@tea-agent/loop-agent 0.26.0 → 0.26.2

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 (197) hide show
  1. package/CHANGELOG.md +1056 -1020
  2. package/README.md +8 -3
  3. package/bin/loop-agent.js +21 -21
  4. package/dist/application/dag/generate-task-dag.js +33 -0
  5. package/dist/cli/command-definitions.js +25 -10
  6. package/dist/cli/help.js +4 -3
  7. package/dist/cli/program.js +43 -17
  8. package/dist/commands/cursor-prompt.js +6 -6
  9. package/dist/commands/import-prd.js +7 -2
  10. package/dist/commands/init.js +7 -5
  11. package/dist/commands/loop-benchmark.js +11 -11
  12. package/dist/commands/pi-reuse-benchmark.js +16 -16
  13. package/dist/commands/task-source-prepare.js +474 -0
  14. package/dist/executors/dag-pi-executor.js +40 -5
  15. package/dist/executors/shell-executor.js +111 -0
  16. package/dist/executors/shell-presets.js +12 -4
  17. package/dist/executors/shell-write-guard.js +161 -25
  18. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  19. package/dist/task/config-types.js +6 -0
  20. package/dist/task/contract/constants.js +1 -0
  21. package/dist/task/contract/project.js +8 -0
  22. package/dist/task/contract/schema.js +1 -0
  23. package/dist/task/frontend-preflight.js +131 -0
  24. package/dist/task/runtime.js +2 -4
  25. package/dist/task/source-prepare/build-draft.js +224 -0
  26. package/dist/task/source-prepare/completeness.js +195 -0
  27. package/dist/task/source-prepare/index.js +7 -0
  28. package/dist/task/source-prepare/parse-intent.js +373 -0
  29. package/dist/task/source-prepare/path-policy.js +197 -0
  30. package/dist/task/source-prepare/prepare.js +506 -0
  31. package/dist/task/source-prepare/reference-integrity.js +274 -0
  32. package/dist/task/source-prepare/types.js +7 -0
  33. package/dist/worker/observability/read-model.js +134 -0
  34. package/dist/worker/observe/static/copy.js +67 -67
  35. package/dist/worker/observe/static/dag-layout.d.ts +31 -31
  36. package/dist/worker/observe/static/dag-layout.js +83 -83
  37. package/dist/worker/observe/static/dom.js +220 -220
  38. package/dist/worker/observe/static/relations.js +133 -133
  39. package/dist/worker/observe/static/router.js +93 -93
  40. package/dist/worker/observe/static/run-processing.js +148 -148
  41. package/dist/worker/observe/static/state.js +61 -0
  42. package/dist/worker/observe/static/styles.css +8 -0
  43. package/dist/worker/observe/static/views/batch.js +227 -227
  44. package/dist/worker/observe/static/views/dag-graph.js +248 -172
  45. package/dist/worker/observe/static/views/dag-inspector.js +374 -157
  46. package/dist/worker/observe/static/views/dag.js +4 -11
  47. package/dist/worker/observe/static/views/failures.js +143 -143
  48. package/dist/worker/observe/static/views/feature.js +492 -492
  49. package/dist/worker/observe/static/views/run.js +453 -453
  50. package/dist/worker/observe/static/views/shell.js +7 -7
  51. package/dist/worker/observe/static/views/timeline.js +163 -163
  52. package/dist/workflows/dag/backend-test-pytest-collection.js +277 -0
  53. package/dist/workflows/dag/canvas-observer.js +275 -275
  54. package/dist/workflows/dag/convergence/controller.js +110 -21
  55. package/dist/workflows/dag/frontend-implementation-contract.js +218 -17
  56. package/dist/workflows/dag/frontend-review-context.js +7 -1
  57. package/dist/workflows/dag/frontend-verification-trace.js +14 -3
  58. package/dist/workflows/dag/frontend-worktree-diff.js +14 -3
  59. package/dist/workflows/dag/init-hybrid.js +96 -34
  60. package/dist/workflows/dag/output-protocol.js +180 -7
  61. package/dist/workflows/dag/runner.js +141 -52
  62. package/dist/workflows/dag/types.js +4 -0
  63. package/dist/workflows/dag/validate.js +3 -2
  64. package/docs/skills/README.md +7 -7
  65. package/docs/templates/adr.md +60 -60
  66. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  67. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  68. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  69. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  70. package/docs/templates/agent-dag-report.schema.json +473 -473
  71. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  72. package/docs/templates/backend-test-dag.json +100 -8
  73. package/docs/templates/backend-test-result.schema.json +99 -99
  74. package/docs/templates/feature-spec.md +53 -53
  75. package/docs/templates/frontend-design-contract.md +42 -42
  76. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
  77. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
  78. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
  79. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
  80. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
  81. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
  82. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
  83. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
  84. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
  85. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
  86. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
  87. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
  88. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
  89. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
  90. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
  91. package/docs/templates/frontend-eval/metrics.md +138 -138
  92. package/docs/templates/frontend-eval/smoke-targets.md +53 -53
  93. package/docs/templates/frontend-task-constraints.md +35 -35
  94. package/docs/templates/frontend-task-requirement.md +70 -70
  95. package/docs/templates/init-evolution-review.md +35 -35
  96. package/docs/templates/init-managed-agents.md +10 -5
  97. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  98. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  99. package/docs/templates/knowledge-sync-dag.json +178 -178
  100. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  101. package/docs/templates/product-line/closeout.yaml +9 -9
  102. package/docs/templates/product-line/design.md +13 -13
  103. package/docs/templates/product-line/links.md +10 -10
  104. package/docs/templates/product-line/requirement.md +17 -17
  105. package/docs/templates/product-line/test-plan.md +7 -7
  106. package/docs/templates/production-readiness-checklist.md +57 -57
  107. package/docs/templates/project-start-checklist.md +9 -9
  108. package/docs/templates/qa-report.md +48 -48
  109. package/docs/templates/sprint-contract.md +29 -29
  110. package/docs/templates/worker-dogfood-evidence.md +80 -80
  111. package/docs/templates/worker-dogfood-setup.md +68 -68
  112. package/package.json +1 -1
  113. package/scripts/kb-bootstrap-init-skeleton.sh +0 -0
  114. package/scripts/kb-graph-incremental-prepare.mjs +386 -386
  115. package/scripts/kb-graph-materialize.mjs +105 -105
  116. package/scripts/kb-graph-promote.mjs +164 -164
  117. package/scripts/kb-query.mjs +554 -554
  118. package/skills/ai-engineering-context/SKILL.md +48 -48
  119. package/skills/analyze-product-dependencies/SKILL.md +67 -67
  120. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -4
  121. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -30
  122. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -28
  123. package/skills/analyze-product-dependencies/references/example.md +76 -76
  124. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -35
  125. package/skills/analyze-product-dependencies/references/input-contract.md +11 -11
  126. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -61
  127. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -267
  128. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -101
  129. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -142
  130. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -76
  131. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -146
  132. package/skills/analyze-product-requirements/SKILL.md +90 -90
  133. package/skills/analyze-product-requirements/agents/openai.yaml +4 -4
  134. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -91
  135. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -56
  136. package/skills/analyze-product-requirements/references/example.md +86 -86
  137. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -66
  138. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -32
  139. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -33
  140. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -35
  141. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -193
  142. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -69
  143. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -97
  144. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -98
  145. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -156
  146. package/skills/browser-tools/browser-content.js +103 -103
  147. package/skills/browser-tools/browser-cookies.js +35 -35
  148. package/skills/browser-tools/browser-eval.js +53 -53
  149. package/skills/browser-tools/browser-hn-scraper.js +108 -108
  150. package/skills/browser-tools/browser-nav.js +44 -44
  151. package/skills/browser-tools/browser-pick.js +162 -162
  152. package/skills/browser-tools/browser-screenshot.js +34 -34
  153. package/skills/browser-tools/browser-start.js +86 -86
  154. package/skills/browser-tools/package-lock.json +2556 -2556
  155. package/skills/browser-tools/package.json +19 -19
  156. package/skills/code-review-core/SKILL.md +20 -20
  157. package/skills/codebase-scout/SKILL.md +19 -19
  158. package/skills/grill-me/SKILL.md +10 -10
  159. package/skills/loop-agent/SKILL.md +5 -2
  160. package/skills/loop-agent/references/README.md +67 -67
  161. package/skills/loop-agent/references/command-reference.md +17 -15
  162. package/skills/loop-agent/references/docs-converge.md +126 -126
  163. package/skills/loop-agent/references/harness-policy.md +3 -4
  164. package/skills/loop-agent/references/hybrid-dag.md +1 -1
  165. package/skills/loop-agent/references/learned/README.md +21 -21
  166. package/skills/loop-agent/references/long-running-loop.md +57 -57
  167. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  168. package/skills/loop-agent/references/pi-prompt.md +23 -23
  169. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  170. package/skills/loop-agent/references/post-implementation-and-patterns.md +1 -1
  171. package/skills/loop-agent/references/source-and-plan-practice.md +3 -2
  172. package/skills/loop-agent/references/task-workflow.md +7 -5
  173. package/skills/playwright-cli/SKILL.md +420 -420
  174. package/skills/playwright-cli/references/element-attributes.md +23 -23
  175. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  176. package/skills/playwright-cli/references/request-mocking.md +87 -87
  177. package/skills/playwright-cli/references/running-code.md +241 -241
  178. package/skills/playwright-cli/references/session-management.md +225 -225
  179. package/skills/playwright-cli/references/storage-state.md +275 -275
  180. package/skills/playwright-cli/references/test-generation.md +433 -433
  181. package/skills/playwright-cli/references/tracing.md +139 -139
  182. package/skills/playwright-cli/references/video-recording.md +143 -143
  183. package/skills/requesting-code-review/SKILL.md +101 -101
  184. package/skills/requesting-code-review/code-reviewer.md +168 -168
  185. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  186. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  187. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  188. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  189. package/skills/systematic-debugging/find-polluter.sh +63 -63
  190. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  191. package/skills/systematic-debugging/test-academic.md +14 -14
  192. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  193. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  194. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  195. package/skills/using-git-worktrees/SKILL.md +215 -215
  196. package/skills/verification-before-completion/SKILL.md +154 -154
  197. package/skills/webapp-testing/SKILL.md +19 -19
@@ -1,156 +1,156 @@
1
- import { existsSync, readFileSync, statSync } from "node:fs";
2
- import { basename, dirname, join, resolve } from "node:path";
3
-
4
- export function loadMarkdown(fileArg, label = "artifact") {
5
- const path = resolve(fileArg);
6
- try {
7
- return { path, text: readFileSync(path, "utf8") };
8
- } catch (error) {
9
- throw new Error(`Cannot read ${label} ${path}: ${error.message}`);
10
- }
11
- }
12
-
13
- export function frontmatter(text) {
14
- return text.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1] ?? "";
15
- }
16
-
17
- export function metadata(text, name) {
18
- const block = frontmatter(text);
19
- const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
20
- return block.match(new RegExp(`^${escaped}:[ \\t]*["']?([^"'\\r\\n]+)["']?[ \\t]*$`, "m"))?.[1].trim();
21
- }
22
-
23
- export function headings(text, level) {
24
- const prefix = "#".repeat(level);
25
- const matches = [...text.matchAll(new RegExp(`^${prefix}\\s+(.+)$`, "gm"))];
26
- return matches.map((match, index) => ({
27
- title: match[1].trim(),
28
- start: match.index,
29
- text: text.slice(match.index, matches[index + 1]?.index ?? text.length),
30
- }));
31
- }
32
-
33
- export function canonical(title) {
34
- return title.replace(/^\d+(?:\.\d+)*[.、]?[ \t]*/, "").trim();
35
- }
36
-
37
- export function section(text, level, title) {
38
- return headings(text, level).find((item) => canonical(item.title) === title)?.text;
39
- }
40
-
41
- export function sections(text, level, title) {
42
- return headings(text, level).filter((item) => canonical(item.title) === title);
43
- }
44
-
45
- export function hasSubstance(block) {
46
- if (!block) return false;
47
- return block.split(/\r?\n/).slice(1).some((line) => line.trim() && !/^\|?[-:| ]+\|?$/.test(line.trim()));
48
- }
49
-
50
- export function field(block, name) {
51
- const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
52
- return block.match(new RegExp(`^-[ \\t]*${escaped}[::][ \\t]*(.+)$`, "m"))?.[1].trim().replace(/[。.]$/, "");
53
- }
54
-
55
- export function storyBlocks(block, prefix) {
56
- if (!block) return [];
57
- const matches = [...block.matchAll(new RegExp(`^###\\s+(${prefix}-\\d{3,})\\s+(.+)$`, "gm"))];
58
- return matches.map((match, index) => ({
59
- id: match[1],
60
- title: match[2].trim(),
61
- text: block.slice(match.index, matches[index + 1]?.index ?? block.length),
62
- }));
63
- }
64
-
65
- export function outputSpecBlocks(block, prefix) {
66
- return storyBlocks(block, prefix);
67
- }
68
-
69
- export function validateStorySpecCoverage(stories, specs, errors, label) {
70
- const storyIds = stories.map((item) => item.id);
71
- const specIds = specs.map((item) => item.id);
72
- for (const id of new Set(storyIds)) if (storyIds.filter((value) => value === id).length > 1) errors.push(`Duplicate story ID: ${id}.`);
73
- for (const id of new Set(specIds)) if (specIds.filter((value) => value === id).length > 1) errors.push(`Duplicate output specification: ${id}.`);
74
- for (const id of storyIds) if (!specIds.includes(id)) errors.push(`${label} is missing output specification for ${id}.`);
75
- for (const id of specIds) if (!storyIds.includes(id)) errors.push(`${label} contains output specification for unknown story ${id}.`);
76
- }
77
-
78
- export function acceptanceBlocks(story, prefix) {
79
- const matches = [...story.text.matchAll(new RegExp(`^####\\s+(${prefix}-\\d{3,})\\s+(.+)$`, "gm"))];
80
- return matches.map((match, index) => ({
81
- id: match[1],
82
- title: match[2].trim(),
83
- text: story.text.slice(match.index, matches[index + 1]?.index ?? story.text.length),
84
- }));
85
- }
86
-
87
- export function validateAcceptance(block, owner, errors) {
88
- const labels = ["Given", "When", "Then", "异常场景"];
89
- const positions = labels.map((label) => ({ label, index: block.search(new RegExp(`^${label}[::]`, "m")) }));
90
- for (const item of positions) if (item.index < 0) errors.push(`${owner} is missing ${item.label}.`);
91
- if (positions.some((item) => item.index < 0)) return;
92
- const counts = positions.map((item, index) => {
93
- const end = positions[index + 1]?.index ?? block.length;
94
- return (block.slice(item.index, end).match(/^-\s+\S.+$/gm) ?? []).length;
95
- });
96
- if (counts[0] < 1 || counts[1] < 1 || counts[2] < 2 || counts[3] < 1) {
97
- errors.push(`${owner} must contain at least 1 Given, 1 When, 2 Then, and 1 exception bullet.`);
98
- }
99
- if (counts.reduce((sum, count) => sum + count, 0) < 6) errors.push(`${owner} must contain at least six concrete bullets.`);
100
- if (!/(?:不得|不应|禁止|保留|恢复|重试|兜底|回滚|disabled)/.test(block)) {
101
- errors.push(`${owner} must include an observable protection or recovery result.`);
102
- }
103
- }
104
-
105
- export function containsUnresolvedBlockingPriority(block) {
106
- if (!block) return false;
107
- return block.split(/\r?\n/).slice(1).some((line) => {
108
- const plain = line.trim().replace(/^[-*+]\s*/, "").replace(/^\[[ xX]\]\s*/, "");
109
- if (!/\bP[01]\b/.test(plain)) return false;
110
- if (/^(?:不存在|没有|无)(?:任何)?(?:尚未|未)?(?:解决|确认|关闭|完成)?(?:的)?\s*P[01]\b/.test(plain)) return false;
111
- if (/^P[01]\b/.test(plain)) return true;
112
- return /(?:pending(?:-blocking)?|unresolved|未解决|未确认|待确认|未决|阻塞)/i.test(plain);
113
- });
114
- }
115
-
116
- export function assertHeadings(text, level, required, errors, owner) {
117
- for (const title of required) {
118
- const matches = sections(text, level, title);
119
- if (matches.length !== 1) errors.push(`${owner} must contain exactly one ${title} heading.`);
120
- else if (!hasSubstance(matches[0].text)) errors.push(`${owner} section ${title} must not be empty.`);
121
- }
122
- }
123
-
124
- export function printResult(label, path, errors) {
125
- if (errors.length) {
126
- console.error(`${label} validation failed (${errors.length}):`);
127
- for (const error of errors) console.error(`- ${error}`);
128
- process.exit(1);
129
- }
130
- console.log(`${label} validation passed: ${path}`);
131
- }
132
-
133
- export function validateArtifactLocation(artifact, errors, expectedName) {
134
- const requirementId = metadata(artifact.text, "requirement_id");
135
- const projectRootValue = metadata(artifact.text, "project_root");
136
- if (!requirementId || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(requirementId)) {
137
- errors.push("requirement_id must use lowercase letters, digits, and single hyphens.");
138
- return;
139
- }
140
- if (!projectRootValue) {
141
- errors.push("project_root is required.");
142
- return;
143
- }
144
- const projectRoot = resolve(dirname(artifact.path), projectRootValue);
145
- if (!existsSync(projectRoot) || !statSync(projectRoot).isDirectory()) {
146
- errors.push(`project_root does not resolve to an existing directory: ${projectRoot}`);
147
- return;
148
- }
149
- const expected = resolve(join(projectRoot, "docs", "product-analysis", requirementId));
150
- if (dirname(artifact.path) !== expected) {
151
- errors.push(`Artifact must be located under ${expected}.`);
152
- }
153
- if (expectedName && basename(artifact.path) !== expectedName) {
154
- errors.push(`Artifact filename must be ${expectedName}.`);
155
- }
156
- }
1
+ import { existsSync, readFileSync, statSync } from "node:fs";
2
+ import { basename, dirname, join, resolve } from "node:path";
3
+
4
+ export function loadMarkdown(fileArg, label = "artifact") {
5
+ const path = resolve(fileArg);
6
+ try {
7
+ return { path, text: readFileSync(path, "utf8") };
8
+ } catch (error) {
9
+ throw new Error(`Cannot read ${label} ${path}: ${error.message}`);
10
+ }
11
+ }
12
+
13
+ export function frontmatter(text) {
14
+ return text.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1] ?? "";
15
+ }
16
+
17
+ export function metadata(text, name) {
18
+ const block = frontmatter(text);
19
+ const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
20
+ return block.match(new RegExp(`^${escaped}:[ \\t]*["']?([^"'\\r\\n]+)["']?[ \\t]*$`, "m"))?.[1].trim();
21
+ }
22
+
23
+ export function headings(text, level) {
24
+ const prefix = "#".repeat(level);
25
+ const matches = [...text.matchAll(new RegExp(`^${prefix}\\s+(.+)$`, "gm"))];
26
+ return matches.map((match, index) => ({
27
+ title: match[1].trim(),
28
+ start: match.index,
29
+ text: text.slice(match.index, matches[index + 1]?.index ?? text.length),
30
+ }));
31
+ }
32
+
33
+ export function canonical(title) {
34
+ return title.replace(/^\d+(?:\.\d+)*[.、]?[ \t]*/, "").trim();
35
+ }
36
+
37
+ export function section(text, level, title) {
38
+ return headings(text, level).find((item) => canonical(item.title) === title)?.text;
39
+ }
40
+
41
+ export function sections(text, level, title) {
42
+ return headings(text, level).filter((item) => canonical(item.title) === title);
43
+ }
44
+
45
+ export function hasSubstance(block) {
46
+ if (!block) return false;
47
+ return block.split(/\r?\n/).slice(1).some((line) => line.trim() && !/^\|?[-:| ]+\|?$/.test(line.trim()));
48
+ }
49
+
50
+ export function field(block, name) {
51
+ const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
52
+ return block.match(new RegExp(`^-[ \\t]*${escaped}[::][ \\t]*(.+)$`, "m"))?.[1].trim().replace(/[。.]$/, "");
53
+ }
54
+
55
+ export function storyBlocks(block, prefix) {
56
+ if (!block) return [];
57
+ const matches = [...block.matchAll(new RegExp(`^###\\s+(${prefix}-\\d{3,})\\s+(.+)$`, "gm"))];
58
+ return matches.map((match, index) => ({
59
+ id: match[1],
60
+ title: match[2].trim(),
61
+ text: block.slice(match.index, matches[index + 1]?.index ?? block.length),
62
+ }));
63
+ }
64
+
65
+ export function outputSpecBlocks(block, prefix) {
66
+ return storyBlocks(block, prefix);
67
+ }
68
+
69
+ export function validateStorySpecCoverage(stories, specs, errors, label) {
70
+ const storyIds = stories.map((item) => item.id);
71
+ const specIds = specs.map((item) => item.id);
72
+ for (const id of new Set(storyIds)) if (storyIds.filter((value) => value === id).length > 1) errors.push(`Duplicate story ID: ${id}.`);
73
+ for (const id of new Set(specIds)) if (specIds.filter((value) => value === id).length > 1) errors.push(`Duplicate output specification: ${id}.`);
74
+ for (const id of storyIds) if (!specIds.includes(id)) errors.push(`${label} is missing output specification for ${id}.`);
75
+ for (const id of specIds) if (!storyIds.includes(id)) errors.push(`${label} contains output specification for unknown story ${id}.`);
76
+ }
77
+
78
+ export function acceptanceBlocks(story, prefix) {
79
+ const matches = [...story.text.matchAll(new RegExp(`^####\\s+(${prefix}-\\d{3,})\\s+(.+)$`, "gm"))];
80
+ return matches.map((match, index) => ({
81
+ id: match[1],
82
+ title: match[2].trim(),
83
+ text: story.text.slice(match.index, matches[index + 1]?.index ?? story.text.length),
84
+ }));
85
+ }
86
+
87
+ export function validateAcceptance(block, owner, errors) {
88
+ const labels = ["Given", "When", "Then", "异常场景"];
89
+ const positions = labels.map((label) => ({ label, index: block.search(new RegExp(`^${label}[::]`, "m")) }));
90
+ for (const item of positions) if (item.index < 0) errors.push(`${owner} is missing ${item.label}.`);
91
+ if (positions.some((item) => item.index < 0)) return;
92
+ const counts = positions.map((item, index) => {
93
+ const end = positions[index + 1]?.index ?? block.length;
94
+ return (block.slice(item.index, end).match(/^-\s+\S.+$/gm) ?? []).length;
95
+ });
96
+ if (counts[0] < 1 || counts[1] < 1 || counts[2] < 2 || counts[3] < 1) {
97
+ errors.push(`${owner} must contain at least 1 Given, 1 When, 2 Then, and 1 exception bullet.`);
98
+ }
99
+ if (counts.reduce((sum, count) => sum + count, 0) < 6) errors.push(`${owner} must contain at least six concrete bullets.`);
100
+ if (!/(?:不得|不应|禁止|保留|恢复|重试|兜底|回滚|disabled)/.test(block)) {
101
+ errors.push(`${owner} must include an observable protection or recovery result.`);
102
+ }
103
+ }
104
+
105
+ export function containsUnresolvedBlockingPriority(block) {
106
+ if (!block) return false;
107
+ return block.split(/\r?\n/).slice(1).some((line) => {
108
+ const plain = line.trim().replace(/^[-*+]\s*/, "").replace(/^\[[ xX]\]\s*/, "");
109
+ if (!/\bP[01]\b/.test(plain)) return false;
110
+ if (/^(?:不存在|没有|无)(?:任何)?(?:尚未|未)?(?:解决|确认|关闭|完成)?(?:的)?\s*P[01]\b/.test(plain)) return false;
111
+ if (/^P[01]\b/.test(plain)) return true;
112
+ return /(?:pending(?:-blocking)?|unresolved|未解决|未确认|待确认|未决|阻塞)/i.test(plain);
113
+ });
114
+ }
115
+
116
+ export function assertHeadings(text, level, required, errors, owner) {
117
+ for (const title of required) {
118
+ const matches = sections(text, level, title);
119
+ if (matches.length !== 1) errors.push(`${owner} must contain exactly one ${title} heading.`);
120
+ else if (!hasSubstance(matches[0].text)) errors.push(`${owner} section ${title} must not be empty.`);
121
+ }
122
+ }
123
+
124
+ export function printResult(label, path, errors) {
125
+ if (errors.length) {
126
+ console.error(`${label} validation failed (${errors.length}):`);
127
+ for (const error of errors) console.error(`- ${error}`);
128
+ process.exit(1);
129
+ }
130
+ console.log(`${label} validation passed: ${path}`);
131
+ }
132
+
133
+ export function validateArtifactLocation(artifact, errors, expectedName) {
134
+ const requirementId = metadata(artifact.text, "requirement_id");
135
+ const projectRootValue = metadata(artifact.text, "project_root");
136
+ if (!requirementId || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(requirementId)) {
137
+ errors.push("requirement_id must use lowercase letters, digits, and single hyphens.");
138
+ return;
139
+ }
140
+ if (!projectRootValue) {
141
+ errors.push("project_root is required.");
142
+ return;
143
+ }
144
+ const projectRoot = resolve(dirname(artifact.path), projectRootValue);
145
+ if (!existsSync(projectRoot) || !statSync(projectRoot).isDirectory()) {
146
+ errors.push(`project_root does not resolve to an existing directory: ${projectRoot}`);
147
+ return;
148
+ }
149
+ const expected = resolve(join(projectRoot, "docs", "product-analysis", requirementId));
150
+ if (dirname(artifact.path) !== expected) {
151
+ errors.push(`Artifact must be located under ${expected}.`);
152
+ }
153
+ if (expectedName && basename(artifact.path) !== expectedName) {
154
+ errors.push(`Artifact filename must be ${expectedName}.`);
155
+ }
156
+ }
@@ -1,103 +1,103 @@
1
- #!/usr/bin/env node
2
-
3
- import puppeteer from "puppeteer-core";
4
- import { Readability } from "@mozilla/readability";
5
- import { JSDOM } from "jsdom";
6
- import TurndownService from "turndown";
7
- import { gfm } from "turndown-plugin-gfm";
8
-
9
- // Global timeout - exit if script takes too long
10
- const TIMEOUT = 30000;
11
- const timeoutId = setTimeout(() => {
12
- console.error("✗ Timeout after 30s");
13
- process.exit(1);
14
- }, TIMEOUT).unref();
15
-
16
- const url = process.argv[2];
17
-
18
- if (!url) {
19
- console.log("Usage: browser-content.js <url>");
20
- console.log("\nExtracts readable content from a URL as markdown.");
21
- console.log("\nExamples:");
22
- console.log(" browser-content.js https://example.com");
23
- console.log(" browser-content.js https://en.wikipedia.org/wiki/Rust_(programming_language)");
24
- process.exit(1);
25
- }
26
-
27
- const b = await Promise.race([
28
- puppeteer.connect({
29
- browserURL: "http://localhost:9222",
30
- defaultViewport: null,
31
- }),
32
- new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
33
- ]).catch((e) => {
34
- console.error("✗ Could not connect to browser:", e.message);
35
- console.error(" Run: browser-start.js");
36
- process.exit(1);
37
- });
38
-
39
- const p = (await b.pages()).at(-1);
40
- if (!p) {
41
- console.error("✗ No active tab found");
42
- process.exit(1);
43
- }
44
-
45
- await Promise.race([
46
- p.goto(url, { waitUntil: "networkidle2" }),
47
- new Promise((r) => setTimeout(r, 10000)),
48
- ]).catch(() => {});
49
-
50
- // Get HTML via CDP (works even with TrustedScriptURL restrictions)
51
- const client = await p.createCDPSession();
52
- const { root } = await client.send("DOM.getDocument", { depth: -1, pierce: true });
53
- const { outerHTML } = await client.send("DOM.getOuterHTML", { nodeId: root.nodeId });
54
- await client.detach();
55
-
56
- const finalUrl = p.url();
57
-
58
- // Extract with Readability
59
- const doc = new JSDOM(outerHTML, { url: finalUrl });
60
- const reader = new Readability(doc.window.document);
61
- const article = reader.parse();
62
-
63
- // Convert to markdown
64
- function htmlToMarkdown(html) {
65
- const turndown = new TurndownService({ headingStyle: "atx", codeBlockStyle: "fenced" });
66
- turndown.use(gfm);
67
- turndown.addRule("removeEmptyLinks", {
68
- filter: (node) => node.nodeName === "A" && !node.textContent?.trim(),
69
- replacement: () => "",
70
- });
71
- return turndown
72
- .turndown(html)
73
- .replace(/\[\\?\[\s*\\?\]\]\([^)]*\)/g, "")
74
- .replace(/ +/g, " ")
75
- .replace(/\s+,/g, ",")
76
- .replace(/\s+\./g, ".")
77
- .replace(/\n{3,}/g, "\n\n")
78
- .trim();
79
- }
80
-
81
- let content;
82
- if (article && article.content) {
83
- content = htmlToMarkdown(article.content);
84
- } else {
85
- // Fallback
86
- const fallbackDoc = new JSDOM(outerHTML, { url: finalUrl });
87
- const fallbackBody = fallbackDoc.window.document;
88
- fallbackBody.querySelectorAll("script, style, noscript, nav, header, footer, aside").forEach((el) => el.remove());
89
- const main = fallbackBody.querySelector("main, article, [role='main'], .content, #content") || fallbackBody.body;
90
- const fallbackHtml = main?.innerHTML || "";
91
- if (fallbackHtml.trim().length > 100) {
92
- content = htmlToMarkdown(fallbackHtml);
93
- } else {
94
- content = "(Could not extract content)";
95
- }
96
- }
97
-
98
- console.log(`URL: ${finalUrl}`);
99
- if (article?.title) console.log(`Title: ${article.title}`);
100
- console.log("");
101
- console.log(content);
102
-
103
- process.exit(0);
1
+ #!/usr/bin/env node
2
+
3
+ import puppeteer from "puppeteer-core";
4
+ import { Readability } from "@mozilla/readability";
5
+ import { JSDOM } from "jsdom";
6
+ import TurndownService from "turndown";
7
+ import { gfm } from "turndown-plugin-gfm";
8
+
9
+ // Global timeout - exit if script takes too long
10
+ const TIMEOUT = 30000;
11
+ const timeoutId = setTimeout(() => {
12
+ console.error("✗ Timeout after 30s");
13
+ process.exit(1);
14
+ }, TIMEOUT).unref();
15
+
16
+ const url = process.argv[2];
17
+
18
+ if (!url) {
19
+ console.log("Usage: browser-content.js <url>");
20
+ console.log("\nExtracts readable content from a URL as markdown.");
21
+ console.log("\nExamples:");
22
+ console.log(" browser-content.js https://example.com");
23
+ console.log(" browser-content.js https://en.wikipedia.org/wiki/Rust_(programming_language)");
24
+ process.exit(1);
25
+ }
26
+
27
+ const b = await Promise.race([
28
+ puppeteer.connect({
29
+ browserURL: "http://localhost:9222",
30
+ defaultViewport: null,
31
+ }),
32
+ new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
33
+ ]).catch((e) => {
34
+ console.error("✗ Could not connect to browser:", e.message);
35
+ console.error(" Run: browser-start.js");
36
+ process.exit(1);
37
+ });
38
+
39
+ const p = (await b.pages()).at(-1);
40
+ if (!p) {
41
+ console.error("✗ No active tab found");
42
+ process.exit(1);
43
+ }
44
+
45
+ await Promise.race([
46
+ p.goto(url, { waitUntil: "networkidle2" }),
47
+ new Promise((r) => setTimeout(r, 10000)),
48
+ ]).catch(() => {});
49
+
50
+ // Get HTML via CDP (works even with TrustedScriptURL restrictions)
51
+ const client = await p.createCDPSession();
52
+ const { root } = await client.send("DOM.getDocument", { depth: -1, pierce: true });
53
+ const { outerHTML } = await client.send("DOM.getOuterHTML", { nodeId: root.nodeId });
54
+ await client.detach();
55
+
56
+ const finalUrl = p.url();
57
+
58
+ // Extract with Readability
59
+ const doc = new JSDOM(outerHTML, { url: finalUrl });
60
+ const reader = new Readability(doc.window.document);
61
+ const article = reader.parse();
62
+
63
+ // Convert to markdown
64
+ function htmlToMarkdown(html) {
65
+ const turndown = new TurndownService({ headingStyle: "atx", codeBlockStyle: "fenced" });
66
+ turndown.use(gfm);
67
+ turndown.addRule("removeEmptyLinks", {
68
+ filter: (node) => node.nodeName === "A" && !node.textContent?.trim(),
69
+ replacement: () => "",
70
+ });
71
+ return turndown
72
+ .turndown(html)
73
+ .replace(/\[\\?\[\s*\\?\]\]\([^)]*\)/g, "")
74
+ .replace(/ +/g, " ")
75
+ .replace(/\s+,/g, ",")
76
+ .replace(/\s+\./g, ".")
77
+ .replace(/\n{3,}/g, "\n\n")
78
+ .trim();
79
+ }
80
+
81
+ let content;
82
+ if (article && article.content) {
83
+ content = htmlToMarkdown(article.content);
84
+ } else {
85
+ // Fallback
86
+ const fallbackDoc = new JSDOM(outerHTML, { url: finalUrl });
87
+ const fallbackBody = fallbackDoc.window.document;
88
+ fallbackBody.querySelectorAll("script, style, noscript, nav, header, footer, aside").forEach((el) => el.remove());
89
+ const main = fallbackBody.querySelector("main, article, [role='main'], .content, #content") || fallbackBody.body;
90
+ const fallbackHtml = main?.innerHTML || "";
91
+ if (fallbackHtml.trim().length > 100) {
92
+ content = htmlToMarkdown(fallbackHtml);
93
+ } else {
94
+ content = "(Could not extract content)";
95
+ }
96
+ }
97
+
98
+ console.log(`URL: ${finalUrl}`);
99
+ if (article?.title) console.log(`Title: ${article.title}`);
100
+ console.log("");
101
+ console.log(content);
102
+
103
+ process.exit(0);
@@ -1,35 +1,35 @@
1
- #!/usr/bin/env node
2
-
3
- import puppeteer from "puppeteer-core";
4
-
5
- const b = await Promise.race([
6
- puppeteer.connect({
7
- browserURL: "http://localhost:9222",
8
- defaultViewport: null,
9
- }),
10
- new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
11
- ]).catch((e) => {
12
- console.error("✗ Could not connect to browser:", e.message);
13
- console.error(" Run: browser-start.js");
14
- process.exit(1);
15
- });
16
-
17
- const p = (await b.pages()).at(-1);
18
-
19
- if (!p) {
20
- console.error("✗ No active tab found");
21
- process.exit(1);
22
- }
23
-
24
- const cookies = await p.cookies();
25
-
26
- for (const cookie of cookies) {
27
- console.log(`${cookie.name}: ${cookie.value}`);
28
- console.log(` domain: ${cookie.domain}`);
29
- console.log(` path: ${cookie.path}`);
30
- console.log(` httpOnly: ${cookie.httpOnly}`);
31
- console.log(` secure: ${cookie.secure}`);
32
- console.log("");
33
- }
34
-
35
- await b.disconnect();
1
+ #!/usr/bin/env node
2
+
3
+ import puppeteer from "puppeteer-core";
4
+
5
+ const b = await Promise.race([
6
+ puppeteer.connect({
7
+ browserURL: "http://localhost:9222",
8
+ defaultViewport: null,
9
+ }),
10
+ new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
11
+ ]).catch((e) => {
12
+ console.error("✗ Could not connect to browser:", e.message);
13
+ console.error(" Run: browser-start.js");
14
+ process.exit(1);
15
+ });
16
+
17
+ const p = (await b.pages()).at(-1);
18
+
19
+ if (!p) {
20
+ console.error("✗ No active tab found");
21
+ process.exit(1);
22
+ }
23
+
24
+ const cookies = await p.cookies();
25
+
26
+ for (const cookie of cookies) {
27
+ console.log(`${cookie.name}: ${cookie.value}`);
28
+ console.log(` domain: ${cookie.domain}`);
29
+ console.log(` path: ${cookie.path}`);
30
+ console.log(` httpOnly: ${cookie.httpOnly}`);
31
+ console.log(` secure: ${cookie.secure}`);
32
+ console.log("");
33
+ }
34
+
35
+ await b.disconnect();