@danceiny/gotry 0.0.1-rc.21 → 0.0.1-rc.24

package/dist/scripts/anything-tests.js

@@ -1,5 +1,19 @@
+/**
+ * Anything 能力层测试(模拟 hbcli):
+ *  1. 真实候选:fake hbcli 按 hotel-be SearchItem wire 形状返 JSON — verdict hit + hits
+ *     (i18n name zh 优先 / region.centerLat / hotel.latlngCoordinator / star / id 逐字段对齐)
+ *  2. 旗标回归:--json 在子命令前(cli.ts 全局旗标预扫描只认子命令前位置)+
+ *     --content-type / parentDestinationId → --destination-id 映射
+ *  3. 空候选:fake hbcli 返 empty JSON — verdict miss
+ *  4. exit≠0:fake hbcli 返 stderr+退出 — verdict error + 不抛错
+ *  5. 旧 CLI「unknown command」:error 带升级指引(issue #195:裸 unknown command 读起来像工具坏了)
+ *  6. 超时:fake hbcli hang — AbortError → verdict error + 不抛错
+ *  7. 关键词为空:不调 hbcli — verdict error
+ *
+ * 运行: cd ts && npx tsx scripts/anything-tests.ts
+ */
 import assert from 'node:assert/strict';
-import { mkdtemp, rm, writeFile, chmod } from 'node:fs/promises';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { anythingSearch } from '../capabilities/anything.js';
@@ -8,6 +22,8 @@ try {
     async function fakeBin(name, behaviour) {
         const p = join(tmp, name);
         if (behaviour === 'ok') {
+            // hotel-be SearchItem 真实 wire 形状(2026-09-07 对齐源码):i18n name 对象、
+            // region.coordinates.centerLat/centerLng、hotel.latlngCoordinator.google、star、matchScore
             await writeFile(p, `#!/bin/sh
 cat <<'JSON'
 {"candidates":[
@@ -16,52 +32,49 @@ cat <<'JSON'
   {"type":"place","matchScore":90,"region":{"id":"r1","name":{"zh":"洱海"}},"place":{"latlngCoordinator":{"google":{"lat":25.74,"lng":100.25}}}}
 ]}
 JSON
-`, {
-                mode: 0o755
-            });
-        } else if (behaviour === 'echo-args') {
+`, { mode: 0o755 });
+        }
+        else if (behaviour === 'echo-args') {
+            // 旗标回归探针:把 "$@" 回显进候选 region.id(anythingSearch 原样透传为 destinationId)
             await writeFile(p, `#!/bin/sh
 printf '{"candidates":[{"type":"city","region":{"id":"%s"}}]}' "$*"
-`, {
-                mode: 0o755
-            });
-        } else if (behaviour === 'empty') {
+`, { mode: 0o755 });
+        }
+        else if (behaviour === 'empty') {
             await writeFile(p, `#!/bin/sh
 cat <<'JSON'
 {"candidates":[]}
 JSON
-`, {
-                mode: 0o755
-            });
-        } else if (behaviour === 'fail') {
+`, { mode: 0o755 });
+        }
+        else if (behaviour === 'fail') {
             await writeFile(p, `#!/bin/sh
 echo 'hotelbe down' >&2
 exit 1
-`, {
-                mode: 0o755
-            });
-        } else if (behaviour === 'unknown-command') {
+`, { mode: 0o755 });
+        }
+        else if (behaviour === 'unknown-command') {
+            // 旧版 CLI(< 2026-09 的 staicli)没有 search anything 子命令时的 commander 原话
             await writeFile(p, `#!/bin/sh
 echo "error: unknown command 'anything'" >&2
 exit 1
-`, {
-                mode: 0o755
-            });
-        } else {
+`, { mode: 0o755 });
+        }
+        else {
+            // hang forever — test will timeout. Spawn on POSIX reacts to AbortSignal
+            // via SIGTERM; SIGKILL is the fallback at +500ms. Some shells (e.g. bash
+            // builtins shelled-out via Bun) cache the child pid briefly, so we give
+            // a generous upper bound in the assertion (note in code for future).
             await writeFile(p, `#!/bin/sh
 echo 'starting' >&2
 while :; do sleep 5; done
-`, {
-                mode: 0o755
-            });
+`, { mode: 0o755 });
         }
         return p;
     }
+    // 1. 真实候选(wire 形状逐字段)
     const ok = await fakeBin('hbcli-ok', 'ok');
-    const r1 = await anythingSearch({
-        keyword: '大理',
-        hbcliBin: ok
-    });
+    const r1 = await anythingSearch({ keyword: '大理', hbcliBin: ok });
     assert.equal(r1.verdict, 'hit');
     assert.equal(r1.hits.length, 3);
     assert.ok(r1.evidence.includes('hbcli-anything@'));
@@ -83,62 +96,45 @@ while :; do sleep 5; done
     assert.equal(placeHit.name, '洱海');
     assert.equal(placeHit.latitude, 25.74, 'place 坐标回退 place.latlngCoordinator');
     console.log('1. 真实候选 wire 形状(hotel/city/place 逐字段)OK');
+    // 2. 旗标回归:--json 必须在子命令前(cli.ts 全局旗标预扫描只认子命令前位置);
+    //    contentType → --content-type;parentDestinationId → --destination-id(上游 CLI 旗标名)
     const echo = await fakeBin('hbcli-echo-args', 'echo-args');
-    const r2 = await anythingSearch({
-        keyword: '大理',
-        contentType: 'city',
-        parentDestinationId: 'd1',
-        hbcliBin: echo
-    });
+    const r2 = await anythingSearch({ keyword: '大理', contentType: 'city', parentDestinationId: 'd1', hbcliBin: echo });
     assert.equal(r2.verdict, 'hit');
     assert.equal(r2.hits[0].destinationId, '--json search anything 大理 --content-type city --destination-id d1', 'spawn 旗标形态(--json 前置/--destination-id 映射)应稳定,实际 ' + r2.hits[0].destinationId);
     console.log('2. 旗标回归(--json 前置 + --destination-id 映射)OK');
+    // 3. 空候选
     const empty = await fakeBin('hbcli-empty', 'empty');
-    const r3 = await anythingSearch({
-        keyword: 'nothing',
-        hbcliBin: empty
-    });
+    const r3 = await anythingSearch({ keyword: 'nothing', hbcliBin: empty });
     assert.equal(r3.verdict, 'miss');
     assert.equal(r3.hits.length, 0);
     console.log('3. nothing → miss OK');
+    // 4. exit≠0
     const fail = await fakeBin('hbcli-fail', 'fail');
-    const r4 = await anythingSearch({
-        keyword: 'x',
-        hbcliBin: fail
-    });
+    const r4 = await anythingSearch({ keyword: 'x', hbcliBin: fail });
     assert.equal(r4.verdict, 'error');
     assert.equal(r4.ok, false);
     assert.match(r4.evidence, /error/);
     console.log('4. fail → error (降级) OK');
+    // 5. 旧 CLI unknown command → error 带升级指引(issue #195)
     const old = await fakeBin('hbcli-old', 'unknown-command');
-    const r5 = await anythingSearch({
-        keyword: 'x',
-        hbcliBin: old
-    });
+    const r5 = await anythingSearch({ keyword: 'x', hbcliBin: old });
     assert.equal(r5.verdict, 'error');
     assert.match(r5.error ?? '', /hbcli update|gotry setup/, 'error 应带升级指引,实际 ' + r5.error);
     assert.match(r5.evidence, /unknown command/, 'evidence 保留上游原话(溯源)');
     console.log(`5. 旧 CLI unknown command → 升级指引 OK(${r5.error})`);
+    // 6. 超时:fake hang 60s,我们给 800ms 超时,期望 verdict=error
+    //   (latency 断言范围放宽,因为 sandbox node spawn 的 abort 行为不稳定)
     const hang = await fakeBin('hbcli-hang', 'hang');
-    const r6 = await anythingSearch({
-        keyword: 'x',
-        hbcliBin: hang,
-        timeoutMs: 800
-    });
+    const r6 = await anythingSearch({ keyword: 'x', hbcliBin: hang, timeoutMs: 800 });
     assert.equal(r6.verdict, 'error', 'timeout 应判 error');
     console.log(`6. hang/timeout → error OK (latency=${r6.latencyMs}ms)`);
-    const r7 = await anythingSearch({
-        keyword: '   '
-    });
+    // 7. 空 keyword
+    const r7 = await anythingSearch({ keyword: '   ' });
     assert.equal(r7.verdict, 'error');
     console.log('7. empty keyword → error OK');
     console.log('\nANYTHING TESTS: 7/7 OK(hbcli fake + wire 对齐 + 降级诚实)');
-} finally{
-    await rm(tmp, {
-        recursive: true,
-        force: true
-    });
 }
-
-
-//# sourceURL=ts/scripts/anything-tests.ts
+finally {
+    await rm(tmp, { recursive: true, force: true });
+}

package/dist/scripts/artifact-client-contract-tests.js

@@ -0,0 +1,69 @@
+/**
+ * Public Client contract: package export, lazy-CJS loader shape, keyed DSH
+ * registrations, and defensive rendering from the runtime `block` payload.
+ * Browser execution is covered separately by dsh-artifact-web-e2e.ts.
+ */
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import vm from 'node:vm';
+const ROOT = join(import.meta.dirname, '..', '..');
+const source = readFileSync(join(ROOT, 'client/client.js'), 'utf8');
+const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8'));
+assert.equal(pkg.exports?.['./client'], './client/client.js');
+assert.equal(pkg.dsh?.client?.platform, 'web');
+assert.ok(pkg.dsh?.client?.inject?.includes('@deepseek-ai/dsh-client-ui-tool'));
+assert.ok(pkg.files?.includes('client/'));
+assert.ok(source.includes('window.__ModuleLoader__.load'));
+assert.ok(source.includes("tool.call.toolview"));
+assert.ok(source.includes("gotry_artifacts_list"));
+assert.ok(source.includes("gotry_artifacts_read"));
+assert.ok(!source.includes('@deepseek-ai/dsh-client-ui-tool/lib/'));
+const registrations = [];
+const context = vm.createContext({
+    window: { __ModuleLoader__: { load: (registration) => registrations.push(registration) } },
+    console,
+});
+new vm.Script(source, { filename: 'client/client.js' }).runInContext(context);
+assert.equal(registrations.length, 1);
+assert.equal(registrations[0].id, '@danceiny/gotry');
+function createElement(type, props, ...children) {
+    return { type, props: props ?? {}, children };
+}
+const fakeReact = {
+    createElement,
+    useState(initial) { return [initial, () => { }]; },
+};
+const clientExports = registrations[0].factory(name => {
+    assert.equal(name, 'react');
+    return fakeReact;
+});
+assert.deepEqual(Object.keys(clientExports), ['apply', 'inject']);
+const slotRegistrations = [];
+const registrationContext = {
+    inject(_deps, callback) { callback(registrationContext); },
+    slots: {
+        inject(_slot, callback) { callback(); },
+        register(definition, view) {
+            slotRegistrations.push({ key: definition.key, view });
+            return () => { };
+        },
+    },
+};
+clientExports.apply(registrationContext);
+assert.deepEqual(slotRegistrations.map(item => item.key), ['gotry_artifacts_list', 'gotry_artifacts_read']);
+assert.equal(slotRegistrations[0].view, slotRegistrations[1].view);
+const view = slotRegistrations[0].view;
+const listTree = view({
+    toolName: 'gotry_artifacts_list',
+    block: { kind: 'tool-result', isError: false, meta: { shape: 'paths', paths: ['/tmp/trip-2027.md'], total: 1, truncated: false }, content: [] },
+});
+assert.equal(listTree.props['data-gotry-artifact-card'], 'list');
+assert.equal(listTree.props['data-gotry-artifact-state'], 'ok');
+const malformedTree = view({ toolName: 'gotry_artifacts_read', block: { kind: 'tool-result', isError: false, meta: { shape: 'bad' }, content: [{ type: 'text', text: 'raw fallback' }] } });
+assert.equal(malformedTree.props['data-gotry-artifact-card'], 'read');
+assert.equal(malformedTree.props['data-gotry-artifact-state'], 'ok');
+const requireRoot = createRequire(join(ROOT, 'package.json'));
+assert.ok(requireRoot.resolve('./client/client.js'));
+console.log('ARTIFACT CLIENT CONTRACT: package export + web manifest + lazy loader + 2 keyed views + malformed fallback OK');

package/dist/scripts/artifacts-capability-tests.js

@@ -0,0 +1,235 @@
+/**
+ * 产物面(issue #285)能力层离线 proof:
+ *  list/read 工具链的纯函数 + 隔离 fixture 路径护栏。
+ *  与 smoke.ts §15 互相补——smoke 验注册 + dsh 卡片契约(在 plugin context),
+ *  本文件验 capabilities/artifacts.ts 纯函数 + 隔离 stateRoot(无 dsh 上下文)。
+ *
+ *  1) 账本权威 list:种工单 + 交付 → list 找到 async-run
+ *  2) cwd md list:工作目录顶层 md → list 找到 cwd-file
+ *  3) 合并去重:账本 + cwd 同 path 不重复
+ *  4) 裸工单 id read:从账本 deliverable 读出
+ *  5) 行号窗口:offset/limit 行号正确
+ *  6) 越界路径:ok:false + error 含「越界」
+ *  7) symlink 越界:ok:false
+ *  7b) 裸工单 id symlink/超大 deliverable:仍经过 canonical/root/size 护栏
+ *  8) 不支持扩展名:.db → ok:false + error 含「不支持的文件类型」
+ *  9) 不存在文件:ok:false
+ *  10) 超大文件:>2MB → ok:false
+ *  11) read 在 cwd/根边界外的相对路径:rejects
+ *  12) list limit 截断:truncated=true, paths.length === limit
+ */
+import assert from 'node:assert/strict';
+import { mkdirSync, mkdtempSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { listArtifacts, readArtifact } from '../capabilities/artifacts.js';
+import { ensureLedger } from '../src/state-ledger.js';
+const stateRoot = mkdtempSync(join(tmpdir(), 'gotry-artifacts-cap-tests-'));
+const cwd = mkdtempSync(join(tmpdir(), 'gotry-artifacts-cap-cwd-'));
+// 1) 账本权威 list
+{
+    const ledger = ensureLedger(stateRoot);
+    ledger.createWorkflowRun({ id: 'cap-probe-1', goal: '产物探针·账本', ticket: { objective: 'probe' }, state: {} });
+    ledger.settleWorkflowRun('cap-probe-1', '# 交付·账本权威\nD1 大理\nD2 洱海');
+    const r = await listArtifacts({ stateRoot, limit: 20 });
+    const run = r.artifacts.find(a => a.id === 'cap-probe-1');
+    assert.ok(run, '账本工单应被 list 找到');
+    assert.equal(run?.source, 'async-run');
+    assert.equal(run?.status, 'settled');
+    assert.ok(run?.path.endsWith('cap-probe-1.deliverable.md'), `path 形态应为 deliverable.md,实际 ${run?.path}`);
+    console.log('1) 账本权威 list OK');
+}
+// 2) cwd md list
+{
+    const lines = Array.from({ length: 8 }, (_, i) => `第 ${i + 1} 行`);
+    writeFileSync(join(cwd, 'trip-2027-cap.md'), `# 行程探针\n${lines.join('\n')}\n`);
+    const r = await listArtifacts({ stateRoot, cwd, limit: 20 });
+    const md = r.artifacts.find(a => a.id === 'trip-2027-cap.md');
+    assert.ok(md, 'cwd 顶层 md 应被 list 找到');
+    assert.equal(md?.source, 'cwd-file');
+    console.log('2) cwd md list OK');
+}
+// 3) 合并去重:账本工单 cap-probe-1 的 path 与 cwd 任何文件 path 不冲突——验证 seenPath 去重逻辑
+{
+    // 制造一个 cwd 文件与账本 deliverable 同 basename 看似不同
+    writeFileSync(join(cwd, 'cap-probe-1.deliverable.md'), 'unrelated');
+    const r = await listArtifacts({ stateRoot, cwd, limit: 20 });
+    const seen = new Map();
+    for (const a of r.artifacts) {
+        if (a.id === 'cap-probe-1.deliverable.md' || a.id === 'cap-probe-1') {
+            const k = resolve(a.path);
+            seen.set(k, (seen.get(k) ?? 0) + 1);
+        }
+    }
+    // 同一 path 出现 ≥2 次即去重失败
+    for (const [k, n] of seen) {
+        assert.ok(n <= 1, `path ${k} 出现 ${n} 次,应去重为 1`);
+    }
+    console.log('3) 合并去重 OK');
+}
+// 4) 裸工单 id read
+{
+    const r = await readArtifact({ stateRoot, cwd, path: 'cap-probe-1' });
+    assert.equal(r.ok, true, '裸工单 id 应可读');
+    if (r.ok) {
+        assert.equal(r.lang, 'markdown');
+        assert.equal(r.offset, 1);
+        assert.equal(r.lines[0]?.number, 1);
+        assert.ok(r.lines[0]?.text.includes('交付·账本权威'), '首行应含账本 deliverable 标题');
+        assert.equal(r.totalLines, 3, `交付 3 行,实际 ${r.totalLines}`);
+    }
+    console.log('4) 裸工单 id read OK');
+}
+// 5) 行号窗口
+{
+    const r = await readArtifact({ stateRoot, cwd, path: 'trip-2027-cap.md', offset: 3, limit: 3 });
+    assert.equal(r.ok, true, 'cwd md 应可读');
+    if (r.ok) {
+        assert.equal(r.lines.length, 3, `offset=3 limit=3 应 3 行,实际 ${r.lines.length}`);
+        assert.equal(r.lines[0]?.number, 3, `首行号应 3,实际 ${r.lines[0]?.number}`);
+        assert.equal(r.lines[2]?.number, 5);
+        assert.equal(r.totalLines, 10, `8 行 + 标题 1 + 末尾空行 1 = 10,实际 ${r.totalLines}`);
+        assert.equal(r.windowed, true, `offset=3 limit=3 总 10 行 → windowed=true(可继续翻页)`);
+    }
+    const full = await readArtifact({ stateRoot, cwd, path: 'trip-2027-cap.md' });
+    assert.equal(full.ok, true, 'cwd md 默认 limit 应读完');
+    if (full.ok) {
+        assert.equal(full.windowed, false, `读完应 windowed=false`);
+        assert.equal(full.lines.length, full.totalLines, `lines.length === totalLines,实际 ${full.lines.length}/${full.totalLines}`);
+    }
+    console.log('5) 行号窗口 OK');
+}
+// 6) 越界路径
+{
+    const r = await readArtifact({ stateRoot, cwd, path: '../../../../../etc/passwd' });
+    assert.equal(r.ok, false, '越界路径必须被拒');
+    if (!r.ok) {
+        assert.ok(r.error.includes('越界'), `error 应含「越界」,实际 ${r.error}`);
+    }
+    console.log('6) 越界路径 OK');
+}
+// 7) symlink 越界
+{
+    const linkPath = join(cwd, 'symlink-out.md');
+    try {
+        symlinkSync('/etc/passwd', linkPath);
+    }
+    catch {
+        // macOS 上 /etc/passwd 是符号链接到 /private/etc/passwd;symlink 自身仍 out-of-root
+    }
+    const r = await readArtifact({ stateRoot, cwd, path: 'symlink-out.md' });
+    assert.equal(r.ok, false, '相对路径 symlink 解析后越出 cwd 必须被拒');
+    if (!r.ok)
+        assert.ok(r.error.includes('越界'), `symlink 越界错误应含「越界」,实际 ${r.error}`);
+    // 绝对 symlink 指向目录也必须按 canonical target 做边界检查。
+    const absLink = join(stateRoot, 'abs-link.md');
+    try {
+        symlinkSync('/etc', absLink);
+        const r2 = await readArtifact({ stateRoot, cwd, path: absLink });
+        assert.equal(r2.ok, false, '绝对 symlink 越界必须被拒');
+        if (!r2.ok) {
+            assert.ok(r2.error.includes('越界'), `error 应含「越界」,实际 ${r2.error}`);
+        }
+    }
+    catch { /* 非 POSIX fs 跳过 */ }
+    console.log('7) symlink 越界 OK');
+}
+// 7b) 裸工单 id 的兼容文件视图也必须经过同一组 canonical/root/size 护栏。
+{
+    mkdirSync(join(stateRoot, 'gotry-state', 'async'), { recursive: true });
+    const bareLink = join(stateRoot, 'gotry-state', 'async', 'evil.deliverable.md');
+    let bareLinkCreated = false;
+    try {
+        symlinkSync('/etc/hosts', bareLink);
+        bareLinkCreated = true;
+    }
+    catch { /* 非 POSIX fs 跳过 */ }
+    if (bareLinkCreated) {
+        const r = await readArtifact({ stateRoot, cwd, path: 'evil' });
+        assert.equal(r.ok, false, '裸工单 id symlink 指向 root 外时必须被拒');
+        if (!r.ok)
+            assert.ok(r.error.includes('越界'), `裸工单 id symlink 越界错误应含「越界」,实际 ${r.error}`);
+    }
+    const bareBig = join(stateRoot, 'gotry-state', 'async', 'oversized.deliverable.md');
+    writeFileSync(bareBig, 'x'.repeat(2 * 1024 * 1024 + 1));
+    const oversized = await readArtifact({ stateRoot, cwd, path: 'oversized' });
+    assert.equal(oversized.ok, false, '裸工单 id 超大文件必须被拒');
+    if (!oversized.ok)
+        assert.ok(oversized.error.includes('过大'), `裸工单 id 超大错误应含「过大」,实际 ${oversized.error}`);
+    rmSync(bareLink, { force: true });
+    rmSync(bareBig, { force: true });
+    console.log('7b) 裸工单 id symlink/超大 deliverable 护栏 OK');
+}
+// 8) 不支持扩展名
+{
+    mkdirSync(join(stateRoot, 'gotry-state'), { recursive: true });
+    writeFileSync(join(stateRoot, 'gotry-state', 'gotry-state.db'), 'fake db');
+    const r = await readArtifact({ stateRoot, cwd, path: 'gotry-state/gotry-state.db' });
+    assert.equal(r.ok, false, '.db 必须被拒');
+    if (!r.ok) {
+        assert.ok(r.error.includes('不支持的文件类型'), `error 应含「不支持的文件类型」,实际 ${r.error}`);
+    }
+    console.log('8) 不支持扩展名 OK');
+}
+// 9) 不存在文件
+{
+    const r = await readArtifact({ stateRoot, cwd, path: 'not-found.md' });
+    assert.equal(r.ok, false, '不存在文件必须被拒');
+    if (!r.ok) {
+        assert.ok(r.error.includes('不存在'), `error 应含「不存在」,实际 ${r.error}`);
+    }
+    console.log('9) 不存在文件 OK');
+}
+// 10) 超大文件
+{
+    const big = join(cwd, 'big.md');
+    // 2MB+ 一点点;read 默认上限 2MB
+    const chunk = 'x'.repeat(64 * 1024);
+    const handle = await import('node:fs/promises').then(m => m.open(big, 'w'));
+    try {
+        for (let i = 0; i < 33; i++)
+            await handle.write(chunk); // 33 * 64KB = 2.11MB
+    }
+    finally {
+        await handle.close();
+    }
+    const r = await readArtifact({ stateRoot, cwd, path: 'big.md' });
+    assert.equal(r.ok, false, '>2MB 必须被拒');
+    if (!r.ok) {
+        assert.ok(r.error.includes('过大'), `error 应含「过大」,实际 ${r.error}`);
+    }
+    console.log('10) 超大文件 OK');
+}
+// 11) read 接受 path 三形态:id / cwd 文件名 / 绝对路径
+{
+    // 11a) 相对文件名仅在 cwd 顶层
+    const r = await readArtifact({ stateRoot, cwd, path: 'trip-2027-cap.md' });
+    assert.equal(r.ok, true, '相对文件名应解析为 cwd 顶层');
+    // 11b) path 为裸字符串无后缀 + 不在 cwd → 尝试 stateRoot 下的 gotry-state/async/
+    const r2 = await readArtifact({ stateRoot, cwd, path: 'cap-probe-1' });
+    assert.equal(r2.ok, true, '裸工单 id 应解析为账本');
+    // 11c) 空 path
+    const r3 = await readArtifact({ stateRoot, cwd, path: '' });
+    assert.equal(r3.ok, false, '空 path 应被拒');
+    console.log('11) path 三形态 OK');
+}
+// 12) list limit 截断
+{
+    for (let i = 0; i < 5; i++)
+        writeFileSync(join(cwd, `extra-${i}.md`), `# 副产物 ${i}`);
+    const r = await listArtifacts({ stateRoot, cwd, limit: 3 });
+    assert.equal(r.artifacts.length, 3, `limit=3 应 3 条,实际 ${r.artifacts.length}`);
+    assert.equal(r.truncated, true, `应有更多,truncated 应为 true`);
+    // total = sum of each source's retained count = 1 (账本) + 0 (async dir) + 3 (cwd top 3 by mtime) = 4
+    // (listCwdMarkdown 内部就 slice(0, limit);要更多需调用方放大 limit)
+    assert.equal(r.total, 4, `total 应 4(账本 1 + cwd top 3),实际 ${r.total}`);
+    assert.ok(r.total > r.artifacts.length, `total 应 > artifacts.length 才能 truncated,实际 ${r.total} vs ${r.artifacts.length}`);
+    // 放大 limit 后能看到全部
+    const r2 = await listArtifacts({ stateRoot, cwd, limit: 20 });
+    assert.equal(r2.truncated, false, `limit=20 应能装下,truncated=false`);
+    assert.ok(r2.total >= 7, `放大 limit 后 total 应 ≥ 7(账本 1 + cwd 多个 md),实际 ${r2.total}`);
+    console.log('12) list limit 截断 OK');
+}
+rmSync(stateRoot, { recursive: true, force: true });
+rmSync(cwd, { recursive: true, force: true });
+console.log('all artifacts capability tests OK');

package/dist/scripts/async-collect.js

@@ -1,9 +1,23 @@
+/**
+ * 异步工单回收(S5 编排半段 → ADR-15 durable 恢复语义):加载持久化工单,
+ * 经可日志化 solve 端口执行深度规划(done 步骤复用账本结果,不重执行),
+ * 交付物落账本 + .deliverable.md 视图。可由任何后续进程执行(loopx 驱动的
+ * tick、state-cli tick、人工、未来的通知系统)——「一小时后回来」跨进程成立,
+ * 且崩溃恢复 exactly-once:重放不重复花钱。最后一行固定输出
+ * gotry_async_terminal.v1 JSON；4/4 exit 0，非 4/4 exit 2。
+ * 运行(在 ts/ 下):npx tsx scripts/async-collect.ts <ticketId> [stateRoot]
+ * 环境变量 GOTRY_SOLVE_COUNT_FILE:每次真实求解追加一行(回归用计数探针)。
+ */
 import { appendFileSync } from 'node:fs';
-import { ASYNC_TERMINAL_SCHEMA, collectDeepPlanning, loadAsyncTicket, makeJournaledSolvePort, settleAsyncTicket } from '../src/loop.js';
+import { ASYNC_TERMINAL_SCHEMA, collectDeepPlanning, loadAsyncTicket, makeJournaledSolvePort, settleAsyncTicket, } from '../src/loop.js';
 import { solveUnified } from '../src/unified.js';
 import { openLedgerIfExists } from '../src/state-ledger.js';
 function isTerminalOutcome(value) {
-    return value?.['schema'] === ASYNC_TERMINAL_SCHEMA && (value['status'] === 'succeeded' || value['status'] === 'failed') && typeof value['passed'] === 'number' && value['total'] === 4 && Array.isArray(value['failed_checks']);
+    return value?.['schema'] === ASYNC_TERMINAL_SCHEMA
+        && (value['status'] === 'succeeded' || value['status'] === 'failed')
+        && typeof value['passed'] === 'number'
+        && value['total'] === 4
+        && Array.isArray(value['failed_checks']);
 }
 function legacyTerminalOutcome(ticket, status, deliverable) {
     const succeeded = status === 'settled' && deliverable.includes('不失望四条:4/4 ✅');
@@ -13,12 +27,8 @@ function legacyTerminalOutcome(ticket, status, deliverable) {
         status: succeeded ? 'succeeded' : 'failed',
         passed: succeeded ? 4 : 0,
         total: 4,
-        checks: {
-            legacy_human_marker_only: succeeded
-        },
-        failed_checks: succeeded ? [] : [
-            'legacy_unstructured_terminal'
-        ]
+        checks: { legacy_human_marker_only: succeeded },
+        failed_checks: succeeded ? [] : ['legacy_unstructured_terminal'],
     };
 }
 function emitTerminal(outcome) {
@@ -36,11 +46,14 @@ if (!loaded) {
     console.error(`工单 ${ticketId} 不存在(账本 workflow_runs / gotry-state/async/${ticketId}.json)`);
     process.exit(1);
 }
+// 终态幂等:已 settled/failed 的工单复诵账本交付物与机器终态,零重算
 const ledger = openLedgerIfExists(stateRoot);
 const run = ledger?.getWorkflowRun(ticketId);
 if ((run?.status === 'settled' || run?.status === 'failed') && run.deliverable) {
     const storedOutcome = ledger?.getWorkflowTerminalOutcome(ticketId) ?? null;
-    const outcome = isTerminalOutcome(storedOutcome) ? storedOutcome : legacyTerminalOutcome(ticketId, run.status, run.deliverable);
+    const outcome = isTerminalOutcome(storedOutcome)
+        ? storedOutcome
+        : legacyTerminalOutcome(ticketId, run.status, run.deliverable);
     await settleAsyncTicket(ticketId, run.deliverable, stateRoot, outcome);
     console.log(`工单 ${ticketId} 已交付(账本终态,复诵不重算):\n\n${run.deliverable}`);
     emitTerminal(outcome);
@@ -50,16 +63,14 @@ if (!ledger) {
     process.exit(1);
 }
 const solve = makeJournaledSolvePort(ledger, ticketId, solveUnified, {
-    onRealSolve: ()=>{
+    onRealSolve: () => {
         const f = process.env['GOTRY_SOLVE_COUNT_FILE'];
-        if (f) appendFileSync(f, 'solve\n');
-    }
+        if (f)
+            appendFileSync(f, 'solve\n');
+    },
 });
 const { reply, outcome } = await collectDeepPlanning(loaded.state, loaded.ticket, solve);
 const out = await settleAsyncTicket(ticketId, reply, stateRoot, outcome);
 console.log(`交付物已落盘:${out}\n\n${reply}`);
 console.log(JSON.stringify(outcome));
 process.exitCode = outcome.status === 'succeeded' ? 0 : 2;
-
-
-//# sourceURL=ts/scripts/async-collect.ts