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

package/dist/cli/commands/create.js

@@ -0,0 +1,226 @@
+/**
+ * `jinn create harness <pkgName>` — scaffolds a working external
+ * Harness package on disk. After
+ *   cd <pkgName> && yarn install && yarn test
+ * the package's tests pass against a synthetic HarnessContext.
+ *
+ * Spec: `spec/2026-05-01-harness-pack-architecture.md`.
+ */
+import { parseArgs } from 'node:util';
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { COMMON_FLAGS } from '../command.js';
+/**
+ * Resolve the templates directory. During development the file lives
+ * at `client/src/cli/commands/create.ts`, so `../../../templates`
+ * resolves to `client/templates`. After tsc, it lives at
+ * `client/dist/cli/commands/create.js`, so the same offset resolves
+ * to `client/dist/templates` — we copy templates into dist on build.
+ * For robustness we probe both locations.
+ */
+function resolveTemplatesRoot() {
+    const here = fileURLToPath(new URL('.', import.meta.url));
+    const candidates = [
+        join(here, '../../../templates/harnesses/'), // src/cli/commands -> client/templates
+        join(here, '../../templates/harnesses/'), // dist/cli/commands -> client/templates
+        join(here, '../../../../templates/harnesses/'),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    // Fallback: first candidate (will surface a clear ENOENT below).
+    return candidates[0];
+}
+const TEMPLATES_ROOT = resolveTemplatesRoot();
+const NETWORK_CHAIN_IDS = {
+    'base-mainnet': 8453,
+    'base-sepolia': 84532,
+    sepolia: 11155111,
+    'ethereum-mainnet': 1,
+};
+export const SUPPORTED_PATTERNS = [
+    'forecaster',
+    'evaluator',
+    'alternative-harness',
+];
+const FORECASTER_FILES = [
+    { src: 'package.json.tmpl', dst: 'package.json' },
+    { src: 'tsconfig.json.tmpl', dst: 'tsconfig.json' },
+    { src: 'jinn.manifest.json.tmpl', dst: 'jinn.manifest.json' },
+    { src: 'src/index.ts.tmpl', dst: 'src/index.ts' },
+    { src: 'test/unit.test.ts.tmpl', dst: 'test/unit.test.ts' },
+    { src: 'README.md.tmpl', dst: 'README.md' },
+    { src: 'gitignore.tmpl', dst: '.gitignore' },
+];
+const EVALUATOR_FILES = [
+    { src: 'package.json.tmpl', dst: 'package.json' },
+    { src: 'tsconfig.json.tmpl', dst: 'tsconfig.json' },
+    { src: 'jinn.manifest.json.tmpl', dst: 'jinn.manifest.json' },
+    { src: 'src/index.ts.tmpl', dst: 'src/index.ts' },
+    { src: 'test/unit.test.ts.tmpl', dst: 'test/unit.test.ts' },
+    { src: 'README.md.tmpl', dst: 'README.md' },
+    { src: 'gitignore.tmpl', dst: '.gitignore' },
+];
+const ALTERNATIVE_HARNESS_FILES = [
+    { src: 'package.json.tmpl', dst: 'package.json' },
+    { src: 'tsconfig.json.tmpl', dst: 'tsconfig.json' },
+    { src: 'jinn.manifest.json.tmpl', dst: 'jinn.manifest.json' },
+    { src: 'src/index.ts.tmpl', dst: 'src/index.ts' },
+    { src: 'src/harness.ts.tmpl', dst: 'src/harness.ts' },
+    { src: 'src/mock-harness.ts.tmpl', dst: 'src/mock-harness.ts' },
+    { src: 'src/coordinator.ts.tmpl', dst: 'src/coordinator.ts' },
+    { src: 'src/phases/orient.ts.tmpl', dst: 'src/phases/orient.ts' },
+    { src: 'src/phases/strategize.ts.tmpl', dst: 'src/phases/strategize.ts' },
+    { src: 'src/phases/plan.ts.tmpl', dst: 'src/phases/plan.ts' },
+    { src: 'src/phases/execute.ts.tmpl', dst: 'src/phases/execute.ts' },
+    { src: 'src/phases/debrief.ts.tmpl', dst: 'src/phases/debrief.ts' },
+    { src: 'src/phases/improve.ts.tmpl', dst: 'src/phases/improve.ts' },
+    { src: 'src/phases/memory.ts.tmpl', dst: 'src/phases/memory.ts' },
+    { src: 'test/unit.test.ts.tmpl', dst: 'test/unit.test.ts' },
+    { src: 'test/coordinator.test.ts.tmpl', dst: 'test/coordinator.test.ts' },
+    { src: 'README.md.tmpl', dst: 'README.md' },
+    { src: 'gitignore.tmpl', dst: '.gitignore' },
+];
+function templateFiles(pattern) {
+    switch (pattern) {
+        case 'forecaster':
+            return FORECASTER_FILES;
+        case 'evaluator':
+            return EVALUATOR_FILES;
+        case 'alternative-harness':
+            return ALTERNATIVE_HARNESS_FILES;
+        default:
+            throw new Error(`unsupported pattern: ${pattern}`);
+    }
+}
+function substitute(text, vars) {
+    return text.replace(/\{\{(\w+)\}\}/g, (_match, key) => String(vars[key] ?? ''));
+}
+function packageNameSlug(packageName) {
+    return packageName.replace(/^@/, '').replace(/[/]/g, '-');
+}
+export async function runCreate(args) {
+    if (args.target !== 'harness') {
+        throw new Error(`unsupported target: ${args.target}`);
+    }
+    const networkChainId = NETWORK_CHAIN_IDS[args.network];
+    if (networkChainId === undefined) {
+        throw new Error(`unknown network ${args.network}; known: ${Object.keys(NETWORK_CHAIN_IDS).join(', ')}`);
+    }
+    const targetRoot = join(args.outDir, args.packageName);
+    const vars = {
+        packageName: args.packageName,
+        packageNameSlug: packageNameSlug(args.packageName),
+        solverTypeString: args.solverTypeString,
+        network: args.network,
+        networkChainId,
+    };
+    for (const file of templateFiles(args.pattern)) {
+        const srcPath = join(TEMPLATES_ROOT, args.pattern, file.src);
+        const dstPath = join(targetRoot, file.dst);
+        const text = readFileSync(srcPath, 'utf8');
+        mkdirSync(dirname(dstPath), { recursive: true });
+        writeFileSync(dstPath, substitute(text, vars));
+    }
+    return targetRoot;
+}
+const HELP_TEXT = `\
+jinn create harness <packageName>
+
+Scaffold a new Jinn package on disk.
+
+Subcommands:
+  harness    external Harness package (forecaster / evaluator / alternative-harness)
+
+Harness options:
+  --pattern=<pattern>     Template pattern (default: forecaster)
+                          Supported: forecaster, evaluator, alternative-harness
+  --solver-type=<value>   SolverType the Harness handles (default: prediction.v1)
+  --network=<network>     Default network (default: base-sepolia)
+                          One of: base-mainnet, base-sepolia, sepolia, ethereum-mainnet
+
+Common:
+  --out-dir=<path>        Where to write the package (default: cwd)
+  --help                  Show this help
+
+Examples:
+  jinn create harness @example/forecaster
+`;
+async function run(ctx) {
+    // Manual parsing — we want positional: subcommand + packageName.
+    const sub = ctx.argv[0];
+    if (!sub || sub === '--help' || ctx.argv.includes('--help')) {
+        ctx.writer.write(HELP_TEXT);
+        return;
+    }
+    if (sub !== 'harness') {
+        ctx.writer.write(`error: unknown subcommand '${sub}' (expected 'harness')\n`);
+        ctx.writer.write(HELP_TEXT);
+        ctx.exit(1);
+        return;
+    }
+    const packageName = ctx.argv[1];
+    if (!packageName || packageName.startsWith('--')) {
+        ctx.writer.write(`error: package name required\n`);
+        ctx.writer.write(HELP_TEXT);
+        ctx.exit(1);
+        return;
+    }
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: ctx.argv.slice(2),
+            options: {
+                ...COMMON_FLAGS,
+                pattern: {
+                    type: 'string',
+                    default: 'forecaster',
+                },
+                'solver-type': { type: 'string', default: 'prediction.v1' },
+                network: { type: 'string', default: 'base-sepolia' },
+                'out-dir': { type: 'string' },
+            },
+            allowPositionals: false,
+        });
+    }
+    catch (err) {
+        ctx.writer.write(`error: ${err.message}\n`);
+        ctx.exit(1);
+        return;
+    }
+    const flags = parsed.values;
+    const outDir = String(flags['out-dir'] ?? process.cwd());
+    const pattern = String(flags.pattern ?? 'forecaster');
+    if (!SUPPORTED_PATTERNS.includes(pattern)) {
+        ctx.writer.write(`error: unsupported --pattern '${pattern}' (supported: ${SUPPORTED_PATTERNS.join(', ')})\n`);
+        ctx.exit(1);
+        return;
+    }
+    let target;
+    try {
+        target = await runCreate({
+            target: 'harness',
+            pattern,
+            packageName,
+            solverTypeString: String(flags['solver-type'] ?? 'prediction.v1'),
+            network: String(flags.network ?? 'base-sepolia'),
+            outDir,
+        });
+    }
+    catch (err) {
+        ctx.writer.write(`error: ${err.message}\n`);
+        ctx.exit(1);
+        return;
+    }
+    ctx.writer.write(`Created ${packageName} at ${target}\nNext: cd ${target} && yarn install && yarn test\n`);
+}
+export const createCommand = {
+    name: 'create',
+    summary: 'Scaffold a new Jinn external harness impl package',
+    helpText: HELP_TEXT,
+    run,
+};
+export default createCommand;
+//# sourceMappingURL=create.js.map

package/dist/cli/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/cli/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;GAOG;AACH,SAAS,oBAAoB;IAC3B,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,EAAE,+BAA+B,CAAC,EAAE,uCAAuC;QACpF,IAAI,CAAC,IAAI,EAAE,4BAA4B,CAAC,EAAK,wCAAwC;QACrF,IAAI,CAAC,IAAI,EAAE,kCAAkC,CAAC;KAC/C,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,iEAAiE;IACjE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,cAAc,GAAG,oBAAoB,EAAE,CAAC;AAE9C,MAAM,iBAAiB,GAA2B;IAChD,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,KAAK;IACrB,OAAO,EAAE,QAAQ;IACjB,kBAAkB,EAAE,CAAC;CACtB,CAAC;AAIF,MAAM,CAAC,MAAM,kBAAkB,GAA8B;IAC3D,YAAY;IACZ,WAAW;IACX,qBAAqB;CACtB,CAAC;AAgBF,MAAM,gBAAgB,GAAmB;IACvC,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,EAAE;IACjD,EAAE,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,eAAe,EAAE;IACnD,EAAE,GAAG,EAAE,yBAAyB,EAAE,GAAG,EAAE,oBAAoB,EAAE;IAC7D,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,EAAE;IACjD,EAAE,GAAG,EAAE,wBAAwB,EAAE,GAAG,EAAE,mBAAmB,EAAE;IAC3D,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,WAAW,EAAE;IAC3C,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,EAAE;CAC7C,CAAC;AAEF,MAAM,eAAe,GAAmB;IACtC,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,EAAE;IACjD,EAAE,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,eAAe,EAAE;IACnD,EAAE,GAAG,EAAE,yBAAyB,EAAE,GAAG,EAAE,oBAAoB,EAAE;IAC7D,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,EAAE;IACjD,EAAE,GAAG,EAAE,wBAAwB,EAAE,GAAG,EAAE,mBAAmB,EAAE;IAC3D,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,WAAW,EAAE;IAC3C,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,EAAE;CAC7C,CAAC;AAEF,MAAM,yBAAyB,GAAmB;IAChD,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,EAAE;IACjD,EAAE,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,eAAe,EAAE;IACnD,EAAE,GAAG,EAAE,yBAAyB,EAAE,GAAG,EAAE,oBAAoB,EAAE;IAC7D,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,EAAE;IACjD,EAAE,GAAG,EAAE,qBAAqB,EAAE,GAAG,EAAE,gBAAgB,EAAE;IACrD,EAAE,GAAG,EAAE,0BAA0B,EAAE,GAAG,EAAE,qBAAqB,EAAE;IAC/D,EAAE,GAAG,EAAE,yBAAyB,EAAE,GAAG,EAAE,oBAAoB,EAAE;IAC7D,EAAE,GAAG,EAAE,2BAA2B,EAAE,GAAG,EAAE,sBAAsB,EAAE;IACjE,EAAE,GAAG,EAAE,+BAA+B,EAAE,GAAG,EAAE,0BAA0B,EAAE;IACzE,EAAE,GAAG,EAAE,yBAAyB,EAAE,GAAG,EAAE,oBAAoB,EAAE;IAC7D,EAAE,GAAG,EAAE,4BAA4B,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACnE,EAAE,GAAG,EAAE,4BAA4B,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACnE,EAAE,GAAG,EAAE,4BAA4B,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACnE,EAAE,GAAG,EAAE,2BAA2B,EAAE,GAAG,EAAE,sBAAsB,EAAE;IACjE,EAAE,GAAG,EAAE,wBAAwB,EAAE,GAAG,EAAE,mBAAmB,EAAE;IAC3D,EAAE,GAAG,EAAE,+BAA+B,EAAE,GAAG,EAAE,0BAA0B,EAAE;IACzE,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,WAAW,EAAE;IAC3C,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,EAAE;CAC7C,CAAC;AAEF,SAAS,aAAa,CAAC,OAAuB;IAC5C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,YAAY;YACf,OAAO,gBAAgB,CAAC;QAC1B,KAAK,WAAW;YACd,OAAO,eAAe,CAAC;QACzB,KAAK,qBAAqB;YACxB,OAAO,yBAAyB,CAAC;QACnC;YACE,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAiB,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,IAAqC;IACrE,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,GAAW,EAAE,EAAE,CAC5D,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CACxB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,WAAmB;IAC1C,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,MAAgB,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,CAAC,OAAO,YAAY,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvF,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,IAAI,GAAoC;QAC5C,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,eAAe,EAAE,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC;QAClD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,cAAc;KACf,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBjB,CAAC;AAEF,KAAK,UAAU,GAAG,CAAC,GAAmB;IACpC,iEAAiE;IACjE,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5B,OAAO;IACT,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,8BAA8B,GAAG,0BAA0B,CAC5D,CAAC;QACF,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,OAAO;IACT,CAAC;IACD,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC;YACjB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACvB,OAAO,EAAE;gBACP,GAAG,YAAY;gBACf,OAAO,EAAE;oBACP,IAAI,EAAE,QAAiB;oBACvB,OAAO,EAAE,YAAY;iBACtB;gBACD,aAAa,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,eAAe,EAAE;gBACpE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,cAAc,EAAE;gBAC7D,SAAS,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;aACvC;YACD,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,YAAY,CAAmB,CAAC;IACxE,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,iCAAiC,OAAO,iBAAiB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAC5F,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,OAAO;IACT,CAAC;IAED,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,SAAS,CAAC;YACvB,MAAM,EAAE,SAAS;YACjB,OAAO;YACP,WAAW;YACX,gBAAgB,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,eAAe,CAAC;YACjE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC;YAChD,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,OAAO;IACT,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,WAAW,WAAW,OAAO,MAAM,cAAc,MAAM,iCAAiC,CACzF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,mDAAmD;IAC5D,QAAQ,EAAE,SAAS;IACnB,GAAG;CACJ,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/cli/commands/doctor.d.ts

@@ -1,3 +1,51 @@
-import type { CommandModule } from '../command.js';
+import type { BaseCommandDeps, CommandModule } from '../command.js';
+import { checkClaudeBinary as defaultCheckClaudeBinary } from '../../preflight/claude-binary.js';
+import { detectAuthContext as defaultDetectAuthContext, probeClaudeAuth as defaultProbeClaudeAuth } from '../../preflight/claude-auth.js';
+import { type JinnConfig } from '../../config.js';
+import { runPortfolioV0DoctorChecks as defaultRunPortfolioV0DoctorChecks } from '../../api/portfolio-v0-doctor.js';
+import { checkRpcNetwork as defaultCheckRpcNetwork, rpcNetworkFailureHint as defaultRpcNetworkFailureHint } from '../../preflight/rpc-network.js';
+import { type TaskNativeReadiness } from '../task-native-readiness.js';
+export interface DoctorDeps extends BaseCommandDeps {
+    checkClaudeBinary: typeof defaultCheckClaudeBinary;
+    checkRpcNetwork: typeof defaultCheckRpcNetwork;
+    rpcNetworkFailureHint: typeof defaultRpcNetworkFailureHint;
+    runPortfolioV0DoctorChecks: typeof defaultRunPortfolioV0DoctorChecks;
+    /** Probes the distributor's OLAS balance via real RPC; tests inject a fake to avoid network hangs. */
+    checkDistributorReachable: (config: JinnConfig) => Promise<CheckResult | null>;
+    /** Detects whether claude runs in a container/compose/bare context. */
+    detectAuthContext: typeof defaultDetectAuthContext;
+    /** Probes claude auth status via subprocess; tests inject a fake to avoid spawning claude. */
+    probeClaudeAuth: typeof defaultProbeClaudeAuth;
+    /** Local-only Task-native deployment/config readiness check. */
+    resolveTaskNativeReadiness?: (config: JinnConfig) => TaskNativeReadiness;
+}
+interface CheckResult {
+    name: string;
+    ok: boolean;
+    detail: string;
+    remedy?: string;
+    /** `rpc_network` only: preflight used loopback Anvil/Hardhat chain id, not Base. */
+    rpcStatus?: 'matched' | 'local_dev_override';
+    /** `rpc_network` only: machine-readable context (avoid parsing `detail` for automation). */
+    rpc?: {
+        host: string;
+        network: 'mainnet' | 'testnet';
+        expectedChainId: number;
+        actualChainId: number;
+    };
+    taskNative?: {
+        solverReady: boolean;
+        evaluatorReady: boolean;
+        source: string | null;
+        contracts: {
+            taskCoordinator?: string;
+            jinnRouterV3?: string;
+            taskActivityCheckerV3?: string;
+        };
+        routerClaimDeliveryVersion?: 'v1' | 'v2' | 'v3';
+        operatorState?: TaskNativeReadiness['operatorState'];
+    };
+}
+export declare function createDoctorCommand(deps?: DoctorDeps): CommandModule;
 declare const command: CommandModule;
 export default command;

package/dist/cli/commands/doctor.js

@@ -7,14 +7,26 @@ import { baseSepolia } from 'viem/chains';
 import { COMMON_FLAGS } from '../command.js';
 import { emitResult } from '../output.js';
 import { emitEnvelope } from '../../errors/envelope.js';
-import { checkClaudeBinary } from '../../preflight/claude-binary.js';
-import { detectAuthContext, probeClaudeAuth } from '../../preflight/claude-auth.js';
-import { getConfigPathFromArgs, loadConfig } from '../../config.js';
+import { checkClaudeBinary as defaultCheckClaudeBinary } from '../../preflight/claude-binary.js';
+import { detectAuthContext as defaultDetectAuthContext, probeClaudeAuth as defaultProbeClaudeAuth, } from '../../preflight/claude-auth.js';
+import { getConfigPathFromArgs as defaultGetConfigPathFromArgs, loadConfig as defaultLoadConfig, buildConfigProvenance, } from '../../config.js';
 import { getChainConfig, ERC20_ABI } from '../../earning/contracts.js';
-import { runPortfolioV0DoctorChecks } from '../../api/portfolio-v0-doctor.js';
+import { runPortfolioV0DoctorChecks as defaultRunPortfolioV0DoctorChecks } from '../../api/portfolio-v0-doctor.js';
 import { mnemonicKeystorePath } from '../../earning/store.js';
-import { checkRpcNetwork, rpcNetworkFailureHint } from '../../preflight/rpc-network.js';
-import { SPEC_KINDS } from '../../intents/kinds/index.js';
+import { checkRpcNetwork as defaultCheckRpcNetwork, rpcNetworkFailureHint as defaultRpcNetworkFailureHint, } from '../../preflight/rpc-network.js';
+import { SOLVER_TYPES } from '../../solver-types/index.js';
+import { resolveTaskNativeReadiness as defaultResolveTaskNativeReadiness, } from '../task-native-readiness.js';
+const PRODUCTION_DEPS = {
+    loadConfig: defaultLoadConfig,
+    getConfigPathFromArgs: defaultGetConfigPathFromArgs,
+    checkClaudeBinary: defaultCheckClaudeBinary,
+    checkRpcNetwork: defaultCheckRpcNetwork,
+    rpcNetworkFailureHint: defaultRpcNetworkFailureHint,
+    runPortfolioV0DoctorChecks: defaultRunPortfolioV0DoctorChecks,
+    checkDistributorReachable,
+    detectAuthContext: defaultDetectAuthContext,
+    probeClaudeAuth: defaultProbeClaudeAuth,
+};
 async function checkNodeVersion() {
     const version = process.versions.node;
     const major = parseInt(version.split('.')[0], 10);
@@ -49,22 +61,15 @@ async function checkDeploymentLoaded(config) {
             testnetL2TokenDeploymentPath: config.testnetL2TokenDeploymentPath,
             testnetMechDeploymentPath: config.testnetMechDeploymentPath,
             testnetStolasDeploymentPath: config.testnetStolasDeploymentPath,
-            testnetClaimRegistryDeploymentPath: config.testnetClaimRegistryDeploymentPath,
         });
         const hasMech = cfg.mechMarketplace !== '0x0000000000000000000000000000000000000000';
-        const requiresClaimRegistry = config.network === 'testnet';
-        const claimRegistryDetail = cfg.claimRegistry
-            ? ', claim registry resolved'
-            : requiresClaimRegistry
-                ? ', claim registry not configured'
-                : '';
         return {
             name: 'deployment_loaded',
-            ok: hasMech && (!requiresClaimRegistry || Boolean(cfg.claimRegistry)),
+            ok: hasMech,
             detail: hasMech
-                ? `resolved on ${chain}${claimRegistryDetail}`
+                ? `resolved on ${chain}`
                 : 'resolved deployment has no usable routing address',
-            ...(hasMech && (!requiresClaimRegistry || cfg.claimRegistry)
+            ...(hasMech
                 ? {}
                 : {
                     remedy: 'Update deployment settings in your configuration file, or use a network with bundled deployment data.',
@@ -80,6 +85,24 @@ async function checkDeploymentLoaded(config) {
         };
     }
 }
+function taskNativeCheckForDoctor(readiness) {
+    return {
+        name: 'task_native_deployment',
+        ok: readiness.ok,
+        detail: readiness.detail,
+        ...(readiness.remedy ? { remedy: readiness.remedy } : {}),
+        taskNative: {
+            solverReady: readiness.solverReady,
+            evaluatorReady: readiness.evaluatorReady,
+            source: readiness.source,
+            contracts: readiness.contracts,
+            ...(readiness.routerClaimDeliveryVersion
+                ? { routerClaimDeliveryVersion: readiness.routerClaimDeliveryVersion }
+                : {}),
+            ...(readiness.operatorState ? { operatorState: readiness.operatorState } : {}),
+        },
+    };
+}
 function claudeBinaryCheckForDoctor(claudePath, result) {
     const configuredAsPath = isAbsolute(claudePath) || claudePath.includes('/');
     const detail = result.ok
@@ -112,7 +135,7 @@ function checkDaemonRuntimeReady() {
     // Under tsx (dev), __dirname is src/cli/commands; the check then looks for a sibling
     // built artifact under dist/, which will only exist after `yarn build`.
     const thisDir = dirname(fileURLToPath(import.meta.url));
-    const mcpToolsJsDist = join(thisDir, '..', '..', 'restorer', 'impls', 'claude-mcp-hyperliquid', 'mcp-tools.js');
+    const mcpToolsJsDist = join(thisDir, '..', '..', 'harnesses', 'impls', 'claude-mcp-hyperliquid', 'mcp-tools.js');
     if (existsSync(mcpToolsJsDist)) {
         return {
             name: 'daemon_runtime_ready',
@@ -143,7 +166,6 @@ async function checkDistributorReachable(config) {
             testnetL2TokenDeploymentPath: config.testnetL2TokenDeploymentPath,
             testnetMechDeploymentPath: config.testnetMechDeploymentPath,
             testnetStolasDeploymentPath: config.testnetStolasDeploymentPath,
-            testnetClaimRegistryDeploymentPath: config.testnetClaimRegistryDeploymentPath,
         });
         if (!cfg.distributorAddress) {
             return {
@@ -185,125 +207,52 @@ async function checkDistributorReachable(config) {
         };
     }
 }
-async function checkRpcNetworkForDoctor(config) {
-    const result = await checkRpcNetwork(config);
-    if (result.ok) {
-        const detail = result.localDev
-            ? `${result.rpcHost} reports chainId ${result.actualChainId} for config network ${result.network} (local loopback; Anvil/Hardhat id, not Base ${result.expectedChainId} — expected for local forks).`
-            : `${result.rpcHost} reports chain ${result.actualChainId} for ${result.network}`;
+export function createDoctorCommand(deps = PRODUCTION_DEPS) {
+    async function checkRpcNetworkForDoctor(config) {
+        const result = await deps.checkRpcNetwork(config);
+        if (result.ok) {
+            const detail = result.localDev
+                ? `${result.rpcHost} reports chainId ${result.actualChainId} for config network ${result.network} (local loopback; Anvil/Hardhat id, not Base ${result.expectedChainId} — expected for local forks).`
+                : `${result.rpcHost} reports chain ${result.actualChainId} for ${result.network}`;
+            return {
+                name: 'rpc_network',
+                ok: true,
+                detail,
+                rpcStatus: result.localDev ? 'local_dev_override' : 'matched',
+                rpc: {
+                    host: result.rpcHost,
+                    network: result.network,
+                    expectedChainId: result.expectedChainId,
+                    actualChainId: result.actualChainId,
+                },
+            };
+        }
         return {
             name: 'rpc_network',
-            ok: true,
-            detail,
-            rpcStatus: result.localDev ? 'local_dev_override' : 'matched',
-            rpc: {
-                host: result.rpcHost,
-                network: result.network,
-                expectedChainId: result.expectedChainId,
-                actualChainId: result.actualChainId,
-            },
+            ok: false,
+            detail: result.message,
+            remedy: deps.rpcNetworkFailureHint(result),
         };
     }
-    return {
-        name: 'rpc_network',
-        ok: false,
-        detail: result.message,
-        remedy: rpcNetworkFailureHint(result),
-    };
-}
-async function checkClaudeAuth(config) {
-    const cwd = process.cwd();
-    const context = detectAuthContext({ cwd, configuredMode: config.runtimeMode });
-    const probe = probeClaudeAuth({ context, cwd });
-    return {
-        name: 'claude_auth',
-        ok: probe.authenticated,
-        detail: probe.authenticated
-            ? `${probe.detail} (${context})`
-            : `Not authenticated (${context})`,
-        ...(probe.authenticated
-            ? {}
-            : { remedy: 'Run `jinn auth` to authenticate Claude.' }),
-    };
-}
-async function run(ctx) {
-    let parsed;
-    try {
-        parsed = parseArgs({
-            args: ctx.argv,
-            options: { ...COMMON_FLAGS },
-            allowPositionals: false,
-        });
-    }
-    catch (err) {
-        emitEnvelope({
-            code: 'invalid_invocation',
-            message: err instanceof Error ? err.message : String(err),
-            exampleCli: 'jinn doctor',
-            details: { field: 'flags' },
-        }, { writer: ctx.writer, exit: ctx.exit });
-        return;
-    }
-    const configPath = getConfigPathFromArgs(ctx.argv ?? []) ?? getConfigPathFromArgs(process.argv.slice(2));
-    const config = loadConfig(configPath);
-    const checks = [];
-    checks.push(await checkNodeVersion());
-    const claudeResult = await checkClaudeBinary(config.claudePath);
-    checks.push(claudeBinaryCheckForDoctor(config.claudePath, claudeResult));
-    checks.push(await checkClaudeAuth(config));
-    checks.push(checkKeystorePresent(config.earningDir));
-    checks.push(await checkRpcNetworkForDoctor(config));
-    checks.push(await checkDeploymentLoaded(config));
-    checks.push(checkDaemonRuntimeReady());
-    const distributorCheck = await checkDistributorReachable(config);
-    if (distributorCheck)
-        checks.push(distributorCheck);
-    // portfolio.v0 checks — only run if the operator has configured a
-    // portfolio.v0 desired state. Otherwise, reporting `hl_api_wallet: fail`
-    // on a fresh operator who hasn't submitted an HL intent is false-alarm
-    // noise. Operators who want the HL-specific preflight in isolation can
-    // run those checks under a dedicated verb once one exists.
-    const portfolioKind = SPEC_KINDS['portfolio.v0'].kind;
-    const hasPortfolioV0 = config.desiredStates.some((d) => d.spec?.kind === portfolioKind);
-    if (hasPortfolioV0) {
-        const implStateDirRoot = config.engine.implStateDirRoot;
-        const hlImplStateDir = join(implStateDirRoot, 'claude-mcp-hyperliquid');
-        const portfolioChecks = runPortfolioV0DoctorChecks(hlImplStateDir);
-        checks.push(...portfolioChecks);
-    }
-    const blockingCount = checks.filter((c) => !c.ok).length;
-    const payload = {
-        schemaVersion: 1,
-        generatedAt: new Date().toISOString(),
-        checks,
-        ok: blockingCount === 0,
-        blockingCount,
-    };
-    emitResult(payload, (v) => humanDoctor(v), {
-        json: Boolean(parsed.values.json),
-        human: Boolean(parsed.values.human),
-        writer: ctx.writer,
-        stdoutIsTty: ctx.stdoutIsTty,
-        noColor: Boolean(ctx.env['NO_COLOR']),
-    });
-}
-function humanDoctor(payload) {
-    const lines = [];
-    for (const check of payload.checks) {
-        const mark = check.ok ? 'ok  ' : 'fail';
-        lines.push(`[${mark}] ${check.name}: ${check.detail}`);
-        if (check.remedy)
-            lines.push(`       remedy: ${check.remedy}`);
+    async function checkClaudeAuth(config) {
+        const cwd = process.cwd();
+        const context = deps.detectAuthContext({ cwd, configuredMode: config.runtimeMode });
+        const probe = deps.probeClaudeAuth({ context, cwd, claudePath: config.claudePath });
+        return {
+            name: 'claude_auth',
+            ok: probe.authenticated,
+            detail: probe.authenticated
+                ? `${probe.detail} (${context})`
+                : `Not authenticated (${context})`,
+            ...(probe.authenticated
+                ? {}
+                : { remedy: 'Run `jinn auth` to authenticate Claude.' }),
+        };
     }
-    lines.push(payload.ok
-        ? 'Summary: all checks passed.'
-        : `Summary: ${payload.blockingCount} blocking check(s) failed.`);
-    return lines.join('\n');
-}
-const command = {
-    name: 'doctor',
-    summary: 'Preflight checks: answers "would jinn run work?" without running it',
-    helpText: `Usage: jinn doctor [--human] [--config <path>]
+    return {
+        name: 'doctor',
+        summary: 'Preflight checks: answers "would jinn run work?" without running it',
+        helpText: `Usage: jinn doctor [--human] [--config <path>]
 
 Runs a set of non-mutating checks against the local environment and
 configuration:
@@ -312,6 +261,7 @@ configuration:
   - claude_auth                 Claude CLI authenticated
   - keystore_present            mnemonic keystore in configured earning directory (optional)
   - deployment_loaded           testnet/mainnet contract addresses resolved
+  - task_native_deployment      TaskCoordinator/JinnRouterV3/TaskActivityCheckerV3 local readiness
   - portfolio_impl_state_dir    HL impl state directory present and readable
   - hl_api_wallet               HL API wallet generated and approved by operator
 
@@ -323,7 +273,85 @@ Examples:
   jinn doctor
   jinn doctor --human
 `,
-    run,
-};
+        async run(ctx) {
+            let parsed;
+            try {
+                parsed = parseArgs({
+                    args: ctx.argv,
+                    options: { ...COMMON_FLAGS },
+                    allowPositionals: false,
+                });
+            }
+            catch (err) {
+                emitEnvelope({
+                    code: 'invalid_invocation',
+                    message: err instanceof Error ? err.message : String(err),
+                    exampleCli: 'jinn doctor',
+                    details: { field: 'flags' },
+                }, { writer: ctx.writer, exit: ctx.exit });
+                return;
+            }
+            const configPath = deps.getConfigPathFromArgs(ctx.argv ?? []) ?? deps.getConfigPathFromArgs(process.argv.slice(2));
+            const config = deps.loadConfig(configPath);
+            const checks = [];
+            checks.push(await checkNodeVersion());
+            const claudeResult = await deps.checkClaudeBinary(config.claudePath);
+            checks.push(claudeBinaryCheckForDoctor(config.claudePath, claudeResult));
+            checks.push(await checkClaudeAuth(config));
+            checks.push(checkKeystorePresent(config.earningDir));
+            checks.push(await checkRpcNetworkForDoctor(config));
+            checks.push(await checkDeploymentLoaded(config));
+            checks.push(taskNativeCheckForDoctor((deps.resolveTaskNativeReadiness ?? defaultResolveTaskNativeReadiness)(config)));
+            checks.push(checkDaemonRuntimeReady());
+            const distributorCheck = await deps.checkDistributorReachable(config);
+            if (distributorCheck)
+                checks.push(distributorCheck);
+            // portfolio.v0 checks — only run if the operator has configured a
+            // portfolio.v0 Task. Otherwise, reporting `hl_api_wallet: fail`
+            // on a fresh operator who hasn't submitted an HL task is false-alarm
+            // noise. Operators who want the HL-specific preflight in isolation can
+            // run those checks under a dedicated verb once one exists.
+            const portfolioKind = SOLVER_TYPES['portfolio.v0'].solverType;
+            const hasPortfolioV0 = config.tasks.some((d) => d.solverType === portfolioKind);
+            if (hasPortfolioV0) {
+                const implStateDirRoot = config.engine.implStateDirRoot;
+                const hlImplStateDir = join(implStateDirRoot, 'claude-mcp-hyperliquid');
+                const portfolioChecks = deps.runPortfolioV0DoctorChecks(hlImplStateDir);
+                checks.push(...portfolioChecks);
+            }
+            const blockingCount = checks.filter((c) => !c.ok).length;
+            const provenance = buildConfigProvenance(configPath, config, ctx.env);
+            const payload = {
+                schemaVersion: 1,
+                generatedAt: new Date().toISOString(),
+                config: provenance,
+                checks,
+                ok: blockingCount === 0,
+                blockingCount,
+            };
+            emitResult(payload, (v) => humanDoctor(v), {
+                json: Boolean(parsed.values.json),
+                human: Boolean(parsed.values.human),
+                writer: ctx.writer,
+                stdoutIsTty: ctx.stdoutIsTty,
+                noColor: Boolean(ctx.env['NO_COLOR']),
+            });
+        },
+    };
+}
+function humanDoctor(payload) {
+    const lines = [];
+    for (const check of payload.checks) {
+        const mark = check.ok ? 'ok  ' : 'fail';
+        lines.push(`[${mark}] ${check.name}: ${check.detail}`);
+        if (check.remedy)
+            lines.push(`       remedy: ${check.remedy}`);
+    }
+    lines.push(payload.ok
+        ? 'Summary: all checks passed.'
+        : `Summary: ${payload.blockingCount} blocking check(s) failed.`);
+    return lines.join('\n');
+}
+const command = createDoctorCommand();
 export default command;
 //# sourceMappingURL=doctor.js.map