@esoteric-logic/praxis-harness 1.1.0

package/scripts/update.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+set -euo pipefail
+
+# ════════════════════════════════════════════════════════════════
+#  Praxis — Update
+#  Pull latest, re-run install, update kit dependencies
+# ════════════════════════════════════════════════════════════════
+
+CONFIG_FILE="$HOME/.claude/praxis.config.json"
+
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  echo "No Praxis installation found. Run install.sh first."
+  exit 1
+fi
+
+REPO_PATH=$(jq -r '.repo_path' "$CONFIG_FILE")
+
+if [[ ! -d "$REPO_PATH" ]]; then
+  echo "Praxis repo not found at $REPO_PATH. Check praxis.config.json."
+  exit 1
+fi
+
+# ─── Check for uncommitted changes ───
+cd "$REPO_PATH"
+if [[ -n "$(git status --porcelain)" ]]; then
+  echo "⚠ Uncommitted changes in $REPO_PATH"
+  echo "  Stash or commit before updating."
+  read -p "  Continue anyway? [y/N] " CONTINUE
+  if [[ ! "${CONTINUE:-N}" =~ ^[Yy]$ ]]; then
+    echo "Aborted."
+    exit 0
+  fi
+fi
+
+# ─── Pull latest ───
+echo "Pulling latest from origin..."
+git pull origin main
+
+# ─── Re-run install to pick up new symlinks ───
+echo ""
+echo "Re-running install.sh..."
+./install.sh
+
+# ─── Update kit dependencies ───
+echo ""
+echo "Checking kit dependencies..."
+for kit_dir in "$REPO_PATH"/kits/*/; do
+  [[ -d "$kit_dir" ]] || continue
+  kit_name=$(basename "$kit_dir")
+
+  if [[ -f "$kit_dir/install.sh" ]]; then
+    read -p "Update $kit_name dependencies? [Y/n] " UPDATE_KIT
+    if [[ "${UPDATE_KIT:-Y}" =~ ^[Yy]$ ]]; then
+      echo "  Updating $kit_name..."
+      bash "$kit_dir/install.sh" || echo "  ⚠ $kit_name update had errors"
+    fi
+  fi
+done
+
+# ─── Verify key tools (conditional on backend) ───
+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 claude &>/dev/null && echo "  ✓ claude available" || echo "  ✗ claude not found"
+command -v node &>/dev/null && echo "  ✓ node available" || echo "  ✗ node not found"
+
+if [[ -f "$REPO_PATH/scripts/health-check.sh" ]]; then
+  echo ""
+  echo "Running health check..."
+  bash "$REPO_PATH/scripts/health-check.sh" || echo "  ⚠ Health check had failures"
+fi
+
+if [[ -f "$REPO_PATH/scripts/lint-harness.sh" ]]; then
+  echo ""
+  echo "Running content lint..."
+  bash "$REPO_PATH/scripts/lint-harness.sh" "$REPO_PATH" || echo "  ⚠ Lint had failures"
+fi
+
+echo ""
+echo "✓ Praxis updated"

package/templates/_index.md

@@ -0,0 +1,33 @@
+---
+tags: [index, project-slug]
+status: active
+repo: https://github.com/org/repo
+local_path: # REQUIRED: absolute path to repo root
+vault_path: # REQUIRED: absolute path to vault project directory
+tech_stack: [stack-item-1, stack-item-2]
+started: YYYY-MM-DD
+---
+
+# {Project Name}
+
+> This is the vault copy. See also: `project-index.md` (repo reference).
+
+## Overview
+One-line description of what this project does.
+
+## Links
+- **Repo**: [GitHub](https://github.com/org/repo)
+- **Local**: ~/path/to/repo
+- **Vault**: ~/path/to/vault/project
+
+## Active Goals
+- [ ] Goal 1
+- [ ] Goal 2
+
+## Key Decisions
+<!-- Link decision records here as they are created -->
+
+## Execution State
+- **Status file**: [[project-slug/status]]
+- **Machine state**: `vault_path/claude-progress.json`
+- **Active plan**: see `current_plan:` in status.md

package/templates/adr.md

@@ -0,0 +1,28 @@
+---
+tags: [adr, project-slug]
+date: YYYY-MM-DD
+status: proposed
+source: agent
+---
+
+# ADR: Title
+
+## Decision
+One sentence. What was decided.
+
+## Context
+Why this decision was needed. What constraints applied.
+
+## Options Considered
+
+| Option | Pros | Cons |
+|--------|------|------|
+| Option A | | |
+| Option B | | |
+
+## Consequences
+What this makes easier, harder, or impossible going forward.
+
+## References
+- Related specs: [[link]]
+- Risk register items: R-XX

package/templates/claude-progress.json

@@ -0,0 +1,24 @@
+{
+  "project": "project-slug",
+  "display_name": "Project Name",
+  "created": "YYYY-MM-DD",
+  "type": "Work",
+  "identity": "identity-profile",
+  "repo_root": "~/path/to/repo",
+  "vault_path": "~/path/to/vault/project",
+  "stack": ["item-1", "item-2"],
+  "milestones": [],
+  "features": [],
+  "ralph_state": {
+    "mode": "idle",
+    "prd_path": null,
+    "current_story": null,
+    "completed_stories": [],
+    "blocked_stories": [],
+    "learnings": [],
+    "last_iteration": null,
+    "session_count": 0
+  },
+  "last_session": null,
+  "sessions": []
+}

package/templates/plan.md

@@ -0,0 +1,46 @@
+---
+tags: [plan, project-slug]
+date: YYYY-MM-DD
+status: active
+target: YYYY-MM-DD
+execution_type: execute | tdd | research
+source: agent
+---
+
+# Plan: Title
+
+## Objective
+One sentence.
+
+## Context
+Why this work is happening now.
+
+## Milestones
+- [ ] Milestone 1 — date
+- [ ] Milestone 2 — date | depends_on: Milestone 1
+- [ ] Milestone 3 — date | depends_on: Milestone 2 | checkpoint: decision
+- [ ] Milestone 4 — date | checkpoint: human-verify
+
+## Steps
+
+### Milestone 1
+1. Step
+2. Step
+
+### Milestone 2
+1. Step
+2. Step
+
+## Done When
+- [ ] Specific verifiable check
+
+## Boundaries
+<!-- Required. Files/systems that MUST NOT change during this plan. -->
+<!-- Override requires explicit "OVERRIDE: {reason}" from user. -->
+- DO NOT CHANGE: {file or system list}
+
+## Blockers
+<!-- Known blockers at plan creation time -->
+
+## Session Log
+<!-- Updated by session-retro -->

package/templates/project-index.md

@@ -0,0 +1,31 @@
+---
+tags: [index, project-slug]
+status: active
+repo: https://github.com/org/repo
+local_path: ~/path/to/repo
+vault_path: ~/path/to/vault/project
+tech_stack: [stack-item-1, stack-item-2]
+started: YYYY-MM-DD
+---
+
+# Project Name
+
+## Overview
+One-line description of what this project does.
+
+## Links
+- **Repo**: [GitHub](https://github.com/org/repo)
+- **Local**: ~/path/to/repo
+- **Vault**: ~/path/to/vault/project
+
+## Active Goals
+- [ ] Goal 1
+- [ ] Goal 2
+
+## Key Decisions
+<!-- Link decision records here as they are created -->
+
+## Execution State
+- **Status file**: [[project-slug/status]]
+- **Machine state**: `vault_path/claude-progress.json`
+- **Active plan**: see `current_plan:` in status.md

package/templates/session-note.md

@@ -0,0 +1,21 @@
+---
+tags: [session, project-slug]
+date: YYYY-MM-DD
+source: agent
+---
+
+# Session Note — YYYY-MM-DD
+
+## Summary
+- Bullet 1
+- Bullet 2
+- Bullet 3
+
+## Decisions Made
+<!-- Key decisions and rationale -->
+
+## Learnings
+<!-- [LEARN:tag] entries from this session -->
+
+## Next Session
+<!-- What to pick up next -->

package/templates/status.md

@@ -0,0 +1,27 @@
+---
+tags: [status, project-slug]
+date: YYYY-MM-DD
+source: agent
+---
+
+# Status — {Project Name}
+
+current_plan:
+last_updated: YYYY-MM-DD
+last_session:
+loop_position: IDLE
+
+## What
+<!-- Facts only. What exists, what was done, what failed. -->
+
+## So What
+<!-- Why it matters. Risk, dependency, compliance gap, or opportunity. -->
+
+## Now What
+<!-- Ordered actions informed by the above. -->
+
+## Blockers
+<!-- Active blockers with owner if known -->
+
+## Test Debt
+<!-- Modules or features lacking test coverage -->

package/templates/tasks.md

@@ -0,0 +1,27 @@
+---
+tags: [tasks, project-slug]
+date: YYYY-MM-DD
+source: agent
+---
+
+# Tasks — {Project Name}
+
+## Active
+
+| Task | Owner | Due | Status |
+|------|-------|-----|--------|
+
+## Blocked
+
+| Task | Blocker | Owner |
+|------|---------|-------|
+
+## Backlog
+
+| Task | Priority | Notes |
+|------|----------|-------|
+
+## Completed
+
+| Task | Completed | Notes |
+|------|-----------|-------|