claudius-core 0.9.2 → 0.9.5

package/.claude/agents/manager.md

@@ -17,7 +17,7 @@ When asked who you are: "I am the Claudius manager. I route work, coordinate age
 2. Decide solo (XS/S) vs team (M+) based on scope
 3. Create feature branch from main — **unless already in a worktree** (see Branch Convention)
 4. For solo: implement directly with TDD
-5. For team: spawn developer via Agent tool, then simplifier (best-effort), then reviewer
+5. For team: spawn developer via Agent tool, then reviewer
 6. **Validate before PR** — `bun test && bun run lint && bun run build` must all pass. Fix failures before creating PR. Never create a PR with known lint or build failures.
 7. Create PR
 8. Update issue checkboxes as criteria are met
@@ -43,19 +43,9 @@ Use the Agent tool with `subagent_type: "developer"`. Include in the prompt:
 - The constraint: only implement what's asked, no scope creep
 - **Reminder: developer must run `bun test`, `bun run lint`, and `bun run build` before pushing**
 
-The developer runs in an isolated worktree, implements via TDD, validates (test + lint + build), and returns its output. After it completes, verify the developer reported all three validations passing, then spawn the simplifier (best-effort), then create the PR: `gh pr create`. Only spawn the reviewer after the PR exists.
+The developer runs in an isolated worktree, implements via TDD, validates (test + lint + build), and returns its output. After it completes, verify the developer reported all three validations passing, then create the PR: `gh pr create`.
 
-**Simplifier** (for M+ work, after developer completes and before reviewer):
-Use the Agent tool with `subagent_type: "general-purpose"` and `agent: "code-simplifier"`. Include in the prompt:
-- The git diff of all changes so far: output of `git diff main...HEAD`
-- The original issue acceptance criteria
-- Project conventions: contents of CLAUDE.md
-- Instruction: reduce complexity, improve reuse, fix quality issues — without changing behavior or adding new features
-- Constraint: only touch files already changed on this branch (visible in the diff above)
-
-The simplifier is **non-blocking**: if it returns no changes, errors, or is unavailable, log the outcome and continue to the reviewer. Never let the simplifier halt the pipeline.
-
-**Reviewer** (for M+ work, after simplifier completes and PR is created):
+**Reviewer** (for M+ work, after PR is created):
 Use the Agent tool with `subagent_type: "reviewer"`. Include in the prompt:
 - The PR number to review
 - Return structured verdict: approve / request-changes / block

package/.claude/agents/worker.md

@@ -41,7 +41,6 @@ gh pr list --search "Closes #<N> in:body" --state open --json number --limit 1
 If no open PR found → stale claim → restore to ready:
 ```bash
 gh issue edit <N> --remove-label "in-progress,claude" --add-label "ready"
-bash .claude/scripts/project-status.sh <N> "Todo" "Queued"
 ```
 
 ## Guard Checks
@@ -63,26 +62,11 @@ tail -20 .claudius/job-runs.jsonl
 Before picking new work, merge any open XS/S/M PRs with passing CI:
 
 ```bash
-gh pr list --json number,title,headRefName,statusCheckRollup,mergeable --limit 20
+gh pr list --json number,title,headRefName,statusCheckRollup --limit 20
+bash .claude/scripts/merge-pr.sh <N>
+gh issue close <issue-N> --comment "Closed by PR #<N>."
 ```
 
-For each PR with all checks passing:
-1. **Check mergeability** — if `mergeable` is `CONFLICTING`, try rebasing first:
-   ```bash
-   gh pr view <N> --json mergeable --jq '.mergeable'
-   # If CONFLICTING → attempt rebase:
-   git fetch origin main
-   git checkout <branch>
-   git rebase origin/main
-   git push --force-with-lease
-   # If rebase fails: skip this PR, leave for human or next cycle
-   ```
-2. **Merge** — only if mergeable:
-   ```bash
-   bash .claude/scripts/merge-pr.sh <N>
-   gh issue close <issue-N> --comment "Closed by PR #<N>."
-   ```
-
 ## Step 2: Pick Top-3 Issues
 
 ```bash
@@ -113,7 +97,13 @@ PRIOR_ATTEMPTS=$(gh issue view <N> --json comments \
 if [ "${PRIOR_ATTEMPTS:-0}" -ge "$MAX_ATTEMPTS" ]; then
   gh issue edit <N> --remove-label "ready" --add-label "blocked"
   gh issue comment <N> --body "Claudius: exceeded ${MAX_ATTEMPTS} build attempts. Needs human review before retrying."
-  bash .claude/scripts/project-status.sh <N> "Blocked" "Blocked"
+  REPO_NAME=$(gh repo view --json nameWithOwner --jq '.nameWithOwner')
+  ITEM_ID=$(gh api graphql -f query='{user(login:"SharadKumar"){projectV2(number:6){items(first:100){nodes{id content{...on Issue{number repository{nameWithOwner}}}}}}}}'  \
+    --jq ".data.user.projectV2.items.nodes[] | select(.content.number == <N> and .content.repository.nameWithOwner == \"$REPO_NAME\") | .id" 2>/dev/null | head -1)
+  [ -n "$ITEM_ID" ] && gh project item-edit --id "$ITEM_ID" \
+    --project-id "PVT_kwHOAFO-EM4BRTW5" \
+    --field-id "PVTSSF_lAHOAFO-EM4BRTW5zg_K3tE" \
+    --single-select-option-id "d239ddb3" 2>/dev/null || true
   # skip this issue — continue to next candidate
 fi
 ```
@@ -133,9 +123,18 @@ NEW_ATTEMPTS=$(( ${PRIOR_ATTEMPTS:-0} + 1 ))
 bash .claude/scripts/workpad-upsert.sh <N> "🔄 Claimed — reading issue" "TBD" "- [ ] (loading)" "pending" "$NEW_ATTEMPTS"
 ```
 
-**Update Project #6 → In Progress / Running** (best-effort):
+**Update Project #6 Status → In Progress** — add to project if needed, then set status:
+
 ```bash
-bash .claude/scripts/project-status.sh <N> "In Progress" "Running"
+ISSUE_URL=$(gh issue view <N> --json url --jq '.url')
+REPO_NAME=$(gh repo view --json nameWithOwner --jq '.nameWithOwner')
+gh project item-add 6 --owner SharadKumar --url "$ISSUE_URL" 2>/dev/null || true
+ITEM_ID=$(gh api graphql -f query='{user(login:"SharadKumar"){projectV2(number:6){items(first:100){nodes{id content{...on Issue{number repository{nameWithOwner}}}}}}}}'  \
+  --jq ".data.user.projectV2.items.nodes[] | select(.content.number == <N> and .content.repository.nameWithOwner == \"$REPO_NAME\") | .id" 2>/dev/null | head -1)
+[ -n "$ITEM_ID" ] && gh project item-edit --id "$ITEM_ID" \
+  --project-id "PVT_kwHOAFO-EM4BRTW5" \
+  --field-id "PVTSSF_lAHOAFO-EM4BRTW5zg_K3tE" \
+  --single-select-option-id "0d583361" 2>/dev/null || true
 ```
 
 ## Step 3: Develop in Parallel
@@ -178,7 +177,6 @@ Wait for all developer agents to complete before proceeding.
 ```bash
 gh issue edit <N> --remove-label "in-progress,claude" --add-label "ready"
 gh issue comment <N> --body "Worker: developer failed. Restored to ready queue."
-bash .claude/scripts/project-status.sh <N> "Todo" "Queued"
 ```
 Remove it from the active set and continue with the rest.
 
@@ -246,9 +244,15 @@ if [ -n "$SLACK_CHANNEL" ]; then
 fi
 ```
 
-**Update Project #6 → Under Review / Review** (best-effort):
+**Update Project #6 Status → Under Review** (best-effort):
 ```bash
-bash .claude/scripts/project-status.sh <N> "Under Review" "Review"
+REPO_NAME=$(gh repo view --json nameWithOwner --jq '.nameWithOwner')
+ITEM_ID=$(gh api graphql -f query='{user(login:"SharadKumar"){projectV2(number:6){items(first:100){nodes{id content{...on Issue{number repository{nameWithOwner}}}}}}}}'  \
+  --jq ".data.user.projectV2.items.nodes[] | select(.content.number == <N> and .content.repository.nameWithOwner == \"$REPO_NAME\") | .id" 2>/dev/null | head -1)
+[ -n "$ITEM_ID" ] && gh project item-edit --id "$ITEM_ID" \
+  --project-id "PVT_kwHOAFO-EM4BRTW5" \
+  --field-id "PVTSSF_lAHOAFO-EM4BRTW5zg_K3tE" \
+  --single-select-option-id "173633ca" 2>/dev/null || true
 ```
 
 ## Step 5: Review in Parallel
@@ -272,7 +276,17 @@ Wait for all reviewer agents to complete.
 ```bash
 gh issue edit <N> --remove-label "in-progress,claude" --add-label "ready"
 gh issue comment <N> --body "Worker: reviewer blocked. Reason: <reason>."
-bash .claude/scripts/project-status.sh <N> "Todo" "Queued"
+```
+
+**Update Project #6 Status → Blocked** (best-effort):
+```bash
+REPO_NAME=$(gh repo view --json nameWithOwner --jq '.nameWithOwner')
+ITEM_ID=$(gh api graphql -f query='{user(login:"SharadKumar"){projectV2(number:6){items(first:100){nodes{id content{...on Issue{number repository{nameWithOwner}}}}}}}}'  \
+  --jq ".data.user.projectV2.items.nodes[] | select(.content.number == <N> and .content.repository.nameWithOwner == \"$REPO_NAME\") | .id" 2>/dev/null | head -1)
+[ -n "$ITEM_ID" ] && gh project item-edit --id "$ITEM_ID" \
+  --project-id "PVT_kwHOAFO-EM4BRTW5" \
+  --field-id "PVTSSF_lAHOAFO-EM4BRTW5zg_K3tE" \
+  --single-select-option-id "d239ddb3" 2>/dev/null || true
 ```
 
 ## Step 6: Merge & Record
@@ -283,7 +297,16 @@ bash .claude/scripts/merge-pr.sh <PR-number>
 gh issue close <N> --comment "Closed by PR #<M>."
 ```
 
-Closing the issue removes it from the active Project #6 board — no explicit "Done" status needed.
+**Update Project #6 Status → Done** (best-effort):
+```bash
+REPO_NAME=$(gh repo view --json nameWithOwner --jq '.nameWithOwner')
+ITEM_ID=$(gh api graphql -f query='{user(login:"SharadKumar"){projectV2(number:6){items(first:100){nodes{id content{...on Issue{number repository{nameWithOwner}}}}}}}}'  \
+  --jq ".data.user.projectV2.items.nodes[] | select(.content.number == <N> and .content.repository.nameWithOwner == \"$REPO_NAME\") | .id" 2>/dev/null | head -1)
+[ -n "$ITEM_ID" ] && gh project item-edit --id "$ITEM_ID" \
+  --project-id "PVT_kwHOAFO-EM4BRTW5" \
+  --field-id "PVTSSF_lAHOAFO-EM4BRTW5zg_K3tE" \
+  --single-select-option-id "b60a81d0" 2>/dev/null || true
+```
 
 After each merge, reply in the PR's Slack thread (best-effort):
 ```bash

package/.claude/rules/testing.md

@@ -25,17 +25,20 @@ Every change that can be tested locally MUST be tested locally before committing
 
 ### dist/ freshness
 
-`dist/` is gitignored and built at install time via the `prepare` script. Do NOT commit `dist/` — it is a build artifact.
+`dist/` is committed to the repo. The `prepare` script skips building when `dist/` already exists. This means stale `dist/` = users run old code.
 
-**After changing any `src/` file, always verify the build succeeds:**
+**After changing any `src/` file, always rebuild and commit dist/:**
 ```bash
-bun run build
+bun run build:server
+git add dist/
 ```
 
+If you forget, `npx github:SharadKumar/claudius` will silently run old code — the most dangerous kind of bug.
+
 ### Anti-patterns
 
 - Committing install commands without testing them in the target environment
 - Assuming package managers behave identically (they don't — especially for private repos, workspaces, lockfiles)
 - Shipping a fix for a fix for a fix instead of reverting and getting it right once
 - Trusting `bun run build` as sufficient validation when the change is user-facing
-- Committing `dist/` — it is gitignored and built at install time
+- Changing `src/` without rebuilding and committing `dist/`

package/.claude/scripts/merge-pr.sh

@@ -1,13 +1,16 @@
 #!/usr/bin/env bash
-# merge-pr.sh — Worktree-safe PR merge.
+# merge-pr.sh — Robust PR merge that works regardless of CWD or worktree state.
 #
 # Usage: bash .claude/scripts/merge-pr.sh <PR-number>
 #
 # Behavior:
-#   - From a worktree: API-only merge. NEVER touches the main checkout.
-#   - From the main checkout: gh pr merge with fallback to API merge.
+#   1. Resolve the main repo root via git-common-dir (CWD-agnostic)
+#   2. cd to main root before any git/gh operations
+#   3. Try gh pr merge (happy path — works when main is not checked out elsewhere)
+#   4. On failure, fall back to GitHub API merge + remote branch deletion
+#   5. Sync home branch inline (no external script dependency)
 #
-# Exit codes: 0 = merged, 1 = merge failed
+# Exit codes: 0 = merged + synced, 1 = merge failed, 2 = sync failed
 
 set -euo pipefail
 
@@ -17,23 +20,25 @@ if [[ -z "$PR" ]]; then
   exit 1
 fi
 
-# Detect context BEFORE any cd
-ORIGINAL_GIT_DIR=$(git rev-parse --git-dir 2>/dev/null)
-IN_WORKTREE=false
-if [[ "$ORIGINAL_GIT_DIR" == */.git/worktrees/* ]] || [[ "$ORIGINAL_GIT_DIR" == */worktrees/* ]]; then
-  IN_WORKTREE=true
-fi
+# Resolve main repo root — works from any CWD (worktree, subdir, main checkout)
+GIT_COMMON_DIR=$(git rev-parse --git-common-dir 2>/dev/null)
+MAIN_ROOT=$(cd "$(git rev-parse --show-toplevel)" && cd "$(git rev-parse --git-common-dir)/.." && pwd)
+
+cd "$MAIN_ROOT"
 
-# Get PR metadata (works from any context)
+# Get branch name before merging (needed for API fallback cleanup)
 BRANCH=$(gh pr view "$PR" --json headRefName --jq '.headRefName' 2>/dev/null)
 REPO=$(gh repo view --json nameWithOwner --jq '.nameWithOwner' 2>/dev/null)
 
 echo "Merging PR #$PR ($BRANCH) in $REPO..."
 
-if $IN_WORKTREE; then
-  # --- WORKTREE PATH ---
-  # CRITICAL: Never cd to main checkout. Never run git checkout.
-  # Use GitHub API only — zero local branch operations.
+# Happy path: gh pr merge handles everything locally
+if gh pr merge "$PR" --squash --delete-branch 2>/dev/null; then
+  echo "Merged via gh pr merge."
+else
+  echo "gh pr merge failed (likely worktree conflict) — falling back to API merge..."
+
+  # API merge
   TITLE=$(gh pr view "$PR" --json title --jq '.title')
   gh api "repos/$REPO/pulls/$PR/merge" \
     -X PUT \
@@ -41,52 +46,34 @@ if $IN_WORKTREE; then
     -f commit_title="$TITLE" \
     --silent
 
-  echo "Merged via API (worktree-safe)."
-
-  # Delete remote branch via API (no local git operations)
-  gh api "repos/$REPO/git/refs/heads/$BRANCH" -X DELETE --silent 2>/dev/null \
-    && echo "Deleted remote branch: $BRANCH" \
-    || echo "⚠ Could not delete remote branch: $BRANCH"
-
-  # Fetch latest main (doesn't change any local branch)
-  git fetch origin main 2>/dev/null || true
-
-else
-  # --- MAIN CHECKOUT PATH ---
-  # Save current branch to restore after merge
-  SAVED_BRANCH=$(git branch --show-current 2>/dev/null || echo "")
-
-  # Try gh pr merge (happy path)
-  if gh pr merge "$PR" --squash --delete-branch 2>/dev/null; then
-    echo "Merged via gh pr merge."
-  else
-    echo "gh pr merge failed — falling back to API merge..."
+  echo "Merged via API."
 
-    TITLE=$(gh pr view "$PR" --json title --jq '.title')
-    gh api "repos/$REPO/pulls/$PR/merge" \
-      -X PUT \
-      -f merge_method=squash \
-      -f commit_title="$TITLE" \
-      --silent
+  # Delete remote branch
+  if git ls-remote --exit-code origin "$BRANCH" &>/dev/null; then
+    git push origin --delete "$BRANCH" 2>/dev/null && echo "Deleted remote branch: $BRANCH" || echo "⚠ Could not delete remote branch: $BRANCH"
+  fi
+fi
 
-    echo "Merged via API."
+# Re-anchor to main root (gh pr merge may change CWD)
+cd "$MAIN_ROOT"
 
-    # Delete remote branch
-    if git ls-remote --exit-code origin "$BRANCH" &>/dev/null; then
-      git push origin --delete "$BRANCH" 2>/dev/null \
-        && echo "Deleted remote branch: $BRANCH" \
-        || echo "⚠ Could not delete remote branch: $BRANCH"
-    fi
-  fi
+# Inline sync: return to home branch
+# Detect if this script was invoked from a worktree context
+GIT_DIR=$(git rev-parse --git-dir 2>/dev/null)
 
-  # Sync main
+if [[ "$GIT_DIR" == */.git/worktrees/* ]]; then
+  WORKTREE_NAME=$(basename "$GIT_DIR")
+  HOME_BRANCH="worktree-$WORKTREE_NAME"
+  git checkout "$HOME_BRANCH" 2>/dev/null || true
+  echo "Returned to home branch: $HOME_BRANCH"
+else
+  # Root repo — return to main and sync
   git checkout main 2>/dev/null || true
-  git pull --ff-only origin main 2>/dev/null || {
-    echo "⚠ main has diverged — fast-forward not possible."
-  }
-
-  # Restore original branch if it still exists and wasn't the merged branch
-  if [[ -n "$SAVED_BRANCH" ]] && [[ "$SAVED_BRANCH" != "$BRANCH" ]] && [[ "$SAVED_BRANCH" != "main" ]]; then
-    git checkout "$SAVED_BRANCH" 2>/dev/null || true
+  if git pull --ff-only origin main 2>/dev/null; then
+    echo "main synced to latest."
+  else
+    echo "⚠ main has diverged from origin/main — fast-forward not possible."
+    echo "  Resolve manually: git fetch origin && git rebase origin/main"
+    exit 2
   fi
 fi

package/.claude/scripts/project-status.sh

@@ -22,19 +22,19 @@ EXECUTION_FIELD="PVTSSF_lAHOAFO-EM4BRTW5zg_Lokk"
 
 # Resolve Status option ID
 case "$STATUS" in
-  "Todo")           STATUS_OPT="6ed537f9" ;;
-  "In Progress")    STATUS_OPT="0d583361" ;;
-  "Under Review")   STATUS_OPT="173633ca" ;;
-  "Blocked")        STATUS_OPT="d239ddb3" ;;
+  "Todo")           STATUS_OPT="59debf59" ;;
+  "In Progress")    STATUS_OPT="6e8991c5" ;;
+  "Under Review")   STATUS_OPT="a6a6dc32" ;;
+  "Blocked")        STATUS_OPT="f77fb75d" ;;
   *) echo "[project-status] Unknown status: $STATUS" >&2; exit 1 ;;
 esac
 
 # Resolve Execution option ID
 case "$EXECUTION" in
-  "Queued")   EXECUTION_OPT="f00eea4e" ;;
-  "Running")  EXECUTION_OPT="14585208" ;;
-  "Review")   EXECUTION_OPT="8e0939cc" ;;
-  "Blocked")  EXECUTION_OPT="65e212b0" ;;
+  "Queued")   EXECUTION_OPT="b2b4bd91" ;;
+  "Running")  EXECUTION_OPT="e632d881" ;;
+  "Review")   EXECUTION_OPT="4098f421" ;;
+  "Blocked")  EXECUTION_OPT="70bc5d52" ;;
   *) echo "[project-status] Unknown execution: $EXECUTION" >&2; exit 1 ;;
 esac
 

package/.claude/skills/build/SKILL.md

@@ -105,23 +105,9 @@ Also read: `.claudius/design/tokens.css` for token values, `.claudius/design/com
 1. Write failing test from first acceptance criterion
 2. Implement until test passes
 3. Repeat for each AC
-4. Invoke `/simplify` on the changed files to reduce complexity before validating (best-effort: if it returns no changes or errors, log and continue)
-5. Run full suite: `bun test`
-
-**Team (M+ — >2 files, >100 lines):** Use the Agent tool to spawn developer, simplifier, and reviewer agents in sequence.
-
-1. **Spawn builder** — developer agent implements the issue with TDD (full cycle: failing tests → implementation → passing tests)
-2. **Spawn simplifier** — after builder completes, spawn the `code-simplifier` agent (best-effort: if it returns no changes or errors, log and continue to reviewer):
-   ```
-   Agent tool, subagent_type: general-purpose, agent: code-simplifier
-   Prompt:
-     <git diff of all changes: `git diff main...HEAD`>
-     <original issue ACs>
-     Project conventions: see CLAUDE.md
-     Task: Reduce complexity, improve reuse, fix quality issues — without changing behavior or adding new features.
-     Constraint: Only touch files already changed on this branch (visible in the diff above).
-   ```
-3. **Spawn reviewer** — reviewer agent runs quality gate after simplifier completes (or after simplifier is skipped due to error)
+4. Run full suite: `bun test`
+
+**Team (M+ — >2 files, >100 lines):** Use the Agent tool to spawn developer and reviewer agents.
 
 ### 5. Validate
 

package/.claude-plugin/marketplace.json

@@ -21,10 +21,10 @@
 			"name": "claudius",
 			"source": "./",
 			"description": "Autonomous orchestration layer for Claude Code — agents, skills, hooks, and heartbeat daemon for round-the-clock development",
-			"version": "0.9.2",
+			"version": "0.9.5",
 			"strict": true,
 			"category": "development"
 		}
 	],
-	"version": "0.9.2"
+	"version": "0.9.5"
 }

package/dist/lib/db.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Generic local store — Convex-ready interface.
+ *
+ * Interface mirrors Convex query/mutation shape:
+ *   - namespace = table name
+ *   - key       = document id
+ *
+ * Backed by `.claudius/db.json` with atomic writes (tmp + rename) so the
+ * file is always valid JSON even if the process is killed mid-write.
+ *
+ * Swap path: replace `createDb` with a Convex adapter that implements the
+ * same `Db` interface — callers don't change.
+ */
+/** Convex-compatible store interface. */
+export interface Db {
+    /** Read a document by namespace (table) and key (doc id). */
+    get<T = unknown>(namespace: string, key: string): T | undefined;
+    /** Write a document. Overwrites if it already exists. */
+    set(namespace: string, key: string, value: unknown): void;
+    /** Delete a document. No-op if it doesn't exist. */
+    del(namespace: string, key: string): void;
+}
+/**
+ * Create a `Db` instance scoped to `projectDir`.
+ *
+ * @param projectDir - root of the project (where `.claudius/` lives).
+ *   Defaults to `"."` (current working directory).
+ */
+export declare function createDb(projectDir?: string): Db;
+//# sourceMappingURL=db.d.ts.map

package/dist/lib/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/lib/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,yCAAyC;AACzC,MAAM,WAAW,EAAE;IAClB,6DAA6D;IAC7D,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAChE,yDAAyD;IACzD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1D,oDAAoD;IACpD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAiCD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,UAAU,SAAM,GAAG,EAAE,CAqB7C"}

package/dist/lib/db.js

@@ -0,0 +1,71 @@
+/**
+ * Generic local store — Convex-ready interface.
+ *
+ * Interface mirrors Convex query/mutation shape:
+ *   - namespace = table name
+ *   - key       = document id
+ *
+ * Backed by `.claudius/db.json` with atomic writes (tmp + rename) so the
+ * file is always valid JSON even if the process is killed mid-write.
+ *
+ * Swap path: replace `createDb` with a Convex adapter that implements the
+ * same `Db` interface — callers don't change.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+const DB_FILENAME = ".claudius/db.json";
+function dbPath(projectDir) {
+    return resolve(projectDir, DB_FILENAME);
+}
+function read(projectDir) {
+    const path = dbPath(projectDir);
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function write(projectDir, store) {
+    const path = dbPath(projectDir);
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    // Atomic write: write to tmp then rename.
+    // pid + random suffix prevents collisions under concurrent writes.
+    const tmp = `${path}.tmp.${process.pid}.${Math.random().toString(36).slice(2)}`;
+    writeFileSync(tmp, JSON.stringify(store, null, 2));
+    renameSync(tmp, path);
+}
+/**
+ * Create a `Db` instance scoped to `projectDir`.
+ *
+ * @param projectDir - root of the project (where `.claudius/` lives).
+ *   Defaults to `"."` (current working directory).
+ */
+export function createDb(projectDir = ".") {
+    return {
+        get(namespace, key) {
+            const store = read(projectDir);
+            return store[namespace]?.[key] ?? undefined;
+        },
+        set(namespace, key, value) {
+            const store = read(projectDir);
+            if (!store[namespace])
+                store[namespace] = {};
+            store[namespace][key] = value;
+            write(projectDir, store);
+        },
+        del(namespace, key) {
+            const store = read(projectDir);
+            if (!store[namespace])
+                return;
+            delete store[namespace][key];
+            write(projectDir, store);
+        },
+    };
+}
+//# sourceMappingURL=db.js.map

package/dist/lib/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/lib/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAc7C,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,SAAS,MAAM,CAAC,UAAkB;IACjC,OAAO,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,IAAI,CAAC,UAAkB;IAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAU,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC;AAED,SAAS,KAAK,CAAC,UAAkB,EAAE,KAAY;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,0CAA0C;IAC1C,mEAAmE;IACnE,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnD,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,UAAU,GAAG,GAAG;IACxC,OAAO;QACN,GAAG,CAAc,SAAiB,EAAE,GAAW;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,OAAQ,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAO,IAAI,SAAS,CAAC;QACpD,CAAC;QAED,GAAG,CAAC,SAAiB,EAAE,GAAW,EAAE,KAAc;YACjD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;gBAAE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YAC7C,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC9B,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;QAED,GAAG,CAAC,SAAiB,EAAE,GAAW;YACjC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;gBAAE,OAAO;YAC9B,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC;YAC7B,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/lib/slack.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Slack PR notification layer.
+ *
+ * Announces PRs as channel messages and routes all follow-up activity
+ * (approvals, merges, CI failures) as thread replies on the original post.
+ *
+ * Thread timestamps are persisted via the `Db` store under the
+ * `slack_threads` namespace so they survive process restarts.
+ *
+ * Environment variables:
+ *   SLACK_BOT_TOKEN   — required; xoxb-… bot token
+ *   SLACK_CHANNEL     — required; channel ID (C123…) or name
+ */
+import type { Db } from "./db.js";
+export interface SlackNotifier {
+    /**
+     * Post a new channel message announcing PR creation.
+     * Stores the message timestamp in db for thread replies.
+     */
+    postPR(prNumber: number, title: string, url: string): Promise<void>;
+    /**
+     * Reply to the original PR announcement thread.
+     * No-ops if no thread is found in db or if Slack is unconfigured.
+     */
+    replyPR(prNumber: number, text: string): Promise<void>;
+}
+/**
+ * Create a `SlackNotifier` backed by the given `Db` instance.
+ *
+ * @param db - db instance for persisting thread timestamps.
+ */
+export declare function createSlack(db: Db): SlackNotifier;
+//# sourceMappingURL=slack.d.ts.map

package/dist/lib/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/lib/slack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AA4ClC,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,aAAa,CA+BjD"}

package/dist/lib/slack.js

@@ -0,0 +1,79 @@
+/**
+ * Slack PR notification layer.
+ *
+ * Announces PRs as channel messages and routes all follow-up activity
+ * (approvals, merges, CI failures) as thread replies on the original post.
+ *
+ * Thread timestamps are persisted via the `Db` store under the
+ * `slack_threads` namespace so they survive process restarts.
+ *
+ * Environment variables:
+ *   SLACK_BOT_TOKEN   — required; xoxb-… bot token
+ *   SLACK_CHANNEL     — required; channel ID (C123…) or name
+ */
+const SLACK_API = "https://slack.com/api/chat.postMessage";
+const NAMESPACE = "slack_threads";
+function getConfig() {
+    const token = process.env.SLACK_BOT_TOKEN;
+    const channel = process.env.SLACK_CHANNEL;
+    if (!token || !channel)
+        return null;
+    return { token, channel };
+}
+async function post(token, channel, text, threadTs) {
+    const body = { channel, text };
+    if (threadTs)
+        body.thread_ts = threadTs;
+    const response = await fetch(SLACK_API, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${token}`,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        console.warn(`[slack] HTTP ${response.status} from Slack API`);
+        return { ok: false, error: `http_${response.status}` };
+    }
+    return response.json();
+}
+/**
+ * Create a `SlackNotifier` backed by the given `Db` instance.
+ *
+ * @param db - db instance for persisting thread timestamps.
+ */
+export function createSlack(db) {
+    return {
+        async postPR(prNumber, title, url) {
+            const cfg = getConfig();
+            if (!cfg)
+                return;
+            const text = `\u{1F500} PR #${prNumber}: ${title}\n${url}`;
+            try {
+                const res = await post(cfg.token, cfg.channel, text);
+                if (res.ok && res.ts) {
+                    db.set(NAMESPACE, String(prNumber), res.ts);
+                }
+            }
+            catch (err) {
+                console.warn(`[slack] postPR failed for PR #${prNumber}:`, err);
+            }
+        },
+        async replyPR(prNumber, text) {
+            const cfg = getConfig();
+            if (!cfg)
+                return;
+            const threadTs = db.get(NAMESPACE, String(prNumber));
+            if (!threadTs)
+                return;
+            try {
+                await post(cfg.token, cfg.channel, text, threadTs);
+            }
+            catch (err) {
+                console.warn(`[slack] replyPR failed for PR #${prNumber}:`, err);
+            }
+        },
+    };
+}
+//# sourceMappingURL=slack.js.map

package/dist/lib/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../src/lib/slack.ts"],"names":[],"mappings":"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"}