@ironbee-ai/cli 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -1,34 +1,45 @@
 # Changelog
 
-## 0.3.0 (2026-03-17)
+## 0.4.1 (2026-03-25)
+
+### Features
+
+* **verify-command:** add parametric modes and improve verification quality ([b274813](https://github.com/ironbee-ai/ironbee-cli/commit/b2748139d0dc17f9ffcf5e211a6c1b95b0ec9d33))
+
+## [0.4.0](https://github.com/ironbee-ai/ironbee-cli/compare/v0.3.0...v0.4.0) (2026-03-22)
+
+### Features
+
+* **verification:** add verification lifecycle with start/end boundaries, trace IDs, tool input metadata injection, and bdt_ tool name prefix ([a5df3e8](https://github.com/ironbee-ai/ironbee-cli/commit/a5df3e8))
+* **lifecycle:** add fix start/stop tracking with phase state and session reconciliation ([b10f878](https://github.com/ironbee-ai/ironbee-cli/commit/b10f878))
+* **analyze:** add session analytics with time, quality, code changes, fix effectiveness, scoring, cross-session analysis, and /ironbee-analyze command ([61fe0c8](https://github.com/ironbee-ai/ironbee-cli/commit/61fe0c8))
 
 All notable changes to this project will be documented in this file.
 
-## [0.2.1](https://github.com/ironbee-ai/ironbee-cli/compare/v0.2.0...v0.2.1) (2026-03-16)
+## [0.3.0](https://github.com/ironbee-ai/ironbee-cli/compare/v0.2.1...v0.3.0) (2026-03-17)
 
+### Features
+
+* **telemetry:** add telemetry support ([#3](https://github.com/ironbee-ai/ironbee-cli/issues/3)) ([e39398b](https://github.com/ironbee-ai/ironbee-cli/commit/e39398b))
+
+## [0.2.1](https://github.com/ironbee-ai/ironbee-cli/compare/v0.2.0...v0.2.1) (2026-03-16)
 
 ### Refactors
 
 * **banner:** update banner for the terminals without color support ([3865968](https://github.com/ironbee-ai/ironbee-cli/commit/3865968))
 
-
 ## [0.2.0](https://github.com/ironbee-ai/ironbee-cli/compare/v0.1.1...v0.2.0) (2026-03-16)
 
-
 ### Features
 
 * **cursor:** initial impl ([#2](https://github.com/ironbee-ai/ironbee-cli/issues/2)) ([872a91e](https://github.com/ironbee-ai/ironbee-cli/commit/872a91e))
 
-
 ### Bug Fixes
 
-* **build:** fix banner.txt path resolution for npm global install ([1830699](https://github.com/ironbee-ai/ironbee-cli/commit/1830699))
 * **readme:** fix license and CI badges ([42ea61c](https://github.com/ironbee-ai/ironbee-cli/commit/42ea61c))
 
-
 ## [0.1.1](https://github.com/ironbee-ai/ironbee-cli/compare/v0.1.0...v0.1.1) (2026-03-14)
 
-
 ### Features
 
 * **claude:** initial impl ([#1](https://github.com/ironbee-ai/ironbee-cli/issues/1)) ([960c59d](https://github.com/ironbee-ai/ironbee-cli/commit/960c59d))

package/README.md

@@ -4,7 +4,7 @@
 </h1>
 
 <p align="center">
-  <strong>The CLI for <a href="https://ironbee.ai">IronBee</a> — The Verification Layer for Agentic Development</strong>
+  <strong>The CLI for <a href="https://ironbee.ai">IronBee</a> — Verification and Intelligence Layer for Agentic Development</strong>
 </p>
 
 <p align="center">
@@ -19,6 +19,8 @@
 
 No more "it should work" — every change is tested.
 
+IronBee also tracks every verification cycle — coding time, fix time, pass/fail rates, problematic files — and provides session and project-level analytics for LLM-powered semantic insights.
+
 Powered by [browser-devtools-mcp](https://browser-devtools.com) — the agent navigates pages, clicks buttons, fills forms, takes screenshots, checks console errors, and writes a structured verdict.
 
 ## Supported Clients
@@ -72,8 +74,23 @@ ironbee install [project-dir] [--client <name>]   Set up hooks and config
 ironbee uninstall [project-dir] [--client <name>] Remove hooks and config
 ironbee status [project-dir]                      Show verdict status for active sessions
 ironbee verify [session-id]                       Dry-run verdict validation
+ironbee analyze [session-id]                      Analyze session metrics (or all sessions)
 ```
 
+### Agent Commands (slash commands)
+
+IronBee installs slash commands that the agent can use inside Claude Code or Cursor:
+
+| Command | Description |
+|---------|-------------|
+| `/ironbee-verify` | Verify changes — focused on affected areas (default) |
+| `/ironbee-verify full` | Full verification — complete visual + functional + accessibility checklists |
+| `/ironbee-verify visual` | Visual-only — contrast, layout, spacing, fonts, images, theming |
+| `/ironbee-verify functional` | Functional-only — clicks, forms, navigation, data flow, error handling |
+| `/ironbee-analyze` | Run session analytics and provide LLM-powered semantic insights |
+
+`/ironbee-verify` guides the agent through a systematic verification process. The default mode focuses on what changed, while `full` runs every checklist item. Use `visual` or `functional` to narrow the scope when you know what type of testing is needed.
+
 ## Configuration
 
 IronBee loads config from two locations (project overrides global):
@@ -103,6 +120,51 @@ By default, IronBee requires verification for common code file extensions: `.ts`
 
 Non-code files like `README.md`, `package.json`, or `.gitignore` do not trigger verification.
 
+### Browser DevTools MCP config
+
+By default, IronBee configures `browser-devtools-mcp` via npx. To customize the MCP server (e.g., use a local server or HTTP transport), add a `browserDevTools` key to your config:
+
+```json
+{
+  "browserDevTools": {
+    "mcp": {
+      "url": "http://localhost:4000/mcp"
+    }
+  }
+}
+```
+
+Or with a custom stdio command:
+
+```json
+{
+  "browserDevTools": {
+    "mcp": {
+      "command": "node",
+      "args": ["./my-server.js"],
+      "env": { "MY_VAR": "value" }
+    }
+  }
+}
+```
+
+You can also pass extra env vars to the default npx server without replacing it:
+
+```json
+{
+  "browserDevTools": {
+    "env": { "BROWSER_HEADLESS_ENABLE": "true", "OTEL_ENABLE": "true" }
+  }
+}
+```
+
+| Key | Description |
+|-----|-------------|
+| `browserDevTools.mcp` | Full MCP server config — used as-is when provided. Supports `command`+`args` (stdio) or `url` (HTTP) |
+| `browserDevTools.env` | Extra env vars merged into the default config. Only used when `mcp` is not provided |
+
+> **Note:** IronBee always sets `TOOL_NAME_PREFIX=bdt_` and `TOOL_INPUT_METADATA_ENABLE=true` — these cannot be overridden.
+
 ## Verification Flow
 
 When the agent tries to complete a task, IronBee runs these checks:
@@ -166,13 +228,111 @@ Each AI session gets its own directory under `.ironbee/sessions/<session-id>/`:
 ```
 .ironbee/sessions/<session-id>/
   actions.jsonl    # Event log (file edits, tool calls, verification markers)
-  verdict.json     # Written by agent after verification
-  retries          # Retry counter
+  verdict.json     # Current verdict (cleared on code edit)
+  state.json       # Session state (retries, active verification, trace ID, active fix, phase)
   session.log      # Debug log
 ```
 
 This means parallel sessions (e.g., multiple Claude Code instances) don't interfere with each other.
 
+## Analytics
+
+`ironbee analyze` provides metrics about verification sessions — how time is spent, how effective verifications are, and how confident we can be in the agent's code.
+
+### Usage
+
+```bash
+ironbee analyze <session-id>                    # single session analysis
+ironbee analyze                                 # all sessions (project-level)
+ironbee analyze --json                          # JSON output
+ironbee analyze --detailed                      # include verdict details (checks, issues, fixes)
+ironbee analyze --json --detailed               # JSON with verdict text for LLM semantic analysis
+ironbee analyze <session-id> --json --detailed  # single session JSON with verdict details
+```
+
+The `--detailed` flag includes raw verdict text (checks, issues, fixes) in the output. This is designed for LLM-powered semantic analysis — use `/ironbee-analyze` in Claude Code or Cursor to have the agent interpret these details automatically.
+
+### Session Analysis
+
+#### Phase Distribution
+
+Each session is divided into three phases:
+
+| Phase | What it measures |
+|-------|-----------------|
+| **Coding** | Time from session start to first verification, and between fix end and next verification start |
+| **Verification** | Time between `verification_start` and `verification_end` — browser testing |
+| **Fixing** | Time between `fix_start` and `fix_end` — fixing failed verifications |
+
+#### Cycles
+
+| Metric | Meaning |
+|--------|---------|
+| Verifications | Number of verification cycles in the session |
+| Fixes | Number of fix cycles (each fail verdict starts a fix) |
+| Avg verify | Average duration of a verification cycle |
+| Avg fix | Average duration of a fix cycle |
+| First verify | Time from session start to first verification |
+
+#### Verification Quality
+
+| Metric | Meaning |
+|--------|---------|
+| First-pass rate | Percentage of verification chains where the first verdict was pass |
+| Verdicts | Total verdict count (pass + fail) |
+| Avg retries | Average number of fail verdicts before pass per chain |
+| Avg console errs | Average `console_errors` across all verdicts |
+| Avg network fails | Average `network_failures` across all verdicts |
+| Avg pages tested | Average number of pages tested per verdict |
+| Avg checks | Average number of checks performed per verdict |
+
+#### Code Changes
+
+| Metric | Meaning |
+|--------|---------|
+| Total edits | Total file edit operations in the session |
+| Unique files | Number of distinct files edited |
+| Avg per verify | Average file edits before each verification |
+| Avg per fix | Average file edits during each fix cycle |
+| Hot Files | Top 5 most frequently edited files |
+| Problematic Files | Top 5 files with most edits during fix cycles |
+| Edit Churn | Files edited in 2+ separate fix cycles (root cause may not be resolved) |
+
+#### Fix Effectiveness
+
+| Metric | Meaning |
+|--------|---------|
+| Success rate | Percentage of fixes followed by a pass verdict |
+| Re-fail rate | Percentage of fixes followed by another fail verdict |
+| Fix/verify | Ratio of fix cycles to verification cycles (0 = no fixes needed) |
+
+#### Scoring
+
+Three scores summarize the session:
+
+| Score | Formula | What it measures |
+|-------|---------|-----------------|
+| **Efficiency** | `coding_time / (coding_time + fix_time) × 100` | How much productive time vs fix overhead. High = minimal wasted time on fixes |
+| **Quality** | `(pass_pct + pages_pct + checks_pct + clean_pct) / 4` | How thorough and clean the verification was. Components: pass rate, page coverage (3+ = 100%), check depth (5+ = 100%), error cleanliness (0 errors = 100%) |
+| **Confidence** | `pass_count / total_verdicts × 100` | How likely the agent's code works. Based on verdict pass rate |
+
+### Project Analysis
+
+When run without a session ID, `ironbee analyze` aggregates metrics across all sessions:
+
+| Metric | Meaning |
+|--------|---------|
+| Session History | Each session's summary — duration, cycles, outcome, score |
+| Avg duration | Average session duration across all sessions |
+| Avg verifies | Average verification cycles per session |
+| Avg fixes | Average fix cycles per session |
+| First-pass rate | Percentage of sessions where the first verdict was pass |
+| Fix success rate | Percentage of all fixes (across sessions) that succeeded |
+| Abandon rate | Percentage of sessions with interrupted verification/fix cycles |
+| Avg efficiency | Average efficiency score across all sessions |
+| Avg confidence | Average confidence score across all sessions |
+| Problematic Files | Top 5 files with most fix edits across all sessions |
+
 ## Telemetry
 
 IronBee collects anonymous usage data to help improve the product. No source code, file contents, or personally identifiable information is ever sent.

package/dist/analysis/code-changes.d.ts

@@ -0,0 +1,22 @@
+/**
+ * IronBee — Code Change Analysis
+ *
+ * Reads actions.jsonl and calculates code change metrics.
+ * Pure logic — no process.exit, no stdin, no side effects.
+ */
+export interface FileStats {
+    filePath: string;
+    editCount: number;
+    fixEditCount: number;
+}
+export interface CodeChangeAnalysis {
+    totalFileEdits: number;
+    uniqueFilesEdited: number;
+    filesEditedPerVerification: number;
+    filesChangedPerFix: number;
+    hotFiles: FileStats[];
+    problematicFiles: FileStats[];
+    editChurnFiles: string[];
+}
+export declare function analyzeCodeChanges(actionsFile: string): CodeChangeAnalysis | null;
+//# sourceMappingURL=code-changes.d.ts.map

package/dist/analysis/code-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-changes.d.ts","sourceRoot":"","sources":["../../src/analysis/code-changes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,SAAS;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B,EAAE,MAAM,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,gBAAgB,EAAE,SAAS,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC5B;AAuBD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAqIjF"}

package/dist/analysis/code-changes.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * IronBee — Code Change Analysis
+ *
+ * Reads actions.jsonl and calculates code change metrics.
+ * Pure logic — no process.exit, no stdin, no side effects.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeCodeChanges = analyzeCodeChanges;
+const fs_1 = require("fs");
+function parseEntries(actionsFile) {
+    if (!(0, fs_1.existsSync)(actionsFile)) {
+        return [];
+    }
+    const content = (0, fs_1.readFileSync)(actionsFile, "utf-8");
+    const lines = content.trim().split("\n").filter((l) => l.length > 0);
+    const entries = [];
+    for (const line of lines) {
+        try {
+            const entry = JSON.parse(line);
+            entries.push(entry);
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return entries;
+}
+function analyzeCodeChanges(actionsFile) {
+    const entries = parseEntries(actionsFile);
+    // Collect all file_edit entries
+    const fileEdits = entries.filter((e) => e.type === "file_edit");
+    if (fileEdits.length === 0) {
+        return null;
+    }
+    const totalFileEdits = fileEdits.length;
+    // Unique files
+    const uniqueFiles = new Set();
+    for (const edit of fileEdits) {
+        const filePath = edit.file_path;
+        if (typeof filePath === "string") {
+            uniqueFiles.add(filePath);
+        }
+    }
+    const uniqueFilesEdited = uniqueFiles.size;
+    // Track phases and count edits per phase type
+    let inFixPhase = false;
+    let currentFixId = null;
+    let codingEditCount = 0;
+    let fixEditCount = 0;
+    let verificationCount = 0;
+    let fixCount = 0;
+    // Per-file stats
+    const fileEditCounts = new Map();
+    const fileFixEditCounts = new Map();
+    // Track which fix cycles each file appears in (for churn detection)
+    const fileFixCycles = new Map();
+    for (const entry of entries) {
+        if (entry.type === "fix_start") {
+            inFixPhase = true;
+            currentFixId = entry.fix_id;
+            fixCount++;
+            continue;
+        }
+        if (entry.type === "fix_end") {
+            inFixPhase = false;
+            currentFixId = null;
+            continue;
+        }
+        if (entry.type === "verification_start") {
+            inFixPhase = false;
+            currentFixId = null;
+            verificationCount++;
+            continue;
+        }
+        if (entry.type === "file_edit") {
+            const filePath = entry.file_path;
+            if (inFixPhase) {
+                fixEditCount++;
+                if (typeof filePath === "string") {
+                    const currentCount = fileFixEditCounts.get(filePath) ?? 0;
+                    fileFixEditCounts.set(filePath, currentCount + 1);
+                    if (typeof currentFixId === "string") {
+                        let cycles = fileFixCycles.get(filePath);
+                        if (cycles === undefined) {
+                            cycles = new Set();
+                            fileFixCycles.set(filePath, cycles);
+                        }
+                        cycles.add(currentFixId);
+                    }
+                }
+            }
+            else {
+                codingEditCount++;
+            }
+            if (typeof filePath === "string") {
+                const currentCount = fileEditCounts.get(filePath) ?? 0;
+                fileEditCounts.set(filePath, currentCount + 1);
+            }
+        }
+    }
+    // filesEditedPerVerification: coding edits / verification count
+    const filesEditedPerVerification = verificationCount > 0
+        ? Math.round((codingEditCount / verificationCount) * 10) / 10
+        : 0;
+    // filesChangedPerFix: fix edits / fix count
+    const filesChangedPerFix = fixCount > 0
+        ? Math.round((fixEditCount / fixCount) * 10) / 10
+        : 0;
+    // hotFiles: top 5 by total edit count
+    const allFileStats = [];
+    for (const [filePath, editCount] of fileEditCounts) {
+        const fixEdits = fileFixEditCounts.get(filePath) ?? 0;
+        allFileStats.push({ filePath, editCount, fixEditCount: fixEdits });
+    }
+    const hotFiles = [...allFileStats]
+        .sort((a, b) => b.editCount - a.editCount)
+        .slice(0, 5);
+    // problematicFiles: top 5 by fix edit count, only those with fixEditCount > 0
+    const problematicFiles = [...allFileStats]
+        .filter((f) => f.fixEditCount > 0)
+        .sort((a, b) => b.fixEditCount - a.fixEditCount)
+        .slice(0, 5);
+    // editChurnFiles: files edited in 2+ different fix cycles
+    const editChurnFiles = [];
+    for (const [filePath, cycles] of fileFixCycles) {
+        if (cycles.size >= 2) {
+            editChurnFiles.push(filePath);
+        }
+    }
+    return {
+        totalFileEdits,
+        uniqueFilesEdited,
+        filesEditedPerVerification,
+        filesChangedPerFix,
+        hotFiles,
+        problematicFiles,
+        editChurnFiles,
+    };
+}
+//# sourceMappingURL=code-changes.js.map

package/dist/analysis/code-changes.js.map

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

package/dist/analysis/cross-session.d.ts

@@ -0,0 +1,34 @@
+/**
+ * IronBee — Cross-Session Analysis
+ *
+ * Scans all sessions in .ironbee/sessions/ and produces aggregate metrics.
+ * Pure logic — no process.exit, no stdin, no side effects.
+ */
+export interface SessionSummary {
+    sessionId: string;
+    timestamp: string;
+    duration: number;
+    verificationCycles: number;
+    fixCycles: number;
+    firstPassSuccess: boolean;
+    lastVerdictStatus: string | null;
+    agentEfficiencyScore: number;
+}
+export interface CrossSessionAnalysis {
+    totalSessions: number;
+    sessionSummaries: SessionSummary[];
+    aggregateFirstPassRate: number;
+    aggregateFixSuccessRate: number;
+    averageSessionDuration: number;
+    averageVerificationCycles: number;
+    averageFixCycles: number;
+    averageEfficiencyScore: number;
+    averageCodeConfidence: number;
+    mostProblematicFiles: Array<{
+        filePath: string;
+        fixEditCount: number;
+    }>;
+    abandonRate: number;
+}
+export declare function analyzeCrossSessions(sessionsDir: string): CrossSessionAnalysis | null;
+//# sourceMappingURL=cross-session.d.ts.map

package/dist/analysis/cross-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-session.d.ts","sourceRoot":"","sources":["../../src/analysis/cross-session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,WAAW,EAAE,MAAM,CAAC;CACvB;AAiFD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CA2KrF"}