taskboard-workbench 0.0.0-stage → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/CHANGELOG.md +403 -0
  2. package/LICENSE +21 -0
  3. package/README.md +210 -2
  4. package/cli/tb.mjs +314 -0
  5. package/cordis.patch.yml +5 -0
  6. package/index.js +633 -0
  7. package/lib/client.js +522 -0
  8. package/package.json +96 -4
  9. package/scripts/tb-flow.mjs +86 -0
  10. package/skills/taskboard-flow/SKILL.md +89 -0
  11. package/skills/taskboard-flow/references/errors.md +61 -0
  12. package/skills/taskboard-flow/references/injection.md +70 -0
  13. package/skills/taskboard-flow/references/steps/S0.md +31 -0
  14. package/skills/taskboard-flow/references/steps/S1.md +28 -0
  15. package/skills/taskboard-flow/references/steps/S2.md +31 -0
  16. package/skills/taskboard-flow/references/steps/S3.md +22 -0
  17. package/skills/taskboard-flow/references/steps/S4.md +25 -0
  18. package/skills/taskboard-flow/references/steps/S5.md +36 -0
  19. package/skills/taskboard-flow/references/steps/S6.md +30 -0
  20. package/skills/taskboard-flow/references/steps/S7.md +23 -0
  21. package/spec/norms/acceptance.md +36 -0
  22. package/spec/norms/card-update.md +39 -0
  23. package/spec/norms/doc-editing.md +30 -0
  24. package/spec/norms/flow.md +45 -0
  25. package/spec/norms/manifest.json +41 -0
  26. package/spec/norms/project-defaults.md +33 -0
  27. package/spec//345/233/242/351/230/237agent.md +171 -0
  28. package/src/core/acceptance.mjs +62 -0
  29. package/src/core/advance.mjs +192 -0
  30. package/src/core/agent-teams.mjs +48 -0
  31. package/src/core/binding.mjs +44 -0
  32. package/src/core/config.mjs +22 -0
  33. package/src/core/contract.mjs +287 -0
  34. package/src/core/debug-dispatch.mjs +94 -0
  35. package/src/core/delivery.mjs +93 -0
  36. package/src/core/deps.mjs +53 -0
  37. package/src/core/diagnostics.mjs +648 -0
  38. package/src/core/domain.mjs +235 -0
  39. package/src/core/empty-state.mjs +240 -0
  40. package/src/core/errors.mjs +142 -0
  41. package/src/core/evidence.mjs +86 -0
  42. package/src/core/executor.mjs +645 -0
  43. package/src/core/human-review.mjs +773 -0
  44. package/src/core/intake.mjs +179 -0
  45. package/src/core/kickoff.mjs +147 -0
  46. package/src/core/loop.mjs +498 -0
  47. package/src/core/memory.mjs +193 -0
  48. package/src/core/next-step.mjs +377 -0
  49. package/src/core/notify.mjs +183 -0
  50. package/src/core/owner.mjs +41 -0
  51. package/src/core/requirements.mjs +292 -0
  52. package/src/core/review.mjs +82 -0
  53. package/src/core/session-naming.mjs +64 -0
  54. package/src/core/split-ask.mjs +107 -0
  55. package/src/core/store.mjs +3442 -0
  56. package/src/core/team.mjs +170 -0
  57. package/src/core/ticket-stage.mjs +150 -0
  58. package/src/core/verify.mjs +170 -0
  59. package/src/core/watchdog.mjs +144 -0
  60. package/src/host/ai-elaborator.mjs +26 -0
  61. package/src/host/team-engine.mjs +125 -0
  62. package/src/host/tool-surface.mjs +205 -0
  63. package/src/mcp/flow-block.mjs +173 -0
  64. package/src/mcp/server.mjs +156 -0
  65. package/src/mcp/tools.mjs +764 -0
  66. package/src/server/api.mjs +2050 -0
  67. package/src/server/events.mjs +32 -0
  68. package/src/server/kickoff.mjs +46 -0
  69. package/src/server/server.mjs +214 -0
  70. package/src/server/verify.mjs +112 -0
  71. package/tools/env-check.mjs +35 -0
  72. package/tools/seed.mjs +67 -0
  73. package/web/app.js +5337 -0
  74. package/web/index.html +15 -0
  75. package/web/tokens.css +1151 -0
@@ -0,0 +1,86 @@
1
+ /**
2
+ * 交付物证据的**规则层**(FR-106 / 卡 `-197` · 0-B)。
3
+ *
4
+ * 这一层只做「判」,不碰库:四字段齐不齐、`artifact_refs` 解不解得开。
5
+ * 为什么单独成模块:核验规则要被单测逐条钉住,也要能被将来的 Router / 看护复用,
6
+ * 塞进 store 里就只能靠"跑一遍看板"验证。
7
+ */
8
+ import fs from "node:fs";
9
+ import path from "node:path";
10
+ import { execFileSync } from "node:child_process";
11
+
12
+ export const EVIDENCE_FIELDS = Object.freeze(["verdict", "deviation", "boundary", "artifacts"]);
13
+ export const EVIDENCE_REF_KINDS = Object.freeze(["commit", "file"]);
14
+
15
+ const text = (v) => (typeof v === "string" ? v.trim() : "");
16
+
17
+ /** 四字段缺什么就报什么(**门在事务前**:调用方拿到非空数组就不许落库)。 */
18
+ export function evidenceProblems(input = {}) {
19
+ const problems = [];
20
+ for (const f of ["verdict", "deviation", "boundary"]) {
21
+ if (text(input[f]) === "") problems.push({ field: f, reason: "empty" });
22
+ }
23
+ const arts = Array.isArray(input.artifacts) ? input.artifacts.filter((a) => text(a) !== "") : [];
24
+ if (arts.length === 0) problems.push({ field: "artifacts", reason: "empty" });
25
+ return problems;
26
+ }
27
+
28
+ /** 统一形状:`[{kind, ref, note?}]`;非法 kind 直接丢弃(不猜)。 */
29
+ export function normalizeArtifactRefs(refs) {
30
+ if (!Array.isArray(refs)) return [];
31
+ const out = [];
32
+ for (const r of refs) {
33
+ const kind = text(r?.kind);
34
+ const ref = text(r?.ref);
35
+ if (!ref || !EVIDENCE_REF_KINDS.includes(kind)) continue;
36
+ const note = text(r?.note);
37
+ out.push(note ? { kind, ref, note } : { kind, ref });
38
+ }
39
+ return out;
40
+ }
41
+
42
+ /**
43
+ * 核验 `artifact_refs`:任一解不开即整体 `unresolved`(不"部分通过")。
44
+ * `resolve({kind, ref})` 由调用方注入 —— 默认实现见 `makeResolver`。
45
+ */
46
+ export function verifyArtifactRefs(refs = [], resolve) {
47
+ const list = normalizeArtifactRefs(refs);
48
+ if (list.length === 0) return { state: "unchecked", unresolved: [] };
49
+ if (typeof resolve !== "function") return { state: "unchecked", unresolved: [] };
50
+ const unresolved = [];
51
+ for (const r of list) {
52
+ let ok = false;
53
+ try { ok = resolve(r) === true; } catch { ok = false; }
54
+ if (!ok) unresolved.push(r);
55
+ }
56
+ return { state: unresolved.length ? "unresolved" : "resolved", unresolved };
57
+ }
58
+
59
+ /**
60
+ * `format_ok` 的**唯一**判据(0-A 的 `ticketStage()` 直接调用这里,别在别处再写一份):
61
+ * 四字段齐 **且** refs 不是 `unresolved`。
62
+ * `unchecked` 可以进 format_ok —— 没给 refs 就不假装校验过;"格式合格" ≠ "内容已判"(那是 ready 的事)。
63
+ */
64
+ export function evidenceFormatOk(evidence) {
65
+ if (!evidence) return false;
66
+ if (evidenceProblems(evidence).length) return false;
67
+ return evidence.refsState !== "unresolved";
68
+ }
69
+
70
+ /**
71
+ * 默认解析器:`file` 走 `fs.existsSync`(相对仓库根),`commit` 走 `git cat-file -e <sha>^{commit}`。
72
+ * 刻意**不抛**:核验失败是数据问题,不是程序异常。
73
+ */
74
+ export function makeResolver({ root, execFileSyncImpl = execFileSync, existsSyncImpl = fs.existsSync } = {}) {
75
+ const base = root ?? process.cwd();
76
+ return (r) => {
77
+ if (r.kind === "file") return existsSyncImpl(path.resolve(base, r.ref));
78
+ if (r.kind === "commit") {
79
+ try {
80
+ execFileSyncImpl("git", ["-C", base, "cat-file", "-e", `${r.ref}^{commit}`], { stdio: "ignore" });
81
+ return true;
82
+ } catch { return false; }
83
+ }
84
+ return false;
85
+ };
86
+ }