@rryando/arcs 3.0.0

package/dist/utils/task-store.js

@@ -0,0 +1,178 @@
+/**
+ * Task CRUD storage for ARCS projects.
+ *
+ * Provides create, list, get, update, delete operations for tasks,
+ * with a flat JSON index and markdown render for human-readable output.
+ */
+import { writeFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { invalidateGraphCache } from "../retrieval/graph-invalidate.js";
+import { itemNotFound, normalizedIdCollision } from "./errors.js";
+import { withLock } from "./file-lock.js";
+import { readJsonSafe } from "./json.js";
+import { normalizeIdentifier } from "./slug.js";
+import { ensureDir, fileExists, nowISO, sanitizeFileRefs, validateTaskPriority, validateTaskStatus, writeJson, } from "./storage-utils.js";
+export { TASK_PRIORITIES, TASK_STATUSES } from "./storage-utils.js";
+// ---------------------------------------------------------------------------
+// Index helpers
+// ---------------------------------------------------------------------------
+async function readTaskIndex(projectDir) {
+    const tasksDir = join(projectDir, "tasks");
+    if (!(await fileExists(tasksDir))) {
+        return { tasks: [] };
+    }
+    const indexPath = join(tasksDir, "index.json");
+    const index = await readJsonSafe(indexPath);
+    if (!index || !Array.isArray(index.tasks)) {
+        return { tasks: [] };
+    }
+    return index;
+}
+async function writeTaskIndex(projectDir, index) {
+    const tasksDir = join(projectDir, "tasks");
+    await ensureDir(tasksDir);
+    const indexPath = join(tasksDir, "index.json");
+    await withLock(indexPath, async () => {
+        await writeJson(indexPath, index);
+    });
+}
+// ---------------------------------------------------------------------------
+// Render
+// ---------------------------------------------------------------------------
+const PRIORITY_ORDER = {
+    high: 0,
+    medium: 1,
+    low: 2,
+};
+function sortByPriority(tasks) {
+    return [...tasks].sort((a, b) => PRIORITY_ORDER[a.priority] - PRIORITY_ORDER[b.priority]);
+}
+export async function renderTasksMd(projectDir, index) {
+    const metaPath = join(projectDir, "meta.json");
+    const meta = await readJsonSafe(metaPath);
+    const name = meta?.name ?? "Unknown";
+    const sections = [`# Tasks — ${name}\n`];
+    const statusConfig = [
+        { status: "in_progress", heading: "In Progress", marker: "[/]", showPriority: true },
+        { status: "backlog", heading: "Backlog", marker: "[ ]", showPriority: true },
+        { status: "done", heading: "Done", marker: "[x]", showPriority: false },
+        { status: "cancelled", heading: "Cancelled", marker: "[~]", showPriority: false },
+    ];
+    for (const { status, heading, marker, showPriority } of statusConfig) {
+        const tasks = sortByPriority(index.tasks.filter((t) => t.status === status));
+        if (tasks.length === 0)
+            continue;
+        sections.push(`## ${heading}`);
+        for (const task of tasks) {
+            const priorityTag = showPriority ? ` **[${task.priority}]**` : "";
+            sections.push(`- ${marker}${priorityTag} ${task.title}`);
+        }
+        sections.push("");
+    }
+    await writeFile(join(projectDir, "tasks.md"), sections.join("\n"), "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export async function createTask(projectDir, input) {
+    const status = input.status ?? "backlog";
+    const priority = input.priority ?? "medium";
+    validateTaskStatus(status);
+    validateTaskPriority(priority);
+    const sourceFiles = input.sourceFiles ? sanitizeFileRefs(input.sourceFiles) : undefined;
+    const normalizedId = normalizeIdentifier(input.title);
+    const index = await readTaskIndex(projectDir);
+    if (index.tasks.some((t) => t.normalizedId === normalizedId)) {
+        throw normalizedIdCollision("task", input.title, normalizedId);
+    }
+    const ts = nowISO(input.now);
+    const meta = {
+        id: normalizedId,
+        normalizedId,
+        title: input.title,
+        status,
+        priority,
+        ...(input.planId && { planId: input.planId }),
+        ...(sourceFiles && { sourceFiles }),
+        createdAt: ts,
+        updatedAt: ts,
+    };
+    index.tasks.push(meta);
+    await writeTaskIndex(projectDir, index);
+    await renderTasksMd(projectDir, index);
+    invalidateGraphCache(basename(projectDir));
+    return meta;
+}
+export async function listTasks(projectDir, filters) {
+    const index = await readTaskIndex(projectDir);
+    let tasks = index.tasks;
+    if (filters?.status) {
+        tasks = tasks.filter((t) => t.status === filters.status);
+    }
+    if (filters?.priority) {
+        tasks = tasks.filter((t) => t.priority === filters.priority);
+    }
+    return tasks;
+}
+export async function getTask(projectDir, taskId) {
+    const normalizedId = normalizeIdentifier(taskId);
+    const index = await readTaskIndex(projectDir);
+    const task = index.tasks.find((t) => t.normalizedId === normalizedId);
+    if (!task) {
+        throw itemNotFound("task", taskId);
+    }
+    return task;
+}
+export async function updateTask(projectDir, input) {
+    if (input.status !== undefined) {
+        validateTaskStatus(input.status);
+    }
+    if (input.priority !== undefined) {
+        validateTaskPriority(input.priority);
+    }
+    const normalizedId = normalizeIdentifier(input.id);
+    const index = await readTaskIndex(projectDir);
+    const task = index.tasks.find((t) => t.normalizedId === normalizedId);
+    if (!task) {
+        throw itemNotFound("task", input.id);
+    }
+    if (input.title !== undefined)
+        task.title = input.title;
+    if (input.status !== undefined)
+        task.status = input.status;
+    if (input.priority !== undefined)
+        task.priority = input.priority;
+    if (input.planId !== undefined) {
+        if (input.planId === null) {
+            delete task.planId;
+        }
+        else {
+            task.planId = input.planId;
+        }
+    }
+    if (input.sourceFiles !== undefined) {
+        if (input.sourceFiles.length === 0) {
+            delete task.sourceFiles;
+        }
+        else {
+            task.sourceFiles = sanitizeFileRefs(input.sourceFiles);
+        }
+    }
+    task.updatedAt = nowISO(input.now);
+    await writeTaskIndex(projectDir, index);
+    await renderTasksMd(projectDir, index);
+    invalidateGraphCache(basename(projectDir));
+    return task;
+}
+export async function deleteTask(projectDir, taskId) {
+    const normalizedId = normalizeIdentifier(taskId);
+    const index = await readTaskIndex(projectDir);
+    const task = index.tasks.find((t) => t.normalizedId === normalizedId);
+    if (!task) {
+        throw itemNotFound("task", taskId);
+    }
+    index.tasks = index.tasks.filter((t) => t.normalizedId !== normalizedId);
+    await writeTaskIndex(projectDir, index);
+    await renderTasksMd(projectDir, index);
+}
+//# sourceMappingURL=task-store.js.map

package/dist/utils/task-store.js.map

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

package/dist/utils/template.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Renders a mustache-style template by replacing {{variable}} placeholders.
+ * NOTE: Template reading remains synchronous — templates are local package
+ * assets read once during `arcs project init`, not on the hot path.
+ */
+export declare function renderTemplate(templatePath: string, variables: Record<string, string>): string;
+/**
+ * Renders a template string with {{variable}} substitution.
+ */
+export declare function renderString(template: string, variables: Record<string, string>): string;
+/**
+ * Resolves a template path relative to the package's templates/ dir.
+ */
+export declare function getTemplatePath(templateName: string): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/utils/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/utils/template.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAG9F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIxF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/utils/template.js

@@ -0,0 +1,27 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { PACKAGE_ROOT } from "./paths.js";
+/**
+ * Renders a mustache-style template by replacing {{variable}} placeholders.
+ * NOTE: Template reading remains synchronous — templates are local package
+ * assets read once during `arcs project init`, not on the hot path.
+ */
+export function renderTemplate(templatePath, variables) {
+    const template = readFileSync(templatePath, "utf-8");
+    return renderString(template, variables);
+}
+/**
+ * Renders a template string with {{variable}} substitution.
+ */
+export function renderString(template, variables) {
+    return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+        return variables[key] ?? match;
+    });
+}
+/**
+ * Resolves a template path relative to the package's templates/ dir.
+ */
+export function getTemplatePath(templateName) {
+    return resolve(PACKAGE_ROOT, "templates", templateName);
+}
+//# sourceMappingURL=template.js.map

package/dist/utils/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/utils/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,SAAiC;IACpF,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrD,OAAO,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,SAAiC;IAC9E,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QAC/D,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,OAAO,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AAC1D,CAAC"}

package/dist/utils/tool-response.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Standard CLI tool response helpers.
+ */
+type ToolErrorResponse = {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+};
+export declare function jsonResult(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * Build a code-tagged CLI command error response.
+ *
+ * Every error surfaced to the caller carries a stable `[CODE]` prefix so
+ * clients can programmatically distinguish error classes.
+ *
+ * @param code  Stable upper-case error code (e.g. `"NOT_FOUND"`, `"INVALID_INPUT"`).
+ * @param message  Human-readable description.
+ * @param cause  Optional underlying error — appended as `" — <detail>"` when present.
+ */
+export declare function toolError(code: string, message: string, cause?: unknown): ToolErrorResponse;
+/**
+ * Fallback error helper for truly unknown exceptions caught at the top-level.
+ *
+ * Prefer `toolError(code, ...)` for known error conditions, or
+ * `formatError(DagError)` for typed DAG errors. Use `errorResult` only
+ * in generic `catch (err)` blocks where the error type is not known.
+ */
+export declare function errorResult(err: unknown): ToolErrorResponse;
+export {};
+//# sourceMappingURL=tool-response.d.ts.map

package/dist/utils/tool-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.d.ts","sourceRoot":"","sources":["../../src/utils/tool-response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,KAAK,iBAAiB,GAAG;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAEtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO;;;;;EASvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAS3F;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAE3D"}

package/dist/utils/tool-response.js

@@ -0,0 +1,44 @@
+/**
+ * Standard CLI tool response helpers.
+ */
+export function jsonResult(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Build a code-tagged CLI command error response.
+ *
+ * Every error surfaced to the caller carries a stable `[CODE]` prefix so
+ * clients can programmatically distinguish error classes.
+ *
+ * @param code  Stable upper-case error code (e.g. `"NOT_FOUND"`, `"INVALID_INPUT"`).
+ * @param message  Human-readable description.
+ * @param cause  Optional underlying error — appended as `" — <detail>"` when present.
+ */
+export function toolError(code, message, cause) {
+    let text = `[${code}] ${message}`;
+    if (cause !== undefined && cause !== null) {
+        const detail = cause instanceof Error ? cause.message : String(cause);
+        if (detail && detail !== message) {
+            text += ` — ${detail}`;
+        }
+    }
+    return { content: [{ type: "text", text }], isError: true };
+}
+/**
+ * Fallback error helper for truly unknown exceptions caught at the top-level.
+ *
+ * Prefer `toolError(code, ...)` for known error conditions, or
+ * `formatError(DagError)` for typed DAG errors. Use `errorResult` only
+ * in generic `catch (err)` blocks where the error type is not known.
+ */
+export function errorResult(err) {
+    return toolError("INTERNAL_ERROR", err instanceof Error ? err.message : String(err));
+}
+//# sourceMappingURL=tool-response.js.map

package/dist/utils/tool-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.js","sourceRoot":"","sources":["../../src/utils/tool-response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe,EAAE,KAAe;IACtE,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,MAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACjC,IAAI,IAAI,MAAM,MAAM,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,CAAC;AAChF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,SAAS,CAAC,gBAAgB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACvF,CAAC"}

package/dist/utils/workflow-policy.d.ts

@@ -0,0 +1,50 @@
+export type WorkflowSurface = "queue" | "plan" | "memory";
+export interface WorkflowPlanCandidate {
+    title: string;
+    status: string;
+    updatedAt?: string;
+}
+export interface CurrentFocus {
+    kind: "plan" | "task" | "none";
+    label: string;
+}
+export interface OperatingBrief {
+    currentFocus: string;
+    recommendedSurface: "QUEUE" | "PLAN" | "MEMORY";
+    why: string;
+    nextAction: string;
+}
+export interface StructuredTask {
+    id: string;
+    title: string;
+    status: "backlog" | "in_progress" | "done" | "cancelled";
+    planId?: string;
+    priority?: "low" | "medium" | "high";
+}
+export interface StructuredPlan {
+    id: string;
+    title: string;
+    status: "proposed" | "planned" | "in_progress" | "blocked" | "done" | "archived";
+}
+/**
+ * Derive an operating brief from structured task and plan data.
+ */
+export declare function deriveOperatingBrief(input: {
+    tasks: StructuredTask[];
+    plans: StructuredPlan[];
+}): OperatingBrief;
+export declare function chooseCurrentFocus(input: {
+    plans: WorkflowPlanCandidate[];
+    inProgressTasks: string[];
+    backlogTasks: string[];
+}): CurrentFocus;
+export declare function recommendSurface(input: {
+    hasPlanSignals: boolean;
+    hasDurableKnowledgeSignal: boolean;
+    itemLabel?: string;
+}): {
+    surface: WorkflowSurface;
+    why: string;
+};
+export declare function safeTime(value?: string): number;
+//# sourceMappingURL=workflow-policy.d.ts.map

package/dist/utils/workflow-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-policy.d.ts","sourceRoot":"","sources":["../../src/utils/workflow-policy.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,WAAW,CAAC;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;CAClF;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,GAAG,cAAc,CAgEjB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,GAAG,YAAY,CA4Bf;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,cAAc,EAAE,OAAO,CAAC;IACxB,yBAAyB,EAAE,OAAO,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAmB5C;AAED,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/C"}

package/dist/utils/workflow-policy.js

@@ -0,0 +1,111 @@
+import { stripTaskCheckbox } from "./content-assembly.js";
+const PRIORITY_ORDER = { high: 0, medium: 1, low: 2 };
+/**
+ * Derive an operating brief from structured task and plan data.
+ */
+export function deriveOperatingBrief(input) {
+    const { tasks, plans } = input;
+    // 1. Any task in_progress → QUEUE
+    const inProgress = tasks.filter((t) => t.status === "in_progress");
+    if (inProgress.length > 0) {
+        const task = inProgress[0];
+        return {
+            currentFocus: task.title,
+            recommendedSurface: "QUEUE",
+            why: `Task in progress: ${task.title}`,
+            nextAction: `Continue task ${task.id}`,
+        };
+    }
+    // 2. Any plan in_progress with a backlog task → QUEUE
+    const inProgressPlans = plans.filter((p) => p.status === "in_progress");
+    for (const plan of inProgressPlans) {
+        const readyTask = tasks.find((t) => t.status === "backlog" && t.planId === plan.id);
+        if (readyTask) {
+            return {
+                currentFocus: plan.title,
+                recommendedSurface: "QUEUE",
+                why: `Plan ${plan.title} has ready tasks`,
+                nextAction: `Start task ${readyTask.id}`,
+            };
+        }
+    }
+    // 3. Any plan proposed or planned → PLAN
+    const needsPlanning = plans.find((p) => p.status === "proposed" || p.status === "planned");
+    if (needsPlanning) {
+        return {
+            currentFocus: needsPlanning.title,
+            recommendedSurface: "PLAN",
+            why: `Plan "${needsPlanning.title}" needs attention (status: ${needsPlanning.status})`,
+            nextAction: `Advance plan ${needsPlanning.id}`,
+        };
+    }
+    // 4. Any backlog task (no in-progress plan) → QUEUE, highest priority
+    const backlog = tasks.filter((t) => t.status === "backlog");
+    if (backlog.length > 0) {
+        const sorted = [...backlog].sort((a, b) => (PRIORITY_ORDER[a.priority ?? "medium"] ?? 1) -
+            (PRIORITY_ORDER[b.priority ?? "medium"] ?? 1));
+        const task = sorted[0];
+        return {
+            currentFocus: task.title,
+            recommendedSurface: "QUEUE",
+            why: `Backlog task ready: ${task.title}`,
+            nextAction: `Start task ${task.id}`,
+        };
+    }
+    // 5. Nothing active
+    return {
+        currentFocus: "No active work",
+        recommendedSurface: "MEMORY",
+        why: "All plans/tasks complete",
+        nextAction: "Review knowledge or start a new plan",
+    };
+}
+export function chooseCurrentFocus(input) {
+    const inProgressPlans = input.plans.filter((plan) => plan.status === "in_progress");
+    if (inProgressPlans.length > 0) {
+        const sorted = [...inProgressPlans].sort((a, b) => {
+            const aTime = safeTime(a.updatedAt);
+            const bTime = safeTime(b.updatedAt);
+            return bTime - aTime;
+        });
+        return { kind: "plan", label: sorted[0]?.title ?? "Unknown plan" };
+    }
+    if (input.inProgressTasks.length > 0) {
+        return {
+            kind: "task",
+            label: stripTaskCheckbox(input.inProgressTasks[0] ?? ""),
+        };
+    }
+    if (input.backlogTasks.length > 0) {
+        return {
+            kind: "task",
+            label: stripTaskCheckbox(input.backlogTasks[0] ?? ""),
+        };
+    }
+    return { kind: "none", label: "None" };
+}
+export function recommendSurface(input) {
+    if (input.hasDurableKnowledgeSignal) {
+        return {
+            surface: "memory",
+            why: "This should outlive the current task and be reusable later.",
+        };
+    }
+    if (input.hasPlanSignals) {
+        return {
+            surface: "plan",
+            why: "This work spans multiple steps and needs durable planning context.",
+        };
+    }
+    return {
+        surface: "queue",
+        why: "This is best tracked as immediate execution state.",
+    };
+}
+export function safeTime(value) {
+    if (!value)
+        return Number.NEGATIVE_INFINITY;
+    const parsed = new Date(value).getTime();
+    return Number.isFinite(parsed) ? parsed : Number.NEGATIVE_INFINITY;
+}
+//# sourceMappingURL=workflow-policy.js.map

package/dist/utils/workflow-policy.js.map

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

package/dist/utils/workspace-match.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Path-segment-aware workspace matching for project context resolution.
+ */
+/**
+ * Normalize a workspace path: strip trailing slashes (preserving root "/").
+ */
+export declare function normalizeWorkspacePath(p: string): string;
+/**
+ * Check if `queryPath` is inside (or equal to) `storedPath`.
+ * Uses path-segment-aware comparison to prevent "/Users/ryan" matching "/Users/ryan.ryn".
+ */
+export declare function matchWorkspace(queryPath: string, storedPath: string): boolean;
+export interface WorkspaceProject {
+    slug: string;
+    workspacePaths: string[];
+}
+/** Discriminated union result for findBestMatch. */
+export type FindMatchResult = {
+    kind: "match";
+    slug: string;
+    matchedPath: string;
+} | {
+    kind: "none";
+} | {
+    kind: "ambiguous";
+    slugs: string[];
+};
+/**
+ * Find the best matching project for a query path.
+ * Returns the project with the longest matching workspace path (most specific).
+ * Returns { kind: "none" } if no match, { kind: "ambiguous", slugs } if multiple
+ * projects match at the same prefix length.
+ */
+export declare function findBestMatch(queryPath: string, projects: WorkspaceProject[]): FindMatchResult;
+//# sourceMappingURL=workspace-match.d.ts.map

package/dist/utils/workspace-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-match.d.ts","sourceRoot":"","sources":["../../src/utils/workspace-match.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAI7E;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,oDAAoD;AACpD,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,eAAe,CAiC9F"}

package/dist/utils/workspace-match.js

@@ -0,0 +1,58 @@
+/**
+ * Path-segment-aware workspace matching for project context resolution.
+ */
+/**
+ * Normalize a workspace path: strip trailing slashes (preserving root "/").
+ */
+export function normalizeWorkspacePath(p) {
+    if (p === "/")
+        return p;
+    return p.replace(/\/+$/, "");
+}
+/**
+ * Check if `queryPath` is inside (or equal to) `storedPath`.
+ * Uses path-segment-aware comparison to prevent "/Users/ryan" matching "/Users/ryan.ryn".
+ */
+export function matchWorkspace(queryPath, storedPath) {
+    const q = normalizeWorkspacePath(queryPath);
+    const s = normalizeWorkspacePath(storedPath);
+    return q === s || q.startsWith(`${s}/`);
+}
+/**
+ * Find the best matching project for a query path.
+ * Returns the project with the longest matching workspace path (most specific).
+ * Returns { kind: "none" } if no match, { kind: "ambiguous", slugs } if multiple
+ * projects match at the same prefix length.
+ */
+export function findBestMatch(queryPath, projects) {
+    let bestLength = -1;
+    let bestSlug = null;
+    let bestPath = null;
+    let ambiguousSlugs = [];
+    for (const project of projects) {
+        for (const wp of project.workspacePaths) {
+            if (matchWorkspace(queryPath, wp)) {
+                const normalized = normalizeWorkspacePath(wp);
+                if (normalized.length > bestLength) {
+                    bestLength = normalized.length;
+                    bestSlug = project.slug;
+                    bestPath = normalized;
+                    ambiguousSlugs = [project.slug];
+                }
+                else if (normalized.length === bestLength && project.slug !== bestSlug) {
+                    if (!ambiguousSlugs.includes(project.slug)) {
+                        ambiguousSlugs.push(project.slug);
+                    }
+                }
+            }
+        }
+    }
+    if (bestSlug === null || bestPath === null) {
+        return { kind: "none" };
+    }
+    if (ambiguousSlugs.length > 1) {
+        return { kind: "ambiguous", slugs: ambiguousSlugs };
+    }
+    return { kind: "match", slug: bestSlug, matchedPath: bestPath };
+}
+//# sourceMappingURL=workspace-match.js.map

package/dist/utils/workspace-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-match.js","sourceRoot":"","sources":["../../src/utils/workspace-match.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,CAAS;IAC9C,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC;IACxB,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,UAAkB;IAClE,MAAM,CAAC,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAaD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,QAA4B;IAC3E,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;IACpB,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,cAAc,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YACxC,IAAI,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC;gBAClC,MAAM,UAAU,GAAG,sBAAsB,CAAC,EAAE,CAAC,CAAC;gBAC9C,IAAI,UAAU,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;oBACnC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;oBAC/B,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;oBACxB,QAAQ,GAAG,UAAU,CAAC;oBACtB,cAAc,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAClC,CAAC;qBAAM,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACzE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC3C,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IACtD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAClE,CAAC"}