@ktpartners/dgs-platform 2.7.4 → 2.8.0

package/deliver-great-systems/bin/lib/init.test.cjs

@@ -34,13 +34,13 @@ function runInit(cwd, command) {
 
 function v1Fixture() {
   return createFixture({
-    '.planning/config.json': JSON.stringify({}),
-    '.planning/STATE.md': '# State',
-    '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 1: Test Phase** - A test\n',
-    '.planning/REQUIREMENTS.md': '# Requirements',
-    '.planning/PROJECT.md': '# Project',
-    '.planning/phases/01-test-phase/01-CONTEXT.md': '# Context',
-    '.planning/phases/01-test-phase/01-01-PLAN.md': '---\nphase: 01-test-phase\nplan: 01\n---\n# Plan',
+    'config.json': JSON.stringify({}),
+    'STATE.md': '# State',
+    'ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 1: Test Phase** - A test\n',
+    'REQUIREMENTS.md': '# Requirements',
+    'PROJECT.md': '# Project',
+    'phases/01-test-phase/01-CONTEXT.md': '# Context',
+    'phases/01-test-phase/01-01-PLAN.md': '---\nphase: 01-test-phase\nplan: 01\n---\n# Plan',
   });
 }
 
@@ -48,15 +48,15 @@ function v1Fixture() {
 
 function v2FixtureWithProject() {
   return createFixture({
-    '.planning/config.json': JSON.stringify({ current_project: 'test-project' }),
-    '.planning/PROJECTS.md': '# Projects\n\n| Project | Status |\n|---------|--------|\n| test-project | Active |\n',
-    '.planning/REPOS.md': '# Repos\n\n| Name | Path |\n|------|------|\n',
-    '.planning/projects/test-project/STATE.md': '# State',
-    '.planning/projects/test-project/ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 1: Test Phase** - A test\n',
-    '.planning/projects/test-project/REQUIREMENTS.md': '# Requirements',
-    '.planning/projects/test-project/PROJECT.md': '# Project',
-    '.planning/projects/test-project/phases/01-test-phase/01-CONTEXT.md': '# Context',
-    '.planning/projects/test-project/phases/01-test-phase/01-01-PLAN.md': '---\nphase: 01-test-phase\nplan: 01\n---\n# Plan',
+    'config.json': JSON.stringify({ current_project: 'test-project' }),
+    'PROJECTS.md': '# Projects\n\n| Project | Status |\n|---------|--------|\n| test-project | Active |\n',
+    'REPOS.md': '# Repos\n\n| Name | Path |\n|------|------|\n',
+    'projects/test-project/STATE.md': '# State',
+    'projects/test-project/ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 1: Test Phase** - A test\n',
+    'projects/test-project/REQUIREMENTS.md': '# Requirements',
+    'projects/test-project/PROJECT.md': '# Project',
+    'projects/test-project/phases/01-test-phase/01-CONTEXT.md': '# Context',
+    'projects/test-project/phases/01-test-phase/01-01-PLAN.md': '---\nphase: 01-test-phase\nplan: 01\n---\n# Plan',
   });
 }
 
@@ -64,28 +64,28 @@ function v2FixtureWithProject() {
 
 function v2FixtureOneProject() {
   return createFixture({
-    '.planning/config.json': JSON.stringify({}),
-    '.planning/PROJECTS.md': '# Projects\n\n| Project | Status |\n',
-    '.planning/REPOS.md': '# Repos\n\n| Name | Path |\n',
-    '.planning/projects/test-project/STATE.md': '# State',
+    'config.json': JSON.stringify({}),
+    'PROJECTS.md': '# Projects\n\n| Project | Status |\n',
+    'REPOS.md': '# Repos\n\n| Name | Path |\n',
+    'projects/test-project/STATE.md': '# State',
   });
 }
 
 function v2FixtureZeroProjects() {
   return createFixture({
-    '.planning/config.json': JSON.stringify({}),
-    '.planning/PROJECTS.md': '# Projects\n\n| Project | Status |\n',
-    '.planning/REPOS.md': '# Repos\n\n| Name | Path |\n',
+    'config.json': JSON.stringify({}),
+    'PROJECTS.md': '# Projects\n\n| Project | Status |\n',
+    'REPOS.md': '# Repos\n\n| Name | Path |\n',
   });
 }
 
 function v2FixtureMultipleProjects() {
   return createFixture({
-    '.planning/config.json': JSON.stringify({}),
-    '.planning/PROJECTS.md': '# Projects\n\n| Project | Status |\n',
-    '.planning/REPOS.md': '# Repos\n\n| Name | Path |\n',
-    '.planning/projects/alpha-project/STATE.md': '# State',
-    '.planning/projects/beta-project/STATE.md': '# State',
+    'config.json': JSON.stringify({}),
+    'PROJECTS.md': '# Projects\n\n| Project | Status |\n',
+    'REPOS.md': '# Repos\n\n| Name | Path |\n',
+    'projects/alpha-project/STATE.md': '# State',
+    'projects/beta-project/STATE.md': '# State',
   });
 }
 
@@ -104,16 +104,16 @@ describe('v1 mode: init plan-phase', () => {
     fixture.cleanup();
   });
 
-  it('returns state_path as .planning/STATE.md', () => {
-    assert.equal(result.state_path, '.planning/STATE.md');
+  it('returns state_path as STATE.md', () => {
+    assert.equal(result.state_path, 'STATE.md');
   });
 
-  it('returns roadmap_path as .planning/ROADMAP.md', () => {
-    assert.equal(result.roadmap_path, '.planning/ROADMAP.md');
+  it('returns roadmap_path as ROADMAP.md', () => {
+    assert.equal(result.roadmap_path, 'ROADMAP.md');
   });
 
-  it('returns requirements_path as .planning/REQUIREMENTS.md', () => {
-    assert.equal(result.requirements_path, '.planning/REQUIREMENTS.md');
+  it('returns requirements_path as REQUIREMENTS.md', () => {
+    assert.equal(result.requirements_path, 'REQUIREMENTS.md');
   });
 
   it('returns dgs_mode v1', () => {
@@ -128,8 +128,8 @@ describe('v1 mode: init plan-phase', () => {
     assert.equal(result.guard, null);
   });
 
-  it('returns project_root as .planning', () => {
-    assert.equal(result.project_root, '.planning');
+  it('returns project_root as .', () => {
+    assert.equal(result.project_root, '.');
   });
 
   it('preserves phase_found', () => {
@@ -156,24 +156,24 @@ describe('v1 mode: init execute-phase', () => {
     fixture.cleanup();
   });
 
-  it('returns state_path as .planning/STATE.md', () => {
-    assert.equal(result.state_path, '.planning/STATE.md');
+  it('returns state_path as STATE.md', () => {
+    assert.equal(result.state_path, 'STATE.md');
   });
 
-  it('returns roadmap_path as .planning/ROADMAP.md', () => {
-    assert.equal(result.roadmap_path, '.planning/ROADMAP.md');
+  it('returns roadmap_path as ROADMAP.md', () => {
+    assert.equal(result.roadmap_path, 'ROADMAP.md');
   });
 
-  it('returns config_path as .planning/config.json (always product-level)', () => {
-    assert.equal(result.config_path, '.planning/config.json');
+  it('returns config_path as config.json (always product-level)', () => {
+    assert.equal(result.config_path, 'config.json');
   });
 
-  it('returns project_path as .planning/PROJECT.md', () => {
-    assert.equal(result.project_path, '.planning/PROJECT.md');
+  it('returns project_path as PROJECT.md', () => {
+    assert.equal(result.project_path, 'PROJECT.md');
   });
 
-  it('returns debug_dir as .planning/debug', () => {
-    assert.equal(result.debug_dir, '.planning/debug');
+  it('returns debug_dir as debug', () => {
+    assert.equal(result.debug_dir, 'debug');
   });
 
   it('returns dgs_mode v1', () => {
@@ -204,24 +204,24 @@ describe('v1 mode: init new-project', () => {
     fixture.cleanup();
   });
 
-  it('returns state_path as .planning/STATE.md', () => {
-    assert.equal(result.state_path, '.planning/STATE.md');
+  it('returns state_path as STATE.md', () => {
+    assert.equal(result.state_path, 'STATE.md');
   });
 
-  it('returns roadmap_path as .planning/ROADMAP.md', () => {
-    assert.equal(result.roadmap_path, '.planning/ROADMAP.md');
+  it('returns roadmap_path as ROADMAP.md', () => {
+    assert.equal(result.roadmap_path, 'ROADMAP.md');
   });
 
-  it('returns requirements_path as .planning/REQUIREMENTS.md', () => {
-    assert.equal(result.requirements_path, '.planning/REQUIREMENTS.md');
+  it('returns requirements_path as REQUIREMENTS.md', () => {
+    assert.equal(result.requirements_path, 'REQUIREMENTS.md');
   });
 
-  it('returns research_dir as .planning/research', () => {
-    assert.equal(result.research_dir, '.planning/research');
+  it('returns research_dir as research', () => {
+    assert.equal(result.research_dir, 'research');
   });
 
-  it('returns project_path as .planning/PROJECT.md', () => {
-    assert.equal(result.project_path, '.planning/PROJECT.md');
+  it('returns project_path as PROJECT.md', () => {
+    assert.equal(result.project_path, 'PROJECT.md');
   });
 
   it('returns dgs_mode v1', () => {
@@ -253,10 +253,10 @@ describe('v1 mode: init progress', () => {
   });
 
   it('returns v1 file paths', () => {
-    assert.equal(result.state_path, '.planning/STATE.md');
-    assert.equal(result.roadmap_path, '.planning/ROADMAP.md');
-    assert.equal(result.project_path, '.planning/PROJECT.md');
-    assert.equal(result.config_path, '.planning/config.json');
+    assert.equal(result.state_path, 'STATE.md');
+    assert.equal(result.roadmap_path, 'ROADMAP.md');
+    assert.equal(result.project_path, 'PROJECT.md');
+    assert.equal(result.config_path, 'config.json');
   });
 
   it('returns dgs_mode v1', () => {
@@ -278,11 +278,11 @@ describe('v1 mode: init todos', () => {
   });
 
   it('returns v1 pending_dir path', () => {
-    assert.equal(result.pending_dir, '.planning/todos/pending');
+    assert.equal(result.pending_dir, 'todos/pending');
   });
 
   it('returns v1 completed_dir path', () => {
-    assert.equal(result.completed_dir, '.planning/todos/completed');
+    assert.equal(result.completed_dir, 'todos/completed');
   });
 
   it('returns dgs_mode v1', () => {
@@ -304,9 +304,9 @@ describe('v1 mode: init milestone-op', () => {
   });
 
   it('returns v1 file paths', () => {
-    assert.equal(result.project_path, '.planning/PROJECT.md');
-    assert.equal(result.roadmap_path, '.planning/ROADMAP.md');
-    assert.equal(result.state_path, '.planning/STATE.md');
+    assert.equal(result.project_path, 'PROJECT.md');
+    assert.equal(result.roadmap_path, 'ROADMAP.md');
+    assert.equal(result.state_path, 'STATE.md');
   });
 
   it('returns dgs_mode v1', () => {
@@ -332,7 +332,7 @@ describe('v1 mode: init map-codebase', () => {
   });
 
   it('keeps codebase_dir product-level (not project-qualified)', () => {
-    assert.equal(result.codebase_dir, '.planning/codebase');
+    assert.equal(result.codebase_dir, 'codebase');
   });
 
   it('returns dgs_mode v1', () => {
@@ -356,15 +356,15 @@ describe('v2 mode with project: init plan-phase', () => {
   });
 
   it('returns project-qualified state_path', () => {
-    assert.equal(result.state_path, path.join('.planning', 'projects', 'test-project', 'STATE.md'));
+    assert.equal(result.state_path, path.join('projects', 'test-project', 'STATE.md'));
   });
 
   it('returns project-qualified roadmap_path', () => {
-    assert.equal(result.roadmap_path, path.join('.planning', 'projects', 'test-project', 'ROADMAP.md'));
+    assert.equal(result.roadmap_path, path.join('projects', 'test-project', 'ROADMAP.md'));
   });
 
   it('returns project-qualified requirements_path', () => {
-    assert.equal(result.requirements_path, path.join('.planning', 'projects', 'test-project', 'REQUIREMENTS.md'));
+    assert.equal(result.requirements_path, path.join('projects', 'test-project', 'REQUIREMENTS.md'));
   });
 
   it('returns dgs_mode v2', () => {
@@ -376,7 +376,7 @@ describe('v2 mode with project: init plan-phase', () => {
   });
 
   it('returns project_root', () => {
-    assert.equal(result.project_root, path.join('.planning', 'projects', 'test-project'));
+    assert.equal(result.project_root, path.join('projects', 'test-project'));
   });
 
   it('returns guard null (project is set)', () => {
@@ -386,7 +386,7 @@ describe('v2 mode with project: init plan-phase', () => {
   it('finds phase in project-scoped phases directory', () => {
     assert.equal(result.phase_found, true);
     assert.equal(result.phase_number, '01');
-    assert.equal(result.phase_dir, path.join('.planning', 'projects', 'test-project', 'phases', '01-test-phase'));
+    assert.equal(result.phase_dir, path.join('projects', 'test-project', 'phases', '01-test-phase'));
   });
 });
 
@@ -404,23 +404,23 @@ describe('v2 mode with project: init execute-phase', () => {
   });
 
   it('returns project-qualified state_path', () => {
-    assert.equal(result.state_path, path.join('.planning', 'projects', 'test-project', 'STATE.md'));
+    assert.equal(result.state_path, path.join('projects', 'test-project', 'STATE.md'));
   });
 
   it('returns project-qualified roadmap_path', () => {
-    assert.equal(result.roadmap_path, path.join('.planning', 'projects', 'test-project', 'ROADMAP.md'));
+    assert.equal(result.roadmap_path, path.join('projects', 'test-project', 'ROADMAP.md'));
   });
 
   it('config_path stays product-level', () => {
-    assert.equal(result.config_path, '.planning/config.json');
+    assert.equal(result.config_path, 'config.json');
   });
 
   it('returns project-qualified project_path', () => {
-    assert.equal(result.project_path, path.join('.planning', 'projects', 'test-project', 'PROJECT.md'));
+    assert.equal(result.project_path, path.join('projects', 'test-project', 'PROJECT.md'));
   });
 
   it('returns project-qualified debug_dir', () => {
-    assert.equal(result.debug_dir, path.join('.planning', 'projects', 'test-project', 'debug'));
+    assert.equal(result.debug_dir, path.join('projects', 'test-project', 'debug'));
   });
 
   it('returns dgs_mode v2', () => {
@@ -430,7 +430,7 @@ describe('v2 mode with project: init execute-phase', () => {
   it('finds phase in project-scoped phases directory', () => {
     assert.equal(result.phase_found, true);
     assert.equal(result.phase_number, '01');
-    assert.equal(result.phase_dir, path.join('.planning', 'projects', 'test-project', 'phases', '01-test-phase'));
+    assert.equal(result.phase_dir, path.join('projects', 'test-project', 'phases', '01-test-phase'));
   });
 });
 
@@ -448,23 +448,23 @@ describe('v2 mode with project: init new-project', () => {
   });
 
   it('returns project-qualified state_path', () => {
-    assert.equal(result.state_path, path.join('.planning', 'projects', 'test-project', 'STATE.md'));
+    assert.equal(result.state_path, path.join('projects', 'test-project', 'STATE.md'));
   });
 
   it('returns project-qualified roadmap_path', () => {
-    assert.equal(result.roadmap_path, path.join('.planning', 'projects', 'test-project', 'ROADMAP.md'));
+    assert.equal(result.roadmap_path, path.join('projects', 'test-project', 'ROADMAP.md'));
   });
 
   it('returns project-qualified requirements_path', () => {
-    assert.equal(result.requirements_path, path.join('.planning', 'projects', 'test-project', 'REQUIREMENTS.md'));
+    assert.equal(result.requirements_path, path.join('projects', 'test-project', 'REQUIREMENTS.md'));
   });
 
   it('returns project-qualified research_dir', () => {
-    assert.equal(result.research_dir, path.join('.planning', 'projects', 'test-project', 'research'));
+    assert.equal(result.research_dir, path.join('projects', 'test-project', 'research'));
   });
 
   it('returns project-qualified project_path', () => {
-    assert.equal(result.project_path, path.join('.planning', 'projects', 'test-project', 'PROJECT.md'));
+    assert.equal(result.project_path, path.join('projects', 'test-project', 'PROJECT.md'));
   });
 
   it('returns dgs_mode v2', () => {
@@ -490,16 +490,16 @@ describe('v2 mode with project: init progress', () => {
   });
 
   it('returns project-qualified state_path', () => {
-    assert.equal(result.state_path, path.join('.planning', 'projects', 'test-project', 'STATE.md'));
+    assert.equal(result.state_path, path.join('projects', 'test-project', 'STATE.md'));
   });
 
   it('config_path stays product-level', () => {
-    assert.equal(result.config_path, '.planning/config.json');
+    assert.equal(result.config_path, 'config.json');
   });
 
   it('phase directory is project-qualified', () => {
     if (result.phases.length > 0) {
-      assert.ok(result.phases[0].directory.startsWith(path.join('.planning', 'projects', 'test-project', 'phases')));
+      assert.ok(result.phases[0].directory.startsWith(path.join('projects', 'test-project', 'phases')));
     }
   });
 });
@@ -518,11 +518,11 @@ describe('v2 mode with project: init todos', () => {
   });
 
   it('returns product-level pending_dir', () => {
-    assert.equal(result.pending_dir, path.join('.planning', 'todos', 'pending'));
+    assert.equal(result.pending_dir, path.join('todos', 'pending'));
   });
 
   it('returns product-level completed_dir', () => {
-    assert.equal(result.completed_dir, path.join('.planning', 'todos', 'completed'));
+    assert.equal(result.completed_dir, path.join('todos', 'completed'));
   });
 
   it('returns dgs_mode v2', () => {
@@ -544,9 +544,9 @@ describe('v2 mode with project: init milestone-op', () => {
   });
 
   it('returns project-qualified file paths', () => {
-    assert.equal(result.project_path, path.join('.planning', 'projects', 'test-project', 'PROJECT.md'));
-    assert.equal(result.roadmap_path, path.join('.planning', 'projects', 'test-project', 'ROADMAP.md'));
-    assert.equal(result.state_path, path.join('.planning', 'projects', 'test-project', 'STATE.md'));
+    assert.equal(result.project_path, path.join('projects', 'test-project', 'PROJECT.md'));
+    assert.equal(result.roadmap_path, path.join('projects', 'test-project', 'ROADMAP.md'));
+    assert.equal(result.state_path, path.join('projects', 'test-project', 'STATE.md'));
   });
 
   it('returns dgs_mode v2', () => {
@@ -568,7 +568,7 @@ describe('v2 mode with project: init map-codebase', () => {
   });
 
   it('keeps codebase_dir product-level (shared, not project-qualified)', () => {
-    assert.equal(result.codebase_dir, '.planning/codebase');
+    assert.equal(result.codebase_dir, 'codebase');
   });
 
   it('returns dgs_mode v2', () => {
@@ -589,10 +589,10 @@ describe('init map-codebase: multi-repo with valid repos', () => {
 
     // Use a fixture with REPOS.md containing the sibling repo via relative path
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': `# Repos\n\nRegistered repositories for this product. Managed by DGS — manual edits may be overwritten.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| testrepo | ../${path.basename(repoDir)} | | Test repo |\n`,
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': `# Repos\n\nRegistered repositories for this product. Managed by DGS — manual edits may be overwritten.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| testrepo | ../${path.basename(repoDir)} | | Test repo |\n`,
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -626,7 +626,7 @@ describe('init map-codebase: multi-repo with valid repos', () => {
 
   it('preserves backward-compatible codebase_dir field', () => {
     const result = runInit(fixture.cwd, 'map-codebase');
-    assert.equal(result.codebase_dir, '.planning/codebase');
+    assert.equal(result.codebase_dir, 'codebase');
   });
 });
 
@@ -635,9 +635,9 @@ describe('init map-codebase: no repos registered', () => {
 
   beforeEach(() => {
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -666,10 +666,10 @@ describe('init map-codebase: empty REPOS.md table', () => {
 
   beforeEach(() => {
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': '# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n',
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': '# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n',
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -697,12 +697,12 @@ describe('init map-codebase: existing per-repo maps detected', () => {
     fs.mkdirSync(path.join(repoDir, '.git'));
 
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| myrepo | ../${path.basename(repoDir)} | | My repo |\n`,
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
-      '.planning/codebase/myrepo/STACK.md': '# Stack\n',
-      '.planning/codebase/myrepo/ARCHITECTURE.md': '# Architecture\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| myrepo | ../${path.basename(repoDir)} | | My repo |\n`,
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'codebase/myrepo/STACK.md': '# Stack\n',
+      'codebase/myrepo/ARCHITECTURE.md': '# Architecture\n',
     });
   });
 
@@ -725,10 +725,10 @@ describe('init map-codebase: invalid repo paths produce errors', () => {
 
   beforeEach(() => {
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': '# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| badrepo | ../nonexistent-path-nowhere | | Bad repo |\n',
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': '# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| badrepo | ../nonexistent-path-nowhere | | Bad repo |\n',
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -766,10 +766,10 @@ describe('init map-codebase: --only with valid repo name returns only that repo'
     fs.mkdirSync(path.join(repoDirB, '.git'));
 
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n| repo-b | ../${path.basename(repoDirB)} | | Repo B |\n`,
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n| repo-b | ../${path.basename(repoDirB)} | | Repo B |\n`,
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -811,10 +811,10 @@ describe('init map-codebase: --only with invalid repo name throws error', () =>
     fs.mkdirSync(path.join(repoDirA, '.git'));
 
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n`,
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n`,
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -854,10 +854,10 @@ describe('init map-codebase: without --only returns refresh mode', () => {
     fs.mkdirSync(path.join(repoDirB, '.git'));
 
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n| repo-b | ../${path.basename(repoDirB)} | | Repo B |\n`,
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n| repo-b | ../${path.basename(repoDirB)} | | Repo B |\n`,
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -894,10 +894,10 @@ describe('init map-codebase: --only without repo name argument throws error', ()
     fs.mkdirSync(path.join(repoDirA, '.git'));
 
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n`,
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n`,
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -937,10 +937,10 @@ describe('init map-codebase: positional argument with valid repo name', () => {
     fs.mkdirSync(path.join(repoDirB, '.git'));
 
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n| repo-b | ../${path.basename(repoDirB)} | | Repo B |\n`,
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n| repo-b | ../${path.basename(repoDirB)} | | Repo B |\n`,
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -985,10 +985,10 @@ describe('init map-codebase: positional argument with invalid repo name', () =>
     fs.mkdirSync(path.join(repoDirA, '.git'));
 
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n`,
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n`,
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -1017,10 +1017,10 @@ describe('init map-codebase: argument starting with -- is not treated as positio
     fs.mkdirSync(path.join(repoDirA, '.git'));
 
     fixture = createFixture({
-      '.planning/config.json': JSON.stringify({}),
-      '.planning/REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n`,
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
+      'config.json': JSON.stringify({}),
+      'REPOS.md': `# Repos\n\nRegistered repositories.\n\n| Name | Path | GitHub URL | Description |\n|------|------|------------|-------------|\n| repo-a | ../${path.basename(repoDirA)} | | Repo A |\n`,
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n',
     });
   });
 
@@ -1066,7 +1066,7 @@ describe('v2 guard: one project, no current_project (auto-select)', () => {
   });
 
   it('project_root is set to the auto-selected project root', () => {
-    assert.equal(result.project_root, path.join('.planning', 'projects', 'test-project'));
+    assert.equal(result.project_root, path.join('projects', 'test-project'));
   });
 
   it('dgs_mode is v2', () => {
@@ -1148,12 +1148,12 @@ describe('v2 guard: multiple projects (prompt)', () => {
 describe('branch_name with {project} resolution', () => {
   it('v1 execute-phase branch_name resolves {project} from current_project', () => {
     const fixture = createFixture({
-      '.planning/config.json': JSON.stringify({ current_project: 'myapp', git: { branching_strategy: 'phase' } }),
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 3: Auth** - Auth\n',
-      '.planning/REQUIREMENTS.md': '# Requirements',
-      '.planning/PROJECT.md': '# Project',
-      '.planning/phases/03-auth/03-01-PLAN.md': '---\nphase: 03-auth\nplan: 01\n---\n# Plan',
+      'config.json': JSON.stringify({ current_project: 'myapp', git: { branching_strategy: 'phase' } }),
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 3: Auth** - Auth\n',
+      'REQUIREMENTS.md': '# Requirements',
+      'PROJECT.md': '# Project',
+      'phases/03-auth/03-01-PLAN.md': '---\nphase: 03-auth\nplan: 01\n---\n# Plan',
     });
     try {
       const result = runInit(fixture.cwd, 'execute-phase 3');
@@ -1165,14 +1165,14 @@ describe('branch_name with {project} resolution', () => {
 
   it('v2 execute-phase branch_name resolves {project} from current_project', () => {
     const fixture = createFixture({
-      '.planning/config.json': JSON.stringify({ current_project: 'checkout', git: { branching_strategy: 'phase' } }),
-      '.planning/PROJECTS.md': '# Projects\n\n| Project | Status |\n|---------|--------|\n| checkout | Active |\n',
-      '.planning/REPOS.md': '# Repos\n\n| Name | Path |\n|------|------|\n',
-      '.planning/projects/checkout/STATE.md': '# State',
-      '.planning/projects/checkout/ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 1: Init** - Init\n',
-      '.planning/projects/checkout/REQUIREMENTS.md': '# Requirements',
-      '.planning/projects/checkout/PROJECT.md': '# Project',
-      '.planning/projects/checkout/phases/01-init/01-01-PLAN.md': '---\nphase: 01-init\nplan: 01\n---\n# Plan',
+      'config.json': JSON.stringify({ current_project: 'checkout', git: { branching_strategy: 'phase' } }),
+      'PROJECTS.md': '# Projects\n\n| Project | Status |\n|---------|--------|\n| checkout | Active |\n',
+      'REPOS.md': '# Repos\n\n| Name | Path |\n|------|------|\n',
+      'projects/checkout/STATE.md': '# State',
+      'projects/checkout/ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 1: Init** - Init\n',
+      'projects/checkout/REQUIREMENTS.md': '# Requirements',
+      'projects/checkout/PROJECT.md': '# Project',
+      'projects/checkout/phases/01-init/01-01-PLAN.md': '---\nphase: 01-init\nplan: 01\n---\n# Plan',
     });
     try {
       const result = runInit(fixture.cwd, 'execute-phase 1');
@@ -1184,15 +1184,15 @@ describe('branch_name with {project} resolution', () => {
 
   it('branch_name with custom template without {project} is unchanged', () => {
     const fixture = createFixture({
-      '.planning/config.json': JSON.stringify({
+      'config.json': JSON.stringify({
         current_project: 'myapp',
         git: { branching_strategy: 'phase', phase_branch_template: 'feature/phase-{phase}-{slug}' }
       }),
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 3: Auth** - Auth\n',
-      '.planning/REQUIREMENTS.md': '# Requirements',
-      '.planning/PROJECT.md': '# Project',
-      '.planning/phases/03-auth/03-01-PLAN.md': '---\nphase: 03-auth\nplan: 01\n---\n# Plan',
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 3: Auth** - Auth\n',
+      'REQUIREMENTS.md': '# Requirements',
+      'PROJECT.md': '# Project',
+      'phases/03-auth/03-01-PLAN.md': '---\nphase: 03-auth\nplan: 01\n---\n# Plan',
     });
     try {
       const result = runInit(fixture.cwd, 'execute-phase 3');
@@ -1204,12 +1204,12 @@ describe('branch_name with {project} resolution', () => {
 
   it('branch_name errors when {project} in template but current_project is null', () => {
     const fixture = createFixture({
-      '.planning/config.json': JSON.stringify({ git: { branching_strategy: 'phase' } }),
-      '.planning/STATE.md': '# State',
-      '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 3: Auth** - Auth\n',
-      '.planning/REQUIREMENTS.md': '# Requirements',
-      '.planning/PROJECT.md': '# Project',
-      '.planning/phases/03-auth/03-01-PLAN.md': '---\nphase: 03-auth\nplan: 01\n---\n# Plan',
+      'config.json': JSON.stringify({ git: { branching_strategy: 'phase' } }),
+      'STATE.md': '# State',
+      'ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 3: Auth** - Auth\n',
+      'REQUIREMENTS.md': '# Requirements',
+      'PROJECT.md': '# Project',
+      'phases/03-auth/03-01-PLAN.md': '---\nphase: 03-auth\nplan: 01\n---\n# Plan',
     });
     try {
       const result = runInit(fixture.cwd, 'execute-phase 3');
@@ -1227,13 +1227,13 @@ describe('branch_name with {project} resolution', () => {
 // Helper: v1 fixture with custom git.sync_pull setting
 function v1FixtureWithSyncPull(syncPull) {
   return createFixture({
-    '.planning/config.json': JSON.stringify({ git: { sync_pull: syncPull } }),
-    '.planning/STATE.md': '# State',
-    '.planning/ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 1: Test Phase** - A test\n',
-    '.planning/REQUIREMENTS.md': '# Requirements',
-    '.planning/PROJECT.md': '# Project',
-    '.planning/phases/01-test-phase/01-CONTEXT.md': '# Context',
-    '.planning/phases/01-test-phase/01-01-PLAN.md': '---\nphase: 01-test-phase\nplan: 01\n---\n# Plan',
+    'config.json': JSON.stringify({ git: { sync_pull: syncPull } }),
+    'STATE.md': '# State',
+    'ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 1: Test Phase** - A test\n',
+    'REQUIREMENTS.md': '# Requirements',
+    'PROJECT.md': '# Project',
+    'phases/01-test-phase/01-CONTEXT.md': '# Context',
+    'phases/01-test-phase/01-01-PLAN.md': '---\nphase: 01-test-phase\nplan: 01\n---\n# Plan',
   });
 }
 
@@ -1454,3 +1454,70 @@ describe('backward compatibility: v1 output is superset of old shape', () => {
     assert.ok('dgs_mode' in result);
   });
 });
+
+// ─── Archived milestone phase rejection ───────────────────────────────────────
+
+describe('archived milestone phase rejection', () => {
+  let fixture;
+
+  beforeEach(() => {
+    // v2 fixture with:
+    // - Active project with phase 01
+    // - Archived milestone v16.0 with phase 50 (NOT in active project)
+    // - ROADMAP.md does NOT list phase 50
+    fixture = createFixture({
+      'config.json': JSON.stringify({ current_project: 'test-project' }),
+      'PROJECTS.md': '# Projects\n\n| Project | Status |\n|---------|--------|\n| test-project | Active |\n',
+      'REPOS.md': '# Repos\n\n| Name | Path |\n|------|------|\n',
+      'projects/test-project/STATE.md': '# State',
+      'projects/test-project/ROADMAP.md': '# Roadmap\n\n## Phases\n\n- [ ] **Phase 1: Test Phase** - A test\n',
+      'projects/test-project/REQUIREMENTS.md': '# Requirements',
+      'projects/test-project/PROJECT.md': '# Project',
+      'projects/test-project/phases/01-test-phase/01-CONTEXT.md': '# Context',
+      'projects/test-project/phases/01-test-phase/01-01-PLAN.md': '---\nphase: 01-test-phase\nplan: 01\n---\n# Plan',
+      // Archived milestone phase 50 — exists ONLY in archive
+      'milestones/v16.0-phases/50-old-phase/50-CONTEXT.md': '# Old Context',
+      'milestones/v16.0-phases/50-old-phase/50-01-PLAN.md': '---\nphase: 50-old-phase\nplan: 01\n---\n# Old Plan',
+    });
+  });
+
+  afterEach(() => {
+    fixture.cleanup();
+  });
+
+  it('execute-phase rejects archived-only phase 50', () => {
+    const result = runInit(fixture.cwd, 'execute-phase 50');
+    assert.equal(result.phase_found, false);
+    assert.equal(result.phase_dir, null);
+  });
+
+  it('plan-phase rejects archived-only phase 50', () => {
+    const result = runInit(fixture.cwd, 'plan-phase 50');
+    assert.equal(result.phase_found, false);
+    assert.equal(result.phase_dir, null);
+  });
+
+  it('verify-work rejects archived-only phase 50', () => {
+    const result = runInit(fixture.cwd, 'verify-work 50');
+    assert.equal(result.phase_found, false);
+    assert.equal(result.phase_dir, null);
+  });
+
+  it('audit-phase rejects archived-only phase 50', () => {
+    const result = runInit(fixture.cwd, 'audit-phase 50');
+    assert.equal(result.phase_found, false);
+    assert.equal(result.phase_dir, null);
+  });
+
+  it('phase-op rejects archived-only phase 50', () => {
+    const result = runInit(fixture.cwd, 'phase-op 50');
+    assert.equal(result.phase_found, false);
+    assert.equal(result.phase_dir, null);
+  });
+
+  it('execute-phase still finds active phase 1', () => {
+    const result = runInit(fixture.cwd, 'execute-phase 1');
+    assert.equal(result.phase_found, true);
+    assert.ok(result.phase_dir);
+  });
+});