human-to-code 0.1.21 → 0.1.23

package/dist/agents/direct/integration-validation.js

@@ -0,0 +1,284 @@
+/**
+ * Opt-in post-generation checks for relationships that a compiler cannot
+ * validate. The first contract covers static-web entry documents: generated
+ * HTML must reference conventional generated CSS/browser-JavaScript companions
+ * in the same directory. Consistent groups issue no request; a detected gap
+ * permits one bounded whole-file reconciliation and otherwise fails closed.
+ */
+import { posix } from "node:path";
+import { ContextSecurityError, scanSecrets } from "../../context/context.js";
+import { validateGeneratedUnit } from "./candidate-validation.js";
+const DEFAULT_CONTEXT_CHAR_BUDGET = 48_000;
+const HTML_EXTENSIONS = new Set([".html", ".htm"]);
+const BROWSER_SCRIPT_EXTENSIONS = new Set([".js", ".mjs"]);
+const RAW_OR_INERT_HTML_ELEMENTS = new Set([
+    "iframe", "noembed", "noframes", "script", "style", "template", "textarea", "title", "xmp",
+]);
+const CONVENTIONAL_BROWSER_SCRIPT = /^(?:app|client|frontend|index|main|page|script|ui)(?:[.-].*)?\.(?:js|mjs)$/iu;
+const BROWSER_PURPOSE = /\b(?:browser|button|calculator|click|document|dom|event|form|html|page|screen|ui|window)\b/iu;
+function targetPath(unit) {
+    return unit.kind === "file" ? unit.outputPath : unit.sourcePath;
+}
+function extension(path) {
+    return posix.extname(path).toLowerCase();
+}
+function isWholeHtml(unit) {
+    return unit.kind === "file" && HTML_EXTENSIONS.has(extension(targetPath(unit)));
+}
+function isStylesheetCompanion(unit) {
+    if (unit.kind !== "file" || extension(targetPath(unit)) !== ".css")
+        return false;
+    return !/(?:^|[.-])(?:module|spec|test)(?:[.-]|\.css$)/iu.test(posix.basename(targetPath(unit)));
+}
+function isBrowserScriptCompanion(unit) {
+    if (unit.kind !== "file" || !BROWSER_SCRIPT_EXTENSIONS.has(extension(targetPath(unit))))
+        return false;
+    const name = posix.basename(targetPath(unit));
+    if (/(?:^|[.-])(?:config|server|spec|test)(?:[.-]|\.(?:js|mjs)$)/iu.test(name))
+        return false;
+    return CONVENTIONAL_BROWSER_SCRIPT.test(name) || BROWSER_PURPOSE.test(unit.prompt);
+}
+function webIntegrationGroups(units) {
+    const files = units.filter((unit) => unit.kind === "file");
+    return files.filter(isWholeHtml).flatMap((html) => {
+        const directory = posix.dirname(targetPath(html));
+        const related = files.filter((unit) => unit !== html
+            && posix.dirname(targetPath(unit)) === directory
+            && (isStylesheetCompanion(unit) || isBrowserScriptCompanion(unit)));
+        return related.length > 0 ? [{ html, related }] : [];
+    });
+}
+/** Maximum integration requests disclosed before an opt-in run. */
+export function potentialIntegrationRequests(units) {
+    return webIntegrationGroups(units).length;
+}
+function requiredReference(from, to) {
+    return posix.relative(posix.dirname(from), to) || posix.basename(to);
+}
+function attribute(tag, name) {
+    const pattern = new RegExp(`(?:^|\\s)${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s"'=<>\u0060]+))`, "iu");
+    const match = pattern.exec(tag);
+    return match?.[1] ?? match?.[2] ?? match?.[3];
+}
+function resolveLocalReference(from, reference) {
+    const trimmed = reference.trim();
+    if (trimmed.length === 0 || trimmed.startsWith("#") || trimmed.startsWith("//"))
+        return undefined;
+    if (/^[a-z][a-z0-9+.-]*:/iu.test(trimmed))
+        return undefined;
+    const withoutSuffix = trimmed.split(/[?#]/u, 1)[0] ?? "";
+    let decoded;
+    try {
+        decoded = decodeURIComponent(withoutSuffix);
+    }
+    catch {
+        decoded = withoutSuffix;
+    }
+    const resolved = decoded.startsWith("/")
+        ? posix.normalize(decoded.slice(1))
+        : posix.normalize(posix.join(posix.dirname(from), decoded));
+    if (resolved === ".." || resolved.startsWith("../"))
+        return undefined;
+    return resolved.replace(/^\.\//u, "");
+}
+function tagEnd(html, start) {
+    let quote;
+    for (let index = start + 1; index < html.length; index += 1) {
+        const char = html[index];
+        if (quote !== undefined) {
+            if (char === quote)
+                quote = undefined;
+        }
+        else if (char === "\"" || char === "'") {
+            quote = char;
+        }
+        else if (char === ">") {
+            return index;
+        }
+    }
+    return html.length - 1;
+}
+/**
+ * Extract active start tags without accepting examples inside HTML comments,
+ * template contents, or JavaScript/CSS raw-text bodies as real references.
+ */
+function htmlStartTags(html) {
+    const tags = [];
+    let offset = 0;
+    while (offset < html.length) {
+        const start = html.indexOf("<", offset);
+        if (start === -1)
+            break;
+        if (html.startsWith("<!--", start)) {
+            const end = html.indexOf("-->", start + 4);
+            offset = end === -1 ? html.length : end + 3;
+            continue;
+        }
+        const end = tagEnd(html, start);
+        const source = html.slice(start, end + 1);
+        const match = /^<\s*([a-z][a-z0-9:-]*)\b/iu.exec(source);
+        if (!match) {
+            offset = end + 1;
+            continue;
+        }
+        const name = match[1].toLowerCase();
+        tags.push({ name, source });
+        if (RAW_OR_INERT_HTML_ELEMENTS.has(name) && !/\/\s*>$/u.test(source)) {
+            const closing = new RegExp(`<\\/\\s*${name}\\s*>`, "giu");
+            closing.lastIndex = end + 1;
+            const close = closing.exec(html);
+            offset = close === null ? html.length : close.index + close[0].length;
+        }
+        else {
+            offset = end + 1;
+        }
+    }
+    return tags;
+}
+function hasStylesheetReference(htmlPath, tags, stylesheetPath) {
+    for (const tag of tags) {
+        if (tag.name !== "link")
+            continue;
+        const rel = attribute(tag.source, "rel")?.toLowerCase().split(/\s+/u) ?? [];
+        const href = attribute(tag.source, "href");
+        if (rel.includes("stylesheet") && href !== undefined && resolveLocalReference(htmlPath, href) === stylesheetPath)
+            return true;
+    }
+    return false;
+}
+function hasScriptReference(htmlPath, tags, scriptPath) {
+    for (const tag of tags) {
+        if (tag.name !== "script")
+            continue;
+        const source = attribute(tag.source, "src");
+        if (source !== undefined && resolveLocalReference(htmlPath, source) === scriptPath)
+            return true;
+    }
+    return false;
+}
+/** Check one complete HTML candidate against its known generated companions. */
+export function findHtmlIntegrationIssues(htmlPath, html, relatedUnits) {
+    const issues = [];
+    const tags = htmlStartTags(html);
+    for (const unit of relatedUnits) {
+        const relatedPath = targetPath(unit);
+        const reference = requiredReference(htmlPath, relatedPath);
+        if (isStylesheetCompanion(unit) && !hasStylesheetReference(htmlPath, tags, relatedPath)) {
+            issues.push({
+                code: "MISSING_STYLESHEET_REFERENCE",
+                message: `${htmlPath} does not load its generated stylesheet companion ${relatedPath}.`,
+                relatedPath,
+                requiredReference: reference,
+            });
+        }
+        else if (isBrowserScriptCompanion(unit) && !hasScriptReference(htmlPath, tags, relatedPath)) {
+            issues.push({
+                code: "MISSING_BROWSER_SCRIPT_REFERENCE",
+                message: `${htmlPath} does not load its generated browser-script companion ${relatedPath}.`,
+                relatedPath,
+                requiredReference: reference,
+            });
+        }
+    }
+    return issues;
+}
+function describeIssues(issues) {
+    return issues.map((issue) => `${issue.code} (${issue.requiredReference})`).join(", ");
+}
+function buildIntegrationRequest(group, currentCode, issues, byUnit, contextCharBudget, projectMemory) {
+    const issueChars = issues.reduce((total, issue) => total + issue.message.length + issue.relatedPath.length + issue.requiredReference.length + 48, 0);
+    let budget = contextCharBudget - currentCode.length - issueChars;
+    if (budget < 0)
+        return undefined;
+    const renderedProjectMemory = projectMemory?.renderFor(group.html, Math.floor(budget / 2));
+    budget -= renderedProjectMemory?.length ?? 0;
+    const relatedFiles = [];
+    for (const unit of group.related) {
+        const item = byUnit.get(unit);
+        if (!item || item.error !== undefined || item.code.length > budget)
+            continue;
+        relatedFiles.push({ path: targetPath(unit), content: item.code });
+        budget -= item.code.length;
+    }
+    return {
+        unit: group.html,
+        targetPath: targetPath(group.html),
+        instruction: group.html.prompt,
+        currentCode,
+        issues,
+        relatedFiles,
+        ...(renderedProjectMemory ? { projectMemory: renderedProjectMemory } : {}),
+    };
+}
+/** Run opt-in integration checks and bounded repair over generated candidates. */
+export async function reconcileGeneratedIntegrations(generated, options = {}) {
+    const results = generated.map((item) => ({ ...item }));
+    const byUnit = new Map(results.map((item) => [item.unit, item]));
+    const groups = webIntegrationGroups(results.map((item) => item.unit));
+    const maxAttempts = Math.max(0, options.maxIntegrationAttemptsPerUnit ?? 1);
+    const contextCharBudget = Math.max(0, options.contextCharBudget ?? DEFAULT_CONTEXT_CHAR_BUDGET);
+    let integrationRequests = 0;
+    const rejectGroup = (group, reason) => {
+        for (const unit of [group.html, ...group.related]) {
+            const item = byUnit.get(unit);
+            if (!item || item.error !== undefined)
+                continue;
+            item.error = reason;
+            item.code = "";
+            options.onProgress?.({ kind: "reject", unit, reason });
+        }
+    };
+    for (const group of groups) {
+        const groupItems = [group.html, ...group.related].map((unit) => byUnit.get(unit));
+        const unavailable = groupItems.filter((item) => item.error !== undefined || item.code.trim().length === 0);
+        if (unavailable.length > 0) {
+            rejectGroup(group, `cross-file integration group is incomplete because ${unavailable.map((item) => item.unit.sourcePath).join(", ")} did not produce an applicable candidate`);
+            continue;
+        }
+        const htmlItem = byUnit.get(group.html);
+        let issues = findHtmlIntegrationIssues(targetPath(group.html), htmlItem.code, group.related);
+        options.onProgress?.({ kind: "integration-check", unit: group.html, issues: issues.length });
+        if (issues.length === 0)
+            continue;
+        if (!options.integrate || maxAttempts === 0) {
+            rejectGroup(group, `cross-file integration validation failed: ${describeIssues(issues)}`);
+            continue;
+        }
+        let reconciled = false;
+        for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+            const request = buildIntegrationRequest(group, htmlItem.code, issues, byUnit, contextCharBudget, options.projectMemory);
+            if (!request)
+                break;
+            const outbound = [request.currentCode, request.projectMemory ?? "", ...request.relatedFiles.map((file) => file.content)].join("\n");
+            if (scanSecrets(outbound).length > 0)
+                break;
+            options.onProgress?.({ kind: "integrate", unit: group.html, attempt, issues: issues.length });
+            integrationRequests += 1;
+            try {
+                const integratedCode = await options.integrate(request);
+                if (integratedCode.trim().length === 0 || integratedCode === htmlItem.code)
+                    continue;
+                await validateGeneratedUnit(group.html, integratedCode);
+                const remaining = findHtmlIntegrationIssues(targetPath(group.html), integratedCode, group.related);
+                if (remaining.length > 0) {
+                    issues = remaining;
+                    continue;
+                }
+                htmlItem.code = integratedCode;
+                options.projectMemory?.remember(group.html, integratedCode);
+                reconciled = true;
+                break;
+            }
+            catch (error) {
+                if (error instanceof ContextSecurityError)
+                    throw error;
+                // The request budget is consumed. A known-broken connected group is
+                // rejected below instead of being written partially.
+            }
+        }
+        if (!reconciled)
+            rejectGroup(group, `cross-file integration validation failed after bounded reconciliation: ${describeIssues(issues)}`);
+    }
+    return { results, integrationRequests, checkedTargets: groups.length };
+}
+//# sourceMappingURL=integration-validation.js.map

package/dist/agents/direct/integration-validation.js.map

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

package/dist/agents/direct/presentation.d.ts

@@ -2,6 +2,14 @@ import type { ConversionUnit } from "./types.ts";
 export declare class ModelOutputError extends Error {
     constructor(message: string);
 }
-export declare function renderReceipt(units: readonly ConversionUnit[], provider: string, model: string, configuredLanguages: string | readonly string[]): string;
+export interface ConditionalRequestAllowance {
+    integrationUpTo: number;
+    compilerRepairUpTo: number;
+}
+/** Conservative opt-in request ceilings for pre-generation disclosure. */
+export declare function conditionalRequestAllowance(units: readonly ConversionUnit[], configuredLanguages: string | readonly string[]): ConditionalRequestAllowance;
+export declare function renderReceipt(units: readonly ConversionUnit[], provider: string, model: string, configuredLanguages: string | readonly string[], options?: {
+    reconcileIntegrations?: boolean;
+}): string;
 export declare function stripCodeFence(output: string): string;
 //# sourceMappingURL=presentation.d.ts.map

package/dist/agents/direct/presentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../src/agents/direct/presentation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAC9C,MAAM,CAwCR;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWrD"}
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../src/agents/direct/presentation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,0EAA0E;AAC1E,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,mBAAmB,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAC9C,2BAA2B,CAU7B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAC/C,OAAO,GAAE;IAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO,GAChD,MAAM,CAmDR;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWrD"}

package/dist/agents/direct/presentation.js

@@ -1,11 +1,24 @@
 import { languageProfile } from "./languages.js";
+import { potentialIntegrationRequests } from "./integration-validation.js";
 export class ModelOutputError extends Error {
     constructor(message) {
         super(message);
         this.name = "ModelOutputError";
     }
 }
-export function renderReceipt(units, provider, model, configuredLanguages) {
+/** Conservative opt-in request ceilings for pre-generation disclosure. */
+export function conditionalRequestAllowance(units, configuredLanguages) {
+    const configured = typeof configuredLanguages === "string" ? [configuredLanguages] : configuredLanguages;
+    const primary = configured[0] ?? "typescript";
+    return {
+        integrationUpTo: potentialIntegrationRequests(units),
+        compilerRepairUpTo: units.filter((unit) => {
+            const language = unit.language ?? primary;
+            return unit.kind === "file" && (language === "typescript" || language === "javascript");
+        }).length,
+    };
+}
+export function renderReceipt(units, provider, model, configuredLanguages, options = {}) {
     const configured = typeof configuredLanguages === "string"
         ? [configuredLanguages]
         : configuredLanguages;
@@ -29,6 +42,12 @@ export function renderReceipt(units, provider, model, configuredLanguages) {
     const repairAllowance = repairableUnits.length > 0
         ? ` (up to ${repairableUnits.length} extra bounded repair request${repairableUnits.length === 1 ? "" : "s"} for ${repairLanguages})`
         : "";
+    const conditional = options.reconcileIntegrations
+        ? conditionalRequestAllowance(units, configured)
+        : undefined;
+    const integrationDisclaimer = conditional !== undefined && conditional.integrationUpTo > 0
+        ? `  Additional: opt-in integration reconciliation may issue up to ${conditional.integrationUpTo} extra bounded request${conditional.integrationUpTo === 1 ? "" : "s"}, only when generated cross-file links are missing.`
+        : undefined;
     const lines = [
         "human-to-code — conversion receipt",
         "",
@@ -36,7 +55,12 @@ export function renderReceipt(units, provider, model, configuredLanguages) {
         `  Provider : ${provider}`,
         `  Model    : ${model}`,
         `  Engine   : direct (one model request per prompt; bounded cross-file repair may add requests)`,
-        `  Requests : ${units.length} planned${repairAllowance}`,
+        `  Context  : compact current/projected ProjectMemory (target-specific, bounded)`,
+        `  Requests : ${units.length} planned${options.reconcileIntegrations ? "" : repairAllowance}`,
+        ...(integrationDisclaimer ? [integrationDisclaimer] : []),
+        ...(conditional !== undefined && conditional.compilerRepairUpTo > 0
+            ? [`  Validation: up to ${conditional.compilerRepairUpTo} additional bounded JS/TS compiler-repair request${conditional.compilerRepairUpTo === 1 ? "" : "s"}, only if validation fails.`]
+            : []),
         "",
     ];
     if (units.length === 0)

package/dist/agents/direct/presentation.js.map

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

package/dist/agents/direct/project-contracts.d.ts

@@ -0,0 +1,5 @@
+export declare const PROJECT_CONTRACT_EXTENSIONS: Set<string>;
+export declare const PROJECT_MANIFEST_NAMES: Set<string>;
+/** Extract a bounded interface/relationship summary without executing source. */
+export declare function compactFileContract(path: string, content: string): string;
+//# sourceMappingURL=project-contracts.d.ts.map

package/dist/agents/direct/project-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-contracts.d.ts","sourceRoot":"","sources":["../../../src/agents/direct/project-contracts.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,2BAA2B,aAItC,CAAC;AAEH,eAAO,MAAM,sBAAsB,aAIjC,CAAC;AAiIH,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAuBzE"}

package/dist/agents/direct/project-contracts.js

@@ -0,0 +1,167 @@
+/**
+ * Static, language-aware contract extraction for ProjectMemory. These compact
+ * summaries expose relationships and public structure without executing source
+ * or sending whole files. Credential-bearing content yields no contract.
+ */
+import { basename, extname } from "node:path";
+import { scanSecrets } from "../../context/context.js";
+import { extractStaticFileMemory } from "../../pipeline/file-memory.js";
+const MAX_CONTRACT_CHARS = 2_400;
+const MAX_CONTRACT_ITEMS = 24;
+export const PROJECT_CONTRACT_EXTENSIONS = new Set([
+    ".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs",
+    ".html", ".htm", ".css", ".py", ".rs", ".go", ".java", ".rb",
+    ".cs", ".cpp", ".cc", ".c", ".h", ".hpp", ".json",
+]);
+export const PROJECT_MANIFEST_NAMES = new Set([
+    "package.json", "tsconfig.json", "jsconfig.json", "Cargo.toml", "go.mod",
+    "pom.xml", "build.gradle", "build.gradle.kts", "requirements.txt",
+    "pyproject.toml", "CMakeLists.txt", "Makefile",
+]);
+function oneLine(value, limit) {
+    const sanitized = value
+        .replace(/[\u0000-\u0008\u000b-\u001f\u007f]/gu, " ")
+        .replace(/\s+/gu, " ")
+        .trim();
+    return sanitized.length <= limit ? sanitized : `${sanitized.slice(0, Math.max(0, limit - 1))}…`;
+}
+function unique(values, limit = MAX_CONTRACT_ITEMS) {
+    const result = [];
+    const seen = new Set();
+    for (const value of values) {
+        const cleaned = oneLine(value, 180);
+        if (cleaned.length === 0 || seen.has(cleaned))
+            continue;
+        seen.add(cleaned);
+        result.push(cleaned);
+        if (result.length >= limit)
+            break;
+    }
+    return result;
+}
+function matches(content, expression, group = 1) {
+    const values = [];
+    for (const match of content.matchAll(expression)) {
+        const value = match[group];
+        if (value !== undefined)
+            values.push(value);
+    }
+    return values;
+}
+function listLine(label, values) {
+    return values.length === 0 ? undefined : `${label}: ${values.join(", ")}`;
+}
+function htmlContract(content) {
+    const stylesheets = matches(content, /<link\b(?=[^>]*\brel\s*=\s*["'][^"']*stylesheet[^"']*["'])[^>]*\bhref\s*=\s*["']([^"']+)["'][^>]*>/giu);
+    const scripts = matches(content, /<script\b[^>]*\bsrc\s*=\s*["']([^"']+)["'][^>]*>/giu);
+    const ids = matches(content, /\bid\s*=\s*["']([^"']+)["']/giu)
+        .flatMap((value) => value.split(/\s+/u));
+    const classes = matches(content, /\bclass\s*=\s*["']([^"']+)["']/giu)
+        .flatMap((value) => value.split(/\s+/u));
+    const landmarks = matches(content, /<(header|nav|main|section|article|aside|footer|form)\b/giu);
+    const elements = matches(content, /<([a-z][a-z0-9-]*)\b/giu);
+    return [
+        listLine("stylesheets", unique(stylesheets)),
+        listLine("scripts", unique(scripts)),
+        listLine("ids", unique(ids)),
+        listLine("classes", unique(classes)),
+        listLine("landmarks", unique(landmarks)),
+        listLine("elements", unique(elements)),
+    ].filter((line) => line !== undefined);
+}
+function cssContract(content) {
+    const imports = matches(content, /@import\s+(?:url\(\s*)?["']([^"']+)["']/giu);
+    const urls = matches(content, /url\(\s*["']?([^"')\s]+)["']?\s*\)/giu);
+    const customProperties = matches(content, /(^|[;{]\s*)(--[A-Za-z0-9_-]+)\s*:/gmu, 2);
+    const selectors = matches(content, /(?:^|\})\s*([^@{}][^{}]{0,240})\s*\{/gmu)
+        .flatMap((value) => value.split(","));
+    return [
+        listLine("imports", unique(imports)),
+        listLine("asset URLs", unique(urls)),
+        listLine("custom properties", unique(customProperties)),
+        listLine("selectors", unique(selectors)),
+    ].filter((line) => line !== undefined);
+}
+function javascriptContract(content) {
+    const modules = [
+        ...matches(content, /\b(?:import|export)\b[\s\S]{0,240}?\bfrom\s*["']([^"']+)["']/gu),
+        ...matches(content, /\bimport\s*["']([^"']+)["']/gu),
+        ...matches(content, /\brequire\s*\(\s*["']([^"']+)["']\s*\)/gu),
+    ];
+    const selectors = [
+        ...matches(content, /\bquerySelector(?:All)?\s*\(\s*["']([^"']+)["']/gu),
+        ...matches(content, /\bgetElementById\s*\(\s*["']([^"']+)["']/gu).map((value) => `#${value}`),
+    ];
+    return [
+        listLine("module references", unique(modules)),
+        listLine("DOM selectors", unique(selectors)),
+    ].filter((line) => line !== undefined);
+}
+function genericReferences(path, content) {
+    const extension = extname(path).toLowerCase();
+    if ([".c", ".cc", ".cpp", ".h", ".hpp"].includes(extension)) {
+        return [listLine("includes", unique(matches(content, /^\s*#\s*include\s*["<]([^">]+)[">]/gmu)))]
+            .filter((line) => line !== undefined);
+    }
+    if (extension === ".py") {
+        const imports = [
+            ...matches(content, /^\s*from\s+([A-Za-z0-9_.]+)\s+import/gmu),
+            ...matches(content, /^\s*import\s+([A-Za-z0-9_.]+)/gmu),
+        ];
+        return [listLine("imports", unique(imports))]
+            .filter((line) => line !== undefined);
+    }
+    return [];
+}
+function jsonManifestContract(path, content) {
+    if (basename(path) !== "package.json")
+        return [];
+    try {
+        const parsed = JSON.parse(content);
+        const dependencies = ["dependencies", "devDependencies", "peerDependencies"]
+            .flatMap((key) => {
+            const value = parsed[key];
+            return typeof value === "object" && value !== null && !Array.isArray(value)
+                ? Object.keys(value)
+                : [];
+        });
+        const scripts = typeof parsed.scripts === "object" && parsed.scripts !== null && !Array.isArray(parsed.scripts)
+            ? Object.keys(parsed.scripts)
+            : [];
+        return [
+            typeof parsed.type === "string" ? `module type: ${oneLine(parsed.type, 40)}` : undefined,
+            listLine("dependencies", unique(dependencies)),
+            listLine("script names", unique(scripts)),
+        ].filter((line) => line !== undefined);
+    }
+    catch {
+        return [];
+    }
+}
+/** Extract a bounded interface/relationship summary without executing source. */
+export function compactFileContract(path, content) {
+    if (scanSecrets(content).length > 0)
+        return "";
+    const extension = extname(path).toLowerCase();
+    const details = extension === ".html" || extension === ".htm"
+        ? htmlContract(content)
+        : extension === ".css"
+            ? cssContract(content)
+            : [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"].includes(extension)
+                ? javascriptContract(content)
+                : extension === ".json"
+                    ? jsonManifestContract(path, content)
+                    : genericReferences(path, content);
+    const declarations = extractStaticFileMemory(path, content)
+        .slice(0, MAX_CONTRACT_ITEMS)
+        .map((entry) => oneLine(entry.code, 220));
+    const lines = [
+        ...details,
+        ...(declarations.length > 0 ? [`declarations: ${declarations.join(" | ")}`] : []),
+    ];
+    const rendered = lines.join("\n");
+    return rendered.length <= MAX_CONTRACT_CHARS
+        ? rendered
+        : `${rendered.slice(0, MAX_CONTRACT_CHARS - 1)}…`;
+}
+//# sourceMappingURL=project-contracts.js.map

package/dist/agents/direct/project-contracts.js.map

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

package/dist/agents/direct/project-memory.d.ts

@@ -0,0 +1,42 @@
+import type { ConversionUnit, ProjectMemoryProvider } from "./types.ts";
+export interface ProjectMemoryOptions {
+    /** Reuse discovery's already-bounded walk instead of walking the tree twice. */
+    scannedPaths?: readonly string[];
+    /** Exact names omitted by operator policy. */
+    ignoredNames?: readonly string[];
+    /** Project-relative files or directories forbidden from outbound context. */
+    excludedPaths?: readonly string[];
+    /** Maximum file size eligible for static contract extraction. */
+    maxFileBytes?: number;
+    /** Hard cap on source files read for compact contracts. */
+    maxContractFiles?: number;
+    /** Hard cap for one rendered ProjectMemory block. */
+    renderCharLimit?: number;
+}
+export interface PlannedProjectFile {
+    path: string;
+    sourcePaths: string[];
+    language: string;
+    purposes: string[];
+    created: boolean;
+}
+/** Shared project-level memory updated after every accepted generation. */
+export declare class ProjectMemory implements ProjectMemoryProvider {
+    #private;
+    readonly root: string;
+    readonly currentFiles: readonly string[];
+    readonly projectedFiles: readonly string[];
+    constructor(input: {
+        root: string;
+        currentFiles: readonly string[];
+        planned: ReadonlyMap<string, PlannedProjectFile>;
+        existingContracts: ReadonlyMap<string, string>;
+        contextExcludedTargets: ReadonlySet<string>;
+        renderCharLimit: number;
+    });
+    remember(unit: ConversionUnit, code: string): void;
+    renderFor(unit: ConversionUnit, requestedBudget?: number): string;
+}
+/** Build one immutable current/projected inventory plus compact current contracts. */
+export declare function buildProjectMemory(root: string, units: readonly ConversionUnit[], options?: ProjectMemoryOptions): Promise<ProjectMemory>;
+//# sourceMappingURL=project-memory.d.ts.map

package/dist/agents/direct/project-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory.d.ts","sourceRoot":"","sources":["../../../src/agents/direct/project-memory.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAYxE,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,8CAA8C;IAC9C,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAiKD,2EAA2E;AAC3E,qBAAa,aAAc,YAAW,qBAAqB;;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;gBAgB/B,KAAK,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;QAChC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QACjD,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/C,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5C,eAAe,EAAE,MAAM,CAAC;KACzB;IAuCD,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAgElD,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,eAAe,SAAwB,GAAG,MAAM;CA8EjF;AA6CD,sFAAsF;AACtF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CA6DxB"}