@deftai/directive 0.62.0 → 0.64.0

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 (99) hide show
  1. package/dist/{branch-parity.d.ts → branch-fixtures.d.ts} +1 -3
  2. package/dist/{branch-parity.js → branch-fixtures.js} +3 -110
  3. package/dist/dispatch.d.ts +1 -1
  4. package/dist/dispatch.js +3 -1
  5. package/dist/orchestration-cli/coverage-map.js +1 -1
  6. package/dist/{policy-parity.d.ts → policy-fixtures.d.ts} +1 -3
  7. package/dist/{policy-parity.js → policy-fixtures.js} +4 -100
  8. package/dist/{release-e2e-parity.d.ts → release-e2e-fixtures.d.ts} +1 -3
  9. package/dist/release-e2e-fixtures.js +38 -0
  10. package/dist/{story-ready-parity.d.ts → story-ready-fixtures.d.ts} +1 -3
  11. package/dist/{story-ready-parity.js → story-ready-fixtures.js} +4 -121
  12. package/dist/{triage-aux-a-parity.d.ts → triage-aux-a-fixtures.d.ts} +1 -3
  13. package/dist/{triage-aux-a-parity.js → triage-aux-a-fixtures.js} +3 -73
  14. package/dist/{triage-aux-b-parity.d.ts → triage-aux-b-fixtures.d.ts} +1 -3
  15. package/dist/triage-aux-b-fixtures.js +167 -0
  16. package/dist/{triage-bootstrap-parity.d.ts → triage-bootstrap-fixtures.d.ts} +1 -3
  17. package/dist/{triage-bootstrap-parity.js → triage-bootstrap-fixtures.js} +4 -91
  18. package/dist/{triage-classify-parity.d.ts → triage-classify-fixtures.d.ts} +1 -3
  19. package/dist/{triage-classify-parity.js → triage-classify-fixtures.js} +4 -94
  20. package/dist/{triage-queue-parity.d.ts → triage-queue-fixtures.d.ts} +1 -3
  21. package/dist/{triage-queue-parity.js → triage-queue-fixtures.js} +4 -86
  22. package/dist/{triage-scope-parity.d.ts → triage-scope-fixtures.d.ts} +1 -3
  23. package/dist/{triage-scope-parity.js → triage-scope-fixtures.js} +4 -91
  24. package/dist/{vbrief-preflight-parity.d.ts → vbrief-preflight-fixtures.d.ts} +1 -3
  25. package/dist/vbrief-preflight-fixtures.js +79 -0
  26. package/dist/verify-source-cli/verify-cursor-tier1.d.ts +12 -0
  27. package/dist/verify-source-cli/verify-cursor-tier1.js +51 -0
  28. package/dist/{wip-cap-parity.d.ts → wip-cap-fixtures.d.ts} +1 -3
  29. package/dist/{wip-cap-parity.js → wip-cap-fixtures.js} +4 -91
  30. package/package.json +4 -15
  31. package/dist/cache-parity.d.ts +0 -36
  32. package/dist/cache-parity.js +0 -165
  33. package/dist/codebase-parity.d.ts +0 -31
  34. package/dist/codebase-parity.js +0 -303
  35. package/dist/doc-cli-parity.d.ts +0 -29
  36. package/dist/doc-cli-parity.js +0 -159
  37. package/dist/doctor-parity.d.ts +0 -42
  38. package/dist/doctor-parity.js +0 -157
  39. package/dist/intake-parity.d.ts +0 -30
  40. package/dist/intake-parity.js +0 -203
  41. package/dist/lifecycle-packs-parity.d.ts +0 -30
  42. package/dist/lifecycle-packs-parity.js +0 -377
  43. package/dist/orchestration-parity.d.ts +0 -38
  44. package/dist/orchestration-parity.js +0 -364
  45. package/dist/parity.d.ts +0 -36
  46. package/dist/parity.js +0 -176
  47. package/dist/platform-parity.d.ts +0 -26
  48. package/dist/platform-parity.js +0 -309
  49. package/dist/pr-closing-keywords-parity.d.ts +0 -45
  50. package/dist/pr-closing-keywords-parity.js +0 -259
  51. package/dist/pr-merge-readiness-parity.d.ts +0 -44
  52. package/dist/pr-merge-readiness-parity.js +0 -296
  53. package/dist/pr-monitor-parity.d.ts +0 -44
  54. package/dist/pr-monitor-parity.js +0 -283
  55. package/dist/pr-protected-issues-parity.d.ts +0 -41
  56. package/dist/pr-protected-issues-parity.js +0 -220
  57. package/dist/pr-wait-mergeable-parity.d.ts +0 -45
  58. package/dist/pr-wait-mergeable-parity.js +0 -340
  59. package/dist/release-e2e-parity.js +0 -114
  60. package/dist/release-parity.d.ts +0 -40
  61. package/dist/release-parity.js +0 -226
  62. package/dist/release-publish-parity.d.ts +0 -36
  63. package/dist/release-publish-parity.js +0 -138
  64. package/dist/release-rollback-parity.d.ts +0 -37
  65. package/dist/release-rollback-parity.js +0 -161
  66. package/dist/render-parity.d.ts +0 -36
  67. package/dist/render-parity.js +0 -385
  68. package/dist/scm-parity.d.ts +0 -39
  69. package/dist/scm-parity.js +0 -181
  70. package/dist/scope-lifecycle-parity.d.ts +0 -35
  71. package/dist/scope-lifecycle-parity.js +0 -177
  72. package/dist/session-parity.d.ts +0 -39
  73. package/dist/session-parity.js +0 -262
  74. package/dist/slice-parity.d.ts +0 -36
  75. package/dist/slice-parity.js +0 -304
  76. package/dist/swarm-parity.d.ts +0 -28
  77. package/dist/swarm-parity.js +0 -327
  78. package/dist/triage-actions-parity.d.ts +0 -36
  79. package/dist/triage-actions-parity.js +0 -357
  80. package/dist/triage-aux-b-parity.js +0 -308
  81. package/dist/triage-summary-parity.d.ts +0 -50
  82. package/dist/triage-summary-parity.js +0 -306
  83. package/dist/validate-content-parity.d.ts +0 -33
  84. package/dist/validate-content-parity.js +0 -356
  85. package/dist/vbrief-activate-parity.d.ts +0 -39
  86. package/dist/vbrief-activate-parity.js +0 -216
  87. package/dist/vbrief-build-parity.d.ts +0 -28
  88. package/dist/vbrief-build-parity.js +0 -399
  89. package/dist/vbrief-preflight-parity.js +0 -163
  90. package/dist/vbrief-reconcile-parity.d.ts +0 -23
  91. package/dist/vbrief-reconcile-parity.js +0 -609
  92. package/dist/vbrief-validate-parity.d.ts +0 -27
  93. package/dist/vbrief-validate-parity.js +0 -122
  94. package/dist/vbrief-validation-parity.d.ts +0 -28
  95. package/dist/vbrief-validation-parity.js +0 -645
  96. package/dist/verify-env-parity.d.ts +0 -28
  97. package/dist/verify-env-parity.js +0 -272
  98. package/dist/verify-source-parity.d.ts +0 -26
  99. package/dist/verify-source-parity.js +0 -178
@@ -1,16 +1,7 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Golden-output parity harness (#1725): builds throwaway fixture repos, runs
4
- * BOTH the Python oracle (`scripts/triage_queue.py queue`) and the ported TS
5
- * triage:queue CLI, and diffs exit codes + stdout/stderr (cache-off).
6
- *
7
- * Exit codes: 0 parity / 1 divergence / 2 harness setup error.
8
- */
9
- import { spawnSync } from "node:child_process";
10
- import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
1
+ /** Test fixtures extracted from legacy parity harness (#2083). */
2
+ import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
11
3
  import { tmpdir } from "node:os";
12
- import { dirname, join, resolve } from "node:path";
13
- import { fileURLToPath } from "node:url";
4
+ import { join } from "node:path";
14
5
  const DEFAULT_REPO = "owner/repo";
15
6
  /** Strip volatile absolute paths before compare. */
16
7
  export function normalizeOutput(text) {
@@ -18,25 +9,6 @@ export function normalizeOutput(text) {
18
9
  .replace(/^WARN [^\n]*\n/gm, "")
19
10
  .replace(/project_root=[^\s)]+/g, "project_root=<ROOT>");
20
11
  }
21
- function runCapture(cmd, args, cwd, env = {}) {
22
- const merged = { ...process.env, ...env };
23
- for (const key of Object.keys(merged)) {
24
- if (merged[key] === undefined) {
25
- delete merged[key];
26
- }
27
- }
28
- const result = spawnSync(cmd, args, {
29
- cwd,
30
- encoding: "utf8",
31
- env: merged,
32
- stdio: ["ignore", "pipe", "pipe"],
33
- });
34
- return {
35
- status: result.status ?? 2,
36
- stdout: typeof result.stdout === "string" ? result.stdout : "",
37
- stderr: typeof result.stderr === "string" ? result.stderr : "",
38
- };
39
- }
40
12
  function writeCachedIssue(root, repo, issue) {
41
13
  const parts = repo.split("/", 2);
42
14
  const owner = parts[0];
@@ -142,20 +114,6 @@ export function buildFixtureRepo(options = {}) {
142
114
  }
143
115
  return root;
144
116
  }
145
- function resolveDeftRoot() {
146
- if (process.env.DEFT_ROOT !== undefined && process.env.DEFT_ROOT.length > 0) {
147
- return resolve(process.env.DEFT_ROOT);
148
- }
149
- return resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
150
- }
151
- function runPythonQueue(deftRoot, _repo, argv) {
152
- const cap = runCapture("uv", ["run", "python", join(deftRoot, "scripts", "triage_queue.py"), "queue", ...argv], deftRoot, { DEFT_TRIAGE_REPO: undefined, PYTHONUTF8: "1" });
153
- return { exitCode: cap.status, stdout: cap.stdout, stderr: cap.stderr };
154
- }
155
- function runTsQueue(deftRoot, _repo, argv) {
156
- const cap = runCapture("node", [join(deftRoot, "packages", "cli", "dist", "triage-queue.js"), "queue", ...argv], deftRoot, { DEFT_TRIAGE_REPO: undefined });
157
- return { exitCode: cap.status, stdout: cap.stdout, stderr: cap.stderr };
158
- }
159
117
  /** Diff one parity case between Python oracle and TS CLI. */
160
118
  export function diffCase(python, ts, caseName) {
161
119
  const pyOut = normalizeOutput(python.stdout);
@@ -301,31 +259,6 @@ export function augmentParityArgv(testCase, root) {
301
259
  return [...argv, ...extras];
302
260
  }
303
261
  /** Run all parity cases; returns aggregate result. */
304
- export function runParity() {
305
- const deftRoot = resolveDeftRoot();
306
- const diffs = [];
307
- for (const testCase of PARITY_CASES) {
308
- const pyRepo = testCase.skipFixture
309
- ? mkdtempSync(join(tmpdir(), "deft-triage-queue-parity-"))
310
- : buildFixtureRepo(testCase.fixture);
311
- const tsRepo = testCase.skipFixture
312
- ? mkdtempSync(join(tmpdir(), "deft-triage-queue-parity-"))
313
- : buildFixtureRepo(testCase.fixture);
314
- const pyArgv = augmentParityArgv(testCase, pyRepo);
315
- const tsArgv = augmentParityArgv(testCase, tsRepo);
316
- try {
317
- const python = runPythonQueue(deftRoot, pyRepo, pyArgv);
318
- const ts = runTsQueue(deftRoot, tsRepo, tsArgv);
319
- diffs.push(diffCase(python, ts, testCase.name));
320
- }
321
- finally {
322
- rmSync(pyRepo, { recursive: true, force: true });
323
- rmSync(tsRepo, { recursive: true, force: true });
324
- }
325
- }
326
- const ok = diffs.every((diff) => !diff.exitMismatch && !diff.stdoutMismatch && !diff.stderrMismatch);
327
- return { ok, diffs };
328
- }
329
262
  export function renderReport(result) {
330
263
  if (result.ok) {
331
264
  return `triage:queue parity: CLEAN -- Python and TS agree on ${PARITY_CASES.length} cases.`;
@@ -347,19 +280,4 @@ export function renderReport(result) {
347
280
  }
348
281
  return lines.join("\n");
349
282
  }
350
- if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
351
- try {
352
- const result = runParity();
353
- if (result.ok) {
354
- process.stdout.write(`${renderReport(result)}\n`);
355
- process.exit(0);
356
- }
357
- process.stderr.write(`${renderReport(result)}\n`);
358
- process.exit(1);
359
- }
360
- catch (err) {
361
- process.stderr.write(`triage:queue parity: harness error -- ${String(err)}\n`);
362
- process.exit(2);
363
- }
364
- }
365
- //# sourceMappingURL=triage-queue-parity.js.map
283
+ //# sourceMappingURL=triage-queue-fixtures.js.map
@@ -1,4 +1,3 @@
1
- #!/usr/bin/env node
2
1
  export interface CommandCapture {
3
2
  readonly exitCode: number;
4
3
  readonly stdout: string;
@@ -29,6 +28,5 @@ export declare function normalizeOutput(text: string): string;
29
28
  export declare function buildFixtureRepo(options?: ScopeFixtureOptions): string;
30
29
  export declare function diffCase(python: CommandCapture, ts: CommandCapture, caseName: string): ParityDiff;
31
30
  export declare const PARITY_CASES: readonly ParityCase[];
32
- export declare function runParity(): ParityResult;
33
31
  export declare function renderReport(result: ParityResult): string;
34
- //# sourceMappingURL=triage-scope-parity.d.ts.map
32
+ //# sourceMappingURL=triage-scope-fixtures.d.ts.map
@@ -1,16 +1,7 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Golden-output parity harness (#1725): runs BOTH the Python oracle
4
- * (`scripts/triage_scope.py`) and the ported TS triage:scope CLI, then
5
- * diffs exit codes and normalised stdout/stderr (cache-off).
6
- *
7
- * Exit codes: 0 parity / 1 divergence / 2 harness setup error.
8
- */
9
- import { spawnSync } from "node:child_process";
10
- import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
1
+ /** Test fixtures extracted from legacy parity harness (#2083). */
2
+ import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
11
3
  import { tmpdir } from "node:os";
12
- import { dirname, join, resolve } from "node:path";
13
- import { fileURLToPath } from "node:url";
4
+ import { join } from "node:path";
14
5
  /** Strip volatile absolute paths before compare. */
15
6
  export function normalizeOutput(text) {
16
7
  return text
@@ -18,19 +9,6 @@ export function normalizeOutput(text) {
18
9
  .replace(/--cache-root [^\s]+/g, "--cache-root <ROOT>")
19
10
  .replace(/path=[^\s\n]+coverage\.json/g, "path=<ROOT>/coverage.json");
20
11
  }
21
- function runCapture(cmd, args, cwd) {
22
- const result = spawnSync(cmd, args, {
23
- cwd,
24
- encoding: "utf8",
25
- env: process.env,
26
- stdio: ["ignore", "pipe", "pipe"],
27
- });
28
- return {
29
- exitCode: result.status ?? 2,
30
- stdout: typeof result.stdout === "string" ? result.stdout : "",
31
- stderr: typeof result.stderr === "string" ? result.stderr : "",
32
- };
33
- }
34
12
  function writeProjectDefinition(root, policy = {}) {
35
13
  const dir = join(root, "vbrief");
36
14
  mkdirSync(dir, { recursive: true });
@@ -45,25 +23,6 @@ export function buildFixtureRepo(options = {}) {
45
23
  writeProjectDefinition(root, options.policy ?? {});
46
24
  return root;
47
25
  }
48
- function resolveDeftRoot() {
49
- if (process.env.DEFT_ROOT !== undefined && process.env.DEFT_ROOT.length > 0) {
50
- return resolve(process.env.DEFT_ROOT);
51
- }
52
- return resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
53
- }
54
- function runPythonScope(deftRoot, repo, argv) {
55
- return runCapture("uv", [
56
- "run",
57
- "python",
58
- join(deftRoot, "scripts", "triage_scope.py"),
59
- ...argv,
60
- "--project-root",
61
- repo,
62
- ], deftRoot);
63
- }
64
- function runTsScope(deftRoot, repo, argv) {
65
- return runCapture("node", [join(deftRoot, "packages", "cli", "dist", "triage-scope.js"), ...argv, "--project-root", repo], deftRoot);
66
- }
67
26
  export function diffCase(python, ts, caseName) {
68
27
  const pyOut = normalizeOutput(python.stdout);
69
28
  const tsOut = normalizeOutput(ts.stdout);
@@ -151,37 +110,6 @@ export const PARITY_CASES = [
151
110
  },
152
111
  },
153
112
  ];
154
- export function runParity() {
155
- const deftRoot = resolveDeftRoot();
156
- const diffs = [];
157
- for (const testCase of PARITY_CASES) {
158
- if (testCase.name === "invalid-project-root") {
159
- const missing = join(tmpdir(), `deft-missing-${Date.now()}`);
160
- const python = runPythonScope(deftRoot, missing, testCase.argv);
161
- const ts = runTsScope(deftRoot, missing, testCase.argv);
162
- diffs.push(diffCase(python, ts, testCase.name));
163
- continue;
164
- }
165
- const pyRepo = buildFixtureRepo(testCase.fixture);
166
- const tsRepo = buildFixtureRepo(testCase.fixture);
167
- try {
168
- const extraArgv = [...testCase.argv];
169
- if (testCase.name === "refresh-denominator-success") {
170
- const cacheRoot = mkdtempSync(join(tmpdir(), "deft-scope-cache-"));
171
- extraArgv.push("--cache-root", cacheRoot);
172
- }
173
- const python = runPythonScope(deftRoot, pyRepo, extraArgv);
174
- const ts = runTsScope(deftRoot, tsRepo, extraArgv);
175
- diffs.push(diffCase(python, ts, testCase.name));
176
- }
177
- finally {
178
- rmSync(pyRepo, { recursive: true, force: true });
179
- rmSync(tsRepo, { recursive: true, force: true });
180
- }
181
- }
182
- const ok = diffs.every((d) => !d.exitMismatch && !d.stdoutMismatch && !d.stderrMismatch);
183
- return { ok, diffs };
184
- }
185
113
  export function renderReport(result) {
186
114
  if (result.ok) {
187
115
  return `triage:scope parity: CLEAN -- Python and TS agree on ${PARITY_CASES.length} cases.`;
@@ -200,19 +128,4 @@ export function renderReport(result) {
200
128
  }
201
129
  return lines.join("\n");
202
130
  }
203
- if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
204
- try {
205
- const result = runParity();
206
- if (result.ok) {
207
- process.stdout.write(`${renderReport(result)}\n`);
208
- process.exit(0);
209
- }
210
- process.stderr.write(`${renderReport(result)}\n`);
211
- process.exit(1);
212
- }
213
- catch (err) {
214
- process.stderr.write(`triage:scope parity: harness error -- ${String(err)}\n`);
215
- process.exit(2);
216
- }
217
- }
218
- //# sourceMappingURL=triage-scope-parity.js.map
131
+ //# sourceMappingURL=triage-scope-fixtures.js.map
@@ -1,4 +1,3 @@
1
- #!/usr/bin/env node
2
1
  export interface JsonGateOutput {
3
2
  readonly exitCode: number;
4
3
  readonly ready: boolean;
@@ -28,7 +27,6 @@ export declare function diffOutputs(name: string, python: JsonGateOutput, ts: Js
28
27
  /** Build temp fixture files; returns map of label -> absolute path. */
29
28
  export declare function buildFixtures(root: string): Map<string, string>;
30
29
  /** Run both gates against all fixtures and diff them. */
31
- export declare function runParity(): ParityResult;
32
30
  /** Render a human-readable parity report (exported for unit tests). */
33
31
  export declare function renderReport(result: ParityResult): string;
34
- //# sourceMappingURL=vbrief-preflight-parity.d.ts.map
32
+ //# sourceMappingURL=vbrief-preflight-fixtures.d.ts.map
@@ -0,0 +1,79 @@
1
+ /** Test fixtures extracted from legacy parity harness (#2083). */
2
+ import { mkdirSync, writeFileSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ /** Fixture corpus: [label, folder, file content]. */
5
+ export const PARITY_FIXTURES = [
6
+ ["active_running", "active", JSON.stringify({ plan: { status: "running" } })],
7
+ ["pending", "pending", JSON.stringify({ plan: { status: "running" } })],
8
+ ["proposed", "proposed", JSON.stringify({ plan: { status: "running" } })],
9
+ ["malformed_json", "active", "{bad json"],
10
+ ["wrong_status", "active", JSON.stringify({ plan: { status: "pending" } })],
11
+ ["missing_plan_status", "active", JSON.stringify({ plan: {} })],
12
+ ];
13
+ /** Parse the structured `--json` stdout payload. */
14
+ export function parseJsonOutput(stdout, exitCode) {
15
+ const trimmed = stdout.trim();
16
+ let payload;
17
+ try {
18
+ payload = JSON.parse(trimmed);
19
+ }
20
+ catch {
21
+ throw new Error(`Expected JSON output but got: ${trimmed.length > 0 ? trimmed : "(empty)"}`);
22
+ }
23
+ return {
24
+ exitCode,
25
+ ready: payload.ready,
26
+ vbriefPath: payload.vbrief_path,
27
+ message: payload.message,
28
+ rawJson: trimmed,
29
+ };
30
+ }
31
+ /** Diff two gate JSON outputs for one fixture case. */
32
+ export function diffOutputs(name, python, ts) {
33
+ const exitMismatch = python.exitCode !== ts.exitCode;
34
+ const readyMismatch = python.ready !== ts.ready;
35
+ const messageMismatch = python.message !== ts.message;
36
+ return {
37
+ name,
38
+ ok: !exitMismatch && !readyMismatch && !messageMismatch,
39
+ pythonExit: python.exitCode,
40
+ tsExit: ts.exitCode,
41
+ exitMismatch,
42
+ readyMismatch,
43
+ messageMismatch,
44
+ };
45
+ }
46
+ /** Build temp fixture files; returns map of label -> absolute path. */
47
+ export function buildFixtures(root) {
48
+ const paths = new Map();
49
+ for (const [label, folder, content] of PARITY_FIXTURES) {
50
+ const dir = join(root, folder);
51
+ mkdirSync(dir, { recursive: true });
52
+ const file = join(dir, `${label}.vbrief.json`);
53
+ writeFileSync(file, content, { encoding: "utf8" });
54
+ paths.set(label, file);
55
+ }
56
+ return paths;
57
+ }
58
+ /** Run both gates against all fixtures and diff them. */
59
+ /** Render a human-readable parity report (exported for unit tests). */
60
+ export function renderReport(result) {
61
+ if (result.ok) {
62
+ return `vbrief_preflight parity: CLEAN -- Python and TS agree on ${result.cases.length} fixture(s).`;
63
+ }
64
+ const lines = ["vbrief_preflight parity: DIVERGENCE"];
65
+ for (const c of result.cases.filter((x) => !x.ok)) {
66
+ lines.push(` case ${c.name}:`);
67
+ if (c.exitMismatch) {
68
+ lines.push(` exit mismatch: python=${c.pythonExit} ts=${c.tsExit}`);
69
+ }
70
+ if (c.readyMismatch) {
71
+ lines.push(" ready mismatch");
72
+ }
73
+ if (c.messageMismatch) {
74
+ lines.push(" message mismatch");
75
+ }
76
+ }
77
+ return lines.join("\n");
78
+ }
79
+ //# sourceMappingURL=vbrief-preflight-fixtures.js.map
@@ -0,0 +1,12 @@
1
+ #!/usr/bin/env node
2
+ interface ParsedArgs {
3
+ projectRoot: string;
4
+ quiet: boolean;
5
+ error?: string;
6
+ }
7
+ /** Parse verify-cursor-tier1 CLI args (#1877). */
8
+ export declare function parseArgs(argv: string[]): ParsedArgs;
9
+ /** Run the gate and return the process exit code. */
10
+ export declare function run(argv: string[]): number;
11
+ export {};
12
+ //# sourceMappingURL=verify-cursor-tier1.d.ts.map
@@ -0,0 +1,51 @@
1
+ #!/usr/bin/env node
2
+ import { resolve } from "node:path";
3
+ import { fileURLToPath } from "node:url";
4
+ import { evaluateCursorTier1 } from "@deftai/directive-core/verify-source";
5
+ /** Parse verify-cursor-tier1 CLI args (#1877). */
6
+ export function parseArgs(argv) {
7
+ const parsed = { projectRoot: ".", quiet: false };
8
+ for (let i = 0; i < argv.length; i += 1) {
9
+ const arg = argv[i];
10
+ if (arg === "--quiet") {
11
+ parsed.quiet = true;
12
+ }
13
+ else if (arg === "--project-root") {
14
+ const value = argv[i + 1];
15
+ if (value === undefined) {
16
+ return { ...parsed, error: "argument --project-root: expected one argument" };
17
+ }
18
+ parsed.projectRoot = value;
19
+ i += 1;
20
+ }
21
+ else if (arg?.startsWith("--project-root=")) {
22
+ parsed.projectRoot = arg.slice("--project-root=".length);
23
+ }
24
+ else {
25
+ return { ...parsed, error: `unrecognized argument: ${arg}` };
26
+ }
27
+ }
28
+ return parsed;
29
+ }
30
+ /** Run the gate and return the process exit code. */
31
+ export function run(argv) {
32
+ const args = parseArgs(argv);
33
+ if (args.error !== undefined) {
34
+ process.stderr.write(`verify_cursor_tier1: ${args.error}\n`);
35
+ return 2;
36
+ }
37
+ const result = evaluateCursorTier1(resolve(args.projectRoot), { quiet: args.quiet });
38
+ if (result.code === 0) {
39
+ if (!args.quiet && result.message.length > 0) {
40
+ process.stdout.write(`${result.message}\n`);
41
+ }
42
+ }
43
+ else {
44
+ process.stderr.write(`${result.message}\n`);
45
+ }
46
+ return result.code;
47
+ }
48
+ if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
49
+ process.exit(run(process.argv.slice(2)));
50
+ }
51
+ //# sourceMappingURL=verify-cursor-tier1.js.map
@@ -1,4 +1,3 @@
1
- #!/usr/bin/env node
2
1
  export interface CommandCapture {
3
2
  readonly exitCode: number;
4
3
  readonly stdout: string;
@@ -34,6 +33,5 @@ export declare function buildFixtureRepo(options?: WipFixtureOptions): string;
34
33
  export declare function diffCase(python: CommandCapture, ts: CommandCapture, caseName: string): ParityDiff;
35
34
  export declare const PARITY_CASES: readonly ParityCase[];
36
35
  /** Run all parity cases; returns aggregate result. */
37
- export declare function runParity(): ParityResult;
38
36
  export declare function renderReport(result: ParityResult): string;
39
- //# sourceMappingURL=wip-cap-parity.d.ts.map
37
+ //# sourceMappingURL=wip-cap-fixtures.d.ts.map
@@ -1,38 +1,11 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Golden-output parity harness (#1723): builds throwaway fixture repos, runs
4
- * BOTH the Python oracle (`scripts/preflight_wip_cap.py`) and the ported TS
5
- * verify:wip-cap gate, and diffs exit codes + stdout/stderr (cache-off).
6
- *
7
- * Exit codes: 0 parity / 1 divergence / 2 harness setup error.
8
- */
9
- import { spawnSync } from "node:child_process";
10
- import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
1
+ /** Test fixtures extracted from legacy parity harness (#2083). */
2
+ import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
11
3
  import { tmpdir } from "node:os";
12
- import { dirname, join, resolve } from "node:path";
13
- import { fileURLToPath } from "node:url";
4
+ import { join } from "node:path";
14
5
  /** Strip volatile absolute paths before compare. */
15
6
  export function normalizeOutput(text) {
16
7
  return text.replace(/project_root=[^\s)]+/g, "project_root=<ROOT>");
17
8
  }
18
- function runCapture(cmd, args, cwd, env = {}) {
19
- const merged = { ...process.env, ...env };
20
- for (const key of Object.keys(merged)) {
21
- if (merged[key] === undefined)
22
- delete merged[key];
23
- }
24
- const result = spawnSync(cmd, args, {
25
- cwd,
26
- encoding: "utf8",
27
- env: merged,
28
- stdio: ["ignore", "pipe", "pipe"],
29
- });
30
- return {
31
- status: result.status ?? 2,
32
- stdout: typeof result.stdout === "string" ? result.stdout : "",
33
- stderr: typeof result.stderr === "string" ? result.stderr : "",
34
- };
35
- }
36
9
  function writeProjectDefinition(root, plan) {
37
10
  const dir = join(root, "vbrief");
38
11
  mkdirSync(dir, { recursive: true });
@@ -61,32 +34,6 @@ export function buildFixtureRepo(options = {}) {
61
34
  }
62
35
  return root;
63
36
  }
64
- function resolveDeftRoot() {
65
- if (process.env.DEFT_ROOT !== undefined && process.env.DEFT_ROOT.length > 0) {
66
- return resolve(process.env.DEFT_ROOT);
67
- }
68
- return resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
69
- }
70
- function runPythonWipCap(deftRoot, repo, argv) {
71
- const cap = runCapture("uv", [
72
- "run",
73
- "python",
74
- join(deftRoot, "scripts", "preflight_wip_cap.py"),
75
- ...argv,
76
- "--project-root",
77
- repo,
78
- ], deftRoot);
79
- return { exitCode: cap.status, stdout: cap.stdout, stderr: cap.stderr };
80
- }
81
- function runTsWipCap(deftRoot, repo, argv) {
82
- const cap = runCapture("node", [
83
- join(deftRoot, "packages", "cli", "dist", "verify-wip-cap.js"),
84
- ...argv,
85
- "--project-root",
86
- repo,
87
- ], deftRoot);
88
- return { exitCode: cap.status, stdout: cap.stdout, stderr: cap.stderr };
89
- }
90
37
  /** Diff one parity case between Python oracle and TS CLI. */
91
38
  export function diffCase(python, ts, caseName) {
92
39
  const pyOut = normalizeOutput(python.stdout);
@@ -154,25 +101,6 @@ export const PARITY_CASES = [
154
101
  },
155
102
  ];
156
103
  /** Run all parity cases; returns aggregate result. */
157
- export function runParity() {
158
- const deftRoot = resolveDeftRoot();
159
- const diffs = [];
160
- for (const testCase of PARITY_CASES) {
161
- const pyRepo = buildFixtureRepo(testCase.fixture);
162
- const tsRepo = buildFixtureRepo(testCase.fixture);
163
- try {
164
- const python = runPythonWipCap(deftRoot, pyRepo, testCase.argv);
165
- const ts = runTsWipCap(deftRoot, tsRepo, testCase.argv);
166
- diffs.push(diffCase(python, ts, testCase.name));
167
- }
168
- finally {
169
- rmSync(pyRepo, { recursive: true, force: true });
170
- rmSync(tsRepo, { recursive: true, force: true });
171
- }
172
- }
173
- const ok = diffs.every((d) => !d.exitMismatch && !d.stdoutMismatch && !d.stderrMismatch);
174
- return { ok, diffs };
175
- }
176
104
  export function renderReport(result) {
177
105
  if (result.ok) {
178
106
  return `verify:wip-cap parity: CLEAN -- Python and TS agree on ${PARITY_CASES.length} cases.`;
@@ -191,19 +119,4 @@ export function renderReport(result) {
191
119
  }
192
120
  return lines.join("\n");
193
121
  }
194
- if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
195
- try {
196
- const result = runParity();
197
- if (result.ok) {
198
- process.stdout.write(`${renderReport(result)}\n`);
199
- process.exit(0);
200
- }
201
- process.stderr.write(`${renderReport(result)}\n`);
202
- process.exit(1);
203
- }
204
- catch (err) {
205
- process.stderr.write(`verify:wip-cap parity: harness error -- ${String(err)}\n`);
206
- process.exit(2);
207
- }
208
- }
209
- //# sourceMappingURL=wip-cap-parity.js.map
122
+ //# sourceMappingURL=wip-cap-fixtures.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deftai/directive",
3
- "version": "0.62.0",
3
+ "version": "0.64.0",
4
4
  "description": "Directive CLI — npm install path for the Deft Directive framework.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -9,18 +9,7 @@
9
9
  "directive": "./dist/bin.js",
10
10
  "deft": "./dist/bin.js",
11
11
  "deft-ts": "./dist/bin.js",
12
- "deft-verify-encoding": "./dist/verify-encoding.js",
13
- "deft-encoding-parity": "./dist/parity.js",
14
- "deft-policy": "./dist/policy.js",
15
- "deft-policy-parity": "./dist/policy-parity.js",
16
- "deft-vbrief-preflight": "./dist/vbrief-preflight.js",
17
- "deft-vbrief-preflight-parity": "./dist/vbrief-preflight-parity.js",
18
- "deft-verify-story-ready": "./dist/verify-story-ready.js",
19
- "deft-story-ready-parity": "./dist/story-ready-parity.js",
20
- "deft-verify-branch": "./dist/verify-branch.js",
21
- "deft-branch-parity": "./dist/branch-parity.js",
22
- "deft-verify-wip-cap": "./dist/verify-wip-cap.js",
23
- "deft-wip-cap-parity": "./dist/wip-cap-parity.js"
12
+ "deft-verify-encoding": "./dist/verify-encoding.js"
24
13
  },
25
14
  "exports": {
26
15
  ".": {
@@ -42,8 +31,8 @@
42
31
  "provenance": true
43
32
  },
44
33
  "dependencies": {
45
- "@deftai/directive-core": "^0.62.0",
46
- "@deftai/directive-content": "^0.62.0"
34
+ "@deftai/directive-core": "^0.64.0",
35
+ "@deftai/directive-content": "^0.64.0"
47
36
  },
48
37
  "scripts": {
49
38
  "build": "tsc -b"
@@ -1,36 +0,0 @@
1
- #!/usr/bin/env node
2
- export interface ScenarioResult {
3
- readonly name: string;
4
- readonly exitCode: number;
5
- readonly stdout: string;
6
- readonly stderr: string;
7
- }
8
- export interface ParityScenario {
9
- readonly name: string;
10
- readonly argv: readonly string[];
11
- }
12
- export interface ParityResult {
13
- readonly ok: boolean;
14
- readonly scenarios: Array<{
15
- readonly name: string;
16
- readonly exitMismatch: boolean;
17
- readonly pythonExit: number;
18
- readonly tsExit: number;
19
- readonly messageMismatch: boolean;
20
- readonly pythonMessage: string;
21
- readonly tsMessage: string;
22
- }>;
23
- }
24
- /** Validation-only scenarios (no live gh network). */
25
- export declare const PARITY_SCENARIOS: readonly ParityScenario[];
26
- /** Normalise gate output for comparison. */
27
- export declare function normaliseMessage(stdout: string, stderr: string, exitCode: number): string;
28
- export declare function diffParity(python: ScenarioResult, ts: ScenarioResult): {
29
- exitMismatch: boolean;
30
- messageMismatch: boolean;
31
- pythonMessage: string;
32
- tsMessage: string;
33
- };
34
- export declare function runParity(): ParityResult;
35
- export declare function renderReport(result: ParityResult): string;
36
- //# sourceMappingURL=cache-parity.d.ts.map