@esoteric-logic/praxis-harness 2.0.1 → 2.0.3

package/base/skills/architecture-patterns/SKILL.md

@@ -1,12 +1,6 @@
 ---
 name: architecture-patterns
-description: >
-  Architecture decision and design documentation standards. Auto-triggers when
-  writing ADRs, technical specs, risk register entries, system design documents,
-  or any decision that affects system design, network topology, identity model,
-  data residency, security posture, or compliance scope. Also triggers when
-  writing status updates, blocker reports, or spec summaries that require
-  What/So What/Now What structure.
+description: "Architecture decision and design documentation standards. Auto-triggers when writing ADRs, technical specs, risk register entries, system design documents, or any decision that affects system design, network topology, identity model, data residency, security posture, or compliance scope. Also triggers when writing status updates, blocker reports, or spec summaries that require What/So What/Now What structure."
 ---
 
 # Architecture Patterns

package/base/skills/code-gc/SKILL.md

@@ -1,10 +1,7 @@
 ---
 name: code-gc
 disable-model-invocation: true
-description: Detect code entropy in the current repo. Dead code, test debt, stale
-  TODOs, oversized functions, commented-out blocks, unused deps. Two modes:
-  lightweight (called by session-retro) and full audit (manual /code-gc).
-  Never auto-deletes or auto-fixes. Side-effect skill — never auto-triggers.
+description: "Detect code entropy in the current repo: dead code, test debt, stale TODOs, oversized functions, commented-out blocks, unused deps. Two modes: lightweight (called by session-retro) and full audit (manual /code-gc). Never auto-deletes or auto-fixes."
 ---
 
 # code-gc Skill

package/base/skills/communication-standards/SKILL.md

@@ -1,12 +1,6 @@
 ---
 name: communication-standards
-description: >
-  Client-facing writing standards. Auto-triggers when writing proposals,
-  status reports, executive summaries, SOWs, deliverable documents, or any
-  content targeting a non-technical audience. Also triggers when writing
-  git commit messages, PR descriptions, or any text where AI attribution
-  must be avoided. Covers executive-summary-first rule, What/So What/Now What
-  structure, proposal format, audience calibration, and no-AI-attribution policy.
+description: "Client-facing writing standards. Auto-triggers when writing proposals, status reports, executive summaries, SOWs, deliverable documents, or any content targeting a non-technical audience. Also triggers when writing git commit messages, PR descriptions, or any text where AI attribution must be avoided. Covers executive-summary-first rule, What/So What/Now What structure, proposal format, audience calibration, and no-AI-attribution policy."
 ---
 
 # Communication Standards

package/base/skills/context7-lookup/SKILL.md

@@ -1,10 +1,6 @@
 ---
 name: context7-lookup
-description: >
-  Enforces the docs-first mandate from coding.md. Before implementing with
-  any external library, framework, or API, use Context7 to retrieve current
-  documentation. Activates when code references an external package, imports
-  a third-party library, or calls an API that releases frequently.
+description: "Enforces the docs-first mandate from coding.md. Before implementing with any external library, framework, or API, use Context7 to retrieve current documentation. Activates when code references an external package, imports a third-party library, or calls an API that releases frequently."
 ---
 
 # context7-lookup Skill

package/base/skills/managing-git-identities/SKILL.md

@@ -1,10 +1,6 @@
 ---
 name: managing-git-identities
-description: >
-  Guides setup and troubleshooting of multiple Git identities
-  (SSH keys, commit author, GitHub CLI auth, includeIf directory
-  routing). Activates when user discusses git accounts, commit
-  identity mismatch, SSH key management, or gh auth switching.
+description: "Guides setup and troubleshooting of multiple Git identities (SSH keys, commit author, GitHub CLI auth, includeIf directory routing). Activates when user discusses git accounts, commit identity mismatch, SSH key management, or gh auth switching."
 ---
 
 ## Two Independent Problems

package/base/skills/plan-writer/SKILL.md

@@ -1,10 +1,7 @@
 ---
 name: plan-writer
 disable-model-invocation: true
-description: >
-  Writes a dated work plan to the vault plans/ directory. Creates the plan
-  file with YAML frontmatter, milestones, and acceptance criteria. Updates
-  status.md current_plan field. Called by /plan and /discuss workflows.
+description: "Writes a dated work plan to the vault plans/ directory. Creates the plan file with YAML frontmatter, milestones, and acceptance criteria. Updates status.md current_plan field. Called by /plan and /discuss workflows."
 ---
 
 # plan-writer Skill

package/base/skills/pre-commit-lint/SKILL.md

@@ -1,10 +1,7 @@
 ---
 name: pre-commit-lint
 disable-model-invocation: true
-description: Generate a stack-aware pre-commit hook script for a repo. Use when setting
-  up a new repo, when asked to "install pre-commit checks", "add linting to commits",
-  or "wire pre-commit-lint". Also invoked by scaffold-new Phase 5.5.
-  NOT invoked at commit time — generates a shell script that runs at commit time.
+description: "Generate a stack-aware pre-commit hook script for a repo. Use when setting up a new repo, when asked to install pre-commit checks, add linting to commits, or wire pre-commit-lint. Also invoked by scaffold-new Phase 5.5. NOT invoked at commit time — generates a shell script that runs at commit time."
 ---
 
 # pre-commit-lint Skill

package/base/skills/review/SKILL.md

@@ -1,8 +1,7 @@
 ---
 name: review
 disable-model-invocation: true
-description: Manual code review trigger. Launches a subagent to review a diff for
-  bugs, security, and convention violations. Use independently of Praxis phases.
+description: "Manual code review trigger. Launches a subagent to review a diff for bugs, security, and convention violations. Use independently of Praxis phases."
 ---
 
 # review Skill

package/base/skills/scaffold-exist/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: scaffold-exist
 disable-model-invocation: true
-description: Scaffold an existing project into the full harness. Invoke with /scaffold-exist only.
-  Adds missing harness files to projects that predate the scaffold standard.
-  Non-destructive — never overwrites without confirmation. Side-effect skill — never auto-triggers.
+description: "Scaffold an existing project into the full harness. Invoke with /scaffold-exist only. Adds missing harness files to projects that predate the scaffold standard. Non-destructive — never overwrites without confirmation. Side-effect skill — never auto-triggers."
 ---
 
 # scaffold-exist Skill

package/base/skills/scaffold-new/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: scaffold-new
 disable-model-invocation: true
-description: Scaffold a brand new project into the full harness. Invoke with /scaffold-new only.
-  Creates repo CLAUDE.md, vault subtree, git identity verification, gitignore,
-  pre-commit hook, and Project Registry entry. Side-effect skill — never auto-triggers.
+description: "Scaffold a brand new project into the full harness. Invoke with /scaffold-new only. Creates repo CLAUDE.md, vault subtree, git identity verification, gitignore, pre-commit hook, and Project Registry entry. Side-effect skill — never auto-triggers."
 ---
 
 # scaffold-new Skill

package/base/skills/secret-scan/SKILL.md

@@ -1,10 +1,6 @@
 ---
 name: secret-scan
-description: >
-  Canonical secret scanning skill. Scans files for credential patterns
-  (API keys, tokens, connection strings). Called by pre-commit-lint and
-  ship workflows. Also usable standalone for repo-wide audits. Replaces
-  all inline secret scan regex instances with a single authoritative source.
+description: "Canonical secret scanning skill. Scans files for credential patterns (API keys, tokens, connection strings). Called by pre-commit-lint and ship workflows. Also usable standalone for repo-wide audits. Replaces all inline secret scan regex instances with a single authoritative source."
 ---
 
 # secret-scan Skill

package/base/skills/session-retro/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: session-retro
 disable-model-invocation: true
-description: End-of-session retrospective. Invoke manually with /session-retro only.
-  Writes [LEARN:tag] entries, proposes rule updates, updates claude-progress.json,
-  triggers vault-gc lightweight check. Side-effect skill — never auto-triggers.
+description: "End-of-session retrospective. Invoke manually with /session-retro only. Writes [LEARN:tag] entries, proposes rule updates, updates claude-progress.json, triggers vault-gc lightweight check. Side-effect skill — never auto-triggers."
 ---
 
 # session-retro Skill

package/base/skills/simplify/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: simplify
 disable-model-invocation: true
-description: Post-implementation code simplification. Launches a subagent to review
-  recent changes for unnecessary complexity, over-abstraction, and opportunities to
-  simplify. Runs after any implementation phase. Side-effect skill — never auto-triggers.
+description: "Post-implementation code simplification. Launches a subagent to review recent changes for unnecessary complexity, over-abstraction, and opportunities to simplify. Runs after any implementation phase. Side-effect skill — never auto-triggers."
 ---
 
 # simplify Skill

package/base/skills/status-update/SKILL.md

@@ -1,10 +1,7 @@
 ---
 name: status-update
 disable-model-invocation: true
-description: >
-  Atomic update to vault status.md. Ensures consistent format, enforces
-  the 100-line limit, and archives resolved items. Called at milestone
-  boundaries, session end, and phase transitions.
+description: "Atomic update to vault status.md. Ensures consistent format, enforces the 100-line limit, and archives resolved items. Called at milestone boundaries, session end, and phase transitions."
 ---
 
 # status-update Skill

package/base/skills/vault-gc/SKILL.md

@@ -1,9 +1,7 @@
 ---
 name: vault-gc
 disable-model-invocation: true
-description: Audit vault health and detect entropy. Invoke manually with /vault-gc
-  only. Two modes — full audit (manual) and lightweight staleness check (called
-  inline by session-retro). Never auto-deletes. Side-effect skill — never auto-triggers.
+description: "Audit vault health and detect entropy. Invoke manually with /vault-gc only. Two modes — full audit (manual) and lightweight staleness check (called inline by session-retro). Never auto-deletes. Side-effect skill — never auto-triggers."
 ---
 
 # vault-gc Skill

package/base/skills/verify-app/SKILL.md

@@ -1,10 +1,7 @@
 ---
 name: verify-app
 disable-model-invocation: true
-description: End-to-end application verification. Launches a subagent to run the full
-  test suite, check build, verify runtime behavior, and confirm acceptance criteria.
-  Use after implementation to catch integration issues that unit tests miss.
-  Side-effect skill — never auto-triggers.
+description: "End-to-end application verification. Launches a subagent to run the full test suite, check build, verify runtime behavior, and confirm acceptance criteria. Use after implementation to catch integration issues that unit tests miss. Side-effect skill — never auto-triggers."
 ---
 
 # verify-app Skill

package/bin/praxis.js

@@ -37,7 +37,7 @@ async function install() {
   header('Praxis Harness v' + VERSION);
 
   // Ensure ~/.claude/ structure
-  for (const sub of ['rules', 'commands', 'skills']) {
+  for (const sub of ['rules', 'skills', 'hooks']) {
     fs.mkdirSync(path.join(CLAUDE_DIR, sub), { recursive: true });
   }
 
@@ -59,17 +59,6 @@ async function install() {
     ok(count + ' rules installed');
   }
 
-  // Copy base/commands/* → ~/.claude/commands/
-  const cmdsDir = path.join(PKG_DIR, 'base', 'commands');
-  if (fs.existsSync(cmdsDir)) {
-    let count = 0;
-    for (const f of fs.readdirSync(cmdsDir)) {
-      copyFile(path.join(cmdsDir, f), path.join(CLAUDE_DIR, 'commands', f));
-      count++;
-    }
-    ok(count + ' commands installed');
-  }
-
   // Copy base/skills/* → ~/.claude/skills/
   const skillsDir = path.join(PKG_DIR, 'base', 'skills');
   if (fs.existsSync(skillsDir)) {
@@ -87,6 +76,35 @@ async function install() {
     ok(count + ' skills installed');
   }
 
+  // Copy base/hooks/*.sh → ~/.claude/hooks/
+  const hooksDir = path.join(PKG_DIR, 'base', 'hooks');
+  if (fs.existsSync(hooksDir)) {
+    let count = 0;
+    for (const f of fs.readdirSync(hooksDir)) {
+      if (f.endsWith('.sh')) {
+        copyFile(path.join(hooksDir, f), path.join(CLAUDE_DIR, 'hooks', f));
+        // Make executable
+        fs.chmodSync(path.join(CLAUDE_DIR, 'hooks', f), 0o755);
+        count++;
+      }
+    }
+    ok(count + ' hooks installed');
+
+    // Merge hooks configuration into settings.json
+    const hooksConfig = path.join(hooksDir, 'settings-hooks.json');
+    const settingsFile = path.join(CLAUDE_DIR, 'settings.json');
+    if (fs.existsSync(hooksConfig)) {
+      const hooksCfg = JSON.parse(fs.readFileSync(hooksConfig, 'utf8'));
+      let settings = {};
+      if (fs.existsSync(settingsFile)) {
+        try { settings = JSON.parse(fs.readFileSync(settingsFile, 'utf8')); } catch {}
+      }
+      Object.assign(settings, hooksCfg);
+      fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
+      ok('hooks configuration merged into settings.json');
+    }
+  }
+
   // Copy kits/ → ~/.claude/kits/
   const kitsDir = path.join(PKG_DIR, 'kits');
   if (fs.existsSync(kitsDir)) {
@@ -94,11 +112,29 @@ async function install() {
     ok('kits installed');
   }
 
-  // Orphan cleanup: obsidian.md renamed to vault.md
-  const legacyObsidian = path.join(CLAUDE_DIR, 'rules', 'obsidian.md');
-  if (fs.existsSync(legacyObsidian)) {
-    fs.unlinkSync(legacyObsidian);
-    ok('Removed legacy obsidian.md (renamed to vault.md)');
+  // Orphan cleanup: deleted rules and legacy files
+  const orphans = [
+    'obsidian.md', 'code-quality.md', 'security.md',
+    'communication.md', 'architecture.md'
+  ];
+  for (const f of orphans) {
+    const target = path.join(CLAUDE_DIR, 'rules', f);
+    if (fs.existsSync(target)) {
+      fs.unlinkSync(target);
+      dim('removed legacy ' + f);
+    }
+  }
+
+  // Orphan cleanup: old commands directory (v1.x)
+  const oldCmdsDir = path.join(CLAUDE_DIR, 'commands');
+  if (fs.existsSync(oldCmdsDir)) {
+    const files = fs.readdirSync(oldCmdsDir);
+    if (files.length > 0) {
+      for (const f of files) {
+        fs.unlinkSync(path.join(oldCmdsDir, f));
+      }
+      dim('cleaned up ' + files.length + ' legacy command files');
+    }
   }
 
   // Vault configuration
@@ -115,7 +151,7 @@ async function install() {
     }
 
     const config = {
-      version: '1.1.0',
+      version: VERSION,
       vault_path: vaultPath || '',
       vault_backend: 'obsidian',
       repo_path: PKG_DIR
@@ -140,7 +176,7 @@ async function install() {
   // Summary
   header('Install complete');
   console.log('  Files copied to ' + CLAUDE_DIR);
-  console.log('  Run: npx praxis-harness health');
+  console.log('  Run: npx @esoteric-logic/praxis-harness health');
   console.log('');
 }
 
@@ -177,15 +213,6 @@ function health() {
     }
   }
 
-  // Commands
-  console.log('\nCommands:');
-  const cmdsDir = path.join(PKG_DIR, 'base', 'commands');
-  if (fs.existsSync(cmdsDir)) {
-    for (const f of fs.readdirSync(cmdsDir)) {
-      check(fs.existsSync(path.join(CLAUDE_DIR, 'commands', f)), 'commands/' + f + ' installed');
-    }
-  }
-
   // Skills
   console.log('\nSkills:');
   const skillsDir = path.join(PKG_DIR, 'base', 'skills');
@@ -195,6 +222,18 @@ function health() {
     }
   }
 
+  // Hooks
+  console.log('\nHooks:');
+  const hooksDir = path.join(PKG_DIR, 'base', 'hooks');
+  if (fs.existsSync(hooksDir)) {
+    for (const f of fs.readdirSync(hooksDir)) {
+      if (f.endsWith('.sh')) {
+        check(fs.existsSync(path.join(CLAUDE_DIR, 'hooks', f)), 'hooks/' + f + ' installed');
+      }
+    }
+  }
+  check(fs.existsSync(path.join(CLAUDE_DIR, 'settings.json')), 'settings.json with hooks configured');
+
   // Kits
   console.log('\nKits:');
   check(fs.existsSync(path.join(CLAUDE_DIR, 'kits')), 'kits directory installed');
@@ -236,34 +275,26 @@ function health() {
 function uninstall() {
   header('Uninstalling Praxis Harness');
 
-  // Remove files that came from base/
+  // Remove CLAUDE.md
   const claudeMd = path.join(CLAUDE_DIR, 'CLAUDE.md');
   if (fs.existsSync(claudeMd)) { fs.unlinkSync(claudeMd); ok('CLAUDE.md removed'); }
 
-  // Remove rules from base/rules/
+  // Remove rules
   const rulesDir = path.join(PKG_DIR, 'base', 'rules');
   if (fs.existsSync(rulesDir)) {
     for (const f of fs.readdirSync(rulesDir)) {
       const target = path.join(CLAUDE_DIR, 'rules', f);
       if (fs.existsSync(target)) fs.unlinkSync(target);
     }
-    // Also remove legacy obsidian.md if present
-    const legacyRule = path.join(CLAUDE_DIR, 'rules', 'obsidian.md');
-    if (fs.existsSync(legacyRule)) fs.unlinkSync(legacyRule);
-    ok('rules removed');
-  }
-
-  // Remove commands from base/commands/
-  const cmdsDir = path.join(PKG_DIR, 'base', 'commands');
-  if (fs.existsSync(cmdsDir)) {
-    for (const f of fs.readdirSync(cmdsDir)) {
-      const target = path.join(CLAUDE_DIR, 'commands', f);
+    // Also remove legacy files
+    for (const f of ['obsidian.md', 'code-quality.md', 'security.md', 'communication.md', 'architecture.md']) {
+      const target = path.join(CLAUDE_DIR, 'rules', f);
       if (fs.existsSync(target)) fs.unlinkSync(target);
     }
-    ok('commands removed');
+    ok('rules removed');
   }
 
-  // Remove skills from base/skills/
+  // Remove skills
   const skillsDir = path.join(PKG_DIR, 'base', 'skills');
   if (fs.existsSync(skillsDir)) {
     for (const entry of fs.readdirSync(skillsDir)) {
@@ -275,6 +306,17 @@ function uninstall() {
     ok('skills removed');
   }
 
+  // Remove hooks
+  const hooksDir = path.join(CLAUDE_DIR, 'hooks');
+  if (fs.existsSync(hooksDir)) {
+    for (const f of fs.readdirSync(hooksDir)) {
+      if (f.endsWith('.sh')) {
+        fs.unlinkSync(path.join(hooksDir, f));
+      }
+    }
+    ok('hooks removed');
+  }
+
   // Remove kits
   const kitsTarget = path.join(CLAUDE_DIR, 'kits');
   if (fs.existsSync(kitsTarget)) {
@@ -282,6 +324,13 @@ function uninstall() {
     ok('kits removed');
   }
 
+  // Remove legacy commands directory
+  const oldCmdsDir = path.join(CLAUDE_DIR, 'commands');
+  if (fs.existsSync(oldCmdsDir)) {
+    fs.rmSync(oldCmdsDir, { recursive: true, force: true });
+    ok('legacy commands directory removed');
+  }
+
   header('Uninstall complete');
   dim('Config file preserved: ' + CONFIG_FILE);
   dim('Run: rm ' + CONFIG_FILE + ' to remove config');
@@ -294,10 +343,10 @@ function printHelp() {
   console.log(`
 praxis-harness v${VERSION}
 
-Usage: npx praxis-harness [command]
+Usage: npx @esoteric-logic/praxis-harness [command]
 
 Commands:
-  install     Copy rules, commands, skills, and kits to ~/.claude/ (default)
+  install     Copy rules, skills, hooks, and kits to ~/.claude/ (default)
   update      Re-copy from latest npm package version
   health      Verify install integrity
   uninstall   Remove Praxis-owned files from ~/.claude/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esoteric-logic/praxis-harness",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Layered Claude Code harness — workflow discipline, AI-Kits, persistent vault integration",
   "bin": {
     "praxis-harness": "./bin/praxis.js"