documentation-engine 0.3.1__tar.gz → 0.4.0__tar.gz

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to Documentation Engine are documented in this file.
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-08-09
+
+### Highlights
+
+- External consumers can reconcile exact retained documentation generations
+  through a provider-neutral, privacy-safe contract without importing package
+  internals or reading generated projection files directly.
+- Pinned comparison distinguishes content changes, relocation and genuine
+  entity absence while failing closed for unavailable, corrupt, unsupported or
+  incomplete provider evidence.
+
+### Added
+
+- Opt-in, provider-neutral `provider snapshot` and `provider compare` commands
+  export bounded body-free observations from explicitly pinned immutable
+  generations and classify exact stable entities as relocated, changed,
+  missing or added.
+- Projection schema 5 binds provider identity, visibility, advertised
+  capabilities, catalog completeness, coverage, document line counts and
+  explicit/generated anchor kind into the generation hash. Older generations
+  fail provider export as unsupported instead of receiving retroactive claims.
+
 ## [0.3.1] - 2026-07-19
 
 ### Fixed
@@ -197,7 +219,8 @@ documentation-engine` starts working only after the first successful release.
 - Measured context-reduction methodology and a reproducible consumer-install
   smoke test.
 
-[Unreleased]: https://github.com/Jafa7/DocumentationEngine/compare/v0.3.1...HEAD
+[Unreleased]: https://github.com/Jafa7/DocumentationEngine/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/Jafa7/DocumentationEngine/compare/v0.3.1...v0.4.0
 [0.3.1]: https://github.com/Jafa7/DocumentationEngine/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/Jafa7/DocumentationEngine/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/Jafa7/DocumentationEngine/compare/v0.1.2...v0.2.0

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: documentation-engine
-Version: 0.3.1
+Version: 0.4.0
 Summary: Provider-neutral structured Markdown documentation engine.
 Project-URL: Repository, https://github.com/Jafa7/DocumentationEngine
 Project-URL: Documentation, https://github.com/Jafa7/DocumentationEngine/tree/main/docs
@@ -225,6 +225,7 @@ task rather than one mandatory process:
 | --- | --- | --- |
 | Core retrieval | Discover, read and inspect context/impact | Default for routine work |
 | Adoption | Connect or migrate an existing Markdown corpus | Setup and compatibility work |
+| Provider reconciliation | Export or compare explicitly pinned, body-free generations | External consumers that retain stable documentation evidence |
 | Governed delivery | Roadmaps, admission, handoff and lifecycle evidence | Multi-stage, delegated or risk-bearing work |
 | Bounded mutation | Journaled managed-block synchronization and recovery | Explicitly approved mechanical writes |
 | Multi-source | Workspace selection and federation | Deliberate cross-project documentation queries |
@@ -342,6 +343,8 @@ docsystem migrate . --apply
 docsystem index . --write
 docsystem changes .
 docsystem changes . --json
+docsystem provider snapshot GENERATION . --json
+docsystem provider compare BEFORE AFTER . --json
 docsystem agent-instructions .
 docsystem agent-instructions . --json
 docsystem workspace list . --workspace /path/to/workspace
@@ -792,6 +795,13 @@ relations.
 hashed over both the derived content and a fingerprint of the projection-
 relevant configuration, then atomically selects the current generation.
 `index` checks freshness and `changes` reports changed documents and sections.
+Projects that expose immutable documentation evidence to another consumer may
+opt into `[provider]` identity and use `provider snapshot` or `provider compare`
+with explicit retained generation hashes. These commands never select the
+current pointer implicitly, never return Markdown bodies or absolute paths, and
+distinguish unavailable/corrupt provider state from a genuinely missing
+entity. See [pinned provider snapshots](docs/provider-snapshots.md) for the
+versioned JSON, relocation and bounded-pagination contract.
 `read`, `context` and `impact` serve from the verified projection when it is
 current: verification re-hashes every included source byte-for-byte, checks the
 configuration fingerprint, and reconstructs the generation hash from the shards,

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/README.md

@@ -208,6 +208,7 @@ task rather than one mandatory process:
 | --- | --- | --- |
 | Core retrieval | Discover, read and inspect context/impact | Default for routine work |
 | Adoption | Connect or migrate an existing Markdown corpus | Setup and compatibility work |
+| Provider reconciliation | Export or compare explicitly pinned, body-free generations | External consumers that retain stable documentation evidence |
 | Governed delivery | Roadmaps, admission, handoff and lifecycle evidence | Multi-stage, delegated or risk-bearing work |
 | Bounded mutation | Journaled managed-block synchronization and recovery | Explicitly approved mechanical writes |
 | Multi-source | Workspace selection and federation | Deliberate cross-project documentation queries |
@@ -325,6 +326,8 @@ docsystem migrate . --apply
 docsystem index . --write
 docsystem changes .
 docsystem changes . --json
+docsystem provider snapshot GENERATION . --json
+docsystem provider compare BEFORE AFTER . --json
 docsystem agent-instructions .
 docsystem agent-instructions . --json
 docsystem workspace list . --workspace /path/to/workspace
@@ -775,6 +778,13 @@ relations.
 hashed over both the derived content and a fingerprint of the projection-
 relevant configuration, then atomically selects the current generation.
 `index` checks freshness and `changes` reports changed documents and sections.
+Projects that expose immutable documentation evidence to another consumer may
+opt into `[provider]` identity and use `provider snapshot` or `provider compare`
+with explicit retained generation hashes. These commands never select the
+current pointer implicitly, never return Markdown bodies or absolute paths, and
+distinguish unavailable/corrupt provider state from a genuinely missing
+entity. See [pinned provider snapshots](docs/provider-snapshots.md) for the
+versioned JSON, relocation and bounded-pagination contract.
 `read`, `context` and `impact` serve from the verified projection when it is
 current: verification re-hashes every included source byte-for-byte, checks the
 configuration fingerprint, and reconstructs the generation hash from the shards,

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/docs/README.md

@@ -31,6 +31,8 @@ link to that owner rather than repeat commands or policy.
   recommendation, prerequisites and exact source-contract scope.
 - [Compact context delivery](context-delivery.md) — lossless range
   deduplication, inclusion reasons and diagnostics drill-down.
+- [Pinned provider snapshots](provider-snapshots.md) — privacy-safe,
+  body-free export and comparison of explicit immutable generations.
 - [Bounded workstream evidence](workstream-evidence.md) — versioned completion
   criteria, corrective lineage and fail-closed finish evidence.
 - [Deterministic idea intake](idea-intake.md) — place an agent-interpreted idea

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/docs/agent-contract.md

@@ -594,6 +594,15 @@ context the delta deliberately left out. `--since` and
 every rejected combination fails closed with no packet, so an agent never acts
 on a partially applied request.
 
+When a separate consumer needs durable cross-process reconciliation rather
+than a task packet, use `provider snapshot` or `provider compare` with explicit
+retained generation hashes. Do not read `.docsystem/cache` directly and do not
+interpret provider unavailability, corruption or incomplete coverage as a
+missing document/section. Provider responses intentionally contain no Markdown
+bodies; fetch authored content through `read` or `context` only when the task
+requires it. The canonical contract is
+[pinned provider snapshots](provider-snapshots.md).
+
 ## Report product issues without leaking adopter context
 
 When an agent finds a DocumentationEngine problem while working inside another

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/docs/architecture.md

@@ -11,6 +11,7 @@ The core owns deterministic documentation retrieval mechanics:
 - inspectable context packets with explicit coverage and omissions;
 - impact and changed-section analysis;
 - versioned, sharded machine projections and diagnostics.
+- body-free export and comparison of explicitly pinned provider generations.
 
 The package also ships optional extensions over that same core:
 
@@ -58,6 +59,7 @@ The capability groups are progressive, not an execution checklist:
 | --- | --- | --- |
 | Core discovery and retrieval | `readiness`, `catalog`, `validate`, `read`, `context`, `dependencies`, `references`, `impact`, `change-plan` | Default path for understanding and changing documentation-backed work |
 | Adoption and derived state | `migration-report`, `migrate`, `profile-check`, `index`, `changes`, `report` | Connecting an existing corpus, checking policy or refreshing disposable projections |
+| Provider reconciliation | `provider snapshot`, `provider compare` | An external consumer needs exact body-free observations from one or two pinned generations |
 | Governed delivery | `roadmap`, `intake`, `admission`, `execution-handoff`, `execution-result`, `workstream`, `lifecycle`, `finish`, `promotion` | Genuinely multi-stage, delegated or risk-bearing work that requires bounded evidence |
 | Bounded mutation | `maintenance`, `maintenance-recover` | Explicitly approved mechanical synchronization with journal and recovery guarantees |
 | Multi-source operation | `workspace`, `federation` | A task that deliberately spans independently owned documentation sources |
@@ -94,6 +96,7 @@ Project policy may configure:
 - review policy;
 - graph-health advisory thresholds and required metadata fields;
 - projection retention;
+- stable provider identity and exported visibility classification;
 - legacy path-relation migration and historical snapshot document types;
 - provider adapters.
 
@@ -179,6 +182,20 @@ direct Markdown with a visible diagnostic rather than serving mixed state.
 Coordinating multiple writers is a caller/orchestrator responsibility, not
 core engine behavior.
 
+Provider reconciliation uses the same immutable generations but a different
+verification mode from live reads. A provider generation binds stable provider
+identity, visibility, supported capabilities, catalog completeness, coverage,
+scope and body-free export boundaries into the manifest root. `provider
+snapshot` and `provider compare` fully verify explicitly selected retained
+generations without comparing them with live Markdown or using `current.json`;
+historical drift is the evidence being requested. The provider model exposes
+only IDs, canonical anchors, hashes, root-relative paths and line hints. Its
+schema, deterministic cursor and byte/page bounds are independent from the
+internal projection schema. See [pinned provider snapshots](provider-snapshots.md).
+Portable comparison of complete exported snapshot artifacts is deliberately
+deferred. Losing a retained operand requires an explicit full rebaseline; it
+does not authorize heuristic reconstruction or an entity-absence conclusion.
+
 Retained generation manifests also drive two token-economy `context` modes
 that omit content only when omission is provably safe, never as a silent
 budget cut. `--assume-known ID@REV` is a client-declared cache: an agent

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/docs/client-integration.md

@@ -35,14 +35,16 @@ adoption-oriented, read-only commands:
 - `docsystem catalog PROJECT --explain --json`
 - `docsystem changes PROJECT --json`
 - `docsystem context DOCUMENT_ID PROJECT --json`
+- `docsystem provider snapshot GENERATION PROJECT --json`
+- `docsystem provider compare BEFORE AFTER PROJECT --json`
 
-Each prints one deterministic JSON object to stdout (sorted keys, stable
-field names) carrying the same diagnostics that the text form prints as
-human `ERROR`/`WARNING` lines on stderr. In `--json` mode those human
-stderr diagnostics may be suppressed since the JSON payload already carries
-the same information in structured form, so a wrapper does not need to read
-stderr to make a decision. Exit codes are unchanged by `--json`: `0` on
-success or a ready project, `1` otherwise.
+Each successful command prints one deterministic JSON object to stdout (sorted
+keys and stable field names). For the adoption/context commands, structured
+diagnostics may replace duplicate human `ERROR`/`WARNING` lines. Provider
+snapshot/compare instead fail closed with a stable error code on stderr and no
+stdout, because an unavailable generation must never resemble an entity result.
+Exit codes are unchanged by `--json`: `0` on success or a ready project, `1`
+otherwise.
 
 Every `--json` root is an object with a `"schema_version": 1` field; it is
 bumped only on a breaking change to an existing field, while new fields may
@@ -101,9 +103,15 @@ hash before comparison. `--since` and
 `--assume-known` are mutually exclusive, and neither combines with
 `--outline`; a rejected combination exits `1` with no stdout.
 
-A wrapper that speaks MCP can skip the CLI entirely and use
-[the MCP adapter](mcp-adapter.md), which exposes these same read-only
-commands as typed tools over the identical JSON contract.
+A wrapper that speaks MCP can use [the MCP adapter](mcp-adapter.md) for its
+document, context, graph and governance tools over the same core contracts.
+
+Provider snapshot/compare responses use their own versioned, body-free schema
+and bounded cursor contract. They require explicit retained generations and
+never infer either operand from current Markdown or `current.json`. These two
+commands are currently CLI-only. A wrapper must distinguish
+provider/generation failures on stderr from `missing` inside a successful
+comparison; see [pinned provider snapshots](provider-snapshots.md).
 
 `docsystem readiness PROJECT --json` is the entry point for an adoption
 sequence: its `next_command` field names the single safe next command for

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/docs/mcp-adapter.md

@@ -60,6 +60,9 @@ The adapter is deliberately a wrapper, not a second implementation:
   `maintenance-recover`) intentionally have no tools and stay
   with the human or calling system, matching
   [the agent contract](agent-contract.md);
+- pinned `provider snapshot` and `provider compare` are currently CLI-only.
+  An MCP wrapper may be added later only as a thin transport over the same
+  bounded, body-free contract; clients must not inspect projection files;
 - a non-zero CLI exit becomes a tool error carrying the CLI's stderr
   diagnostics, so a client never mistakes a failure for data. The one
   exception is `readiness`, whose "not ready" state is a legitimate answer:

documentation_engine-0.4.0/docs/provider-snapshots.md

@@ -0,0 +1,175 @@
+# Pinned provider snapshots
+
+Pinned provider snapshots let an external consumer reconcile two exact states
+of a Documentation Engine catalog without importing package internals or
+reading `.docsystem/cache` directly. The surface is read-only, body-free and
+provider-neutral.
+
+This contract answers a different question from `docsystem changes`:
+
+- `changes` compares live Markdown with the generation selected by
+  `current.json`;
+- `provider snapshot` exports observations from one explicitly named immutable
+  generation;
+- `provider compare` compares two explicitly named immutable generations and
+  does not substitute the current pointer for either operand.
+
+## Opt-in provider identity
+
+Configure a stable identity before building generations intended for external
+reconciliation:
+
+```toml
+[provider]
+id = "example-docs"
+visibility = "private"
+
+[projection]
+format = "sharded-json"
+keep_generations = 4
+```
+
+`provider.id` accepts 1–128 lowercase letters, digits, `.`, `_` and `-`.
+`visibility` is `private` by default and may be set to `public`; it is an
+exported classification, not an access-control mechanism. Filesystem,
+sandbox, service and transport policy still control who can invoke the CLI.
+
+Provider configuration is optional for all existing commands. The provider
+commands fail closed with `provider-not-configured` when the ID is absent.
+Never derive the ID from an absolute path, host name or repository remote.
+
+Run `docsystem index PROJECT --write` after configuring the provider. Each new
+projection generation binds the provider ID, visibility, capabilities,
+catalog-completeness evidence, coverage and fixed export boundaries into its
+content hash. Generations created by older projection schemas do not acquire
+those claims retroactively and are reported as `generation-unsupported`.
+
+## Export one pinned generation
+
+```bash
+docsystem provider snapshot GENERATION PROJECT --json
+docsystem provider snapshot GENERATION PROJECT --json \
+  --page-size 100 --cursor CURSOR
+```
+
+`GENERATION` is a full retained generation hash or an unambiguous prefix of at
+least twelve characters. It is required; the command never selects
+`current.json` implicitly.
+
+The versioned response identifies the provider and generation, advertises
+capabilities, states coverage/scope/boundaries, and returns a page of stable
+document and section observations. Each observation contains only:
+
+- `document_id` and canonical `anchor` (`null` for a document);
+- `anchor_kind` (`explicit` or `generated`) for a section;
+- exact content hash;
+- documentation-root-relative POSIX path;
+- one-based inclusive line hints;
+- configured visibility.
+
+Markdown bodies, titles, metadata values, relations, excluded paths, absolute
+paths and projection locations are not exported. Explicit anchors provide the
+strongest stable section identity. A generated anchor remains canonical for
+that generation, but changing its heading may produce a missing/added pair
+rather than an inferred match; the engine does not use title similarity.
+
+## Compare two pinned generations
+
+```bash
+docsystem provider compare BEFORE AFTER PROJECT --json
+docsystem provider compare BEFORE AFTER PROJECT --json \
+  --page-size 100 --cursor CURSOR
+```
+
+Both operands are verified independently and may be retained historical
+generations. They do not need to match live Markdown or the current pointer.
+They must belong to the configured provider and advertise the same supported
+capability.
+
+The comparison uses the exact key `(kind, document_id, canonical_anchor)`:
+
+| Classification | Meaning |
+| --- | --- |
+| `relocated` | Identity and content hash are unchanged, but path or line hints changed |
+| `changed` | Identity exists on both sides and its content hash changed |
+| `missing` | Identity exists only in `BEFORE` |
+| `added` | Identity exists only in `AFTER` |
+
+Every change carries the exact body-free `before` and `after` observation when
+that side exists. A content change takes precedence over relocation, while the
+two observations still expose any simultaneous location change. The summary
+also counts unchanged entities. Valid Documentation Engine catalogs prevent
+duplicate stable keys; ambiguity is never used to disguise corruption or an
+incomplete catalog.
+
+## Integrity and availability
+
+Pinned export verifies the selector, projection schema, manifest-to-generation
+hash, provider capability descriptor, completeness evidence, document coverage
+and every stored document/reverse/reference shard hash. It deliberately does
+not compare historical source hashes with live Markdown: a retained generation
+is immutable historical evidence and is expected to differ from current files.
+
+Failures return exit code `1`, write no stdout, and use a stable code in stderr,
+for example `ERROR [generation-corrupt]: ...`. Important distinctions include:
+
+- `provider-unavailable`: generation storage cannot be read;
+- `generation-unknown`: the requested retained generation does not exist;
+- `generation-selector-ambiguous`: a prefix selects more than one generation;
+- `generation-corrupt`: bound manifest or shard evidence is invalid;
+- `generation-unsupported`: the generation lacks this versioned capability;
+- `generation-incomplete`: catalog or coverage completeness cannot be proved;
+- `provider-mismatch`: generation identity differs from configured identity;
+- `page-invalid` / `page-too-large`: pagination evidence is invalid or cannot
+  fit the bounded response.
+
+Provider unavailability and corrupt/incomplete snapshots are never represented
+as missing entities.
+
+## Pagination and deterministic bytes
+
+Pages default to 100 entities, accept 1–500, and never exceed 262,144 UTF-8
+bytes. The response may return fewer than the requested count to respect the
+byte limit. If one observation cannot fit, the command fails instead of
+truncating a field. `next_cursor` is bound to the response kind and exact
+generation operand(s); using it for another query fails closed.
+
+Following `next_cursor` until `null` reconstructs the complete ordered result
+without loss or duplication. Repeating the same pinned request produces the
+same sorted JSON bytes with one trailing newline.
+
+Retention controls availability. Set `projection.keep_generations` high enough
+for the consumer's reconciliation window, or archive the body-free exported
+responses in the consumer. If either comparison generation has been evicted,
+the provider fails with `generation-unknown`/unavailable. The consumer must
+perform an explicit full rebaseline from a newly selected complete generation
+and record that the earlier delta chain ended. Retention loss is never evidence
+that an entity was removed, and the engine does not reconstruct the missing
+operand heuristically.
+
+## Deferred follow-up: portable snapshot artifacts
+
+Portable comparison after provider retention expiry is a named follow-up, not
+part of the first contract. A future command may accept complete exported
+snapshot artifacts as operands, but must bind and verify their schema, provider
+and generation identity, query/scope, coverage/completeness, complete ordered
+observations and canonical artifact digest before applying the same comparison
+semantics. It must reject partial page sets, mixed-query pages, tampering,
+unsupported schemas and incompatible providers. Persisted pages from this
+version are evidence for a consumer; they are not yet accepted back as
+Documentation Engine comparison operands.
+
+For v1, entity identity is exactly `(kind, document_id, canonical_anchor)`.
+Moving the same document ID to another provider-relative path can be
+`relocated`. Moving a section across document IDs is `missing` plus `added`,
+even when its anchor and content match; cross-document similarity is not safe
+structural identity and is not inferred.
+
+The first contract is CLI-only. A service or MCP adapter may wrap these exact
+read-only commands later, but it must preserve their integrity, privacy,
+pagination and failure semantics rather than inspect projection files itself.
+
+[`examples/provider-snapshots/`](../examples/provider-snapshots/) is a public
+synthetic corpus with explicit anchors and an opt-in provider profile. Copy it
+to a temporary directory, run `index --write`, make one source change and write
+a second generation to exercise the commands without exposing adopter data.

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/docs/setup-guide.md

@@ -177,6 +177,11 @@ format = "sharded-json"
 keep_generations = 2
 ```
 
+Projects that expose immutable body-free observations to another consumer may
+also configure an explicit `[provider]` identity. This is optional for ordinary
+local use; see [pinned provider snapshots](provider-snapshots.md). Do not infer
+the identity from a private filesystem path.
+
 Whole-graph smell policy is optional and should reflect the adopting project,
 not copied thresholds. With no thresholds, `graph-health` still reports the
 complete deterministic inventory and emits only intrinsic dead-link evidence:

documentation_engine-0.4.0/examples/provider-snapshots/.docsystem.toml

@@ -0,0 +1,30 @@
+version = 1
+
+[documentation]
+root = "docs"
+language = "en"
+
+[areas]
+workspace = "."
+
+[identifiers]
+document = "DOC"
+
+[catalog]
+exclude = []
+
+[navigation]
+extend_through = []
+
+[provider]
+id = "example-docs"
+visibility = "public"
+
+[relations]
+legacy_paths = "strict"
+snapshot_types = []
+snapshot_rules = []
+
+[projection]
+format = "sharded-json"
+keep_generations = 4

documentation_engine-0.4.0/examples/provider-snapshots/docs/README.md

@@ -0,0 +1,8 @@
+---
+id: DOC-001
+revision: 1
+---
+
+# Example documentation index
+
+- [Service contract](service-contract.md)

documentation_engine-0.4.0/examples/provider-snapshots/docs/service-contract.md

@@ -0,0 +1,17 @@
+---
+id: DOC-002
+revision: 1
+---
+
+# Service contract
+
+<a id="purpose"></a>
+## Purpose
+
+Define one synthetic service boundary.
+
+<a id="constraints"></a>
+## Constraints
+
+- Preserve stable identities across file relocation.
+- Report unavailable provider evidence separately from missing entities.

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/scripts/installed_cli_smoke.sh

@@ -130,6 +130,52 @@ run_cli_checks() {
     env -u PYTHONPATH -u PYTHONHOME "${docsystem_bin}" init .
     env -u PYTHONPATH -u PYTHONHOME "${docsystem_bin}" doctor .
     env -u PYTHONPATH -u PYTHONHOME "${docsystem_bin}" show-config .
+
+    sed -i '/^\[provider\]$/a id = "installed-smoke"' .docsystem.toml
+    mkdir -p plan/foundation
+    cat > plan/foundation/README.md <<'MARKDOWN'
+---
+id: DOC-001
+revision: 1
+---
+# Installed consumer fixture
+
+<a id="contract"></a>
+## Contract
+
+Original private-like fixture text that must not appear in provider output.
+MARKDOWN
+    first_generation="$(
+      env -u PYTHONPATH -u PYTHONHOME "${docsystem_bin}" index . --write \
+        | sed -n 's/^Projection generation written: //p'
+    )"
+    if [[ -z "${first_generation}" ]]; then
+      echo "error: installed provider smoke did not create the first generation" >&2
+      exit 1
+    fi
+    printf '\nA changed line.\n' >> plan/foundation/README.md
+    second_generation="$(
+      env -u PYTHONPATH -u PYTHONHOME "${docsystem_bin}" index . --write \
+        | sed -n 's/^Projection generation written: //p'
+    )"
+    env -u PYTHONPATH -u PYTHONHOME "${docsystem_bin}" provider snapshot \
+      "${first_generation}" . --json > provider-snapshot.json
+    env -u PYTHONPATH -u PYTHONHOME "${docsystem_bin}" provider compare \
+      "${first_generation}" "${second_generation}" . --json \
+      > provider-compare.json
+    env -u PYTHONPATH -u PYTHONHOME "${venv_python}" - <<'PY'
+import json
+from pathlib import Path
+
+snapshot_text = Path("provider-snapshot.json").read_text(encoding="utf-8")
+comparison = json.loads(Path("provider-compare.json").read_text(encoding="utf-8"))
+snapshot = json.loads(snapshot_text)
+assert snapshot["kind"] == "provider-snapshot"
+assert snapshot["snapshot"]["provider_id"] == "installed-smoke"
+assert "Original private-like fixture text" not in snapshot_text
+assert comparison["kind"] == "provider-compare"
+assert comparison["summary"]["changed"] >= 1
+PY
   )
 }
 

{documentation_engine-0.3.1 → documentation_engine-0.4.0}/src/docsystem/__init__.py

@@ -9,7 +9,7 @@ from docsystem.catalog import (
 from docsystem.metadata import DocumentMetadata, MetadataReference
 from docsystem.sections import MarkdownSection
 
-__version__ = "0.3.1"
+__version__ = "0.4.0"
 
 __all__ = [
     "CatalogMembership",