@rryando/arcs 3.0.0

package/dist/utils/quick-scan.js

@@ -0,0 +1,156 @@
+// ---------------------------------------------------------------------------
+// Quick Scan — extract initial project context from a git repo
+// ---------------------------------------------------------------------------
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+function exec(cmd, cwd) {
+    try {
+        return execSync(cmd, {
+            encoding: "utf-8",
+            cwd,
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: 5000,
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function isGitRepo(repoPath) {
+    return exec("git rev-parse --is-inside-work-tree", repoPath) === "true";
+}
+function getRecentBranches(repoPath) {
+    const output = exec("git branch --sort=-committerdate --format='%(refname:short)'", repoPath);
+    if (!output)
+        return [];
+    return output
+        .split("\n")
+        .map((b) => b.trim())
+        .filter((b) => b && !["main", "master", "HEAD"].includes(b))
+        .slice(0, 5);
+}
+function getRecentCommitTopics(repoPath) {
+    const output = exec("git log --oneline -20", repoPath);
+    if (!output)
+        return [];
+    const seen = new Set();
+    const topics = [];
+    for (const line of output.split("\n")) {
+        // Remove the short SHA prefix (7 hex chars + space)
+        const message = line.replace(/^[0-9a-f]{7,} /, "").trim();
+        if (!message)
+            continue;
+        // Extract conventional commit prefix (feat:, fix:, chore:, etc.) or first 50 chars
+        const conventionalMatch = message.match(/^(\w+)(?:\([^)]+\))?:\s*(.+)/);
+        const topic = conventionalMatch
+            ? `${conventionalMatch[1]}: ${conventionalMatch[2].slice(0, 60)}`
+            : message.slice(0, 60);
+        if (!seen.has(topic)) {
+            seen.add(topic);
+            topics.push(topic);
+        }
+    }
+    return topics;
+}
+function getTodos(repoPath) {
+    const excludeDirs = ["node_modules", "dist", ".git", "vendor", "target"];
+    const excludeArgs = excludeDirs.map((d) => `--exclude-dir=${d}`).join(" ");
+    const includePatterns = ["*.ts", "*.js", "*.py", "*.rs"].map((p) => `--include="${p}"`).join(" ");
+    const output = exec(`grep -rn ${excludeArgs} ${includePatterns} "TODO\\|FIXME" . | head -20`, repoPath);
+    if (!output)
+        return [];
+    const todos = [];
+    for (const line of output.split("\n")) {
+        // Format: ./path/to/file.ts:42:  // TODO: fix this
+        const match = line.match(/^\.\/(.+?):(\d+):(.+)$/);
+        if (!match)
+            continue;
+        const [, file, lineStr, rawText] = match;
+        const text = rawText
+            .trim()
+            .replace(/^[/*# ]+/, "")
+            .trim();
+        todos.push({ file, line: parseInt(lineStr, 10), text });
+    }
+    return todos.slice(0, 20);
+}
+function branchToTaskTitle(branch) {
+    // feat/foo-bar → "Implement foo bar"
+    // fix/some-bug → "Fix some bug"
+    // chore/update-deps → "Update deps"
+    const prefixMap = {
+        feat: "Implement",
+        feature: "Implement",
+        fix: "Fix",
+        bugfix: "Fix",
+        hotfix: "Fix",
+        chore: "",
+        refactor: "Refactor",
+        docs: "Document",
+        test: "Test",
+        ci: "Configure CI for",
+        release: "Release",
+    };
+    const slashIdx = branch.indexOf("/");
+    if (slashIdx === -1) {
+        // No prefix — just humanize the branch name
+        return humanize(branch);
+    }
+    const prefix = branch.slice(0, slashIdx).toLowerCase();
+    const rest = branch.slice(slashIdx + 1);
+    const humanRest = humanize(rest);
+    const verb = prefixMap[prefix];
+    if (verb === undefined) {
+        return humanize(branch.replace("/", " "));
+    }
+    return verb ? `${verb} ${humanRest}` : humanRest;
+}
+function humanize(slug) {
+    return slug
+        .replace(/[-_]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/\b\w/g, (c) => c.toUpperCase())
+        .replace(/^./, (c) => c.toUpperCase());
+}
+function todoToTaskTitle(todo) {
+    // Strip TODO:/FIXME: prefix and return first 80 chars
+    return todo.text
+        .replace(/^(TODO|FIXME)\s*[:!-]?\s*/i, "")
+        .slice(0, 80)
+        .trim();
+}
+export function quickScan(repoPath) {
+    const absPath = resolve(repoPath);
+    if (!existsSync(absPath)) {
+        return { recentBranches: [], recentCommitTopics: [], todos: [], suggestedTasks: [] };
+    }
+    const gitRepo = isGitRepo(absPath);
+    const recentBranches = gitRepo ? getRecentBranches(absPath) : [];
+    const recentCommitTopics = gitRepo ? getRecentCommitTopics(absPath) : [];
+    const todos = getTodos(absPath);
+    // Build suggested tasks: branches first, then TODO-derived, dedup, max 5
+    const seen = new Set();
+    const suggested = [];
+    for (const branch of recentBranches) {
+        if (suggested.length >= 5)
+            break;
+        const title = branchToTaskTitle(branch);
+        if (title && !seen.has(title.toLowerCase())) {
+            seen.add(title.toLowerCase());
+            suggested.push(title);
+        }
+    }
+    for (const todo of todos) {
+        if (suggested.length >= 5)
+            break;
+        const title = todoToTaskTitle(todo);
+        if (title && title.length > 5 && !seen.has(title.toLowerCase())) {
+            seen.add(title.toLowerCase());
+            suggested.push(title);
+        }
+    }
+    return { recentBranches, recentCommitTopics, todos, suggestedTasks: suggested };
+}
+//# sourceMappingURL=quick-scan.js.map

package/dist/utils/quick-scan.js.map

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

package/dist/utils/schemas.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+export declare const fileRefSchema: z.ZodObject<{
+    path: z.ZodString;
+    anchor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    anchor?: string | undefined;
+}, {
+    path: string;
+    anchor?: string | undefined;
+}>;
+export type FileRef = z.infer<typeof fileRefSchema>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/utils/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa;;;;;;;;;EAGxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/utils/schemas.js

@@ -0,0 +1,6 @@
+import { z } from "zod";
+export const fileRefSchema = z.object({
+    path: z.string().describe("Relative path from workspace root"),
+    anchor: z.string().optional().describe("Stable identifier: function/class/export name"),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/utils/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/utils/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CACxF,CAAC,CAAC"}

package/dist/utils/slug.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert a project name to a URL-safe slug.
+ * "My Cool Project" → "my-cool-project"
+ */
+export declare function slugify(name: string): string;
+/**
+ * Normalize a user-provided identifier into the canonical storage form.
+ */
+export declare function normalizeIdentifier(value: string): string;
+//# sourceMappingURL=slug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/utils/slug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/utils/slug.js

@@ -0,0 +1,18 @@
+/**
+ * Convert a project name to a URL-safe slug.
+ * "My Cool Project" → "my-cool-project"
+ */
+export function slugify(name) {
+    return name
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * Normalize a user-provided identifier into the canonical storage form.
+ */
+export function normalizeIdentifier(value) {
+    return slugify(value);
+}
+//# sourceMappingURL=slug.js.map

package/dist/utils/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/utils/slug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/dist/utils/stdin.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read all data from stdin with a configurable timeout.
+ * Rejects if no data arrives within the timeout window.
+ */
+export declare function readStdin(timeoutMs?: number): Promise<string>;
+//# sourceMappingURL=stdin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../../src/utils/stdin.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,SAAS,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBjE"}

package/dist/utils/stdin.js

@@ -0,0 +1,25 @@
+// ---------------------------------------------------------------------------
+// stdin — Shared stdin reading utility
+// ---------------------------------------------------------------------------
+/**
+ * Read all data from stdin with a configurable timeout.
+ * Rejects if no data arrives within the timeout window.
+ */
+export async function readStdin(timeoutMs = 5000) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        const timeout = setTimeout(() => {
+            reject(new Error(`Timed out reading from stdin (${timeoutMs / 1000}s). Ensure data is piped to the command.`));
+        }, timeoutMs);
+        process.stdin.on("data", (chunk) => chunks.push(chunk));
+        process.stdin.on("end", () => {
+            clearTimeout(timeout);
+            resolve(Buffer.concat(chunks).toString("utf-8"));
+        });
+        process.stdin.on("error", (err) => {
+            clearTimeout(timeout);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=stdin.js.map

package/dist/utils/stdin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.js","sourceRoot":"","sources":["../../src/utils/stdin.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAS,GAAG,IAAI;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,MAAM,CACJ,IAAI,KAAK,CACP,iCAAiC,SAAS,GAAG,IAAI,0CAA0C,CAC5F,CACF,CAAC;QACJ,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAChC,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/storage-utils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared storage utilities for ARCS project stores.
+ *
+ * Filesystem helpers, validation utilities, and common types used by
+ * plan-store, knowledge-store, and task-store modules.
+ */
+export declare const PLAN_STATUSES: readonly ["proposed", "planned", "in_progress", "blocked", "done", "archived"];
+export type PlanStatus = (typeof PLAN_STATUSES)[number];
+export declare const KNOWLEDGE_KINDS: readonly ["lesson", "gotcha", "pattern", "architecture", "module", "feature", "reference", "decision"];
+export type KnowledgeKind = (typeof KNOWLEDGE_KINDS)[number];
+export declare const KNOWLEDGE_AUDIENCES: readonly ["orchestrator", "implementer", "designer", "universal"];
+export type KnowledgeAudience = (typeof KNOWLEDGE_AUDIENCES)[number];
+export declare const TASK_STATUSES: readonly ["backlog", "in_progress", "done", "cancelled"];
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+export declare const TASK_PRIORITIES: readonly ["high", "medium", "low"];
+export type TaskPriority = (typeof TASK_PRIORITIES)[number];
+export interface FileRef {
+    path: string;
+    anchor?: string;
+}
+/**
+ * Validates and normalizes an array of FileRef objects.
+ * - path: backslashes normalized to forward slashes first, then validated.
+ *   Must be relative (no leading /), no .., no empty, no #, comma, or colon.
+ * - anchor: if provided, must be non-empty/non-whitespace, no # or comma.
+ * Returns a new array with normalized paths. Throws on invalid input.
+ */
+export declare function sanitizeFileRefs(refs: FileRef[]): FileRef[];
+export declare function validatePlanStatus(status: string): asserts status is PlanStatus;
+export declare function validateKnowledgeKind(kind: string): asserts kind is KnowledgeKind;
+export declare function validateTaskStatus(status: string): asserts status is TaskStatus;
+export declare function validateTaskPriority(priority: string): asserts priority is TaskPriority;
+/** A valid keyword is a non-empty, lowercase, alpha-numeric-or-dash string. */
+export declare function sanitizeKeywords(raw: string[]): string[];
+export declare function fileExists(path: string): Promise<boolean>;
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function writeJson(filePath: string, data: unknown): Promise<void>;
+export declare function nowISO(override?: string): string;
+/**
+ * Build body markdown. If `content` is supplied and already starts with
+ * a matching H1, use as-is. Otherwise, prepend `# title\n\n`.
+ */
+export declare function buildBody(title: string, content?: string): string;
+/**
+ * Rewrite the leading H1 in an existing body file.
+ */
+export declare function rewriteH1(filePath: string, newTitle: string): Promise<void>;
+//# sourceMappingURL=storage-utils.d.ts.map

package/dist/utils/storage-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-utils.d.ts","sourceRoot":"","sources":["../../src/utils/storage-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,eAAO,MAAM,aAAa,gFAOhB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe,wGASlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,eAAO,MAAM,mBAAmB,mEAKtB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMrE,eAAO,MAAM,aAAa,0DAA2D,CAAC;AACtF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe,oCAAqC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAM5D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CA6B3D;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAI/E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,aAAa,CAIjF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAI/E;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,IAAI,YAAY,CAIvF;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAexD;AAMD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAED,wBAAgB,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAcjE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjF"}

package/dist/utils/storage-utils.js

@@ -0,0 +1,175 @@
+/**
+ * Shared storage utilities for ARCS project stores.
+ *
+ * Filesystem helpers, validation utilities, and common types used by
+ * plan-store, knowledge-store, and task-store modules.
+ */
+import { constants } from "node:fs";
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { invalidFileRef, invalidKeyword, invalidKnowledgeKind, invalidPlanStatus, invalidTaskPriority, invalidTaskStatus, } from "./errors.js";
+// ---------------------------------------------------------------------------
+// Enums — Plans
+// ---------------------------------------------------------------------------
+export const PLAN_STATUSES = [
+    "proposed",
+    "planned",
+    "in_progress",
+    "blocked",
+    "done",
+    "archived",
+];
+export const KNOWLEDGE_KINDS = [
+    "lesson",
+    "gotcha",
+    "pattern",
+    "architecture",
+    "module",
+    "feature",
+    "reference",
+    "decision",
+];
+export const KNOWLEDGE_AUDIENCES = [
+    "orchestrator",
+    "implementer",
+    "designer",
+    "universal",
+];
+// ---------------------------------------------------------------------------
+// Enums — Tasks
+// ---------------------------------------------------------------------------
+export const TASK_STATUSES = ["backlog", "in_progress", "done", "cancelled"];
+export const TASK_PRIORITIES = ["high", "medium", "low"];
+/**
+ * Validates and normalizes an array of FileRef objects.
+ * - path: backslashes normalized to forward slashes first, then validated.
+ *   Must be relative (no leading /), no .., no empty, no #, comma, or colon.
+ * - anchor: if provided, must be non-empty/non-whitespace, no # or comma.
+ * Returns a new array with normalized paths. Throws on invalid input.
+ */
+export function sanitizeFileRefs(refs) {
+    return refs.map((ref) => {
+        // Normalize backslashes to forward slashes first (Windows path compat)
+        const path = ref.path.replace(/\\/g, "/").replace(/\/+$/, "");
+        if (!path?.trim()) {
+            throw invalidFileRef("path must not be empty");
+        }
+        if (path.startsWith("/")) {
+            throw invalidFileRef(`path must be relative, got "${path}"`);
+        }
+        if (/(^|\/)\.\.($|\/)/.test(path)) {
+            throw invalidFileRef(`path must not contain ".." segments, got "${path}"`);
+        }
+        // Note: backslash already normalized above, so only check #, comma, colon
+        if (/[#,:]/.test(path)) {
+            throw invalidFileRef(`path must not contain #, comma, or colon, got "${path}"`);
+        }
+        const result = { path };
+        if (ref.anchor !== undefined) {
+            if (!ref.anchor?.trim()) {
+                throw invalidFileRef("anchor must not be empty or whitespace-only");
+            }
+            if (/[#,]/.test(ref.anchor)) {
+                throw invalidFileRef(`anchor must not contain # or comma, got "${ref.anchor}"`);
+            }
+            result.anchor = ref.anchor;
+        }
+        return result;
+    });
+}
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+export function validatePlanStatus(status) {
+    if (!PLAN_STATUSES.includes(status)) {
+        throw invalidPlanStatus(status);
+    }
+}
+export function validateKnowledgeKind(kind) {
+    if (!KNOWLEDGE_KINDS.includes(kind)) {
+        throw invalidKnowledgeKind(kind);
+    }
+}
+export function validateTaskStatus(status) {
+    if (!TASK_STATUSES.includes(status)) {
+        throw invalidTaskStatus(status);
+    }
+}
+export function validateTaskPriority(priority) {
+    if (!TASK_PRIORITIES.includes(priority)) {
+        throw invalidTaskPriority(priority);
+    }
+}
+/** A valid keyword is a non-empty, lowercase, alpha-numeric-or-dash string. */
+export function sanitizeKeywords(raw) {
+    const seen = new Set();
+    const out = [];
+    for (const kw of raw) {
+        const trimmed = kw.trim().toLowerCase();
+        // Reject empty/blank or anything that normalizes to nothing useful
+        if (!trimmed || !/[a-z0-9]/.test(trimmed)) {
+            throw invalidKeyword(kw);
+        }
+        if (!seen.has(trimmed)) {
+            seen.add(trimmed);
+            out.push(trimmed);
+        }
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Filesystem helpers
+// ---------------------------------------------------------------------------
+export async function fileExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function ensureDir(dir) {
+    await mkdir(dir, { recursive: true });
+}
+export async function writeJson(filePath, data) {
+    await writeFile(filePath, `${JSON.stringify(data, null, 2)}\n`, "utf-8");
+}
+export function nowISO(override) {
+    return override ?? new Date().toISOString();
+}
+// ---------------------------------------------------------------------------
+// H1 rewrite
+// ---------------------------------------------------------------------------
+/**
+ * Build body markdown. If `content` is supplied and already starts with
+ * a matching H1, use as-is. Otherwise, prepend `# title\n\n`.
+ */
+export function buildBody(title, content) {
+    if (content !== undefined) {
+        // If content starts with the correct H1, keep it
+        if (content.startsWith(`# ${title}`)) {
+            return content;
+        }
+        // If it starts with a different H1, replace it
+        if (content.startsWith("# ")) {
+            const rest = content.slice(content.indexOf("\n"));
+            return `# ${title}${rest}`;
+        }
+        return `# ${title}\n\n${content}`;
+    }
+    return `# ${title}\n\n`;
+}
+/**
+ * Rewrite the leading H1 in an existing body file.
+ */
+export async function rewriteH1(filePath, newTitle) {
+    const body = await readFile(filePath, "utf-8");
+    if (body.startsWith("# ")) {
+        const rest = body.slice(body.indexOf("\n"));
+        await writeFile(filePath, `# ${newTitle}${rest}`, "utf-8");
+    }
+    else {
+        await writeFile(filePath, `# ${newTitle}\n\n${body}`, "utf-8");
+    }
+}
+//# sourceMappingURL=storage-utils.js.map

package/dist/utils/storage-utils.js.map

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

package/dist/utils/task-store.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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.
+ */
+export type { FileRef, TaskPriority, TaskStatus } from "./storage-utils.js";
+export { TASK_PRIORITIES, TASK_STATUSES } from "./storage-utils.js";
+export interface TaskMeta {
+    id: string;
+    normalizedId: string;
+    title: string;
+    status: import("./storage-utils.js").TaskStatus;
+    priority: import("./storage-utils.js").TaskPriority;
+    planId?: string;
+    sourceFiles?: import("./storage-utils.js").FileRef[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface TaskIndex {
+    tasks: TaskMeta[];
+}
+export interface CreateTaskInput {
+    title: string;
+    status?: import("./storage-utils.js").TaskStatus;
+    priority?: import("./storage-utils.js").TaskPriority;
+    planId?: string;
+    sourceFiles?: import("./storage-utils.js").FileRef[];
+    now?: string;
+}
+export interface UpdateTaskInput {
+    id: string;
+    title?: string;
+    status?: import("./storage-utils.js").TaskStatus;
+    priority?: import("./storage-utils.js").TaskPriority;
+    planId?: string | null;
+    sourceFiles?: import("./storage-utils.js").FileRef[];
+    now?: string;
+}
+export declare function renderTasksMd(projectDir: string, index: TaskIndex): Promise<void>;
+export declare function createTask(projectDir: string, input: CreateTaskInput): Promise<TaskMeta>;
+export declare function listTasks(projectDir: string, filters?: {
+    status?: import("./storage-utils.js").TaskStatus;
+    priority?: import("./storage-utils.js").TaskPriority;
+}): Promise<TaskMeta[]>;
+export declare function getTask(projectDir: string, taskId: string): Promise<TaskMeta>;
+export declare function updateTask(projectDir: string, input: UpdateTaskInput): Promise<TaskMeta>;
+export declare function deleteTask(projectDir: string, taskId: string): Promise<void>;
+//# sourceMappingURL=task-store.d.ts.map

package/dist/utils/task-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-store.d.ts","sourceRoot":"","sources":["../../src/utils/task-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMpE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,oBAAoB,EAAE,UAAU,CAAC;IAChD,QAAQ,EAAE,OAAO,oBAAoB,EAAE,YAAY,CAAC;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,oBAAoB,EAAE,OAAO,EAAE,CAAC;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,SAAS;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAMD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,oBAAoB,EAAE,UAAU,CAAC;IACjD,QAAQ,CAAC,EAAE,OAAO,oBAAoB,EAAE,YAAY,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,oBAAoB,EAAE,OAAO,EAAE,CAAC;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,oBAAoB,EAAE,UAAU,CAAC;IACjD,QAAQ,CAAC,EAAE,OAAO,oBAAoB,EAAE,YAAY,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,oBAAoB,EAAE,OAAO,EAAE,CAAC;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA0CD,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCvF;AAMD,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkC9F;AAED,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,OAAO,oBAAoB,EAAE,UAAU,CAAC;IACjD,QAAQ,CAAC,EAAE,OAAO,oBAAoB,EAAE,YAAY,CAAC;CACtD,GACA,OAAO,CAAC,QAAQ,EAAE,CAAC,CAYrB;AAED,wBAAsB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQnF;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuC9F;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlF"}