@gracker/smartperfetto 1.0.13

package/dist/agentv3/standaloneMcpServer.js

@@ -0,0 +1,244 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LineDelimitedJsonSink = exports.LineDelimitedJsonSource = exports.RPC_ERROR_CODES = void 0;
+exports.dispatch = dispatch;
+exports.runStdioLoop = runStdioLoop;
+/**
+ * StandaloneMcpServer — Plan 41 M1 stdio server.
+ *
+ * Implements the minimum subset of the Model Context Protocol that
+ * Claude Code, Cursor, and Codex CLI clients use:
+ *   - `initialize` handshake with capabilities advertisement
+ *   - `tools/list` — returns the public-exposure tools from
+ *     `McpToolRegistry`
+ *   - `tools/call` — invokes the requested tool's handler with
+ *     args, returns the structured content
+ *
+ * Wire protocol is JSON-RPC 2.0 over line-delimited JSON
+ * (one request per stdin line, one response per stdout line).
+ *
+ * The dispatcher is factored out from the actual stdio wiring so
+ * unit tests can drive request/response pairs without spawning a
+ * subprocess. `bin/smartperfetto-mcp.ts` is the thin entry that
+ * pipes process.stdin/stdout into `runStdioLoop`.
+ *
+ * Out of scope:
+ * - Capability negotiation beyond `tools` (no resources / prompts).
+ * - Auth handshake (deferred to Plan 41 M2 A2A).
+ * - Streaming tool output (the agent SDK handlers we wrap are
+ *   request/response only).
+ *
+ * @module standaloneMcpServer
+ */
+const mcpToolRegistry_1 = require("./mcpToolRegistry");
+const PROTOCOL_VERSION = '2024-11-05';
+const SERVER_NAME = 'smartperfetto';
+const SERVER_VERSION = '1.0.0';
+/** Standard JSON-RPC error codes plus MCP-specific tool errors. */
+exports.RPC_ERROR_CODES = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    TOOL_EXECUTION_FAILED: -32000,
+};
+/** Best-effort handler extraction across SDK versions. */
+function getToolHandler(tool) {
+    const t = tool;
+    if (typeof t.handler === 'function')
+        return t.handler.bind(t);
+    if (typeof t.callback === 'function')
+        return t.callback.bind(t);
+    if (typeof t.fn === 'function')
+        return t.fn.bind(t);
+    return null;
+}
+/** Dispatch one JSON-RPC request against the registry. Pure
+ * function — no I/O. The stdio loop wraps this and writes the
+ * response back. */
+async function dispatch(registry, req) {
+    // Notifications (no id) — execute side effects but never reply.
+    // Our protocol surface has none, but per JSON-RPC we silently drop.
+    if (req.id === undefined)
+        return null;
+    const id = req.id;
+    // Codex round E P2#5: parse-error sentinel surfaces with a real
+    // PARSE_ERROR response instead of falling through to METHOD_NOT_FOUND.
+    if (req.method === '__parse_error__') {
+        return rpcError(null, exports.RPC_ERROR_CODES.PARSE_ERROR, 'Invalid JSON');
+    }
+    if (req.method === 'initialize') {
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: {
+                protocolVersion: PROTOCOL_VERSION,
+                serverInfo: { name: SERVER_NAME, version: SERVER_VERSION },
+                capabilities: { tools: {} },
+            },
+        };
+    }
+    if (req.method === 'tools/list') {
+        // External hosts only see public tools. Internal session-protocol
+        // tools (submit_plan, write_analysis_note, etc.) stay hidden so a
+        // remote Claude Code instance cannot corrupt our session state.
+        const publicDefs = (0, mcpToolRegistry_1.filterByExposure)(registry.list(), ['public']);
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: {
+                tools: publicDefs.map(d => sdkToolToMcpDescriptor(d)),
+            },
+        };
+    }
+    if (req.method === 'tools/call') {
+        const params = (req.params ?? {});
+        if (!params.name || typeof params.name !== 'string') {
+            return rpcError(id, exports.RPC_ERROR_CODES.INVALID_PARAMS, '`name` is required');
+        }
+        const def = registry.list().find(d => d.name === params.name);
+        if (!def) {
+            return rpcError(id, exports.RPC_ERROR_CODES.METHOD_NOT_FOUND, `Unknown tool '${params.name}'`);
+        }
+        if (def.exposure !== 'public') {
+            // Internal / deprecated tools stay invisible to external hosts
+            // both in the listing and at call time.
+            return rpcError(id, exports.RPC_ERROR_CODES.METHOD_NOT_FOUND, `Tool '${params.name}' is not exposed to external hosts`);
+        }
+        const handler = getToolHandler(def.tool);
+        if (!handler) {
+            return rpcError(id, exports.RPC_ERROR_CODES.INTERNAL_ERROR, `Tool '${params.name}' has no callable handler`);
+        }
+        try {
+            const out = await handler(params.arguments ?? {});
+            return { jsonrpc: '2.0', id, result: out };
+        }
+        catch (err) {
+            return rpcError(id, exports.RPC_ERROR_CODES.TOOL_EXECUTION_FAILED, err instanceof Error ? err.message : String(err));
+        }
+    }
+    return rpcError(id, exports.RPC_ERROR_CODES.METHOD_NOT_FOUND, `Unknown method '${req.method}'`);
+}
+function rpcError(id, code, message) {
+    return { jsonrpc: '2.0', id, error: { code, message } };
+}
+function sdkToolToMcpDescriptor(def) {
+    const t = def.tool;
+    return {
+        name: def.name,
+        description: def.summary || t.description || '',
+        // Codex round E P1#1: SDK's `inputSchema` is Zod raw shape, not
+        // JSON Schema. Emit a safe permissive descriptor so external MCP
+        // clients see valid JSON Schema; the handler still validates
+        // against the real Zod shape on `tools/call`.
+        inputSchema: { type: 'object', additionalProperties: true },
+    };
+}
+/** Run the dispatch loop until the source is exhausted. Each
+ * request is dispatched independently; failures in one tool call
+ * never bring down the loop. */
+async function runStdioLoop(registry, source, sink) {
+    while (true) {
+        const req = await source.next();
+        if (req === null)
+            return;
+        try {
+            const resp = await dispatch(registry, req);
+            if (resp)
+                sink.send(resp);
+        }
+        catch (err) {
+            // Defensive: dispatch itself shouldn't throw, but if a tool
+            // handler throws synchronously past the inner catch, log it
+            // back as an internal error rather than crashing the server.
+            const id = req.id ?? null;
+            sink.send(rpcError(id, exports.RPC_ERROR_CODES.INTERNAL_ERROR, err instanceof Error ? err.message : String(err)));
+        }
+    }
+}
+/** stdin-backed request source: reads line-delimited JSON from a
+ * Node Readable. Returns null when the stream ends. Malformed JSON
+ * lines are surfaced as a special MALFORMED_PARSE request so the
+ * dispatch layer can emit a proper PARSE_ERROR. */
+class LineDelimitedJsonSource {
+    constructor(stream) {
+        this.buffer = '';
+        this.queue = [];
+        this.closed = false;
+        this.wakeup = null;
+        stream.setEncoding?.('utf-8');
+        stream.on('data', (chunk) => {
+            this.buffer += chunk;
+            this.drainBuffer();
+            this.wake();
+        });
+        stream.on('end', () => {
+            // Flush any partial line.
+            if (this.buffer.trim().length > 0) {
+                this.tryParseAndQueue(this.buffer);
+                this.buffer = '';
+            }
+            this.closed = true;
+            this.wake();
+        });
+        stream.on('close', () => {
+            this.closed = true;
+            this.wake();
+        });
+    }
+    drainBuffer() {
+        let nl;
+        while ((nl = this.buffer.indexOf('\n')) >= 0) {
+            const line = this.buffer.slice(0, nl).trim();
+            this.buffer = this.buffer.slice(nl + 1);
+            if (line.length > 0)
+                this.tryParseAndQueue(line);
+        }
+    }
+    tryParseAndQueue(line) {
+        try {
+            const obj = JSON.parse(line);
+            this.queue.push(obj);
+        }
+        catch {
+            this.queue.push(PARSE_ERROR_SENTINEL);
+        }
+    }
+    wake() {
+        const w = this.wakeup;
+        this.wakeup = null;
+        w?.();
+    }
+    async next() {
+        while (this.queue.length === 0 && !this.closed) {
+            await new Promise(resolve => (this.wakeup = resolve));
+        }
+        const head = this.queue.shift();
+        if (!head)
+            return null;
+        if (head === PARSE_ERROR_SENTINEL) {
+            // Synthesize a parse-error request — the dispatcher emits the
+            // proper PARSE_ERROR response. id=null since we have no real id.
+            return { jsonrpc: '2.0', id: null, method: '__parse_error__' };
+        }
+        return head;
+    }
+}
+exports.LineDelimitedJsonSource = LineDelimitedJsonSource;
+const PARSE_ERROR_SENTINEL = Symbol('parse-error');
+/** stdout-backed response sink. Writes one JSON-encoded response
+ * per line. */
+class LineDelimitedJsonSink {
+    constructor(stream) {
+        this.stream = stream;
+    }
+    send(response) {
+        this.stream.write(JSON.stringify(response) + '\n');
+    }
+}
+exports.LineDelimitedJsonSink = LineDelimitedJsonSink;
+//# sourceMappingURL=standaloneMcpServer.js.map

package/dist/agentv3/standaloneMcpServer.js.map

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

package/dist/agentv3/strategyLoader.d.ts

@@ -0,0 +1,96 @@
+/** Phase-level restatement hint — loaded from strategy frontmatter `phase_hints`. */
+export interface PhaseHint {
+    id: string;
+    keywords: string[];
+    constraints: string;
+    criticalTools: string[];
+    /** When true, this hint is injected as unconditional fallback if keyword matching fails. */
+    critical: boolean;
+}
+/**
+ * A single mandatory aspect a plan must touch — sourced from a scene's
+ * `plan_template.mandatory_aspects` frontmatter. The submit_plan /
+ * revise_plan hard-gate fails when no plan phase mentions any of the
+ * `matchKeywords`.
+ */
+export interface PlanMandatoryAspect {
+    /** Stable identifier for diff-friendly tracking (e.g. `frame_jank_analysis`). */
+    id: string;
+    matchKeywords: string[];
+    suggestion: string;
+}
+/** Plan template loaded from a strategy's `plan_template:` frontmatter. */
+export interface PlanTemplate {
+    mandatoryAspects: PlanMandatoryAspect[];
+}
+export interface StrategyDefinition {
+    scene: string;
+    priority: number;
+    effort: string;
+    keywords: string[];
+    compoundPatterns: RegExp[];
+    /** Capability IDs required for this scene (missing = critical gap) */
+    requiredCapabilities: string[];
+    /** Capability IDs that enhance analysis but are not required */
+    optionalCapabilities: string[];
+    /** Phase-level hints for mid-analysis restatement injection. */
+    phaseHints: PhaseHint[];
+    /**
+     * Plan template — mandatory aspects every submitted plan must cover for
+     * this scene. `null` (vs. an empty mandatoryAspects array) means the
+     * scene has deliberately opted out of plan-template validation.
+     */
+    planTemplate: PlanTemplate | null;
+    content: string;
+    /**
+     * Absolute path to the source `*.strategy.md` file. Required because the
+     * scene id (e.g. `touch_tracking`) is not always the file basename
+     * (`touch-tracking.strategy.md`); callers that need the file itself —
+     * fingerprinting, hot-reload diffing — must resolve through this field
+     * instead of `${scene}.strategy.md`.
+     */
+    sourcePath: string;
+}
+export declare function loadStrategies(): Map<string, StrategyDefinition>;
+export declare function getStrategyContent(scene: string): string | undefined;
+export declare function getRegisteredScenes(): StrategyDefinition[];
+/** Get phase-level restatement hints for a scene. Returns [] if scene has no hints. */
+export declare function getPhaseHints(scene: string): PhaseHint[];
+/**
+ * Get the plan template for a scene loaded from `plan_template:`
+ * frontmatter. Returns `null` for unknown scenes and for scenes that
+ * deliberately opted out (no `plan_template` block in their frontmatter).
+ *
+ * Phase 2.1 of v2.1 — strategies migrated to frontmatter take priority
+ * over the legacy hardcoded `SCENE_PLAN_TEMPLATES` map; the legacy map
+ * remains as a fallback in `scenePlanTemplates.ts` until every strategy
+ * has migrated.
+ */
+export declare function getPlanTemplate(scene: string): PlanTemplate | null;
+/**
+ * Resolve the absolute path of the `*.strategy.md` file backing a scene.
+ * Returns `undefined` for unknown scenes. Use this instead of `${scene}.strategy.md`
+ * — file basenames may use hyphens (`touch-tracking.strategy.md`) where
+ * the scene id uses underscores (`touch_tracking`).
+ */
+export declare function getStrategyFilePath(scene: string): string | undefined;
+/** Clear cached strategies and templates — useful for dev/test reloads. */
+export declare function invalidateStrategyCache(): void;
+/**
+ * Load a prompt template from `backend/strategies/<name>.template.md`.
+ * Templates use `{{variable}}` placeholders that callers substitute at runtime via `renderTemplate()`.
+ * Static templates (no variables) can be used directly as-is.
+ *
+ * Results are cached in `templateCache` and cleared by `invalidateStrategyCache()`.
+ */
+export declare function loadPromptTemplate(name: string): string | undefined;
+/**
+ * Load a selection context template from `backend/strategies/selection-<kind>.template.md`.
+ * Delegates to `loadPromptTemplate()` with the `selection-` prefix.
+ */
+export declare function loadSelectionTemplate(kind: string): string | undefined;
+/**
+ * Substitute `{{key}}` placeholders in a template string with provided values.
+ */
+export declare function renderTemplate(template: string, vars: Record<string, string | number | undefined>): string;
+//# sourceMappingURL=strategyLoader.d.ts.map

package/dist/agentv3/strategyLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategyLoader.d.ts","sourceRoot":"","sources":["../../src/agentv3/strategyLoader.ts"],"names":[],"mappings":"AAwBA,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,sEAAsE;IACtE,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,gEAAgE;IAChE,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,gEAAgE;IAChE,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB;;;;OAIG;IACH,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AA0DD,wBAAgB,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAehE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,EAAE,CAE1D;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED,2EAA2E;AAC3E,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAQD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASnE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAK1G"}

package/dist/agentv3/strategyLoader.js

@@ -0,0 +1,204 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadStrategies = loadStrategies;
+exports.getStrategyContent = getStrategyContent;
+exports.getRegisteredScenes = getRegisteredScenes;
+exports.getPhaseHints = getPhaseHints;
+exports.getPlanTemplate = getPlanTemplate;
+exports.getStrategyFilePath = getStrategyFilePath;
+exports.invalidateStrategyCache = invalidateStrategyCache;
+exports.loadPromptTemplate = loadPromptTemplate;
+exports.loadSelectionTemplate = loadSelectionTemplate;
+exports.renderTemplate = renderTemplate;
+/**
+ * Loads external prompt content from `backend/strategies/`:
+ *
+ * 1. **Scene strategies** (`*.strategy.md`): YAML frontmatter + Markdown body.
+ *    Used by `sceneClassifier.ts` for matching and `claudeSystemPrompt.ts` for injection.
+ *    Adding a new scene requires only a new `.strategy.md` file, no code changes.
+ *
+ * 2. **Prompt templates** (`*.template.md`): Markdown with optional `{{variable}}`
+ *    placeholders, substituted at runtime by `renderTemplate()`.
+ *    Used by `claudeSystemPrompt.ts` for role, methodology, output format,
+ *    architecture guidance, and selection context sections.
+ *    Adding/editing prompt content requires only template changes, no code changes.
+ *
+ * Both categories are cached on first load and cleared together via `invalidateStrategyCache()`.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const STRATEGIES_DIR = path.resolve(__dirname, '../../strategies');
+/** Tolerates leading `<!-- -->` blocks (e.g. SPDX/license headers) before the frontmatter. */
+const FRONTMATTER_RE = /^(?:\s*<!--[\s\S]*?-->\s*)*---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
+/** In dev mode, skip caching so .strategy.md / .template.md edits take effect without restart. */
+const DEV_MODE = process.env.NODE_ENV !== 'production';
+let cache = null;
+function parseStrategyFile(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    const match = raw.match(FRONTMATTER_RE);
+    if (!match)
+        return null;
+    const frontmatter = yaml.load(match[1]);
+    const content = match[2].trim();
+    const compoundPatternStrings = frontmatter.compound_patterns || [];
+    const compoundPatterns = compoundPatternStrings.map(p => new RegExp(p, 'i'));
+    const rawHints = frontmatter.phase_hints || [];
+    const phaseHints = rawHints.map(h => ({
+        id: h.id || '',
+        keywords: h.keywords || [],
+        constraints: h.constraints || '',
+        criticalTools: h.critical_tools || [],
+        critical: h.critical ?? false,
+    }));
+    const rawPlanTemplate = frontmatter.plan_template;
+    let planTemplate = null;
+    if (rawPlanTemplate) {
+        const aspects = rawPlanTemplate.mandatory_aspects || [];
+        planTemplate = {
+            mandatoryAspects: aspects.map(a => ({
+                id: a.id || '',
+                matchKeywords: a.match_keywords || [],
+                suggestion: a.suggestion || '',
+            })),
+        };
+    }
+    return {
+        scene: frontmatter.scene,
+        priority: frontmatter.priority ?? 99,
+        effort: frontmatter.effort ?? 'high',
+        keywords: frontmatter.keywords || [],
+        compoundPatterns,
+        requiredCapabilities: frontmatter.required_capabilities || [],
+        optionalCapabilities: frontmatter.optional_capabilities || [],
+        phaseHints,
+        planTemplate,
+        content,
+        sourcePath: filePath,
+    };
+}
+function loadStrategies() {
+    if (cache && !DEV_MODE)
+        return cache;
+    cache = new Map();
+    const files = fs.readdirSync(STRATEGIES_DIR)
+        .filter(f => f.endsWith('.strategy.md'));
+    for (const file of files) {
+        const def = parseStrategyFile(path.join(STRATEGIES_DIR, file));
+        if (def) {
+            cache.set(def.scene, def);
+        }
+    }
+    return cache;
+}
+function getStrategyContent(scene) {
+    return loadStrategies().get(scene)?.content;
+}
+function getRegisteredScenes() {
+    return Array.from(loadStrategies().values());
+}
+/** Get phase-level restatement hints for a scene. Returns [] if scene has no hints. */
+function getPhaseHints(scene) {
+    return loadStrategies().get(scene)?.phaseHints || [];
+}
+/**
+ * Get the plan template for a scene loaded from `plan_template:`
+ * frontmatter. Returns `null` for unknown scenes and for scenes that
+ * deliberately opted out (no `plan_template` block in their frontmatter).
+ *
+ * Phase 2.1 of v2.1 — strategies migrated to frontmatter take priority
+ * over the legacy hardcoded `SCENE_PLAN_TEMPLATES` map; the legacy map
+ * remains as a fallback in `scenePlanTemplates.ts` until every strategy
+ * has migrated.
+ */
+function getPlanTemplate(scene) {
+    return loadStrategies().get(scene)?.planTemplate ?? null;
+}
+/**
+ * Resolve the absolute path of the `*.strategy.md` file backing a scene.
+ * Returns `undefined` for unknown scenes. Use this instead of `${scene}.strategy.md`
+ * — file basenames may use hyphens (`touch-tracking.strategy.md`) where
+ * the scene id uses underscores (`touch_tracking`).
+ */
+function getStrategyFilePath(scene) {
+    return loadStrategies().get(scene)?.sourcePath;
+}
+/** Clear cached strategies and templates — useful for dev/test reloads. */
+function invalidateStrategyCache() {
+    cache = null;
+    templateCache.clear();
+}
+// ---------------------------------------------------------------------------
+// Prompt & selection context templates ({{variable}} substitution)
+// ---------------------------------------------------------------------------
+const templateCache = new Map();
+/**
+ * Load a prompt template from `backend/strategies/<name>.template.md`.
+ * Templates use `{{variable}}` placeholders that callers substitute at runtime via `renderTemplate()`.
+ * Static templates (no variables) can be used directly as-is.
+ *
+ * Results are cached in `templateCache` and cleared by `invalidateStrategyCache()`.
+ */
+function loadPromptTemplate(name) {
+    if (templateCache.has(name) && !DEV_MODE)
+        return templateCache.get(name);
+    const filePath = path.join(STRATEGIES_DIR, `${name}.template.md`);
+    if (!fs.existsSync(filePath))
+        return undefined;
+    const content = fs.readFileSync(filePath, 'utf-8').trim();
+    templateCache.set(name, content);
+    return content;
+}
+/**
+ * Load a selection context template from `backend/strategies/selection-<kind>.template.md`.
+ * Delegates to `loadPromptTemplate()` with the `selection-` prefix.
+ */
+function loadSelectionTemplate(kind) {
+    return loadPromptTemplate(`selection-${kind}`);
+}
+/**
+ * Substitute `{{key}}` placeholders in a template string with provided values.
+ */
+function renderTemplate(template, vars) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+        const val = vars[key];
+        return val !== undefined ? String(val) : `{{${key}}}`;
+    });
+}
+//# sourceMappingURL=strategyLoader.js.map

package/dist/agentv3/strategyLoader.js.map

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

package/dist/agentv3/toolCallSummary.d.ts

@@ -0,0 +1,15 @@
+export interface ToolCallSummary {
+    inputSummary?: string;
+    skillId?: string;
+    paramsHash?: string;
+}
+/**
+ * Resolve a structured digest for an MCP tool call. `toolName` must be the
+ * short form (without the `mcp__smartperfetto__` prefix).
+ *
+ * Tools with well-known input shapes (`execute_sql`, `invoke_skill`,
+ * `fetch_artifact`) get hand-tuned summaries; everything else falls back
+ * to a truncated JSON dump.
+ */
+export declare function summarizeToolCallInput(toolName: string, input: unknown): ToolCallSummary;
+//# sourceMappingURL=toolCallSummary.d.ts.map

package/dist/agentv3/toolCallSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolCallSummary.d.ts","sourceRoot":"","sources":["../../src/agentv3/toolCallSummary.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,eAAe,CA+BxF"}

package/dist/agentv3/toolCallSummary.js

@@ -0,0 +1,66 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeToolCallInput = summarizeToolCallInput;
+/**
+ * Build a one-line digest of an MCP tool's `input` object so plan-adherence
+ * checks can confirm the *right* call was made, not just any call with the
+ * right tool name. Two `invoke_skill` calls targeting different skills
+ * should be distinguishable in the tool log.
+ *
+ * Phase 0.5 of the v2.1 context-engineering refactor introduces this; Phase
+ * 0.6 changes `PlanPhase.expectedCalls` to a structured `{tool, skillId?,
+ * paramsPredicate?}` matcher that consumes `skillId` / `inputSummary`.
+ */
+const crypto_1 = require("crypto");
+const SHORT_LIMIT = 120;
+function shorten(s) {
+    const flat = s.replace(/\s+/g, ' ').trim();
+    return flat.length > SHORT_LIMIT ? flat.slice(0, SHORT_LIMIT - 3) + '...' : flat;
+}
+function hashInput(input) {
+    return (0, crypto_1.createHash)('sha256').update(JSON.stringify(input ?? null)).digest('hex').slice(0, 8);
+}
+/**
+ * Resolve a structured digest for an MCP tool call. `toolName` must be the
+ * short form (without the `mcp__smartperfetto__` prefix).
+ *
+ * Tools with well-known input shapes (`execute_sql`, `invoke_skill`,
+ * `fetch_artifact`) get hand-tuned summaries; everything else falls back
+ * to a truncated JSON dump.
+ */
+function summarizeToolCallInput(toolName, input) {
+    if (input == null || typeof input !== 'object')
+        return {};
+    const obj = input;
+    const paramsHash = hashInput(input);
+    switch (toolName) {
+        case 'execute_sql': {
+            const sql = typeof obj.sql === 'string' ? obj.sql : '';
+            return { inputSummary: shorten(sql) || undefined, paramsHash };
+        }
+        case 'invoke_skill': {
+            const skillId = typeof obj.skillId === 'string' ? obj.skillId : undefined;
+            const params = obj.params && typeof obj.params === 'object'
+                ? obj.params
+                : {};
+            const paramKeys = Object.keys(params).sort().join(',');
+            const inputSummary = skillId
+                ? (paramKeys ? `${skillId}(${paramKeys})` : skillId)
+                : undefined;
+            return { skillId, inputSummary, paramsHash };
+        }
+        case 'fetch_artifact': {
+            const id = obj.artifactId ?? obj.id ?? '?';
+            const detail = obj.detail ?? '?';
+            const purpose = typeof obj.purpose === 'string' ? ` ${shorten(obj.purpose)}` : '';
+            return { inputSummary: `${id}@${detail}${purpose}`, paramsHash };
+        }
+        default: {
+            return { inputSummary: shorten(JSON.stringify(input)), paramsHash };
+        }
+    }
+}
+//# sourceMappingURL=toolCallSummary.js.map

package/dist/agentv3/toolCallSummary.js.map

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