Skip to content

v2.3.0

Choose a tag to compare

@github-actions github-actions released this 20 Jun 15:40
2acaa12

Deprecated

  • The dev-context command alias is deprecated and will be removed in v3.0.0. Use repoctx. Invoking the CLI through the dev-context bin now prints a deprecation warning to stderr (never on --json stdout). The .dev-context/ output directory is unaffected — it is not part of the deprecation.

Added

  • repoctx dashboard renders a local usage & performance UI. A new opt-in telemetry layer records one JSONL line per CLI run and per MCP tool call to ~/.dev-context/usage.jsonl (command, arg shape — keys only — latency, outcome, and the value signals each command already produces). repoctx dashboard aggregates that log (plus existing .dev-context artifacts and recent git history) into ONE self-contained HTML file — no server, no chart library, no network — with interpretation tooltips on every tile and chart and a "what this can't show" honesty panel. Capture is off by default and strictly local: gated by the telemetry config key or REPOCTX_TELEMETRY, forced off under CI, never written to stdout or the MCP JSON-RPC channel (a determinism-firewall test enforces byte-identical output on/off), and error text is reduced to a code/class so no paths leak. Manage it with repoctx telemetry status|on|off|clear.
  • repoctx ax "<task>" --path . scores Agent Experience (AX). A single 0–100 number for "how cheap and safe is it for an agent to make this change here?", blending Changeability (token cost), Containment (blast radius), Guardrails (tests/validation/CODEOWNERS/CI), and Clarity. Deterministic and composed from the existing impact, tokens, and codeowners engines — no new analysis. Supports --json and --out, and is exposed over MCP as the agent_experience tool (the MCP surface bumps from 11 to 12 tools). See docs/07-harness-thesis/ax-score-spec.md.
  • repoctx converge "<task>" --base <ref> scores convergence. A deterministic 0–100 measure of the distance between a stated task (intent) and the actual git diff (execution), with sub-scores for Coverage (did the intent happen?), Scope (did only the intent happen?), and Risk alignment (did unrequested drift land on risk-sensitive paths?). Emits a recomputable, timestamp-free receipt as durable evidence. Composed from the change_impact diff comparison and the shared risk vocabulary — no model, no new analysis. Supports --json and --out, and is exposed over MCP as the convergence_score tool (the MCP surface bumps from 12 to 13 tools). See docs/09-convergence-thesis/convergence-score-spec.md.
  • postinstall runs repoctx doctor after a global install. npm install -g @nugehs/repoctx now prints an environment readiness summary. The hook is guarded: it runs only for global installs (npm_config_global=true), skips in CI and when REPOCTX_SKIP_POSTINSTALL is set, and always exits 0 so it can never fail an install.