@tea-agent/loop-agent 0.38.1 → 0.38.3

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 (180) hide show
  1. package/CHANGELOG.md +126 -12
  2. package/README.md +2 -0
  3. package/bin/loop-agent.js +7 -3
  4. package/dist/application/dag/generate-task-dag.js +9 -0
  5. package/dist/application/task-lifecycle/advance.js +4 -0
  6. package/dist/build-stamp.json +3 -3
  7. package/dist/commands/init.js +2 -14
  8. package/dist/commands/task-advance.js +31 -0
  9. package/dist/executors/dag-pi-executor.js +99 -5
  10. package/dist/executors/pi-event-serializer.js +42 -1
  11. package/dist/executors/pi-executor.js +51 -0
  12. package/dist/executors/pi-extension-resolver.js +233 -0
  13. package/dist/executors/pi-sdk-executor.js +187 -59
  14. package/dist/executors/shell-executor.js +324 -16
  15. package/dist/executors/shell-write-guard.js +7 -0
  16. package/dist/governance/manifest-types.js +0 -2
  17. package/dist/shared/operator/capabilities.js +87 -22
  18. package/dist/task/config-types.js +22 -0
  19. package/dist/task/contract/constants.js +1 -0
  20. package/dist/task/contract/diff.js +26 -0
  21. package/dist/task/contract/project.js +5 -0
  22. package/dist/task/contract/schema.js +6 -1
  23. package/dist/task/source-prepare/build-draft.js +15 -0
  24. package/dist/worker/console/chat/deferred-turn.js +91 -0
  25. package/dist/worker/console/chat/pi-runtime.js +10 -5
  26. package/dist/worker/console/chat/routes.js +458 -47
  27. package/dist/worker/console/chat/semantic-activity.js +13 -13
  28. package/dist/worker/console/chat/session-store.js +146 -2
  29. package/dist/worker/console/harness-pi-model-matrix.js +2 -11
  30. package/dist/worker/console/operator-actions.js +5 -4
  31. package/dist/worker/console/pi-readiness.js +5 -4
  32. package/dist/worker/console/recovery-cta.js +4 -4
  33. package/dist/worker/console/recovery-error-copy.js +4 -4
  34. package/dist/worker/console/server.js +6 -1
  35. package/dist/worker/console/static/assets/{abnfDiagram-N423BO3Z-Hfsot6rP.js → abnfDiagram-N423BO3Z-C4kVYweA.js} +1 -1
  36. package/dist/worker/console/static/assets/{arc-YGwEASin.js → arc-Bj2M8iO5.js} +1 -1
  37. package/dist/worker/console/static/assets/{architectureDiagram-T3A2C74G-CmOM0F92.js → architectureDiagram-T3A2C74G-CLlXe4-6.js} +1 -1
  38. package/dist/worker/console/static/assets/{blockDiagram-VBNYF7ZC-DDLuaHC5.js → blockDiagram-VBNYF7ZC-psEp5xH0.js} +1 -1
  39. package/dist/worker/console/static/assets/{c4Diagram-5PPSVZJV-B0Um43W4.js → c4Diagram-5PPSVZJV-DeKcOCGJ.js} +1 -1
  40. package/dist/worker/console/static/assets/channel-CPF4N7pf.js +1 -0
  41. package/dist/worker/console/static/assets/{chunk-2GRJ4B5K-DvBN4JZc.js → chunk-2GRJ4B5K-K0C744p1.js} +1 -1
  42. package/dist/worker/console/static/assets/{chunk-2Q5K7J3B-B1UVgW4E.js → chunk-2Q5K7J3B-xbNw4J9-.js} +1 -1
  43. package/dist/worker/console/static/assets/{chunk-5RXB4S5H-Cf0GgXzX.js → chunk-5RXB4S5H-DjLaSDUO.js} +1 -1
  44. package/dist/worker/console/static/assets/{chunk-5VM5RSS4-DbNA24sj.js → chunk-5VM5RSS4-CtiPlKel.js} +1 -1
  45. package/dist/worker/console/static/assets/{chunk-6Q2QTUOP-Bi_0Be06.js → chunk-6Q2QTUOP-DZtolir7.js} +1 -1
  46. package/dist/worker/console/static/assets/{chunk-GF5L2VYU-C8pPGvRd.js → chunk-GF5L2VYU-CPcdNeew.js} +1 -1
  47. package/dist/worker/console/static/assets/{chunk-JWPE2WC7-BitQY8Z-.js → chunk-JWPE2WC7-NgHc6V37.js} +1 -1
  48. package/dist/worker/console/static/assets/{chunk-KBJHAD2P-U67GCiEo.js → chunk-KBJHAD2P-DQ_T-hg8.js} +1 -1
  49. package/dist/worker/console/static/assets/{chunk-RYQCIY6F-IoJwXPBA.js → chunk-RYQCIY6F-DgLsxcVP.js} +1 -1
  50. package/dist/worker/console/static/assets/{chunk-XXDRQBXY-YDZ_UHgE.js → chunk-XXDRQBXY-UrVoM9z1.js} +1 -1
  51. package/dist/worker/console/static/assets/classDiagram-JCYQIIEL-C2DwA_Y1.js +1 -0
  52. package/dist/worker/console/static/assets/classDiagram-v2-OCEON4UE-C2DwA_Y1.js +1 -0
  53. package/dist/worker/console/static/assets/{cose-bilkent-JH36ORCC-CUZgsiRC.js → cose-bilkent-JH36ORCC-CLkYvTb3.js} +1 -1
  54. package/dist/worker/console/static/assets/{cynefin-VYW2F7L2-COmCh4pT.js → cynefin-VYW2F7L2-BwT_xKrE.js} +1 -1
  55. package/dist/worker/console/static/assets/{cynefinDiagram-MW4NZA55-Ta6FSm68.js → cynefinDiagram-MW4NZA55-Bi9tuzif.js} +1 -1
  56. package/dist/worker/console/static/assets/{dagre-VZM6K2ZE-UdcR-VW9.js → dagre-VZM6K2ZE-BCIqkWBV.js} +1 -1
  57. package/dist/worker/console/static/assets/{diagram-7IWD3JNH-DybcO3Et.js → diagram-7IWD3JNH-Dip6l9_Z.js} +1 -1
  58. package/dist/worker/console/static/assets/{diagram-B4RE2ZJO-wErDFWLw.js → diagram-B4RE2ZJO-B-xkh_wK.js} +1 -1
  59. package/dist/worker/console/static/assets/{diagram-LBJQPF4R-DkVHZWqz.js → diagram-LBJQPF4R-DZO0kTt_.js} +1 -1
  60. package/dist/worker/console/static/assets/{diagram-Q27KOJAE-DdqWs7QN.js → diagram-Q27KOJAE-D6ZplNbZ.js} +1 -1
  61. package/dist/worker/console/static/assets/{diagram-UB23O5K3-C9dMVmDo.js → diagram-UB23O5K3-BPekbhoS.js} +1 -1
  62. package/dist/worker/console/static/assets/{ebnfDiagram-BXEA7PRR-B2T2WcBK.js → ebnfDiagram-BXEA7PRR-BtmaJpK5.js} +1 -1
  63. package/dist/worker/console/static/assets/{erDiagram-JOGREHBK-Bt9rjDFq.js → erDiagram-JOGREHBK-6DS0Xc44.js} +1 -1
  64. package/dist/worker/console/static/assets/{flowDiagram-UKHOOZJN-U8ic_tvi.js → flowDiagram-UKHOOZJN-CihnROSm.js} +1 -1
  65. package/dist/worker/console/static/assets/{ganttDiagram-PKOTCBZU-BfQJdQoO.js → ganttDiagram-PKOTCBZU-CZC4zOE2.js} +1 -1
  66. package/dist/worker/console/static/assets/{gitGraphDiagram-DS77QQ5N-CpMftH4O.js → gitGraphDiagram-DS77QQ5N-Dq1fhzGN.js} +1 -1
  67. package/dist/worker/console/static/assets/index-DTZOKgAn.js +404 -0
  68. package/dist/worker/console/static/assets/index-Ya5FE7cD.css +1 -0
  69. package/dist/worker/console/static/assets/{infoDiagram-6WML65LV-DzqWXNO_.js → infoDiagram-6WML65LV-DlSl4BGx.js} +1 -1
  70. package/dist/worker/console/static/assets/{ishikawaDiagram-WSZJBQD7-CJmGQ5Yp.js → ishikawaDiagram-WSZJBQD7-snnzFl_U.js} +1 -1
  71. package/dist/worker/console/static/assets/{journeyDiagram-NVQOT4AX-ChPtKFLz.js → journeyDiagram-NVQOT4AX-BDE7qpMx.js} +1 -1
  72. package/dist/worker/console/static/assets/{kanban-definition-27J2QSJJ-PRe7wB5u.js → kanban-definition-27J2QSJJ-CD2Ci04G.js} +1 -1
  73. package/dist/worker/console/static/assets/{linear-DpKX6QNp.js → linear-DdnapKIH.js} +1 -1
  74. package/dist/worker/console/static/assets/{mermaid.core-Dnl76b7Y.js → mermaid.core-BVjAT9b8.js} +5 -5
  75. package/dist/worker/console/static/assets/{mindmap-definition-FAOFIHXS-S9PCXc3J.js → mindmap-definition-FAOFIHXS-D0yJk-zA.js} +1 -1
  76. package/dist/worker/console/static/assets/{pegDiagram-VL7TDLO6-Du8e-FSX.js → pegDiagram-VL7TDLO6-BVo9tFP-.js} +1 -1
  77. package/dist/worker/console/static/assets/{pieDiagram-7S7Q4E2Y-CY6OmHTc.js → pieDiagram-7S7Q4E2Y-DnOV-mZ_.js} +1 -1
  78. package/dist/worker/console/static/assets/{quadrantDiagram-CIZ2JOQS-C65GPhpj.js → quadrantDiagram-CIZ2JOQS-CzUJo58i.js} +1 -1
  79. package/dist/worker/console/static/assets/{railroadDiagram-AXF67PYL-U6IUiTCL.js → railroadDiagram-AXF67PYL-Bvikrolh.js} +1 -1
  80. package/dist/worker/console/static/assets/{requirementDiagram-LRYGKXZP-D-I_9Qhi.js → requirementDiagram-LRYGKXZP-DtaSVCap.js} +1 -1
  81. package/dist/worker/console/static/assets/{sankeyDiagram-W5VNT64P-B57Fhed0.js → sankeyDiagram-W5VNT64P-C2c9A0wW.js} +1 -1
  82. package/dist/worker/console/static/assets/{sequenceDiagram-SI44F4Z6-CJOtiw21.js → sequenceDiagram-SI44F4Z6-DmXJcU7r.js} +1 -1
  83. package/dist/worker/console/static/assets/{sizeCapture-X5ZJPWSS-FyX8zxSh.js → sizeCapture-X5ZJPWSS-B4GUFW92.js} +1 -1
  84. package/dist/worker/console/static/assets/{stateDiagram-OKZ733FA-eF-pbs9t.js → stateDiagram-OKZ733FA-Dsad2MXf.js} +1 -1
  85. package/dist/worker/console/static/assets/stateDiagram-v2-UEYNNEHI-B8FB_cNk.js +1 -0
  86. package/dist/worker/console/static/assets/{swimlanes-SLNWSIFB-CcfkA-Dq.js → swimlanes-SLNWSIFB-DGq48Fbi.js} +2 -2
  87. package/dist/worker/console/static/assets/swimlanesDiagram-ULZ7WXOC-CrZYaWfx.js +8 -0
  88. package/dist/worker/console/static/assets/{timeline-definition-Z64GVDOM-DH8FjnOK.js → timeline-definition-Z64GVDOM-CSSi6OFf.js} +1 -1
  89. package/dist/worker/console/static/assets/{vennDiagram-T6HMQDX7-beoTagJg.js → vennDiagram-T6HMQDX7-BqyzPrWv.js} +1 -1
  90. package/dist/worker/console/static/assets/{wardleyDiagram-T6FBY63Y-CQSfw4cK.js → wardleyDiagram-T6FBY63Y-DlznVb6S.js} +1 -1
  91. package/dist/worker/console/static/assets/{xychartDiagram-ELKLHX3M-CQgzQ6jn.js → xychartDiagram-ELKLHX3M-CfBcgJ_K.js} +1 -1
  92. package/dist/worker/console/static/index.html +2 -2
  93. package/dist/worker/console/static-src/app/console-types.js +0 -12
  94. package/dist/worker/console/static-src/app/useOperatorActions.js +1 -1
  95. package/dist/worker/console/static-src/app/useRecoveryActions.js +2 -2
  96. package/dist/worker/console/static-src/operator-chat/chat-sse-events.js +38 -1
  97. package/dist/worker/console/static-src/operator-chat/open-preview-in-browser.js +328 -0
  98. package/dist/worker/console/static-src/operator-chat/turn-stream-controller.js +8 -1
  99. package/dist/worker/console/static-src/operator-chat/turn-submission.js +42 -0
  100. package/dist/worker/console/static-src/operator-chat/useChatSessions.js +3 -0
  101. package/dist/worker/console/static-src/operator-chat/useChatStream.js +204 -11
  102. package/dist/worker/console/static-src/operator-chat/useChatThread.js +23 -1
  103. package/dist/worker/observe/node-input.js +72 -3
  104. package/dist/worker/observe/static/dag-history-labels.js +4 -0
  105. package/dist/worker/observe/static/state.js +2 -2
  106. package/dist/worker/observe/static/views/dag-inspector.js +51 -0
  107. package/dist/worker/observe/static/views/session-timeline.js +18 -5
  108. package/dist/workflows/dag/backend-test-case-coverage-analysis.js +809 -53
  109. package/dist/workflows/dag/backend-test-case-manifest.js +4 -0
  110. package/dist/workflows/dag/backend-test-execution-contract.js +18 -9
  111. package/dist/workflows/dag/backend-test-gap-fill.js +205 -0
  112. package/dist/workflows/dag/backend-test-intake-context.js +32 -0
  113. package/dist/workflows/dag/backend-test-layout.js +133 -0
  114. package/dist/workflows/dag/backend-test-markdown-workflow.js +167 -32
  115. package/dist/workflows/dag/backend-test-module-stem.js +5 -0
  116. package/dist/workflows/dag/backend-test-pytest-collection.js +368 -33
  117. package/dist/workflows/dag/backend-test-result-contract.js +1 -1
  118. package/dist/workflows/dag/backend-test-scenario-param.js +884 -140
  119. package/dist/workflows/dag/backend-test-scenario-partitions.js +321 -0
  120. package/dist/workflows/dag/backend-test-writer-completeness.js +100 -56
  121. package/dist/workflows/dag/contract-output-registry.js +15 -0
  122. package/dist/workflows/dag/contract-validator-registrations.js +2 -1
  123. package/dist/workflows/dag/convergence/controller.js +141 -0
  124. package/dist/workflows/dag/dynamic-runtime/map.js +24 -8
  125. package/dist/workflows/dag/dynamic-runtime/shared.js +1 -1
  126. package/dist/workflows/dag/failure-category.js +4 -0
  127. package/dist/workflows/dag/frontend-implementation-contract.js +355 -26
  128. package/dist/workflows/dag/frontend-prewrite-gate.js +96 -84
  129. package/dist/workflows/dag/frontend-test-case-quality.js +5 -13
  130. package/dist/workflows/dag/frontend-test-environment-probe.js +227 -0
  131. package/dist/workflows/dag/frontend-test-markdown.js +61 -0
  132. package/dist/workflows/dag/frontend-test-result-contract.js +10 -18
  133. package/dist/workflows/dag/frontend-test-standard-scenarios.js +68 -0
  134. package/dist/workflows/dag/init-hybrid.js +720 -177
  135. package/dist/workflows/dag/node-execution.js +164 -26
  136. package/dist/workflows/dag/prompt.js +60 -1
  137. package/dist/workflows/dag/rerun-feedback.js +212 -0
  138. package/dist/workflows/dag/rerun-plan.js +112 -27
  139. package/dist/workflows/dag/rerun-run.js +3 -0
  140. package/dist/workflows/dag/rerun-task.js +61 -2
  141. package/dist/workflows/dag/retry-policy.js +18 -0
  142. package/dist/workflows/dag/structured-output-repair.js +712 -0
  143. package/dist/workflows/dag/types.js +121 -0
  144. package/dist/workflows/dag/validate.js +41 -1
  145. package/docs/operations/local-development-environment.md +1 -5
  146. package/docs/skills/vetted-skill-registry.md +14 -0
  147. package/docs/templates/README.md +1 -1
  148. package/docs/templates/agent-dag.schema.json +44 -0
  149. package/docs/templates/backend-test-dag.json +60 -35
  150. package/docs/templates/frontend-test-dag.json +8 -10
  151. package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +1 -1
  152. package/docs/templates/harness.schema.json +0 -8
  153. package/harness.json +1 -8
  154. package/package.json +8 -4
  155. package/skills/analyze-product-requirements/SKILL.md +8 -5
  156. package/skills/analyze-product-requirements/references/acceptance-criteria.md +1 -1
  157. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +10 -6
  158. package/skills/analyze-product-requirements/references/example.md +50 -0
  159. package/skills/analyze-product-requirements/references/forward-test-cases.md +11 -7
  160. package/skills/analyze-product-requirements/references/kb-integration.md +5 -5
  161. package/skills/analyze-product-requirements/references/product-analysis-schema.md +8 -4
  162. package/skills/analyze-product-requirements/references/product-requirement-schema.md +2 -2
  163. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +1 -1
  164. package/skills/analyze-product-requirements/scripts/test-validators.mjs +11 -1
  165. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +20 -1
  166. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +9 -0
  167. package/skills/codebase-scout/SKILL.md +1 -1
  168. package/skills/frontend-implementation/references/node-contracts.md +2 -2
  169. package/skills/improve-codebase-architecture/SKILL.md +81 -0
  170. package/skills/improve-codebase-architecture/deepening.md +37 -0
  171. package/skills/improve-codebase-architecture/html-report.md +123 -0
  172. package/skills/improve-codebase-architecture/interface-design.md +44 -0
  173. package/skills/improve-codebase-architecture/language.md +53 -0
  174. package/dist/worker/console/static/assets/channel-Dp_2Aqf1.js +0 -1
  175. package/dist/worker/console/static/assets/classDiagram-JCYQIIEL--CODy37j.js +0 -1
  176. package/dist/worker/console/static/assets/classDiagram-v2-OCEON4UE--CODy37j.js +0 -1
  177. package/dist/worker/console/static/assets/index-BA5-N5ER.css +0 -1
  178. package/dist/worker/console/static/assets/index-DKPXBrdc.js +0 -325
  179. package/dist/worker/console/static/assets/stateDiagram-v2-UEYNNEHI-B-mvnLEc.js +0 -1
  180. package/dist/worker/console/static/assets/swimlanesDiagram-ULZ7WXOC-JtpBmIv4.js +0 -8
@@ -10,6 +10,18 @@ export const dagNodeExecutorSchema = z.enum(["pi", "shell", "static"]);
10
10
  export const CURSOR_DAG_EXECUTOR_REMOVED_ERROR = 'executor "cursor" is no longer supported; regenerate the DAG with Pi-only writers (implement-pi / repair-pi)';
11
11
  export const CURSOR_EXECUTOR_MODELS_REMOVED_ERROR = "executorModels.cursor is no longer supported; use executorModels.pi only";
12
12
  export const dagToolProfileSchema = z.enum(["read-only", "write"]);
13
+ /**
14
+ * Frozen Pi extension short ids for backend implementation DAGs (plan
15
+ * 2026-08-21 D2): the DAG carries only these ids; the executor resolves them
16
+ * against the Pi settings package inventory at run time. Adding a package
17
+ * requires changing this enum and the plan.
18
+ */
19
+ export const dagPiExtensionIdSchema = z.enum(["pi-codegraph", "pi-lens"]);
20
+ /** Node-level explicit Pi extension allowlist (omitted = all off, R8.1). */
21
+ export const dagPiExtensionsSchema = z
22
+ .array(dagPiExtensionIdSchema)
23
+ .min(1)
24
+ .transform((ids) => Array.from(new Set(ids)));
13
25
  /** Static command capabilities only; tasks cannot inject executables or shell prefixes. */
14
26
  export const dagCommandCapabilitySchema = z.enum(["playwright-cli"]);
15
27
  export const dagCommandPolicySchema = z.discriminatedUnion("mode", [
@@ -423,8 +435,12 @@ export const dagBackendTestPipelineSchema = z.enum([
423
435
  "markdown-scenario-param",
424
436
  "markdown-execute-html",
425
437
  "markdown-manifest",
438
+ "markdown-report",
439
+ "ingest-backend-test-gap",
426
440
  ]);
427
441
  export const dagFrontendBrowserToolPreflightSchema = z.object({}).strict();
442
+ export const dagFrontendTestStandardScenariosSchema = z.object({}).strict();
443
+ export const dagFrontendTestEnvironmentProbeSchema = z.object({}).strict();
428
444
  export const dagFrontendTestEvidenceValidationSchema = z.object({}).strict();
429
445
  export const dagFrontendTestCaseChecklistSchema = z.object({}).strict();
430
446
  export const dagFrontendTestHtmlReportSchema = z.object({}).strict();
@@ -515,6 +531,8 @@ export const dagShellConfigSchema = z.object({
515
531
  frontendReviewContext: dagFrontendReviewContextSchema.optional(),
516
532
  frontendTestCaseChecklist: dagFrontendTestCaseChecklistSchema.optional(),
517
533
  frontendBrowserToolPreflight: dagFrontendBrowserToolPreflightSchema.optional(),
534
+ frontendTestStandardScenarios: dagFrontendTestStandardScenariosSchema.optional(),
535
+ frontendTestEnvironmentProbe: dagFrontendTestEnvironmentProbeSchema.optional(),
518
536
  frontendTestEvidenceValidation: dagFrontendTestEvidenceValidationSchema.optional(),
519
537
  finalWriteSetApprovalGate: dagFinalWriteSetApprovalGateSchema.optional(),
520
538
  frontendTestL5Report: z.object({}).strict().optional(),
@@ -600,6 +618,13 @@ export const dagDynamicExpansionSchema = z.object({
600
618
  maxTotalTokens: z.number().int().positive().optional(),
601
619
  })
602
620
  .optional(),
621
+ /**
622
+ * When true, any child blocked by the aggregate token budget fails the map
623
+ * barrier instead of being retained as a case-level blocked outcome.
624
+ * Backend-test enables this because partial Markdown/pytest module sets are
625
+ * invalid generation assets; frontend-test keeps the default false.
626
+ */
627
+ failOnTokenBudgetExhaustion: z.boolean().optional(),
603
628
  /**
604
629
  * When true, map child ERROR/auth/timeout is recorded as case-level
605
630
  * failed/blocked evidence and the map barrier still succeeds (frontend-test).
@@ -704,6 +729,7 @@ export const dagConvergenceSpecSchema = z
704
729
  */
705
730
  export const structuredContractOutputSchemaIds = [
706
731
  "frontend-implementation-contract-v1",
732
+ "frontend-implementation-contract-plan-patch-v1",
707
733
  "frontend-implementation-contract-revision-patch-v1",
708
734
  ];
709
735
  export const dagTaskSchema = z.object({ id: z.string().regex(/^[a-z][a-z0-9-]*$/, "task id must be kebab-case"),
@@ -739,6 +765,13 @@ export const dagTaskSchema = z.object({ id: z.string().regex(/^[a-z][a-z0-9-]*$/
739
765
  role: dagRoleSchema.optional(),
740
766
  skills: z.array(z.string()).optional(),
741
767
  toolProfile: dagToolProfileSchema.optional(),
768
+ /**
769
+ * Explicit Pi extension allowlist (backend implementation DAGs only):
770
+ * frozen short ids resolved at run time against the Pi settings package
771
+ * inventory. Omitted = extension discovery stays fully closed (R8.1).
772
+ * Only `executor: "pi"` nodes may declare it (validated fail-closed).
773
+ */
774
+ piExtensions: dagPiExtensionsSchema.optional(),
742
775
  /** Default deny: file write (toolProfile=write) does not grant command execution. */
743
776
  commandPolicy: dagCommandPolicySchema.optional(),
744
777
  writePolicy: dagWritePolicySchema.optional(),
@@ -766,8 +799,25 @@ export const dagTaskSchema = z.object({ id: z.string().regex(/^[a-z][a-z0-9-]*$/
766
799
  .object({
767
800
  schemaId: z.enum(structuredContractOutputSchemaIds),
768
801
  retryOnInvalid: z.boolean().default(true),
802
+ /**
803
+ * Optional deterministic base object for patch-producing structured
804
+ * nodes. The frontend plan patch validator applies the model delta to
805
+ * this run-owned skeleton before strict contract validation.
806
+ */
807
+ skeleton: z.record(z.string(), z.unknown()).optional(),
769
808
  })
770
809
  .strict()
810
+ .superRefine((value, ctx) => {
811
+ if (value.schemaId ===
812
+ "frontend-implementation-contract-plan-patch-v1" &&
813
+ !value.skeleton) {
814
+ ctx.addIssue({
815
+ code: "custom",
816
+ message: "frontend plan patch output requires a runtime skeleton",
817
+ path: ["skeleton"],
818
+ });
819
+ }
820
+ })
771
821
  .optional(),
772
822
  /**
773
823
  * Fail-closed outcome/diff consistency contract for bounded Pi writers.
@@ -846,6 +896,55 @@ export const dagSourceBindingSchema = z.object({
846
896
  .min(1),
847
897
  requirementIds: z.array(z.string().regex(/^(?:REQ|BR|AC)-[A-Z0-9]+(?:-[A-Z0-9]+)*$/)),
848
898
  });
899
+ const dagRerunFeedbackEvidencePathSchema = z
900
+ .string()
901
+ .min(1)
902
+ .refine((value) => !/^(?:[A-Za-z]:[\\/]|[\\/]{2}|\/)/.test(value), "rerun feedback evidence paths must be repository-relative");
903
+ /**
904
+ * Bounded unresolved verify/review feedback carried by a full task rerun.
905
+ * This is recovery context, not a mutation of the original task contract.
906
+ */
907
+ export const dagRerunFeedbackSchema = z
908
+ .object({
909
+ schemaVersion: z.literal(1),
910
+ kind: z.literal("unresolved-terminal-feedback"),
911
+ parentRunId: z.string().min(1),
912
+ taskId: z.string().min(1),
913
+ sourceNodeId: z.string().min(1),
914
+ verdict: z.enum(["request-revision", "fail"]).optional(),
915
+ failureCategory: z.string().min(1).optional(),
916
+ feedbackText: z.string().min(1).max(12_000),
917
+ evidenceRefs: z
918
+ .array(z
919
+ .object({
920
+ nodeId: z.string().min(1),
921
+ preservedNodeRecordPath: dagRerunFeedbackEvidencePathSchema,
922
+ })
923
+ .strict())
924
+ .max(8),
925
+ attemptSummary: z
926
+ .object({
927
+ completedPasses: z.number().int().positive(),
928
+ maxPasses: z.number().int().positive(),
929
+ terminalReason: z.string().min(1).optional(),
930
+ })
931
+ .strict(),
932
+ binding: z
933
+ .object({
934
+ sourceCanonicalHash: z
935
+ .string()
936
+ .regex(/^[a-f0-9]{64}$/)
937
+ .optional(),
938
+ taskContractCanonicalHash: z
939
+ .string()
940
+ .regex(/^[a-f0-9]{64}$/)
941
+ .optional(),
942
+ status: z.enum(["exact", "changed", "unknown"]),
943
+ })
944
+ .strict(),
945
+ digest: z.string().regex(/^[a-f0-9]{64}$/),
946
+ })
947
+ .strict();
849
948
  export const dagSpecSchema = z
850
949
  .object({
851
950
  version: dagVersionSchema,
@@ -857,6 +956,28 @@ export const dagSpecSchema = z
857
956
  sourceBinding: dagSourceBindingSchema.optional(),
858
957
  /** v4 managed Task Contract binding; only valid on version 4. */
859
958
  taskContractBinding: dagTaskContractBindingSchema.optional(),
959
+ /** Optional unresolved parent-run feedback for a full task rerun. */
960
+ rerunFeedback: dagRerunFeedbackSchema.optional(),
961
+ /** Frozen backend-test artifact layout (plan A); absent = historical default testcase/ layout. */
962
+ backendTestLayout: z
963
+ .object({
964
+ testRoot: z.string(),
965
+ markdownRel: z.string(),
966
+ scriptRel: z.string(),
967
+ markdownDir: z.string(),
968
+ scriptDir: z.string(),
969
+ readmePath: z.string(),
970
+ isDefault: z.boolean(),
971
+ })
972
+ .optional(),
973
+ /** Bound user shared-setup document (plan B); absent = no shared setup references expected. */
974
+ backendTestSharedSetup: z
975
+ .object({
976
+ path: z.string(),
977
+ readPath: z.string(),
978
+ sha256: z.string(),
979
+ })
980
+ .optional(),
860
981
  outputLanguage: dagOutputLanguageSchema.optional(),
861
982
  objective: z.string().optional(),
862
983
  successCriteria: z.array(z.string()).optional(),
@@ -1,4 +1,4 @@
1
- import { DEFAULT_DAG_EXECUTOR_MODELS, ENV_VAR_NAME_PATTERN, dagCommandPolicyAllows, resolveDagCommandPolicy, } from "./types.js";
1
+ import { DEFAULT_DAG_EXECUTOR_MODELS, ENV_VAR_NAME_PATTERN, dagCommandPolicyAllows, dagPiExtensionIdSchema, resolveDagCommandPolicy, } from "./types.js";
2
2
  import { resolveShellCommands } from "../../executors/shell-executor.js";
3
3
  import { pathMatchesPattern } from "../../shared/git-progress.js";
4
4
  import { resolveRepairTaskForGate } from "./repair-artifact.js";
@@ -465,6 +465,8 @@ function validateShellTaskConfig(task, spec, issues) {
465
465
  !shell.backendTestPipeline &&
466
466
  !shell.frontendPrewriteGate &&
467
467
  !shell.frontendBrowserToolPreflight &&
468
+ !shell.frontendTestStandardScenarios &&
469
+ !shell.frontendTestEnvironmentProbe &&
468
470
  !shell.frontendVerificationBundle &&
469
471
  !shell.frontendReviewContext &&
470
472
  !shell.frontendTestCaseChecklist &&
@@ -953,6 +955,7 @@ export function validateDagSpec(spec) {
953
955
  validateCommandPolicyTaskConfig(task, issues);
954
956
  validateDynamicChildCommandPolicy(task, issues);
955
957
  validateProjectGovernanceTaskConfig(task, spec, issues);
958
+ validatePiExtensionsTaskConfig(task, issues);
956
959
  validateFailureAwareDependsOn(task, spec, issues);
957
960
  }
958
961
  validateSameRankWriteSetConflicts(spec, ranks, issues);
@@ -963,6 +966,43 @@ export function validateDagSpec(spec) {
963
966
  }
964
967
  return issues;
965
968
  }
969
+ /**
970
+ * Fail-closed `piExtensions` validation (plan 2026-08-21 D1/D2):
971
+ * - only `executor: "pi"` nodes may declare it (shell/static reject);
972
+ * - unknown ids outside the frozen enum are rejected at parse time by zod,
973
+ * and here for task objects that bypass schema parsing;
974
+ * - closeout nodes must stay fully closed (extension-free) — the two-bucket
975
+ * generator never assigns it there, so any appearance is contract drift.
976
+ */
977
+ function validatePiExtensionsTaskConfig(task, issues) {
978
+ const ids = task.piExtensions;
979
+ if (ids === undefined)
980
+ return;
981
+ if (task.executor !== "pi") {
982
+ issues.push({
983
+ type: "invalid-pi-extensions-config",
984
+ message: `task ${task.id} piExtensions requires executor "pi" (found ${task.executor})`,
985
+ });
986
+ return;
987
+ }
988
+ const allowed = new Set(dagPiExtensionIdSchema.options);
989
+ for (const id of ids) {
990
+ if (!allowed.has(id)) {
991
+ issues.push({
992
+ type: "invalid-pi-extensions-config",
993
+ message: `task ${task.id} piExtensions has unknown id "${id}"; allowed: ${[
994
+ ...allowed,
995
+ ].join(", ")}`,
996
+ });
997
+ }
998
+ }
999
+ if (task.id === "closeout-pi" && ids.length > 0) {
1000
+ issues.push({
1001
+ type: "invalid-pi-extensions-config",
1002
+ message: "closeout-pi must stay extension-free (read buckets exclude closeout)",
1003
+ });
1004
+ }
1005
+ }
966
1006
  function validateProjectGovernanceTaskConfig(task, spec, issues) {
967
1007
  if (task.governanceStandardReview) {
968
1008
  if (task.executor !== "pi" ||
@@ -29,11 +29,7 @@ Cursor Cloud VM 当前有两个需要特别注意的环境问题。
29
29
 
30
30
  ### Node.js 版本
31
31
 
32
- VM 默认 `node`(`/exec-daemon/node`)可能是 v22.14.0,但可选依赖 `@earendil-works/pi-ai` / `@earendil-works/pi-coding-agent` 要求 Node.js `>=22.19.0`。版本过低时,`npm install` / `npm ci` 可能跳过这些依赖,随后 `npm run typecheck``npm run build` 会报告:
33
-
34
- ```text
35
- Cannot find module '@earendil-works/...'
36
- ```
32
+ VM 默认 `node`(`/exec-daemon/node`)可能是 v22.14.0,但根包与运行时依赖 `@earendil-works/pi-ai` / `@earendil-works/pi-coding-agent` 都要求 Node.js `>=22.19.0`。版本过低时,npm 默认模式会报告 `EBADENGINE` 警告;启用 `engine-strict` 时,`npm install` / `npm ci` 会直接失败。即使默认模式完成安装,也不应在不受支持的 Node.js 版本上继续执行 typecheck、buildruntime 命令。
37
33
 
38
34
  在 Cursor Cloud 中执行安装或验证前,先切换到已配置的 Node.js 22:
39
35
 
@@ -16,10 +16,22 @@ The entries below are local wrappers or existing local skills. They are not whol
16
16
  | `code-review-core` | local wrapper inspired by code review practice | `skills/code-review-core/SKILL.md` | reviewer | reviewer | No external tools or network by default. |
17
17
  | `codebase-scout` | local wrapper | `skills/codebase-scout/SKILL.md` | scout | scout | Read-only reconnaissance guidance. |
18
18
  | `init-capability-evolution` | local wrapper | `skills/init-capability-evolution/SKILL.md` | supervisor, maintenance | optional | Used only when changes may affect target-project initialization, package surface, or init projection rules. |
19
+ | `frontend-implementation` | local existing (frontend hybrid DAG) | `skills/frontend-implementation/SKILL.md` | frontend plan / contract / scout / mock nodes (spec-level `skillsByRole`) | frontend-implementation DAG only | Required refs node-contracts / design-spec / code-standards; injected by `init-hybrid.ts` spec generation and `src/adapters/loop-agent.ts`; projected via init-surface manifest. Not in `DEFAULT_SKILLS_BY_ROLE`. |
20
+ | `frontend-review` | local existing (frontend hybrid DAG) | `skills/frontend-review/SKILL.md` | reviewer (frontend review nodes, spec-level) | frontend-implementation / repair DAGs | Consumed by `init-hybrid.ts` / `frontend-repair.ts` / `shell-executor.ts`; required ref review-findings (maxChars 2800). |
21
+ | `frontend-verification` | local existing (frontend hybrid DAG) | `skills/frontend-verification/SKILL.md` | verifier / closeout (frontend evidence, spec-level) | frontend DAG closeout | Consumed by `shell-executor.ts` / `frontend-repair.ts` / `frontend-review-context.ts`; required ref verification-checklist. |
22
+ | `frontend-design-review` | local existing (frontend hybrid DAG) | `skills/frontend-design-review/SKILL.md` | design-gate reviewer (before any writer) | frontend-implementation DAG design gate | Injected by `init-hybrid.ts`; runs before the prewrite gate authorizes writers; required ref review-checklist. |
23
+ | `frontend-bounded-implement` | local existing (frontend hybrid DAG) | `skills/frontend-bounded-implement/SKILL.md` | implementer (writer nodes, spec-level) | frontend writers after canonical contract gate | Injected by `init-hybrid.ts`; writers run only after the canonical contract gate accepts and only inside the frozen writeSet (ADR 0015/0016 discipline). |
19
24
  | `grill-with-docs` | local operator skill adapted from domain grilling + ADR/glossary discipline | `skills/grill-with-docs/SKILL.md` | explicit interactive operator only | never a default DAG role | Resolves decisions via `harness.json.governanceRoot`; required refs `context-format.md` / `adr-format.md`; respects writeSet; not in `DEFAULT_SKILLS_BY_ROLE`. |
25
+ | `grill-me` | local interview question engine wrapper | `skills/grill-me/SKILL.md` | interview runtime dependency (not a DAG role) | never a default DAG role | Question engine lives in `src/worker/console/interview/grill-me.ts` (Console interview / operator-actions); intentionally NOT projected by init-surface manifest — runs in this repo's Console only. |
26
+ | `analyze-product-requirements` | local org-internal Product Analysis V4 skill | `skills/analyze-product-requirements/SKILL.md` | source-prepare dependency (not a DAG role) | never a default DAG role | Loaded by `src/task/source-prepare/prepare.ts` during 任务源 preparation; IRON-LAW freeze semantics on `product-analysis.md`; intentionally NOT projected by init-surface manifest. |
20
27
  | `webapp-testing` | local wrapper inspired by frontend/browser testing practice | `skills/webapp-testing/SKILL.md` | verifier, reviewer | optional | Only applies when task explicitly involves browser-rendered behavior; no default Playwright/Semgrep execution. |
21
28
  | `playwright-cli` | repo-local Playwright CLI instructions | `skills/playwright-cli/SKILL.md` | FE-test case executor | FE-test only | Direct browser commands require isolated test environments, per-case evidence paths, and explicit credential/data handling. |
22
29
  | `playwright-cli-case-generator` | adapted from the repo-local playwright CLI case-generator contract | `skills/playwright-cli-case-generator/SKILL.md` | FE-test case generator | FE-test only | Generates Markdown cases and a compact manifest from RAG facts; does not execute browsers, create test code, or invent API/data constraints. |
30
+ | `analyze-product-dependencies` | local org-internal product dependency analysis | `skills/analyze-product-dependencies/SKILL.md` | explicit interactive operator only | never a default DAG role | PRD → code/API mapping analysis; read-only; no runtime references; not projected. |
31
+ | `browser-tools` | local operator skill (CDP automation) | `skills/browser-tools/SKILL.md` | explicit interactive operator only | never a default DAG role | Requires user-visible Chrome with remote debugging (:9222); credential/data handling reviewed per use; not projected. |
32
+ | `local-jacoco-coverage` | local operator orchestration skill | `skills/local-jacoco-coverage/SKILL.md` | explicit interactive operator only | never a default DAG role | Orchestrates backend-test DAGs with a JaCoCo agent — it drives DAGs, so it must never be loaded by one (no recursion); not projected. |
33
+ | `using-git-worktrees` | local wrapper | `skills/using-git-worktrees/SKILL.md` | explicit interactive operator only | never a default DAG role | Workspace isolation guidance only; no runtime references; not projected. |
34
+ | `improve-codebase-architecture` | local operator skill (copied from shared agent platform 2026-08-21) | `skills/improve-codebase-architecture/SKILL.md` | explicit interactive operator only | never a default DAG role | Interactive architecture review producing a temp HTML report; reads CONTEXT.md glossary + `docs/decisions/` ADRs; cross-directory refs `../grill-with-docs/{context,adr}-format.md` are exempt (see Vetting Rules); not projected. |
23
35
 
24
36
  ## Verification placement taxonomy
25
37
 
@@ -42,6 +54,8 @@ Authoring vocabulary for where a check or verification skill should live. Prefer
42
54
  - Default role mappings may reference only repo-local skills that resolve cleanly under `dag validate --strict-skills`.
43
55
  - `agent-worker` is explicitly outside default role mappings. Its trigger description must cover `agent-worker`, Feature Packet, TaskSpec, Task Pool, self-host/candidate and the `loop-agent` routing boundary; `scripts/check-skill-entry.sh` enforces this public entry contract.
44
56
  - `grill-with-docs` is an explicit interactive operator skill only; it must stay outside `DEFAULT_SKILLS_BY_ROLE`.
57
+ - Registry ↔ disk sync: every `skills/*/SKILL.md` in the repo must have a row above. Operator-local skills are recorded with `never a default DAG role` instead of being omitted, so an audit cannot mistake them for drift.
58
+ - `improve-codebase-architecture` is exempt from the "references stay within the skill directory" rule: it is operator-only, never resolved by DAG skill snapshots, and reuses `grill-with-docs` context/ADR formats by relative path.
45
59
  - Optional/security/web skills remain task- or profile-specific until their tool, network, credential, and write behavior is reviewed.
46
60
  - This registry records source inspiration, not license clearance for vendored third-party content. Vendoring requires a separate license/security review.
47
61
  - `SKILL.md` is the entry point. References must be declared in frontmatter and stay within the skill directory.
@@ -30,7 +30,7 @@
30
30
 
31
31
  ## Backend-test
32
32
 
33
- - `backend-test-dag.json` — backend-test DAG 模板;其中 `generate-backend-md-cases-pi` 是唯一允许 `writer-empty-diff` 重试的 writer(总共两次,仅限 post-write-guard attribution 确认的空 diff)。
33
+ - `backend-test-dag.json` — backend-test DAG 模板;其中 `generate-backend-md-cases-pi` 是唯一允许 `writer-empty-diff` 重试的 writer(总共两次,仅限 post-write-guard attribution 确认的空 diff);N2/N5 合同限定 Scenario Partition 必须有源有限域。
34
34
  - `backend-test-dag.classify.prompt.md`、`backend-test-dag.generate-pytest.prompt.md`、`backend-test-dag.review-cases.prompt.md`、`backend-test-dag.retrospect.prompt.md` — 分类、生成、审查和复盘提示。
35
35
  - `backend-test-analysis.schema.json`、`backend-test-execution.schema.json`、`backend-test-result.schema.json`、`backend-test-case-manifest.schema.json` — 分析、执行、结果与用例清单 schema。
36
36
 
@@ -130,6 +130,18 @@
130
130
  "toolProfile": {
131
131
  "enum": ["read-only", "write"]
132
132
  },
133
+ "piExtensionId": {
134
+ "type": "string",
135
+ "enum": ["pi-codegraph", "pi-lens"],
136
+ "description": "Frozen Pi extension short id resolved at run time against the Pi settings package inventory. Adding a package requires changing the plan and this enum."
137
+ },
138
+ "piExtensions": {
139
+ "type": "array",
140
+ "minItems": 1,
141
+ "uniqueItems": true,
142
+ "items": { "$ref": "#/$defs/piExtensionId" },
143
+ "description": "Node-level explicit Pi extension allowlist (backend implementation DAGs only). Omitted = extension discovery stays fully closed (R8.1). Only executor 'pi' nodes may declare it."
144
+ },
133
145
  "role": {
134
146
  "enum": ["planner", "scout", "implementer", "reviewer", "supervisor", "verifier", "closeout"]
135
147
  },
@@ -356,6 +368,31 @@
356
368
  "properties": { "schemaVersion": { "const": 1 }, "requireBaseline": { "const": true } }
357
369
  },
358
370
  "frontendTestCaseChecklist": { "type": "object", "additionalProperties": false },
371
+ "frontendBrowserToolPreflight": { "type": "object", "additionalProperties": false },
372
+ "frontendTestStandardScenarios": { "type": "object", "additionalProperties": false },
373
+ "frontendTestEnvironmentProbe": { "type": "object", "additionalProperties": false },
374
+ "frontendTestCaseManifest": {
375
+ "type": "object",
376
+ "additionalProperties": false,
377
+ "properties": {
378
+ "maxCases": { "type": "integer", "minimum": 1 },
379
+ "declaredAcIds": { "type": "array", "items": { "type": "string" } }
380
+ }
381
+ },
382
+ "frontendTestResultFinalize": {
383
+ "type": "object",
384
+ "additionalProperties": false,
385
+ "properties": {
386
+ "declaredAcIds": { "type": "array", "items": { "type": "string" } }
387
+ }
388
+ },
389
+ "frontendTestReports": {
390
+ "type": "object",
391
+ "additionalProperties": false,
392
+ "properties": {
393
+ "l5": { "type": "boolean" }
394
+ }
395
+ },
359
396
  "frontendTestEvidenceValidation": { "type": "object", "additionalProperties": false },
360
397
  "frontendTestHtmlReport": { "type": "object", "additionalProperties": false },
361
398
  "backendTestPipeline": {
@@ -383,6 +420,12 @@
383
420
  { "required": ["frontendVerificationBundle"] },
384
421
  { "required": ["frontendReviewContext"] },
385
422
  { "required": ["frontendTestCaseChecklist"] },
423
+ { "required": ["frontendBrowserToolPreflight"] },
424
+ { "required": ["frontendTestStandardScenarios"] },
425
+ { "required": ["frontendTestEnvironmentProbe"] },
426
+ { "required": ["frontendTestCaseManifest"] },
427
+ { "required": ["frontendTestResultFinalize"] },
428
+ { "required": ["frontendTestReports"] },
386
429
  { "required": ["frontendTestEvidenceValidation"] },
387
430
  { "required": ["frontendTestHtmlReport"] },
388
431
  { "required": ["backendTestPipeline"] }
@@ -485,6 +528,7 @@
485
528
  "items": { "type": "string", "minLength": 1 }
486
529
  },
487
530
  "toolProfile": { "$ref": "#/$defs/toolProfile" },
531
+ "piExtensions": { "$ref": "#/$defs/piExtensions" },
488
532
  "governanceStandardReview": {
489
533
  "type": "boolean",
490
534
  "description": "Explicitly opts this node into writer-change-scoped AGENTS.md and repository-local code-standard review. Never inferred from node id or role."