@agent-plan/core 0.2.19-next.13 → 0.2.19-next.14

package/dist/checklist.d.ts

@@ -0,0 +1,16 @@
+import type { ChecklistItem } from "./schema.js";
+/**
+ * Granular per-task checklist helpers. Each item has a stable unique `id`
+ * (the robust handle for add/remove/toggle) plus a progressive `number`
+ * (C1..Cn display label, renumbered on remove for readability). Selectors
+ * accept C{n} (e.g. C2), the item id, or a title (case-insensitive, first
+ * exact then partial match).
+ */
+export declare function findChecklistItem(items: ChecklistItem[], selector: string): ChecklistItem | undefined;
+/** Append a new item. number = max(existing)+1 (stable, never reused). Mutates nothing; returns the new item. */
+export declare function addChecklistItem(items: ChecklistItem[], taskId: string, title: string): ChecklistItem;
+/** Remove the matched item in place (splice) and renumber the rest 1..n. Returns the removed item, or undefined. */
+export declare function removeChecklistItem(items: ChecklistItem[], selector: string): ChecklistItem | undefined;
+/** Tick/untick the matched item in place. checked omitted → toggle. Returns the item, or undefined. */
+export declare function toggleChecklistItem(items: ChecklistItem[], selector: string, checked?: boolean): ChecklistItem | undefined;
+//# sourceMappingURL=checklist.d.ts.map

package/dist/checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist.d.ts","sourceRoot":"","sources":["../src/checklist.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;GAMG;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAerG;AAED,iHAAiH;AACjH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAKrG;AAED,oHAAoH;AACpH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CASvG;AAED,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAK1H"}

package/dist/checklist.js

@@ -0,0 +1,52 @@
+import { createChecklistItemId } from "./naming.js";
+/**
+ * Granular per-task checklist helpers. Each item has a stable unique `id`
+ * (the robust handle for add/remove/toggle) plus a progressive `number`
+ * (C1..Cn display label, renumbered on remove for readability). Selectors
+ * accept C{n} (e.g. C2), the item id, or a title (case-insensitive, first
+ * exact then partial match).
+ */
+export function findChecklistItem(items, selector) {
+    const s = selector.trim();
+    if (!s)
+        return undefined;
+    const cMatch = /^C(\d+)$/i.exec(s);
+    if (cMatch) {
+        const n = parseInt(cMatch[1], 10);
+        return items.find((i) => i.number === n);
+    }
+    const byId = items.find((i) => i.id === s);
+    if (byId)
+        return byId;
+    const needle = s.toLowerCase();
+    return (items.find((i) => i.title.trim().toLowerCase() === needle) ??
+        items.find((i) => i.title.trim().toLowerCase().includes(needle)));
+}
+/** Append a new item. number = max(existing)+1 (stable, never reused). Mutates nothing; returns the new item. */
+export function addChecklistItem(items, taskId, title) {
+    const clean = title.trim();
+    const number = items.length === 0 ? 1 : Math.max(...items.map((i) => i.number)) + 1;
+    const id = createChecklistItemId(taskId, number, clean);
+    return { id, number, title: clean, checked: false };
+}
+/** Remove the matched item in place (splice) and renumber the rest 1..n. Returns the removed item, or undefined. */
+export function removeChecklistItem(items, selector) {
+    const found = findChecklistItem(items, selector);
+    if (!found)
+        return undefined;
+    const idx = items.findIndex((i) => i.id === found.id);
+    if (idx >= 0)
+        items.splice(idx, 1);
+    items.forEach((i, n) => {
+        i.number = n + 1;
+    });
+    return found;
+}
+/** Tick/untick the matched item in place. checked omitted → toggle. Returns the item, or undefined. */
+export function toggleChecklistItem(items, selector, checked) {
+    const found = findChecklistItem(items, selector);
+    if (!found)
+        return undefined;
+    found.checked = checked ?? !found.checked;
+    return found;
+}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./naming.js";
 export * from "./refs.js";
 export * from "./schema.js";
+export * from "./checklist.js";
 export * from "./recap.js";
 export { PlanStore, PlanStoreError, setWriteBusyHook, setWriteNotifyHook, migrateToUuids, migrateToGlobalSequence, withFeatureLock, type PhaseHandoffSummary } from "./plan-store.js";
 export { PlanRenderer } from "./renderer.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,uBAAuB,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtL,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,uBAAuB,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtL,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from "./naming.js";
 export * from "./refs.js";
 export * from "./schema.js";
+export * from "./checklist.js";
 export * from "./recap.js";
 export { PlanStore, PlanStoreError, setWriteBusyHook, setWriteNotifyHook, migrateToUuids, migrateToGlobalSequence, withFeatureLock } from "./plan-store.js";
 export { PlanRenderer } from "./renderer.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-plan/core",
-  "version": "0.2.19-next.13",
+  "version": "0.2.19-next.14",
   "private": false,
   "description": "Harness-agnostic core for Agent Plan: schemas, persistence, ordering, status rollups, and markdown rendering.",
   "license": "MIT",