@jinn-network/client 0.1.2 → 0.1.3-canary.2d6b2676

package/dist/cli/commands/conformance.js

@@ -0,0 +1,140 @@
+/**
+ * `jinn conformance` verb.
+ *
+ * Runs the conformance harness against a signed envelope CID and prints the
+ * ConformanceReport. Exits 0 on PASS, 1 on FAIL.
+ *
+ * Usage:
+ *   jinn conformance --envelope-cid <cid> [--skip-layer2] [--json]
+ */
+import { parseArgs } from 'node:util';
+import { COMMON_FLAGS } from '../command.js';
+import { emitEnvelope } from '../../errors/envelope.js';
+import { getConfigPathFromArgs, loadConfig } from '../../config.js';
+import { runConformance } from '../../conformance/harness.js';
+async function run(ctx) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: ctx.argv,
+            options: {
+                ...COMMON_FLAGS,
+                'envelope-cid': { type: 'string' },
+                'skip-layer2': { type: 'boolean', default: false },
+            },
+            allowPositionals: false,
+        });
+    }
+    catch (err) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: err instanceof Error ? err.message : String(err),
+            exampleCli: 'jinn conformance --envelope-cid bafyxxx',
+            details: { field: 'flags' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const envelopeCid = parsed.values['envelope-cid'];
+    if (!envelopeCid) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: '--envelope-cid is required',
+            exampleCli: 'jinn conformance --envelope-cid bafyxxx',
+            details: { field: '--envelope-cid', expected: 'non-empty string IPFS CID' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const configPath = getConfigPathFromArgs(ctx.argv ?? []) ?? getConfigPathFromArgs(process.argv.slice(2));
+    const config = loadConfig(configPath);
+    let report;
+    try {
+        report = await runConformance({
+            envelopeCid,
+            options: {
+                ipfsGatewayUrl: config.ipfsGatewayUrl,
+                ipfsRegistryUrl: config.ipfsRegistryUrl,
+                skipLayer2: parsed.values['skip-layer2'] === true,
+            },
+        });
+    }
+    catch (err) {
+        emitEnvelope({
+            code: 'transient_error',
+            message: `Conformance run failed unexpectedly: ${err instanceof Error ? err.message : String(err)}`,
+            details: { envelopeCid },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const useJson = Boolean(parsed.values.json);
+    if (useJson) {
+        ctx.writer.write(JSON.stringify(report, null, 2) + '\n');
+    }
+    else {
+        ctx.writer.write(`Conformance report for ${report.envelopeCid}\n`);
+        ctx.writer.write(`  Tier   : ${report.envelopeTier}\n`);
+        ctx.writer.write(`  Summary: ${report.summary.passed}/${report.summary.total} passed, ` +
+            `${report.summary.failed} failed, ${report.summary.skipped} skipped\n`);
+        ctx.writer.write(`  Layer 1: ${report.layer1Passed ? 'PASS' : 'FAIL'}\n`);
+        ctx.writer.write(`  Layer 2: ${report.layer2Passed === 'N/A'
+            ? 'N/A (not attested tier)'
+            : report.layer2Passed
+                ? 'PASS'
+                : 'FAIL'}\n`);
+        ctx.writer.write(`  Overall: ${report.overall}\n`);
+        ctx.writer.write('\n');
+        for (const c of report.checks) {
+            const icon = c.skipped ? '-' : c.passed ? 'ok  ' : 'FAIL';
+            const detail = c.detail ? `: ${c.detail}` : '';
+            ctx.writer.write(`  [${icon}] [L${c.layer}] ${c.id}${detail}\n`);
+        }
+    }
+    ctx.exit(report.overall === 'PASS' ? 0 : 1);
+}
+const command = {
+    name: 'conformance',
+    summary: 'Run the envelope + trajectory conformance suite against a signed envelope CID',
+    helpText: `Usage: jinn conformance --envelope-cid <cid> [--skip-layer2] [--json]
+
+Fetches the signed envelope from IPFS and runs the full Layer 1 + Layer 2
+conformance suite. Prints a human-readable summary (or JSON with --json).
+
+Layer 1 checks (structural — applies to every envelope):
+  envelope.schema          SignedEnvelopeSchema validation
+  envelope.payload         KIND_PAYLOADS[kind][role] validation
+  envelope.hash-signature  Canonical hash + secp256k1 signature recovery
+  trajectory.schema        JinnTrajectoryV1Schema validation
+  trajectory.hash-chain    Per-span prevSpanHash chain integrity
+  trajectory.span-profile  Required span attributes per SPAN_PROFILE
+  artifacts.vocabulary     Required artifactType values present
+  artifacts.linkage        Bidirectional span↔artifact linkage
+  verdict.back-ref         Verdict restoration-envelope SHA256 back-reference
+  verdict.verification-record  Verdict verificationOfRestoration structure
+  secret-scrub.compliance  V1 minimum credential scrubbing
+
+Layer 2 checks (attested tier only — source bundle static analysis):
+  source.traced-http       All LLM calls via traced HTTP wrapper
+  source.mcp-shim          All MCP calls via measured MCP shim
+  source.subprocess        No raw child_process outside subprocess wrapper
+  source.raw-sockets       No raw TCP/TLS sockets outside socket wrapper
+  source.dynamic-code      No eval / new Function / vm.runIn* / dynamic import
+  source.artifact-emit     Artifact emission via canonical helper
+
+Flags:
+  --envelope-cid <cid>   IPFS CID of the SignedEnvelope to check (required)
+  --skip-layer2          Skip Layer 2 (source-static) checks even at attested tier
+  --json                 Emit the full ConformanceReport as JSON
+  --config <path>        Path to jinn config file
+
+Exit codes:
+  0  PASS
+  1  FAIL
+
+Examples:
+  jinn conformance --envelope-cid bafybeiabc123...
+  jinn conformance --envelope-cid bafybeiabc123... --json
+  jinn conformance --envelope-cid bafybeiabc123... --skip-layer2
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=conformance.js.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * `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 type { CommandModule } from '../command.js';
+export type HarnessPattern = 'forecaster' | 'evaluator' | 'alternative-harness';
+export declare const SUPPORTED_PATTERNS: readonly HarnessPattern[];
+export interface RunCreateArgs {
+    target: 'harness';
+    pattern: HarnessPattern;
+    packageName: string;
+    solverTypeString: string;
+    network: string;
+    outDir: string;
+}
+export declare function runCreate(args: RunCreateArgs): Promise<string>;
+export declare const createCommand: CommandModule;
+export default createCommand;

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.v0)
+  --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.v0' },
+                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.v0'),
+            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":"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"}

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

@@ -1,3 +1,36 @@
-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';
+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;
+}
+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;
+    };
+}
+export declare function createDoctorCommand(deps?: DoctorDeps): CommandModule;
 declare const command: CommandModule;
 export default command;