project-tiny-context-harness 0.2.85 → 0.6.0

package/dist/lib/context-export.js

@@ -3,9 +3,9 @@ import { createHash } from "node:crypto";
 import { promises as fs } from "node:fs";
 import path from "node:path";
 import { promisify } from "node:util";
-import { ensureDir, listFiles, pathExists, readText, writeTextIfChanged } from "./fs.js";
+import { ensureDir, listFiles, pathExists, readText, writeTextIfChanged, } from "./fs.js";
 import { harnessRoot } from "./harness-root.js";
-import { SAFE_EXAMPLE_FILE_NAMES, shouldExcludeRelativePath, shouldIncludeCodeFile, toPosix } from "./source-files.js";
+import { SAFE_EXAMPLE_FILE_NAMES, shouldExcludeRelativePath, shouldIncludeCodeFile, toPosix, } from "./source-files.js";
 const execFileAsync = promisify(execFile);
 const EXPORT_HEADER = "Export artifact. Do not reference from project_context/context.toml.";
 const DEFAULT_EXPORT_DIR = "tmp/ty-context/context-exports";
@@ -30,8 +30,11 @@ async function runFullContextExport(projectRoot, options) {
     const outputRelativePath = repoRelative(projectRoot, outputPath);
     const warnings = [];
     const sourceFiles = await collectSourceFiles(projectRoot, warnings);
-    const sourceRelativeFiles = sourceFiles.map((file) => repoRelative(projectRoot, file)).sort();
-    const sourceContextCount = sourceRelativeFiles.filter((file) => file === "project_context/context.toml" || file.startsWith("project_context/")).length;
+    const sourceRelativeFiles = sourceFiles
+        .map((file) => repoRelative(projectRoot, file))
+        .sort();
+    const sourceContextCount = sourceRelativeFiles.filter((file) => file === "project_context/context.toml" ||
+        file.startsWith("project_context/")).length;
     const sourceSections = [];
     const contextEntrySections = [];
     for (const file of sourceFiles) {
@@ -66,7 +69,9 @@ async function runFullContextExport(projectRoot, options) {
         "- source_file_list:",
         ...sourceRelativeFiles.map((file) => `  - ${file}`),
         "- warnings:",
-        ...(warnings.length > 0 ? warnings.map((warning) => `  - ${warning}`) : ["  - none"]),
+        ...(warnings.length > 0
+            ? warnings.map((warning) => `  - ${warning}`)
+            : ["  - none"]),
         "",
         "## Directory Tree Summary",
         "",
@@ -78,12 +83,14 @@ async function runFullContextExport(projectRoot, options) {
         "",
         "## Context Code Entry Point Index",
         "",
-        contextEntrySections.length > 0 ? contextEntrySections.join("\n\n") : "- No Code Entry Points sections found in exported Context Markdown.",
+        contextEntrySections.length > 0
+            ? contextEntrySections.join("\n\n")
+            : "- No Code Entry Points sections found in exported Context Markdown.",
         "",
         "## Source Files",
         "",
         sourceSections.join("\n\n"),
-        ""
+        "",
     ].join("\n");
     if (!options.check) {
         await ensureDir(path.dirname(outputPath));
@@ -96,7 +103,7 @@ async function runFullContextExport(projectRoot, options) {
         sourceFiles: sourceRelativeFiles,
         sourceContextCount,
         warnings,
-        wrote: !options.check
+        wrote: !options.check,
     };
 }
 async function runCodeImplementationExport(projectRoot, options) {
@@ -121,7 +128,7 @@ async function runCodeImplementationExport(projectRoot, options) {
             characters: content.length,
             sha256: sha256(content),
             summary: summarizeCodeFile(relative, content, language),
-            content
+            content,
         });
     }
     records.sort((left, right) => left.relative.localeCompare(right.relative));
@@ -146,7 +153,9 @@ async function runCodeImplementationExport(projectRoot, options) {
         `- total_lines: ${totalLines}`,
         `- total_characters: ${totalCharacters}`,
         "- warnings:",
-        ...(warnings.length > 0 ? warnings.map((warning) => `  - ${warning}`) : ["  - none"]),
+        ...(warnings.length > 0
+            ? warnings.map((warning) => `  - ${warning}`)
+            : ["  - none"]),
         "",
         "## Implementation Guide",
         "",
@@ -159,7 +168,7 @@ async function runCodeImplementationExport(projectRoot, options) {
         "## Source Files",
         "",
         records.map(renderCodeFileSection).join("\n\n"),
-        ""
+        "",
     ].join("\n");
     if (!options.check) {
         await ensureDir(path.dirname(outputPath));
@@ -175,7 +184,7 @@ async function runCodeImplementationExport(projectRoot, options) {
         totalLines,
         totalCharacters,
         warnings,
-        wrote: !options.check
+        wrote: !options.check,
     };
 }
 function resolveOutputPath(projectRoot, requestedOutput, now, mode) {
@@ -190,7 +199,8 @@ function resolveOutputPath(projectRoot, requestedOutput, now, mode) {
         throw new Error("export-context --output must stay inside the workspace; use tmp/ty-context/context-exports/<name>.md");
     }
     const normalized = toPosix(relative);
-    if (normalized === "project_context" || normalized.startsWith("project_context/")) {
+    if (normalized === "project_context" ||
+        normalized.startsWith("project_context/")) {
         throw new Error("export-context output is a temporary artifact; use tmp/ty-context/context-exports/** instead of project_context/**");
     }
     if (!normalized.startsWith(`${DEFAULT_EXPORT_DIR}/`)) {
@@ -212,7 +222,8 @@ async function collectSourceFiles(projectRoot, warnings) {
     const contextRoot = path.join(projectRoot, "project_context");
     for (const file of await listFiles(contextRoot)) {
         const relative = repoRelative(projectRoot, file);
-        if ((relative.endsWith(".md") || relative.endsWith(".toml")) && !shouldExcludeRelativePath(relative)) {
+        if ((relative.endsWith(".md") || relative.endsWith(".toml")) &&
+            !shouldExcludeRelativePath(relative)) {
             files.add(file);
         }
     }
@@ -220,14 +231,16 @@ async function collectSourceFiles(projectRoot, warnings) {
     const skillRoot = path.join(projectRoot, root, "skills");
     for (const file of await listFiles(skillRoot)) {
         const relative = repoRelative(projectRoot, file);
-        if (relative.endsWith("/SKILL.md") && !shouldExcludeRelativePath(relative)) {
+        if (relative.endsWith("/SKILL.md") &&
+            !shouldExcludeRelativePath(relative)) {
             files.add(file);
         }
     }
     for (const file of await listCandidateFiles(projectRoot)) {
         const relative = repoRelative(projectRoot, file);
         const base = path.basename(file);
-        if (["README.md", "AGENTS.md", "DESIGN.md"].includes(base) && !shouldExcludeRelativePath(relative)) {
+        if (["README.md", "AGENTS.md", "DESIGN.md"].includes(base) &&
+            !shouldExcludeRelativePath(relative)) {
             files.add(file);
         }
     }
@@ -247,9 +260,17 @@ async function collectCodeSourceFiles(projectRoot) {
 }
 async function listGitCandidateFiles(projectRoot) {
     try {
-        const result = await execFileAsync("git", ["-C", projectRoot, "ls-files", "--cached", "--others", "--exclude-standard", "-z"], {
+        const result = await execFileAsync("git", [
+            "-C",
+            projectRoot,
+            "ls-files",
+            "--cached",
+            "--others",
+            "--exclude-standard",
+            "-z",
+        ], {
             encoding: "utf8",
-            maxBuffer: GIT_LS_MAX_BUFFER
+            maxBuffer: GIT_LS_MAX_BUFFER,
         });
         const stdout = result.stdout;
         return stdout
@@ -322,7 +343,8 @@ async function buildDirectoryTree(projectRoot, warnings) {
         }
         const visibleEntries = entries
             .filter((entry) => !shouldExcludeRelativePath(repoRelative(projectRoot, path.join(current, entry.name))))
-            .sort((left, right) => Number(right.isDirectory()) - Number(left.isDirectory()) || left.name.localeCompare(right.name));
+            .sort((left, right) => Number(right.isDirectory()) - Number(left.isDirectory()) ||
+            left.name.localeCompare(right.name));
         for (const entry of visibleEntries) {
             if (count >= MAX_TREE_ENTRIES) {
                 truncated = true;
@@ -362,7 +384,9 @@ async function buildMakefileVerificationSummary(projectRoot) {
             summary.push(`  ${line.trim()}`);
         }
     }
-    return summary.length > 0 ? summary.join("\n") : "- No obvious verification targets found in root Makefile.";
+    return summary.length > 0
+        ? summary.join("\n")
+        : "- No obvious verification targets found in root Makefile.";
 }
 function redactSensitiveAssignments(content) {
     let count = 0;
@@ -379,7 +403,13 @@ function redactSensitiveAssignments(content) {
 function renderSourceSection(relative, content) {
     const fence = fenceFor(content);
     const language = languageFor(relative);
-    return [`### ${relative}`, "", `${fence}${language}`, content.trimEnd(), fence].join("\n");
+    return [
+        `### ${relative}`,
+        "",
+        `${fence}${language}`,
+        content.trimEnd(),
+        fence,
+    ].join("\n");
 }
 function renderCodeFileSection(record) {
     const fence = fenceFor(record.content);
@@ -396,7 +426,7 @@ function renderCodeFileSection(record) {
         "",
         `${fence}${record.language}`,
         record.content.trimEnd(),
-        fence
+        fence,
     ].join("\n");
 }
 function renderCodeFileIndex(records) {
@@ -406,7 +436,7 @@ function renderCodeFileIndex(records) {
     return [
         "| Path | Type | Lines | Characters | SHA256 | Summary |",
         "|---|---:|---:|---:|---|---|",
-        ...records.map((record) => `| ${escapeTableCell(record.relative)} | ${escapeTableCell(record.language)} | ${record.lines} | ${record.characters} | ${record.sha256.slice(0, 12)} | ${escapeTableCell(record.summary)} |`)
+        ...records.map((record) => `| ${escapeTableCell(record.relative)} | ${escapeTableCell(record.language)} | ${record.lines} | ${record.characters} | ${record.sha256.slice(0, 12)} | ${escapeTableCell(record.summary)} |`),
     ].join("\n");
 }
 function buildImplementationGuide(records) {
@@ -432,7 +462,7 @@ function buildImplementationGuide(records) {
         `- Main modules: ${modules || "no obvious modules identified"}.`,
         `- Key entry points: ${entrypoints.length > 0 ? entrypoints.join(", ") : "no obvious entry points identified"}.`,
         "- Each file block keeps the relative path, heuristic summary, line count, character count, SHA256 and redacted source body.",
-        "- This file is a temporary implementation snapshot, not durable Context; durable project facts still belong in project_context/**."
+        "- This file is a temporary implementation snapshot, not durable Context; durable project facts still belong in project_context/**.",
     ].join("\n");
 }
 function summarizeCodeFile(relative, content, language) {
@@ -448,17 +478,25 @@ function summarizeCodeFile(relative, content, language) {
     if (base.toLowerCase() === "makefile") {
         return summarizeMakefile(content);
     }
-    if (base.toLowerCase().startsWith("dockerfile") || lower.endsWith(".dockerfile")) {
+    if (base.toLowerCase().startsWith("dockerfile") ||
+        lower.endsWith(".dockerfile")) {
         const image = /^FROM\s+(.+)$/im.exec(content)?.[1]?.trim();
-        return image ? `Defines a Docker image build starting from ${image}.` : "Defines a Docker image build.";
+        return image
+            ? `Defines a Docker image build starting from ${image}.`
+            : "Defines a Docker image build.";
     }
-    if (lower.endsWith("docker-compose.yml") || lower.endsWith("docker-compose.yaml") || base.toLowerCase().startsWith("compose.")) {
+    if (lower.endsWith("docker-compose.yml") ||
+        lower.endsWith("docker-compose.yaml") ||
+        base.toLowerCase().startsWith("compose.")) {
         const services = extractYamlTopLevelMapKeys(content, "services").slice(0, 6);
         return services.length > 0
             ? `Defines Docker Compose services ${services.join(", ")}.`
             : "Defines Docker Compose services and local runtime wiring.";
     }
-    if (language === "yaml" || language === "toml" || language === "json" || language === "jsonc") {
+    if (language === "yaml" ||
+        language === "toml" ||
+        language === "json" ||
+        language === "jsonc") {
         return symbols.length > 0
             ? `Defines project configuration around ${symbols.slice(0, 6).join(", ")}.`
             : "Defines project configuration used by the implementation or tooling.";
@@ -471,19 +509,30 @@ function summarizeCodeFile(relative, content, language) {
 function extractSymbolSummary(content, language) {
     const symbols = new Set();
     const patterns = language === "python"
-        ? [/^(?:async\s+)?def\s+([A-Za-z_][\w]*)/gm, /^class\s+([A-Za-z_][\w]*)/gm]
+        ? [
+            /^(?:async\s+)?def\s+([A-Za-z_][\w]*)/gm,
+            /^class\s+([A-Za-z_][\w]*)/gm,
+        ]
         : language === "go"
-            ? [/^func\s+(?:\([^)]+\)\s*)?([A-Za-z_][\w]*)/gm, /^type\s+([A-Za-z_][\w]*)/gm]
+            ? [
+                /^func\s+(?:\([^)]+\)\s*)?([A-Za-z_][\w]*)/gm,
+                /^type\s+([A-Za-z_][\w]*)/gm,
+            ]
             : language === "sql"
-                ? [/\bCREATE\s+(?:OR\s+REPLACE\s+)?(?:TABLE|VIEW|FUNCTION|PROCEDURE|INDEX|TRIGGER)\s+([A-Za-z0-9_."]+)/gim]
-                : language === "yaml" || language === "toml" || language === "json" || language === "jsonc"
+                ? [
+                    /\bCREATE\s+(?:OR\s+REPLACE\s+)?(?:TABLE|VIEW|FUNCTION|PROCEDURE|INDEX|TRIGGER)\s+([A-Za-z0-9_."]+)/gim,
+                ]
+                : language === "yaml" ||
+                    language === "toml" ||
+                    language === "json" ||
+                    language === "jsonc"
                     ? [/^["']?([A-Za-z0-9_.-]+)["']?\s*[:=]/gm]
                     : [
                         /(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/g,
                         /(?:export\s+)?class\s+([A-Za-z_$][\w$]*)/g,
                         /(?:export\s+)?interface\s+([A-Za-z_$][\w$]*)/g,
                         /(?:export\s+)?type\s+([A-Za-z_$][\w$]*)/g,
-                        /(?:export\s+)?const\s+([A-Za-z_$][\w$]*)/g
+                        /(?:export\s+)?const\s+([A-Za-z_$][\w$]*)/g,
                     ];
     for (const pattern of patterns) {
         let match;
@@ -505,7 +554,7 @@ function extractRouteSummary(content) {
     const routePatterns = [
         /\.(get|post|put|patch|delete|head|options)\s*\(\s*["'`]([^"'`]+)["'`]/gi,
         /\bHandleFunc\s*\(\s*["'`]([^"'`]+)["'`]/g,
-        /\bHandle\s*\(\s*["'`]([^"'`]+)["'`]/g
+        /\bHandle\s*\(\s*["'`]([^"'`]+)["'`]/g,
     ];
     for (const pattern of routePatterns) {
         let match;
@@ -521,7 +570,9 @@ function extractRouteSummary(content) {
     return [...routes];
 }
 function summarizeMakefile(content) {
-    const targets = [...content.matchAll(/^([A-Za-z0-9_.-]+):/gm)].map((match) => match[1]).slice(0, 8);
+    const targets = [...content.matchAll(/^([A-Za-z0-9_.-]+):/gm)]
+        .map((match) => match[1])
+        .slice(0, 8);
     return targets.length > 0
         ? `Defines Make targets ${targets.join(", ")} for local build, validation or automation.`
         : "Defines Make targets for local build, validation or automation.";
@@ -551,10 +602,14 @@ function extractJsonString(content, key) {
 }
 function describeFilePurpose(relative, language) {
     const lower = relative.toLowerCase();
-    if (lower.includes("/test") || lower.includes(".test.") || lower.includes(".spec.")) {
+    if (lower.includes("/test") ||
+        lower.includes(".test.") ||
+        lower.includes(".spec.")) {
         return `Contains ${language} tests for ${path.posix.basename(relative)}`;
     }
-    if (lower.includes("/cli") || lower.endsWith("/cli.ts") || lower.endsWith("/cli.js")) {
+    if (lower.includes("/cli") ||
+        lower.endsWith("/cli.ts") ||
+        lower.endsWith("/cli.js")) {
         return `Implements ${language} CLI behavior for ${path.posix.basename(relative)}`;
     }
     if (lower.includes("/commands/")) {
@@ -563,7 +618,9 @@ function describeFilePurpose(relative, language) {
     if (lower.includes("/lib/") || lower.includes("/internal/")) {
         return `Implements ${language} library behavior for ${path.posix.basename(relative)}`;
     }
-    if (lower.includes("/components/") || lower.includes("/pages/") || lower.includes("/app/")) {
+    if (lower.includes("/components/") ||
+        lower.includes("/pages/") ||
+        lower.includes("/app/")) {
         return `Implements ${language} UI or application behavior for ${path.posix.basename(relative)}`;
     }
     return `Contains ${language} implementation for ${path.posix.basename(relative)}`;
@@ -624,7 +681,9 @@ function languageFor(relative) {
     if (base === "makefile") {
         return "make";
     }
-    if (base === "dockerfile" || base.startsWith("dockerfile.") || lower.endsWith(".dockerfile")) {
+    if (base === "dockerfile" ||
+        base.startsWith("dockerfile.") ||
+        lower.endsWith(".dockerfile")) {
         return "dockerfile";
     }
     if (SAFE_EXAMPLE_FILE_NAMES.has(base)) {
@@ -645,7 +704,9 @@ function languageFor(relative) {
     if (lower.endsWith(".jsx")) {
         return "jsx";
     }
-    if (lower.endsWith(".js") || lower.endsWith(".mjs") || lower.endsWith(".cjs")) {
+    if (lower.endsWith(".js") ||
+        lower.endsWith(".mjs") ||
+        lower.endsWith(".cjs")) {
         return "javascript";
     }
     if (lower.endsWith(".py")) {
@@ -699,7 +760,10 @@ function extractSection(content, heading) {
     return body || undefined;
 }
 function timestampForFile(now) {
-    return now.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}Z$/, "Z");
+    return now
+        .toISOString()
+        .replace(/[-:]/g, "")
+        .replace(/\.\d{3}Z$/, "Z");
 }
 function repoRelative(root, file) {
     return toPosix(path.relative(root, file));

package/dist/lib/context-graph-snapshot.d.ts

@@ -0,0 +1,18 @@
+export interface ContextGraphSnapshot {
+    mode: "referenced" | "full";
+    topology_sha256: string;
+    files: string[];
+    sha256: Record<string, string>;
+    controlling_files: string[];
+    supporting_files: string[];
+}
+export interface CampaignContextBaseline {
+    graph_sha256: string;
+    files: Record<string, string>;
+    baseline_sha256: string;
+}
+export declare function captureContextGraphSnapshot(repositoryRoot: string, contextRefs: Iterable<string>, mode?: "referenced" | "full"): Promise<ContextGraphSnapshot>;
+export declare function captureCampaignContextBaseline(repositoryRoot: string, contextRefs: Iterable<string>): Promise<CampaignContextBaseline>;
+export declare function assertCampaignContextBaselineFresh(repositoryRoot: string, expected: CampaignContextBaseline, contextRefs: Iterable<string>): Promise<void>;
+export declare function currentContextTopologySha256(repositoryRoot: string): Promise<string>;
+export declare function listContextFiles(repositoryRoot: string): Promise<string[]>;

package/dist/lib/context-graph-snapshot.js

@@ -0,0 +1,171 @@
+import { readFile, readdir } from "node:fs/promises";
+import path from "node:path";
+import { contextAuthorityTopologyHash } from "./long-task-context-authority-topology.js";
+import { canonicalJson, sha256Hex } from "./strict-codec.js";
+import { parseContextManifest, } from "./context-manifest-schema.js";
+import { assertProtectedRepositoryFile } from "./long-task-protected-files.js";
+const CONTEXT_MANIFEST_PATH = "project_context/context.toml";
+const SUPPORTING_CONTEXT_ROLES = new Set(["implementation-index", "archive"]);
+export async function captureContextGraphSnapshot(repositoryRoot, contextRefs, mode = "referenced") {
+    const root = path.resolve(repositoryRoot);
+    const manifest = await readContextManifest(root);
+    const allFiles = await listContextFiles(root);
+    const available = new Set(allFiles);
+    const selected = new Set();
+    const explicitlySelected = new Set();
+    if (mode === "full") {
+        allFiles.forEach((file) => selected.add(file));
+    }
+    else {
+        for (const required of [
+            CONTEXT_MANIFEST_PATH,
+            "project_context/global.md",
+            "project_context/architecture.md",
+        ]) {
+            if (!available.has(required)) {
+                throw new Error(`context_snapshot_required_file_missing:${required}`);
+            }
+            selected.add(required);
+            explicitlySelected.add(required);
+        }
+        for (const contextRef of contextRefs) {
+            const normalized = normalizeRepoPath(contextRef);
+            if (!available.has(normalized)) {
+                throw new Error(`context_ref_invalid:${contextRef}`);
+            }
+            selected.add(normalized);
+            explicitlySelected.add(normalized);
+        }
+        addTransitiveChildren(manifest, selected, available);
+    }
+    const files = [...selected].sort();
+    const authorityTopologySha256 = contextAuthorityTopologyHash(manifest, files);
+    const hashes = Object.fromEntries(await Promise.all(files.map(async (file) => [
+        file,
+        file === CONTEXT_MANIFEST_PATH
+            ? authorityTopologySha256
+            : await hashFile(root, path.join(root, file)),
+    ])));
+    const classification = classifyContextFiles(manifest, files, explicitlySelected, mode);
+    return {
+        mode,
+        topology_sha256: authorityTopologySha256,
+        files,
+        sha256: sortRecord(hashes),
+        controlling_files: classification.controlling,
+        supporting_files: classification.supporting,
+    };
+}
+export async function captureCampaignContextBaseline(repositoryRoot, contextRefs) {
+    const snapshot = await captureContextGraphSnapshot(repositoryRoot, contextRefs, "referenced");
+    const files = sortRecord(snapshot.sha256);
+    return {
+        graph_sha256: snapshot.topology_sha256,
+        files,
+        baseline_sha256: sha256Hex(canonicalJson({ graph_sha256: snapshot.topology_sha256, files })),
+    };
+}
+export async function assertCampaignContextBaselineFresh(repositoryRoot, expected, contextRefs) {
+    const current = await captureCampaignContextBaseline(repositoryRoot, contextRefs);
+    if (current.graph_sha256 !== expected.graph_sha256) {
+        throw new Error("campaign_context_changed:graph");
+    }
+    if (current.baseline_sha256 !== expected.baseline_sha256) {
+        const changed = [
+            ...new Set([
+                ...Object.keys(expected.files),
+                ...Object.keys(current.files),
+            ]),
+        ]
+            .filter((file) => expected.files[file] !== current.files[file])
+            .sort();
+        throw new Error(`campaign_context_changed:files:${changed.join(",") || "set"}`);
+    }
+}
+export async function currentContextTopologySha256(repositoryRoot) {
+    const root = path.resolve(repositoryRoot);
+    return contextAuthorityTopologyHash(await readContextManifest(root), await listContextFiles(root));
+}
+export async function listContextFiles(repositoryRoot) {
+    const root = path.resolve(repositoryRoot);
+    const contextRoot = path.join(root, "project_context");
+    const result = [];
+    async function visit(directory) {
+        for (const entry of await readdir(directory, { withFileTypes: true })) {
+            const absolute = path.join(directory, entry.name);
+            if (entry.isSymbolicLink()) {
+                throw new Error(`protected_input_symlink_not_allowed:context_authority:${absolute.replace(/\\/gu, "/")}`);
+            }
+            if (entry.isDirectory()) {
+                await visit(absolute);
+            }
+            else if (entry.isFile()) {
+                await assertProtectedRepositoryFile(root, absolute, "context_authority");
+                result.push(repoRelative(root, absolute));
+            }
+        }
+    }
+    await visit(contextRoot);
+    return result.sort();
+}
+async function readContextManifest(root) {
+    const manifestFile = await assertProtectedRepositoryFile(root, path.join(root, "project_context", "context.toml"), "context_manifest");
+    const parsed = parseContextManifest(await readFile(manifestFile, "utf8"));
+    if (!parsed.manifest || parsed.errors.length > 0) {
+        throw new Error(`context_manifest_invalid:${parsed.errors.join("|")}`);
+    }
+    return parsed.manifest;
+}
+function addTransitiveChildren(manifest, selected, available) {
+    const children = new Map(manifest.contexts.map((entry) => [
+        normalizeRepoPath(entry.path),
+        entry.default_children.map(normalizeRepoPath),
+    ]));
+    const queue = [...selected];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        for (const child of children.get(current) ?? []) {
+            if (!available.has(child)) {
+                throw new Error(`context_graph_child_missing:${current}:${child}`);
+            }
+            if (!selected.has(child)) {
+                selected.add(child);
+                queue.push(child);
+            }
+        }
+    }
+}
+function classifyContextFiles(manifest, files, explicitlySelected, mode) {
+    if (mode === "full")
+        return { controlling: [...files], supporting: [] };
+    const roles = new Map(manifest.contexts.map((entry) => [normalizeRepoPath(entry.path), entry.role]));
+    const controlling = [];
+    const supporting = [];
+    for (const file of files) {
+        const role = roles.get(file);
+        if (explicitlySelected.has(file) ||
+            role === undefined ||
+            !SUPPORTING_CONTEXT_ROLES.has(role))
+            controlling.push(file);
+        else
+            supporting.push(file);
+    }
+    return { controlling, supporting };
+}
+async function hashFile(root, file) {
+    const protectedFile = await assertProtectedRepositoryFile(root, file, "context_authority");
+    return sha256Hex(await readFile(protectedFile));
+}
+function repoRelative(root, file) {
+    const value = path.relative(root, file).replace(/\\/g, "/");
+    if (value.startsWith("../") || path.isAbsolute(value)) {
+        throw new Error(`Path is outside repository: ${file}`);
+    }
+    return value;
+}
+function normalizeRepoPath(value) {
+    return value.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+function sortRecord(value) {
+    return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)));
+}

package/dist/lib/context-manifest-schema.d.ts

@@ -0,0 +1,28 @@
+export type ContextRole = "global" | "architecture" | "area" | "domain" | "subdomain" | "foundation" | "archive" | "contract" | "verification" | "deployment" | "implementation-index" | "decision-rationale";
+export interface ContextAreaEntry {
+    line: number;
+    id: string;
+    root: string;
+    context: string;
+    kind?: string;
+    default: boolean;
+    forbidden_runtime_dependencies: string[];
+}
+export interface ContextNodeEntry {
+    line: number;
+    path: string;
+    role: string;
+    read_when?: string;
+    read_policy?: string;
+    triggers: string[];
+    default_children: string[];
+}
+export interface ContextManifest {
+    areas: ContextAreaEntry[];
+    contexts: ContextNodeEntry[];
+}
+export interface ContextManifestParseResult {
+    manifest?: ContextManifest;
+    errors: string[];
+}
+export declare function parseContextManifest(content: string, file?: string): ContextManifestParseResult;