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

package/dist/restorer/external-impls/loader.js.map

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

package/dist/restorer/external-impls/package-hash.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Deterministic recursive package-content hash for `manifest.package.hash`
+ * verification. Walks the package directory in sorted order, hashes each
+ * file's `relPath + "\0" + contents`, and folds the per-file digests into
+ * a rolling sha256 to produce a single hex digest the daemon can compare
+ * against the manifest's claimed `sha256:<64hex>`.
+ *
+ * Exclusions mirror `walkArtifacts` / `createWorkdirTarball` in
+ * `engine/packaging.ts`: `node_modules/`, `.git/`, `test/`, dotfiles,
+ * symlinks. Absolute paths and symlinks short-circuit (we never follow
+ * them) — the publisher must produce a pure tree of regular files.
+ *
+ * The relative path is normalised to forward-slash form before hashing so
+ * the digest is stable across Linux / macOS / Windows publishers.
+ */
+import type { JinnManifest } from '../manifest/index.js';
+/**
+ * Compute the deterministic package-content sha256 for `packageDir`.
+ * Returned as `sha256:<64hex>` to match the manifest field shape.
+ */
+export declare function computePackageHash(packageDir: string): `sha256:${string}`;
+/**
+ * Verify the package directory matches `manifest.package.hash`.
+ * Returns true iff the recomputed digest matches exactly.
+ */
+export declare function verifyPackageHash(packageDir: string, manifest: JinnManifest): Promise<boolean>;

package/dist/restorer/external-impls/package-hash.js

@@ -0,0 +1,102 @@
+/**
+ * Deterministic recursive package-content hash for `manifest.package.hash`
+ * verification. Walks the package directory in sorted order, hashes each
+ * file's `relPath + "\0" + contents`, and folds the per-file digests into
+ * a rolling sha256 to produce a single hex digest the daemon can compare
+ * against the manifest's claimed `sha256:<64hex>`.
+ *
+ * Exclusions mirror `walkArtifacts` / `createWorkdirTarball` in
+ * `engine/packaging.ts`: `node_modules/`, `.git/`, `test/`, dotfiles,
+ * symlinks. Absolute paths and symlinks short-circuit (we never follow
+ * them) — the publisher must produce a pure tree of regular files.
+ *
+ * The relative path is normalised to forward-slash form before hashing so
+ * the digest is stable across Linux / macOS / Windows publishers.
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync, readdirSync, lstatSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+const EXCLUDED_DIRS = new Set(['node_modules', '.git', 'test']);
+function shouldSkip(name) {
+    if (name.startsWith('.'))
+        return true; // dotfiles + .git, .DS_Store, etc.
+    if (EXCLUDED_DIRS.has(name))
+        return true;
+    return false;
+}
+function collectFiles(packageDir, current, out) {
+    let entries;
+    try {
+        entries = readdirSync(current);
+    }
+    catch {
+        return;
+    }
+    entries.sort();
+    for (const name of entries) {
+        if (shouldSkip(name))
+            continue;
+        const full = join(current, name);
+        let st;
+        try {
+            st = lstatSync(full);
+        }
+        catch {
+            continue;
+        }
+        // Refuse to follow symlinks — the package-hash contract is a tree
+        // of regular files anchored at packageDir.
+        if (st.isSymbolicLink())
+            continue;
+        if (st.isDirectory()) {
+            collectFiles(packageDir, full, out);
+        }
+        else if (st.isFile()) {
+            // Always exclude the manifest itself: its hash field is a
+            // commitment to the rest of the package (and the signature
+            // makes it tamper-evident on its own).
+            const rel = relative(packageDir, full);
+            if (rel === 'jinn.manifest.json')
+                continue;
+            out.push(full);
+        }
+    }
+}
+/**
+ * Compute the deterministic package-content sha256 for `packageDir`.
+ * Returned as `sha256:<64hex>` to match the manifest field shape.
+ */
+export function computePackageHash(packageDir) {
+    const files = [];
+    collectFiles(packageDir, packageDir, files);
+    // collectFiles produces sorted-per-directory order; normalise to a
+    // single global sort over POSIX-form relative paths so the digest is
+    // platform-stable.
+    const ordered = files
+        .map((abs) => ({
+        abs,
+        rel: relative(packageDir, abs).split(sep).join('/'),
+    }))
+        .sort((a, b) => (a.rel < b.rel ? -1 : a.rel > b.rel ? 1 : 0));
+    const rolling = createHash('sha256');
+    for (const { abs, rel } of ordered) {
+        const contents = readFileSync(abs);
+        const perFile = createHash('sha256')
+            .update(rel)
+            .update(Buffer.from([0]))
+            .update(contents)
+            .digest();
+        rolling.update(perFile);
+    }
+    return `sha256:${rolling.digest('hex')}`;
+}
+/**
+ * Verify the package directory matches `manifest.package.hash`.
+ * Returns true iff the recomputed digest matches exactly.
+ */
+export async function verifyPackageHash(packageDir, manifest) {
+    const expected = manifest.package.hash;
+    const actual = computePackageHash(packageDir);
+    return actual === expected;
+}
+//# sourceMappingURL=package-hash.js.map

package/dist/restorer/external-impls/package-hash.js.map

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

package/dist/restorer/external-impls/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Config types for operator-declared external impls. The loader and
+ * future config parsing both consume these. Kept in a self-contained
+ * module so daemon config wiring can adopt them without pulling in
+ * loader internals.
+ *
+ * Spec: `spec/2026-05-registry-discovery.md` §4.
+ */
+export interface ExternalImplEntry {
+    /** MUST equal the manifest's `name`. */
+    name: string;
+    /**
+     * Pointer to the manifest source. Reserved for future ipfs:// /
+     * https:// fetching; currently the loader expects a local
+     * directory path (see `entry`).
+     */
+    package?: string;
+    /**
+     * Local path the loader uses to find both `jinn.manifest.json` and
+     * the entry module. Typically points to a node_modules directory
+     * (e.g. `node_modules/@example/forecaster`).
+     */
+    entry: string;
+    /**
+     * Optional operator-pinned version. When set, the loader rejects
+     * the impl if `manifest.version` does not match this string exactly.
+     * Lets operators pin a specific package version in config without
+     * relying on `node_modules/` discipline.
+     */
+    version?: string;
+}
+export interface SignerTrust {
+    alg: 'ed25519';
+    publicKey: string;
+    label?: string;
+}
+export interface RestorersConfig {
+    /** Names of in-repo or external impls to suppress for this fleet. */
+    disabled?: readonly string[];
+    /** Operator-supplied external impls. */
+    externalImpls?: readonly ExternalImplEntry[];
+}

package/dist/restorer/external-impls/types.js

@@ -0,0 +1,10 @@
+/**
+ * Config types for operator-declared external impls. The loader and
+ * future config parsing both consume these. Kept in a self-contained
+ * module so daemon config wiring can adopt them without pulling in
+ * loader internals.
+ *
+ * Spec: `spec/2026-05-registry-discovery.md` §4.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/restorer/external-impls/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/restorer/external-impls/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

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

@@ -0,0 +1,38 @@
+import { spawn } from 'node:child_process';
+import type { HarnessAdapter, IntentSessionInputs } from '../types.js';
+export interface ClaudeCodeHarnessAdapterConfig {
+    /** Path to the `claude` executable. Default: 'claude' (from PATH). */
+    claudePath?: string;
+    /** Optional model override (e.g. 'claude-sonnet-4-6'). */
+    claudeModel?: string;
+    /**
+     * Plugin install directory for Claude Code. Defaults to
+     * `~/.claude/plugins/`. The adapter copies (or symlinks) the plugin
+     * into this directory before spawning.
+     */
+    pluginInstallDir?: string;
+    /**
+     * Override spawn for testing. When provided, called instead of
+     * node:child_process.spawn so tests can inject a fake child process.
+     */
+    _spawnFn?: typeof spawn;
+}
+/**
+ * Real Claude Code adapter. Spawns the `claude` CLI with the plugin
+ * loaded via Claude Code's plugin install directory, sets IMPL_STATE_DIR
+ * so the session-start hook fires correctly, and hands the coordinator
+ * an initial prompt with intent context.
+ *
+ * Output collection is delegated to the shim's harvester — this adapter
+ * only owns the spawn lifecycle.
+ */
+export declare class ClaudeCodeHarnessAdapter implements HarnessAdapter {
+    readonly name = "claude-code";
+    readonly allowsHarnessSelfModification = false;
+    private readonly claudePath;
+    private readonly claudeModel;
+    private readonly pluginInstallDir;
+    private readonly spawnFn;
+    constructor(config?: ClaudeCodeHarnessAdapterConfig);
+    runIntent(inputs: IntentSessionInputs, pluginRoot: string): Promise<void>;
+}

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

@@ -0,0 +1,200 @@
+import { spawn } from 'node:child_process';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { mergeMcpConfig, mergeMemoryBackendsIntoMcpConfig, pluginDirsForSession, } from '../mcp-config.js';
+/**
+ * Allowlist of env vars that propagate to the spawned Claude session.
+ * We deliberately limit this to avoid leaking unrelated credentials
+ * into the agent process.
+ *
+ * Mirror of the canonical allowlist in client/src/runner/claude.ts.
+ * Hard-won from prior auth/runtime issues — keep in sync with that file.
+ */
+const ENV_ALLOWLIST = [
+    'PATH',
+    'HOME',
+    'USER',
+    'SHELL',
+    'LANG',
+    'TERM',
+    'TMPDIR',
+    'XDG_CONFIG_HOME',
+    'XDG_DATA_HOME',
+    'XDG_CACHE_HOME',
+    'NODE_PATH',
+    'NODE_OPTIONS',
+    'NPM_CONFIG_PREFIX',
+    // Claude Code auth — needed in Docker where keychain is unavailable.
+    // CLAUDE_CODE_OAUTH_TOKEN is the output of `claude setup-token` (subscription
+    // path, year-long validity); ANTHROPIC_API_KEY is the pay-per-request fallback.
+    // Both are Claude credentials, not Jinn operator secrets, so forwarding is
+    // scoped and intentional. Without these the spawned `claude -p …` fails with
+    // "Not logged in · Please run /login".
+    'CLAUDE_CODE_OAUTH_TOKEN',
+    'ANTHROPIC_API_KEY',
+];
+function buildAgentEnv(extra) {
+    const env = {};
+    for (const key of ENV_ALLOWLIST) {
+        if (process.env[key])
+            env[key] = process.env[key];
+    }
+    return { ...env, ...extra };
+}
+/**
+ * Construct the initial prompt that invokes the coordinator skill with
+ * the intent context.
+ */
+function buildInitialPrompt(inputs) {
+    return [
+        'You are running a Jinn restoration intent. Invoke the `claude-code-learner:coordinator` skill via the Skill tool to begin.',
+        '',
+        'Session inputs (refer to these when the coordinator skill or any phase asks for them):',
+        `- intent.id = ${inputs.intentId}`,
+        inputs.intentCid ? `- intent.cid = ${inputs.intentCid}` : '',
+        inputs.intentKind ? `- intent.kind = ${inputs.intentKind}` : '',
+        `- workingDir = ${inputs.workingDir}`,
+        `- implStateDir = ${inputs.implStateDir}`,
+        `- window.startTs = ${inputs.windowStartTs} (ms since epoch)`,
+        `- window.endTs = ${inputs.windowEndTs} (ms since epoch)`,
+        `- msUntilEndTs = ${inputs.msUntilEndTs}`,
+        inputs.intentBody
+            ? `\nintent (full body):\n${JSON.stringify(inputs.intentBody, null, 2)}`
+            : '',
+        '',
+        'Run the phases specified by JINN_CLAUDE_CODE_LEARNER_PHASE_RANGE (defaults to all seven if unset) and return when complete.',
+    ]
+        .filter((line) => line !== '')
+        .join('\n');
+}
+/**
+ * Real Claude Code adapter. Spawns the `claude` CLI with the plugin
+ * loaded via Claude Code's plugin install directory, sets IMPL_STATE_DIR
+ * so the session-start hook fires correctly, and hands the coordinator
+ * an initial prompt with intent context.
+ *
+ * Output collection is delegated to the shim's harvester — this adapter
+ * only owns the spawn lifecycle.
+ */
+export class ClaudeCodeHarnessAdapter {
+    name = 'claude-code';
+    allowsHarnessSelfModification = false;
+    claudePath;
+    claudeModel;
+    pluginInstallDir;
+    spawnFn;
+    constructor(config = {}) {
+        this.claudePath = config.claudePath ?? 'claude';
+        this.claudeModel = config.claudeModel;
+        this.pluginInstallDir = config.pluginInstallDir ?? join(homedir(), '.claude', 'plugins');
+        this.spawnFn = config._spawnFn ?? spawn;
+    }
+    async runIntent(inputs, pluginRoot) {
+        // Ensure the plugin install directory exists. The adapter does NOT
+        // copy the plugin — that's the operator's responsibility per the
+        // README. If the operator has not installed it, Claude Code will
+        // not find the coordinator skill and will fail; check for it here.
+        mkdirSync(this.pluginInstallDir, { recursive: true });
+        const prompt = buildInitialPrompt(inputs);
+        const args = ['-p', prompt];
+        if (this.claudeModel)
+            args.push('--model', this.claudeModel);
+        // Path 1 plug-in surface: when the shim has a slot registry, build
+        // the harness mcp-config (mcp-tool + memory-backend slots) and union
+        // the plug-in skill-bundle package roots with the bundled plugin
+        // root. See spec/2026-04-30-plug-in-surface.md §4 + plan tasks 9.5 / 10.2.
+        const registryJson = inputs.adapterEnv?.JINN_SLOT_REGISTRY_JSON;
+        let pluginDirs = [pluginRoot];
+        let mcpConfigPath;
+        if (registryJson) {
+            try {
+                const registry = JSON.parse(registryJson);
+                const baseline = { mcpServers: {} };
+                const withTools = mergeMcpConfig(baseline, registry.mcpTools.map((s) => ({
+                    plugInName: s.plugInName,
+                    plugInVersion: registry.learnerVersion,
+                    packageRoot: s.packageRoot,
+                    slot: s.slot,
+                })));
+                const withMemory = mergeMemoryBackendsIntoMcpConfig(withTools, registry.memoryBackends.map((s) => ({
+                    plugInName: s.plugInName,
+                    plugInVersion: registry.learnerVersion,
+                    packageRoot: s.packageRoot,
+                    slot: s.slot,
+                })));
+                if (Object.keys(withMemory.mcpServers).length > 0) {
+                    mcpConfigPath = join(inputs.workingDir, '.coordinator', 'mcp.json');
+                    mkdirSync(join(inputs.workingDir, '.coordinator'), { recursive: true });
+                    writeFileSync(mcpConfigPath, JSON.stringify(withMemory, null, 2));
+                }
+                pluginDirs = pluginDirsForSession({ skillBundles: registry.skillBundles }, pluginRoot);
+            }
+            catch (err) {
+                // Bad registry JSON should not abort the spawn — log and continue
+                // with the bundled plugin only.
+                // eslint-disable-next-line no-console
+                console.warn(`[claude-code-adapter] failed to apply slot registry: ${err.message}`);
+            }
+        }
+        if (mcpConfigPath)
+            args.push('--mcp-config', mcpConfigPath);
+        for (const dir of pluginDirs)
+            args.push('--plugin-dir', dir);
+        const env = buildAgentEnv({
+            IMPL_STATE_DIR: inputs.implStateDir,
+            // Surfaced for the session-start hook so Path 1 plug-in slot
+            // registry can be materialised into workingDir/.coordinator/slots.json.
+            WORKING_DIR: inputs.workingDir,
+            JINN_WORKING_DIR: inputs.workingDir,
+            JINN_CLAUDE_CODE_LEARNER_PLUGIN_ROOT: pluginRoot,
+            ...(inputs.adapterEnv ?? {}),
+        });
+        const spawnOpts = {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env,
+            cwd: inputs.workingDir,
+        };
+        return new Promise((resolve, reject) => {
+            const child = this.spawnFn(this.claudePath, args, spawnOpts);
+            // If the abort signal already fired before we got here (race), kill
+            // the child immediately. Without this, addEventListener below would
+            // never fire (signals only emit on transition to aborted, not when
+            // already aborted).
+            if (inputs.abort.aborted) {
+                if (!child.killed)
+                    child.kill('SIGTERM');
+            }
+            // Window-end abort: kill child, reject.
+            const onAbort = () => {
+                if (!child.killed)
+                    child.kill('SIGTERM');
+            };
+            inputs.abort.addEventListener('abort', onAbort);
+            let stderr = '';
+            child.stderr?.on('data', (d) => {
+                stderr += d.toString();
+            });
+            child.on('exit', (code, signal) => {
+                inputs.abort.removeEventListener('abort', onAbort);
+                if (code === 0) {
+                    resolve();
+                }
+                else if (inputs.abort.aborted) {
+                    // Window expired; resolve anyway so harvester can collect
+                    // partial outputs. The shim's caller (engine) handles the
+                    // abort signal separately.
+                    resolve();
+                }
+                else {
+                    reject(new Error(`claude-code adapter: child exited with code=${code} signal=${signal}: ${stderr.slice(0, 500)}`));
+                }
+            });
+            child.on('error', (err) => {
+                inputs.abort.removeEventListener('abort', onAbort);
+                reject(err);
+            });
+        });
+    }
+}
+//# sourceMappingURL=claude-code.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { RestorationOutput } from '../../types.js';
+/**
+ * Like safeReadJson but throws on missing file or invalid JSON.
+ * Used for required phase artifacts where a silent failure would allow an
+ * empty-looking success to propagate through the engine.
+ */
+export declare function requiredReadJson(path: string): Record<string, unknown>;
+/**
+ * Construct RestorationOutput from the plugin's per-phase artifacts.
+ *
+ * Phase range (from phaseRange arg, JINN_CLAUDE_CODE_LEARNER_PHASE_RANGE env, or 'full'):
+ *   full         — all 7 phases required
+ *   pre-execute  — orient, strategize, plan required (phases 1–3)
+ *   post-execute — debrief, improve, memory-consolidation required (phases 5–7)
+ *
+ * Required phase artifacts: hard-fail (throw) if missing or corrupt JSON.
+ * Optional phase artifacts (outside the required range): safeReadJson + warn on null.
+ */
+export declare function harvestOutput(workingDir: string, phaseRange?: string): RestorationOutput;

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

@@ -0,0 +1,146 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+const PHASE_ORDER = [
+    'orient',
+    'strategize',
+    'plan',
+    'execute',
+    'debrief',
+    'improve',
+    'memory-consolidation',
+];
+const PHASE_PRIMARY_ARTIFACT = {
+    orient: 'summary.json',
+    strategize: 'strategy.json',
+    plan: 'plan.json',
+    execute: 'summary.json',
+    debrief: 'analysis.json',
+    improve: 'summary.json',
+    'memory-consolidation': 'consolidation_record.json',
+};
+const REQUIRED_PHASES = {
+    full: [...PHASE_ORDER],
+    'pre-execute': ['orient', 'strategize', 'plan'],
+    'post-execute': ['debrief', 'improve', 'memory-consolidation'],
+};
+function safeReadJson(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        const text = readFileSync(path, 'utf8');
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Like safeReadJson but throws on missing file or invalid JSON.
+ * Used for required phase artifacts where a silent failure would allow an
+ * empty-looking success to propagate through the engine.
+ */
+export function requiredReadJson(path) {
+    if (!existsSync(path)) {
+        throw new Error(`Required artifact missing: ${path}`);
+    }
+    let text;
+    try {
+        text = readFileSync(path, 'utf8');
+    }
+    catch (err) {
+        throw new Error(`Cannot read required artifact ${path}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (err) {
+        throw new Error(`Required artifact contains invalid JSON: ${path}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function detectCompletedPhases(workingDir) {
+    const completed = [];
+    for (const phase of PHASE_ORDER) {
+        const dir = join(workingDir, `.${phase}`);
+        if (!existsSync(dir))
+            continue;
+        try {
+            const stat = statSync(dir);
+            if (!stat.isDirectory())
+                continue;
+            const entries = readdirSync(dir);
+            if (entries.length > 0)
+                completed.push(phase);
+        }
+        catch {
+            // Best-effort; ignore permission / IO errors.
+        }
+    }
+    return completed;
+}
+function resolvePhaseRange(override) {
+    const raw = override ?? process.env.JINN_CLAUDE_CODE_LEARNER_PHASE_RANGE ?? 'full';
+    if (raw === 'pre-execute' || raw === 'post-execute')
+        return raw;
+    return 'full';
+}
+/**
+ * Construct RestorationOutput from the plugin's per-phase artifacts.
+ *
+ * Phase range (from phaseRange arg, JINN_CLAUDE_CODE_LEARNER_PHASE_RANGE env, or 'full'):
+ *   full         — all 7 phases required
+ *   pre-execute  — orient, strategize, plan required (phases 1–3)
+ *   post-execute — debrief, improve, memory-consolidation required (phases 5–7)
+ *
+ * Required phase artifacts: hard-fail (throw) if missing or corrupt JSON.
+ * Optional phase artifacts (outside the required range): safeReadJson + warn on null.
+ */
+export function harvestOutput(workingDir, phaseRange) {
+    const range = resolvePhaseRange(phaseRange);
+    const requiredPhases = new Set(REQUIRED_PHASES[range]);
+    // Hard-fail on missing or corrupt primary artifacts for all required phases.
+    const validated = new Map();
+    for (const phase of REQUIRED_PHASES[range]) {
+        const path = join(workingDir, `.${phase}`, PHASE_PRIMARY_ARTIFACT[phase]);
+        validated.set(phase, requiredReadJson(path));
+    }
+    const phasesCompleted = detectCompletedPhases(workingDir);
+    const gating = { phasesCompleted };
+    // Read a phase's primary artifact for optional gating-field extraction.
+    // Required phases: use the already-validated result (no second read).
+    // Optional phases: safeReadJson + warn on null.
+    function readForGating(phase) {
+        if (requiredPhases.has(phase)) {
+            return validated.get(phase) ?? null;
+        }
+        const path = join(workingDir, `.${phase}`, PHASE_PRIMARY_ARTIFACT[phase]);
+        const data = safeReadJson(path);
+        if (data === null) {
+            console.warn(`[claude-code-learner] harvestOutput: optional artifact absent or corrupt — ${path}`);
+        }
+        return data;
+    }
+    const strategy = readForGating('strategize');
+    if (strategy && typeof strategy.timingPosture === 'string') {
+        gating.timingPosture = strategy.timingPosture;
+    }
+    const exec = readForGating('execute');
+    if (exec) {
+        if (typeof exec.returnReason === 'string')
+            gating.executeReturnReason = exec.returnReason;
+        if (Array.isArray(exec.stepsCompleted))
+            gating.executeStepsCompleted = exec.stepsCompleted.length;
+        if (Array.isArray(exec.stepsFailed))
+            gating.executeStepsFailed = exec.stepsFailed.length;
+        if (typeof exec.elapsedMs === 'number')
+            gating.executeElapsedMs = exec.elapsedMs;
+    }
+    const debrief = readForGating('debrief');
+    if (debrief && typeof debrief.successCriteriaMet === 'string') {
+        gating.debriefVerdict = debrief.successCriteriaMet;
+    }
+    return {
+        venueRef: { name: 'claude-code-learner' },
+        gating,
+    };
+}
+//# sourceMappingURL=harvest.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * @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 type { HarnessAdapter, IntentSessionInputs, ClaudeCodeLearnerConfig, } from './types.js';
+export { ClaudeCodeLearnerImpl } from './restorer.js';
+export { resolvePluginRoot } from './plugin-path.js';
+export { harvestOutput } from './harvest.js';
+export { ClaudeCodeHarnessAdapter } from './adapters/claude-code.js';
+export type { ClaudeCodeHarnessAdapterConfig } from './adapters/claude-code.js';
+export { ClaudeCodeLearnerWrapper, type ClaudeCodeLearnerWrapperConfig } from './wrapper.js';