prjct-cli 0.47.0 → 0.48.0

package/dist/bin/prjct.mjs

@@ -5863,7 +5863,7 @@ function formatSubtaskLine(index, subtask, spinnerFrame = "\u25B6") {
   const num = `${DIM2}${String(index + 1).padStart(2)}${RESET2}`;
   const domainColor = getDomainColor(subtask.domain);
   const domain = `${domainColor}${subtask.domain.padEnd(10)}${RESET2}`;
-  const desc = subtask.description.length > 32 ? subtask.description.slice(0, 29) + "..." : subtask.description.padEnd(32);
+  const desc = subtask.description.length > 32 ? `${subtask.description.slice(0, 29)}...` : subtask.description.padEnd(32);
   let status;
   switch (subtask.status) {
     case "completed":
@@ -8755,7 +8755,9 @@ var init_memory_system = __esm({
           const matchingIds = /* @__PURE__ */ new Set();
           for (const tag of parsedTags) {
             const ids = db.index[tag];
-            ids.forEach((id) => matchingIds.add(id));
+            for (const id of ids) {
+              matchingIds.add(id);
+            }
           }
           return db.memories.filter((m) => matchingIds.has(m.id));
         }
@@ -9986,14 +9988,18 @@ var init_markdown_builder = __esm({
        * Add multiple list items
        */
       list(items, options) {
-        items.forEach((item) => this.li(item, options));
+        for (const item of items) {
+          this.li(item, options);
+        }
         return this;
       }
       /**
        * Add multiple numbered list items
        */
       orderedList(items) {
-        items.forEach((item, i) => this.oli(item, i + 1));
+        for (let i = 0; i < items.length; i++) {
+          this.oli(items[i], i + 1);
+        }
         return this;
       }
       /**
@@ -10079,7 +10085,9 @@ var init_markdown_builder = __esm({
        * Iterate and build for each item
        */
       each(items, builder) {
-        items.forEach((item, i) => builder(this, item, i));
+        for (let i = 0; i < items.length; i++) {
+          builder(this, items[i], i);
+        }
         return this;
       }
       /**
@@ -12415,12 +12423,16 @@ Stack: ${stack}
           parts.push("\n## THINK FIRST (reasoning from analysis)\n");
           if (thinkBlock.conclusions && thinkBlock.conclusions.length > 0) {
             parts.push("Conclusions:\n");
-            thinkBlock.conclusions.forEach((c) => parts.push(`  \u2192 ${c}
-`));
+            for (const c of thinkBlock.conclusions) {
+              parts.push(`  \u2192 ${c}
+`);
+            }
           }
           parts.push("Plan:\n");
-          thinkBlock.plan.forEach((p, i) => parts.push(`  ${i + 1}. ${p}
-`));
+          for (let i = 0; i < thinkBlock.plan.length; i++) {
+            parts.push(`  ${i + 1}. ${thinkBlock.plan[i]}
+`);
+          }
           parts.push(`Confidence: ${Math.round((thinkBlock.confidence || 0.5) * 100)}%
 `);
         }
@@ -13378,10 +13390,100 @@ var init_update_checker = __esm({
   }
 });
 
+// core/utils/preserve-sections.ts
+function createPreserveStartRegex() {
+  return /<!-- prjct:preserve(?::([\w-]+))? -->/g;
+}
+function extractPreservedSections(content) {
+  const sections = [];
+  const regex = createPreserveStartRegex();
+  let match;
+  let sectionIndex = 0;
+  while ((match = regex.exec(content)) !== null) {
+    const startIndex = match.index;
+    const startTag = match[0];
+    const sectionId = match[1] || `section-${sectionIndex++}`;
+    const endTagStart = content.indexOf(PRESERVE_END_PATTERN, startIndex + startTag.length);
+    if (endTagStart === -1) {
+      continue;
+    }
+    const endIndex = endTagStart + PRESERVE_END_PATTERN.length;
+    const fullContent = content.substring(startIndex, endIndex);
+    sections.push({
+      id: sectionId,
+      content: fullContent,
+      startIndex,
+      endIndex
+    });
+  }
+  return sections;
+}
+function mergePreservedSections(newContent, oldContent) {
+  const preservedSections = extractPreservedSections(oldContent);
+  if (preservedSections.length === 0) {
+    return newContent;
+  }
+  let merged = newContent.trimEnd();
+  merged += "\n\n---\n\n";
+  merged += "## Your Customizations\n\n";
+  merged += "_The sections below are preserved during sync. Edit freely._\n\n";
+  for (const section of preservedSections) {
+    merged += section.content;
+    merged += "\n\n";
+  }
+  return `${merged.trimEnd()}
+`;
+}
+function validatePreserveBlocks(content) {
+  const errors = [];
+  const startMatches = content.match(/<!-- prjct:preserve(?::\w+)? -->/g) || [];
+  const endMatches = content.match(/<!-- \/prjct:preserve -->/g) || [];
+  if (startMatches.length !== endMatches.length) {
+    errors.push(
+      `Mismatched preserve markers: ${startMatches.length} opening, ${endMatches.length} closing`
+    );
+  }
+  let depth = 0;
+  let maxDepth = 0;
+  const lines = content.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (/<!-- prjct:preserve(?::\w+)? -->/.test(line)) {
+      depth++;
+      maxDepth = Math.max(maxDepth, depth);
+    }
+    if (line.includes(PRESERVE_END_PATTERN)) {
+      depth--;
+    }
+    if (depth > 1) {
+      errors.push(`Nested preserve blocks detected at line ${i + 1} (not supported)`);
+    }
+    if (depth < 0) {
+      errors.push(`Unexpected closing marker at line ${i + 1}`);
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+var PRESERVE_END_PATTERN;
+var init_preserve_sections = __esm({
+  "core/utils/preserve-sections.ts"() {
+    "use strict";
+    PRESERVE_END_PATTERN = "<!-- /prjct:preserve -->";
+    __name(createPreserveStartRegex, "createPreserveStartRegex");
+    __name(extractPreservedSections, "extractPreservedSections");
+    __name(mergePreservedSections, "mergePreservedSections");
+    __name(validatePreserveBlocks, "validatePreserveBlocks");
+  }
+});
+
 // core/services/agent-generator.ts
 var init_agent_generator = __esm({
   "core/services/agent-generator.ts"() {
     "use strict";
+    init_preserve_sections();
   }
 });
 
@@ -17312,60 +17414,6 @@ var init_formatters = __esm({
   }
 });
 
-// core/utils/preserve-sections.ts
-function createPreserveStartRegex() {
-  return /<!-- prjct:preserve(?::([\w-]+))? -->/g;
-}
-function extractPreservedSections(content) {
-  const sections = [];
-  const regex = createPreserveStartRegex();
-  let match;
-  let sectionIndex = 0;
-  while ((match = regex.exec(content)) !== null) {
-    const startIndex = match.index;
-    const startTag = match[0];
-    const sectionId = match[1] || `section-${sectionIndex++}`;
-    const endTagStart = content.indexOf(PRESERVE_END_PATTERN, startIndex + startTag.length);
-    if (endTagStart === -1) {
-      continue;
-    }
-    const endIndex = endTagStart + PRESERVE_END_PATTERN.length;
-    const fullContent = content.substring(startIndex, endIndex);
-    sections.push({
-      id: sectionId,
-      content: fullContent,
-      startIndex,
-      endIndex
-    });
-  }
-  return sections;
-}
-function mergePreservedSections(newContent, oldContent) {
-  const preservedSections = extractPreservedSections(oldContent);
-  if (preservedSections.length === 0) {
-    return newContent;
-  }
-  let merged = newContent.trimEnd();
-  merged += "\n\n---\n\n";
-  merged += "## Your Customizations\n\n";
-  merged += "_The sections below are preserved during sync. Edit freely._\n\n";
-  for (const section of preservedSections) {
-    merged += section.content;
-    merged += "\n\n";
-  }
-  return merged.trimEnd() + "\n";
-}
-var PRESERVE_END_PATTERN;
-var init_preserve_sections = __esm({
-  "core/utils/preserve-sections.ts"() {
-    "use strict";
-    PRESERVE_END_PATTERN = "<!-- /prjct:preserve -->";
-    __name(createPreserveStartRegex, "createPreserveStartRegex");
-    __name(extractPreservedSections, "extractPreservedSections");
-    __name(mergePreservedSections, "mergePreservedSections");
-  }
-});
-
 // core/ai-tools/registry.ts
 import { execSync as execSync4 } from "node:child_process";
 import fs34 from "node:fs";
@@ -17515,6 +17563,13 @@ async function generateForTool(context2, config, globalPath, repoPath) {
     await fs35.mkdir(path38.dirname(outputPath), { recursive: true });
     try {
       const existingContent = await fs35.readFile(outputPath, "utf-8");
+      const validation = validatePreserveBlocks(existingContent);
+      if (!validation.valid) {
+        console.warn(`\u26A0\uFE0F  ${config.outputFile} has invalid preserve blocks:`);
+        for (const error of validation.errors) {
+          console.warn(`   ${error}`);
+        }
+      }
       content = mergePreservedSections(content, existingContent);
     } catch {
     }
@@ -17573,6 +17628,27 @@ var init_context_generator = __esm({
       constructor(config) {
         this.config = config;
       }
+      /**
+       * Write file with preserved sections from existing content
+       * This ensures user customizations survive regeneration
+       */
+      async writeWithPreservation(filePath, content) {
+        let finalContent = content;
+        try {
+          const existingContent = await fs36.readFile(filePath, "utf-8");
+          const validation = validatePreserveBlocks(existingContent);
+          if (!validation.valid) {
+            const filename = path39.basename(filePath);
+            console.warn(`\u26A0\uFE0F  ${filename} has invalid preserve blocks:`);
+            for (const error of validation.errors) {
+              console.warn(`   ${error}`);
+            }
+          }
+          finalContent = mergePreservedSections(content, existingContent);
+        } catch {
+        }
+        await fs36.writeFile(filePath, finalContent, "utf-8");
+      }
       /**
        * Generate all context files in parallel
        */
@@ -17672,13 +17748,7 @@ Load from \`~/.prjct-cli/projects/${this.config.projectId}/agents/\`:
 **Domain**: ${domainAgents.join(", ") || "none"}
 `;
         const claudePath = path39.join(contextPath, "CLAUDE.md");
-        let finalContent = content;
-        try {
-          const existingContent = await fs36.readFile(claudePath, "utf-8");
-          finalContent = mergePreservedSections(content, existingContent);
-        } catch {
-        }
-        await fs36.writeFile(claudePath, finalContent, "utf-8");
+        await this.writeWithPreservation(claudePath, content);
       }
       /**
        * Generate now.md - current task status
@@ -17703,7 +17773,7 @@ _No active task_
 
 Use \`p. task "description"\` to start working.
 `;
-        await fs36.writeFile(path39.join(contextPath, "now.md"), content, "utf-8");
+        await this.writeWithPreservation(path39.join(contextPath, "now.md"), content);
       }
       /**
        * Generate next.md - task queue
@@ -17719,7 +17789,7 @@ Use \`p. task "description"\` to start working.
 
 ${queue.tasks.length > 0 ? queue.tasks.map((t, i) => `${i + 1}. ${t.description}${t.priority ? ` [${t.priority}]` : ""}`).join("\n") : "_Empty queue_"}
 `;
-        await fs36.writeFile(path39.join(contextPath, "next.md"), content, "utf-8");
+        await this.writeWithPreservation(path39.join(contextPath, "next.md"), content);
       }
       /**
        * Generate ideas.md - captured ideas
@@ -17735,7 +17805,7 @@ ${queue.tasks.length > 0 ? queue.tasks.map((t, i) => `${i + 1}. ${t.description}
 
 ${ideas.ideas.length > 0 ? ideas.ideas.map((i) => `- ${i.text}${i.priority ? ` [${i.priority}]` : ""}`).join("\n") : "_No ideas captured yet_"}
 `;
-        await fs36.writeFile(path39.join(contextPath, "ideas.md"), content, "utf-8");
+        await this.writeWithPreservation(path39.join(contextPath, "ideas.md"), content);
       }
       /**
        * Generate shipped.md - completed features
@@ -17755,7 +17825,7 @@ ${shipped.shipped.length > 0 ? shipped.shipped.slice(-10).map((s) => `- **${s.na
 
 **Total shipped:** ${shipped.shipped.length}
 `;
-        await fs36.writeFile(path39.join(contextPath, "shipped.md"), content, "utf-8");
+        await this.writeWithPreservation(path39.join(contextPath, "shipped.md"), content);
       }
     };
   }
@@ -21173,7 +21243,9 @@ ${"\u2550".repeat(50)}`);
             }
             if (command.features) {
               console.log("\nFeatures:");
-              command.features.forEach((f) => console.log(`  \u2022 ${f}`));
+              for (const f of command.features) {
+                console.log(`  \u2022 ${f}`);
+              }
             }
             console.log(`
 ${"\u2550".repeat(50)}
@@ -23903,7 +23975,7 @@ var init_commands = __esm({
         return this.setupCmds.installStatusLine();
       }
       showAsciiArt() {
-        return this.setupCmds.showAsciiArt();
+        this.setupCmds.showAsciiArt();
       }
       // ========== Delegated Base Methods ==========
       async initializeAgent() {
@@ -24008,7 +24080,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.47.0",
+      version: "0.48.0",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.47.0",
+  "version": "0.48.0",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {

package/templates/global/CLAUDE.md

@@ -147,6 +147,33 @@ fs.writeFileSync(path, JSON.stringify(data, null, 2))
 
 **Full specification**: Install prjct-cli and see `{npm root -g}/prjct-cli/templates/global/STORAGE-SPEC.md`
 
+### 6. Preserve Markers (User Customizations)
+
+User customizations in context files and agents survive regeneration using preserve markers:
+
+```markdown
+<!-- prjct:preserve -->
+# My Custom Rules
+- Always use tabs
+- Prefer functional patterns
+<!-- /prjct:preserve -->
+```
+
+**How it works:**
+- Content between markers is extracted before regeneration
+- After regeneration, preserved content is appended under "Your Customizations"
+- Named sections: `<!-- prjct:preserve:my-rules -->` for identification
+
+**Where to use:**
+- `context/CLAUDE.md` - Project-specific AI instructions
+- `agents/*.md` - Domain-specific patterns
+- Any regenerated context file
+
+**⚠️ Invalid blocks show warnings:**
+- Unclosed markers are ignored
+- Nested blocks are not supported
+- Mismatched markers trigger console warnings
+
 ---
 
 ## CORE WORKFLOW