codebyplan 1.13.67 → 1.13.68

package/dist/cli/claude/generate.d.ts

@@ -16,7 +16,7 @@ export interface GenerateOpts {
     projectDir?: string;
     /** Print the would-be content to stdout, write nothing. */
     dryRun?: boolean;
-    /** Exit non-zero when AGENTS.md is missing or drifted. Read-only — writes nothing. */
+    /** Exit non-zero when AGENTS.md or structure.md is missing or drifted. Read-only — writes nothing. */
     check?: boolean;
 }
 export declare function runGenerate(opts: GenerateOpts | Record<string, unknown>): Promise<void>;

package/dist/cli/claude/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/claude/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyDD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CA4Of"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/claude/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sGAAsG;IACtG,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyDD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAiOf"}

package/dist/cli/claude/readme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readme.d.ts","sourceRoot":"","sources":["../../../src/cli/claude/readme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA4BH,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA4KD,wBAAsB,SAAS,CAC7B,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAkLf;AAmCD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBpE"}
+{"version":3,"file":"readme.d.ts","sourceRoot":"","sources":["../../../src/cli/claude/readme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA4BH,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA4ID,wBAAsB,SAAS,CAC7B,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAkLf;AAmCD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBpE"}

package/dist/cli.js

@@ -48,7 +48,7 @@ var VERSION, PACKAGE_NAME;
 var init_version = __esm({
   "src/lib/version.ts"() {
     "use strict";
-    VERSION = "1.13.67";
+    VERSION = "1.13.68";
     PACKAGE_NAME = "codebyplan";
   }
 });
@@ -41334,6 +41334,45 @@ var init_verify_parity2 = __esm({
   }
 });
 
+// src/lib/tech-stack-render.ts
+function buildTechStackDisplay(flat) {
+  const categoryMap = {};
+  for (const entry of flat) {
+    if (entry.name === SYNTHETIC_CARRIER_NAME) continue;
+    if (!categoryMap[entry.category]) {
+      categoryMap[entry.category] = [];
+    }
+    categoryMap[entry.category].push(entry.name);
+  }
+  if ((categoryMap["mobile"]?.length ?? 0) > 0) {
+    const frameworkEntries = categoryMap["framework"] ?? [];
+    const filtered = frameworkEntries.filter((n) => n !== "React");
+    if (filtered.length > 0) {
+      categoryMap["framework"] = filtered;
+    } else {
+      delete categoryMap["framework"];
+    }
+  }
+  const techStack = {};
+  for (const [cat, names] of Object.entries(categoryMap)) {
+    const label = CATEGORY_LABELS[cat] ?? cat.charAt(0).toUpperCase() + cat.slice(1);
+    techStack[label] = [...names].sort().join(" + ");
+  }
+  return { categoryMap, techStack };
+}
+var CATEGORY_LABELS;
+var init_tech_stack_render = __esm({
+  "src/lib/tech-stack-render.ts"() {
+    "use strict";
+    init_tech_detect();
+    CATEGORY_LABELS = {
+      "component-lib": "Component Library",
+      graphql: "GraphQL",
+      quality: "Code Quality"
+    };
+  }
+});
+
 // src/lib/structure-generator.ts
 function renderTechStack(techStack) {
   const entries = Object.entries(techStack).filter(([, value]) => value.trim().length > 0).sort(([a], [b]) => a.localeCompare(b));
@@ -41821,28 +41860,7 @@ async function runGenerate(opts) {
     });
   }
   const techResult = await detectTechStack(rootDir);
-  const CATEGORY_LABELS = {
-    "component-lib": "Component Library",
-    graphql: "GraphQL",
-    quality: "Code Quality"
-  };
-  const categoryMap = {};
-  for (const entry of techResult.flat) {
-    if (entry.name === SYNTHETIC_CARRIER_NAME) continue;
-    if (!categoryMap[entry.category]) {
-      categoryMap[entry.category] = [];
-    }
-    categoryMap[entry.category].push(entry.name);
-  }
-  if ((categoryMap["mobile"]?.length ?? 0) > 0) {
-    const frameworkEntries = categoryMap["framework"] ?? [];
-    const filtered = frameworkEntries.filter((n) => n !== "React");
-    if (filtered.length > 0) {
-      categoryMap["framework"] = filtered;
-    } else {
-      delete categoryMap["framework"];
-    }
-  }
+  const { categoryMap, techStack } = buildTechStackDisplay(techResult.flat);
   const hasNextjs = (categoryMap["framework"] ?? []).some(
     (n) => n.toLowerCase().includes("next")
   );
@@ -41850,11 +41868,6 @@ async function runGenerate(opts) {
     if (p.server_type === "nextjs" && !hasNextjs) return false;
     return true;
   });
-  const techStack = {};
-  for (const [cat, names] of Object.entries(categoryMap)) {
-    const label = CATEGORY_LABELS[cat] ?? cat.charAt(0).toUpperCase() + cat.slice(1);
-    techStack[label] = [...names].sort().join(" + ");
-  }
   const config = {
     techStack: Object.keys(techStack).length > 0 ? techStack : void 0,
     packageManager,
@@ -41889,6 +41902,25 @@ async function runGenerate(opts) {
 `);
       }
     }
+    const structurePath = join56(rootDir, ".claude", "generated", "structure.md");
+    let existingStructureCheck = null;
+    try {
+      existingStructureCheck = await readFile30(structurePath, "utf-8");
+    } catch {
+      existingStructureCheck = null;
+    }
+    if (existingStructureCheck === null) {
+      process.stdout.write(`structure.md missing
+`);
+      process.exitCode = 1;
+    } else if (existingStructureCheck !== structureMdContent) {
+      process.stdout.write(`structure.md drifted
+`);
+      process.exitCode = 1;
+    } else {
+      process.stdout.write(`.claude/generated/structure.md up to date
+`);
+    }
     return;
   }
   if (dryRun) {
@@ -41908,9 +41940,20 @@ async function runGenerate(opts) {
   const outputDir = join56(rootDir, ".claude", "generated");
   await mkdir14(outputDir, { recursive: true });
   const outputPath = join56(outputDir, "structure.md");
-  await writeFile20(outputPath, structureMdContent, "utf-8");
-  process.stdout.write(`Wrote: .claude/generated/structure.md
+  let existingStructure = null;
+  try {
+    existingStructure = await readFile30(outputPath, "utf-8");
+  } catch {
+    existingStructure = null;
+  }
+  if (existingStructure !== null && existingStructure === structureMdContent) {
+    process.stdout.write(`Up to date: .claude/generated/structure.md
+`);
+  } else {
+    await writeFile20(outputPath, structureMdContent, "utf-8");
+    process.stdout.write(`Wrote: .claude/generated/structure.md
 `);
+  }
   const agentsMdPath = join56(rootDir, "AGENTS.md");
   let existingAgentsContent = null;
   try {
@@ -41931,6 +41974,7 @@ var init_generate = __esm({
   "src/cli/claude/generate.ts"() {
     "use strict";
     init_tech_detect();
+    init_tech_stack_render();
     init_structure_generator();
     init_agents_generator();
   }
@@ -41956,34 +42000,9 @@ async function buildConfig(absPath, isRoot, allPackages, rootPkgJson, pkgJson) {
   let techStack;
   try {
     const techResult = await detectTechStack(absPath);
-    const CATEGORY_LABELS = {
-      "component-lib": "Component Library",
-      graphql: "GraphQL",
-      quality: "Code Quality"
-    };
-    const categoryMap = {};
-    for (const entry of techResult.flat) {
-      if (entry.name === SYNTHETIC_CARRIER_NAME) continue;
-      if (!categoryMap[entry.category]) {
-        categoryMap[entry.category] = [];
-      }
-      categoryMap[entry.category].push(entry.name);
-    }
-    if ((categoryMap["mobile"]?.length ?? 0) > 0) {
-      const frameworkEntries = categoryMap["framework"] ?? [];
-      const filtered = frameworkEntries.filter((n) => n !== "React");
-      if (filtered.length > 0) {
-        categoryMap["framework"] = filtered;
-      } else {
-        delete categoryMap["framework"];
-      }
-    }
-    if (Object.keys(categoryMap).length > 0) {
-      techStack = {};
-      for (const [cat, names] of Object.entries(categoryMap)) {
-        const label = CATEGORY_LABELS[cat] ?? cat.charAt(0).toUpperCase() + cat.slice(1);
-        techStack[label] = [...names].sort().join(" + ");
-      }
+    const { techStack: ts } = buildTechStackDisplay(techResult.flat);
+    if (Object.keys(ts).length > 0) {
+      techStack = ts;
     }
   } catch {
   }
@@ -42218,6 +42237,7 @@ var init_readme = __esm({
   "src/cli/claude/readme.ts"() {
     "use strict";
     init_tech_detect();
+    init_tech_stack_render();
     init_readme_generator();
   }
 });

package/dist/lib/tech-stack-render.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Pure, I/O-free helper for rendering a flat TechStackEntry[] into the
+ * display structures used by `codebyplan claude generate` and
+ * `codebyplan claude readme`.
+ *
+ * Both callers previously contained identical copies of this logic.
+ * Extracted here so changes propagate uniformly and the logic can be
+ * unit-tested in isolation.
+ */
+import type { TechStackEntry } from "./types.js";
+/** Human-readable labels for multi-word category keys. */
+export declare const CATEGORY_LABELS: Record<string, string>;
+export interface TechStackRenderResult {
+    /** Per-category name lists, post-F5 mobile guard. */
+    categoryMap: Record<string, string[]>;
+    /** Display-ready map: label → sorted joined names (e.g. "Framework" → "Next.js + React"). */
+    techStack: Record<string, string>;
+}
+/**
+ * Build category and display maps from a flat TechStackEntry array.
+ *
+ * Behaviour:
+ *  1. Iterates `flat`, skipping entries where `entry.name === SYNTHETIC_CARRIER_NAME`.
+ *  2. F5 mobile guard: when `categoryMap["mobile"]` is non-empty, strips "React"
+ *     from `categoryMap["framework"]`; deletes the key entirely if that leaves it empty.
+ *  3. Builds `techStack` by joining sorted names per category under a human-readable label.
+ *  4. Empty input → `{ categoryMap: {}, techStack: {} }`.
+ */
+export declare function buildTechStackDisplay(flat: TechStackEntry[]): TechStackRenderResult;
+//# sourceMappingURL=tech-stack-render.d.ts.map

package/dist/lib/tech-stack-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-stack-render.d.ts","sourceRoot":"","sources":["../../src/lib/tech-stack-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,0DAA0D;AAC1D,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIlD,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EAAE,GACrB,qBAAqB,CAgCvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codebyplan",
-  "version": "1.13.67",
+  "version": "1.13.68",
   "description": "CLI for CodeByPlan — AI-powered development planning and tracking",
   "type": "module",
   "bin": {