@esoteric-logic/praxis-harness 1.1.0 → 1.2.0

package/README.md

@@ -84,7 +84,7 @@ For technical research: `/discover` (structured options evaluation before decisi
 
 Key additions in this version:
 - **context-management** — context brackets (FRESH/MODERATE/DEPLETED/CRITICAL) adapt behavior to session stage
-- **vault** — multi-backend vault integration (obsidian, logseq, plain, custom)
+- **vault** — Obsidian vault integration
 
 ## Ralph
 
@@ -111,7 +111,7 @@ Ralph is not a replacement for GSD — it runs GSD internally per story. Use GSD
 │  GSD → Superpowers → Ralph             │
 ├────────────────────────────────────────┤
 │  Vault layer                           │
-│  obsidian | logseq | plain | custom    │
+│  Obsidian                              │
 ├────────────────────────────────────────┤
 │  Claude Code                           │
 │  ~/.claude/ + plugins + subagents      │
@@ -131,16 +131,9 @@ More kits coming. See `docs/creating-a-kit.md` to build your own.
 
 ## Vault integration
 
-Praxis integrates with a persistent vault for project state, session learnings, and architecture decisions. Four backends are supported:
+Praxis integrates with an Obsidian vault for project state, session learnings, and architecture decisions.
 
-| Backend | Description | Search tool |
-|---------|-------------|-------------|
-| `obsidian` | Obsidian vault (default) | [Obsidian CLI](https://obsidian.md) |
-| `logseq` | Logseq graph | ripgrep |
-| `plain` | Plain markdown directory (`~/.praxis-vault`) | ripgrep |
-| `custom` | Any directory you choose | ripgrep |
-
-The backend and vault path are configured per machine during install:
+The vault path is configured per machine during install:
 
 ```json
 {
@@ -151,8 +144,7 @@ The backend and vault path are configured per machine during install:
 }
 ```
 
-- **obsidian**: requires [Obsidian CLI](https://obsidian.md) (enable in Obsidian Settings > General > Command line interface). Obsidian must be running for vault search.
-- **logseq/plain/custom**: uses ripgrep for vault search — no extra dependencies
+Requires [Obsidian CLI](https://obsidian.md) (enable in Obsidian Settings > General > Command line interface). Obsidian must be running for vault search.
 
 ## Updating
 
@@ -185,7 +177,7 @@ The git-clone + `install.sh` path uses symlinks instead of copies, so edits in t
 - macOS or Linux
 - Claude Code CLI
 - Node.js 18+
-- Obsidian, Logseq, or a plain markdown directory (optional, for vault integration)
+- Obsidian with CLI enabled (for vault integration)
 
 ## License
 

package/base/CLAUDE.md

@@ -57,7 +57,6 @@ Vault path and backend are machine-specific. Read from `~/.claude/praxis.config.
 ```json
 { "vault_path": "/path/to/vault", "vault_backend": "obsidian" }
 ```
-Supported backends: `obsidian` (default), `logseq`, `plain`, `custom`.
 If config file is missing: tell the user to run `praxis/install.sh`.
 All `{vault_path}` references in rules and skills resolve from this config.
 
@@ -75,7 +74,7 @@ Context is volatile. Files are permanent. Act accordingly.
 ## Vault Protocol
 - ALWAYS run a vault search before reading vault files (see vault.md backend table).
 - Obsidian indexes in real-time — no manual update command needed.
-- Link format: obsidian → `[[wikilinks]]`; logseq/plain/custom → standard markdown links.
+- Link format: `[[wikilinks]]` for all internal vault references.
 - Detect project from CWD matching `local_path` in `_index.md`.
 
 ## MCP Servers
@@ -84,9 +83,10 @@ Registered via `claude mcp add`. Persist globally across sessions.
 | Server | Purpose | API Key |
 |--------|---------|---------|
 | context7 | Live library/API docs | None |
-| perplexity | AI web search | `PERPLEXITY_API_KEY` |
 | github | Repo operations, PRs, issues | `GITHUB_PERSONAL_ACCESS_TOKEN` |
 
+Optional: `perplexity` (AI web search). Run `bash scripts/onboard-mcp.sh perplexity` to add.
+
 Check: `claude mcp list` | Manage: `bash scripts/onboard-mcp.sh [server|all]`
 Missing servers are non-blocking — features degrade gracefully.
 
@@ -135,7 +135,7 @@ Kit manifests live in `~/.claude/kits/<name>/KIT.md`.
 | `~/.claude/rules/git-workflow.md` | Commits, branches, identity verification |
 | `~/.claude/rules/security.md` | Secrets, credentials, auth patterns |
 | `~/.claude/rules/communication.md` | Client writing, no AI attribution |
-| `~/.claude/rules/vault.md` | Second brain integration — obsidian, logseq, or plain markdown |
+| `~/.claude/rules/vault.md` | Second brain integration — Obsidian vault |
 | `~/.claude/rules/architecture.md` | ADR format, What/So What/Now What, risk docs |
 | `~/.claude/rules/context-management.md` | GSD/Ralph anti-rot, context reset protocol |
 

package/base/commands/context-reset.md

@@ -15,7 +15,7 @@ You are preparing a clean context reset for the current session.
 - Identify: current milestone, last 3 decisions, any STOP conditions or blockers
 
 **Step 3 — Write context checkpoint**
-Write a standalone checkpoint file at `{vault_path}/plans/current-phase-summary.md`:
+Write a standalone checkpoint file at `{vault_path}/plans/{YYYY-MM-DD}-context-checkpoint.md`:
 
 ```markdown
 ---
@@ -58,7 +58,7 @@ Write a session snapshot to `claude-progress.json`:
 Print:
 ```
 Context checkpoint saved to:
-  Checkpoint: {vault_path}/plans/current-phase-summary.md
+  Checkpoint: {vault_path}/plans/{YYYY-MM-DD}-context-checkpoint.md
   Status:     {vault_path}/status.md
   Progress:   {vault_path}/claude-progress.json
 
@@ -67,6 +67,6 @@ Run /clear to reset context, then paste this bootstrap prompt:
   Context reset. Bootstrap:
   1. Read project CLAUDE.md
   2. Read {vault_path}/plans/{current-plan}
-  3. Read {vault_path}/plans/current-phase-summary.md
+  3. Read {vault_path}/plans/{YYYY-MM-DD}-context-checkpoint.md
   4. Resume from milestone: {milestone-name}
 ```

package/base/commands/gsd-verify.md

@@ -32,7 +32,7 @@ If no commands are defined: warn and ask user for the correct commands.
 
 **Step 3b — UNIFY (mandatory after all milestones verified)**
 After self-review passes, write phase summary:
-- Write `{vault_path}/plans/current-phase-summary.md`:
+- Write `{vault_path}/plans/{YYYY-MM-DD}_{project-slug}-phase-summary.md`:
   ```markdown
   ---
   tags: [unify, {project-slug}]

package/base/hooks/post-session-lint.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Stop hook — runs project lint command as an advisory check.
+# Always exits 0 (never blocks session end).
+set -uo pipefail
+
+CONFIG_FILE="$HOME/.claude/praxis.config.json"
+
+# Find project CLAUDE.md by walking up from CWD
+find_project_claude_md() {
+  local dir="$PWD"
+  while [[ "$dir" != "/" ]]; do
+    if [[ -f "$dir/CLAUDE.md" ]]; then
+      echo "$dir/CLAUDE.md"
+      return 0
+    fi
+    dir=$(dirname "$dir")
+  done
+  return 1
+}
+
+CLAUDE_MD=$(find_project_claude_md 2>/dev/null) || exit 0
+
+# Extract lint command from ## Commands section
+LINT_CMD=$(awk '/^## Commands/,/^## /{
+  if (/^lint:/) { sub(/^lint:[[:space:]]*/, ""); print; exit }
+}' "$CLAUDE_MD" 2>/dev/null)
+
+if [[ -z "$LINT_CMD" || "$LINT_CMD" == "#"* ]]; then
+  exit 0
+fi
+
+echo "Running lint: $LINT_CMD" >&2
+if eval "$LINT_CMD" 2>&1 | tail -20 >&2; then
+  echo "Lint: PASS" >&2
+else
+  echo "Lint: warnings found (advisory only)" >&2
+fi
+
+exit 0

package/base/hooks/secret-scan.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# PreToolUse hook — blocks Write/Edit if file contains secret patterns.
+# Exit 0 = allow, Exit 2 = block with message.
+set -euo pipefail
+
+# Claude Code passes tool input as JSON via stdin for PreToolUse hooks
+INPUT=$(cat)
+
+# Extract file_path from the JSON input (works for Write, Edit tools)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.path // empty' 2>/dev/null)
+
+if [[ -z "$FILE_PATH" || ! -f "$FILE_PATH" ]]; then
+  exit 0
+fi
+
+# Scan the file for secret patterns
+SECRET_PATTERN='(sk-[a-zA-Z0-9]{20,}|ghp_[a-zA-Z0-9]{36,}|pplx-[a-zA-Z0-9]{20,}|AKIA[0-9A-Z]{16}|Bearer [A-Za-z0-9+/]{20,})'
+
+if rg -q "$SECRET_PATTERN" "$FILE_PATH" 2>/dev/null; then
+  MATCHES=$(rg -n "$SECRET_PATTERN" "$FILE_PATH" 2>/dev/null | head -5)
+  echo "BLOCKED: Potential secret detected in $FILE_PATH" >&2
+  echo "$MATCHES" >&2
+  echo "Remove the secret before proceeding." >&2
+  exit 2
+fi
+
+exit 0

package/base/hooks/vault-checkpoint.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# PreCompact hook — writes minimal checkpoint to vault before context compaction.
+# Always exits 0 (advisory, never blocks compaction).
+set -uo pipefail
+
+CONFIG_FILE="$HOME/.claude/praxis.config.json"
+
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  exit 0
+fi
+
+VAULT_PATH=$(jq -r '.vault_path // empty' "$CONFIG_FILE" 2>/dev/null)
+if [[ -z "$VAULT_PATH" || ! -d "$VAULT_PATH" ]]; then
+  exit 0
+fi
+
+PLANS_DIR="$VAULT_PATH/plans"
+mkdir -p "$PLANS_DIR"
+
+DATE=$(date +%Y-%m-%d)
+TIMESTAMP=$(date +"%Y-%m-%d %H:%M:%S")
+CHECKPOINT_FILE="$PLANS_DIR/$DATE-compact-checkpoint.md"
+
+BRANCH=$(git --no-pager rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
+LAST_COMMIT=$(git --no-pager log --oneline -1 2>/dev/null || echo "no commits")
+PROJECT_DIR=$(basename "$PWD")
+
+cat > "$CHECKPOINT_FILE" <<EOF
+---
+tags: [checkpoint, compact]
+date: $DATE
+source: agent
+---
+# Compact Checkpoint — $TIMESTAMP
+
+## Working Directory
+$PWD
+
+## Git State
+- Branch: $BRANCH
+- Last commit: $LAST_COMMIT
+
+## Note
+This checkpoint was auto-written by the PreCompact hook.
+Read this file after compaction to restore context.
+EOF
+
+echo "Vault checkpoint written: $CHECKPOINT_FILE" >&2
+exit 0

package/base/rules/vault.md

@@ -3,20 +3,13 @@
 
 ---
 
-## Backend Detection
-Read `vault_backend` from `~/.claude/praxis.config.json`. Defaults to `"obsidian"` if absent.
+## Vault Backend
 
-| Backend | Search command | Update after write | Link format |
-|---------|---------------|-------------------|-------------|
-| `obsidian` | `obsidian search query="{query}" limit=5` | no-op (real-time indexing) | `[[wikilinks]]` |
-| `logseq` | `rg -l "{query}" {vault_path} --glob "*.md" \| head -5` | no-op | standard markdown links |
-| `plain` | `rg -l "{query}" {vault_path} --glob "*.md" \| head -5` | no-op | standard markdown links |
-| `custom` | `rg -l "{query}" {vault_path} --glob "*.md" \| head -5` | no-op | standard markdown links |
-
-**Note:** The Obsidian CLI requires Obsidian to be running. If Obsidian is not running, vault search will fail.
+Vault backend is Obsidian. Search: `obsidian search query="{query}" limit=5`
 Scope searches with `path=` filter: `obsidian search query="{query}" path="01_Projects" limit=5`
 
-All commands below use the backend table above. When a step says "vault search" or "vault update", substitute the correct command for the active backend.
+**Note:** The Obsidian CLI requires Obsidian to be running. If Obsidian is not running, vault search will fail.
+Use `[[wikilinks]]` for all internal vault references.
 
 ## Vault Location
 Read vault_path from `~/.claude/praxis.config.json`.
@@ -51,7 +44,6 @@ Never ask "should I save this?" for the above categories — just save it.
 
 ### No manual index update needed
 - Obsidian indexes vault changes in real-time — no update command required.
-- For all other backends: files are read directly, no indexing needed.
 
 ---
 
@@ -83,9 +75,7 @@ source: agent | human | meeting
 ---
 ```
 
-Link format depends on backend:
-- `obsidian` → use `[[wikilinks]]` for all internal vault references
-- `logseq`, `plain`, `custom` → use standard markdown links
+Use `[[wikilinks]]` for all internal vault references.
 
 ### Bootstrap templates
 If `status.md`, `tasks.md`, or `_index.md` are missing from a project vault directory,

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

@@ -140,10 +140,8 @@ Vault indexing is automatic.
 
 ## Phase 7 — Confirm & Open Vault
 
-Open the vault in the user's app (backend-conditional):
-- `obsidian` → `open "obsidian://open?vault=Obsidian"`
-- `logseq` → `open "logseq://graph/{vault_name}"`
-- `plain` / `custom` → print vault path for user to open manually
+Open the vault in Obsidian:
+- `open "obsidian://open?vault=Obsidian"`
 
 Print summary table with all created files and bootstrap sequence.
 

package/base/skills/scaffold-new/references/gitignore-template.txt

@@ -14,7 +14,6 @@ agent-memory.jsonl
 .obsidian-local/
 .obsidian/workspace
 .obsidian/workspace.json
-.logseq/
 
 # ── OS and Editor Noise ───────────────────────────────────────────────────
 .DS_Store

package/bin/praxis.js

@@ -107,43 +107,7 @@ async function install() {
     const readline = require('readline/promises');
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
 
-    console.log('');
-    console.log('  Choose a vault backend:');
-    console.log('    [1] Obsidian (default)');
-    console.log('    [2] Logseq');
-    console.log('    [3] Plain markdown (~/.praxis-vault)');
-    console.log('    [4] Custom path');
-    console.log('');
-    const backendChoice = await rl.question('  Choice [1]: ');
-    const choice = (backendChoice || '1').trim();
-
-    let vaultBackend = 'obsidian';
-    let vaultPath = '';
-
-    switch (choice) {
-      case '1':
-        vaultBackend = 'obsidian';
-        vaultPath = await rl.question('  Obsidian vault path: ');
-        break;
-      case '2':
-        vaultBackend = 'logseq';
-        vaultPath = await rl.question('  Logseq vault path: ');
-        break;
-      case '3':
-        vaultBackend = 'plain';
-        vaultPath = path.join(os.homedir(), '.praxis-vault');
-        fs.mkdirSync(vaultPath, { recursive: true });
-        ok('Created ' + vaultPath);
-        break;
-      case '4':
-        vaultBackend = 'custom';
-        vaultPath = await rl.question('  Vault path: ');
-        break;
-      default:
-        vaultBackend = 'obsidian';
-        vaultPath = await rl.question('  Vault path: ');
-        break;
-    }
+    let vaultPath = await rl.question('  Obsidian vault path: ');
     rl.close();
 
     if (vaultPath) {
@@ -153,7 +117,7 @@ async function install() {
     const config = {
       version: '1.1.0',
       vault_path: vaultPath || '',
-      vault_backend: vaultBackend,
+      vault_backend: 'obsidian',
       repo_path: PKG_DIR
     };
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
@@ -162,22 +126,9 @@ async function install() {
     dim('praxis.config.json already exists — skipping');
   }
 
-  // Tool checks (conditional on backend)
+  // Tool checks
   header('Tool check');
-  let vaultBackendForCheck = 'obsidian';
-  if (fs.existsSync(CONFIG_FILE)) {
-    try {
-      const cfg = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
-      vaultBackendForCheck = cfg.vault_backend || 'obsidian';
-    } catch {}
-  }
-
-  const baseTools = ['node', 'claude', 'jq'];
-  if (vaultBackendForCheck === 'obsidian') {
-    baseTools.push('obsidian');
-  } else {
-    baseTools.push('rg');
-  }
+  const baseTools = ['node', 'claude', 'jq', 'obsidian'];
   for (const tool of baseTools) {
     if (toolExists(tool)) {
       ok(tool + ' available');
@@ -262,21 +213,9 @@ function health() {
     } catch { total++; fail('praxis.config.json is invalid JSON'); }
   }
 
-  // Tools (conditional on backend)
+  // Tools
   console.log('\nTools:');
-  let healthBackend = 'obsidian';
-  if (fs.existsSync(CONFIG_FILE)) {
-    try {
-      const cfg = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
-      healthBackend = cfg.vault_backend || 'obsidian';
-    } catch {}
-  }
-  const healthTools = ['node', 'claude', 'jq'];
-  if (healthBackend === 'obsidian') {
-    healthTools.push('obsidian');
-  } else {
-    healthTools.push('rg');
-  }
+  const healthTools = ['node', 'claude', 'jq', 'obsidian'];
   for (const tool of healthTools) {
     check(toolExists(tool), tool + ' available');
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esoteric-logic/praxis-harness",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Layered Claude Code harness — workflow discipline, AI-Kits, persistent vault integration",
   "bin": {
     "praxis-harness": "./bin/praxis.js"
@@ -19,7 +19,14 @@
     "type": "git",
     "url": "https://github.com/arcanesme/praxis.git"
   },
-  "keywords": ["claude-code", "ai-harness", "vault", "obsidian", "logseq", "workflow", "gsd"],
+  "keywords": [
+    "claude-code",
+    "ai-harness",
+    "vault",
+    "obsidian",
+    "workflow",
+    "gsd"
+  ],
   "author": "arcanesme",
   "license": "MIT",
   "engines": {

package/scripts/health-check.sh

@@ -88,18 +88,10 @@ if [[ -f "$CONFIG_FILE" ]]; then
   fi
 fi
 
-# ─── Required tools (conditional on backend) ───
+# ─── Required tools ───
 echo ""
 echo "Tools:"
-VAULT_BACKEND=""
-if [[ -f "$CONFIG_FILE" ]]; then
-  VAULT_BACKEND=$(jq -r '.vault_backend // "obsidian"' "$CONFIG_FILE" 2>/dev/null)
-fi
-if [[ "$VAULT_BACKEND" == "obsidian" ]]; then
-  check "command -v obsidian" "Obsidian CLI available"
-else
-  check "command -v rg" "ripgrep available"
-fi
+check "command -v obsidian" "Obsidian CLI available"
 check "command -v node" "node available"
 check "command -v claude" "claude available"
 check "command -v jq" "jq available"
@@ -109,7 +101,7 @@ echo ""
 echo "MCP Servers:"
 if command -v claude &>/dev/null; then
   MCP_LIST=$(claude mcp list 2>/dev/null || true)
-  for server in context7 perplexity github; do
+  for server in context7 github; do
     TOTAL=$((TOTAL + 1))
     if echo "$MCP_LIST" | grep -q "$server"; then
       echo "  ✓ $server registered"

package/scripts/update.sh

@@ -57,18 +57,10 @@ for kit_dir in "$REPO_PATH"/kits/*/; do
   fi
 done
 
-# ─── Verify key tools (conditional on backend) ───
+# ─── Verify key tools ───
 echo ""
 echo "Verifying tools..."
-VAULT_BACKEND=""
-if [[ -f "$CONFIG_FILE" ]]; then
-  VAULT_BACKEND=$(jq -r '.vault_backend // "obsidian"' "$CONFIG_FILE" 2>/dev/null)
-fi
-if [[ "$VAULT_BACKEND" == "obsidian" ]]; then
-  command -v obsidian &>/dev/null && echo "  ✓ Obsidian CLI available" || echo "  ✗ Obsidian CLI not found"
-else
-  command -v rg &>/dev/null && echo "  ✓ ripgrep available" || echo "  ✗ ripgrep not found"
-fi
+command -v obsidian &>/dev/null && echo "  ✓ Obsidian CLI available" || echo "  ✗ Obsidian CLI not found"
 command -v claude &>/dev/null && echo "  ✓ claude available" || echo "  ✗ claude not found"
 command -v node &>/dev/null && echo "  ✓ node available" || echo "  ✗ node not found"