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

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.1"
+    "version": "2.8.0"
   },
   "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.1",
+      "version": "2.8.0",
       "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.1",
+  "version": "2.8.0",
   "author": {
     "name": "TheGlitchKing",
     "email": "theglitchking@users.noreply.github.com"

package/README.md

@@ -874,6 +874,23 @@ src/
     └── logger.ts            # Logging and output formatting
 ```
 
+### Lifecycle enforcement (2.8.0+)
+
+hewtd's policy is now **binding on an agent**, not merely documented. A
+`PreToolUse` hook — run by the harness, not the model — **denies** the two
+destructive violations: hand-editing a generated `INDEX.md`/`REGISTRY.md` (it is
+rebuilt from disk; edits are discarded) and `rm`-ing a doc under
+`.documentation/` (use `hewtd archive` — reversible and link-safe). It **warns**,
+without blocking, on `status: deprecated` without archiving and on starting a
+rival `docs/` folder.
+
+It **fails open**: no `.documentation/` tree, or any internal error, and it allows
+everything silently. Both rules are opt-out via an `enforcement` block in
+`.claude/hit-em-with-the-docs.json`. A `SessionStart` brief and a model-invocable
+skill round it out — no `CLAUDE.md` is written or modified.
+
+**Full reference: [docs/enforcement.md](docs/enforcement.md).**
+
 ### Indexing: what counts as a document
 
 `INDEX.md` and `REGISTRY.md` are **generated** — `index`, `maintain`, and

package/dist/action/core/enforce/guard.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Lifecycle enforcement — the decision function behind the PreToolUse hook.
+ *
+ * hewtd's lifecycle policy has always been enforced at the CLI boundary (the
+ * archive link guard, `auto: false`, the frontmatter schema). None of that
+ * binds an *agent*, which will happily `rm` a doc, hand-edit a generated
+ * INDEX.md, or invent its own `docs/` folder. This is the part the model
+ * cannot reason its way past: the harness runs it, and a `deny` is final.
+ *
+ * Two rules deny, because they destroy work or corrupt a generated artifact.
+ * Everything else at most warns. Anything unrecognized is allowed — this runs
+ * in every session the plugin is installed in, including repos that have
+ * nothing to do with hewtd, so the cost of a false positive is far higher
+ * than the cost of a miss.
+ */
+export type GuardDecision = {
+    action: 'allow';
+} | {
+    action: 'warn';
+    context: string;
+} | {
+    action: 'deny';
+    reason: string;
+};
+export interface GuardInput {
+    toolName: string;
+    /** `file_path` for Write/Edit. */
+    filePath?: string;
+    /** `command` for Bash. */
+    command?: string;
+    /** `content` (Write) or `new_string` (Edit) — used to spot lifecycle changes. */
+    text?: string;
+    /** Docs root relative to the project, e.g. `.documentation`. */
+    docsDir: string;
+}
+/** Which enforcement rules are active. Both default on; users can opt out. */
+export interface EnforcementPolicy {
+    blockIndexEdits: boolean;
+    blockDocDeletion: boolean;
+}
+export declare const DEFAULT_ENFORCEMENT: EnforcementPolicy;
+/**
+ * Is this path inside an `archive/` folder, at any depth?
+ *
+ * Archived docs are **referenceable but never concrete** — history you may cite,
+ * never evidence of what is true now. Nothing under an `archive/` folder is
+ * indexed, audited, link-checked, or validated.
+ */
+export declare function isArchived(path: string): boolean;
+/**
+ * Decide what to do about one tool call. Pure — all I/O lives in the hook.
+ */
+export declare function evaluate(input: GuardInput, policy?: EnforcementPolicy): GuardDecision;
+//# sourceMappingURL=guard.d.ts.map

package/dist/action/core/enforce/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/core/enforce/guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,mBAAmB,EAAE,iBAGjC,CAAC;AAOF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIhD;AA4BD;;GAEG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,MAAM,GAAE,iBAAuC,GAC9C,aAAa,CA4Gf"}

package/dist/action/index.d.ts

@@ -34,6 +34,7 @@ export * from './reports/link-report.js';
 export * from './core/archive/manage.js';
 export * from './core/archive/candidates.js';
 export * from './core/archive/links.js';
+export * from './core/enforce/guard.js';
 export * from './core/metadata/errors.js';
 export * from './core/knowledge-base/citers.js';
 export * from './generators/facts-index.js';

package/dist/action/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAG3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAGhD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAGhD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AAGzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"","sourceRoot":"","sources":["file:///home/tmarlette/workspace/the-glitch-kingdom/hit-em-with-the-docs/src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAG3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAGhD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAGhD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AAGzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}