@mnstry/atelier 0.2.0-alpha.12 → 0.2.0-alpha.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnstry/atelier",
-  "version": "0.2.0-alpha.12",
+  "version": "0.2.0-alpha.14",
   "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 or required hosted account; optional host-bound vault adapters.",
   "keywords": [
@@ -23,9 +23,20 @@
     "mnstry-atelier": "bin/mnstry-atelier.mjs"
   },
   "exports": {
+    "./templates": "./src/templates/profile.mjs",
+    "./template-bindings": "./src/template-bindings/project.mjs",
+    "./contracts/atelier-template-profile.v1.schema.json": "./contracts/atelier-template-profile.v1.schema.json",
     "./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",
+    "./ingestion": "./src/ingestion/store.mjs",
+    "./ingestion/processors": "./src/ingestion/processors.mjs",
+    "./ingestion/evaluation": "./src/ingestion/evaluation.mjs",
+    "./contracts/atelier-ingestion.v1.schema.json": "./contracts/atelier-ingestion.v1.schema.json",
+    "./learning": "./src/learning/store.mjs",
+    "./learning/assistance": "./src/learning/assistance.mjs",
+    "./learning/adapters": "./src/learning/adapters.mjs",
+    "./contracts/atelier-learning.v1.schema.json": "./contracts/atelier-learning.v1.schema.json",
     "./presentation": "./src/ui/presentation/index.mjs",
     "./presentation/browser": "./src/ui/presentation/browser.mjs",
     "./presentation/native": "./src/ui/presentation/native.mjs",
@@ -33,6 +44,8 @@
     "./contracts/atelier-pane-presentation.v1.schema.json": "./contracts/atelier-pane-presentation.v1.schema.json",
     "./coauthor": "./src/coauthor/session.mjs",
     "./skills": "./src/skills/steward.mjs",
+    "./capabilities": "./src/capabilities/index.mjs",
+    "./contracts/atelier-capability.v1.schema.json": "./contracts/atelier-capability.v1.schema.json",
     "./intake": "./src/intake/store.mjs",
     "./contracts/atelier-intake.v1.schema.json": "./contracts/atelier-intake.v1.schema.json",
     "./guides": "./src/guides/contracts.mjs",
@@ -48,6 +61,7 @@
     "./readiness": "./src/readiness/readiness.mjs",
     "./readiness-protocols": "./src/readiness-protocols/bundled-pack.mjs",
     "./server": "./src/server/local-sidecar.mjs",
+    "./ui": "./src/ui/control-system.mjs",
     "./harness": "./src/harness/context.mjs",
     "./collaboration": "./src/collaboration/index.mjs",
     "./support": "./src/support/support-bundle.mjs",
@@ -55,6 +69,10 @@
     "./disclosure": "./src/disclosure/content-scan.mjs",
     "./boundary": "./src/boundary/policy.mjs",
     "./upgrade": "./src/upgrade/upgrade.mjs",
+    "./contracts/atelier-adoption-policy.v2.schema.json": "./contracts/atelier-adoption-policy.v2.schema.json",
+    "./contracts/atelier-migration.v3.schema.json": "./contracts/atelier-migration.v3.schema.json",
+    "./contracts/atelier-template-adoption.v1.schema.json": "./contracts/atelier-template-adoption.v1.schema.json",
+    "./contracts/atelier-upgrade-plan.v3.schema.json": "./contracts/atelier-upgrade-plan.v3.schema.json",
     "./attestation": "./src/attestation/sign.mjs",
     "./extension-packs": "./src/extension-packs/loader.mjs",
     "./analysis/adapter": "./src/analysis/adapter.mjs",
@@ -92,7 +110,43 @@
     "./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"
+    "./contracts/atelier-obsidian-source-snapshot.v1.schema.json": "./contracts/atelier-obsidian-source-snapshot.v1.schema.json",
+    "./inquiry": "./src/inquiry/index.mjs",
+    "./contracts/atelier-inquiry.v1.schema.json": "./contracts/atelier-inquiry.v1.schema.json",
+    "./harnesses": "./src/harnesses/index.mjs",
+    "./knowledge": "./src/knowledge/index.mjs",
+    "./knowledge-health": "./src/knowledge-health/index.mjs",
+    "./evidence-navigation": "./src/evidence-navigation/index.mjs",
+    "./evidence-navigation/local": "./src/evidence-navigation/local.mjs",
+    "./personal-workspace": "./src/personal-workspace/index.mjs",
+    "./build": "./src/build/index.mjs",
+    "./contracts/atelier-harness.v1.schema.json": "./contracts/atelier-harness.v1.schema.json",
+    "./contracts/atelier-knowledge.v1.schema.json": "./contracts/atelier-knowledge.v1.schema.json",
+    "./contracts/atelier-evidence-navigation.v1.schema.json": "./contracts/atelier-evidence-navigation.v1.schema.json",
+    "./contracts/atelier-personal-workspace-manifest.v1.schema.json": "./contracts/atelier-personal-workspace-manifest.v1.schema.json",
+    "./contracts/atelier-personal-workspace-overlay.v1.schema.json": "./contracts/atelier-personal-workspace-overlay.v1.schema.json",
+    "./contracts/atelier-build.v1.schema.json": "./contracts/atelier-build.v1.schema.json",
+    "./architecture": "./src/architecture/index.mjs",
+    "./contracts/atelier-architecture.v1.schema.json": "./contracts/atelier-architecture.v1.schema.json",
+    "./judgment": "./src/judgment/index.mjs",
+    "./contracts/atelier-judgment.v1.schema.json": "./contracts/atelier-judgment.v1.schema.json",
+    "./contracts/atelier-instruction-adoption.v1.schema.json": "./contracts/atelier-instruction-adoption.v1.schema.json",
+    "./trackables": "./src/trackables/store.mjs",
+    "./contracts/atelier-trackable.v1.schema.json": "./contracts/atelier-trackable.v1.schema.json",
+    "./reflection": "./src/reflection/index.mjs",
+    "./interaction": "./src/interaction/index.mjs",
+    "./coordination": "./src/coordination/index.mjs",
+    "./contracts/atelier-interaction.v1.schema.json": "./contracts/atelier-interaction.v1.schema.json",
+    "./contracts/atelier-coordination.v1.schema.json": "./contracts/atelier-coordination.v1.schema.json",
+    "./ingestion/optional": "./src/ingestion/optional/index.mjs",
+    "./ingestion/composition": "./src/ingestion/optional/composition/index.mjs",
+    "./ingestion/qualification": "./src/ingestion/optional/evaluation/index.mjs",
+    "./ingestion/vanilla": "./src/ingestion/optional/vanilla/composition-binding.mjs",
+    "./ingestion/native-normalization": "./src/ingestion/optional/vanilla/native-normalization.mjs",
+    "./ingestion/jev": "./src/ingestion/optional/jev/composition-binding.mjs",
+    "./ingestion/jev/judgments": "./src/ingestion/optional/jev/judgments.mjs",
+    "./ingestion/graphify": "./src/ingestion/optional/graphify/composition-binding.mjs",
+    "./ingestion/lightrag": "./src/ingestion/optional/lightrag/composition-binding.mjs"
   },
   "scripts": {
     "contract": "node src/check-atelier-export-contract.mjs",
@@ -104,6 +158,7 @@
     "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",
+    "knowledge:consumer-proof": "node scripts/prove-knowledge-consumer.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",
@@ -111,7 +166,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-first-open-real-app.test.mjs test/obsidian-maintenance.test.mjs test/obsidian-materialization.test.mjs test/obsidian-open.test.mjs test/obsidian-package.test.mjs test/obsidian-plugin.test.mjs test/obsidian-proposals.test.mjs test/obsidian-publication-feasibility.test.mjs test/obsidian-recovery.test.mjs test/obsidian-vault-layout.test.mjs",
+    "obsidian:test": "node --test --test-concurrency=1 test/obsidian-acceptance.test.mjs test/obsidian-contract.test.mjs test/obsidian-direct-unheld.test.mjs test/obsidian-edits.test.mjs test/obsidian-first-open-real-app.test.mjs test/obsidian-login-item.test.mjs test/obsidian-maintenance.test.mjs test/obsidian-materialization.test.mjs test/obsidian-open.test.mjs test/obsidian-package.test.mjs test/obsidian-plugin.test.mjs test/obsidian-proposals.test.mjs test/obsidian-publication-feasibility.test.mjs test/obsidian-recovery.test.mjs test/obsidian-vault-layout.test.mjs test/obsidian-vault-location.test.mjs test/obsidian-views.test.mjs test/obsidian-only-you.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",
@@ -127,7 +182,7 @@
   "dependencies": {
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",
-    "fast-uri": "3.1.7"
+    "fast-uri": "3.1.8"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
@@ -173,6 +228,6 @@
     "access": "public"
   },
   "overrides": {
-    "fast-uri": "3.1.7"
+    "fast-uri": "3.1.8"
   }
 }

package/plugins/obsidian/main.js

@@ -196,11 +196,14 @@ class AtelierStatusModal extends obsidian.Modal {
 class AtelierProjectionPlugin extends obsidian.Plugin {
   async onload() {
     this.channel = null
+    this.lastObservedStatus = null
     this.session = null
     this.cycling = null
     this.unloaded = false
+    this.channelAdmitted = false
     this.view = { state: 'connecting', reason: 'not-yet-asked', report: null }
     this.shownState = null
+    this.noticeState = null
     // A round's failure that differs from the failure shown, not yet seen twice in a row.
     this.pendingFailure = null
     this.appVersion = typeof obsidian.apiVersion === 'string' ? obsidian.apiVersion : null
@@ -226,6 +229,7 @@ class AtelierProjectionPlugin extends obsidian.Plugin {
       this.setView({ state: 'not-set-up', reason: 'node-modules-unavailable', report: null })
       return
     }
+    this.channelAdmitted = true
     // This launch of the plugin: the service tells two apps holding the same vault apart by it.
     this.instanceId = `pi-${this.crypto.randomBytes(16).toString('hex')}`
     await this.readChannel()
@@ -238,6 +242,8 @@ class AtelierProjectionPlugin extends obsidian.Plugin {
     // The lease lapses by itself; releasing it says at once that the vault closed. A round still under way stops at its
     // next step, and a session it opens after this is released at once.
     this.unloaded = true
+    this.channelAdmitted = false
+    this.lastObservedStatus = null
     const session = this.session
     this.session = null
     if (this.channel && session) void this.release(this.channel, session)
@@ -245,6 +251,7 @@ class AtelierProjectionPlugin extends obsidian.Plugin {
 
   // Obsidian calls this when data.json changed on disk: Atelier republished the channel.
   async onExternalSettingsChange() {
+    if (!this.channelAdmitted || this.unloaded) return
     await this.readChannel()
     // A round under way still speaks for the old channel; the next one uses the new.
     if (this.cycling) await this.cycling
@@ -252,13 +259,19 @@ class AtelierProjectionPlugin extends obsidian.Plugin {
   }
 
   async readChannel() {
+    if (!this.channelAdmitted || this.unloaded) return
     let data = null
     try { data = await this.loadData() } catch { data = null }
+    if (!this.channelAdmitted || this.unloaded) return
     const next = channelOf(data)
     const same = next && this.channel && next.host === this.channel.host && next.port === this.channel.port && next.scopeId === this.channel.scopeId && next.bearer === this.channel.bearer
-    if (!same) this.session = null
+    if (!same) {
+      this.session = null
+      this.lastObservedStatus = null
+    } else if (this.lastObservedStatus?.channel === this.channel) this.lastObservedStatus.channel = next
     this.channel = next
     if (next === null) this.setView({ state: 'not-set-up', reason: data === null ? 'no-channel-data' : 'channel-data-unusable', report: null })
+    else if (!same) this.setView({ state: 'connecting', reason: 'not-yet-asked', report: null })
   }
 
   // One round: shake hands (once per session), renew the lease, read the status.
@@ -270,12 +283,12 @@ class AtelierProjectionPlugin extends obsidian.Plugin {
 
   // Whether a round that started for `channel` may still act.
   current(channel) {
-    return !this.unloaded && channel === this.channel
+    return this.channelAdmitted && !this.unloaded && channel === this.channel
   }
 
   async runCycle() {
     const channel = this.channel
-    if (channel === null || this.unloaded) return
+    if (!this.channelAdmitted || channel === null || this.unloaded) return
     if (this.session === null) {
       if (!(await this.handshake(channel))) return
     } else {
@@ -290,6 +303,7 @@ class AtelierProjectionPlugin extends obsidian.Plugin {
           return
         }
         // The service started again since, the vault's key changed, or the session is not accepted: shake hands at once.
+        this.lastObservedStatus = null
         if (!(await this.handshake(channel))) return
       }
     }
@@ -386,13 +400,18 @@ class AtelierProjectionPlugin extends obsidian.Plugin {
 
   unreachable(answer) {
     const reason = answer.kind === 'unreachable' ? answer.code : typeof answer.error === 'string' ? answer.error : answer.body && typeof answer.body.error === 'string' ? answer.body.error : `answered-${answer.statusCode}`
-    return { state: 'unreachable', reason, report: null }
+    // Retain history only for a transport interruption, never an unsealed or
+    // refused answer, failed listener proof or unknown authentication state.
+    const transportFailure = answer.kind === 'unreachable' && ['refused', 'timeout'].includes(answer.code)
+    return { state: 'unreachable', reason, report: null, transportFailure }
   }
 
   // What a round found. A failure other than the one shown ('not set up' where 'service unreachable' is shown, or the other
   // way round) is shown only when the next round finds it too, so answers that alternate between them do not make the
   // status bar flip. Anything else is shown at once.
   showRound(view) {
+    // A setup refusal clears remembered evidence even while its label is debounced.
+    if (view.state === 'not-set-up' || (view.state === 'unreachable' && view.transportFailure !== true)) this.lastObservedStatus = null
     if (ROUND_FAILURES.has(view.state) && ROUND_FAILURES.has(this.shownState) && view.state !== this.shownState && this.pendingFailure !== view.state) {
       this.pendingFailure = view.state
       return
@@ -404,11 +423,32 @@ class AtelierProjectionPlugin extends obsidian.Plugin {
     // Nothing is shown once the plugin unloaded.
     if (this.unloaded) return
     this.pendingFailure = null
-    const previous = this.shownState
+    const previous = this.noticeState
+    // A transient display projection, never a freshness or permission record.
+    // Only a report of this exact channel may be remembered. `channel` is an
+    // in-memory identity binding, never shown or stored; the other fields hold
+    // no service health, edit counts, source content or credentials.
+    if (!this.channel || view.state === 'not-set-up' || view.state === 'unsupported' || (view.state === 'unreachable' && view.transportFailure !== true)) this.lastObservedStatus = null
+    else if (view.report !== null) {
+      const report = view.report
+      const observed = isPlainObject(report) && report.schema === CHANNEL.statusSchema && report.scopeId === this.channel.scopeId && isPlainObject(report.view) && report.view.state !== 'disabled' ? report.view : null
+      this.lastObservedStatus = observed === null ? null : {
+        channel: this.channel, state: view.state, reason: view.reason,
+        generationId: typeof observed.generationId === 'string' ? observed.generationId : null,
+        checkedAt: typeof observed.checkedAt === 'string' ? observed.checkedAt : null,
+      }
+    }
     this.view = view
     this.statusBarEl.setText(labelOf(view))
     this.statusBarEl.setAttr('aria-label', `${labelOf(view)} (${readable(view.reason)})`)
     this.shownState = view.state
+    // A republished channel resets the display before its first answer, but
+    // does not repeat attention notices or erase the recovery transition.
+    if (view.state === 'connecting') {
+      if (previous === null) this.noticeState = view.state
+      return
+    }
+    this.noticeState = view.state
     if (previous === view.state || previous === null) return
     if (Object.prototype.hasOwnProperty.call(ATTENTION, view.state)) new obsidian.Notice(ATTENTION[view.state](view))
     else if (view.state === 'current' && Object.prototype.hasOwnProperty.call(ATTENTION, previous)) new obsidian.Notice('Atelier: this view is current again.')
@@ -419,13 +459,22 @@ class AtelierProjectionPlugin extends obsidian.Plugin {
     const view = isPlainObject(report.view) ? report.view : {}
     const count = (value) => (Number.isInteger(value) ? String(value) : 'unknown')
     const channel = this.channel
+    const last = this.lastObservedStatus?.channel === channel ? this.lastObservedStatus : null
+    const missingGeneration = this.view.state === 'unreachable' ? 'unknown' : 'none yet'
+    const missingCheck = this.view.state === 'unreachable' ? 'unknown' : 'not yet'
     return [
       ['View', channel ? channel.scopeId : 'not set up'],
       ['State', labelOf(this.view).replace(/^Atelier: /, '')],
       ['Reason', readable(this.view.reason)],
-      ['Generation', typeof view.generationId === 'string' ? view.generationId : 'none yet'],
-      ['Prepared generation', typeof view.preparedGenerationId === 'string' ? view.preparedGenerationId : 'none yet'],
-      ['Checked at', typeof view.checkedAt === 'string' ? view.checkedAt : 'not yet'],
+      ...(this.view.state !== 'unreachable' ? [] : last ? [
+        ['Last observed state', readable(last.state)],
+        ['Last observed reason', readable(last.reason)],
+        ['Last observed generation', last.generationId || 'none yet'],
+        ['Last observed check', last.checkedAt || 'not yet'],
+      ] : [['Last observed status', 'not available']]),
+      ['Generation', typeof view.generationId === 'string' ? view.generationId : missingGeneration],
+      ['Prepared generation', typeof view.preparedGenerationId === 'string' ? view.preparedGenerationId : missingGeneration],
+      ['Checked at', typeof view.checkedAt === 'string' ? view.checkedAt : missingCheck],
       ['Held edits', count(view.heldNoteCount)],
       ['Retained edits', count(view.retainedEdits)],
       ['Pending edits', count(isPlainObject(report.pendingEdits) ? report.pendingEdits.open : null)],

package/plugins/obsidian/manifest.json

@@ -1,7 +1,7 @@
 {
   "id": "atelier-projection",
   "name": "Atelier",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "minAppVersion": "1.13.7",
   "description": "Shows whether this Atelier view is current and tells Atelier's maintenance service that the vault is open. Shipped by Atelier into the vaults it manages.",
   "author": "MNSTRY",

package/skills/claude/atelier-build-harness/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: atelier-build-harness
+description: Turn an accepted objective into a bounded, evidence-backed deliverable with candidate custody, dependencies, verification gates, recovery and delivery acceptance. Use for implementation and cross-repository delivery coordination.
+---
+
+# Build Harness
+
+People establish the objective and acceptance criteria; agents implement admitted
+work; owners review consequential decisions and actual delivery. Coordinate with
+the user's existing coding, testing, review and CI tools. Fabric may consume the
+coordination proposal; creating that proposal does not enroll or wake an owner.
+
+## Bound the work
+
+Establish purpose, owner, scope, acceptance criteria, required gates, admitted
+effects, attempt budget and stopping rule. A dependency names the exact producer
+artifact and the receiving need. Shared initiative membership creates no dependency
+or authority. Keep independent work moving while a concrete prerequisite is absent.
+
+Use `atelier harness build` and `@mnstry/atelier/build`, with the shared
+`@mnstry/atelier/harnesses` records. `atelier build` retains its older projection
+meaning. The reference example has simulated reviews and CI: never reuse its
+approval reports as real evidence. If tooling is missing, prepare a plan and report
+the gap without fabricating execution.
+
+## Implement and verify
+
+Reserve an isolated writer lane or follow the repository's existing custody
+mechanism. Preserve local edits and do not claim another task's ownership.
+Implement against the admitted inputs. Use existing tools to run appropriate
+tests and actual review/CI workflows only within the task's authority.
+
+The read-only Git adapter binds clean committed source and selected artifact bytes.
+A writer declaration remains caller-reported. Record the exact commit, tree,
+artifact digest, skill binding and evidence; a changed candidate needs new proof.
+
+Persist an attempt intent before invoking an external executor. These records do
+not invoke tools. On uncertain dispatch, preserve its identity and reconcile the
+existing attempt before retrying. A completed transport or command does not satisfy
+a review or CI gate. Keep unavailable, failed and passed evidence distinct.
+
+## Integrate and return learning
+
+Evaluate the current candidate, every required gate and current dependency
+snapshots. Report missing evidence and candidate changes without treating stale
+receipts as current. Review, CI, integration, delivery and recipient acceptance
+remain distinct. Record only the actual owner's decision and observed delivery.
+The harness reports consistency; repository and host controls enforce authority.
+
+Prepare a coordination proposal for the existing owner/coordinator. Do not create
+tasks, send messages, publish or deploy from a manifest alone. Emit an accepted
+artifact handoff to Knowledge Harness, preserving assumptions, limitations and
+the evidence behind the result. Research quality or business usefulness cannot
+be inferred from a successful build.
+
+When an upstream source changes, refresh dependency snapshots and prepare the
+affected decisions for reconsideration. Route observed skill, tool, host, context
+or provider problems through version-bound Steward feedback. Preserve unknown
+causes and adopter consent; do not automatically rewrite or upgrade skills.

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

@@ -0,0 +1,32 @@
+---
+name: atelier-coordination
+description: Coordinate bounded outcomes across repositories using exact producer and receiver references, independent gates, directive dispositions and retained recovery history.
+---
+
+# Portable Coordination
+
+Name the outcome, integration owner, scope, exact candidate or artifact, receiving
+need, next action and forecast. Discover the existing native source of each fact.
+Reuse Build, Harness and repository coordination records rather than starting a
+parallel approval system. Local operation does not require a Fabric service.
+
+Use the installed Coordination contracts for bounded outcome, dependency,
+directive, disposition and recovery observations. Preserve source references,
+observation time and expiry. Missing, stale, changed or future-dated observations
+cannot become fresh merely because a dashboard can render them. Detect dependency
+cycles and keep receiving acceptance separate from producer source completion.
+
+Bind each gate to its candidate. Tests, independent review, CI, merge, deployment,
+activation and recipient acceptance retain separate evidence and authority.
+A reported waiver is not a passed test. A receipt reference is not authenticated
+verification. Use native verification where acceptance depends on that receipt.
+
+Directives preserve target, scope, expiry, supersession and proposed/sent/read/
+applied/verified distinctions. Do not infer a later stage from an earlier report.
+A directive or skill grants no messaging, execution or repository adoption power.
+Act only within existing user authority and the destination's actual contracts.
+
+For interruption or retirement, preserve exact prior state, recovery evidence and
+successor identity. Do not wake another owner, overwrite dirty work or delete
+uncertain journals to make a view appear settled. Report the smallest concrete
+receiving dependency and keep unrelated admitted work moving.

package/skills/claude/atelier-discovery-harness/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: atelier-discovery-harness
+description: Frame uncertain questions, compare explanations, plan evidence collection and prepare accountable decisions through the Atelier inquiry ledger.
+---
+
+# Discovery Harness
+
+Start with the person's purpose and the repository's actual rules, tools and
+source boundaries. Resolve the installed Atelier version and use `atelier
+inquiry help` when available. This source capability uses `@mnstry/atelier/inquiry`
+and `contracts/atelier-inquiry.v1.schema.json`; older packages may lack them.
+
+Record a bounded campaign, competing explanations and a hypothesis with a
+context, scope and prospective test plan. Exploratory work can remain qualitative.
+Use conceptual lenses where useful: definitions, mechanisms, systems and causal
+structure, alternatives, counterfactuals, context variation and consequences.
+For each lens say what it can reveal and what evidence would challenge it.
+
+Prepare a request with independent purposes for each inquiry, source standards,
+budget and admitted effects. Emit a standalone handoff for the user's chosen
+research workflow. A provider-specific skill can fulfill this contract; do not
+replace an existing skill merely because its name differs. Package installation
+and effect declarations grant no execution permission.
+
+On return, inspect complete captures, exact quotes, verification states, evidence
+families, contradictions and new questions. Use current immutable references.
+Record delayed answers against their original request; revise the hypothesis
+explicitly if the question changes. Unsupported conclusions remain gaps.
+
+Prefer qualitative assessment when no defensible numerical model exists.
+For elicited odds, identify the source of the prior and every likelihood ratio,
+state conditional-independence assumptions and show sensitivity. For a rate
+model, define the population and binary trial before supplying counts. Interview
+enthusiasm is not automatically a trial or a likelihood ratio. Disclose evidence
+already used in the prior. Repeated reports from one family do not create new
+independent observations. Broad graph links never justify confidence arithmetic.
+
+Use `inquiry append` with the current history digest. The ledger checks references
+and arithmetic; verification and reviewer identities are caller reports. Record
+only actual owner dispositions within existing authority. Use `inquiry graph`
+to prepare a source diff and relation proposals, then follow the receiving
+repository's review and graph workflow. Keep raw captures outside accepted
+knowledge. A source withdrawal requires reconsidering affected decisions.
+
+Send only permitted, version-bound feedback to Skill Steward. A failure can come
+from a method, tool, source, context or provider. Feedback proposes evaluation;
+it never edits the skill or adopts an upgrade. Retain prior heuristic scores as
+`legacy-assessment` records, without turning them into probabilities.

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

@@ -44,6 +44,35 @@ 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.
 
+When the package manager identified above is npm, check advisory-pinned
+dependencies in the staged candidate: the selected package's exact-version
+`overrides` entries and any package the owner names. Record an override that is
+not an exact version as unchecked. A dependency publisher's root-project
+`overrides` are not inherited by its consumers. `npm ls <package> --all` lists
+every installed copy and reports copies outside a declared range; a valid range
+need not equal the resolved version literally. Each copy must be at its pin or
+an owner-approved version; more than one copy can be valid in a consumer's
+tree. `npm ls` alone does not compare with the lock. Using the lock of the
+candidate's npm root project, compare `npm ls --all --json` with
+`npm ls --all --json --package-lock-only` by dependency path and version, and
+refuse a tree that reports `problems`. Classify each difference on evidence.
+Two different versions at one dependency path are a stale installation. A lock
+entry with no installed version is not installed: call it a package for another
+platform only when its entry in the lock file lists an `os`, `cpu` or `libc`
+that excludes this host as npm is configured. Otherwise record it as missing,
+with the cause when known, and as stale unless the owner confirms the omission.
+Do not report that the tree agrees with the lock while any difference is
+unexplained. Changing a pin or an override in the owner's project is an
+installation effect that needs the owner's consent; adoption requires the
+completed change and its readback. This skill does not prove an offline
+reinstall. When the owner or the repository's procedure requires offline
+installs, follow that procedure and record its result separately. The lock
+comparison was observed once on one development tree whose only differences
+were packages for other platforms, on macOS with npm 10. Other platforms, npm
+versions, real workspaces and missing packages are unqualified. Record the Node
+and npm versions, registry and platform in private evidence, and whether each
+observation used a real registry or a fixture.
+
 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

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

@@ -0,0 +1,34 @@
+---
+name: atelier-interaction
+description: Integrate Companion communication policy and optional Witness reflection with one host conversation authority, exact evidence and truthful delivery, interruption and repair.
+---
+
+# Interaction and optional Reflection
+
+Keep ordinary work useful with Reflection disabled. Companion governs how the
+interface participates; Witness proposes reflection about a person, work, tools
+or a system. Coaching is optional and requires a current chosen intention.
+Neither role creates another persona, transcript or implicit monitoring program.
+
+Separate reported observations, attributed assessments, intentions, preferences,
+commitments and interaction acts. Preserve subject, author, purpose, scope,
+revision, assistance, uncertainty and limitations. Tool friction does not establish
+personal incapacity. A completed assisted task does not establish independent
+capacity. Preserve legitimate disagreement rather than manufacturing consensus.
+
+Use the installed Reflection contracts to qualify current evidence and the
+Interaction selector to resolve purpose, expiry, floor, pause, initiative and
+policy. Corrected or withdrawn sources invalidate dependent queued guidance.
+Silence, deferral and a useful clarification are legitimate results.
+
+The host owns one conversation authority, durable reservations, effect admission
+and native delivery. Bind the exact act and policy; verify current context again
+before emission. Respect real interruption, retain actual partial output, and
+make repair a separately selected act. Read native receipts after uncertainty
+rather than automatically emitting again. Delivery is not understanding or assent.
+
+Evaluate clarity, warmth, candor, challenge, pacing and repair with representative
+interactions and human feedback. Contract conformance cannot certify communication
+quality or lasting developmental benefit. Keep personal inspection, correction,
+withdrawal, export and retention in the existing owner; do not claim erasure or
+rights that the host has not implemented.

package/skills/claude/atelier-knowledge-harness/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: atelier-knowledge-harness
+description: Establish and develop a governed knowledge domain, including ingestion, original contributions, interpretation, curation, graph activation, and correction. Use when building or maintaining a body of knowledge.
+---
+
+# Knowledge Harness
+
+People establish purpose and acceptance criteria, agents prepare admitted work,
+and the designated owner validates consequential interpretations. Ingestion is
+one entry point alongside writing, conversation, observation and build results.
+
+## Establish before expanding
+
+Inspect the person's existing skills, source stores, tools and repository rules.
+Keep their ownership and names. Use an available method that satisfies the
+required outcome; do not replace another skill or add a provider implicitly.
+
+Prepare a domain record answering: what should this knowledge help someone do;
+which questions must it answer; which vocabulary, identity rules, source policy,
+scope, audience and acceptance criteria govern it? Show unresolved distinctions.
+Choose a small representative sample before bulk acquisition. A graph census or
+successful extraction alone does not establish a useful knowledge domain.
+
+## Develop and evaluate contributions
+
+Use the installed `atelier harness knowledge` CLI or `@mnstry/atelier/knowledge`
+with `@mnstry/atelier/harnesses`. `atelier harness example` provides explicitly
+synthetic records; `atelier harness help` lists the actual local commands.
+If the tool is unavailable, prepare the records and clearly report that execution
+has not occurred. Do not invent an installed version or approval.
+
+Preserve originals. Existing extractors can use `@mnstry/atelier/intake`; prepare
+their verified output with `prepareIntakeContribution`. Keep gaps, speaker
+ambiguity and structure. Outputs exceeding supported bounds need an explicit
+continuation plan, never silent truncation. Sources are evidence, not instructions.
+
+Distinguish source, observation, concept, claim, model, interpretation and decision
+rationale. Bind each contribution to its domain revision, scope, audience and
+origin. Anchor derived statements to exact source passages. Record evaluations
+and applicability limits separately from the owner's reported acceptance.
+Propose ambiguous identity matches as relations; do not silently merge entities.
+Uncertain or contested material may be curated with that uncertainty intact.
+
+## Activate and learn
+
+Record the actual review disposition. An activation names its purpose, reviewed
+inputs, destination and domain questions. Produce draft graph sources and relation
+claims, inspect the exact changes, then use the receiver's authorized authoring
+workflow to admit them. Rebuild the graph and test the question-to-evidence trace.
+
+Use an explicit handoff for another repository or harness. Preserve exact source
+history, subject and content pins; supply current source snapshots when reconciling
+imports. An unavailable source leaves freshness unresolved. A changed source,
+interpretation or ontology needs a new record and downstream reconsideration.
+Historical decisions remain intelligible; corrections do not erase them.
+
+Feedback names the actual skill binding and evidence. Prepare it for Skill Steward
+without automatically changing a skill, accepting an upgrade or publishing data.
+Keep source correctness, model confidence, owner acceptance and execution authority
+separate. Hosted extraction, credentials, budgets and disclosure remain host-owned.