/** * GSD Tools Tests - Milestone */ const { test, describe, beforeEach, afterEach } = require('node:test'); const assert = require('node:assert'); const fs = require('fs'); const path = require('path'); const { runGsdTools, createTempProject, cleanup } = require('./helpers.cjs'); describe('milestone complete command', () => { let tmpDir; beforeEach(() => { tmpDir = createTempProject(); }); afterEach(() => { cleanup(tmpDir); }); test('archives roadmap, requirements, creates MILESTONES.md', () => { fs.writeFileSync( path.join(tmpDir, '.planning', 'ROADMAP.md'), `# Roadmap v1.0 MVP\n\n### Phase 1: Foundation\n**Goal:** Setup\n` ); fs.writeFileSync( path.join(tmpDir, '.planning', 'REQUIREMENTS.md'), `# Requirements\n\n- [ ] User auth\n- [ ] Dashboard\n` ); fs.writeFileSync( path.join(tmpDir, '.planning', 'STATE.md'), `# State\n\n**Status:** In progress\n**Last Activity:** 2025-01-01\n**Last Activity Description:** Working\n` ); const p1 = path.join(tmpDir, '.planning', 'phases', '01-foundation'); fs.mkdirSync(p1, { recursive: true }); fs.writeFileSync( path.join(p1, '01-01-SUMMARY.md'), `---\none-liner: Set up project infrastructure\n---\n# Summary\n` ); const result = runGsdTools('milestone complete v1.0 --name MVP Foundation', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.version, 'v1.0'); assert.strictEqual(output.phases, 1); assert.ok(output.archived.roadmap, 'roadmap should be archived'); assert.ok(output.archived.requirements, 'requirements should be archived'); // Verify archive files exist assert.ok( fs.existsSync(path.join(tmpDir, '.planning', 'milestones', 'v1.0-ROADMAP.md')), 'archived roadmap should exist' ); assert.ok( fs.existsSync(path.join(tmpDir, '.planning', 'milestones', 'v1.0-REQUIREMENTS.md')), 'archived requirements should exist' ); // Verify MILESTONES.md created assert.ok( fs.existsSync(path.join(tmpDir, '.planning', 'MILESTONES.md')), 'MILESTONES.md should be created' ); const milestones = fs.readFileSync(path.join(tmpDir, '.planning', 'MILESTONES.md'), 'utf-8'); assert.ok(milestones.includes('v1.0 MVP Foundation'), 'milestone entry should contain name'); assert.ok(milestones.includes('Set up project infrastructure'), 'accomplishments should be listed'); }); test('appends to existing MILESTONES.md', () => { fs.writeFileSync( path.join(tmpDir, '.planning', 'MILESTONES.md'), `# Milestones\n\n## v0.9 Alpha (Shipped: 2025-01-01)\n\n---\n\n` ); fs.writeFileSync( path.join(tmpDir, '.planning', 'ROADMAP.md'), `# Roadmap v1.0\n` ); fs.writeFileSync( path.join(tmpDir, '.planning', 'STATE.md'), `# State\n\n**Status:** In progress\n**Last Activity:** 2025-01-01\n**Last Activity Description:** Working\n` ); const result = runGsdTools('milestone complete v1.0 --name Beta', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const milestones = fs.readFileSync(path.join(tmpDir, '.planning', 'MILESTONES.md'), 'utf-8'); assert.ok(milestones.includes('v0.9 Alpha'), 'existing entry should be preserved'); assert.ok(milestones.includes('v1.0 Beta'), 'new entry should be appended'); }); test('archives phase directories with --archive-phases flag', () => { fs.writeFileSync( path.join(tmpDir, '.planning', 'ROADMAP.md'), `# Roadmap v1.0\n` ); fs.writeFileSync( path.join(tmpDir, '.planning', 'STATE.md'), `# State\n\n**Status:** In progress\n**Last Activity:** 2025-01-01\n**Last Activity Description:** Working\n` ); const p1 = path.join(tmpDir, '.planning', 'phases', '01-foundation'); fs.mkdirSync(p1, { recursive: true }); fs.writeFileSync( path.join(p1, '01-01-SUMMARY.md'), `---\none-liner: Set up project infrastructure\n---\n# Summary\n` ); const result = runGsdTools('milestone complete v1.0 --name MVP --archive-phases', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.archived.phases, true, 'phases should be archived'); // Phase directory moved to milestones/v1.0-phases/ assert.ok( fs.existsSync(path.join(tmpDir, '.planning', 'milestones', 'v1.0-phases', '01-foundation')), 'archived phase directory should exist in milestones/v1.0-phases/' ); // Original phase directory no longer exists assert.ok( !fs.existsSync(p1), 'original phase directory should no longer exist' ); }); test('archived REQUIREMENTS.md contains archive header', () => { fs.writeFileSync( path.join(tmpDir, '.planning', 'REQUIREMENTS.md'), `# Requirements\n\n- [ ] **TEST-01**: core.cjs has tests\n- [ ] **TEST-02**: more tests\n` ); fs.writeFileSync( path.join(tmpDir, '.planning', 'ROADMAP.md'), `# Roadmap v1.0\n` ); fs.writeFileSync( path.join(tmpDir, '.planning', 'STATE.md'), `# State\n\n**Status:** In progress\n**Last Activity:** 2025-01-01\n**Last Activity Description:** Working\n` ); const result = runGsdTools('milestone complete v1.0 --name MVP', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const archivedReq = fs.readFileSync( path.join(tmpDir, '.planning', 'milestones', 'v1.0-REQUIREMENTS.md'), 'utf-8' ); assert.ok(archivedReq.includes('Requirements Archive: v1.0'), 'should contain archive version'); assert.ok(archivedReq.includes('SHIPPED'), 'should contain SHIPPED status'); assert.ok(archivedReq.includes('Archived:'), 'should contain Archived: date line'); // Original content preserved after header assert.ok(archivedReq.includes('# Requirements'), 'original content should be preserved'); assert.ok(archivedReq.includes('**TEST-01**'), 'original requirement items should be preserved'); }); test('STATE.md gets updated during milestone complete', () => { fs.writeFileSync( path.join(tmpDir, '.planning', 'ROADMAP.md'), `# Roadmap v1.0\n` ); fs.writeFileSync( path.join(tmpDir, '.planning', 'STATE.md'), `# State\n\n**Status:** In progress\n**Last Activity:** 2025-01-01\n**Last Activity Description:** Working\n` ); const result = runGsdTools('milestone complete v1.0 --name Test', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.state_updated, true, 'state_updated should be true'); const state = fs.readFileSync(path.join(tmpDir, '.planning', 'STATE.md'), 'utf-8'); assert.ok(state.includes('v1.0 milestone complete'), 'status should be updated to milestone complete'); assert.ok( state.includes('v1.0 milestone completed and archived'), 'last activity description should reference milestone completion' ); }); test('handles missing ROADMAP.md gracefully', () => { // Only STATE.md — no ROADMAP.md, no REQUIREMENTS.md fs.writeFileSync( path.join(tmpDir, '.planning', 'STATE.md'), `# State\n\n**Status:** In progress\n**Last Activity:** 2025-01-01\n**Last Activity Description:** Working\n` ); const result = runGsdTools('milestone complete v1.0 --name NoRoadmap', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.archived.roadmap, false, 'roadmap should not be archived'); assert.strictEqual(output.archived.requirements, false, 'requirements should not be archived'); assert.strictEqual(output.milestones_updated, true, 'MILESTONES.md should still be created'); assert.ok( fs.existsSync(path.join(tmpDir, '.planning', 'MILESTONES.md')), 'MILESTONES.md should be created even without ROADMAP.md' ); }); test('handles empty phases directory', () => { fs.writeFileSync( path.join(tmpDir, '.planning', 'ROADMAP.md'), `# Roadmap v1.0\n` ); fs.writeFileSync( path.join(tmpDir, '.planning', 'STATE.md'), `# State\n\n**Status:** In progress\n**Last Activity:** 2025-01-01\n**Last Activity Description:** Working\n` ); // phases directory exists but is empty (from createTempProject) const result = runGsdTools('milestone complete v1.0 --name EmptyPhases', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.phases, 0, 'phase count should be 0'); assert.strictEqual(output.plans, 0, 'plan count should be 0'); assert.strictEqual(output.tasks, 0, 'task count should be 0'); }); }); // ───────────────────────────────────────────────────────────────────────────── // requirements mark-complete command // ───────────────────────────────────────────────────────────────────────────── describe('requirements mark-complete command', () => { let tmpDir; beforeEach(() => { tmpDir = createTempProject(); }); afterEach(() => { cleanup(tmpDir); }); // ─── helpers ────────────────────────────────────────────────────────────── function writeRequirements(tmpDir, content) { fs.writeFileSync(path.join(tmpDir, '.planning', 'REQUIREMENTS.md'), content, 'utf-8'); } function readRequirements(tmpDir) { return fs.readFileSync(path.join(tmpDir, '.planning', 'REQUIREMENTS.md'), 'utf-8'); } const STANDARD_REQUIREMENTS = `# Requirements ## Test Coverage - [ ] **TEST-01**: core.cjs has tests for loadConfig - [ ] **TEST-02**: core.cjs has tests for resolveModelInternal - [x] **TEST-03**: core.cjs has tests for escapeRegex (already complete) ## Bug Regressions - [ ] **REG-01**: Test confirms loadConfig returns model_overrides ## Infrastructure - [ ] **INFRA-01**: GitHub Actions workflow runs tests ## Traceability | Requirement | Phase | Status | |-------------|-------|--------| | TEST-01 | Phase 1 | Pending | | TEST-02 | Phase 1 | Pending | | TEST-03 | Phase 1 | Complete | | REG-01 | Phase 1 | Pending | | INFRA-01 | Phase 6 | Pending | `; // ─── tests ──────────────────────────────────────────────────────────────── test('marks single requirement complete (checkbox + table)', () => { writeRequirements(tmpDir, STANDARD_REQUIREMENTS); const result = runGsdTools('requirements mark-complete TEST-01', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.updated, true); assert.ok(output.marked_complete.includes('TEST-01'), 'TEST-01 should be marked complete'); const content = readRequirements(tmpDir); assert.ok(content.includes('- [x] **TEST-01**'), 'checkbox should be checked'); assert.ok(content.includes('| TEST-01 | Phase 1 | Complete |'), 'table row should be Complete'); // Other checkboxes unchanged assert.ok(content.includes('- [ ] **TEST-02**'), 'TEST-02 should remain unchecked'); }); test('handles mixed prefixes in single call (TEST-XX, REG-XX, INFRA-XX)', () => { writeRequirements(tmpDir, STANDARD_REQUIREMENTS); const result = runGsdTools('requirements mark-complete TEST-01,REG-01,INFRA-01', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.marked_complete.length, 3, 'should mark 3 requirements complete'); assert.ok(output.marked_complete.includes('TEST-01')); assert.ok(output.marked_complete.includes('REG-01')); assert.ok(output.marked_complete.includes('INFRA-01')); const content = readRequirements(tmpDir); assert.ok(content.includes('- [x] **TEST-01**'), 'TEST-01 checkbox should be checked'); assert.ok(content.includes('- [x] **REG-01**'), 'REG-01 checkbox should be checked'); assert.ok(content.includes('- [x] **INFRA-01**'), 'INFRA-01 checkbox should be checked'); assert.ok(content.includes('| TEST-01 | Phase 1 | Complete |'), 'TEST-01 table should be Complete'); assert.ok(content.includes('| REG-01 | Phase 1 | Complete |'), 'REG-01 table should be Complete'); assert.ok(content.includes('| INFRA-01 | Phase 6 | Complete |'), 'INFRA-01 table should be Complete'); }); test('accepts space-separated IDs', () => { writeRequirements(tmpDir, STANDARD_REQUIREMENTS); const result = runGsdTools('requirements mark-complete TEST-01 TEST-02', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.marked_complete.length, 2, 'should mark 2 requirements complete'); const content = readRequirements(tmpDir); assert.ok(content.includes('- [x] **TEST-01**'), 'TEST-01 should be checked'); assert.ok(content.includes('- [x] **TEST-02**'), 'TEST-02 should be checked'); }); test('accepts bracket-wrapped IDs [REQ-01, REQ-02]', () => { writeRequirements(tmpDir, STANDARD_REQUIREMENTS); const result = runGsdTools('requirements mark-complete [TEST-01,TEST-02]', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.marked_complete.length, 2, 'should mark 2 requirements complete'); const content = readRequirements(tmpDir); assert.ok(content.includes('- [x] **TEST-01**'), 'TEST-01 should be checked'); assert.ok(content.includes('- [x] **TEST-02**'), 'TEST-02 should be checked'); }); test('returns not_found for invalid IDs while updating valid ones', () => { writeRequirements(tmpDir, STANDARD_REQUIREMENTS); const result = runGsdTools('requirements mark-complete TEST-01,FAKE-99', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.updated, true, 'should still update valid IDs'); assert.ok(output.marked_complete.includes('TEST-01'), 'TEST-01 should be marked complete'); assert.ok(output.not_found.includes('FAKE-99'), 'FAKE-99 should be in not_found'); assert.strictEqual(output.total, 2, 'total should reflect all IDs attempted'); }); test('idempotent — re-marking already-complete requirement does not corrupt', () => { writeRequirements(tmpDir, STANDARD_REQUIREMENTS); // TEST-03 already has [x] and Complete in the fixture const result = runGsdTools('requirements mark-complete TEST-03', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); // Regex only matches [ ] (space), not [x], so TEST-03 goes to not_found assert.ok(output.not_found.includes('TEST-03'), 'already-complete ID should be in not_found'); const content = readRequirements(tmpDir); // File should not be corrupted — no [xx] or doubled markers assert.ok(content.includes('- [x] **TEST-03**'), 'existing [x] should remain intact'); assert.ok(!content.includes('[xx]'), 'should not have doubled x markers'); assert.ok(!content.includes('- [x] [x]'), 'should not have duplicate checkbox'); }); test('missing REQUIREMENTS.md returns expected error structure', () => { // createTempProject does not create REQUIREMENTS.md — so it's already missing const result = runGsdTools('requirements mark-complete TEST-01', tmpDir); assert.ok(result.success, `Command failed: ${result.error}`); const output = JSON.parse(result.output); assert.strictEqual(output.updated, false, 'updated should be false'); assert.strictEqual(output.reason, 'REQUIREMENTS.md not found', 'should report file not found'); }); }); // ───────────────────────────────────────────────────────────────────────────── // validate consistency command // ─────────────────────────────────────────────────────────────────────────────