@interf/compiler 0.22.2 → 0.33.0

package/dist/packages/engine/runtime-caches.d.ts

@@ -1,76 +0,0 @@
-/**
- * Runtime read-side caches.
- *
- * The local service runtime fronts a filesystem-backed model: every
- * "list" or "get" call walks `.interf/runtime/...`, parses each JSON
- * record through Zod, and returns the typed shape. Polling clients
- * (Interf UI, CLI status loops) hit those endpoints multiple times
- * per second; on instances with hundreds of build / test runs this
- * shows up as the dominant CPU cost.
- *
- * The caches here memoize the parsed-and-validated results. Each cache
- * is keyed by Preparation data directory so independent Preparations do
- * not cross-pollinate, and each cache exposes both a read path (`get(...)`) and an explicit
- * invalidation hook (`invalidate(...)`). The runtime calls
- * `invalidate*` whenever it writes, so the next read repopulates from
- * disk. Invalidation is intentionally broad (per-preparation, not
- * per-record) — staleness is the only correctness bug worth avoiding,
- * and per-record invalidation introduces fan-out without measurably
- * lowering recompute cost.
- */
-/**
- * Per-(Preparation data directory, preparation) cache for Build run records, plus a
- * runId -> preparation index so `getBuildRun(runId)` can resolve to
- * the owning preparation without scanning every preparation's runs.
- */
-export declare class RunListingCache<TRecord> {
-    /** prepDataDir -> preparation -> records (newest-first sorted). */
-    private byPreparationRoot;
-    /** prepDataDir -> runId -> preparation. */
-    private runIndex;
-    get(prepDataDir: string, preparation: string, fill: () => TRecord[], runIdOf: (record: TRecord) => string): TRecord[];
-    /** Look up which preparation owns this runId, if known. */
-    preparationFor(prepDataDir: string, runId: string): string | null;
-    /** Invalidate a single preparation's cached records and id index. */
-    invalidatePreparation(prepDataDir: string, preparation: string): void;
-    /** Drop everything for a Preparation data directory (e.g. after a reset). */
-    invalidatePreparationRoot(prepDataDir: string): void;
-}
-/**
- * Per-(Preparation data directory, preparation) readiness cache. Readiness joins build
- * runs, test runs, readiness-check runs, and the preparation config; it
- * is computed on every poll. The cache invalidates when the runtime
- * writes any of those underlying objects for a given preparation.
- */
-export declare class ReadinessCache<TReadiness> {
-    private byPreparationRoot;
-    get(prepDataDir: string, preparation: string, compute: () => TReadiness): TReadiness;
-    invalidatePreparation(prepDataDir: string, preparation: string): void;
-    invalidatePreparationRoot(prepDataDir: string): void;
-}
-/**
- * Source-folder listing cache keyed by `(cacheKey, folderRootMtime)`.
- * `cacheKey` is the slot identifier; `folderPath` is the directory the
- * cache stats for an mtime probe. UI polling is the hot path; CLI
- * commands rarely hit the same path twice in <2s, hence the short TTL
- * fallback.
- */
-export declare class MtimeListingCache<TList> {
-    private static readonly TTL_MS;
-    private cache;
-    get(cacheKey: string, folderPath: string, fill: () => TList): TList;
-    invalidate(cacheKey: string): void;
-    invalidateAll(): void;
-}
-/**
- * Build Plan listing cache keyed by the joined mtimes of the
- * bundled / user-library / Preparation-local Build Plan package roots. If
- * any of those ticks (a new local Build Plan package, an edit to the user library, etc.) the cache
- * misses and we re-resolve.
- */
-export declare class BuildPlanListingCache<TList> {
-    private cache;
-    get(cacheKey: string, rootPaths: string[], fill: () => TList): TList;
-    invalidate(cacheKey: string): void;
-    invalidateAll(): void;
-}

package/dist/packages/engine/runtime-proposal-helpers.d.ts

@@ -1,35 +0,0 @@
-import { type SourcePreparationConfig } from "../project/lib/schema.js";
-import { type ActionProposalPlanActionType, type ActionProposalResource } from "./lib/schema.js";
-export declare const ACTION_PLANNER_CLARIFICATION_MESSAGE = "I can help with this Interf instance. Ask a question about Interf, or ask me to create a Preparation, prepare, check readiness, improve, or draft a Build Plan and I will prepare an approval proposal.";
-export type LocalTestMode = "source-files" | "verifiable-context" | "both";
-export declare function createActionProposalId(): string;
-export declare function sanitizeActionProposalPlan(value: unknown): unknown;
-export declare function configuredAgentName(): string | null;
-export declare function detectedExecutorOptions(currentAgentName: string | null): {
-    name: string;
-    display_name: string;
-    command: string;
-    current: boolean;
-}[];
-export declare function slugFromText(value: string): string;
-export declare function escapeRegExp(value: string): string;
-export declare function stringValue(values: Record<string, unknown> | undefined, key: string): string | null;
-export declare function actionTypeFromValues(values: Record<string, unknown> | undefined): ActionProposalPlanActionType | null;
-export declare function directServiceEndpointForAction(actionType: ActionProposalPlanActionType): string | null;
-export declare function numberValue(values: Record<string, unknown> | undefined, key: string): number | null;
-export declare function testModeFromValues(values: Record<string, unknown> | undefined): LocalTestMode | null;
-export declare function testModeValue(values: Record<string, unknown> | undefined, defaultMode?: LocalTestMode): LocalTestMode;
-export declare function testModeCliTarget(mode: LocalTestMode): "source-files" | "verifiable-context";
-export declare function buildPlanIdForProposal(message: string, values: Record<string, unknown> | undefined): string;
-export declare function actionValueBuildPlanTaskPrompt(values: Record<string, unknown> | undefined): string | null;
-export declare function normalizeBuildPlanAuthoringText(value: string): string;
-export declare function extractBuildPlanAuthoringSection(value: string, label: string): string | null;
-export declare function stripBuildPlanCommandPrefix(value: string, buildPlanId: string): string;
-export declare function buildPlanAuthoringPromptFallback(message: string, buildPlanId: string): string;
-export declare function buildPlanAuthoringHintFromPrompt(prompt: string): string;
-export declare function buildPlanLabelFromId(buildPlanId: string): string;
-export declare function detachBuildPlanFromPreparation(preparation: SourcePreparationConfig, buildPlanId: string): SourcePreparationConfig;
-export declare function requireSelectedBuildPlan(preparation: SourcePreparationConfig): string;
-export declare function actionCommandPreview(actionType: ActionProposalResource["action_type"], preparationName: string | null, buildPlanId: string | null, values: Record<string, unknown> | undefined): string;
-export declare function hasVerifiableContextTestTarget(sourcePath: string, preparationConfig: SourcePreparationConfig): boolean;
-export declare function actionAssistantMessage(actionType: ActionProposalResource["action_type"], preparationName: string | null, commandPreview: string): string;

package/dist/packages/engine/runtime-proposal-helpers.js

@@ -1,247 +0,0 @@
-/**
- * Pure helpers used by the runtime's action-proposal and Build Plan authoring
- * paths. None of these depend on runtime state — they shape strings, parse
- * proposal values, and build CLI previews. Keeping them out of runtime.ts
- * lets the coordinator stay small and means future tests can reach these
- * helpers without booting a runtime.
- */
-import { existsSync } from "node:fs";
-import { AGENTS, } from "./agents/lib/constants.js";
-import { detectAgents, supportsAutomatedRuns, } from "./agents/lib/detection.js";
-import { loadUserConfig, } from "./agents/lib/user-config.js";
-import { asPreparationDataDir, preparationVerifiableContextPath, } from "../contracts/lib/preparation-paths.js";
-import { DEFAULT_BUILD_PLAN_ID, buildPlanIdForSourcePreparationConfig, } from "../project/source-config.js";
-import { createVerifiableContextTestTarget, } from "./verify/verify-targets.js";
-import { buildPlanAuthoringTaskPrompt, BuildPlanAuthoringActionValuesSchema, } from "./action-values.js";
-import { ActionProposalPlanActionTypeSchema, } from "./lib/schema.js";
-export const ACTION_PLANNER_CLARIFICATION_MESSAGE = "I can help with this Interf instance. Ask a question about Interf, or ask me to create a Preparation, prepare, check readiness, improve, or draft a Build Plan and I will prepare an approval proposal.";
-export function createActionProposalId() {
-    return `action_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
-}
-export function sanitizeActionProposalPlan(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        return value;
-    const plan = { ...value };
-    for (const key of ["preparation", "build_plan", "title", "summary", "assistant_message", "command_preview"]) {
-        const current = plan[key];
-        if (current === null || current === undefined) {
-            delete plan[key];
-            continue;
-        }
-        if (typeof current === "string" && current.trim().length === 0) {
-            delete plan[key];
-        }
-    }
-    return plan;
-}
-export function configuredAgentName() {
-    const config = loadUserConfig();
-    if (!config)
-        return null;
-    const configured = AGENTS.find((agent) => agent.command === config.agentCommand) ??
-        AGENTS.find((agent) => agent.name === config.agent) ??
-        AGENTS.find((agent) => agent.displayName === config.agent);
-    return configured?.name ?? null;
-}
-export function detectedExecutorOptions(currentAgentName) {
-    return detectAgents()
-        .filter(supportsAutomatedRuns)
-        .map((agent) => ({
-        name: agent.name,
-        display_name: agent.displayName,
-        command: agent.command,
-        current: agent.name === currentAgentName,
-    }));
-}
-export function slugFromText(value) {
-    const slug = value
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 42)
-        .replace(/-+$/g, "");
-    return slug || "custom";
-}
-export function escapeRegExp(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-export function stringValue(values, key) {
-    const value = values?.[key];
-    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
-}
-export function actionTypeFromValues(values) {
-    const explicit = stringValue(values, "action_type") ?? stringValue(values, "service_action");
-    if (explicit) {
-        const parsed = ActionProposalPlanActionTypeSchema.safeParse(explicit);
-        if (parsed.success && parsed.data !== "clarification")
-            return parsed.data;
-    }
-    const action = stringValue(values, "action");
-    if (action === "build" || action === "build-run" || action === "run-preparation")
-        return "build";
-    if (action === "test" || action === "check-readiness")
-        return "test";
-    if (action === "draft-readiness-checks" || action === "readiness-check-draft")
-        return "readiness-check-draft";
-    if (action === "create-build-plan" || action === "build-plan-draft")
-        return "build-plan-draft";
-    if (action === "build-plan-duplicate" || action === "build-plan-remove" || action === "build-plan-change")
-        return "build-plan-change";
-    if (action === "preparation-remove" || action === "preparation-change")
-        return "preparation-change";
-    if (action === "improve-preparation" || action === "build-plan-improvement")
-        return "build-plan-improvement";
-    return null;
-}
-export function directServiceEndpointForAction(actionType) {
-    if (actionType === "preparation-setup")
-        return "/v1/preparation-setups";
-    if (actionType === "build-plan-change")
-        return "/v1/build-plan-changes";
-    if (actionType === "preparation-change")
-        return "/v1/preparation-changes";
-    return null;
-}
-export function numberValue(values, key) {
-    const value = values?.[key];
-    return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-export function testModeFromValues(values) {
-    const value = stringValue(values, "mode") ?? stringValue(values, "target");
-    return value === "source-files" || value === "verifiable-context" || value === "both" ? value : null;
-}
-export function testModeValue(values, defaultMode = "verifiable-context") {
-    return testModeFromValues(values) ?? defaultMode;
-}
-export function testModeCliTarget(mode) {
-    if (mode === "source-files")
-        return "source-files";
-    return "verifiable-context";
-}
-export function buildPlanIdForProposal(message, values) {
-    const explicit = stringValue(values, "build_plan_id") ??
-        stringValue(values, "build_plan");
-    const fromMessage = message.match(/\b(?:create|reate|eate|draft|author|build|make)\s+(?:a\s+new\s+)?(?:interf\s+)?build\s+plan\s+([a-z0-9][a-z0-9-]{0,79})\b/i)?.[1];
-    return explicit ?? fromMessage ?? `custom-${slugFromText(message)}`;
-}
-export function actionValueBuildPlanTaskPrompt(values) {
-    const parsed = BuildPlanAuthoringActionValuesSchema.safeParse(values);
-    return parsed.success ? buildPlanAuthoringTaskPrompt(parsed.data) : null;
-}
-const BUILD_PLAN_AUTHORING_INTERNAL_INSTRUCTION = /Use the attached values as the Build Plan authoring request before proposing the action\.?/gi;
-const BUILD_PLAN_AUTHORING_LABELS = [
-    "Agent work",
-    "Verifiable context output",
-    "Readiness checks",
-    "CLI preview",
-];
-export function normalizeBuildPlanAuthoringText(value) {
-    return value
-        .replace(/[│]+/g, " ")
-        .replace(BUILD_PLAN_AUTHORING_INTERNAL_INSTRUCTION, " ")
-        .replace(/\s+/g, " ")
-        .trim();
-}
-export function extractBuildPlanAuthoringSection(value, label) {
-    const otherLabels = BUILD_PLAN_AUTHORING_LABELS
-        .filter((candidate) => candidate !== label)
-        .map(escapeRegExp)
-        .join("|");
-    const match = value.match(new RegExp(`${escapeRegExp(label)}\\s*:\\s*([\\s\\S]*?)(?=\\s*(?:${otherLabels})\\s*:|$)`, "i"));
-    return match?.[1] ? normalizeBuildPlanAuthoringText(match[1]) : null;
-}
-export function stripBuildPlanCommandPrefix(value, buildPlanId) {
-    const specific = new RegExp(`^(?:create|reate|eate|draft|author|build|make)\\s+(?:a\\s+new\\s+)?(?:interf\\s+)?build\\s+plan\\s+${escapeRegExp(buildPlanId)}\\.?\\s*`, "i");
-    const generic = /^(?:create|reate|eate|draft|author|build|make)\s+(?:a\s+new\s+)?(?:interf\s+)?build\s+plan\b[^.]{0,180}\.\s*/i;
-    const stripped = normalizeBuildPlanAuthoringText(value)
-        .replace(specific, "")
-        .replace(generic, "")
-        .trim();
-    return stripped || normalizeBuildPlanAuthoringText(value);
-}
-export function buildPlanAuthoringPromptFallback(message, buildPlanId) {
-    const cleaned = message
-        .replace(/[│]+/g, " ")
-        .replace(BUILD_PLAN_AUTHORING_INTERNAL_INSTRUCTION, " ")
-        .trim();
-    const agentWork = extractBuildPlanAuthoringSection(cleaned, "Agent work");
-    const portableOutput = extractBuildPlanAuthoringSection(cleaned, "Verifiable context output");
-    const readinessNotes = extractBuildPlanAuthoringSection(cleaned, "Readiness checks");
-    const lines = [
-        agentWork ? `Agent work: ${stripBuildPlanCommandPrefix(agentWork, buildPlanId)}` : null,
-        portableOutput ? `Verifiable context output: ${portableOutput}` : null,
-        readinessNotes ? `Readiness checks: ${readinessNotes}` : null,
-    ].filter((line) => Boolean(line));
-    if (lines.length > 0)
-        return lines.join("\n");
-    return stripBuildPlanCommandPrefix(cleaned, buildPlanId);
-}
-export function buildPlanAuthoringHintFromPrompt(prompt) {
-    const plain = normalizeBuildPlanAuthoringText(prompt.replace(/\b(?:Agent work|Verifiable context output|Readiness checks)\s*:/gi, " "));
-    if (plain.length <= 180)
-        return plain || "Custom Build Plan";
-    const clipped = plain.slice(0, 177).replace(/\s+\S*$/, "").trim();
-    return `${clipped || plain.slice(0, 177)}...`;
-}
-export function buildPlanLabelFromId(buildPlanId) {
-    return buildPlanId
-        .split("-")
-        .filter(Boolean)
-        .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)
-        .join(" ") || buildPlanId;
-}
-export function detachBuildPlanFromPreparation(preparation, buildPlanId) {
-    if (buildPlanIdForSourcePreparationConfig(preparation) !== buildPlanId)
-        return preparation;
-    const { build_plan: _removedBuildPlan, ...detachedPreparation } = preparation;
-    return detachedPreparation;
-}
-export function requireSelectedBuildPlan(preparation) {
-    const buildPlanId = buildPlanIdForSourcePreparationConfig(preparation);
-    if (buildPlanId)
-        return buildPlanId;
-    throw new Error(`Select a Build Plan for Preparation "${preparation.name}" before building it.`);
-}
-export function actionCommandPreview(actionType, preparationName, buildPlanId, values) {
-    if (actionType === "build") {
-        const buildPlanSuffix = buildPlanId ? ` # Build Plan: ${buildPlanId}` : "";
-        return preparationName
-            ? `interf build ${preparationName}${buildPlanSuffix}`
-            : `interf build${buildPlanSuffix}`;
-    }
-    if (actionType === "test") {
-        const mode = testModeCliTarget(testModeValue(values));
-        return preparationName
-            ? `interf test ${preparationName} --target ${mode}`
-            : `interf test --target ${mode}`;
-    }
-    if (actionType === "readiness-check-draft") {
-        return "interf # choose Auto-create readiness checks";
-    }
-    if (actionType === "build-plan-draft" || actionType === "build-plan-improvement") {
-        return "interf build-plan draft";
-    }
-    return "Try: create a Preparation, build, check readiness, draft readiness checks, or draft a Build Plan.";
-}
-export function hasVerifiableContextTestTarget(sourcePath, preparationConfig) {
-    const verifiableContextPath = preparationVerifiableContextPath(asPreparationDataDir(sourcePath), preparationConfig.name);
-    if (!existsSync(verifiableContextPath))
-        return false;
-    return createVerifiableContextTestTarget(verifiableContextPath, preparationConfig.name, buildPlanIdForSourcePreparationConfig(preparationConfig) ?? DEFAULT_BUILD_PLAN_ID).eligible;
-}
-export function actionAssistantMessage(actionType, preparationName, commandPreview) {
-    const preparationSuffix = preparationName ? ` for Preparation "${preparationName}"` : "";
-    if (actionType === "build") {
-        return `Interf prepared a Build run proposal${preparationSuffix}. Approve to submit it through the local Interf service and watch the run in Interf. CLI equivalent: ${commandPreview}`;
-    }
-    if (actionType === "test") {
-        return `Interf prepared a readiness-check proposal${preparationSuffix}. Approve to run the requested target against saved readiness checks. CLI equivalent: ${commandPreview}`;
-    }
-    if (actionType === "readiness-check-draft") {
-        return `Interf prepared a proposal to draft readiness checks${preparationSuffix}. Approve to ask the configured local executor to draft saved checks as a visible run. CLI equivalent: ${commandPreview}`;
-    }
-    if (actionType === "build-plan-draft" || actionType === "build-plan-improvement") {
-        return `Interf prepared a Build Plan proposal${preparationSuffix}. Approve to draft a reusable Build Plan as a visible run. CLI equivalent: ${commandPreview}`;
-    }
-    return "I could not map that to a safe Interf action. Ask for one action in plain English, such as create a Preparation, build context, check readiness, draft readiness checks, or draft a Build Plan.";
-}