@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,134 @@
1
+ import path from "node:path";
2
+ import { resolveRpcUrl } from "../rpc/client.js";
3
+ import { defaultCanvasPath, defaultCanvasUsesWorkspaceFallback, evaluateCanvasWritePath, resolveCanvasesDir, resolveHarnessForCanvas, shouldAutoOpenCanvas, tryOpenCanvasFile, writeCampaignCanvas, } from "./canvas-render.js";
4
+ import { composeCampaignStatus } from "./compose.js";
5
+ import { runCampaignMcpServer } from "./mcp-server.js";
6
+ import { defaultPanelPath, renderCampaignStatusMarkdown, writeCampaignPanel, } from "./render.js";
7
+ export { composeCampaignStatus } from "./compose.js";
8
+ export { capLabelForKind } from "./kind-map.js";
9
+ export { defaultCanvasPath, evaluateCanvasWritePath, isUnderCanvasDir, looksLikeCursorCanvasesPath, renderCampaignCanvasTsx, resolveCanvasesDir, softMatchCanvasesDir, tryOpenCanvasFile, writeCampaignCanvas, } from "./canvas-render.js";
10
+ export { renderCampaignStatusMarkdown, writeCampaignPanel, } from "./render.js";
11
+ export { loadTrellisParentSnapshot } from "./trellis-load.js";
12
+ function resolveParentDir(explicit) {
13
+ const fromArg = explicit?.trim();
14
+ if (fromArg)
15
+ return path.resolve(fromArg);
16
+ const fromEnv = process.env.TRELLIS_CAMPAIGN_PARENT?.trim();
17
+ if (fromEnv)
18
+ return path.resolve(fromEnv);
19
+ throw new Error("Missing parent task directory. Pass --parent <dir> or set TRELLIS_CAMPAIGN_PARENT.");
20
+ }
21
+ /**
22
+ * Register `cstl campaign` — Cursor MIX observation (CMD + MCP).
23
+ * Read-only; never auto-approves Trellis HITL gates.
24
+ */
25
+ export function registerCampaignCommand(program) {
26
+ const campaign = program
27
+ .command("campaign")
28
+ .description("Campaign observation MIX (CMD + MCP + Canvas). Trellis task-map + optional RPC status. Read-only; no HITL bypass.");
29
+ campaign
30
+ .command("status")
31
+ .description("Compose campaign status (Trellis parent-status + RPC /status when reachable)")
32
+ .option("--parent <dir>", "Parent task directory (or TRELLIS_CAMPAIGN_PARENT)")
33
+ .option("--url <url>", "RPC broker base URL (or TRELLIS_RPC_URL)")
34
+ .option("--json", "Print JSON snapshot")
35
+ .option("--panel", "Write Markdown panel and print absolute path for open_resource")
36
+ .option("--panel-out <path>", "Panel output path (implies --panel)")
37
+ .action(async (opts) => {
38
+ try {
39
+ const parentDir = resolveParentDir(opts.parent);
40
+ const snapshot = await composeCampaignStatus({
41
+ parentDir,
42
+ rpcUrl: opts.url,
43
+ });
44
+ const panelOut = opts.panelOut?.trim();
45
+ const wantPanel = opts.panel === true || Boolean(panelOut);
46
+ if (wantPanel) {
47
+ const out = panelOut ?? defaultPanelPath(snapshot, parentDir);
48
+ const abs = writeCampaignPanel(snapshot, out);
49
+ console.log(abs);
50
+ }
51
+ if (opts.json) {
52
+ console.log(JSON.stringify(snapshot, null, 2));
53
+ }
54
+ else if (!wantPanel) {
55
+ console.log(renderCampaignStatusMarkdown(snapshot));
56
+ }
57
+ }
58
+ catch (error) {
59
+ console.error(error instanceof Error ? error.message : String(error));
60
+ process.exitCode = 1;
61
+ }
62
+ });
63
+ campaign
64
+ .command("mcp")
65
+ .description("Stdio MCP server exposing tool campaign_status (read-only). Configure as trellis-campaign in .cursor/mcp.json.")
66
+ .option("--parent <dir>", "Default parent (sets TRELLIS_CAMPAIGN_PARENT)")
67
+ .option("--url <url>", "Default RPC URL (sets TRELLIS_RPC_URL for process)")
68
+ .action(async (opts) => {
69
+ if (opts.parent?.trim()) {
70
+ process.env.TRELLIS_CAMPAIGN_PARENT = path.resolve(opts.parent.trim());
71
+ }
72
+ if (opts.url?.trim()) {
73
+ process.env.TRELLIS_RPC_URL = resolveRpcUrl(opts.url);
74
+ }
75
+ await runCampaignMcpServer();
76
+ });
77
+ campaign
78
+ .command("canvas")
79
+ .description("Write a Cursor Canvas (.canvas.tsx) with embedded campaign snapshot; print absolute path")
80
+ .option("--parent <dir>", "Parent task directory (or TRELLIS_CAMPAIGN_PARENT)")
81
+ .option("--url <url>", "RPC broker base URL (or TRELLIS_RPC_URL)")
82
+ .option("--out <path>", "Canvas output path (default: Cursor projects/.../canvases/campaign-<id>.canvas.tsx)")
83
+ .option("-q, --quiet", "Suppress stderr hints/warnings and skip auto-open (stdout still prints the absolute path)")
84
+ .option("--no-open", "Do not launch Cursor after writing the canvas file (auto-open is on by default)")
85
+ .action(async (opts) => {
86
+ try {
87
+ const parentDir = resolveParentDir(opts.parent);
88
+ const snapshot = await composeCampaignStatus({
89
+ parentDir,
90
+ rpcUrl: opts.url,
91
+ });
92
+ const explicitOut = opts.out?.trim();
93
+ const out = explicitOut || defaultCanvasPath(snapshot, parentDir);
94
+ const usedWorkspaceFallback = !explicitOut && defaultCanvasUsesWorkspaceFallback(parentDir);
95
+ const abs = writeCampaignCanvas(snapshot, out);
96
+ const canvasDir = resolveCanvasesDir(resolveHarnessForCanvas(parentDir));
97
+ const evaluation = evaluateCanvasWritePath(abs, canvasDir, {
98
+ usedWorkspaceFallback,
99
+ });
100
+ // stdout: absolute path only (script-friendly)
101
+ console.log(abs);
102
+ if (!opts.quiet) {
103
+ for (const warning of evaluation.warnings) {
104
+ console.warn(warning);
105
+ }
106
+ for (const hint of evaluation.hints) {
107
+ console.warn(`Hint: ${hint}`);
108
+ }
109
+ }
110
+ // Commander: --no-open ⇒ open:false; absent ⇒ undefined (default open).
111
+ if (shouldAutoOpenCanvas({
112
+ noOpen: opts.open === false,
113
+ quiet: opts.quiet === true,
114
+ })) {
115
+ const openResult = tryOpenCanvasFile(abs);
116
+ if (!opts.quiet) {
117
+ if (openResult.ok) {
118
+ console.warn(`Hint: opened canvas file via Cursor CLI (${openResult.detail}). ` +
119
+ "If the tab shows source only, use Open as Canvas / reopen from the canvases path.");
120
+ }
121
+ else {
122
+ console.warn(`⚠ Warning: could not auto-open Canvas (${openResult.detail}). ` +
123
+ "Open the printed path in Cursor Canvas view manually.");
124
+ }
125
+ }
126
+ }
127
+ }
128
+ catch (error) {
129
+ console.error(error instanceof Error ? error.message : String(error));
130
+ process.exitCode = 1;
131
+ }
132
+ });
133
+ }
134
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/campaign/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Map RPC address.kind → CAP-oriented label.
3
+ * Advisory only — Task ≠ Agent window (CAP MATRIX).
4
+ */
5
+ export declare function capLabelForKind(kind: string): string;
6
+ //# sourceMappingURL=kind-map.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kind-map.d.ts","sourceRoot":"","sources":["../../../src/commands/campaign/kind-map.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAepD"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Map RPC address.kind → CAP-oriented label.
3
+ * Advisory only — Task ≠ Agent window (CAP MATRIX).
4
+ */
5
+ export function capLabelForKind(kind) {
6
+ switch (kind) {
7
+ case "worker":
8
+ return "Task";
9
+ case "session":
10
+ return "window";
11
+ case "sdk":
12
+ return "SDK";
13
+ case "cli":
14
+ return "CLI";
15
+ case "broker":
16
+ return "broker";
17
+ default:
18
+ return "unknown";
19
+ }
20
+ }
21
+ //# sourceMappingURL=kind-map.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kind-map.js","sourceRoot":"","sources":["../../../src/commands/campaign/kind-map.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC;QAClB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Run MCP stdio server (newline-delimited JSON-RPC, SDK dialect).
3
+ * Blocks until stdin closes.
4
+ */
5
+ export declare function runCampaignMcpServer(): Promise<void>;
6
+ //# sourceMappingURL=mcp-server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/commands/campaign/mcp-server.ts"],"names":[],"mappings":"AAoKA;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAmC1D"}
@@ -0,0 +1,167 @@
1
+ import { composeCampaignStatus } from "./compose.js";
2
+ /**
3
+ * MCP stdio framing used by @modelcontextprotocol/sdk (and Cursor host):
4
+ * one JSON-RPC message per line (NDJSON). Not LSP Content-Length.
5
+ */
6
+ function writeMessage(message) {
7
+ process.stdout.write(`${JSON.stringify(message)}\n`);
8
+ }
9
+ function ok(id, result) {
10
+ writeMessage({ jsonrpc: "2.0", id: id ?? null, result });
11
+ }
12
+ function err(id, code, message) {
13
+ writeMessage({
14
+ jsonrpc: "2.0",
15
+ id: id ?? null,
16
+ error: { code, message },
17
+ });
18
+ }
19
+ const TOOL_NAME = "campaign_status";
20
+ function toolList() {
21
+ return {
22
+ tools: [
23
+ {
24
+ name: TOOL_NAME,
25
+ description: "Read-only Trellis campaign status (task-map stages/children + optional RPC broker clients/topics). Never approves HITL gates.",
26
+ inputSchema: {
27
+ type: "object",
28
+ properties: {
29
+ parent: {
30
+ type: "string",
31
+ description: "Parent task directory (default: TRELLIS_CAMPAIGN_PARENT env)",
32
+ },
33
+ rpcUrl: {
34
+ type: "string",
35
+ description: "RPC broker base URL (default TRELLIS_RPC_URL)",
36
+ },
37
+ },
38
+ additionalProperties: false,
39
+ },
40
+ },
41
+ ],
42
+ };
43
+ }
44
+ async function callCampaignStatus(params) {
45
+ const p = params && typeof params === "object"
46
+ ? params
47
+ : {};
48
+ const args = p.arguments && typeof p.arguments === "object"
49
+ ? p.arguments
50
+ : p;
51
+ const parent = (typeof args.parent === "string" && args.parent.trim()) ||
52
+ process.env.TRELLIS_CAMPAIGN_PARENT?.trim();
53
+ if (!parent) {
54
+ throw new Error("campaign_status requires parent path or TRELLIS_CAMPAIGN_PARENT");
55
+ }
56
+ const rpcUrl = typeof args.rpcUrl === "string" && args.rpcUrl.trim()
57
+ ? args.rpcUrl.trim()
58
+ : undefined;
59
+ const snapshot = await composeCampaignStatus({ parentDir: parent, rpcUrl });
60
+ return JSON.stringify(snapshot, null, 2);
61
+ }
62
+ function negotiatedProtocolVersion(params) {
63
+ const p = params && typeof params === "object"
64
+ ? params
65
+ : {};
66
+ const requested = typeof p.protocolVersion === "string" ? p.protocolVersion.trim() : "";
67
+ return requested || "2024-11-05";
68
+ }
69
+ async function handleRequest(msg) {
70
+ const method = msg.method ?? "";
71
+ const id = msg.id ?? null;
72
+ if (method === "initialize") {
73
+ ok(id, {
74
+ protocolVersion: negotiatedProtocolVersion(msg.params),
75
+ capabilities: {
76
+ tools: {},
77
+ },
78
+ serverInfo: { name: "trellis-campaign", version: "0.1.0" },
79
+ });
80
+ return;
81
+ }
82
+ if (method === "notifications/initialized" || method === "initialized") {
83
+ return;
84
+ }
85
+ if (method === "ping") {
86
+ ok(id, {});
87
+ return;
88
+ }
89
+ if (method === "tools/list") {
90
+ ok(id, toolList());
91
+ return;
92
+ }
93
+ if (method === "resources/list") {
94
+ ok(id, { resources: [] });
95
+ return;
96
+ }
97
+ if (method === "prompts/list") {
98
+ ok(id, { prompts: [] });
99
+ return;
100
+ }
101
+ if (method === "tools/call") {
102
+ try {
103
+ const params = msg.params;
104
+ const name = typeof params?.name === "string" ? params.name : "";
105
+ if (name !== TOOL_NAME) {
106
+ err(id, -32601, `Unknown tool: ${name}`);
107
+ return;
108
+ }
109
+ const text = await callCampaignStatus(params);
110
+ ok(id, {
111
+ content: [{ type: "text", text }],
112
+ isError: false,
113
+ });
114
+ }
115
+ catch (error) {
116
+ const message = error instanceof Error ? error.message : String(error);
117
+ ok(id, {
118
+ content: [{ type: "text", text: message }],
119
+ isError: true,
120
+ });
121
+ }
122
+ return;
123
+ }
124
+ if (id !== undefined && id !== null) {
125
+ err(id, -32601, `Method not found: ${method}`);
126
+ }
127
+ }
128
+ /**
129
+ * Run MCP stdio server (newline-delimited JSON-RPC, SDK dialect).
130
+ * Blocks until stdin closes.
131
+ */
132
+ export async function runCampaignMcpServer() {
133
+ let buffer = "";
134
+ let chain = Promise.resolve();
135
+ const processLines = async () => {
136
+ while (true) {
137
+ const index = buffer.indexOf("\n");
138
+ if (index === -1)
139
+ return;
140
+ const line = buffer.slice(0, index).replace(/\r$/, "").trim();
141
+ buffer = buffer.slice(index + 1);
142
+ if (!line)
143
+ continue;
144
+ let msg;
145
+ try {
146
+ msg = JSON.parse(line);
147
+ }
148
+ catch {
149
+ continue;
150
+ }
151
+ await handleRequest(msg);
152
+ }
153
+ };
154
+ if (typeof process.stdin.resume === "function") {
155
+ process.stdin.resume();
156
+ }
157
+ process.stdin.setEncoding("utf8");
158
+ process.stdin.on("data", (chunk) => {
159
+ buffer += typeof chunk === "string" ? chunk : chunk.toString("utf8");
160
+ chain = chain.then(() => processLines()).catch(() => undefined);
161
+ });
162
+ await new Promise((resolve) => {
163
+ process.stdin.on("end", () => resolve());
164
+ process.stdin.on("close", () => resolve());
165
+ });
166
+ }
167
+ //# sourceMappingURL=mcp-server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../../../src/commands/campaign/mcp-server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import type { CampaignStatusSnapshot } from "./types.js";
2
+ export declare function renderCampaignStatusMarkdown(snapshot: CampaignStatusSnapshot): string;
3
+ export declare function defaultPanelPath(snapshot: CampaignStatusSnapshot, parentDir: string): string;
4
+ export declare function writeCampaignPanel(snapshot: CampaignStatusSnapshot, outPath: string): string;
5
+ //# sourceMappingURL=render.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/commands/campaign/render.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAmGR;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,sBAAsB,EAChC,SAAS,EAAE,MAAM,GAChB,MAAM,CAOR;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,sBAAsB,EAChC,OAAO,EAAE,MAAM,GACd,MAAM,CAKR"}
@@ -0,0 +1,103 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { findHarnessRoot } from "./trellis-load.js";
4
+ export function renderCampaignStatusMarkdown(snapshot) {
5
+ const lines = [
6
+ `# Campaign status — \`${snapshot.parent.id}\``,
7
+ "",
8
+ `- Generated: \`${snapshot.generatedAt}\``,
9
+ `- Parent path: \`${snapshot.parent.path}\``,
10
+ `- contract_epoch: ${snapshot.parent.contractEpoch ?? "?"}`,
11
+ `- execution_topology: ${snapshot.parent.executionTopology ?? "?"}`,
12
+ `- merge_limit: ${snapshot.parent.mergeLimit ?? "?"}`,
13
+ "",
14
+ "## Notes",
15
+ "",
16
+ ...snapshot.notes.map((n) => `- ${n}`),
17
+ "",
18
+ "## Stages (Trellis)",
19
+ "",
20
+ ];
21
+ if (snapshot.parent.stages.length === 0) {
22
+ lines.push("(no stages)");
23
+ lines.push("");
24
+ }
25
+ else {
26
+ for (const stage of snapshot.parent.stages) {
27
+ const title = stage.title ? ` — ${stage.title}` : "";
28
+ lines.push(`### \`${stage.id}\`${title}`);
29
+ for (const unit of stage.units) {
30
+ const blocked = unit.readiness === "blocked" && unit.blockedBy.length > 0
31
+ ? ` — blocked (${unit.blockedBy.join(", ")})`
32
+ : "";
33
+ lines.push(`- \`${unit.id}\` — \`${unit.state}\` — ${unit.readiness}${blocked}`);
34
+ }
35
+ lines.push("");
36
+ }
37
+ }
38
+ lines.push("## Children", "");
39
+ for (const child of snapshot.parent.children) {
40
+ lines.push(`### \`${child.id}\` — \`${child.state}\``);
41
+ if (child.dependsOn.length) {
42
+ lines.push(`- depends_on: ${child.dependsOn.join(", ")}`);
43
+ }
44
+ if (child.ref)
45
+ lines.push(`- ref: ${child.ref}`);
46
+ if (child.evidence)
47
+ lines.push(`- evidence: ${child.evidence}`);
48
+ lines.push("");
49
+ }
50
+ lines.push("## RPC broker", "");
51
+ lines.push(`- URL: \`${snapshot.rpc.url}\``);
52
+ lines.push(`- reachable: **${snapshot.rpc.reachable}**`);
53
+ if (snapshot.rpc.protocolVersion !== undefined) {
54
+ lines.push(`- protocolVersion: ${snapshot.rpc.protocolVersion}`);
55
+ }
56
+ if (snapshot.rpc.error) {
57
+ lines.push(`- error: \`${snapshot.rpc.error}\``);
58
+ }
59
+ lines.push("");
60
+ if (snapshot.rpc.clients.length === 0) {
61
+ lines.push("(no registered clients)");
62
+ lines.push("");
63
+ }
64
+ else {
65
+ lines.push("| kind | id | capLabel | campaignId | lastSeenAt |");
66
+ lines.push("| --- | --- | --- | --- | --- |");
67
+ for (const c of snapshot.rpc.clients) {
68
+ lines.push(`| \`${c.kind}\` | \`${c.id}\` | **${c.capLabel}** | ${c.campaignId ?? "—"} | ${c.lastSeenAt ?? "—"} |`);
69
+ }
70
+ lines.push("");
71
+ }
72
+ if (snapshot.rpc.topics.length > 0) {
73
+ lines.push("### Topics");
74
+ lines.push("");
75
+ for (const t of snapshot.rpc.topics) {
76
+ lines.push(`- \`${t}\``);
77
+ }
78
+ lines.push("");
79
+ }
80
+ lines.push("## Suggested Parent commands", "");
81
+ lines.push("```bash");
82
+ lines.push(`python ./.cstl/scripts/task.py parent-status ${snapshot.parent.path}`);
83
+ lines.push(`python ./.cstl/scripts/task.py publish-pack ${snapshot.parent.path}`);
84
+ lines.push("```");
85
+ lines.push("");
86
+ lines.push("Open this file in Cursor via `open_resource` (cursor-app-control MCP).");
87
+ lines.push("");
88
+ return lines.join("\n");
89
+ }
90
+ export function defaultPanelPath(snapshot, parentDir) {
91
+ const harness = findHarnessRoot(parentDir) ?? findHarnessRoot(process.cwd());
92
+ const base = harness
93
+ ? path.join(harness, ".cstl", "workspace", "campaign-status")
94
+ : path.join(process.cwd(), ".cstl", "workspace", "campaign-status");
95
+ return path.join(base, `campaign-status-${snapshot.parent.id}.md`);
96
+ }
97
+ export function writeCampaignPanel(snapshot, outPath) {
98
+ const abs = path.resolve(outPath);
99
+ fs.mkdirSync(path.dirname(abs), { recursive: true });
100
+ fs.writeFileSync(abs, renderCampaignStatusMarkdown(snapshot), "utf8");
101
+ return abs;
102
+ }
103
+ //# sourceMappingURL=render.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/commands/campaign/render.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { CampaignParentSnapshot } from "./types.js";
2
+ /** Walk upward from start until a directory containing `.cstl/scripts/task.py` is found. */
3
+ export declare function findHarnessRoot(start: string): string | null;
4
+ declare function normalizeParentSnapshot(raw: unknown): CampaignParentSnapshot;
5
+ /**
6
+ * Load Trellis parent snapshot via `python ./.cstl/scripts/task.py parent-status --json`.
7
+ */
8
+ export declare function loadTrellisParentSnapshot(parentDir: string, options?: {
9
+ python?: string;
10
+ harnessRoot?: string;
11
+ }): Promise<CampaignParentSnapshot>;
12
+ export { normalizeParentSnapshot };
13
+ //# sourceMappingURL=trellis-load.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trellis-load.d.ts","sourceRoot":"","sources":["../../../src/commands/campaign/trellis-load.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIzD,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU5D;AAOD,iBAAS,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CAoErE;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,OAAO,CAAC,sBAAsB,CAAC,CAyCjC;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}
@@ -0,0 +1,122 @@
1
+ import { execFile } from "node:child_process";
2
+ import fs from "node:fs";
3
+ import path from "node:path";
4
+ import { promisify } from "node:util";
5
+ const execFileAsync = promisify(execFile);
6
+ /** Walk upward from start until a directory containing `.cstl/scripts/task.py` is found. */
7
+ export function findHarnessRoot(start) {
8
+ let cur = path.resolve(start);
9
+ for (let i = 0; i < 12; i++) {
10
+ const candidate = path.join(cur, ".cstl", "scripts", "task.py");
11
+ if (fs.existsSync(candidate))
12
+ return cur;
13
+ const parent = path.dirname(cur);
14
+ if (parent === cur)
15
+ break;
16
+ cur = parent;
17
+ }
18
+ return null;
19
+ }
20
+ function asStringArray(value) {
21
+ if (!Array.isArray(value))
22
+ return [];
23
+ return value.filter((item) => typeof item === "string");
24
+ }
25
+ function normalizeParentSnapshot(raw) {
26
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
27
+ throw new Error("parent-status --json returned non-object payload");
28
+ }
29
+ const o = raw;
30
+ if (typeof o.error === "string") {
31
+ throw new Error(o.error);
32
+ }
33
+ if (typeof o.id !== "string" || typeof o.path !== "string") {
34
+ throw new Error("parent-status --json missing id/path");
35
+ }
36
+ const stagesRaw = Array.isArray(o.stages) ? o.stages : [];
37
+ const stages = stagesRaw.map((stage) => {
38
+ const s = stage;
39
+ const unitsRaw = Array.isArray(s.units) ? s.units : [];
40
+ return {
41
+ id: String(s.id ?? "?"),
42
+ title: typeof s.title === "string" ? s.title : "",
43
+ units: unitsRaw.map((unit) => {
44
+ const u = unit;
45
+ return {
46
+ id: String(u.id ?? "?"),
47
+ state: String(u.state ?? "?"),
48
+ readiness: String(u.readiness ?? "?"),
49
+ blockedBy: asStringArray(u.blockedBy),
50
+ };
51
+ }),
52
+ };
53
+ });
54
+ const childrenRaw = Array.isArray(o.children) ? o.children : [];
55
+ const children = childrenRaw.map((child) => {
56
+ const c = child;
57
+ return {
58
+ id: String(c.id ?? "?"),
59
+ state: String(c.state ?? "?"),
60
+ dependsOn: asStringArray(c.dependsOn),
61
+ touches: asStringArray(c.touches),
62
+ isolation: typeof c.isolation === "string" ? c.isolation : null,
63
+ branch: typeof c.branch === "string" ? c.branch : null,
64
+ worktreePath: typeof c.worktreePath === "string" ? c.worktreePath : null,
65
+ evidence: typeof c.evidence === "string" ? c.evidence : null,
66
+ ref: typeof c.ref === "string" ? c.ref : null,
67
+ verifyMd: Boolean(c.verifyMd),
68
+ handoffMd: Boolean(c.handoffMd),
69
+ };
70
+ });
71
+ return {
72
+ id: o.id,
73
+ path: o.path,
74
+ contractEpoch: typeof o.contractEpoch === "number" || typeof o.contractEpoch === "string"
75
+ ? o.contractEpoch
76
+ : null,
77
+ executionTopology: typeof o.executionTopology === "string" ? o.executionTopology : null,
78
+ mergeLimit: typeof o.mergeLimit === "number" ? o.mergeLimit : null,
79
+ stages,
80
+ children,
81
+ integrationQueue: Array.isArray(o.integrationQueue)
82
+ ? o.integrationQueue
83
+ : [],
84
+ stageErrors: asStringArray(o.stageErrors),
85
+ legacyStages: Boolean(o.legacyStages),
86
+ };
87
+ }
88
+ /**
89
+ * Load Trellis parent snapshot via `python ./.cstl/scripts/task.py parent-status --json`.
90
+ */
91
+ export async function loadTrellisParentSnapshot(parentDir, options = {}) {
92
+ const resolvedParent = path.resolve(parentDir);
93
+ if (!fs.existsSync(resolvedParent)) {
94
+ throw new Error(`Parent directory not found: ${resolvedParent}`);
95
+ }
96
+ const harnessRoot = options.harnessRoot ??
97
+ findHarnessRoot(resolvedParent) ??
98
+ findHarnessRoot(process.cwd());
99
+ if (!harnessRoot) {
100
+ throw new Error("Could not locate harness root (.cstl/scripts/task.py). Pass an absolute parent under a Trellis harness.");
101
+ }
102
+ const script = path.join(harnessRoot, ".cstl", "scripts", "task.py");
103
+ const python = options.python ?? process.env.TRELLIS_PYTHON ?? "python";
104
+ const { stdout, stderr } = await execFileAsync(python, [script, "parent-status", resolvedParent, "--json"], {
105
+ cwd: harnessRoot,
106
+ windowsHide: true,
107
+ maxBuffer: 4 * 1024 * 1024,
108
+ });
109
+ if (stderr?.trim()) {
110
+ // parent-status is quiet on success; keep stderr for debug only
111
+ }
112
+ let parsed;
113
+ try {
114
+ parsed = JSON.parse(stdout);
115
+ }
116
+ catch {
117
+ throw new Error(`Failed to parse parent-status --json output from ${script}`);
118
+ }
119
+ return normalizeParentSnapshot(parsed);
120
+ }
121
+ export { normalizeParentSnapshot };
122
+ //# sourceMappingURL=trellis-load.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trellis-load.js","sourceRoot":"","sources":["../../../src/commands/campaign/trellis-load.ts"],"names":[],"mappings":"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"}