@consensus-tools/consensus-tools 0.1.0 → 0.1.3

package/src/cli.ts

@@ -1,9 +1,18 @@
-import { readFileSync, promises as fs } from 'node:fs';
+import { promises as fs } from 'node:fs';
 import path from 'node:path';
-import os from 'node:os';
 import type { ConsensusToolsConfig, Job } from './types';
 import { renderTable } from './util/table';
-import { runConsensusPolicyTests } from '../tests/runner/consensusTestRunner';
+import { runConsensusPolicyTests } from './testing/consensusTestRunner';
+import { runInitWizard } from './initWizard';
+import {
+  defaultConsensusCliConfig,
+  getConfigValue,
+  loadCliConfig,
+  parseValue,
+  saveCliConfig,
+  setConfigValue,
+  type ConsensusCliConfig
+} from './cliConfig';
 
 export interface ConsensusToolsBackendCli {
   postJob(agentId: string, input: any): Promise<Job>;
@@ -17,15 +26,67 @@ export interface ConsensusToolsBackendCli {
   resolveJob(agentId: string, jobId: string, input: any): Promise<any>;
 }
 
+export async function initRepo(opts: {
+  rootDir?: string;
+  force?: boolean;
+  wizard?: boolean;
+  templatesOnly?: boolean;
+}): Promise<void> {
+  const rootDir = opts.rootDir || process.cwd();
+  const force = Boolean(opts.force);
+  const templatesOnly = Boolean(opts.templatesOnly);
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  const wizard = typeof opts.wizard === 'boolean' ? opts.wizard : interactive;
+
+  if (templatesOnly || !wizard) {
+    await writeInitTemplates(rootDir, force, defaultConsensusCliConfig);
+    return;
+  }
+
+  if (!interactive) {
+    throw new Error('init wizard requires a TTY. Re-run with --templates-only.');
+  }
+
+  const result = await runInitWizard(rootDir);
+  await writeInitTemplates(rootDir, force, result.config);
+  if (result.env) {
+    await writeEnvFile(rootDir, force, result.env);
+  }
+}
+
 export function registerCli(program: any, backend: ConsensusToolsBackendCli, config: ConsensusToolsConfig, agentId: string) {
   const consensus = program.command('consensus').description('Consensus tools');
+  registerConsensusSubcommands(consensus, backend, config, agentId);
+}
 
+export function registerStandaloneCli(
+  program: any,
+  backend: ConsensusToolsBackendCli,
+  config: ConsensusToolsConfig,
+  agentId: string
+) {
+  registerConsensusSubcommands(program, backend, config, agentId);
+}
+
+function registerConsensusSubcommands(
+  consensus: any,
+  backend: ConsensusToolsBackendCli,
+  _config: ConsensusToolsConfig,
+  agentId: string
+) {
   consensus
     .command('init')
-    .description('Generate .consensus shell templates')
+    .description('Initialize consensus-tools in this repo (.consensus/)')
     .option('--force', 'Overwrite existing files')
+    .option('--wizard', 'Run an interactive wizard (default when TTY)')
+    .option('--templates-only', 'Only generate templates; skip prompts')
     .action(async (opts: any) => {
-      await writeInitTemplates(process.cwd(), Boolean(opts.force));
+      await initRepo({
+        rootDir: process.cwd(),
+        force: Boolean(opts.force),
+        wizard: typeof opts.wizard === 'boolean' ? opts.wizard : undefined,
+        templatesOnly: Boolean(opts.templatesOnly)
+      });
       console.log('Created .consensus templates.');
     });
 
@@ -34,7 +95,7 @@ export function registerCli(program: any, backend: ConsensusToolsBackendCli, con
     .command('get <key>')
     .description('Get a config value')
     .action(async (key: string) => {
-      const cfg = await loadConfigFile();
+      const cfg = await loadCliConfig();
       const value = getConfigValue(cfg, key);
       output(value ?? null, true);
     });
@@ -43,10 +104,10 @@ export function registerCli(program: any, backend: ConsensusToolsBackendCli, con
     .command('set <key> <value>')
     .description('Set a config value')
     .action(async (key: string, value: string) => {
-      const cfg = await loadConfigFile();
+      const cfg = await loadCliConfig();
       const parsed = parseValue(value);
       setConfigValue(cfg, key, parsed);
-      await saveConfigFile(cfg);
+      await saveCliConfig(cfg);
       output({ ok: true }, true);
     });
 
@@ -55,7 +116,7 @@ export function registerCli(program: any, backend: ConsensusToolsBackendCli, con
     .command('use <type> [url]')
     .description('Select local or remote board')
     .action(async (type: string, url?: string) => {
-      const cfg = await loadConfigFile();
+      const cfg = await loadCliConfig();
       if (type !== 'local' && type !== 'remote') {
         throw new Error('board type must be local or remote');
       }
@@ -63,7 +124,7 @@ export function registerCli(program: any, backend: ConsensusToolsBackendCli, con
       if (type === 'remote' && url) {
         cfg.boards.remote.url = url;
       }
-      await saveConfigFile(cfg);
+      await saveCliConfig(cfg);
       output({ activeBoard: cfg.activeBoard, url: cfg.boards.remote.url }, true);
     });
 
@@ -78,7 +139,7 @@ export function registerCli(program: any, backend: ConsensusToolsBackendCli, con
     .option('--policy <policy>', 'Policy key')
     .option('--reward <n>', 'Reward amount', parseFloat)
     .option('--stake <n>', 'Stake amount', parseFloat)
-    .option('--lease <seconds>', 'Lease seconds', parseInt)
+    .option('--expires <seconds>', 'Expires seconds', parseInt)
     .option('--json', 'JSON output')
     .action(async (opts: any) => {
       const input = opts.input ?? (await readStdinIfAny());
@@ -93,7 +154,7 @@ export function registerCli(program: any, backend: ConsensusToolsBackendCli, con
         stakeAmount: opts.stake,
         reward: opts.reward,
         stakeRequired: opts.stake,
-        expiresSeconds: opts.lease
+        expiresSeconds: opts.expires
       });
       output(job, opts.json);
     });
@@ -176,16 +237,23 @@ export function registerCli(program: any, backend: ConsensusToolsBackendCli, con
     .description('Cast a vote')
     .option('--submission <id>', 'Submission id to vote for')
     .option('--choice <key>', 'Choice key to vote for')
+    .option('--yes', 'Approval vote: yes (+1)')
+    .option('--no', 'Approval vote: no (-1)')
     .option('--weight <n>', 'Vote weight', parseFloat)
+    .option('--stake <n>', 'Stake amount locked for this vote (staked settlement)', parseFloat)
     .option('--json', 'JSON output')
     .action(async (jobId: string, opts: any) => {
+      const hasYesNo = Boolean(opts.yes || opts.no);
+      const score = hasYesNo ? (opts.no ? -1 : 1) : (opts.weight ?? 1);
+
       const vote = await backend.vote(agentId, jobId, {
         submissionId: opts.submission,
         choiceKey: opts.choice,
         targetType: opts.submission ? 'SUBMISSION' : opts.choice ? 'CHOICE' : undefined,
         targetId: opts.submission ?? opts.choice,
-        weight: opts.weight ?? 1,
-        score: opts.weight ?? 1
+        weight: opts.weight ?? (hasYesNo ? 1 : undefined),
+        score,
+        stakeAmount: opts.stake
       });
       output(vote, opts.json);
     });
@@ -228,7 +296,7 @@ export function registerCli(program: any, backend: ConsensusToolsBackendCli, con
     .command('run')
     .description('Run consensus policy tests with generation script')
     .option('--agents <n>', 'Number of agent personalities', parseInt)
-    .option('--script <path>', 'Path to generation script', 'tests/runner/generation.ts')
+    .option('--script <path>', 'Path to generation script', '.consensus/generation.ts')
     .option('--openai-key <key>', 'OpenAI API key (or set OPENAI_API_KEY)')
     .option('--model <name>', 'Model name', 'gpt-5.2')
     .action(async (opts: any) => {
@@ -270,89 +338,14 @@ async function readStdinIfAny(): Promise<string | undefined> {
   return text || undefined;
 }
 
-type ConsensusConfig = {
-  activeBoard: 'local' | 'remote';
-  boards: {
-    local: { type: 'local'; root: string; jobsPath: string; ledgerPath: string };
-    remote: { type: 'remote'; url: string; boardId: string; auth: { type: 'apiKey'; apiKeyEnv: string } };
-  };
-  defaults: { policy: string; reward: number; stake: number; leaseSeconds: number };
-};
-
-const defaultConsensusConfig: ConsensusConfig = {
-  activeBoard: 'local',
-  boards: {
-    local: {
-      type: 'local',
-      root: '~/.openclaw/workplace/consensus-board',
-      jobsPath: 'jobs',
-      ledgerPath: 'ledger.json'
-    },
-    remote: {
-      type: 'remote',
-      url: 'https://api.consensus.tools',
-      boardId: 'board_replace_me',
-      auth: { type: 'apiKey', apiKeyEnv: 'CONSENSUS_API_KEY' }
-    }
-  },
-  defaults: {
-    policy: 'HIGHEST_CONFIDENCE_SINGLE',
-    reward: 8,
-    stake: 4,
-    leaseSeconds: 180
-  }
-};
-
-function configPath(): string {
-  const envPath = process.env.CONSENSUS_CONFIG;
-  if (envPath) return expandHome(envPath);
-  return path.join(os.homedir(), '.consensus', 'config.json');
-}
-
-function expandHome(input: string): string {
-  if (!input.startsWith('~')) return input;
-  return path.join(os.homedir(), input.slice(1));
+async function writeEnvFile(rootDir: string, force: boolean, env: Record<string, string>): Promise<void> {
+  const filePath = path.join(rootDir, '.consensus', '.env');
+  const lines = Object.entries(env).map(([k, v]) => `export ${k}=${v}`);
+  const content = [...lines, ''].join('\n');
+  await writeFile(filePath, content, force);
 }
 
-async function loadConfigFile(): Promise<ConsensusConfig> {
-  const filePath = configPath();
-  try {
-    const raw = await fs.readFile(filePath, 'utf8');
-    return JSON.parse(raw) as ConsensusConfig;
-  } catch {
-    return JSON.parse(JSON.stringify(defaultConsensusConfig)) as ConsensusConfig;
-  }
-}
-
-async function saveConfigFile(config: ConsensusConfig): Promise<void> {
-  const filePath = configPath();
-  await fs.mkdir(path.dirname(filePath), { recursive: true });
-  await fs.writeFile(filePath, JSON.stringify(config, null, 2), 'utf8');
-}
-
-function getConfigValue(config: any, key: string): any {
-  return key.split('.').reduce((acc, part) => (acc ? acc[part] : undefined), config);
-}
-
-function setConfigValue(config: any, key: string, value: any): void {
-  const parts = key.split('.');
-  let cur = config as any;
-  for (let i = 0; i < parts.length - 1; i += 1) {
-    if (!cur[parts[i]]) cur[parts[i]] = {};
-    cur = cur[parts[i]];
-  }
-  cur[parts[parts.length - 1]] = value;
-}
-
-function parseValue(input: string): any {
-  try {
-    return JSON.parse(input);
-  } catch {
-    return input;
-  }
-}
-
-async function writeInitTemplates(rootDir: string, force: boolean): Promise<void> {
+async function writeInitTemplates(rootDir: string, force: boolean, config: ConsensusCliConfig): Promise<void> {
   const baseDir = path.join(rootDir, '.consensus');
   const apiDir = path.join(baseDir, 'api');
 
@@ -360,8 +353,10 @@ async function writeInitTemplates(rootDir: string, force: boolean): Promise<void
 
   const files: Array<{ path: string; content: string; executable?: boolean }> = [
     { path: path.join(baseDir, 'README.md'), content: consensusReadme() },
-    { path: path.join(baseDir, 'env.example'), content: envExample() },
-    { path: path.join(baseDir, 'config.json'), content: JSON.stringify(defaultConsensusConfig, null, 2) },
+    { path: path.join(baseDir, 'env.example'), content: envExample(config) },
+    { path: path.join(baseDir, '.gitignore'), content: ['.env', ''].join('\n') },
+    { path: path.join(baseDir, 'config.json'), content: JSON.stringify(config, null, 2) },
+    { path: path.join(baseDir, 'generation.ts'), content: generationScriptTemplate() },
     { path: path.join(apiDir, 'common.sh'), content: commonSh(), executable: true },
     { path: path.join(apiDir, 'jobs_post.sh'), content: jobsPostSh(), executable: true },
     { path: path.join(apiDir, 'jobs_get.sh'), content: jobsGetSh(), executable: true },
@@ -397,7 +392,7 @@ function consensusReadme(): string {
   return [
     '# consensus.tools shell templates',
     '',
-    'This folder is generated by `consensus init`.',
+    'This folder is generated by `consensus-tools init` (or `openclaw consensus init`).',
     '',
     '## Quick start',
     '',
@@ -426,6 +421,13 @@ function consensusReadme(): string {
     'bash .consensus/api/jobs_post.sh "Title" "Desc" "Input"',
     '```',
     '',
+    'Try the CLI:',
+    '',
+    '```bash',
+    'consensus-tools jobs list',
+    'consensus-tools jobs post --title "Hello" --desc "World" --input "Test"',
+    '```',
+    '',
     'Notes',
     '',
     'Local mode writes to CONSENSUS_ROOT (defaults in env.example).',
@@ -437,24 +439,129 @@ function consensusReadme(): string {
   ].join('\n');
 }
 
-function envExample(): string {
+function envExample(config: ConsensusCliConfig): string {
+  const apiKeyEnv = config.boards.remote.auth.apiKeyEnv || 'CONSENSUS_API_KEY';
   return [
     '# Mode: "local" or "remote"',
-    'export CONSENSUS_MODE=local',
+    `export CONSENSUS_MODE=${config.activeBoard === 'remote' ? 'remote' : 'local'}`,
+    '',
+    '# Agent id (used by the CLI; optional)',
+    'export CONSENSUS_AGENT_ID="cli@your-machine"',
     '',
     '# Local board root (JSON filesystem board)',
-    'export CONSENSUS_ROOT="$HOME/.openclaw/workplace/consensus-board"',
+    `export CONSENSUS_ROOT="${config.boards.local.root}"`,
     '',
     '# Remote board settings',
-    'export CONSENSUS_URL="https://api.consensus.tools"',
-    'export CONSENSUS_BOARD_ID="board_replace_me"',
-    'export CONSENSUS_API_KEY="replace_me"',
+    `export CONSENSUS_URL="${config.boards.remote.url}"`,
+    `export CONSENSUS_BOARD_ID="${config.boards.remote.boardId}"`,
+    `export CONSENSUS_API_KEY_ENV="${apiKeyEnv}"`,
+    `export ${apiKeyEnv}="replace_me"`,
     '',
     '# Defaults (used by jobs_post.sh if not provided)',
-    'export CONSENSUS_DEFAULT_POLICY="HIGHEST_CONFIDENCE_SINGLE"',
-    'export CONSENSUS_DEFAULT_REWARD="8"',
-    'export CONSENSUS_DEFAULT_STAKE="4"',
-    'export CONSENSUS_DEFAULT_LEASE_SECONDS="180"',
+    `export CONSENSUS_DEFAULT_POLICY="${config.defaults.policy}"`,
+    `export CONSENSUS_DEFAULT_REWARD="${config.defaults.reward}"`,
+    `export CONSENSUS_DEFAULT_STAKE="${config.defaults.stake}"`,
+    `export CONSENSUS_DEFAULT_LEASE_SECONDS="${config.defaults.leaseSeconds}"`,
+    ''
+  ].join('\n');
+}
+
+function generationScriptTemplate(): string {
+  return [
+    '// Generated by consensus-tools init.',
+    '// Customize this file, then run:',
+    '//   consensus-tools tests run --agents 6 --script .consensus/generation.ts',
+    '',
+    '/**',
+    ' * This script is intentionally deterministic by default (mockResponse).',
+    ' * If you provide OPENAI_API_KEY (or --openai-key), the runner will call OpenAI.',
+    ' */',
+    'const script = {',
+    "  name: 'rx_negation_demo',",
+    '  task: {',
+    "    title: 'Negation test: prescription advancement',",
+    "    desc: 'Tell us why this insulin amount is NOT enough based on patient file, insurance reqs, and doctor notes.',",
+    '    input: [',
+    "      'We want to negation test prescription advancement for diabetic patients.',",
+    "      'Explain why the insulin amount is not enough based on:',",
+    "      '- patient file',",
+    "      '- insurance info/requirements',",
+    "      '- doctor notes',",
+    "      '',",
+    "      'Patient file: (paste here)',",
+    "      '',",
+    "      'Insurance info/requirements: (paste here)',",
+    "      '',",
+    "      'Doctor notes: (paste here)'",
+    '    ].join(\"\\n\")',
+    '  },',
+    "  expectedAnswer: 'INSUFFICIENT',",
+    '  personas: [],',
+    '  getPersonas(count) {',
+    '    const n = Math.max(3, Number(count || 3));',
+    '    const third = Math.ceil(n / 3);',
+    '',
+    '    const mk = (role, i, systemPrompt, personaRole) => ({',
+    "      id: `${role}_${i + 1}`,",
+    "      name: `${role.toUpperCase()} Agent ${i + 1}`,",
+    '      systemPrompt,',
+    '      role: personaRole',
+    '    });',
+    '',
+    '    const doctors = Array.from({ length: third }, (_, i) =>',
+    '      mk(',
+    "        'doctor',",
+    '        i,',
+    "        'You are a practicing clinician. Be precise. Use only the provided case context. Focus on medical necessity.',",
+    "        'accurate'",
+    '      )',
+    '    );',
+    '    const support = Array.from({ length: third }, (_, i) =>',
+    '      mk(',
+    "        'support',",
+    '        i,',
+    "        'You are customer support at a pharmacy benefits manager. Focus on process, eligibility, required docs, and next steps.',",
+    "        'accurate'",
+    '      )',
+    '    );',
+    '    const insurance = Array.from({ length: n - 2 * third }, (_, i) =>',
+    '      mk(',
+    "        'insurance',",
+    '        i,',
+    "        'You are an insurance reviewer. Apply coverage criteria and utilization management rules. Be skeptical and cite requirements.',",
+    // Make the last insurance persona contrarian to ensure policies see disagreement.
+    "        i === (n - 2 * third) - 1 ? 'contrarian' : 'accurate'",
+    '      )',
+    '    );',
+    '',
+    '    return [...doctors, ...support, ...insurance].slice(0, n);',
+    '  },',
+    '  buildPrompt(persona, task, expectedAnswer) {',
+    '    return {',
+    '      system: persona.systemPrompt,',
+    '      user: [',
+    "        'Return JSON: {\"answer\": string, \"confidence\": number, \"evidence\": string[]}',",
+    "        '',",
+    "        `TASK: ${task.title}`,",
+    "        task.desc ? `DESC: ${task.desc}` : '',",
+    "        '',",
+    "        `INPUT:\\n${task.input}`,",
+    "        '',",
+    "        `EXPECTED (for negation testing): ${expectedAnswer}`",
+    '      ].filter(Boolean).join(\"\\n\")',
+    '    };',
+    '  },',
+    '  mockResponse(persona, task, expectedAnswer) {',
+    '    const answer = persona.role === \"contrarian\" ? \"SUFFICIENT\" : expectedAnswer;',
+    '    return JSON.stringify({',
+    '      answer,',
+    '      confidence: persona.role === \"contrarian\" ? 0.2 : 0.9,',
+    '      evidence: [persona.name, task.title]',
+    '    });',
+    '  }',
+    '};',
+    '',
+    'export default script;',
     ''
   ].join('\n');
 }
@@ -482,6 +589,16 @@ function commonSh(): string {
     '  echo "$CONSENSUS_ROOT"',
     '}',
     '',
+    'local_state_file() {',
+    '  # Engine-parity local state file (JsonStorage)',
+    '  if [[ -n "${CONSENSUS_STATE_FILE:-}" ]]; then',
+    '    echo "${CONSENSUS_STATE_FILE}"',
+    '  else',
+    '    echo "$(local_root)/state.json"',
+    '  fi',
+    '}',
+    '',
+    '',
     'ensure_local_board() {',
     '  local root; root="$(local_root)"',
     '  mkdir -p "$root/jobs"',
@@ -509,9 +626,14 @@ function commonSh(): string {
     '  echo "${CONSENSUS_URL%/}/v1/boards/${CONSENSUS_BOARD_ID}"',
     '}',
     '',
+    'api_key_env() {',
+    '  echo "${CONSENSUS_API_KEY_ENV:-CONSENSUS_API_KEY}"',
+    '}',
+    '',
     'remote_auth_header() {',
-    '  require_env "CONSENSUS_API_KEY"',
-    '  echo "Authorization: Bearer ${CONSENSUS_API_KEY}"',
+    '  local name; name="$(api_key_env)"',
+    '  require_env "$name"',
+    '  echo "Authorization: Bearer ${!name}"',
     '}',
     '',
     'curl_json() {',
@@ -578,39 +700,35 @@ function jobsPostSh(): string {
     '',
     'POLICY="${CONSENSUS_DEFAULT_POLICY:-HIGHEST_CONFIDENCE_SINGLE}"',
     'REWARD="${CONSENSUS_DEFAULT_REWARD:-8}"',
-    'STAKE="${CONSENSUS_DEFAULT_STAKE:-4}"',
-    'LEASE_SECONDS="${CONSENSUS_DEFAULT_LEASE_SECONDS:-180}"',
+    'STAKE_REQUIRED="${CONSENSUS_DEFAULT_STAKE:-4}"',
+    'EXPIRES_SECONDS="${CONSENSUS_DEFAULT_EXPIRES_SECONDS:-86400}"',
     'MODE="$(mode)"',
     '',
     'if [[ "$MODE" == "local" ]]; then',
     '  ensure_local_board',
-    '  local id; id="$(rand_id "job")"',
-    '',
-    '  local title_json desc_json input_json',
-    '  title_json="$(json_escape "$TITLE")"',
-    '  desc_json="$(json_escape "${DESC:-}")"',
-    '  input_json="$(json_escape "${INPUT:-}")"',
-    '',
-    '  local job_json',
-    '  job_json="$(cat <<JSON',
-    '{',
-    '  "id": "$id",',
-    '  "title": $title_json,',
-    '  "desc": $desc_json,',
-    '  "input": $input_json,',
-    '  "mode": "SUBMISSION",',
-    '  "policyKey": "$POLICY",',
-    '  "rewardAmount": $REWARD,',
-    '  "stakeAmount": $STAKE,',
-    '  "leaseSeconds": $LEASE_SECONDS,',
-    '  "status": "OPEN",',
-    '  "createdAt": "$(now_iso)"',
-    '}',
-    'JSON',
-    ')"',
-    '  write_json_file "$(job_file "$id")" "$job_json"',
-    '  ensure_job_dir "$id"',
-    '  echo "$job_json"',
+    '  state_file="$(local_state_file)"',
+    '  node --import tsx --input-type=module - "$state_file" "$TITLE" "$DESC" "$INPUT" "$POLICY" "$REWARD" "$STAKE_REQUIRED" "$EXPIRES_SECONDS" <<\'NODE\'',
+    "import { JsonStorage } from '@consensus-tools/consensus-tools/src/storage/JsonStorage.ts';",
+    "import { LedgerEngine } from '@consensus-tools/consensus-tools/src/ledger/ledger.ts';",
+    "import { JobEngine } from '@consensus-tools/consensus-tools/src/jobs/engine.ts';",
+    "import { defaultConfig } from '@consensus-tools/consensus-tools/src/config.ts';",
+    'const [stateFile,title,desc,input,policy,reward,stake,expires]=process.argv.slice(2);',
+    'const storage=new JsonStorage(stateFile); await storage.init();',
+    'const ledger=new LedgerEngine(storage, defaultConfig);',
+    'const engine=new JobEngine(storage, ledger, defaultConfig);',
+    "const job = await engine.postJob('cli@local', {",
+    '  title,',
+    '  desc,',
+    '  inputRef: input,',
+    '  policyKey: policy,',
+    '  rewardAmount: Number(reward),',
+    '  reward: Number(reward),',
+    '  stakeRequired: Number(stake),',
+    '  stakeAmount: Number(stake),',
+    '  expiresSeconds: Number(expires)',
+    '});',
+    'console.log(JSON.stringify(job, null, 2));',
+    'NODE',
     '  exit 0',
     'fi',
     '',
@@ -624,14 +742,13 @@ function jobsPostSh(): string {
     '  "mode": "SUBMISSION",',
     '  "policyKey": "$POLICY",',
     '  "rewardAmount": $REWARD,',
-    '  "stakeAmount": $STAKE,',
-    '  "leaseSeconds": $LEASE_SECONDS',
+    '  "stakeAmount": $STAKE_REQUIRED,',
+    '  "leaseSeconds": ${CONSENSUS_DEFAULT_LEASE_SECONDS:-180}',
     '}',
     'JSON',
     ')"',
     'curl_json "POST" "$base/jobs" "$payload"',
     'echo',
-    ''
   ].join('\n');
 }
 
@@ -651,14 +768,26 @@ function jobsGetSh(): string {
     '',
     'if [[ "$MODE" == "local" ]]; then',
     '  ensure_local_board',
-    '  read_json_file "$(job_file "$JOB_ID")"',
+    '  state_file="$(local_state_file)"',
+    '  node --import tsx --input-type=module - "$state_file" "$JOB_ID" <<\'NODE\'',
+    "import { JsonStorage } from '@consensus-tools/consensus-tools/src/storage/JsonStorage.ts';",
+    "import { LedgerEngine } from '@consensus-tools/consensus-tools/src/ledger/ledger.ts';",
+    "import { JobEngine } from '@consensus-tools/consensus-tools/src/jobs/engine.ts';",
+    "import { defaultConfig } from '@consensus-tools/consensus-tools/src/config.ts';",
+    'const [stateFile, jobId] = process.argv.slice(2);',
+    'const storage=new JsonStorage(stateFile); await storage.init();',
+    'const ledger=new LedgerEngine(storage, defaultConfig);',
+    'const engine=new JobEngine(storage, ledger, defaultConfig);',
+    'const job = await engine.getJob(jobId);',
+    "if (!job) { console.error('Job not found'); process.exit(1); }",
+    'console.log(JSON.stringify(job, null, 2));',
+    'NODE',
     '  exit 0',
     'fi',
     '',
     'base="$(remote_base)"',
     'curl -sS "$base/jobs/$JOB_ID" -H "$(remote_auth_header)"',
     'echo',
-    ''
   ].join('\n');
 }
 
@@ -672,13 +801,23 @@ function jobsListSh(): string {
     '',
     'if [[ "$MODE" == "local" ]]; then',
     '  ensure_local_board',
-    '  root="$(local_root)"',
-    '  ls -1 "$root/jobs"/*.json 2>/dev/null | sed "s#.*/##" | sed "s#\\.json$##" || true',
+    '  state_file="$(local_state_file)"',
+    '  node --import tsx --input-type=module - "$state_file" <<\'NODE\'',
+    "import { JsonStorage } from '@consensus-tools/consensus-tools/src/storage/JsonStorage.ts';",
+    "import { LedgerEngine } from '@consensus-tools/consensus-tools/src/ledger/ledger.ts';",
+    "import { JobEngine } from '@consensus-tools/consensus-tools/src/jobs/engine.ts';",
+    "import { defaultConfig } from '@consensus-tools/consensus-tools/src/config.ts';",
+    'const [stateFile]=process.argv.slice(2);',
+    'const storage=new JsonStorage(stateFile); await storage.init();',
+    'const ledger=new LedgerEngine(storage, defaultConfig);',
+    'const engine=new JobEngine(storage, ledger, defaultConfig);',
+    'const jobs = await engine.listJobs({});',
+    'for (const j of jobs) console.log(j.id);',
+    'NODE',
     '  exit 0',
     'fi',
     '',
     'base="$(remote_base)"',
-    '# Optional: pass query string as $1, e.g. "status=OPEN&mode=SUBMISSION"',
     'QS="${1:-}"',
     'url="$base/jobs"',
     'if [[ -n "$QS" ]]; then',
@@ -686,7 +825,6 @@ function jobsListSh(): string {
     'fi',
     'curl -sS "$url" -H "$(remote_auth_header)"',
     'echo',
-    ''
   ].join('\n');
 }
 
@@ -699,10 +837,10 @@ function submissionsCreateSh(): string {
     'JOB_ID="${1:-}"',
     'ARTIFACT_JSON="${2:-}"',
     'SUMMARY="${3:-}"',
+    'CONFIDENCE="${4:-0.5}"',
     '',
     'if [[ -z "$JOB_ID" || -z "$ARTIFACT_JSON" ]]; then',
-    '  echo "Usage: submissions_create.sh <jobId> <artifact_json> [summary]" >&2',
-    '  echo "Example: submissions_create.sh job_... {\\\"toxic\\\":false,\\\"confidence\\\":0.98,\\\"brief_reason\\\":\\\"...\\\"}" >&2',
+    '  echo "Usage: submissions_create.sh <jobId> <artifact_json> [summary] [confidence]" >&2',
     '  exit 2',
     'fi',
     '',
@@ -710,23 +848,20 @@ function submissionsCreateSh(): string {
     '',
     'if [[ "$MODE" == "local" ]]; then',
     '  ensure_local_board',
-    '  ensure_job_dir "$JOB_ID"',
-    '',
-    '  sid="$(rand_id "sub")"',
-    '  summary_json="$(json_escape "${SUMMARY:-}")"',
-    '  sub_json="$(cat <<JSON',
-    '{',
-    '  "id": "$sid",',
-    '  "jobId": "$JOB_ID",',
-    '  "artifact": $ARTIFACT_JSON,',
-    '  "summary": $summary_json,',
-    '  "createdAt": "$(now_iso)",',
-    '  "status": "VALID"',
-    '}',
-    'JSON',
-    ')"',
-    '  write_json_file "$(job_dir "$JOB_ID")/submissions/${sid}.json" "$sub_json"',
-    '  echo "$sub_json"',
+    '  state_file="$(local_state_file)"',
+    '  node --import tsx --input-type=module - "$state_file" "$JOB_ID" "$ARTIFACT_JSON" "${SUMMARY:-}" "$CONFIDENCE" <<\'NODE\'',
+    "import { JsonStorage } from '@consensus-tools/consensus-tools/src/storage/JsonStorage.ts';",
+    "import { LedgerEngine } from '@consensus-tools/consensus-tools/src/ledger/ledger.ts';",
+    "import { JobEngine } from '@consensus-tools/consensus-tools/src/jobs/engine.ts';",
+    "import { defaultConfig } from '@consensus-tools/consensus-tools/src/config.ts';",
+    'const [stateFile, jobId, artifactJson, summary, conf] = process.argv.slice(2);',
+    'const artifacts = JSON.parse(artifactJson);',
+    'const storage=new JsonStorage(stateFile); await storage.init();',
+    'const ledger=new LedgerEngine(storage, defaultConfig);',
+    'const engine=new JobEngine(storage, ledger, defaultConfig);',
+    "const sub = await engine.submitJob('cli@local', jobId, { summary: summary || '', artifacts, confidence: Number(conf) });",
+    'console.log(JSON.stringify(sub, null, 2));',
+    'NODE',
     '  exit 0',
     'fi',
     '',
@@ -740,7 +875,6 @@ function submissionsCreateSh(): string {
     ')"',
     'curl_json "POST" "$base/jobs/$JOB_ID/submissions" "$payload"',
     'echo',
-    ''
   ].join('\n');
 }
 
@@ -760,15 +894,25 @@ function submissionsListSh(): string {
     '',
     'if [[ "$MODE" == "local" ]]; then',
     '  ensure_local_board',
-    '  ensure_job_dir "$JOB_ID"',
-    '  ls -1 "$(job_dir "$JOB_ID")/submissions"/*.json 2>/dev/null | xargs -I{} cat "{}" || true',
+    '  state_file="$(local_state_file)"',
+    '  node --import tsx --input-type=module - "$state_file" "$JOB_ID" <<\'NODE\'',
+    "import { JsonStorage } from '@consensus-tools/consensus-tools/src/storage/JsonStorage.ts';",
+    "import { LedgerEngine } from '@consensus-tools/consensus-tools/src/ledger/ledger.ts';",
+    "import { JobEngine } from '@consensus-tools/consensus-tools/src/jobs/engine.ts';",
+    "import { defaultConfig } from '@consensus-tools/consensus-tools/src/config.ts';",
+    'const [stateFile, jobId] = process.argv.slice(2);',
+    'const storage=new JsonStorage(stateFile); await storage.init();',
+    'const ledger=new LedgerEngine(storage, defaultConfig);',
+    'const engine=new JobEngine(storage, ledger, defaultConfig);',
+    'const list = await engine.listSubmissions(jobId);',
+    'for (const s of list) console.log(JSON.stringify(s, null, 2));',
+    'NODE',
     '  exit 0',
     'fi',
     '',
     'base="$(remote_base)"',
     'curl -sS "$base/jobs/$JOB_ID/submissions" -H "$(remote_auth_header)"',
     'echo',
-    ''
   ].join('\n');
 }
 
@@ -779,14 +923,27 @@ function votesCastSh(): string {
     'source "$(dirname "$0")/common.sh"',
     '',
     'JOB_ID="${1:-}"',
-    'TARGET_TYPE="${2:-}"   # SUBMISSION or CHOICE',
-    'TARGET_ID="${3:-}"     # submission id or choice key',
-    'WEIGHT="${4:-1}"',
+    'shift || true',
+    'TARGET_TYPE=""',
+    'TARGET_ID=""',
+    'WEIGHT="1"',
+    '',
+    'if [[ "${1:-}" == "SUBMISSION" || "${1:-}" == "CHOICE" ]]; then',
+    '  TARGET_TYPE="$1"; TARGET_ID="${2:-}"; WEIGHT="${3:-1}"',
+    'else',
+    '  while [[ $# -gt 0 ]]; do',
+    '    case "$1" in',
+    '      --submission) TARGET_TYPE="SUBMISSION"; TARGET_ID="${2:-}"; shift 2 ;;',
+    '      --choice)     TARGET_TYPE="CHOICE"; TARGET_ID="${2:-}"; shift 2 ;;',
+    '      --weight)     WEIGHT="${2:-1}"; shift 2 ;;',
+    '      *) echo "Unknown arg: $1" >&2; exit 2 ;;',
+    '    esac',
+    '  done',
+    'fi',
     '',
     'if [[ -z "$JOB_ID" || -z "$TARGET_TYPE" || -z "$TARGET_ID" ]]; then',
-    '  echo "Usage: votes_cast.sh <jobId> <targetType:SUBMISSION|CHOICE> <targetId> [weight]" >&2',
-    '  echo "Example: votes_cast.sh job_... SUBMISSION sub_... 1" >&2',
-    '  echo "Example: votes_cast.sh job_... CHOICE TOXIC_FALSE 1" >&2',
+    '  echo "Usage: votes_cast.sh <jobId> SUBMISSION <submissionId> [weight]" >&2',
+    '  echo "   or: votes_cast.sh <jobId> --submission <id> [--weight <n>]" >&2',
     '  exit 2',
     'fi',
     '',
@@ -794,22 +951,19 @@ function votesCastSh(): string {
     '',
     'if [[ "$MODE" == "local" ]]; then',
     '  ensure_local_board',
-    '  ensure_job_dir "$JOB_ID"',
-    '',
-    '  vid="$(rand_id "vote")"',
-    '  vote_json="$(cat <<JSON',
-    '{',
-    '  "id": "$vid",',
-    '  "jobId": "$JOB_ID",',
-    '  "targetType": "$TARGET_TYPE",',
-    '  "targetId": "$TARGET_ID",',
-    '  "weight": $WEIGHT,',
-    '  "createdAt": "$(now_iso)"',
-    '}',
-    'JSON',
-    ')"',
-    '  write_json_file "$(job_dir "$JOB_ID")/votes/${vid}.json" "$vote_json"',
-    '  echo "$vote_json"',
+    '  state_file="$(local_state_file)"',
+    '  node --import tsx --input-type=module - "$state_file" "$JOB_ID" "$TARGET_TYPE" "$TARGET_ID" "$WEIGHT" <<\'NODE\'',
+    "import { JsonStorage } from '@consensus-tools/consensus-tools/src/storage/JsonStorage.ts';",
+    "import { LedgerEngine } from '@consensus-tools/consensus-tools/src/ledger/ledger.ts';",
+    "import { JobEngine } from '@consensus-tools/consensus-tools/src/jobs/engine.ts';",
+    "import { defaultConfig } from '@consensus-tools/consensus-tools/src/config.ts';",
+    'const [stateFile, jobId, targetType, targetId, weight] = process.argv.slice(2);',
+    'const storage=new JsonStorage(stateFile); await storage.init();',
+    'const ledger=new LedgerEngine(storage, defaultConfig);',
+    'const engine=new JobEngine(storage, ledger, defaultConfig);',
+    "const vote = await engine.vote('cli@local', jobId, { targetType, targetId, submissionId: targetType==='SUBMISSION'?targetId:undefined, choiceKey: targetType==='CHOICE'?targetId:undefined, weight: Number(weight), score: Number(weight) });",
+    'console.log(JSON.stringify(vote, null, 2));',
+    'NODE',
     '  exit 0',
     'fi',
     '',
@@ -824,7 +978,6 @@ function votesCastSh(): string {
     ')"',
     'curl_json "POST" "$base/jobs/$JOB_ID/votes" "$payload"',
     'echo',
-    ''
   ].join('\n');
 }
 
@@ -844,15 +997,25 @@ function votesListSh(): string {
     '',
     'if [[ "$MODE" == "local" ]]; then',
     '  ensure_local_board',
-    '  ensure_job_dir "$JOB_ID"',
-    '  ls -1 "$(job_dir "$JOB_ID")/votes"/*.json 2>/dev/null | xargs -I{} cat "{}" || true',
+    '  state_file="$(local_state_file)"',
+    '  node --import tsx --input-type=module - "$state_file" "$JOB_ID" <<\'NODE\'',
+    "import { JsonStorage } from '@consensus-tools/consensus-tools/src/storage/JsonStorage.ts';",
+    "import { LedgerEngine } from '@consensus-tools/consensus-tools/src/ledger/ledger.ts';",
+    "import { JobEngine } from '@consensus-tools/consensus-tools/src/jobs/engine.ts';",
+    "import { defaultConfig } from '@consensus-tools/consensus-tools/src/config.ts';",
+    'const [stateFile, jobId] = process.argv.slice(2);',
+    'const storage=new JsonStorage(stateFile); await storage.init();',
+    'const ledger=new LedgerEngine(storage, defaultConfig);',
+    'const engine=new JobEngine(storage, ledger, defaultConfig);',
+    'const list = await engine.listVotes(jobId);',
+    'for (const v of list) console.log(JSON.stringify(v, null, 2));',
+    'NODE',
     '  exit 0',
     'fi',
     '',
     'base="$(remote_base)"',
     'curl -sS "$base/jobs/$JOB_ID/votes" -H "$(remote_auth_header)"',
     'echo',
-    ''
   ].join('\n');
 }
 
@@ -863,8 +1026,20 @@ function resolveSh(): string {
     'source "$(dirname "$0")/common.sh"',
     '',
     'JOB_ID="${1:-}"',
+    'shift || true',
+    'MANUAL_WINNER=""',
+    'MANUAL_SUB=""',
+    '',
+    'while [[ $# -gt 0 ]]; do',
+    '  case "$1" in',
+    '    --winner) MANUAL_WINNER="${2:-}"; shift 2 ;;',
+    '    --submission) MANUAL_SUB="${2:-}"; shift 2 ;;',
+    '    *) echo "Unknown arg: $1" >&2; exit 2 ;;',
+    '  esac',
+    'done',
+    '',
     'if [[ -z "$JOB_ID" ]]; then',
-    '  echo "Usage: resolve.sh <jobId>" >&2',
+    '  echo "Usage: resolve.sh <jobId> [--winner <agentId>] [--submission <submissionId>]" >&2',
     '  exit 2',
     'fi',
     '',
@@ -872,56 +1047,29 @@ function resolveSh(): string {
     '',
     'if [[ "$MODE" == "local" ]]; then',
     '  ensure_local_board',
-    '  ensure_job_dir "$JOB_ID"',
-    '',
-    '  # Local resolution policy: HIGHEST_CONFIDENCE_SINGLE for SUBMISSION jobs.',
-    '  # We pick the submission with max artifact.confidence if present.',
-    '  # If missing, we fall back to the most recent submission.',
-    '',
-    '  dir="$(job_dir "$JOB_ID")/submissions"',
-    '  if ! ls "$dir"/*.json >/dev/null 2>&1; then',
-    '    echo "No submissions found for $JOB_ID" >&2',
-    '    exit 1',
-    '  fi',
-    '',
-    '  python3 - <<\'PY\' "$JOB_ID" "$dir" | tee "$(job_dir "$JOB_ID")/result.json"',
-    'import json,glob,sys,os',
-    'job_id=sys.argv[1]; d=sys.argv[2]',
-    'subs=[]',
-    'for p in glob.glob(os.path.join(d,"*.json")):',
-    '    with open(p,"r") as f:',
-    '        s=json.load(f)',
-    '    conf=None',
-    '    try:',
-    '        conf=float(s.get("artifact",{}).get("confidence"))',
-    '    except Exception:',
-    '        conf=None',
-    '    subs.append((conf,s.get("createdAt",""),s,p))',
-    '# sort: confidence desc (None last), then createdAt desc',
-    'def key(t):',
-    '    conf,created,_,_ = t',
-    '    return (conf is not None, conf if conf is not None else -1.0, created)',
-    'subs_sorted=sorted(subs, key=key, reverse=True)',
-    'conf,created,s,p=subs_sorted[0]',
-    'result={',
-    '  "jobId": job_id,',
-    '  "mode": "SUBMISSION",',
-    '  "selectedSubmissionId": s.get("id"),',
-    '  "selectedSubmissionPath": p,',
-    '  "resolvedAt": __import__("datetime").datetime.utcnow().isoformat()+"Z",',
-    '  "artifact": s.get("artifact"),',
-    '  "summary": s.get("summary","")',
-    '}',
-    'print(json.dumps(result, indent=2))',
-    'PY',
-    '',
+    '  state_file="$(local_state_file)"',
+    '  node --import tsx --input-type=module - "$state_file" "$JOB_ID" "$MANUAL_WINNER" "$MANUAL_SUB" <<\'NODE\'',
+    "import { JsonStorage } from '@consensus-tools/consensus-tools/src/storage/JsonStorage.ts';",
+    "import { LedgerEngine } from '@consensus-tools/consensus-tools/src/ledger/ledger.ts';",
+    "import { JobEngine } from '@consensus-tools/consensus-tools/src/jobs/engine.ts';",
+    "import { defaultConfig } from '@consensus-tools/consensus-tools/src/config.ts';",
+    'const [stateFile, jobId, winner, subId] = process.argv.slice(2);',
+    'const storage=new JsonStorage(stateFile); await storage.init();',
+    'const ledger=new LedgerEngine(storage, defaultConfig);',
+    'const engine=new JobEngine(storage, ledger, defaultConfig);',
+    'const input:any = {};',
+    'if (winner) input.manualWinners = [winner];',
+    'if (subId) input.manualSubmissionId = subId;',
+    "const actor = winner || 'cli@local';",
+    'const res = await engine.resolveJob(actor, jobId, input);',
+    'console.log(JSON.stringify(res, null, 2));',
+    'NODE',
     '  exit 0',
     'fi',
     '',
     'base="$(remote_base)"',
     'curl -sS -X POST "$base/jobs/$JOB_ID/resolve" -H "$(remote_auth_header)"',
     'echo',
-    ''
   ].join('\n');
 }
 
@@ -941,14 +1089,24 @@ function resultGetSh(): string {
     '',
     'if [[ "$MODE" == "local" ]]; then',
     '  ensure_local_board',
-    '  path="$(job_dir "$JOB_ID")/result.json"',
-    '  read_json_file "$path"',
+    '  state_file="$(local_state_file)"',
+    '  node --import tsx --input-type=module - "$state_file" "$JOB_ID" <<\'NODE\'',
+    "import { JsonStorage } from '@consensus-tools/consensus-tools/src/storage/JsonStorage.ts';",
+    "import { LedgerEngine } from '@consensus-tools/consensus-tools/src/ledger/ledger.ts';",
+    "import { JobEngine } from '@consensus-tools/consensus-tools/src/jobs/engine.ts';",
+    "import { defaultConfig } from '@consensus-tools/consensus-tools/src/config.ts';",
+    'const [stateFile, jobId] = process.argv.slice(2);',
+    'const storage=new JsonStorage(stateFile); await storage.init();',
+    'const ledger=new LedgerEngine(storage, defaultConfig);',
+    'const engine=new JobEngine(storage, ledger, defaultConfig);',
+    'const status = await engine.getStatus(jobId);',
+    'console.log(JSON.stringify(status.resolution ?? null, null, 2));',
+    'NODE',
     '  exit 0',
     'fi',
     '',
     'base="$(remote_base)"',
     'curl -sS "$base/jobs/$JOB_ID/result" -H "$(remote_auth_header)"',
     'echo',
-    ''
   ].join('\n');
 }