pilotswarm-sdk 0.2.2 → 0.3.0

package/dist/agent-loader.d.ts

@@ -51,13 +51,15 @@ export interface AgentConfig {
     /** Internal: identifies which prompt layering path this agent should use. */
     promptLayerKind?: "app-agent" | "app-system-agent" | "pilotswarm-system-agent";
     /**
-     * App-assigned HARVESTER role (enhancedfactstore 07 §1.5). When `true`, a
-    * session bound to this agent receives the privileged crawl queue when a
-    * graph store is configured. Graph extraction/fill is app-specific, so the
-    * app sets `harvester: true` in its own harvester agent's frontmatter. The
-     * role is derived from this definition on the worker every turn — never
-     * inherited from a parent session.
+     * App-assigned CRAWLER role. When `true`, a session bound to this agent
+     * receives the privileged crawl queue when a graph store is configured.
+     * Graph extraction/fill is app-specific, so the app sets `crawler: true` in
+     * its own crawler agent's frontmatter. The role is derived from this
+     * definition on the worker every turn — never inherited from a parent
+     * session.
      */
+    crawler?: boolean;
+    /** @deprecated Use `crawler: true`; accepted as a compatibility alias. */
     harvester?: boolean;
     /**
      * Frontmatter schema version. Defaults to 1 when the file omits it. Higher integers

package/dist/agent-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-loader.d.ts","sourceRoot":"","sources":["../src/agent-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYpD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAclF;AAID,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qGAAqG;IACrG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qHAAqH;IACrH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,WAAW,GAAG,kBAAkB,GAAG,yBAAyB,CAAC;IAC/E;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAqHD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CA8D/D"}
+{"version":3,"file":"agent-loader.d.ts","sourceRoot":"","sources":["../src/agent-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYpD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAclF;AAID,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qGAAqG;IACrG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qHAAqH;IACrH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,WAAW,GAAG,kBAAkB,GAAG,yBAAyB,CAAC;IAC/E;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAsHD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAgE/D"}

package/dist/agent-loader.js

@@ -131,6 +131,8 @@ function parseAgentFrontmatter(content) {
             meta.description = value;
         else if (key === "system")
             meta.system = value === "true";
+        else if (key === "crawler")
+            meta.crawler = value === "true";
         else if (key === "harvester")
             meta.harvester = value === "true";
         else if (key === "id")
@@ -203,6 +205,7 @@ export function loadAgentFiles(agentsDir) {
                 console.warn(`[agent-loader] Skipping ${entry.name}: unsupported schemaVersion ${meta.schemaVersion}; expected schemaVersion: 1`);
                 continue;
             }
+            const crawler = meta.crawler === true || meta.harvester === true;
             agents.push({
                 name: meta.name,
                 description: meta.description,
@@ -214,7 +217,8 @@ export function loadAgentFiles(agentsDir) {
                 parent: meta.parent,
                 splash: meta.splash,
                 initialPrompt: meta.initialPrompt,
-                harvester: meta.harvester,
+                crawler,
+                harvester: crawler,
                 schemaVersion: meta.schemaVersion,
                 version: meta.version,
                 sourcePath: filePath,

package/dist/agent-loader.js.map

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

package/dist/facts-migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facts-migrations.d.ts","sourceRoot":"","sources":["../src/facts-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAqDjE"}
+{"version":3,"file":"facts-migrations.d.ts","sourceRoot":"","sources":["../src/facts-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CA0DjE"}

package/dist/facts-migrations.js

@@ -61,6 +61,11 @@ export function FACTS_MIGRATIONS(schema) {
             name: "soft_delete_etag",
             sql: migration_0010_soft_delete_etag(schema),
         },
+        {
+            version: "0011",
+            name: "prefix_crawl_flag",
+            sql: migration_0011_prefix_crawl_flag(schema),
+        },
     ];
 }
 // ─── Migration 0001: Baseline ────────────────────────────────────
@@ -1360,4 +1365,175 @@ END;
 $$ LANGUAGE plpgsql;
 `;
 }
+// ─── Migration 0011: Prefix-scoped crawl flag (multi-crawler Phase 1) ─────────
+function migration_0011_prefix_crawl_flag(schema) {
+    const s = `"${schema}"`;
+    const t = `${s}.facts`;
+    return `
+-- 0011_prefix_crawl_flag: generalize the single-crawler queue into N crawlers
+-- over DISJOINT key prefixes. No registry / lock / per-crawler state (Phase 2).
+-- Because each fact lives under exactly one crawler's prefix, no two crawlers
+-- touch the same row, so the single last_crawled_at column never contends.
+--
+--   - facts_like_prefix(text)     : escape % _ \\ in a literal prefix so LIKE
+--                                   matches it literally while still letting the
+--                                   planner use a text_pattern_ops index range.
+--   - facts_read_uncrawled        : param p_ns_prefix -> p_key_prefix, escaped
+--                                   literal-prefix LIKE, ORDER BY key,id.
+--   - facts_set_crawled_by_prefix : flip last_crawled_at for a whole literal prefix.
+--   - facts_set_crawled_by_keys   : flip last_crawled_at for an explicit batch of
+--                                   {scopeKey, etag?} receipts (1..500).
+--   - facts_mark_crawled          : DROPPED — replaced by facts_set_crawled_by_keys.
+--   - idx_${schema}_facts_uncrawled_key : (key text_pattern_ops, id) WHERE last_crawled_at IS NULL.
+--                                   Supersedes the id-only idx_${schema}_facts_uncrawled.
+--
+-- Crawl writes only touch last_crawled_at; facts_touch never bumps etag for a
+-- last_crawled_at-only write, so a {scopeKey, etag} receipt survives a recrawl.
+
+-- Escape a literal key prefix into a LIKE pattern (escape \\ % _, append %).
+-- Pair with \`ESCAPE chr(92)\` at the call site. chr(92) is a literal backslash;
+-- using it avoids backslash-quoting ambiguity across SQL string forms.
+CREATE OR REPLACE FUNCTION ${s}.facts_like_prefix(p_prefix TEXT)
+RETURNS TEXT LANGUAGE sql IMMUTABLE STRICT AS $$
+    SELECT replace(replace(replace(p_prefix, chr(92), chr(92) || chr(92)),
+                           '%', chr(92) || '%'), '_', chr(92) || '_') || '%';
+$$;
+
+-- Queue-prefix index: pending rows keyed by key for prefix range scans. The
+-- text_pattern_ops opclass is required because the database collation is not C.
+-- This supersedes the id-only uncrawled index (ORDER BY key,id uses this one).
+DROP INDEX IF EXISTS ${s}.idx_${schema}_facts_uncrawled;
+CREATE INDEX IF NOT EXISTS idx_${schema}_facts_uncrawled_key
+    ON ${t} (key text_pattern_ops, id) WHERE last_crawled_at IS NULL;
+
+-- Read: pending facts (last_crawled_at IS NULL) across ALL scopes, narrowed by a
+-- literal key prefix, oldest-first within the prefix. The param is renamed
+-- (p_ns_prefix -> p_key_prefix), which requires DROP before re-create.
+DROP FUNCTION IF EXISTS ${s}.facts_read_uncrawled(TEXT, INT);
+CREATE OR REPLACE FUNCTION ${s}.facts_read_uncrawled(
+    p_key_prefix TEXT,
+    p_limit      INT
+) RETURNS TABLE (
+    scope_key    TEXT,
+    key          TEXT,
+    value        JSONB,
+    agent_id     TEXT,
+    session_id   TEXT,
+    shared       BOOLEAN,
+    tags         TEXT[],
+    created_at   TIMESTAMPTZ,
+    updated_at   TIMESTAMPTZ,
+    deleted_at   TIMESTAMPTZ,
+    etag         BIGINT
+) LANGUAGE sql STABLE AS $$
+    SELECT f.scope_key, f.key, f.value, f.agent_id, f.session_id, f.shared,
+           f.tags, f.created_at, f.updated_at, f.deleted_at, f.etag
+    FROM ${t} f
+    WHERE f.last_crawled_at IS NULL
+      AND (p_key_prefix IS NULL
+           OR f.key LIKE ${s}.facts_like_prefix(p_key_prefix) ESCAPE chr(92))
+    ORDER BY f.key, f.id
+    LIMIT p_limit;
+$$;
+
+-- Prefix writer: flip last_crawled_at for a whole literal prefix.
+--   crawled=true  : queued (NULL) -> now(); NEVER a tombstone (a blind flush
+--                   must not turn unreconciled deletes into purgeable rows).
+--   crawled=false : crawled -> NULL (recrawl); tombstones included.
+-- affected = rows that changed state. skipped = rows that matched the prefix
+-- selector but were already in the requested state. An empty prefix is a no-op.
+CREATE OR REPLACE FUNCTION ${s}.facts_set_crawled_by_prefix(
+    p_key_prefix TEXT,
+    p_crawled    BOOLEAN
+) RETURNS TABLE (affected INT, skipped INT)
+LANGUAGE sql AS $$
+    WITH matched AS (
+        SELECT f.id
+        FROM ${t} f
+        WHERE p_key_prefix IS NOT NULL
+          AND p_key_prefix <> ''
+          AND f.key LIKE ${s}.facts_like_prefix(p_key_prefix) ESCAPE chr(92)
+          AND (NOT p_crawled OR f.deleted_at IS NULL)
+    ), upd AS (
+        UPDATE ${t} f
+           SET last_crawled_at = CASE WHEN p_crawled THEN now() ELSE NULL END
+          FROM matched m
+         WHERE f.id = m.id
+           AND ( (p_crawled     AND f.last_crawled_at IS NULL)
+              OR (NOT p_crawled AND f.last_crawled_at IS NOT NULL) )
+        RETURNING f.id
+    )
+    SELECT (SELECT count(*) FROM upd)::int AS affected,
+           ((SELECT count(*) FROM matched) - (SELECT count(*) FROM upd))::int AS skipped;
+$$;
+
+-- Explicit-batch writer: 1..500 {scopeKey, etag?} receipts.
+--   with etag    : conditional — facts.etag must match, else skipped.
+--   without etag : unconditional stomp of that key's crawl flag.
+-- affected = rows that changed state. skipped = an existing fact matched the
+-- scopeKey but did not change (etag mismatch, or already in the requested
+-- state). A non-existent scopeKey is neither affected nor skipped.
+CREATE OR REPLACE FUNCTION ${s}.facts_set_crawled_by_keys(
+    p_keys    JSONB,
+    p_crawled BOOLEAN
+) RETURNS TABLE (affected INT, skipped INT)
+LANGUAGE plpgsql AS $$
+DECLARE
+    v_count INT;
+    v_bad   BOOLEAN;
+    v_dup   BOOLEAN;
+BEGIN
+    IF jsonb_typeof(p_keys) IS DISTINCT FROM 'array' THEN
+        RAISE EXCEPTION 'facts_set_crawled_by_keys requires a JSON array';
+    END IF;
+    v_count := jsonb_array_length(p_keys);
+    IF v_count = 0 OR v_count > 500 THEN
+        RAISE EXCEPTION 'facts_set_crawled_by_keys requires 1..500 entries';
+    END IF;
+
+    SELECT
+        bool_or(scope_key IS NULL OR scope_key = '' OR (has_etag AND (etag IS NULL OR etag <= 0))),
+        count(*) <> count(DISTINCT scope_key)
+      INTO v_bad, v_dup
+    FROM (
+        SELECT e->>'scopeKey' AS scope_key,
+               (e ? 'etag') AS has_etag,
+               CASE WHEN (e ? 'etag') AND (e->>'etag') ~ '^[0-9]+$'
+                    THEN (e->>'etag')::BIGINT ELSE NULL END AS etag
+        FROM jsonb_array_elements(p_keys) e
+    ) q;
+    IF v_bad OR v_dup THEN
+        RAISE EXCEPTION 'facts_set_crawled_by_keys entries require unique scopeKey values and optional numeric etags';
+    END IF;
+
+    RETURN QUERY
+    WITH input AS (
+        SELECT e->>'scopeKey' AS scope_key,
+               (e ? 'etag') AS has_etag,
+               CASE WHEN (e ? 'etag') AND (e->>'etag') ~ '^[0-9]+$'
+                    THEN (e->>'etag')::BIGINT ELSE NULL END AS etag
+        FROM jsonb_array_elements(p_keys) e
+    ), matched AS (
+        SELECT f.id, i.has_etag, i.etag AS input_etag
+        FROM ${t} f
+        JOIN input i ON i.scope_key = f.scope_key
+    ), upd AS (
+        UPDATE ${t} f
+           SET last_crawled_at = CASE WHEN p_crawled THEN now() ELSE NULL END
+          FROM matched m
+         WHERE f.id = m.id
+           AND (NOT m.has_etag OR f.etag = m.input_etag)
+           AND ( (p_crawled     AND f.last_crawled_at IS NULL)
+              OR (NOT p_crawled AND f.last_crawled_at IS NOT NULL) )
+        RETURNING f.id
+    )
+    SELECT (SELECT count(*) FROM upd)::int AS affected,
+           ((SELECT count(*) FROM matched) - (SELECT count(*) FROM upd))::int AS skipped;
+END;
+$$;
+
+-- The legacy single-shape receipt mark is replaced by facts_set_crawled_by_keys.
+DROP FUNCTION IF EXISTS ${s}.facts_mark_crawled(JSONB);
+`;
+}
 //# sourceMappingURL=facts-migrations.js.map

package/dist/facts-migrations.js.map

@@ -1 +1 @@
-{"version":3,"file":"facts-migrations.js","sourceRoot":"","sources":["../src/facts-migrations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"facts-migrations.js","sourceRoot":"","sources":["../src/facts-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC3C,OAAO;QACH;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,UAAU;YAChB,GAAG,EAAE,uBAAuB,CAAC,MAAM,CAAC;SACvC;QACD;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,mBAAmB;YACzB,GAAG,EAAE,gCAAgC,CAAC,MAAM,CAAC;SAChD;QACD;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,mBAAmB;YACzB,GAAG,EAAE,gCAAgC,CAAC,MAAM,CAAC;SAChD;QACD;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,yBAAyB;YAC/B,GAAG,EAAE,sCAAsC,CAAC,MAAM,CAAC;SACtD;QACD;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,uBAAuB;YAC7B,GAAG,EAAE,oCAAoC,CAAC,MAAM,CAAC;SACpD;QACD;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,0BAA0B,CAAC,MAAM,CAAC;SAC1C;QACD;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,qBAAqB;YAC3B,GAAG,EAAE,kCAAkC,CAAC,MAAM,CAAC;SAClD;QACD;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,4BAA4B;YAClC,GAAG,EAAE,yCAAyC,CAAC,MAAM,CAAC;SACzD;QACD;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,0BAA0B;YAChC,GAAG,EAAE,uCAAuC,CAAC,MAAM,CAAC;SACvD;QACD;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,kBAAkB;YACxB,GAAG,EAAE,+BAA+B,CAAC,MAAM,CAAC;SAC/C;QACD;YACI,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,mBAAmB;YACzB,GAAG,EAAE,gCAAgC,CAAC,MAAM,CAAC;SAChD;KACJ,CAAC;AACN,CAAC;AAED,oEAAoE;AAEpE,SAAS,uBAAuB,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAG,GAAG,MAAM,QAAQ,CAAC;IAChC,OAAO;;;;6BAIkB,KAAK;;;;;;;;;;;;;;;iCAeD,MAAM,iBAAiB,KAAK;iCAC5B,MAAM,kBAAkB,KAAK;iCAC7B,MAAM,qBAAqB,KAAK;iCAChC,MAAM,mBAAmB,KAAK;iCAC9B,MAAM,oBAAoB,KAAK;iCAC/B,MAAM,uBAAuB,KAAK;;;cAGrD,KAAK;cACL,KAAK;cACL,KAAK;cACL,KAAK;cACL,KAAK;cACL,KAAK;;;SAGV,KAAK;;;;;;CAMb,CAAC;AACF,CAAC;AAED,oEAAoE;AAEpE,SAAS,gCAAgC,CAAC,MAAc;IACpD,MAAM,KAAK,GAAG,GAAG,MAAM,QAAQ,CAAC;IAChC,OAAO;;;;6BAIkB,MAAM;;;;;;;;;;;kBAWjB,KAAK;;;;;;;;;;;;;;;;6BAgBM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;sHAwBmF,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAuD9F,MAAM;;;;;;kBAMjB,KAAK;;;;;;;6BAOM,MAAM;;;;;;kBAMjB,KAAK;;;;;;;CAOtB,CAAC;AACF,CAAC;AAED,oEAAoE;AAEpE,SAAS,gCAAgC,CAAC,MAAc;IACpD,MAAM,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;IACxB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACvB,OAAO;;;;;;;;;;;6BAWkB,CAAC;;;;;;;;;;;;;;;;;;0BAkBJ,CAAC;6BACE,CAAC;;;;;;;;;;;;UAYpB,CAAC;;;;;WAKA,CAAC;;;;;;;;;;;;0BAYc,CAAC;6BACE,CAAC;;;;;;;;;;;;UAYpB,CAAC;;;;;WAKA,CAAC;;;;;;;;;;0BAUc,CAAC;6BACE,CAAC;;;;;;;;;;;UAWpB,CAAC;;;;;WAKA,CAAC;;;;;;CAMX,CAAC;AACF,CAAC;AAED,mEAAmE;AAEnE,SAAS,sCAAsC,CAAC,MAAc;IAC1D,MAAM,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;IACxB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACvB,OAAO;;;;;;;;;;;;;0BAae,CAAC;;6BAEE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;sHAyBwF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDtH,CAAC;AACF,CAAC;AAED,gFAAgF;AAEhF,SAAS,oCAAoC,CAAC,MAAc;IACxD,MAAM,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;IACxB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACvB,OAAO;;;;;;;;;;;0BAWe,CAAC;;6BAEE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;mIA2BqG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DnI,CAAC;AACF,CAAC;AAED,gFAAgF;AAEhF,SAAS,0BAA0B,CAAC,MAAc;IAC9C,MAAM,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;IACxB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACvB,OAAO;;;;;;;;;;;;;cAaG,CAAC;cACD,CAAC;;;;SAIN,CAAC;;;;;iCAKuB,MAAM;SAC9B,CAAC;;;;;;6BAMmB,CAAC;;;;;;;;;;;;;;;;wCAgBU,CAAC;;iCAER,CAAC;oCACE,CAAC;;;;;6BAKR,CAAC;;;;;;;;;;;;;;;;;WAiBnB,CAAC;;;;;;;;;;6BAUiB,CAAC;;;;;;;;iBAQb,CAAC;;;;;;;;;;CAUjB,CAAC;AACF,CAAC;AAED,SAAS,kCAAkC,CAAC,MAAc;IACtD,MAAM,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;IACxB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACvB,OAAO;;;;;6BAKkB,CAAC;;;;;;;;;cAShB,CAAC;;0BAEW,CAAC;;6BAEE,CAAC;;;;;;;;;;;;;;;;WAgBnB,CAAC;;;;;;;6BAOiB,CAAC;;;;;;;;iBAQb,CAAC;;;;;;;;;;CAUjB,CAAC;AACF,CAAC;AAED,SAAS,yCAAyC,CAAC,MAAc;IAC7D,MAAM,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;IACxB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACvB,OAAO;;;;;6BAKkB,CAAC;;;;;;;;;;;;;;;sBAeR,CAAC;;;;;;;;;;;;;;;;;6BAiBM,CAAC;;;;;;;;;;;cAWhB,CAAC;;;;;;;;;;;;;6BAac,CAAC;;;;;;;;;;;;;;;;;;;;;;kBAsBZ,CAAC;;;;;;;;;;;CAWlB,CAAC;AACF,CAAC;AAED,SAAS,uCAAuC,CAAC,MAAc;IAC3D,MAAM,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;IACxB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACvB,OAAO;;;;;0BAKe,CAAC;0BACD,CAAC;6BACE,CAAC;;;;;;;;;;;;;;;sBAeR,CAAC;;;;;;;;;;;;;;;;;0BAiBG,CAAC;0BACD,CAAC;6BACE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;sBA0BR,CAAC;;;;;;;;sBAQD,CAAC;;;;;;;0BAOG,CAAC;0BACD,CAAC;CAC1B,CAAC;AACF,CAAC;AAED,SAAS,+BAA+B,CAAC,MAAc;IACnD,MAAM,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;IACxB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACvB,OAAO;;;;;;cAMG,CAAC;cACD,CAAC;;iCAEkB,MAAM;SAC9B,CAAC;;;;;6BAKmB,CAAC;;;;;;;;;;;;;;;0BAeJ,CAAC;6BACE,CAAC;;;;;;;;;;;;;;;sBAeR,CAAC;;;;;;;;;;;;;;;;;;;0BAmBG,CAAC;6BACE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0Bb,CAAC;;;;;;;;;;iBAUD,CAAC;;;;;;;;;;6BAUW,CAAC;;;;;;aAMjB,CAAC;;;;;;;;;;0BAUY,CAAC;6BACE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yJA6B2H,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAyD7H,CAAC;;;;;;;;;;;;UAYpB,CAAC;;;;;WAKA,CAAC;;;;;;;;;6BASiB,CAAC;;;;;;;;;;;;UAYpB,CAAC;;;;;WAKA,CAAC;;;;;;;;;6BASiB,CAAC;;;;;;;;;;;UAWpB,CAAC;;;;;WAKA,CAAC;;;;;;;;0BAQc,CAAC;6BACE,CAAC;;;;;;;;;;;;;;;;;;WAkBnB,CAAC;;;;;;;6BAOiB,CAAC;;;;;;;;iBAQb,CAAC;;;;;;;;;;;;6BAYW,CAAC;;;;;;;;;eASf,CAAC;;;;;;;;;;;;;sBAaM,CAAC;;;;;;;;;;6BAUM,CAAC;;;;;;;;;;;;;;;;;;;;;WAqBnB,CAAC;;;6BAGiB,CAAC;;;;;;;;;;;eAWf,CAAC;;;;;;;;;sBASM,CAAC;;;;;;;;;CAStB,CAAC;AACF,CAAC;AAED,iFAAiF;AAEjF,SAAS,gCAAgC,CAAC,MAAc;IACpD,MAAM,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;IACxB,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACvB,OAAO;;;;;;;;;;;;;;;aAeE,MAAM;kEAC+C,MAAM;;;;;;;;6BAQ3C,CAAC;;;;;;;;;uBASP,CAAC,QAAQ,MAAM;iCACL,MAAM;SAC9B,CAAC;;;;;0BAKgB,CAAC;6BACE,CAAC;;;;;;;;;;;;;;;;;;WAkBnB,CAAC;;;2BAGe,CAAC;;;;;;;;;;;6BAWC,CAAC;;;;;;;eAOf,CAAC;;;2BAGW,CAAC;;;iBAGX,CAAC;;;;;;;;;;;;;;;;;;6BAkBW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA0Cf,CAAC;;;iBAGC,CAAC;;;;;;;;;;;;;;;0BAeQ,CAAC;CAC1B,CAAC;AACF,CAAC"}

package/dist/facts-store.d.ts

@@ -78,10 +78,27 @@ export interface AccessContext {
     grantedSessionIds?: string[];
     unrestricted?: boolean;
 }
-/** Crawl-queue receipt: the scope key + etag returned by readUncrawledFacts. */
-export interface CrawledFactStamp {
+/**
+ * One scope-key receipt for {@link FactStore.setFactsCrawled}. `etag` (optional)
+ * makes the entry a conditional compare-and-set against `facts.etag` — the
+ * receipt returned by `readUncrawledFacts`; omitting it stomps the crawl flag
+ * regardless of source version.
+ */
+export interface SetFactsCrawledScopeKey {
     scopeKey: string;
-    etag: number;
+    etag?: number;
+}
+/**
+ * Input to {@link FactStore.setFactsCrawled}. Provide EXACTLY one selection of
+ * `scopeKeys` (explicit batch) or `keyPrefix` (coarse prefix flush).
+ */
+export interface SetFactsCrawledInput {
+    /** Explicit batch of 1..500 receipts. Each entry's etag, when present, is a conditional CAS. */
+    scopeKeys?: SetFactsCrawledScopeKey[];
+    /** Literal key prefix flipped in one shot (no per-row etag). Must be non-empty. */
+    keyPrefix?: string;
+    /** Default true. false clears `last_crawled_at` to trigger a recrawl (includes tombstones). */
+    crawled?: boolean;
 }
 export interface FactsTombstoneStats {
     pendingTotal: number;
@@ -134,10 +151,11 @@ export interface FactStore {
     /**
      * PRIVILEGED crawl-queue read (base-store bookkeeping, enhancedfactstore 07 D3):
      * facts not yet incorporated into a graph (`last_crawled_at IS NULL`), across
-     * ALL scopes. Each returned fact carries its `scopeKey` — the receipt for
-     * `markFactsCrawled`. Only useful when a graph harvester is running; inert otherwise.
+     * ALL scopes. Each returned fact carries its `scopeKey` (and `etag`) — the
+     * receipt for `setFactsCrawled`. Only useful when a graph harvester is running; inert otherwise.
      */
     readUncrawledFacts(opts?: {
+        keyPrefix?: string;
         namespace?: string;
         limit?: number;
     }): Promise<{
@@ -145,12 +163,20 @@ export interface FactStore {
         facts: FactRecord[];
     }>;
     /**
-    * PRIVILEGED crawl-queue write: stamp `last_crawled_at = now()` for the
-    * supplied scope keys that are still uncrawled. Facts edited before marking
-    * remain uncrawled because writes reset `last_crawled_at` to NULL again.
+     * PRIVILEGED crawl-queue write: set the crawled flag on a selection. Provide
+     * EXACTLY one of:
+     *  - `scopeKeys`: up to 500 `{ scopeKey, etag? }` receipts. An entry with
+     *    `etag` is a conditional CAS (skipped on mismatch); without `etag` it
+     *    stomps. The `crawled: true` path is the per-fact receipt mark.
+     *  - `keyPrefix`: a non-empty literal key prefix flipped in one shot (coarse,
+     *    no per-row etag).
+     * `crawled` defaults to true; `crawled: false` clears `last_crawled_at` to
+     * requeue for recrawl (includes tombstones). Returns `affected` (rows that
+     * changed state) and `skipped` (matched the selector but already in the
+     * requested state, or etag mismatch).
      */
-    markFactsCrawled(stamps: CrawledFactStamp[]): Promise<{
-        marked: number;
+    setFactsCrawled(input: SetFactsCrawledInput): Promise<{
+        affected: number;
         skipped: number;
     }>;
     purgeExpiredFacts(ttlSeconds: number, limit?: number): Promise<number>;
@@ -350,14 +376,15 @@ export declare class PgFactStore implements FactStore {
     getFactsStatsForSessions(sessionIds: string[]): Promise<FactsStatsRow[]>;
     getSharedFactsStats(): Promise<FactsStatsRow[]>;
     readUncrawledFacts(opts?: {
+        keyPrefix?: string;
         namespace?: string;
         limit?: number;
     }): Promise<{
         count: number;
         facts: FactRecord[];
     }>;
-    markFactsCrawled(stamps: CrawledFactStamp[]): Promise<{
-        marked: number;
+    setFactsCrawled(input: SetFactsCrawledInput): Promise<{
+        affected: number;
         skipped: number;
     }>;
     purgeExpiredFacts(ttlSeconds: number, limit?: number): Promise<number>;

package/dist/facts-store.d.ts.map

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

package/dist/facts-store.js

@@ -7,6 +7,65 @@
  *   - session cleanup when a session is deleted
  */
 import { runFactsMigrations } from "./facts-migrator.js";
+/**
+ * Validate + normalize {@link SetFactsCrawledInput} into a single proc call.
+ * Mirrors the SQL guards in `facts_set_crawled_by_keys` so misuse fails fast at
+ * the provider boundary with a clear message.
+ * @internal
+ */
+function normalizeSetFactsCrawled(input) {
+    let crawled = true;
+    if (input?.crawled !== undefined && input?.crawled !== null) {
+        if (typeof input.crawled !== "boolean") {
+            throw new Error("setFactsCrawled: crawled must be a boolean.");
+        }
+        crawled = input.crawled;
+    }
+    const hasKeys = input?.scopeKeys !== undefined && input?.scopeKeys !== null;
+    const hasPrefix = input?.keyPrefix !== undefined && input?.keyPrefix !== null;
+    if (hasKeys === hasPrefix) {
+        throw new Error("setFactsCrawled: provide exactly one of { scopeKeys } or { keyPrefix }.");
+    }
+    if (hasPrefix) {
+        const prefix = input.keyPrefix;
+        if (typeof prefix !== "string" || prefix === "") {
+            throw new Error("setFactsCrawled: keyPrefix must be a non-empty string (it would otherwise select every fact).");
+        }
+        return { mode: "prefix", prefix, crawled };
+    }
+    const entries = input.scopeKeys;
+    if (!Array.isArray(entries) || entries.length === 0) {
+        throw new Error("setFactsCrawled: scopeKeys must be a non-empty array.");
+    }
+    if (entries.length > 500) {
+        throw new Error("setFactsCrawled: scopeKeys is capped at 500 entries; page larger batches.");
+    }
+    const seen = new Set();
+    const keys = entries.map((e) => {
+        if (!e || typeof e.scopeKey !== "string" || e.scopeKey === "") {
+            throw new Error("setFactsCrawled: each scopeKeys entry needs a non-empty scopeKey.");
+        }
+        if (seen.has(e.scopeKey)) {
+            throw new Error(`setFactsCrawled: duplicate scopeKey "${e.scopeKey}" in batch.`);
+        }
+        seen.add(e.scopeKey);
+        // A present etag (even null) makes the entry a conditional CAS and MUST
+        // be a positive integer (number or clean digit-string, mirroring the SQL
+        // guard). To force/stomp, OMIT the field entirely — do NOT pass null,
+        // which would otherwise silently mark the wrong source version crawled.
+        if (e.etag === undefined) {
+            return { scopeKey: e.scopeKey };
+        }
+        const etag = typeof e.etag === "string" && /^[1-9][0-9]*$/.test(e.etag)
+            ? Number(e.etag)
+            : e.etag;
+        if (typeof etag !== "number" || !Number.isInteger(etag) || etag <= 0) {
+            throw new Error("setFactsCrawled: etag must be a positive integer when provided (omit it to force a stomp).");
+        }
+        return { scopeKey: e.scopeKey, etag };
+    });
+    return { mode: "keys", keys, crawled };
+}
 /**
  * Thrown when an enhanced/graph method is called on a store that does not
  * support it. Providers don't grow throwing stubs (Liskov / ISP — 07 D1); this
@@ -52,7 +111,8 @@ function sqlForSchema(schema) {
             getFactsStatsForSessions: `${schema}.facts_get_facts_stats_for_sessions`,
             getSharedFactsStats: `${schema}.facts_get_shared_facts_stats`,
             readUncrawledFacts: `${schema}.facts_read_uncrawled`,
-            markFactsCrawled: `${schema}.facts_mark_crawled`,
+            setCrawledByKeys: `${schema}.facts_set_crawled_by_keys`,
+            setCrawledByPrefix: `${schema}.facts_set_crawled_by_prefix`,
             purgeExpiredFacts: `${schema}.facts_purge_expired`,
             factsTombstoneStats: `${schema}.facts_tombstone_stats`,
             forcePurgeFacts: `${schema}.facts_force_purge`,
@@ -314,33 +374,27 @@ export class PgFactStore {
         return rows.map(rowToFactsStatsRow);
     }
     async readUncrawledFacts(opts = {}) {
-        // Literal key prefix (NOT a LIKE pattern) — the proc uses starts_with so
-        // any `_` / `%` in the namespace are matched literally, not as wildcards.
-        const nsPrefix = opts.namespace ?? null;
-        const limit = opts.limit ?? 20;
-        const { rows } = await this.pool.query(`SELECT * FROM ${this.sql.fn.readUncrawledFacts}($1, $2)`, [nsPrefix, limit]);
+        // Literal key prefix (NOT a LIKE pattern) — the proc escapes %/_/\ so any
+        // metacharacters match literally. `namespace` is a deprecated alias for
+        // `keyPrefix`. An empty prefix means "all scopes" (NULL to the proc).
+        const raw = opts.keyPrefix ?? opts.namespace ?? null;
+        const keyPrefix = typeof raw === "string" && raw !== "" ? raw : null;
+        const limit = Math.min(opts.limit ?? 20, 500);
+        const { rows } = await this.pool.query(`SELECT * FROM ${this.sql.fn.readUncrawledFacts}($1, $2)`, [keyPrefix, limit]);
         return {
             count: rows.length,
             facts: rows.map(mapFactRow),
         };
     }
-    async markFactsCrawled(stamps) {
-        // Coerce etag like the SQL does (it accepts numeric strings): LLM tool
-        // JSON frequently serializes numbers as strings. Reject only genuinely
-        // missing / non-numeric receipts so harvester bugs still surface loudly.
-        const normalized = stamps.map((s) => {
-            const etag = Number(s?.etag);
-            if (!s || typeof s.scopeKey !== "string" || !Number.isInteger(etag) || etag <= 0) {
-                throw new Error("markFactsCrawled: every stamp requires { scopeKey, etag } " +
-                    "(the receipt returned by readUncrawledFacts).");
-            }
-            return { scopeKey: s.scopeKey, etag };
-        });
-        if (normalized.length === 0)
-            return { marked: 0, skipped: 0 };
-        const { rows } = await this.pool.query(`SELECT * FROM ${this.sql.fn.markFactsCrawled}($1::jsonb)`, [JSON.stringify(normalized)]);
+    async setFactsCrawled(input) {
+        const norm = normalizeSetFactsCrawled(input);
+        const sql = norm.mode === "prefix"
+            ? `SELECT * FROM ${this.sql.fn.setCrawledByPrefix}($1, $2)`
+            : `SELECT * FROM ${this.sql.fn.setCrawledByKeys}($1::jsonb, $2)`;
+        const arg = norm.mode === "prefix" ? norm.prefix : JSON.stringify(norm.keys);
+        const { rows } = await this.pool.query(sql, [arg, norm.crawled]);
         return {
-            marked: Number(rows[0]?.marked) || 0,
+            affected: Number(rows[0]?.affected) || 0,
             skipped: Number(rows[0]?.skipped) || 0,
         };
     }