@mnstry/atelier 0.2.0-alpha.6 → 0.2.0-alpha.8

package/fixtures/ui/presentation/reference.v1.json

@@ -0,0 +1,293 @@
+{
+  "schema": "atelier.presentation/v1",
+  "version": "1.0.0",
+  "id": "reference-desk",
+  "title": "Reference desk",
+  "lang": "en",
+  "direction": "ltr",
+  "theme": "light",
+  "density": "comfortable",
+  "navigation": [
+    {
+      "id": "nav-work",
+      "label": "Working area",
+      "target": "work"
+    },
+    {
+      "id": "nav-context",
+      "label": "Context",
+      "target": "context"
+    }
+  ],
+  "panes": [
+    {
+      "id": "work",
+      "label": "Working area",
+      "role": "primary",
+      "width": {
+        "min": 30,
+        "max": 75,
+        "value": 60
+      },
+      "blocks": [
+        "intro",
+        "draft-title",
+        "draft-body",
+        "comparison",
+        "preview",
+        "paper-image"
+      ]
+    },
+    {
+      "id": "context",
+      "label": "Context",
+      "role": "context",
+      "width": {
+        "min": 25,
+        "max": 60,
+        "value": 35
+      },
+      "blocks": [
+        "items",
+        "steps",
+        "graph",
+        "status",
+        "refusal",
+        "decision",
+        "receipt",
+        "offer",
+        "review",
+        "publication"
+      ]
+    }
+  ],
+  "nodes": [
+    {
+      "id": "paper-image",
+      "type": "media",
+      "label": "Paper illustration",
+      "src": "/paper.svg",
+      "alt": "A grey rectangular sheet on a plain background",
+      "caption": "Invented reference media; the host supplies the local asset."
+    },
+    {
+      "id": "intro",
+      "type": "text",
+      "label": "A small reference workspace",
+      "text": "Invented notes and objects exercise the presentation contract. Content, workflow and permissions belong to the host."
+    },
+    {
+      "id": "draft-title",
+      "type": "field",
+      "label": "Note title",
+      "value": "A study of paper shapes",
+      "input": "text",
+      "required": true,
+      "disabled": false
+    },
+    {
+      "id": "draft-body",
+      "type": "editor",
+      "label": "Draft text",
+      "value": "Arrange three paper shapes on the table.\nDescribe how their edges meet.",
+      "disabled": false
+    },
+    {
+      "id": "comparison",
+      "type": "diff",
+      "label": "Change preview",
+      "before": "Two paper shapes.",
+      "after": "Three paper shapes.",
+      "beforeLabel": "Earlier text",
+      "afterLabel": "Proposed text"
+    },
+    {
+      "id": "preview",
+      "type": "preview",
+      "label": "Read-only preview",
+      "text": "A study of paper shapes\n\nThree simple shapes share a table."
+    },
+    {
+      "id": "items",
+      "type": "collection",
+      "label": "Objects",
+      "items": [
+        {
+          "id": "circle",
+          "label": "Circle",
+          "detail": "Round edge",
+          "selected": true
+        },
+        {
+          "id": "square",
+          "label": "Square",
+          "detail": "Four equal edges",
+          "selected": false
+        }
+      ]
+    },
+    {
+      "id": "steps",
+      "type": "sequence",
+      "reorderable": true,
+      "label": "Reading order",
+      "items": [
+        {
+          "id": "observe",
+          "label": "Observe",
+          "selected": false
+        },
+        {
+          "id": "describe",
+          "label": "Describe",
+          "selected": false
+        }
+      ]
+    },
+    {
+      "id": "graph",
+      "type": "graph",
+      "label": "Connections",
+      "items": [
+        {
+          "id": "paper",
+          "label": "Paper"
+        },
+        {
+          "id": "shape",
+          "label": "Shape"
+        }
+      ],
+      "edges": [
+        {
+          "from": "paper",
+          "to": "shape",
+          "label": "folded into"
+        }
+      ]
+    },
+    {
+      "id": "status",
+      "type": "status",
+      "label": "Status",
+      "text": "Host-supplied status information.",
+      "tone": "neutral",
+      "details": [
+        {
+          "label": "Source",
+          "value": "Invented reference host"
+        }
+      ],
+      "actions": []
+    },
+    {
+      "id": "refusal",
+      "type": "refusal",
+      "label": "Refusal",
+      "text": "Host-supplied refusal information.",
+      "tone": "warning",
+      "details": [
+        {
+          "label": "Source",
+          "value": "Invented reference host"
+        }
+      ],
+      "actions": [
+        "disabled-action"
+      ]
+    },
+    {
+      "id": "decision",
+      "type": "decision",
+      "label": "Decision",
+      "text": "Host-supplied decision information.",
+      "tone": "neutral",
+      "details": [
+        {
+          "label": "Source",
+          "value": "Invented reference host"
+        }
+      ],
+      "actions": []
+    },
+    {
+      "id": "receipt",
+      "type": "receipt",
+      "label": "Receipt",
+      "text": "Host-supplied receipt information.",
+      "tone": "neutral",
+      "details": [
+        {
+          "label": "Source",
+          "value": "Invented reference host"
+        }
+      ],
+      "actions": []
+    },
+    {
+      "id": "offer",
+      "type": "offer",
+      "label": "Offer",
+      "text": "Host-supplied offer information.",
+      "tone": "neutral",
+      "details": [
+        {
+          "label": "Source",
+          "value": "Invented reference host"
+        }
+      ],
+      "actions": []
+    },
+    {
+      "id": "review",
+      "type": "review",
+      "label": "Review",
+      "text": "Host-supplied review information.",
+      "tone": "neutral",
+      "details": [
+        {
+          "label": "Source",
+          "value": "Invented reference host"
+        }
+      ],
+      "actions": []
+    },
+    {
+      "id": "publication",
+      "type": "publication",
+      "label": "Publication",
+      "text": "Host-supplied publication information.",
+      "tone": "neutral",
+      "details": [
+        {
+          "label": "Source",
+          "value": "Invented reference host"
+        }
+      ],
+      "actions": [
+        "confirm-action"
+      ]
+    },
+    {
+      "id": "confirm-action",
+      "type": "action",
+      "label": "Request publication",
+      "actionRef": "publish-request",
+      "disabled": false,
+      "confirmation": {
+        "title": "Request publication?",
+        "description": "This forwards a request to the host. It does not publish content or grant permission.",
+        "confirmLabel": "Send request",
+        "cancelLabel": "Keep editing"
+      }
+    },
+    {
+      "id": "disabled-action",
+      "type": "action",
+      "label": "Unavailable action",
+      "actionRef": "unavailable",
+      "disabled": true,
+      "reason": "The reference host has not supplied this capability."
+    }
+  ]
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@mnstry/atelier",
-  "version": "0.2.0-alpha.6",
+  "version": "0.2.0-alpha.8",
   "private": false,
-  "description": "Local toolkit that turns a Git repository into an ontology-governed knowledge graph, enforcement layer, and runtime for people, agents, and tools. No telemetry, service, or account.",
+  "description": "Local toolkit that turns a Git repository into an ontology-governed knowledge graph, enforcement layer, and runtime for people, agents, and tools. No telemetry or required hosted account; optional host-bound vault adapters.",
   "keywords": [
     "knowledge-graph",
     "ontology",
@@ -23,6 +23,23 @@
     "mnstry-atelier": "bin/mnstry-atelier.mjs"
   },
   "exports": {
+    "./decisions": "./src/decisions/contracts.mjs",
+    "./contracts/atelier-decision-request.v1.schema.json": "./contracts/atelier-decision-request.v1.schema.json",
+    "./contracts/atelier-decision-result.v1.schema.json": "./contracts/atelier-decision-result.v1.schema.json",
+    "./presentation": "./src/ui/presentation/index.mjs",
+    "./presentation/browser": "./src/ui/presentation/browser.mjs",
+    "./presentation/native": "./src/ui/presentation/native.mjs",
+    "./contracts/atelier-presentation.v1.schema.json": "./contracts/atelier-presentation.v1.schema.json",
+    "./contracts/atelier-pane-presentation.v1.schema.json": "./contracts/atelier-pane-presentation.v1.schema.json",
+    "./coauthor": "./src/coauthor/session.mjs",
+    "./skills": "./src/skills/steward.mjs",
+    "./intake": "./src/intake/store.mjs",
+    "./contracts/atelier-intake.v1.schema.json": "./contracts/atelier-intake.v1.schema.json",
+    "./guides": "./src/guides/contracts.mjs",
+    "./contracts/atelier-guide.v1.schema.json": "./contracts/atelier-guide.v1.schema.json",
+    "./contracts/atelier-skill-steward.v1.schema.json": "./contracts/atelier-skill-steward.v1.schema.json",
+    "./coauthor/store": "./src/coauthor/store.mjs",
+    "./contracts/atelier-coauthor.v1.schema.json": "./contracts/atelier-coauthor.v1.schema.json",
     ".": "./src/index.mjs",
     "./cli": "./src/cli/run.mjs",
     "./project": "./src/project/config.mjs",
@@ -47,7 +64,34 @@
     "./export-contract": "./src/export/atelier-export-contract.mjs",
     "./dry-run": "./src/validate-atelier-export-dry-run.mjs",
     "./contracts/atelier-export.v1.schema.json": "./contracts/atelier-export.v1.schema.json",
-    "./fixtures/atelier-export/sample-studio-offer.v1.json": "./fixtures/atelier-export/sample-studio-offer.v1.json"
+    "./fixtures/atelier-export/sample-studio-offer.v1.json": "./fixtures/atelier-export/sample-studio-offer.v1.json",
+    "./vault": "./src/vault/index.mjs",
+    "./contracts/atelier-vault-publication.v1.schema.json": "./contracts/atelier-vault-publication.v1.schema.json",
+    "./vault/source": "./src/vault/source.mjs",
+    "./contracts/atelier-adoption-policy.v1.schema.json": "./contracts/atelier-adoption-policy.v1.schema.json",
+    "./contracts/atelier-migration.v2.schema.json": "./contracts/atelier-migration.v2.schema.json",
+    "./contracts/atelier-upgrade-plan.v2.schema.json": "./contracts/atelier-upgrade-plan.v2.schema.json",
+    "./contracts/atelier-upgrade-receipt.v1.schema.json": "./contracts/atelier-upgrade-receipt.v1.schema.json",
+    "./local-state": "./src/project/durable-state.mjs",
+    "./obsidian": "./src/runtime/obsidian/index.mjs",
+    "./obsidian/contracts": "./src/projection/obsidian/contracts.mjs",
+    "./obsidian/materialize": "./src/projection/obsidian/materialize/index.mjs",
+    "./obsidian/publication": "./src/projection/obsidian/publication/index.mjs",
+    "./obsidian/recovery": "./src/projection/obsidian/recovery/index.mjs",
+    "./obsidian/edits": "./src/projection/obsidian/edits/index.mjs",
+    "./obsidian/proposals": "./src/projection/obsidian/proposals/index.mjs",
+    "./obsidian/selection": "./src/projection/obsidian/selection-ui/index.mjs",
+    "./contracts/atelier-obsidian-acceptance-receipt.v1.schema.json": "./contracts/atelier-obsidian-acceptance-receipt.v1.schema.json",
+    "./contracts/atelier-obsidian-apply-policy.v1.schema.json": "./contracts/atelier-obsidian-apply-policy.v1.schema.json",
+    "./contracts/atelier-obsidian-corpus-profile.v1.schema.json": "./contracts/atelier-obsidian-corpus-profile.v1.schema.json",
+    "./contracts/atelier-obsidian-edit-operation.v1.schema.json": "./contracts/atelier-obsidian-edit-operation.v1.schema.json",
+    "./contracts/atelier-obsidian-ext-settings.v1.schema.json": "./contracts/atelier-obsidian-ext-settings.v1.schema.json",
+    "./contracts/atelier-obsidian-generation-manifest.v1.schema.json": "./contracts/atelier-obsidian-generation-manifest.v1.schema.json",
+    "./contracts/atelier-obsidian-proposal-receipt.v1.schema.json": "./contracts/atelier-obsidian-proposal-receipt.v1.schema.json",
+    "./contracts/atelier-obsidian-publication-journal.v1.schema.json": "./contracts/atelier-obsidian-publication-journal.v1.schema.json",
+    "./contracts/atelier-obsidian-scope.v1.schema.json": "./contracts/atelier-obsidian-scope.v1.schema.json",
+    "./contracts/atelier-obsidian-service-state.v1.schema.json": "./contracts/atelier-obsidian-service-state.v1.schema.json",
+    "./contracts/atelier-obsidian-source-snapshot.v1.schema.json": "./contracts/atelier-obsidian-source-snapshot.v1.schema.json"
   },
   "scripts": {
     "contract": "node src/check-atelier-export-contract.mjs",
@@ -58,6 +102,7 @@
     "project:test": "node --test test/project.test.mjs test/project-config.test.mjs test/projection-policy.test.mjs test/projection-alignment.test.mjs",
     "server:security:test": "node --test test/server.test.mjs test/server-security.test.mjs test/server-proposals.test.mjs",
     "browser:smoke": "node --test test/server.test.mjs",
+    "presentation:proof": "node scripts/prove-presentation-browser.mjs",
     "support-bundle:test": "node --test test/support-bundle.test.mjs test/support-egress-analysis.test.mjs",
     "egress:check": "node bin/atelier.mjs egress check",
     "readiness:test": "node --test test/readiness.test.mjs test/readiness-summary.test.mjs test/readiness-protocol-contract.test.mjs test/readiness-protocols.test.mjs test/readiness-protocol-runtime.test.mjs",
@@ -65,6 +110,7 @@
     "collaboration:test": "node --test test/collaboration-ledger.test.mjs test/server-proposals.test.mjs",
     "sync:test": "node --test test/runtime-git-adapter.test.mjs test/runtime-observation.test.mjs test/runtime-supervisor.test.mjs",
     "boundary:test": "node --test test/boundary-policy-contract.test.mjs test/boundary-content-rules.test.mjs test/boundary-guard.test.mjs",
+    "obsidian:test": "node --test --test-concurrency=1 test/obsidian-acceptance.test.mjs test/obsidian-contract.test.mjs test/obsidian-edits.test.mjs test/obsidian-maintenance.test.mjs test/obsidian-materialization.test.mjs test/obsidian-open.test.mjs test/obsidian-package.test.mjs test/obsidian-proposals.test.mjs test/obsidian-publication-feasibility.test.mjs test/obsidian-recovery.test.mjs",
     "upgrade:test": "node --test test/upgrade-contract.test.mjs test/upgrade.test.mjs",
     "release:audit": "node scripts/check-release-tarball.mjs",
     "release:candidate": "node scripts/release-candidate.mjs",
@@ -80,10 +126,15 @@
   "dependencies": {
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",
-    "fast-uri": "3.1.5"
+    "fast-uri": "3.1.7"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0"
+    "@types/node": "^22.0.0",
+    "esbuild": "0.25.12",
+    "playwright": "1.55.1",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "typescript": "5.8.3"
   },
   "license": "Apache-2.0",
   "repository": {
@@ -118,6 +169,6 @@
     "access": "public"
   },
   "overrides": {
-    "fast-uri": "3.1.5"
+    "fast-uri": "3.1.7"
   }
 }

package/skills/claude/atelier-guided-coauthor/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: atelier-guided-coauthor
+description: Guide an author through a selected packet in Codex, retaining private source-bound draft answers and resuming through the local Atelier coauthor CLI.
+---
+
+# Guided coauthor
+
+Use the installed `atelier coauthor` command, not a browser conversation service.
+The author chooses the packet and may read it normally without this workflow.
+
+Check the repository's instructions and local package first. Run
+`./node_modules/.bin/atelier coauthor --help` from the intended repository.
+Do not download another package if the command is unavailable. Explain that the
+installed version needs the coauthor capability and preserve ordinary packet review.
+
+## Start or resume
+
+- Require an existing Git workspace with ignored, untracked `.atelier-local/`.
+  Do not change global skills, sibling repositories, credentials or remote access.
+- Read the selected packet. Use consumer-owned field ids and workspace-relative
+  source references. Compute SHA-256 over each source file's exact UTF-8 bytes.
+  Send a `start` request containing `config: {id, fields}`; each field has
+  `id` and `source: {ref, digest}`. Packet structure stays in the consumer.
+- Requests are JSON on stdin; responses are JSON. Use an ignored request file
+  when needed, not shell interpolation of the author's text. Read the returned
+  state and revision. `read` takes `sessionId` and resumes retained history.
+- Ask one useful question at a time. Record the author's exact answer with an
+  `answer` event; events carry a unique `id`, `expectedRevision` and `type`.
+  Do not infer an answer or approval from silence.
+- If proposing edited wording, use `propose` and show the change. Wait for the
+  author's explicit confirmation before `confirm`. `reject` restores the
+  original. Even apparently stylistic rewrites need confirmation.
+- Send `save` only for the agreed draft. Say “saved as a private draft” only
+  after the command returns a saved receipt. The source packet is never edited.
+  `continueAfterSave: true` on an answer retains the author's advance intent;
+  otherwise `advance` is explicit.
+- `pause` and `resume` preserve the current phase. On restart, a `saving`
+  state may use `recover` to reconcile the pending private write. A
+  `recovery` state requires explicit `retry`, with one retry available.
+  Stop retrying when exhausted and retain all artifacts for inspection.
+
+## Boundaries
+
+Never submit store-owned receipt/failure events or fabricate persistence evidence.
+A stale source or revision is a visible conflict, not permission to overwrite it.
+Keep the old history and obtain a newly bound session for revised sources.
+Saved answers are proposals for later owner review, not publication, canonical
+acceptance, guide access, or a completed packet. No saved-answer undo is provided;
+do not erase history to simulate it. Summarize unresolved questions for the meeting.

package/skills/claude/atelier-guided-upgrade/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: atelier-guided-upgrade
+description: Prepare and explain an Atelier package upgrade in an isolated candidate, retain the owner decision, and apply only the approved effects. Use for owners asking to update an existing Atelier.
+---
+
+# Guided Atelier upgrade
+
+The default outcome is a reviewable candidate and an owner decision. Preserve the
+owner's actual request and existing scoped authority; no per-command approval
+loop is needed for actions already authorized. Preparation alone never authorizes
+changing the working installation, merging, publishing or restarting a service.
+
+## Establish the source and workspace
+
+Read the selected repository's instructions and upgrade procedure. Identify its
+actual installed scoped package, package-manager lock, Atelier lock, Git state,
+project roots, packs, overlays and running-service ownership. Resolve the package
+from that workspace (including a parent install); never use global Atelier,
+unscoped registry fallback or the first sibling checkout found on disk.
+Read `docs/guided-upgrades.md` and `docs/exact-upgrades.md` from the selected
+installed package when present. If an old install lacks this skill or commands,
+use the owner-selected new package's documentation only after verifying its
+source. Repository instructions and owner authority still govern.
+
+Select an exact release through a source already trusted by the owner. Record
+version, source commit when verified, artifact URL/integrity and the dependency
+lock. Mutable dist-tags are discovery hints, not final pins. A declaration in a
+lock or a digest supplied beside a download does not authenticate a publisher.
+An unpublished candidate must be labeled as such; use it only in an expressly
+selected rehearsal. Never invent a release or replace a pinned install with main.
+
+## Prepare without disturbing authoring
+
+Use a separate candidate with an identified base. Preserve dirty source and
+private answers; do not stash, reset, clean, stop services or commit another
+writer's edits to create eligibility. If using a snapshot of current edits,
+record and recheck its exact manifest; it is a snapshot, not an adopted commit.
+Ignored answers, browser storage and runtime credentials are not in a Git clone.
+Record that gap without importing them into a public report or projection.
+
+Stage the selected package using the owner's package manager and lock procedure,
+with lifecycle scripts disabled; investigate any required scripts before execution.
+Verify the resolved identity and inventory before running its commands. Inspect
+migration/compatibility effects before rewriting the old Atelier lock. Retain the
+old lock and all lineage. Keep installation changes distinct from generated files.
+
+Check exact-plan eligibility: Linux/macOS, one managed repository at `.`, config
+and workspace at its root, linked candidate worktree, clean state and supported
+Git settings. Packs, overlays and other unsupported participants require the
+repository's explicit operator procedure. Do not broaden graph roots, remove
+policies or disable filters/hooks to force eligibility. Never silently fall back
+to legacy `upgrade --apply`; it has different guarantees.
+
+For an eligible candidate, prepare `upgrade plan --save`, then use
+`upgrade explain --plan SAVED_PLAN_PATH` (JSON) and `--format markdown` (owner
+view). Invoke the verified installed binary with the explicit project path.
+Inspect `bindingsCurrent` and blockers even when the explanation exits zero.
+Keep source/pin/policy installation commits and the saved projection plan separate.
+For an operator procedure, retain an exact before/after file manifest and named
+commands instead; do not call it an exact-plan transaction or invent its digest.
+
+## Explain and retain consent
+
+Present the local benefit, exact target, changed files, preserved customizations,
+checks, known limits, recovery coverage and proposed effects. Show installation,
+local commit, merge, publication and activation separately. Ask one concrete
+question covering the effects that still need authority. A permission to prepare
+or a generic earlier “go” does not approve a newly introduced material effect.
+A prior explicit approval of this same current plan and effects remains valid.
+
+Retain a new decision record in ignored, untracked
+`.atelier-local/guided-upgrades/` (or a private sibling evidence directory):
+`kind: owner-decision`, report and plan/manifest SHA-256, candidate base, target
+identity, exact owner words, conversation reference, observation time, decision
+(approve/defer/decline), allowed effects, and
+`humanApprovalAuthenticated: false`, `recordedBy: agent`.
+Do not invent identity, words, references or approvals; missing provenance is a
+reported gap. This is an agent-attested record, not an authenticated signature or
+an execution grant. Keep existing records immutable. Silence conveys no consent.
+
+## Apply, validate and close
+
+After actual approval, use the saved path and exact confirmation digest literally.
+Recheck bindings; changed or expired plans require a fresh explanation and any
+newly necessary decision. A consumed plan is inspected, never replayed.
+Run the repository's documented acceptance checks and inspect the actual diff.
+Only a verified terminal transaction receipt means a candidate commit completed.
+Honor existing hooks and keep source/answer files within their ownership boundary.
+An operator procedure has its own validation evidence, not a transaction receipt.
+
+Continue authorized merge/activation steps only when included in the owner's
+scope. Report prepared, installed-in-candidate, committed, merged and running as
+separate observed states. A local preview passing is not recipient acceptance.
+On failure, preserve the candidate, backups and receipts; explain what changed
+and the next safe action. Recovery inspection does not automatically restore
+files or reset Git. Do not publish source, restart an existing service or advance
+an author's workflow phase merely because upgrade checks passed.

package/skills/claude/atelier-open/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: atelier-open
+description: Open the local Atelier preview in the current client when asked to show the portal or current page.
+---
+
 # Open the Atelier
 
 Use this skill when someone says "open the atelier", "pull up the atelier",

package/skills/claude/atelier-skill-steward/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: atelier-skill-steward
+description: Audit, create, improve, reconcile, retire, or update an Atelier-backed agent skill catalog using evidence thresholds, behavioral checks, and reversible managed projections.
+---
+
+# Atelier skill steward
+
+Use this skill when a repository should maintain its agent skills as a coherent,
+self-improving catalog. Do not use it to turn a one-off preference into a skill,
+capture prompts or transcripts, or grant a skill new authority implicitly.
+
+## Route the work
+
+- Audit the current catalog with `atelier skills audit --json`.
+- Record only a content-free signal with `atelier skills observe`; use a stable
+  workflow key, enumerated signal, optional skill name, and outcome. Never put a
+  summary, prompt, source excerpt, person, client, or private method in the key.
+- Find evidence-thresholded work with `atelier skills candidates --json`.
+- Create or improve an authored skill only when the candidate evidence and the
+  current task establish a repeatable input, workflow, and success condition.
+- Update a repo-scoped deployed catalog with `atelier skills sync`. Review the
+  plan, then repeat its exact digest with `--apply --confirm`. Never manufacture
+  confirmation before inspecting blockers and actions.
+
+## Authoring boundary
+
+Keep each skill focused. Give `SKILL.md` lowercase kebab-case `name` and a
+discriminating `description`; put only decision-changing guidance in the body.
+Add scripts or references only when deterministic reuse or progressive
+disclosure justifies them. Test direct triggers, indirect triggers, incomplete
+inputs, non-triggers, and risky edge cases.
+
+In the public Atelier repository, read `AGENTS.md`, `CONTRIBUTING.md`, and
+`docs/release-engineering.md` before editing. Re-derive private lessons as
+generic invariants with invented fixtures. Keep Codex and Claude bundles
+byte-identical and run the repository disclosure and release gates required by
+those documents.
+
+## Promotion policy
+
+An instruction-only change that retains the same tools, data boundary, and
+external authority may advance after its behavioral checks and catalog audit
+pass. New scripts, tool dependencies, network access, filesystem scope,
+external messages, spending, destructive operations, credential handling, or
+audience changes require explicit human authorization immediately before that
+authority is introduced.
+
+Do not treat an audit pass as proof of behavioral quality. Compare the candidate
+against representative positive and negative requests. Reject it when it only
+memorizes one incident, broadens its trigger, weakens a refusal, or cannot name
+observable improvement.
+
+## Retirement and updates
+
+Remove obsolete skills from active discovery only after checking dependents and
+supersession. Preserve recovery through Git or the sync quarantine; never
+permanently delete a managed deployed bundle during sync. A locally drifted or
+unmanaged target is a blocker, not permission to overwrite it.
+
+The steward has no model provider, telemetry, send path, browser apply endpoint,
+or hidden source-mutation authority. Scheduling may invoke this workflow, but a
+schedule does not widen its permissions or lower its evidence gates.

package/skills/claude/mnstry-readiness/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: mnstry-readiness
+description: Prepare or review Atelier readiness outputs for a project workspace using its readiness protocols.
+---
+
 # MNSTRY Readiness
 
 Use this skill when preparing or reviewing MNSTRY Atelier readiness outputs for