prjct-cli 2.63.2 → 2.67.0

package/CHANGELOG.md

@@ -2,20 +2,38 @@
 
 ## [Unreleased]
 
+## [2.67.0] - 2026-06-23
+
+### Added
+- eval benchmarks cloud
+
+## [2.66.0] - 2026-06-23
+
+### Added
+- cleanup command surfaces and dead templates
+
+## [2.65.0] - 2026-06-23
+
+### Added
+- setup-owned vault root with OS-aware defaults
+
+## [2.64.0] - 2026-06-23
+
+### Added
+- eval benchmarks cloud
+
 ## [2.63.2] - 2026-06-23
 
 ### Bug Fixes
 
 - resolve Dependabot audit alerts
 
-
 ## [2.63.1] - 2026-06-23
 
 ### Bug Fixes
 
 - harden prjct eval workflow inputs
 
-
 ## [2.63.0] - 2026-06-23
 
 ### Added

package/README.md

@@ -98,7 +98,7 @@ and locked-down CI, which closes the supply-chain surface a native rebuild opens
 
 After install, **next session in any prjct-cli project**:
 
-- **Lookup-first protocol**: Claude reads `~/Documents/prjct/<slug>/_generated/` (architecture, patterns, decisions, gotchas, recent ships) BEFORE re-exploring source. Cuts ~10K tokens of exploration per session.
+- **Lookup-first protocol**: Claude reads the configured vault snapshot (default: your OS Documents folder, e.g. `~/Documents/prjct/<slug>/_generated/` on macOS/Linux) BEFORE re-exploring source. Cuts ~10K tokens of exploration per session.
 - **Auto-capture**: Stop hook scans the assistant transcript and persists durable insights (decisions/learnings/gotchas) tagged for dedup. The next session finds them in the vault.
 - **Pattern detection**: Stop hook detects hot files (>3 changes in 7 days), recurring bugs (gotchas with the same topic), tech-debt growth (TODO/FIXME count rising). All persisted as learnings, surfaced next session.
 - **5 quality workflows** activated by natural language ("review this branch", "qa the UI", "security check", "investigate this bug"):
@@ -111,7 +111,7 @@ After install, **next session in any prjct-cli project**:
 
 ## How it works
 
-State lives in **SQLite** at `~/.prjct-cli/projects/<id>/`. The vault at `~/Documents/prjct/<slug>/_generated/` is an auto-regenerated Markdown snapshot — agent-readable via `Read`/`Glob`, browsable in Obsidian.
+State lives in **SQLite** at `~/.prjct-cli/projects/<id>/`. The vault is an auto-regenerated Markdown snapshot under the root configured by `prjct setup` (default: your OS Documents folder, e.g. `~/Documents/prjct/<slug>/_generated/` on macOS/Linux) — agent-readable via `Read`/`Glob`, browsable in Obsidian.
 
 ```
 Claude Code session                       prjct-cli
@@ -143,11 +143,12 @@ Not "all in a local `.prjct/` folder" — that's the pre-v1.24.1 model. Three ti
 |---|---|---|
 | Config / identity | `<repo>/.prjct/prjct.config.json` (`projectId`, persona) | **Yes** — small, machine-independent |
 | State (source of truth) | `~/.prjct-cli/projects/<projectId>/prjct.db` (SQLite) | No — per-device |
-| Vault (recall snapshot) | `~/Documents/prjct/<slug>/_generated/` (Markdown) | No — regenerated |
+| Vault (recall snapshot) | `<vault-root>/<slug>/_generated/` (Markdown; `prjct setup --vault-root <path>`) | No — regenerated |
 
 Find a project's data: read `projectId` from `.prjct/prjct.config.json`, then the
 DB is `~/.prjct-cli/projects/<projectId>/`, the vault is
-`~/Documents/prjct/<slug>/` (`<slug>` = repo dir name lowercased; `PRJCT_CLI_HOME`
+`<vault-root>/<slug>/` (`<slug>` = repo dir name lowercased; `prjct setup`
+chooses the global vault root, defaulting to the OS Documents folder; `PRJCT_CLI_HOME`
 relocates the global store). Teammates share knowledge via optional cloud sync
 (`prjct login` + `prjct sync`), **not** git — git never carries state. Full
 detail, worktrees, monorepos: **[docs/storage-and-paths.md](./docs/storage-and-paths.md)**.
@@ -181,20 +182,19 @@ read-only commands show whether the project is actually compounding:
 ### Version evals
 
 Use `prjct eval` to measure product readiness between versions and publish the
-evidence to GitHub:
+evidence to the prjct cloud benchmark API:
 
 ```bash
 prjct eval run --candidate 2.62.0
 prjct eval compare --baseline 2.61.0 --candidate 2.62.0 --md
-prjct eval run --candidate "$GITHUB_SHA" --publish --target github
-prjct eval compare --baseline "$BASELINE" --candidate "$CANDIDATE" --publish --target github
+prjct eval run --candidate "$GITHUB_SHA" --publish --target cloud
+prjct eval compare --baseline "$BASELINE" --candidate "$CANDIDATE" --publish --target cloud
 ```
 
-Local artifacts live under `$PRJCT_CLI_HOME/evals/<repo>/`. GitHub publishing
-writes JSON + Markdown to an `eval-results` branch, including
-`summary/latest.json` and `summary/latest-comparison.json`. See
-[EVALS.md](./EVALS.md) and `.github/workflows/prjct-evals.yml` for the
-CI workflow.
+Local artifacts live under `$PRJCT_CLI_HOME/evals/<repo>/`. Cloud publishing
+requires `prjct login` and an active `prjct cloud link`, then sends the
+benchmark payload to the prjct API with server-side ownership/subscription
+checks. See [EVALS.md](./EVALS.md) for the full workflow.
 
 | Command | What it proves |
 |---|---|
@@ -260,7 +260,7 @@ p. status done                                # close the active task
 p. ship                                       # commit, push, open PR
 ```
 
-Cursor / Windsurf use the same commands with a `/` prefix: `/capture`, `/task`, `/ship`.
+Cursor and Windsurf use their installed prjct router files; otherwise run `prjct <command> --md` and follow the output.
 
 ### Core verbs
 
@@ -277,7 +277,6 @@ Cursor / Windsurf use the same commands with a `/` prefix: `/capture`, `/task`,
 | `prjct ship [name]` | Run the project's ship workflow (commit, push, PR, persist). |
 | `prjct sync` | Re-index files, git co-change, imports; refresh project analysis. |
 | `prjct regen` | Full rebuild of the Obsidian vault snapshot from SQLite. |
-| `prjct suggest` | Smart recommendations based on current project state. |
 | `prjct value` | Show whether prjct is paying for itself in this project. |
 | `prjct memory-doctor` | Audit memory quality before noisy context spreads to every agent. |
 | `prjct report [days]` | Generate a human report from shipped work and project memory. |
@@ -381,7 +380,7 @@ prjct capture "check why webhook retries on 502"
 prjct context memory "auth refresh"
 ```
 
-Memory is FTS5-backed (SQLite) and persona-filtered. Recall blends three signals — BM25 lexical, semantic vectors, and a usefulness ledger that reinforces what the project keeps building on. Capture **dedups** automatically: a verbatim re-capture of the same `(type, content)` is skipped, so detectors firing each session can't bloat the store. Every `remember`, `capture`, `ship`, and the SessionStart / Stop hooks regenerate the agent-readable markdown export at `~/Documents/prjct/<slug>/_generated/`.
+Memory is FTS5-backed (SQLite) and persona-filtered. Recall blends three signals — BM25 lexical, semantic vectors, and a usefulness ledger that reinforces what the project keeps building on. Capture **dedups** automatically: a verbatim re-capture of the same `(type, content)` is skipped, so detectors firing each session can't bloat the store. Every `remember`, `capture`, `ship`, and the SessionStart / Stop hooks regenerate the agent-readable markdown export at `<vault-root>/<slug>/_generated/`.
 
 > SQLite is the source of truth. The export is a snapshot — never hand-edit `_generated/`; if data is missing, fix the pipeline.
 
@@ -430,7 +429,7 @@ Without a key the built-in local embedder is used. Vector dimensionality is dete
 
 ### Drop files into the vault (bidirectional)
 
-Drop a file into `~/Documents/prjct/<slug>/captured/` — it becomes memory, vectorized into the DB. Two shapes:
+Drop a file into `<vault-root>/<slug>/captured/` — it becomes memory, vectorized into the DB. Two shapes:
 
 ```markdown
 ---
@@ -531,9 +530,7 @@ $ prjct status done                       # close it when finished
 $ prjct ship                              # bump version, commit, PR
 ```
 
-Inside an agent you don't type the command — say it: `p. task "add OAuth
-refresh"` in Claude Code, `/task "…"` in Cursor/Windsurf. `prjct task` with no
-argument prints the currently active task.
+Inside an agent you can say it: `p. task "add OAuth refresh"` in Claude Code, or run `prjct task "…" --md` from any wired agent. `prjct task` with no argument prints the currently active task.
 
 **How do I get AI assistance for a coding problem?**
 Inside Claude Code (or any wired agent) describe the problem in natural
@@ -548,7 +545,7 @@ persisting findings to memory. Concrete examples:
 | "qa the checkout page" | `qa` | Real browser, atomic fixes, regression tests |
 
 You can also pull project knowledge directly: ask "what patterns does this
-project use?" and the agent reads `~/Documents/prjct/<slug>/_generated/patterns.md`
+project use?" and the agent reads `<vault-root>/<slug>/_generated/patterns.md`
 instead of grepping source (the lookup-first protocol). Outside an agent, every
 command takes `--md` to emit agent-ready markdown.
 
@@ -608,7 +605,7 @@ git check-ignore -v .prjct                         # why git ignores it
 The path is always `<repoRoot>/.prjct/` (strictly relative to the project — no
 env var, no global lookup). Read `projectId` from `prjct.config.json` to reach
 the *other* tiers: DB at `~/.prjct-cli/projects/<projectId>/prjct.db`, vault at
-`~/Documents/prjct/<slug>/_generated/` (`PRJCT_CLI_HOME` overrides the global
+`<vault-root>/<slug>/_generated/` (`prjct setup --vault-root <path>` configures the vault root; `PRJCT_CLI_HOME` overrides the global
 base). The in-repo `.prjct/` holds only config, not state — full detail in
 [docs/storage-and-paths.md](./docs/storage-and-paths.md).
 

package/assets/statusline/components/limits.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+# prjct statusline - Usage limits component
+# Displays Claude.ai 5-hour and weekly limit usage when Claude provides it.
+
+limit_circle() {
+  local pct="$1"
+  if [[ ! "$pct" =~ ^[0-9]+$ ]]; then
+    echo ""
+  elif [[ "$pct" -ge 90 ]]; then
+    echo "●"
+  elif [[ "$pct" -ge 75 ]]; then
+    echo "◕"
+  elif [[ "$pct" -ge 50 ]]; then
+    echo "◑"
+  elif [[ "$pct" -ge 25 ]]; then
+    echo "◔"
+  else
+    echo "○"
+  fi
+}
+
+limit_color() {
+  local pct="$1"
+  if [[ ! "$pct" =~ ^[0-9]+$ ]]; then
+    echo "$MUTED"
+  elif [[ "$pct" -ge 90 ]]; then
+    echo "$ERROR"
+  elif [[ "$pct" -ge 75 ]]; then
+    echo "$WARNING"
+  else
+    echo "$MUTED"
+  fi
+}
+
+format_limit() {
+  local label="$1"
+  local pct="$2"
+
+  [[ -z "$pct" || "$pct" == "null" || ! "$pct" =~ ^[0-9]+$ ]] && return
+
+  local circle color
+  circle=$(limit_circle "$pct")
+  color=$(limit_color "$pct")
+
+  echo -e "${color}${circle} ${label} ${pct}%${NC}"
+}
+
+component_limits() {
+  component_enabled "limits" || return
+
+  local parts=()
+  local five_hour weekly
+
+  five_hour=$(format_limit "5h" "$RATE_LIMIT_5H_PERCENT")
+  weekly=$(format_limit "7d" "$RATE_LIMIT_WEEKLY_PERCENT")
+
+  [[ -n "$five_hour" ]] && parts+=("$five_hour")
+  [[ -n "$weekly" ]] && parts+=("$weekly")
+
+  [[ ${#parts[@]} -eq 0 ]] && return
+
+  local old_ifs="$IFS"
+  IFS=" "
+  echo -e "${parts[*]}"
+  IFS="$old_ifs"
+}

package/assets/statusline/default-config.json

@@ -35,10 +35,14 @@
     },
     "model": {
       "enabled": false,
-      "position": 7
+      "position": 8
     },
     "enrichment": {
       "enabled": true
+    },
+    "limits": {
+      "enabled": true,
+      "position": 7
     }
   }
 }

package/assets/statusline/lib/cache.sh

@@ -64,6 +64,43 @@ parse_stdin() {
   # Single jq call to extract all values
   local parsed
   parsed=$(echo "$input" | jq -r '
+    def pct:
+      (.used_percentage // .usedPercent // .used_percent // .percent // empty);
+    def reset:
+      (.resets_at // .resetsAt // .reset_at // .resetAt // empty);
+    def key:
+      (.id // .name // .limit_name // .limitName // .window // .type // .label // "" | tostring | ascii_downcase);
+    def normpct:
+      if . == null or . == "" then "" else (tonumber | floor | tostring) end;
+    def five_hour_from($rl):
+      if ($rl | type) == "array" then
+        (($rl[]? | select((key | test("5|five|hour")) and ((key | test("week|7|day")) | not)) | pct) // "")
+      elif ($rl | type) == "object" then
+        (($rl.five_hour | pct) // ($rl.fiveHour | pct) // ($rl["5h"] | pct) // ($rl.primary | pct) //
+          ($rl | to_entries[]? | select(((.key | ascii_downcase) | test("5|five|hour")) or ((.value | key) | test("5|five|hour"))) | .value | pct) // "")
+      else "" end;
+    def weekly_from($rl):
+      if ($rl | type) == "array" then
+        (($rl[]? | select(key | test("week|weekly|7|day")) | pct) // "")
+      elif ($rl | type) == "object" then
+        (($rl.weekly | pct) // ($rl.week | pct) // ($rl.seven_day | pct) // ($rl.sevenDay | pct) // ($rl["7d"] | pct) // ($rl.secondary | pct) //
+          ($rl | to_entries[]? | select(((.key | ascii_downcase) | test("week|weekly|7|day")) or ((.value | key) | test("week|weekly|7|day"))) | .value | pct) // "")
+      else "" end;
+    def five_hour_reset_from($rl):
+      if ($rl | type) == "array" then
+        (($rl[]? | select((key | test("5|five|hour")) and ((key | test("week|7|day")) | not)) | reset) // "")
+      elif ($rl | type) == "object" then
+        (($rl.five_hour | reset) // ($rl.fiveHour | reset) // ($rl["5h"] | reset) // ($rl.primary | reset) //
+          ($rl | to_entries[]? | select(((.key | ascii_downcase) | test("5|five|hour")) or ((.value | key) | test("5|five|hour"))) | .value | reset) // "")
+      else "" end;
+    def weekly_reset_from($rl):
+      if ($rl | type) == "array" then
+        (($rl[]? | select(key | test("week|weekly|7|day")) | reset) // "")
+      elif ($rl | type) == "object" then
+        (($rl.weekly | reset) // ($rl.week | reset) // ($rl.seven_day | reset) // ($rl.sevenDay | reset) // ($rl["7d"] | reset) // ($rl.secondary | reset) //
+          ($rl | to_entries[]? | select(((.key | ascii_downcase) | test("week|weekly|7|day")) or ((.value | key) | test("week|weekly|7|day"))) | .value | reset) // "")
+      else "" end;
+    .rate_limits as $rl |
     [
       (.model.display_name // "Claude"),
       (.workspace.current_dir // "~"),
@@ -72,13 +109,17 @@ parse_stdin() {
       (.context_window.context_window_size // 200000),
       (.context_window.current_usage.input_tokens // 0),
       (.context_window.current_usage.cache_creation_input_tokens // 0),
-      (.context_window.current_usage.cache_read_input_tokens // 0)
+      (.context_window.current_usage.cache_read_input_tokens // 0),
+      (five_hour_from($rl) | normpct),
+      (five_hour_reset_from($rl) // ""),
+      (weekly_from($rl) | normpct),
+      (weekly_reset_from($rl) // "")
     ] | @tsv
   ' 2>/dev/null)
 
   # Parse tab-separated values (save/restore IFS to avoid breaking associative arrays)
   local old_ifs="$IFS"
-  IFS=$'\t' read -r MODEL CWD ADDED REMOVED CTX_SIZE INPUT_TOKENS CACHE_CREATE CACHE_READ <<< "$parsed"
+  IFS=$'\t' read -r MODEL CWD ADDED REMOVED CTX_SIZE INPUT_TOKENS CACHE_CREATE CACHE_READ RATE_LIMIT_5H_PERCENT RATE_LIMIT_5H_RESET RATE_LIMIT_WEEKLY_PERCENT RATE_LIMIT_WEEKLY_RESET <<< "$parsed"
   IFS="$old_ifs"
 
   # Set defaults if parsing failed
@@ -90,6 +131,10 @@ parse_stdin() {
   INPUT_TOKENS="${INPUT_TOKENS:-0}"
   CACHE_CREATE="${CACHE_CREATE:-0}"
   CACHE_READ="${CACHE_READ:-0}"
+  RATE_LIMIT_5H_PERCENT="${RATE_LIMIT_5H_PERCENT:-}"
+  RATE_LIMIT_5H_RESET="${RATE_LIMIT_5H_RESET:-}"
+  RATE_LIMIT_WEEKLY_PERCENT="${RATE_LIMIT_WEEKLY_PERCENT:-}"
+  RATE_LIMIT_WEEKLY_RESET="${RATE_LIMIT_WEEKLY_RESET:-}"
 
   # Calculate context percentage
   TOTAL_USED=$((INPUT_TOKENS + CACHE_CREATE + CACHE_READ))
@@ -119,3 +164,4 @@ get_global_path() {
   [[ -z "$project_id" ]] && return
   echo "${HOME}/.prjct-cli/projects/${project_id}"
 }
+

package/assets/statusline/lib/config.sh

@@ -46,6 +46,7 @@ load_config() {
   COMPONENT_ENABLED["git"]="true"
   COMPONENT_ENABLED["changes"]="true"
   COMPONENT_ENABLED["context"]="true"
+  COMPONENT_ENABLED["limits"]="true"
   COMPONENT_ENABLED["model"]="true"
 
   COMPONENT_POSITION["prjct_icon"]=0
@@ -56,7 +57,8 @@ load_config() {
   COMPONENT_POSITION["git"]=4
   COMPONENT_POSITION["changes"]=5
   COMPONENT_POSITION["context"]=6
-  COMPONENT_POSITION["model"]=7
+  COMPONENT_POSITION["limits"]=7
+  COMPONENT_POSITION["model"]=8
 
   # Load config file if exists
   [[ ! -f "$CONFIG_FILE" ]] && return
@@ -84,6 +86,7 @@ load_config() {
       (if .components.git.enabled == null then true else .components.git.enabled end),
       (if .components.changes.enabled == null then true else .components.changes.enabled end),
       (if .components.context.enabled == null then true else .components.context.enabled end),
+      (if .components.limits.enabled == null then true else .components.limits.enabled end),
       (if .components.model.enabled == null then false else .components.model.enabled end),
       (if .components.enrichment.enabled == null then true else .components.enrichment.enabled end),
       (.components.prjct_icon.position // 0),
@@ -94,7 +97,8 @@ load_config() {
       (.components.git.position // 4),
       (.components.changes.position // 5),
       (.components.context.position // 6),
-      (.components.model.position // 7)
+      (.components.limits.position // 7),
+      (.components.model.position // 8)
     ] | @tsv
   ' "$CONFIG_FILE" 2>/dev/null)
 
@@ -107,8 +111,8 @@ load_config() {
     CONFIG_CACHE_TTL_PRJCT CONFIG_CACHE_TTL_GIT CONFIG_CACHE_TTL_LINEAR CONFIG_CACHE_TTL_JIRA \
     CONFIG_TASK_MAX_LENGTH CONFIG_CONTEXT_MIN_PERCENT \
     CONFIG_LINEAR_SHOW_PRIORITY CONFIG_JIRA_SHOW_PRIORITY CONFIG_JIRA_SHOW_STATUS \
-    E_PRJCT_ICON E_TASK E_LINEAR E_JIRA E_DIR E_GIT E_CHANGES E_CONTEXT E_MODEL E_ENRICHMENT \
-    P_PRJCT_ICON P_TASK P_LINEAR P_JIRA P_DIR P_GIT P_CHANGES P_CONTEXT P_MODEL \
+    E_PRJCT_ICON E_TASK E_LINEAR E_JIRA E_DIR E_GIT E_CHANGES E_CONTEXT E_LIMITS E_MODEL E_ENRICHMENT \
+    P_PRJCT_ICON P_TASK P_LINEAR P_JIRA P_DIR P_GIT P_CHANGES P_CONTEXT P_LIMITS P_MODEL \
     <<< "$config_data"
   IFS="$old_ifs"
 
@@ -121,6 +125,7 @@ load_config() {
   COMPONENT_ENABLED["git"]="$E_GIT"
   COMPONENT_ENABLED["changes"]="$E_CHANGES"
   COMPONENT_ENABLED["context"]="$E_CONTEXT"
+  COMPONENT_ENABLED["limits"]="$E_LIMITS"
   COMPONENT_ENABLED["model"]="$E_MODEL"
 
   # Set component positions
@@ -132,6 +137,7 @@ load_config() {
   COMPONENT_POSITION["git"]="$P_GIT"
   COMPONENT_POSITION["changes"]="$P_CHANGES"
   COMPONENT_POSITION["context"]="$P_CONTEXT"
+  COMPONENT_POSITION["limits"]="$P_LIMITS"
   COMPONENT_POSITION["model"]="$P_MODEL"
 
   # Update linear/jira enabled based on component config

package/assets/statusline/statusline.sh

@@ -25,7 +25,7 @@ STATUSLINE_DIR="${HOME}/.prjct-cli/statusline"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # Use installed location or script location for libs/components
-if [[ -d "${STATUSLINE_DIR}/lib" ]]; then
+if [[ -f "${STATUSLINE_DIR}/lib/cache.sh" && -f "${STATUSLINE_DIR}/lib/theme.sh" && -f "${STATUSLINE_DIR}/lib/config.sh" ]]; then
   LIB_DIR="${STATUSLINE_DIR}/lib"
   COMPONENTS_DIR="${STATUSLINE_DIR}/components"
 else