@blxzer/cursor-trellis 0.3.4 → 0.3.6

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 (210) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/README.md +13 -13
  3. package/README.zh-CN.md +1 -1
  4. package/bin/cstl.js +1 -1
  5. package/bin/smart-search.js +1 -1
  6. package/dist/cli/index.d.ts.map +1 -1
  7. package/dist/cli/index.js +17 -2
  8. package/dist/cli/index.js.map +1 -1
  9. package/dist/commands/campaign/canvas-render.d.ts +68 -0
  10. package/dist/commands/campaign/canvas-render.d.ts.map +1 -0
  11. package/dist/commands/campaign/canvas-render.js +414 -0
  12. package/dist/commands/campaign/canvas-render.js.map +1 -0
  13. package/dist/commands/campaign/compose.d.ts +15 -0
  14. package/dist/commands/campaign/compose.d.ts.map +1 -0
  15. package/dist/commands/campaign/compose.js +110 -0
  16. package/dist/commands/campaign/compose.js.map +1 -0
  17. package/dist/commands/campaign/index.d.ts +13 -0
  18. package/dist/commands/campaign/index.d.ts.map +1 -0
  19. package/dist/commands/campaign/index.js +134 -0
  20. package/dist/commands/campaign/index.js.map +1 -0
  21. package/dist/commands/campaign/kind-map.d.ts +6 -0
  22. package/dist/commands/campaign/kind-map.d.ts.map +1 -0
  23. package/dist/commands/campaign/kind-map.js +21 -0
  24. package/dist/commands/campaign/kind-map.js.map +1 -0
  25. package/dist/commands/campaign/mcp-server.d.ts +6 -0
  26. package/dist/commands/campaign/mcp-server.d.ts.map +1 -0
  27. package/dist/commands/campaign/mcp-server.js +167 -0
  28. package/dist/commands/campaign/mcp-server.js.map +1 -0
  29. package/dist/commands/campaign/render.d.ts +5 -0
  30. package/dist/commands/campaign/render.d.ts.map +1 -0
  31. package/dist/commands/campaign/render.js +103 -0
  32. package/dist/commands/campaign/render.js.map +1 -0
  33. package/dist/commands/campaign/trellis-load.d.ts +13 -0
  34. package/dist/commands/campaign/trellis-load.d.ts.map +1 -0
  35. package/dist/commands/campaign/trellis-load.js +122 -0
  36. package/dist/commands/campaign/trellis-load.js.map +1 -0
  37. package/dist/commands/campaign/types.d.ts +61 -0
  38. package/dist/commands/campaign/types.d.ts.map +1 -0
  39. package/dist/commands/campaign/types.js +3 -0
  40. package/dist/commands/campaign/types.js.map +1 -0
  41. package/dist/commands/goal/index.d.ts +3 -0
  42. package/dist/commands/goal/index.d.ts.map +1 -0
  43. package/dist/commands/goal/index.js +159 -0
  44. package/dist/commands/goal/index.js.map +1 -0
  45. package/dist/commands/goal/review.d.ts +6 -0
  46. package/dist/commands/goal/review.d.ts.map +1 -0
  47. package/dist/commands/goal/review.js +28 -0
  48. package/dist/commands/goal/review.js.map +1 -0
  49. package/dist/commands/init.d.ts.map +1 -1
  50. package/dist/commands/init.js +11 -1
  51. package/dist/commands/init.js.map +1 -1
  52. package/dist/commands/rpc/client.d.ts +51 -0
  53. package/dist/commands/rpc/client.d.ts.map +1 -0
  54. package/dist/commands/rpc/client.js +147 -0
  55. package/dist/commands/rpc/client.js.map +1 -0
  56. package/dist/commands/rpc/index.d.ts +10 -0
  57. package/dist/commands/rpc/index.d.ts.map +1 -0
  58. package/dist/commands/rpc/index.js +157 -0
  59. package/dist/commands/rpc/index.js.map +1 -0
  60. package/dist/commands/rpc/serve.d.ts +23 -0
  61. package/dist/commands/rpc/serve.d.ts.map +1 -0
  62. package/dist/commands/rpc/serve.js +60 -0
  63. package/dist/commands/rpc/serve.js.map +1 -0
  64. package/dist/commands/rpc/smoke.d.ts +16 -0
  65. package/dist/commands/rpc/smoke.d.ts.map +1 -0
  66. package/dist/commands/rpc/smoke.js +92 -0
  67. package/dist/commands/rpc/smoke.js.map +1 -0
  68. package/dist/commands/sdk/index.d.ts +9 -0
  69. package/dist/commands/sdk/index.d.ts.map +1 -0
  70. package/dist/commands/sdk/index.js +58 -0
  71. package/dist/commands/sdk/index.js.map +1 -0
  72. package/dist/commands/sdk/run.d.ts +42 -0
  73. package/dist/commands/sdk/run.d.ts.map +1 -0
  74. package/dist/commands/sdk/run.js +220 -0
  75. package/dist/commands/sdk/run.js.map +1 -0
  76. package/dist/commands/sdk/status.d.ts +14 -0
  77. package/dist/commands/sdk/status.d.ts.map +1 -0
  78. package/dist/commands/sdk/status.js +69 -0
  79. package/dist/commands/sdk/status.js.map +1 -0
  80. package/dist/configurators/workflow.d.ts.map +1 -1
  81. package/dist/configurators/workflow.js +13 -1
  82. package/dist/configurators/workflow.js.map +1 -1
  83. package/dist/goal/action-packet.d.ts +89 -0
  84. package/dist/goal/action-packet.d.ts.map +1 -0
  85. package/dist/goal/action-packet.js +113 -0
  86. package/dist/goal/action-packet.js.map +1 -0
  87. package/dist/goal/audit.d.ts +14 -0
  88. package/dist/goal/audit.d.ts.map +1 -0
  89. package/dist/goal/audit.js +12 -0
  90. package/dist/goal/audit.js.map +1 -0
  91. package/dist/goal/constants.d.ts +26 -0
  92. package/dist/goal/constants.d.ts.map +1 -0
  93. package/dist/goal/constants.js +24 -0
  94. package/dist/goal/constants.js.map +1 -0
  95. package/dist/goal/paths.d.ts +8 -0
  96. package/dist/goal/paths.d.ts.map +1 -0
  97. package/dist/goal/paths.js +36 -0
  98. package/dist/goal/paths.js.map +1 -0
  99. package/dist/goal/preflight.d.ts +21 -0
  100. package/dist/goal/preflight.d.ts.map +1 -0
  101. package/dist/goal/preflight.js +97 -0
  102. package/dist/goal/preflight.js.map +1 -0
  103. package/dist/goal/review-seam.d.ts +44 -0
  104. package/dist/goal/review-seam.d.ts.map +1 -0
  105. package/dist/goal/review-seam.js +153 -0
  106. package/dist/goal/review-seam.js.map +1 -0
  107. package/dist/goal/reviewer-rules.d.ts +13 -0
  108. package/dist/goal/reviewer-rules.d.ts.map +1 -0
  109. package/dist/goal/reviewer-rules.js +153 -0
  110. package/dist/goal/reviewer-rules.js.map +1 -0
  111. package/dist/goal/reviewer.d.ts +9 -0
  112. package/dist/goal/reviewer.d.ts.map +1 -0
  113. package/dist/goal/reviewer.js +54 -0
  114. package/dist/goal/reviewer.js.map +1 -0
  115. package/dist/goal/runtime.d.ts +32 -0
  116. package/dist/goal/runtime.d.ts.map +1 -0
  117. package/dist/goal/runtime.js +242 -0
  118. package/dist/goal/runtime.js.map +1 -0
  119. package/dist/goal/sdk-client.d.ts +10 -0
  120. package/dist/goal/sdk-client.d.ts.map +1 -0
  121. package/dist/goal/sdk-client.js +34 -0
  122. package/dist/goal/sdk-client.js.map +1 -0
  123. package/dist/goal/state.d.ts +40 -0
  124. package/dist/goal/state.d.ts.map +1 -0
  125. package/dist/goal/state.js +37 -0
  126. package/dist/goal/state.js.map +1 -0
  127. package/dist/goal/task-triggers.d.ts +15 -0
  128. package/dist/goal/task-triggers.d.ts.map +1 -0
  129. package/dist/goal/task-triggers.js +23 -0
  130. package/dist/goal/task-triggers.js.map +1 -0
  131. package/dist/goal/walls.d.ts +12 -0
  132. package/dist/goal/walls.d.ts.map +1 -0
  133. package/dist/goal/walls.js +65 -0
  134. package/dist/goal/walls.js.map +1 -0
  135. package/dist/goal/worker-prompt.d.ts +13 -0
  136. package/dist/goal/worker-prompt.d.ts.map +1 -0
  137. package/dist/goal/worker-prompt.js +41 -0
  138. package/dist/goal/worker-prompt.js.map +1 -0
  139. package/dist/goal/worker.d.ts +42 -0
  140. package/dist/goal/worker.d.ts.map +1 -0
  141. package/dist/goal/worker.js +180 -0
  142. package/dist/goal/worker.js.map +1 -0
  143. package/dist/migrations/manifests/0.3.5.json +9 -0
  144. package/dist/migrations/manifests/0.3.6.json +9 -0
  145. package/dist/templates/common/bundled-skills/smart-search-cli/SKILL.md +35 -29
  146. package/dist/templates/common/bundled-skills/smart-search-cli/references/cli-contract.md +11 -25
  147. package/dist/templates/common/commands/continue.md +15 -3
  148. package/dist/templates/common/skills/check.md +7 -4
  149. package/dist/templates/cursor/agents/cstl-check.md +1 -0
  150. package/dist/templates/cursor/fixtures/expected-rules.d.ts.map +1 -1
  151. package/dist/templates/cursor/fixtures/expected-rules.js +6 -1
  152. package/dist/templates/cursor/fixtures/expected-rules.js.map +1 -1
  153. package/dist/templates/cursor/rules/cstl-cursor-modes.mdc +32 -0
  154. package/dist/templates/cursor/rules/cstl-triage.mdc +2 -4
  155. package/dist/templates/cursor/rules/retrieval-routing.mdc +26 -7
  156. package/dist/templates/markdown/agents.md +2 -0
  157. package/dist/templates/markdown/index.d.ts +3 -0
  158. package/dist/templates/markdown/index.d.ts.map +1 -1
  159. package/dist/templates/markdown/index.js +3 -0
  160. package/dist/templates/markdown/index.js.map +1 -1
  161. package/dist/templates/markdown/spec/guides/cursor-context-injection-guide.md.txt +38 -21
  162. package/dist/templates/markdown/spec/guides/cursor-native-modes-guide.md.txt +125 -0
  163. package/dist/templates/markdown/spec/guides/index.md.txt +107 -104
  164. package/dist/templates/markdown/spec/guides/injection-budget-guide.md.txt +111 -0
  165. package/dist/templates/markdown/spec/guides/retrieval-daily-guide.md.txt +38 -6
  166. package/dist/templates/markdown/spec/guides/verification-strength-guide.md.txt +184 -0
  167. package/dist/templates/shared-hooks/session-start.py +10 -0
  168. package/dist/templates/trellis/config.yaml +18 -0
  169. package/dist/templates/trellis/index.d.ts +5 -0
  170. package/dist/templates/trellis/index.d.ts.map +1 -1
  171. package/dist/templates/trellis/index.js +14 -0
  172. package/dist/templates/trellis/index.js.map +1 -1
  173. package/dist/templates/trellis/scripts/common/artifact_locale.py +278 -0
  174. package/dist/templates/trellis/scripts/common/codebase_retrieval_router.py +51 -2
  175. package/dist/templates/trellis/scripts/common/config.py +39 -0
  176. package/dist/templates/trellis/scripts/common/injection_budget.py +317 -0
  177. package/dist/templates/trellis/scripts/common/parent_orchestration.py +500 -5
  178. package/dist/templates/trellis/scripts/common/retrieval_agent_instructions.py +9 -3
  179. package/dist/templates/trellis/scripts/common/session_context.py +32 -4
  180. package/dist/templates/trellis/scripts/common/session_memory.py +26 -0
  181. package/dist/templates/trellis/scripts/common/subagent_dispatch.py +74 -9
  182. package/dist/templates/trellis/scripts/common/task_context.py +18 -0
  183. package/dist/templates/trellis/scripts/common/task_dashboard.py +16 -1
  184. package/dist/templates/trellis/scripts/common/task_map.py +670 -614
  185. package/dist/templates/trellis/scripts/common/task_store.py +191 -40
  186. package/dist/templates/trellis/scripts/common/test_observable_defaults.py +135 -0
  187. package/dist/templates/trellis/scripts/cursor_retrieval_probe_prompt.md +14 -12
  188. package/dist/templates/trellis/scripts/generate_dispatch_prompt.py +182 -0
  189. package/dist/templates/trellis/scripts/injection_budget_probe.py +69 -0
  190. package/dist/templates/trellis/scripts/retrieval_probe_matrix_template.json +3 -3
  191. package/dist/templates/trellis/scripts/spec_health_outcomes.py +160 -0
  192. package/dist/templates/trellis/scripts/task.py +51 -0
  193. package/dist/templates/trellis/tasks/locale/en/default-prd.md +19 -0
  194. package/dist/templates/trellis/tasks/locale/zh/default-prd.md +19 -0
  195. package/dist/templates/trellis/workflow.md +23 -3
  196. package/dist/utils/codebase-retrieval-router.d.ts.map +1 -1
  197. package/dist/utils/codebase-retrieval-router.js +14 -0
  198. package/dist/utils/codebase-retrieval-router.js.map +1 -1
  199. package/dist/utils/cursor-sdk-gate.d.ts +10 -0
  200. package/dist/utils/cursor-sdk-gate.d.ts.map +1 -0
  201. package/dist/utils/cursor-sdk-gate.js +32 -0
  202. package/dist/utils/cursor-sdk-gate.js.map +1 -0
  203. package/dist/utils/project-capabilities.d.ts +30 -3
  204. package/dist/utils/project-capabilities.d.ts.map +1 -1
  205. package/dist/utils/project-capabilities.js +182 -11
  206. package/dist/utils/project-capabilities.js.map +1 -1
  207. package/dist/utils/readiness.d.ts.map +1 -1
  208. package/dist/utils/readiness.js +26 -0
  209. package/dist/utils/readiness.js.map +1 -1
  210. package/package.json +4 -3
@@ -0,0 +1,153 @@
1
+ const RELEASE_BRANCH = /\b(main|master|release)\b/i;
2
+ const FEATURE_BRANCH = /\bfeat\/[\w-]+/i;
3
+ function combinedText(packet) {
4
+ return `${packet.proposed_action}\n${packet.diff_or_cmd_digest}`.toLowerCase();
5
+ }
6
+ function isProjectScopedMcp(text) {
7
+ return (/\.cursor\/mcp\.json/.test(text) &&
8
+ !/~\//.test(text) &&
9
+ !/user-global|machine-level|~\/.cursor/.test(text));
10
+ }
11
+ export function detectHardDeny(packet) {
12
+ const text = combinedText(packet);
13
+ if (/git\s+push\s+(--force|-f)\b/.test(text) &&
14
+ RELEASE_BRANCH.test(text)) {
15
+ return "H-1";
16
+ }
17
+ if (RELEASE_BRANCH.test(text) &&
18
+ (/git\s+(commit|push|merge)\b/.test(text) ||
19
+ packet.action_kind === "git") &&
20
+ !FEATURE_BRANCH.test(text)) {
21
+ return "H-2";
22
+ }
23
+ if (/drop\s+database/.test(text) ||
24
+ /production.*purge/.test(text) ||
25
+ /prod(uction)?\s+destructive/.test(text)) {
26
+ return "H-3";
27
+ }
28
+ if ((/akia[0-9a-z]{8,}/i.test(text) || /sk-[a-z0-9]{8,}/i.test(text)) &&
29
+ (/git\s+add/.test(text) || /\.env/.test(text))) {
30
+ return "H-4";
31
+ }
32
+ if (!isProjectScopedMcp(text) &&
33
+ (/~\/\.cursor\/mcp\.json/.test(text) ||
34
+ /user-global/.test(text) ||
35
+ /machine-level/.test(text) ||
36
+ /platform\s+auth/.test(text))) {
37
+ return "H-5";
38
+ }
39
+ if (/\.\.\/|outside-repo|rm\s+-rf\s+\.\./.test(text)) {
40
+ return "H-6";
41
+ }
42
+ for (const candidate of packet.hard_deny_candidates) {
43
+ if (candidate === "H-5" && isProjectScopedMcp(text)) {
44
+ continue;
45
+ }
46
+ if (candidate === "H-1" && /force/.test(text))
47
+ return "H-1";
48
+ if (candidate === "H-2" && RELEASE_BRANCH.test(text))
49
+ return "H-2";
50
+ if (candidate === "H-3" && /drop\s+database|purge/.test(text))
51
+ return "H-3";
52
+ if (candidate === "H-4" && /akia|sk-/.test(text))
53
+ return "H-4";
54
+ if (candidate === "H-5" && !isProjectScopedMcp(text))
55
+ return "H-5";
56
+ if (candidate === "H-6" && /\.\.\//.test(text))
57
+ return "H-6";
58
+ }
59
+ return null;
60
+ }
61
+ function assessAxes(packet) {
62
+ const text = combinedText(packet);
63
+ const A = packet.axes.A ||
64
+ /force|drop\s+database|rm\s+-rf|production/.test(text);
65
+ const B = packet.axes.B ||
66
+ /npm\s+publish|remote|registry|push\s+origin/.test(text);
67
+ const C = packet.axes.C;
68
+ return { A, B, C };
69
+ }
70
+ export function evaluateSoftDecision(packet, axes) {
71
+ const text = combinedText(packet);
72
+ if (FEATURE_BRANCH.test(text) &&
73
+ /git\s+commit/.test(text) &&
74
+ !RELEASE_BRANCH.test(text)) {
75
+ return {
76
+ hard_deny_hit: null,
77
+ decision: "allow_with_constraints",
78
+ axes,
79
+ constraints: ["feature-branch-only"],
80
+ rationale: "Commit on feature branch with branch discipline.",
81
+ };
82
+ }
83
+ if (isProjectScopedMcp(text)) {
84
+ return {
85
+ hard_deny_hit: null,
86
+ decision: "uncertain",
87
+ axes: { ...axes, B: true },
88
+ rationale: "Project-scoped MCP edit is reviewable but not global H-5.",
89
+ };
90
+ }
91
+ if (!axes.C && /optional|unrelated|refactor/.test(text)) {
92
+ return {
93
+ hard_deny_hit: null,
94
+ decision: "deny_suggest_alternative",
95
+ axes,
96
+ alternative: "Focus on the done_when path instead of optional work.",
97
+ rationale: "Action is not required to satisfy done_when.",
98
+ };
99
+ }
100
+ if (/implementing suggested alternative|follow-up alternative/.test(text)) {
101
+ return {
102
+ hard_deny_hit: null,
103
+ decision: "allow",
104
+ axes,
105
+ rationale: "Reroute follow-up aligned with prior alternative.",
106
+ };
107
+ }
108
+ if (axes.B && /npm\s+publish|dry-run|registry/.test(text)) {
109
+ return {
110
+ hard_deny_hit: null,
111
+ decision: "uncertain",
112
+ axes,
113
+ rationale: "Remote publish path is ambiguous; record evidence before H3.",
114
+ };
115
+ }
116
+ if (!axes.A && !axes.B && axes.C) {
117
+ return {
118
+ hard_deny_hit: null,
119
+ decision: "allow",
120
+ axes,
121
+ rationale: "Local reversible work required for done_when.",
122
+ };
123
+ }
124
+ if (axes.A || axes.B) {
125
+ return {
126
+ hard_deny_hit: null,
127
+ decision: "uncertain",
128
+ axes,
129
+ rationale: "Gray-zone action needs evidence before continue.",
130
+ };
131
+ }
132
+ return {
133
+ hard_deny_hit: null,
134
+ decision: "allow",
135
+ axes,
136
+ rationale: "Low-risk local action.",
137
+ };
138
+ }
139
+ export function evaluateReviewerRules(packet) {
140
+ const axes = assessAxes(packet);
141
+ const hard_deny_hit = detectHardDeny(packet);
142
+ if (hard_deny_hit != null) {
143
+ return {
144
+ hard_deny_hit,
145
+ decision: "deny_suggest_alternative",
146
+ axes,
147
+ alternative: `Hard deny ${hard_deny_hit}: choose a safer reroute.`,
148
+ rationale: `Hard deny ${hard_deny_hit} blocks H3 even when C is true.`,
149
+ };
150
+ }
151
+ return evaluateSoftDecision(packet, axes);
152
+ }
153
+ //# sourceMappingURL=reviewer-rules.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reviewer-rules.js","sourceRoot":"","sources":["../../src/goal/reviewer-rules.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import { type GoalReviewDecision, validateGoalReviewDecision } from "./action-packet.js";
2
+ export interface ReviewResult {
3
+ valid: boolean;
4
+ decision?: GoalReviewDecision;
5
+ invalid_reason?: string;
6
+ }
7
+ export declare function reviewGoalActionPacket(input: unknown): ReviewResult;
8
+ export { validateGoalReviewDecision };
9
+ //# sourceMappingURL=reviewer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../src/goal/reviewer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EAEvB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAmBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAyCnE;AAED,OAAO,EAAE,0BAA0B,EAAE,CAAC"}
@@ -0,0 +1,54 @@
1
+ import { deriveH3Allowed, safeParseGoalActionPacket, validateGoalReviewDecision, } from "./action-packet.js";
2
+ import { evaluateReviewerRules } from "./reviewer-rules.js";
3
+ function buildL1Ready(packet, evaluation) {
4
+ return {
5
+ time: new Date().toISOString(),
6
+ action: packet.proposed_action.slice(0, 200),
7
+ axes: evaluation.axes,
8
+ reviewer: "cstl-goal-reviewer",
9
+ decision: evaluation.decision,
10
+ rollback_hint: evaluation.hard_deny_hit != null
11
+ ? `Do not execute; reroute away from ${evaluation.hard_deny_hit}.`
12
+ : "Revert local edits or undo git commit if outcome is wrong.",
13
+ };
14
+ }
15
+ export function reviewGoalActionPacket(input) {
16
+ const packetResult = safeParseGoalActionPacket(input);
17
+ if (!packetResult.valid) {
18
+ return {
19
+ valid: false,
20
+ invalid_reason: packetResult.invalid_reason,
21
+ };
22
+ }
23
+ const packet = packetResult.packet;
24
+ const evaluation = evaluateReviewerRules(packet);
25
+ const l1_ready = buildL1Ready(packet, evaluation);
26
+ const decisionPayload = {
27
+ schema_version: 1,
28
+ decision: evaluation.decision,
29
+ axes: evaluation.axes,
30
+ hard_deny_hit: evaluation.hard_deny_hit,
31
+ constraints: evaluation.constraints,
32
+ alternative: evaluation.alternative ?? null,
33
+ rationale: evaluation.rationale,
34
+ l1_ready,
35
+ h3_allowed: deriveH3Allowed({
36
+ schema_version: 1,
37
+ decision: evaluation.decision,
38
+ axes: evaluation.axes,
39
+ hard_deny_hit: evaluation.hard_deny_hit,
40
+ rationale: evaluation.rationale,
41
+ l1_ready,
42
+ }),
43
+ };
44
+ const decisionResult = validateGoalReviewDecision(decisionPayload);
45
+ if (!decisionResult.valid) {
46
+ return {
47
+ valid: false,
48
+ invalid_reason: decisionResult.invalid_reason,
49
+ };
50
+ }
51
+ return { valid: true, decision: decisionResult.decision };
52
+ }
53
+ export { validateGoalReviewDecision };
54
+ //# sourceMappingURL=reviewer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reviewer.js","sourceRoot":"","sources":["../../src/goal/reviewer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAGf,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAQ5D,SAAS,YAAY,CACnB,MAAwB,EACxB,UAAoD;IAEpD,OAAO;QACL,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC9B,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QAC5C,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,QAAQ,EAAE,oBAAoB;QAC9B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,aAAa,EACX,UAAU,CAAC,aAAa,IAAI,IAAI;YAC9B,CAAC,CAAC,qCAAqC,UAAU,CAAC,aAAa,GAAG;YAClE,CAAC,CAAC,4DAA4D;KACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,YAAY,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,cAAc,EAAE,YAAY,CAAC,cAAc;SAC5C,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IACnC,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAElD,MAAM,eAAe,GAAG;QACtB,cAAc,EAAE,CAAU;QAC1B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,IAAI;QAC3C,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,QAAQ;QACR,UAAU,EAAE,eAAe,CAAC;YAC1B,cAAc,EAAE,CAAC;YACjB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,QAAQ;SACT,CAAC;KACH,CAAC;IAEF,MAAM,cAAc,GAAG,0BAA0B,CAAC,eAAe,CAAC,CAAC;IACnE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,cAAc,EAAE,cAAc,CAAC,cAAc;SAC9C,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC;AAC5D,CAAC;AAED,OAAO,EAAE,0BAA0B,EAAE,CAAC"}
@@ -0,0 +1,32 @@
1
+ import { proposePreflight } from "./preflight.js";
2
+ import { type ReviewCaller } from "./review-seam.js";
3
+ import { type GoalState } from "./state.js";
4
+ import { type GoalWorkerKind } from "./worker.js";
5
+ export interface GoalPreflightOptions {
6
+ cwd: string;
7
+ goal: string;
8
+ window?: boolean;
9
+ goalId?: string;
10
+ }
11
+ export interface GoalAcceptOptions {
12
+ cwd: string;
13
+ goalId: string;
14
+ }
15
+ export interface GoalRunOptions {
16
+ cwd: string;
17
+ goalId: string;
18
+ mockWorker?: boolean;
19
+ worker?: GoalWorkerKind;
20
+ maxSteps?: number;
21
+ }
22
+ export declare function runGoalPreflight(opts: GoalPreflightOptions): {
23
+ goalId: string;
24
+ result: ReturnType<typeof proposePreflight>;
25
+ };
26
+ export declare function acceptGoalPreflight(opts: GoalAcceptOptions): GoalState;
27
+ export declare function pauseGoal(cwd: string, goalId: string, reason: string): GoalState;
28
+ export declare function crashGoal(cwd: string, goalId: string, reason: string): GoalState;
29
+ export declare function runGoalLoop(opts: GoalRunOptions, reviewCaller?: ReviewCaller): Promise<GoalState>;
30
+ export declare function goalStatus(cwd: string, goalId: string): GoalState;
31
+ export declare function listGoalRuns(cwd: string): string[];
32
+ //# sourceMappingURL=runtime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/goal/runtime.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,gBAAgB,EAA0B,MAAM,gBAAgB,CAAC;AAOzF,OAAO,EAML,KAAK,YAAY,EAElB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAIpB,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;CAC7C,CAYA;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,CA0CtE;AA2DD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAUhF;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAOhF;AAgBD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,YAAY,GAAE,YAQb,GACA,OAAO,CAAC,SAAS,CAAC,CAuHpB;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAEjE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOlD"}
@@ -0,0 +1,242 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { spawnSync } from "node:child_process";
4
+ import { appendAuditLine } from "./audit.js";
5
+ import { detectRunMode, proposePreflight, renderContractMarkdown } from "./preflight.js";
6
+ import { ensureGoalRunDir, goalContractPath, goalRunsRoot, newGoalId, } from "./paths.js";
7
+ import { applyReviewDecision, minimalReviewFallback, packAction, recordL1, recordL2, writePacketFiles, } from "./review-seam.js";
8
+ import { reviewGoalActionPacket } from "./reviewer.js";
9
+ import { createDraftState, readGoalState, writeGoalState, } from "./state.js";
10
+ import { evaluateTaskTriggers, shouldCreateGoalRootTask } from "./task-triggers.js";
11
+ import { checkWalls, markNoProgressRound, markProgress } from "./walls.js";
12
+ import { buildWorkerTurnContext, resolveWorkerAdapter, } from "./worker.js";
13
+ import { DIR_NAMES } from "../constants/paths.js";
14
+ import { workflowPath } from "../utils/workflow-dir.js";
15
+ function runnerAvailable() {
16
+ return process.env.CSTL_GOAL_FORCE_WINDOW !== "1";
17
+ }
18
+ export function runGoalPreflight(opts) {
19
+ const goalId = opts.goalId ?? newGoalId();
20
+ const mode = detectRunMode({
21
+ forceWindow: opts.window === true,
22
+ runnerAvailable: runnerAvailable(),
23
+ });
24
+ const result = proposePreflight(opts.goal, mode);
25
+ ensureGoalRunDir(opts.cwd, goalId);
26
+ let state = createDraftState(goalId, opts.goal, mode);
27
+ state.lifecycle = result.ok ? "preflight_pending" : "draft";
28
+ writeGoalState(opts.cwd, state);
29
+ return { goalId, result };
30
+ }
31
+ export function acceptGoalPreflight(opts) {
32
+ const state = readGoalState(opts.cwd, opts.goalId);
33
+ if (state.lifecycle !== "preflight_pending") {
34
+ throw new Error(`Goal ${opts.goalId} is not awaiting preflight acceptance`);
35
+ }
36
+ const proposal = proposePreflight(state.goal_text, state.mode);
37
+ if (!proposal.ok) {
38
+ throw new Error(`Cannot accept preflight: ${proposal.reason}`);
39
+ }
40
+ const contract = {
41
+ goalText: state.goal_text,
42
+ doneWhen: proposal.doneWhen,
43
+ evidenceHow: proposal.evidenceHow,
44
+ acceptedAt: new Date().toISOString(),
45
+ };
46
+ fs.writeFileSync(goalContractPath(opts.cwd, opts.goalId), renderContractMarkdown(proposal, state.goal_text), "utf-8");
47
+ let next = {
48
+ ...state,
49
+ lifecycle: "running",
50
+ contract,
51
+ started_at: new Date().toISOString(),
52
+ last_progress_at: new Date().toISOString(),
53
+ };
54
+ const hits = evaluateTaskTriggers(next, {
55
+ l1Count: 0,
56
+ justAcceptedPreflight: true,
57
+ });
58
+ if (shouldCreateGoalRootTask(hits)) {
59
+ next.task_dir = createGoalRootTask(opts.cwd, next);
60
+ appendAuditLine(opts.cwd, next.goal_id, "L0", `goal-root task ${next.task_dir}`);
61
+ }
62
+ writeGoalState(opts.cwd, next);
63
+ return next;
64
+ }
65
+ function createGoalRootTask(cwd, state) {
66
+ const slug = `goal-${state.goal_id.replace(/^goal-/, "")}`;
67
+ const scripts = workflowPath(cwd, DIR_NAMES.SCRIPTS);
68
+ const taskPy = scripts ? path.join(scripts, "task.py") : null;
69
+ const title = `goal: ${state.goal_text.slice(0, 80)}`;
70
+ if (taskPy && fs.existsSync(taskPy)) {
71
+ const proc = spawnSync(process.platform === "win32" ? "python" : "python3", [taskPy, "create", title, "--slug", slug, "--package", "cursor-trellis"], { cwd, encoding: "utf-8" });
72
+ if (proc.status === 0) {
73
+ const taskDir = workflowPath(cwd, "tasks", slug);
74
+ if (taskDir && fs.existsSync(path.join(taskDir, "task.json"))) {
75
+ patchGoalMeta(taskDir, state.goal_id);
76
+ return taskDir;
77
+ }
78
+ }
79
+ }
80
+ const fallbackDir = workflowPath(cwd, "tasks", slug);
81
+ if (!fallbackDir)
82
+ throw new Error("Cannot resolve tasks directory");
83
+ fs.mkdirSync(fallbackDir, { recursive: true });
84
+ fs.writeFileSync(path.join(fallbackDir, "task.json"), `${JSON.stringify({
85
+ id: slug,
86
+ title,
87
+ status: "in_progress",
88
+ meta: { created_by: "cstl-goal", goal_id: state.goal_id },
89
+ }, null, 2)}\n`, "utf-8");
90
+ fs.writeFileSync(path.join(fallbackDir, "prd.md"), `# ${title}\n\nGoal-root task for ${state.goal_id}.\n`, "utf-8");
91
+ return fallbackDir;
92
+ }
93
+ function patchGoalMeta(taskDir, goalId) {
94
+ const file = path.join(taskDir, "task.json");
95
+ if (!fs.existsSync(file))
96
+ return;
97
+ const data = JSON.parse(fs.readFileSync(file, "utf-8"));
98
+ const meta = typeof data.meta === "object" && data.meta !== null
99
+ ? data.meta
100
+ : {};
101
+ meta.created_by = "cstl-goal";
102
+ meta.goal_id = goalId;
103
+ data.meta = meta;
104
+ data.status = "in_progress";
105
+ fs.writeFileSync(file, `${JSON.stringify(data, null, 2)}\n`, "utf-8");
106
+ }
107
+ export function pauseGoal(cwd, goalId, reason) {
108
+ const state = readGoalState(cwd, goalId);
109
+ const hits = evaluateTaskTriggers(state, { l1Count: 0, aboutToPause: true });
110
+ if (hits.length > 0 && state.task_dir) {
111
+ appendVerifySnippet(state.task_dir, `pause: ${reason}`);
112
+ }
113
+ recordL2(cwd, goalId, reason);
114
+ const next = { ...state, lifecycle: "paused" };
115
+ writeGoalState(cwd, next);
116
+ return next;
117
+ }
118
+ export function crashGoal(cwd, goalId, reason) {
119
+ const state = readGoalState(cwd, goalId);
120
+ recordL2(cwd, goalId, reason);
121
+ if (state.task_dir)
122
+ appendVerifySnippet(state.task_dir, `crash-wall: ${reason}`);
123
+ const next = { ...state, lifecycle: "crashed" };
124
+ writeGoalState(cwd, next);
125
+ return next;
126
+ }
127
+ function appendVerifySnippet(taskDir, line) {
128
+ const verify = path.join(taskDir, "verify.md");
129
+ if (!fs.existsSync(taskDir)) {
130
+ return;
131
+ }
132
+ const stamp = new Date().toISOString();
133
+ const chunk = `\n## Goal runtime (${stamp})\n\n- ${line}\n`;
134
+ if (fs.existsSync(verify)) {
135
+ fs.appendFileSync(verify, chunk, "utf-8");
136
+ }
137
+ else {
138
+ fs.writeFileSync(verify, `# verify\n${chunk}`, "utf-8");
139
+ }
140
+ }
141
+ export async function runGoalLoop(opts, reviewCaller = async (packetPath) => {
142
+ const raw = JSON.parse(fs.readFileSync(packetPath, "utf-8"));
143
+ const result = reviewGoalActionPacket(raw);
144
+ if (!result.valid || !result.decision) {
145
+ // Invalid packet / decision: fall back so walls can retry or pause.
146
+ return minimalReviewFallback(raw);
147
+ }
148
+ return result.decision;
149
+ }) {
150
+ let state = readGoalState(opts.cwd, opts.goalId);
151
+ if (state.lifecycle !== "running") {
152
+ throw new Error(`Goal ${opts.goalId} is not running (lifecycle=${state.lifecycle})`);
153
+ }
154
+ const maxSteps = opts.maxSteps ?? 3;
155
+ let packetSeq = 1;
156
+ for (let step = 0; step < maxSteps; step += 1) {
157
+ const wall = checkWalls(state);
158
+ if (!wall.ok) {
159
+ return crashGoal(opts.cwd, state.goal_id, wall.reason);
160
+ }
161
+ state = {
162
+ ...state,
163
+ worker_turns: state.worker_turns + 1,
164
+ total_turns: state.total_turns + 1,
165
+ };
166
+ if (state.mode === "window" && !opts.mockWorker && opts.worker !== "mock") {
167
+ appendAuditLine(opts.cwd, state.goal_id, "L0", "window mode — continue in IDE agent; close window stops run");
168
+ writeGoalState(opts.cwd, state);
169
+ return state;
170
+ }
171
+ const adapter = resolveWorkerAdapter({
172
+ mockWorker: opts.mockWorker,
173
+ worker: opts.worker,
174
+ });
175
+ state = { ...state, last_worker_adapter: adapter.id };
176
+ appendAuditLine(opts.cwd, state.goal_id, "L0", `worker ${adapter.id} turn ${step + 1} start`);
177
+ const turnResult = await adapter.runTurn(buildWorkerTurnContext(opts.cwd, state, step + 1));
178
+ appendAuditLine(opts.cwd, state.goal_id, "L0", turnResult.summary);
179
+ if (turnResult.kind === "error") {
180
+ state = markNoProgressRound(state);
181
+ writeGoalState(opts.cwd, state);
182
+ continue;
183
+ }
184
+ if (turnResult.kind === "status") {
185
+ state = markProgress(state);
186
+ writeGoalState(opts.cwd, state);
187
+ continue;
188
+ }
189
+ const sampleAction = turnResult.packet ??
190
+ packAction(state, {
191
+ summary: "Run focused validation for goal step",
192
+ kind: "shell",
193
+ digest: "pnpm test goal/",
194
+ axes: { A: false, B: false, C: true },
195
+ hardDenyCandidates: [],
196
+ });
197
+ const packetPath = writePacketFiles(opts.cwd, state.goal_id, packetSeq, sampleAction).requestPath;
198
+ let reviewAttempts = 0;
199
+ let applied = false;
200
+ while (reviewAttempts <= state.walls.maxReviewRetries && !applied) {
201
+ const decision = await reviewCaller(packetPath);
202
+ writePacketFiles(opts.cwd, state.goal_id, packetSeq, sampleAction, decision);
203
+ const outcome = applyReviewDecision(state, sampleAction, decision, sampleAction.action_kind);
204
+ state = outcome.state;
205
+ if (outcome.result.action === "retry_review") {
206
+ reviewAttempts += 1;
207
+ continue;
208
+ }
209
+ recordL1(opts.cwd, state.goal_id, decision);
210
+ applied = true;
211
+ if (outcome.result.action === "crash_wall") {
212
+ return crashGoal(opts.cwd, state.goal_id, outcome.result.reason);
213
+ }
214
+ if (outcome.result.action === "reroute") {
215
+ state = markNoProgressRound(state);
216
+ }
217
+ else {
218
+ state = markProgress(state);
219
+ }
220
+ }
221
+ if (!applied) {
222
+ return pauseGoal(opts.cwd, state.goal_id, "review retries exhausted");
223
+ }
224
+ packetSeq += 1;
225
+ writeGoalState(opts.cwd, state);
226
+ }
227
+ writeGoalState(opts.cwd, state);
228
+ return state;
229
+ }
230
+ export function goalStatus(cwd, goalId) {
231
+ return readGoalState(cwd, goalId);
232
+ }
233
+ export function listGoalRuns(cwd) {
234
+ const runsRoot = goalRunsRoot(cwd);
235
+ if (!fs.existsSync(runsRoot))
236
+ return [];
237
+ return fs
238
+ .readdirSync(runsRoot, { withFileTypes: true })
239
+ .filter((d) => d.isDirectory())
240
+ .map((d) => d.name);
241
+ }
242
+ //# sourceMappingURL=runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/goal/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EACV,QAAQ,EACR,QAAQ,EAER,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,GAGf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GAErB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAsBxD,SAAS,eAAe;IACtB,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,GAAG,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAA0B;IAIzD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,aAAa,CAAC;QACzB,WAAW,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI;QACjC,eAAe,EAAE,eAAe,EAAE;KACnC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5D,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,SAAS,KAAK,mBAAmB,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,MAAM,uCAAuC,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,QAAQ,GAAiB;QAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS;QACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;IAEF,EAAE,CAAC,aAAa,CACd,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EACvC,sBAAsB,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,EACjD,OAAO,CACR,CAAC;IAEF,IAAI,IAAI,GAAc;QACpB,GAAG,KAAK;QACR,SAAS,EAAE,SAAS;QACpB,QAAQ;QACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC3C,CAAC;IAEF,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,EAAE;QACtC,OAAO,EAAE,CAAC;QACV,qBAAqB,EAAE,IAAI;KAC5B,CAAC,CAAC;IACH,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnD,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW,EAAE,KAAgB;IACvD,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;IAC3D,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,KAAK,GAAG,SAAS,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAEtD,IAAI,MAAM,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,SAAS,CACpB,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EACnD,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,CAAC,EACxE,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAC3B,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACjD,IAAI,OAAO,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;gBAC9D,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtC,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,EACnC,GAAG,IAAI,CAAC,SAAS,CACf;QACE,EAAE,EAAE,IAAI;QACR,KAAK;QACL,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;KAC1D,EACD,IAAI,EACJ,CAAC,CACF,IAAI,EACL,OAAO,CACR,CAAC;IACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,KAAK,KAAK,0BAA0B,KAAK,CAAC,OAAO,KAAK,EAAE,OAAO,CAAC,CAAC;IACpH,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,MAAc;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAA4B,CAAC;IACnF,MAAM,IAAI,GACR,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;QACjD,CAAC,CAAE,IAAI,CAAC,IAAgC;QACxC,CAAC,CAAC,EAAE,CAAC;IACT,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC;IAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACjB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;IAC5B,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,MAAc,EAAE,MAAc;IACnE,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACtC,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,QAAiB,EAAE,CAAC;IACxD,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,MAAc,EAAE,MAAc;IACnE,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,QAAQ;QAAE,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,eAAe,MAAM,EAAE,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,SAAkB,EAAE,CAAC;IACzD,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe,EAAE,IAAY;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,sBAAsB,KAAK,UAAU,IAAI,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAoB,EACpB,eAA6B,KAAK,EAAE,UAAU,EAAE,EAAE;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,oEAAoE;QACpE,OAAO,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC;IAED,IAAI,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,MAAM,8BAA8B,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;IACpC,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACzD,CAAC;QAED,KAAK,GAAG;YACN,GAAG,KAAK;YACR,YAAY,EAAE,KAAK,CAAC,YAAY,GAAG,CAAC;YACpC,WAAW,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC;SACnC,CAAC;QAEF,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC1E,eAAe,CACb,IAAI,CAAC,GAAG,EACR,KAAK,CAAC,OAAO,EACb,IAAI,EACJ,6DAA6D,CAC9D,CAAC;YACF,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,OAAO,GAAG,oBAAoB,CAAC;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;QACtD,eAAe,CACb,IAAI,CAAC,GAAG,EACR,KAAK,CAAC,OAAO,EACb,IAAI,EACJ,UAAU,OAAO,CAAC,EAAE,SAAS,IAAI,GAAG,CAAC,QAAQ,CAC9C,CAAC;QAEF,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,OAAO,CACtC,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAClD,CAAC;QACF,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QAEnE,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAChC,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YACnC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QAED,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YAC5B,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAChB,UAAU,CAAC,MAAM;YACjB,UAAU,CAAC,KAAK,EAAE;gBAChB,OAAO,EAAE,sCAAsC;gBAC/C,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,iBAAiB;gBACzB,IAAI,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE;gBACrC,kBAAkB,EAAE,EAAE;aACvB,CAAC,CAAC;QAEL,MAAM,UAAU,GAAG,gBAAgB,CACjC,IAAI,CAAC,GAAG,EACR,KAAK,CAAC,OAAO,EACb,SAAS,EACT,YAAY,CACb,CAAC,WAAW,CAAC;QAEd,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,OAAO,cAAc,IAAI,KAAK,CAAC,KAAK,CAAC,gBAAgB,IAAI,CAAC,OAAO,EAAE,CAAC;YAClE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;YAChD,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;YAC7E,MAAM,OAAO,GAAG,mBAAmB,CACjC,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,CAAC,WAAW,CACzB,CAAC;YACF,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAEtB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;gBAC7C,cAAc,IAAI,CAAC,CAAC;gBACpB,SAAS;YACX,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC5C,OAAO,GAAG,IAAI,CAAC;YAEf,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;gBAC3C,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACxC,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;QACxE,CAAC;QAED,SAAS,IAAI,CAAC,CAAC;QACf,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,MAAc;IACpD,OAAO,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,OAAO,EAAE;SACN,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC9C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}
@@ -0,0 +1,10 @@
1
+ export interface CursorAgentOutcome {
2
+ status: string;
3
+ result: string;
4
+ }
5
+ /**
6
+ * Call @cursor/sdk Agent.prompt against a local cwd.
7
+ * Requires CURSOR_API_KEY in the current process (never logged).
8
+ */
9
+ export declare function promptCursorAgent(prompt: string, cwd: string): Promise<CursorAgentOutcome>;
10
+ //# sourceMappingURL=sdk-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sdk-client.d.ts","sourceRoot":"","sources":["../../src/goal/sdk-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAaD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,kBAAkB,CAAC,CAmC7B"}
@@ -0,0 +1,34 @@
1
+ import { cursorApiKeySetupGuide, hasCursorApiKey } from "../utils/cursor-sdk-gate.js";
2
+ /**
3
+ * Call @cursor/sdk Agent.prompt against a local cwd.
4
+ * Requires CURSOR_API_KEY in the current process (never logged).
5
+ */
6
+ export async function promptCursorAgent(prompt, cwd) {
7
+ if (!hasCursorApiKey()) {
8
+ throw new Error([
9
+ "Live goal worker requires CURSOR_API_KEY (and prior user consent to use it).",
10
+ "Use --mock-worker for offline/CI runs.",
11
+ cursorApiKeySetupGuide(),
12
+ ].join(" "));
13
+ }
14
+ const apiKey = process.env.CURSOR_API_KEY.trim();
15
+ let Agent;
16
+ try {
17
+ const dynamicImport = new Function("specifier", "return import(specifier)");
18
+ const mod = await dynamicImport("@cursor/sdk");
19
+ Agent = mod.Agent;
20
+ }
21
+ catch {
22
+ throw new Error("@cursor/sdk is not installed. After explicit consent, add the optional dependency, or use --mock-worker.");
23
+ }
24
+ const outcome = await Agent.prompt(prompt, {
25
+ apiKey,
26
+ model: { id: "composer-2.5" },
27
+ local: { cwd },
28
+ });
29
+ return {
30
+ status: outcome.status ?? "unknown",
31
+ result: outcome.result ?? "",
32
+ };
33
+ }
34
+ //# sourceMappingURL=sdk-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sdk-client.js","sourceRoot":"","sources":["../../src/goal/sdk-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAkBtF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,GAAW;IAEX,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb;YACE,8EAA8E;YAC9E,wCAAwC;YACxC,sBAAsB,EAAE;SACzB,CAAC,IAAI,CAAC,GAAG,CAAC,CACZ,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAe,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,KAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,IAAI,QAAQ,CAChC,WAAW,EACX,0BAA0B,CAC+B,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,CAAC;QAC/C,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;QACzC,MAAM;QACN,KAAK,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE;QAC7B,KAAK,EAAE,EAAE,GAAG,EAAE;KACf,CAAC,CAAC;IACH,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS;QACnC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;KAC7B,CAAC;AACJ,CAAC"}
@@ -0,0 +1,40 @@
1
+ import type { GoalLifecycleState, GoalRunMode } from "./constants.js";
2
+ export interface GoalContract {
3
+ goalText: string;
4
+ doneWhen: string[];
5
+ evidenceHow: string;
6
+ acceptedAt: string;
7
+ }
8
+ export interface GoalWallCounters {
9
+ wallClockSeconds: number;
10
+ noProgressSeconds: number;
11
+ noProgressRounds: number;
12
+ workerTurnLimit: number;
13
+ totalTurnLimit: number;
14
+ workerTurnTimeoutMs: number;
15
+ maxReroutes: number;
16
+ maxReviewRetries: number;
17
+ }
18
+ export interface GoalState {
19
+ goal_id: string;
20
+ lifecycle: GoalLifecycleState;
21
+ mode: GoalRunMode;
22
+ goal_text: string;
23
+ contract?: GoalContract;
24
+ task_dir: string | null;
25
+ started_at: string | null;
26
+ last_progress_at: string | null;
27
+ worker_turns: number;
28
+ total_turns: number;
29
+ no_progress_rounds: number;
30
+ reroute_counts: Record<string, number>;
31
+ walls: GoalWallCounters;
32
+ channel_name: string | null;
33
+ last_worker_adapter?: GoalWorkerKind | null;
34
+ }
35
+ export type GoalWorkerKind = "sdk" | "mock";
36
+ export declare function defaultWalls(mode: GoalRunMode): GoalWallCounters;
37
+ export declare function createDraftState(goalId: string, goalText: string, mode: GoalRunMode): GoalState;
38
+ export declare function readGoalState(cwd: string, goalId: string): GoalState;
39
+ export declare function writeGoalState(cwd: string, state: GoalState): void;
40
+ //# sourceMappingURL=state.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/goal/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAItE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,KAAK,EAAE,gBAAgB,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,gBAAgB,CAEhE;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,GAChB,SAAS,CAiBX;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAMpE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAIlE"}