@jinn-network/client 0.1.2 → 0.1.3-canary.12cf8b76

package/dist/harnesses/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 HarnessesConfig {
+    /** Names of in-repo or external impls to suppress for this fleet. */
+    disabled?: readonly string[];
+    /** Operator-supplied external impls. */
+    externalImpls?: readonly ExternalImplEntry[];
+}

package/dist/harnesses/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/harnesses/external-impls/types.js.map

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

package/dist/harnesses/freeze.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Deterministic content hashing for implStateDir directories.
+ *
+ * Used by the daemon's freeze-fence (`client/src/daemon/freeze-fence.ts`)
+ * to detect violations of the frozen-mode contract — a harness MUST NOT
+ * mutate `implStateDir` when running with `ctx.mode === 'frozen'`. The
+ * daemon hashes the directory before and after each Task and rejects the
+ * envelope on mismatch.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §6.3
+ */
+/**
+ * Compute a deterministic SHA-256 hash of an `implStateDir`'s contents.
+ *
+ * Algorithm:
+ *   1. Walk the directory tree recursively.
+ *   2. For each file, hash its content with SHA-256.
+ *   3. Sort entries by relative path (canonical ordering, OS-independent).
+ *   4. Combine "<relpath>:<filehash>\n" lines and hash the whole thing.
+ *
+ * Properties:
+ *   - Deterministic: same content → same hash.
+ *   - Order-stable: filesystem listing order does not affect output.
+ *   - Order-sensitive: file path differences DO affect output.
+ *   - Recursive: walks subdirectories.
+ *   - Metadata-independent: mtimes, permissions, file order do not affect output.
+ *
+ * Cost: O(total bytes) read + SHA-256. For typical claude-code-learner
+ * implStateDir (~few MB) this is sub-second.
+ *
+ * Returns a 64-character lowercase hex string (no `sha256:` prefix; callers
+ * that need that prefix add it themselves).
+ */
+export declare function hashImplStateDir(dirPath: string): Promise<string>;

package/dist/harnesses/freeze.js

@@ -0,0 +1,60 @@
+/**
+ * Deterministic content hashing for implStateDir directories.
+ *
+ * Used by the daemon's freeze-fence (`client/src/daemon/freeze-fence.ts`)
+ * to detect violations of the frozen-mode contract — a harness MUST NOT
+ * mutate `implStateDir` when running with `ctx.mode === 'frozen'`. The
+ * daemon hashes the directory before and after each Task and rejects the
+ * envelope on mismatch.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §6.3
+ */
+import { createHash } from 'node:crypto';
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+/**
+ * Compute a deterministic SHA-256 hash of an `implStateDir`'s contents.
+ *
+ * Algorithm:
+ *   1. Walk the directory tree recursively.
+ *   2. For each file, hash its content with SHA-256.
+ *   3. Sort entries by relative path (canonical ordering, OS-independent).
+ *   4. Combine "<relpath>:<filehash>\n" lines and hash the whole thing.
+ *
+ * Properties:
+ *   - Deterministic: same content → same hash.
+ *   - Order-stable: filesystem listing order does not affect output.
+ *   - Order-sensitive: file path differences DO affect output.
+ *   - Recursive: walks subdirectories.
+ *   - Metadata-independent: mtimes, permissions, file order do not affect output.
+ *
+ * Cost: O(total bytes) read + SHA-256. For typical claude-code-learner
+ * implStateDir (~few MB) this is sub-second.
+ *
+ * Returns a 64-character lowercase hex string (no `sha256:` prefix; callers
+ * that need that prefix add it themselves).
+ */
+export async function hashImplStateDir(dirPath) {
+    const entries = [];
+    async function walk(currentPath) {
+        const items = (await readdir(currentPath)).sort();
+        for (const item of items) {
+            const full = join(currentPath, item);
+            const s = await stat(full);
+            if (s.isDirectory()) {
+                await walk(full);
+            }
+            else if (s.isFile()) {
+                const content = await readFile(full);
+                const fileHash = createHash('sha256').update(content).digest('hex');
+                entries.push({ relPath: relative(dirPath, full), fileHash });
+            }
+            // Symlinks and special files are skipped (not expected in implStateDir).
+        }
+    }
+    await walk(dirPath);
+    entries.sort((a, b) => a.relPath.localeCompare(b.relPath));
+    const combined = entries.map((e) => `${e.relPath}:${e.fileHash}`).join('\n');
+    return createHash('sha256').update(combined).digest('hex');
+}
+//# sourceMappingURL=freeze.js.map

package/dist/harnesses/freeze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freeze.js","sourceRoot":"","sources":["../../src/harnesses/freeze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IACpD,MAAM,OAAO,GAAiD,EAAE,CAAC;IAEjE,KAAK,UAAU,IAAI,CAAC,WAAmB;QACrC,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACpE,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,yEAAyE;QAC3E,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;IAEpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,57 @@
+import { spawn } from 'node:child_process';
+import type { HarnessAdapter, TaskSessionInputs } 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;
+    /**
+     * Local SQLite store path forwarded to the Jinn client MCP server exposed by
+     * Network Tools. Without it, read-only record search degrades to an empty
+     * no-store response.
+     */
+    storePath?: string;
+    /** Daemon API URL used by explicit cost-mutating MCP tools such as acquire_artifact. */
+    daemonApiUrl?: string;
+    /** Bearer token for daemon API cost-mutating routes. */
+    daemonApiToken?: string;
+    /** Keyless corpus endpoints for read-only record search and inspection. */
+    corpusEnv?: {
+        subgraphUrl?: string;
+        ipfsGatewayUrl?: 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 learn skill
+ * an initial prompt with task 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 storePath;
+    private readonly daemonApiUrl;
+    private readonly daemonApiToken;
+    private readonly corpusEnv;
+    private readonly pluginInstallDir;
+    private readonly spawnFn;
+    constructor(config?: ClaudeCodeHarnessAdapterConfig);
+    runTask(inputs: TaskSessionInputs, pluginRoot: string): Promise<void>;
+}

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

@@ -0,0 +1,235 @@
+import { spawn } from 'node:child_process';
+import { createWriteStream, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { finished } from 'node:stream/promises';
+/**
+ * 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 };
+}
+function stringField(value) {
+    return typeof value === 'string' ? value : '';
+}
+function taskContextJson(inputs) {
+    const context = inputs.taskBody?.context;
+    if (!context || typeof context !== 'object')
+        return '';
+    try {
+        return JSON.stringify(context);
+    }
+    catch {
+        return '';
+    }
+}
+function captureLogError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+/**
+ * Construct the initial prompt that invokes the learn skill with
+ * the task context.
+ */
+function buildInitialPrompt(inputs) {
+    return [
+        'You are running a task through the claude-code-learner harness.',
+        'Use the `claude-code-learner:learn` skill end-to-end. The skill defines the seven-phase learning loop; follow it.',
+        '',
+        'Session inputs:',
+        `- goal.id = ${inputs.taskId}`,
+        inputs.taskCid ? `- goal.cid = ${inputs.taskCid}` : '',
+        `- workingDir = ${inputs.workingDir}`,
+        `- implStateDir = ${inputs.implStateDir}`,
+        `- goal.deadline = ${inputs.windowEndTs} (ms since epoch)`,
+        `- msUntilDeadline = ${inputs.msUntilEndTs}`,
+        `- mode = ${inputs.mode}`,
+        inputs.taskBody
+            ? `\ngoal (full body):\n${JSON.stringify(inputs.taskBody, null, 2)}`
+            : '',
+    ]
+        .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 learn skill
+ * an initial prompt with task 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;
+    storePath;
+    daemonApiUrl;
+    daemonApiToken;
+    corpusEnv;
+    pluginInstallDir;
+    spawnFn;
+    constructor(config = {}) {
+        this.claudePath = config.claudePath ?? 'claude';
+        this.claudeModel = config.claudeModel;
+        this.storePath = config.storePath;
+        this.daemonApiUrl = config.daemonApiUrl;
+        this.daemonApiToken = config.daemonApiToken;
+        this.corpusEnv = config.corpusEnv;
+        this.pluginInstallDir = config.pluginInstallDir ?? join(homedir(), '.claude', 'plugins');
+        this.spawnFn = config._spawnFn ?? spawn;
+    }
+    async runTask(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 learn skill and will fail; check for it here.
+        mkdirSync(this.pluginInstallDir, { recursive: true });
+        const prompt = buildInitialPrompt(inputs);
+        const args = [
+            '--setting-sources',
+            'project',
+            '--permission-mode',
+            'bypassPermissions',
+            '--verbose',
+            '--output-format',
+            'stream-json',
+            '--include-hook-events',
+            '-p',
+            prompt,
+        ];
+        const claudeModel = inputs.claudeModel ?? this.claudeModel;
+        if (claudeModel)
+            args.push('--model', claudeModel);
+        for (const dir of [pluginRoot, ...(inputs.pluginRoots ?? [])]) {
+            args.push('--plugin-dir', dir);
+        }
+        const env = buildAgentEnv({
+            IMPL_STATE_DIR: inputs.implStateDir,
+            WORKING_DIR: inputs.workingDir,
+            JINN_WORKING_DIR: inputs.workingDir,
+            JINN_CLAUDE_CODE_LEARNER_PLUGIN_ROOT: pluginRoot,
+            DESIRED_STATE_ID: inputs.taskId,
+            DESIRED_STATE_DESCRIPTION: stringField(inputs.taskBody?.description),
+            DESIRED_STATE_CONTEXT: taskContextJson(inputs),
+            DESIRED_STATE_ROLE: stringField(inputs.taskBody?.role),
+            RESTORATION_REQUEST_ID: stringField(inputs.taskBody?.restorationRequestId),
+            REQUEST_ID: inputs.requestId ?? inputs.taskId,
+            STORE_PATH: this.storePath ?? '',
+            DAEMON_API_URL: this.daemonApiUrl ?? '',
+            DAEMON_API_TOKEN: this.daemonApiToken ?? '',
+            JINN_CORPUS_SUBGRAPH_URL: this.corpusEnv?.subgraphUrl ?? '',
+            JINN_CORPUS_IPFS_GATEWAY_URL: this.corpusEnv?.ipfsGatewayUrl ?? '',
+            ...(inputs.adapterEnv ?? {}),
+        });
+        const spawnOpts = {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env,
+            cwd: inputs.workingDir,
+        };
+        return new Promise((resolve, reject) => {
+            const logDir = join(inputs.workingDir, '.claude-code');
+            mkdirSync(logDir, { recursive: true });
+            const stdoutLog = createWriteStream(join(logDir, 'stdout.jsonl'), { flags: 'a' });
+            const stderrLog = createWriteStream(join(logDir, 'stderr.log'), { flags: 'a' });
+            const stdoutDone = finished(stdoutLog).then(() => null, captureLogError);
+            const stderrDone = finished(stderrLog).then(() => null, captureLogError);
+            const closeLogs = async () => {
+                if (!stdoutLog.writableEnded)
+                    stdoutLog.end();
+                if (!stderrLog.writableEnded)
+                    stderrLog.end();
+                const [stdoutErr, stderrErr] = await Promise.all([stdoutDone, stderrDone]);
+                if (stdoutErr)
+                    throw stdoutErr;
+                if (stderrErr)
+                    throw stderrErr;
+            };
+            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.stdout?.on('data', (d) => {
+                stdoutLog.write(d);
+            });
+            child.stderr?.on('data', (d) => {
+                stderrLog.write(d);
+                stderr += d.toString();
+            });
+            let settled = false;
+            const settleAfterLogs = (complete, onLogError = reject) => {
+                if (settled)
+                    return;
+                settled = true;
+                inputs.abort.removeEventListener('abort', onAbort);
+                closeLogs().then(complete, onLogError);
+            };
+            child.on('exit', (code, signal) => {
+                settleAfterLogs(() => {
+                    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) => {
+                settleAfterLogs(() => reject(err), () => reject(err));
+            });
+        });
+    }
+}
+//# sourceMappingURL=claude-code.js.map

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

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

package/dist/harnesses/impls/claude-code-learner/harness.d.ts

@@ -0,0 +1,22 @@
+import type { Harness, HarnessContext, Solution } from '../../types.js';
+import type { ClaudeCodeLearnerConfig } from './types.js';
+/**
+ * `Harness` shell. Bridges the engine's dispatch contract
+ * (`await impl.run(ctx)`) into the harness adapter + markdown plugin.
+ *
+ * `supports()` returns true for any non-evaluation SolverType. The registry
+ * keeps this Harness as the default, so explicit specialists can still claim
+ * their SolverTypes without being wrapped.
+ */
+export declare class ClaudeCodeLearnerImpl implements Harness {
+    readonly name: string;
+    readonly version: string;
+    private readonly adapter;
+    private readonly pluginRoot;
+    constructor(config: ClaudeCodeLearnerConfig);
+    supports(spec: {
+        solverType: string;
+        role?: 'restoration' | 'evaluation';
+    }): boolean;
+    run(ctx: HarnessContext): Promise<Solution>;
+}

package/dist/harnesses/impls/claude-code-learner/harness.js

@@ -0,0 +1,56 @@
+import { resolvePluginRoot } from './plugin-path.js';
+import { harvestOutput } from './harvest.js';
+/**
+ * `Harness` shell. Bridges the engine's dispatch contract
+ * (`await impl.run(ctx)`) into the harness adapter + markdown plugin.
+ *
+ * `supports()` returns true for any non-evaluation SolverType. The registry
+ * keeps this Harness as the default, so explicit specialists can still claim
+ * their SolverTypes without being wrapped.
+ */
+export class ClaudeCodeLearnerImpl {
+    name;
+    version;
+    adapter;
+    pluginRoot;
+    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();
+    }
+    supports(spec) {
+        if (spec.role === 'evaluation')
+            return false;
+        // These SolverTypes have first-party restoration Harnesses that return
+        // typed solutionPayload objects. The learner emits phase artifacts for its
+        // own pipeline; letting it claim these specialist tasks can run Claude but
+        // fail packaging when the phase artifacts are absent.
+        if (spec.solverType === 'prediction.v1' || spec.solverType === 'prediction.apy.v0') {
+            return false;
+        }
+        return true;
+    }
+    async run(ctx) {
+        const window = ctx.task.window ?? { startTs: 0, endTs: 0 };
+        const inputs = {
+            taskId: ctx.task.id,
+            requestId: ctx.requestId,
+            taskCid: ctx.taskCid,
+            solverType: ctx.task.solverType,
+            claudeModel: ctx.solverNet?.model,
+            taskBody: ctx.task,
+            implStateDir: ctx.implStateDir,
+            workingDir: ctx.workingDir,
+            pluginRoots: [...(ctx.solverPluginRoots ?? [])],
+            windowStartTs: window.startTs,
+            windowEndTs: window.endTs,
+            msUntilEndTs: ctx.msUntilEndTs(),
+            abort: ctx.abort,
+            mode: ctx.mode,
+        };
+        await this.adapter.runTask(inputs, this.pluginRoot);
+        return harvestOutput(ctx.workingDir);
+    }
+}
+//# sourceMappingURL=harness.js.map

package/dist/harnesses/impls/claude-code-learner/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-code-learner/harness.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IACvB,IAAI,CAAS;IACb,OAAO,CAAS;IACR,OAAO,CAAiB;IACxB,UAAU,CAAS;IAEpC,YAAY,MAA+B;QACzC,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;IAC7D,CAAC;IAED,QAAQ,CAAC,IAAiE;QACxE,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,KAAK,CAAC;QAC7C,uEAAuE;QACvE,2EAA2E;QAC3E,2EAA2E;QAC3E,sDAAsD;QACtD,IAAI,IAAI,CAAC,UAAU,KAAK,eAAe,IAAI,IAAI,CAAC,UAAU,KAAK,mBAAmB,EAAE,CAAC;YACnF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAmB;QAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAsB;YAChC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE;YACnB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU;YAC/B,WAAW,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK;YACjC,QAAQ,EAAE,GAAG,CAAC,IAAqC;YACnD,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YAC/C,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,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC;QAEF,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEpD,OAAO,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;CACF"}

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

@@ -0,0 +1,20 @@
+import type { Task } from '../../../types/task.js';
+import type { Solution } 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 Solution from the plugin's per-phase artifacts.
+ *
+ * Phase range (from phaseRange arg, 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, task?: Task): Solution;