@dv.nghiem/flowdeck 0.4.4 → 0.4.6

package/dist/services/supervisor.test.d.ts

@@ -1,14 +0,0 @@
-/**
- * Supervisor Binding Tests
- *
- * Covers:
- * - Approves an existing valid command
- * - Blocks an existing command with missing required stage
- * - Blocks a workflow that violates policy
- * - Does not invent new commands or workflows
- * - Integrates with current orchestrator without breaking existing command routing
- * - Only applied to already-registered commands/workflows
- * - Missing command/workflow reported correctly
- */
-export {};
-//# sourceMappingURL=supervisor.test.d.ts.map

package/dist/services/supervisor.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"supervisor.test.d.ts","sourceRoot":"","sources":["../../src/services/supervisor.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/services/task-batcher.d.ts

@@ -1,48 +0,0 @@
-/**
- * Task Batcher
- *
- * Coalesces multiple homogeneous cheap tasks into a single agent call.
- * Reduces N session creations + system-prompt injections to 1 for
- * classification/validation batches.
- *
- * SAFETY CONSTRAINTS:
- * - Max 5 tasks per batch (avoid context contamination in large batches)
- * - Each task must have a unique, non-empty id
- * - Partial salvage: successfully parsed results are returned even if
- *   others fail — caller decides how to handle failures
- * - The batcher builds prompts and parses responses; session creation
- *   is the caller's responsibility (use with `delegate`)
- */
-export declare const TASK_BATCHER_MAX_SIZE = 5;
-export interface BatchTask {
-    id: string;
-    prompt: string;
-}
-export interface BatchResult {
-    id: string;
-    result: string;
-    success: boolean;
-    error?: string;
-}
-export interface BatchResponse {
-    results: BatchResult[];
-    success_count: number;
-    failure_count: number;
-}
-/**
- * Build a single batched prompt from multiple tasks.
- * The expected response is a JSON array with `id` and `result` fields.
- */
-export declare function buildBatchPrompt(tasks: BatchTask[]): string;
-/**
- * Parse a batched model response into per-task results.
- * Returns partial results: tasks whose ids appear in the response are
- * marked success, missing tasks are marked failure.
- */
-export declare function parseBatchResponse(tasks: BatchTask[], rawResponse: string): BatchResponse;
-/**
- * Validate that a batch is safe to send.
- * Returns null if valid, or an error message if not.
- */
-export declare function validateBatch(tasks: BatchTask[]): string | null;
-//# sourceMappingURL=task-batcher.d.ts.map

package/dist/services/task-batcher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"task-batcher.d.ts","sourceRoot":"","sources":["../../src/services/task-batcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAiB3D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CA0DzF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,GAAG,IAAI,CAY/D"}

package/dist/services/task-batcher.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=task-batcher.test.d.ts.map

package/dist/services/task-batcher.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"task-batcher.test.d.ts","sourceRoot":"","sources":["../../src/services/task-batcher.test.ts"],"names":[],"mappings":""}

package/dist/services/telemetry.d.ts

@@ -1,48 +0,0 @@
-export type TelemetryEventType = "command.start" | "command.end" | "tool.call" | "tool.complete" | "tool.failed" | "tool.retried" | "tool.fallback" | "cache.hit" | "stage.progress" | "agent.dispatch" | "agent.complete" | "approval.request" | "approval.resolve" | "run.complete" | "run.fail" | "policy.violation" | "patch.scored" | "contract.violation" | "agent.span.open" | "agent.span.close" | "budget.warning" | "budget.exhausted" | "deadlock.detected" | "scorecard.generated" | "supervisor.review";
-export interface TelemetryEvent {
-    id: string;
-    ts: string;
-    session_id: string;
-    run_id: string;
-    event: TelemetryEventType;
-    command?: string;
-    agent?: string;
-    tool?: string;
-    model?: string;
-    duration_ms?: number;
-    status?: "ok" | "error" | "blocked" | "approved" | "rejected";
-    risk_score?: number;
-    files?: string[];
-    cost_estimate?: number;
-    error_category?: string;
-    /** Short summary of the tool's input (no raw dumps) */
-    input_summary?: string;
-    /** Short summary of the tool's result */
-    result_summary?: string;
-    /** Workflow stage (e.g. "research", "plan", "execute") */
-    stage?: string;
-    /** Number of retry attempts consumed */
-    retry_count?: number;
-    /** Estimated input tokens (chars / 4) for this event. */
-    input_tokens?: number;
-    /** Estimated output tokens (chars / 4) for this event. */
-    output_tokens?: number;
-    /** Raw input character count before prompt was sent to the model. */
-    context_size_chars?: number;
-    meta?: Record<string, unknown>;
-}
-export declare function telemetryPath(dir: string): string;
-export declare function appendEvent(dir: string, partial: Omit<TelemetryEvent, "id" | "ts">): TelemetryEvent | null;
-export declare function readEvents(dir: string, limit?: number): TelemetryEvent[];
-export declare function getRunEvents(dir: string, run_id: string): TelemetryEvent[];
-export interface CommandSummary {
-    command: string;
-    total_runs: number;
-    successes: number;
-    failures: number;
-    avg_duration_ms: number;
-    last_run: string;
-}
-export declare function getCommandSummary(dir: string, n?: number): CommandSummary[];
-export declare function getRecentToolFailures(dir: string, limit?: number): TelemetryEvent[];
-//# sourceMappingURL=telemetry.d.ts.map

package/dist/services/telemetry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/services/telemetry.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,aAAa,GACb,WAAW,GACX,eAAe,GACf,aAAa,GACb,cAAc,GACd,eAAe,GACf,WAAW,GACX,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,UAAU,GACV,kBAAkB,GAClB,cAAc,GAEd,oBAAoB,GACpB,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GAErB,mBAAmB,CAAA;AAEvB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,kBAAkB,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,cAAc,GAAG,IAAI,CAa1G;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,cAAc,EAAE,CAUrE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAE1E;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,SAAM,GAAG,cAAc,EAAE,CAuBxE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE,CAI/E"}

package/dist/services/token-budget.d.ts

@@ -1,44 +0,0 @@
-/**
- * Token Budget Service
- *
- * Provides INPUT size budgets and soft response directives by workflow stage
- * and task complexity. These are GUIDANCE values, not hard limits
- * (OpenCode SDK does not expose a max_tokens parameter on session.prompt).
- *
- * Hard controls apply to INPUT: context_chars_limit and prompt_chars_limit
- * cap carry-forward and total prompt size before sending.
- *
- * Soft controls: response_directive is a hint string appended to the prompt.
- * It asks the model to be concise — not enforced at the API level.
- */
-import type { WorkflowStage } from "./token-metrics";
-import type { TaskComplexity } from "./model-router";
-export interface TokenBudget {
-    /** Hard cap on context/carry-forward chars (apply before sending). */
-    context_chars_limit: number;
-    /** Hard cap on total prompt chars including system instructions. */
-    prompt_chars_limit: number;
-    /**
-     * Soft directive to append to the prompt.
-     * Empty string = no constraint injected.
-     * This is guidance only — not API-enforced.
-     */
-    response_directive: string;
-}
-/**
- * Get the token budget for a given workflow stage and task complexity.
- * Cheap tasks receive ~40% of the base budget; expensive tasks receive ~150%.
- */
-export declare function getTokenBudget(stage: WorkflowStage, complexity: TaskComplexity): TokenBudget;
-/**
- * Truncate a carry-forward context to fit within budget.
- * Preserves the most recent content (tail) when truncating.
- * Attempts to trim to a line boundary to avoid mid-line cuts.
- */
-export declare function applyContextBudget(context: string, budget: TokenBudget): string;
-/**
- * Append the response directive to a prompt, if one is set for this budget.
- * Returns the prompt unchanged when no directive applies.
- */
-export declare function applyResponseDirective(prompt: string, budget: TokenBudget): string;
-//# sourceMappingURL=token-budget.d.ts.map

package/dist/services/token-budget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token-budget.d.ts","sourceRoot":"","sources":["../../src/services/token-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,mBAAmB,EAAE,MAAM,CAAA;IAC3B,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,CAAA;IAC1B;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAyBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,GAAG,WAAW,CAY5F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAK/E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAGlF"}

package/dist/services/token-budget.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=token-budget.test.d.ts.map

package/dist/services/token-budget.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token-budget.test.d.ts","sourceRoot":"","sources":["../../src/services/token-budget.test.ts"],"names":[],"mappings":""}

package/dist/services/token-metrics-ext.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=token-metrics-ext.test.d.ts.map

package/dist/services/token-metrics-ext.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token-metrics-ext.test.d.ts","sourceRoot":"","sources":["../../src/services/token-metrics-ext.test.ts"],"names":[],"mappings":""}

package/dist/services/token-metrics.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=token-metrics.test.d.ts.map

package/dist/services/token-metrics.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token-metrics.test.d.ts","sourceRoot":"","sources":["../../src/services/token-metrics.test.ts"],"names":[],"mappings":""}

package/dist/tools/agent-dispatch.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=agent-dispatch.test.d.ts.map

package/dist/tools/agent-dispatch.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-dispatch.test.d.ts","sourceRoot":"","sources":["../../src/tools/agent-dispatch.test.ts"],"names":[],"mappings":""}

package/dist/tools/codebase-index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=codebase-index.test.d.ts.map

package/dist/tools/codebase-index.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codebase-index.test.d.ts","sourceRoot":"","sources":["../../src/tools/codebase-index.test.ts"],"names":[],"mappings":""}

package/dist/tools/context-generator.d.ts

@@ -1,3 +0,0 @@
-import { type ToolDefinition } from "@opencode-ai/plugin";
-export declare const contextGeneratorTool: ToolDefinition;
-//# sourceMappingURL=context-generator.d.ts.map

package/dist/tools/context-generator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-generator.d.ts","sourceRoot":"","sources":["../../src/tools/context-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAI/D,eAAO,MAAM,oBAAoB,EAAE,cAuDjC,CAAA"}

package/dist/tools/create-skill.d.ts

@@ -1,3 +0,0 @@
-import { type ToolDefinition } from "@opencode-ai/plugin";
-export declare const createSkillTool: ToolDefinition;
-//# sourceMappingURL=create-skill.d.ts.map

package/dist/tools/create-skill.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-skill.d.ts","sourceRoot":"","sources":["../../src/tools/create-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAO/D,eAAO,MAAM,eAAe,EAAE,cAgD5B,CAAA"}

package/dist/tools/dispatch-routing.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=dispatch-routing.test.d.ts.map

package/dist/tools/dispatch-routing.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch-routing.test.d.ts","sourceRoot":"","sources":["../../src/tools/dispatch-routing.test.ts"],"names":[],"mappings":""}

package/dist/tools/failure-replay.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=failure-replay.test.d.ts.map

package/dist/tools/failure-replay.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"failure-replay.test.d.ts","sourceRoot":"","sources":["../../src/tools/failure-replay.test.ts"],"names":[],"mappings":""}

package/dist/tools/repo-memory.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=repo-memory.test.d.ts.map

package/dist/tools/repo-memory.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"repo-memory.test.d.ts","sourceRoot":"","sources":["../../src/tools/repo-memory.test.ts"],"names":[],"mappings":""}

package/dist/tools/volatility-map.d.ts

@@ -1,18 +0,0 @@
-import { type ToolDefinition } from "@opencode-ai/plugin";
-export interface VolatilityEntry {
-    path: string;
-    churn_score: number;
-    hotfix_count: number;
-    todo_count: number;
-    last_breakage?: string;
-    stability: "stable" | "moderate" | "volatile" | "critical";
-    notes: string[];
-}
-export interface VolatilityStore {
-    version: string;
-    last_updated: string;
-    generated_at: string;
-    entries: VolatilityEntry[];
-}
-export declare const volatilityMapTool: ToolDefinition;
-//# sourceMappingURL=volatility-map.d.ts.map

package/dist/tools/volatility-map.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"volatility-map.d.ts","sourceRoot":"","sources":["../../src/tools/volatility-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAO/D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAA;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,eAAe,EAAE,CAAA;CAC3B;AA+BD,eAAO,MAAM,iBAAiB,EAAE,cAwE9B,CAAA"}

package/dist/tools/volatility-map.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=volatility-map.test.d.ts.map

package/dist/tools/volatility-map.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"volatility-map.test.d.ts","sourceRoot":"","sources":["../../src/tools/volatility-map.test.ts"],"names":[],"mappings":""}

package/dist/tools/workspace-state.d.ts

@@ -1,3 +0,0 @@
-import { type ToolDefinition } from "@opencode-ai/plugin";
-export declare const workspaceStateTool: ToolDefinition;
-//# sourceMappingURL=workspace-state.d.ts.map

package/dist/tools/workspace-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace-state.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAiH/D,eAAO,MAAM,kBAAkB,EAAE,cAmC/B,CAAA"}

package/src/skills/volatility-map/SKILL.md

@@ -1,52 +0,0 @@
----
-name: volatility-map
-description: Highlight unstable zones of the repo based on commit churn, recent breakages, hotfix frequency, and unresolved TODO clusters.
-origin: FlowDeck
----
-
-# Codebase Volatility Map
-
-Activate this skill to generate a heatmap of the most unstable parts of the codebase. Results are stored in `.codebase/VOLATILITY.json` for use by other FlowDeck features.
-
-## Stability Levels
-
-| Level | Score | Meaning |
-|-------|-------|---------|
-| stable | 0–19 | Low churn, no hotfixes, few TODOs |
-| moderate | 20–49 | Some churn, occasional fixes |
-| volatile | 50–79 | High churn or repeated hotfixes |
-| critical | 80+ | Highest risk, most likely to break |
-
-## Score Formula
-
-`score = churn_commits + (hotfix_count × 10) + (todo_count × 2)`
-
-## Data Collection Workflow
-
-1. **Churn analysis** (git log, last 90 days):
-   ```bash
-   git log --since="90 days ago" --name-only --pretty=format: | sort | uniq -c | sort -rn
-   ```
-2. **Hotfix detection** (commit messages):
-   ```bash
-   git log --since="90 days ago" --pretty=format:"%s %H" | grep -i "hotfix\|revert\|urgent\|critical"
-   ```
-3. **TODO scan** (source files):
-   ```bash
-   grep -rn "TODO\|FIXME\|HACK\|XXX" src/ --include="*.ts" | cut -d: -f1 | sort | uniq -c
-   ```
-4. Write results to VOLATILITY.json via `volatility-map` tool
-
-## How Other Features Use This
-
-- **Patch Trust Score**: deducts points for volatile/critical files
-- **Change Impact Radar**: flags volatile files in impact reports
-- **Safe Execution Modes**: switches to `guarded` for volatile, `review-only` for critical
-- **Human Review Routing**: escalates changes to volatile files to senior reviewers
-
-## Refresh Schedule
-
-Refresh the volatility map:
-- Before any significant feature work
-- After a production incident
-- Weekly in active development periods