instar 1.3.197 → 1.3.199

package/dist/core/ApprenticeshipProgram.js

@@ -0,0 +1,433 @@
+/**
+ * ApprenticeshipProgram — the standing program scaffold for apprenticeship /
+ * mentorship instances (Apprenticeship Step 1, APPRENTICESHIP-STEP1-PROGRAM-
+ * SCAFFOLD-SPEC.md).
+ *
+ * Each instance is a project under a standing program that crystallizes by
+ * bootstrap. This module is the instance-as-project REGISTRY plus the two
+ * lifecycle GATES that make "review before you start / capture before you
+ * close" unskippable at the state-mutating transition:
+ *
+ *   - the RETRO-GATE (pending→active): refused unless the prior instance's
+ *     retro-harvest exists at its CANONICAL CONFINED PATH and passes the
+ *     Step 0 validator (the first instance is seeded by the Echo→Codey
+ *     bootstrap harvest).
+ *   - the DOC-AS-REQUIRED-ARTIFACT GATE (active→complete): refused until the
+ *     instance's declared-required artifacts are VERIFIED PRESENT FROM LIVE
+ *     STATE (never a stored flag).
+ *
+ * Signal vs Authority / The Body and the Mind: the gates are structural
+ * preconditions on OBJECTIVE artifacts ("does a validated harvest exist?",
+ * "is there ≥1 instance-scoped ledger entry?"). They are NOT quality
+ * judgments — whether the mentor truly internalized the lessons stays with
+ * the overseer (the mind), informed by the gate. Every verdict is appended
+ * to logs/apprenticeship-decisions.jsonl (the decision audit).
+ *
+ * Concurrency: file-backed store at `.instar/apprenticeship/instances.json`,
+ * atomic tmp-write+rename, with a single in-process serialized mutator and an
+ * optimistic `version` CAS (lost-update safe under the single-process-per-agent
+ * AgentServer model). A corrupt/unparseable store FAILS CLOSED — gates return
+ * `allow:false`, never "no prior instance → open the gate".
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { validateRetroHarvest, parseArtifact, safeArtifactPath, } from './retroHarvestValidator.js';
+/** The typed no-op overseer stub (§2). */
+export const noopApprenticeshipOverseer = {
+    computeDifferential(_instance) {
+        return { implemented: false, reason: 'differential read-channel is implemented in Step 4 (need-001)' };
+    },
+};
+const CHARSET_RE = /^[a-z0-9-]+$/;
+/** Legal status transitions (§3.4). `complete` is terminal. */
+const TRANSITIONS = {
+    pending: ['active'],
+    active: ['complete', 'blocked'],
+    blocked: ['active'],
+    complete: [], // terminal
+};
+// ── Implementation ───────────────────────────────────────────────────
+export class ApprenticeshipProgram {
+    storePath;
+    decisionLogPath;
+    projectDir;
+    store;
+    /** True when the on-disk store was unparseable → gates fail closed. */
+    corrupt = false;
+    deps;
+    constructor(config) {
+        this.storePath = path.join(config.stateDir, 'apprenticeship', 'instances.json');
+        this.decisionLogPath =
+            config.decisionLogPath ?? path.join(config.stateDir, 'logs', 'apprenticeship-decisions.jsonl');
+        this.projectDir = config.projectDir;
+        this.deps = {
+            readHarvest: config.deps?.readHarvest ?? ((rel) => this.defaultReadHarvest(rel)),
+            validate: config.deps?.validate ?? validateRetroHarvest,
+            countInstanceLedgerEntries: config.deps?.countInstanceLedgerEntries ?? (() => 0),
+            detectorAuditExists: config.deps?.detectorAuditExists ?? (() => false),
+        };
+        this.store = this.loadStore();
+    }
+    /** Default harvest reader — resolves the confined relative path under projectDir. */
+    defaultReadHarvest(relPath) {
+        try {
+            const full = path.join(this.projectDir, relPath);
+            if (!fs.existsSync(full))
+                return null;
+            return fs.readFileSync(full, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+    // ── Persistence ────────────────────────────────────────────────────
+    loadStore() {
+        try {
+            if (fs.existsSync(this.storePath)) {
+                const raw = fs.readFileSync(this.storePath, 'utf-8');
+                const data = JSON.parse(raw);
+                if (data && data.version === 1 && Array.isArray(data.instances)) {
+                    this.corrupt = false;
+                    return data;
+                }
+                // Present but unparseable shape → fail closed (do NOT silently reset).
+                this.corrupt = true;
+                return { version: 1, instances: [], lastModified: new Date().toISOString() };
+            }
+        }
+        catch {
+            // A present-but-corrupt file fails closed; a truly-missing file is fresh.
+            if (fs.existsSync(this.storePath)) {
+                this.corrupt = true;
+                return { version: 1, instances: [], lastModified: new Date().toISOString() };
+            }
+        }
+        this.corrupt = false;
+        return { version: 1, instances: [], lastModified: new Date().toISOString() };
+    }
+    saveStore() {
+        this.store.lastModified = new Date().toISOString();
+        const dir = path.dirname(this.storePath);
+        fs.mkdirSync(dir, { recursive: true });
+        const tmpPath = `${this.storePath}.${process.pid}.tmp`;
+        fs.writeFileSync(tmpPath, JSON.stringify(this.store, null, 2) + '\n');
+        fs.renameSync(tmpPath, this.storePath);
+    }
+    /**
+     * The single in-process serialized mutator with optimistic `version` CAS.
+     * JS is single-threaded and `fn` is synchronous, so a straight read → apply
+     * → version++ → persist cannot interleave with another mutate() under the
+     * single-process model; the CAS guards against a same-tick stale read by
+     * re-reading the live record before commit. Returns the persisted snapshot.
+     */
+    mutate(id, fn) {
+        const idx = this.store.instances.findIndex((i) => i.id === id);
+        if (idx === -1)
+            throw new Error(`ApprenticeshipProgram.mutate: unknown instance id ${id}`);
+        const current = this.store.instances[idx];
+        const observedVersion = current.version ?? 0;
+        const next = fn({ ...current });
+        // CAS re-read: under single-process this is belt-and-braces.
+        const latestIdx = this.store.instances.findIndex((i) => i.id === id);
+        if (latestIdx === -1)
+            throw new Error(`ApprenticeshipProgram.mutate: instance ${id} disappeared mid-apply`);
+        if ((this.store.instances[latestIdx].version ?? 0) !== observedVersion) {
+            throw new Error(`ApprenticeshipProgram.mutate: version drift on ${id} (CAS abort)`);
+        }
+        const committed = {
+            ...next,
+            // requiredArtifacts is immutable after create — restore from the live record.
+            requiredArtifacts: current.requiredArtifacts,
+            version: observedVersion + 1,
+            updatedAt: new Date().toISOString(),
+        };
+        this.store.instances[latestIdx] = committed;
+        this.saveStore();
+        return committed;
+    }
+    // ── Read ───────────────────────────────────────────────────────────
+    list() {
+        return [...this.store.instances];
+    }
+    get(id) {
+        return this.store.instances.find((i) => i.id === id) ?? null;
+    }
+    /** True when the on-disk store was present but unparseable (gates fail closed). */
+    isCorrupt() {
+        return this.corrupt;
+    }
+    // ── Create ─────────────────────────────────────────────────────────
+    /**
+     * Create an instance. Charset-clamps id/overseer/mentor/mentee/framework to
+     * ^[a-z0-9-]+$, rejects a duplicate id, computes harvestFrom=mentor /
+     * harvestTo=mentee. requiredArtifacts defaults to all-required.
+     */
+    createInstance(input) {
+        if (this.corrupt) {
+            throw new Error('ApprenticeshipProgram: store is corrupt — refusing to create (fail closed)');
+        }
+        const overseer = input.overseer ?? '';
+        const fields = {
+            id: input.id,
+            mentor: input.mentor,
+            mentee: input.mentee,
+            framework: input.framework,
+        };
+        // overseer is optional (apprenticeship has none); clamp only when present.
+        if (overseer)
+            fields.overseer = overseer;
+        for (const [k, v] of Object.entries(fields)) {
+            if (typeof v !== 'string' || !CHARSET_RE.test(v)) {
+                throw new Error(`ApprenticeshipProgram.createInstance: ${k}="${v}" must match ^[a-z0-9-]+$`);
+            }
+        }
+        if (input.instanceType !== 'apprenticeship' && input.instanceType !== 'mentorship') {
+            throw new Error(`ApprenticeshipProgram.createInstance: invalid instanceType "${input.instanceType}"`);
+        }
+        if (this.store.instances.some((i) => i.id === input.id)) {
+            throw new Error(`ApprenticeshipProgram.createInstance: duplicate id "${input.id}"`);
+        }
+        const now = new Date().toISOString();
+        const harvestFrom = input.mentor; // a harvest is named for the mentoring edge (§3.1)
+        const harvestTo = input.mentee;
+        // Record the canonical path for humans only — NEVER the resolution source.
+        let harvestRef = null;
+        try {
+            harvestRef = safeArtifactPath(harvestFrom, harvestTo, input.instanceType);
+        }
+        catch {
+            harvestRef = null;
+        }
+        const instance = {
+            id: input.id,
+            instanceType: input.instanceType,
+            overseer,
+            mentor: input.mentor,
+            mentee: input.mentee,
+            framework: input.framework,
+            status: 'pending',
+            priorInstanceId: input.priorInstanceId ?? null,
+            requiredArtifacts: {
+                retroHarvest: input.requiredArtifacts?.retroHarvest ?? true,
+                ledgerEntries: input.requiredArtifacts?.ledgerEntries ?? true,
+                detectorAudit: input.requiredArtifacts?.detectorAudit ?? true,
+            },
+            programNeeds: input.programNeeds ?? [],
+            harvestFrom,
+            harvestTo,
+            harvestRef,
+            version: 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.store.instances.push(instance);
+        this.saveStore();
+        return instance;
+    }
+    // ── Gates (pure; truth re-derived from injected deps) ───────────────
+    /**
+     * The retro-gate (§3.3). priorInstanceId === null → the bootstrap seed (the
+     * Echo→Codey artifact at its canonical path) must exist + validate. Else the
+     * prior instance must be status:'complete' AND its canonical harvest must
+     * exist + validate. partial-accepted passes ONLY with acceptance metadata
+     * (acceptedBy + acceptedAt); complete always passes.
+     *
+     * The path is recomputed via safeArtifactPath(harvestFrom, harvestTo,
+     * instanceType) — never a stored harvestRef.
+     */
+    evaluateStartGate(instance) {
+        if (this.corrupt) {
+            return { allow: false, reason: 'instance store is corrupt — fail closed' };
+        }
+        let priorInstance = null;
+        let from;
+        let to;
+        let type;
+        let priorHarvestExists;
+        if (instance.priorInstanceId === null) {
+            // Bootstrap: validate THIS instance's own canonical harvest (the seed).
+            from = instance.harvestFrom;
+            to = instance.harvestTo;
+            type = instance.instanceType;
+            priorHarvestExists = false;
+        }
+        else {
+            priorInstance = this.get(instance.priorInstanceId);
+            if (!priorInstance) {
+                return { allow: false, reason: `prior instance "${instance.priorInstanceId}" not found` };
+            }
+            if (priorInstance.status !== 'complete') {
+                return {
+                    allow: false,
+                    reason: `prior instance "${priorInstance.id}" is "${priorInstance.status}", must be "complete"`,
+                };
+            }
+            from = priorInstance.harvestFrom;
+            to = priorInstance.harvestTo;
+            type = priorInstance.instanceType;
+            priorHarvestExists = true;
+        }
+        // Recompute the confined path (NEVER the stored harvestRef).
+        let relPath;
+        try {
+            relPath = safeArtifactPath(from, to, type);
+        }
+        catch (e) {
+            return { allow: false, reason: `cannot resolve canonical harvest path: ${e.message}` };
+        }
+        const text = this.deps.readHarvest(relPath);
+        if (text === null) {
+            return { allow: false, reason: `retro-harvest missing at canonical path ${relPath}` };
+        }
+        const result = this.deps.validate(text, { priorHarvestExists });
+        if (!result.valid) {
+            return { allow: false, reason: `retro-harvest at ${relPath} is invalid: ${result.errors.join('; ')}` };
+        }
+        // partial-accepted requires acceptance metadata (acceptedBy + acceptedAt).
+        let fm;
+        try {
+            fm = parseArtifact(text).frontmatter;
+        }
+        catch (e) {
+            return { allow: false, reason: `cannot parse harvest frontmatter: ${e.message}` };
+        }
+        const completeness = fm.completeness;
+        if (completeness === 'partial-accepted') {
+            const acceptedBy = fm.acceptedBy;
+            const acceptedAt = fm.acceptedAt;
+            if (!acceptedBy || !acceptedAt) {
+                return {
+                    allow: false,
+                    reason: `partial harvest at ${relPath} awaiting acceptance (acceptedBy + acceptedAt required)`,
+                };
+            }
+        }
+        return {
+            allow: true,
+            reason: instance.priorInstanceId === null
+                ? `bootstrap seed ${relPath} present + valid (completeness=${String(completeness)})`
+                : `prior instance "${priorInstance.id}" complete; harvest ${relPath} present + valid`,
+        };
+    }
+    /**
+     * The doc-as-required-artifact gate (§3.3). Each requiredArtifacts flag the
+     * instance DECLARES required is checked against LIVE state via injected deps —
+     * harvestExists+validates, an instance-scoped ledger count ≥1, detectorAudit
+     * present. A stored requiredArtifacts:true is NEVER treated as evidence of
+     * presence.
+     */
+    evaluateCompletionGate(instance) {
+        if (this.corrupt) {
+            return { allow: false, reason: 'instance store is corrupt — fail closed', missing: ['store-corrupt'] };
+        }
+        const missing = [];
+        if (instance.requiredArtifacts.retroHarvest) {
+            // This instance's OWN harvest (mentor→mentee edge), at its canonical path.
+            let relPath = null;
+            try {
+                relPath = safeArtifactPath(instance.harvestFrom, instance.harvestTo, instance.instanceType);
+            }
+            catch {
+                relPath = null;
+            }
+            const text = relPath ? this.deps.readHarvest(relPath) : null;
+            if (text === null) {
+                missing.push('retroHarvest:absent');
+            }
+            else {
+                const result = this.deps.validate(text, { priorHarvestExists: instance.priorInstanceId !== null });
+                if (!result.valid)
+                    missing.push('retroHarvest:invalid');
+            }
+        }
+        if (instance.requiredArtifacts.ledgerEntries) {
+            const n = this.deps.countInstanceLedgerEntries(instance);
+            if (!(n >= 1))
+                missing.push('ledgerEntries:none');
+        }
+        if (instance.requiredArtifacts.detectorAudit) {
+            if (!this.deps.detectorAuditExists(instance))
+                missing.push('detectorAudit:absent');
+        }
+        if (missing.length > 0) {
+            return {
+                allow: false,
+                reason: `completion blocked — missing live artifacts: ${missing.join(', ')}`,
+                missing,
+            };
+        }
+        return { allow: true, reason: 'all declared-required artifacts verified present from live state', missing: [] };
+    }
+    // ── Status transitions (the gates are not advisory) ─────────────────
+    /**
+     * The ONLY way status changes (§3.4). pending→active runs evaluateStartGate
+     * and refuses on !allow; active→complete runs evaluateCompletionGate;
+     * active→blocked / blocked→active (re-gate) allowed; complete is terminal.
+     * Any transition not in the table is rejected with a reason. Every gate
+     * verdict is appended to the decision audit.
+     */
+    transition(id, to) {
+        if (this.corrupt) {
+            return { ok: false, reason: 'instance store is corrupt — fail closed' };
+        }
+        const instance = this.get(id);
+        if (!instance)
+            return { ok: false, reason: `instance "${id}" not found` };
+        const allowed = TRANSITIONS[instance.status] ?? [];
+        if (!allowed.includes(to)) {
+            return {
+                ok: false,
+                reason: `illegal transition ${instance.status}→${to} (allowed: ${allowed.join(', ') || 'none — terminal'})`,
+            };
+        }
+        // Gate the guarded transitions.
+        if (instance.status === 'pending' && to === 'active') {
+            const verdict = this.evaluateStartGate(instance);
+            this.recordDecision({ gate: 'start', instanceId: id, allow: verdict.allow, reason: verdict.reason });
+            if (!verdict.allow)
+                return { ok: false, reason: `start gate refused: ${verdict.reason}` };
+        }
+        if (instance.status === 'blocked' && to === 'active') {
+            // Re-gate on resume from blocked.
+            const verdict = this.evaluateStartGate(instance);
+            this.recordDecision({ gate: 'start', instanceId: id, allow: verdict.allow, reason: verdict.reason });
+            if (!verdict.allow)
+                return { ok: false, reason: `start gate refused (re-gate): ${verdict.reason}` };
+        }
+        if (instance.status === 'active' && to === 'complete') {
+            const verdict = this.evaluateCompletionGate(instance);
+            this.recordDecision({
+                gate: 'completion',
+                instanceId: id,
+                allow: verdict.allow,
+                reason: verdict.reason,
+                missing: verdict.missing,
+            });
+            if (!verdict.allow)
+                return { ok: false, reason: `completion gate refused: ${verdict.reason}` };
+        }
+        const updated = this.mutate(id, (i) => ({ ...i, status: to }));
+        return { ok: true, reason: `transitioned ${instance.status}→${to}`, instance: updated };
+    }
+    // ── Decision audit (§3.6) ───────────────────────────────────────────
+    recordDecision(entry) {
+        try {
+            const dir = path.dirname(this.decisionLogPath);
+            fs.mkdirSync(dir, { recursive: true });
+            const line = JSON.stringify({
+                ts: new Date().toISOString(),
+                gate: entry.gate,
+                instanceId: entry.instanceId,
+                allow: entry.allow,
+                reason: entry.reason,
+                ...(entry.missing && entry.missing.length ? { missing: entry.missing } : {}),
+            }) + '\n';
+            fs.appendFileSync(this.decisionLogPath, line);
+        }
+        catch {
+            // @silent-fallback-ok — the audit is observability; a write failure must
+            // not block the (already-decided) transition.
+        }
+    }
+}
+//# sourceMappingURL=ApprenticeshipProgram.js.map

package/dist/core/ApprenticeshipProgram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApprenticeshipProgram.js","sourceRoot":"","sources":["../../src/core/ApprenticeshipProgram.ts"],"names":[],"mappings":"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"}

package/dist/core/PostUpdateMigrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PostUpdateMigrator.d.ts","sourceRoot":"","sources":["../../src/core/PostUpdateMigrator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PostUpdateMigrator.d.ts","sourceRoot":"","sources":["../../src/core/PostUpdateMigrator.ts"],"names":[],"mappings":"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"}

package/dist/core/PostUpdateMigrator.js

@@ -222,14 +222,18 @@ export class PostUpdateMigrator {
             return;
         }
         // Marker strings the current boot wrapper must contain to be considered
-        // up-to-date. Both are required:
+        // up-to-date. All are required:
         //  - 'cannot load better-sqlite3 (ABI drift)' — the ABI-check self-heal branch.
         //  - 'version-managed node candidates' — the asdf/nvm `which node` candidate
         //    discovery (instar-codey node-25/ABI-141 deadlock fix). An install that has
         //    the ABI check but NOT this marker (e.g. instar-codey) self-heals FORWARD to
         //    the wrong ABI and cannot recover — it must be regenerated.
+        //  - 'npm_config_scripts_prepend_node_path' — the reinstall now puts the resolved
+        //    node dir on PATH so native postinstalls (sharp) don't die with "command not
+        //    found" under a launchd-spawned boot child. Wrappers lacking it must regenerate.
         if (content.includes('cannot load better-sqlite3 (ABI drift)') &&
-            content.includes('version-managed node candidates')) {
+            content.includes('version-managed node candidates') &&
+            content.includes('npm_config_scripts_prepend_node_path')) {
             result.skipped.push('boot-wrapper ABI-check: already current');
             return;
         }
@@ -2509,6 +2513,25 @@ Rule: I do not state that work landed inside another agent's state unless I have
             patched = true;
             result.upgraded.push('CLAUDE.md: added Cross-Agent Communication Discipline (anti-confabulation) section');
         }
+        // Apprenticeship Program (Step 1, APPRENTICESHIP-STEP1-PROGRAM-SCAFFOLD-SPEC.md).
+        // Existing agents need to know the program registry + lifecycle gates exist —
+        // an agent that doesn't know about a capability effectively doesn't have it.
+        // Content-sniffed on a distinctive marker for idempotency (the same heading the
+        // template emits, so a freshly-initialized agent is never double-patched).
+        if (!content.includes('**Apprenticeship Program**')) {
+            const apprenticeshipSection = `
+### Apprenticeship Program
+
+The standing program that each apprenticeship/mentorship instance plugs into (e.g. Echo mentors Codey, then Codey mentors Gemini while Echo oversees). **Apprenticeship Program** instances are projects with a locked role triple (overseer / mentor / mentee), a framework, and a required-artifact checklist. Two lifecycle GATES make "review before you start / capture before you close" unskippable at the state-mutating transition: the retro-gate refuses \`pending→active\` unless the prior instance's retro-harvest exists at its canonical confined path AND passes the Step 0 validator (the first instance is seeded by the Echo→Codey bootstrap harvest); the doc-as-required-artifact gate refuses \`active→complete\` until the declared-required artifacts are verified present FROM LIVE STATE (never a stored flag). The gates are structural preconditions on objective artifacts — quality stays with the overseer (the mind); every verdict is audited to \`logs/apprenticeship-decisions.jsonl\`.
+- List / inspect: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/apprenticeship/instances\` · \`GET /apprenticeship/instances/:id\`
+- Create: \`POST /apprenticeship/instances\` \`{"id":"codey-to-gemini","instanceType":"mentorship","overseer":"echo","mentor":"codey","mentee":"gemini","framework":"gemini-cli","priorInstanceId":null}\` (id/overseer/mentor/mentee/framework charset-clamped to \`^[a-z0-9-]+$\`; dup id rejected; harvestFrom=mentor / harvestTo=mentee).
+- Transition status (the ONLY way it changes — runs the gate): \`POST /apprenticeship/instances/:id/transition\` \`{"to":"active"}\` (refused + 409 on a failed gate or illegal transition; \`complete\` is terminal). Preview without mutating: \`.../can-start\` · \`.../can-complete\`.
+- **When to use** (PROACTIVE): when starting or closing a mentorship/apprenticeship instance, drive it through the registry + transitions so the retro-harvest is reviewed before the next instance starts and the lessons are captured before this one closes — never track the lifecycle by memory.
+`;
+            content += '\n' + apprenticeshipSection;
+            patched = true;
+            result.upgraded.push('CLAUDE.md: added Apprenticeship Program section');
+        }
         // Close the Loop (Untracked = Abandoned) — STANDARDS-REGISTRY amendment
         // ratified with Justin 2026-05-31. The "nothing slips through the cracks"
         // principle was made a constitutional standard; existing agents need the