@nusoft/nuos-build-catalogue 0.14.1 → 0.14.2

package/dist/indexer/crawl.d.ts

@@ -1,13 +1,21 @@
 /**
- * Crawler — walks the NuOS catalogue tree picking up indexable .md files.
+ * Crawler — walks the catalogue's `docs/` tree picking up indexable .md files.
  *
- * Per WU 110 spec:
- *   - includes: docs/build/**, docs/contracts/**, docs/philosophy/**,
- *     docs/guides/**, plus top-level docs/build/STATE.md, BUILD-ORDER.md,
- *     README.md, reference-index.md
- *   - skips: _index.md (derived; adds noise), done/, archive/, superseded/
- *     subdirs (opt-in via includeArchived)
- *   - skips: .excalidraw, binary
+ * Default behaviour (0.14.2+): recursive crawl of EVERYTHING under
+ * `docs/`, including top-level loose markdown files and every subdirectory.
+ * The earlier hardcoded allowlist of four subdirs (`build/`, `contracts/`,
+ * `philosophy/`, `guides/`) silently excluded strategic content that lives
+ * elsewhere — top-level docs like `THE-NUOS-BUILD-METHOD.md`,
+ * `MVP-NEXT-STEPS.md`, `PHASE-4-SIGNOFF.md`, and subdirs like
+ * `architecture/`, `integration/`, `investor/`, `wireframes/`. Those are
+ * load-bearing strategic context and need to be searchable.
+ *
+ * Skipped:
+ *   - `_index.md` (derived; adds noise to ranking)
+ *   - `*-template.md` (templates, not real content)
+ *   - `done/`, `archive/`, `superseded/` subdirs (opt-in via includeArchived)
+ *   - `node_modules/`, `.git/`, `.nuos-catalogue/`
+ *   - non-`.md` files (binaries, .excalidraw, etc.)
  */
 export interface CrawlOptions {
     catalogueRoot: string;

package/dist/indexer/crawl.js

@@ -1,28 +1,42 @@
 /**
- * Crawler — walks the NuOS catalogue tree picking up indexable .md files.
+ * Crawler — walks the catalogue's `docs/` tree picking up indexable .md files.
  *
- * Per WU 110 spec:
- *   - includes: docs/build/**, docs/contracts/**, docs/philosophy/**,
- *     docs/guides/**, plus top-level docs/build/STATE.md, BUILD-ORDER.md,
- *     README.md, reference-index.md
- *   - skips: _index.md (derived; adds noise), done/, archive/, superseded/
- *     subdirs (opt-in via includeArchived)
- *   - skips: .excalidraw, binary
+ * Default behaviour (0.14.2+): recursive crawl of EVERYTHING under
+ * `docs/`, including top-level loose markdown files and every subdirectory.
+ * The earlier hardcoded allowlist of four subdirs (`build/`, `contracts/`,
+ * `philosophy/`, `guides/`) silently excluded strategic content that lives
+ * elsewhere — top-level docs like `THE-NUOS-BUILD-METHOD.md`,
+ * `MVP-NEXT-STEPS.md`, `PHASE-4-SIGNOFF.md`, and subdirs like
+ * `architecture/`, `integration/`, `investor/`, `wireframes/`. Those are
+ * load-bearing strategic context and need to be searchable.
+ *
+ * Skipped:
+ *   - `_index.md` (derived; adds noise to ranking)
+ *   - `*-template.md` (templates, not real content)
+ *   - `done/`, `archive/`, `superseded/` subdirs (opt-in via includeArchived)
+ *   - `node_modules/`, `.git/`, `.nuos-catalogue/`
+ *   - non-`.md` files (binaries, .excalidraw, etc.)
  */
 import { readdir, stat } from 'node:fs/promises';
 import path from 'node:path';
-const TOP_LEVEL_INCLUDES = ['build', 'contracts', 'philosophy', 'guides'];
-const SKIPPED_DIR_NAMES = new Set(['node_modules', '.git', '.nuos-catalogue']);
+const SKIPPED_DIR_NAMES = new Set([
+    'node_modules',
+    '.git',
+    '.nuos-catalogue',
+    '.opencode',
+    '.claude',
+    '.agents',
+]);
 const ARCHIVED_DIR_NAMES = new Set(['done', 'archive', 'superseded']);
 const INDEX_FILENAMES = new Set(['_index.md']);
+function isTemplateName(name) {
+    // Catches `001-template-simple.md`, `module-template.md`, `_template.md`,
+    // `99-template-power-user-operational-plan.md`, etc.
+    return /template\.md$/.test(name) || name === '_template.md';
+}
 export async function crawl(options) {
     const out = [];
-    for (const top of TOP_LEVEL_INCLUDES) {
-        const start = path.join(options.catalogueRoot, top);
-        if (await exists(start)) {
-            await walkDir(start, options, out);
-        }
-    }
+    await walkDir(options.catalogueRoot, options, out);
     return out.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
 }
 async function walkDir(dir, options, out) {
@@ -49,6 +63,8 @@ async function walkDir(dir, options, out) {
             continue;
         if (INDEX_FILENAMES.has(entry.name))
             continue;
+        if (isTemplateName(entry.name))
+            continue;
         out.push({
             absolutePath: full,
             relativePath: path.relative(options.catalogueRoot, full),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nusoft/nuos-build-catalogue",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "description": "NuOS build-catalogue tooling: semantic search (WU 110) + migration runner that lifts markdown artefacts into JSON-backed workflow records (WU 111, Phase G).",
   "type": "module",
   "bin": {