@danceiny/gotry 0.0.1-rc.10

package/dist/scripts/state-cli-tests.js

@@ -0,0 +1,136 @@
+import { existsSync, mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { spawnSync } from 'node:child_process';
+let pass = 0;
+let fail = 0;
+function assert(cond, msg) {
+    if (cond) {
+        pass++;
+        console.log(`  ok - ${msg}`);
+    } else {
+        fail++;
+        console.error(`  FAIL - ${msg}`);
+    }
+}
+function cli(args) {
+    return spawnSync('npx', [
+        'tsx',
+        'scripts/state-cli.ts',
+        ...args
+    ], {
+        encoding: 'utf-8'
+    });
+}
+const root = mkdtempSync(join(tmpdir(), 'gotry-cli-'));
+const dir = join(root, 'gotry-state');
+mkdirSync(dir, {
+    recursive: true
+});
+writeFileSync(join(dir, 'motivation-profile.json'), JSON.stringify({
+    weights: {
+        curiosity: 0.6
+    },
+    evidence: [
+        '原话A'
+    ],
+    hard: {}
+}));
+writeFileSync(join(dir, 'wish-pool.json'), JSON.stringify([
+    {
+        wish_id: 'wLEGACY1',
+        name: '京都',
+        conditions: {
+            days: 7
+        },
+        added_at: '2026-08-01T00:00:00Z'
+    }
+]));
+const mig = cli([
+    'migrate',
+    root
+]);
+assert(mig.status === 0 && /账本就绪/.test(mig.stdout ?? ''), `migrate exit 0 且报告就绪(实际 ${mig.status}:${(mig.stderr ?? '').slice(0, 200)})`);
+assert(existsSync(join(dir, 'gotry-state.db')), 'migrate 后账本文件存在');
+assert(existsSync(join(dir, 'pre-ledger-backup', 'wish-pool.json')), 'migrate 前自动快照(pre-ledger-backup/)');
+const stats = cli([
+    'stats',
+    root
+]);
+assert(stats.status === 0 && /wishes=1/.test(stats.stdout ?? '') && /events=\d+/.test(stats.stdout ?? ''), `stats 计数正确(${(stats.stdout ?? '').trim()})`);
+const log = cli([
+    'log',
+    root,
+    '--limit',
+    '3'
+]);
+assert(log.status === 0 && /\bwish\.imported\b|\bmotivation\.imported\b/.test(log.stdout ?? ''), `log 呈现账本事件(append-only 审计面)`);
+rmSync(join(dir, 'wish-pool.json'));
+const exp = cli([
+    'export',
+    root
+]);
+assert(exp.status === 0 && existsSync(join(dir, 'wish-pool.json')), 'export 重建旧文件名视图(红线 6:可见可导出)');
+const exported = JSON.parse(readFileSync(join(dir, 'wish-pool.json'), 'utf-8'));
+assert(exported[0]?.wish_id === 'wLEGACY1', 'export 视图内容与账本一致');
+const fg = cli([
+    'forget',
+    root,
+    'wish',
+    'wLEGACY1'
+]);
+assert(fg.status === 0 && /物理硬删/.test(fg.stdout ?? ''), 'forget 执行成功');
+const stats2 = cli([
+    'stats',
+    root
+]);
+assert(/wishes=0/.test(stats2.stdout ?? ''), 'forget 后愿望池归零(红线 6「可删除」,D5 物理硬删)');
+const log2 = cli([
+    'log',
+    root,
+    '--limit',
+    '3'
+]);
+assert(/forget\.executed/.test(log2.stdout ?? ''), 'forget 留审计一行(删除本身可溯源)');
+const root2 = mkdtempSync(join(tmpdir(), 'gotry-cli2-'));
+const req = cli([
+    'pw-request',
+    root2,
+    'booking:e2e-1',
+    'flight-order-confirm',
+    '{"flight":"MU123"}'
+]);
+assert(req.status === 0 && /"created":true/.test(req.stdout ?? ''), 'pw-request 登记成功(L2:只登记不执行)');
+const dup = cli([
+    'pw-request',
+    root2,
+    'booking:e2e-1',
+    'flight-order-confirm',
+    '{"flight":"MU123"}'
+]);
+assert(/"created":false/.test(dup.stdout ?? ''), 'pw-request 幂等键去重');
+const conf = cli([
+    'pw-confirm',
+    root2,
+    'booking:e2e-1',
+    'PNR-XYZ'
+]);
+assert(conf.status === 0 && /"ok":true/.test(conf.stdout ?? ''), 'pw-confirm 携 receipt 确认(L3)');
+const list = cli([
+    'pw-list',
+    root2
+]);
+assert(/confirmed/.test(list.stdout ?? '') && /PNR-XYZ/.test(list.stdout ?? ''), 'pw-list 呈现终态与 receipt');
+rmSync(root, {
+    recursive: true,
+    force: true
+});
+rmSync(root2, {
+    recursive: true,
+    force: true
+});
+console.log(`\nSTATE-CLI TESTS: ${pass} ok, ${fail} fail`);
+if (fail > 0) process.exit(1);
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/state-cli-tests.ts

package/dist/scripts/state-cli.js

@@ -0,0 +1,248 @@
+import { mkdirSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { ensureLedger, openLedgerIfExists } from '../src/state-ledger.js';
+import { collectDeepPlanning, makeJournaledSolvePort, settleAsyncTicket } from '../src/loop.js';
+import { solveUnified } from '../src/unified.js';
+const [cmd, ...rest] = process.argv.slice(2);
+function rootOf(args) {
+    const i = args.indexOf('--state-root');
+    if (i >= 0 && args[i + 1]) return args[i + 1];
+    const first = args.find((a)=>!a.startsWith('--') && !/^[\d]+$/.test(a));
+    return first ?? '.';
+}
+function tenantOf(args) {
+    const i = args.indexOf('--tenant');
+    return i >= 0 && args[i + 1] ? args[i + 1] : 'local';
+}
+function arg(name, fallback) {
+    const i = process.argv.indexOf(name);
+    return i >= 0 ? process.argv[i + 1] : fallback;
+}
+function atomicWrite(path, text) {
+    const tmp = `${path}.tmp`;
+    writeFileSync(tmp, text, 'utf-8');
+    renameSync(tmp, path);
+}
+const HELP = '用法见文件头注释(npx tsx scripts/state-cli.ts <cmd> [root] ...)';
+switch(cmd){
+    case 'migrate':
+        {
+            const root = rootOf(rest);
+            const tenant = tenantOf(rest);
+            const before = openLedgerIfExists(root, tenant)?.countEvents() ?? 0;
+            const ledger = ensureLedger(root, tenant);
+            const backupDir = join(root, 'gotry-state', 'pre-ledger-backup');
+            console.log(`账本就绪:${ledger.dbPath}(events ${before} → ${ledger.countEvents()};存在旧文件时已快照至 ${backupDir}/)`);
+            break;
+        }
+    case 'export':
+        {
+            const root = rootOf(rest);
+            const tenant = tenantOf(rest);
+            const ledger = ensureLedger(root, tenant);
+            const dir = join(root === '.' ? process.cwd() : root, 'gotry-state');
+            mkdirSync(dir, {
+                recursive: true
+            });
+            const motivation = ledger.readMotivation();
+            if (motivation) atomicWrite(join(dir, 'motivation-profile.json'), JSON.stringify(motivation, null, 2));
+            const pool = ledger.readWishPool();
+            if (pool.length) atomicWrite(join(dir, 'wish-pool.json'), JSON.stringify(pool, null, 2));
+            const companions = ledger.readCompanions();
+            if (companions.length) atomicWrite(join(dir, 'companions.json'), JSON.stringify(companions, null, 2));
+            const utility = ledger.readUtilityEvents();
+            if (utility.length) atomicWrite(join(dir, 'memory-utility.jsonl'), utility.map((e)=>JSON.stringify(e)).join('\n') + '\n');
+            const trips = ledger.readTrips();
+            if (trips.length) atomicWrite(join(dir, 'trips.jsonl'), trips.map((e)=>JSON.stringify(e)).join('\n') + '\n');
+            console.log(`视图已导出(单向,DB→文件;红线 6):${dir}/`);
+            break;
+        }
+    case 'log':
+        {
+            const root = rootOf(rest);
+            const tenant = tenantOf(rest);
+            const limit = Number(arg('--limit', '20'));
+            const ledger = openLedgerIfExists(root, tenant);
+            if (!ledger) {
+                console.log('(无账本——未迁移 root,旧文件形态)');
+                break;
+            }
+            for (const e of ledger.readEvents(undefined, limit)){
+                console.log(`${String(e.seq).padStart(5)}  ${e.ts}  ${e.actor.padEnd(28)} ${e.kind.padEnd(24)} ${e.subject_id}${e.idem_key ? `  #${e.idem_key}` : ''}`);
+            }
+            break;
+        }
+    case 'stats':
+        {
+            const root = rootOf(rest);
+            const tenant = tenantOf(rest);
+            const ledger = openLedgerIfExists(root, tenant);
+            if (!ledger) {
+                console.log('(无账本——未迁移 root)');
+                break;
+            }
+            console.log(`events=${ledger.countEvents()} wishes=${ledger.readWishPool().length} companions=${ledger.readCompanions().length} trips=${ledger.readTrips().length} utility=${ledger.readUtilityEvents().length} pendingRuns=${ledger.pendingWorkflowRuns().length} pendingWrites=${ledger.listPendingWrites().length}`);
+            break;
+        }
+    case 'rebuild':
+    case 'rewind':
+        {
+            const root = rootOf(rest);
+            const tenant = tenantOf(rest);
+            const ledger = openLedgerIfExists(root, tenant);
+            if (!ledger) {
+                console.error('无账本');
+                process.exit(1);
+            }
+            const toSeqRaw = rest.find((a)=>/^\d+$/.test(a));
+            const r = ledger.rebuildProjections(toSeqRaw ? Number(toSeqRaw) : undefined);
+            console.log(`fold 重建完成${toSeqRaw ? `(至 seq ${toSeqRaw};rebuild 无参即回最新)` : '(全量)'}:重放 ${r.events} 事件 → 愿望 ${r.wishes} / 同行人 ${r.companions}`);
+            break;
+        }
+    case 'forget':
+        {
+            const root = rootOf(rest);
+            const tenant = tenantOf(rest);
+            const ledger = openLedgerIfExists(root, tenant);
+            if (!ledger) {
+                console.error('无账本');
+                process.exit(1);
+            }
+            const subject = rest.find((a)=>!a.startsWith('--') && a !== root);
+            const id = rest[rest.indexOf(subject) + 1];
+            if (!subject || id === undefined) {
+                console.error(HELP);
+                process.exit(1);
+            }
+            const map = {
+                wish: {
+                    kinds: [
+                        'wish.imported',
+                        'wish.added',
+                        'wish.updated',
+                        'memory_utility.event'
+                    ],
+                    subjectId: id
+                },
+                companion: {
+                    kinds: [
+                        'companion.imported',
+                        'companion.saved'
+                    ],
+                    subjectId: id
+                },
+                motivation: {
+                    kinds: [
+                        'motivation.imported',
+                        'motivation.patch'
+                    ],
+                    subjectId: 'motivation'
+                }
+            };
+            const spec = map[subject];
+            if (!spec) {
+                console.error(`未知主体 ${subject}(wish|companion|motivation)`);
+                process.exit(1);
+            }
+            const r = ledger.forgetSubject([
+                spec
+            ]);
+            console.log(`已物理硬删 ${r.deleted} 条事件并重建投影(审计一行留痕;红线 6「可删除」)`);
+            break;
+        }
+    case 'tick':
+        {
+            const root = rootOf(rest);
+            const tenant = tenantOf(rest);
+            const ledger = openLedgerIfExists(root, tenant);
+            if (!ledger) {
+                console.log('(无账本,无待办)');
+                break;
+            }
+            const pending = ledger.pendingWorkflowRuns();
+            if (pending.length === 0) {
+                console.log('(无 pending 工单)');
+                break;
+            }
+            for (const p of pending){
+                const run = ledger.getWorkflowRun(p.id);
+                const ticket = JSON.parse(run.ticket_json);
+                const state = JSON.parse(run.state_json);
+                const solve = makeJournaledSolvePort(ledger, p.id, solveUnified);
+                const { reply } = await collectDeepPlanning(state, ticket, solve);
+                await settleAsyncTicket(p.id, reply, root);
+                console.log(`工单 ${p.id} 已回收(durable 恢复语义:done 步骤零重执行)`);
+            }
+            break;
+        }
+    case 'whatif':
+        {
+            const root = rootOf(rest);
+            const tenant = tenantOf(rest);
+            const ledger = openLedgerIfExists(root, tenant);
+            if (!ledger) {
+                console.error('无账本');
+                process.exit(1);
+            }
+            const dest = rest.find((a)=>a !== root && !a.startsWith('--'));
+            if (!dest) {
+                console.error(HELP);
+                process.exit(1);
+            }
+            mkdirSync(dirname(dest), {
+                recursive: true
+            });
+            ledger.forkWhatIf(dest);
+            console.log(`what-if 分叉已生成:${dest}(预演在副本,正本零改动)`);
+            break;
+        }
+    case 'pw-list':
+        {
+            const root = rootOf(rest);
+            const tenant = tenantOf(rest);
+            const ledger = openLedgerIfExists(root, tenant);
+            if (!ledger) {
+                console.log('(无账本)');
+                break;
+            }
+            for (const w of ledger.listPendingWrites()){
+                console.log(`${w.status.padEnd(12)} ${w.idem_key}  seam=${w.seam}${w.receipt ? `  receipt=${w.receipt}` : ''}`);
+            }
+            break;
+        }
+    case 'pw-request':
+    case 'pw-confirm':
+    case 'pw-compensate':
+        {
+            const root = rootOf(rest);
+            const tenant = tenantOf(rest);
+            const ledger = ensureLedger(root, tenant);
+            const positional = rest.filter((a)=>a !== root && !a.startsWith('--'));
+            if (positional.length < (cmd === 'pw-request' ? 3 : 2)) {
+                console.error(HELP);
+                process.exit(1);
+            }
+            if (cmd === 'pw-request') {
+                const r = ledger.requestPendingWrite({
+                    idemKey: positional[0],
+                    seam: positional[1],
+                    payload: JSON.parse(positional[2])
+                });
+                console.log(`登记:${JSON.stringify(r)}(L2:只登记不执行)`);
+            } else if (cmd === 'pw-confirm') {
+                const r = ledger.confirmPendingWrite(positional[0], positional[1]);
+                console.log(`确认:${JSON.stringify(r)}`);
+            } else {
+                const r = ledger.compensatePendingWrite(positional[0], positional[1]);
+                console.log(`补偿:${JSON.stringify(r)}`);
+            }
+            break;
+        }
+    default:
+        console.error(cmd ? `未知命令 ${cmd}` : HELP);
+        console.error(HELP);
+        process.exit(1);
+}
+
+
+//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/state-cli.ts