Skip to content

SCRUM-1238-feat(semantic): add native Ossie authoring support - #427

Merged
marcociav-exmergo merged 1 commit into
ossie-setupfrom
SCRUM-1238-issue-411
Sep 6, 2026
Merged

SCRUM-1238-feat(semantic): add native Ossie authoring support#427
marcociav-exmergo merged 1 commit into
ossie-setupfrom
SCRUM-1238-issue-411

Conversation

@emnarahmouni-exmergo

Copy link
Copy Markdown
Contributor

Adds native Apache Ossie semantic authoring support
This PR introduces semantic ossie define|update|plan, allowing agents to create and update configured Ossie documents through Dex’s existing reviewable plan and transform apply workflow.
What changed

  • Added the format-neutral semantic_document edit kind.
  • Added native Ossie define, update, and plan commands.
  • Restricted edits to paths explicitly listed in semantic.ossie.files.
  • Validated the complete prospective semantic layer before storing a plan.
  • Preserved authored YAML/JSON byte-for-byte, including comments and formatting.
  • Added hash-based stale-edit detection and atomic multi-document application.
  • Kept Ossie independent from the transformation-project hierarchy.
  • Added the shipped SemanticEditTargetContract for semantic-source editing guarantees.
  • Added explicit Ossie authoring coverage to test_safety_spine.py.
  • Added Python API reachability coverage for semantic ossie.
  • Updated the command contract, semantic-layer documentation, agent instructions, transform skill, and changelog.
    Architecture note
    Ossie intentionally does not implement EditableProject or PlacingProject. Those protocols represent transformation projects, while the revised architecture requires Ossie to remain on the semantic-layer axis.
    Equivalent editing and placement safety guarantees are enforced through the new SemanticEditTarget protocol and its shipped conformance contract.
    Verification
  • Focused Ossie/conformance/safety suite: 187 passed, 2 skipped
  • Engine, CLI contract, and Ossie authoring suite: 176 passed
  • Ruff: passed
  • git diff --check: passed
    Issue
    Closes Add native Ossie authoring plans #411.

Add define, update, and plan commands for native Ossie documents with validation, configured-file confinement, atomic application, stale-edit protection, and semantic edit-target conformance tests.
@marcociav-exmergo marcociav-exmergo linked an issue Sep 4, 2026 that may be closed by this pull request

@marcociav-exmergo marcociav-exmergo left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice, thanks @emnarahmouni-exmergo

@marcociav-exmergo
marcociav-exmergo merged commit 684a310 into ossie-setup Sep 6, 2026
marcociav-exmergo added a commit that referenced this pull request Sep 6, 2026
* First ossie setup commit

* Pin Apache Ossie Schema and added notes on PROVENANCE.md

* Add support for Apache Ossie as a semantic-layer vendor in config.py

* Extract `project_definitions.py` as a standalone module

* Add `connector` attribute to `ProjectContext` and implement relation parsing

* Introduce native Apache Ossie support with schema validation and document loading

* Refactor semantic layer: unify backend implementation, add Apache Ossie runtime, and improve vendor-deployment handling

* Improve relationship handling: support multi-column relationships and enhance declared relationship resolution

* explore commands: add support for hosted semantic layers, native semantic edge resolution, and improved relationship handling

* Refactor semantic layer snapshot: rename `SemanticLayer` to `SemanticLayerSnapshot` and update references for improved clarity and compatibility

* Add legacy Apache Ossie project format deprecation and hosted semantic layer support

* Ossie tests: restructure and consolidate into dedicated `tests/ossie` module for improved organization and expanded coverage

* Add comprehensive safety_spine for Apache Ossie integration: ensure PII linkage, repository confinement, catalog restrictions, and runtime guardrails

* Add `ossie` extra to dependencies: enable native schema validation and improve Apache Ossie workflow integration

* Update agent-facing docs

* Update CHANGELOG.md

* Deprecate legacy Ossie project format, remove compatibility routes, and enhance semantic configuration for native Ossie layer support

* Update CHANGELOG.md

* Remove comments

* Hotfix tests

* Adds declared-relationship conflict detection, composes local and (#423)

hosted semantic catalogs instead of one silently winning, folds a
layer's own declared keys into the grain channel, fixes the Mermaid
composite-edge label, and adds full DuckDB end-to-end coverage

* Reach tier 2 for native Ossie: maintain snapshot and drift (#425)

Co-authored-by: Marco Ciavarella <129963453+marcociav-exmergo@users.noreply.github.com>

* Verify Ossie keys through governed grain checks (#426)

* feat(semantic): add native Ossie authoring support (#427)

Add define, update, and plan commands for native Ossie documents with validation, configured-file confinement, atomic application, stale-edit protection, and semantic edit-target conformance tests.

* hotfix: merge issue 412 into ossie-setup (#435)

* feat(semantic): add native Ossie authoring support

Add define, update, and plan commands for native Ossie documents with validation, configured-file confinement, atomic application, stale-edit protection, and semantic edit-target conformance tests.

* Validate Ossie authoring against cached physical evidence (#428)

---------

Co-authored-by: Emna Rahmouni <emna.rahmouni@exmergo.com>

* Fix ruff and em dash issues

* Introduce native semantic layer authoring module for Ossie and refactor commands

* hotfix ruff

* Make Ossie a Semantic Source. Add testing fixtures (#436)

* Update ruff.toml

* Introduce SemanticSource abstractions and conformance

* Refactor SEMANTIC_PROJECT_FORMATS to SEMANTIC_SOURCE_FACTORIES

* Update ossie/schema/PROVENANCE.md

* Remove unused artifacts from OssieSemanticLayer

* Clarified semantic_source invocation in explore/semantic and transform

* Add conformance tests in explore/semantic

* Clarified semantic source invocation in cli.py and engine.py

* Add ossie testing fixtures

* Update tests w/ ossie fixtures

* Update docs

* Update CHANGELOG.md

* Document Native Ossie Workflows (#437)

* Update agent-facing docs and evals

* Update dev-facing docs

* Update README.md

* Update README.md with new connectors and semantic layer tables. Clearer breakdowns

* Cut release 1.11.0

---------

Co-authored-by: emnarahmouni-exmergo <emna.rahmouni@exmergo.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add native Ossie authoring plans

2 participants