@mclawnet/task 0.1.0

package/dist/briefings/compute-lead.d.ts

@@ -0,0 +1,17 @@
+import type { TaskStore } from "../store.js";
+import type { LeadBriefingBody } from "./format-lead.js";
+/**
+ * Compute the queen-facing situation summary body for a swarm.
+ *
+ * Pure-ish: reads from TaskStore, no mutations. Mirrors the bucket logic that
+ * previously lived inline in `handleLeadBriefing` (mcp-server). Caller is
+ * responsible for resolving `queenInstanceId` (e.g. via recovery.json on the
+ * MCP side, or via the live coordinator on the swarm side); pass `null` when
+ * the queen cannot be identified — `lead_owned` will then be empty.
+ *
+ * Phase-1 simplifications retained:
+ *   - `assign_reviewer` is always [] (no reviewer field in schema).
+ *   - `clarify` uses the "?" heuristic on the latest comment.
+ */
+export declare function computeLeadBriefing(store: TaskStore, swarmId: string, queenInstanceId: string | null): LeadBriefingBody;
+//# sourceMappingURL=compute-lead.d.ts.map

package/dist/briefings/compute-lead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-lead.d.ts","sourceRoot":"","sources":["../../src/briefings/compute-lead.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,gBAAgB,CA0ClB"}

package/dist/briefings/compute-lead.js

@@ -0,0 +1,52 @@
+import { classifyBlockers } from "../dag.js";
+/**
+ * Compute the queen-facing situation summary body for a swarm.
+ *
+ * Pure-ish: reads from TaskStore, no mutations. Mirrors the bucket logic that
+ * previously lived inline in `handleLeadBriefing` (mcp-server). Caller is
+ * responsible for resolving `queenInstanceId` (e.g. via recovery.json on the
+ * MCP side, or via the live coordinator on the swarm side); pass `null` when
+ * the queen cannot be identified — `lead_owned` will then be empty.
+ *
+ * Phase-1 simplifications retained:
+ *   - `assign_reviewer` is always [] (no reviewer field in schema).
+ *   - `clarify` uses the "?" heuristic on the latest comment.
+ */
+export function computeLeadBriefing(store, swarmId, queenInstanceId) {
+    const tasks = store
+        .list()
+        .map((e) => store.tryGet(e.id))
+        .filter((t) => t !== null)
+        .filter((t) => t.swarmId === swarmId);
+    const assignOwner = [];
+    const assignReviewer = []; // Phase 1: always empty.
+    const clarify = [];
+    const repairDependencies = [];
+    const leadOwned = [];
+    for (const t of tasks) {
+        if (t.status === "pending" && t.owner === null) {
+            assignOwner.push(t);
+        }
+        if (t.comments.length > 0) {
+            const latest = t.comments[t.comments.length - 1];
+            if (latest.body.includes("?")) {
+                clarify.push(t);
+            }
+        }
+        const classification = classifyBlockers(t, store);
+        if (classification.broken.length > 0) {
+            repairDependencies.push(t);
+        }
+        if (queenInstanceId !== null && t.owner === queenInstanceId) {
+            leadOwned.push(t);
+        }
+    }
+    return {
+        assign_owner: assignOwner,
+        assign_reviewer: assignReviewer,
+        clarify,
+        repair_dependencies: repairDependencies,
+        lead_owned: leadOwned,
+    };
+}
+//# sourceMappingURL=compute-lead.js.map

package/dist/briefings/compute-lead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-lead.js","sourceRoot":"","sources":["../../src/briefings/compute-lead.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAgB,EAChB,OAAe,EACf,eAA8B;IAE9B,MAAM,KAAK,GAAG,KAAK;SAChB,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAa,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;SACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAExC,MAAM,WAAW,GAAW,EAAE,CAAC;IAC/B,MAAM,cAAc,GAAW,EAAE,CAAC,CAAC,yBAAyB;IAC5D,MAAM,OAAO,GAAW,EAAE,CAAC;IAC3B,MAAM,kBAAkB,GAAW,EAAE,CAAC;IACtC,MAAM,SAAS,GAAW,EAAE,CAAC;IAE7B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC/C,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACjD,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,MAAM,cAAc,GAAG,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAClD,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,eAAe,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,eAAe,EAAE,CAAC;YAC5D,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO;QACL,YAAY,EAAE,WAAW;QACzB,eAAe,EAAE,cAAc;QAC/B,OAAO;QACP,mBAAmB,EAAE,kBAAkB;QACvC,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC"}

package/dist/briefings/compute-member.d.ts

@@ -0,0 +1,12 @@
+import type { MemberBriefingBody } from "./format-member.js";
+export interface ComputeMemberBriefingArgs {
+    swarmId: string;
+    instanceId: string;
+    /** "queen" produces queen-flavoured rules; anything else is treated as a worker. */
+    roleType: string;
+}
+/**
+ * Build the member briefing body. Pure: no I/O, no side effects.
+ */
+export declare function computeMemberBriefing(args: ComputeMemberBriefingArgs): MemberBriefingBody;
+//# sourceMappingURL=compute-member.d.ts.map

package/dist/briefings/compute-member.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-member.d.ts","sourceRoot":"","sources":["../../src/briefings/compute-member.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAsBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,GAAG,kBAAkB,CAOzF"}

package/dist/briefings/compute-member.js

@@ -0,0 +1,30 @@
+/**
+ * Hardcoded boot rules for queen vs. worker. Verbatim from the previous
+ * `handleMemberBriefing` body so the JSON shape is byte-identical.
+ */
+const QUEEN_RULES = [
+    "每次开始一项工作前先调用 lead_briefing 查看 assign_owner / repair_dependencies / clarify 等桶。",
+    "通过 task_set_owner 给 pending 任务分配 owner，通过 task_link/task_unlink 维护依赖图。",
+    "状态变更必须用 task_set_status，不要直接 mutate task 文件。",
+    "需要补充上下文或决策时，使用 task_add_comment 记录。",
+    "跨角色沟通走 message_send，不要直接 mutate 别人的 task。",
+];
+const WORKER_RULES = [
+    "每次开始一项工作前先调用 task_briefing 查看 actionable 列表。",
+    "接到 inbox 消息后，必要时通过 task_create_from_message 派生新 task。",
+    "状态变更必须用 task_set_status，不要直接 mutate task 文件。",
+    "完成或进展评论使用 task_add_comment 记录。",
+    "跨角色沟通走 message_send，不要直接 mutate 别人的 task。",
+];
+/**
+ * Build the member briefing body. Pure: no I/O, no side effects.
+ */
+export function computeMemberBriefing(args) {
+    const { swarmId, instanceId, roleType } = args;
+    const rules = roleType === "queen" ? [...QUEEN_RULES] : [...WORKER_RULES];
+    return {
+        rules,
+        bootstrap: { swarmId, instanceId, roleType },
+    };
+}
+//# sourceMappingURL=compute-member.js.map

package/dist/briefings/compute-member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-member.js","sourceRoot":"","sources":["../../src/briefings/compute-member.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,WAAW,GAAsB;IACrC,gFAAgF;IAChF,wEAAwE;IACxE,8CAA8C;IAC9C,qCAAqC;IACrC,2CAA2C;CACnC,CAAC;AAEX,MAAM,YAAY,GAAsB;IACtC,8CAA8C;IAC9C,uDAAuD;IACvD,8CAA8C;IAC9C,gCAAgC;IAChC,2CAA2C;CACnC,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA+B;IACnE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC/C,MAAM,KAAK,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC;IAC1E,OAAO;QACL,KAAK;QACL,SAAS,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE;KAC7C,CAAC;AACJ,CAAC"}

package/dist/briefings/compute-task.d.ts

@@ -0,0 +1,17 @@
+import type { TaskStore } from "../store.js";
+import type { TaskBriefingBody } from "./format-task.js";
+/**
+ * Compute the per-instance task briefing body for a swarm.
+ *
+ * Pure-ish: reads from the TaskStore (filesystem-backed) but performs no
+ * mutations. Mirrors the bucket-classification logic that previously lived
+ * inline in `handleTaskBriefing` (mcp-server). Used by both the MCP handler
+ * and `SwarmCoordinator.spawnRole` boot-time injection.
+ *
+ * Simplifications inherited from Phase 1 schema:
+ *   - No `priority` field, so actionable is sorted by createdAt asc only.
+ *   - No `reviewer` field, so awareness only checks waiting-deps.
+ *   - Warnings cover broken deps + orphaned in_progress.
+ */
+export declare function computeTaskBriefing(store: TaskStore, swarmId: string, instanceId: string): TaskBriefingBody;
+//# sourceMappingURL=compute-task.d.ts.map

package/dist/briefings/compute-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-task.d.ts","sourceRoot":"","sources":["../../src/briefings/compute-task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,gBAAgB,CAoDlB"}

package/dist/briefings/compute-task.js

@@ -0,0 +1,60 @@
+import { classifyBlockers } from "../dag.js";
+/**
+ * Compute the per-instance task briefing body for a swarm.
+ *
+ * Pure-ish: reads from the TaskStore (filesystem-backed) but performs no
+ * mutations. Mirrors the bucket-classification logic that previously lived
+ * inline in `handleTaskBriefing` (mcp-server). Used by both the MCP handler
+ * and `SwarmCoordinator.spawnRole` boot-time injection.
+ *
+ * Simplifications inherited from Phase 1 schema:
+ *   - No `priority` field, so actionable is sorted by createdAt asc only.
+ *   - No `reviewer` field, so awareness only checks waiting-deps.
+ *   - Warnings cover broken deps + orphaned in_progress.
+ */
+export function computeTaskBriefing(store, swarmId, instanceId) {
+    const all = store
+        .list()
+        .map((e) => store.tryGet(e.id))
+        .filter((t) => t !== null)
+        .filter((t) => t.swarmId === swarmId);
+    const actionable = [];
+    const awareness = [];
+    let blocked = 0;
+    let waitingOnUser = 0;
+    const warnings = [];
+    for (const t of all) {
+        const classification = classifyBlockers(t, store);
+        if (classification.broken.length > 0) {
+            warnings.push(`broken-deps: task ${t.id} has cancelled/missing dependencies [${classification.broken.join(", ")}]`);
+        }
+        if (t.status === "in_progress" && t.owner === null) {
+            warnings.push(`orphaned in_progress: task ${t.id} is in_progress but has no owner`);
+        }
+        if (classification.isBlocked)
+            blocked++;
+        if (t.owner !== instanceId)
+            continue;
+        const ownedActive = t.status === "pending" || t.status === "in_progress";
+        if (ownedActive && !classification.isBlocked) {
+            actionable.push(t);
+        }
+        if (classification.waiting.length > 0) {
+            awareness.push(t);
+            waitingOnUser++;
+        }
+    }
+    actionable.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    return {
+        actionable,
+        awareness,
+        counters: {
+            actionable: actionable.length,
+            awareness: awareness.length,
+            blocked,
+            waitingOnUser,
+        },
+        warnings,
+    };
+}
+//# sourceMappingURL=compute-task.js.map

package/dist/briefings/compute-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-task.js","sourceRoot":"","sources":["../../src/briefings/compute-task.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAgB,EAChB,OAAe,EACf,UAAkB;IAElB,MAAM,GAAG,GAAG,KAAK;SACd,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAa,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;SACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAExC,MAAM,UAAU,GAAW,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAW,EAAE,CAAC;IAC7B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,MAAM,cAAc,GAAG,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAElD,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,QAAQ,CAAC,IAAI,CACX,qBAAqB,CAAC,CAAC,EAAE,wCAAwC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACnD,QAAQ,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,EAAE,kCAAkC,CAAC,CAAC;QACtF,CAAC;QAED,IAAI,cAAc,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAExC,IAAI,CAAC,CAAC,KAAK,KAAK,UAAU;YAAE,SAAS;QAErC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC;QACzE,IAAI,WAAW,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;YAC7C,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,cAAc,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,aAAa,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAElE,OAAO;QACL,UAAU;QACV,SAAS;QACT,QAAQ,EAAE;YACR,UAAU,EAAE,UAAU,CAAC,MAAM;YAC7B,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,OAAO;YACP,aAAa;SACd;QACD,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/briefings/format-lead.d.ts

@@ -0,0 +1,19 @@
+import type { Task } from "../schema.js";
+export interface LeadBriefingBody {
+    assign_owner: Task[];
+    /**
+     * v1: always [] from handleLeadBriefing (reviewer field does not exist yet).
+     * Kept in the type for forward compatibility, but intentionally NOT rendered
+     * even if populated — see renderer below.
+     */
+    assign_reviewer: Task[];
+    clarify: Task[];
+    repair_dependencies: Task[];
+    lead_owned: Task[];
+}
+export interface FormatLeadBriefingOpts {
+    /** Max items per bucket. Default 10. */
+    maxItems?: number;
+}
+export declare function formatLeadBriefing(body: LeadBriefingBody, opts?: FormatLeadBriefingOpts): string;
+//# sourceMappingURL=format-lead.d.ts.map

package/dist/briefings/format-lead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-lead.d.ts","sourceRoot":"","sources":["../../src/briefings/format-lead.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,IAAI,EAAE,CAAC;IACrB;;;;OAIG;IACH,eAAe,EAAE,IAAI,EAAE,CAAC;IACxB,OAAO,EAAE,IAAI,EAAE,CAAC;IAChB,mBAAmB,EAAE,IAAI,EAAE,CAAC;IAC5B,UAAU,EAAE,IAAI,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAwChG"}

package/dist/briefings/format-lead.js

@@ -0,0 +1,47 @@
+const DEFAULT_MAX = 10;
+export function formatLeadBriefing(body, opts) {
+    const maxItems = opts?.maxItems ?? DEFAULT_MAX;
+    const { assign_owner, clarify, repair_dependencies, lead_owned } = body;
+    // assign_reviewer is intentionally excluded from emptiness check & rendering:
+    // v1 has no reviewer concept, so the bucket is always empty in practice.
+    // Skipping it (rather than rendering an empty bucket) keeps the briefing tight.
+    const isEmpty = assign_owner.length === 0 &&
+        clarify.length === 0 &&
+        repair_dependencies.length === 0 &&
+        lead_owned.length === 0;
+    if (isEmpty) {
+        return "### Queen 简报: 当前无待处理事项";
+    }
+    const lines = [];
+    lines.push("### Queen 简报");
+    lines.push("");
+    if (assign_owner.length > 0) {
+        renderBucket(lines, "待指派 owner", assign_owner, maxItems);
+    }
+    if (clarify.length > 0) {
+        renderBucket(lines, "待澄清", clarify, maxItems);
+    }
+    if (repair_dependencies.length > 0) {
+        renderBucket(lines, "待修复依赖", repair_dependencies, maxItems);
+    }
+    if (lead_owned.length > 0) {
+        renderBucket(lines, "Queen 自持", lead_owned, maxItems);
+    }
+    // Trailing blank line from last renderBucket — trim it.
+    while (lines.length > 0 && lines[lines.length - 1] === "") {
+        lines.pop();
+    }
+    return lines.join("\n");
+}
+function renderBucket(out, title, items, maxItems) {
+    out.push(`**${title} (${items.length})**`);
+    const shown = items.slice(0, maxItems);
+    for (const t of shown) {
+        out.push(`- ${t.id} ${t.subject}`);
+    }
+    if (items.length > maxItems) {
+        out.push(`- (还有 ${items.length - maxItems} 项被截断)`);
+    }
+    out.push("");
+}
+//# sourceMappingURL=format-lead.js.map

package/dist/briefings/format-lead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-lead.js","sourceRoot":"","sources":["../../src/briefings/format-lead.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,MAAM,UAAU,kBAAkB,CAAC,IAAsB,EAAE,IAA6B;IACtF,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,WAAW,CAAC;IAC/C,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAExE,8EAA8E;IAC9E,yEAAyE;IACzE,gFAAgF;IAChF,MAAM,OAAO,GACX,YAAY,CAAC,MAAM,KAAK,CAAC;QACzB,OAAO,CAAC,MAAM,KAAK,CAAC;QACpB,mBAAmB,CAAC,MAAM,KAAK,CAAC;QAChC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;IAE1B,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED,wDAAwD;IACxD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC1D,KAAK,CAAC,GAAG,EAAE,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,GAAa,EAAE,KAAa,EAAE,KAAa,EAAE,QAAgB;IACjF,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,GAAG,QAAQ,QAAQ,CAAC,CAAC;IACrD,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACf,CAAC"}

package/dist/briefings/format-member.d.ts

@@ -0,0 +1,18 @@
+export interface MemberBriefingBody {
+    rules: string[];
+    bootstrap: {
+        swarmId: string;
+        instanceId: string;
+        /** "queen" | "worker" today; left as string for forward-compat. */
+        roleType: string;
+    };
+}
+/**
+ * Render a member briefing as markdown. Pure, no I/O.
+ *
+ * Note: bootstrap.swarmId is intentionally NOT rendered — instanceId + roleType
+ * in the header is sufficient context for a per-role prompt; swarmId would just
+ * be noise.
+ */
+export declare function formatMemberBriefing(body: MemberBriefingBody): string;
+//# sourceMappingURL=format-member.d.ts.map

package/dist/briefings/format-member.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-member.d.ts","sourceRoot":"","sources":["../../src/briefings/format-member.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,mEAAmE;QACnE,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAcrE"}

package/dist/briefings/format-member.js

@@ -0,0 +1,24 @@
+/**
+ * Render a member briefing as markdown. Pure, no I/O.
+ *
+ * Note: bootstrap.swarmId is intentionally NOT rendered — instanceId + roleType
+ * in the header is sufficient context for a per-role prompt; swarmId would just
+ * be noise.
+ */
+export function formatMemberBriefing(body) {
+    const { rules, bootstrap } = body;
+    const lines = [];
+    lines.push(`### 成员引导 (${bootstrap.instanceId} · ${bootstrap.roleType})`);
+    lines.push("");
+    lines.push("**启动规则**");
+    if (rules.length === 0) {
+        lines.push("_(无)_");
+    }
+    else {
+        rules.forEach((rule, idx) => {
+            lines.push(`${idx + 1}. ${rule}`);
+        });
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=format-member.js.map

package/dist/briefings/format-member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-member.js","sourceRoot":"","sources":["../../src/briefings/format-member.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAC3D,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,UAAU,MAAM,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC;IACzE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/briefings/format-task.d.ts

@@ -0,0 +1,19 @@
+import type { Task } from "../schema.js";
+export interface TaskBriefingBody {
+    actionable: Task[];
+    awareness: Task[];
+    counters: {
+        actionable: number;
+        awareness: number;
+        blocked: number;
+        waitingOnUser: number;
+    };
+    warnings: string[];
+}
+export interface FormatTaskBriefingOpts {
+    instanceId?: string;
+    /** Max items per bucket. Default 10. */
+    maxItems?: number;
+}
+export declare function formatTaskBriefing(body: TaskBriefingBody, opts?: FormatTaskBriefingOpts): string;
+//# sourceMappingURL=format-task.d.ts.map

package/dist/briefings/format-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-task.d.ts","sourceRoot":"","sources":["../../src/briefings/format-task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,IAAI,EAAE,CAAC;IACnB,SAAS,EAAE,IAAI,EAAE,CAAC;IAClB,QAAQ,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5F,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,MAAM,CA6ChG"}

package/dist/briefings/format-task.js

@@ -0,0 +1,48 @@
+const DEFAULT_MAX = 10;
+export function formatTaskBriefing(body, opts) {
+    const maxItems = opts?.maxItems ?? DEFAULT_MAX;
+    const { actionable, awareness, counters, warnings } = body;
+    const isEmpty = actionable.length === 0 &&
+        awareness.length === 0 &&
+        counters.actionable === 0 &&
+        counters.awareness === 0 &&
+        counters.blocked === 0 &&
+        counters.waitingOnUser === 0 &&
+        warnings.length === 0;
+    if (isEmpty) {
+        return "### 你的任务简报: 暂无任务";
+    }
+    const lines = [];
+    const headerSuffix = opts?.instanceId ? ` (${opts.instanceId})` : "";
+    lines.push(`### 你的任务简报${headerSuffix}`);
+    lines.push("");
+    if (actionable.length > 0) {
+        renderBucket(lines, "可执行", actionable, maxItems, (t) => `- ${t.id} [${t.status}] ${t.subject}`);
+    }
+    if (awareness.length > 0) {
+        // NOTE: kept pure (no store). A richer "waiting on {ids}" rendering can be
+        // added later once a store handle is plumbed through.
+        renderBucket(lines, "需关注", awareness, maxItems, (t) => `- ${t.id} ${t.subject}`);
+    }
+    lines.push(`**计数**: actionable=${counters.actionable} awareness=${counters.awareness} blocked=${counters.blocked} waitingOnUser=${counters.waitingOnUser}`);
+    if (warnings.length > 0) {
+        lines.push("");
+        lines.push("**警告**:");
+        for (const w of warnings) {
+            lines.push(`- ${w}`);
+        }
+    }
+    return lines.join("\n");
+}
+function renderBucket(out, title, items, maxItems, render) {
+    out.push(`**${title} (${items.length})**`);
+    const shown = items.slice(0, maxItems);
+    for (const t of shown) {
+        out.push(render(t));
+    }
+    if (items.length > maxItems) {
+        out.push(`- (还有 ${items.length - maxItems} 项被截断)`);
+    }
+    out.push("");
+}
+//# sourceMappingURL=format-task.js.map

package/dist/briefings/format-task.js.map

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

package/dist/dag.d.ts

@@ -0,0 +1,10 @@
+import { Task } from "./schema.js";
+import { TaskStore } from "./store.js";
+export interface BlockerClassification {
+    broken: string[];
+    waiting: string[];
+    isBlocked: boolean;
+}
+export declare function classifyBlockers(task: Task, store: TaskStore): BlockerClassification;
+export declare function wouldCreateCycle(store: TaskStore, fromId: string, toId: string): boolean;
+//# sourceMappingURL=dag.d.ts.map

package/dist/dag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../src/dag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,qBAAqB,CAYpF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAaxF"}

package/dist/dag.js

@@ -0,0 +1,33 @@
+export function classifyBlockers(task, store) {
+    const broken = [];
+    const waiting = [];
+    for (const depId of task.blockedBy) {
+        const dep = store.tryGet(depId);
+        if (!dep || dep.status === "cancelled") {
+            broken.push(depId);
+        }
+        else if (dep.status !== "completed") {
+            waiting.push(depId);
+        }
+    }
+    return { broken, waiting, isBlocked: broken.length + waiting.length > 0 };
+}
+export function wouldCreateCycle(store, fromId, toId) {
+    if (fromId === toId)
+        return true;
+    const visited = new Set();
+    const stack = [toId];
+    while (stack.length) {
+        const cur = stack.pop();
+        if (cur === fromId)
+            return true;
+        if (visited.has(cur))
+            continue;
+        visited.add(cur);
+        const t = store.tryGet(cur);
+        if (t)
+            stack.push(...t.blocks);
+    }
+    return false;
+}
+//# sourceMappingURL=dag.js.map

package/dist/dag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.js","sourceRoot":"","sources":["../src/dag.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,gBAAgB,CAAC,IAAU,EAAE,KAAgB;IAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAgB,EAAE,MAAc,EAAE,IAAY;IAC7E,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAa,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QACzB,IAAI,GAAG,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./schema.js";
+export * from "./path.js";
+export * from "./meta.js";
+export * from "./locking.js";
+export * from "./store.js";
+export * from "./dag.js";
+export { formatTaskBriefing } from "./briefings/format-task.js";
+export type { TaskBriefingBody, FormatTaskBriefingOpts } from "./briefings/format-task.js";
+export { formatLeadBriefing } from "./briefings/format-lead.js";
+export type { LeadBriefingBody, FormatLeadBriefingOpts } from "./briefings/format-lead.js";
+export { formatMemberBriefing } from "./briefings/format-member.js";
+export type { MemberBriefingBody } from "./briefings/format-member.js";
+export { computeTaskBriefing } from "./briefings/compute-task.js";
+export { computeLeadBriefing } from "./briefings/compute-lead.js";
+export { computeMemberBriefing } from "./briefings/compute-member.js";
+export type { ComputeMemberBriefingArgs } from "./briefings/compute-member.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from "./schema.js";
+export * from "./path.js";
+export * from "./meta.js";
+export * from "./locking.js";
+export * from "./store.js";
+export * from "./dag.js";
+export { formatTaskBriefing } from "./briefings/format-task.js";
+export { formatLeadBriefing } from "./briefings/format-lead.js";
+export { formatMemberBriefing } from "./briefings/format-member.js";
+export { computeTaskBriefing } from "./briefings/compute-task.js";
+export { computeLeadBriefing } from "./briefings/compute-lead.js";
+export { computeMemberBriefing } from "./briefings/compute-member.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/locking.d.ts

@@ -0,0 +1,8 @@
+export interface WithLockOptions {
+    retries?: number;
+    minTimeout?: number;
+    maxTimeout?: number;
+    staleMs?: number;
+}
+export declare function withLock<T>(filePath: string, fn: () => Promise<T>, opts?: WithLockOptions): Promise<T>;
+//# sourceMappingURL=locking.d.ts.map

package/dist/locking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locking.d.ts","sourceRoot":"","sources":["../src/locking.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,CAAC,CAAC,CAeZ"}

package/dist/locking.js

@@ -0,0 +1,19 @@
+import lockfile from "proper-lockfile";
+export async function withLock(filePath, fn, opts = {}) {
+    const release = await lockfile.lock(filePath, {
+        retries: {
+            retries: opts.retries ?? 20,
+            minTimeout: opts.minTimeout ?? 20,
+            maxTimeout: opts.maxTimeout ?? 200,
+        },
+        stale: opts.staleMs ?? 10_000,
+        realpath: false,
+    });
+    try {
+        return await fn();
+    }
+    finally {
+        await release();
+    }
+}
+//# sourceMappingURL=locking.js.map

package/dist/locking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locking.js","sourceRoot":"","sources":["../src/locking.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AASvC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAgB,EAChB,EAAoB,EACpB,OAAwB,EAAE;IAE1B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE;QAC5C,OAAO,EAAE;YACP,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,GAAG;SACnC;QACD,KAAK,EAAE,IAAI,CAAC,OAAO,IAAI,MAAM;QAC7B,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/meta.d.ts

@@ -0,0 +1,21 @@
+export interface ProjectMeta {
+    version: 1;
+    workDir: string;
+    createdAt: string;
+    [extra: string]: unknown;
+}
+/**
+ * Ensure `<projectRoot>/meta.json` exists for the given workDir.
+ *
+ * - Idempotent: if the file already exists and parses as JSON, it is left
+ *   untouched (preserves `createdAt` and any unrelated fields written by
+ *   other tools).
+ * - On a fresh project, writes `{version: 1, workDir, createdAt: <ISO now>}`.
+ * - On a parse failure, the corrupt file is overwritten with a fresh meta —
+ *   we prefer "project visible to hub" over preserving unreadable garbage.
+ *
+ * Safe to call from constructors / hot paths: a single `existsSync` short-circuit
+ * avoids any disk write on the steady-state path.
+ */
+export declare function ensureProjectMeta(workDir: string, home?: string): void;
+//# sourceMappingURL=meta.d.ts.map

package/dist/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAmBtE"}

package/dist/meta.js

@@ -0,0 +1,37 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { projectRoot, metaFile } from "./path.js";
+/**
+ * Ensure `<projectRoot>/meta.json` exists for the given workDir.
+ *
+ * - Idempotent: if the file already exists and parses as JSON, it is left
+ *   untouched (preserves `createdAt` and any unrelated fields written by
+ *   other tools).
+ * - On a fresh project, writes `{version: 1, workDir, createdAt: <ISO now>}`.
+ * - On a parse failure, the corrupt file is overwritten with a fresh meta —
+ *   we prefer "project visible to hub" over preserving unreadable garbage.
+ *
+ * Safe to call from constructors / hot paths: a single `existsSync` short-circuit
+ * avoids any disk write on the steady-state path.
+ */
+export function ensureProjectMeta(workDir, home) {
+    const path = metaFile(workDir, home);
+    if (existsSync(path)) {
+        try {
+            const parsed = JSON.parse(readFileSync(path, "utf-8"));
+            if (parsed && typeof parsed === "object" && typeof parsed.createdAt === "string") {
+                return;
+            }
+        }
+        catch {
+            // fall through and overwrite
+        }
+    }
+    mkdirSync(projectRoot(workDir, home), { recursive: true });
+    const meta = {
+        version: 1,
+        workDir,
+        createdAt: new Date().toISOString(),
+    };
+    writeFileSync(path, JSON.stringify(meta, null, 2));
+}
+//# sourceMappingURL=meta.js.map