@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/store/sqlite/tag-creation.js

@@ -0,0 +1,78 @@
+import { createHash } from "node:crypto";
+import { CliError } from "@wirecat/cli-base";
+import { normalizeVocabularyName, vocabularySimilarity } from "../../domain/vocabulary.js";
+const folded = (name) => {
+    try {
+        return normalizeVocabularyName(name);
+    }
+    catch {
+        return null;
+    }
+};
+/** Includes both label kinds and aliases: a narrower preview must not hide a collision. */
+export const tagCreationReview = ({ database }, name, kind) => {
+    const metadata = database
+        .prepare("SELECT count(*) AS count,coalesce(sum(length(CAST(name AS BLOB))),0) AS bytes FROM tags")
+        .get();
+    const aliasMetadata = database
+        .prepare("SELECT count(*) AS count,coalesce(sum(length(CAST(a.name AS BLOB))),0) AS bytes FROM aliases a " +
+        "JOIN tags t ON t.id=a.aliasable_id WHERE a.aliasable_type='tag' AND a.account_id IS NULL")
+        .get();
+    if (Number(metadata?.count ?? 0) > 5000 ||
+        Number(aliasMetadata?.count ?? 0) > 100000 ||
+        Number(metadata?.bytes ?? 0) + Number(aliasMetadata?.bytes ?? 0) > 4 * 1024 * 1024)
+        throw new CliError("validation_error", "label creation review exceeds its metadata budget", {
+            reason: "tag-review.over-budget",
+        });
+    const rows = database.prepare("SELECT id,name,kind FROM tags ORDER BY id").all();
+    const aliases = database
+        .prepare("SELECT a.id,a.aliasable_id,a.name FROM aliases a JOIN tags t ON t.id=a.aliasable_id " +
+        "WHERE a.aliasable_type='tag' AND a.account_id IS NULL ORDER BY a.id")
+        .all();
+    const names = new Map();
+    for (const alias of aliases) {
+        const id = Number(alias.aliasable_id);
+        const values = names.get(id) ?? [];
+        values.push(String(alias.name));
+        names.set(id, values);
+    }
+    const candidates = rows
+        .map((row) => ({
+        id: String(row.id),
+        name: String(row.name),
+        kind: row.kind,
+        similarity: Math.max(...[String(row.name), ...(names.get(Number(row.id)) ?? [])].map((value) => folded(value) === null ? 0 : vocabularySimilarity(name, value))),
+    }))
+        .filter((entry) => entry.similarity >= 0.65)
+        .sort((a, b) => b.similarity - a.similarity || Number(a.id) - Number(b.id))
+        .slice(0, 10);
+    return {
+        creationFingerprint: `label-v1:${createHash("sha256")
+            .update(JSON.stringify({
+            name: normalizeVocabularyName(name),
+            kind,
+            rows,
+            aliases,
+        }))
+            .digest("hex")}`,
+        candidates,
+    };
+};
+export const guardTagCreation = (context, name, kind, by, options = {}) => {
+    const expected = options.expectedCreationFingerprint;
+    if (expected !== undefined && (typeof expected !== "string" || !/^label-v1:[a-f0-9]{64}$/.test(expected)))
+        throw new CliError("validation_error", "invalid label creation review fingerprint");
+    if (expected !== undefined && by !== "owner")
+        throw new CliError("permission_error", "only the owner can accept a distinct label after review");
+    const review = tagCreationReview(context, name, kind);
+    if (expected !== undefined && expected !== review.creationFingerprint)
+        throw new CliError("configuration_error", "labels changed since the creation review", {
+            reason: "tag-review.stale",
+        });
+    if (review.candidates.length && expected === undefined)
+        throw new CliError("validation_error", "similar labels exist; reuse one or review this distinct label before creation", {
+            reason: "tag-review.required",
+            ...review,
+        });
+};
+//# sourceMappingURL=tag-creation.js.map

package/dist/store/sqlite/tag-creation.js.map

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

package/dist/store/sqlite/tags.d.ts

@@ -0,0 +1,78 @@
+import type { Id } from "../../domain/models.js";
+import type { TagType } from "../../domain/tags.js";
+import type { CacheDatabase } from "../driver.js";
+import type { AccountKey } from "../store.js";
+import type { Actor } from "./actors.js";
+import type { StoreContext } from "./open.js";
+import { type TagCreationOptions } from "./tag-creation.js";
+import { type Thing } from "./things.js";
+/** What a tag labels: a chat or a message of the account, or a person of its messenger. */
+export type TagTarget = {
+    type: "chat";
+    chatId: Id;
+} | {
+    type: "contact";
+    personId: Id;
+} | {
+    type: "message";
+    chatId: Id;
+    messageId: Id;
+};
+export interface StoredTag {
+    tag: string;
+    type: TagType;
+    chatId?: Id;
+    chatTitle?: string | null;
+    personId?: Id;
+    name?: string | null;
+    messageId?: Id;
+    locator?: string;
+    sources?: ("manual" | "auto")[];
+    createdAt: string;
+}
+export interface TagFilter {
+    source?: "manual" | "auto";
+    tag?: string;
+    type?: TagType;
+}
+export declare const TAG_KINDS: readonly ["tag", "topic"];
+export type TagKind = (typeof TAG_KINDS)[number];
+/**
+ * Where a tagging came from. `owner` is the owner's own (the old `manual`), `file` what a note file states,
+ * `auto` what the keyword rules claimed for a chat, `agent` what an agent added.
+ */
+export type TaggingSource = "owner" | "file" | "auto" | "agent";
+export declare const targetThing: ({ database }: StoreContext, key: AccountKey, target: TagTarget) => Thing;
+export interface TagRow {
+    id: number;
+    name: string;
+    kind: TagKind;
+}
+export declare const tagNamed: (database: CacheDatabase, name: string) => TagRow | undefined;
+/** An explicit alias reuses its target; similarity never chooses a canonical label. */
+export declare const canonicalTagNamed: (database: CacheDatabase, name: string) => TagRow | undefined;
+/**
+ * A new tag or topic. A name is one or the other, never both, so a clash names what holds it; only the
+ * owner makes a topic — an agent's topic is a proposed action the owner approves.
+ */
+export declare const createTag: (context: StoreContext, name: string, kind: TagKind, by: "owner" | "agent", options?: TagCreationOptions) => TagRow;
+/** The tag of that name, made as a plain tag when no tag or topic holds the name yet. */
+export declare const ensureTag: (context: StoreContext, name: string) => TagRow;
+/** The tags it did not have before, in the order given; a tag the owner adds becomes the owner's. */
+export declare const addTags: (context: StoreContext, thing: Thing, tags: string[], source?: TaggingSource, author?: Actor) => string[];
+/** The tags it had, in the order given. A chat's keyword claim stays apart from the owner's own tag. */
+export declare const removeTags: ({ database }: StoreContext, thing: Thing, tags: string[], source?: "manual" | "auto") => string[];
+export interface Label {
+    tag: string;
+    /** `file` when only a note's file states it; the owner's own label otherwise. */
+    origin: "file" | "owner";
+}
+/** A thing's tags by name, with whether only a file states each. */
+export declare const labelsOf: (database: CacheDatabase, thing: Thing) => Label[];
+/**
+ * Marks one topic as the thing's main one, or clears it with `null`: the topic is tagged on it if it was
+ * not, and any other main topic stops being main.
+ */
+export declare const setMainTopic: (context: StoreContext, thing: Thing, topic: string | null) => void;
+export declare const tagsOf: ({ database }: StoreContext, key: AccountKey, filter: TagFilter) => StoredTag[];
+//# sourceMappingURL=tags.d.ts.map

package/dist/store/sqlite/tags.d.ts.map

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

package/dist/store/sqlite/tags.js

@@ -0,0 +1,240 @@
+import { CliError } from "@wirecat/cli-base";
+import { formatLocator } from "../../domain/locator.js";
+import { normalizeVocabularyName } from "../../domain/vocabulary.js";
+import { guardTagCreation } from "./tag-creation.js";
+import { emailOf, emailThreadOf } from "./things.js";
+import { toIso } from "./values.js";
+export const TAG_KINDS = ["tag", "topic"];
+/** A messenger tag target's polymorphic type: a contact is an `identity` row. */
+const TAGGABLE = { chat: "chat", contact: "identity", message: "message" };
+const TAG_TYPE = {
+    chat: "chat",
+    identity: "contact",
+    message: "message",
+    email_thread: "chat",
+    email: "message",
+};
+export const targetThing = ({ database }, key, target) => {
+    const mail = key.provider !== "email" || target.type === "contact"
+        ? undefined
+        : target.type === "chat"
+            ? emailThreadOf(database, key.account, target.chatId)
+            : emailOf(database, key.account, target.chatId, target.messageId);
+    if (mail)
+        return mail;
+    const found = target.type === "contact"
+        ? database
+            .prepare("SELECT id FROM identities WHERE provider=? AND external_id=?")
+            .get(key.provider, target.personId)
+        : target.type === "chat"
+            ? database
+                .prepare("SELECT c.id FROM chats c JOIN accounts a ON a.id=c.account_id WHERE a.provider=? AND a.external_id=? AND c.external_id=?")
+                .get(key.provider, key.account, target.chatId)
+            : database
+                .prepare("SELECT m.id FROM messages m JOIN chats c ON c.id=m.chat_id JOIN accounts a ON a.id=c.account_id " +
+                "WHERE a.provider=? AND a.external_id=? AND c.external_id=? AND m.external_id=? AND m.deleted_at IS NULL")
+                .get(key.provider, key.account, target.chatId, target.messageId);
+    if (found === undefined) {
+        const what = target.type === "contact"
+            ? `person ${target.personId}`
+            : target.type === "chat"
+                ? `chat ${target.chatId}`
+                : `message ${target.messageId} in chat ${target.chatId}`;
+        throw new CliError("not_found", `the local store holds no ${what}`);
+    }
+    return { type: TAGGABLE[target.type], id: Number(found.id) };
+};
+export const tagNamed = (database, name) => {
+    const row = database.prepare("SELECT id, name, kind FROM tags WHERE name = ?").get(name);
+    return row ? { id: Number(row.id), name: String(row.name), kind: row.kind } : undefined;
+};
+/** An explicit alias reuses its target; similarity never chooses a canonical label. */
+export const canonicalTagNamed = (database, name) => {
+    const normalized = normalizeVocabularyName(name);
+    const direct = tagNamed(database, normalized);
+    const aliases = database
+        .prepare("SELECT DISTINCT t.id,t.name,t.kind FROM aliases a JOIN tags t ON t.id=a.aliasable_id " +
+        "WHERE a.aliasable_type='tag' AND a.account_id IS NULL AND a.name_folded=? LIMIT 2")
+        .all(normalized);
+    if (aliases.length > 1 || (direct && aliases.some((row) => Number(row.id) !== direct.id)))
+        throw new CliError("configuration_error", "the label name has conflicting canonical targets");
+    const row = aliases[0];
+    return direct ?? (row ? { id: Number(row.id), name: String(row.name), kind: row.kind } : undefined);
+};
+/**
+ * A new tag or topic. A name is one or the other, never both, so a clash names what holds it; only the
+ * owner makes a topic — an agent's topic is a proposed action the owner approves.
+ */
+export const createTag = (context, name, kind, by, options = {}) => {
+    const { database, now } = context;
+    if (!TAG_KINDS.includes(kind))
+        throw new CliError("validation_error", `a tag's kind is one of ${TAG_KINDS.join(", ")}`);
+    if (kind === "topic" && by !== "owner")
+        throw new CliError("permission_error", "only the owner creates a topic — propose it for the owner to approve", {
+            reason: "topic.owner-only",
+        });
+    const held = canonicalTagNamed(database, name);
+    if (held)
+        throw new CliError("validation_error", held.kind === kind ? `the ${kind} "${name}" exists` : `"${name}" is a ${held.kind}; one name is never both`, { reason: held.kind === kind ? "tag_exists" : "tag_name_clash" });
+    guardTagCreation(context, name, kind, by, options);
+    const at = now();
+    database.prepare("INSERT INTO tags (name, kind, created_at, updated_at) VALUES (?, ?, ?, ?)").run(name, kind, at, at);
+    return tagNamed(database, name);
+};
+/** The tag of that name, made as a plain tag when no tag or topic holds the name yet. */
+export const ensureTag = (context, name) => {
+    return canonicalTagNamed(context.database, name) ?? createTag(context, name, "tag", "owner");
+};
+/** The tags it did not have before, in the order given; a tag the owner adds becomes the owner's. */
+export const addTags = (context, thing, tags, source = "owner", author) => {
+    const { database, now } = context;
+    const insert = database.prepare("INSERT INTO taggings (tag_id, taggable_type, taggable_id, main, source, author_type, author_id, created_at, updated_at) " +
+        "VALUES (?, ?, ?, 0, ?, ?, ?, ?, ?) ON CONFLICT (tag_id, taggable_type, taggable_id) DO NOTHING");
+    const claim = database.prepare("UPDATE taggings SET source = 'owner', updated_at = ? WHERE tag_id = ? AND taggable_type = ? AND taggable_id = ? AND source <> 'owner'");
+    const at = now();
+    return tags.filter((name) => {
+        const tag = ensureTag(context, name);
+        const added = insert.run(tag.id, thing.type, thing.id, source, author?.type ?? null, author?.id ?? null, at, at).changes > 0;
+        if (!added && source === "owner")
+            claim.run(at, tag.id, thing.type, thing.id);
+        return added;
+    });
+};
+const sourceOf = (database, thing, tagId) => database
+    .prepare("SELECT source FROM taggings WHERE tag_id=? AND taggable_type=? AND taggable_id=?")
+    .get(tagId, thing.type, thing.id)?.source;
+/** The tags it had, in the order given. A chat's keyword claim stays apart from the owner's own tag. */
+export const removeTags = ({ database }, thing, tags, source) => {
+    const remove = database.prepare("DELETE FROM taggings WHERE tag_id=? AND taggable_type=? AND taggable_id=?");
+    return tags.filter((name) => {
+        const tag = tagNamed(database, name);
+        if (!tag)
+            return false;
+        const held = sourceOf(database, thing, tag.id);
+        const automatic = thing.type === "chat" &&
+            database.prepare("SELECT 1 AS held FROM auto_tag_claims WHERE chat_id=? AND tag_id=?").get(thing.id, tag.id);
+        if (source === "manual") {
+            if (held !== "owner")
+                return false;
+            if (automatic)
+                database
+                    .prepare("UPDATE taggings SET source='auto' WHERE tag_id=? AND taggable_type=? AND taggable_id=?")
+                    .run(tag.id, thing.type, thing.id);
+            else
+                remove.run(tag.id, thing.type, thing.id);
+            return true;
+        }
+        if (thing.type === "chat")
+            database.prepare("DELETE FROM auto_tag_claims WHERE chat_id=? AND tag_id=?").run(thing.id, tag.id);
+        if (source === "auto") {
+            if (!automatic)
+                return false;
+            if (held !== "owner")
+                remove.run(tag.id, thing.type, thing.id);
+            return true;
+        }
+        return remove.run(tag.id, thing.type, thing.id).changes > 0;
+    });
+};
+/** A thing's tags by name, with whether only a file states each. */
+export const labelsOf = (database, thing) => database
+    .prepare("SELECT t.name, g.source FROM taggings g JOIN tags t ON t.id = g.tag_id WHERE g.taggable_type=? AND g.taggable_id=? ORDER BY t.name")
+    .all(thing.type, thing.id)
+    .map((row) => ({ tag: String(row.name), origin: row.source === "file" ? "file" : "owner" }));
+/**
+ * Marks one topic as the thing's main one, or clears it with `null`: the topic is tagged on it if it was
+ * not, and any other main topic stops being main.
+ */
+export const setMainTopic = (context, thing, topic) => {
+    const { database, now } = context;
+    const at = now();
+    database
+        .prepare("UPDATE taggings SET main = 0, updated_at = ? WHERE taggable_type = ? AND taggable_id = ? AND main = 1")
+        .run(at, thing.type, thing.id);
+    if (topic === null)
+        return;
+    const tag = tagNamed(database, topic);
+    if (tag?.kind !== "topic")
+        throw new CliError("validation_error", `"${topic}" is not a topic; only a topic can be a thing's main one`);
+    addTags(context, thing, [topic]);
+    database
+        .prepare("UPDATE taggings SET main = 1, updated_at = ? WHERE tag_id = ? AND taggable_type = ? AND taggable_id = ?")
+        .run(at, tag.id, thing.type, thing.id);
+};
+export const tagsOf = ({ database }, key, filter) => {
+    const tagged = filter.tag === undefined ? "" : " AND t.name=?";
+    const parts = [
+        {
+            type: "chat",
+            sql: "SELECT t.name AS tag, g.taggable_type AS type, g.created_at, c.external_id AS chat_id, c.title AS chat_title, " +
+                "NULL AS person_id, NULL AS name, NULL AS message_id, g.source, g.taggable_id AS target_id, t.id AS tag_id " +
+                "FROM taggings g JOIN tags t ON t.id=g.tag_id JOIN chats c ON c.id=g.taggable_id " +
+                "JOIN accounts a ON a.id=c.account_id WHERE g.taggable_type='chat' AND a.provider=? AND a.external_id=?",
+            params: [key.provider, key.account],
+        },
+        {
+            type: "contact",
+            sql: "SELECT t.name AS tag, g.taggable_type AS type, g.created_at, NULL AS chat_id, NULL AS chat_title, " +
+                "i.external_id AS person_id, i.name AS name, NULL AS message_id, g.source, g.taggable_id AS target_id, t.id AS tag_id " +
+                "FROM taggings g JOIN tags t ON t.id=g.tag_id JOIN identities i ON i.id=g.taggable_id " +
+                "WHERE g.taggable_type='identity' AND i.provider=?",
+            params: [key.provider],
+        },
+        {
+            type: "message",
+            sql: "SELECT t.name AS tag, g.taggable_type AS type, g.created_at, c.external_id AS chat_id, c.title AS chat_title, " +
+                "NULL AS person_id, NULL AS name, m.external_id AS message_id, g.source, g.taggable_id AS target_id, t.id AS tag_id " +
+                "FROM taggings g JOIN tags t ON t.id=g.tag_id JOIN messages m ON m.id=g.taggable_id JOIN chats c ON c.id=m.chat_id " +
+                "JOIN accounts a ON a.id=c.account_id WHERE g.taggable_type='message' AND a.provider=? AND a.external_id=?",
+            params: [key.provider, key.account],
+        },
+        {
+            type: "chat",
+            sql: "SELECT t.name AS tag, g.taggable_type AS type, g.created_at, th.external_id AS chat_id, th.subject AS chat_title, " +
+                "NULL AS person_id, NULL AS name, NULL AS message_id, g.source, g.taggable_id AS target_id, t.id AS tag_id " +
+                "FROM taggings g JOIN tags t ON t.id=g.tag_id JOIN email_threads th ON th.id=g.taggable_id " +
+                "JOIN accounts a ON a.id=th.account_id WHERE g.taggable_type='email_thread' AND a.provider=? AND a.external_id=?",
+            params: [key.provider, key.account],
+        },
+        {
+            type: "message",
+            sql: "SELECT t.name AS tag, g.taggable_type AS type, g.created_at, th.external_id AS chat_id, th.subject AS chat_title, " +
+                "NULL AS person_id, NULL AS name, e.external_id AS message_id, g.source, g.taggable_id AS target_id, t.id AS tag_id " +
+                "FROM taggings g JOIN tags t ON t.id=g.tag_id JOIN emails e ON e.id=g.taggable_id " +
+                "JOIN email_threads th ON th.id=e.email_thread_id JOIN accounts a ON a.id=e.account_id " +
+                "WHERE g.taggable_type='email' AND e.deleted_at IS NULL AND a.provider=? AND a.external_id=?",
+            params: [key.provider, key.account],
+        },
+    ];
+    const chosen = parts.filter(({ type }) => filter.type === undefined || filter.type === type);
+    const rows = database
+        .prepare(`${chosen.map(({ sql }) => sql + tagged).join(" UNION ALL ")} ORDER BY 1, 2, 3, 4, 6, 8`)
+        .all(...chosen.flatMap(({ params }) => (filter.tag === undefined ? params : [...params, filter.tag])));
+    const result = rows.map((row) => {
+        const type = TAG_TYPE[String(row.type)];
+        const chatId = row.chat_id == null ? undefined : String(row.chat_id);
+        const messageId = row.message_id == null ? undefined : String(row.message_id);
+        const automatic = row.type === "chat" &&
+            database
+                .prepare("SELECT 1 AS held FROM auto_tag_claims WHERE chat_id=? AND tag_id=?")
+                .get(Number(row.target_id), Number(row.tag_id));
+        return {
+            ...(automatic
+                ? { sources: (row.source === "owner" ? ["manual", "auto"] : ["auto"]) }
+                : {}),
+            tag: String(row.tag),
+            type,
+            ...(type === "contact"
+                ? { personId: String(row.person_id), name: row.name == null ? null : String(row.name) }
+                : { chatId, chatTitle: row.chat_title == null ? null : String(row.chat_title) }),
+            ...(type === "message" && chatId !== undefined && messageId !== undefined
+                ? { messageId, locator: formatLocator({ ...key, chat: chatId, message: messageId }) }
+                : {}),
+            createdAt: toIso(Number(row.created_at)),
+        };
+    });
+    return filter.source === undefined
+        ? result
+        : result.filter((entry) => (entry.sources ?? ["manual"]).includes(filter.source));
+};
+//# sourceMappingURL=tags.js.map

package/dist/store/sqlite/tags.js.map

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

package/dist/store/sqlite/task-relations.d.ts

@@ -0,0 +1,43 @@
+import type { CacheDatabase } from "../driver.js";
+import type { Actor } from "./actors.js";
+import { type Author } from "./memories.js";
+import type { StoreContext } from "./open.js";
+export declare const TASK_RELATION_KINDS: readonly ["blocked-by", "follow-up-of", "related-to"];
+export type TaskRelationKind = (typeof TASK_RELATION_KINDS)[number];
+export interface TaskRelation {
+    id: string;
+    from: string;
+    to: string;
+    kind: TaskRelationKind;
+}
+export interface TaskRelationsStore {
+    linkTask(from: string, to: string, kind: TaskRelationKind, by: Author): Promise<{
+        relation: TaskRelation;
+        changed: boolean;
+    }>;
+    unlinkTask(from: string, to: string, kind: TaskRelationKind, by: Author): Promise<{
+        changed: boolean;
+    }>;
+    taskRelations(task: string): Promise<TaskRelation[]>;
+    taskReadiness(task: string): Promise<{
+        ready: boolean;
+        blockers: {
+            task: string;
+            state: "open" | "dismissed" | "unavailable";
+        }[];
+    }>;
+    readyTasks(project: string, options?: {
+        limit?: number;
+    }): Promise<{
+        items: {
+            id: string;
+            key: string;
+            title: string;
+        }[];
+        hasMore: boolean;
+    }>;
+}
+/** Validation and the edge insert must see the same write-locked snapshot. */
+export declare const validateTaskRelation: (database: CacheDatabase, from: number, to: number, kind: TaskRelationKind) => void;
+export declare const taskRelationsStoreOver: (context: StoreContext, record: (task: number, actor: Actor, kind: "linked" | "unlinked", changes: Record<string, [unknown, unknown]>, at: number) => void) => TaskRelationsStore;
+//# sourceMappingURL=task-relations.d.ts.map

package/dist/store/sqlite/task-relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-relations.d.ts","sourceRoot":"","sources":["../../../src/store/sqlite/task-relations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,KAAK,MAAM,EAAe,MAAM,eAAe,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAI7C,eAAO,MAAM,mBAAmB,YAAI,YAAY,EAAE,cAAc,EAAE,YAAY,CAAU,CAAA;AACxF,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AACnE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,gBAAgB,CAAA;CACvB;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;QAAE,QAAQ,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACxD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACvG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IACpD,aAAa,CACX,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC,CAAA;IACzG,UAAU,CACR,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC;QAAE,KAAK,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CACtF;AAgBD,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,aAAc,aAAa,QAAQ,MAAM,MAAM,MAAM,QAAQ,gBAAgB,SAgB7G,CAAA;AAED,eAAO,MAAM,sBAAsB,YACxB,YAAY,UACb,CACN,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,QAAQ,GAAG,UAAU,EAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EAC3C,EAAE,EAAE,MAAM,KACP,IAAI,KACR,kBA4HF,CAAA"}

package/dist/store/sqlite/task-relations.js

@@ -0,0 +1,148 @@
+import { CliError } from "@wirecat/cli-base";
+import { atomic } from "./atomic.js";
+import { authorActor } from "./memories.js";
+import { readSnapshot } from "./read-snapshot.js";
+import { taskIdOf, taskRowOf } from "./things.js";
+export const TASK_RELATION_KINDS = ["blocked-by", "follow-up-of", "related-to"];
+const kindOf = (kind) => {
+    if (!TASK_RELATION_KINDS.includes(kind))
+        throw new CliError("validation_error", "choose blocked-by, follow-up-of or related-to");
+};
+const liveTask = (database, rowId) => {
+    const row = database
+        .prepare("SELECT t.id,t.status FROM tasks t JOIN projects p ON p.id=t.project_id WHERE t.id=? AND t.deleted_at IS NULL AND p.deleted_at IS NULL AND p.account_id IS NULL")
+        .get(rowId);
+    if (!row)
+        throw new CliError("not_found", "the owner project task is unavailable");
+    return row;
+};
+/** Validation and the edge insert must see the same write-locked snapshot. */
+export const validateTaskRelation = (database, from, to, kind) => {
+    kindOf(kind);
+    liveTask(database, from);
+    liveTask(database, to);
+    if (from === to)
+        throw new CliError("validation_error", "a task cannot link to itself");
+    if (kind === "related-to")
+        return;
+    const reached = database
+        .prepare("WITH RECURSIVE reached(id) AS (SELECT ? UNION SELECT l.to_id FROM links l JOIN reached r ON l.from_id=r.id WHERE l.from_type='task' AND l.to_type='task' AND l.kind=? AND l.anchor IS NULL LIMIT 10001) SELECT id FROM reached")
+        .all(to, kind);
+    if (reached.length > 10000)
+        throw new CliError("validation_error", "task dependency traversal exceeds 10000 nodes");
+    if (reached.some((row) => Number(row.id) === from))
+        throw new CliError("validation_error", "this task relationship would create a cycle", {
+            reason: "task.dependency-cycle",
+        });
+};
+export const taskRelationsStoreOver = (context, record) => {
+    const { database, now } = context;
+    const required = (reference) => {
+        if (typeof reference !== "string" || !reference.trim())
+            throw new CliError("validation_error", "a task reference is required");
+        const rowId = taskRowOf(database, reference.startsWith("task:") ? reference.slice(5) : reference);
+        if (rowId === undefined)
+            throw new CliError("not_found", "the task is unavailable");
+        liveTask(database, rowId);
+        return rowId;
+    };
+    const ref = (rowId) => {
+        const found = taskIdOf(database, rowId);
+        if (found === undefined)
+            throw new CliError("not_found", "a task relationship points at an unavailable record");
+        return `task:${found}`;
+    };
+    const pair = (from, to, kind) => {
+        kindOf(kind);
+        const a = required(from);
+        const b = required(to);
+        return kind === "related-to" && a > b ? [b, a] : [a, b];
+    };
+    const relationOf = (row) => ({
+        id: String(row.id),
+        from: ref(Number(row.from_id)),
+        to: ref(Number(row.to_id)),
+        kind: row.kind,
+    });
+    const lookup = (from, to, kind) => database
+        .prepare("SELECT id,from_id,to_id,kind FROM links WHERE from_type='task' AND to_type='task' AND kind=? AND anchor IS NULL AND ((from_id=? AND to_id=?) OR (?='related-to' AND from_id=? AND to_id=?)) ORDER BY id LIMIT 1")
+        .get(kind, from, to, kind, to, from);
+    return {
+        linkTask: async (from, to, kind, by) => atomic(database, () => {
+            if (by !== "owner")
+                throw new CliError("permission_error", "an agent proposes task relationships; only the owner applies them");
+            const [a, b] = pair(from, to, kind);
+            validateTaskRelation(database, a, b, kind);
+            const held = lookup(a, b, kind);
+            if (held)
+                return { relation: relationOf(held), changed: false };
+            const at = now();
+            database
+                .prepare("INSERT INTO links (from_type,from_id,to_type,to_id,kind,source,confirmed,author,created_at,updated_at) VALUES ('task',?,'task',? ,?,'owner',1,'owner',?,?)")
+                .run(a, b, kind, at, at);
+            record(a, authorActor(context, "owner").actor, "linked", { relation: [null, { kind, to: ref(b) }] }, at);
+            return { relation: relationOf(lookup(a, b, kind)), changed: true };
+        }),
+        unlinkTask: async (from, to, kind, by) => atomic(database, () => {
+            if (by !== "owner")
+                throw new CliError("permission_error", "an agent proposes task relationships; only the owner applies them");
+            const [a, b] = pair(from, to, kind);
+            const changed = database
+                .prepare("DELETE FROM links WHERE from_type='task' AND to_type='task' AND kind=? AND anchor IS NULL AND ((from_id=? AND to_id=?) OR (?='related-to' AND from_id=? AND to_id=?))")
+                .run(kind, a, b, kind, b, a).changes > 0;
+            if (changed)
+                record(a, authorActor(context, "owner").actor, "unlinked", { relation: [{ kind, to: ref(b) }, null] }, now());
+            return { changed };
+        }),
+        taskRelations: async (task) => readSnapshot(database, () => {
+            const rowId = required(task);
+            const rows = database
+                .prepare("SELECT id,from_id,to_id,kind FROM links WHERE from_type='task' AND to_type='task' AND (from_id=? OR to_id=?) AND kind IN ('blocked-by','follow-up-of','related-to') AND anchor IS NULL ORDER BY id LIMIT 501")
+                .all(rowId, rowId);
+            if (rows.length > 500)
+                throw new CliError("validation_error", "task relationships exceed the 500-edge read budget");
+            return rows.map(relationOf);
+        }),
+        taskReadiness: async (task) => readSnapshot(database, () => {
+            const rowId = required(task);
+            const rows = database
+                .prepare("SELECT l.to_id,t.status,t.deleted_at,p.deleted_at AS project_deleted FROM links l LEFT JOIN tasks t ON t.id=l.to_id LEFT JOIN projects p ON p.id=t.project_id WHERE l.from_type='task' AND l.to_type='task' AND l.kind='blocked-by' AND l.from_id=? AND l.confirmed=1 AND l.anchor IS NULL AND (t.id IS NULL OR t.deleted_at IS NOT NULL OR p.deleted_at IS NOT NULL OR t.status!='done') ORDER BY l.id LIMIT 101")
+                .all(rowId);
+            if (rows.length > 100)
+                throw new CliError("validation_error", "task blockers exceed the 100-edge read budget");
+            const blockers = rows.map((row) => ({
+                task: ref(Number(row.to_id)),
+                state: row.status == null || row.deleted_at != null || row.project_deleted != null
+                    ? "unavailable"
+                    : row.status === "dismissed"
+                        ? "dismissed"
+                        : "open",
+            }));
+            return { ready: liveTask(database, rowId).status === "open" && blockers.length === 0, blockers };
+        }),
+        readyTasks: async (project, options = {}) => readSnapshot(database, () => {
+            const limit = options.limit ?? 50;
+            if (!Number.isSafeInteger(limit) || limit < 1 || limit > 500)
+                throw new CliError("validation_error", "ready tasks take 1–500 rows");
+            const row = project.startsWith("project:")
+                ? database
+                    .prepare("SELECT id FROM projects WHERE id=? AND account_id IS NULL AND deleted_at IS NULL")
+                    .get(project.slice(8))
+                : database
+                    .prepare("SELECT id FROM projects WHERE key=? AND account_id IS NULL AND deleted_at IS NULL")
+                    .get(project.trim().toUpperCase());
+            if (!row)
+                throw new CliError("not_found", "the owner project is unavailable");
+            const rows = database
+                .prepare("SELECT coalesce(t.package_id,t.key) AS id,t.key,substr(t.title,1,300) AS title FROM tasks t WHERE t.project_id=? AND t.status='open' AND t.deleted_at IS NULL AND NOT EXISTS (SELECT 1 FROM links l LEFT JOIN tasks b ON b.id=l.to_id LEFT JOIN projects p ON p.id=b.project_id WHERE l.from_type='task' AND l.to_type='task' AND l.kind='blocked-by' AND l.from_id=t.id AND l.confirmed=1 AND l.anchor IS NULL AND (b.id IS NULL OR b.deleted_at IS NOT NULL OR p.deleted_at IS NOT NULL OR b.status!='done')) ORDER BY coalesce(t.priority,5),t.number,t.id LIMIT ?")
+                .all(Number(row.id), limit + 1);
+            return {
+                items: rows
+                    .slice(0, limit)
+                    .map((value) => ({ id: String(value.id), key: String(value.key), title: String(value.title ?? "") })),
+                hasMore: rows.length > limit,
+            };
+        }),
+    };
+};
+//# sourceMappingURL=task-relations.js.map