fix(#4628): expose DAG-ready plans and restrict dispatch to them (#4781)

Emitted-Drift-Ack-Growth: execute-phase.md — #4628 consumer wiring: ready_plans parse pointer, not-ready named skip, and waiting condition 2b reference to the ready-wave-gate step file

Co-authored-by: sim <sim@local>
This commit is contained in:
Tom Boucher
2026-09-16 02:38:43 -04:00
committed by GitHub
parent febe6c9885
commit 740ba0d8a3
41 changed files with 432 additions and 684 deletions

View File

@@ -37,12 +37,9 @@ const TIMEOUT = 5000;
// site 1/2 (execute-phase.md): source PHASE_NUMBER, prefix PHASE
// site 3 (completion-reconciliation.md): source SPOT_PHASE_NUMBER, prefix SPOT_PHASE
// site 4 (tdd.md): source PHASE, prefix PHASE
// #4748: the split is at the first NON-DIGIT, not the first dot, so a letter
// suffix (`03A`, `23A.1.2`) rides through in the rest instead of aborting the
// base-10 arithmetic; the rest is `_REST`, no longer only a `_FRAC`.
function fixedSnippet(sourceVar, prefix, indent = '') {
return `${indent}${prefix}_INT=\${${sourceVar}%%[!0-9]*}; ${prefix}_REST=\${${sourceVar}#"$${prefix}_INT"}\n` +
`${indent}${prefix}_N="$((10#$${prefix}_INT))\${${prefix}_REST//./\\\\.}"`;
return `${indent}${prefix}_INT=\${${sourceVar}%%.*}; ${prefix}_FRAC=\${${sourceVar}#"$${prefix}_INT"}\n` +
`${indent}${prefix}_N="$((10#$${prefix}_INT))\${${prefix}_FRAC//./\\\\.}"`;
}
function runFixed(phaseNumberValue) {
@@ -67,11 +64,6 @@ describe('#4619 — execute-phase decimal/N-segment phase-number arithmetic', ()
assert.equal(runFixed('01'), '1');
});
test('#4748: a letter-suffixed phase number keeps its letter and zero-strips the digit run (03A -> 3A, 23A.1.2 -> 23A\\.1\\.2)', () => {
assert.equal(runFixed('03A'), '3A');
assert.equal(runFixed('23A.1.2'), '23A\\.1\\.2');
});
test('failing-first: the OLD $((10#...)) form is a hard shell syntax error on a decimal phase number', () => {
assert.throws(() => {
execFileSync('bash', ['-c', 'echo $((10#01.1))'], { encoding: 'utf8', timeout: TIMEOUT });
@@ -131,13 +123,13 @@ describe('#4619 — execute-phase decimal/N-segment phase-number arithmetic', ()
});
describe('source parity — each of the 4 production sites carries the fixed logic', () => {
test('execute-phase.md safe_resume_gate carries the fixed PHASE_NUMBER/PHASE_INT/PHASE_REST/PHASE_N logic', () => {
test('execute-phase.md safe_resume_gate carries the fixed PHASE_NUMBER/PHASE_INT/PHASE_FRAC/PHASE_N logic', () => {
const w = fs.readFileSync(EXECUTE_PHASE, 'utf8');
assert.ok(w.includes(fixedSnippet('PHASE_NUMBER', 'PHASE')),
'safe_resume_gate must carry the byte-identical fixed decimal-tolerant snippet');
});
test('execute-phase.md TDD gate carries the fixed PHASE_NUMBER/PHASE_INT/PHASE_REST/PHASE_N logic', () => {
test('execute-phase.md TDD gate carries the fixed PHASE_NUMBER/PHASE_INT/PHASE_FRAC/PHASE_N logic', () => {
const w = fs.readFileSync(EXECUTE_PHASE, 'utf8');
// The TDD gate block is nested one level deeper (4-space indent) than
// safe_resume_gate's top-level snippet.

View File

@@ -18,9 +18,9 @@
"reductionPct": 16.51
},
"execute-phase": {
"offTokens": 26264,
"onTokens": 24013,
"reductionPct": 8.57
"offTokens": 26259,
"onTokens": 23969,
"reductionPct": 8.72
},
"new-project": {
"offTokens": 14308,
@@ -39,8 +39,8 @@
}
},
"aggregate": {
"offTokens": 108307,
"onTokens": 91659,
"reductionPct": 15.37
"offTokens": 108302,
"onTokens": 91615,
"reductionPct": 15.41
}
}

View File

@@ -449,6 +449,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -521,6 +521,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -385,6 +385,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -449,6 +449,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -451,6 +451,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -521,6 +521,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -485,6 +485,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -450,6 +450,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -449,6 +449,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -449,6 +449,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -521,6 +521,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -450,6 +450,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -457,6 +457,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -521,6 +521,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -251,6 +251,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -449,6 +449,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -449,6 +449,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -377,6 +377,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -521,6 +521,7 @@
"gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md",
"gsd-core/workflows/execute-phase/steps/post-merge-gate.md",
"gsd-core/workflows/execute-phase/steps/protected-branch.md",
"gsd-core/workflows/execute-phase/steps/ready-wave-gate.md",
"gsd-core/workflows/execute-phase/steps/regression-gate-run.md",
"gsd-core/workflows/execute-phase/steps/regression-gate.md",
"gsd-core/workflows/execute-phase/steps/sequential-root-pin.md",

View File

@@ -1087,34 +1087,6 @@ describe('init commands ROADMAP fallback when phase directory does not exist (#1
assert.strictEqual(output.phase_name, 'Foundation Setup');
assert.strictEqual(output.phase_slug, 'foundation-setup');
assert.strictEqual(output.phase_req_ids, 'R-01, R-02');
// #4748: the ROADMAP fallback hands the workflow an UNPADDED number, and
// execute-phase.md used to re-pad it with `printf "%02d"` — which cannot
// pad a letter id and reads an already-padded `08` as octal. The
// normalized form is emitted here, like the plan-phase sibling above.
assert.strictEqual(output.padded_phase, '01');
});
test('#4748 — init execute-phase emits padded_phase for a letter-suffixed phase, from a directory and from the ROADMAP fallback', () => {
fs.appendFileSync(
path.join(tmpDir, '.planning', 'ROADMAP.md'),
'\n### Phase 3A: Letter Variant\n**Goal:** On disk\n\n### Phase 4B: Roadmap Only\n**Goal:** No directory yet\n',
);
seedPhase(tmpDir, '03A-letter-variant', { '03A-01-PLAN.md': '# Plan' });
const onDisk = JSON.parse(runGsdTools('init execute-phase 3A', tmpDir).output);
assert.strictEqual(onDisk.phase_found, true);
assert.strictEqual(onDisk.phase_number, '03A');
assert.strictEqual(onDisk.padded_phase, '03A');
const roadmapOnly = JSON.parse(runGsdTools('init execute-phase 4B', tmpDir).output);
assert.strictEqual(roadmapOnly.phase_found, true);
assert.strictEqual(roadmapOnly.phase_dir, null);
assert.strictEqual(roadmapOnly.phase_number, '4B');
assert.strictEqual(roadmapOnly.padded_phase, '04B');
const missing = JSON.parse(runGsdTools('init execute-phase 9Z', tmpDir).output);
assert.strictEqual(missing.phase_found, false);
assert.strictEqual(missing.padded_phase, null);
});
test('init verify-work falls back to ROADMAP when no phase directory exists', () => {

View File

@@ -12,10 +12,6 @@ const {
scanMarkdownSingleSegmentPhaseRegex,
findLetterlessPhaseMirrorDrift,
scanMarkdownLetterlessPhaseMirror,
findDotOnlyIntegerSplitDrift,
findLooseDottedPhaseRegexDrift,
findShellPhasePrintfPadDrift,
scanMarkdownLetterAxisConsumers,
} = require('../scripts/lint-phase-id-drift.cjs');
const ROOT = path.join(__dirname, '..');
@@ -216,119 +212,3 @@ test('findLetterlessPhaseMirrorDrift does NOT flag a site sanctioned with an HTM
test('scanMarkdownLetterlessPhaseMirror against the real repo tree reports zero violations (#4660 fixed)', () => {
assert.deepEqual(scanMarkdownLetterlessPhaseMirror(ROOT), []);
});
// #4748 (epic #4634): the three letter-hostile CONSUMER shapes — a dot-only
// integer split, a `[0-9]+\.?[0-9]*` extraction, a `printf "%02d"` re-pad.
// a. dot-only integer split
test('findDotOnlyIntegerSplitDrift flags the post-#4619 `PHASE_INT=${PHASE_NUMBER%%.*}` split', () => {
const text = 'PHASE_INT=${PHASE_NUMBER%%.*}; PHASE_FRAC=${PHASE_NUMBER#"$PHASE_INT"}';
const found = findDotOnlyIntegerSplitDrift(text);
assert.equal(found.length, 1);
assert.equal(found[0].line, 1);
assert.equal(found[0].found, 'PHASE_INT=${PHASE_NUMBER%%.*}');
});
test('findDotOnlyIntegerSplitDrift flags the prefixed SPOT_ variant and the bare $PHASE source', () => {
assert.equal(findDotOnlyIntegerSplitDrift('SPOT_PHASE_INT=${SPOT_PHASE_NUMBER%%.*}').length, 1);
assert.equal(findDotOnlyIntegerSplitDrift('PHASE_INT=${PHASE%%.*}; PHASE_FRAC=${PHASE#"$PHASE_INT"}').length, 1);
});
test('findDotOnlyIntegerSplitDrift flags the quoted spelling of an _INT split', () => {
assert.equal(findDotOnlyIntegerSplitDrift('PHASE_INT="${PHASE_NUMBER%%.*}"').length, 1);
});
test('findDotOnlyIntegerSplitDrift is SILENT on a dot split into a non-_INT name (a parent-phase derivation is correct as-is)', () => {
// gap-closure-artifacts.md: the parent of `03A.1` is `03A` — everything before
// the first dot, letter included. Not an integer, not fed to $((10#…)).
assert.deepEqual(findDotOnlyIntegerSplitDrift('PARENT_PHASE="${PHASE_NUMBER%%.*}"'), []);
assert.deepEqual(findDotOnlyIntegerSplitDrift('PHASE_PREFIX=${PHASE_NUMBER%%.*}'), []);
});
test('findDotOnlyIntegerSplitDrift is SILENT on the fixed first-non-digit split', () => {
const text = 'PHASE_INT=${PHASE_NUMBER%%[!0-9]*}; PHASE_REST=${PHASE_NUMBER#"$PHASE_INT"}';
assert.deepEqual(findDotOnlyIntegerSplitDrift(text), []);
});
test('findDotOnlyIntegerSplitDrift does NOT flag a split of a non-phase variable (a version, a plan)', () => {
assert.deepEqual(findDotOnlyIntegerSplitDrift('MAJOR_INT=${VERSION%%.*}'), []);
assert.deepEqual(findDotOnlyIntegerSplitDrift('PLAN_INT=${PLAN_ID%%.*}'), []);
});
test('findDotOnlyIntegerSplitDrift skips a full-line comment and honours the HTML sanction', () => {
assert.deepEqual(findDotOnlyIntegerSplitDrift('# was: PHASE_INT=${PHASE_NUMBER%%.*}'), []);
const text = [
'<!-- phase-id-owner: deliberate, this site never sees a letter id -->',
'PHASE_INT=${PHASE_NUMBER%%.*}',
].join('\n');
assert.deepEqual(findDotOnlyIntegerSplitDrift(text), []);
});
// b. loose dotted extraction
test('findLooseDottedPhaseRegexDrift flags the `[0-9]+\\.?[0-9]*` grep -oE extraction on a phase-carrying line', () => {
const text = "FROM_PHASE=$(echo \"$ARGUMENTS\" | grep -oE '\\-\\-from\\s+[0-9]+\\.?[0-9]*' | awk '{print $2}')";
const found = findLooseDottedPhaseRegexDrift(text);
assert.equal(found.length, 1);
assert.equal(found[0].found, '[0-9]+\\.?[0-9]*');
});
test('findLooseDottedPhaseRegexDrift flags the \\d near-variant', () => {
assert.equal(findLooseDottedPhaseRegexDrift("PHASE=$(echo \"$ARGUMENTS\" | grep -oE '\\d+\\.?\\d*')").length, 1);
});
test('findLooseDottedPhaseRegexDrift is SILENT on the canonical `[0-9]+[A-Z]?(\\.[0-9]+)*` form', () => {
const text = "PHASE=$(echo \"$ARGUMENTS\" | grep -oE '[0-9]+[A-Z]?(\\.[0-9]+)*' | head -1)";
assert.deepEqual(findLooseDottedPhaseRegexDrift(text), []);
});
test('findLooseDottedPhaseRegexDrift does NOT overlap the single-segment or letterless rules', () => {
const bounded = 'if ! [[ "$PADDED_PHASE" =~ ^[0-9]+(\\.[0-9]+)?$ ]]; then';
const letterless = 'if ! [[ "$PADDED_PHASE" =~ ^[0-9]+(\\.[0-9]+)*$ ]]; then';
assert.deepEqual(findLooseDottedPhaseRegexDrift(bounded), []);
assert.deepEqual(findLooseDottedPhaseRegexDrift(letterless), []);
});
test('findLooseDottedPhaseRegexDrift does NOT flag a non-phase-carrying line (a version) and honours the sanction', () => {
assert.deepEqual(findLooseDottedPhaseRegexDrift("MAJOR=$(echo \"$VERSION\" | grep -oE '[0-9]+\\.?[0-9]*')"), []);
const text = [
'<!-- phase-id-owner: deliberate, tracked in #4748 -->',
"PHASE=$(echo \"$ARGUMENTS\" | grep -oE '[0-9]+\\.?[0-9]*' | head -1)",
].join('\n');
assert.deepEqual(findLooseDottedPhaseRegexDrift(text), []);
});
// c. printf re-pad
test('findShellPhasePrintfPadDrift flags `printf "%02d"` of a phase variable, braced or bare', () => {
const found = findShellPhasePrintfPadDrift('PADDED=$(printf "%02d" "${PHASE_NUMBER}")');
assert.equal(found.length, 1);
assert.equal(found[0].found, 'printf "%0…d" …$PHASE_NUMBER');
assert.equal(findShellPhasePrintfPadDrift('PHASE=$(printf "%02d" "$PHASE")').length, 1);
assert.equal(findShellPhasePrintfPadDrift('PHASE=$(printf "%02d.%s" "${PHASE_MAJOR}" "${PHASE_MINOR}")').length, 1);
});
test('findShellPhasePrintfPadDrift flags the single-quoted format and a width without the zero flag', () => {
assert.equal(findShellPhasePrintfPadDrift("PADDED=$(printf '%02d' \"$PHASE_NUMBER\")").length, 1);
assert.equal(findShellPhasePrintfPadDrift('PADDED=$(printf "%2d" "$PHASE_NUMBER")').length, 1);
});
test('findShellPhasePrintfPadDrift is SILENT on a pad of an _INT via $((10#…)) and on init\'s padded_phase binding', () => {
assert.deepEqual(findShellPhasePrintfPadDrift('PHASE=$(printf "%02d" "$((10#$PHASE_INT))")${BASH_REMATCH[2]}'), []);
assert.deepEqual(findShellPhasePrintfPadDrift('PADDED="{padded_phase}"'), []);
});
test('findShellPhasePrintfPadDrift does NOT flag a pad of a non-phase variable (a plan number)', () => {
assert.deepEqual(findShellPhasePrintfPadDrift('PLAN_PADDED=$(printf "%02d" "$PLAN_ID")'), []);
});
test('findShellPhasePrintfPadDrift skips a full-line comment and honours the HTML sanction', () => {
assert.deepEqual(findShellPhasePrintfPadDrift('# PADDED=$(printf "%02d" "${PHASE_NUMBER}")'), []);
const text = [
'<!-- phase-id-owner: integer-only surface, tracked in #4748 -->',
'PADDED=$(printf "%02d" "${PHASE_NUMBER}")',
].join('\n');
assert.deepEqual(findShellPhasePrintfPadDrift(text), []);
});
test('scanMarkdownLetterAxisConsumers against the real repo tree reports zero violations (#4748 fixed)', () => {
assert.deepEqual(scanMarkdownLetterAxisConsumers(ROOT), []);
});

View File

@@ -191,7 +191,6 @@ describe('#4568 — plan-phase.md captures the full N-segment --research-phase v
// The canonical grammar is read from the committed bin/lib mirror the other
// grammar tests use (shell cannot import it; the test can).
const { PHASE_NUMBER_TOKEN_SOURCE } = require('../gsd-core/bin/lib/phase-id.cjs');
const { splitLines } = require('../gsd-core/bin/lib/text-lines.cjs');
const CANONICAL_ANCHORED = new RegExp('^(?:' + PHASE_NUMBER_TOKEN_SOURCE + ')$');
// Inputs the canonical grammar ACCEPTS. `03A` is what `normalizePhaseName('3A')`
@@ -319,290 +318,3 @@ describe('#4660 — plan-phase.md captures the full letter-suffixed --research-p
});
}
});
// ---------------------------------------------------------------------------
// #4748 — the letter axis at the seven shell sites OUTSIDE #4660's six. These
// are not grammar mirrors but consumers of the id: the post-#4619
// `PHASE_INT=${PHASE_NUMBER%%.*}; $((10#$PHASE_INT))` split (four sites),
// the `printf "%02d"` re-pad before the REVIEW.md lookup (one site), the
// `[0-9]+\.?[0-9]*` argument extraction (two files, four lines) and the
// legacy manual normalizer. On a letter-suffixed id the first aborts bash,
// the second prints the wrong file, the last two silently truncate. Same
// discipline as above: each site's live lines are read off disk by anchor
// and executed in a real bash subprocess.
// ---------------------------------------------------------------------------
const EXECUTE_PHASE = path.join(__dirname, '..', 'gsd-core', 'workflows', 'execute-phase.md');
const COMPLETION_RECONCILIATION = path.join(
__dirname, '..', 'gsd-core', 'workflows', 'execute-phase', 'steps', 'completion-reconciliation.md',
);
const TDD_REF = path.join(__dirname, '..', 'gsd-core', 'references', 'tdd.md');
const AUTONOMOUS = path.join(__dirname, '..', 'gsd-core', 'workflows', 'autonomous.md');
const PLAN_REVIEW_CONVERGENCE = path.join(__dirname, '..', 'gsd-core', 'workflows', 'plan-review-convergence.md');
const PHASE_ARGUMENT_PARSING = path.join(__dirname, '..', 'gsd-core', 'references', 'phase-argument-parsing.md');
/**
* Pure: the indexes of every line containing `anchor`. Asserts the count so a
* site that is added, removed or renamed breaks this test loudly instead of
* silently narrowing what it covers (execute-phase.md carries the split TWICE
* — plan selection and the TDD gate — and both must stay under test).
*/
function findAnchoredLineIndexes(lines, anchor, expectedCount) {
const idx = [];
lines.forEach((l, i) => {
if (l.includes(anchor)) idx.push(i);
});
assert.equal(
idx.length,
expectedCount,
`expected ${expectedCount} line(s) containing ${JSON.stringify(anchor)}, found ${idx.length}`,
);
return idx;
}
/** Run `script` in bash with `env` merged in; never throws — returns { status, stdout, stderr }. */
function runBash(script, env) {
try {
const stdout = execFileSync('bash', [], {
input: script,
encoding: 'utf8',
timeout: TIMEOUT,
env: { ...process.env, ...env },
stdio: ['pipe', 'pipe', 'pipe'],
});
return { status: 0, stdout: stdout.trim(), stderr: '' };
} catch (e) {
return { status: e.status, stdout: String(e.stdout || '').trim(), stderr: String(e.stderr || '').trim() };
}
}
// What each Class 1 site must compute from the id it is handed: the integer
// half zero-stripped for the anchored `0*` commit-scope ERE, everything after
// it carried through with dots escaped. `03A` is the padded form `init` emits
// for a `03A-slug/` directory; `12A` / `3A` are the bare forms; `03A.1.2` is
// the letter-and-N-segment combination the canonical grammar admits.
const CLASS1_CASES = [
// [PHASE_NUMBER, expected PHASE_N]
['03A', '3A'],
['12A', '12A'],
['3A', '3A'],
['03A.1.2', '3A\\.1\\.2'],
];
const CLASS1_CONTROLS = [
['06', '6'],
['7', '7'],
['08.5', '8\\.5'],
['23.1.2', '23\\.1\\.2'],
];
describe('#4748 — the $((10#$PHASE_INT)) split sites carry a letter suffix into PHASE_N instead of aborting', () => {
const sites = [
// execute-phase.md: plan selection (safe_resume_gate) and the TDD gate a
// few lines below are the same two lines twice; both must be under test.
{ name: 'execute-phase.md', file: EXECUTE_PHASE, anchor: 'PHASE_INT=${PHASE_NUMBER%%', count: 2, input: 'PHASE_NUMBER', output: 'PHASE_N' },
{ name: 'completion-reconciliation.md', file: COMPLETION_RECONCILIATION, anchor: 'SPOT_PHASE_INT=${SPOT_PHASE_NUMBER%%', count: 1, input: 'SPOT_PHASE_NUMBER', output: 'SPOT_PHASE_N' },
{ name: 'tdd.md', file: TDD_REF, anchor: 'PHASE_INT=${PHASE%%', count: 1, input: 'PHASE', output: 'PHASE_N' },
];
for (const site of sites) {
describe(site.name, () => {
const lines = splitLines(fs.readFileSync(site.file, 'utf8'));
const indexes = findAnchoredLineIndexes(lines, site.anchor, site.count);
indexes.forEach((i, n) => {
// The split line and the PHASE_N line directly below it, verbatim.
const splitLine = lines[i].trim();
const nLine = lines[i + 1].trim();
assert.ok(nLine.startsWith(`${site.output}=`), `line after the split must assign ${site.output}: ${nLine}`);
const snippet = ['set -e', splitLine, nLine, `printf '%s' "$${site.output}"`].join('\n');
const label = site.count > 1 ? ` (occurrence ${n + 1})` : '';
for (const [id, expected] of CLASS1_CASES) {
test(`${id} → ${site.output}=${expected} without a shell error${label} (fails before the fix)`, () => {
const r = runBash(snippet, { [site.input]: id });
assert.equal(r.status, 0, `bash exited ${r.status}: ${r.stderr}`);
assert.equal(r.stdout, expected);
});
}
for (const [id, expected] of CLASS1_CONTROLS) {
test(`regression control: ${id} → ${site.output}=${expected}${label}`, () => {
const r = runBash(snippet, { [site.input]: id });
assert.equal(r.status, 0, `bash exited ${r.status}: ${r.stderr}`);
assert.equal(r.stdout, expected);
});
}
test(`the commit-scope ERE built from PHASE_N matches both the padded and the unpadded scope of a letter phase${label}`, () => {
// Each site feeds PHASE_N into `^[a-z]+\((0*${PHASE_N})-(0*${PLAN_N})\):`
// — the #4003 zero-pad-tolerant scope. Prove the value it now yields
// for `03A` matches the two subjects an executor could have written,
// and does NOT match the letter-less phase 3.
const script = [
'set -e',
splitLine,
nLine,
`SCOPE_RE="^[a-z]+\\((0*\${${site.output}})-(0*1)\\):"`,
'for s in "feat(3A-01): x" "feat(03A-1): x"; do printf \'%s\\n\' "$s" | grep -qE "$SCOPE_RE" || { echo "MISS $s"; exit 3; }; done',
'printf \'%s\\n\' "feat(3-01): x" | grep -qE "$SCOPE_RE" && { echo "FALSE-MATCH"; exit 4; }',
'echo OK',
].join('\n');
const r = runBash(script, { [site.input]: '03A' });
assert.equal(r.status, 0, `${r.stdout} ${r.stderr}`);
assert.equal(r.stdout, 'OK');
});
});
});
}
});
describe('#4748 — execute-phase.md resolves the REVIEW.md path from init\'s padded_phase, not a shell re-pad', () => {
const lines = splitLines(fs.readFileSync(EXECUTE_PHASE, 'utf8'));
const [i] = findAnchoredLineIndexes(lines, 'REVIEW_FILE="${PHASE_DIR}/${PADDED}-REVIEW.md"', 1);
const paddedLine = lines[i - 1].trim();
test('the PADDED binding directly above the lookup reads {padded_phase} (fails before the fix)', () => {
// `printf "%02d"` cannot pad `03A` (prints `03`, exits 1) — and cannot
// even re-pad an already-padded `08` (bash reads it as octal, prints
// `00`). `init execute-phase` now emits `padded_phase` through the
// canonical normalizer, so the workflow binds it instead of re-deriving.
assert.ok(paddedLine.startsWith('PADDED='), `line above the lookup must bind PADDED: ${paddedLine}`);
assert.equal(paddedLine, 'PADDED="{padded_phase}"');
});
test('regression control: the lookup line itself is unchanged', () => {
assert.equal(lines[i].trim(), 'REVIEW_FILE="${PHASE_DIR}/${PADDED}-REVIEW.md"');
});
test('composition: the value init emits, substituted into the live lookup lines, resolves the letter phase\'s own REVIEW.md', (t) => {
// The model substitutes `{padded_phase}` from the init JSON, which is
// `normalizePhaseName(phase_number)` (src/init.cts). Do that substitution
// here and run the three live lines against a fixture, so the emitted
// value, the binding, the path construction and the status extraction are
// exercised together — the executable half of a `{template}` site.
const { normalizePhaseName } = require('../gsd-core/bin/lib/phase-id.cjs');
const { createTempDir, cleanup } = require('./helpers.cjs');
const dir = createTempDir();
t.after(() => cleanup(dir));
for (const [id, status] of [['3A', 'clean'], ['8', 'issues'], ['9', 'skipped']]) {
const emitted = normalizePhaseName(id);
fs.writeFileSync(path.join(dir, `${emitted}-REVIEW.md`), `---\nstatus: ${status}\n---\n# review\n`);
const script = [
'set -e',
paddedLine.replace('{padded_phase}', emitted),
lines[i].trim(),
lines[i + 1].trim(),
'printf \'%s %s\' "$PADDED" "$REVIEW_STATUS"',
].join('\n');
assert.ok(lines[i + 1].includes('REVIEW_STATUS='), `line after the lookup must extract REVIEW_STATUS: ${lines[i + 1]}`);
const r = runBash(script, { PHASE_DIR: dir });
assert.equal(r.status, 0, `bash exited ${r.status}: ${r.stderr}`);
assert.equal(r.stdout, `${emitted} ${status}`);
}
});
test('the workflow\'s init parse list names padded_phase, so the binding is not a literal (fails before the fix)', () => {
// A `{field}` token is substituted from the init JSON only for fields the
// workflow tells the model to parse; `phase_number` is on that list and
// `padded_phase` was not (adversarial review, claim 2).
const [p] = findAnchoredLineIndexes(lines, 'Parse JSON for: `executor_model`', 1);
assert.match(lines[p], /`phase_number`, `padded_phase`,/);
});
});
describe('#4748 — autonomous.md --from/--to/--only and plan-review-convergence.md extract the full letter-suffixed phase', () => {
const autonomousText = fs.readFileSync(AUTONOMOUS, 'utf8');
const prcText = fs.readFileSync(PLAN_REVIEW_CONVERGENCE, 'utf8');
const sites = [
{ name: 'autonomous.md --from', pattern: extractGrepPattern(autonomousText, 'FROM_PHASE=$(echo "$ARGUMENTS" | grep -oE'), args: (v) => `--from ${v}`, tail: "| awk '{print $2}'" },
{ name: 'autonomous.md --to', pattern: extractGrepPattern(autonomousText, 'TO_PHASE=$(echo "$ARGUMENTS" | grep -oE'), args: (v) => `--from 1 --to ${v}`, tail: "| awk '{print $2}'" },
{ name: 'autonomous.md --only', pattern: extractGrepPattern(autonomousText, 'ONLY_PHASE=$(echo "$ARGUMENTS" | grep -oE'), args: (v) => `--only ${v} --interactive`, tail: "| awk '{print $2}'" },
{ name: 'plan-review-convergence.md', pattern: extractGrepPattern(prcText, 'PHASE=$(echo "$ARGUMENTS" | grep -oE'), args: (v) => `${v} --codex --max-cycles 3`, tail: '| head -1' },
];
function extract(site, v) {
const script = `echo "$ARGUMENTS" | grep -oE '${site.pattern}' ${site.tail}`;
return runBash(script, { ARGUMENTS: site.args(v) }).stdout;
}
for (const site of sites) {
describe(site.name, () => {
// Before the fix `[0-9]+\.?[0-9]*` stops at the letter: `12A` → `12`,
// silently targeting a different phase. `23.1.2` → `23.1` is the same
// truncation one axis over (#4568's class in a spelling neither lint saw).
for (const v of ['12A', '3A', '23A.1.2', '23.1.2']) {
test(`${v} extracts ${v}, not a truncated prefix (fails before the fix)`, () => {
const got = extract(site, v);
assert.equal(got, v);
assert.equal(CANONICAL_ANCHORED.test(got), true);
});
}
for (const v of ['6', '36.14']) {
test(`regression control: ${v} extracts ${v}`, () => {
assert.equal(extract(site, v), v);
});
}
});
}
test('autonomous.md: the three flags extract independently from one argument string', () => {
const script = [
`FROM_PHASE=$(echo "$ARGUMENTS" | grep -oE '${sites[0].pattern}' | awk '{print $2}')`,
`TO_PHASE=$(echo "$ARGUMENTS" | grep -oE '${sites[1].pattern}' | awk '{print $2}')`,
'printf \'%s %s\' "$FROM_PHASE" "$TO_PHASE"',
].join('\n');
assert.equal(runBash(script, { ARGUMENTS: '--from 3A --to 5B --max-cycles 2' }).stdout, '3A 5B');
});
});
describe('#4748 — phase-argument-parsing.md\'s legacy normalizer pads a letter-suffixed id instead of leaving it alone', () => {
const lines = splitLines(fs.readFileSync(PHASE_ARGUMENT_PARSING, 'utf8'));
const [start] = findAnchoredLineIndexes(lines, '# Normalize phase number', 1);
let end = start;
while (end < lines.length && lines[end].trim() !== 'fi') end++;
assert.ok(end < lines.length, 'normalizer block must close with `fi`');
const block = lines.slice(start, end + 1).join('\n');
function normalize(v) {
return runBash(`set -e\n${block}\nprintf '%s' "$PHASE"`, { PHASE: v });
}
// Before the fix neither branch matches a letter id, so `12A` passes through
// unpadded and `3A` is never zero-padded to the `03A` a directory carries.
for (const [input, expected] of [['3A', '03A'], ['12A', '12A'], ['3A.1', '03A.1'], ['23A.1.2', '23A.1.2']]) {
test(`${input} → ${expected} (fails before the fix)`, () => {
const r = normalize(input);
assert.equal(r.status, 0, `bash exited ${r.status}: ${r.stderr}`);
assert.equal(r.stdout, expected);
assert.equal(CANONICAL_ANCHORED.test(r.stdout), true);
});
}
// `08` is the octal trap: `printf "%02d" 08` is an invalid octal number in
// bash (exit 1, prints `00`), so the old integer branch mangled any
// already-padded id it was handed. `23.1.2` matched neither old branch and
// passed through unchanged — the N-segment axis was silently unpadded.
for (const [input, expected] of [['08', '08'], ['23.1.2', '23.1.2']]) {
test(`${input} → ${expected} without a shell error (fails before the fix)`, () => {
const r = normalize(input);
assert.equal(r.status, 0, `bash exited ${r.status}: ${r.stderr}`);
assert.equal(r.stdout, expected);
});
}
for (const [input, expected] of [['8', '08'], ['2.1', '02.1'], ['36.14', '36.14']]) {
test(`regression control: ${input} → ${expected}`, () => {
const r = normalize(input);
assert.equal(r.status, 0, `bash exited ${r.status}: ${r.stderr}`);
assert.equal(r.stdout, expected);
});
}
test('a non-canonical value passes through untouched (the normalizer is not a validator)', () => {
const r = normalize('AUTH-101');
assert.equal(r.status, 0);
assert.equal(r.stdout, 'AUTH-101');
});
});

View File

@@ -1823,3 +1823,245 @@ describe('lint-phase-enumeration-drift.cjs guard (#3882 rows F1-F3)', () => {
assert.ok(driftGuard.OWNER_FILES.has(path.join('src', 'phase-id.cts')));
});
});
describe('phase-plan-index: DAG-ready view (#4628)', () => {
let tmpDir;
afterEach(() => { if (tmpDir) { cleanup(tmpDir); tmpDir = null; } });
// Local copies: the #2830 fixtures live inside the folded block above and
// are not in scope here (same idiom, same file — not a third definition of
// a shared helper: these are this describe's own fixtures).
function writePlan(phaseDir, filename, frontmatterLines, taskLine = '<task>Work</task>') {
fs.writeFileSync(
path.join(phaseDir, filename),
[
'---',
...frontmatterLines,
'---',
'',
`# ${filename}`,
'',
`<objective>${filename}</objective>`,
'',
taskLine,
].join('\n'),
);
}
function writeSummary(phaseDir, filename, status = 'complete') {
fs.writeFileSync(
path.join(phaseDir, filename),
['---', 'status: ' + status, '---', '', '# Summary', ''].join('\n'),
);
}
/**
* The issue's exact chain: completed deps feed a wave-7 pair (41/50), whose
* incomplete state must hold wave-9 (42) and wave-10 (06) dependents out of
* the ready view. Waves are the reporter's declared frontmatter values.
*/
function build4628Fixture(tmpDir) {
const phaseDir = path.join(tmpDir, '.planning', 'phases', '07-chain');
fs.mkdirSync(phaseDir, { recursive: true });
// completed predecessors of the wave-7 pair
writePlan(phaseDir, '07-04-PLAN.md', ['wave: 6', 'objective: Done 04', 'autonomous: true']);
writeSummary(phaseDir, '07-04-SUMMARY.md', 'complete');
writePlan(phaseDir, '07-05-PLAN.md', ['wave: 6', 'objective: Done 05', 'autonomous: true']);
writeSummary(phaseDir, '07-05-SUMMARY.md', 'complete');
writePlan(phaseDir, '07-18-PLAN.md', ['wave: 5', 'objective: Done 18', 'autonomous: true']);
writeSummary(phaseDir, '07-18-SUMMARY.md', 'complete');
writePlan(phaseDir, '07-39-PLAN.md', ['wave: 6', 'objective: Done 39', 'autonomous: true']);
writeSummary(phaseDir, '07-39-SUMMARY.md', 'complete');
writePlan(phaseDir, '07-40-PLAN.md', ['wave: 6', 'objective: Done 40', 'autonomous: true']);
writeSummary(phaseDir, '07-40-SUMMARY.md', 'complete');
// the wave-7 pair: incomplete but ready (all deps completed)
writePlan(phaseDir, '07-41-PLAN.md', [
'wave: 7', 'objective: Ready A', 'autonomous: true',
'depends_on:', ' - 07-04', ' - 07-40', ' - 07-39',
]);
writePlan(phaseDir, '07-50-PLAN.md', [
'wave: 7', 'objective: Ready B', 'autonomous: true', 'depends_on:', ' - 07-18',
]);
// wave-9: depends on incomplete (not halted) 07-41
writePlan(phaseDir, '07-42-PLAN.md', [
'wave: 9', 'objective: Waiting C', 'autonomous: true',
'depends_on:', ' - 07-05', ' - 07-41', ' - 07-39', ' - 07-40',
]);
// wave-10: depends on incomplete 07-42
writePlan(phaseDir, '07-06-PLAN.md', [
'wave: 10', 'objective: Waiting D', 'autonomous: true',
'depends_on:', ' - 07-40', ' - 07-42', ' - 07-05',
]);
return phaseDir;
}
test('locator: the wave-7 pair is ready; the wave-9/10 dependents are runnable but NOT ready', () => {
tmpDir = createTempProject('gsd-4628-');
build4628Fixture(tmpDir);
const result = phaseLocator.findPhaseInternal(tmpDir, '7');
assert.ok(result, 'expected a result');
assert.deepEqual(
[...result.ready_plans].sort(),
['07-41-PLAN.md', '07-50-PLAN.md'],
'exactly the wave-7 pair is ready — every dependency has completion evidence',
);
assert.ok(result.runnable_plans.includes('07-42-PLAN.md'),
'42 stays runnable (not halted-blocked) — runnable must not be read as DAG-ready');
assert.ok(!result.ready_plans.includes('07-42-PLAN.md'),
'42 depends on incomplete 07-41 — not ready');
assert.ok(!result.ready_plans.includes('07-06-PLAN.md'),
'06 depends on incomplete 07-42 — not ready');
});
test('completed plans never appear in ready_plans (ready is a property of incomplete plans)', () => {
tmpDir = createTempProject('gsd-4628-');
build4628Fixture(tmpDir);
const result = phaseLocator.findPhaseInternal(tmpDir, '7');
assert.ok(!result.ready_plans.includes('07-04-PLAN.md'));
assert.ok(!result.ready_plans.includes('07-18-PLAN.md'));
});
test('CLI: per-plan ready/unresolved_dependencies name the missing predecessors', () => {
tmpDir = createTempProject('gsd-4628-');
build4628Fixture(tmpDir);
const result = runGsdTools(['phase-plan-index', '7', '--json'], tmpDir);
assert.ok(result.success, `phase-plan-index should succeed: ${result.error}`);
const data = JSON.parse(result.output);
assert.deepEqual(
[...data.ready_plans].sort(),
['07-41', '07-50'],
'ready_plans is the DAG-ready dispatch view',
);
const p42 = data.plans.find((p) => p.id === '07-42');
assert.strictEqual(p42.ready, false);
assert.deepEqual(p42.unresolved_dependencies, ['07-41'],
'only the actually-incomplete dependency is named');
const p06 = data.plans.find((p) => p.id === '07-06');
assert.strictEqual(p06.ready, false);
assert.deepEqual(p06.unresolved_dependencies, ['07-42']);
const p41 = data.plans.find((p) => p.id === '07-41');
assert.strictEqual(p41.ready, true);
assert.strictEqual(p41.unresolved_dependencies, undefined);
// a halted predecessor still routes through blocked_by (#2830) AND reads not-ready
});
test('a halted dependency keeps blocked_by semantics AND reads not-ready', () => {
tmpDir = createTempProject('gsd-4628-');
const phaseDir = path.join(tmpDir, '.planning', 'phases', '08-halt');
fs.mkdirSync(phaseDir, { recursive: true });
writePlan(phaseDir, '08-01-PLAN.md', ['wave: 1', 'objective: Halted', 'autonomous: true']);
writeSummary(phaseDir, '08-01-SUMMARY.md', 'halted');
writePlan(phaseDir, '08-02-PLAN.md', [
'wave: 2', 'objective: Dependent of halt', 'autonomous: true', 'depends_on:', ' - 08-01',
]);
const result = phaseLocator.findPhaseInternal(tmpDir, '8');
assert.deepEqual(result.blocked_by['08-02-PLAN.md'], ['08-01'], '#2830 semantics unchanged');
assert.ok(!result.ready_plans.includes('08-02-PLAN.md'), 'halt-blocked is not ready');
});
});
describe('phase-plan-index: readiness fail-closed edges (#4628)', () => {
let tmpDir;
afterEach(() => { if (tmpDir) { cleanup(tmpDir); tmpDir = null; } });
function writePlan(phaseDir, filename, frontmatterLines, taskLine = '<task>Work</task>') {
fs.writeFileSync(
path.join(phaseDir, filename),
[
'---',
...frontmatterLines,
'---',
'',
'# ' + filename,
'',
'<objective>' + filename + '</objective>',
'',
taskLine,
].join('\n'),
);
}
function writeSummary(phaseDir, filename, status = 'complete') {
fs.writeFileSync(
path.join(phaseDir, filename),
['---', 'status: ' + status, '---', '', '# Summary', ''].join('\n'),
);
}
test('an unresolved depends_on token carries no evidence — the plan is not ready', () => {
tmpDir = createTempProject('gsd-4628-tok-');
const phaseDir = path.join(tmpDir, '.planning', 'phases', '09-tok');
fs.mkdirSync(phaseDir, { recursive: true });
writePlan(phaseDir, '09-01-PLAN.md', ['wave: 1', 'objective: Ready by itself', 'autonomous: true']);
writePlan(phaseDir, '09-02-PLAN.md', [
'wave: 2', 'objective: Typo dependency', 'autonomous: true', 'depends_on:', ' - 99-99',
]);
const locator = phaseLocator.findPhaseInternal(tmpDir, '9');
assert.ok(locator, 'expected a result');
assert.ok(locator.ready_plans.includes('09-01-PLAN.md'), '09-01 has no dependencies — ready');
assert.ok(!locator.ready_plans.includes('09-02-PLAN.md'),
'a dropped edge carries no completion evidence — fail closed');
const cli = runGsdTools(['phase-plan-index', '9', '--json'], tmpDir);
const data = JSON.parse(cli.output);
const p02 = data.plans.find((p) => p.id === '09-02');
assert.strictEqual(p02.ready, false, 'CLI must fail closed identically to the locator');
});
test('a dependency whose SUMMARY declares status: blocked is NOT completion evidence', () => {
tmpDir = createTempProject('gsd-4628-blk-');
const phaseDir = path.join(tmpDir, '.planning', 'phases', '10-blk');
fs.mkdirSync(phaseDir, { recursive: true });
writePlan(phaseDir, '10-01-PLAN.md', ['wave: 1', 'objective: Blocked dependency', 'autonomous: true']);
writeSummary(phaseDir, '10-01-SUMMARY.md', 'blocked');
writePlan(phaseDir, '10-02-PLAN.md', [
'wave: 2', 'objective: Dependent of blocked', 'autonomous: true', 'depends_on:', ' - 10-01',
]);
const locator = phaseLocator.findPhaseInternal(tmpDir, '10');
assert.ok(locator, 'expected a result');
assert.ok(!locator.ready_plans.includes('10-02-PLAN.md'),
'a status:blocked SUMMARY is a failure record, not completion evidence');
const cli = runGsdTools(['phase-plan-index', '10', '--json'], tmpDir);
const data = JSON.parse(cli.output);
const p02 = data.plans.find((p) => p.id === '10-02');
assert.strictEqual(p02.ready, false, 'CLI and locator must agree: blocked dep = not ready');
});
test('locator and CLI agree on the issue chain (lockstep pin)', () => {
tmpDir = createTempProject('gsd-4628-lock-');
const phaseDir = path.join(tmpDir, '.planning', 'phases', '11-lock');
fs.mkdirSync(phaseDir, { recursive: true });
// completed
writePlan(phaseDir, '11-01-PLAN.md', ['wave: 1', 'objective: Done', 'autonomous: true']);
writeSummary(phaseDir, '11-01-SUMMARY.md', 'complete');
// incomplete + ready
writePlan(phaseDir, '11-02-PLAN.md', ['wave: 2', 'objective: Ready', 'autonomous: true', 'depends_on:', ' - 11-01']);
// incomplete + not ready
writePlan(phaseDir, '11-03-PLAN.md', ['wave: 3', 'objective: Waiting', 'autonomous: true', 'depends_on:', ' - 11-02']);
const locator = phaseLocator.findPhaseInternal(tmpDir, '11');
const cli = JSON.parse(runGsdTools(['phase-plan-index', '11', '--json'], tmpDir).output);
// the locator reports FILENAMES in ready_plans; the CLI reports plan ids —
// normalize the filename form before comparing the two views.
const locatorIds = locator.ready_plans.map((f) => f.replace(/-PLAN\.md$/, '')).sort();
assert.deepEqual(
locatorIds,
[...cli.ready_plans].sort(),
'locator and CLI must never disagree on which plans are ready',
);
assert.deepEqual([...cli.ready_plans].sort(), ['11-02']);
});
});

View File

@@ -31,9 +31,9 @@ describe('#4003 — safe_resume_gate commit-scope greps', () => {
const w = fs.readFileSync(WORKFLOW, 'utf8');
// Anchored, ERE, zero-pad-tolerant on BOTH components — matches feat(2-02): and
// feat(02-02): alike, never a substring elsewhere in the message.
assert.ok(w.includes('PHASE_INT=${PHASE_NUMBER%%[!0-9]*}; PHASE_REST=${PHASE_NUMBER#"$PHASE_INT"}') &&
w.includes('PHASE_N="$((10#$PHASE_INT))${PHASE_REST//./\\\\.}"'),
'phase component must be zero-stripped via arithmetic base-10 (#4619: leading integer segment only, decimal/N-segment tolerant; #4748: split at the first non-digit so a letter suffix rides through)');
assert.ok(w.includes('PHASE_INT=${PHASE_NUMBER%%.*}; PHASE_FRAC=${PHASE_NUMBER#"$PHASE_INT"}') &&
w.includes('PHASE_N="$((10#$PHASE_INT))${PHASE_FRAC//./\\\\.}"'),
'phase component must be zero-stripped via arithmetic base-10 (#4619: leading integer segment only, decimal/N-segment tolerant)');
assert.ok(w.includes('PLAN_N=$((10#{plan_padded}))'),
'plan component must be zero-stripped via arithmetic base-10');
assert.ok(w.includes('PLAN_SCOPE_RE="^[a-z]+\\((0*${PHASE_N})-(0*${PLAN_N})\\):"'),
@@ -60,9 +60,9 @@ describe('#4003 — safe_resume_gate commit-scope greps', () => {
test('tdd red gate tolerates both commit-scope spellings (#4011 keying untouched)', () => {
const w = fs.readFileSync(WORKFLOW, 'utf8');
assert.ok(w.includes('PHASE_INT=${PHASE_NUMBER%%[!0-9]*}; PHASE_REST=${PHASE_NUMBER#"$PHASE_INT"}') &&
w.includes('PHASE_N="$((10#$PHASE_INT))${PHASE_REST//./\\\\.}"') && w.includes('PLAN_N=$((10#${PLAN_ID}))'),
'the TDD block derives zero-stripped components (#4619: leading integer segment only, decimal/N-segment tolerant; #4748: letter-suffix tolerant)');
assert.ok(w.includes('PHASE_INT=${PHASE_NUMBER%%.*}; PHASE_FRAC=${PHASE_NUMBER#"$PHASE_INT"}') &&
w.includes('PHASE_N="$((10#$PHASE_INT))${PHASE_FRAC//./\\\\.}"') && w.includes('PLAN_N=$((10#${PLAN_ID}))'),
'the TDD block derives zero-stripped components (#4619: leading integer segment only, decimal/N-segment tolerant)');
assert.ok(w.includes('RED_COMMIT=$(git log --oneline -E ${TDD_MILESTONE_BASE:+"$TDD_MILESTONE_BASE..HEAD"} --grep="${PLAN_SCOPE_RE}" -- "*.test.*"'),
'the RED grep must use the same anchored padding-tolerant scope, milestone-bounded');
assert.ok(!w.includes('--grep="^test(${PHASE_NUMBER}-${PLAN_ID})"'),
@@ -80,9 +80,9 @@ describe('#4003 — safe_resume_gate commit-scope greps', () => {
'the padded-literal example grep must not remain');
assert.ok(ref.includes('--grep="^test\\((0*${PHASE_N})-(0*${PLAN_N})\\):"'),
'the RED example is anchored and zero-pad-tolerant');
assert.ok(ref.includes('PHASE_INT=${PHASE%%[!0-9]*}; PHASE_REST=${PHASE#"$PHASE_INT"}') &&
ref.includes('PHASE_N="$((10#$PHASE_INT))${PHASE_REST//./\\\\.}"') && ref.includes('PLAN_N=$((10#${PLAN}))'),
'the examples derive zero-stripped components (#4619: leading integer segment only, decimal/N-segment tolerant; #4748: letter-suffix tolerant)');
assert.ok(ref.includes('PHASE_INT=${PHASE%%.*}; PHASE_FRAC=${PHASE#"$PHASE_INT"}') &&
ref.includes('PHASE_N="$((10#$PHASE_INT))${PHASE_FRAC//./\\\\.}"') && ref.includes('PLAN_N=$((10#${PLAN}))'),
'the examples derive zero-stripped components (#4619: leading integer segment only, decimal/N-segment tolerant)');
});
test('completion spot-check uses the anchored scope and keeps its time bound', () => {
@@ -96,10 +96,10 @@ describe('#4003 — safe_resume_gate commit-scope greps', () => {
'execute-phase', 'steps', 'completion-reconciliation.md'), 'utf8');
assert.ok(!w.includes('--grep="{phase_number}-{plan_padded}"') && !frag.includes('--grep="{phase_number}-{plan_padded}"'),
'the raw padded placeholder substring grep must not remain');
assert.ok(frag.includes('SPOT_PHASE_INT=${SPOT_PHASE_NUMBER%%[!0-9]*}; SPOT_PHASE_REST=${SPOT_PHASE_NUMBER#"$SPOT_PHASE_INT"}') &&
frag.includes('SPOT_PHASE_N="$((10#$SPOT_PHASE_INT))${SPOT_PHASE_REST//./\\\\.}"') &&
assert.ok(frag.includes('SPOT_PHASE_INT=${SPOT_PHASE_NUMBER%%.*}; SPOT_PHASE_FRAC=${SPOT_PHASE_NUMBER#"$SPOT_PHASE_INT"}') &&
frag.includes('SPOT_PHASE_N="$((10#$SPOT_PHASE_INT))${SPOT_PHASE_FRAC//./\\\\.}"') &&
frag.includes('SPOT_PLAN_N=$((10#{plan_padded}))'),
'the spot-check derives zero-stripped components (#4619: leading integer segment only, decimal/N-segment tolerant; #4748: letter-suffix tolerant)');
'the spot-check derives zero-stripped components (#4619: leading integer segment only, decimal/N-segment tolerant)');
assert.ok(frag.includes('--since="1 hour ago"'), 'the spot-check keeps its temporal bound');
});