@ktpartners/dgs-platform 2.9.0 → 3.3.0

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

@@ -63,6 +63,7 @@ function parseReposMd(cwd) {
       path: cells[2] || '',
       url: cells[3] || '',
       description: cells[4] || '',
+      setup: (cells[5] || '').trim(),
     });
   }
 
@@ -1100,38 +1101,40 @@ function cmdReposInitProduct(cwd, options, raw) {
   // Check if already initialized (idempotency)
   if (isV2Install(cwd)) {
     // Silently ensure v3.0 directories exist (backfill for upgrades)
-    const ideasStates = ['pending', 'rejected', 'done'];
-    for (const st of ideasStates) {
-      fs.mkdirSync(path.join(getPlanningRoot(cwd), 'ideas', st), { recursive: true });
-    }
     fs.mkdirSync(path.join(getPlanningRoot(cwd), 'specs'), { recursive: true });
     fs.mkdirSync(path.join(getPlanningRoot(cwd), 'docs', 'product'), { recursive: true });
+    fs.mkdirSync(path.join(getPlanningRoot(cwd), 'quick'), { recursive: true });
     error('Product already initialized. Use /dgs:progress to see status.');
   }
 
   // Planning root is cwd (root layout)
   fs.mkdirSync(getPlanningRoot(cwd), { recursive: true });
 
-  // Create ideas, specs, and docs directories for v3.0 features
-  const ideasStates = ['pending', 'rejected', 'done'];
-  for (const state of ideasStates) {
-    fs.mkdirSync(path.join(getPlanningRoot(cwd), 'ideas', state), { recursive: true });
-  }
+  // Create specs and docs directories for v3.0 features
+  // (ideas/ is created on demand by `dgs-tools ideas create`; flat-status frontmatter replaces directory-based state per idea #009)
   fs.mkdirSync(path.join(getPlanningRoot(cwd), 'specs'), { recursive: true });
   fs.mkdirSync(path.join(getPlanningRoot(cwd), 'docs', 'product'), { recursive: true });
+  fs.mkdirSync(path.join(getPlanningRoot(cwd), 'quick'), { recursive: true });
 
   // Add .gitkeep files to empty directories so they survive git commit
   const gitkeepPaths = [
-    path.join(getPlanningRoot(cwd), 'ideas', 'pending', '.gitkeep'),
-    path.join(getPlanningRoot(cwd), 'ideas', 'rejected', '.gitkeep'),
-    path.join(getPlanningRoot(cwd), 'ideas', 'done', '.gitkeep'),
     path.join(getPlanningRoot(cwd), 'specs', '.gitkeep'),
     path.join(getPlanningRoot(cwd), 'docs', 'product', '.gitkeep'),
+    path.join(getPlanningRoot(cwd), 'quick', '.gitkeep'),
   ];
+  // AGENT-13 contract: scaffolded_files lists all files this command writes/guarantees,
+  // derived from actual write list (never hardcoded). Workflows MUST consume this array
+  // and pass it to a subsequent commit step's --files argument. See
+  // references/workflow-conventions.md and references/agent-step-reliability.md.
+  const scaffoldedFiles = [];
   for (const gk of gitkeepPaths) {
     if (!fs.existsSync(gk)) {
       fs.writeFileSync(gk, '', 'utf-8');
     }
+    // Always include in scaffolded_files: contract is "files this command guarantees on
+    // disk that the caller MUST commit", not "files this run newly created" — fresh
+    // clones need them tracked even if a previous local run already wrote them.
+    scaffoldedFiles.push(path.relative(cwd, gk));
   }
 
   // Scaffold review-keys.json with empty template
@@ -1150,6 +1153,25 @@ function cmdReposInitProduct(cwd, options, raw) {
   const siblingRepos = discoverSiblingRepos(cwd);
   const allRepos = [...discoveredRepos, ...siblingRepos];
 
+  // Bootstrap empty code repos so git worktree creation works later.
+  // git worktree add requires at least one commit (a HEAD to branch from).
+  const bootstrappedRepos = [];
+  for (const repo of allRepos) {
+    const repoPath = path.resolve(cwd, repo.path);
+    if (!fs.existsSync(path.join(repoPath, '.git'))) continue;
+    const logResult = execGit(repoPath, ['rev-parse', 'HEAD']);
+    if (logResult.exitCode !== 0) {
+      // Empty repo — no commits yet
+      const readmePath = path.join(repoPath, 'README.md');
+      if (!fs.existsSync(readmePath)) {
+        fs.writeFileSync(readmePath, `# ${repo.name}\n`, 'utf-8');
+      }
+      execGit(repoPath, ['add', 'README.md']);
+      execGit(repoPath, ['commit', '-m', 'chore: initial commit']);
+      bootstrappedRepos.push(repo.name);
+    }
+  }
+
   // Derive product name
   const productName = options.productName || path.basename(cwd);
 
@@ -1178,7 +1200,9 @@ function cmdReposInitProduct(cwd, options, raw) {
     ideas_dirs_created: true,
     specs_dir_created: true,
     docs_dir_created: true,
-    files_created: ['config.json', 'config.local.json', 'REPOS.md', 'PROJECTS.md', 'ideas/', 'specs/', 'docs/', '.gitignore', 'review-keys.json'],
+    bootstrapped_repos: bootstrappedRepos,
+    files_created: ['config.json', 'config.local.json', 'REPOS.md', 'PROJECTS.md', 'ideas/', 'specs/', 'docs/', 'quick/', '.gitignore', 'review-keys.json'],
+    scaffolded_files: scaffoldedFiles,
   }, raw);
 }