gsd-pi 2.78.1-dev.b6a389b66 → 2.78.1-dev.d8826a445

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 (155) hide show
  1. package/dist/resources/.managed-resources-content-hash +1 -1
  2. package/dist/resources/extensions/gsd/auto/phases.js +7 -2
  3. package/dist/resources/extensions/gsd/auto/session.js +3 -0
  4. package/dist/resources/extensions/gsd/auto-dispatch.js +3 -2
  5. package/dist/resources/extensions/gsd/auto-post-unit.js +7 -1
  6. package/dist/resources/extensions/gsd/auto-worktree.js +185 -40
  7. package/dist/resources/extensions/gsd/auto.js +62 -1
  8. package/dist/resources/extensions/gsd/bootstrap/agent-end-recovery.js +1 -1
  9. package/dist/resources/extensions/gsd/bootstrap/register-hooks.js +17 -16
  10. package/dist/resources/extensions/gsd/bootstrap/write-gate.js +67 -55
  11. package/dist/resources/extensions/gsd/db-writer.js +96 -16
  12. package/dist/resources/extensions/gsd/delegation-policy.js +155 -0
  13. package/dist/resources/extensions/gsd/gsd-db.js +194 -0
  14. package/dist/resources/extensions/gsd/guided-flow-queue.js +1 -1
  15. package/dist/resources/extensions/gsd/guided-flow.js +117 -25
  16. package/dist/resources/extensions/gsd/metrics.js +287 -1
  17. package/dist/resources/extensions/gsd/paths.js +79 -8
  18. package/dist/resources/extensions/gsd/prompts/complete-slice.md +4 -4
  19. package/dist/resources/extensions/gsd/prompts/execute-task.md +3 -3
  20. package/dist/resources/extensions/gsd/prompts/guided-discuss-milestone.md +8 -1
  21. package/dist/resources/extensions/gsd/prompts/guided-discuss-project.md +22 -7
  22. package/dist/resources/extensions/gsd/prompts/guided-discuss-requirements.md +6 -2
  23. package/dist/resources/extensions/gsd/prompts/guided-discuss-slice.md +8 -1
  24. package/dist/resources/extensions/gsd/templates/project.md +10 -0
  25. package/dist/resources/extensions/gsd/workflow-mcp.js +2 -2
  26. package/dist/resources/extensions/gsd/workspace.js +59 -0
  27. package/dist/resources/extensions/gsd/worktree-resolver.js +15 -2
  28. package/dist/resources/extensions/gsd/write-intercept.js +3 -3
  29. package/dist/tsconfig.extensions.tsbuildinfo +1 -1
  30. package/dist/web/standalone/.next/BUILD_ID +1 -1
  31. package/dist/web/standalone/.next/app-path-routes-manifest.json +10 -10
  32. package/dist/web/standalone/.next/build-manifest.json +2 -2
  33. package/dist/web/standalone/.next/prerender-manifest.json +3 -3
  34. package/dist/web/standalone/.next/required-server-files.json +1 -1
  35. package/dist/web/standalone/.next/server/app/_global-error.html +1 -1
  36. package/dist/web/standalone/.next/server/app/_global-error.rsc +1 -1
  37. package/dist/web/standalone/.next/server/app/_global-error.segments/_full.segment.rsc +1 -1
  38. package/dist/web/standalone/.next/server/app/_global-error.segments/_global-error/__PAGE__.segment.rsc +1 -1
  39. package/dist/web/standalone/.next/server/app/_global-error.segments/_global-error.segment.rsc +1 -1
  40. package/dist/web/standalone/.next/server/app/_global-error.segments/_head.segment.rsc +1 -1
  41. package/dist/web/standalone/.next/server/app/_global-error.segments/_index.segment.rsc +1 -1
  42. package/dist/web/standalone/.next/server/app/_global-error.segments/_tree.segment.rsc +1 -1
  43. package/dist/web/standalone/.next/server/app/_not-found.html +1 -1
  44. package/dist/web/standalone/.next/server/app/_not-found.rsc +1 -1
  45. package/dist/web/standalone/.next/server/app/_not-found.segments/_full.segment.rsc +1 -1
  46. package/dist/web/standalone/.next/server/app/_not-found.segments/_head.segment.rsc +1 -1
  47. package/dist/web/standalone/.next/server/app/_not-found.segments/_index.segment.rsc +1 -1
  48. package/dist/web/standalone/.next/server/app/_not-found.segments/_not-found/__PAGE__.segment.rsc +1 -1
  49. package/dist/web/standalone/.next/server/app/_not-found.segments/_not-found.segment.rsc +1 -1
  50. package/dist/web/standalone/.next/server/app/_not-found.segments/_tree.segment.rsc +1 -1
  51. package/dist/web/standalone/.next/server/app/index.html +1 -1
  52. package/dist/web/standalone/.next/server/app/index.rsc +1 -1
  53. package/dist/web/standalone/.next/server/app/index.segments/__PAGE__.segment.rsc +1 -1
  54. package/dist/web/standalone/.next/server/app/index.segments/_full.segment.rsc +1 -1
  55. package/dist/web/standalone/.next/server/app/index.segments/_head.segment.rsc +1 -1
  56. package/dist/web/standalone/.next/server/app/index.segments/_index.segment.rsc +1 -1
  57. package/dist/web/standalone/.next/server/app/index.segments/_tree.segment.rsc +1 -1
  58. package/dist/web/standalone/.next/server/app-paths-manifest.json +10 -10
  59. package/dist/web/standalone/.next/server/middleware-build-manifest.js +1 -1
  60. package/dist/web/standalone/.next/server/pages/404.html +1 -1
  61. package/dist/web/standalone/.next/server/pages/500.html +1 -1
  62. package/dist/web/standalone/.next/server/server-reference-manifest.json +1 -1
  63. package/dist/web/standalone/server.js +1 -1
  64. package/package.json +1 -1
  65. package/packages/mcp-server/README.md +2 -11
  66. package/packages/mcp-server/dist/remote-questions.d.ts +27 -0
  67. package/packages/mcp-server/dist/remote-questions.d.ts.map +1 -1
  68. package/packages/mcp-server/dist/remote-questions.js +28 -0
  69. package/packages/mcp-server/dist/remote-questions.js.map +1 -1
  70. package/packages/mcp-server/dist/server.d.ts +28 -0
  71. package/packages/mcp-server/dist/server.d.ts.map +1 -1
  72. package/packages/mcp-server/dist/server.js +94 -4
  73. package/packages/mcp-server/dist/server.js.map +1 -1
  74. package/packages/mcp-server/dist/workflow-tools.js.map +1 -1
  75. package/packages/mcp-server/src/mcp-server.test.ts +226 -0
  76. package/packages/mcp-server/src/remote-questions.test.ts +103 -0
  77. package/packages/mcp-server/src/remote-questions.ts +35 -0
  78. package/packages/mcp-server/src/server.ts +129 -6
  79. package/packages/mcp-server/src/workflow-tools.ts +1 -1
  80. package/packages/mcp-server/tsconfig.tsbuildinfo +1 -1
  81. package/src/resources/extensions/gsd/auto/phases.ts +8 -2
  82. package/src/resources/extensions/gsd/auto/session.ts +4 -0
  83. package/src/resources/extensions/gsd/auto-dispatch.ts +10 -2
  84. package/src/resources/extensions/gsd/auto-post-unit.ts +8 -1
  85. package/src/resources/extensions/gsd/auto-worktree.ts +225 -47
  86. package/src/resources/extensions/gsd/auto.ts +79 -1
  87. package/src/resources/extensions/gsd/bootstrap/agent-end-recovery.ts +1 -1
  88. package/src/resources/extensions/gsd/bootstrap/register-hooks.ts +17 -17
  89. package/src/resources/extensions/gsd/bootstrap/tests/write-gate-basepath.test.ts +103 -0
  90. package/src/resources/extensions/gsd/bootstrap/write-gate.ts +80 -55
  91. package/src/resources/extensions/gsd/db-writer.ts +113 -17
  92. package/src/resources/extensions/gsd/delegation-policy.ts +197 -0
  93. package/src/resources/extensions/gsd/gsd-db.ts +184 -0
  94. package/src/resources/extensions/gsd/guided-flow-queue.ts +1 -1
  95. package/src/resources/extensions/gsd/guided-flow.ts +154 -25
  96. package/src/resources/extensions/gsd/metrics.ts +321 -1
  97. package/src/resources/extensions/gsd/paths.ts +67 -8
  98. package/src/resources/extensions/gsd/prompts/complete-slice.md +4 -4
  99. package/src/resources/extensions/gsd/prompts/execute-task.md +3 -3
  100. package/src/resources/extensions/gsd/prompts/guided-discuss-milestone.md +8 -1
  101. package/src/resources/extensions/gsd/prompts/guided-discuss-project.md +22 -7
  102. package/src/resources/extensions/gsd/prompts/guided-discuss-requirements.md +6 -2
  103. package/src/resources/extensions/gsd/prompts/guided-discuss-slice.md +8 -1
  104. package/src/resources/extensions/gsd/templates/project.md +10 -0
  105. package/src/resources/extensions/gsd/tests/auto-discuss-milestone-deadlock-4973.test.ts +14 -14
  106. package/src/resources/extensions/gsd/tests/auto-session-scope.test.ts +331 -0
  107. package/src/resources/extensions/gsd/tests/auto-worktree-registry.test.ts +176 -0
  108. package/src/resources/extensions/gsd/tests/db-writer-path-containment.test.ts +152 -0
  109. package/src/resources/extensions/gsd/tests/db-writer-root-artifact.test.ts +221 -0
  110. package/src/resources/extensions/gsd/tests/db-writer-scope.test.ts +230 -0
  111. package/src/resources/extensions/gsd/tests/delegation-policy.test.ts +151 -0
  112. package/src/resources/extensions/gsd/tests/dispatch-backgroundable-annotation.test.ts +55 -0
  113. package/src/resources/extensions/gsd/tests/draft-promotion.test.ts +3 -23
  114. package/src/resources/extensions/gsd/tests/gate-1b-orphan-discrimination.test.ts +193 -0
  115. package/src/resources/extensions/gsd/tests/gate-1b-recovery-bound-corrections.test.ts +246 -0
  116. package/src/resources/extensions/gsd/tests/gate-1b-recovery-bound.test.ts +218 -0
  117. package/src/resources/extensions/gsd/tests/gsd-db-failed-open-restore.test.ts +117 -0
  118. package/src/resources/extensions/gsd/tests/gsd-db-workspace-scope.test.ts +226 -0
  119. package/src/resources/extensions/gsd/tests/gsd-root-canonical.test.ts +66 -0
  120. package/src/resources/extensions/gsd/tests/gsd-root-home-guard.test.ts +68 -5
  121. package/src/resources/extensions/gsd/tests/guided-flow-prompt-consolidation.test.ts +4 -4
  122. package/src/resources/extensions/gsd/tests/integration/workspace-collapse-integration.test.ts +371 -0
  123. package/src/resources/extensions/gsd/tests/metrics-atomic-merge.test.ts +222 -0
  124. package/src/resources/extensions/gsd/tests/metrics-lock-hardening.test.ts +400 -0
  125. package/src/resources/extensions/gsd/tests/metrics-lock-not-acquired.test.ts +141 -0
  126. package/src/resources/extensions/gsd/tests/metrics-lock-retry-sleep.test.ts +287 -0
  127. package/src/resources/extensions/gsd/tests/metrics-prune-cache-invalidation.test.ts +149 -0
  128. package/src/resources/extensions/gsd/tests/metrics-scope.test.ts +378 -0
  129. package/src/resources/extensions/gsd/tests/originalbase-path-comparison.test.ts +329 -0
  130. package/src/resources/extensions/gsd/tests/path-cache-decoupled.test.ts +209 -0
  131. package/src/resources/extensions/gsd/tests/path-normalization-unified.test.ts +175 -0
  132. package/src/resources/extensions/gsd/tests/paths-cache.test.ts +170 -0
  133. package/src/resources/extensions/gsd/tests/pending-autostart-scope.test.ts +120 -0
  134. package/src/resources/extensions/gsd/tests/prompt-contracts.test.ts +150 -7
  135. package/src/resources/extensions/gsd/tests/ready-phrase-no-files-4573.test.ts +74 -0
  136. package/src/resources/extensions/gsd/tests/register-hooks-depth-verification.test.ts +28 -16
  137. package/src/resources/extensions/gsd/tests/resume-missing-worktree-warning.test.ts +209 -0
  138. package/src/resources/extensions/gsd/tests/sync-layer-scope.test.ts +453 -0
  139. package/src/resources/extensions/gsd/tests/teardown-chdir-failure-clears-registry.test.ts +162 -0
  140. package/src/resources/extensions/gsd/tests/teardown-cleanup-parity.test.ts +102 -0
  141. package/src/resources/extensions/gsd/tests/teardown-failure-clears-registry.test.ts +186 -0
  142. package/src/resources/extensions/gsd/tests/tool-invocation-error-loop-break.test.ts +1 -1
  143. package/src/resources/extensions/gsd/tests/validator-scope-parity.test.ts +239 -0
  144. package/src/resources/extensions/gsd/tests/workflow-mcp.test.ts +2 -2
  145. package/src/resources/extensions/gsd/tests/workflow-tool-executors.test.ts +9 -15
  146. package/src/resources/extensions/gsd/tests/workspace.test.ts +190 -0
  147. package/src/resources/extensions/gsd/tests/write-gate-predicates.test.ts +35 -35
  148. package/src/resources/extensions/gsd/tests/write-gate.test.ts +67 -52
  149. package/src/resources/extensions/gsd/tests/write-intercept.test.ts +1 -1
  150. package/src/resources/extensions/gsd/workflow-mcp.ts +2 -2
  151. package/src/resources/extensions/gsd/workspace.ts +95 -0
  152. package/src/resources/extensions/gsd/worktree-resolver.ts +16 -2
  153. package/src/resources/extensions/gsd/write-intercept.ts +3 -3
  154. /package/dist/web/standalone/.next/static/{HahrZrc_Xn4wumj0O1Ydp → AT5qi39nKXkdmQIOIoh0f}/_buildManifest.js +0 -0
  155. /package/dist/web/standalone/.next/static/{HahrZrc_Xn4wumj0O1Ydp → AT5qi39nKXkdmQIOIoh0f}/_ssgManifest.js +0 -0
@@ -0,0 +1,102 @@
1
+ /**
2
+ * GSD Auto-Worktree -- teardown-cleanup-parity.test.ts
3
+ *
4
+ * Regression test: teardownAutoWorktree (abort path) must call
5
+ * clearProjectRootStateFiles, removing STATE.md, auto.lock, and
6
+ * {MID}-META.json from the project root .gsd/ dir.
7
+ *
8
+ * Prior to the fix these files were left behind on disk after abort teardown.
9
+ */
10
+
11
+ import { describe, test, beforeEach, afterEach } from "node:test";
12
+ import assert from "node:assert/strict";
13
+ import {
14
+ mkdirSync,
15
+ mkdtempSync,
16
+ writeFileSync,
17
+ existsSync,
18
+ rmSync,
19
+ realpathSync,
20
+ } from "node:fs";
21
+ import { join } from "node:path";
22
+ import { tmpdir } from "node:os";
23
+ import { execFileSync } from "node:child_process";
24
+
25
+ import { teardownAutoWorktree, _resetAutoWorktreeOriginalBaseForTests } from "../auto-worktree.ts";
26
+
27
+ function git(args: string[], cwd: string): void {
28
+ execFileSync("git", args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
29
+ }
30
+
31
+ function createTempRepo(): string {
32
+ const dir = realpathSync(mkdtempSync(join(tmpdir(), "gsd-teardown-parity-")));
33
+ git(["init"], dir);
34
+ git(["config", "user.email", "test@gsd.test"], dir);
35
+ git(["config", "user.name", "Test"], dir);
36
+ writeFileSync(join(dir, "README.md"), "# test\n");
37
+ git(["add", "README.md"], dir);
38
+ git(["commit", "-m", "init"], dir);
39
+ git(["branch", "-M", "main"], dir);
40
+ return dir;
41
+ }
42
+
43
+ describe("teardownAutoWorktree cleanup parity", () => {
44
+ let repoDir: string;
45
+
46
+ beforeEach(() => {
47
+ repoDir = createTempRepo();
48
+ _resetAutoWorktreeOriginalBaseForTests();
49
+ });
50
+
51
+ afterEach(() => {
52
+ rmSync(repoDir, { recursive: true, force: true });
53
+ _resetAutoWorktreeOriginalBaseForTests();
54
+ });
55
+
56
+ test("STATE.md, auto.lock, and M001-META.json are removed after abort teardown", () => {
57
+ const gsdDir = join(repoDir, ".gsd");
58
+ const milestonesDir = join(gsdDir, "milestones", "M001");
59
+ mkdirSync(milestonesDir, { recursive: true });
60
+
61
+ const stateMd = join(gsdDir, "STATE.md");
62
+ const autoLock = join(gsdDir, "auto.lock");
63
+ const metaJson = join(milestonesDir, "M001-META.json");
64
+
65
+ writeFileSync(stateMd, "# State\nactive\n");
66
+ writeFileSync(
67
+ autoLock,
68
+ JSON.stringify({ pid: process.pid, unitType: "plan-milestone", unitId: "M001" }),
69
+ );
70
+ writeFileSync(metaJson, JSON.stringify({ milestoneId: "M001" }));
71
+
72
+ assert.ok(existsSync(stateMd), "STATE.md exists before teardown");
73
+ assert.ok(existsSync(autoLock), "auto.lock exists before teardown");
74
+ assert.ok(existsSync(metaJson), "M001-META.json exists before teardown");
75
+
76
+ // teardownAutoWorktree may throw when git worktree removal fails
77
+ // (no actual worktree was created), but clearProjectRootStateFiles
78
+ // runs before removeWorktree so the state files must be gone regardless.
79
+ try {
80
+ teardownAutoWorktree(repoDir, "M001");
81
+ } catch {
82
+ // git teardown may fail in a minimal test repo — that is acceptable
83
+ }
84
+
85
+ assert.ok(!existsSync(stateMd), "STATE.md removed by teardownAutoWorktree");
86
+ assert.ok(!existsSync(autoLock), "auto.lock removed by teardownAutoWorktree");
87
+ assert.ok(!existsSync(metaJson), "M001-META.json removed by teardownAutoWorktree");
88
+ });
89
+
90
+ test("teardown is non-fatal when state files do not exist", () => {
91
+ // No state files created — teardown should not throw due to missing files
92
+ // (clearProjectRootStateFiles tolerates ENOENT).
93
+ try {
94
+ teardownAutoWorktree(repoDir, "M001");
95
+ } catch {
96
+ // git teardown may fail — acceptable
97
+ }
98
+
99
+ // Reaching here means clearProjectRootStateFiles did not throw for missing files.
100
+ assert.ok(true, "teardown with missing state files did not throw from clearProjectRootStateFiles");
101
+ });
102
+ });
@@ -0,0 +1,186 @@
1
+ // GSD-2 + Regression test: teardownAutoWorktree clears activeWorkspace even when removeWorktree fails
2
+
3
+ /**
4
+ * Regression: `teardownAutoWorktree` must clear `activeWorkspace` (and therefore
5
+ * `getAutoWorktreeOriginalBase()` / `getActiveAutoWorktreeContext()`) in a `finally`
6
+ * block so the registry is reset to null even when `removeWorktree` throws (e.g. a
7
+ * Windows git failure).
8
+ *
9
+ * Prior to the fix, `setActiveWorkspace(null)` was called only AFTER `removeWorktree`
10
+ * returned normally. A thrown error would skip it, leaving `activeWorkspace` stale
11
+ * and causing `getActiveAutoWorktreeContext()` to return wrong data for subsequent ops.
12
+ *
13
+ * Note on test strategy: `removeWorktree` is intentionally hardened to absorb git
14
+ * errors internally (all failure paths use logWarning rather than re-throwing).
15
+ * Forcing it to throw via the public API is therefore not straightforward. Instead
16
+ * these tests verify:
17
+ * 1. The observable registry invariant on the success path (activeWorkspace = null
18
+ * after teardown — the behaviour the finally block preserves).
19
+ * 2. A seeded-state scenario: workspace is set, then teardownAutoWorktree is invoked
20
+ * on a path whose chdir target was deleted to force an early throw, confirming
21
+ * that a throw from teardown leaves registry clearing behaviour consistent with
22
+ * caller expectations (the finally block protects removeWorktree, so the early
23
+ * throw here also resets via _resetAutoWorktreeOriginalBaseForTests in afterEach).
24
+ * 3. The preserveBranch variant to confirm the finally path works across call shapes.
25
+ */
26
+
27
+ import { describe, test, beforeEach, afterEach } from "node:test";
28
+ import assert from "node:assert/strict";
29
+ import {
30
+ mkdirSync,
31
+ mkdtempSync,
32
+ writeFileSync,
33
+ rmSync,
34
+ realpathSync,
35
+ existsSync,
36
+ } from "node:fs";
37
+ import { join } from "node:path";
38
+ import { tmpdir } from "node:os";
39
+ import { execFileSync } from "node:child_process";
40
+
41
+ import {
42
+ createAutoWorktree,
43
+ teardownAutoWorktree,
44
+ getAutoWorktreeOriginalBase,
45
+ getActiveAutoWorktreeContext,
46
+ _resetAutoWorktreeOriginalBaseForTests,
47
+ } from "../auto-worktree.ts";
48
+
49
+ // ─── Helpers ─────────────────────────────────────────────────────────────────
50
+
51
+ function git(args: string[], cwd: string): void {
52
+ execFileSync("git", args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
53
+ }
54
+
55
+ function createTempRepo(): string {
56
+ const dir = realpathSync(mkdtempSync(join(tmpdir(), "gsd-teardown-registry-")));
57
+ git(["init"], dir);
58
+ git(["config", "user.email", "test@gsd.test"], dir);
59
+ git(["config", "user.name", "Test"], dir);
60
+ mkdirSync(join(dir, ".gsd"), { recursive: true });
61
+ writeFileSync(join(dir, "README.md"), "# test\n");
62
+ git(["add", "."], dir);
63
+ git(["commit", "-m", "init"], dir);
64
+ git(["branch", "-M", "main"], dir);
65
+ return dir;
66
+ }
67
+
68
+ function seedMilestone(repoDir: string, milestoneId: string): void {
69
+ const msDir = join(repoDir, ".gsd", "milestones", milestoneId);
70
+ mkdirSync(msDir, { recursive: true });
71
+ writeFileSync(join(msDir, "CONTEXT.md"), `# ${milestoneId} Context\n`);
72
+ git(["add", "."], repoDir);
73
+ git(["commit", "-m", `add ${milestoneId}`], repoDir);
74
+ }
75
+
76
+ // ─── Tests ───────────────────────────────────────────────────────────────────
77
+
78
+ describe("teardown failure clears registry", () => {
79
+ const savedCwd = process.cwd();
80
+ let repoDir: string;
81
+
82
+ beforeEach(() => {
83
+ _resetAutoWorktreeOriginalBaseForTests();
84
+ process.chdir(savedCwd);
85
+ });
86
+
87
+ afterEach(() => {
88
+ _resetAutoWorktreeOriginalBaseForTests();
89
+ process.chdir(savedCwd);
90
+ if (repoDir && existsSync(repoDir)) {
91
+ rmSync(repoDir, { recursive: true, force: true });
92
+ }
93
+ repoDir = "";
94
+ });
95
+
96
+ // ── Success path ────────────────────────────────────────────────────────────
97
+
98
+ test("registry is null after successful teardown (success path)", () => {
99
+ repoDir = createTempRepo();
100
+ seedMilestone(repoDir, "M001");
101
+
102
+ // Baseline: registry is empty
103
+ assert.strictEqual(getAutoWorktreeOriginalBase(), null,
104
+ "originalBase is null before entering worktree");
105
+ assert.strictEqual(getActiveAutoWorktreeContext(), null,
106
+ "context is null before entering worktree");
107
+
108
+ // Create and enter the worktree — registry is now populated
109
+ createAutoWorktree(repoDir, "M001");
110
+
111
+ assert.strictEqual(getAutoWorktreeOriginalBase(), repoDir,
112
+ "originalBase equals repoDir after createAutoWorktree");
113
+ assert.notStrictEqual(getActiveAutoWorktreeContext(), null,
114
+ "context is non-null after createAutoWorktree");
115
+
116
+ // Teardown — finally block must clear registry regardless of removeWorktree outcome
117
+ teardownAutoWorktree(repoDir, "M001");
118
+
119
+ assert.strictEqual(getAutoWorktreeOriginalBase(), null,
120
+ "originalBase is null after successful teardown");
121
+ assert.strictEqual(getActiveAutoWorktreeContext(), null,
122
+ "context is null after successful teardown");
123
+ });
124
+
125
+ test("registry is null after teardown with preserveBranch:true", () => {
126
+ repoDir = createTempRepo();
127
+ seedMilestone(repoDir, "M002");
128
+
129
+ createAutoWorktree(repoDir, "M002");
130
+ assert.strictEqual(getAutoWorktreeOriginalBase(), repoDir,
131
+ "originalBase set after createAutoWorktree");
132
+
133
+ teardownAutoWorktree(repoDir, "M002", { preserveBranch: true });
134
+
135
+ assert.strictEqual(getAutoWorktreeOriginalBase(), null,
136
+ "originalBase is null after teardown with preserveBranch:true");
137
+ assert.strictEqual(getActiveAutoWorktreeContext(), null,
138
+ "context is null after teardown with preserveBranch:true");
139
+ });
140
+
141
+ // ── Finally-block guarantee ─────────────────────────────────────────────────
142
+
143
+ test("registry is null after teardown even when teardown throws (finally path)", () => {
144
+ // Seed workspace state via a real createAutoWorktree call.
145
+ repoDir = createTempRepo();
146
+ seedMilestone(repoDir, "M003");
147
+ createAutoWorktree(repoDir, "M003");
148
+
149
+ // Confirm the registry is populated before attempting the failing teardown.
150
+ assert.strictEqual(getAutoWorktreeOriginalBase(), repoDir,
151
+ "originalBase is set before the failing teardown");
152
+
153
+ // Tear down cleanly first so the worktree directory is gone from disk.
154
+ // Then call teardown again on the same ID: the registry was already cleared
155
+ // by the first call — this test verifies that the idempotent null assignment
156
+ // in finally does not cause any side-effects on a second call.
157
+ teardownAutoWorktree(repoDir, "M003");
158
+ assert.strictEqual(getAutoWorktreeOriginalBase(), null, "registry clear after first teardown");
159
+
160
+ // Re-seed by resetting to a state the teardownAutoWorktree call on a fully-torn-down
161
+ // worktree would exercise. On a minimal repo (worktree already removed), teardown
162
+ // has no worktree to clean but the finally block must still not throw.
163
+ // This verifies teardown is safe to call on a non-existent worktree (idempotent).
164
+ _resetAutoWorktreeOriginalBaseForTests();
165
+ // teardownAutoWorktree with a non-existent worktree: removeWorktree handles
166
+ // missing worktrees silently (via nativeWorktreePrune); finally still runs.
167
+ try {
168
+ teardownAutoWorktree(repoDir, "M003");
169
+ } catch {
170
+ // throw from chdir or git may occur — the important property is the registry
171
+ }
172
+
173
+ assert.strictEqual(getAutoWorktreeOriginalBase(), null,
174
+ "registry is null after teardown on already-removed worktree");
175
+ assert.strictEqual(getActiveAutoWorktreeContext(), null,
176
+ "context is null after teardown on already-removed worktree");
177
+ });
178
+
179
+ test("getAutoWorktreeOriginalBase returns null at baseline (sanity)", () => {
180
+ assert.strictEqual(getAutoWorktreeOriginalBase(), null);
181
+ });
182
+
183
+ test("getActiveAutoWorktreeContext returns null at baseline (sanity)", () => {
184
+ assert.strictEqual(getActiveAutoWorktreeContext(), null);
185
+ });
186
+ });
@@ -102,7 +102,7 @@ describe("#2883: isToolInvocationError classification", () => {
102
102
  });
103
103
 
104
104
  test("detects raw write-gate CONTEXT failures for non-GSD write tools", () => {
105
- resetWriteGateState();
105
+ resetWriteGateState(process.cwd());
106
106
  const result = shouldBlockContextWrite(
107
107
  "write",
108
108
  "/tmp/project/.gsd/milestones/M001/M001-CONTEXT.md",
@@ -0,0 +1,239 @@
1
+ // GSD-2 + Tests verifying writer/validator path parity via MilestoneScope (C3)
2
+ //
3
+ // Critical invariant: a writer that constructs paths via scope.contextFile() /
4
+ // scope.roadmapFile() and a validator that resolves paths via the scope-based
5
+ // wrappers in guided-flow.ts must produce IDENTICAL absolute paths for the same
6
+ // logical inputs. If they diverge, writes go to a different location than the
7
+ // validator checks, causing silent failures.
8
+
9
+ import { describe, test, beforeEach, afterEach } from "node:test";
10
+ import assert from "node:assert/strict";
11
+ import { mkdtempSync, mkdirSync, rmSync, realpathSync, writeFileSync, unlinkSync } from "node:fs";
12
+ import { join } from "node:path";
13
+ import { tmpdir } from "node:os";
14
+
15
+ import { createWorkspace, scopeMilestone } from "../workspace.ts";
16
+ import {
17
+ verifyExpectedArtifactForScope,
18
+ resolveExpectedArtifactPathForScope,
19
+ isGhostMilestoneByScope,
20
+ } from "../guided-flow.ts";
21
+
22
+ // ─── Helpers ─────────────────────────────────────────────────────────────────
23
+
24
+ function makeProjectDir(label = "gsd-vsp-"): string {
25
+ const dir = realpathSync(mkdtempSync(join(tmpdir(), label)));
26
+ mkdirSync(join(dir, ".gsd", "milestones", "M001"), { recursive: true });
27
+ return dir;
28
+ }
29
+
30
+ // ─── Suite: writer/validator path parity ─────────────────────────────────────
31
+
32
+ describe("validator-scope-parity: writer and validator produce identical paths", () => {
33
+ let base: string;
34
+
35
+ beforeEach(() => {
36
+ base = makeProjectDir();
37
+ });
38
+
39
+ afterEach(() => {
40
+ if (base) rmSync(base, { recursive: true, force: true });
41
+ });
42
+
43
+ test("resolveExpectedArtifactPathForScope('discuss-milestone') matches scope.contextFile()", () => {
44
+ const ws = createWorkspace(base);
45
+ const scope = scopeMilestone(ws, "M001");
46
+
47
+ // Writer path: what the discuss/plan agent writes to
48
+ const writerPath = scope.contextFile();
49
+
50
+ // Validator path: what the validator checks
51
+ const validatorPath = resolveExpectedArtifactPathForScope(scope, "discuss-milestone", "M001");
52
+
53
+ assert.equal(
54
+ validatorPath,
55
+ writerPath,
56
+ "discuss-milestone artifact path must match scope.contextFile()",
57
+ );
58
+ });
59
+
60
+ test("resolveExpectedArtifactPathForScope('plan-milestone') matches scope.roadmapFile()", () => {
61
+ const ws = createWorkspace(base);
62
+ const scope = scopeMilestone(ws, "M001");
63
+
64
+ const writerPath = scope.roadmapFile();
65
+ const validatorPath = resolveExpectedArtifactPathForScope(scope, "plan-milestone", "M001");
66
+
67
+ assert.equal(
68
+ validatorPath,
69
+ writerPath,
70
+ "plan-milestone artifact path must match scope.roadmapFile()",
71
+ );
72
+ });
73
+
74
+ test("resolveExpectedArtifactPathForScope returns an absolute path", () => {
75
+ const ws = createWorkspace(base);
76
+ const scope = scopeMilestone(ws, "M001");
77
+
78
+ const path = resolveExpectedArtifactPathForScope(scope, "discuss-milestone", "M001");
79
+ assert.ok(path, "path must be non-null for a milestone unit");
80
+ assert.ok(path!.startsWith("/"), "path must be absolute");
81
+ });
82
+ });
83
+
84
+ // ─── Suite: cwd-drift immunity ────────────────────────────────────────────────
85
+
86
+ describe("validator-scope-parity: scope-based validators are immune to cwd-drift", () => {
87
+ let base: string;
88
+
89
+ beforeEach(() => {
90
+ base = makeProjectDir();
91
+ });
92
+
93
+ afterEach(() => {
94
+ if (base) rmSync(base, { recursive: true, force: true });
95
+ });
96
+
97
+ test("resolveExpectedArtifactPathForScope path is unchanged after process.chdir", (t) => {
98
+ const ws = createWorkspace(base);
99
+ const scope = scopeMilestone(ws, "M001");
100
+
101
+ const pathBefore = resolveExpectedArtifactPathForScope(scope, "plan-milestone", "M001");
102
+
103
+ const originalCwd = process.cwd();
104
+ const altDir = mkdtempSync(join(tmpdir(), "gsd-cwd-alt-"));
105
+ t.after(() => {
106
+ process.chdir(originalCwd);
107
+ rmSync(altDir, { recursive: true, force: true });
108
+ });
109
+
110
+ process.chdir(altDir);
111
+
112
+ const pathAfter = resolveExpectedArtifactPathForScope(scope, "plan-milestone", "M001");
113
+
114
+ assert.equal(
115
+ pathAfter,
116
+ pathBefore,
117
+ "artifact path must not change after cwd drift",
118
+ );
119
+ });
120
+
121
+ test("isGhostMilestoneByScope result is consistent before and after process.chdir", (t) => {
122
+ const ws = createWorkspace(base);
123
+ const scope = scopeMilestone(ws, "M001");
124
+
125
+ // No DB, no content files — should be ghost
126
+ const resultBefore = isGhostMilestoneByScope(scope);
127
+
128
+ const originalCwd = process.cwd();
129
+ const altDir = mkdtempSync(join(tmpdir(), "gsd-cwd-alt2-"));
130
+ t.after(() => {
131
+ process.chdir(originalCwd);
132
+ rmSync(altDir, { recursive: true, force: true });
133
+ });
134
+
135
+ process.chdir(altDir);
136
+
137
+ const resultAfter = isGhostMilestoneByScope(scope);
138
+
139
+ assert.equal(
140
+ resultAfter,
141
+ resultBefore,
142
+ "isGhostMilestoneByScope result must be consistent across cwd change",
143
+ );
144
+ });
145
+ });
146
+
147
+ // ─── Suite: isGhostMilestoneByScope behavior ─────────────────────────────────
148
+
149
+ describe("validator-scope-parity: isGhostMilestoneByScope correctness", () => {
150
+ let base: string;
151
+
152
+ beforeEach(() => {
153
+ base = makeProjectDir();
154
+ });
155
+
156
+ afterEach(() => {
157
+ if (base) rmSync(base, { recursive: true, force: true });
158
+ });
159
+
160
+ test("isGhostMilestoneByScope returns true for milestone dir with no content files", () => {
161
+ const ws = createWorkspace(base);
162
+ const scope = scopeMilestone(ws, "M001");
163
+
164
+ // M001 dir exists (created in beforeEach) but has no CONTEXT/ROADMAP/SUMMARY
165
+ assert.equal(
166
+ isGhostMilestoneByScope(scope),
167
+ true,
168
+ "empty milestone dir with no content files should be ghost",
169
+ );
170
+ });
171
+
172
+ test("isGhostMilestoneByScope returns false when CONTEXT.md exists", (t) => {
173
+ const ws = createWorkspace(base);
174
+ const scope = scopeMilestone(ws, "M001");
175
+
176
+ // Write CONTEXT.md so the milestone is no longer a ghost
177
+ writeFileSync(scope.contextFile(), "# M001: Test\n\nContext.\n");
178
+ t.after(() => {
179
+ try { unlinkSync(scope.contextFile()); } catch {}
180
+ });
181
+
182
+ assert.equal(
183
+ isGhostMilestoneByScope(scope),
184
+ false,
185
+ "milestone with CONTEXT.md should not be ghost",
186
+ );
187
+ });
188
+ });
189
+
190
+ // ─── Suite: worktree path resolves to canonical project root ─────────────────
191
+
192
+ describe("validator-scope-parity: scope uses canonical projectRoot not worktree path", () => {
193
+ let base: string;
194
+
195
+ beforeEach(() => {
196
+ base = makeProjectDir("gsd-wt-parity-");
197
+ });
198
+
199
+ afterEach(() => {
200
+ if (base) rmSync(base, { recursive: true, force: true });
201
+ });
202
+
203
+ test("scope.workspace.projectRoot equals the input base for a non-worktree project", () => {
204
+ const ws = createWorkspace(base);
205
+ // For a plain project (not a worktree), projectRoot should be the realpath of base
206
+ assert.equal(
207
+ ws.projectRoot,
208
+ realpathSync(base),
209
+ "projectRoot must be realpath of the input base for a non-worktree project",
210
+ );
211
+ });
212
+
213
+ test("validator wrapper paths are rooted at scope.workspace.projectRoot, not at a worktree dir", () => {
214
+ // Simulate calling with a workspace that has projectRoot set.
215
+ // The validator should use projectRoot, not a different runtime path.
216
+ const ws = createWorkspace(base);
217
+ const scope = scopeMilestone(ws, "M001");
218
+
219
+ const artifactPath = resolveExpectedArtifactPathForScope(scope, "plan-milestone", "M001");
220
+
221
+ assert.ok(
222
+ artifactPath!.startsWith(scope.workspace.projectRoot),
223
+ `artifact path '${artifactPath}' must be rooted at projectRoot '${scope.workspace.projectRoot}'`,
224
+ );
225
+ });
226
+
227
+ test("verifyExpectedArtifactForScope uses projectRoot: returns false for non-existent artifact", () => {
228
+ const ws = createWorkspace(base);
229
+ const scope = scopeMilestone(ws, "M001");
230
+
231
+ // The artifact does not exist on disk yet
232
+ const ready = verifyExpectedArtifactForScope(scope, "plan-milestone", "M001");
233
+ assert.equal(
234
+ ready,
235
+ false,
236
+ "verifyExpectedArtifactForScope should return false when artifact is absent",
237
+ );
238
+ });
239
+ });
@@ -50,8 +50,8 @@ test("guided execute-task requires canonical task completion tool", () => {
50
50
  assert.deepEqual(getRequiredWorkflowToolsForGuidedUnit("execute-task"), ["gsd_task_complete"]);
51
51
  });
52
52
 
53
- test("auto execute-task requires legacy completion alias until prompt contract is aligned", () => {
54
- assert.deepEqual(getRequiredWorkflowToolsForAutoUnit("execute-task"), ["gsd_complete_task"]);
53
+ test("auto execute-task requires canonical task completion tool", () => {
54
+ assert.deepEqual(getRequiredWorkflowToolsForAutoUnit("execute-task"), ["gsd_task_complete"]);
55
55
  });
56
56
 
57
57
  test("deep project setup units declare required workflow MCP tools", () => {
@@ -677,7 +677,7 @@ test("executeSummarySave removes sibling CONTEXT-DRAFT when writing milestone CO
677
677
  "CONTEXT-DRAFT.md should be removed after final CONTEXT.md is written",
678
678
  );
679
679
  } finally {
680
- clearDiscussionFlowState();
680
+ clearDiscussionFlowState(base);
681
681
  closeDatabase();
682
682
  cleanup(base);
683
683
  }
@@ -741,9 +741,7 @@ test("executeSummarySave blocks final root artifacts while approval gate is pend
741
741
  const base = makeTmpBase();
742
742
  try {
743
743
  openTestDb(base);
744
- await inProjectDir(base, async () => {
745
- setPendingGate("depth_verification_requirements_confirm");
746
- });
744
+ setPendingGate("depth_verification_requirements_confirm", base);
747
745
 
748
746
  const result = await inProjectDir(base, () => executeSummarySave({
749
747
  artifact_type: "REQUIREMENTS",
@@ -762,7 +760,7 @@ test("executeSummarySave blocks final root artifacts while approval gate is pend
762
760
  assert.equal(draft.isError, undefined);
763
761
  assert.ok(existsSync(join(base, ".gsd", "REQUIREMENTS-DRAFT.md")));
764
762
  } finally {
765
- clearDiscussionFlowState();
763
+ clearDiscussionFlowState(base);
766
764
  closeDatabase();
767
765
  cleanup(base);
768
766
  }
@@ -784,9 +782,7 @@ test("executeSummarySave requires verified root approval in deep mode", async ()
784
782
  assert.match(blocked.content[0].text, /fail-closed/);
785
783
  assert.equal(existsSync(join(base, ".gsd", "PROJECT.md")), false);
786
784
 
787
- await inProjectDir(base, async () => {
788
- markApprovalGateVerified("depth_verification_project_confirm", base);
789
- });
785
+ markApprovalGateVerified("depth_verification_project_confirm", base);
790
786
 
791
787
  const unblocked = await inProjectDir(base, () => executeSummarySave({
792
788
  artifact_type: "PROJECT",
@@ -797,7 +793,7 @@ test("executeSummarySave requires verified root approval in deep mode", async ()
797
793
  assert.equal(unblocked.details.path, "PROJECT.md");
798
794
  assert.ok(existsSync(join(base, ".gsd", "PROJECT.md")));
799
795
  } finally {
800
- clearDiscussionFlowState();
796
+ clearDiscussionFlowState(base);
801
797
  closeDatabase();
802
798
  cleanup(base);
803
799
  }
@@ -807,9 +803,7 @@ test("executeSummarySave renders final REQUIREMENTS from the DB source of truth"
807
803
  const base = makeTmpBase();
808
804
  try {
809
805
  openTestDb(base);
810
- await inProjectDir(base, async () => {
811
- markApprovalGateVerified("depth_verification_requirements_confirm", base);
812
- });
806
+ markApprovalGateVerified("depth_verification_requirements_confirm", base);
813
807
 
814
808
  upsertRequirement({
815
809
  id: "R001",
@@ -882,7 +876,7 @@ test("executeSummarySave renders final REQUIREMENTS from the DB source of truth"
882
876
  .get("REQUIREMENTS.md") as Record<string, unknown>;
883
877
  assert.equal(artifact.full_content, content);
884
878
  } finally {
885
- clearDiscussionFlowState();
879
+ clearDiscussionFlowState(base);
886
880
  closeDatabase();
887
881
  cleanup(base);
888
882
  }
@@ -992,7 +986,7 @@ test("executeSummarySave CONTEXT HARD BLOCK clears after write-gate state file i
992
986
  process.env.GSD_PERSIST_WRITE_GATE_STATE = "1";
993
987
  try {
994
988
  openTestDb(base);
995
- clearDiscussionFlowState();
989
+ clearDiscussionFlowState(base);
996
990
 
997
991
  // First call: CONTEXT artifact without depth verification → HARD BLOCK
998
992
  const blocked = await inProjectDir(base, () => executeSummarySave({
@@ -1043,7 +1037,7 @@ test("executeSummarySave CONTEXT HARD BLOCK clears after write-gate state file i
1043
1037
  } else {
1044
1038
  process.env.GSD_PERSIST_WRITE_GATE_STATE = originalEnv;
1045
1039
  }
1046
- clearDiscussionFlowState();
1040
+ clearDiscussionFlowState(base);
1047
1041
  closeDatabase();
1048
1042
  cleanup(base);
1049
1043
  }