@ktpartners/dgs-platform 2.7.5 → 2.8.0

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

@@ -8,13 +8,12 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-const { createTempDir, cleanupDir } = require('./test-helpers.cjs');
+const { createTempDir, cleanupDir , initGitRepo } = require('./test-helpers.cjs');
+const { resetPaths } = require('./paths.cjs');
 
-// Helper to create .planning/REPOS.md with given content
+// Helper to create REPOS.md with given content at root
 function writeReposFile(cwd, content) {
-  const planningDir = path.join(cwd, '.planning');
-  fs.mkdirSync(planningDir, { recursive: true });
-  fs.writeFileSync(path.join(planningDir, 'REPOS.md'), content);
+  fs.writeFileSync(path.join(cwd, 'REPOS.md'), content);
 }
 
 const VALID_REPOS_MD = `# Repos
@@ -45,8 +44,8 @@ const {
 
 describe('parseReposMd', () => {
   let tmpDir;
-  beforeEach(() => { tmpDir = createTempDir(); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('returns structured array from valid REPOS.md', () => {
     writeReposFile(tmpDir, VALID_REPOS_MD);
@@ -60,7 +59,7 @@ describe('parseReposMd', () => {
   });
 
   it('returns null when file does not exist', () => {
-    fs.mkdirSync(path.join(tmpDir, '.planning'), { recursive: true });
+    
     const result = parseReposMd(tmpDir);
     assert.strictEqual(result, null);
   });
@@ -147,18 +146,18 @@ Registered repositories.
 
 describe('writeReposMd', () => {
   let tmpDir;
-  beforeEach(() => { tmpDir = createTempDir(); fs.mkdirSync(path.join(tmpDir, '.planning'), { recursive: true }); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('creates file with # Repos header', () => {
     writeReposMd(tmpDir, [{ name: 'app', path: './app', url: '', description: 'App' }]);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'REPOS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'REPOS.md'), 'utf-8');
     assert.ok(content.startsWith('# Repos'));
   });
 
   it('includes explanatory text', () => {
     writeReposMd(tmpDir, []);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'REPOS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'REPOS.md'), 'utf-8');
     assert.ok(content.includes('Managed by DGS'));
   });
 
@@ -166,7 +165,7 @@ describe('writeReposMd', () => {
     writeReposMd(tmpDir, [
       { name: 'web', path: './web', url: 'https://github.com/org/web', description: 'Frontend' },
     ]);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'REPOS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'REPOS.md'), 'utf-8');
     assert.ok(content.includes('| Name | Path | GitHub URL | Description |'));
     assert.ok(content.includes('|------|------|------------|-------------|'));
     assert.ok(content.includes('| web | ./web | https://github.com/org/web | Frontend |'));
@@ -174,16 +173,16 @@ describe('writeReposMd', () => {
 
   it('handles empty repos array', () => {
     writeReposMd(tmpDir, []);
-    const content = fs.readFileSync(path.join(tmpDir, '.planning', 'REPOS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(tmpDir, 'REPOS.md'), 'utf-8');
     assert.ok(content.includes('| Name | Path | GitHub URL | Description |'));
     // Should NOT have any data rows
     const lines = content.split('\n').filter(l => l.startsWith('|'));
     assert.strictEqual(lines.length, 2); // header + separator only
   });
 
-  it('writes to .planning/REPOS.md', () => {
+  it('writes REPOS.md at root', () => {
     writeReposMd(tmpDir, []);
-    assert.ok(fs.existsSync(path.join(tmpDir, '.planning', 'REPOS.md')));
+    assert.ok(fs.existsSync(path.join(tmpDir, 'REPOS.md')));
   });
 });
 
@@ -227,8 +226,8 @@ describe('resolveFileToRepo', () => {
     assert.strictEqual(result, null);
   });
 
-  it('returns null for .planning/STATE.md', () => {
-    const result = resolveFileToRepo('.planning/STATE.md', repos);
+  it('returns null for STATE.md', () => {
+    const result = resolveFileToRepo('STATE.md', repos);
     assert.strictEqual(result, null);
   });
 
@@ -281,8 +280,8 @@ describe('resolveFileToRepo', () => {
 
 describe('discoverRepos', () => {
   let tmpDir;
-  beforeEach(() => { tmpDir = createTempDir(); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('finds directories containing .git/', () => {
     fs.mkdirSync(path.join(tmpDir, 'my-repo', '.git'), { recursive: true });
@@ -299,8 +298,8 @@ describe('discoverRepos', () => {
     assert.strictEqual(result[0].name, 'real-repo');
   });
 
-  it('excludes .planning', () => {
-    fs.mkdirSync(path.join(tmpDir, '.planning', '.git'), { recursive: true });
+  it('excludes system directories', () => {
+    fs.mkdirSync(path.join(tmpDir, '.git'), { recursive: true });
     const result = discoverRepos(tmpDir);
     assert.strictEqual(result.length, 0);
   });
@@ -361,8 +360,8 @@ describe('discoverRepos', () => {
 
 describe('discoverSiblingRepos', () => {
   let tmpDir;
-  beforeEach(() => { tmpDir = createTempDir(); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('finds sibling directories containing .git/', () => {
     // tmpDir acts as parent; product-root and sibling-repo are siblings
@@ -427,8 +426,8 @@ describe('discoverSiblingRepos', () => {
 
 describe('syncGitignore', () => {
   let tmpDir;
-  beforeEach(() => { tmpDir = createTempDir(); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('creates .gitignore with DGS section when file does not exist', () => {
     syncGitignore(tmpDir, ['./web-app', './server']);
@@ -515,8 +514,8 @@ describe('syncGitignore', () => {
 
 describe('validateRepoPaths', () => {
   let tmpDir;
-  beforeEach(() => { tmpDir = createTempDir(); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('returns valid and missing arrays', () => {
     fs.mkdirSync(path.join(tmpDir, 'existing'));
@@ -589,25 +588,25 @@ describe('hasPathConflict', () => {
 
 describe('writeProjectsMd', () => {
   let tmpDir;
-  beforeEach(() => { tmpDir = createTempDir(); fs.mkdirSync(path.join(tmpDir, '.planning'), { recursive: true }); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('creates file with # Projects header', () => {
     writeProjectsMd(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'));
   });
 
   it('includes Active and Completed sections', () => {
     writeProjectsMd(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('## Active'));
     assert.ok(content.includes('## Completed'));
   });
 
-  it('writes to .planning/PROJECTS.md', () => {
+  it('writes PROJECTS.md at root', () => {
     writeProjectsMd(tmpDir, []);
-    assert.ok(fs.existsSync(path.join(tmpDir, '.planning', 'PROJECTS.md')));
+    assert.ok(fs.existsSync(path.join(tmpDir, 'PROJECTS.md')));
   });
 });
 
@@ -615,8 +614,8 @@ describe('writeProjectsMd', () => {
 
 describe('writeReposMd -> parseReposMd roundtrip', () => {
   let tmpDir;
-  beforeEach(() => { tmpDir = createTempDir(); fs.mkdirSync(path.join(tmpDir, '.planning'), { recursive: true }); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('write then parse produces identical data', () => {
     const repos = [
@@ -1379,10 +1378,12 @@ describe('cmdReposAdd ../name format enforcement', () => {
   const { execSync } = require('child_process');
 
   beforeEach(() => {
-    tmpDir = createTempDir();
-    // Create a flat layout: product-root with .planning, and sibling repos
+    resetPaths();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir);
+    // Create a flat layout: product-root with its own git repo and sibling repos
     const productRoot = path.join(tmpDir, 'product-root');
-    fs.mkdirSync(path.join(productRoot, '.planning'), { recursive: true });
+    fs.mkdirSync(productRoot, { recursive: true });
+    initGitRepo(productRoot);
     // Write initial REPOS.md
     const reposMd = `# Repos
 
@@ -1391,7 +1392,8 @@ Registered repositories for this product. Managed by DGS — manual edits may be
 | Name | Path | GitHub URL | Description |
 |------|------|------------|-------------|
 `;
-    fs.writeFileSync(path.join(productRoot, '.planning', 'REPOS.md'), reposMd);
+    fs.writeFileSync(path.join(productRoot, 'REPOS.md'), reposMd);
+    execSync('git add REPOS.md && git commit -m "add repos"', { cwd: productRoot, stdio: 'pipe' });
     // Create sibling repo with .git
     const siblingRepo = path.join(tmpDir, 'my-repo');
     fs.mkdirSync(path.join(siblingRepo, '.git'), { recursive: true });
@@ -1399,7 +1401,7 @@ Registered repositories for this product. Managed by DGS — manual edits may be
     const noGitRepo = path.join(tmpDir, 'no-git-repo');
     fs.mkdirSync(noGitRepo, { recursive: true });
   });
-  afterEach(() => { cleanupDir(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   // Helper to test cmdReposAdd via subprocess (it calls error() which does process.exit)
   function runCmdReposAdd(cwd, repoPath, opts) {
@@ -1491,9 +1493,11 @@ describe('cmdReposAdd trailing slash normalization', () => {
   const { execSync } = require('child_process');
 
   beforeEach(() => {
-    tmpDir = createTempDir();
+    resetPaths();
+    tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir);
     const productRoot = path.join(tmpDir, 'product-root');
-    fs.mkdirSync(path.join(productRoot, '.planning'), { recursive: true });
+    fs.mkdirSync(productRoot, { recursive: true });
+    initGitRepo(productRoot);
     const reposMd = `# Repos
 
 Registered repositories for this product. Managed by DGS — manual edits may be overwritten.
@@ -1501,12 +1505,13 @@ Registered repositories for this product. Managed by DGS — manual edits may be
 | Name | Path | GitHub URL | Description |
 |------|------|------------|-------------|
 `;
-    fs.writeFileSync(path.join(productRoot, '.planning', 'REPOS.md'), reposMd);
+    fs.writeFileSync(path.join(productRoot, 'REPOS.md'), reposMd);
+    execSync('git add REPOS.md && git commit -m "add repos"', { cwd: productRoot, stdio: 'pipe' });
     // Create sibling repo with .git
     const siblingRepo = path.join(tmpDir, 'sibling-repo');
     fs.mkdirSync(path.join(siblingRepo, '.git'), { recursive: true });
   });
-  afterEach(() => { cleanupDir(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   function runCmdReposAdd(cwd, repoPath, opts) {
     const reposPath = require.resolve('./repos.cjs');
@@ -1541,7 +1546,7 @@ Registered repositories for this product. Managed by DGS — manual edits may be
   }
 
   function getStoredPath(productRoot) {
-    const content = fs.readFileSync(path.join(productRoot, '.planning', 'REPOS.md'), 'utf-8');
+    const content = fs.readFileSync(path.join(productRoot, 'REPOS.md'), 'utf-8');
     const lines = content.split('\n').filter(l => l.startsWith('|') && !l.includes('---') && !l.includes('Name'));
     if (lines.length === 0) return null;
     const cols = lines[0].split('|').map(c => c.trim()).filter(Boolean);
@@ -1577,12 +1582,13 @@ Registered repositories for this product. Managed by DGS — manual edits may be
 
 describe('validateReposMdEager', () => {
   let tmpDir;
-  beforeEach(() => { tmpDir = createTempDir(); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { resetPaths(); tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   function setupFlatLayout(tmpDir, entries) {
     const productRoot = path.join(tmpDir, 'product-root');
-    fs.mkdirSync(path.join(productRoot, '.planning'), { recursive: true });
+    fs.mkdirSync(productRoot, { recursive: true });
+    initGitRepo(productRoot);
 
     let reposMd = `# Repos
 
@@ -1600,7 +1606,7 @@ Registered repositories for this product. Managed by DGS — manual edits may be
         fs.mkdirSync(path.join(tmpDir, entry.name, '.git'), { recursive: true });
       }
     }
-    fs.writeFileSync(path.join(productRoot, '.planning', 'REPOS.md'), reposMd);
+    fs.writeFileSync(path.join(productRoot, 'REPOS.md'), reposMd);
     return productRoot;
   }
 
@@ -1627,7 +1633,9 @@ Registered repositories for this product. Managed by DGS — manual edits may be
     const repoDir = path.join(tmpDir, 'shared');
     fs.mkdirSync(path.join(repoDir, '.git'), { recursive: true });
     const productRoot = path.join(tmpDir, 'product-root');
-    fs.mkdirSync(path.join(productRoot, '.planning'), { recursive: true });
+    fs.mkdirSync(productRoot, { recursive: true });
+    initGitRepo(productRoot);
+    resetPaths();
 
     const reposMd = `# Repos
 
@@ -1638,7 +1646,7 @@ Registered repositories for this product. Managed by DGS — manual edits may be
 | shared-a | ../shared | | First ref |
 | shared-b | ../shared | | Duplicate ref |
 `;
-    fs.writeFileSync(path.join(productRoot, '.planning', 'REPOS.md'), reposMd);
+    fs.writeFileSync(path.join(productRoot, 'REPOS.md'), reposMd);
     const result = validateReposMdEager(productRoot);
     assert.ok(result.errors.length > 0);
     assert.ok(result.errors[0].includes('Duplicate path'));
@@ -1656,7 +1664,9 @@ Registered repositories for this product. Managed by DGS — manual edits may be
 
   it('rejects ./repo path format', () => {
     const productRoot = path.join(tmpDir, 'product-root');
-    fs.mkdirSync(path.join(productRoot, '.planning'), { recursive: true });
+    fs.mkdirSync(productRoot, { recursive: true });
+    initGitRepo(productRoot);
+    resetPaths();
     fs.mkdirSync(path.join(productRoot, 'local-repo', '.git'), { recursive: true });
 
     const reposMd = `# Repos
@@ -1665,7 +1675,7 @@ Registered repositories for this product. Managed by DGS — manual edits may be
 |------|------|------------|-------------|
 | local-repo | ./local-repo | | Local repo |
 `;
-    fs.writeFileSync(path.join(productRoot, '.planning', 'REPOS.md'), reposMd);
+    fs.writeFileSync(path.join(productRoot, 'REPOS.md'), reposMd);
     const result = validateReposMdEager(productRoot);
     assert.ok(result.errors.length > 0);
     assert.ok(result.errors[0].includes('Repo paths must use ../name format'));
@@ -1676,8 +1686,8 @@ Registered repositories for this product. Managed by DGS — manual edits may be
 
 describe('validateRepoPaths with ../repo paths', () => {
   let tmpDir;
-  beforeEach(() => { tmpDir = createTempDir(); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); initGitRepo(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
   it('validates ../repo paths that exist on disk', () => {
     const productRoot = path.join(tmpDir, 'product-root');
@@ -1707,15 +1717,15 @@ describe('syncGitignore skip for flat layout', () => {
   let tmpDir;
   const { execSync } = require('child_process');
 
-  beforeEach(() => { tmpDir = createTempDir(); });
-  afterEach(() => { cleanupDir(tmpDir); });
+  beforeEach(() => { resetPaths(); tmpDir = createTempDir(); tmpDir = fs.realpathSync(tmpDir); });
+  afterEach(() => { resetPaths(); cleanupDir(tmpDir); });
 
-  it('cmdReposInitProduct with no local repos does NOT create .gitignore DGS section', () => {
-    // Set up a product root with no subdirectory repos (flat layout)
-    // discoverRepos will find nothing -> localPaths is empty -> syncGitignore not called
+  it('cmdReposInitProduct creates root layout with .gitignore', () => {
+    // Set up a product root with its own git repo (root layout)
     const productRoot = path.join(tmpDir, 'product-root');
-    fs.mkdirSync(path.join(productRoot, '.planning'), { recursive: true });
-    // Create sibling repos (outside product root — discoverRepos won't find them)
+    fs.mkdirSync(productRoot, { recursive: true });
+    initGitRepo(productRoot);
+    // Create sibling repos (outside product root -- discoverRepos won't find them)
     fs.mkdirSync(path.join(tmpDir, 'sibling-app', '.git'), { recursive: true });
 
     const reposPath = require.resolve('./repos.cjs');
@@ -1745,20 +1755,18 @@ describe('syncGitignore skip for flat layout', () => {
     }).trim();
     const parsed = JSON.parse(result);
     assert.strictEqual(parsed.initialized, true);
-    assert.strictEqual(parsed.gitignore_synced, false);
+    assert.strictEqual(parsed.layout, 'root');
 
-    // .gitignore should not exist or should not contain DGS markers
+    // .gitignore should exist with root-layout DGS markers
     const gitignorePath = path.join(productRoot, '.gitignore');
-    if (fs.existsSync(gitignorePath)) {
-      const content = fs.readFileSync(gitignorePath, 'utf-8');
-      assert.ok(!content.includes('# DGS managed repos'), '.gitignore should not contain DGS markers');
-    }
+    assert.ok(fs.existsSync(gitignorePath), '.gitignore should exist');
   });
 
   it('cmdReposAdd with ../path does NOT modify .gitignore', () => {
-    // Set up product root with REPOS.md and a sibling repo
+    // Set up product root with its own git repo and a sibling repo
     const productRoot = path.join(tmpDir, 'product-root');
-    fs.mkdirSync(path.join(productRoot, '.planning'), { recursive: true });
+    fs.mkdirSync(productRoot, { recursive: true });
+    initGitRepo(productRoot);
     const reposMd = `# Repos
 
 Registered repositories for this product. Managed by DGS — manual edits may be overwritten.
@@ -1766,7 +1774,7 @@ Registered repositories for this product. Managed by DGS — manual edits may be
 | Name | Path | GitHub URL | Description |
 |------|------|------------|-------------|
 `;
-    fs.writeFileSync(path.join(productRoot, '.planning', 'REPOS.md'), reposMd);
+    fs.writeFileSync(path.join(productRoot, 'REPOS.md'), reposMd);
     // Create sibling repo with .git
     fs.mkdirSync(path.join(tmpDir, 'sibling-repo', '.git'), { recursive: true });
 
@@ -1803,9 +1811,10 @@ Registered repositories for this product. Managed by DGS — manual edits may be
   });
 
   it('cmdReposRemove with ../path does NOT modify .gitignore', () => {
-    // Set up product root with REPOS.md containing a ../repo entry
+    // Set up product root with its own git repo and REPOS.md containing a ../repo entry
     const productRoot = path.join(tmpDir, 'product-root');
-    fs.mkdirSync(path.join(productRoot, '.planning'), { recursive: true });
+    fs.mkdirSync(productRoot, { recursive: true });
+    initGitRepo(productRoot);
     const reposMd = `# Repos
 
 Registered repositories for this product. Managed by DGS — manual edits may be overwritten.
@@ -1814,7 +1823,7 @@ Registered repositories for this product. Managed by DGS — manual edits may be
 |------|------|------------|-------------|
 | sibling-repo | ../sibling-repo | | Test repo |
 `;
-    fs.writeFileSync(path.join(productRoot, '.planning', 'REPOS.md'), reposMd);
+    fs.writeFileSync(path.join(productRoot, 'REPOS.md'), reposMd);
     // Create sibling repo with .git
     fs.mkdirSync(path.join(tmpDir, 'sibling-repo', '.git'), { recursive: true });
 

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

@@ -161,7 +161,7 @@ function parseFrontmatter(content) {
 
 /**
  * Scan ideas directories for searchable idea files.
- * Scans .planning/ideas/{pending,done,rejected}/ for .md files.
+ * Scans ideas/{pending,done,rejected}/ for .md files.
  *
  * @param {string} cwd - Working directory
  * @param {object} options - { include_rejected, tags }
@@ -218,7 +218,7 @@ function scanIdeas(cwd, options) {
 
 /**
  * Scan specs directory for searchable spec files.
- * Scans .planning/specs/ for .md files.
+ * Scans specs/ for .md files.
  *
  * @param {string} cwd - Working directory
  * @returns {Array<{ type: string, id: string, title: string, filePath: string, status: string, author: string, content: string }>}
@@ -258,8 +258,8 @@ function scanSpecs(cwd) {
 
 /**
  * Scan docs directories for searchable documents.
- * Scans .planning/docs/ (product), .planning/ideas/star/docs/ (idea-scoped),
- * .planning/specs/star/docs/ (spec-scoped).
+ * Scans docs/ (product), ideas/{state}/{idea-slug}/docs/ (idea-scoped),
+ * specs/{spec-slug}/docs/ (spec-scoped).
  * Uses .extracted.txt sidecars when available.
  *
  * @param {string} cwd - Working directory

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

@@ -4,7 +4,7 @@
  * Provides the data model and operations for the spec lifecycle:
  * create, list, update-status, append-review-history, and finalize.
  * Specs are stored as markdown files with YAML frontmatter in
- * .planning/specs/ (flat directory, no subdirectories).
+ * specs/ (flat directory, no subdirectories).
  */
 
 const fs = require('fs');
@@ -32,7 +32,7 @@ function normalizeStatus(status) {
 }
 
 /**
- * Ensure .planning/specs/ directory exists.
+ * Ensure specs/ directory exists.
  *
  * @param {string} cwd - Working directory
  */

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

@@ -140,7 +140,7 @@ function classifyError(result, operation, repoName, repoPath) {
 function collectSyncRepos(cwd) {
   const repos = [];
 
-  // First entry: the planning repo itself (cwd is the product root containing .planning/)
+  // First entry: the planning repo itself (cwd is the product root)
   const resolvedCwd = path.resolve(cwd);
   const basename = path.basename(resolvedCwd);
 

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

@@ -144,9 +144,9 @@ function cmdTemplateFill(cwd, templateType, options, raw) {
         '- **Output:** [Concrete deliverable]',
         '',
         '## Context',
-        '@.planning/PROJECT.md',
-        '@.planning/ROADMAP.md',
-        '@.planning/STATE.md',
+        '@PROJECT.md',
+        '@ROADMAP.md',
+        '@STATE.md',
         '',
         '## Tasks',
         '',