@interf/compiler 0.16.0 → 0.21.0

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

@@ -11,10 +11,10 @@ import { detectAgents, supportsAutomatedRuns, } from "./agents/lib/detection.js"
 import { loadUserConfig, } from "./agents/lib/user-config.js";
 import { asPreparationDataDir, preparationPortableContextPath, } from "../contracts/lib/preparation-paths.js";
 import { DEFAULT_METHOD_ID, methodIdForSourcePreparationConfig, } from "../project/source-config.js";
-import { createCompiledTestTarget, } from "./verify/test-targets.js";
+import { createCompiledTestTarget, } from "./verify/verify-targets.js";
 import { methodAuthoringTaskPrompt, MethodAuthoringActionValuesSchema, } from "./action-values.js";
 import { ActionProposalPlanActionTypeSchema, } from "./lib/schema.js";
-export const ACTION_PLANNER_CLARIFICATION_MESSAGE = "I can help with this Interf Workspace. Ask a question about Interf, or ask me to create a Preparation, prepare, check readiness, improve, or draft a Method and I will prepare an approval proposal.";
+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)}`;
 }
@@ -112,15 +112,13 @@ export function testModeFromValues(values) {
         return "compiled";
     return value === "source-files" || value === "compiled" || value === "both" ? value : null;
 }
-export function testModeValue(values, defaultMode = "both") {
+export function testModeValue(values, defaultMode = "compiled") {
     return testModeFromValues(values) ?? defaultMode;
 }
 export function testModeCliTarget(mode) {
     if (mode === "source-files")
         return "source-files";
-    if (mode === "compiled")
-        return "portable-context";
-    return "both";
+    return "compiled";
 }
 export function methodIdForProposal(message, values) {
     const explicit = stringValue(values, "method_id") ??
@@ -210,13 +208,13 @@ export function actionCommandPreview(actionType, preparationName, methodId, valu
     if (actionType === "compile") {
         const methodSuffix = methodId ? ` # Method: ${methodId}` : "";
         return preparationName
-            ? `interf compile --preparation ${preparationName}${methodSuffix}`
+            ? `interf compile ${preparationName}${methodSuffix}`
             : `interf compile${methodSuffix}`;
     }
     if (actionType === "test") {
         const mode = testModeCliTarget(testModeValue(values));
         return preparationName
-            ? `interf test --preparation ${preparationName} --target ${mode}`
+            ? `interf test ${preparationName} --target ${mode}`
             : `interf test --target ${mode}`;
     }
     if (actionType === "readiness-check-draft") {

package/dist/packages/engine/runtime-resource-builders.d.ts

@@ -9,7 +9,7 @@
 import { type ArtifactRef, type ProofRecord } from "./execution/lib/schema.js";
 import { type CompiledState } from "./compile/state.js";
 import { type RuntimeRun } from "./compile/lib/schema.js";
-import { type ReadinessState, type ReadinessTargetResult } from "../contracts/lib/schema.js";
+import { type Artifact, type Readiness, type VerifyTargetResult } from "../contracts/lib/schema.js";
 import { type TestRunTargetSummary } from "./verify/lib/schema.js";
 import { type SourcePreparationConfig } from "../project/lib/schema.js";
 import { type MethodResource, type PreparationResource } from "./lib/schema.js";
@@ -35,18 +35,23 @@ export declare function logsForRuntimeRun(run: RuntimeRun | undefined): {
     prompt_path?: string | undefined;
 } | undefined;
 export declare function passRate(passed: number, total: number): number | null;
-export declare function readinessTargetResult(summary: TestRunTargetSummary | null | undefined, currentFingerprint: string | null, readinessRunFingerprint: string | null | undefined): ReadinessTargetResult | null;
-export declare function readinessSummaryForStatus(status: ReadinessState["status"]): string;
-export declare function readinessStateToPreparationReadiness(readiness: ReadinessState): ReadinessState;
-export declare function buildPreparationResource(rootPath: string, preparation: SourcePreparationConfig, readiness: ReadinessState, latestCompileRunId: string | null, latestTestRunId: string | null): PreparationResource;
+export declare function readinessTargetResult(summary: TestRunTargetSummary | null | undefined, currentFingerprint: string | null, readinessRunFingerprint: string | null | undefined): VerifyTargetResult | null;
+export declare function readinessSummaryForStatus(status: Readiness["status"]): string;
+export declare function readinessStateToPreparationReadiness(readiness: Readiness): Readiness;
+export declare function buildPreparationResource(rootPath: string, preparation: SourcePreparationConfig, readiness: Readiness, latestCompileRunId: string | null, latestTestRunId: string | null, artifacts?: PreparationResource["artifacts"]): PreparationResource;
 export declare function buildMethodResource(resource: {
     id: string;
     path: string;
     label?: string;
     hint?: string;
+    purpose?: {
+        label: string;
+        taskHint: string;
+    };
+    inputs?: MethodResource["inputs"];
     source_kind: "builtin" | "local";
     built_in: boolean;
     active_for_preparations: string[];
-    output_paths: string[];
+    artifacts: Artifact[];
     stages: MethodResource["stages"];
 }): MethodResource;

package/dist/packages/engine/runtime-resource-builders.js

@@ -1,4 +1,4 @@
-import { ReadinessStateSchema, } from "../contracts/lib/schema.js";
+import { ReadinessSchema, } from "../contracts/lib/schema.js";
 import { methodIdForSourcePreparationConfig, resolveSourcePreparationPath, } from "../project/source-config.js";
 import { MethodResourceSchema, PreparationResourceSchema, } from "./lib/schema.js";
 export function createRunId(prefix) {
@@ -85,7 +85,7 @@ export function readinessSummaryForStatus(status) {
     if (status === "ready")
         return "Ready for agent work.";
     if (status === "not-ready")
-        return "Readiness checks did not pass.";
+        return "Artifact or readiness checks did not pass.";
     if (status === "stale")
         return "Readiness checks are stale for the current saved checks.";
     if (status === "checking")
@@ -97,16 +97,16 @@ export function readinessSummaryForStatus(status) {
     if (status === "not-built")
         return "Portable context has not been built yet.";
     if (status === "not-configured")
-        return "No readiness checks are configured.";
+        return "No checks are configured.";
     return "Latest preparation failed.";
 }
 export function readinessStateToPreparationReadiness(readiness) {
-    return ReadinessStateSchema.parse({
+    return ReadinessSchema.parse({
         ...readiness,
         checks: readiness.checks.map((check) => ({ ...check })),
     });
 }
-export function buildPreparationResource(rootPath, preparation, readiness, latestCompileRunId, latestTestRunId) {
+export function buildPreparationResource(rootPath, preparation, readiness, latestCompileRunId, latestTestRunId, artifacts = []) {
     const methodId = methodIdForSourcePreparationConfig(preparation);
     return PreparationResourceSchema.parse({
         id: preparation.name,
@@ -115,6 +115,8 @@ export function buildPreparationResource(rootPath, preparation, readiness, lates
         source_path: resolveSourcePreparationPath(rootPath, preparation),
         method_id: methodId,
         checks: preparation.checks,
+        requested_artifacts: preparation.requested_artifacts ?? [],
+        source_profile: preparation.source_profile ?? null,
         portable_context: {
             preparation: preparation.name,
             path: readiness.portable_context_path,
@@ -131,6 +133,7 @@ export function buildPreparationResource(rootPath, preparation, readiness, lates
         },
         latest_compile_run_id: latestCompileRunId,
         latest_test_run_id: latestTestRunId,
+        artifacts,
     });
 }
 export function buildMethodResource(resource) {
@@ -140,10 +143,19 @@ export function buildMethodResource(resource) {
         path: resource.path,
         ...(resource.label ? { label: resource.label } : {}),
         ...(resource.hint ? { hint: resource.hint } : {}),
+        ...(resource.purpose
+            ? {
+                purpose: {
+                    label: resource.purpose.label,
+                    task_hint: resource.purpose.taskHint,
+                },
+            }
+            : {}),
+        inputs: resource.inputs ?? [],
         source_kind: resource.source_kind,
         built_in: resource.built_in,
         active_for_preparations: resource.active_for_preparations,
-        output_paths: resource.output_paths,
+        artifacts: resource.artifacts,
         stages: resource.stages,
     });
 }

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

@@ -1,7 +1,9 @@
 import { type ArtifactRef, type CompileRun, type InterfRunEvent, type ProofRecord } from "./execution/lib/schema.js";
 import { type RunEventSink } from "./execution/events.js";
-import { type ReadinessState } from "../contracts/lib/schema.js";
+import { type Readiness } from "../contracts/lib/schema.js";
 import type { SourcePreparationConfig } from "../project/lib/schema.js";
+import { type BillingEventSink } from "./compile/billing-events.js";
+import type { IdempotencyStore, RunLeaseStore, TokenValidator } from "./cloud-seams.js";
 import { type ActionProposalCreateRequest, type ActionProposalPlan, type ActionProposalResource, type CompileRunCreateRequest, type CompileRunResource, type MethodResource, type LocalServiceHealth, type LocalJobEvent, type LocalJobEventAppendRequest, type LocalExecutorStatus, type LocalJobRunResource, type LocalRunHandlerResult, type PortableContextResource, type PreparationResource, type ReadinessCheckDraftCreateRequest, type ReadinessCheckDraftResult, type RunObservabilityResource, type ServiceRegistryWorkspace, type SourceFileResource, type WorkspaceFileResource, type VerifyRunCreateRequest, type VerifyRunResource, type MethodAuthoringCreateRequest, type MethodAuthoringResult, type MethodChangeResult, type PreparationChangeResult, type PreparationSetupResult, type ResetResult } from "./lib/schema.js";
 export interface LocalServiceCompileRunContext {
     runId: string;
@@ -58,6 +60,21 @@ export interface LocalServiceRuntimeOptions {
      * skip generating one; production startup always provides a token.
      */
     authToken?: string;
+    /**
+     * 0.17 — optional injection point for the per-Artifact billing event
+     * sink. Local default writes a JSONL file alongside the run record;
+     * cloud variants will inject a Metronome HTTP sender once the
+     * Stripe/Metronome integration ships in 0.18+.
+     */
+    billingEventSink?: BillingEventSink;
+    /**
+     * 0.17 — cloud-variant interface seams. Local default: in-process
+     * Maps on the runtime (current behavior). Cloud variants pass shared
+     * implementations so multi-replica engines coordinate. See
+     * `cloud-seams.ts` for the contract.
+     */
+    idempotencyStore?: IdempotencyStore;
+    runLeaseStore?: RunLeaseStore;
 }
 /**
  * Per-preparation context tracked by the runtime. Multiple preparations can
@@ -99,6 +116,11 @@ export declare class LocalServiceRuntime {
      * when a compile run is launched and cleared once the run reaches a
      * terminal state. Each entry remembers where the persisted record lives
      * so cancel can mark it without re-resolving the Preparation.
+     *
+     * TODO(cloud): when the cloud variant lands, wire `RunLeaseStore`
+     * (see `cloud-seams.ts` B4.2) through this map. Multi-replica engines
+     * need a shared lease store so a replica can take over a run whose
+     * owning replica died.
      */
     private activeCompileRuns;
     /**
@@ -108,6 +130,11 @@ export declare class LocalServiceRuntime {
      * tenants on the same engine (CSO finding: a malicious preparation could
      * otherwise hijack another preparation's run id by reusing its key).
      * Entries expire after `IDEMPOTENCY_TTL_MS`.
+     *
+     * TODO(cloud): when the cloud variant lands, wire `IdempotencyStore`
+     * (see `cloud-seams.ts` B4.1) through this map. Multi-replica engines
+     * need a shared store so retries that land on a different replica
+     * still hit the same dedupe entry.
      */
     private idempotencyKeyCache;
     /**
@@ -122,8 +149,32 @@ export declare class LocalServiceRuntime {
     private readonly readinessCache;
     private readonly sourceFilesCache;
     private readonly methodListingCache;
+    /**
+     * 0.17 — sink for per-Artifact billing events. Set once at construction.
+     * Lazy-defaults to a per-run JSONL writer when no override was injected.
+     */
+    private readonly billingEventSink;
+    /**
+     * 0.17 — cloud-variant injection points. The local engine accepts
+     * these on the options surface but does not consume them yet — the
+     * in-process Maps remain authoritative for idempotency and
+     * run-lease state. The cloud variant fork will swap to these stores;
+     * the option-fields are documented here so the cloud build has a
+     * stable target. See `cloud-seams.ts` for the contracts.
+     */
+    readonly cloudIdempotencyStore: IdempotencyStore | null;
+    readonly cloudRunLeaseStore: RunLeaseStore | null;
+    private cloudTokenValidator;
     constructor(options: LocalServiceRuntimeOptions);
     setBoundPort(port: number): void;
+    /**
+     * 0.17 — token validator setter for cloud variants. Stored on the
+     * runtime so `isAuthorizedMutation` in `server.ts` can opt into the
+     * async per-account check when present. Local default: never set —
+     * the static bearer-token check runs.
+     */
+    setTokenValidator(validator: TokenValidator | null): void;
+    getTokenValidator(): TokenValidator | null;
     /** Set a hook that fires whenever the registered preparations change. */
     setOnRegistryChanged(handler: (() => void) | null): void;
     /**
@@ -175,11 +226,11 @@ export declare class LocalServiceRuntime {
     health(prepDataDir?: string): LocalServiceHealth;
     listPreparations(prepDataDir: string): PreparationResource[];
     getPreparation(prepDataDir: string, preparationName: string): PreparationResource | null;
-    listPreparationReadiness(prepDataDir: string): ReadinessState[];
-    getPreparationReadiness(prepDataDir: string, preparationName: string): ReadinessState | null;
-    listReadiness(prepDataDir: string): ReadinessState[];
-    getReadiness(prepDataDir: string, preparationName: string): ReadinessState | null;
-    computePreparationReadiness(prepDataDir: string, preparation: SourcePreparationConfig): ReadinessState;
+    listPreparationReadiness(prepDataDir: string): Readiness[];
+    getPreparationReadiness(prepDataDir: string, preparationName: string): Readiness | null;
+    listReadiness(prepDataDir: string): Readiness[];
+    getReadiness(prepDataDir: string, preparationName: string): Readiness | null;
+    computePreparationReadiness(prepDataDir: string, preparation: SourcePreparationConfig): Readiness;
     private computePreparationReadinessUncached;
     listSourceFiles(prepDataDir: string, preparationName?: string | null): SourceFileResource[];
     listWorkspaceFiles(prepDataDir: string): WorkspaceFileResource[];
@@ -224,7 +275,7 @@ export declare class LocalServiceRuntime {
     listRunObservability(prepDataDir: string): RunObservabilityResource[];
     getRunObservability(prepDataDir: string, runId: string): RunObservabilityResource | null;
     /**
-     * Method-scoped runs: every method-authoring or method-improvement job
+     * Method Activity runs: every method-authoring or method-improvement job
      * whose `method` matches `methodId`. Surfaced through
      * `GET /v1/methods/<id>/runs` so Method Detail can show the full audit
      * trail of authoring + improvement work for a Method.
@@ -249,7 +300,7 @@ export declare class LocalServiceRuntime {
     createCompileRun(prepDataDir: string, requestValue: unknown): Promise<CompileRunResource>;
     /**
      * Cancel an in-flight compile run. Marks the persisted record as
-     * `cancelled`, emits a `run.failed` event to capture the cancellation in
+     * `cancelled`, emits a `run.cancelled` event to capture the cancellation in
      * the run timeline, and clears the active handle so retries may start a
      * fresh run. If the run already finished, returns
      * `{ cancelled: false, reason: "already finished" }` and persists nothing.
@@ -303,6 +354,17 @@ export declare class LocalServiceRuntime {
     private resolvePreparationConfig;
     private ensureCompiledForRun;
     private readCompileRun;
+    private hydrateCompileRunFromRuntime;
+    private finalizeInterruptedCompileRuns;
+    private finalizeInterruptedJobRuns;
+    /**
+     * 0.17 — emit per-Artifact billing events when a compile run reaches
+     * a terminal state. STUB FORM: writes a JSONL file alongside the run
+     * record by default. Production sink (Metronome HTTP) wires in 0.18+.
+     * The JSONL output is observability/dev fixture, NOT production
+     * billing data.
+     */
+    private emitBillingEventsForRun;
     private writeCompileRun;
     private writeJobRun;
     private writeActionProposal;