contextpro-mcp 0.0.0-stage → 1.5.0

package/build/core/sql-schema.js

@@ -0,0 +1,218 @@
+// SQL schema / RLS extractor for Postgres + Supabase migrations.
+//
+// FEATURE: Agents working on Supabase apps constantly need "what columns does X
+// have / does role Y have a SELECT policy on Z / what's the body of function W" —
+// today the only answer is dropping to psql. This parses migration SQL into
+// tables (columns + types + CHECK), RLS state, policies (command/roles/predicate),
+// and SECURITY DEFINER functions, so those questions are answerable from the index.
+//
+// A focused line/regex parser (not a full SQL grammar) keeps this dependency-free
+// and covers the DDL constructs that matter for schema/RLS questions. It is
+// deliberately lenient: unrecognized statements are skipped, never thrown.
+/** A schema-qualified table key, e.g. "public.users" — distinguishes auth.users. */
+export function qualifiedName(schema, name) {
+    return `${schema}.${name}`;
+}
+function stripSchemaPrefix(qualified) {
+    const cleaned = qualified.replace(/"/g, "").trim();
+    const parts = cleaned.split(".");
+    if (parts.length >= 2)
+        return { schema: parts[0], name: parts[parts.length - 1] };
+    return { schema: "public", name: cleaned };
+}
+function lineOf(source, index) {
+    let line = 1;
+    for (let i = 0; i < index && i < source.length; i++) {
+        if (source[i] === "\n")
+            line++;
+    }
+    return line;
+}
+/**
+ * Split a parenthesized column list on top-level commas only (so `numeric(10,2)`
+ * and `check (a > 0)` stay intact).
+ */
+function splitTopLevel(body) {
+    const parts = [];
+    let depth = 0;
+    let current = "";
+    for (const ch of body) {
+        if (ch === "(")
+            depth++;
+        else if (ch === ")")
+            depth--;
+        if (ch === "," && depth === 0) {
+            parts.push(current);
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current.trim())
+        parts.push(current);
+    return parts;
+}
+const TABLE_LEVEL_KEYWORDS = /^(primary\s+key|foreign\s+key|unique|check|constraint|exclude|like)\b/i;
+function parseColumn(raw) {
+    const text = raw.trim();
+    if (!text || TABLE_LEVEL_KEYWORDS.test(text))
+        return null;
+    const nameMatch = text.match(/^("?[a-zA-Z_][\w]*"?)\s+(.+)$/s);
+    if (!nameMatch)
+        return null;
+    const name = nameMatch[1].replace(/"/g, "");
+    let rest = nameMatch[2].trim();
+    // The type runs from here until the first column-constraint keyword (or end).
+    // This captures multi-word types (`timestamp with time zone`, `double precision`,
+    // `character varying(255)`) and schema-qualified enums (`public.user_role`),
+    // including a trailing `(precision[, scale])` and `[]` array marker — instead of
+    // the old pattern that grabbed at most one extra word and no dot.
+    const CONSTRAINT_BOUNDARY = /\s+\b(not\s+null|null|default|check|references|unique|primary\s+key|generated|collate|constraint)\b/i;
+    const boundary = rest.search(CONSTRAINT_BOUNDARY);
+    const type = (boundary >= 0 ? rest.slice(0, boundary) : rest).trim().replace(/,$/, "");
+    const notNull = /\bnot\s+null\b/i.test(rest);
+    const defaultMatch = rest.match(/\bdefault\s+(.+?)(?=\s+(?:not\s+null|check|references|unique|primary)\b|$)/is);
+    const defaultValue = defaultMatch ? defaultMatch[1].trim() : null;
+    const checkMatch = rest.match(/\bcheck\s*\(([^)]*(?:\([^)]*\)[^)]*)*)\)/i);
+    const check = checkMatch ? checkMatch[1].trim() : null;
+    return { name, type, notNull, defaultValue, check };
+}
+function extractTables(source) {
+    const tables = [];
+    const re = /create\s+table\s+(?:if\s+not\s+exists\s+)?([\w."]+)\s*\(/gi;
+    let match;
+    while ((match = re.exec(source)) !== null) {
+        const { schema, name } = stripSchemaPrefix(match[1]);
+        // Find the matching close paren for the column list.
+        const start = re.lastIndex;
+        let depth = 1;
+        let i = start;
+        for (; i < source.length && depth > 0; i++) {
+            if (source[i] === "(")
+                depth++;
+            else if (source[i] === ")")
+                depth--;
+        }
+        const body = source.slice(start, i - 1);
+        const columns = splitTopLevel(body)
+            .map(parseColumn)
+            .filter((c) => c !== null);
+        tables.push({ name, schema, columns, rlsEnabled: false, line: lineOf(source, match.index) });
+    }
+    return tables;
+}
+function extractAlterAddColumns(source) {
+    const added = [];
+    // `ALTER TABLE [IF EXISTS] <tbl> ADD COLUMN [IF NOT EXISTS] <col> <type…>;`
+    const re = /alter\s+table\s+(?:if\s+exists\s+)?([\w."]+)\s+add\s+column\s+(?:if\s+not\s+exists\s+)?([^;]+);/gi;
+    let match;
+    while ((match = re.exec(source)) !== null) {
+        const { schema, name } = stripSchemaPrefix(match[1]);
+        const column = parseColumn(match[2].trim());
+        if (column)
+            added.push({ table: qualifiedName(schema, name), column });
+    }
+    return added;
+}
+function applyRlsFlags(source, tables) {
+    const enabled = [];
+    const re = /alter\s+table\s+(?:if\s+exists\s+)?([\w."]+)\s+enable\s+row\s+level\s+security/gi;
+    let match;
+    while ((match = re.exec(source)) !== null) {
+        const { schema, name } = stripSchemaPrefix(match[1]);
+        // Store SCHEMA-QUALIFIED so a later cross-file enable targets the right table
+        // (Supabase's auth.users must not be confused with an app's public.users).
+        enabled.push(qualifiedName(schema, name));
+        // Set the flag in-file when the CREATE TABLE is in the same file; otherwise the
+        // returned list lets the aggregator apply it across migration files.
+        const table = tables.find((t) => t.name === name && t.schema === schema);
+        if (table)
+            table.rlsEnabled = true;
+    }
+    return enabled;
+}
+function extractPolicies(source) {
+    const policies = [];
+    // Match through the optional clauses up to the statement terminator.
+    const re = /create\s+policy\s+("([^"]+)"|[\w]+)\s+on\s+([\w."]+)([\s\S]*?);/gi;
+    let match;
+    while ((match = re.exec(source)) !== null) {
+        const name = (match[2] ?? match[1]).replace(/"/g, "");
+        const { schema: tableSchema, name: table } = stripSchemaPrefix(match[3]);
+        const clause = match[4];
+        const commandMatch = clause.match(/\bfor\s+(all|select|insert|update|delete)\b/i);
+        const command = commandMatch ? commandMatch[1].toLowerCase() : "all";
+        const rolesMatch = clause.match(/\bto\s+([\w\s,]+?)(?=\s+(?:using|with\s+check)\b|$)/i);
+        const roles = rolesMatch
+            ? rolesMatch[1].split(",").map((r) => r.trim()).filter(Boolean)
+            : [];
+        const usingMatch = clause.match(/\busing\s*\(([\s\S]*?)\)(?=\s*(?:with\s+check|$))/i);
+        const withCheckMatch = clause.match(/\bwith\s+check\s*\(([\s\S]*?)\)\s*$/i);
+        policies.push({
+            name,
+            table,
+            schema: tableSchema,
+            command,
+            roles,
+            using: usingMatch ? usingMatch[1].trim() : null,
+            withCheck: withCheckMatch ? withCheckMatch[1].trim() : null,
+            line: lineOf(source, match.index),
+        });
+    }
+    return policies;
+}
+function extractFunctions(source) {
+    const functions = [];
+    const re = /create\s+(?:or\s+replace\s+)?function\s+([\w."]+)\s*\(/gi;
+    let match;
+    while ((match = re.exec(source)) !== null) {
+        const { schema, name } = stripSchemaPrefix(match[1]);
+        // The function definition runs until its dollar-quoted body closes, or to ';'.
+        const afterParen = source.slice(match.index);
+        const dollarTag = afterParen.match(/as\s+(\$[\w]*\$)/i);
+        let body = "";
+        // Options like LANGUAGE / SECURITY DEFINER can appear BEFORE the dollar body
+        // (`LANGUAGE sql SECURITY DEFINER AS $$…$$`) OR AFTER it
+        // (`AS $$…$$ LANGUAGE plpgsql SECURITY DEFINER;`). Scan the whole statement
+        // with the body content REMOVED, so both forms are detected.
+        let header = afterParen;
+        if (dollarTag) {
+            const tag = dollarTag[1];
+            const openIdx = afterParen.indexOf(tag, dollarTag.index);
+            const closeIdx = afterParen.indexOf(tag, openIdx + tag.length);
+            if (openIdx !== -1 && closeIdx !== -1) {
+                body = afterParen.slice(openIdx + tag.length, closeIdx).trim();
+                // header = everything before the body + everything after it (to end of stmt).
+                const afterBody = afterParen.slice(closeIdx + tag.length);
+                const stmtEnd = afterBody.indexOf(";");
+                header = afterParen.slice(0, openIdx) + " " + (stmtEnd >= 0 ? afterBody.slice(0, stmtEnd) : afterBody);
+            }
+        }
+        const securityDefiner = /\bsecurity\s+definer\b/i.test(header);
+        const langMatch = header.match(/\blanguage\s+([\w]+)/i);
+        functions.push({
+            name,
+            schema,
+            securityDefiner,
+            language: langMatch ? langMatch[1].toLowerCase() : null,
+            body,
+            line: lineOf(source, match.index),
+        });
+    }
+    return functions;
+}
+export function extractSqlSchema(path, source) {
+    const normalized = source.replace(/\r\n/g, "\n");
+    const tables = extractTables(normalized);
+    const rlsEnabledTables = applyRlsFlags(normalized, tables);
+    return {
+        path,
+        tables,
+        policies: extractPolicies(normalized),
+        functions: extractFunctions(normalized),
+        rlsEnabledTables,
+        alterAddColumns: extractAlterAddColumns(normalized),
+    };
+}
+//# sourceMappingURL=sql-schema.js.map

package/build/core/sql-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-schema.js","sourceRoot":"","sources":["../../src/core/sql-schema.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,gFAAgF;AAChF,kFAAkF;AAClF,4EAA4E;AAC5E,mFAAmF;AACnF,oFAAoF;AACpF,EAAE;AACF,kFAAkF;AAClF,4EAA4E;AAC5E,2EAA2E;AA2D3E,oFAAoF;AACpF,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,IAAY;IACxD,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;IAClF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,MAAM,CAAC,MAAc,EAAE,KAAa;IAC3C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpD,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,IAAI,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACnB,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;QAC7B,IAAI,EAAE,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,oBAAoB,GAAG,wEAAwE,CAAC;AAEtG,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC,IAAI,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC/D,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5C,IAAI,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE/B,8EAA8E;IAC9E,kFAAkF;IAClF,6EAA6E;IAC7E,iFAAiF;IACjF,kEAAkE;IAClE,MAAM,mBAAmB,GAAG,sGAAsG,CAAC;IACnI,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEvF,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAChH,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,4DAA4D,CAAC;IACxE,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,qDAAqD;QACrD,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC;QAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,GAAG,KAAK,CAAC;QACd,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,KAAK,EAAE,CAAC;iBAC1B,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,KAAK,EAAE,CAAC;QACtC,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC;aAChC,GAAG,CAAC,WAAW,CAAC;aAChB,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAc;IAC5C,MAAM,KAAK,GAAgD,EAAE,CAAC;IAC9D,4EAA4E;IAC5E,MAAM,EAAE,GAAG,mGAAmG,CAAC;IAC/G,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,MAAc,EAAE,MAAkB;IACvD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,EAAE,GAAG,kFAAkF,CAAC;IAC9F,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,8EAA8E;QAC9E,2EAA2E;QAC3E,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1C,gFAAgF;QAChF,qEAAqE;QACrE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QACzE,IAAI,KAAK;YAAE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,qEAAqE;IACrE,MAAM,EAAE,GAAG,mEAAmE,CAAC;IAC/E,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAExB,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClF,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAErE,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACxF,MAAM,KAAK,GAAG,UAAU;YACtB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YAC/D,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACtF,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAE5E,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI;YACJ,KAAK;YACL,MAAM,EAAE,WAAW;YACnB,OAAO;YACP,KAAK;YACL,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;YAC/C,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;YAC3D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,SAAS,GAAkB,EAAE,CAAC;IACpC,MAAM,EAAE,GAAG,0DAA0D,CAAC;IACtE,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,+EAA+E;QAC/E,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACxD,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,6EAA6E;QAC7E,yDAAyD;QACzD,4EAA4E;QAC5E,6DAA6D;QAC7D,IAAI,MAAM,GAAG,UAAU,CAAC;QACxB,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/D,IAAI,OAAO,KAAK,CAAC,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;gBACtC,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC/D,8EAA8E;gBAC9E,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC1D,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACvC,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACzG,CAAC;QACH,CAAC;QACD,MAAM,eAAe,GAAG,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAExD,SAAS,CAAC,IAAI,CAAC;YACb,IAAI;YACJ,MAAM;YACN,eAAe;YACf,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;YACvD,IAAI;YACJ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAAc;IAC3D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO;QACL,IAAI;QACJ,MAAM;QACN,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC;QACrC,SAAS,EAAE,gBAAgB,CAAC,UAAU,CAAC;QACvC,gBAAgB;QAChB,eAAe,EAAE,sBAAsB,CAAC,UAAU,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/build/core/startup-health.d.ts

@@ -0,0 +1,40 @@
+import { type NativeStorageProbe } from "./db.js";
+declare const runtimeBuild: Readonly<{
+    serverVersion: string;
+    buildStamp: string;
+}>;
+export declare function getRuntimeBuildIdentity(): typeof runtimeBuild;
+export interface StartupHealthReport {
+    status: "ok" | "degraded";
+    timestamp: string;
+    rootDir: string;
+    runtime: {
+        nodeVersion: string;
+        execPath: string;
+        parserBackend: string;
+        nodeAbi: string;
+        pid: number;
+        serverVersion: string;
+        buildStamp: string;
+    };
+    project: {
+        ok: boolean;
+        message: string;
+        projectId: string | null;
+        clientId: string | null;
+        gitRoot: string | null;
+        fingerprint: string | null;
+    };
+    storage: NativeStorageProbe & {
+        databaseOpen: {
+            ok: boolean;
+            message: string;
+        };
+    };
+}
+export declare function runStartupHealthCheck(rootDir: string, options?: {
+    autoRepair?: boolean;
+}): Promise<StartupHealthReport>;
+export declare function formatStartupHealthReport(report: StartupHealthReport): string;
+export {};
+//# sourceMappingURL=startup-health.d.ts.map

package/build/core/startup-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-health.d.ts","sourceRoot":"","sources":["../../src/core/startup-health.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsC,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AA+BtF,QAAA,MAAM,YAAY;;;EAAsF,CAAC;AACzG,wBAAgB,uBAAuB,IAAI,OAAO,YAAY,CAAyB;AAEvF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,GAAG,UAAU,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE;QACP,EAAE,EAAE,OAAO,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;IACF,OAAO,EAAE,kBAAkB,GAAG;QAC5B,YAAY,EAAE;YACZ,EAAE,EAAE,OAAO,CAAC;YACZ,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;CACH;AAyBD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsDjI;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAuB7E"}

package/build/core/startup-health.js

@@ -0,0 +1,132 @@
+// Startup health checks for project identity and native storage readiness
+// FEATURE: Boot diagnostics — fail loud on root drift and native dependency breakage
+import { closeDB, getDB, probeNativeStorage } from "./db.js";
+import { attemptNativeAutoRepair } from "./native-repair.js";
+import { verifyProjectContext } from "./project-config.js";
+import { readFileSync, statSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+const HEALTH_PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+function readServerVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(resolve(HEALTH_PACKAGE_ROOT, "package.json"), "utf8"));
+        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    }
+    catch {
+        return "unknown";
+    }
+}
+function readBuildStamp() {
+    // The mtime of the compiled entry point. Lets a user confirm — after a restart — that the
+    // running process is using a freshly-built artifact (different timestamp = new code loaded).
+    try {
+        const stat = statSync(resolve(HEALTH_PACKAGE_ROOT, "build/index.js"));
+        return stat.mtime.toISOString();
+    }
+    catch {
+        return "unknown";
+    }
+}
+// Capture identity when this module loads. Reading the artifact timestamp on
+// every health request falsely labels an old process as a newly compiled build.
+const runtimeBuild = Object.freeze({ serverVersion: readServerVersion(), buildStamp: readBuildStamp() });
+export function getRuntimeBuildIdentity() { return runtimeBuild; }
+function summarizeProjectContext(context, error) {
+    if (context) {
+        return {
+            ok: true,
+            message: "project context verified",
+            projectId: context.config.projectId,
+            clientId: context.config.clientId,
+            gitRoot: context.gitRoot,
+            fingerprint: context.config.repoFingerprint,
+        };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        ok: false,
+        message,
+        projectId: null,
+        clientId: null,
+        gitRoot: null,
+        fingerprint: null,
+    };
+}
+export async function runStartupHealthCheck(rootDir, options = {}) {
+    const timestamp = new Date().toISOString();
+    let verifiedContext = null;
+    let projectError = null;
+    try {
+        verifiedContext = await verifyProjectContext(rootDir);
+    }
+    catch (error) {
+        projectError = error;
+    }
+    let storageProbe = probeNativeStorage();
+    if (!storageProbe.ok && options.autoRepair !== false) {
+        const repaired = await attemptNativeAutoRepair(storageProbe.diagnostic?.code);
+        if (repaired)
+            storageProbe = probeNativeStorage();
+    }
+    let databaseOpen = { ok: false, message: "native storage unavailable" };
+    if (storageProbe.ok) {
+        try {
+            const db = await getDB(rootDir);
+            db.getGraphStats();
+            databaseOpen = { ok: true, message: "database opened successfully" };
+        }
+        catch (error) {
+            databaseOpen = {
+                ok: false,
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+        finally {
+            closeDB(rootDir);
+        }
+    }
+    const project = summarizeProjectContext(verifiedContext, projectError);
+    const status = project.ok && storageProbe.ok && databaseOpen.ok ? "ok" : "degraded";
+    return {
+        status,
+        timestamp,
+        rootDir,
+        runtime: {
+            nodeVersion: process.version,
+            execPath: process.execPath,
+            parserBackend: "isolated-process/liftoff",
+            nodeAbi: process.versions.modules ?? "unknown",
+            pid: process.pid,
+            ...getRuntimeBuildIdentity(),
+        },
+        project,
+        storage: {
+            ...storageProbe,
+            databaseOpen,
+        },
+    };
+}
+export function formatStartupHealthReport(report) {
+    const lines = [
+        `[contextpro/startup] status=${report.status} root=${report.rootDir}`,
+        `[contextpro/startup] version=${report.runtime.serverVersion} build=${report.runtime.buildStamp}`,
+        `[contextpro/startup] runtime node=${report.runtime.nodeVersion} abi=${report.runtime.nodeAbi} pid=${report.runtime.pid}`,
+        `[contextpro/startup] executable=${report.runtime.execPath} parser=${report.runtime.parserBackend}`,
+        `[contextpro/startup] project ok=${report.project.ok} projectId=${report.project.projectId ?? "unknown"} gitRoot=${report.project.gitRoot ?? "unknown"} fingerprint=${report.project.fingerprint ?? "unknown"}`,
+        `[contextpro/startup] storage ok=${report.storage.ok} dbOpen=${report.storage.databaseOpen.ok}`,
+    ];
+    if (!report.project.ok) {
+        lines.push(`[contextpro/startup] project_error ${report.project.message}`);
+    }
+    if (!report.storage.ok && report.storage.diagnostic) {
+        lines.push(`[contextpro/startup] storage_error [${report.storage.diagnostic.code}] ${report.storage.diagnostic.message}`);
+        for (const step of report.storage.diagnostic.remediation) {
+            lines.push(`[contextpro/startup] remediation ${step}`);
+        }
+    }
+    else if (!report.storage.databaseOpen.ok) {
+        lines.push(`[contextpro/startup] storage_error ${report.storage.databaseOpen.message}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=startup-health.js.map

package/build/core/startup-health.js.map

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

package/build/core/team-ledger.d.ts

@@ -0,0 +1,60 @@
+type State = "queued" | "active" | "blocked" | "completed";
+export interface TeamTaskOptions {
+    rootDir: string;
+    action: "create" | "update" | "claim" | "renew" | "release" | "block" | "complete" | "handoff";
+    taskId?: string;
+    title?: string;
+    dependencies?: string[];
+    owner?: string;
+    files?: string[];
+    note?: string;
+    handoffId?: string;
+}
+export declare function teamStatus(rootDir: string, now?: number, options?: {
+    taskId?: string;
+    beforeEventId?: number;
+    eventLimit?: number;
+}): Promise<{
+    root: string;
+    advisory: boolean;
+    total: number;
+    omitted: number;
+    tasks: {
+        state: State;
+        leaseExpired: boolean;
+        dependencies: string[];
+        files: string[];
+        ready: boolean;
+        id: string;
+        title: string;
+        owner: string | null;
+        root: string;
+        expires: number;
+        handoff: string | null;
+    }[];
+    readyTaskIds: string[];
+    events: {
+        id: number;
+    }[];
+    olderEventsBefore: number | null;
+}>;
+export declare function teamTask(options: TeamTaskOptions, now?: number): Promise<{
+    task: {
+        state: State;
+        leaseExpired: boolean;
+        dependencies: string[];
+        files: string[];
+        ready: boolean;
+        id: string;
+        title: string;
+        owner: string | null;
+        root: string;
+        expires: number;
+        handoff: string | null;
+    };
+    warnings: string[];
+    advisory: boolean;
+    leaseMs: number;
+}>;
+export {};
+//# sourceMappingURL=team-ledger.d.ts.map

package/build/core/team-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-ledger.d.ts","sourceRoot":"","sources":["../../src/core/team-ledger.ts"],"names":[],"mappings":"AAYA,KAAK,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAChH,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC/H;AA2BD,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAa,EAAE,OAAO,GAAE;IAAC,MAAM,CAAC,EAAC,MAAM,CAAC;IAAA,aAAa,CAAC,EAAC,MAAM,CAAC;IAAA,UAAU,CAAC,EAAC,MAAM,CAAA;CAAM;;;;;;;;sBAJ1F,MAAM,EAAE;eAAmC,MAAM,EAAE;;YA3B/E,MAAM;eAAS,MAAM;eAA6C,MAAM,GAAG,IAAI;cAAQ,MAAM;iBAAW,MAAM;iBAA0B,MAAM,GAAG,IAAI;;;;YAsC7B,MAAM;;;GAKlJ;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,SAAa;;;;sBAlBxB,MAAM,EAAE;eAAmC,MAAM,EAAE;;YA3B/E,MAAM;eAAS,MAAM;eAA6C,MAAM,GAAG,IAAI;cAAQ,MAAM;iBAAW,MAAM;iBAA0B,MAAM,GAAG,IAAI;;;;;GAqHzK"}

package/build/core/team-ledger.js

@@ -0,0 +1,171 @@
+// Local, advisory coordination. SQLite transactions arbitrate claims; no agent execution.
+import { ensureNativeStorage, loadNativeStorageBindings } from "./db-native.js";
+import { createHash, randomUUID } from "node:crypto";
+import { homedir } from "node:os";
+import { mkdir, realpath } from "node:fs/promises";
+import { statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { detectWorktreeInfo } from "./project-config.js";
+import { resolveProjectPath, canonicalProjectPath } from "./path-guard.js";
+import { readArtifact } from "./artifacts.js";
+const LEASE_MS = 300_000;
+async function ledger(rootDir) {
+    const root = await realpath(rootDir), worktree = await detectWorktreeInfo(root);
+    const identity = await realpath(worktree.gitCommonDir).catch(() => root);
+    const directory = join(process.env.CONTEXTPRO_TEAM_DIR ?? join(homedir(), ".contextpro", "teams"), createHash("sha256").update(identity).digest("hex").slice(0, 24));
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    await ensureNativeStorage();
+    const { Database } = loadNativeStorageBindings();
+    const db = new Database(join(directory, "tasks.db"));
+    db.pragma("journal_mode = WAL");
+    db.pragma("busy_timeout = 5000");
+    db.exec(`CREATE TABLE IF NOT EXISTS tasks (
+    id TEXT PRIMARY KEY, title TEXT NOT NULL, state TEXT NOT NULL CHECK(state IN ('queued','active','blocked','completed')),
+    dependencies TEXT NOT NULL, owner TEXT, root TEXT NOT NULL, expires INTEGER NOT NULL, files TEXT NOT NULL, handoff TEXT);
+    CREATE TABLE IF NOT EXISTS events (id INTEGER PRIMARY KEY, task_id TEXT NOT NULL, at INTEGER NOT NULL, action TEXT NOT NULL, owner TEXT, root TEXT NOT NULL, note TEXT NOT NULL, details TEXT NOT NULL DEFAULT '{}');`);
+    const hasDetails = () => db.prepare("PRAGMA table_info(events)").all().some(column => column.name === "details");
+    if (!hasDetails())
+        db.transaction(() => {
+            if (!hasDetails())
+                db.exec("ALTER TABLE events ADD COLUMN details TEXT NOT NULL DEFAULT '{}'");
+        }).immediate();
+    return { db, root };
+}
+const effectiveState = (task, now) => task.state === "active" && task.expires <= now ? "queued" : task.state;
+const describe = (task, all, now) => ({ ...task, state: effectiveState(task, now),
+    leaseExpired: task.state === "active" && task.expires <= now,
+    dependencies: JSON.parse(task.dependencies), files: JSON.parse(task.files),
+    ready: effectiveState(task, now) === "queued" && JSON.parse(task.dependencies).every(id => all.some(item => item.id === id && item.state === "completed")),
+});
+export async function teamStatus(rootDir, now = Date.now(), options = {}) {
+    const { db, root } = await ledger(rootDir);
+    try {
+        const all = db.prepare("SELECT * FROM tasks ORDER BY id").all();
+        const selected = options.taskId ? all.filter(task => task.id === options.taskId) : all;
+        const limit = Math.max(1, Math.min(options.eventLimit ?? 20, 50));
+        const events = db.prepare("SELECT * FROM events WHERE (? IS NULL OR task_id=?) AND (? IS NULL OR id<?) ORDER BY id DESC LIMIT ?")
+            .all(options.taskId ?? null, options.taskId ?? null, options.beforeEventId ?? null, options.beforeEventId ?? null, limit);
+        return { root, advisory: true, total: selected.length, omitted: Math.max(0, selected.length - 100), tasks: selected.slice(0, 100).map(task => describe(task, all, now)),
+            readyTaskIds: selected.filter(task => describe(task, all, now).ready).slice(0, 100).map(task => task.id),
+            events, olderEventsBefore: events.length === limit ? events.at(-1).id : null };
+    }
+    finally {
+        db.close();
+    }
+}
+export async function teamTask(options, now = Date.now()) {
+    const { db, root } = await ledger(options.rootDir);
+    try {
+        const files = [...new Set((options.files ?? []).map(file => {
+                const path = relative(root, canonicalProjectPath(resolveProjectPath(root, file, "advisory lease"))).split("\\").join("/");
+                if (!path || path === ".")
+                    throw new Error("Lease individual files, not an entire root.");
+                try {
+                    if (statSync(resolveProjectPath(root, path)).isDirectory())
+                        throw new Error("Lease individual files, not directories.");
+                }
+                catch (error) {
+                    if (error.code !== "ENOENT")
+                        throw error;
+                }
+                return path;
+            }))];
+        let handoff;
+        if (options.action === "handoff") {
+            const artifact = options.handoffId ? await readArtifact(root, options.handoffId) : null;
+            if (!artifact || artifact.kind !== "handoff" || await realpath(artifact.repoRoot) !== root)
+                throw new Error("A handoff artifact from this workspace is required.");
+            handoff = JSON.stringify({ id: artifact.id, root });
+        }
+        return db.transaction(() => {
+            const all = db.prepare("SELECT * FROM tasks").all();
+            const id = options.taskId ?? (options.action === "create" ? randomUUID() : "");
+            let task = all.find(item => item.id === id);
+            const dependencies = [...new Set(options.dependencies ?? [])];
+            if (options.action === "create") {
+                if (task)
+                    throw new Error("Task already exists.");
+                if (!options.title?.trim())
+                    throw new Error("Task title is required.");
+                task = { id, title: options.title, state: "queued", dependencies: JSON.stringify(dependencies), owner: null, root, expires: 0, files: "[]", handoff: null };
+            }
+            else if (!task)
+                throw new Error("Unknown task.");
+            else
+                task = { ...task };
+            const owned = task.expires > now && task.owner !== null;
+            if (owned && task.owner !== options.owner)
+                throw new Error(`Task is owned by ${task.owner}; renew or release through that owner.`);
+            if (options.action === "update") {
+                if (options.title !== undefined)
+                    task.title = options.title;
+                if (options.dependencies !== undefined)
+                    task.dependencies = JSON.stringify(dependencies);
+            }
+            const proposed = all.filter(item => item.id !== id).concat(task);
+            const visited = new Set();
+            const visit = (key, path) => {
+                if (path.has(key))
+                    throw new Error("Task dependencies form a cycle.");
+                if (visited.has(key))
+                    return;
+                const item = proposed.find(value => value.id === key);
+                if (!item)
+                    throw new Error(`Unknown dependency: ${key}`);
+                const next = new Set(path);
+                next.add(key);
+                for (const dependency of JSON.parse(item.dependencies))
+                    visit(dependency, next);
+                visited.add(key);
+            };
+            visit(id, new Set());
+            const warnings = [];
+            if (["claim", "renew"].includes(options.action)) {
+                if (!options.owner?.trim())
+                    throw new Error("An explicit agent owner is required.");
+                if (options.action === "renew" && (!owned || task.owner !== options.owner || task.root !== root))
+                    throw new Error("Cannot renew an expired or foreign lease; claim the task again.");
+                if (task.state === "completed" || task.state === "blocked")
+                    throw new Error("Completed or blocked task cannot be claimed; update its dependencies or release it first.");
+                if (JSON.parse(task.dependencies).some(dep => !all.some(item => item.id === dep && item.state === "completed")))
+                    throw new Error("Task dependencies are incomplete.");
+                const leased = options.action === "renew" && options.files === undefined ? JSON.parse(task.files) : files;
+                for (const other of all.filter(item => item.id !== id && item.expires > now)) {
+                    const overlap = leased.filter(file => JSON.parse(other.files).includes(file));
+                    if (!overlap.length)
+                        continue;
+                    if (other.root === root)
+                        throw new Error(`File lease conflict with ${other.id}: ${overlap.join(", ")}`);
+                    warnings.push(`Other worktree ${other.root} has overlapping work in ${other.id}: ${overlap.join(", ")}`);
+                }
+                task.state = "active";
+                task.owner = options.owner;
+                task.root = root;
+                task.files = JSON.stringify(leased);
+                task.expires = now + LEASE_MS;
+            }
+            else if (["release", "block", "complete", "handoff"].includes(options.action)) {
+                if (options.action !== "release" && (!owned || task.owner !== options.owner || task.root !== root))
+                    throw new Error("An active claim in this worktree is required.");
+                if (options.action === "handoff")
+                    task.handoff = handoff;
+                else {
+                    task.state = options.action === "complete" ? "completed" : options.action === "block" ? "blocked" : "queued";
+                    task.owner = null;
+                    task.expires = 0;
+                    task.files = "[]";
+                }
+            }
+            db.prepare("INSERT OR REPLACE INTO tasks VALUES (@id,@title,@state,@dependencies,@owner,@root,@expires,@files,@handoff)").run(task);
+            // Keep each handoff and claim snapshot even after a later owner replaces
+            // the task's current fields. Old schema rows remain valid empty details.
+            db.prepare("INSERT INTO events(task_id,at,action,owner,root,note,details) VALUES(?,?,?,?,?,?,?)")
+                .run(id, now, options.action, options.owner ?? null, root, options.note ?? "", JSON.stringify(task));
+            return { task: describe(task, proposed, now), warnings, advisory: true, leaseMs: LEASE_MS };
+        }).immediate();
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=team-ledger.js.map