8cd874969c
* feat(plan-phase): add ADR ingest express path for approved enhancement #3209 * fix(review): address coderabbit doc note and brittle section-number assertion
81 lines
3.5 KiB
JavaScript
81 lines
3.5 KiB
JavaScript
// allow-test-rule: source-text-is-the-product
|
|
// These assertions validate shipped workflow/command markdown contracts.
|
|
|
|
const { test, describe } = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
const fs = require('fs');
|
|
const path = require('path');
|
|
|
|
const ROOT = path.join(__dirname, '..');
|
|
const COMMAND_PATH = path.join(ROOT, 'commands', 'gsd', 'plan-phase.md');
|
|
const WORKFLOW_PATH = path.join(ROOT, 'get-shit-done', 'workflows', 'plan-phase.md');
|
|
const DOCS_COMMANDS_PATH = path.join(ROOT, 'docs', 'COMMANDS.md');
|
|
|
|
function read(filePath) {
|
|
return fs.readFileSync(filePath, 'utf8');
|
|
}
|
|
|
|
describe('enh #3209: plan-phase ADR ingest express path', () => {
|
|
test('command argument-hint advertises --ingest and --ingest-format', () => {
|
|
const command = read(COMMAND_PATH);
|
|
assert.ok(command.includes('--ingest <path-or-glob>'),
|
|
'plan-phase command argument-hint must include --ingest <path-or-glob>');
|
|
assert.ok(command.includes('--ingest-format <auto|nygard|madr|narrative>'),
|
|
'plan-phase command argument-hint must include --ingest-format selector');
|
|
});
|
|
|
|
test('workflow parses --ingest and --ingest-format flags', () => {
|
|
const workflow = read(WORKFLOW_PATH);
|
|
assert.ok(workflow.includes('--ingest <path-or-glob>'),
|
|
'plan-phase workflow argument parsing must mention --ingest');
|
|
assert.ok(workflow.includes('--ingest-format'),
|
|
'plan-phase workflow argument parsing must mention --ingest-format');
|
|
});
|
|
|
|
test('workflow has explicit mutual exclusion guard for --prd and --ingest', () => {
|
|
const workflow = read(WORKFLOW_PATH);
|
|
assert.ok(
|
|
workflow.includes('cannot combine `--prd` with `--ingest`') ||
|
|
workflow.includes('mutually exclusive'),
|
|
'plan-phase workflow must fail fast when --prd and --ingest are both provided'
|
|
);
|
|
});
|
|
|
|
test('workflow defines an ADR ingest express-path step', () => {
|
|
const workflow = read(WORKFLOW_PATH);
|
|
assert.ok(/##\s*(?:\d+(?:\.\d+)*)?\.?\s*Handle ADR Ingest Express Path/i.test(workflow),
|
|
'plan-phase workflow must include a dedicated ADR ingest express-path step');
|
|
assert.ok(workflow.includes('ADR Ingest Express Path'),
|
|
'workflow must display ADR ingest express-path banner text');
|
|
});
|
|
|
|
test('ADR ingest context template includes scope fence and ADR source attribution', () => {
|
|
const workflow = read(WORKFLOW_PATH);
|
|
assert.ok(workflow.includes('<scope_fence>'),
|
|
'ADR ingest context template must include <scope_fence> for hard out-of-scope exclusions');
|
|
assert.ok(workflow.includes('Source:** ADR Ingest Express Path'),
|
|
'ADR ingest context template must tag source as ADR Ingest Express Path');
|
|
});
|
|
|
|
test('workflow documents status gate and no-decisions fallback', () => {
|
|
const workflow = read(WORKFLOW_PATH);
|
|
assert.ok(
|
|
workflow.includes('Reject `superseded`/`rejected`/`deprecated`') ||
|
|
workflow.includes('reject `superseded`/`rejected`/`deprecated`') ||
|
|
/superseded.*rejected.*deprecated/i.test(workflow),
|
|
'ADR ingest workflow must include status gate for non-active ADRs'
|
|
);
|
|
assert.ok(
|
|
workflow.includes('empty-decisions fallback') ||
|
|
workflow.includes('fall back to discuss-phase'),
|
|
'ADR ingest workflow must document fallback when no locked decisions are present'
|
|
);
|
|
});
|
|
|
|
test('docs COMMANDS advertises --ingest flag for /gsd-plan-phase', () => {
|
|
const commands = read(DOCS_COMMANDS_PATH);
|
|
assert.ok(commands.includes('--ingest <path-or-glob>'),
|
|
'docs/COMMANDS.md must document --ingest for /gsd-plan-phase');
|
|
});
|
|
});
|