nodebench-mcp 2.28.0 → 2.31.0

package/README.md

@@ -194,6 +194,92 @@ All analytics data is stored locally in `~/.nodebench/analytics.db` and never le
 
 ---
 
+## Headless Engine API (v2.30.0)
+
+NodeBench now ships a **headless, API-first Agentic Engine** — plug it into any client workflow and sell results, not software seats.
+
+```bash
+# Start MCP server with engine API on port 6276
+npx nodebench-mcp --engine
+
+# With auth token
+npx nodebench-mcp --engine --engine-secret "your-token"
+# or: ENGINE_SECRET=your-token npx nodebench-mcp --engine
+```
+
+### API Endpoints
+
+| Method | Path | Purpose |
+|--------|------|---------|
+| GET | `/` | Engine status, tool count, uptime |
+| GET | `/api/health` | Health check |
+| GET | `/api/tools` | List all available tools |
+| POST | `/api/tools/:name` | Execute a single tool |
+| GET | `/api/workflows` | List all 32 workflow chains |
+| POST | `/api/workflows/:name` | Execute a workflow (with SSE streaming) |
+| POST | `/api/sessions` | Create an isolated session |
+| GET | `/api/sessions/:id` | Session status + call history |
+| GET | `/api/sessions/:id/trace` | Full disclosure trace |
+| GET | `/api/sessions/:id/report` | Conformance report |
+| DELETE | `/api/sessions/:id` | End session |
+| GET | `/api/presets` | List presets with tool counts |
+
+### Quick Examples
+
+```bash
+# Execute a single tool
+curl -X POST http://127.0.0.1:6276/api/tools/discover_tools \
+  -H "Content-Type: application/json" \
+  -d '{"args": {"query": "security audit"}, "preset": "full"}'
+
+# Run a workflow with streaming
+curl -N -X POST http://127.0.0.1:6276/api/workflows/fix_bug \
+  -H "Content-Type: application/json" \
+  -d '{"preset": "web_dev", "streaming": true}'
+
+# Create a session, execute tools, get conformance report
+SESSION=$(curl -s -X POST http://127.0.0.1:6276/api/sessions \
+  -H "Content-Type: application/json" \
+  -d '{"preset": "web_dev"}' | jq -r .sessionId)
+
+curl -X POST "http://127.0.0.1:6276/api/tools/run_recon" \
+  -H "Content-Type: application/json" \
+  -d "{\"args\": {\"focusArea\": \"web\"}, \"sessionId\": \"$SESSION\"}"
+
+curl "http://127.0.0.1:6276/api/sessions/$SESSION/report"
+```
+
+### Conformance Reports
+
+Every workflow execution produces a conformance report scoring:
+- **Step completeness** — did all required tools execute?
+- **Quality gate** — did the quality gate pass?
+- **Test layers** — were unit/integration/e2e results logged?
+- **Flywheel** — was the methodology completed?
+- **Learnings** — were findings banked for next time?
+
+Grades: A (90+) / B (75+) / C (60+) / D (40+) / F (<40). Sell these reports as "Zero-bug deployment certificates" or "Automated WebMCP Conformance Reports."
+
+### SSE Streaming
+
+Workflow execution supports Server-Sent Events for real-time progress:
+
+```
+event: start
+data: {"workflow":"fix_bug","totalSteps":7,"sessionId":"eng_..."}
+
+event: step
+data: {"stepIndex":0,"tool":"search_all_knowledge","status":"running"}
+
+event: step
+data: {"stepIndex":0,"tool":"search_all_knowledge","status":"complete","durationMs":42}
+
+event: complete
+data: {"totalSteps":7,"totalDurationMs":340,"conformanceScore":88,"grade":"B"}
+```
+
+---
+
 ## What You Get — The AI Flywheel
 
 The default setup (no `--preset` flag) gives you **50 tools** that implement the complete [AI Flywheel](https://github.com/HomenShum/nodebench-ai/blob/main/AI_FLYWHEEL.md) methodology — two interlocking loops that compound quality over time:

package/dist/db.js

@@ -652,6 +652,75 @@ CREATE TABLE IF NOT EXISTS skill_sync_history (
 CREATE INDEX IF NOT EXISTS idx_skills_skill_id ON skills(skill_id);
 CREATE INDEX IF NOT EXISTS idx_skills_status ON skills(status);
 CREATE INDEX IF NOT EXISTS idx_skill_sync_history_skill ON skill_sync_history(skill_id);
+
+-- ═══════════════════════════════════════════
+-- ENGINE CONTEXT PERSISTENCE
+-- Conformance reports, workflow runs, content archive
+-- ═══════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS engine_reports (
+  id              TEXT PRIMARY KEY,
+  session_id      TEXT NOT NULL,
+  workflow        TEXT NOT NULL,
+  preset          TEXT NOT NULL,
+  score           REAL NOT NULL,
+  grade           TEXT NOT NULL,
+  breakdown       TEXT NOT NULL,
+  summary         TEXT NOT NULL,
+  total_steps     INTEGER NOT NULL,
+  successful_steps INTEGER NOT NULL,
+  failed_steps    INTEGER NOT NULL,
+  total_duration_ms INTEGER NOT NULL,
+  generated_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_engine_reports_workflow ON engine_reports(workflow);
+CREATE INDEX IF NOT EXISTS idx_engine_reports_generated ON engine_reports(generated_at);
+
+CREATE TABLE IF NOT EXISTS engine_workflow_runs (
+  id              TEXT PRIMARY KEY,
+  session_id      TEXT NOT NULL,
+  workflow        TEXT NOT NULL,
+  preset          TEXT NOT NULL,
+  step_count      INTEGER NOT NULL,
+  success_count   INTEGER NOT NULL DEFAULT 0,
+  failed_count    INTEGER NOT NULL DEFAULT 0,
+  duration_ms     INTEGER NOT NULL DEFAULT 0,
+  context_loaded  TEXT,
+  outcome_summary TEXT,
+  created_at      TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_engine_runs_workflow ON engine_workflow_runs(workflow);
+CREATE INDEX IF NOT EXISTS idx_engine_runs_created ON engine_workflow_runs(created_at);
+
+CREATE TABLE IF NOT EXISTS content_archive (
+  id              TEXT PRIMARY KEY,
+  title           TEXT NOT NULL,
+  content_type    TEXT NOT NULL,
+  digest          TEXT,
+  full_content    TEXT,
+  themes          TEXT,
+  workflow        TEXT,
+  published_at    TEXT NOT NULL DEFAULT (datetime('now')),
+  engagement      TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_content_archive_type ON content_archive(content_type);
+CREATE INDEX IF NOT EXISTS idx_content_archive_published ON content_archive(published_at);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS content_archive_fts USING fts5(
+  title,
+  digest,
+  themes,
+  content='content_archive',
+  content_rowid='rowid'
+);
+
+CREATE TRIGGER IF NOT EXISTS content_archive_fts_insert AFTER INSERT ON content_archive BEGIN
+  INSERT INTO content_archive_fts(rowid, title, digest, themes)
+  VALUES (new.rowid, new.title, COALESCE(new.digest, ''), COALESCE(new.themes, ''));
+END;
 `;
 export function getDb() {
     if (_db)

package/dist/db.js.map

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

package/dist/engine/conformance.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Engine Conformance Scoring
+ *
+ * Computes a deterministic conformance score from a session's tool call history.
+ * Used to generate "Conformance Reports" — the sellable output of the engine.
+ */
+import type { EngineSession } from "./session.js";
+export interface ConformanceBreakdown {
+    stepsCompleted: boolean;
+    qualityGatePassed: boolean;
+    testLayersLogged: boolean;
+    flywheelCompleted: boolean;
+    learningsRecorded: boolean;
+    reconPerformed: boolean;
+    verificationCycleStarted: boolean;
+    noErrors: boolean;
+}
+export interface ConformanceReport {
+    sessionId: string;
+    preset: string;
+    score: number;
+    grade: "A" | "B" | "C" | "D" | "F";
+    breakdown: ConformanceBreakdown;
+    summary: string;
+    totalSteps: number;
+    successfulSteps: number;
+    failedSteps: number;
+    totalDurationMs: number;
+    generatedAt: number;
+}
+export declare function computeConformance(session: EngineSession, expectedSteps?: number): ConformanceReport;

package/dist/engine/conformance.js

@@ -0,0 +1,81 @@
+/**
+ * Engine Conformance Scoring
+ *
+ * Computes a deterministic conformance score from a session's tool call history.
+ * Used to generate "Conformance Reports" — the sellable output of the engine.
+ */
+const FLYWHEEL_TOOLS = [
+    "start_flywheel",
+    "log_flywheel_step",
+    "run_quality_gate",
+];
+const TEST_TOOLS = [
+    "log_test_result",
+];
+const LEARNING_TOOLS = [
+    "log_learning",
+    "save_session_note",
+    "search_all_knowledge",
+];
+const RECON_TOOLS = [
+    "run_recon",
+    "log_recon_finding",
+];
+const VERIFICATION_TOOLS = [
+    "start_verification_cycle",
+    "log_verification_step",
+];
+const QUALITY_GATE_TOOLS = [
+    "run_quality_gate",
+];
+function hasToolCalled(history, toolNames) {
+    return history.some((r) => toolNames.includes(r.toolName) && r.status === "success");
+}
+function countByStatus(history, status) {
+    return history.filter((r) => r.status === status).length;
+}
+export function computeConformance(session, expectedSteps) {
+    const history = session.callHistory;
+    const successful = countByStatus(history, "success");
+    const failed = countByStatus(history, "error");
+    const total = history.length;
+    const totalDurationMs = history.reduce((sum, r) => sum + r.durationMs, 0);
+    const breakdown = {
+        stepsCompleted: expectedSteps ? successful >= expectedSteps : successful > 0,
+        qualityGatePassed: hasToolCalled(history, QUALITY_GATE_TOOLS),
+        testLayersLogged: hasToolCalled(history, TEST_TOOLS),
+        flywheelCompleted: hasToolCalled(history, FLYWHEEL_TOOLS),
+        learningsRecorded: hasToolCalled(history, LEARNING_TOOLS),
+        reconPerformed: hasToolCalled(history, RECON_TOOLS),
+        verificationCycleStarted: hasToolCalled(history, VERIFICATION_TOOLS),
+        noErrors: failed === 0,
+    };
+    // Score: each check is worth 12.5 points (8 checks × 12.5 = 100)
+    const checks = Object.values(breakdown);
+    const passed = checks.filter(Boolean).length;
+    const score = Math.round((passed / checks.length) * 100);
+    const grade = score >= 90 ? "A" :
+        score >= 75 ? "B" :
+            score >= 60 ? "C" :
+                score >= 40 ? "D" : "F";
+    const failedChecks = Object.entries(breakdown)
+        .filter(([, v]) => !v)
+        .map(([k]) => k.replace(/([A-Z])/g, " $1").toLowerCase().trim());
+    const summary = score === 100
+        ? `All conformance checks passed. ${successful}/${total} tool calls succeeded in ${totalDurationMs}ms.`
+        : `Score ${score}/100 (${grade}). Missing: ${failedChecks.join(", ")}. ${successful}/${total} calls succeeded.`;
+    return {
+        sessionId: session.id,
+        preset: session.preset,
+        score,
+        grade,
+        breakdown,
+        summary,
+        totalSteps: total,
+        successfulSteps: successful,
+        failedSteps: failed,
+        totalDurationMs,
+        generatedAt: Date.now(),
+    };
+}
+//# sourceMappingURL=conformance.js.map

package/dist/engine/conformance.js.map

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

package/dist/engine/contextBridge.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Engine Context Bridge
+ *
+ * Connects the engine's ephemeral sessions to SQLite persistent storage.
+ * Loads accumulated context before workflow execution and persists outcomes after.
+ */
+import type { ConformanceReport } from "./conformance.js";
+import type { ToolCallRecord } from "./session.js";
+export interface SessionContext {
+    recentRuns: Array<{
+        workflow: string;
+        score: number;
+        grade: string;
+        durationMs: number;
+        createdAt: string;
+    }>;
+    relevantLearnings: Array<{
+        key: string;
+        content: string;
+        category: string;
+    }>;
+    conformanceTrend: {
+        direction: "improving" | "stable" | "regressing" | "insufficient_data";
+        avgScore: number;
+        runCount: number;
+    };
+    recentContentThemes: string[];
+    openGapCount: number;
+}
+export interface ContextHealth {
+    learningsCount: number;
+    recentRunScores: number[];
+    trendDirection: string;
+    contentArchiveSize: number;
+    daysSinceLastLearning: number | null;
+    workflowCoverage: Record<string, number>;
+}
+export declare function loadSessionContext(workflow: string, _preset: string): SessionContext;
+export declare function persistSessionOutcome(sessionId: string, report: ConformanceReport, workflow: string, preset: string, callHistory?: ToolCallRecord[]): void;
+export declare function getContextHealth(): ContextHealth;
+export declare function archiveContent(title: string, contentType: string, digest: string, themes: string[], workflow?: string, fullContent?: string): void;
+export declare function searchContentArchive(query: string, contentType?: string, limit?: number): Array<{
+    id: string;
+    title: string;
+    contentType: string;
+    digest: string;
+    themes: string[];
+    publishedAt: string;
+}>;
+export declare function getWorkflowHistory(workflow: string, limit?: number): Array<{
+    sessionId: string;
+    workflow: string;
+    preset: string;
+    score: number;
+    grade: string;
+    durationMs: number;
+    stepCount: number;
+    successCount: number;
+    failedCount: number;
+    createdAt: string;
+}>;
+export declare function searchLearnings(query: string, limit?: number): Array<{
+    key: string;
+    content: string;
+    category: string;
+    createdAt: string;
+}>;