@ktpartners/dgs-platform 2.7.5 → 2.9.0

package/deliver-great-systems/bin/lib/projects.cjs

@@ -19,7 +19,7 @@ const STANDARD_DIRS = ['phases', 'research', 'quick', 'debug'];
 // ─── Project Subfolder Creation ─────────────────────────────────────────────
 
 /**
- * Create a project subfolder under .planning/projects/<slug>/ with all standard
+ * Create a project subfolder under projects/<slug>/ with all standard
  * planning files and directories.
  *
  * @param {string} cwd - Working directory (product root)
@@ -31,7 +31,7 @@ const STANDARD_DIRS = ['phases', 'research', 'quick', 'debug'];
  */
 function createProjectSubfolder(cwd, slug, name, options) {
   const projectDir = getProjectDir(cwd, slug);
-  // Ensure .planning/projects/ container exists
+  // Ensure projects/ container exists
   fs.mkdirSync(path.dirname(projectDir), { recursive: true });
 
   // Don't overwrite existing project
@@ -77,7 +77,7 @@ function createProjectSubfolder(cwd, slug, name, options) {
 // ─── Project State Reading ──────────────────────────────────────────────────
 
 /**
- * Read and parse a project's STATE.md at .planning/projects/<slug>/STATE.md
+ * Read and parse a project's STATE.md at projects/<slug>/STATE.md
  * to extract status information.
  *
  * Extracts:
@@ -114,7 +114,7 @@ function readProjectState(cwd, slug) {
  * Scan a project's plan files for <repos>...</repos> tags and extract
  * all unique repo names referenced.
  *
- * Scans all PLAN.md files under .planning/projects/<slug>/phases/ subdirectories.
+ * Scans all PLAN.md files under projects/<slug>/phases/ subdirectories.
  *
  * @param {string} cwd - Working directory (product root)
  * @param {string} slug - Project slug
@@ -166,7 +166,7 @@ function scanProjectReposTags(cwd, slug) {
 // ─── PROJECTS.md Regeneration ───────────────────────────────────────────────
 
 /**
- * Regenerate .planning/PROJECTS.md by scanning all project subfolders.
+ * Regenerate PROJECTS.md by scanning all project subfolders.
  *
  * Reads each project's STATE.md for status/phase/progress, scans plan
  * <repos> tags for repos touched, and writes the derived PROJECTS.md.
@@ -229,7 +229,7 @@ function regenerateProjectsMd(cwd) {
 
 /**
  * Mark a project as completed by updating its STATE.md at
- * .planning/projects/<slug>/STATE.md.
+ * projects/<slug>/STATE.md.
  *
  * - Updates "Status:" line to "completed"
  * - Adds "Completed: YYYY-MM-DD" line with today's date
@@ -286,7 +286,7 @@ function completeProject(cwd, slug) {
 
 /**
  * Reactivate a completed project by updating its STATE.md at
- * .planning/projects/<slug>/STATE.md.
+ * projects/<slug>/STATE.md.
  *
  * - Changes "Status: completed" back to "Status: In progress"
  * - Removes the "Completed: YYYY-MM-DD" line entirely
@@ -332,7 +332,7 @@ function reactivateProject(cwd, slug) {
 // ─── PROJECTS.md Parsing ────────────────────────────────────────────────────
 
 /**
- * Parse .planning/PROJECTS.md into structured data.
+ * Parse PROJECTS.md into structured data.
  *
  * Returns null if the file doesn't exist or doesn't start with '# Projects'.
  *

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

@@ -9,26 +9,27 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-const { createTempDir, cleanupDir, createFixture } = require('./test-helpers.cjs');
+const { createTempDir, cleanupDir, createFixture , initGitRepo } = require('./test-helpers.cjs');
+const { resetPaths } = require('./paths.cjs');
 const { getProjectRoot } = require('./core.cjs');
 
-// Helper: create .planning/projects/ directory structure
+// Helper: create projects/ directory structure
 function setupPlanning(cwd) {
-  fs.mkdirSync(path.join(cwd, '.planning', 'projects'), { recursive: true });
+  fs.mkdirSync(path.join(cwd, 'projects'), { recursive: true });
 }
 
-// Helper: create a project subfolder with STATE.md manually under .planning/projects/<slug>/
+// Helper: create a project subfolder with STATE.md manually under projects/<slug>/
 function createProjectManually(cwd, slug, stateContent) {
-  const projDir = path.join(cwd, '.planning', 'projects', slug);
+  const projDir = path.join(cwd, 'projects', slug);
   fs.mkdirSync(projDir, { recursive: true });
   if (stateContent) {
     fs.writeFileSync(path.join(projDir, 'STATE.md'), stateContent);
   }
 }
 
-// Helper: create plan file with <repos> tags under .planning/projects/<slug>/phases/
+// Helper: create plan file with <repos> tags under projects/<slug>/phases/
 function createPlanFile(cwd, slug, phaseDir, planName, content) {
-  const dir = path.join(cwd, '.planning', 'projects', slug, 'phases', phaseDir);
+  const dir = path.join(cwd, 'projects', slug, 'phases', phaseDir);
   fs.mkdirSync(dir, { recursive: true });
   fs.writeFileSync(path.join(dir, planName), content);
 }
@@ -50,16 +51,16 @@ describe('createProjectSubfolder', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
-  it('creates project directory at .planning/projects/<slug>/', () => {
+  it('creates project directory at projects/<slug>/', () => {
     const result = createProjectSubfolder(tmpDir, 'auth-overhaul', 'Auth Overhaul');
     assert.strictEqual(result.created, true);
-    assert.ok(fs.existsSync(path.join(tmpDir, '.planning', 'projects', 'auth-overhaul')));
+    assert.ok(fs.existsSync(path.join(tmpDir, 'projects', 'auth-overhaul')));
   });
 
   it('creates all required subdirectories', () => {
@@ -67,7 +68,7 @@ describe('createProjectSubfolder', () => {
     const expectedDirs = ['phases', 'research', 'quick', 'debug'];
     for (const dir of expectedDirs) {
       assert.ok(
-        fs.existsSync(path.join(tmpDir, '.planning', 'projects', 'auth-overhaul', dir)),
+        fs.existsSync(path.join(tmpDir, 'projects', 'auth-overhaul', dir)),
         `Missing directory: ${dir}`
       );
     }
@@ -78,7 +79,7 @@ describe('createProjectSubfolder', () => {
     const expectedFiles = ['PROJECT.md', 'REQUIREMENTS.md', 'ROADMAP.md', 'STATE.md'];
     for (const file of expectedFiles) {
       assert.ok(
-        fs.existsSync(path.join(tmpDir, '.planning', 'projects', 'auth-overhaul', file)),
+        fs.existsSync(path.join(tmpDir, 'projects', 'auth-overhaul', file)),
         `Missing file: ${file}`
       );
     }
@@ -87,7 +88,7 @@ describe('createProjectSubfolder', () => {
   it('PROJECT.md contains project name in header', () => {
     createProjectSubfolder(tmpDir, 'auth-overhaul', 'Auth Overhaul');
     const content = fs.readFileSync(
-      path.join(tmpDir, '.planning', 'projects', 'auth-overhaul', 'PROJECT.md'),
+      path.join(tmpDir, 'projects', 'auth-overhaul', 'PROJECT.md'),
       'utf-8'
     );
     assert.ok(content.includes('# Project: Auth Overhaul'));
@@ -96,7 +97,7 @@ describe('createProjectSubfolder', () => {
   it('STATE.md contains initial "Not started" status', () => {
     createProjectSubfolder(tmpDir, 'auth-overhaul', 'Auth Overhaul');
     const content = fs.readFileSync(
-      path.join(tmpDir, '.planning', 'projects', 'auth-overhaul', 'STATE.md'),
+      path.join(tmpDir, 'projects', 'auth-overhaul', 'STATE.md'),
       'utf-8'
     );
     assert.ok(content.includes('Not started'));
@@ -118,7 +119,7 @@ describe('createProjectSubfolder', () => {
   it('handles slug that is already clean', () => {
     const result = createProjectSubfolder(tmpDir, 'my-cool-project', 'My Cool Project');
     assert.strictEqual(result.created, true);
-    assert.ok(fs.existsSync(path.join(tmpDir, '.planning', 'projects', 'my-cool-project')));
+    assert.ok(fs.existsSync(path.join(tmpDir, 'projects', 'my-cool-project')));
   });
 });
 
@@ -128,11 +129,11 @@ describe('readProjectState', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('extracts phase from "Phase: 3 of 7 (Name)" format', () => {
     createProjectManually(tmpDir, 'proj', '# Project State\n\nPhase: 3 of 7 (Project Lifecycle)\nStatus: In progress\n');
@@ -195,11 +196,11 @@ describe('scanProjectReposTags', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('returns empty array when no phases directory exists', () => {
     createProjectManually(tmpDir, 'proj', '# State\n');
@@ -209,7 +210,7 @@ describe('scanProjectReposTags', () => {
 
   it('returns empty array when no plan files exist', () => {
     createProjectManually(tmpDir, 'proj', '# State\n');
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'phases', '01-setup'), {
+    fs.mkdirSync(path.join(tmpDir, 'projects', 'proj', 'phases', '01-setup'), {
       recursive: true,
     });
     const repos = scanProjectReposTags(tmpDir, 'proj');
@@ -252,30 +253,30 @@ describe('regenerateProjectsMd', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('writes Active table with correct columns', () => {
     createProjectManually(tmpDir, 'proj-a', '# Project State\n\nPhase: 1\nStatus: Active\nProgress: [██░░░░░░░░] 20%\n');
     regenerateProjectsMd(tmpDir);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'PROJECTS.md'), 'utf-8');
     assert.ok(content.includes('| Project | Status | Repos Touched | Current Phase |'));
   });
 
   it('writes Completed table with correct columns', () => {
     createProjectManually(tmpDir, 'proj-a', '# Project State\n\nStatus: Active\n');
     regenerateProjectsMd(tmpDir);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'PROJECTS.md'), 'utf-8');
     assert.ok(content.includes('| Project | Completed | Duration |'));
   });
 
   it('active projects appear in Active table', () => {
     createProjectManually(tmpDir, 'proj-a', '# Project State\n\nPhase: 2\nStatus: Active\n');
     regenerateProjectsMd(tmpDir);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'PROJECTS.md'), 'utf-8');
     // Find active section and check for project row
     const activeSection = content.split('## Completed')[0];
     assert.ok(activeSection.includes('proj-a'));
@@ -284,14 +285,14 @@ describe('regenerateProjectsMd', () => {
   it('completed projects appear in Completed table', () => {
     createProjectManually(tmpDir, 'proj-done', '# Project State\n\nStatus: completed\nCompleted: 2026-02-20\n');
     regenerateProjectsMd(tmpDir);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'PROJECTS.md'), 'utf-8');
     const completedSection = content.split('## Completed')[1];
     assert.ok(completedSection.includes('proj-done'));
   });
 
   it('ghost projects emit warning and are omitted', () => {
     // Create directory but NO STATE.md
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'projects', 'ghost-project'), { recursive: true });
+    fs.mkdirSync(path.join(tmpDir, 'projects', 'ghost-project'), { recursive: true });
     // getProjectFolders requires STATE.md, so ghost won't even be found
     // But let's also test a project whose STATE.md is unreadable
     createProjectManually(tmpDir, 'real-project', '# State\n\nStatus: Active\n');
@@ -309,7 +310,7 @@ describe('regenerateProjectsMd', () => {
 
   it('empty project list produces tables with headers but no data rows', () => {
     regenerateProjectsMd(tmpDir);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'PROJECTS.md'), 'utf-8');
     assert.ok(content.includes('# Projects'));
     assert.ok(content.includes('## Active'));
     assert.ok(content.includes('## Completed'));
@@ -317,7 +318,7 @@ describe('regenerateProjectsMd', () => {
 
   it('starts with # Projects header (v2 marker)', () => {
     regenerateProjectsMd(tmpDir);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'PROJECTS.md'), 'utf-8');
     assert.ok(content.startsWith('# Projects'));
   });
 });
@@ -328,23 +329,23 @@ describe('completeProject', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('adds "Status: completed" to STATE.md', () => {
     createProjectManually(tmpDir, 'proj', '# Project State\n\nPhase: 3\nStatus: Active\n');
     completeProject(tmpDir, 'proj');
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'STATE.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'projects', 'proj', 'STATE.md'), 'utf-8');
     assert.ok(content.includes('Status: completed'));
   });
 
   it('adds "Completed: YYYY-MM-DD" to STATE.md', () => {
     createProjectManually(tmpDir, 'proj', '# Project State\n\nStatus: Active\n');
     const result = completeProject(tmpDir, 'proj');
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'STATE.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'projects', 'proj', 'STATE.md'), 'utf-8');
     assert.ok(content.includes('Completed:'));
     assert.ok(/Completed: \d{4}-\d{2}-\d{2}/.test(content));
   });
@@ -364,7 +365,7 @@ describe('completeProject', () => {
   });
 
   it('returns error if STATE.md does not exist', () => {
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'projects', 'no-state'), { recursive: true });
+    fs.mkdirSync(path.join(tmpDir, 'projects', 'no-state'), { recursive: true });
     const result = completeProject(tmpDir, 'no-state');
     assert.strictEqual(result.completed, false);
     assert.strictEqual(result.error, 'no_state_md');
@@ -384,23 +385,23 @@ describe('reactivateProject', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('changes Status from completed back to In progress', () => {
     createProjectManually(tmpDir, 'proj', '# Project State\n\nStatus: completed\nCompleted: 2026-01-15\n');
     reactivateProject(tmpDir, 'proj');
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'STATE.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'projects', 'proj', 'STATE.md'), 'utf-8');
     assert.ok(content.includes('Status: In progress'));
   });
 
   it('removes Completed date line', () => {
     createProjectManually(tmpDir, 'proj', '# Project State\n\nStatus: completed\nCompleted: 2026-01-15\n');
     reactivateProject(tmpDir, 'proj');
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'STATE.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'projects', 'proj', 'STATE.md'), 'utf-8');
     assert.ok(!content.includes('Completed:'));
   });
 
@@ -417,7 +418,7 @@ describe('reactivateProject', () => {
   });
 
   it('returns error if STATE.md does not exist', () => {
-    fs.mkdirSync(path.join(tmpDir, '.planning', 'projects', 'no-state'), { recursive: true });
+    fs.mkdirSync(path.join(tmpDir, 'projects', 'no-state'), { recursive: true });
     const result = reactivateProject(tmpDir, 'no-state');
     assert.strictEqual(result.reactivated, false);
     assert.strictEqual(result.error, 'no_state_md');
@@ -434,7 +435,7 @@ describe('reactivateProject', () => {
     const original = '# Project State\n\n## Current Position\n\nPhase: 5 of 7\nStatus: completed\nCompleted: 2026-01-15\n\n## Decisions\n\n- Some important decision\n';
     createProjectManually(tmpDir, 'proj', original);
     reactivateProject(tmpDir, 'proj');
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'STATE.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'projects', 'proj', 'STATE.md'), 'utf-8');
     assert.ok(content.includes('# Project State'));
     assert.ok(content.includes('## Decisions'));
     assert.ok(content.includes('Some important decision'));
@@ -445,7 +446,7 @@ describe('reactivateProject', () => {
     const original = '# Project State\n\nStatus: Active\n';
     createProjectManually(tmpDir, 'proj', original);
     reactivateProject(tmpDir, 'proj');
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'STATE.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'projects', 'proj', 'STATE.md'), 'utf-8');
     assert.strictEqual(content, original);
   });
 
@@ -453,7 +454,7 @@ describe('reactivateProject', () => {
     createProjectManually(tmpDir, 'proj', '# Project State\n\nStatus: Completed\nCompleted: 2026-01-15\n');
     const result = reactivateProject(tmpDir, 'proj');
     assert.strictEqual(result.reactivated, true);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'STATE.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'projects', 'proj', 'STATE.md'), 'utf-8');
     assert.ok(content.includes('Status: In progress'));
   });
 });
@@ -464,11 +465,11 @@ describe('parseProjectsMd', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('parses Active table rows into structured objects', () => {
     const content = `# Projects
@@ -484,7 +485,7 @@ describe('parseProjectsMd', () => {
 | Project | Completed | Duration |
 |---------|-----------|----------|
 `;
-    fs.writeFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), content);
+    fs.writeFileSync(path.join(tmpDir, 'PROJECTS.md'), content);
     const result = parseProjectsMd(tmpDir);
     assert.strictEqual(result.active.length, 1);
     assert.strictEqual(result.active[0].name, 'auth-overhaul');
@@ -507,7 +508,7 @@ describe('parseProjectsMd', () => {
 |---------|-----------|----------|
 | old-project | 2026-01-15 | 30 days |
 `;
-    fs.writeFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), content);
+    fs.writeFileSync(path.join(tmpDir, 'PROJECTS.md'), content);
     const result = parseProjectsMd(tmpDir);
     assert.strictEqual(result.completed.length, 1);
     assert.strictEqual(result.completed[0].name, 'old-project');
@@ -521,7 +522,7 @@ describe('parseProjectsMd', () => {
   });
 
   it('returns null if file does not start with # Projects', () => {
-    fs.writeFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), '# Not Projects\n');
+    fs.writeFileSync(path.join(tmpDir, 'PROJECTS.md'), '# Not Projects\n');
     const result = parseProjectsMd(tmpDir);
     assert.strictEqual(result, null);
   });
@@ -539,7 +540,7 @@ describe('parseProjectsMd', () => {
 | Project | Completed | Duration |
 |---------|-----------|----------|
 `;
-    fs.writeFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), content);
+    fs.writeFileSync(path.join(tmpDir, 'PROJECTS.md'), content);
     const result = parseProjectsMd(tmpDir);
     assert.strictEqual(result.active.length, 0);
     assert.strictEqual(result.completed.length, 0);
@@ -552,18 +553,18 @@ describe('createProjectSubfolder edge cases', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('includes initial_repos in PROJECT.md when provided', () => {
     createProjectSubfolder(tmpDir, 'my-proj', 'My Project', {
       initial_repos: 'web-app, server, shared-lib',
     });
     const content = fs.readFileSync(
-      path.join(tmpDir, '.planning', 'projects', 'my-proj', 'PROJECT.md'),
+      path.join(tmpDir, 'projects', 'my-proj', 'PROJECT.md'),
       'utf-8'
     );
     assert.ok(content.includes('## Initial Repos'));
@@ -573,7 +574,7 @@ describe('createProjectSubfolder edge cases', () => {
   it('STATE.md has 0% progress bar initially', () => {
     createProjectSubfolder(tmpDir, 'my-proj', 'My Project');
     const content = fs.readFileSync(
-      path.join(tmpDir, '.planning', 'projects', 'my-proj', 'STATE.md'),
+      path.join(tmpDir, 'projects', 'my-proj', 'STATE.md'),
       'utf-8'
     );
     assert.ok(content.includes('0%'));
@@ -584,11 +585,11 @@ describe('readProjectState edge cases', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('extracts multi-part Phase field', () => {
     createProjectManually(
@@ -617,11 +618,11 @@ describe('scanProjectReposTags edge cases', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('handles multiple <repos> tags in one plan file', () => {
     createProjectManually(tmpDir, 'proj', '# State\n');
@@ -654,18 +655,18 @@ describe('regenerateProjectsMd edge cases', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('handles mix of active and completed projects', () => {
     createProjectManually(tmpDir, 'active-proj', '# State\n\nPhase: 2\nStatus: In progress\n');
     createProjectManually(tmpDir, 'done-proj', '# State\n\nStatus: completed\nCompleted: 2026-01-15\n');
     const result = regenerateProjectsMd(tmpDir);
     assert.strictEqual(result.projects.length, 2);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'PROJECTS.md'), 'utf-8');
     const activeSection = content.split('## Completed')[0];
     const completedSection = content.split('## Completed')[1];
     assert.ok(activeSection.includes('active-proj'));
@@ -684,7 +685,7 @@ describe('regenerateProjectsMd edge cases', () => {
     createProjectManually(tmpDir, 'proj', '# State\n\nStatus: Active\nPhase: 1\n');
     createPlanFile(tmpDir, 'proj', '01-setup', '01-01-PLAN.md', '<repos>web-app, server</repos>\n');
     regenerateProjectsMd(tmpDir);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'PROJECTS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'PROJECTS.md'), 'utf-8');
     assert.ok(content.includes('server, web-app'));
   });
 });
@@ -693,17 +694,17 @@ describe('completeProject edge cases', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('preserves existing STATE.md content', () => {
     const original = '# Project State\n\n## Current Position\n\nPhase: 5 of 7\nStatus: In progress\nProgress: [████████░░] 80%\n\n## Decisions\n\n- Some important decision\n';
     createProjectManually(tmpDir, 'proj', original);
     completeProject(tmpDir, 'proj');
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'STATE.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'projects', 'proj', 'STATE.md'), 'utf-8');
     assert.ok(content.includes('# Project State'));
     assert.ok(content.includes('## Decisions'));
     assert.ok(content.includes('Some important decision'));
@@ -713,7 +714,7 @@ describe('completeProject edge cases', () => {
   it('overwrites existing Status line instead of adding duplicate', () => {
     createProjectManually(tmpDir, 'proj', '# State\n\nStatus: Active\n');
     completeProject(tmpDir, 'proj');
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'STATE.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'projects', 'proj', 'STATE.md'), 'utf-8');
     const statusCount = (content.match(/Status:/g) || []).length;
     assert.strictEqual(statusCount, 1);
   });
@@ -722,7 +723,7 @@ describe('completeProject edge cases', () => {
     const original = '# Project State\n\nStatus: completed\nCompleted: 2026-01-15\n';
     createProjectManually(tmpDir, 'proj', original);
     completeProject(tmpDir, 'proj');
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'projects', 'proj', 'STATE.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'projects', 'proj', 'STATE.md'), 'utf-8');
     assert.strictEqual(content, original);
   });
 
@@ -738,11 +739,11 @@ describe('roundtrip integration', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('create -> read -> regenerate -> parse produces consistent data', () => {
     // Create
@@ -822,11 +823,11 @@ describe('cmdProjectsSwitch guards', () => {
   let tmpDir;
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir);
     setupPlanning(tmpDir);
   });
 
-  afterEach(() => cleanupDir(tmpDir));
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('readProjectState detects completed status for cmdProjectsSwitch guard', () => {
     createProjectManually(tmpDir, 'completed-proj', '# Project State\n\nStatus: completed\nCompleted: 2026-02-20\n');
@@ -853,10 +854,10 @@ describe('cmdProjectsSwitch guards', () => {
   it('getProjectRoot throws PROJECT_COMPLETED for completed project (integration)', () => {
     // Set up a v2 fixture with completed project as current_project
     const fixture = createFixture({
-      '.planning/config.json': JSON.stringify({ current_project: 'finished-proj' }),
-      '.planning/PROJECTS.md': '# Projects\n\n## Active\n\n| Project | Status | Repos Touched | Current Phase |\n|---------|--------|---------------|---------------|\n\n## Completed\n\n| Project | Completed | Duration |\n|---------|-----------|----------|\n| finished-proj | 2026-02-20 | |\n',
-      '.planning/REPOS.md': '# Repos\n\n| Name | Path |\n',
-      '.planning/projects/finished-proj/STATE.md': '# Project State\n\nStatus: completed\nCompleted: 2026-02-20\n',
+      'config.json': JSON.stringify({ current_project: 'finished-proj' }),
+      'PROJECTS.md': '# Projects\n\n## Active\n\n| Project | Status | Repos Touched | Current Phase |\n|---------|--------|---------------|---------------|\n\n## Completed\n\n| Project | Completed | Duration |\n|---------|-----------|----------|\n| finished-proj | 2026-02-20 | |\n',
+      'REPOS.md': '# Repos\n\n| Name | Path |\n',
+      'projects/finished-proj/STATE.md': '# Project State\n\nStatus: completed\nCompleted: 2026-02-20\n',
     });
 
     try {