@jinn-network/client 0.1.2 → 0.1.3-canary.262e5cda

package/dist/restorer/impls/claude-code-learner/index.js

@@ -0,0 +1,14 @@
+/**
+ * @jinn-network/client claude-code-learner restorer impl.
+ *
+ * Bridges the engine's RestorerImpl interface to the claude-code-learner
+ * plugin shipped at client/plugins/claude-code-learner/.
+ *
+ * Spec: docs/superpowers/specs/2026-04-23-default-learning-restorer-design.md (v1.1)
+ */
+export { ClaudeCodeLearnerImpl } from './restorer.js';
+export { resolvePluginRoot } from './plugin-path.js';
+export { harvestOutput } from './harvest.js';
+export { ClaudeCodeHarnessAdapter } from './adapters/claude-code.js';
+export { ClaudeCodeLearnerWrapper } from './wrapper.js';
+//# sourceMappingURL=index.js.map

package/dist/restorer/impls/claude-code-learner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/restorer/impls/claude-code-learner/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,wBAAwB,EAAuC,MAAM,cAAc,CAAC"}

package/dist/restorer/impls/claude-code-learner/mcp-config.d.ts

@@ -0,0 +1,48 @@
+/**
+ * MCP-server config merger for Path 1 plug-ins. The Claude Code adapter
+ * spawns the harness with a baseline `mcpServers` map (in-repo MCP
+ * tools); this helper extends that map with `mcp-tool` and
+ * `memory-backend` slots from the loaded plug-in registry.
+ *
+ * Slot key resolution:
+ *   - mcp-tool        → `slot.namespace ?? plugInName`
+ *   - memory-backend  → `memory-<plugInName>` (always prefixed so the
+ *                       memory-consolidation skill can pattern-match)
+ *
+ * Collisions with the baseline (or between two plug-ins) throw — the
+ * loader cannot silently overwrite an in-repo MCP server.
+ *
+ * Spec: spec/2026-04-30-plug-in-surface.md §4 (slots: mcp-tool,
+ * memory-backend). Plan tasks 9 + 11.
+ *
+ * Slot integrations rely on Claude Code's `--mcp-config` argument; this
+ * module only assembles the JSON shape — it does not write it to disk
+ * or pass it to the adapter. The adapter materialises this output as a
+ * temp `.mcp.json` and points the harness at it.
+ */
+import type { RegistrySlot } from '../../plug-ins/registry.js';
+import type { McpToolSlot, MemoryBackendSlot } from '../../plug-ins/types.js';
+export interface McpServerEntry {
+    command: string;
+    args: readonly string[];
+}
+export interface McpConfig {
+    mcpServers: Record<string, McpServerEntry>;
+}
+export declare function mergeMcpConfig(baseline: McpConfig, slots: ReadonlyArray<RegistrySlot<McpToolSlot>>): McpConfig;
+export declare function mergeMemoryBackendsIntoMcpConfig(baseline: McpConfig, slots: ReadonlyArray<RegistrySlot<MemoryBackendSlot>>): McpConfig;
+/**
+ * Skill-bundle integration uses Claude Code's `--plugin-dir` argument:
+ * each plug-in's package root is its own loaded plugin. The bundled
+ * claude-code-learner plugin always ships first; plug-in skill bundles
+ * extend the list. See plan Task 10.
+ */
+export interface SerialisedRegistryLike {
+    skillBundles: ReadonlyArray<{
+        packageRoot: string;
+        slot: {
+            skillsDir: string;
+        };
+    }>;
+}
+export declare function pluginDirsForSession(registry: SerialisedRegistryLike, bundledPluginRoot: string): string[];

package/dist/restorer/impls/claude-code-learner/mcp-config.js

@@ -0,0 +1,52 @@
+/**
+ * MCP-server config merger for Path 1 plug-ins. The Claude Code adapter
+ * spawns the harness with a baseline `mcpServers` map (in-repo MCP
+ * tools); this helper extends that map with `mcp-tool` and
+ * `memory-backend` slots from the loaded plug-in registry.
+ *
+ * Slot key resolution:
+ *   - mcp-tool        → `slot.namespace ?? plugInName`
+ *   - memory-backend  → `memory-<plugInName>` (always prefixed so the
+ *                       memory-consolidation skill can pattern-match)
+ *
+ * Collisions with the baseline (or between two plug-ins) throw — the
+ * loader cannot silently overwrite an in-repo MCP server.
+ *
+ * Spec: spec/2026-04-30-plug-in-surface.md §4 (slots: mcp-tool,
+ * memory-backend). Plan tasks 9 + 11.
+ *
+ * Slot integrations rely on Claude Code's `--mcp-config` argument; this
+ * module only assembles the JSON shape — it does not write it to disk
+ * or pass it to the adapter. The adapter materialises this output as a
+ * temp `.mcp.json` and points the harness at it.
+ */
+export function mergeMcpConfig(baseline, slots) {
+    const out = { mcpServers: { ...baseline.mcpServers } };
+    for (const reg of slots) {
+        const key = reg.slot.namespace ?? reg.plugInName;
+        if (key in out.mcpServers) {
+            throw new Error(`MCP server name collision: ${key} (already in baseline or another plug-in)`);
+        }
+        out.mcpServers[key] = { command: reg.slot.command, args: reg.slot.args };
+    }
+    return out;
+}
+export function mergeMemoryBackendsIntoMcpConfig(baseline, slots) {
+    const out = { mcpServers: { ...baseline.mcpServers } };
+    for (const reg of slots) {
+        const key = `memory-${reg.plugInName}`;
+        if (key in out.mcpServers) {
+            throw new Error(`MCP server name collision: ${key}`);
+        }
+        out.mcpServers[key] = { command: reg.slot.command, args: reg.slot.args };
+    }
+    return out;
+}
+export function pluginDirsForSession(registry, bundledPluginRoot) {
+    const dirs = [bundledPluginRoot];
+    for (const r of registry.skillBundles) {
+        dirs.push(r.packageRoot);
+    }
+    return dirs;
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/restorer/impls/claude-code-learner/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../../../../src/restorer/impls/claude-code-learner/mcp-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAiBH,MAAM,UAAU,cAAc,CAC5B,QAAmB,EACnB,KAA+C;IAE/C,MAAM,GAAG,GAAc,EAAE,UAAU,EAAE,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;IAClE,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU,CAAC;QACjD,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,8BAA8B,GAAG,2CAA2C,CAC7E,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,QAAmB,EACnB,KAAqD;IAErD,MAAM,GAAG,GAAc,EAAE,UAAU,EAAE,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;IAClE,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,UAAU,GAAG,CAAC,UAAU,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAYD,MAAM,UAAU,oBAAoB,CAClC,QAAgC,EAChC,iBAAyB;IAEzB,MAAM,IAAI,GAAa,CAAC,iBAAiB,CAAC,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/restorer/impls/claude-code-learner/plugin-path.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolve the claude-code-learner plugin root from the impl directory's
+ * runtime location.
+ *
+ * Layout assumption: this file lives at
+ *   <package>/<src-or-dist>/restorer/impls/claude-code-learner/plugin-path.{ts,js}
+ * and the plugin lives at
+ *   <package>/plugins/claude-code-learner/
+ *
+ * Walks up four directories from this file (impls → restorer → src/dist →
+ * package root) then descends into plugins/claude-code-learner/. Verifies the
+ * expected layout exists and throws with a clear message if not.
+ */
+export declare function resolvePluginRoot(): string;

package/dist/restorer/impls/claude-code-learner/plugin-path.js

@@ -0,0 +1,30 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Resolve the claude-code-learner plugin root from the impl directory's
+ * runtime location.
+ *
+ * Layout assumption: this file lives at
+ *   <package>/<src-or-dist>/restorer/impls/claude-code-learner/plugin-path.{ts,js}
+ * and the plugin lives at
+ *   <package>/plugins/claude-code-learner/
+ *
+ * Walks up four directories from this file (impls → restorer → src/dist →
+ * package root) then descends into plugins/claude-code-learner/. Verifies the
+ * expected layout exists and throws with a clear message if not.
+ */
+export function resolvePluginRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const packageRoot = resolve(here, '..', '..', '..', '..');
+    const pluginRoot = join(packageRoot, 'plugins', 'claude-code-learner');
+    if (!existsSync(pluginRoot)) {
+        throw new Error(`claude-code-learner plugin not found at expected path: ${pluginRoot}. ` +
+            `Resolved from impl dir: ${here}.`);
+    }
+    if (!existsSync(join(pluginRoot, 'skills', 'coordinator', 'SKILL.md'))) {
+        throw new Error(`claude-code-learner plugin at ${pluginRoot} is missing skills/coordinator/SKILL.md`);
+    }
+    return pluginRoot;
+}
+//# sourceMappingURL=plugin-path.js.map

package/dist/restorer/impls/claude-code-learner/plugin-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-path.js","sourceRoot":"","sources":["../../../../src/restorer/impls/claude-code-learner/plugin-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;IAEvE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,0DAA0D,UAAU,IAAI;YACtE,2BAA2B,IAAI,GAAG,CACrC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CACb,iCAAiC,UAAU,yCAAyC,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/restorer/impls/claude-code-learner/restorer.d.ts

@@ -0,0 +1,38 @@
+import type { RestorerImpl, RestorationContext, RestorationOutput } from '../../types.js';
+import type { ClaudeCodeLearnerConfig } from './types.js';
+import type { ImplIntentPeek } from '../../types.js';
+/**
+ * `RestorerImpl` shell. Bridges the engine's dispatch contract
+ * (`await impl.run(ctx)`) into the harness adapter + markdown plugin.
+ *
+ * `supports()` is true for restoration jobs only (`type !== 'evaluation'`).
+ * `ClaudeCodeLearnerWrapper`
+ * (./wrapper.ts) is the first-match dispatcher that delegates Execute to a
+ * kind-specific specialist when one exists; this shim runs the plugin's full
+ * pipeline when no specialist matches.
+ */
+export declare class ClaudeCodeLearnerImpl implements RestorerImpl {
+    readonly name: string;
+    readonly version: string;
+    private readonly adapter;
+    private readonly pluginRoot;
+    /**
+     * Pre-built serialised slot registry (Path 1 plug-ins) threaded into the
+     * harness via `JINN_SLOT_REGISTRY_JSON`. Constructed once at daemon boot
+     * from `config.learnerPlugIns[]`. See plan Task 5.
+     */
+    private readonly slotRegistryJson;
+    constructor(config: ClaudeCodeLearnerConfig & {
+        slotRegistryJson?: string;
+    });
+    supports(spec: ImplIntentPeek): boolean;
+    run(ctx: RestorationContext): Promise<RestorationOutput>;
+    /**
+     * Public escape hatch for the ClaudeCodeLearnerWrapper. Threads
+     * adapterEnv through IntentSessionInputs so the wrapper can hand
+     * the coordinator skill a phase-range hint without mutating
+     * process.env (which would not propagate to the spawned harness
+     * anyway).
+     */
+    runWithAdapterEnv(ctx: RestorationContext, adapterEnv: Record<string, string>): Promise<RestorationOutput>;
+}

package/dist/restorer/impls/claude-code-learner/restorer.js

@@ -0,0 +1,73 @@
+import { resolvePluginRoot } from './plugin-path.js';
+import { harvestOutput } from './harvest.js';
+/**
+ * `RestorerImpl` shell. Bridges the engine's dispatch contract
+ * (`await impl.run(ctx)`) into the harness adapter + markdown plugin.
+ *
+ * `supports()` is true for restoration jobs only (`type !== 'evaluation'`).
+ * `ClaudeCodeLearnerWrapper`
+ * (./wrapper.ts) is the first-match dispatcher that delegates Execute to a
+ * kind-specific specialist when one exists; this shim runs the plugin's full
+ * pipeline when no specialist matches.
+ */
+export class ClaudeCodeLearnerImpl {
+    name;
+    version;
+    adapter;
+    pluginRoot;
+    /**
+     * Pre-built serialised slot registry (Path 1 plug-ins) threaded into the
+     * harness via `JINN_SLOT_REGISTRY_JSON`. Constructed once at daemon boot
+     * from `config.learnerPlugIns[]`. See plan Task 5.
+     */
+    slotRegistryJson;
+    constructor(config) {
+        this.adapter = config.adapter;
+        this.name = config.name ?? 'claude-code-learner';
+        this.version = config.version ?? '0.1.0-shim';
+        this.pluginRoot = config.pluginRoot ?? resolvePluginRoot();
+        this.slotRegistryJson = config.slotRegistryJson;
+    }
+    supports(spec) {
+        return spec.type !== 'evaluation';
+    }
+    async run(ctx) {
+        return this.runWithAdapterEnv(ctx, {});
+    }
+    /**
+     * Public escape hatch for the ClaudeCodeLearnerWrapper. Threads
+     * adapterEnv through IntentSessionInputs so the wrapper can hand
+     * the coordinator skill a phase-range hint without mutating
+     * process.env (which would not propagate to the spawned harness
+     * anyway).
+     */
+    async runWithAdapterEnv(ctx, adapterEnv) {
+        // Merge the pre-built slot registry (if any) into adapterEnv so the
+        // session-start hook in the harness writes it to slots.json.
+        const adapterEnvMerged = { ...adapterEnv };
+        if (this.slotRegistryJson) {
+            adapterEnvMerged.JINN_SLOT_REGISTRY_JSON = this.slotRegistryJson;
+        }
+        const window = ctx.intent.window ?? { startTs: 0, endTs: 0 };
+        const inputs = {
+            intentId: ctx.intent.id,
+            intentCid: ctx.intentCid,
+            intentKind: ctx.intent.spec?.kind,
+            intentBody: ctx.intent,
+            implStateDir: ctx.implStateDir,
+            workingDir: ctx.workingDir,
+            windowStartTs: window.startTs,
+            windowEndTs: window.endTs,
+            msUntilEndTs: ctx.msUntilEndTs(),
+            abort: ctx.abort,
+            adapterEnv: Object.keys(adapterEnvMerged).length > 0 ? adapterEnvMerged : undefined,
+        };
+        await this.adapter.runIntent(inputs, this.pluginRoot);
+        // Pass the phase-range hint (if any) through to harvestOutput so that
+        // a pre-execute or post-execute pass only validates the artifacts that
+        // the coordinator was asked to produce for that pass.
+        const phaseRange = adapterEnv['JINN_CLAUDE_CODE_LEARNER_PHASE_RANGE'];
+        return harvestOutput(ctx.workingDir, phaseRange);
+    }
+}
+//# sourceMappingURL=restorer.js.map

package/dist/restorer/impls/claude-code-learner/restorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restorer.js","sourceRoot":"","sources":["../../../../src/restorer/impls/claude-code-learner/restorer.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,OAAO,qBAAqB;IACvB,IAAI,CAAS;IACb,OAAO,CAAS;IACR,OAAO,CAAiB;IACxB,UAAU,CAAS;IACpC;;;;OAIG;IACc,gBAAgB,CAAqB;IAEtD,YACE,MAA+D;QAE/D,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,qBAAqB,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,YAAY,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;QAC3D,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAClD,CAAC;IAED,QAAQ,CAAC,IAAoB;QAC3B,OAAO,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAuB;QAC/B,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CACrB,GAAuB,EACvB,UAAkC;QAElC,oEAAoE;QACpE,6DAA6D;QAC7D,MAAM,gBAAgB,GAA2B,EAAE,GAAG,UAAU,EAAE,CAAC;QACnE,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,gBAAgB,CAAC,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACnE,CAAC;QAED,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAwB;YAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE;YACvB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI;YACjC,UAAU,EAAE,GAAG,CAAC,MAA2C;YAC3D,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,aAAa,EAAE,MAAM,CAAC,OAAO;YAC7B,WAAW,EAAE,MAAM,CAAC,KAAK;YACzB,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE;YAChC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,UAAU,EACR,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;SAC1E,CAAC;QAEF,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEtD,sEAAsE;QACtE,uEAAuE;QACvE,sDAAsD;QACtD,MAAM,UAAU,GAAG,UAAU,CAAC,sCAAsC,CAAC,CAAC;QACtE,OAAO,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/restorer/impls/claude-code-learner/test-utils/fake-plugin-outputs.d.ts

@@ -0,0 +1,19 @@
+export declare function fakeOrientSummary(workingDir: string, intentId: string, intentKind: string): void;
+export declare function fakeStrategy(workingDir: string, posture: 'early-return' | 'hold-and-revise' | 'continuous-observation'): void;
+export declare function fakePlan(workingDir: string, stepCount: number): void;
+export declare function fakeExecuteSummary(workingDir: string, opts?: {
+    stepsCompleted?: string[];
+    stepsFailed?: string[];
+    returnReason?: string;
+    elapsedMs?: number;
+}): void;
+export declare function fakeDebriefAnalysis(workingDir: string, verdict: 'yes' | 'no' | 'partial'): void;
+export declare function fakeImproveSummary(workingDir: string): void;
+export declare function fakeMemoryConsolidationRecord(workingDir: string): void;
+/** Convenience: write all seven happy-path phase artifacts. */
+export declare function fakeFullPipelineRun(workingDir: string, opts?: {
+    intentId?: string;
+    intentKind?: string;
+    posture?: 'early-return' | 'hold-and-revise' | 'continuous-observation';
+    verdict?: 'yes' | 'no' | 'partial';
+}): void;

package/dist/restorer/impls/claude-code-learner/test-utils/fake-plugin-outputs.js

@@ -0,0 +1,111 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Helpers to seed workingDir with realistic plugin artifacts so tests
+ * can exercise the shim's harvest + lifecycle logic without spawning a
+ * real harness.
+ *
+ * Each function writes one phase's output. The shapes match what the
+ * plugin (Plan 1) writes per its skill/agent contracts.
+ */
+function writeJson(path, payload) {
+    const dir = path.substring(0, path.lastIndexOf('/'));
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(path, JSON.stringify(payload, null, 2));
+}
+export function fakeOrientSummary(workingDir, intentId, intentKind) {
+    writeJson(join(workingDir, '.orient', 'summary.json'), {
+        intent: { id: intentId, kind: intentKind, window: { startTs: 0, endTs: 0 } },
+        topics: [
+            { topic: 'intent-parse', artifact: 'workingDir/.orient/intent-parse.json', summary: 'parsed', flags: [] },
+        ],
+        openQuestions: [],
+    });
+}
+export function fakeStrategy(workingDir, posture) {
+    writeJson(join(workingDir, '.strategize', 'strategy.json'), {
+        approach: 'fake-approach',
+        rationale: 'test',
+        successCriteria: 'fake passes if test passes',
+        timingPosture: posture,
+        constraints: [],
+        rejectedAlternatives: [],
+    });
+    writeJson(join(workingDir, '.strategize', 'constitution.json'), {
+        successCriteriaCid: 'sha256:fake',
+        timingPosture: posture,
+        skillBundleCid: 'sha256:fake',
+        implStateDirSha: 'fakeSha',
+        editableScope: [`${workingDir}/**`],
+    });
+}
+export function fakePlan(workingDir, stepCount) {
+    writeJson(join(workingDir, '.plan', 'plan.json'), {
+        successCriteria: 'fake passes if test passes',
+        timingPosture: 'early-return',
+        steps: Array.from({ length: stepCount }, (_, i) => ({
+            id: `step-${i + 1}`,
+            kind: 'work',
+            concurrency: 'sequential',
+            description: `fake step ${i + 1}`,
+            inputs: {},
+            toolsNeeded: [],
+            expectedOutputs: [],
+            successSignal: 'always',
+            abortCondition: 'never',
+        })),
+    });
+}
+export function fakeExecuteSummary(workingDir, opts = {}) {
+    writeJson(join(workingDir, '.execute', 'summary.json'), {
+        stepsCompleted: opts.stepsCompleted ?? ['step-1'],
+        stepsFailed: opts.stepsFailed ?? [],
+        decisions: [],
+        elapsedMs: opts.elapsedMs ?? 0,
+        returnReason: opts.returnReason ?? 'all-steps-completed',
+    });
+}
+export function fakeDebriefAnalysis(workingDir, verdict) {
+    writeJson(join(workingDir, '.debrief', 'analysis.json'), {
+        successCriteriaMet: verdict,
+        successCriteriaShortfall: verdict === 'yes' ? null : 'fake shortfall',
+        divergencesFromPlan: [],
+        crossOperatorSignals: [],
+        trend: { kind: 'fake', lastNRuns: 0, passRate: 1, direction: 'flat', notableFailureShapes: [] },
+        recommendationsForImprove: [],
+    });
+}
+export function fakeImproveSummary(workingDir) {
+    writeJson(join(workingDir, '.improve', 'summary.json'), {
+        implStateDirShaBefore: 'fakeShaBefore',
+        implStateDirShaAfter: 'fakeShaBefore',
+        changesAccepted: 0,
+        changesRejected: 0,
+        operatorRequests: 0,
+        rejectionsRationale: [],
+    });
+}
+export function fakeMemoryConsolidationRecord(workingDir) {
+    writeJson(join(workingDir, '.memory-consolidation', 'consolidation_record.json'), {
+        ts: Date.now(),
+        implStateDirShaBefore: 'fakeShaBefore',
+        implStateDirShaAfter: 'fakeShaBefore',
+        durable: { skillsArchived: [], promotionsReverted: [], notesCompacted: 0, conflictsResolved: [] },
+        ephemeral: { movedToPrivate: [], migratedToImplState: [] },
+    });
+}
+/** Convenience: write all seven happy-path phase artifacts. */
+export function fakeFullPipelineRun(workingDir, opts = {}) {
+    const intentId = opts.intentId ?? 'fake-intent';
+    const intentKind = opts.intentKind ?? 'fake.kind';
+    const posture = opts.posture ?? 'early-return';
+    const verdict = opts.verdict ?? 'yes';
+    fakeOrientSummary(workingDir, intentId, intentKind);
+    fakeStrategy(workingDir, posture);
+    fakePlan(workingDir, 1);
+    fakeExecuteSummary(workingDir);
+    fakeDebriefAnalysis(workingDir, verdict);
+    fakeImproveSummary(workingDir);
+    fakeMemoryConsolidationRecord(workingDir);
+}
+//# sourceMappingURL=fake-plugin-outputs.js.map

package/dist/restorer/impls/claude-code-learner/test-utils/fake-plugin-outputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-plugin-outputs.js","sourceRoot":"","sources":["../../../../../src/restorer/impls/claude-code-learner/test-utils/fake-plugin-outputs.ts"],"names":[],"mappings":"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"}

package/dist/restorer/impls/claude-code-learner/test-utils/noop-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { HarnessAdapter, IntentSessionInputs } from '../types.js';
+export type NoOpRunHandler = (inputs: IntentSessionInputs, pluginRoot: string) => void | Promise<void>;
+/**
+ * Test-only HarnessAdapter. By default, a runIntent call simulates a
+ * full happy-path pipeline by writing all seven phase artifacts to
+ * inputs.workingDir. Tests can override via .on() to inject failures,
+ * partial completion, etc.
+ */
+export declare class NoOpHarnessAdapter implements HarnessAdapter {
+    readonly name = "noop";
+    readonly allowsHarnessSelfModification = false;
+    private handler;
+    private invocations;
+    /** Override the default happy-path simulation. */
+    on(handler: NoOpRunHandler): this;
+    /** Inspect what runIntent was called with — useful for assertions. */
+    getInvocations(): ReadonlyArray<{
+        inputs: IntentSessionInputs;
+        pluginRoot: string;
+    }>;
+    runIntent(inputs: IntentSessionInputs, pluginRoot: string): Promise<void>;
+}

package/dist/restorer/impls/claude-code-learner/test-utils/noop-adapter.js

@@ -0,0 +1,35 @@
+import { fakeFullPipelineRun } from './fake-plugin-outputs.js';
+/**
+ * Test-only HarnessAdapter. By default, a runIntent call simulates a
+ * full happy-path pipeline by writing all seven phase artifacts to
+ * inputs.workingDir. Tests can override via .on() to inject failures,
+ * partial completion, etc.
+ */
+export class NoOpHarnessAdapter {
+    name = 'noop';
+    allowsHarnessSelfModification = false;
+    handler = null;
+    invocations = [];
+    /** Override the default happy-path simulation. */
+    on(handler) {
+        this.handler = handler;
+        return this;
+    }
+    /** Inspect what runIntent was called with — useful for assertions. */
+    getInvocations() {
+        return this.invocations;
+    }
+    async runIntent(inputs, pluginRoot) {
+        this.invocations.push({ inputs, pluginRoot });
+        if (this.handler) {
+            await this.handler(inputs, pluginRoot);
+        }
+        else {
+            fakeFullPipelineRun(inputs.workingDir, {
+                intentId: inputs.intentId,
+                intentKind: inputs.intentKind ?? 'unknown',
+            });
+        }
+    }
+}
+//# sourceMappingURL=noop-adapter.js.map

package/dist/restorer/impls/claude-code-learner/test-utils/noop-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-adapter.js","sourceRoot":"","sources":["../../../../../src/restorer/impls/claude-code-learner/test-utils/noop-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAI/D;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,MAAM,CAAC;IACd,6BAA6B,GAAG,KAAK,CAAC;IAEvC,OAAO,GAA0B,IAAI,CAAC;IACtC,WAAW,GAA+D,EAAE,CAAC;IAErF,kDAAkD;IAClD,EAAE,CAAC,OAAuB;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sEAAsE;IACtE,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAA2B,EAAE,UAAkB;QAC7D,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,mBAAmB,CAAC,MAAM,CAAC,UAAU,EAAE;gBACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;aAC3C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/restorer/impls/claude-code-learner/test-utils/synthetic-session.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Synthetic-session fixture for testing Path 1 plug-in slot-registry
+ * hand-off without spawning a real Claude Code subprocess. Mirrors the
+ * effect of the bundled `hooks/session-start` script: when the env
+ * carries `JINN_SLOT_REGISTRY_JSON`, write it to
+ * `<workingDir>/.coordinator/slots.json`.
+ *
+ * See plan
+ * docs/superpowers/plans/2026-04-30-plug-in-surface-path-1-mechanism.md
+ * Task 5 step 5.7.
+ */
+export interface SyntheticSession {
+    /** Synthesised workingDir for this session. */
+    workingDir: string;
+    /** Apply the equivalent of the hook script to the supplied env. */
+    applySessionStart(env: Record<string, string>): void;
+    /** Read the resulting slots.json (returns null if not written). */
+    readSlots(): unknown | null;
+}
+export declare function makeSyntheticSession(): SyntheticSession;

package/dist/restorer/impls/claude-code-learner/test-utils/synthetic-session.js

@@ -0,0 +1,34 @@
+/**
+ * Synthetic-session fixture for testing Path 1 plug-in slot-registry
+ * hand-off without spawning a real Claude Code subprocess. Mirrors the
+ * effect of the bundled `hooks/session-start` script: when the env
+ * carries `JINN_SLOT_REGISTRY_JSON`, write it to
+ * `<workingDir>/.coordinator/slots.json`.
+ *
+ * See plan
+ * docs/superpowers/plans/2026-04-30-plug-in-surface-path-1-mechanism.md
+ * Task 5 step 5.7.
+ */
+import { mkdtempSync, writeFileSync, mkdirSync, readFileSync, existsSync, } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+export function makeSyntheticSession() {
+    const workingDir = mkdtempSync(join(tmpdir(), 'jinn-synth-'));
+    return {
+        workingDir,
+        applySessionStart(env) {
+            const json = env.JINN_SLOT_REGISTRY_JSON;
+            if (!json)
+                return;
+            mkdirSync(join(workingDir, '.coordinator'), { recursive: true });
+            writeFileSync(join(workingDir, '.coordinator', 'slots.json'), json);
+        },
+        readSlots() {
+            const path = join(workingDir, '.coordinator', 'slots.json');
+            return existsSync(path)
+                ? JSON.parse(readFileSync(path, 'utf8'))
+                : null;
+        },
+    };
+}
+//# sourceMappingURL=synthetic-session.js.map

package/dist/restorer/impls/claude-code-learner/test-utils/synthetic-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-session.js","sourceRoot":"","sources":["../../../../../src/restorer/impls/claude-code-learner/test-utils/synthetic-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,YAAY,EACZ,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAWjC,MAAM,UAAU,oBAAoB;IAClC,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9D,OAAO;QACL,UAAU;QACV,iBAAiB,CAAC,GAA2B;YAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,uBAAuB,CAAC;YACzC,IAAI,CAAC,IAAI;gBAAE,OAAO;YAClB,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,CAAC;QACtE,CAAC;QACD,SAAS;YACP,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;YAC5D,OAAO,UAAU,CAAC,IAAI,CAAC;gBACrB,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAa;gBACrD,CAAC,CAAC,IAAI,CAAC;QACX,CAAC;KACF,CAAC;AACJ,CAAC"}