nodedex 0.1.0

package/dist/middleware/reflect/pipeline-flags.d.ts

@@ -0,0 +1,140 @@
+import type Database from "better-sqlite3";
+import type { PipelineFlag, PipelineFlagType, PipelineFlagWriter, ScopeCheck, ReviewVerdict, FlagActionTaken } from "./types.js";
+/**
+ * Create the pipeline_flags table + indexes if they don't exist. Safe to call
+ * repeatedly (CREATE IF NOT EXISTS + indexes are idempotent).
+ *
+ * Caller responsibility: invoke once at server boot. Writers do NOT auto-
+ * create the table — they assume it exists. Keeps the call graph predictable
+ * (no silent side effects in hot paths). Matches pass2-quarantine.ts pattern.
+ *
+ * criteria_json + review/action fields are stored as nullable TEXT so the
+ * shape can evolve without per-field column adds (SQLite JSON1 can query
+ * into them if composition analysis ever needed).
+ */
+export declare function ensurePipelineFlagsTable(db: Database.Database): void;
+export interface WritePipelineFlagInput {
+    flag_type: PipelineFlagType;
+    block_id_a: string;
+    block_id_b: string | null;
+    criteria: Record<string, unknown>;
+    scope_check: ScopeCheck;
+    origin_writer: PipelineFlagWriter;
+    origin_range_id: string | null;
+}
+/**
+ * Write a new flag for async-reviewer pickup. Returns the generated id.
+ *
+ * Writes are additive — multiple flags for the same block_id_a are allowed
+ * (different flag_types, or different block_id_b candidates). Reviewer
+ * deduplicates by inspecting the unreviewed set + the actual graph state.
+ *
+ * No FK or shape validation here beyond what SQLite enforces — caller is
+ * expected to assemble a valid criteria object per the flag_type's schema
+ * (see PIPELINE-SLICE-1-DESIGN.md §3.1).
+ */
+export declare function writePipelineFlag(db: Database.Database, input: WritePipelineFlagInput): string;
+export interface MarkFlagReviewedInput {
+    flag_id: string;
+    verdict: ReviewVerdict;
+    reason: string;
+    /** What the reviewer actually completed (dup merge / provenance correct/demote).
+     *  null when the reviewer only wrote a verdict (verdict-only mode).  */
+    action_taken?: FlagActionTaken;
+    winning_block_id?: string | null;
+}
+/**
+ * Mark a flag as reviewed — idempotent via `WHERE reviewed_at IS NULL` guard.
+ * Returns true if the row was updated, false if it was already reviewed
+ * (concurrent reviewer tick won the race, or manual REST review beat the
+ * async worker). False is NOT an error — caller logs and moves on.
+ *
+ * Slice 2.2 reviewer worker (flag-reviewer.ts) writes via this helper after
+ * each LLM call. Slice 2.4 REST endpoint (POST /api/flags/:id/review) also
+ * uses it for manual operator override.
+ */
+export declare function markFlagReviewed(db: Database.Database, input: MarkFlagReviewedInput): boolean;
+/**
+ * Route a flag to the AGENT for clarification WITHOUT consuming the single review
+ * slot. Sets review_verdict='pending_clarification' + review_reason but leaves
+ * reviewed_at NULL, so:
+ *   - getPendingFlags excludes it (the autonomous reviewer won't re-process it), AND
+ *   - the agent can still resolve it via POST /api/flags/:id/review — that endpoint
+ *     guards on reviewed_at (not verdict), so the agent's later verdict IS the real
+ *     review and overwrites this routing marker.
+ *
+ * Used by the reviewer for owner-unknown flags it must NOT auto-decide: ownership
+ * needs context the autonomous reviewer lacks (the conversation + the ability to ask
+ * the user). FLAG, don't guess. Returns true if a row was updated (false if the flag
+ * was already reviewed, or already routed).
+ */
+export declare function markFlagPendingClarification(db: Database.Database, input: {
+    flag_id: string;
+    reason: string;
+}): boolean;
+export interface GetPendingFlagsOpts {
+    flag_type?: PipelineFlagType;
+    origin_writer?: PipelineFlagWriter;
+    limit?: number;
+}
+/**
+ * Get flags awaiting review (reviewed_at IS NULL). Default limit 100.
+ * Used by Slice 2 async reviewer worker. Also useful for debug REST endpoint
+ * (Slice 2 will add GET /api/flags).
+ */
+export declare function getPendingFlags(db: Database.Database, opts?: GetPendingFlagsOpts): PipelineFlag[];
+/**
+ * Flags routed to the AGENT for clarification (reviewed_at NULL + verdict=
+ * 'pending_clarification'). The context hook surfaces these as plain-English
+ * questions; the agent resolves them (POST /api/flags/:id/review) or asks the user.
+ * Oldest first (resolve the longest-waiting ambiguity first).
+ */
+export declare function getAgentPendingFlags(db: Database.Database, opts?: {
+    limit?: number;
+}): PipelineFlag[];
+/**
+ * Cheap COUNT of flags routed to the agent (same predicate as getAgentPendingFlags,
+ * no row materialization). Drives the lightweight "N items need your input" nudge
+ * that rides on every tool result — a passive MCP tool can't push, so the agent
+ * discovers pending work by bumping into this on calls it was already making.
+ */
+export declare function countAgentPendingFlags(db: Database.Database): number;
+export interface ListFlagsOpts {
+    flag_type?: PipelineFlagType;
+    origin_writer?: PipelineFlagWriter;
+    /** true → only reviewed; false → only unreviewed; undefined → all. */
+    reviewed?: boolean;
+    block_id?: string;
+    limit?: number;
+}
+/**
+ * General flag lister for the REST endpoint (Slice 2.4). Unlike getPendingFlags
+ * (unreviewed-only), this handles the reviewed=true / =false / =all (undefined)
+ * tri-state + a block_id filter (matches either block_id_a or block_id_b).
+ * Newest-first ordering (REST consumers want the recent flags up top).
+ */
+export declare function listFlags(db: Database.Database, opts?: ListFlagsOpts): PipelineFlag[];
+/** Single flag by id, or null if not found. */
+export declare function getFlagById(db: Database.Database, id: string): PipelineFlag | null;
+/**
+ * Get all flags for a given block (reviewed or not). Useful for surfacing
+ * flag history per block (Slice 2 REST endpoint, debug, audit).
+ */
+export declare function getFlagsForBlock(db: Database.Database, blockId: string): PipelineFlag[];
+/**
+ * Summary counts — useful for telemetry + debug visibility (mirrors
+ * summarizeQuarantine pattern from pass2-quarantine.ts).
+ */
+export declare function summarizePipelineFlags(db: Database.Database): {
+    total: number;
+    unreviewed: number;
+    by_type: Array<{
+        flag_type: string;
+        count: number;
+    }>;
+    by_writer: Array<{
+        origin_writer: string;
+        count: number;
+    }>;
+};
+//# sourceMappingURL=pipeline-flags.d.ts.map

package/dist/middleware/reflect/pipeline-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-flags.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/pipeline-flags.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAmCpE;AAID,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,WAAW,EAAE,UAAU,CAAC;IACxB,aAAa,EAAE,kBAAkB,CAAC;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,sBAAsB,GAC5B,MAAM,CA6BR;AAID,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf;4EACwE;IACxE,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAwBT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC,OAAO,CAWT;AA4CD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,GAAE,mBAAwB,GAC7B,YAAY,EAAE,CAqBhB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5B,YAAY,EAAE,CAQhB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAMpE;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,GAAE,aAAkB,GACvB,YAAY,EAAE,CAgBhB;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAGlF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,GACd,YAAY,EAAE,CAOhB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,SAAS,EAAE,KAAK,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D,CAMA"}

package/dist/middleware/reflect/pipeline-flags.js

@@ -0,0 +1,314 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// DEBT 5 Slice 1 — PIPELINE FLAGS (Stage FLAG infrastructure)
+// ═══════════════════════════════════════════════════════════════════════════════
+//
+// Replaces auto-drop semantics in dedupBySourceAndValue + provides the durable
+// flag persistence layer for Stage AUDIT (Slice 2) + entity resolution
+// uncertainty (Stage C, Sub-step 1.2).
+//
+// Per user direction: system FLAGS, reasoning MERGES. This module is the
+// system FLAGS half — code-only, no LLM, just durable persistence of
+// "these two blocks look like duplicates — needs reasoning to decide."
+//
+// The async LLM reviewer (Slice 2) is the reasoning MERGES half — it
+// consumes rows written here, calls LLM with full context, writes verdict +
+// optional merge action back.
+//
+// Pattern reference: pass2-quarantine.ts (table + writer + reader module).
+// Per docs/PIPELINE-SLICE-1-DESIGN.md §3.
+//
+// Sub-step 1.1 (this file): table schema + function signatures + stub impls.
+//   - ensurePipelineFlagsTable: real impl (idempotent CREATE)
+//   - writePipelineFlag: real impl (INSERT)
+//   - getPendingFlags: real impl (SELECT)
+//   No callers yet — Sub-step 1.4 wires Stage FLAG to call writePipelineFlag.
+//
+// What this module does NOT do:
+//   - The async LLM reviewer (that's Slice 2 — its own module)
+//   - Stage AUDIT background process (that's Slice 2)
+//   - Auto-merge actions (reviewer's job, not flag-writer's)
+import { v4 as uuidv4 } from "uuid";
+// ─── Schema migration ──────────────────────────────────────────────────────────
+/**
+ * Create the pipeline_flags table + indexes if they don't exist. Safe to call
+ * repeatedly (CREATE IF NOT EXISTS + indexes are idempotent).
+ *
+ * Caller responsibility: invoke once at server boot. Writers do NOT auto-
+ * create the table — they assume it exists. Keeps the call graph predictable
+ * (no silent side effects in hot paths). Matches pass2-quarantine.ts pattern.
+ *
+ * criteria_json + review/action fields are stored as nullable TEXT so the
+ * shape can evolve without per-field column adds (SQLite JSON1 can query
+ * into them if composition analysis ever needed).
+ */
+export function ensurePipelineFlagsTable(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS pipeline_flags (
+      id              TEXT PRIMARY KEY,
+      flag_type       TEXT NOT NULL,
+      block_id_a      TEXT NOT NULL,
+      block_id_b      TEXT,
+      criteria_json   TEXT NOT NULL,
+      scope_check     TEXT NOT NULL,
+      origin_writer   TEXT NOT NULL,
+      origin_range_id TEXT,
+      created_at      TEXT NOT NULL,
+
+      reviewed_at     TEXT,
+      review_verdict  TEXT,
+      review_reason   TEXT,
+
+      action_taken    TEXT,
+      action_at       TEXT,
+      winning_block_id TEXT,
+
+      FOREIGN KEY (block_id_a) REFERENCES blocks(id),
+      FOREIGN KEY (block_id_b) REFERENCES blocks(id),
+      FOREIGN KEY (origin_range_id) REFERENCES conversation_turn_ranges(id),
+      FOREIGN KEY (winning_block_id) REFERENCES blocks(id)
+    )
+  `);
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_pipeline_flags_unreviewed
+    ON pipeline_flags(reviewed_at) WHERE reviewed_at IS NULL`);
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_pipeline_flags_type
+    ON pipeline_flags(flag_type)`);
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_pipeline_flags_block_a
+    ON pipeline_flags(block_id_a)`);
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_pipeline_flags_origin_writer
+    ON pipeline_flags(origin_writer)`);
+}
+/**
+ * Write a new flag for async-reviewer pickup. Returns the generated id.
+ *
+ * Writes are additive — multiple flags for the same block_id_a are allowed
+ * (different flag_types, or different block_id_b candidates). Reviewer
+ * deduplicates by inspecting the unreviewed set + the actual graph state.
+ *
+ * No FK or shape validation here beyond what SQLite enforces — caller is
+ * expected to assemble a valid criteria object per the flag_type's schema
+ * (see PIPELINE-SLICE-1-DESIGN.md §3.1).
+ */
+export function writePipelineFlag(db, input) {
+    const id = `pfl_${uuidv4().slice(0, 12)}`;
+    const stmt = db.prepare(`
+    INSERT INTO pipeline_flags (
+      id, flag_type, block_id_a, block_id_b, criteria_json,
+      scope_check, origin_writer, origin_range_id, created_at,
+      reviewed_at, review_verdict, review_reason,
+      action_taken, action_at, winning_block_id
+    ) VALUES (
+      @id, @flag_type, @block_id_a, @block_id_b, @criteria_json,
+      @scope_check, @origin_writer, @origin_range_id, @created_at,
+      NULL, NULL, NULL,
+      NULL, NULL, NULL
+    )
+  `);
+    stmt.run({
+        id,
+        flag_type: input.flag_type,
+        block_id_a: input.block_id_a,
+        block_id_b: input.block_id_b,
+        criteria_json: JSON.stringify(input.criteria ?? {}),
+        scope_check: input.scope_check,
+        origin_writer: input.origin_writer,
+        origin_range_id: input.origin_range_id,
+        created_at: new Date().toISOString(),
+    });
+    return id;
+}
+/**
+ * Mark a flag as reviewed — idempotent via `WHERE reviewed_at IS NULL` guard.
+ * Returns true if the row was updated, false if it was already reviewed
+ * (concurrent reviewer tick won the race, or manual REST review beat the
+ * async worker). False is NOT an error — caller logs and moves on.
+ *
+ * Slice 2.2 reviewer worker (flag-reviewer.ts) writes via this helper after
+ * each LLM call. Slice 2.4 REST endpoint (POST /api/flags/:id/review) also
+ * uses it for manual operator override.
+ */
+export function markFlagReviewed(db, input) {
+    const stmt = db.prepare(`
+    UPDATE pipeline_flags
+       SET reviewed_at      = @reviewed_at,
+           review_verdict   = @verdict,
+           review_reason    = @reason,
+           action_taken     = @action_taken,
+           action_at        = @action_at,
+           winning_block_id = @winning_block_id
+     WHERE id = @flag_id
+       AND reviewed_at IS NULL
+  `);
+    const action_taken = input.action_taken ?? null;
+    const r = stmt.run({
+        flag_id: input.flag_id,
+        reviewed_at: new Date().toISOString(),
+        verdict: input.verdict,
+        reason: input.reason,
+        action_taken,
+        // action_at populated only when an action actually fired
+        action_at: action_taken && action_taken !== 'none' ? new Date().toISOString() : null,
+        winning_block_id: input.winning_block_id ?? null,
+    });
+    return r.changes === 1;
+}
+/**
+ * Route a flag to the AGENT for clarification WITHOUT consuming the single review
+ * slot. Sets review_verdict='pending_clarification' + review_reason but leaves
+ * reviewed_at NULL, so:
+ *   - getPendingFlags excludes it (the autonomous reviewer won't re-process it), AND
+ *   - the agent can still resolve it via POST /api/flags/:id/review — that endpoint
+ *     guards on reviewed_at (not verdict), so the agent's later verdict IS the real
+ *     review and overwrites this routing marker.
+ *
+ * Used by the reviewer for owner-unknown flags it must NOT auto-decide: ownership
+ * needs context the autonomous reviewer lacks (the conversation + the ability to ask
+ * the user). FLAG, don't guess. Returns true if a row was updated (false if the flag
+ * was already reviewed, or already routed).
+ */
+export function markFlagPendingClarification(db, input) {
+    const stmt = db.prepare(`
+    UPDATE pipeline_flags
+       SET review_verdict = 'pending_clarification',
+           review_reason  = @reason
+     WHERE id = @flag_id
+       AND reviewed_at IS NULL
+       AND (review_verdict IS NULL OR review_verdict != 'pending_clarification')
+  `);
+    const r = stmt.run({ flag_id: input.flag_id, reason: input.reason });
+    return r.changes === 1;
+}
+function rowToFlag(row) {
+    let criteria = {};
+    try {
+        criteria = JSON.parse(row.criteria_json);
+    }
+    catch { /* tolerate bad JSON — empty criteria */ }
+    return {
+        id: row.id,
+        flag_type: row.flag_type,
+        block_id_a: row.block_id_a,
+        block_id_b: row.block_id_b,
+        criteria,
+        scope_check: row.scope_check,
+        origin_writer: row.origin_writer,
+        origin_range_id: row.origin_range_id,
+        created_at: row.created_at,
+        reviewed_at: row.reviewed_at,
+        review_verdict: row.review_verdict ?? null,
+        review_reason: row.review_reason,
+        action_taken: row.action_taken ?? null,
+        action_at: row.action_at,
+        winning_block_id: row.winning_block_id,
+    };
+}
+/**
+ * Get flags awaiting review (reviewed_at IS NULL). Default limit 100.
+ * Used by Slice 2 async reviewer worker. Also useful for debug REST endpoint
+ * (Slice 2 will add GET /api/flags).
+ */
+export function getPendingFlags(db, opts = {}) {
+    // Exclude flags routed to the agent (verdict='pending_clarification', reviewed_at
+    // still NULL) — those await the agent/user, not the autonomous reviewer. Without
+    // this the reviewer would re-route them every tick.
+    const where = [
+        "reviewed_at IS NULL",
+        "(review_verdict IS NULL OR review_verdict != 'pending_clarification')",
+    ];
+    const params = {};
+    if (opts.flag_type) {
+        where.push("flag_type = @flag_type");
+        params.flag_type = opts.flag_type;
+    }
+    if (opts.origin_writer) {
+        where.push("origin_writer = @origin_writer");
+        params.origin_writer = opts.origin_writer;
+    }
+    const limit = opts.limit ?? 100;
+    const sql = `SELECT * FROM pipeline_flags WHERE ${where.join(" AND ")} ORDER BY created_at ASC LIMIT ${limit}`;
+    const rows = db.prepare(sql).all(params);
+    return rows.map(rowToFlag);
+}
+/**
+ * Flags routed to the AGENT for clarification (reviewed_at NULL + verdict=
+ * 'pending_clarification'). The context hook surfaces these as plain-English
+ * questions; the agent resolves them (POST /api/flags/:id/review) or asks the user.
+ * Oldest first (resolve the longest-waiting ambiguity first).
+ */
+export function getAgentPendingFlags(db, opts = {}) {
+    const limit = opts.limit ?? 20;
+    const rows = db.prepare(`SELECT * FROM pipeline_flags
+      WHERE reviewed_at IS NULL AND review_verdict = 'pending_clarification'
+      ORDER BY created_at ASC LIMIT ${limit}`).all();
+    return rows.map(rowToFlag);
+}
+/**
+ * Cheap COUNT of flags routed to the agent (same predicate as getAgentPendingFlags,
+ * no row materialization). Drives the lightweight "N items need your input" nudge
+ * that rides on every tool result — a passive MCP tool can't push, so the agent
+ * discovers pending work by bumping into this on calls it was already making.
+ */
+export function countAgentPendingFlags(db) {
+    const row = db.prepare(`SELECT COUNT(*) AS n FROM pipeline_flags
+      WHERE reviewed_at IS NULL AND review_verdict = 'pending_clarification'`).get();
+    return row?.n ?? 0;
+}
+/**
+ * General flag lister for the REST endpoint (Slice 2.4). Unlike getPendingFlags
+ * (unreviewed-only), this handles the reviewed=true / =false / =all (undefined)
+ * tri-state + a block_id filter (matches either block_id_a or block_id_b).
+ * Newest-first ordering (REST consumers want the recent flags up top).
+ */
+export function listFlags(db, opts = {}) {
+    const where = [];
+    const params = {};
+    if (opts.flag_type) {
+        where.push("flag_type = @flag_type");
+        params.flag_type = opts.flag_type;
+    }
+    if (opts.origin_writer) {
+        where.push("origin_writer = @origin_writer");
+        params.origin_writer = opts.origin_writer;
+    }
+    if (opts.reviewed === true)
+        where.push("reviewed_at IS NOT NULL");
+    if (opts.reviewed === false)
+        where.push("reviewed_at IS NULL");
+    if (opts.block_id) {
+        where.push("(block_id_a = @block_id OR block_id_b = @block_id)");
+        params.block_id = opts.block_id;
+    }
+    const limit = opts.limit ?? 100;
+    const whereClause = where.length ? `WHERE ${where.join(" AND ")}` : "";
+    const sql = `SELECT * FROM pipeline_flags ${whereClause} ORDER BY created_at DESC LIMIT ${limit}`;
+    const rows = db.prepare(sql).all(params);
+    return rows.map(rowToFlag);
+}
+/** Single flag by id, or null if not found. */
+export function getFlagById(db, id) {
+    const row = db.prepare(`SELECT * FROM pipeline_flags WHERE id = ?`).get(id);
+    return row ? rowToFlag(row) : null;
+}
+/**
+ * Get all flags for a given block (reviewed or not). Useful for surfacing
+ * flag history per block (Slice 2 REST endpoint, debug, audit).
+ */
+export function getFlagsForBlock(db, blockId) {
+    const rows = db.prepare(`
+    SELECT * FROM pipeline_flags
+    WHERE block_id_a = @blockId OR block_id_b = @blockId
+    ORDER BY created_at DESC
+  `).all({ blockId });
+    return rows.map(rowToFlag);
+}
+/**
+ * Summary counts — useful for telemetry + debug visibility (mirrors
+ * summarizeQuarantine pattern from pass2-quarantine.ts).
+ */
+export function summarizePipelineFlags(db) {
+    const total = db.prepare(`SELECT COUNT(*) as n FROM pipeline_flags`).get().n;
+    const unreviewed = db.prepare(`SELECT COUNT(*) as n FROM pipeline_flags WHERE reviewed_at IS NULL`).get().n;
+    const by_type = db.prepare(`SELECT flag_type, COUNT(*) as count FROM pipeline_flags GROUP BY flag_type ORDER BY count DESC`).all();
+    const by_writer = db.prepare(`SELECT origin_writer, COUNT(*) as count FROM pipeline_flags GROUP BY origin_writer ORDER BY count DESC`).all();
+    return { total, unreviewed, by_type, by_writer };
+}
+//# sourceMappingURL=pipeline-flags.js.map

package/dist/middleware/reflect/pipeline-flags.js.map

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