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

package/dist/cli/commands/create.js

@@ -0,0 +1,374 @@
+/**
+ * `jinn create restorer <pkgName>` — scaffolds a working external
+ * restorer impl package on disk. After
+ *   cd <pkgName> && yarn install && yarn test
+ * the package's tests pass against a synthetic RestorationContext.
+ *
+ * Spec: `spec/2026-04-30-plug-in-surface.md` §3 (acceptance #4),
+ * `spec/2026-04-30-plug-in-surface.md` §3.3.1 (forecaster pattern).
+ */
+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/restorer/'), // src/cli/commands -> client/templates
+        join(here, '../../templates/restorer/'), // dist/cli/commands -> client/templates
+        join(here, '../../../../templates/restorer/'),
+    ];
+    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 PLUG_IN_TEMPLATES_ROOT = TEMPLATES_ROOT.replace(/restorer\/$/, 'plug-in/');
+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' },
+];
+export const SUPPORTED_PLUG_IN_PATTERNS = [
+    'phase-agent-override',
+    'topic-explorer',
+    'mcp-tool',
+    'skill-bundle',
+    'memory-backend',
+    'hook',
+];
+const PHASE_AGENT_OVERRIDE_FILES = [
+    { src: 'package.json.tmpl', dst: 'package.json' },
+    { src: 'jinn-plugin.json.tmpl', dst: 'jinn-plugin.json' },
+    { src: 'agents/agent.md.tmpl', dst: 'agents/{{phaseAgentName}}.md' },
+    { src: 'test/manifest.test.ts.tmpl', dst: 'test/manifest.test.ts' },
+    { src: 'README.md.tmpl', dst: 'README.md' },
+    { src: 'gitignore.tmpl', dst: '.gitignore' },
+];
+const TOPIC_EXPLORER_FILES = [
+    { src: 'package.json.tmpl', dst: 'package.json' },
+    { src: 'jinn-plugin.json.tmpl', dst: 'jinn-plugin.json' },
+    { src: 'agents/explorer.md.tmpl', dst: 'agents/{{topic}}-explorer.md' },
+    { src: 'test/manifest.test.ts.tmpl', dst: 'test/manifest.test.ts' },
+    { src: 'README.md.tmpl', dst: 'README.md' },
+    { src: 'gitignore.tmpl', dst: '.gitignore' },
+];
+const MCP_TOOL_FILES = [
+    { src: 'package.json.tmpl', dst: 'package.json' },
+    { src: 'jinn-plugin.json.tmpl', dst: 'jinn-plugin.json' },
+    { src: 'src/server.ts.tmpl', dst: 'src/server.ts' },
+    { src: 'test/server.test.ts.tmpl', dst: 'test/server.test.ts' },
+    { src: 'README.md.tmpl', dst: 'README.md' },
+    { src: 'gitignore.tmpl', dst: '.gitignore' },
+];
+const SKILL_BUNDLE_FILES = [
+    { src: 'package.json.tmpl', dst: 'package.json' },
+    { src: 'jinn-plugin.json.tmpl', dst: 'jinn-plugin.json' },
+    {
+        src: '.claude-plugin/plugin.json.tmpl',
+        dst: '.claude-plugin/plugin.json',
+    },
+    { src: 'skills/example/SKILL.md.tmpl', dst: 'skills/example/SKILL.md' },
+    { src: 'test/manifest.test.ts.tmpl', dst: 'test/manifest.test.ts' },
+    { src: 'README.md.tmpl', dst: 'README.md' },
+    { src: 'gitignore.tmpl', dst: '.gitignore' },
+];
+const MEMORY_BACKEND_FILES = [
+    { src: 'package.json.tmpl', dst: 'package.json' },
+    { src: 'jinn-plugin.json.tmpl', dst: 'jinn-plugin.json' },
+    { src: 'src/server.ts.tmpl', dst: 'src/server.ts' },
+    { src: 'test/server.test.ts.tmpl', dst: 'test/server.test.ts' },
+    { src: 'README.md.tmpl', dst: 'README.md' },
+    { src: 'gitignore.tmpl', dst: '.gitignore' },
+];
+const HOOK_FILES = [
+    { src: 'package.json.tmpl', dst: 'package.json' },
+    { src: 'jinn-plugin.json.tmpl', dst: 'jinn-plugin.json' },
+    { src: 'hooks/event.sh.tmpl', dst: 'hooks/{{event}}.sh' },
+    { src: 'test/manifest.test.ts.tmpl', dst: 'test/manifest.test.ts' },
+    { src: 'README.md.tmpl', dst: 'README.md' },
+    { src: 'gitignore.tmpl', dst: '.gitignore' },
+];
+function plugInTemplateFiles(pattern) {
+    switch (pattern) {
+        case 'phase-agent-override':
+            return PHASE_AGENT_OVERRIDE_FILES;
+        case 'topic-explorer':
+            return TOPIC_EXPLORER_FILES;
+        case 'mcp-tool':
+            return MCP_TOOL_FILES;
+        case 'skill-bundle':
+            return SKILL_BUNDLE_FILES;
+        case 'memory-backend':
+            return MEMORY_BACKEND_FILES;
+        case 'hook':
+            return HOOK_FILES;
+        default:
+            throw new Error(`unsupported plug-in pattern: ${pattern}`);
+    }
+}
+export async function runCreatePlugIn(args) {
+    const targetRoot = join(args.outDir, args.packageName);
+    const phaseAgentName = args.phase && args.agent ? `${args.phase}-${args.agent}` : 'agent';
+    const vars = {
+        packageName: args.packageName,
+        phase: args.phase ?? '',
+        agent: args.agent ?? '',
+        topic: args.topic ?? '',
+        event: args.event ?? '',
+        phaseAgentName,
+    };
+    for (const file of plugInTemplateFiles(args.pattern)) {
+        const srcPath = join(PLUG_IN_TEMPLATES_ROOT, args.pattern, file.src);
+        const dstPath = join(targetRoot, substitute(file.dst, vars));
+        const text = readFileSync(srcPath, 'utf8');
+        mkdirSync(dirname(dstPath), { recursive: true });
+        writeFileSync(dstPath, substitute(text, vars));
+    }
+    return targetRoot;
+}
+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.kind !== 'restorer') {
+        throw new Error(`unsupported kind: ${args.kind}`);
+    }
+    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),
+        kindString: args.kindString,
+        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 <restorer|plug-in> <packageName>
+
+Scaffold a new Jinn package on disk.
+
+Subcommands:
+  restorer    Path 2 — external restorer impl (forecaster / evaluator / alternative-harness)
+  plug-in     Path 1 — claude-code-learner plug-in (six slot patterns)
+
+Restorer options:
+  --pattern=<pattern>     Template pattern (default: forecaster)
+                          Supported: forecaster, evaluator, alternative-harness
+  --kind=<kindString>     Intent kind the impl handles (default: prediction.v0)
+  --network=<network>     Default network (default: base-sepolia)
+                          One of: base-mainnet, base-sepolia, sepolia, ethereum-mainnet
+
+Plug-in options:
+  --pattern=<pattern>     Slot type (default: phase-agent-override)
+                          Supported: phase-agent-override, topic-explorer, mcp-tool,
+                          skill-bundle, memory-backend, hook
+  --phase=<phase>         For phase-agent-override / topic-explorer / hook
+  --agent=<agent>         For phase-agent-override (e.g. step-worker, planner)
+  --topic=<topic>         For topic-explorer (kebab-case topic name)
+  --event=<event>         For hook (session-start | pre-phase | post-phase | session-end)
+
+Common:
+  --out-dir=<path>        Where to write the package (default: cwd)
+  --help                  Show this help
+
+Examples:
+  jinn create restorer @example/forecaster
+  jinn create plug-in @example/calib --pattern=phase-agent-override --phase=execute --agent=step-worker
+  jinn create plug-in @example/news --pattern=topic-explorer --phase=orient --topic=news-context
+  jinn create plug-in @example/poly --pattern=mcp-tool
+  jinn create plug-in @example/skills --pattern=skill-bundle
+  jinn create plug-in @example/vec --pattern=memory-backend
+  jinn create plug-in @example/precheck --pattern=hook --event=pre-phase --phase=execute
+`;
+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 !== 'restorer' && sub !== 'plug-in') {
+        ctx.writer.write(`error: unknown subcommand '${sub}' (expected 'restorer' or 'plug-in')\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: sub === 'plug-in' ? 'phase-agent-override' : 'forecaster',
+                },
+                kind: { type: 'string', default: 'prediction.v0' },
+                network: { type: 'string', default: 'base-sepolia' },
+                phase: { type: 'string' },
+                agent: { type: 'string' },
+                topic: { type: 'string' },
+                event: { type: 'string' },
+                '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());
+    if (sub === 'plug-in') {
+        const pattern = String(flags.pattern ?? 'phase-agent-override');
+        if (!SUPPORTED_PLUG_IN_PATTERNS.includes(pattern)) {
+            ctx.writer.write(`error: unsupported --pattern '${pattern}' (supported: ${SUPPORTED_PLUG_IN_PATTERNS.join(', ')})\n`);
+            ctx.exit(1);
+            return;
+        }
+        let target;
+        try {
+            target = await runCreatePlugIn({
+                kind: 'plug-in',
+                pattern,
+                packageName,
+                phase: flags.phase ? String(flags.phase) : undefined,
+                agent: flags.agent ? String(flags.agent) : undefined,
+                topic: flags.topic ? String(flags.topic) : undefined,
+                event: flags.event ? String(flags.event) : undefined,
+                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`);
+        return;
+    }
+    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({
+            kind: 'restorer',
+            pattern,
+            packageName,
+            kindString: String(flags.kind ?? '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 restorer 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;