@pythonluvr/openwar 0.4.0

package/dist/tools/types.d.ts

@@ -0,0 +1,48 @@
+import type { AuthCategory } from "../auth/categories.js";
+import type { SandboxContext } from "../sandbox/types.js";
+export type ToolOrigin = "native" | "mcp";
+export interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    description?: string;
+    enum?: unknown[];
+    [k: string]: unknown;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    input_schema: JsonSchema;
+    origin: ToolOrigin;
+    authorization_categories: AuthCategory[];
+    mcp_server_name?: string;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: unknown;
+}
+export interface ToolError {
+    code: string;
+    message: string;
+}
+export interface ToolResultMeta {
+    duration_ms?: number;
+    truncated?: boolean;
+    bytes?: number;
+    exit_code?: number;
+    signal?: string;
+}
+export interface ToolResult {
+    call_id: string;
+    success: boolean;
+    content: string;
+    error?: ToolError;
+    meta?: ToolResultMeta;
+}
+export interface ToolExecutor {
+    (call: ToolCall, ctx: ToolExecutionContext): Promise<ToolResult>;
+}
+export type ToolExecutionContext = SandboxContext;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;AAK1C,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IAEjB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAG7B,IAAI,EAAE,MAAM,CAAC;IAGb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,UAAU,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IAGnB,wBAAwB,EAAE,YAAY,EAAE,CAAC;IAGzC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IAGvB,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAGb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IAGxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IAGjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAKD,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAClE;AAKD,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC"}

package/dist/tools/types.js

@@ -0,0 +1,10 @@
+// Shared shapes for tool calling. Used by:
+//   - Native built-in tools (src/tools/native/*)
+//   - MCP tools (src/mcp/*)
+//   - Adapter tool-call translation (src/adapters/*)
+//   - Runtime integration (src/runner.ts, src/phases/execute.ts)
+//   - Authorization gate (src/auth/check.ts)
+//
+// These types are the contract every tool path must honor. Changes here ripple.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,iDAAiD;AACjD,4BAA4B;AAC5B,qDAAqD;AACrD,iEAAiE;AACjE,6CAA6C;AAC7C,EAAE;AACF,gFAAgF"}

package/dist/types.d.ts

@@ -0,0 +1,385 @@
+import type { ToolDefinition, ToolCall } from "./tools/types.js";
+export type { ToolDefinition, ToolCall, ToolResult, ToolError, ToolResultMeta, ToolExecutor, JsonSchema, ToolOrigin } from "./tools/types.js";
+export type ExecutionMode = "gated" | "auto";
+export interface BriefFrontmatter {
+    project: string;
+    brief_id?: string;
+    deadline?: string;
+    scope_locked: boolean;
+    mode?: ExecutionMode;
+    authorized_costs: string[];
+    workdir?: string;
+    mcp_servers?: {
+        name: string;
+        command: string;
+        cwd?: string;
+    }[];
+    roles?: string[];
+    budgets?: Partial<{
+        max_tokens: number;
+        max_wall_clock_minutes: number;
+        max_tool_calls_per_subtask: number;
+        max_retries_per_subtask: number;
+    }>;
+}
+export interface BriefSections {
+    objective: string;
+    deliverables: string;
+    constraints: string;
+    tools_required: string;
+    notes: string;
+    extra: Record<string, string>;
+}
+export interface Brief {
+    frontmatter: BriefFrontmatter;
+    sections: BriefSections;
+    raw: string;
+    source_path?: string;
+}
+export interface ValidationIssue {
+    field: string;
+    message: string;
+    severity: "error" | "warning";
+}
+export interface ValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+export type Phase = "intake" | "execute" | "blocker" | "destructive" | "completion" | "done";
+export interface PhaseTransition {
+    from: Phase;
+    to: Phase;
+    at: string;
+    reason: string;
+}
+export type MessageRole = "system" | "user" | "assistant";
+/** @deprecated Use MessageRole. Will be removed in a future minor. */
+export type Role = MessageRole;
+export interface Message {
+    role: MessageRole;
+    content: string;
+    at: string;
+    meta?: {
+        phase?: Phase;
+        step_index?: number;
+        detectors?: DetectorSnapshot;
+        orch_role?: RoleId | null;
+        subtask_id?: string;
+    };
+}
+export interface ConfirmationDetection {
+    found: boolean;
+    sections: {
+        objective?: string;
+        deliverables?: string;
+        constraints?: string;
+        tools_required?: string;
+        unknowns?: string;
+    };
+    asked_for_mode: boolean;
+}
+export interface BlockerDetection {
+    blocked: boolean;
+    reason: string | null;
+    matched_pattern?: string;
+}
+export interface DestructiveDetection {
+    destructive: boolean;
+    action: string | null;
+    authorized: boolean;
+    matched_pattern?: string;
+}
+export interface BannedPhraseDetection {
+    count: number;
+    phrases: string[];
+}
+export interface PhaseMarkerDetection {
+    declared: Phase[];
+    last?: Phase;
+}
+export interface CompletionDetection {
+    complete: boolean;
+    matched_pattern?: string;
+}
+export interface DetectorSnapshot {
+    confirmation?: ConfirmationDetection;
+    blocker?: BlockerDetection;
+    destructive?: DestructiveDetection;
+    banned_phrases?: BannedPhraseDetection;
+    phase_marker?: PhaseMarkerDetection;
+    completion?: CompletionDetection;
+}
+export interface SendMessageOptions {
+    system: string;
+    messages: Message[];
+    tools?: ToolDefinition[];
+    prior_tool_calls?: ToolCall[];
+    prior_tool_results?: ToolResultForRound[];
+    signal?: AbortSignal;
+}
+export interface ToolResultForRound {
+    call_id: string;
+    content: string;
+    is_error?: boolean;
+}
+export type StreamEvent = {
+    type: "text_delta";
+    delta: string;
+} | {
+    type: "tool_call_arg_delta";
+    tool_call_id: string;
+    name: string;
+    arg_delta: string;
+} | {
+    type: "tool_call_complete";
+    call: ToolCall;
+} | {
+    type: "done";
+    message: string;
+    tool_calls?: ToolCall[];
+} | {
+    type: "error";
+    error: Error;
+};
+export interface AgentAdapter {
+    readonly id: string;
+    readonly name: string;
+    readonly model: string;
+    isConfigured(): boolean;
+    sendMessage(opts: SendMessageOptions): AsyncIterable<StreamEvent>;
+}
+export interface AdapterConfig {
+    id: string;
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    extra?: Record<string, unknown>;
+}
+export interface SessionMeta {
+    brief_id: string;
+    project: string;
+    started_at: string;
+    updated_at: string;
+    phase: Phase;
+    mode: ExecutionMode | null;
+    destructive_approvals: DestructiveApproval[];
+    transitions: PhaseTransition[];
+    schema_version?: number;
+    session_approved_categories?: string[];
+    tool_calls?: ToolCallRecord[];
+}
+export interface ToolCallRecord {
+    call_id: string;
+    name: string;
+    arguments: unknown;
+    at: string;
+    authorized: boolean;
+    auth_note?: string;
+    result?: {
+        success: boolean;
+        content: string;
+        meta?: unknown;
+    };
+}
+export interface DestructiveApproval {
+    at: string;
+    action: string;
+    approved: boolean;
+    session_categories?: string[];
+}
+export interface SessionState {
+    meta: SessionMeta;
+    brief: Brief;
+    messages: Message[];
+}
+export interface RunOptions {
+    briefPath?: string;
+    briefSource?: string;
+    adapter: AgentAdapter;
+    mode?: ExecutionMode;
+    json?: boolean;
+    ephemeral?: boolean;
+    sessionId?: string;
+    io?: RunnerIO;
+    resume?: boolean;
+    workdir?: string;
+    disableShell?: boolean;
+    mcpServers?: {
+        name: string;
+        command: string;
+        cwd?: string;
+    }[];
+    disableNativeTools?: boolean;
+    runtimeRoles?: string[];
+    runtimeBudgets?: Partial<{
+        max_tokens: number;
+        max_wall_clock_minutes: number;
+        max_tool_calls_per_subtask: number;
+        max_retries_per_subtask: number;
+    }>;
+}
+export interface RunResult {
+    session_id: string;
+    final_phase: Phase;
+    completed: boolean;
+    halted: boolean;
+    halt_reason?: string;
+    messages: Message[];
+}
+export interface RunnerIO {
+    write(text: string): void;
+    banner(text: string): void;
+    warn(text: string): void;
+    prompt(question: string): Promise<string>;
+    confirm(question: string): Promise<boolean>;
+}
+export type BuiltInRoleId = "planner" | "executor" | "reviewer" | "critic";
+export type RoleId = string;
+export interface RoleDefinition {
+    id: RoleId;
+    description: string;
+    prompt_overlay: string;
+    tool_categories: string[];
+    allow_read_file?: boolean;
+}
+export interface RoleContext {
+    brief: Brief;
+    history: Message[];
+    subtask: SubTask | null;
+    execution_handoff?: ExecutionHandoff;
+    adapter: AgentAdapter;
+    system: string;
+    io: RunnerIO;
+    signal?: AbortSignal;
+    toolDefinitions?: ToolDefinition[];
+    toolExecutors?: Map<string, import("./tools/types.js").ToolExecutor>;
+    sandbox?: import("./sandbox/types.js").SandboxContext;
+    sessionApproved?: string[];
+}
+export interface RoleResult {
+    role: RoleId;
+    text: string;
+    history: Message[];
+    plan?: PlanHandoff;
+    execution?: ExecutionHandoff;
+    review?: ReviewHandoff;
+    escalation?: EscalationHandoff;
+    blocked?: boolean;
+    blocker_reason?: string;
+    cost?: RoleCost;
+}
+export interface RoleCost {
+    tokens_used: number;
+    tool_calls: number;
+    wall_clock_ms: number;
+}
+export type CoordinatorState = "init" | "plan" | "dispatch" | "execute" | "review_step" | "next_subtask" | "retry" | "block" | "escalate" | "complete";
+export interface SubTask {
+    id: string;
+    title: string;
+    instruction: string;
+    acceptance_criteria: string[];
+    order: number;
+    depends_on?: string[];
+}
+export type SubTaskStatus = "pending" | "executing" | "reviewing" | "passed" | "failed" | "retrying" | "escalated" | "skipped";
+export interface SubTaskState {
+    id: string;
+    status: SubTaskStatus;
+    attempts: number;
+    last_handoff?: ExecutionHandoff;
+    last_review?: ReviewHandoff;
+    escalation?: EscalationHandoff;
+    started_at?: string;
+    finished_at?: string;
+}
+export type CoordinatorEvent = {
+    type: "state_enter";
+    state: CoordinatorState;
+    at: string;
+    subtask_id?: string;
+} | {
+    type: "role_invoked";
+    role: RoleId;
+    subtask_id?: string;
+    at: string;
+} | {
+    type: "subtask_result";
+    subtask_id: string;
+    status: SubTaskStatus;
+    at: string;
+} | {
+    type: "budget_warn";
+    metric: "tokens" | "wall_clock_ms" | "tool_calls";
+    used: number;
+    limit: number;
+} | {
+    type: "budget_halt";
+    metric: "tokens" | "wall_clock_ms" | "tool_calls";
+    used: number;
+    limit: number;
+    at: string;
+} | {
+    type: "escalated";
+    subtask_id: string;
+    reason: string;
+    at: string;
+};
+export interface PlanNode {
+    subtasks: SubTask[];
+    created_at: string;
+    rationale: string;
+}
+export interface PlanHandoff {
+    kind: "plan";
+    subtasks: SubTask[];
+    rationale: string;
+}
+export interface ExecutionHandoff {
+    kind: "execution";
+    subtask_id: string;
+    output: string;
+    tool_calls: ToolCallRecord[];
+    notes: string;
+}
+export interface ReviewHandoff {
+    kind: "review";
+    subtask_id: string;
+    verdict: "pass" | "fail" | "needs_retry";
+    rationale: string;
+    suggested_revision?: string;
+}
+export interface EscalationHandoff {
+    kind: "escalation";
+    severity: "info" | "warn" | "error";
+    role: RoleId;
+    reason: string;
+    context: string;
+    budget_metric?: "tokens" | "wall_clock_ms" | "tool_calls";
+}
+export interface Budgets {
+    max_tokens: number;
+    max_wall_clock_minutes: number;
+    max_tool_calls_per_subtask: number;
+    max_retries_per_subtask: number;
+}
+export declare const DEFAULT_BUDGETS: Budgets;
+export interface CostUsage {
+    tokens_used: number;
+    wall_clock_ms: number;
+    tool_calls: number;
+    tool_calls_by_subtask: Record<string, number>;
+    started_at: string;
+}
+export type RoleTranscripts = Record<RoleId, Message[]>;
+export interface SessionMetaV3 extends SessionMeta {
+    coordinator_state?: CoordinatorState;
+    plan?: PlanNode | null;
+    subtask_states?: Record<string, SubTaskState>;
+    role_transcripts?: RoleTranscripts;
+    cost?: CostUsage;
+    active_roles?: RoleId[];
+    budgets?: Budgets;
+    coordinator_events?: CoordinatorEvent[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,9 @@
+// Public type surface for OpenWar runtime.
+// Anything exported from src/index.ts ultimately roots here.
+export const DEFAULT_BUDGETS = {
+    max_tokens: 50_000,
+    max_wall_clock_minutes: 20,
+    max_tool_calls_per_subtask: 15,
+    max_retries_per_subtask: 3,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,6DAA6D;AAihB7D,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,UAAU,EAAE,MAAM;IAClB,sBAAsB,EAAE,EAAE;IAC1B,0BAA0B,EAAE,EAAE;IAC9B,uBAAuB,EAAE,CAAC;CAC3B,CAAC"}

package/examples/README.md

@@ -0,0 +1,73 @@
+# OpenWar example briefs
+
+Seven reference briefs you can run end-to-end against any configured adapter.
+
+## creative-brief.md
+
+A copywriting task with gated execution. Demonstrates frontmatter with `scope_locked: false`, `mode: gated`, and a soft `generation_credits` pre-approval.
+
+```bash
+npx @pythonluvr/openwar run examples/creative-brief.md --adapter anthropic
+```
+
+## engineering-brief.md
+
+A code task with auto-pilot execution and a locked scope. Demonstrates `scope_locked: true`, `mode: auto`, and `filesystem_write` pre-approved.
+
+```bash
+npx @pythonluvr/openwar run examples/engineering-brief.md --adapter openai --model gpt-4o
+```
+
+## file-editing-brief.md (v0.3+, requires tools)
+
+A real refactor: rename a symbol across every `.ts` file in the workdir. Demonstrates `read_file`, `list_dir`, and `apply_patch` native tools with `filesystem_write` pre-approved.
+
+```bash
+npx @pythonluvr/openwar run examples/file-editing-brief.md --adapter anthropic --workdir ./your-project
+```
+
+## research-brief.md (v0.3+, requires tools + network)
+
+Fetch three GitHub README files and save them locally. Demonstrates `http_fetch` and `write_file`. If you have `~/.openwar/http-allow.json` configured, allow `*.githubusercontent.com` first.
+
+```bash
+npx @pythonluvr/openwar run examples/research-brief.md --adapter anthropic
+```
+
+## mcp-brief.md (v0.3+, requires MCP)
+
+Survey the workdir through the official Filesystem MCP server. Demonstrates `mcp_servers` in frontmatter and the `mcp_tool:filesystem:*` wildcard.
+
+```bash
+npx @pythonluvr/openwar run examples/mcp-brief.md --adapter anthropic
+```
+
+## multi-agent-brief.md (v0.4+, multi-agent)
+
+A small static-site generator built with the three default roles (planner, executor, reviewer). The planner decomposes the brief into linear sub-tasks, the executor runs each, and the reviewer evaluates against each sub-task's acceptance criteria. Demonstrates `roles:` and `budgets:` frontmatter.
+
+```bash
+# Dry-run the plan first (no execution, no spending).
+npx @pythonluvr/openwar plan examples/multi-agent-brief.md --adapter anthropic
+
+# Full run.
+npx @pythonluvr/openwar run examples/multi-agent-brief.md --adapter anthropic
+```
+
+## critic-disagreement-brief.md (v0.4+, four-role)
+
+A tiny leap-year function with all four roles enabled (planner, executor, reviewer, critic). When the critic disagrees with the reviewer the coordinator halts on Phase 2 and asks the operator to pick a verdict.
+
+```bash
+npx @pythonluvr/openwar run examples/critic-disagreement-brief.md --adapter anthropic
+```
+
+## Inspecting after the run
+
+```bash
+openwar list                              # show recent sessions
+openwar inspect <brief_id>                # show session metadata
+openwar inspect <brief_id> --transcript   # full back-and-forth
+```
+
+Sessions persist to `~/.openwar/sessions/`. Resume with `openwar resume <brief_id>` (multi-agent or single-agent; the runtime detects which).

package/examples/creative-brief.md

@@ -0,0 +1,34 @@
+---
+project: launch-anthem
+brief_id: 2026-01-15-A1
+scope_locked: false
+mode: gated
+authorized_costs:
+  - generation_credits
+---
+
+# Objective
+
+Draft three competing 30-second voiceover scripts for a product launch anthem. Tone should land between "we built this" pride and "you are seen" warmth. The product is a self-hosted journaling app for people who write longhand. The audience is everyone who has tried five productivity tools and quit them.
+
+# Deliverables
+
+- Three voiceover scripts of 60 to 80 words each
+- For each script: a one-line tonal description and a single sentence about who it targets
+- A recommendation at the end with which to film first and why
+
+# Constraints
+
+- No em dashes in any of the output
+- No filler openers like "in a world where" or "what if"
+- Do not write more than three options; do not pad with a fourth weaker variant
+- Stay vendor-neutral; do not name competing products
+
+# Tools required
+
+- None beyond text generation
+
+# Notes / unknowns
+
+- The product name has not been finalized. Use the placeholder "the app" instead of inventing one.
+- A second pass for VO timing markers is out of scope for this brief.

package/examples/critic-disagreement-brief.md

@@ -0,0 +1,42 @@
+---
+project: critic-disagree-demo
+brief_id: 2026-02-01-C1
+scope_locked: true
+mode: auto
+authorized_costs:
+  - filesystem_read
+  - filesystem_write
+roles:
+  - planner
+  - executor
+  - reviewer
+  - critic
+budgets:
+  max_tokens: 60000
+  max_wall_clock_minutes: 20
+  max_tool_calls_per_subtask: 10
+  max_retries_per_subtask: 2
+---
+
+# Objective
+
+Write a function that returns whether a year is a leap year in the Gregorian calendar. Provide three small unit tests covering common edge cases.
+
+# Deliverables
+
+- `src/leap.ts` exporting `isLeap(year: number): boolean`.
+- `tests/leap.test.ts` covering at least: divisible-by-4-but-not-100, divisible-by-100-but-not-400, divisible-by-400.
+
+# Constraints
+
+- Single-file implementation. No date library imports.
+- No mutation. The function is pure.
+
+# Tools required
+
+- Filesystem read and write.
+
+# Notes / unknowns
+
+- This brief is intentionally small so that the four-role flow is easy to follow end-to-end. The reviewer and critic should agree most of the time. When they disagree, the coordinator halts on Phase 2 and asks you which verdict to accept.
+- Negative years (BCE) are out of scope; the function may assume `year >= 0`.

package/examples/engineering-brief.md

@@ -0,0 +1,35 @@
+---
+project: rate-limiter
+brief_id: 2026-01-15-E1
+scope_locked: true
+mode: auto
+authorized_costs:
+  - filesystem_write
+---
+
+# Objective
+
+Add a token-bucket rate limiter to an existing Node HTTP service. The limiter must be per-IP, configurable, and survive process restart without losing the in-flight bucket state.
+
+# Deliverables
+
+- A `src/middleware/rateLimit.ts` module exporting a factory function `createRateLimit(options)`
+- Unit tests at `tests/middleware/rateLimit.test.ts` covering happy path, exhaustion, refill, and restart-state recovery
+- A short README section under `docs/rate-limit.md` documenting how to wire it up and what the configuration knobs do
+
+# Constraints
+
+- Zero new runtime dependencies. Use only Node stdlib.
+- Persistence must be file-backed under `./.cache/ratelimit/`. No external store.
+- Default config: 60 requests per minute per IP, burst of 10.
+- Public API of the existing service must not change.
+
+# Tools required
+
+- Filesystem (read / write)
+- Node test runner via `node --test`
+
+# Notes / unknowns
+
+- The existing service entry is at `src/server.ts`; the middleware should plug in there but the wiring change is part of the deliverable.
+- Clock-skew handling: assume monotonic clock from `performance.now()` is acceptable.