gsd-trae 1.0.0 → 1.0.2

package/refs/gsd/tests/roadmap.test.cjs

@@ -1,265 +0,0 @@
-/**
- * GSD Tools Tests - Roadmap
- */
-
-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('roadmap get-phase command', () => {
-  let tmpDir;
-
-  beforeEach(() => {
-    tmpDir = createTempProject();
-  });
-
-  afterEach(() => {
-    cleanup(tmpDir);
-  });
-
-  test('extracts phase section from ROADMAP.md', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap v1.0
-
-## Phases
-
-### Phase 1: Foundation
-**Goal:** Set up project infrastructure
-**Plans:** 2 plans
-
-Some description here.
-
-### Phase 2: API
-**Goal:** Build REST API
-**Plans:** 3 plans
-`
-    );
-
-    const result = runGsdTools('roadmap get-phase 1', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.found, true, 'phase should be found');
-    assert.strictEqual(output.phase_number, '1', 'phase number correct');
-    assert.strictEqual(output.phase_name, 'Foundation', 'phase name extracted');
-    assert.strictEqual(output.goal, 'Set up project infrastructure', 'goal extracted');
-  });
-
-  test('returns not found for missing phase', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap v1.0
-
-### Phase 1: Foundation
-**Goal:** Set up project
-`
-    );
-
-    const result = runGsdTools('roadmap get-phase 5', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.found, false, 'phase should not be found');
-  });
-
-  test('handles decimal phase numbers', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap
-
-### Phase 2: Main
-**Goal:** Main work
-
-### Phase 2.1: Hotfix
-**Goal:** Emergency fix
-`
-    );
-
-    const result = runGsdTools('roadmap get-phase 2.1', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.found, true, 'decimal phase should be found');
-    assert.strictEqual(output.phase_name, 'Hotfix', 'phase name correct');
-    assert.strictEqual(output.goal, 'Emergency fix', 'goal extracted');
-  });
-
-  test('extracts full section content', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap
-
-### Phase 1: Setup
-**Goal:** Initialize everything
-
-This phase covers:
-- Database setup
-- Auth configuration
-- CI/CD pipeline
-
-### Phase 2: Build
-**Goal:** Build features
-`
-    );
-
-    const result = runGsdTools('roadmap get-phase 1', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.ok(output.section.includes('Database setup'), 'section includes description');
-    assert.ok(output.section.includes('CI/CD pipeline'), 'section includes all bullets');
-    assert.ok(!output.section.includes('Phase 2'), 'section does not include next phase');
-  });
-
-  test('handles missing ROADMAP.md gracefully', () => {
-    const result = runGsdTools('roadmap get-phase 1', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.found, false, 'should return not found');
-    assert.strictEqual(output.error, 'ROADMAP.md not found', 'should explain why');
-  });
-
-  test('accepts ## phase headers (two hashes)', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap v1.0
-
-## Phase 1: Foundation
-**Goal:** Set up project infrastructure
-**Plans:** 2 plans
-
-## Phase 2: API
-**Goal:** Build REST API
-`
-    );
-
-    const result = runGsdTools('roadmap get-phase 1', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.found, true, 'phase with ## header should be found');
-    assert.strictEqual(output.phase_name, 'Foundation', 'phase name extracted');
-    assert.strictEqual(output.goal, 'Set up project infrastructure', 'goal extracted');
-  });
-
-  test('detects malformed ROADMAP with summary list but no detail sections', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap v1.0
-
-## Phases
-
-- [ ] **Phase 1: Foundation** - Set up project
-- [ ] **Phase 2: API** - Build REST API
-`
-    );
-
-    const result = runGsdTools('roadmap get-phase 1', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.found, false, 'phase should not be found');
-    assert.strictEqual(output.error, 'malformed_roadmap', 'should identify malformed roadmap');
-    assert.ok(output.message.includes('missing'), 'should explain the issue');
-  });
-});
-
-// ─────────────────────────────────────────────────────────────────────────────
-// phase next-decimal command
-// ─────────────────────────────────────────────────────────────────────────────
-
-
-describe('roadmap analyze command', () => {
-  let tmpDir;
-
-  beforeEach(() => {
-    tmpDir = createTempProject();
-  });
-
-  afterEach(() => {
-    cleanup(tmpDir);
-  });
-
-  test('missing ROADMAP.md returns error', () => {
-    const result = runGsdTools('roadmap analyze', tmpDir);
-    assert.ok(result.success, `Command should succeed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.error, 'ROADMAP.md not found');
-  });
-
-  test('parses phases with goals and disk status', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap v1.0
-
-### Phase 1: Foundation
-**Goal:** Set up infrastructure
-
-### Phase 2: Authentication
-**Goal:** Add user auth
-
-### Phase 3: Features
-**Goal:** Build core features
-`
-    );
-
-    // Create phase dirs with varying completion
-    const p1 = path.join(tmpDir, '.planning', 'phases', '01-foundation');
-    fs.mkdirSync(p1, { recursive: true });
-    fs.writeFileSync(path.join(p1, '01-01-PLAN.md'), '# Plan');
-    fs.writeFileSync(path.join(p1, '01-01-SUMMARY.md'), '# Summary');
-
-    const p2 = path.join(tmpDir, '.planning', 'phases', '02-authentication');
-    fs.mkdirSync(p2, { recursive: true });
-    fs.writeFileSync(path.join(p2, '02-01-PLAN.md'), '# Plan');
-
-    const result = runGsdTools('roadmap analyze', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.phase_count, 3, 'should find 3 phases');
-    assert.strictEqual(output.phases[0].disk_status, 'complete', 'phase 1 complete');
-    assert.strictEqual(output.phases[1].disk_status, 'planned', 'phase 2 planned');
-    assert.strictEqual(output.phases[2].disk_status, 'no_directory', 'phase 3 no directory');
-    assert.strictEqual(output.completed_phases, 1, '1 phase complete');
-    assert.strictEqual(output.total_plans, 2, '2 total plans');
-    assert.strictEqual(output.total_summaries, 1, '1 total summary');
-    assert.strictEqual(output.progress_percent, 50, '50% complete');
-    assert.strictEqual(output.current_phase, '2', 'current phase is 2');
-  });
-
-  test('extracts goals and dependencies', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap
-
-### Phase 1: Setup
-**Goal:** Initialize project
-**Depends on:** Nothing
-
-### Phase 2: Build
-**Goal:** Build features
-**Depends on:** Phase 1
-`
-    );
-
-    const result = runGsdTools('roadmap analyze', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.phases[0].goal, 'Initialize project');
-    assert.strictEqual(output.phases[0].depends_on, 'Nothing');
-    assert.strictEqual(output.phases[1].goal, 'Build features');
-    assert.strictEqual(output.phases[1].depends_on, 'Phase 1');
-  });
-});
-
-// ─────────────────────────────────────────────────────────────────────────────
-// phase add command
-// ─────────────────────────────────────────────────────────────────────────────
-

package/refs/gsd/tests/state.test.cjs

@@ -1,302 +0,0 @@
-/**
- * GSD Tools Tests - State
- */
-
-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('state-snapshot command', () => {
-  let tmpDir;
-
-  beforeEach(() => {
-    tmpDir = createTempProject();
-  });
-
-  afterEach(() => {
-    cleanup(tmpDir);
-  });
-
-  test('missing STATE.md returns error', () => {
-    const result = runGsdTools('state-snapshot', tmpDir);
-    assert.ok(result.success, `Command should succeed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.error, 'STATE.md not found', 'should report missing file');
-  });
-
-  test('extracts basic fields from STATE.md', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'STATE.md'),
-      `# Project State
-
-**Current Phase:** 03
-**Current Phase Name:** API Layer
-**Total Phases:** 6
-**Current Plan:** 03-02
-**Total Plans in Phase:** 3
-**Status:** In progress
-**Progress:** 45%
-**Last Activity:** 2024-01-15
-**Last Activity Description:** Completed 03-01-PLAN.md
-`
-    );
-
-    const result = runGsdTools('state-snapshot', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.current_phase, '03', 'current phase extracted');
-    assert.strictEqual(output.current_phase_name, 'API Layer', 'phase name extracted');
-    assert.strictEqual(output.total_phases, 6, 'total phases extracted');
-    assert.strictEqual(output.current_plan, '03-02', 'current plan extracted');
-    assert.strictEqual(output.total_plans_in_phase, 3, 'total plans extracted');
-    assert.strictEqual(output.status, 'In progress', 'status extracted');
-    assert.strictEqual(output.progress_percent, 45, 'progress extracted');
-    assert.strictEqual(output.last_activity, '2024-01-15', 'last activity date extracted');
-  });
-
-  test('extracts decisions table', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'STATE.md'),
-      `# Project State
-
-**Current Phase:** 01
-
-## Decisions Made
-
-| Phase | Decision | Rationale |
-|-------|----------|-----------|
-| 01 | Use Prisma | Better DX than raw SQL |
-| 02 | JWT auth | Stateless authentication |
-`
-    );
-
-    const result = runGsdTools('state-snapshot', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.decisions.length, 2, 'should have 2 decisions');
-    assert.strictEqual(output.decisions[0].phase, '01', 'first decision phase');
-    assert.strictEqual(output.decisions[0].summary, 'Use Prisma', 'first decision summary');
-    assert.strictEqual(output.decisions[0].rationale, 'Better DX than raw SQL', 'first decision rationale');
-  });
-
-  test('extracts blockers list', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'STATE.md'),
-      `# Project State
-
-**Current Phase:** 03
-
-## Blockers
-
-- Waiting for API credentials
-- Need design review for dashboard
-`
-    );
-
-    const result = runGsdTools('state-snapshot', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.deepStrictEqual(output.blockers, [
-      'Waiting for API credentials',
-      'Need design review for dashboard',
-    ], 'blockers extracted');
-  });
-
-  test('extracts session continuity info', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'STATE.md'),
-      `# Project State
-
-**Current Phase:** 03
-
-## Session
-
-**Last Date:** 2024-01-15
-**Stopped At:** Phase 3, Plan 2, Task 1
-**Resume File:** .planning/phases/03-api/03-02-PLAN.md
-`
-    );
-
-    const result = runGsdTools('state-snapshot', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.session.last_date, '2024-01-15', 'session date extracted');
-    assert.strictEqual(output.session.stopped_at, 'Phase 3, Plan 2, Task 1', 'stopped at extracted');
-    assert.strictEqual(output.session.resume_file, '.planning/phases/03-api/03-02-PLAN.md', 'resume file extracted');
-  });
-
-  test('handles paused_at field', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'STATE.md'),
-      `# Project State
-
-**Current Phase:** 03
-**Paused At:** Phase 3, Plan 1, Task 2 - mid-implementation
-`
-    );
-
-    const result = runGsdTools('state-snapshot', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.paused_at, 'Phase 3, Plan 1, Task 2 - mid-implementation', 'paused_at extracted');
-  });
-
-  test('supports --cwd override when command runs outside project root', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'STATE.md'),
-      `# Session State
-
-**Current Phase:** 03
-**Status:** Ready to plan
-`
-    );
-    const outsideDir = fs.mkdtempSync(path.join(require('os').tmpdir(), 'gsd-test-outside-'));
-
-    try {
-      const result = runGsdTools(`state-snapshot --cwd "${tmpDir}"`, outsideDir);
-      assert.ok(result.success, `Command failed: ${result.error}`);
-
-      const output = JSON.parse(result.output);
-      assert.strictEqual(output.current_phase, '03', 'should read STATE.md from overridden cwd');
-      assert.strictEqual(output.status, 'Ready to plan', 'should parse status from overridden cwd');
-    } finally {
-      cleanup(outsideDir);
-    }
-  });
-
-  test('returns error for invalid --cwd path', () => {
-    const invalid = path.join(tmpDir, 'does-not-exist');
-    const result = runGsdTools(`state-snapshot --cwd "${invalid}"`, tmpDir);
-    assert.ok(!result.success, 'should fail for invalid --cwd');
-    assert.ok(result.error.includes('Invalid --cwd'), 'error should mention invalid --cwd');
-  });
-});
-
-describe('state mutation commands', () => {
-  let tmpDir;
-
-  beforeEach(() => {
-    tmpDir = createTempProject();
-  });
-
-  afterEach(() => {
-    cleanup(tmpDir);
-  });
-
-  test('add-decision preserves dollar amounts without corrupting Decisions section', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'STATE.md'),
-      `# Project State
-
-## Decisions
-No decisions yet.
-
-## Blockers
-None
-`
-    );
-
-    const result = runGsdTools(
-      "state add-decision --phase 11-01 --summary 'Benchmark prices moved from $0.50 to $2.00 to $5.00' --rationale 'track cost growth'",
-      tmpDir
-    );
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const state = fs.readFileSync(path.join(tmpDir, '.planning', 'STATE.md'), 'utf-8');
-    assert.match(
-      state,
-      /- \[Phase 11-01\]: Benchmark prices moved from \$0\.50 to \$2\.00 to \$5\.00 — track cost growth/,
-      'decision entry should preserve literal dollar values'
-    );
-    assert.strictEqual((state.match(/^## Decisions$/gm) || []).length, 1, 'Decisions heading should not be duplicated');
-    assert.ok(!state.includes('No decisions yet.'), 'placeholder should be removed');
-  });
-
-  test('add-blocker preserves dollar strings without corrupting Blockers section', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'STATE.md'),
-      `# Project State
-
-## Decisions
-None
-
-## Blockers
-None
-`
-    );
-
-    const result = runGsdTools("state add-blocker --text 'Waiting on vendor quote $1.00 before approval'", tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const state = fs.readFileSync(path.join(tmpDir, '.planning', 'STATE.md'), 'utf-8');
-    assert.match(state, /- Waiting on vendor quote \$1\.00 before approval/, 'blocker entry should preserve literal dollar values');
-    assert.strictEqual((state.match(/^## Blockers$/gm) || []).length, 1, 'Blockers heading should not be duplicated');
-  });
-
-  test('add-decision supports file inputs to preserve shell-sensitive dollar text', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'STATE.md'),
-      `# Project State
-
-## Decisions
-No decisions yet.
-
-## Blockers
-None
-`
-    );
-
-    const summaryPath = path.join(tmpDir, 'decision-summary.txt');
-    const rationalePath = path.join(tmpDir, 'decision-rationale.txt');
-    fs.writeFileSync(summaryPath, 'Price tiers: $0.50, $2.00, else $5.00\n');
-    fs.writeFileSync(rationalePath, 'Keep exact currency literals for budgeting\n');
-
-    const result = runGsdTools(
-      `state add-decision --phase 11-02 --summary-file "${summaryPath}" --rationale-file "${rationalePath}"`,
-      tmpDir
-    );
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const state = fs.readFileSync(path.join(tmpDir, '.planning', 'STATE.md'), 'utf-8');
-    assert.match(
-      state,
-      /- \[Phase 11-02\]: Price tiers: \$0\.50, \$2\.00, else \$5\.00 — Keep exact currency literals for budgeting/,
-      'file-based decision input should preserve literal dollar values'
-    );
-  });
-
-  test('add-blocker supports --text-file for shell-sensitive text', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'STATE.md'),
-      `# Project State
-
-## Decisions
-None
-
-## Blockers
-None
-`
-    );
-
-    const blockerPath = path.join(tmpDir, 'blocker.txt');
-    fs.writeFileSync(blockerPath, 'Vendor quote updated from $1.00 to $2.00 pending approval\n');
-
-    const result = runGsdTools(`state add-blocker --text-file "${blockerPath}"`, tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const state = fs.readFileSync(path.join(tmpDir, '.planning', 'STATE.md'), 'utf-8');
-    assert.match(state, /- Vendor quote updated from \$1\.00 to \$2\.00 pending approval/);
-  });
-});
-
-// ─────────────────────────────────────────────────────────────────────────────
-// summary-extract command
-// ─────────────────────────────────────────────────────────────────────────────

package/refs/gsd/tests/verify.test.cjs

@@ -1,80 +0,0 @@
-/**
- * GSD Tools Tests - Verify
- */
-
-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('validate consistency command', () => {
-  let tmpDir;
-
-  beforeEach(() => {
-    tmpDir = createTempProject();
-  });
-
-  afterEach(() => {
-    cleanup(tmpDir);
-  });
-
-  test('passes for consistent project', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap\n### Phase 1: A\n### Phase 2: B\n### Phase 3: C\n`
-    );
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'phases', '01-a'), { recursive: true });
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'phases', '02-b'), { recursive: true });
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'phases', '03-c'), { recursive: true });
-
-    const result = runGsdTools('validate consistency', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.strictEqual(output.passed, true, 'should pass');
-    assert.strictEqual(output.warning_count, 0, 'no warnings');
-  });
-
-  test('warns about phase on disk but not in roadmap', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap\n### Phase 1: A\n`
-    );
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'phases', '01-a'), { recursive: true });
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'phases', '02-orphan'), { recursive: true });
-
-    const result = runGsdTools('validate consistency', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.ok(output.warning_count > 0, 'should have warnings');
-    assert.ok(
-      output.warnings.some(w => w.includes('disk but not in ROADMAP')),
-      'should warn about orphan directory'
-    );
-  });
-
-  test('warns about gaps in phase numbering', () => {
-    fs.writeFileSync(
-      path.join(tmpDir, '.planning', 'ROADMAP.md'),
-      `# Roadmap\n### Phase 1: A\n### Phase 3: C\n`
-    );
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'phases', '01-a'), { recursive: true });
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'phases', '03-c'), { recursive: true });
-
-    const result = runGsdTools('validate consistency', tmpDir);
-    assert.ok(result.success, `Command failed: ${result.error}`);
-
-    const output = JSON.parse(result.output);
-    assert.ok(
-      output.warnings.some(w => w.includes('Gap in phase numbering')),
-      'should warn about gap'
-    );
-  });
-});
-
-// ─────────────────────────────────────────────────────────────────────────────
-// progress command
-// ─────────────────────────────────────────────────────────────────────────────
-