@rryando/arcs 3.0.0

package/dist/utils/loop-state.js.map

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

package/dist/utils/paths.d.ts

@@ -0,0 +1,16 @@
+export declare const PACKAGE_ROOT: string;
+/**
+ * Returns the data directory path.
+ * Priority: ARCS_DATA_DIR env var > ~/.arcs
+ */
+export declare function getDataDir(): string;
+/**
+ * Returns the absolute path to a project's data directory.
+ */
+export declare function getProjectDir(slug: string): string;
+/**
+ * Ensures the data directory exists, is writable, and contains a seed meta.json.
+ * Call once at startup.
+ */
+export declare function ensureDataDir(): void;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY,QAAwC,CAAC;AAIlE;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAMnC;AAuBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAgBpC"}

package/dist/utils/paths.js

@@ -0,0 +1,66 @@
+import { accessSync, constants, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Root of the installed package (read-only assets: templates/, skills/).
+ * Resolves from the compiled JS location: dist/utils/paths.js -> ../../
+ */
+const __filename = fileURLToPath(import.meta.url);
+export const PACKAGE_ROOT = resolve(dirname(__filename), "../..");
+const DEFAULT_DATA_DIR_NAME = ".arcs";
+/**
+ * Returns the data directory path.
+ * Priority: ARCS_DATA_DIR env var > ~/.arcs
+ */
+export function getDataDir() {
+    const envDir = process.env.ARCS_DATA_DIR;
+    if (envDir) {
+        return resolve(envDir);
+    }
+    return resolve(homedir(), DEFAULT_DATA_DIR_NAME);
+}
+/**
+ * Checks if a directory is writable by attempting a test write.
+ * Throws a descriptive error if not writable.
+ */
+function assertWritable(dir) {
+    try {
+        accessSync(dir, constants.W_OK);
+    }
+    catch {
+        const source = process.env.ARCS_DATA_DIR
+            ? `ARCS_DATA_DIR="${process.env.ARCS_DATA_DIR}"`
+            : `~/${DEFAULT_DATA_DIR_NAME}`;
+        throw new Error(`Data directory "${dir}" is not writable.\n` +
+            `Source: ${source}\n` +
+            `Fix: check permissions, or set ARCS_DATA_DIR to a writable path.`);
+    }
+}
+const SEED_META = JSON.stringify({ version: "1.0", projects: [] }, null, 2);
+/**
+ * Returns the absolute path to a project's data directory.
+ */
+export function getProjectDir(slug) {
+    return resolve(getDataDir(), "projects", slug);
+}
+/**
+ * Ensures the data directory exists, is writable, and contains a seed meta.json.
+ * Call once at startup.
+ */
+export function ensureDataDir() {
+    const dataDir = getDataDir();
+    // Create dir (and parents) if missing
+    mkdirSync(dataDir, { recursive: true });
+    // Verify writable
+    assertWritable(dataDir);
+    // Seed meta.json if absent
+    const metaPath = resolve(dataDir, "meta.json");
+    try {
+        accessSync(metaPath, constants.F_OK);
+    }
+    catch {
+        writeFileSync(metaPath, SEED_META, "utf-8");
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AAElE,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,qBAAqB,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa;YACtC,CAAC,CAAC,kBAAkB,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG;YAChD,CAAC,CAAC,KAAK,qBAAqB,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,mBAAmB,GAAG,sBAAsB;YAC1C,WAAW,MAAM,IAAI;YACrB,kEAAkE,CACrE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,OAAO,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,sCAAsC;IACtC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,kBAAkB;IAClB,cAAc,CAAC,OAAO,CAAC,CAAC;IAExB,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Plan CRUD storage for ARCS projects.
+ *
+ * Provides create, update, delete, and index-read operations for plans,
+ * with automatic index maintenance and rebuild-on-read resilience.
+ */
+export type { FileRef, PlanStatus } from "./storage-utils.js";
+export { PLAN_STATUSES } from "./storage-utils.js";
+export interface PlanMeta {
+    id: string;
+    normalizedId: string;
+    title: string;
+    status: import("./storage-utils.js").PlanStatus;
+    keywords: string[];
+    summary: string;
+    sourceFiles?: import("./storage-utils.js").FileRef[];
+    file: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreatePlanInput {
+    id: string;
+    title: string;
+    status: import("./storage-utils.js").PlanStatus;
+    keywords: string[];
+    summary?: string;
+    content?: string;
+    sourceFiles?: import("./storage-utils.js").FileRef[];
+    now?: string;
+}
+export interface UpdatePlanInput {
+    id: string;
+    status?: import("./storage-utils.js").PlanStatus;
+    title?: string;
+    summary?: string;
+    keywords?: string[];
+    sourceFiles?: import("./storage-utils.js").FileRef[];
+    now?: string;
+}
+export declare function createPlan(projectDir: string, input: CreatePlanInput): Promise<PlanMeta>;
+export declare function updatePlan(projectDir: string, input: UpdatePlanInput): Promise<PlanMeta>;
+export declare function deletePlan(projectDir: string, id: string): Promise<void>;
+export declare function readPlanIndex(projectDir: string): Promise<{
+    plans: PlanMeta[];
+}>;
+//# sourceMappingURL=plan-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-store.d.ts","sourceRoot":"","sources":["../../src/utils/plan-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,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,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,oBAAoB,EAAE,OAAO,EAAE,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,oBAAoB,EAAE,UAAU,CAAC;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,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,MAAM,CAAC,EAAE,OAAO,oBAAoB,EAAE,UAAU,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,oBAAoB,EAAE,OAAO,EAAE,CAAC;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAmED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuC9F;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8C9F;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9E;AAED,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAmBtF"}

package/dist/utils/plan-store.js

@@ -0,0 +1,184 @@
+/**
+ * Plan CRUD storage for ARCS projects.
+ *
+ * Provides create, update, delete, and index-read operations for plans,
+ * with automatic index maintenance and rebuild-on-read resilience.
+ */
+import { readdir, writeFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { invalidateGraphCache } from "../retrieval/graph-invalidate.js";
+import { indexRebuildFailed, invalidFileFormat, itemNotFound, normalizedIdCollision, } from "./errors.js";
+import { withLock } from "./file-lock.js";
+import { readJsonSafe } from "./json.js";
+import { planMetaSchema } from "./json-schemas.js";
+import { normalizeIdentifier } from "./slug.js";
+import { buildBody, ensureDir, fileExists, nowISO, rewriteH1, sanitizeFileRefs, sanitizeKeywords, validatePlanStatus, writeJson, } from "./storage-utils.js";
+export { PLAN_STATUSES } from "./storage-utils.js";
+// ---------------------------------------------------------------------------
+// Index helpers
+// ---------------------------------------------------------------------------
+async function rebuildPlanIndex(plansDir) {
+    const files = (await readdir(plansDir)).filter((f) => f.endsWith(".meta.json"));
+    const plans = [];
+    const errors = [];
+    for (const file of files) {
+        try {
+            const filePath = join(plansDir, file);
+            const raw = await readJsonSafe(filePath);
+            if (raw === undefined) {
+                errors.push(file);
+                continue;
+            }
+            const result = planMetaSchema.safeParse(raw);
+            if (!result.success) {
+                throw invalidFileFormat(filePath, result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", "));
+            }
+            plans.push(result.data);
+        }
+        catch (e) {
+            if (e instanceof Error && e.name === "DagError")
+                throw e;
+            errors.push(file);
+        }
+    }
+    if (errors.length > 0) {
+        throw indexRebuildFailed("plans", `corrupt meta files: ${errors.join(", ")}`);
+    }
+    const index = { plans };
+    await writeJson(join(plansDir, "index.json"), index);
+    return index;
+}
+async function isPlanIndexStale(plansDir, index) {
+    const metaFiles = (await readdir(plansDir)).filter((f) => f.endsWith(".meta.json"));
+    if (metaFiles.length !== index.plans.length)
+        return true;
+    for (const entry of index.plans) {
+        const metaPath = join(plansDir, `${entry.normalizedId}.meta.json`);
+        const diskMeta = await readJsonSafe(metaPath);
+        if (!diskMeta || diskMeta.updatedAt !== entry.updatedAt) {
+            return true;
+        }
+    }
+    return false;
+}
+async function writePlanIndex(plansDir, index) {
+    const indexPath = join(plansDir, "index.json");
+    await withLock(indexPath, async () => {
+        await writeJson(indexPath, index);
+    });
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export async function createPlan(projectDir, input) {
+    validatePlanStatus(input.status);
+    const keywords = sanitizeKeywords(input.keywords);
+    const sourceFiles = input.sourceFiles ? sanitizeFileRefs(input.sourceFiles) : undefined;
+    const normalizedId = normalizeIdentifier(input.id);
+    const plansDir = join(projectDir, "plans");
+    await ensureDir(plansDir);
+    const metaPath = join(plansDir, `${normalizedId}.meta.json`);
+    if (await fileExists(metaPath)) {
+        throw normalizedIdCollision("plan", input.id, normalizedId);
+    }
+    const ts = nowISO(input.now);
+    const bodyFile = join("plans", `${normalizedId}.md`);
+    const meta = {
+        id: normalizedId,
+        normalizedId,
+        title: input.title,
+        status: input.status,
+        keywords,
+        summary: input.summary ?? "",
+        ...(sourceFiles && { sourceFiles }),
+        file: bodyFile,
+        createdAt: ts,
+        updatedAt: ts,
+    };
+    await writeJson(metaPath, meta);
+    await writeFile(join(projectDir, bodyFile), buildBody(input.title, input.content), "utf-8");
+    const index = (await readJsonSafe(join(plansDir, "index.json"))) ?? { plans: [] };
+    index.plans.push(meta);
+    await writePlanIndex(plansDir, index);
+    invalidateGraphCache(basename(projectDir));
+    return meta;
+}
+export async function updatePlan(projectDir, input) {
+    if (input.status !== undefined) {
+        validatePlanStatus(input.status);
+    }
+    const normalizedId = normalizeIdentifier(input.id);
+    const plansDir = join(projectDir, "plans");
+    const metaPath = join(plansDir, `${normalizedId}.meta.json`);
+    const meta = await readJsonSafe(metaPath);
+    if (!meta) {
+        throw itemNotFound("plan", input.id);
+    }
+    const ts = nowISO(input.now);
+    if (input.status !== undefined)
+        meta.status = input.status;
+    if (input.title !== undefined && input.title !== meta.title) {
+        const bodyPath = join(projectDir, meta.file);
+        await rewriteH1(bodyPath, input.title);
+        meta.title = input.title;
+    }
+    if (input.summary !== undefined)
+        meta.summary = input.summary;
+    if (input.keywords !== undefined)
+        meta.keywords = sanitizeKeywords(input.keywords);
+    if (input.sourceFiles !== undefined) {
+        if (input.sourceFiles.length === 0) {
+            delete meta.sourceFiles;
+        }
+        else {
+            meta.sourceFiles = sanitizeFileRefs(input.sourceFiles);
+        }
+    }
+    meta.updatedAt = ts;
+    await writeJson(metaPath, meta);
+    const index = (await readJsonSafe(join(plansDir, "index.json"))) ?? { plans: [] };
+    const idx = index.plans.findIndex((p) => p.normalizedId === normalizedId);
+    if (idx >= 0) {
+        index.plans[idx] = meta;
+    }
+    else {
+        index.plans.push(meta);
+    }
+    await writePlanIndex(plansDir, index);
+    invalidateGraphCache(basename(projectDir));
+    return meta;
+}
+export async function deletePlan(projectDir, id) {
+    const normalizedId = normalizeIdentifier(id);
+    const plansDir = join(projectDir, "plans");
+    const metaPath = join(plansDir, `${normalizedId}.meta.json`);
+    const meta = await readJsonSafe(metaPath);
+    if (!meta) {
+        throw itemNotFound("plan", id);
+    }
+    const { unlink } = await import("node:fs/promises");
+    const bodyPath = join(projectDir, meta.file);
+    await unlink(metaPath);
+    if (await fileExists(bodyPath)) {
+        await unlink(bodyPath);
+    }
+    const index = (await readJsonSafe(join(plansDir, "index.json"))) ?? { plans: [] };
+    index.plans = index.plans.filter((p) => p.normalizedId !== normalizedId);
+    await writePlanIndex(plansDir, index);
+}
+export async function readPlanIndex(projectDir) {
+    const plansDir = join(projectDir, "plans");
+    if (!(await fileExists(plansDir))) {
+        return { plans: [] };
+    }
+    const indexPath = join(plansDir, "index.json");
+    const index = await readJsonSafe(indexPath);
+    if (!index || !Array.isArray(index.plans)) {
+        return rebuildPlanIndex(plansDir);
+    }
+    if (await isPlanIndexStale(plansDir, index)) {
+        return rebuildPlanIndex(plansDir);
+    }
+    return index;
+}
+//# sourceMappingURL=plan-store.js.map

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

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

package/dist/utils/project-documents.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared constants for the structured project document model.
+ */
+export declare const PROJECT_DOC_FILES: {
+    readonly overview: "overview.md";
+    readonly tasks: "tasks.md";
+    readonly dependencies: "dependencies.md";
+    readonly knowledge: "knowledge.md";
+};
+export type ProjectDocType = keyof typeof PROJECT_DOC_FILES;
+export interface ProjectMeta {
+    id: string;
+    name: string;
+    description: string;
+    status: string;
+    repoUrl?: string;
+    createdAt: string;
+    workspacePaths: string[];
+}
+//# sourceMappingURL=project-documents.d.ts.map

package/dist/utils/project-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-documents.d.ts","sourceRoot":"","sources":["../../src/utils/project-documents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/utils/project-documents.js

@@ -0,0 +1,10 @@
+/**
+ * Shared constants for the structured project document model.
+ */
+export const PROJECT_DOC_FILES = {
+    overview: "overview.md",
+    tasks: "tasks.md",
+    dependencies: "dependencies.md",
+    knowledge: "knowledge.md",
+};
+//# sourceMappingURL=project-documents.js.map

package/dist/utils/project-documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-documents.js","sourceRoot":"","sources":["../../src/utils/project-documents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,aAAa;IACvB,KAAK,EAAE,UAAU;IACjB,YAAY,EAAE,iBAAiB;IAC/B,SAAS,EAAE,cAAc;CACjB,CAAC"}

package/dist/utils/project-memory.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Backward-compatible barrel re-export for project storage modules.
+ *
+ * All storage operations are now split across focused modules:
+ * - storage-utils.ts  — shared enums, types, filesystem helpers, validation
+ * - plan-store.ts     — Plan CRUD and index maintenance
+ * - knowledge-store.ts — Knowledge entry CRUD and index maintenance
+ * - task-store.ts     — Task CRUD, index, and markdown render
+ *
+ * All original exports are preserved here for backward compatibility.
+ */
+export * from "./knowledge-store.js";
+export * from "./plan-store.js";
+export * from "./storage-utils.js";
+export * from "./task-store.js";
+//# sourceMappingURL=project-memory.d.ts.map

package/dist/utils/project-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory.d.ts","sourceRoot":"","sources":["../../src/utils/project-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/utils/project-memory.js

@@ -0,0 +1,16 @@
+/**
+ * Backward-compatible barrel re-export for project storage modules.
+ *
+ * All storage operations are now split across focused modules:
+ * - storage-utils.ts  — shared enums, types, filesystem helpers, validation
+ * - plan-store.ts     — Plan CRUD and index maintenance
+ * - knowledge-store.ts — Knowledge entry CRUD and index maintenance
+ * - task-store.ts     — Task CRUD, index, and markdown render
+ *
+ * All original exports are preserved here for backward compatibility.
+ */
+export * from "./knowledge-store.js";
+export * from "./plan-store.js";
+export * from "./storage-utils.js";
+export * from "./task-store.js";
+//# sourceMappingURL=project-memory.js.map

package/dist/utils/project-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory.js","sourceRoot":"","sources":["../../src/utils/project-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/utils/project-resolver.d.ts

@@ -0,0 +1,28 @@
+import type { CLIResult } from "../cli/command-registry.js";
+export interface ResolvedProject {
+    slug: string;
+    name: string;
+    description: string;
+    projectDir: string;
+}
+type ResolveSuccess = {
+    ok: true;
+} & ResolvedProject;
+type ResolveFailure = {
+    ok: false;
+    result: CLIResult;
+};
+export type ResolveResult = ResolveSuccess | ResolveFailure;
+/**
+ * Resolve a project from:
+ * - undefined → uses cwd
+ * - absolute path → workspace match
+ * - slug (no `/` or `.`) → direct meta lookup then workspace match
+ * - relative path → resolved then workspace match
+ *
+ * Returns `{ ok: true, slug, name, projectDir }` on success,
+ * or `{ ok: false, result: CLIResult }` with a failure envelope.
+ */
+export declare function resolveProject(pathOrSlug: string | undefined): Promise<ResolveResult>;
+export {};
+//# sourceMappingURL=project-resolver.d.ts.map

package/dist/utils/project-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/project-resolver.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAW5D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,eAAe,CAAC;AACrD,KAAK,cAAc,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;AAE5D;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAgG3F"}

package/dist/utils/project-resolver.js

@@ -0,0 +1,119 @@
+// ---------------------------------------------------------------------------
+// project-resolver — Shared project resolution from path or slug
+// ---------------------------------------------------------------------------
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { ERROR_CODES } from "../cli/command-registry.js";
+import { failure } from "../cli/output-envelope.js";
+import { readRootMeta } from "./dag.js";
+import { readJsonSafe, validateJson } from "./json.js";
+import { projectMetaSchema } from "./json-schemas.js";
+import { getDataDir, getProjectDir } from "./paths.js";
+import { findBestMatch } from "./workspace-match.js";
+/**
+ * Resolve a project from:
+ * - undefined → uses cwd
+ * - absolute path → workspace match
+ * - slug (no `/` or `.`) → direct meta lookup then workspace match
+ * - relative path → resolved then workspace match
+ *
+ * Returns `{ ok: true, slug, name, projectDir }` on success,
+ * or `{ ok: false, result: CLIResult }` with a failure envelope.
+ */
+export async function resolveProject(pathOrSlug) {
+    let queryPath;
+    if (!pathOrSlug) {
+        queryPath = process.cwd();
+    }
+    else if (pathOrSlug.startsWith("/")) {
+        queryPath = pathOrSlug;
+    }
+    else if (!pathOrSlug.includes("/") && !pathOrSlug.includes(".")) {
+        // Slug resolution
+        const dataDir = getDataDir();
+        const projMetaPath = resolve(dataDir, "projects", pathOrSlug, "meta.json");
+        if (!existsSync(projMetaPath)) {
+            return {
+                ok: false,
+                result: failure(ERROR_CODES.PROJECT_NOT_FOUND, `Project "${pathOrSlug}" not found in ARCS`),
+            };
+        }
+        try {
+            const raw = await readFile(projMetaPath, "utf-8");
+            const projMeta = JSON.parse(raw);
+            const paths = Array.isArray(projMeta.workspacePaths) ? projMeta.workspacePaths : [];
+            if (paths.length === 0) {
+                return {
+                    ok: false,
+                    result: failure("no_workspace_paths", `Project "${pathOrSlug}" has no workspace paths configured`),
+                };
+            }
+            const first = paths[0];
+            queryPath = first.startsWith("~") ? resolve(homedir(), first.slice(2)) : resolve(first);
+        }
+        catch {
+            return {
+                ok: false,
+                result: failure("read_error", `Could not read project metadata for "${pathOrSlug}"`),
+            };
+        }
+    }
+    else {
+        queryPath = resolve(pathOrSlug);
+        if (!existsSync(queryPath)) {
+            return {
+                ok: false,
+                result: failure("path_not_found", `Path "${pathOrSlug}" does not exist.`),
+            };
+        }
+    }
+    const dataDir = getDataDir();
+    let rootMeta;
+    try {
+        rootMeta = await readRootMeta(dataDir);
+    }
+    catch {
+        return { ok: false, result: failure("read_error", "Could not read ARCS data directory") };
+    }
+    const workspaceProjects = [];
+    const projectMetas = new Map();
+    for (const node of rootMeta.projects) {
+        const metaPath = resolve(dataDir, "projects", node.id, "meta.json");
+        if (!existsSync(metaPath))
+            continue;
+        const raw = await readJsonSafe(metaPath);
+        if (raw === undefined)
+            continue;
+        const meta = validateJson(raw, projectMetaSchema, metaPath);
+        const paths = Array.isArray(meta.workspacePaths) ? meta.workspacePaths : [];
+        if (paths.length > 0) {
+            workspaceProjects.push({ slug: node.id, workspacePaths: paths });
+            projectMetas.set(node.id, meta);
+        }
+    }
+    const matchResult = findBestMatch(queryPath, workspaceProjects);
+    if (matchResult.kind === "none") {
+        return {
+            ok: false,
+            result: failure("no_match", `No project found matching path "${queryPath}"`),
+        };
+    }
+    if (matchResult.kind === "ambiguous") {
+        return {
+            ok: false,
+            result: failure("ambiguous_match", `Ambiguous match for "${queryPath}"`),
+        };
+    }
+    const slug = matchResult.slug;
+    const meta = projectMetas.get(slug);
+    return {
+        ok: true,
+        slug,
+        name: meta?.name ?? slug,
+        description: meta?.description ?? "",
+        projectDir: getProjectDir(slug),
+    };
+}
+//# sourceMappingURL=project-resolver.js.map

package/dist/utils/project-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-resolver.js","sourceRoot":"","sources":["../../src/utils/project-resolver.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAiB,YAAY,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,aAAa,EAAyB,MAAM,sBAAsB,CAAC;AAe5E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAA8B;IACjE,IAAI,SAAiB,CAAC;IAEtB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;SAAM,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,SAAS,GAAG,UAAU,CAAC;IACzB,CAAC;SAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClE,kBAAkB;QAClB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAC3E,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,YAAY,UAAU,qBAAqB,CAAC;aAC5F,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACjC,MAAM,KAAK,GAAa,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE,OAAO,CACb,oBAAoB,EACpB,YAAY,UAAU,qCAAqC,CAC5D;iBACF,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1F,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,wCAAwC,UAAU,GAAG,CAAC;aACrF,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,SAAS,UAAU,mBAAmB,CAAC;aAC1E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,oCAAoC,CAAC,EAAE,CAAC;IAC5F,CAAC;IAGD,MAAM,iBAAiB,GAAuB,EAAE,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAc,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACpE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAS;QACpC,MAAM,GAAG,GAAG,MAAM,YAAY,CAAU,QAAQ,CAAC,CAAC;QAClD,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,iBAAiB,EAAE,QAAQ,CAAO,CAAC;QAClE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAChE,IAAI,WAAW,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAChC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,mCAAmC,SAAS,GAAG,CAAC;SAC7E,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACrC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE,wBAAwB,SAAS,GAAG,CAAC;SACzE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI;QACJ,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;QACxB,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,EAAE;QACpC,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/utils/quick-scan.d.ts

@@ -0,0 +1,13 @@
+export interface TodoEntry {
+    file: string;
+    line: number;
+    text: string;
+}
+export interface QuickScanResult {
+    recentBranches: string[];
+    recentCommitTopics: string[];
+    todos: TodoEntry[];
+    suggestedTasks: string[];
+}
+export declare function quickScan(repoPath: string): QuickScanResult;
+//# sourceMappingURL=quick-scan.d.ts.map

package/dist/utils/quick-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-scan.d.ts","sourceRoot":"","sources":["../../src/utils/quick-scan.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAyID,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAoC3D"}