@femtomc/mu-issue 26.2.69 → 26.2.70

package/dist/contracts.d.ts

@@ -0,0 +1,33 @@
+import type { Issue } from "@femtomc/mu-core";
+export declare const ISSUE_STATUS_VALUES: readonly ["open", "in_progress", "closed"];
+export declare const DEFAULT_ISSUE_QUERY_LIMIT = 200;
+export declare const MAX_ISSUE_QUERY_LIMIT = 200;
+export declare class IssueStoreError extends Error {
+    constructor(message: string, opts?: {
+        cause?: unknown;
+    });
+}
+export declare class IssueStoreNotFoundError extends IssueStoreError {
+    readonly issueId: string;
+    constructor(issueId: string);
+}
+export declare class IssueStoreValidationError extends IssueStoreError {
+    constructor(message: string, opts?: {
+        cause?: unknown;
+    });
+}
+export declare function normalizeIssueStatusFilter(status: unknown): Issue["status"] | undefined;
+export declare function normalizeIssueTagFilter(tag: unknown): string | undefined;
+export declare function normalizeIssueContainsFilter(contains: unknown): string | undefined;
+export declare function normalizeIssueQueryLimit(limit: unknown, opts?: {
+    defaultLimit?: number | null;
+    max?: number;
+}): number | null;
+export declare function normalizeIssueDepInput(input: {
+    depType: unknown;
+    target: unknown;
+}): {
+    depType: string;
+    target: string;
+};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,mBAAmB,4CAAkF,CAAC;AACnH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAIzC,qBAAa,eAAgB,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI9D;AAED,qBAAa,uBAAwB,SAAQ,eAAe;IAC3D,SAAgB,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM;CAKlC;AAED,qBAAa,yBAA0B,SAAQ,eAAe;gBAC1C,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI9D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,SAAS,CAevF;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASxE;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASlF;AAED,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,OAAO,EACd,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,MAAM,GAAG,IAAI,CAsBf;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf,CAUA"}

package/dist/contracts.js

@@ -0,0 +1,93 @@
+export const ISSUE_STATUS_VALUES = ["open", "in_progress", "closed"];
+export const DEFAULT_ISSUE_QUERY_LIMIT = 200;
+export const MAX_ISSUE_QUERY_LIMIT = 200;
+const ISSUE_STATUS_SET = new Set(ISSUE_STATUS_VALUES);
+export class IssueStoreError extends Error {
+    constructor(message, opts) {
+        super(message, opts);
+        this.name = "IssueStoreError";
+    }
+}
+export class IssueStoreNotFoundError extends IssueStoreError {
+    issueId;
+    constructor(issueId) {
+        super(`issue not found: ${issueId}`);
+        this.name = "IssueStoreNotFoundError";
+        this.issueId = issueId;
+    }
+}
+export class IssueStoreValidationError extends IssueStoreError {
+    constructor(message, opts) {
+        super(message, opts);
+        this.name = "IssueStoreValidationError";
+    }
+}
+export function normalizeIssueStatusFilter(status) {
+    if (status == null || status === "") {
+        return undefined;
+    }
+    if (typeof status !== "string") {
+        throw new IssueStoreValidationError("invalid issue status filter: expected string");
+    }
+    const trimmed = status.trim();
+    if (trimmed.length === 0) {
+        return undefined;
+    }
+    if (!ISSUE_STATUS_SET.has(trimmed)) {
+        throw new IssueStoreValidationError(`invalid issue status filter: ${trimmed}`);
+    }
+    return trimmed;
+}
+export function normalizeIssueTagFilter(tag) {
+    if (tag == null || tag === "") {
+        return undefined;
+    }
+    if (typeof tag !== "string") {
+        throw new IssueStoreValidationError("invalid issue tag filter: expected string");
+    }
+    const trimmed = tag.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+export function normalizeIssueContainsFilter(contains) {
+    if (contains == null || contains === "") {
+        return undefined;
+    }
+    if (typeof contains !== "string") {
+        throw new IssueStoreValidationError("invalid issue contains filter: expected string");
+    }
+    const trimmed = contains.trim().toLowerCase();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+export function normalizeIssueQueryLimit(limit, opts = {}) {
+    const defaultLimit = opts.defaultLimit ?? null;
+    const max = opts.max ?? MAX_ISSUE_QUERY_LIMIT;
+    if (limit == null || limit === "") {
+        return defaultLimit;
+    }
+    let value;
+    if (typeof limit === "number" && Number.isFinite(limit)) {
+        value = limit;
+    }
+    else if (typeof limit === "string" && /^\d+$/.test(limit.trim())) {
+        value = Number.parseInt(limit, 10);
+    }
+    else {
+        throw new IssueStoreValidationError("invalid issue query limit: expected positive integer");
+    }
+    const normalized = Math.trunc(value);
+    if (normalized < 1) {
+        throw new IssueStoreValidationError("invalid issue query limit: must be >= 1");
+    }
+    return Math.min(max, normalized);
+}
+export function normalizeIssueDepInput(input) {
+    const depType = typeof input.depType === "string" ? input.depType.trim() : "";
+    if (depType.length === 0) {
+        throw new IssueStoreValidationError("dependency type is required");
+    }
+    const target = typeof input.target === "string" ? input.target.trim() : "";
+    if (target.length === 0) {
+        throw new IssueStoreValidationError("dependency target is required");
+    }
+    return { depType, target };
+}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-export type { CreateIssueOpts, ListIssueOpts } from "./issue_store.js";
+export type { CreateIssueOpts, ListIssueOpts, ReadyIssueOpts } from "./issue_store.js";
 export { IssueStore } from "./issue_store.js";
+export { DEFAULT_ISSUE_QUERY_LIMIT, ISSUE_STATUS_VALUES, MAX_ISSUE_QUERY_LIMIT, IssueStoreError, IssueStoreNotFoundError, IssueStoreValidationError, normalizeIssueContainsFilter, normalizeIssueDepInput, normalizeIssueQueryLimit, normalizeIssueStatusFilter, normalizeIssueTagFilter, } from "./contracts.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACN,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1 +1,2 @@
 export { IssueStore } from "./issue_store.js";
+export { DEFAULT_ISSUE_QUERY_LIMIT, ISSUE_STATUS_VALUES, MAX_ISSUE_QUERY_LIMIT, IssueStoreError, IssueStoreNotFoundError, IssueStoreValidationError, normalizeIssueContainsFilter, normalizeIssueDepInput, normalizeIssueQueryLimit, normalizeIssueStatusFilter, normalizeIssueTagFilter, } from "./contracts.js";

package/dist/issue_store.d.ts

@@ -6,8 +6,15 @@ export type CreateIssueOpts = {
     priority?: number;
 };
 export type ListIssueOpts = {
-    status?: Issue["status"];
-    tag?: string;
+    status?: Issue["status"] | null;
+    tag?: string | null;
+    contains?: string | null;
+    limit?: number | null;
+};
+export type ReadyIssueOpts = {
+    tags?: readonly string[] | null;
+    contains?: string | null;
+    limit?: number | null;
 };
 export declare class IssueStore {
     #private;
@@ -26,9 +33,7 @@ export declare class IssueStore {
     remove_dep(srcId: string, depType: string, dstId: string): Promise<boolean>;
     children(parentId: string): Promise<Issue[]>;
     subtree_ids(rootId: string): Promise<string[]>;
-    ready(rootId?: string | null, opts?: {
-        tags?: readonly string[] | null;
-    }): Promise<Issue[]>;
+    ready(rootId?: string | null, opts?: ReadyIssueOpts): Promise<Issue[]>;
     collapsible(rootId: string): Promise<Issue[]>;
     validate(rootId: string): Promise<ValidationResult>;
 }

package/dist/issue_store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issue_store.d.ts","sourceRoot":"","sources":["../src/issue_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAGN,QAAQ,EAOR,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,eAAe,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAgDF,qBAAa,UAAU;;IACtB,SAAgB,MAAM,EAAE,QAAQ,CAAC;gBAGd,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,CAAA;KAAO;IAwBnE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,KAAK,CAAC;IA4BjE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAM3C,IAAI,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAWhD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IA0ExE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA+BxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAInE,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBpD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBrE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2B3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAK5C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS9C,KAAK,CAAC,MAAM,GAAE,MAAM,GAAG,IAAW,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;KAAO,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAOrG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAK7C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAIhE"}
+{"version":3,"file":"issue_store.d.ts","sourceRoot":"","sources":["../src/issue_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAGN,QAAQ,EAOR,MAAM,kBAAkB,CAAC;AAW1B,MAAM,MAAM,eAAe,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAqDF,qBAAa,UAAU;;IACtB,SAAgB,MAAM,EAAE,QAAQ,CAAC;gBAGd,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,CAAA;KAAO;IA0CnE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,KAAK,CAAC;IA0BjE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAM3C,IAAI,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA0ChD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IA8ExE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA+BxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAInE,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBpD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCrE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAK5C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS9C,KAAK,CAAC,MAAM,GAAE,MAAM,GAAG,IAAW,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAgBhF,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAK7C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAIhE"}

package/dist/issue_store.js

@@ -1,4 +1,5 @@
 import { collapsible as dagCollapsible, subtreeIds as dagSubtreeIds, EventLog, IssueSchema, NullEventSink, nowTs, readyLeaves, shortId, validateDag, } from "@femtomc/mu-core";
+import { IssueStoreNotFoundError, IssueStoreValidationError, normalizeIssueContainsFilter, normalizeIssueDepInput, normalizeIssueQueryLimit, normalizeIssueStatusFilter, normalizeIssueTagFilter, } from "./contracts.js";
 function deepEqualJson(a, b) {
     if (a === b) {
         return true;
@@ -44,6 +45,10 @@ function deepEqualJson(a, b) {
     }
     return false;
 }
+function issueContainsText(issue, contains) {
+    const haystack = `${issue.title}\n${issue.body}`.toLowerCase();
+    return haystack.includes(contains);
+}
 export class IssueStore {
     events;
     #issues;
@@ -51,15 +56,30 @@ export class IssueStore {
         this.#issues = issues;
         this.events = opts.events ?? new EventLog(new NullEventSink());
     }
+    #parseIssueRow(row, idx) {
+        const parsed = IssueSchema.safeParse(row);
+        if (!parsed.success) {
+            throw new Error(`invalid issue row ${idx}: ${parsed.error.message}`);
+        }
+        return parsed.data;
+    }
     async #load() {
         const rows = await this.#issues.read();
-        return rows.map((row, idx) => {
-            const parsed = IssueSchema.safeParse(row);
-            if (!parsed.success) {
-                throw new Error(`invalid issue row ${idx}: ${parsed.error.message}`);
+        return rows.map((row, idx) => this.#parseIssueRow(row, idx));
+    }
+    async *#streamRows() {
+        if (this.#issues.stream) {
+            let idx = 0;
+            for await (const row of this.#issues.stream()) {
+                yield this.#parseIssueRow(row, idx);
+                idx += 1;
             }
-            return parsed.data;
-        });
+            return;
+        }
+        const rows = await this.#issues.read();
+        for (let idx = 0; idx < rows.length; idx += 1) {
+            yield this.#parseIssueRow(rows[idx], idx);
+        }
     }
     async #save(rows) {
         await this.#issues.write(rows);
@@ -82,9 +102,7 @@ export class IssueStore {
             updated_at: now,
         };
         const issue = IssueSchema.parse(issueInput);
-        const rows = await this.#load();
-        rows.push(issue);
-        await this.#save(rows);
+        await this.#issues.append(issue);
         await this.events.emit("issue.create", {
             source: "issue_store",
             issueId: issue.id,
@@ -98,20 +116,52 @@ export class IssueStore {
         return idx >= 0 ? rows[idx] : null;
     }
     async list(opts = {}) {
+        const status = normalizeIssueStatusFilter(opts.status);
+        const tag = normalizeIssueTagFilter(opts.tag);
+        const contains = normalizeIssueContainsFilter(opts.contains);
+        const limit = normalizeIssueQueryLimit(opts.limit, { defaultLimit: null });
+        if (limit != null && this.#issues.stream) {
+            const bounded = [];
+            for await (const row of this.#streamRows()) {
+                if (status && row.status !== status) {
+                    continue;
+                }
+                if (tag && !row.tags.includes(tag)) {
+                    continue;
+                }
+                if (contains && !issueContainsText(row, contains)) {
+                    continue;
+                }
+                bounded.push(row);
+                if (bounded.length > limit) {
+                    bounded.shift();
+                }
+            }
+            return bounded;
+        }
         let rows = await this.#load();
-        if (opts.status) {
-            rows = rows.filter((row) => row.status === opts.status);
+        if (status) {
+            rows = rows.filter((row) => row.status === status);
+        }
+        if (tag) {
+            rows = rows.filter((row) => row.tags.includes(tag));
         }
-        if (opts.tag) {
-            rows = rows.filter((row) => row.tags.includes(opts.tag));
+        if (contains) {
+            rows = rows.filter((row) => issueContainsText(row, contains));
+        }
+        if (limit != null) {
+            rows = rows.slice(-limit);
         }
         return rows;
     }
     async update(issueId, fields) {
+        if (!fields || typeof fields !== "object" || Array.isArray(fields)) {
+            throw new IssueStoreValidationError("update fields must be an object");
+        }
         const rows = await this.#load();
         const idx = this.#findIndex(rows, issueId);
         if (idx < 0) {
-            throw new Error(issueId);
+            throw new IssueStoreNotFoundError(issueId);
         }
         const issueBefore = rows[idx];
         const before = JSON.parse(JSON.stringify(issueBefore));
@@ -221,35 +271,51 @@ export class IssueStore {
         return reset;
     }
     async add_dep(srcId, depType, dstId) {
+        const normalizedSrcId = srcId.trim();
+        if (normalizedSrcId.length === 0) {
+            throw new IssueStoreValidationError("source issue id is required");
+        }
+        const normalizedDep = normalizeIssueDepInput({ depType, target: dstId });
+        if (normalizedDep.target === normalizedSrcId) {
+            throw new IssueStoreValidationError("dependency target cannot equal source issue id");
+        }
         const rows = await this.#load();
-        const idx = this.#findIndex(rows, srcId);
+        const idx = this.#findIndex(rows, normalizedSrcId);
         if (idx < 0) {
-            throw new Error(srcId);
+            throw new IssueStoreNotFoundError(normalizedSrcId);
+        }
+        if (this.#findIndex(rows, normalizedDep.target) < 0) {
+            throw new IssueStoreNotFoundError(normalizedDep.target);
         }
         const issue = rows[idx];
-        const exists = issue.deps.some((dep) => dep.type === depType && dep.target === dstId);
+        const exists = issue.deps.some((dep) => dep.type === normalizedDep.depType && dep.target === normalizedDep.target);
         if (exists) {
             return;
         }
-        issue.deps.push({ type: depType, target: dstId });
+        issue.deps.push({ type: normalizedDep.depType, target: normalizedDep.target });
         issue.updated_at = nowTs();
         rows[idx] = IssueSchema.parse(issue);
         await this.#save(rows);
         await this.events.emit("issue.dep.add", {
             source: "issue_store",
-            issueId: srcId,
-            payload: { type: depType, target: dstId },
+            issueId: normalizedSrcId,
+            payload: { type: normalizedDep.depType, target: normalizedDep.target },
         });
     }
     async remove_dep(srcId, depType, dstId) {
+        const normalizedSrcId = srcId.trim();
+        if (normalizedSrcId.length === 0) {
+            throw new IssueStoreValidationError("source issue id is required");
+        }
+        const normalizedDep = normalizeIssueDepInput({ depType, target: dstId });
         const rows = await this.#load();
-        const idx = this.#findIndex(rows, srcId);
+        const idx = this.#findIndex(rows, normalizedSrcId);
         if (idx < 0) {
-            throw new Error(srcId);
+            throw new IssueStoreNotFoundError(normalizedSrcId);
         }
         const issue = rows[idx];
         const before = issue.deps.length;
-        issue.deps = issue.deps.filter((dep) => !(dep.type === depType && dep.target === dstId));
+        issue.deps = issue.deps.filter((dep) => !(dep.type === normalizedDep.depType && dep.target === normalizedDep.target));
         const changed = issue.deps.length !== before;
         if (changed) {
             issue.updated_at = nowTs();
@@ -258,8 +324,8 @@ export class IssueStore {
         }
         await this.events.emit("issue.dep.remove", {
             source: "issue_store",
-            issueId: srcId,
-            payload: { type: depType, target: dstId, ok: changed },
+            issueId: normalizedSrcId,
+            payload: { type: normalizedDep.depType, target: normalizedDep.target, ok: changed },
         });
         return changed;
     }
@@ -277,8 +343,17 @@ export class IssueStore {
     async ready(rootId = null, opts = {}) {
         const rows = await this.#load();
         const tags = opts.tags ?? undefined;
+        const contains = normalizeIssueContainsFilter(opts.contains);
+        const limit = normalizeIssueQueryLimit(opts.limit, { defaultLimit: null });
         const root_id = rootId ?? undefined;
-        return readyLeaves(rows, { root_id, tags: tags ?? undefined });
+        let ready = readyLeaves(rows, { root_id, tags: tags ?? undefined });
+        if (contains) {
+            ready = ready.filter((issue) => issueContainsText(issue, contains));
+        }
+        if (limit != null) {
+            ready = ready.slice(0, limit);
+        }
+        return ready;
     }
     async collapsible(rootId) {
         const rows = await this.#load();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@femtomc/mu-issue",
-  "version": "26.2.69",
+  "version": "26.2.70",
   "description": "Work item store with dependency graph helpers for mu.",
   "keywords": [
     "mu",
@@ -22,6 +22,6 @@
     "dist/**"
   ],
   "dependencies": {
-    "@femtomc/mu-core": "26.2.69"
+    "@femtomc/mu-core": "26.2.70"
   }
 }