@rryando/arcs 3.0.0

package/dist/retrieval/graph-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.d.ts","sourceRoot":"","sources":["../../src/retrieval/graph-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAE9D,MAAM,MAAM,YAAY,GACpB,sBAAsB,GACtB,oBAAoB,GACpB,wBAAwB,GACxB,oBAAoB,GACpB,iBAAiB,GACjB,oBAAoB,CAAC;AAEzB,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAChC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAOrD,CAAC"}

package/dist/retrieval/graph-types.js

@@ -0,0 +1,12 @@
+/**
+ * Core types for ARCS's graph-based retrieval layer.
+ */
+export const EDGE_WEIGHTS = {
+    task_belongs_to_plan: 1.0,
+    shares_source_file: 0.9,
+    knowledge_touches_file: 0.85,
+    plan_contains_task: 0.8,
+    shares_keywords: 0.5,
+    project_depends_on: 0.3,
+};
+//# sourceMappingURL=graph-types.js.map

package/dist/retrieval/graph-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.js","sourceRoot":"","sources":["../../src/retrieval/graph-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+CH,MAAM,CAAC,MAAM,YAAY,GAAiC;IACxD,oBAAoB,EAAE,GAAG;IACzB,kBAAkB,EAAE,GAAG;IACvB,sBAAsB,EAAE,IAAI;IAC5B,kBAAkB,EAAE,GAAG;IACvB,eAAe,EAAE,GAAG;IACpB,kBAAkB,EAAE,GAAG;CACxB,CAAC"}

package/dist/retrieval/index-builder.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Adapter that builds BM25 retrieval indexes from ARCS project knowledge and plan entries.
+ */
+export interface ScoredEntry {
+    id: string;
+    type: "knowledge" | "plan";
+    title: string;
+    summary: string;
+    score: number;
+}
+export interface RetrievalIndex {
+    searchKnowledge(query: string, limit?: number): ScoredEntry[];
+    searchPlans(query: string, limit?: number): ScoredEntry[];
+    searchAll(query: string, limit?: number): ScoredEntry[];
+}
+/**
+ * Builds a retrieval index for a project's knowledge and plan entries.
+ * Gracefully returns empty results if the project data cannot be read.
+ */
+export declare function buildProjectRetrievalIndex(slug: string): Promise<RetrievalIndex>;
+//# sourceMappingURL=index-builder.d.ts.map

package/dist/retrieval/index-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-builder.d.ts","sourceRoot":"","sources":["../../src/retrieval/index-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAC9D,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAC1D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACzD;AA6CD;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA4DtF"}

package/dist/retrieval/index-builder.js

@@ -0,0 +1,94 @@
+/**
+ * Adapter that builds BM25 retrieval indexes from ARCS project knowledge and plan entries.
+ */
+import { getProjectDir } from "../utils/paths.js";
+import { readKnowledgeIndex, readPlanIndex, } from "../utils/project-memory.js";
+import { createBm25Index } from "./bm25.js";
+const FIELD_WEIGHTS = { title: 3, keywords: 2, summary: 1 };
+function knowledgeToDocument(entry) {
+    return {
+        id: entry.id,
+        fields: {
+            title: entry.title,
+            keywords: entry.keywords.join(" "),
+            summary: entry.summary ?? "",
+        },
+    };
+}
+function planToDocument(plan) {
+    return {
+        id: plan.id,
+        fields: {
+            title: plan.title,
+            keywords: plan.keywords.join(" "),
+            summary: plan.summary ?? "",
+        },
+    };
+}
+function buildSearchFn(index, metaMap) {
+    return (query, limit = 10) => {
+        const results = index.search(query, limit);
+        return results.map((r) => {
+            const meta = metaMap.get(r.id);
+            return {
+                id: r.id,
+                type: meta.type,
+                title: meta.title,
+                summary: meta.summary,
+                score: r.score,
+            };
+        });
+    };
+}
+/**
+ * Builds a retrieval index for a project's knowledge and plan entries.
+ * Gracefully returns empty results if the project data cannot be read.
+ */
+export async function buildProjectRetrievalIndex(slug) {
+    const projectDir = getProjectDir(slug);
+    let knowledgeEntries = [];
+    let planEntries = [];
+    try {
+        const knowledgeIndex = await readKnowledgeIndex(projectDir);
+        knowledgeEntries = knowledgeIndex.entries;
+    }
+    catch {
+        // Graceful: empty knowledge
+    }
+    try {
+        const planIndex = await readPlanIndex(projectDir);
+        planEntries = planIndex.plans;
+    }
+    catch {
+        // Graceful: empty plans
+    }
+    // Build BM25 indexes
+    const knowledgeDocs = knowledgeEntries.map(knowledgeToDocument);
+    const planDocs = planEntries.map(planToDocument);
+    const knowledgeBm25 = createBm25Index(knowledgeDocs, FIELD_WEIGHTS);
+    const planBm25 = createBm25Index(planDocs, FIELD_WEIGHTS);
+    // Build meta maps for hydrating results
+    const knowledgeMetaMap = new Map();
+    for (const entry of knowledgeEntries) {
+        knowledgeMetaMap.set(entry.id, {
+            title: entry.title,
+            summary: entry.summary ?? "",
+            type: "knowledge",
+        });
+    }
+    const planMetaMap = new Map();
+    for (const plan of planEntries) {
+        planMetaMap.set(plan.id, { title: plan.title, summary: plan.summary ?? "", type: "plan" });
+    }
+    const searchKnowledge = buildSearchFn(knowledgeBm25, knowledgeMetaMap);
+    const searchPlans = buildSearchFn(planBm25, planMetaMap);
+    const searchAll = (query, limit = 10) => {
+        const knowledgeResults = searchKnowledge(query, limit);
+        const planResults = searchPlans(query, limit);
+        const merged = [...knowledgeResults, ...planResults];
+        merged.sort((a, b) => b.score - a.score);
+        return merged.slice(0, limit);
+    };
+    return { searchKnowledge, searchPlans, searchAll };
+}
+//# sourceMappingURL=index-builder.js.map

package/dist/retrieval/index-builder.js.map

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

package/dist/retrieval/knowledge-selection.d.ts

@@ -0,0 +1,7 @@
+import { type KnowledgeMeta } from "../utils/project-memory.js";
+/**
+ * Selects top knowledge entries using graph traversal (when taskId provided)
+ * or recency-based fallback. Returns up to 10 entries, deduplicated by id.
+ */
+export declare function selectKnowledgeEntries(slug: string, entries: KnowledgeMeta[], taskId?: string, audience?: string): Promise<KnowledgeMeta[]>;
+//# sourceMappingURL=knowledge-selection.d.ts.map

package/dist/retrieval/knowledge-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-selection.d.ts","sourceRoot":"","sources":["../../src/retrieval/knowledge-selection.ts"],"names":[],"mappings":"AAKA,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAKzE;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,EAAE,EACxB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,EAAE,CAAC,CAsE1B"}

package/dist/retrieval/knowledge-selection.js

@@ -0,0 +1,80 @@
+// ---------------------------------------------------------------------------
+// Knowledge entry selection using graph traversal + BM25 + recency fallback
+// ---------------------------------------------------------------------------
+import { getProjectDir } from "../utils/paths.js";
+import { getTask } from "../utils/project-memory.js";
+import { safeTime } from "../utils/workflow-policy.js";
+import { retrieveRelated } from "./graph-retrieval.js";
+import { retrieveForTask } from "./task-scoped.js";
+/**
+ * Selects top knowledge entries using graph traversal (when taskId provided)
+ * or recency-based fallback. Returns up to 10 entries, deduplicated by id.
+ */
+export async function selectKnowledgeEntries(slug, entries, taskId, audience) {
+    const MAX_ENTRIES = 10;
+    const entryMap = new Map(entries.map((e) => [e.id, e]));
+    if (!taskId) {
+        // No task context — pure recency
+        const sorted = [...entries].sort((a, b) => safeTime(b.updatedAt) - safeTime(a.updatedAt));
+        return sorted.slice(0, MAX_ENTRIES);
+    }
+    // Try graph retrieval first
+    const graphResults = await retrieveRelated(slug, `task:${taskId}`, {
+        limit: 5,
+        types: ["knowledge"],
+        audience,
+    });
+    const selectedIds = new Set();
+    const selected = [];
+    if (graphResults.length >= 3) {
+        // Use graph results as primary
+        for (const r of graphResults) {
+            const entry = entryMap.get(r.id);
+            if (entry && !selectedIds.has(r.id)) {
+                selectedIds.add(r.id);
+                selected.push(entry);
+            }
+        }
+    }
+    else {
+        // Sparse graph — fall back to BM25
+        const projectDir = getProjectDir(slug);
+        let taskContext;
+        try {
+            const task = await getTask(projectDir, taskId);
+            taskContext = {
+                title: task.title,
+                sourceFiles: task.sourceFiles,
+            };
+        }
+        catch {
+            // Task not found — fall through to recency
+        }
+        if (taskContext) {
+            const bm25Results = await retrieveForTask(slug, taskContext, 5);
+            for (const r of bm25Results) {
+                if (r.type === "knowledge") {
+                    const entry = entryMap.get(r.id);
+                    if (entry && !selectedIds.has(r.id)) {
+                        selectedIds.add(r.id);
+                        selected.push(entry);
+                    }
+                }
+            }
+        }
+    }
+    // Fill remaining slots with recency-sorted entries not already selected
+    if (selected.length < MAX_ENTRIES) {
+        const sorted = [...entries].sort((a, b) => safeTime(b.updatedAt) - safeTime(a.updatedAt));
+        for (const e of sorted) {
+            if (selected.length >= MAX_ENTRIES)
+                break;
+            if (!selectedIds.has(e.id)) {
+                selectedIds.add(e.id);
+                selected.push(e);
+            }
+        }
+    }
+    return selected;
+}
+//# sourceMappingURL=knowledge-selection.js.map

package/dist/retrieval/knowledge-selection.js.map

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

package/dist/retrieval/task-scoped.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Task-scoped context retrieval — expands a task's metadata into a query
+ * and searches the project's unified retrieval index for relevant entries.
+ */
+import { type ScoredEntry } from "./index-builder.js";
+export interface TaskContext {
+    title: string;
+    planKeywords?: string[];
+    sourceFiles?: Array<{
+        path: string;
+        anchor?: string;
+    }>;
+}
+/**
+ * Builds an expanded query string from task metadata for better recall.
+ */
+export declare function buildTaskQuery(task: TaskContext): string;
+/**
+ * Retrieves relevant knowledge and plan entries for a given task context.
+ * Returns top-N entries sorted by relevance score.
+ */
+export declare function retrieveForTask(slug: string, task: TaskContext, limit?: number): Promise<ScoredEntry[]>;
+//# sourceMappingURL=task-scoped.d.ts.map

package/dist/retrieval/task-scoped.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-scoped.d.ts","sourceRoot":"","sources":["../../src/retrieval/task-scoped.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA8B,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAElF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAkBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAkBxD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EACjB,KAAK,SAAK,GACT,OAAO,CAAC,WAAW,EAAE,CAAC,CAQxB"}

package/dist/retrieval/task-scoped.js

@@ -0,0 +1,51 @@
+/**
+ * Task-scoped context retrieval — expands a task's metadata into a query
+ * and searches the project's unified retrieval index for relevant entries.
+ */
+import { buildProjectRetrievalIndex } from "./index-builder.js";
+/**
+ * Extracts meaningful path segments from a source file path.
+ * Takes the last 2-3 segments (directories + filename) and strips extensions.
+ */
+function expandSourceFile(file) {
+    const segments = file.path.split("/").filter(Boolean);
+    const meaningful = segments.slice(-3);
+    // Strip extension from filename
+    const last = meaningful[meaningful.length - 1];
+    if (last) {
+        meaningful[meaningful.length - 1] = last.replace(/\.[^.]+$/, "");
+    }
+    const parts = meaningful.join(" ");
+    return file.anchor ? `${parts} ${file.anchor}` : parts;
+}
+/**
+ * Builds an expanded query string from task metadata for better recall.
+ */
+export function buildTaskQuery(task) {
+    const parts = [];
+    if (task.title) {
+        parts.push(task.title);
+    }
+    if (task.planKeywords?.length) {
+        parts.push(task.planKeywords.join(" "));
+    }
+    if (task.sourceFiles?.length) {
+        for (const file of task.sourceFiles) {
+            parts.push(expandSourceFile(file));
+        }
+    }
+    return parts.join(" ");
+}
+/**
+ * Retrieves relevant knowledge and plan entries for a given task context.
+ * Returns top-N entries sorted by relevance score.
+ */
+export async function retrieveForTask(slug, task, limit = 10) {
+    if (!task.title) {
+        return [];
+    }
+    const query = buildTaskQuery(task);
+    const index = await buildProjectRetrievalIndex(slug);
+    return index.searchAll(query, limit);
+}
+//# sourceMappingURL=task-scoped.js.map

package/dist/retrieval/task-scoped.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-scoped.js","sourceRoot":"","sources":["../../src/retrieval/task-scoped.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,0BAA0B,EAAoB,MAAM,oBAAoB,CAAC;AAQlF;;;GAGG;AACH,SAAS,gBAAgB,CAAC,IAAuC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,gCAAgC;IAChC,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,IAAI,IAAI,EAAE,CAAC;QACT,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAAiB,EACjB,KAAK,GAAG,EAAE;IAEV,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/utils/content-assembly.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared content extraction helpers for assembling project context.
+ * Used by both `arcs context` and `arcs sync-agents-md` commands.
+ */
+/**
+ * Extract meaningful overview content from overview.md, stripping template boilerplate.
+ * Returns null if the overview is still the default template (no real content).
+ *
+ * Strips: leading H1, blockquote, status/repo blocks, then checks if remaining
+ * content is just empty section headers.
+ *
+ * NOTE: Coupled to the template format in project.md.tmpl. Guarded by
+ * test/content-assembly.test.ts — edits to the template or this function
+ * must preserve the null/non-null contract on unmodified vs. populated
+ * renders, or that test will fail.
+ */
+export declare function extractOverviewContent(raw: string): string | null;
+/**
+ * Extract in-progress task lines (matching `- [/]` pattern) in file order.
+ */
+export declare function extractInProgressTasks(raw: string): string[];
+/**
+ * Extract backlog task lines (matching `- [ ]` pattern) in file order.
+ */
+export declare function extractBacklogTasks(raw: string): string[];
+/**
+ * Remove leading markdown checkbox syntax from a task line.
+ */
+export declare function stripTaskCheckbox(line: string): string;
+/**
+ * Extract meaningful dependencies content from dependencies.md, stripping template boilerplate.
+ * Returns null if the content is still the default template.
+ *
+ * Strips leading H1 (`# Dependencies — {name}`). Downgrades `## Upstream` /
+ * `## Downstream` to `###` so they nest correctly under the `## Dependencies`
+ * header in assembled documents. Returns null if the only non-blank content
+ * under each header is `- None yet` / `- None` or nothing.
+ *
+ * NOTE: Coupled to the template format in dependency.md.tmpl. Guarded by
+ * test/content-assembly.test.ts — edits to the template or this function
+ * must preserve the null/non-null contract, or that test will fail.
+ */
+export declare function extractDependenciesContent(raw: string): string | null;
+//# sourceMappingURL=content-assembly.d.ts.map

package/dist/utils/content-assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-assembly.d.ts","sourceRoot":"","sources":["../../src/utils/content-assembly.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6BjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BrE"}

package/dist/utils/content-assembly.js

@@ -0,0 +1,101 @@
+/**
+ * Shared content extraction helpers for assembling project context.
+ * Used by both `arcs context` and `arcs sync-agents-md` commands.
+ */
+/**
+ * Extract meaningful overview content from overview.md, stripping template boilerplate.
+ * Returns null if the overview is still the default template (no real content).
+ *
+ * Strips: leading H1, blockquote, status/repo blocks, then checks if remaining
+ * content is just empty section headers.
+ *
+ * NOTE: Coupled to the template format in project.md.tmpl. Guarded by
+ * test/content-assembly.test.ts — edits to the template or this function
+ * must preserve the null/non-null contract on unmodified vs. populated
+ * renders, or that test will fail.
+ */
+export function extractOverviewContent(raw) {
+    const lines = raw.split("\n");
+    let startIdx = 0;
+    // Skip leading H1
+    if (lines[startIdx]?.startsWith("# "))
+        startIdx++;
+    // Skip blank lines after H1
+    while (startIdx < lines.length && lines[startIdx]?.trim() === "")
+        startIdx++;
+    // Skip blockquote
+    if (lines[startIdx]?.startsWith("> "))
+        startIdx++;
+    // Skip blank lines after blockquote
+    while (startIdx < lines.length && lines[startIdx]?.trim() === "")
+        startIdx++;
+    // Skip status/repo blocks
+    while (startIdx < lines.length &&
+        (lines[startIdx]?.startsWith("**Status:**") ||
+            lines[startIdx]?.startsWith("**Repo:**") ||
+            lines[startIdx]?.trim() === "")) {
+        startIdx++;
+    }
+    const remaining = lines.slice(startIdx).join("\n").trim();
+    // Check if it's just empty section headers with no content beneath them
+    const withoutHeaders = remaining.replace(/^##\s+.+$/gm, "").trim();
+    if (withoutHeaders === "")
+        return null;
+    return remaining;
+}
+/**
+ * Extract in-progress task lines (matching `- [/]` pattern) in file order.
+ */
+export function extractInProgressTasks(raw) {
+    return raw.split("\n").filter((line) => /^- \[\/\]/.test(line.trim()));
+}
+/**
+ * Extract backlog task lines (matching `- [ ]` pattern) in file order.
+ */
+export function extractBacklogTasks(raw) {
+    return raw.split("\n").filter((line) => /^- \[ \]/.test(line.trim()));
+}
+/**
+ * Remove leading markdown checkbox syntax from a task line.
+ */
+export function stripTaskCheckbox(line) {
+    return line.replace(/^- \[[ x/]\]\s*/, "").trim();
+}
+/**
+ * Extract meaningful dependencies content from dependencies.md, stripping template boilerplate.
+ * Returns null if the content is still the default template.
+ *
+ * Strips leading H1 (`# Dependencies — {name}`). Downgrades `## Upstream` /
+ * `## Downstream` to `###` so they nest correctly under the `## Dependencies`
+ * header in assembled documents. Returns null if the only non-blank content
+ * under each header is `- None yet` / `- None` or nothing.
+ *
+ * NOTE: Coupled to the template format in dependency.md.tmpl. Guarded by
+ * test/content-assembly.test.ts — edits to the template or this function
+ * must preserve the null/non-null contract, or that test will fail.
+ */
+export function extractDependenciesContent(raw) {
+    const lines = raw.split("\n");
+    let startIdx = 0;
+    // Skip leading H1
+    if (lines[startIdx]?.startsWith("# "))
+        startIdx++;
+    // Skip blank lines after H1
+    while (startIdx < lines.length && lines[startIdx]?.trim() === "")
+        startIdx++;
+    const remaining = lines.slice(startIdx).join("\n").trim();
+    if (remaining === "")
+        return null;
+    // Check if it's just empty template: only headers and "- None yet" / "- None" lines
+    const withoutHeaders = remaining.replace(/^##\s+.+$/gm, "").trim();
+    const withoutNoneYet = withoutHeaders
+        .split("\n")
+        .filter((line) => line.trim() !== "" && line.trim() !== "- None yet" && line.trim() !== "- None")
+        .join("")
+        .trim();
+    if (withoutNoneYet === "")
+        return null;
+    // Downgrade ## Upstream / ## Downstream to ### for embedding under ## Dependencies
+    return remaining.replace(/^## (Upstream|Downstream)/gm, "### $1");
+}
+//# sourceMappingURL=content-assembly.js.map

package/dist/utils/content-assembly.js.map

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

package/dist/utils/dag.d.ts

@@ -0,0 +1,28 @@
+export interface DagNode {
+    id: string;
+    name: string;
+    status: string;
+    dependsOn: string[];
+}
+export interface RootMeta {
+    version: string;
+    projects: DagNode[];
+}
+/**
+ * Reads and parses the root meta.json.
+ */
+export declare function readRootMeta(dataDir: string): Promise<RootMeta>;
+/**
+ * Detect if adding an edge (from → to) would create a cycle.
+ * Uses DFS from `to` to see if we can reach `from`.
+ */
+export declare function wouldCreateCycle(projects: DagNode[], fromId: string, toId: string): boolean;
+/**
+ * Writes root meta.json under an advisory file lock.
+ */
+export declare function writeRootMeta(dataDir: string, rootMeta: RootMeta): Promise<void>;
+/**
+ * Validate that all dependency targets exist in the project list.
+ */
+export declare function validateDependencies(projects: DagNode[], dependsOn: string[]): string[];
+//# sourceMappingURL=dag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../../src/utils/dag.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAWrE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CA2B3F;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGvF"}

package/dist/utils/dag.js

@@ -0,0 +1,68 @@
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { invalidFileFormat } from "./errors.js";
+import { withLock } from "./file-lock.js";
+import { readJsonSafe, validateJson } from "./json.js";
+import { rootMetaSchema } from "./json-schemas.js";
+/**
+ * Reads and parses the root meta.json.
+ */
+export async function readRootMeta(dataDir) {
+    const metaPath = resolve(dataDir, "meta.json");
+    const raw = await readJsonSafe(metaPath);
+    if (raw === undefined) {
+        throw invalidFileFormat(metaPath, "file missing or not valid JSON");
+    }
+    try {
+        return validateJson(raw, rootMetaSchema, metaPath);
+    }
+    catch (err) {
+        throw invalidFileFormat(metaPath, err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * Detect if adding an edge (from → to) would create a cycle.
+ * Uses DFS from `to` to see if we can reach `from`.
+ */
+export function wouldCreateCycle(projects, fromId, toId) {
+    const adjacency = new Map();
+    for (const p of projects) {
+        adjacency.set(p.id, [...p.dependsOn]);
+    }
+    // Simulate adding the edge: fromId depends on toId
+    const existing = adjacency.get(fromId) ?? [];
+    adjacency.set(fromId, [...existing, toId]);
+    // DFS from fromId following dependsOn — if we reach fromId again, cycle exists
+    const visited = new Set();
+    const stack = [toId];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (current === fromId)
+            return true;
+        if (visited.has(current))
+            continue;
+        visited.add(current);
+        const deps = adjacency.get(current) ?? [];
+        for (const dep of deps) {
+            stack.push(dep);
+        }
+    }
+    return false;
+}
+/**
+ * Writes root meta.json under an advisory file lock.
+ */
+export async function writeRootMeta(dataDir, rootMeta) {
+    const metaPath = resolve(dataDir, "meta.json");
+    await withLock(metaPath, async () => {
+        await writeFile(metaPath, JSON.stringify(rootMeta, null, 2), "utf-8");
+    });
+}
+/**
+ * Validate that all dependency targets exist in the project list.
+ */
+export function validateDependencies(projects, dependsOn) {
+    const knownIds = new Set(projects.map((p) => p.id));
+    return dependsOn.filter((id) => !knownIds.has(id));
+}
+//# sourceMappingURL=dag.js.map

package/dist/utils/dag.js.map

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

package/dist/utils/diagram-generator.d.ts

@@ -0,0 +1,17 @@
+import type { TaskMeta } from "./project-memory.js";
+export interface DiagramNode {
+    nodeId: string;
+    taskId: string;
+    title: string;
+}
+export interface GenerateDiagramResult {
+    mmd: string;
+    nodes: DiagramNode[];
+}
+/**
+ * Generates a skeleton Mermaid .mmd diagram from plan tasks.
+ * Node IDs assigned T001+ sorted by priority (high→medium→low) then id.localeCompare.
+ * No dependency edges — skeleton only. Use manage-diagram.mjs regenerate to add edges.
+ */
+export declare function generateDiagramFromTasks(planId: string, tasks: TaskMeta[]): GenerateDiagramResult;
+//# sourceMappingURL=diagram-generator.d.ts.map

package/dist/utils/diagram-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-generator.d.ts","sourceRoot":"","sources":["../../src/utils/diagram-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,qBAAqB,CA0DjG"}