@interf/compiler 0.9.4 → 0.13.0

package/dist/packages/local-service/index.js

@@ -1,11 +1,15 @@
 export * as schema from "./lib/schema.js";
 export * as actionValues from "./action-values.js";
+export * as actionDefinitions from "./action-definitions.js";
 export * as routes from "./routes.js";
 export * as client from "./client.js";
 export * as runtime from "./runtime.js";
 export * as server from "./server.js";
-export { CompileRunCreateRequestSchema, CompileRunResourceSchema, CompileRunSummarySchema, LocalServiceDiscoverySchema, PortableContextMappingSchema, PreparationReadinessStateSchema, PreparationRunLinkageSchema, PreparationResourceSchema, MethodResourceSchema, LocalJobAgentSchema, LocalJobEventAppendRequestSchema, LocalJobEventSchema, LocalJobEventTypeSchema, LocalJobRunCreateRequestSchema, LocalJobRunResourceSchema, LocalJobStatusSchema, LocalRunHandlerResultSchema, LocalJobStepSchema, LocalJobTypeSchema, LocalServiceConfigSchema, LocalServiceHealthSchema, LocalServiceInstancePointerSchema, LocalServiceResourceSchema, PortableContextResourceSchema, ReadinessResourceSchema, SourceFileResourceSchema, WorkspaceFileResourceSchema, ReadinessCheckDraftCreateRequestSchema, ReadinessCheckDraftResultSchema, TestRunCreateRequestSchema, TestRunResourceSchema, TestRunStatusSchema, RunCreateRequestSchema, RunObservabilityResourceSchema, RunObservabilityListResponseSchema, LocalExecutorStatusSchema, ActionProposalApprovalRequestSchema, ActionProposalApprovalSchema, ActionProposalCreateRequestSchema, ActionProposalListResponseSchema, ActionProposalPlanSchema, ActionProposalResourceSchema, ActionProposalStatusSchema, ActionProposalTypeSchema, PreparationSetupCreateRequestSchema, MethodAuthoringCreateRequestSchema, MethodAuthoringResultSchema, PreparationListResponseSchema, MethodListResponseSchema, CompileRunListResponseSchema, LocalJobRunListResponseSchema, TestRunListResponseSchema, PortableContextListResponseSchema, ReadinessListResponseSchema, SourceFileListResponseSchema, WorkspaceFileListResponseSchema, OpenPathRequestSchema, OpenPathResponseSchema, } from "./lib/schema.js";
-export { LOCAL_SERVICE_DEFAULT_HOST, LOCAL_SERVICE_DEFAULT_PORT, LOCAL_SERVICE_INSTANCE_POINTER_PATH, LOCAL_SERVICE_ROUTES, buildLocalServiceUrl, } from "./routes.js";
-export { appendLocalJobRunEvent, configuredLocalServiceUrl, findLocalService, getLocalJobRun, getLocalCompileRun, getLocalTestRun, listLocalCompileRuns, listLocalJobRuns, listLocalTestRuns, readLocalServiceRunSnapshot, startLocalJobRun, submitCompileRunToLocalService, submitReadinessCheckDraftToLocalService, submitTestRunToLocalService, submitMethodAuthoringRunToLocalService, waitForLocalJobRun, waitForLocalCompileRun, waitForLocalTestRun, } from "./client.js";
+export { CompileRunCreateRequestSchema, CompileRunResourceSchema, CompileRunSummarySchema, LocalServiceDiscoverySchema, PortableContextMappingSchema, PreparationRunLinkageSchema, PreparationResourceSchema, MethodResourceSchema, LocalJobAgentSchema, LocalJobEventAppendRequestSchema, LocalJobEventSchema, LocalJobEventTypeSchema, LocalJobRunCreateRequestSchema, LocalJobRunResourceSchema, LocalJobStatusSchema, LocalRunHandlerResultSchema, LocalJobStepSchema, LocalJobTypeSchema, LocalServiceConfigSchema, LocalServiceErrorSchema, LocalServiceHealthSchema, PortableContextResourceSchema, ReadinessResourceSchema, SourceFileResourceSchema, ReadinessCheckDraftCreateRequestSchema, ReadinessCheckDraftResultSchema, TestRunCreateRequestSchema, TestRunResourceSchema, TestRunStatusSchema, RunObservabilityResourceSchema, RunObservabilityListResponseSchema, LocalExecutorStatusSchema, ActionClientOriginSchema, ActionProposalApprovalRequestSchema, ActionProposalApprovalSchema, ActionProposalCreateRequestSchema, ActionProposalListResponseSchema, ActionProposalPlanSchema, ActionProposalPlanActionTypeSchema, ActionProposalResourceSchema, ActionProposalStatusSchema, ActionProposalTypeSchema, ResetRequestSchema, ResetResultSchema, MethodAuthoringCreateRequestSchema, MethodAuthoringResultSchema, PreparationListResponseSchema, MethodListResponseSchema, PortableContextListResponseSchema, SourceFileListResponseSchema, OpenPathRequestSchema, OpenPathResponseSchema, } from "./lib/schema.js";
+export { LOCAL_SERVICE_DEFAULT_HOST, LOCAL_SERVICE_DEFAULT_PORT, LOCAL_SERVICE_ROUTES, buildLocalServiceUrl, } from "./routes.js";
+export { ServiceRegistrySchema, ServiceRegistryEntrySchema, ServiceRegistryWorkspaceSchema, } from "./lib/schema.js";
+export { readServiceRegistry, registerServiceLocally, unregisterService, writeServiceRegistry, serviceRegistryPath, } from "./service-registry.js";
+export { approveActionProposalInLocalService, cancelLocalCompileRun, configuredLocalServiceUrl, resolveLocalServiceAuthToken, createActionProposalInLocalService, decideActionProposalInLocalService, findLocalService, getLocalJobRun, getLocalCompileRun, getLocalServiceHealth, getLocalTestRun, submitCompileRunToLocalService, submitReadinessCheckDraftToLocalService, submitResetToLocalService, submitTestRunToLocalService, submitMethodAuthoringRunToLocalService, waitForLocalJobRun, waitForLocalCompileRun, waitForLocalTestRun, } from "./client.js";
 export { LocalServiceRuntime, createLocalServiceRuntime, } from "./runtime.js";
-export { createLocalServiceServer, startLocalService, } from "./server.js";
+export { createLocalServiceServer, createLocalServiceAuthToken, startLocalService, } from "./server.js";
+export { createNativeLocalServiceRunHandlers, } from "./native-run-handlers.js";

package/dist/packages/local-service/instance-paths.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Source of truth for every Interf path on disk in 0.13.
+ *
+ * The instance is a black box that owns its preparation state. Storage lives
+ * under `~/.interf/`. The CLI never opens these files directly — it asks the
+ * API where things are and reads from the locator the API returns.
+ *
+ * Layout:
+ *   ~/.interf/
+ *     connection.json            ← single CLI connection record
+ *     services.json              ← internal stop-lookup registry
+ *     methods/<id>/              ← user-installed methods (cross-preparation)
+ *     preparations/<prep-id>/    ← per-preparation state owned by the engine
+ *       config.json              ← preparation config (id, source, method, …)
+ *       portable-context/        ← compiled portable context output
+ *         .interf/               ← per-preparation runtime/method/tests state
+ *       runs/                    ← persisted run records
+ *       jobs/                    ← service job runs
+ *       proposals/               ← chat/wizard action proposals
+ *       tests/                   ← saved readiness check specs
+ */
+export type InterfHomeRoot = string & {
+    readonly __brand: "InterfHomeRoot";
+};
+export type PreparationDataDir = string & {
+    readonly __brand: "PreparationDataDir";
+};
+export type PortableContextPath = string & {
+    readonly __brand: "PortableContextPath";
+};
+export type SourceFolderPath = string & {
+    readonly __brand: "SourceFolderPath";
+};
+export declare const INTERF_USER_HOME_ENV = "INTERF_USER_HOME";
+export declare const INTERF_HOME_DIR = ".interf";
+export declare const PREPARATIONS_DIR = "preparations";
+export declare const METHODS_DIR = "methods";
+export declare const SERVICE_REGISTRY_FILENAME = "services.json";
+export declare const CONNECTION_CONFIG_FILENAME = "connection.json";
+export declare const PREPARATION_CONFIG_FILENAME = "config.json";
+export declare const PREPARATION_PORTABLE_CONTEXT_DIR = "portable-context";
+export declare const PREPARATION_RUNS_DIR = "runs";
+export declare const PREPARATION_JOBS_DIR = "jobs";
+export declare const PREPARATION_PROPOSALS_DIR = "proposals";
+export declare const PREPARATION_TESTS_DIR = "tests";
+export declare const PREPARATION_METHOD_DIR = "method";
+export declare const PORTABLE_CONTEXT_STATE_DIR = ".interf";
+export declare const PORTABLE_CONTEXT_RUNTIME_DIR = "runtime";
+export declare const PORTABLE_CONTEXT_METHOD_DIR = "method";
+export declare const PORTABLE_CONTEXT_TESTS_DIR = "tests";
+export declare function asPreparationDataDir(path: string): PreparationDataDir;
+export declare function asPortableContextPath(path: string): PortableContextPath;
+export declare function asSourceFolderPath(path: string): SourceFolderPath;
+/** `~/.interf/` — overridable via INTERF_USER_HOME for tests. */
+export declare function interfHomeRoot(): InterfHomeRoot;
+/** `~/.interf/connection.json` — single CLI connection record. */
+export declare function connectionConfigPath(): string;
+/** `~/.interf/services.json` — internal `interf web stop` lookup registry. */
+export declare function serviceRegistryPath(): string;
+/** `~/.interf/methods/` — user-installed methods (cross-preparation). */
+export declare function userMethodsRoot(): string;
+/** `~/.interf/methods/<id>/` — a specific user-library method package. */
+export declare function userMethodPackagePath(methodId: string): string;
+/** `~/.interf/preparations/` — root for all preparation state. */
+export declare function preparationsRoot(): string;
+/** `~/.interf/preparations/<prep-id>/` — one preparation's state dir. */
+export declare function preparationDataDir(prepId: string): PreparationDataDir;
+/** `<prep-data>/config.json` — preparation config source of truth. */
+export declare function preparationConfigPath(prepId: string): string;
+/** `<prep-data>/portable-context/` — compiled portable context output. */
+export declare function preparationPortableContextDir(prepId: string): PortableContextPath;
+/** `<prep-data>/runs/` — compile/test run records. */
+export declare function preparationRunsRoot(prepId: string): string;
+/** `<prep-data>/jobs/` — service job runs (drafts, improvements, etc). */
+export declare function preparationJobsRoot(prepId: string): string;
+/** `<prep-data>/proposals/` — action proposals scoped to this preparation. */
+export declare function preparationProposalsRoot(prepId: string): string;
+/** `<prep-data>/tests/` — saved readiness check specs. */
+export declare function preparationTestsRoot(prepId: string): string;
+/** `<prep-data>/method/` — preparation-draft method package (if any). */
+export declare function preparationMethodDraftPath(prepId: string): string;
+/** `<portable-context>/.interf/`. */
+export declare function portableContextStateRoot(portableContext: PortableContextPath): string;
+/** `<portable-context>/.interf/method/`. */
+export declare function portableContextMethodPath(portableContext: PortableContextPath): string;
+/** `<portable-context>/.interf/runtime/`. */
+export declare function portableContextRuntimeRoot(portableContext: PortableContextPath): string;
+/** `<portable-context>/.interf/tests/`. */
+export declare function portableContextTestsRoot(portableContext: PortableContextPath): string;
+export type PreparationTestTargetLabel = "source-files" | "compiled";
+/** `<prep-data>/portable-context/.interf/tests/<target>/runs/`. */
+export declare function preparationTestRunsRoot(prepId: string, target: PreparationTestTargetLabel): string;
+/** `<prep-data>/portable-context/.interf/tests/latest.json`. */
+export declare function preparationLatestReadinessRunPath(prepId: string): string;
+/** `<prep-data>/portable-context/.interf/tests/latest.md`. */
+export declare function preparationLatestReadinessSummaryPath(prepId: string): string;
+/** Normalize a free-form string into a stable kebab-cased id (≤80 chars). */
+export declare function normalizePreparationTestRunId(input: string): string;
+/** `<prep-data>/portable-context/.interf/tests/<target>/runs/<timestamp>-<run-id>[-<suffix>].json`. */
+export declare function preparationTestRunPath(prepId: string, target: PreparationTestTargetLabel, generatedAt: string, runId: string, runSuffix?: string | null): string;

package/dist/packages/local-service/instance-paths.js

@@ -0,0 +1,165 @@
+/**
+ * Source of truth for every Interf path on disk in 0.13.
+ *
+ * The instance is a black box that owns its preparation state. Storage lives
+ * under `~/.interf/`. The CLI never opens these files directly — it asks the
+ * API where things are and reads from the locator the API returns.
+ *
+ * Layout:
+ *   ~/.interf/
+ *     connection.json            ← single CLI connection record
+ *     services.json              ← internal stop-lookup registry
+ *     methods/<id>/              ← user-installed methods (cross-preparation)
+ *     preparations/<prep-id>/    ← per-preparation state owned by the engine
+ *       config.json              ← preparation config (id, source, method, …)
+ *       portable-context/        ← compiled portable context output
+ *         .interf/               ← per-preparation runtime/method/tests state
+ *       runs/                    ← persisted run records
+ *       jobs/                    ← service job runs
+ *       proposals/               ← chat/wizard action proposals
+ *       tests/                   ← saved readiness check specs
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+// ───────────────────────────────────────────────────────────────────────────
+// Constants
+// ───────────────────────────────────────────────────────────────────────────
+export const INTERF_USER_HOME_ENV = "INTERF_USER_HOME";
+export const INTERF_HOME_DIR = ".interf";
+export const PREPARATIONS_DIR = "preparations";
+export const METHODS_DIR = "methods";
+export const SERVICE_REGISTRY_FILENAME = "services.json";
+export const CONNECTION_CONFIG_FILENAME = "connection.json";
+export const PREPARATION_CONFIG_FILENAME = "config.json";
+export const PREPARATION_PORTABLE_CONTEXT_DIR = "portable-context";
+export const PREPARATION_RUNS_DIR = "runs";
+export const PREPARATION_JOBS_DIR = "jobs";
+export const PREPARATION_PROPOSALS_DIR = "proposals";
+export const PREPARATION_TESTS_DIR = "tests";
+export const PREPARATION_METHOD_DIR = "method";
+export const PORTABLE_CONTEXT_STATE_DIR = ".interf";
+export const PORTABLE_CONTEXT_RUNTIME_DIR = "runtime";
+export const PORTABLE_CONTEXT_METHOD_DIR = "method";
+export const PORTABLE_CONTEXT_TESTS_DIR = "tests";
+// ───────────────────────────────────────────────────────────────────────────
+// Brand constructors
+// ───────────────────────────────────────────────────────────────────────────
+export function asPreparationDataDir(path) {
+    return path;
+}
+export function asPortableContextPath(path) {
+    return path;
+}
+export function asSourceFolderPath(path) {
+    return path;
+}
+// ───────────────────────────────────────────────────────────────────────────
+// Interf Home (~/.interf/)
+// ───────────────────────────────────────────────────────────────────────────
+/** `~/.interf/` — overridable via INTERF_USER_HOME for tests. */
+export function interfHomeRoot() {
+    const override = process.env[INTERF_USER_HOME_ENV]?.trim();
+    if (override && override.length > 0)
+        return override;
+    return join(homedir(), INTERF_HOME_DIR);
+}
+/** `~/.interf/connection.json` — single CLI connection record. */
+export function connectionConfigPath() {
+    return join(interfHomeRoot(), CONNECTION_CONFIG_FILENAME);
+}
+/** `~/.interf/services.json` — internal `interf web stop` lookup registry. */
+export function serviceRegistryPath() {
+    return join(interfHomeRoot(), SERVICE_REGISTRY_FILENAME);
+}
+/** `~/.interf/methods/` — user-installed methods (cross-preparation). */
+export function userMethodsRoot() {
+    return join(interfHomeRoot(), METHODS_DIR);
+}
+/** `~/.interf/methods/<id>/` — a specific user-library method package. */
+export function userMethodPackagePath(methodId) {
+    return join(userMethodsRoot(), methodId);
+}
+// ───────────────────────────────────────────────────────────────────────────
+// Preparation data dirs
+// ───────────────────────────────────────────────────────────────────────────
+/** `~/.interf/preparations/` — root for all preparation state. */
+export function preparationsRoot() {
+    return join(interfHomeRoot(), PREPARATIONS_DIR);
+}
+/** `~/.interf/preparations/<prep-id>/` — one preparation's state dir. */
+export function preparationDataDir(prepId) {
+    return asPreparationDataDir(join(preparationsRoot(), prepId));
+}
+/** `<prep-data>/config.json` — preparation config source of truth. */
+export function preparationConfigPath(prepId) {
+    return join(preparationDataDir(prepId), PREPARATION_CONFIG_FILENAME);
+}
+/** `<prep-data>/portable-context/` — compiled portable context output. */
+export function preparationPortableContextDir(prepId) {
+    return asPortableContextPath(join(preparationDataDir(prepId), PREPARATION_PORTABLE_CONTEXT_DIR));
+}
+/** `<prep-data>/runs/` — compile/test run records. */
+export function preparationRunsRoot(prepId) {
+    return join(preparationDataDir(prepId), PREPARATION_RUNS_DIR);
+}
+/** `<prep-data>/jobs/` — service job runs (drafts, improvements, etc). */
+export function preparationJobsRoot(prepId) {
+    return join(preparationDataDir(prepId), PREPARATION_JOBS_DIR);
+}
+/** `<prep-data>/proposals/` — action proposals scoped to this preparation. */
+export function preparationProposalsRoot(prepId) {
+    return join(preparationDataDir(prepId), PREPARATION_PROPOSALS_DIR);
+}
+/** `<prep-data>/tests/` — saved readiness check specs. */
+export function preparationTestsRoot(prepId) {
+    return join(preparationDataDir(prepId), PREPARATION_TESTS_DIR);
+}
+/** `<prep-data>/method/` — preparation-draft method package (if any). */
+export function preparationMethodDraftPath(prepId) {
+    return join(preparationDataDir(prepId), PREPARATION_METHOD_DIR);
+}
+// ───────────────────────────────────────────────────────────────────────────
+// Portable context state (per-preparation, lives under preparation data dir)
+// ───────────────────────────────────────────────────────────────────────────
+/** `<portable-context>/.interf/`. */
+export function portableContextStateRoot(portableContext) {
+    return join(portableContext, PORTABLE_CONTEXT_STATE_DIR);
+}
+/** `<portable-context>/.interf/method/`. */
+export function portableContextMethodPath(portableContext) {
+    return join(portableContextStateRoot(portableContext), PORTABLE_CONTEXT_METHOD_DIR);
+}
+/** `<portable-context>/.interf/runtime/`. */
+export function portableContextRuntimeRoot(portableContext) {
+    return join(portableContextStateRoot(portableContext), PORTABLE_CONTEXT_RUNTIME_DIR);
+}
+/** `<portable-context>/.interf/tests/`. */
+export function portableContextTestsRoot(portableContext) {
+    return join(portableContextStateRoot(portableContext), PORTABLE_CONTEXT_TESTS_DIR);
+}
+/** `<prep-data>/portable-context/.interf/tests/<target>/runs/`. */
+export function preparationTestRunsRoot(prepId, target) {
+    return join(portableContextTestsRoot(preparationPortableContextDir(prepId)), target, "runs");
+}
+/** `<prep-data>/portable-context/.interf/tests/latest.json`. */
+export function preparationLatestReadinessRunPath(prepId) {
+    return join(portableContextTestsRoot(preparationPortableContextDir(prepId)), "latest.json");
+}
+/** `<prep-data>/portable-context/.interf/tests/latest.md`. */
+export function preparationLatestReadinessSummaryPath(prepId) {
+    return join(portableContextTestsRoot(preparationPortableContextDir(prepId)), "latest.md");
+}
+/** Normalize a free-form string into a stable kebab-cased id (≤80 chars). */
+export function normalizePreparationTestRunId(input) {
+    return input
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+}
+/** `<prep-data>/portable-context/.interf/tests/<target>/runs/<timestamp>-<run-id>[-<suffix>].json`. */
+export function preparationTestRunPath(prepId, target, generatedAt, runId, runSuffix) {
+    const suffix = runSuffix ? `-${normalizePreparationTestRunId(runSuffix)}` : "";
+    return join(preparationTestRunsRoot(prepId, target), `${generatedAt.replace(/[:.]/g, "-")}-${runId}${suffix}.json`);
+}