@theglitchking/hit-em-with-the-docs 2.7.0 → 2.7.1

package/.claude-plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Official marketplace for hit-em-with-the-docs - Self-managing documentation system",
-    "version": "2.7.0"
+    "version": "2.7.1"
   },
   "plugins": [
     {
       "name": "hit-em-with-the-docs",
       "description": "Self-managing documentation system with hierarchical structure, intelligent automation, pattern discovery, and agent orchestration",
-      "version": "2.7.0",
+      "version": "2.7.1",
       "author": {
         "name": "TheGlitchKing"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "hit-em-with-the-docs",
   "description": "Self-managing documentation system with hierarchical structure, intelligent automation, pattern discovery, and agent orchestration",
-  "version": "2.7.0",
+  "version": "2.7.1",
   "author": {
     "name": "TheGlitchKing",
     "email": "theglitchking@users.noreply.github.com"

package/README.md

@@ -874,6 +874,26 @@ src/
     └── logger.ts            # Logging and output formatting
 ```
 
+### Indexing: what counts as a document
+
+`INDEX.md` and `REGISTRY.md` are **generated** — `index`, `maintain`, and
+`integrate` rebuild them from disk, so a row you add by hand is overwritten on
+the next run.
+
+Domain folders are walked **recursively**, so a document at any depth inside a
+domain is indexed (`standards/backend/foo.md` appears in `standards/INDEX.md` as
+`backend/foo.md`). Never indexed: the generated `INDEX.md`/`REGISTRY.md`
+themselves; anything under `archive/`, `drafts/`, `reports/`, `_templates/`,
+`node_modules/`, or a nested `.documentation/`; and the vault's `facts/`,
+`incidents/`, and `symptoms/` subtrees, which have their own generators.
+
+Recursive indexing landed in **2.7.1**. Before that the walk was flat and every
+document in a subfolder was invisible to the whole system — so the first
+`index`/`maintain` run after upgrading will add a row for each one.
+
+**Full contract, and the troubleshooting ladder for "my doc isn't in the index":
+[docs/indexing.md](docs/indexing.md).**
+
 ### File Structure
 
 When you run `hewtd init`, it creates this structure:
@@ -887,7 +907,9 @@ When you run `hewtd init`, it creates this structure:
 ├── security/                 # Security documentation (priority: 9)
 │   ├── INDEX.md             # Security domain table of contents
 │   ├── REGISTRY.md          # Quick reference for security docs
-│   └── *.md                 # Individual security documents
+│   ├── *.md                 # Individual security documents
+│   └── auth/                # Subfolders are indexed too (2.7.1+)
+│       └── *.md             # → listed as auth/<name>.md
 │
 ├── api/                      # API documentation (priority: 8)
 │   ├── INDEX.md

package/dist/action/generators/regenerate.d.ts

@@ -9,6 +9,12 @@ export interface RegenerateOptions {
      */
     domains?: Domain[];
     silent?: boolean;
+    /**
+     * Compute everything, write nothing. `filesWritten` then lists the files
+     * that WOULD be written. Exists so users can preview the (large, one-time)
+     * diff the 2.7.1 recursive walk produces before committing to it.
+     */
+    dryRun?: boolean;
 }
 export interface RegenerateResult {
     /** Per-domain document counts — all domains, regardless of the filter. */
@@ -19,9 +25,14 @@ export interface RegenerateResult {
     totalDocuments: number;
 }
 /**
- * List the document files in a domain directory, excluding the generated
- * INDEX.md / REGISTRY.md. Returns sorted file names (not paths). Empty when
- * the domain directory does not exist.
+ * List the document files in a domain directory, walking subfolders. Returns
+ * sorted, domain-relative POSIX paths (`backend/entity-schema-contract.md`).
+ * Empty when the domain directory does not exist.
+ *
+ * This is the shared spine for three consumers — the index generator, the
+ * `index-drift` audit rule, and the `domain remove` orphan count — so what it
+ * excludes, the whole system excludes: the generated INDEX/REGISTRY at any
+ * depth, `EXCLUDED_DIRS`, and the vault's generator-owned subtrees (issue #12).
  */
 export declare function listDomainDocFiles(docsPath: string, domain: string): Promise<string[]>;
 /**

package/dist/action/generators/regenerate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"regenerate.d.ts","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/generators/regenerate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAmB3D,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,8DAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB;AAkED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAkE3B"}
+{"version":3,"file":"regenerate.d.ts","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/generators/regenerate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAiE3D,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,8DAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBnB;AAwFD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAuE3B"}