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

package/dist/restorer/impls/claude-mcp-shared/single-session-orchestrator.js

@@ -0,0 +1,206 @@
+/**
+ * Shared single-session orchestrator for the claude-mcp-prediction* impls.
+ *
+ * Both `claude-mcp-prediction` (probability) and `claude-mcp-prediction-apy`
+ * (integer APY bps) follow the same single-session shape:
+ *
+ *   1. Spawn Claude with a prompt + a single allowed MCP tool namespace.
+ *   2. Poll a shared "submitted" flag to detect the submit-tool call.
+ *   3. Terminate after a short grace period so Claude's tool response reaches it.
+ *
+ * The only differences across the two variants are:
+ *   - the `--allowedTools` value (e.g. `mcp__jinn-prediction__*`)
+ *   - log prefixes (e.g. `prediction-session` vs `apy-prediction-session`)
+ *   - the named submit-tool referenced in log lines (cosmetic)
+ *
+ * Hyperliquid uses a different shape (cadence + market-move trigger) and is
+ * intentionally not refactored through this module.
+ *
+ * Slimmed-down version of:
+ *   client/src/restorer/impls/claude-mcp-hyperliquid/session-orchestrator.ts:97-209
+ */
+import { appendFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { spawn } from 'node:child_process';
+const DEFAULT_SESSION_MAX_MS = 180_000;
+const DEFAULT_POLL_INTERVAL_MS = 500;
+const DEFAULT_SUBMISSION_GRACE_MS = 2_000;
+/**
+ * Spawn a single Claude session, poll for a submit-tool flag, and resolve
+ * with the session result once the child exits.
+ */
+export async function runSingleSession(sessionId, prompt, config, deps) {
+    const sessionMaxMs = deps.sessionMaxMs ?? DEFAULT_SESSION_MAX_MS;
+    const pollIntervalMs = deps.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const submissionGraceMs = deps.submissionGraceMs ?? DEFAULT_SUBMISSION_GRACE_MS;
+    const sessionDir = join(deps.workingDir, 'sessions', sessionId);
+    mkdirSync(sessionDir, { recursive: true });
+    const transcriptPath = join(sessionDir, 'transcript.txt');
+    const startedAt = Date.now();
+    const startNs = `${BigInt(startedAt) * 1000000n}`;
+    writeFileSync(transcriptPath, `=== Session ${sessionId} started at ${new Date(startedAt).toISOString()} ===\n\n`);
+    const args = [
+        '-p', prompt,
+        '--mcp-config', deps.mcpConfigPath,
+        '--strict-mcp-config',
+        '--allowedTools', config.allowedTools,
+    ];
+    if (deps.claudeModel)
+        args.push('--model', deps.claudeModel);
+    // Minimal env allowlist — same set as the HL orchestrator.
+    const agentEnv = {};
+    for (const key of [
+        'PATH', 'HOME', 'USER', 'SHELL', 'LANG', 'TERM', 'TMPDIR',
+        'XDG_CONFIG_HOME', 'XDG_DATA_HOME', 'XDG_CACHE_HOME',
+        'NODE_PATH', 'NODE_OPTIONS', 'NPM_CONFIG_PREFIX',
+        // Anthropic auth — required for Claude Code to reach the model.
+        'CLAUDE_CODE_OAUTH_TOKEN', 'ANTHROPIC_API_KEY',
+    ]) {
+        if (process.env[key])
+            agentEnv[key] = process.env[key];
+    }
+    deps.log({
+        level: 'info',
+        msg: `${config.logTag}: spawning ${sessionId}`,
+        data: { claudePath: deps.claudePath },
+    });
+    const spawnFn = deps._spawnFn ?? spawn;
+    return new Promise((resolve) => {
+        const child = spawnFn(deps.claudePath, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: agentEnv,
+        });
+        let stdout = '';
+        let aborted = false;
+        let terminatedEarly = false;
+        child.stdout?.on('data', (d) => {
+            const chunk = d.toString();
+            stdout += chunk;
+            appendFileSync(transcriptPath, chunk);
+        });
+        child.stderr?.on('data', (d) => {
+            appendFileSync(transcriptPath, `[stderr] ${d.toString()}`);
+        });
+        const sessionTimeout = setTimeout(() => {
+            if (!child.killed) {
+                deps.log({
+                    level: 'warn',
+                    msg: `${config.logTag}: ${sessionId} reached sessionMaxMs; killing`,
+                    data: { sessionMaxMs },
+                });
+                child.kill('SIGTERM');
+            }
+        }, sessionMaxMs);
+        // Poll for the submit tool: once the flag flips, give Claude a short grace
+        // window to receive the tool response + close the connection, then SIGTERM.
+        let graceTimer = null;
+        const pollTimer = setInterval(() => {
+            if (graceTimer || child.killed)
+                return;
+            if (deps.isSubmitted()) {
+                deps.log({
+                    level: 'info',
+                    msg: `${config.logTag}: ${sessionId} ${config.submissionToolName} invoked; scheduling graceful termination`,
+                });
+                terminatedEarly = true;
+                graceTimer = setTimeout(() => {
+                    if (!child.killed)
+                        child.kill('SIGTERM');
+                }, submissionGraceMs);
+            }
+        }, pollIntervalMs);
+        const onAbort = () => {
+            if (aborted)
+                return;
+            aborted = true;
+            deps.log({ level: 'info', msg: `${config.logTag}: ${sessionId} window abort; killing` });
+            child.kill('SIGTERM');
+        };
+        deps.abort.addEventListener('abort', onAbort);
+        const cleanup = () => {
+            clearTimeout(sessionTimeout);
+            if (graceTimer)
+                clearTimeout(graceTimer);
+            clearInterval(pollTimer);
+            deps.abort.removeEventListener('abort', onAbort);
+        };
+        child.on('exit', (code, signal) => {
+            cleanup();
+            const endedAt = Date.now();
+            const endNs = `${BigInt(endedAt) * 1000000n}`;
+            appendFileSync(transcriptPath, `\n\n=== Session ended at ${new Date(endedAt).toISOString()} (code=${code} signal=${signal} submitted=${deps.isSubmitted()} terminatedEarly=${terminatedEarly} aborted=${aborted}) ===\n`);
+            deps.log({
+                level: 'info',
+                msg: `${config.logTag}: ${sessionId} exited`,
+                data: { code, signal, durationMs: endedAt - startedAt, submitted: deps.isSubmitted(), aborted },
+            });
+            const exitCode = code ?? -1;
+            deps.trajectory?.addSpan({
+                name: `subprocess.${deps.claudePath}`,
+                kind: 'INTERNAL',
+                startTimeUnixNano: startNs,
+                endTimeUnixNano: endNs,
+                attributes: {
+                    'jinn.span.kind': 'jinn.state_transition',
+                    'jinn.state.from': 'PREPARED',
+                    'jinn.state.to': 'RAN_CLAUDE',
+                    'subprocess.cmd': deps.claudePath,
+                    'subprocess.args': args,
+                    'subprocess.exit_code': exitCode,
+                    'session.id': sessionId,
+                    'prediction.submitted': deps.isSubmitted(),
+                },
+                events: [],
+                status: exitCode === 0 || signal ? { code: 'OK' } : { code: 'ERROR', message: `exit ${exitCode}` },
+            });
+            resolve({
+                sessionId,
+                startedAt,
+                endedAt,
+                transcriptPath,
+                submitted: deps.isSubmitted(),
+                stdout,
+                aborted: aborted || deps.abort.aborted,
+            });
+        });
+        child.on('error', (err) => {
+            cleanup();
+            const endedAt = Date.now();
+            const endNs = `${BigInt(endedAt) * 1000000n}`;
+            appendFileSync(transcriptPath, `\n\n=== Session spawn error: ${err.message} ===\n`);
+            deps.log({
+                level: 'error',
+                msg: `${config.logTag}: ${sessionId} spawn error`,
+                data: { err: err.message },
+            });
+            deps.trajectory?.addSpan({
+                name: `subprocess.${deps.claudePath}`,
+                kind: 'INTERNAL',
+                startTimeUnixNano: startNs,
+                endTimeUnixNano: endNs,
+                attributes: {
+                    'jinn.span.kind': 'jinn.state_transition',
+                    'jinn.state.from': 'PREPARED',
+                    'jinn.state.to': 'RAN_CLAUDE',
+                    'subprocess.cmd': deps.claudePath,
+                    'subprocess.args': args,
+                    'subprocess.exit_code': -1,
+                    'session.id': sessionId,
+                    'prediction.submitted': deps.isSubmitted(),
+                },
+                events: [{ timeUnixNano: endNs, name: 'exception', attributes: { 'exception.message': err.message } }],
+                status: { code: 'ERROR', message: err.message },
+            });
+            resolve({
+                sessionId,
+                startedAt,
+                endedAt,
+                transcriptPath,
+                submitted: deps.isSubmitted(),
+                stdout,
+                aborted: deps.abort.aborted,
+            });
+        });
+    });
+}
+//# sourceMappingURL=single-session-orchestrator.js.map

package/dist/restorer/impls/claude-mcp-shared/single-session-orchestrator.js.map

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

package/dist/restorer/impls/evaluation-context.d.ts

@@ -1,12 +1,19 @@
-import type { DesiredState } from '../../types/desired-state.js';
-/** Eval `DesiredState.context` key for the restoration job’s intended-state IPFS CID (not the eval job’s). */
+import type { RestorationJob } from '../../types/desired-state.js';
+/** Eval `RestorationJob.context` key for the restoration job's intended-state IPFS CID (not the eval job's). */
 export declare const RESTORATION_INTENT_CID_CONTEXT_KEY: "restorationIntentCid";
+/**
+ * Eval `RestorationJob.context` key for the restoration envelope's IPFS CID.
+ * Set by the daemon when creating evaluation jobs so evaluators can populate the
+ * `restorationEnvelope.cid` back-reference in the verdict payload without a
+ * synchronous IPFS round-trip at verdict time.
+ */
+export declare const RESTORATION_ENVELOPE_CID_CONTEXT_KEY: "restorationEnvelopeCid";
 /**
  * Resolve the expected restoration intent CID for `integrity.intent_ref`.
  * Test-only overrides win; otherwise the value must be present in `context`.
- * There is no fallback to the evaluation job’s `intentCid` (wrong reference).
+ * There is no fallback to the evaluation job's `intentCid` (wrong reference).
  */
-export declare function resolveExpectedRestorationIntentCid(intent: DesiredState, testDeps?: {
+export declare function resolveExpectedRestorationIntentCid(intent: RestorationJob, testDeps?: {
     expectedIntentCid?: string;
 }): {
     kind: 'resolved';

package/dist/restorer/impls/evaluation-context.js

@@ -1,9 +1,16 @@
-/** Eval `DesiredState.context` key for the restoration job’s intended-state IPFS CID (not the eval job’s). */
+/** Eval `RestorationJob.context` key for the restoration job's intended-state IPFS CID (not the eval job's). */
 export const RESTORATION_INTENT_CID_CONTEXT_KEY = 'restorationIntentCid';
+/**
+ * Eval `RestorationJob.context` key for the restoration envelope's IPFS CID.
+ * Set by the daemon when creating evaluation jobs so evaluators can populate the
+ * `restorationEnvelope.cid` back-reference in the verdict payload without a
+ * synchronous IPFS round-trip at verdict time.
+ */
+export const RESTORATION_ENVELOPE_CID_CONTEXT_KEY = 'restorationEnvelopeCid';
 /**
  * Resolve the expected restoration intent CID for `integrity.intent_ref`.
  * Test-only overrides win; otherwise the value must be present in `context`.
- * There is no fallback to the evaluation job’s `intentCid` (wrong reference).
+ * There is no fallback to the evaluation job's `intentCid` (wrong reference).
  */
 export function resolveExpectedRestorationIntentCid(intent, testDeps) {
     if (testDeps?.expectedIntentCid) {

package/dist/restorer/impls/evaluation-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"evaluation-context.js","sourceRoot":"","sources":["../../../src/restorer/impls/evaluation-context.ts"],"names":[],"mappings":"AAEA,8GAA8G;AAC9G,MAAM,CAAC,MAAM,kCAAkC,GAAG,sBAA+B,CAAC;AAElF;;;;GAIG;AACH,MAAM,UAAU,mCAAmC,CACjD,MAAoB,EACpB,QAAyC;IAEzC,IAAI,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,kCAAkC,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"evaluation-context.js","sourceRoot":"","sources":["../../../src/restorer/impls/evaluation-context.ts"],"names":[],"mappings":"AAEA,gHAAgH;AAChH,MAAM,CAAC,MAAM,kCAAkC,GAAG,sBAA+B,CAAC;AAElF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,wBAAiC,CAAC;AAEtF;;;;GAIG;AACH,MAAM,UAAU,mCAAmC,CACjD,MAAsB,EACtB,QAAyC;IAEzC,IAAI,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,kCAAkC,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC"}

package/dist/restorer/impls/index.d.ts

@@ -2,7 +2,7 @@
  * Single construction site for all first-party {@link RestorerImpl} instances.
  * Used by the daemon entrypoint and `jinn intents` CLI (stub mode).
  */
-import type { Runner } from '../../runner/runner.js';
+import type { Runner, RunnerContext } from '../../runner/runner.js';
 import type { RestorerImpl } from '../types.js';
 /**
  * Environment passed to {@link buildRestorerImpls} — same shape for daemon
@@ -26,21 +26,66 @@ export interface RestorerEnv {
     runner?: Runner;
     /** e.g. `http://127.0.0.1:${apiPort}` for {@link LegacyClaudeImpl} */
     daemonApiUrl?: string;
+    /**
+     * Bearer token for daemon API cost-mutating routes (forwarded to the MCP
+     * subprocess via env). Mirrors `daemonApiUrl` exactly.
+     */
+    daemonApiToken?: string;
     /** SQLite store path for MCP artifact handoff in {@link LegacyClaudeImpl}. */
     storePath?: string;
     /**
      * Legacy-claude runner working directory (defaults to /tmp if unset).
      */
     legacyClaudeWorkingDirectory?: string;
+    /**
+     * Corpus env for {@link LegacyClaudeImpl} / MCP `jinn-client` tools
+     * (`search_artifacts`, `acquire_artifact`).
+     */
+    corpusEnv?: RunnerContext['corpusEnv'];
     /**
      * Root for impl-scoped state dirs (e.g. hyperliquid api-wallet). Defaults under
      * `~/.jinn-client/engine/impl-state` when unset — wired from `config.engine` in main.
      */
     implStateDirRoot?: string;
+    /**
+     * Pre-loaded external (operator-supplied) restorer impls — produced by
+     * `loadExternalImpl()` in `client/src/restorer/external-impls/`. Appended to
+     * the in-repo construction list before the claude-code-learner wrapper so
+     * the wrapper sees them as specialists. See plan
+     * `docs/superpowers/plans/2026-04-30-plug-in-surface-path-2-foundation.md`
+     * step 5.7.
+     */
+    externalImpls?: readonly RestorerImpl[];
+    /**
+     * Pre-built serialised slot registry for Path 1 plug-ins (the bundled
+     * claude-code-learner impl's plug-in surface). Built once in main.ts
+     * by calling `loadPlugIns` + `serialiseRegistry` against
+     * `config.learnerPlugIns[]`. Threaded into the learner shim so it can
+     * forward the registry into the harness via `JINN_SLOT_REGISTRY_JSON`.
+     *
+     * See spec/2026-04-30-plug-in-surface.md §4 and plan
+     * docs/superpowers/plans/2026-04-30-plug-in-surface-path-1-mechanism.md
+     * Tasks 4–5.
+     */
+    slotRegistryJson?: string;
+    /**
+     * Impl names to filter out of the returned list entirely (different from
+     * `RestorerImplRegistry.disabled`, which only suppresses dispatch). Useful
+     * when a fleet wants to construct without paying the cost of an in-repo
+     * impl that has external deps.
+     */
+    disabledNames?: readonly string[];
 }
 /**
  * Build the canonical ordered list of first-party restorer / evaluator impls.
  * Registration order is stable: it matches historical `main.ts` first-match
  * behavior for `RestorerImplRegistry`.
+ *
+ * The claude-code-learner wrapper is registered alongside specialists; it does
+ * NOT win first-match by registration order. Universal-wrap behaviour is now
+ * a registry policy (`RestorerDispatchConfig.wrapWith`) — see jinn-mono-0k2.
+ * Default operator config sets `wrapWith: 'claude-code-learner'` so the
+ * learning envelope wraps every restoration kind by default; operators flip
+ * the policy off to dispatch directly to specialists.
  */
 export declare function buildRestorerImpls(env: RestorerEnv): RestorerImpl[];

package/dist/restorer/impls/index.js

@@ -11,10 +11,19 @@ import { ClaudeMcpPredictionImpl } from './claude-mcp-prediction/index.js';
 import { PredictionApyV0BaselineImpl } from './prediction-apy-v0-baseline/index.js';
 import { ClaudeMcpPredictionApyImpl } from './claude-mcp-prediction-apy/index.js';
 import { PredictionApyV0Evaluator } from './prediction-apy-v0-evaluator/index.js';
+import { ClaudeCodeLearnerImpl, ClaudeCodeLearnerWrapper, } from './claude-code-learner/index.js';
+import { ClaudeCodeHarnessAdapter } from './claude-code-learner/index.js';
 /**
  * Build the canonical ordered list of first-party restorer / evaluator impls.
  * Registration order is stable: it matches historical `main.ts` first-match
  * behavior for `RestorerImplRegistry`.
+ *
+ * The claude-code-learner wrapper is registered alongside specialists; it does
+ * NOT win first-match by registration order. Universal-wrap behaviour is now
+ * a registry policy (`RestorerDispatchConfig.wrapWith`) — see jinn-mono-0k2.
+ * Default operator config sets `wrapWith: 'claude-code-learner'` so the
+ * learning envelope wraps every restoration kind by default; operators flip
+ * the policy off to dispatch directly to specialists.
  */
 export function buildRestorerImpls(env) {
     const isStub = Boolean(env.stub);
@@ -32,6 +41,8 @@ export function buildRestorerImpls(env) {
             timeoutMs: 300_000,
             storePath: env.storePath,
             daemonApiUrl: env.daemonApiUrl,
+            daemonApiToken: env.daemonApiToken,
+            corpusEnv: env.corpusEnv,
             stub: isStub,
         }));
     }
@@ -83,6 +94,33 @@ export function buildRestorerImpls(env) {
             rpcUrl: env.rpcUrl,
             archiveRpcUrl: env.archiveRpcUrl,
         }));
+    // Operator-supplied external impls are appended *before* the learner
+    // wrapper so the wrapper sees them as specialists too.
+    if (env.externalImpls && env.externalImpls.length > 0) {
+        out.push(...env.externalImpls);
+    }
+    // Build the claude-code-learner wrapper LAST (so it sees all other impls
+    // as its specialists pool). It is registered alongside specialists, NOT
+    // prepended — universal-wrap is now a registry policy
+    // (RestorerDispatchConfig.wrapWith) rather than an ordering trick. See
+    // jinn-mono-0k2.
+    const learnerAdapter = new ClaudeCodeHarnessAdapter({
+        claudePath: env.claudePath,
+        claudeModel: env.claudeModel,
+    });
+    const learnerShim = new ClaudeCodeLearnerImpl({
+        adapter: learnerAdapter,
+        slotRegistryJson: env.slotRegistryJson,
+    });
+    const learnerWrapper = new ClaudeCodeLearnerWrapper({
+        shim: learnerShim,
+        specialists: [...out], // snapshot of specialists; wrapper does not delegate to itself
+    });
+    out.push(learnerWrapper);
+    if (env.disabledNames && env.disabledNames.length > 0) {
+        const disabled = new Set(env.disabledNames);
+        return out.filter((impl) => !disabled.has(impl.name));
+    }
     return out;
 }
 //# sourceMappingURL=index.js.map

package/dist/restorer/impls/index.js.map

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

package/dist/restorer/impls/legacy-claude/index.d.ts

@@ -8,7 +8,7 @@
  * The engine calls findFor({ kind: '' }) for legacy intents because
  * PersistedIntent.specKind is null → coerced to '' in runImpl().
  */
-import { type Runner } from '../../../runner/runner.js';
+import { type Runner, type RunnerContext } from '../../../runner/runner.js';
 import type { RestorerImpl, RestorationContext, RestorationOutput, ReadyStatus, EnableResult, IntentEnableMetadata } from '../../types.js';
 export interface LegacyClaudeConfig {
     runner: Runner;
@@ -20,6 +20,18 @@ export interface LegacyClaudeConfig {
     storePath?: string;
     /** Daemon API URL for MCP server */
     daemonApiUrl?: string;
+    /**
+     * Bearer token for daemon API cost-mutating routes. Forwarded to the MCP
+     * subprocess via `DAEMON_API_TOKEN` env var.
+     */
+    daemonApiToken?: string;
+    /**
+     * Corpus credentials forwarded to {@link RunnerContext.corpusEnv} so the MCP
+     * subprocess `search_artifacts` tool can hit the keyless subgraph + IPFS
+     * gateway. The agent EOA private key never crosses into the subprocess —
+     * `acquire_artifact` proxies through `daemonApiUrl` (with `daemonApiToken`).
+     */
+    corpusEnv?: RunnerContext['corpusEnv'];
     /**
      * When true (e.g. synthetic registry), `isReady` reports the daemon is required.
      * Production daemon should omit.

package/dist/restorer/impls/legacy-claude/index.js

@@ -51,6 +51,8 @@ export class LegacyClaudeImpl {
             timeoutMs: this.config.timeoutMs ?? 300_000,
             storePath: this.config.storePath,
             daemonApiUrl: this.config.daemonApiUrl,
+            daemonApiToken: this.config.daemonApiToken,
+            corpusEnv: this.config.corpusEnv,
         };
         let result;
         try {

package/dist/restorer/impls/legacy-claude/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/restorer/impls/legacy-claude/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/restorer/impls/legacy-claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,OAAO,EAAE,8BAA8B,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAiChD,iFAAiF;AAEjF,MAAM,OAAO,gBAAgB;IAIE;IAHpB,IAAI,GAAG,eAAe,CAAC;IACvB,OAAO,GAAG,OAAO,CAAC;IAE3B,YAA6B,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;IAAG,CAAC;IAE3D;;;;OAIG;IACH,QAAQ,CAAC,GAA0D;QACjE,OAAO,GAAG,CAAC,IAAI,KAAK,EAAE,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,OAAO,EAAE,GAAG,8BAA8B,EAAE,CAAC;QACnE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,cAAc;QACZ,OAAO;YACL,WAAW,EACT,8EAA8E;SACjF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAyC;QACtD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAuB;QAC/B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;QAExC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,yBAAyB,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAEvF,MAAM,SAAS,GAAkB;YAC/B,SAAS,EAAE,MAAM,CAAC,EAAE;YACpB,gBAAgB,EAAE,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,MAAM;YACtE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO;YAC3C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;YACtC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC1C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;SACjC,CAAC;QAEF,IAAI,MAAyB,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,wBAAwB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,MAAM,IAAI,cAAc,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;YACzD,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAAC;QAC7F,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC/F,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1E,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,iCAAiC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAEnG,MAAM,MAAM,GAAsB;YAChC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,MAAM,EAAE;gBACN,MAAM,EAAE,aAAa;aACtB;YACD,aAAa,EAAE;gBACb,YAAY,EAAE,aAAa;gBAC3B,aAAa;aACd;YACD,SAAS,EAAE,EAAE;SACd,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,wBAAwB,CACpC,cAAsB,EACtB,GAAgD;QAEhD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAEtC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;oBACvC,cAAc;oBACd,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,KAAK,EAAE,CAAC;iBACT,CAAC,CAAC;gBACH,IAAI,QAAQ,EAAE,OAAO;oBAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;YACjD,CAAC;oBAAS,CAAC;gBACT,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,eAAe,gBAAgB,CAAC;AAEhC;;;;GAIG;AACH,SAAS,wBAAwB,CAAC,GAAY;IAC5C,MAAM,GAAG,GAAG,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7E,MAAM,qBAAqB,GAAG;QAC5B,aAAa;QACb,0BAA0B;QAC1B,sBAAsB;QACtB,2BAA2B;QAC3B,cAAc;QACd,mBAAmB;QACnB,eAAe;QACf,mBAAmB;KACpB,CAAC;IACF,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,MAAM,mBAAmB,GAAG;YAC1B,eAAe;YACf,cAAc;YACd,eAAe;YACf,iBAAiB;YACjB,gBAAgB;YAChB,cAAc;YACd,iBAAiB;YACjB,mBAAmB;SACpB,CAAC;QACF,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/restorer/impls/portfolio-v0-evaluator/index.d.ts

@@ -5,8 +5,8 @@
  * No LLM. Pure deterministic verification per spec §7.
  *
  * Architecture decision (T7):
- *   The engine (locked) builds portfolio.v0.manifest.v1. The verdict manifest
- *   shape is portfolio.v0.eval.manifest.v1 (§5.2). Since the engine cannot be
+ *   The engine (locked) builds the restoration envelope. The eval impl assembles
+ *   and signs the verdict manifest itself (§5.2). Since the engine cannot be
  *   modified, the eval impl assembles and signs the verdict manifest itself,
  *   writes it as verdict.json in workingDir, and declares it as an artifact
  *   with role "evaluation_verdict". The engine's outer manifest becomes the
@@ -20,7 +20,7 @@
  *   - intent.restorationRequestId carries the on-chain request ID
  */
 import type { RestorerImpl, RestorationContext, RestorationOutput, ReadyStatus } from '../../types.js';
-import type { DesiredState } from '../../../types/desired-state.js';
+import type { RestorationJob } from '../../../types/desired-state.js';
 import type { PortfolioV0EvaluatorConfig } from './types.js';
 export declare class PortfolioV0Evaluator implements RestorerImpl {
     readonly name = "portfolio-v0-evaluator";
@@ -32,7 +32,7 @@ export declare class PortfolioV0Evaluator implements RestorerImpl {
         type?: 'restoration' | 'evaluation';
     }): boolean;
     isReady(): Promise<ReadyStatus>;
-    canAttempt(intent: DesiredState): Promise<{
+    canAttempt(intent: RestorationJob): Promise<{
         ok: true;
     } | {
         ok: false;