@theglitchking/hit-em-with-the-docs 2.6.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.6.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.6.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.6.0",
+  "version": "2.7.1",
   "author": {
     "name": "TheGlitchKing",
     "email": "theglitchking@users.noreply.github.com"

package/README.md

@@ -256,6 +256,9 @@ These commands run in your terminal and manage your documentation.
 | `hewtd audit` | Check documentation quality and compliance |
 | `hewtd report <type>` | Generate health, audit, or link reports |
 | `hewtd discover` | Scan code for patterns and create docs |
+| `hewtd archive <file>` | Retire a doc into `archive/` (reversible, link-safe) |
+| `hewtd unarchive <file>` | Restore an archived doc to where it came from |
+| `hewtd archive-candidates` | List docs that may warrant archiving (advisory) |
 
 ##### Command Examples and Details
 
@@ -871,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:
@@ -884,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
@@ -919,14 +944,117 @@ When you run `hewtd init`, it creates this structure:
 
 #### Archived / deprecated docs (`archive/`)
 
-Move a doc to `.documentation/archive/` to retire it without deleting it. hewtd
+`.documentation/archive/` is the parking lot for retired documentation. hewtd
 **excludes the entire `archive/` subtree from every scan** — `audit`,
 `link-check`, `metadata-sync`, `integrate` duplicate-detection, the link graph,
 and `search`. Archived docs are never validated against the frontmatter schema,
 never appear in any INDEX.md/REGISTRY.md, and won't break audit/link-check with
 stale frontmatter. `init` scaffolds the folder with a README explaining the
 convention. `archive` is a reserved name and cannot be registered as a domain.
-To un-deprecate a doc, move it back into a domain folder and run `hewtd maintain`.
+
+##### The archival process (2.7.0+)
+
+The `archive/` folder shipped in 2.6.0 as a passive convention — you moved files
+into it by hand. **2.7.0** turns it into an actual workflow: three commands, a
+config block, and an audit nudge, all built around two principles. First,
+**propose, don't impose** — detection is advisory, a human always executes the
+move, and nothing is ever auto-archived. Second, **reversible and link-safe** —
+archiving records where a doc came from so restore is lossless, and a link guard
+keeps you from silently breaking the active corpus.
+
+There's a deliberate stance baked into how candidates are detected, too. hewtd
+**does not** use access-recency (it has no read telemetry) and **does not** treat
+age alone as an archive signal. Docs aren't code: an unchanged foundational doc is
+often the most important one in the tree, not the most disposable. The only
+objective recency signal available is git-last-touched, and even that is advisory
+and gated behind "this doc is also orphaned."
+
+**`hewtd archive <file>`** retires a doc. It moves the file into
+`archive/<same-domain-subpath>/` (so `api/old.md` lands at `archive/api/old.md`),
+stamps lifecycle frontmatter (`status: archived`, `archived_on`, `archived_from`,
+and `archived_reason` when you pass a reason), and regenerates the indexes so the
+doc cleanly leaves its domain INDEX. It prefers `git mv` to preserve history and
+falls back to a plain move when you're not in a git repo.
+
+```bash
+# Preview first — moves nothing
+hewtd archive api/old-endpoints.md --dry-run
+
+# Retire it, recording why
+hewtd archive api/old-endpoints.md -r "Replaced by the v2 endpoint reference"
+```
+
+The **link guard** is on by default: if active docs still link to the target,
+`archive` refuses and lists each offending link so you can fix them first. Pass
+`--force` to archive anyway (those inbound links become dangling):
+
+```bash
+hewtd archive api/old-endpoints.md --force
+```
+
+**`hewtd unarchive <file>`** is the lossless reverse. It restores the doc to the
+path recorded in `archived_from`, sets `status: active`, and strips the
+`archived_*` fields. It refuses if the restore target already exists, so it never
+clobbers a doc you've since recreated.
+
+```bash
+hewtd unarchive archive/api/old-endpoints.md --dry-run
+hewtd unarchive archive/api/old-endpoints.md
+```
+
+**`hewtd archive-candidates`** is advisory and **read-only** — it never moves
+anything. It lists docs that may warrant archiving, each with a score and the
+reasons behind it:
+
+```bash
+hewtd archive-candidates
+hewtd archive-candidates --json
+```
+
+The candidate signals, ranked:
+
+1. **`status: deprecated`** — a strong, explicit signal. Qualifies a doc on its
+   own.
+2. **`superseded_by:` frontmatter** — also strong and explicit. Qualifies alone.
+3. **Orphaned** (zero inbound links) — a weaker signal on its own.
+4. **Stale** — git-last-touched (or `last_updated` as a fallback when git is
+   unavailable) older than `candidate_after_days`. Age **only** contributes when
+   the doc is *also* orphaned; it never qualifies a doc by itself.
+
+##### `archive` config block
+
+Tune detection in `.claude/hit-em-with-the-docs.json` under an `archive` key. All
+four keys are optional; the defaults are conservative on purpose:
+
+```json
+{
+  "archive": {
+    "honor_status_deprecated": true,
+    "candidate_after_days": 365,
+    "require_orphaned": true,
+    "auto": false
+  }
+}
+```
+
+- `honor_status_deprecated` (default `true`) — treat `status: deprecated` as a
+  qualifying candidate signal.
+- `candidate_after_days` (default `365`) — the staleness threshold in days.
+- `require_orphaned` (default `true`) — gate the age signal behind "also
+  orphaned." Set it `false` to let age qualify a doc on its own (not
+  recommended).
+- `auto` (default `false`) — nothing is ever auto-archived. This is the
+  propose-don't-impose default; archiving is always a human decision.
+
+##### Audit nudge: `deprecated-not-archived`
+
+`status: deprecated` and archiving are different steps. Marking a doc
+`deprecated` flags intent while keeping it live, indexed, and linkable; archiving
+physically retires it. To keep `deprecated` from being a dead-end label, the
+auditor now raises an **INFO** issue (`deprecated-not-archived`) for any doc left
+at `status: deprecated` in an active domain folder, suggesting
+`hewtd archive <file>`. That's what finally makes `status: deprecated`
+actionable.
 
 ### Domain System
 

package/commands/archive.md

@@ -0,0 +1,43 @@
+---
+description: Deprecate/retire a doc — move it into archive/ (reversible, link-safe), or list archival candidates
+allowed-tools: Bash(npx:*), Read
+argument-hint: "candidates | archive <file> [--reason ...] | unarchive <file>"
+---
+
+Arguments: $ARGUMENTS
+
+This command wraps `npx --no @theglitchking/hit-em-with-the-docs <archive|unarchive|archive-candidates>`. It retires deprecated docs into `.documentation/archive/` (which hewtd excludes from all scans) — properly: history-preserving move, metadata stamp, reindex, and a link-safety guard. Dispatch on the first word of `$ARGUMENTS`:
+
+## `candidates` (or empty arguments)
+
+- Run `npx --no @theglitchking/hit-em-with-the-docs archive-candidates` and report the suggestions with their reasons/scores. This is **advisory and read-only** — nothing moves. Offer to archive any the user confirms.
+
+## `archive <file>`
+
+Moves the doc into `archive/<same-domain-path>/`, stamps `status: archived` + `archived_on` + `archived_from` (+ `archived_reason` if given), and reindexes.
+
+- **Preview first** (always): run with `--dry-run`:
+  ```bash
+  npx --no @theglitchking/hit-em-with-the-docs archive <file> [--reason "..."] --dry-run
+  ```
+- The dry-run reports any **active docs that link to this doc**. If there are inbound links:
+  - Surface them to the user (file:line). Archiving will leave them dangling.
+  - Recommend fixing those links first. Only proceed with `--force` on **explicit** user confirmation.
+- If the user did not give a reason, ask for one (it's recorded in `archived_reason`).
+- On confirmation, re-run without `--dry-run` (add `--force` only if the user accepted the dangling-link tradeoff). Suggest `hewtd maintain` afterward.
+
+## `unarchive <file>`
+
+Restores an archived doc back to its original path (`archived_from`), `status: active`.
+
+- Run with `--dry-run` to show where it will land, then re-run for real on confirmation:
+  ```bash
+  npx --no @theglitchking/hit-em-with-the-docs unarchive <file> --dry-run
+  ```
+- If it reports the restore target already exists, relay that and don't force it.
+
+## Notes
+
+- Criteria for archiving (what `candidates` ranks on): `status: deprecated` (strongest) → `superseded_by:` → orphaned (no inbound links) → age (only when also orphaned). **Age alone never qualifies a doc** — an unchanged doc is often the most important one.
+- Don't hand-move files into `archive/`; the command does the metadata + reindex + link check that a bare `mv` skips.
+- If the first word isn't `candidates`, `archive`, or `unarchive`, tell the user those are the valid subcommands.

package/commands/help.md

@@ -19,6 +19,8 @@ If `$ARGUMENTS` matches one of the topics below, focus the orientation on that t
 - `audit` — explain `hewtd audit` + `--strict`; explain when to use each
 - `integrate` — explain `hewtd integrate <file>` and when to use it
 - `templates` — list available templates with paths
+- `domains` — explain the 15 built-in domains + custom domains (`hewtd domain add/remove/list`, 2.6.0+)
+- `archive` / `deprecation` — explain the archival workflow (`hewtd archive/unarchive/archive-candidates`, 2.7.0+)
 
 ## What hewtd does (the one-paragraph brief)
 
@@ -31,6 +33,7 @@ If `$ARGUMENTS` matches one of the topics below, focus the orientation on that t
 3. **Creating a fact in the knowledge base (2.3.0+)** — copy `templates/knowledge-base/fact.template.md` into `<vault-root>/facts/<kebab-id>.md`, fill in required fields (`id`, `confidence`, `last_verified`, `provenance`).
 4. **Documenting an incident (2.3.0+)** — create `<vault-root>/incidents/YYYY-MM-DD-slug/` with both `narrative.md` and `facts.md` from the templates.
 5. **Enriching a playbook (2.3.0+)** — add a `symptoms:` block to a playbook's frontmatter; cite the facts the playbook depends on.
+6. **Deprecating / retiring a doc (2.7.0+)** — `hewtd archive <file>` moves a stale doc into `.documentation/archive/` (excluded from all scans), reversibly and link-safely. Run `hewtd archive-candidates` to see what's worth retiring; `hewtd unarchive <file>` to bring one back.
 
 ## Commands available
 
@@ -44,10 +47,16 @@ CLI (via `npx --no @theglitchking/hit-em-with-the-docs <cmd>` or `hewtd <cmd>` i
 - `integrate <file>` — auto-classify and place a raw markdown file
 - `discover patterns|anti-patterns|standards|dependencies` — extract conventions from source code
 - `report health|audit|links` — generate detailed reports
-- `list` — list all 15 domains
+- `list` — list the built-in domains
+- `domain list|add|remove` — manage custom domains (2.6.0+); `add <id> -k <keywords>` registers + scaffolds a project-specific domain
+- `archive <file>` — deprecate a doc into `archive/` (reversible, link-safe, reindexes) (2.7.0+)
+- `unarchive <file>` — restore an archived doc to its domain folder (2.7.0+)
+- `archive-candidates` — advisory list of docs worth retiring (2.7.0+)
 - `search <query>` — search documentation
 
 Slash commands (Claude Code):
+- `/hit-em-with-the-docs:domain` — add/remove/list custom domains (2.6.0+)
+- `/hit-em-with-the-docs:archive` — deprecate/restore docs, or list candidates (2.7.0+)
 - `/hit-em-with-the-docs:status` — installed version, update policy, hook state
 - `/hit-em-with-the-docs:policy [auto|nudge|off]` — get/set update policy
 - `/hit-em-with-the-docs:update` — pull the latest version

package/dist/action/core/archive/candidates.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Archival candidate DETECTION — advisory and read-only.
+ *
+ * Surfaces docs that *might* warrant archiving, scored on ranked signals.
+ * It never moves anything (the executor does that). Philosophy: a strong
+ * explicit signal (`status: deprecated`, `superseded_by`) qualifies on its
+ * own; age qualifies only in combination with orphaned (`require_orphaned`),
+ * because age alone conflates "unchanged" with "obsolete".
+ */
+import type { ArchiveConfig } from '../../utils/config.js';
+export interface ArchiveCandidate {
+    file: string;
+    score: number;
+    reasons: string[];
+    signals: {
+        deprecated: boolean;
+        superseded: boolean;
+        orphaned: boolean;
+        stale: boolean;
+        staleSignalDegraded: boolean;
+    };
+}
+/**
+ * Days since the file was last modified, via git (`%cs` = committer date).
+ * Returns null when not in a git repo or the file is untracked (no history).
+ */
+export declare function gitLastTouchedDays(projectRoot: string, fileAbs: string, today: Date): number | null;
+export interface FindCandidatesInput {
+    docsPath: string;
+    projectRoot: string;
+    config: ArchiveConfig;
+    /** Override "today" for deterministic tests. */
+    today?: Date;
+}
+export declare function findArchiveCandidates(input: FindCandidatesInput): Promise<ArchiveCandidate[]>;
+/** Convenience: resolve absolute docs path for a candidate (test/CLI helper). */
+export declare function candidateAbsPath(docsPath: string, candidate: ArchiveCandidate): string;
+//# sourceMappingURL=candidates.d.ts.map

package/dist/action/core/archive/candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/core/archive/candidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE;QACP,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;QAClB,KAAK,EAAE,OAAO,CAAC;QACf,mBAAmB,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,IAAI,GACV,MAAM,GAAG,IAAI,CAgBf;AAUD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,gDAAgD;IAChD,KAAK,CAAC,EAAE,IAAI,CAAC;CACd;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA4E7B;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAEtF"}

package/dist/action/core/archive/links.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Inbound-link detection for the archival process.
+ *
+ * Archiving a doc that active docs still link to would turn live references
+ * into dead ones — exactly the failure archival must prevent. This reuses the
+ * existing link graph (which already excludes `archive/`, since it scans via
+ * `findMarkdownFiles`) to find every active doc that links to a target.
+ */
+export interface InboundLink {
+    /** docs-relative path of the doc that links to the target. */
+    source: string;
+    lineNumber: number;
+    linkText: string;
+}
+/**
+ * Find all active (non-archived) docs that link to `targetRelPath`
+ * (a path relative to `docsPath`). Returns one entry per inbound link.
+ */
+export declare function findInboundLinks(docsPath: string, targetRelPath: string): Promise<InboundLink[]>;
+/** Normalize an absolute-or-relative file arg to a docs-relative POSIX path. */
+export declare function toDocsRelative(docsPath: string, file: string): string;
+//# sourceMappingURL=links.d.ts.map

package/dist/action/core/archive/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/core/archive/links.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC,CAUxB;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrE"}

package/dist/action/core/archive/manage.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Archival executor: the deterministic WRITER behind `hewtd archive` /
+ * `hewtd unarchive`.
+ *
+ * Moves a doc into `archive/<domain-subpath>/…` (and back), preserving git
+ * history via `git mv` where possible, stamping reversible lifecycle metadata,
+ * and regenerating indexes so the doc cleanly leaves (or rejoins) the active
+ * corpus. Non-destructive and reversible by design: `archived_from` records the
+ * exact restore path.
+ */
+import { type InboundLink } from './links.js';
+export interface ArchiveDocInput {
+    projectRoot: string;
+    docsPath: string;
+    /** Doc to archive — docs-relative (e.g. `api/old.md`) or absolute. */
+    file: string;
+    reason?: string;
+    force?: boolean;
+    dryRun?: boolean;
+    /** Override "today" (YYYY-MM-DD) for deterministic tests. */
+    today?: string;
+}
+export interface ArchiveDocResult {
+    ok: boolean;
+    errors: string[];
+    action: 'archived' | 'dry_run' | 'blocked' | 'rejected';
+    from?: string;
+    to?: string;
+    moveMethod?: 'git' | 'fs';
+    /** Active docs that link to the target (the link guard). */
+    inboundLinks: InboundLink[];
+}
+export declare function archiveDoc(input: ArchiveDocInput): Promise<ArchiveDocResult>;
+export interface UnarchiveDocInput {
+    projectRoot: string;
+    docsPath: string;
+    /** Archived doc — docs-relative (e.g. `archive/api/old.md`) or absolute. */
+    file: string;
+    dryRun?: boolean;
+}
+export interface UnarchiveDocResult {
+    ok: boolean;
+    errors: string[];
+    action: 'unarchived' | 'dry_run' | 'rejected';
+    from?: string;
+    to?: string;
+    moveMethod?: 'git' | 'fs';
+}
+export declare function unarchiveDoc(input: UnarchiveDocInput): Promise<UnarchiveDocResult>;
+//# sourceMappingURL=manage.d.ts.map

package/dist/action/core/archive/manage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage.d.ts","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/core/archive/manage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAsDhF,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC1B,4DAA4D;IAC5D,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAgE3B;AAMD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAsD7B"}

package/dist/action/core/audit/auditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auditor.d.ts","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/core/audit/auditor.ts"],"names":[],"mappings":"AAYA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAM5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAqJpF;AA0ND;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}
+{"version":3,"file":"auditor.d.ts","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/core/audit/auditor.ts"],"names":[],"mappings":"AAYA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAM5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAqJpF;AAyOD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}

package/dist/action/core/metadata/schema.d.ts

@@ -87,6 +87,11 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }>, "many">>;
+} & {
+    superseded_by: z.ZodOptional<z.ZodString>;
+    archived_on: z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>;
+    archived_from: z.ZodOptional<z.ZodString>;
+    archived_reason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     domains: string[];
     title: string;
@@ -133,6 +138,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: string | undefined;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }, {
     domains: string[];
     title: string;
@@ -179,6 +188,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: unknown;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }>, {
     domains: string[];
     title: string;
@@ -225,6 +238,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: string | undefined;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }, {
     domains: string[];
     title: string;
@@ -271,6 +288,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: unknown;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }>, {
     domains: string[];
     title: string;
@@ -317,6 +338,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: string | undefined;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }, {
     domains: string[];
     title: string;
@@ -363,6 +388,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: unknown;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }>, {
     domains: string[];
     title: string;
@@ -409,6 +438,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: string | undefined;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }, {
     domains: string[];
     title: string;
@@ -455,6 +488,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: unknown;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }>, {
     domains: string[];
     title: string;
@@ -501,6 +538,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: string | undefined;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }, {
     domains: string[];
     title: string;
@@ -547,6 +588,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: unknown;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }>, {
     domains: string[];
     title: string;
@@ -593,6 +638,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: string | undefined;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }, {
     domains: string[];
     title: string;
@@ -639,6 +688,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: unknown;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }>, {
     domains: string[];
     title: string;
@@ -685,6 +738,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: string | undefined;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }, {
     domains: string[];
     title: string;
@@ -731,6 +788,10 @@ export declare const MetadataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: unknown;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }>;
 export type DocumentMetadata = z.infer<typeof MetadataSchema>;
 /**
@@ -798,6 +859,10 @@ export declare const PartialMetadataSchema: z.ZodObject<{
         target?: string | undefined;
         cites?: string[] | undefined;
     }>, "many">>>;
+    superseded_by: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    archived_on: z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodString, string, unknown>>>;
+    archived_from: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    archived_reason: z.ZodOptional<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     domains?: string[] | undefined;
     title?: string | undefined;
@@ -844,6 +909,10 @@ export declare const PartialMetadataSchema: z.ZodObject<{
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: string | undefined;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }, {
     domains?: string[] | undefined;
     title?: string | undefined;
@@ -890,6 +959,10 @@ export declare const PartialMetadataSchema: z.ZodObject<{
         target?: string | undefined;
         cites?: string[] | undefined;
     }[] | undefined;
+    superseded_by?: string | undefined;
+    archived_on?: unknown;
+    archived_from?: string | undefined;
+    archived_reason?: string | undefined;
 }>;
 export type PartialDocumentMetadata = z.infer<typeof PartialMetadataSchema>;
 /**

package/dist/action/core/metadata/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/core/metadata/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/core/metadata/schema.ts"],"names":[],"mappings":"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"}

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"}