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

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-guided-upgrade/SKILL.md

@@ -17,7 +17,7 @@ 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
+Read `docs/guides/guided-upgrades.md` and `docs/guides/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.

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

@@ -23,7 +23,7 @@ existing configuration. Never use unscoped `npx atelier`.
 
 ## Design the minimum ontology
 
-Read the bundled `docs/knowledge-setup.md`. Give each domain concept a
+Read the bundled `docs/start/knowledge-setup.md`. Give each domain concept a
 definition, identity rule, and `concept:...` tag. Map relationships to the
 existing native source predicates only where meaning is preserved. Keep rich
 assertions, their passages, qualifications, and review state in source records
@@ -66,7 +66,7 @@ not; retention counts are not practical benefit.
 After graph/build, `atelier dev --knowledge` offers five dashboards. Agents can
 read `atelier knowledge dashboard` and continue the same private session using
 `knowledge session start|read|event|recover|list`. Follow
-`docs/knowledge-workspace.md`: ask one useful question, preserve exact answers,
+`docs/guides/knowledge-workspace.md`: ask one useful question, preserve exact answers,
 use `propose` for machine revisions, and wait for explicit human confirmation.
 Source changes require a separately reviewed owner edit. Record real outcomes
 and measured usage in the Learn flow; never infer savings from source counts.

package/skills/claude/atelier-local-service/SKILL.md

@@ -9,7 +9,7 @@ Use this skill for a consumer-owned service that persists repository-backed
 local state. Do not use it to change `atelier dev` itself or to install an
 operating-system service without explicit authorization.
 
-Read `docs/local-services.md` from the installed Atelier package or source
+Read `docs/reference/local-services.md` from the installed Atelier package or source
 checkout before changing lifecycle code.
 
 ## Boundary first

package/skills/claude/atelier-practical-judgment/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: atelier-practical-judgment
-description: Support situated deliberation and cultivation, then carry accepted practice into scoped instructions, governed skills or the owning implementation when the user wants future work to change.
+description: Support Phronesis — practical judgment through situated deliberation and cultivation, then carry accepted practice into scoped instructions, governed skills or the owning implementation when the user wants future work to change.
 ---
 
-# Practical Judgment
+# Phronesis — practical judgment
 
 Clarify the purpose, particulars, affected people and consequential choice.
 Preserve the person's contribution, competing interpretations, tacit distinctions,
@@ -16,6 +16,11 @@ curates evidence and applicability; Skill Steward governs reusable skill binding
 Companion remains the host's conversational role. Witness reflection or coaching
 is optional and must not create an implicit personal monitoring program.
 
+Phronesis draws on and contributes to the shared Knowledge Graph through existing
+Knowledge owners. Knowledge Stewardship remains the broader responsibility; the
+graph is a representation used across responsibilities. Reuse existing records,
+review and activation routes without creating a new store or canonical authority.
+
 ## Cases, decisions and learning
 
 Use the installed `@mnstry/atelier/judgment` case contract when a durable practical

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

@@ -76,7 +76,7 @@ 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
+`docs/maintainers/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.

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

@@ -10,8 +10,8 @@ a tenant or project workspace.
 
 ## Protocol
 
-- Use the repository's Atelier readiness protocols: `docs/tenant-readiness.md`,
-  `docs/atelier-runtime.md`, `contracts/atelier-readiness.v1.schema.json`, and
+- Use the repository's Atelier readiness protocols: `docs/guides/tenant-readiness.md`,
+  `docs/reference/atelier-runtime.md`, `contracts/atelier-readiness.v1.schema.json`, and
   `contracts/atelier-claim.v1.schema.json`.
 - Treat local source, Git state, project config, repo access, boundary policy,
   and lockfiles as review authority.

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

@@ -17,7 +17,7 @@ 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
+Read `docs/guides/guided-upgrades.md` and `docs/guides/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.

package/skills/codex/atelier-knowledge-setup/SKILL.md

@@ -23,7 +23,7 @@ existing configuration. Never use unscoped `npx atelier`.
 
 ## Design the minimum ontology
 
-Read the bundled `docs/knowledge-setup.md`. Give each domain concept a
+Read the bundled `docs/start/knowledge-setup.md`. Give each domain concept a
 definition, identity rule, and `concept:...` tag. Map relationships to the
 existing native source predicates only where meaning is preserved. Keep rich
 assertions, their passages, qualifications, and review state in source records
@@ -66,7 +66,7 @@ not; retention counts are not practical benefit.
 After graph/build, `atelier dev --knowledge` offers five dashboards. Agents can
 read `atelier knowledge dashboard` and continue the same private session using
 `knowledge session start|read|event|recover|list`. Follow
-`docs/knowledge-workspace.md`: ask one useful question, preserve exact answers,
+`docs/guides/knowledge-workspace.md`: ask one useful question, preserve exact answers,
 use `propose` for machine revisions, and wait for explicit human confirmation.
 Source changes require a separately reviewed owner edit. Record real outcomes
 and measured usage in the Learn flow; never infer savings from source counts.

package/skills/codex/atelier-local-service/SKILL.md

@@ -9,7 +9,7 @@ Use this skill for a consumer-owned service that persists repository-backed
 local state. Do not use it to change `atelier dev` itself or to install an
 operating-system service without explicit authorization.
 
-Read `docs/local-services.md` from the installed Atelier package or source
+Read `docs/reference/local-services.md` from the installed Atelier package or source
 checkout before changing lifecycle code.
 
 ## Boundary first

package/skills/codex/atelier-practical-judgment/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: atelier-practical-judgment
-description: Support situated deliberation and cultivation, then carry accepted practice into scoped instructions, governed skills or the owning implementation when the user wants future work to change.
+description: Support Phronesis — practical judgment through situated deliberation and cultivation, then carry accepted practice into scoped instructions, governed skills or the owning implementation when the user wants future work to change.
 ---
 
-# Practical Judgment
+# Phronesis — practical judgment
 
 Clarify the purpose, particulars, affected people and consequential choice.
 Preserve the person's contribution, competing interpretations, tacit distinctions,
@@ -16,6 +16,11 @@ curates evidence and applicability; Skill Steward governs reusable skill binding
 Companion remains the host's conversational role. Witness reflection or coaching
 is optional and must not create an implicit personal monitoring program.
 
+Phronesis draws on and contributes to the shared Knowledge Graph through existing
+Knowledge owners. Knowledge Stewardship remains the broader responsibility; the
+graph is a representation used across responsibilities. Reuse existing records,
+review and activation routes without creating a new store or canonical authority.
+
 ## Cases, decisions and learning
 
 Use the installed `@mnstry/atelier/judgment` case contract when a durable practical

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

@@ -76,7 +76,7 @@ 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
+`docs/maintainers/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.

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

@@ -10,8 +10,8 @@ a tenant or project workspace.
 
 ## Protocol
 
-- Use the repository's Atelier readiness protocols: `docs/tenant-readiness.md`,
-  `docs/atelier-runtime.md`, `contracts/atelier-readiness.v1.schema.json`, and
+- Use the repository's Atelier readiness protocols: `docs/guides/tenant-readiness.md`,
+  `docs/reference/atelier-runtime.md`, `contracts/atelier-readiness.v1.schema.json`, and
   `contracts/atelier-claim.v1.schema.json`.
 - Treat local source, Git state, project config, repo access, boundary policy,
   and lockfiles as review authority.

package/src/architecture/catalog.mjs

@@ -36,9 +36,9 @@ export function catalogDocument() {
     {
       "id": "practical-judgment",
       "kind": "responsibility",
-      "label": "Practical Judgment",
+      "label": "Phronesis",
       "aliases": [
-        "Phronesis"
+        "Practical Judgment"
       ],
       "purpose": "Discern fitting action, cultivate practice and learn from consequences.",
       "implementation": [

package/src/attestation/sign.mjs

@@ -1,6 +1,6 @@
 // Attestation signing and verification reference implementation.
 //
-// The normative signing input (docs/attestation.md, "Signing procedure"):
+// The normative signing input (docs/reference/attestation.md, "Signing procedure"):
 // the UTF-8 encoding of the RFC 8785 (JCS) canonicalization of the
 // attestation document with its `signature` member set to null.
 //