dlw-machine-setup 0.4.1 → 0.4.3

package/bin/installer.js

@@ -3783,7 +3783,6 @@ var import_path4 = require("path");
 var CONTEXTS_DIR = (0, import_path4.join)(process.cwd(), "_ai-context");
 var MARKER_START = "<!-- one-shot-installer:start -->";
 var MARKER_END = "<!-- one-shot-installer:end -->";
-var SNIPPET_FILENAME = "context-instructions.md";
 function upsertBlock(filePath, block) {
   const marked = `${MARKER_START}
 ${block}
@@ -3803,35 +3802,26 @@ ${MARKER_END}`;
     (0, import_fs4.writeFileSync)(filePath, existing + separator + marked, "utf-8");
   }
 }
-function downgradeHeadings(content) {
-  let inCodeBlock = false;
-  return content.split("\n").map((line) => {
-    if (/^ {0,3}```/.test(line)) inCodeBlock = !inCodeBlock;
-    if (inCodeBlock) return line;
-    return line.replace(/^(#{1,5}) /, "$1# ");
-  }).join("\n");
-}
-function buildWorkflowSection(domains) {
-  const sections = [];
-  for (const domain of domains) {
-    const domainUpper = domain.toUpperCase();
-    const snippetPath = (0, import_path4.join)(CONTEXTS_DIR, domainUpper, SNIPPET_FILENAME);
-    if (!(0, import_fs4.existsSync)(snippetPath)) continue;
-    const raw = (0, import_fs4.readFileSync)(snippetPath, "utf-8").trim();
-    if (!raw) continue;
-    sections.push(downgradeHeadings(raw));
-  }
-  return sections.length > 0 ? sections.join("\n\n") + "\n" : "";
+function collectMdFiles(dir) {
+  if (!(0, import_fs4.existsSync)(dir)) return [];
+  const entries = (0, import_fs4.readdirSync)(dir, { recursive: true });
+  return entries.filter((entry) => {
+    const fullPath = (0, import_path4.join)(dir, entry);
+    return entry.endsWith(".md") && (0, import_fs4.statSync)(fullPath).isFile();
+  }).map((entry) => entry.replace(/\\/g, "/")).sort();
 }
-function cleanupWorkflowSnippets(domains) {
-  for (const domain of domains) {
-    const domainUpper = domain.toUpperCase();
-    const snippetPath = (0, import_path4.join)(CONTEXTS_DIR, domainUpper, SNIPPET_FILENAME);
-    try {
-      (0, import_fs4.unlinkSync)(snippetPath);
-    } catch {
+function extractFirstHeading(filePath) {
+  try {
+    const content = (0, import_fs4.readFileSync)(filePath, "utf-8");
+    const withoutFrontmatter = content.replace(/^---[\s\S]*?---\s*/, "");
+    const match = withoutFrontmatter.match(/^#\s+(.+)/m);
+    if (match) {
+      return match[1].replace(/^[\p{Emoji_Presentation}\p{Extended_Pictographic}\s]+/u, "").trim();
     }
+  } catch {
   }
+  const basename = filePath.split(/[/\\]/).pop() ?? "";
+  return basename.replace(/\.md$/i, "").replace(/[-_]+/g, " ");
 }
 function buildMCPSection(mcpConfig) {
   const entries = Object.entries(mcpConfig);
@@ -3862,27 +3852,52 @@ function buildContextRefsSection(domains) {
     `Domain-specific guidelines and reference material are available in the \`_ai-context/\` folder:`,
     ``
   ];
+  let hasAnyFiles = false;
   for (const domain of domains) {
     const domainUpper = domain.toUpperCase();
     const domainPath = (0, import_path4.join)(CONTEXTS_DIR, domainUpper);
     if (!(0, import_fs4.existsSync)(domainPath)) continue;
-    lines2.push(`### ${domainUpper}`);
+    const domainFiles = [];
+    const ctxInstructions = (0, import_path4.join)(domainPath, "context-instructions.md");
+    if ((0, import_fs4.existsSync)(ctxInstructions)) {
+      const desc = extractFirstHeading(ctxInstructions);
+      domainFiles.push(`- \`_ai-context/${domainUpper}/context-instructions.md\` \u2014 ${desc}`);
+    }
     const instructionsMd = (0, import_path4.join)(domainPath, "core", "instructions.md");
     if ((0, import_fs4.existsSync)(instructionsMd)) {
-      lines2.push(`- \`_ai-context/${domainUpper}/core/instructions.md\` \u2014 core development guidelines`);
+      const desc = extractFirstHeading(instructionsMd);
+      domainFiles.push(`- \`_ai-context/${domainUpper}/core/instructions.md\` \u2014 ${desc} (start here)`);
     }
-    const instructionsDir = (0, import_path4.join)(domainPath, "core", "instructions");
-    if ((0, import_fs4.existsSync)(instructionsDir)) {
-      lines2.push(`- \`_ai-context/${domainUpper}/core/instructions/\` \u2014 detailed topic-specific guidelines`);
+    const coreDir = (0, import_path4.join)(domainPath, "core");
+    if ((0, import_fs4.existsSync)(coreDir)) {
+      const coreFiles = collectMdFiles(coreDir).filter((f) => f !== "instructions.md" && !f.startsWith("instructions/"));
+      for (const file of coreFiles) {
+        const desc = extractFirstHeading((0, import_path4.join)(coreDir, file));
+        domainFiles.push(`- \`_ai-context/${domainUpper}/core/${file}\` \u2014 ${desc}`);
+      }
     }
     const refDir = (0, import_path4.join)(domainPath, "reference");
     if ((0, import_fs4.existsSync)(refDir)) {
-      lines2.push(`- \`_ai-context/${domainUpper}/reference/\` \u2014 cheat sheets and reference material`);
+      const refFiles = collectMdFiles(refDir);
+      if (refFiles.length > 0) {
+        domainFiles.push(``);
+        domainFiles.push(`**Reference & cheat sheets:**`);
+        for (const file of refFiles) {
+          const desc = extractFirstHeading((0, import_path4.join)(refDir, file));
+          domainFiles.push(`- \`_ai-context/${domainUpper}/reference/${file}\` \u2014 ${desc}`);
+        }
+      }
     }
+    if (domainFiles.length === 0) continue;
+    hasAnyFiles = true;
+    lines2.push(`### ${domainUpper}`);
+    lines2.push(...domainFiles);
+    lines2.push(``);
+  }
+  if (hasAnyFiles) {
+    lines2.push(`**ALWAYS** read \`core/instructions.md\` for a domain before implementing features. Consult reference files when the topic is directly relevant.`);
     lines2.push(``);
   }
-  lines2.push(`**ALWAYS** consult these files before implementing features or making architectural decisions.`);
-  lines2.push(``);
   return lines2.join("\n");
 }
 function buildCombinedInstructions(domains, mcpConfig) {
@@ -3896,12 +3911,6 @@ function buildCombinedInstructions(domains, mcpConfig) {
   if (mcpConfig && Object.keys(mcpConfig).length > 0) {
     lines2.push(buildMCPSection(mcpConfig));
   }
-  const workflowContent = buildWorkflowSection(domains);
-  if (workflowContent) {
-    lines2.push(`## Domain-Specific Development Workflows
-`);
-    lines2.push(workflowContent);
-  }
   return lines2.join("\n");
 }
 async function setupInstructions(config) {
@@ -3910,7 +3919,6 @@ async function setupInstructions(config) {
     case "claude-code": {
       const content = buildCombinedInstructions(domains, mcpConfig);
       upsertBlock((0, import_path4.join)(process.cwd(), "CLAUDE.md"), content);
-      cleanupWorkflowSnippets(domains);
       break;
     }
     case "github-copilot": {
@@ -3926,7 +3934,6 @@ applyTo: "**"
       }
       const body = buildCombinedInstructions(domains, mcpConfig);
       upsertBlock(filePath, body);
-      cleanupWorkflowSnippets(domains);
       break;
     }
     case "cursor": {
@@ -3934,7 +3941,6 @@ applyTo: "**"
       if (!(0, import_fs4.existsSync)(cursorDir)) (0, import_fs4.mkdirSync)(cursorDir, { recursive: true });
       const body = buildCombinedInstructions(domains, mcpConfig);
       upsertBlock((0, import_path4.join)(cursorDir, `instructions.mdc`), body);
-      cleanupWorkflowSnippets(domains);
       break;
     }
     default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dlw-machine-setup",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "One-shot installer for The Machine toolchain",
   "bin": {
     "dlw-machine-setup": "bin/installer.js"