dlw-machine-setup 0.4.1 → 0.4.2

package/bin/installer.js

@@ -3811,10 +3811,37 @@ function downgradeHeadings(content) {
     return line.replace(/^(#{1,5}) /, "$1# ");
   }).join("\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() && !entry.toLowerCase().endsWith(SNIPPET_FILENAME);
+  }).map((entry) => entry.replace(/\\/g, "/")).sort();
+}
+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 buildWorkflowSection(domains) {
   const sections = [];
+  const generalSnippet = (0, import_path4.join)(CONTEXTS_DIR, "GENERAL", SNIPPET_FILENAME);
+  if ((0, import_fs4.existsSync)(generalSnippet)) {
+    const raw = (0, import_fs4.readFileSync)(generalSnippet, "utf-8").trim();
+    if (raw) sections.push(downgradeHeadings(raw));
+  }
   for (const domain of domains) {
     const domainUpper = domain.toUpperCase();
+    if (domainUpper === "GENERAL") continue;
     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();
@@ -3862,27 +3889,47 @@ 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 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) {

package/package.json

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