@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

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

@@ -0,0 +1,50 @@
+export declare function fakeOrientSummary(workingDir: string, taskId: string, solverType: 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 fakePredictionCorpusRetrieval(workingDir: string, opts?: {
+    retrievalUsed?: boolean;
+    recordsConsidered?: string[];
+    recordsCited?: string[];
+    recordsUsed?: string[];
+    inspectedRefs?: string[];
+    acquiredArtifacts?: Array<Record<string, unknown>>;
+    affectedForecast?: boolean;
+    probabilityYes?: string;
+    consensusSnapshotRef?: string;
+}): void;
+export declare function fakePredictionV1Solution(workingDir: string, opts?: {
+    probabilityYes?: string;
+    submittedAt?: string;
+    modelId?: string;
+    confidence?: string;
+    methodology?: string;
+    sourceRefs?: Array<{
+        title: string;
+        url: string;
+    }>;
+}): void;
+export declare function fakeDebriefAnalysis(workingDir: string, verdict: 'yes' | 'no' | 'partial'): void;
+export declare function fakeLearnerFeedback(workingDir: string, opts?: {
+    recordsConsidered?: string[];
+    recordsCited?: string[];
+    recordsUsed?: string[];
+    acquiredArtifacts?: Array<Record<string, unknown>>;
+    solverBrier?: string;
+    consensusBrier?: string;
+    brierSpread?: string;
+}): 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?: {
+    taskId?: string;
+    solverType?: string;
+    posture?: 'early-return' | 'hold-and-revise' | 'continuous-observation';
+    verdict?: 'yes' | 'no' | 'partial';
+}): void;

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

@@ -0,0 +1,192 @@
+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, taskId, solverType) {
+    writeJson(join(workingDir, '.orient', 'summary.json'), {
+        task: { id: taskId, solverType, window: { startTs: 0, endTs: 0 } },
+        topics: [
+            { topic: 'task-parse', artifact: 'workingDir/.orient/task-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 fakePredictionCorpusRetrieval(workingDir, opts = {}) {
+    const recordsConsidered = opts.recordsConsidered ?? [];
+    const recordsCited = opts.recordsCited ?? [];
+    const recordsUsed = opts.recordsUsed ?? recordsCited;
+    const inspectedRefs = opts.inspectedRefs ?? recordsConsidered.slice(0, 1);
+    writeJson(join(workingDir, '.execute', 'prediction-corpus-retrieval.json'), {
+        schemaVersion: 'jinn.prediction_corpus_retrieval.v1',
+        retrievalUsed: opts.retrievalUsed ?? recordsUsed.length > 0,
+        queries: [
+            {
+                tool: 'search_records',
+                intent: 'exact-condition',
+                query: 'solverType:prediction.v1 conditionId:0xabc venue:polymarket',
+            },
+        ],
+        records: {
+            considered: recordsConsidered,
+            inspected: inspectedRefs,
+            cited: recordsCited,
+            used: recordsUsed,
+        },
+        acquiredArtifacts: opts.acquiredArtifacts ?? [],
+        forecast: {
+            probabilityYes: opts.probabilityYes ?? '0.62',
+            consensusSnapshotRef: opts.consensusSnapshotRef ?? 'task.spec.consensusSnapshot',
+        },
+        selfAssessment: {
+            affectedForecast: opts.affectedForecast ?? recordsUsed.length > 0,
+            summary: recordsUsed.length > 0
+                ? 'Prior scored records affected calibration.'
+                : 'Retrieval was attempted but no useful records were found.',
+        },
+    });
+}
+export function fakePredictionV1Solution(workingDir, opts = {}) {
+    writeJson(join(workingDir, '.execute', 'prediction-v1-solution.json'), {
+        schemaVersion: 'jinn.prediction_v1_restoration_payload.v1',
+        probabilityYes: opts.probabilityYes ?? '0.62',
+        submittedAt: opts.submittedAt ?? '2026-05-02T01:00:00.000Z',
+        modelId: opts.modelId ?? 'claude-code-learner/prediction-v1-test',
+        confidence: opts.confidence ?? 'medium',
+        methodology: opts.methodology ?? 'Test fixture for the learner-authored prediction.v1 Execute output.',
+        sourceRefs: opts.sourceRefs ?? [
+            {
+                title: 'Polymarket market',
+                url: 'https://polymarket.com/event/test-market',
+            },
+        ],
+    });
+}
+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 fakeLearnerFeedback(workingDir, opts = {}) {
+    writeJson(join(workingDir, '.debrief', 'learner-feedback.json'), {
+        schemaVersion: 'jinn.learner_feedback.v1',
+        task: { solverType: 'prediction.v1' },
+        skillsUsed: ['prediction-corpus-retrieval'],
+        toolsUsed: ['get_task', 'search_records', 'inspect_record'],
+        retrieval: {
+            queries: [
+                { tool: 'search_records', intent: 'similar-scored-verdicts', query: 'prediction.v1 scored verdict' },
+            ],
+            recordsConsidered: opts.recordsConsidered ?? [],
+            recordsCited: opts.recordsCited ?? [],
+            recordsUsed: opts.recordsUsed ?? opts.recordsCited ?? [],
+            acquiredArtifacts: opts.acquiredArtifacts ?? [],
+        },
+        forecast: {
+            probabilityYes: '0.62',
+            consensusSnapshotRef: 'task.spec.consensusSnapshot',
+        },
+        selfAssessment: {
+            affectedForecast: (opts.recordsUsed ?? opts.recordsCited ?? []).length > 0,
+            summary: 'Captured learner-facing evidence for future strategy analysis.',
+        },
+        verdictFeedback: {
+            verdictRef: 'verdict:prediction-v1:example',
+            solverBrier: opts.solverBrier ?? '0.144400',
+            consensusBrier: opts.consensusBrier ?? '0.184900',
+            brierSpread: opts.brierSpread ?? '-0.040500',
+        },
+    });
+}
+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 taskId = opts.taskId ?? 'fake-task';
+    const solverType = opts.solverType ?? 'fake.solver';
+    const posture = opts.posture ?? 'early-return';
+    const verdict = opts.verdict ?? 'yes';
+    fakeOrientSummary(workingDir, taskId, solverType);
+    fakeStrategy(workingDir, posture);
+    fakePlan(workingDir, 1);
+    fakeExecuteSummary(workingDir);
+    fakeDebriefAnalysis(workingDir, verdict);
+    fakeImproveSummary(workingDir);
+    fakeMemoryConsolidationRecord(workingDir);
+}
+//# sourceMappingURL=fake-plugin-outputs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fake-plugin-outputs.js","sourceRoot":"","sources":["../../../../../src/harnesses/impls/claude-code-learner/test-utils/fake-plugin-outputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;GAOG;AAEH,SAAS,SAAS,CAAC,IAAY,EAAE,OAAgB;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,MAAc,EAAE,UAAkB;IACtF,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE;QACrD,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAClE,MAAM,EAAE;YACN,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,oCAAoC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;SACtG;QACD,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,OAAsE;IACrH,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,eAAe,CAAC,EAAE;QAC1D,QAAQ,EAAE,eAAe;QACzB,SAAS,EAAE,MAAM;QACjB,eAAe,EAAE,4BAA4B;QAC7C,aAAa,EAAE,OAAO;QACtB,WAAW,EAAE,EAAE;QACf,oBAAoB,EAAE,EAAE;KACzB,CAAC,CAAC;IACH,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,mBAAmB,CAAC,EAAE;QAC9D,kBAAkB,EAAE,aAAa;QACjC,aAAa,EAAE,OAAO;QACtB,cAAc,EAAE,aAAa;QAC7B,eAAe,EAAE,SAAS;QAC1B,aAAa,EAAE,CAAC,GAAG,UAAU,KAAK,CAAC;KACpC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,UAAkB,EAAE,SAAiB;IAC5D,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE;QAChD,eAAe,EAAE,4BAA4B;QAC7C,aAAa,EAAE,cAAc;QAC7B,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAClD,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE;YACnB,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,YAAY;YACzB,WAAW,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE;YACjC,MAAM,EAAE,EAAE;YACV,WAAW,EAAE,EAAE;YACf,eAAe,EAAE,EAAE;YACnB,aAAa,EAAE,QAAQ;YACvB,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,OAKI,EAAE;IAEN,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE;QACtD,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,CAAC;QACjD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QACnC,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;QAC9B,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,qBAAqB;KACzD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,UAAkB,EAClB,OAUI,EAAE;IAEN,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC;IACvD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,YAAY,CAAC;IACrD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1E,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,kCAAkC,CAAC,EAAE;QAC1E,aAAa,EAAE,qCAAqC;QACpD,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAC3D,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE,iBAAiB;gBACzB,KAAK,EAAE,6DAA6D;aACrE;SACF;QACD,OAAO,EAAE;YACP,UAAU,EAAE,iBAAiB;YAC7B,SAAS,EAAE,aAAa;YACxB,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,WAAW;SAClB;QACD,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,EAAE;QAC/C,QAAQ,EAAE;YACR,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,MAAM;YAC7C,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,6BAA6B;SACjF;QACD,cAAc,EAAE;YACd,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YACjE,OAAO,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC;gBAC7B,CAAC,CAAC,4CAA4C;gBAC9C,CAAC,CAAC,2DAA2D;SAChE;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,UAAkB,EAClB,OAOI,EAAE;IAEN,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,6BAA6B,CAAC,EAAE;QACrE,aAAa,EAAE,2CAA2C;QAC1D,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,MAAM;QAC7C,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,0BAA0B;QAC3D,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,wCAAwC;QACjE,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,QAAQ;QACvC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,qEAAqE;QACtG,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI;YAC7B;gBACE,KAAK,EAAE,mBAAmB;gBAC1B,GAAG,EAAE,0CAA0C;aAChD;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,OAAiC;IAEjC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE;QACvD,kBAAkB,EAAE,OAAO;QAC3B,wBAAwB,EAAE,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB;QACrE,mBAAmB,EAAE,EAAE;QACvB,oBAAoB,EAAE,EAAE;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,EAAE;QAC/F,yBAAyB,EAAE,EAAE;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,OAQI,EAAE;IAEN,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,uBAAuB,CAAC,EAAE;QAC/D,aAAa,EAAE,0BAA0B;QACzC,IAAI,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE;QACrC,UAAU,EAAE,CAAC,6BAA6B,CAAC;QAC3C,SAAS,EAAE,CAAC,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;QAC3D,SAAS,EAAE;YACT,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,yBAAyB,EAAE,KAAK,EAAE,8BAA8B,EAAE;aACrG;YACD,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,EAAE;YAC/C,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE;YACrC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE;YACxD,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,EAAE;SAChD;QACD,QAAQ,EAAE;YACR,cAAc,EAAE,MAAM;YACtB,oBAAoB,EAAE,6BAA6B;SACpD;QACD,cAAc,EAAE;YACd,gBAAgB,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC;YAC1E,OAAO,EAAE,gEAAgE;SAC1E;QACD,eAAe,EAAE;YACf,UAAU,EAAE,+BAA+B;YAC3C,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,UAAU;YAC3C,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,UAAU;YACjD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,WAAW;SAC7C;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE;QACtD,qBAAqB,EAAE,eAAe;QACtC,oBAAoB,EAAE,eAAe;QACrC,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,gBAAgB,EAAE,CAAC;QACnB,mBAAmB,EAAE,EAAE;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,UAAkB;IAC9D,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,EAAE,2BAA2B,CAAC,EAAE;QAChF,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,qBAAqB,EAAE,eAAe;QACtC,oBAAoB,EAAE,eAAe;QACrC,OAAO,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE;QACjG,SAAS,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE;KAC3D,CAAC,CAAC;AACL,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,OAA8J,EAAE;IAEhK,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,aAAa,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;IACtC,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAClD,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACxB,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC/B,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACzC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC/B,6BAA6B,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { HarnessAdapter, TaskSessionInputs } from '../types.js';
+export type NoOpRunHandler = (inputs: TaskSessionInputs, pluginRoot: string) => void | Promise<void>;
+/**
+ * Test-only HarnessAdapter. By default, a runTask 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 runTask was called with — useful for assertions. */
+    getInvocations(): ReadonlyArray<{
+        inputs: TaskSessionInputs;
+        pluginRoot: string;
+    }>;
+    runTask(inputs: TaskSessionInputs, pluginRoot: string): Promise<void>;
+}

package/dist/harnesses/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 runTask 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 runTask was called with — useful for assertions. */
+    getInvocations() {
+        return this.invocations;
+    }
+    async runTask(inputs, pluginRoot) {
+        this.invocations.push({ inputs, pluginRoot });
+        if (this.handler) {
+            await this.handler(inputs, pluginRoot);
+        }
+        else {
+            fakeFullPipelineRun(inputs.workingDir, {
+                taskId: inputs.taskId,
+                solverType: inputs.solverType ?? 'unknown',
+            });
+        }
+    }
+}
+//# sourceMappingURL=noop-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"noop-adapter.js","sourceRoot":"","sources":["../../../../../src/harnesses/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,GAA6D,EAAE,CAAC;IAEnF,kDAAkD;IAClD,EAAE,CAAC,OAAuB;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAyB,EAAE,UAAkB;QACzD,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,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;aAC3C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,114 @@
+/**
+ * Typed allowlist of env keys the learner may inject into the harness child
+ * process. Adding a new key requires an explicit update here.
+ */
+export type KnownAdapterEnvKey = 'LEARNER_PHASE_RANGE';
+/**
+ * Inputs the shim derives from HarnessContext and hands to the
+ * harness adapter. The adapter then constructs a session prompt + env
+ * for the underlying CLI / runtime.
+ */
+export interface TaskSessionInputs {
+    /** Task id from ctx.task.id */
+    taskId: string;
+    /** On-chain / persisted request id for this run; may differ from taskId. */
+    requestId?: string;
+    /** IPFS CID of the full Task payload (if known) for provenance */
+    taskCid?: string;
+    /** SolverType (e.g. 'portfolio.v0', 'prediction.v1') */
+    solverType?: string;
+    /** Optional per-SolverNet model override. */
+    model?: string;
+    /** Optional per-SolverNet Claude model override. Deprecated; use model. */
+    claudeModel?: string;
+    /** Operator-private impl-state directory; passed to the plugin via env IMPL_STATE_DIR */
+    implStateDir: string;
+    /** Ephemeral workingDir for this attempt */
+    workingDir: string;
+    /** Additional SolverPlugin package roots to pass through host plugin loading. */
+    pluginRoots?: string[];
+    /** Window timestamps (ms since epoch) */
+    windowStartTs: number;
+    windowEndTs: number;
+    /** Remaining ms in the window at adapter-invocation time */
+    msUntilEndTs: number;
+    /** Aborted when window.endTs fires */
+    abort: AbortSignal;
+    /**
+     * Full Task body from ctx.task. Passed verbatim into the initial prompt
+     * so the learn skill does not need to read workingDir/task.json.
+     * Includes description, solverType, spec, role, eligibility, and window.
+     */
+    taskBody?: {
+        id?: string;
+        description?: string;
+        solverType?: string;
+        spec?: Record<string, unknown>;
+        role?: string;
+        restorationRequestId?: string;
+        eligibility?: Record<string, unknown>;
+        window?: {
+            startTs: number;
+            endTs: number;
+        };
+        [key: string]: unknown;
+    };
+    /**
+     * Optional env vars the adapter should propagate to the harness child
+     * process IN ADDITION to its own ENV_ALLOWLIST. Used to thread
+     * phase-range hints (e.g. LEARNER_PHASE_RANGE) to
+     * the learn skill running inside the spawned harness.
+     *
+     * Restricted to the {@link KnownAdapterEnvKey} allowlist. Pass-through only;
+     * adapters must not silently drop these.
+     */
+    adapterEnv?: Partial<Record<KnownAdapterEnvKey, string>>;
+    /**
+     * Harness execution mode forwarded from HarnessContext. The orchestrator
+     * skill gates Improve and Memory phase invocations on mode === 'train'.
+     */
+    mode: 'train' | 'frozen';
+}
+/**
+ * Adapter contract: launch the underlying agent harness with the
+ * claude-code-learner plugin loaded and the task context set up. Block
+ * until the harness exits cleanly or the abort signal fires.
+ *
+ * The adapter does NOT harvest outputs — that's the shim's job afterwards.
+ */
+export interface HarnessAdapter {
+    /** Adapter name for logs / spans (e.g. 'claude-code', 'noop'). */
+    readonly name: string;
+    /**
+     * Whether this adapter permits the plugin's Improve phase to patch
+     * harness install code (e.g. Pi.dev). Always false for closed harnesses.
+     */
+    readonly allowsHarnessSelfModification: boolean;
+    /**
+     * Run one claude-code-learner session. The adapter is responsible for:
+     * - Loading the plugin into the harness's skill/plugin directory (or
+     *   pointing the harness at it via flags).
+     * - Setting IMPL_STATE_DIR in the harness's env so the session-start
+     *   hook fires.
+     * - Constructing the initial prompt that invokes the `learn` skill
+     *   with the task + paths.
+     * - Blocking until the harness session exits or `inputs.abort` fires.
+     */
+    runTask(inputs: TaskSessionInputs, pluginRoot: string): Promise<void>;
+}
+/** Shim construction config. */
+export interface ClaudeCodeLearnerConfig {
+    /** Harness adapter (NoOp for tests; Claude Code adapter for production). */
+    adapter: HarnessAdapter;
+    /** Optional override for the impl name (defaults to 'claude-code-learner'). */
+    name?: string;
+    /** Semver string for envelope provenance (defaults to '0.1.0-shim'). */
+    version?: string;
+    /**
+     * Optional override for plugin root resolution. When unset, resolved from
+     * the impl directory via `plugin-path.ts`. Tests may override.
+     */
+    pluginRoot?: string;
+    /** SolverPlugin roots loaded by the daemon. */
+    solverPluginRoots?: string[];
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-code-learner/types.ts"],"names":[],"mappings":""}

package/dist/harnesses/impls/claude-mcp-hyperliquid/api-wallet.d.ts

@@ -0,0 +1,64 @@
+/**
+ * API wallet management for claude-mcp-hyperliquid — §8.1.
+ *
+ * Architecture decision (v0):
+ *   Option (b): fresh keypair generated on first use, persisted in implStateDir.
+ *   This provides blast-radius isolation — a compromised API wallet does not
+ *   expose other keys held by the operator.
+ *
+ * HL "approve agent" flow (v0 operator prerequisite):
+ *   The approve-agent authorization (linking the API wallet to the master account)
+ *   is an OPERATOR PREREQUISITE for v0. The operator must manually approve the API
+ *   wallet via the Hyperliquid UI (Settings → API Wallets → Add) or via the HL
+ *   L2 action `approveAgent` BEFORE the impl can place trades.
+ *
+ *   Steps:
+ *     1. Run any `jinn` command or let the daemon boot once — the API wallet
+ *        keypair is generated and persisted to <implStateDir>/api-wallet.json.
+ *     2. Run `jinn portfolio api-wallet` (or inspect the file) to get the address.
+ *     3. Approve that address as an API wallet on your HL master account.
+ *     4. Set `approved: true` in <implStateDir>/api-wallet.json  OR  call
+ *        `markApiWalletApproved(implStateDir)` from the CLI.
+ *
+ *   This impl checks `state.approved` in `canAttempt()` and returns an
+ *   informative error including the wallet address if not approved.
+ *
+ *   Programmatic approval is a §8.5 future item.
+ *
+ * State file: <implStateDir>/api-wallet.json  (mode 0o600)
+ */
+export interface ApiWalletState {
+    /** 0x-prefixed hex private key */
+    privateKey: string;
+    /** Derived Ethereum address */
+    address: string;
+    /** Whether the operator has approved this wallet as an HL agent */
+    approved: boolean;
+    /** Epoch ms when the wallet was created */
+    createdAt: number;
+    /** Epoch ms when approved flag was last set */
+    approvedAt?: number;
+    /**
+     * The HL master that approved this agent, captured during the operator's
+     * approve-agent setup. When present, the impl cross-checks this against
+     * the task's `spec.account.masterAddress` on every run — if they
+     * disagree, it aborts with `E_MASTER_MISMATCH` rather than silently
+     * routing trades to the wrong master.
+     */
+    masterAddress?: string;
+}
+export declare function walletStatePath(implStateDir: string): string;
+export declare function loadApiWalletState(implStateDir: string): ApiWalletState | null;
+export declare function saveApiWalletState(implStateDir: string, state: ApiWalletState): void;
+/**
+ * Ensure an API wallet exists in implStateDir. Creates one if absent.
+ * Returns the current state (approved or not).
+ *
+ * Synchronous — safe to call at impl startup.
+ */
+export declare function provisionApiWallet(implStateDir: string): ApiWalletState;
+/**
+ * Mark the API wallet as approved by the operator.
+ * Call this after the operator completes the HL approve-agent flow.
+ */
+export declare function markApiWalletApproved(implStateDir: string): ApiWalletState;

package/dist/harnesses/impls/claude-mcp-hyperliquid/api-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-wallet.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-mcp-hyperliquid/api-wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAyBpD,kFAAkF;AAElF,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,OAAO,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;AAC/C,CAAC;AAED,kFAAkF;AAElF,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,MAAM,IAAI,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,YAAoB,EAAE,KAAqB;IAC5E,MAAM,IAAI,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IAC3C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,kFAAkF;AAElF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,uCAAuC;IACvC,MAAM,eAAe,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,KAAK,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAmB,CAAC;IAE3E,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEhD,MAAM,KAAK,GAAmB;QAC5B,UAAU;QACV,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,kBAAkB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,OAAO,GAAmB;QAC9B,GAAG,QAAQ;QACX,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;KACvB,CAAC;IAEF,kBAAkB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/harnesses/impls/claude-mcp-hyperliquid/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * claude-mcp-hyperliquid — Reference Harness for portfolio.v0 — §8.
+ *
+ * Spawns Claude Code session(s) with HL-specific MCP tools (§8.2).
+ * Safety rails enforced at the tool boundary (§8.3).
+ * Sequential session cadence per §8.4.
+ * API wallet managed in implStateDir (§8.1).
+ *
+ * OPERATOR PREREQUISITE (v0):
+ *   Before this impl can place trades, the operator must:
+ *   1. Let the daemon boot once (or call canAttempt()) to generate the API wallet.
+ *   2. Approve the generated API wallet address on their HL master account
+ *      (Settings → API Wallets → Add in the HL UI).
+ *   3. Set approved:true in <implStateDir>/api-wallet.json
+ *
+ *   The impl will surface the wallet address and instructions in canAttempt()
+ *   if the wallet is not yet approved.
+ *
+ *   Programmatic approval is a §8.5 future item.
+ */
+import type { Harness, HarnessContext, Solution, ReadyStatus, EnableResult, HarnessEnableMetadata } from '../../types.js';
+import type { Task } from '../../../types/task.js';
+import { HyperliquidClient } from '../../../venues/hyperliquid/client.js';
+import type { SafetyConfig } from './safety-rails.js';
+export interface ClaudeMcpHyperliquidConfig {
+    claudePath?: string;
+    claudeModel?: string;
+    /** Per-task safety override (from task context) */
+    safetyConfig?: Partial<SafetyConfig>;
+    /** Cadence between sessions in ms. Default: 30 min */
+    cadenceMs?: number;
+    /** Max session wall time in ms. Default: 8 min */
+    sessionMaxMs?: number;
+    /**
+     * Impl state directory — used by `isReady` and `onEnable` to locate
+     * the api-wallet file outside of a running task context. Defaults under
+     * `~/.jinn-client/engine/impl-state/claude-mcp-hyperliquid` (see `config.engine`).
+     */
+    implStateDir?: string;
+    /** Injected deps for testing */
+    _testDeps?: TestDeps;
+    /** CLI `jinn solver-nets` registry without a live fleet */
+    stub?: boolean;
+}
+export interface TestDeps {
+    /** Mock runner — called instead of spawning Claude */
+    runSession?: (sessionId: string, prompt: string) => Promise<{
+        stdout: string;
+    }>;
+    hlClient?: HyperliquidClient;
+}
+export declare class ClaudeMcpHyperliquidImpl implements Harness {
+    readonly name = "claude-mcp-hyperliquid";
+    readonly version = "1.0.0";
+    private config;
+    constructor(config?: ClaudeMcpHyperliquidConfig);
+    supports(ctx: {
+        solverType: string;
+        role?: 'restoration' | 'evaluation';
+    }): boolean;
+    canAttempt(task: Task): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    /** Resolve the impl state directory used by enable / readiness flows. */
+    private resolveImplStateDir;
+    /** Exposed for tests and operator diagnostics; same as internal resolve path. */
+    resolvedImplStateDir(): string;
+    isReady(): Promise<ReadyStatus>;
+    enableMetadata(): HarnessEnableMetadata;
+    onEnable(ctx: {
+        args: Record<string, string | undefined>;
+    }): Promise<EnableResult>;
+    onDisable(): Promise<void>;
+    run(ctx: HarnessContext): Promise<Solution>;
+}
+interface HlServerConfig {
+    hlBaseUrl: string;
+    apiWalletPrivateKey: string;
+    apiWalletAddress: string;
+    masterAddress: string;
+    safetyConfig?: Partial<SafetyConfig>;
+}
+/**
+ * Write a thin ESM wrapper script to disk that delegates to the compiled
+ * startMcpServer() from this package. This is spawned as a subprocess by
+ * Claude's --mcp-config.
+ *
+ * Security: the config (including apiWalletPrivateKey) is written to a
+ * SEPARATE file (hl-server-config.json) with mode 0o600. The script body
+ * receives only the config file path via process.argv[2] — no private key
+ * or secret data appears in the script source.
+ *
+ * The import path is resolved at write-time from __dirname (this module's
+ * location) so it always points to the compiled mcp-tools.js alongside this
+ * file. The daemon MUST run from a compiled build (dist/) — `yarn build`
+ * produces `dist/harnesses/impls/claude-mcp-hyperliquid/mcp-tools.js`, which
+ * this wrapper imports by absolute path from plain Node. Running from tsx
+ * against src/ would leave mcp-tools.js non-existent and cause Claude to
+ * silently spawn with no HL tools loaded — hence the explicit existence
+ * check and `E_DAEMON_MUST_RUN_FROM_DIST` error below.
+ */
+export declare function _writeHlMcpServerScript(outPath: string, hlConfig: HlServerConfig): void;
+export default ClaudeMcpHyperliquidImpl;