@mnstry/atelier 0.2.0-alpha.13 → 0.2.0-alpha.15

package/contracts/public-api-baseline.json

@@ -32,26 +32,305 @@
     "./export-contract",
     "./dry-run",
     "./contracts/atelier-export.v1.schema.json",
-    "./fixtures/atelier-export/sample-studio-offer.v1.json"
+    "./fixtures/atelier-export/sample-studio-offer.v1.json",
+    "./extensions",
+    "./extensions/client",
+    "./extensions/server",
+    "./extensions/postgres",
+    "./contracts/atelier-extension-manifest.v1.schema.json",
+    "./extensions/drizzle",
+    "./extensions/prisma"
   ],
   "requiredModuleExports": {
-    ".": ["ALLOWED_RUNTIME_TARGETS", "ATELIER_LOCK_SCHEMA", "ATELIER_MIGRATION_SCHEMA", "ATELIER_READINESS_SCHEMA", "BASE_MIGRATIONS", "BOUNDARY_POLICY_SCHEMA", "LOCAL_AUDIENCES", "MNSTRY_READINESS_PACK_SCHEMA", "OBJECT_CLASSES", "PROJECT_CONFIG_SCHEMA", "READINESS_PROTOCOL_IDS", "READINESS_PROTOCOL_SLUGS", "RUNTIME_OWNERS", "RUNTIME_VISIBILITIES", "analysisAdapterDryRun", "applyUpgrade", "buildAtelierLock", "buildGraph", "buildProjectProjection", "buildReadiness", "buildSupportBundlePreview", "bundledMnstryReadinessPackV1", "bundledReadinessPack", "bundledReadinessProtocols", "checkAtelierLock", "checkBoundaryPolicy", "checkForbiddenEgress", "contextEnvelope", "createAtelierSidecarServer", "createPromoteEvent", "getBundledReadinessProtocol", "installBoundaryHooks", "loadAtelierLock", "loadBoundaryPolicy", "planUpgrade", "protocolById", "resolveProjectConfig", "validateAtelierExportContract", "validateAtelierExportDryRun", "validateAtelierExportDryRunFile", "validateBoundaryPolicy", "validateJsonSchema", "validateMigrationRecord", "validateProjectConfigDoc", "validateSchemaShape", "validateSupportBundlePayload", "writeAtelierLock"],
-    "./cli": ["DEFAULT_BRAND", "buildCommandHelpText", "buildHelpText", "buildVersionText", "commandMap", "runCli"],
-    "./project": ["EXTERNAL_REPO_KIND", "LOCAL_OVERLAY_ENV", "LOCAL_OVERLAY_FILES", "LOCAL_OVERLAY_SCHEMA", "LOCAL_STATE_DIR", "PROJECT_CONFIG_ARG_PREFIX", "PROJECT_CONFIG_ENV", "PROJECT_CONFIG_SCHEMA", "SUPPORTED_IDENTITY_PROVIDERS", "asObject", "commandProject", "ensureLocalState", "firstString", "gitRemoteUrl", "isExternalRepo", "loadRepoAccess", "localOverlayCandidatePaths", "localStateRoot", "parseArgs", "parseRepoPathOverrides", "projectConfigArg", "readJson", "readLocalOverlay", "readProjectConfig", "remoteHost", "resolvePathValue", "resolveProjectConfig", "stripProjectConfigArgs", "validateProjectConfigDoc", "writeJson"],
-    "./graph": ["VALID_AUDIENCES", "VALID_RELATIONS", "buildGraph", "ignoredSidecarWarnings", "parseFrontmatterYaml", "runGraphCommand"],
-    "./projection": ["buildProjectProjection", "runProjectCommand"],
-    "./readiness": ["ATELIER_READINESS_SCHEMA", "buildReadiness", "runReadinessCommand", "stableReadinessForCheck", "summarizeGraph", "summarizeProjection"],
-    "./readiness-protocols": ["MNSTRY_READINESS_PACK_SCHEMA", "READINESS_PROTOCOL_IDS", "READINESS_PROTOCOL_SCHEMA", "READINESS_PROTOCOL_SLUGS", "READINESS_RUN_SCHEMA", "bundledMnstryReadinessPackV1", "bundledReadinessPack", "bundledReadinessProtocols", "getBundledReadinessProtocol", "protocolById"],
-    "./server": ["ATELIER_CAPABILITIES_SCHEMA", "ATELIER_CONTEXT_SCHEMA", "ATELIER_DOCTOR_SCHEMA", "ATELIER_PRESENCE_SCHEMA", "ATELIER_RESOLVE_SCHEMA", "ATELIER_SESSION_AUTH_SCHEMA", "createAtelierSidecarServer"],
-    "./harness": ["contextEnvelope", "runContextCommand"],
-    "./support": ["BANNED_KEY_PATTERNS", "BANNED_VALUE_PATTERNS", "DEFAULT_SUPPORT_FIELDS", "SUPPORT_BUNDLE_PREVIEW_SCHEMA", "buildSupportBundlePreview", "parseSupportBundleArgs", "readSupportBundleJson", "runSupportCommand", "supportBundlePreview", "validateSupportBundlePayload", "writeOrPrintSupportBundle"],
-    "./egress": ["DEFAULT_EGRESS_SCAN_PATHS", "LOCAL_COMPUTED_ALLOW_MARKER", "TEST_FIXTURE_ALLOW_MARKER", "checkForbiddenEgress", "discoverForbiddenEgressScanFiles", "forbiddenEgressFindingsForText"],
-    "./boundary": ["BOUNDARY_POLICY_SCHEMA", "DEFAULT_FORBIDDEN_PATHS", "LEGACY_PROMOTE_EVENT_SCHEMAS", "PRIVATE_AUDIENCES", "PROMOTE_EVENT_SCHEMA", "SEMANTIC_INITIALIZATION_DEFAULTS", "VALID_AUDIENCES", "VALID_AUTOCOMMIT", "VALID_BOUNDARY_MODES", "VALID_REPO_KINDS", "auditContentRules", "checkBoundaryPolicy", "checkPushContent", "createPromoteEvent", "diffFileSections", "installBoundaryHooks", "loadBoundaryPolicy", "projectBoundaryPolicyPath", "projectGovernanceLedgerPath", "resolveCurrentActor", "runBoundaryAuditCommand", "runBoundaryCheckCommand", "runBoundaryInstallHooksCommand", "runBoundaryPushCheckCommand", "runPromoteCommand", "semanticChangesInFile", "semanticFieldOnLine", "stagedPathsForProject", "validateBoundaryPolicy"],
-    "./upgrade": ["ATELIER_LOCK_SCHEMA", "ATELIER_MIGRATION_SCHEMA", "BASE_MIGRATIONS", "LOCK_FILE", "MIGRATION_CLASSES", "applyMigration", "applyUpgrade", "buildAtelierLock", "checkAtelierLock", "loadAtelierLock", "lockPathForProject", "planUpgrade", "runLockCommand", "runUpgradeCommand", "validateMigrationRecord", "writeAtelierLock"],
-    "./attestation": ["KEY_ENV_VAR", "LOCAL_KEY_FILE", "canonicalize", "generateKeyPair", "loadSigningKey", "payloadHashOf", "safeLabel", "signAttestation", "signDocument", "signingInput", "verifyAttestation", "verifyDocument", "verifyPayloadBinding"],
-    "./extension-packs": ["ATELIER_EXT_NAMESPACE", "EXTENSION_PACK_SCHEMA", "PROTOCOL_POSTURE_POINTS", "RESERVED_NAMESPACE", "RESERVED_NAMESPACE_PATTERN", "computePackDigest", "createProtocolRegistry", "loadExtensionPacks"],
-    "./analysis/adapter": ["analysisAdapterDryRun", "runAnalysisAdapterCommand"],
-    "./export-contract": ["ALLOWED_RUNTIME_TARGETS", "LOCAL_AUDIENCES", "OBJECT_CLASSES", "RUNTIME_OWNERS", "RUNTIME_VISIBILITIES", "validateAtelierExportContract", "validateJsonSchema", "validateSchemaShape"],
-    "./dry-run": ["main", "validateAtelierExportDryRun", "validateAtelierExportDryRunFile"]
+    ".": [
+      "ALLOWED_RUNTIME_TARGETS",
+      "ATELIER_LOCK_SCHEMA",
+      "ATELIER_MIGRATION_SCHEMA",
+      "ATELIER_READINESS_SCHEMA",
+      "BASE_MIGRATIONS",
+      "BOUNDARY_POLICY_SCHEMA",
+      "LOCAL_AUDIENCES",
+      "MNSTRY_READINESS_PACK_SCHEMA",
+      "OBJECT_CLASSES",
+      "PROJECT_CONFIG_SCHEMA",
+      "READINESS_PROTOCOL_IDS",
+      "READINESS_PROTOCOL_SLUGS",
+      "RUNTIME_OWNERS",
+      "RUNTIME_VISIBILITIES",
+      "analysisAdapterDryRun",
+      "applyUpgrade",
+      "buildAtelierLock",
+      "buildGraph",
+      "buildProjectProjection",
+      "buildReadiness",
+      "buildSupportBundlePreview",
+      "bundledMnstryReadinessPackV1",
+      "bundledReadinessPack",
+      "bundledReadinessProtocols",
+      "checkAtelierLock",
+      "checkBoundaryPolicy",
+      "checkForbiddenEgress",
+      "contextEnvelope",
+      "createAtelierSidecarServer",
+      "createPromoteEvent",
+      "getBundledReadinessProtocol",
+      "installBoundaryHooks",
+      "loadAtelierLock",
+      "loadBoundaryPolicy",
+      "planUpgrade",
+      "protocolById",
+      "resolveProjectConfig",
+      "validateAtelierExportContract",
+      "validateAtelierExportDryRun",
+      "validateAtelierExportDryRunFile",
+      "validateBoundaryPolicy",
+      "validateJsonSchema",
+      "validateMigrationRecord",
+      "validateProjectConfigDoc",
+      "validateSchemaShape",
+      "validateSupportBundlePayload",
+      "writeAtelierLock"
+    ],
+    "./cli": [
+      "DEFAULT_BRAND",
+      "buildCommandHelpText",
+      "buildHelpText",
+      "buildVersionText",
+      "commandMap",
+      "runCli"
+    ],
+    "./project": [
+      "EXTERNAL_REPO_KIND",
+      "LOCAL_OVERLAY_ENV",
+      "LOCAL_OVERLAY_FILES",
+      "LOCAL_OVERLAY_SCHEMA",
+      "LOCAL_STATE_DIR",
+      "PROJECT_CONFIG_ARG_PREFIX",
+      "PROJECT_CONFIG_ENV",
+      "PROJECT_CONFIG_SCHEMA",
+      "SUPPORTED_IDENTITY_PROVIDERS",
+      "asObject",
+      "commandProject",
+      "ensureLocalState",
+      "firstString",
+      "gitRemoteUrl",
+      "isExternalRepo",
+      "loadRepoAccess",
+      "localOverlayCandidatePaths",
+      "localStateRoot",
+      "parseArgs",
+      "parseRepoPathOverrides",
+      "projectConfigArg",
+      "readJson",
+      "readLocalOverlay",
+      "readProjectConfig",
+      "remoteHost",
+      "resolvePathValue",
+      "resolveProjectConfig",
+      "stripProjectConfigArgs",
+      "validateProjectConfigDoc",
+      "writeJson"
+    ],
+    "./graph": [
+      "VALID_AUDIENCES",
+      "VALID_RELATIONS",
+      "buildGraph",
+      "ignoredSidecarWarnings",
+      "parseFrontmatterYaml",
+      "runGraphCommand"
+    ],
+    "./projection": [
+      "buildProjectProjection",
+      "runProjectCommand"
+    ],
+    "./readiness": [
+      "ATELIER_READINESS_SCHEMA",
+      "buildReadiness",
+      "runReadinessCommand",
+      "stableReadinessForCheck",
+      "summarizeGraph",
+      "summarizeProjection"
+    ],
+    "./readiness-protocols": [
+      "MNSTRY_READINESS_PACK_SCHEMA",
+      "READINESS_PROTOCOL_IDS",
+      "READINESS_PROTOCOL_SCHEMA",
+      "READINESS_PROTOCOL_SLUGS",
+      "READINESS_RUN_SCHEMA",
+      "bundledMnstryReadinessPackV1",
+      "bundledReadinessPack",
+      "bundledReadinessProtocols",
+      "getBundledReadinessProtocol",
+      "protocolById"
+    ],
+    "./server": [
+      "ATELIER_CAPABILITIES_SCHEMA",
+      "ATELIER_CONTEXT_SCHEMA",
+      "ATELIER_DOCTOR_SCHEMA",
+      "ATELIER_PRESENCE_SCHEMA",
+      "ATELIER_RESOLVE_SCHEMA",
+      "ATELIER_SESSION_AUTH_SCHEMA",
+      "createAtelierSidecarServer"
+    ],
+    "./harness": [
+      "contextEnvelope",
+      "runContextCommand"
+    ],
+    "./support": [
+      "BANNED_KEY_PATTERNS",
+      "BANNED_VALUE_PATTERNS",
+      "DEFAULT_SUPPORT_FIELDS",
+      "SUPPORT_BUNDLE_PREVIEW_SCHEMA",
+      "buildSupportBundlePreview",
+      "parseSupportBundleArgs",
+      "readSupportBundleJson",
+      "runSupportCommand",
+      "supportBundlePreview",
+      "validateSupportBundlePayload",
+      "writeOrPrintSupportBundle"
+    ],
+    "./egress": [
+      "DEFAULT_EGRESS_SCAN_PATHS",
+      "LOCAL_COMPUTED_ALLOW_MARKER",
+      "TEST_FIXTURE_ALLOW_MARKER",
+      "checkForbiddenEgress",
+      "discoverForbiddenEgressScanFiles",
+      "forbiddenEgressFindingsForText"
+    ],
+    "./boundary": [
+      "BOUNDARY_POLICY_SCHEMA",
+      "DEFAULT_FORBIDDEN_PATHS",
+      "LEGACY_PROMOTE_EVENT_SCHEMAS",
+      "PRIVATE_AUDIENCES",
+      "PROMOTE_EVENT_SCHEMA",
+      "SEMANTIC_INITIALIZATION_DEFAULTS",
+      "VALID_AUDIENCES",
+      "VALID_AUTOCOMMIT",
+      "VALID_BOUNDARY_MODES",
+      "VALID_REPO_KINDS",
+      "auditContentRules",
+      "checkBoundaryPolicy",
+      "checkPushContent",
+      "createPromoteEvent",
+      "diffFileSections",
+      "installBoundaryHooks",
+      "loadBoundaryPolicy",
+      "projectBoundaryPolicyPath",
+      "projectGovernanceLedgerPath",
+      "resolveCurrentActor",
+      "runBoundaryAuditCommand",
+      "runBoundaryCheckCommand",
+      "runBoundaryInstallHooksCommand",
+      "runBoundaryPushCheckCommand",
+      "runPromoteCommand",
+      "semanticChangesInFile",
+      "semanticFieldOnLine",
+      "stagedPathsForProject",
+      "validateBoundaryPolicy"
+    ],
+    "./upgrade": [
+      "ATELIER_LOCK_SCHEMA",
+      "ATELIER_MIGRATION_SCHEMA",
+      "BASE_MIGRATIONS",
+      "LOCK_FILE",
+      "MIGRATION_CLASSES",
+      "applyMigration",
+      "applyUpgrade",
+      "buildAtelierLock",
+      "checkAtelierLock",
+      "loadAtelierLock",
+      "lockPathForProject",
+      "planUpgrade",
+      "runLockCommand",
+      "runUpgradeCommand",
+      "validateMigrationRecord",
+      "writeAtelierLock"
+    ],
+    "./attestation": [
+      "KEY_ENV_VAR",
+      "LOCAL_KEY_FILE",
+      "canonicalize",
+      "generateKeyPair",
+      "loadSigningKey",
+      "payloadHashOf",
+      "safeLabel",
+      "signAttestation",
+      "signDocument",
+      "signingInput",
+      "verifyAttestation",
+      "verifyDocument",
+      "verifyPayloadBinding"
+    ],
+    "./extension-packs": [
+      "ATELIER_EXT_NAMESPACE",
+      "EXTENSION_PACK_SCHEMA",
+      "PROTOCOL_POSTURE_POINTS",
+      "RESERVED_NAMESPACE",
+      "RESERVED_NAMESPACE_PATTERN",
+      "computePackDigest",
+      "createProtocolRegistry",
+      "loadExtensionPacks"
+    ],
+    "./analysis/adapter": [
+      "analysisAdapterDryRun",
+      "runAnalysisAdapterCommand"
+    ],
+    "./export-contract": [
+      "ALLOWED_RUNTIME_TARGETS",
+      "LOCAL_AUDIENCES",
+      "OBJECT_CLASSES",
+      "RUNTIME_OWNERS",
+      "RUNTIME_VISIBILITIES",
+      "validateAtelierExportContract",
+      "validateJsonSchema",
+      "validateSchemaShape"
+    ],
+    "./dry-run": [
+      "main",
+      "validateAtelierExportDryRun",
+      "validateAtelierExportDryRunFile"
+    ],
+    "./extensions": [
+      "ExtensionError",
+      "canonicalJson",
+      "exact",
+      "parseInstallationBinding",
+      "parseManifest",
+      "parseOperationReceipt",
+      "text",
+      "parseProviderOperationProof"
+    ],
+    "./extensions/client": [
+      "createExtensionAdminClient",
+      "createExtensionClient",
+      "createHttpHostTransport"
+    ],
+    "./extensions/server": [
+      "assertVerifiedScope",
+      "createExtensionHandler",
+      "createRootAdmissionConsumer",
+      "defineAction",
+      "defineExtension",
+      "digest",
+      "releaseDigest"
+    ],
+    "./extensions/postgres": [
+      "lookupPostgresOperation",
+      "oncePostgresOperation",
+      "postgresHealth",
+      "withPostgresScope"
+    ],
+    "./extensions/drizzle": [
+      "drizzleHealth",
+      "lookupDrizzleOperation",
+      "onceDrizzleOperation",
+      "withDrizzleScope"
+    ],
+    "./extensions/prisma": [
+      "lookupPrismaOperation",
+      "oncePrismaOperation",
+      "prismaHealth",
+      "withPrismaScope"
+    ]
   }
 }

package/docs/README.md

@@ -0,0 +1,90 @@
+# Atelier documentation
+
+Choose a starting path, then use the task guides and references for the installed version.
+The [responsibility architecture](reference/architecture.md) and versioned contracts remain the existing authorities.
+
+## Start here
+
+- [Start Atelier independently](start/independent-start.md)
+- [Install](start/install.md)
+- [Set up a graph that earns its context](start/knowledge-setup.md)
+- [Start a research workspace](start/research-starter-quickstart.md)
+
+## Task guides
+
+- [Atelier Sync: headless repository supervision](guides/atelier-sync.md)
+- [Capability stewardship](guides/capability-stewardship.md)
+- [Co-authoring with agents](guides/co-authoring.md)
+- [Distributions](guides/distributions.md)
+- [Local exact-plan upgrades](guides/exact-upgrades.md)
+- [Custom database extensions](guides/extensions.md)
+- [Upgrade with your agent](guides/guided-upgrades.md)
+- [Progressive local ingestion](guides/ingestion.md)
+- [Discovery Harness and Research Harness](guides/inquiry-harnesses.md)
+- [Knowledge workspaces and guided coauthoring](guides/knowledge-workspace.md)
+- [Knowledge development and the learning cycle](guides/learning-harnesses.md)
+- [Learning from corrections and outcomes](guides/learning.md)
+- [Local source review](guides/local-review.md)
+- [Obsidian projection: selection, apply policy and acceptance receipts](guides/obsidian.md)
+- [Personal workspace composition](guides/personal-workspace.md)
+- [Research starter](guides/research-starter.md)
+- [Skill stewardship](guides/skill-steward.md)
+- [Local template adoption](guides/template-upgrades.md)
+- [Tenant Readiness Guide](guides/tenant-readiness.md)
+- [Upgrade Guide](guides/upgrade.md)
+
+## Architecture and API reference
+
+- [Announcements](reference/announcements.md)
+- [Responsibilities, workflows and runtime bindings](reference/architecture.md)
+- [MNSTRY Atelier Runtime](reference/atelier-runtime.md)
+- [Attestation](reference/attestation.md)
+- [Experimental portable coauthor session](reference/coauthor-session.md)
+- [Connected composition: synthetic foundation](reference/connected-composition.md)
+- [Distribution continuity commitment](reference/continuity.md)
+- [Contract stability](reference/contract-stability.md)
+- [Portable Coordination and native authority](reference/coordination.md)
+- [Decision practices](reference/decision-practices.md)
+- [Typed decision proposals](reference/decisions.md)
+- [The design](reference/design.md)
+- [Evidence navigation](reference/evidence-navigation.md)
+- [Pack compatibility for evidence-bound review](reference/extension-pack-lifecycle.md)
+- [Immutable intake and guide integration](reference/intake-and-guides.md)
+- [Interaction and Reflection](reference/interaction-and-reflection.md)
+- [MNSTRY Atelier Knowledge Graph](reference/knowledge-graph.md)
+- [Managed local services](reference/local-services.md)
+- [Durable local state](reference/local-state.md)
+- [Obsidian projection contract](reference/obsidian-contract.md)
+- [Atelier's Obsidian plugin](reference/obsidian-plugin.md)
+- [Atelier export ontology](reference/ontology.md)
+- [Optional ingestion suppliers](reference/optional-ingestion.md)
+- [Portability: what a record holds and what the checks prove](reference/portability.md)
+- [Portable presentation v1](reference/portable-presentation.md)
+- [Phronesis — practical judgment](reference/phronesis.md)
+- [Presentation and public-page consumers](reference/presentation-consumer-boundaries.md)
+- [Project option and command inventory](reference/project-command-inventory.md)
+- [Project location and repository overrides](reference/project-options.md)
+- [Repo Boundary Guard V1](reference/repo-boundary-guard.md)
+- [Review state and portable inspection](reference/review-portability.md)
+- [Vanilla semantic proposal processor](reference/semantic-ingestion.md)
+- [Semantic operation: internal vanilla profile](reference/semantic-operation.md)
+- [Portable template profiles](reference/template-profile.md)
+- [Trackables: one definition, one domain writer](reference/trackables.md)
+- [Portable private artifact vaults (experimental)](reference/vault-service.md)
+
+## Maintainer controls
+
+- [Assurance controls and evidence map](maintainers/assurance-controls.md)
+- [Describing the Atelier](maintainers/describing-the-atelier.md)
+- [Release engineering](maintainers/release-engineering.md)
+
+## Knowledge Health
+
+- [Collection overview](knowledge-health/readme.md)
+- [Public workshop](knowledge-health/quickstart.md)
+- [Participant response and recovery](knowledge-health/participant-response.md)
+- [Facilitator guide](knowledge-health/facilitator.md)
+- [Assessment example](knowledge-health/assessment/quickstart.md)
+- [Participatory host API](knowledge-health/api.md)
+
+The [claim blocks](blocks/) supply the canonical promise text embedded in the package README.

package/docs/blocks/capability-stewardship.md

@@ -14,4 +14,4 @@ Installation, host discovery and successful exercise are separate evidence.
 Content-free observations can guide improvement, and draft graph records keep
 provenance connected to adoption and outcomes. Publisher authentication, live
 host evaluation and human acceptance require their own evidence. This source
-capability is intended for the next release; alpha.7 does not expose its command.
+capability has shipped as the `capability` command since 0.2.0-alpha.13.

package/docs/blocks/claims.md

@@ -14,7 +14,7 @@ platform logins must uniquely match declared login mappings. Repository identity
 checks may invoke `gh api repos/...` to resolve a canonical GitHub identity.
 Those authenticated requests use your own `gh` credentials. Recorded repository
 identities let identity checks keep working when the provider is unavailable.
-See `docs/install.md` for the full attribution precedence and mode semantics.
+See `docs/start/install.md` for the full attribution precedence and mode semantics.
 Explicitly enrolled Atelier Sync may also run bounded Git fetches
 for observation/reconciliation and one non-force push only when the exact
 reviewed commit plan requested and confirmed it, no earlier local commit is
@@ -69,6 +69,6 @@ service, no network:
 atelier dry-run ./atelier-export.json
 ```
 
-`docs/continuity.md` records the distribution commitments behind these
+`docs/reference/continuity.md` records the distribution commitments behind these
 claims, including the perpetual Apache-2.0 grant on every tagged release you
 receive.

package/docs/blocks/conformance-admission.md

@@ -9,7 +9,7 @@ Admission is a narrower, opt-in decision: whether a MNSTRY governed runtime
 accepts a document for delivery to the people it serves. That is what
 admission buys — delivery through a runtime that enforces consent and
 visibility at serve time — and it takes the form of a signed MNSTRY
-attestation against criteria this package publishes (`docs/attestation.md`).
+attestation against criteria this package publishes (`docs/reference/attestation.md`).
 The criteria are public, the checker is private, and the rejection message
 is part of the contract. You can build on the Atelier without ever talking
 to MNSTRY, and a document MNSTRY declines can still be fully conformant.

package/docs/blocks/learning-harnesses.md

@@ -10,7 +10,7 @@ attempts and distinct verification gates. Its coordination proposal can be read
 by Fabric or another adapter. The shared harness contract connects these workflows
 to Discovery, Research and Skill Steward without replacing their domain records.
 
-These are local, provider-neutral source capabilities for the next release.
+These are local, provider-neutral capabilities, shipped since 0.2.0-alpha.13.
 Handoffs preserve exact pins, and explicit source snapshots reveal corrections
 that require downstream reconsideration. Graph outputs remain draft proposals.
 Recorded acceptance is not authenticated authority, and local checks do not prove

package/docs/{atelier-sync.md → guides/atelier-sync.md}

@@ -1,9 +1,14 @@
-# Atelier Sync: Deliverable Zero
+# Atelier Sync: headless repository supervision
 
-Atelier Sync is the collaborator-facing name for the resident repository
-supervisor. Deliverable Zero is deliberately headless: it proves the Git,
-filesystem, state-machine, recovery, and user-authority boundaries before a
-tray shell or installer is allowed to make the product feel finished.
+Atelier Sync is the optional headless repository supervisor in the public
+Atelier toolkit. Its CLI and runtime APIs cover Git, filesystem, state-machine,
+recovery and user-authority boundaries. Use the [independent local start](../start/independent-start.md)
+for authoring without enabling supervision.
+
+The public toolkit includes no desktop utility, tray shell or native installer.
+MNSTRY's desktop utility is a separate proprietary consumer. Generic startup,
+editor and native-presentation bindings remain optional public tooling; a host
+owns its installation, background lifecycle and user interface.
 
 This is repository mechanics, not MNSTRY runtime authority. A Git commit
 changes the enrolled repository. It does not mutate MNSTRY identity, consent,
@@ -20,7 +25,7 @@ runtime object.
   credentials continue through ordinary Git credential helpers. Git `2.40.0`
   or newer is required so global and system attribute provenance is observable.
 - Every cycle observes the full repository. There is no watcher correctness
-  dependency in Deliverable Zero.
+  dependency.
 - Fetch and fast-forward-only reconciliation are mechanical operations.
 - Commit creation is a two-phase, user-confirmed operation. Planning records
   the head, branch, complete status digest, exact file paths, commit message,
@@ -74,8 +79,8 @@ contains the current `atelier-repository-observation@v1` document. That
 observation cannot report `complete: true` when any of these are unresolved:
 
 - lexically identifiable provider-managed, UNC/network, WSL-cross-boundary, or
-  unclassified external filesystem roots (mapped-drive classification remains
-  an operating-system integration concern for the signed beta);
+  unclassified external filesystem roots (mapped-drive classification requires
+  a qualified operating-system host integration);
 - an unsupported Git engine or bare repository;
 - sparse checkout, partial clone, or shallow repository state;
 - tracked paths carrying `assume-unchanged` or `skip-worktree` index flags;
@@ -151,8 +156,8 @@ process exit when their result is not healthy, so automation cannot treat a
 paused state, attention state, or failed publication as success merely because
 JSON was emitted.
 
-The future native shell may label the final two commands **Commit & sync**.
-It must not bypass either phase.
+A consuming host may present the final two commands as **Commit & sync**.
+It must preserve both phases and their exact confirmation boundary.
 
 The repeated operation id is a visible user-intent confirmation gate, not an
 authorization secret. Local software able to read and modify the repository is
@@ -161,12 +166,13 @@ or stale execution, not a hostile process with the user's filesystem access.
 
 ## Evidence boundary
 
-Deliverable Zero proves the headless supervisor contract on Linux and macOS,
+The headless supervisor contract has automated coverage on Linux and macOS,
 with Windows CI covering the portable observation, state, and direct-process
 contract. POSIX executable-wrapper substitution is explicitly skipped on
 Windows; native Windows wrapper-injection proof, signed installation,
 background launch at user login, Windows Home/Pro device behavior, macOS
-notarization, and a nontechnical-user workflow belong to the signed
-collaborator beta. Repositories without an initial commit are not supported by
-this deliverable. A Git executable upgrade changes enrolled identity and
+notarization and a nontechnical-user workflow require separate evidence from
+the consuming host. These tests establish no installed desktop qualification.
+Repositories without an initial commit are unsupported by this supervisor.
+A Git executable upgrade changes enrolled identity and
 requires re-enrollment.

package/docs/{capability-stewardship.md → guides/capability-stewardship.md}

@@ -1,9 +1,7 @@
 # Capability stewardship
 
-Status: source implementation for the next release. The published alpha.7
-package does not include the `capability` command. From this checkout, use
-`node bin/atelier.mjs capability ...`; the examples below use the installed
-command spelling for a package built from this source.
+Status: shipped since 0.2.0-alpha.13 as the `capability` command. The examples
+below use the installed command spelling.
 
 Atelier can package a useful workflow, introduce it alongside a person's
 existing skills, and keep each repository's adoption explainable over time.