@interf/compiler 0.22.2 → 0.50.0

package/dist/packages/contracts/lib/project-schema.d.ts

@@ -0,0 +1,423 @@
+import { z } from "zod";
+import { InterfIdPattern, isInterfRelativePath } from "./schema.js";
+export declare const ProjectNamePattern: RegExp;
+export declare const ProjectNameSchema: z.ZodString;
+export type ProjectName = z.infer<typeof ProjectNameSchema>;
+/**
+ * Drift verdict for a Project's source binding.
+ *
+ *   fresh    — latest Source Manifest matches the latest Context Graph
+ *   drifted  — a newer Source Manifest differs from latest Context Graph
+ *   missing  — retained for older records where local Source was unreadable
+ *   unknown  — no Source Manifest exists yet
+ */
+export declare const DriftKindSchema: z.ZodEnum<{
+    unknown: "unknown";
+    missing: "missing";
+    fresh: "fresh";
+    drifted: "drifted";
+}>;
+export type DriftKind = z.infer<typeof DriftKindSchema>;
+/**
+ * Per-Project Source state. Computed from the latest Source Manifest, not by
+ * reading the Source locator directly.
+ */
+export declare const ProjectSourceStateSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-project-source-state">;
+    version: z.ZodLiteral<1>;
+    project_id: z.ZodString;
+    file_index_hash: z.ZodNullable<z.ZodString>;
+    file_count: z.ZodNumber;
+    last_observed_at: z.ZodString;
+    drift_kind: z.ZodEnum<{
+        unknown: "unknown";
+        missing: "missing";
+        fresh: "fresh";
+        drifted: "drifted";
+    }>;
+    drift_summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ProjectSourceState = z.infer<typeof ProjectSourceStateSchema>;
+export declare const TraceSchema: z.ZodObject<{
+    kind: z.ZodString;
+    label: z.ZodString;
+    count: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodOptional<z.ZodNumber>;
+    passed: z.ZodOptional<z.ZodBoolean>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type Trace = z.infer<typeof TraceSchema>;
+export declare const TracesSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-context-graph-traces">;
+    version: z.ZodLiteral<1>;
+    generated_at: z.ZodString;
+    graph_id: z.ZodString;
+    project_id: z.ZodString;
+    files_processed: z.ZodNumber;
+    files_total: z.ZodNumber;
+    checks_passed: z.ZodNumber;
+    checks_total: z.ZodNumber;
+    ready: z.ZodBoolean;
+    pages_read: z.ZodOptional<z.ZodNumber>;
+    charts_extracted: z.ZodOptional<z.ZodNumber>;
+    entities_found: z.ZodOptional<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        label: z.ZodString;
+        count: z.ZodOptional<z.ZodNumber>;
+        total: z.ZodOptional<z.ZodNumber>;
+        passed: z.ZodOptional<z.ZodBoolean>;
+        detail: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type Traces = z.infer<typeof TracesSchema>;
+export declare const ContextGraphLocatorSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        "local-path": "local-path";
+        "remote-url": "remote-url";
+        "api-served": "api-served";
+    }>;
+    value: z.ZodString;
+}, z.core.$strict>;
+export type ContextGraphLocator = z.infer<typeof ContextGraphLocatorSchema>;
+export declare const ContextGraphArtifactHandoffSchema: z.ZodObject<{
+    artifact_id: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    locator: z.ZodObject<{
+        kind: z.ZodEnum<{
+            "local-path": "local-path";
+            "remote-url": "remote-url";
+            "api-served": "api-served";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    path: z.ZodOptional<z.ZodString>;
+    artifact_kind: z.ZodOptional<z.ZodEnum<{
+        file: "file";
+        directory: "directory";
+    }>>;
+    role: z.ZodDefault<z.ZodEnum<{
+        entrypoint: "entrypoint";
+        artifact: "artifact";
+        guidance: "guidance";
+        "source-index": "source-index";
+    }>>;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ContextGraphArtifactHandoff = z.infer<typeof ContextGraphArtifactHandoffSchema>;
+export declare const ContextGraphPortableHandoffSchema: z.ZodObject<{
+    locator: z.ZodObject<{
+        kind: z.ZodEnum<{
+            "local-path": "local-path";
+            "remote-url": "remote-url";
+            "api-served": "api-served";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    instructions: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ContextGraphPortableHandoff = z.infer<typeof ContextGraphPortableHandoffSchema>;
+export declare const ContextGraphHandoffSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-context-graph-handoff">;
+    version: z.ZodLiteral<1>;
+    entrypoint: z.ZodObject<{
+        artifact_id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        locator: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        path: z.ZodOptional<z.ZodString>;
+        artifact_kind: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            directory: "directory";
+        }>>;
+        role: z.ZodDefault<z.ZodEnum<{
+            entrypoint: "entrypoint";
+            artifact: "artifact";
+            guidance: "guidance";
+            "source-index": "source-index";
+        }>>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        artifact_id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        locator: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        path: z.ZodOptional<z.ZodString>;
+        artifact_kind: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            directory: "directory";
+        }>>;
+        role: z.ZodDefault<z.ZodEnum<{
+            entrypoint: "entrypoint";
+            artifact: "artifact";
+            guidance: "guidance";
+            "source-index": "source-index";
+        }>>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    portable: z.ZodOptional<z.ZodObject<{
+        locator: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ContextGraphHandoff = z.infer<typeof ContextGraphHandoffSchema>;
+export declare const ContextGraphSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-context-graph">;
+    version: z.ZodLiteral<1>;
+    graph_id: z.ZodString;
+    project_id: z.ZodString;
+    intent: z.ZodOptional<z.ZodString>;
+    build_run_id: z.ZodString;
+    source_state_id: z.ZodString;
+    source_manifest_id: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodString;
+    ready: z.ZodBoolean;
+    readiness: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"interf-readiness-state">;
+        version: z.ZodLiteral<1>;
+        generated_at: z.ZodString;
+        project: z.ZodString;
+        status: z.ZodEnum<{
+            ready: "ready";
+            "not-ready": "not-ready";
+            failed: "failed";
+            "not-configured": "not-configured";
+            "not-built": "not-built";
+            building: "building";
+            built: "built";
+            checking: "checking";
+            stale: "stale";
+        }>;
+        ready: z.ZodBoolean;
+        summary: z.ZodString;
+        context_graph_path: z.ZodNullable<z.ZodString>;
+        latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        build: z.ZodNullable<z.ZodObject<{
+            gate: z.ZodEnum<{
+                "context-graph": "context-graph";
+                "project-config": "project-config";
+                "build-run": "build-run";
+                "artifact-diagnostics": "artifact-diagnostics";
+                "context-checks": "context-checks";
+                benchmarks: "benchmarks";
+                "benchmarks-current": "benchmarks-current";
+            }>;
+            ok: z.ZodBoolean;
+            status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                "not-ready": "not-ready";
+                failed: "failed";
+                "not-configured": "not-configured";
+                "not-built": "not-built";
+                building: "building";
+                built: "built";
+                checking: "checking";
+                stale: "stale";
+            }>>;
+            summary: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+            run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        check_results: z.ZodObject<{
+            configured: z.ZodNumber;
+            fingerprint: z.ZodNullable<z.ZodString>;
+            source_files: z.ZodNullable<z.ZodObject<{
+                passed: z.ZodNumber;
+                total: z.ZodNumber;
+                pass_rate: z.ZodNullable<z.ZodNumber>;
+                checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                stale: z.ZodDefault<z.ZodBoolean>;
+                run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+            context_graph: z.ZodNullable<z.ZodObject<{
+                passed: z.ZodNumber;
+                total: z.ZodNumber;
+                pass_rate: z.ZodNullable<z.ZodNumber>;
+                checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                stale: z.ZodDefault<z.ZodBoolean>;
+                run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            gate: z.ZodEnum<{
+                "context-graph": "context-graph";
+                "project-config": "project-config";
+                "build-run": "build-run";
+                "artifact-diagnostics": "artifact-diagnostics";
+                "context-checks": "context-checks";
+                benchmarks: "benchmarks";
+                "benchmarks-current": "benchmarks-current";
+            }>;
+            ok: z.ZodBoolean;
+            status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                "not-ready": "not-ready";
+                failed: "failed";
+                "not-configured": "not-configured";
+                "not-built": "not-built";
+                building: "building";
+                built: "built";
+                checking: "checking";
+                stale: "stale";
+            }>>;
+            summary: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+            run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    locator: z.ZodObject<{
+        kind: z.ZodEnum<{
+            "local-path": "local-path";
+            "remote-url": "remote-url";
+            "api-served": "api-served";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strict>;
+    entrypoint_artifact: z.ZodOptional<z.ZodObject<{
+        artifact_id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        locator: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        path: z.ZodOptional<z.ZodString>;
+        artifact_kind: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            directory: "directory";
+        }>>;
+        role: z.ZodDefault<z.ZodEnum<{
+            entrypoint: "entrypoint";
+            artifact: "artifact";
+            guidance: "guidance";
+            "source-index": "source-index";
+        }>>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    artifact_handoffs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        artifact_id: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        locator: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        path: z.ZodOptional<z.ZodString>;
+        artifact_kind: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            directory: "directory";
+        }>>;
+        role: z.ZodDefault<z.ZodEnum<{
+            entrypoint: "entrypoint";
+            artifact: "artifact";
+            guidance: "guidance";
+            "source-index": "source-index";
+        }>>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    portable_handoff: z.ZodOptional<z.ZodObject<{
+        locator: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        artifact_id: z.ZodString;
+        status: z.ZodEnum<{
+            ready: "ready";
+            failed: "failed";
+            skipped: "skipped";
+            not_ready: "not_ready";
+        }>;
+        built_by_stages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        check_results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            check_id: z.ZodString;
+            kind: z.ZodEnum<{
+                file_exists: "file_exists";
+                source_manifest_valid: "source_manifest_valid";
+                min_file_count: "min_file_count";
+                min_file_count_matches_source: "min_file_count_matches_source";
+                source_summary_folders: "source_summary_folders";
+                source_page_coverage: "source_page_coverage";
+                frontmatter_valid: "frontmatter_valid";
+                frontmatter_required_keys: "frontmatter_required_keys";
+                frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                source_refs_required: "source_refs_required";
+                summary_backlinks_present: "summary_backlinks_present";
+                knowledge_web_connectivity: "knowledge_web_connectivity";
+                graph_notes_connected: "graph_notes_connected";
+                wikilinks_valid: "wikilinks_valid";
+                must_not_contain: "must_not_contain";
+                must_contain: "must_contain";
+                qa_match: "qa_match";
+            }>;
+            passed: z.ZodBoolean;
+            required: z.ZodBoolean;
+            summary: z.ZodString;
+            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            evaluated_at: z.ZodString;
+        }, z.core.$strict>>>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    traces: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-context-graph-traces">;
+        version: z.ZodLiteral<1>;
+        generated_at: z.ZodString;
+        graph_id: z.ZodString;
+        project_id: z.ZodString;
+        files_processed: z.ZodNumber;
+        files_total: z.ZodNumber;
+        checks_passed: z.ZodNumber;
+        checks_total: z.ZodNumber;
+        ready: z.ZodBoolean;
+        pages_read: z.ZodOptional<z.ZodNumber>;
+        charts_extracted: z.ZodOptional<z.ZodNumber>;
+        entities_found: z.ZodOptional<z.ZodNumber>;
+        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            label: z.ZodString;
+            count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            passed: z.ZodOptional<z.ZodBoolean>;
+            detail: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ContextGraph = z.infer<typeof ContextGraphSchema>;
+export { isInterfRelativePath, InterfIdPattern };

package/dist/packages/contracts/lib/project-schema.js

@@ -0,0 +1,138 @@
+import { z } from "zod";
+import { ArtifactIdSchema, ArtifactStatusSchema, InterfIdPattern, LocatorSchema, ProjectIdPattern, ProjectIdSchema, ProjectIntentSchema, ReadinessSchema, isInterfRelativePath, } from "./schema.js";
+// ───────────────────────────────────────────────────────────────────────────
+// Project — the durable Source binding and selected Build Plan container.
+//
+// A Project binds a Source (folder), Project intent, execution agents, Project
+// activity, and one selected Build Plan. The Build Plan is the recipe for
+// preparing a Context Graph for that Project intent.
+// Each Build produces one Context Graph.
+//
+// Project identity = `path + machine_id` (same folder on different machines
+// is a different Project). The `id` here is the user-facing handle, derived
+// from the source folder basename + locator hash at create time.
+// ───────────────────────────────────────────────────────────────────────────
+// A Project's user-facing handle and its internal id share one identity rule:
+// same regex, same reserved set, same messages. Both names alias the single
+// source in `schema.ts` (`ProjectIdPattern` / `ProjectIdSchema`) so the rule is
+// defined once. The aliases preserve the `projectSchema.*` namespace surface.
+export const ProjectNamePattern = ProjectIdPattern;
+export const ProjectNameSchema = ProjectIdSchema;
+/**
+ * Drift verdict for a Project's source binding.
+ *
+ *   fresh    — latest Source Manifest matches the latest Context Graph
+ *   drifted  — a newer Source Manifest differs from latest Context Graph
+ *   missing  — retained for older records where local Source was unreadable
+ *   unknown  — no Source Manifest exists yet
+ */
+export const DriftKindSchema = z.enum(["fresh", "drifted", "missing", "unknown"]);
+/**
+ * Per-Project Source state. Computed from the latest Source Manifest, not by
+ * reading the Source locator directly.
+ */
+export const ProjectSourceStateSchema = z.object({
+    kind: z.literal("interf-project-source-state"),
+    version: z.literal(1),
+    project_id: z.string().min(1),
+    file_index_hash: z.string().min(1).nullable(),
+    file_count: z.number().int().min(0),
+    last_observed_at: z.string().min(1),
+    drift_kind: DriftKindSchema,
+    drift_summary: z.string().min(1).optional(),
+}).strict();
+// ───────────────────────────────────────────────────────────────────────────
+// Trace — per-claim provenance emitted per file processed by Interf.
+//
+// Traces are the visible product: "20 of 20 files processed, 847 pages
+// read, 18 charts extracted, 92 entities found, 12 checks passed."
+// Each trace rolls up one quantifiable piece of evidence.
+// ───────────────────────────────────────────────────────────────────────────
+export const TraceSchema = z.object({
+    kind: z.string().min(1),
+    label: z.string().min(1),
+    count: z.number().int().min(0).optional(),
+    total: z.number().int().min(0).optional(),
+    passed: z.boolean().optional(),
+    detail: z.string().min(1).optional(),
+}).strict();
+export const TracesSchema = z.object({
+    kind: z.literal("interf-context-graph-traces"),
+    version: z.literal(1),
+    generated_at: z.string().min(1),
+    graph_id: z.string().min(1),
+    project_id: z.string().min(1),
+    files_processed: z.number().int().min(0),
+    files_total: z.number().int().min(0),
+    checks_passed: z.number().int().min(0),
+    checks_total: z.number().int().min(0),
+    ready: z.boolean(),
+    /**
+     * Phase B quantitative signals — summed across all Artifacts that emitted
+     * the corresponding count in `CheckResult.details`. Optional because per-stage
+     * counters are opt-in: a stage that processes PDFs may report pages_read;
+     * a chart-extractor reports charts_extracted; an NER stage reports
+     * entities_found. Stages that don't know don't lie.
+     */
+    pages_read: z.number().int().min(0).optional(),
+    charts_extracted: z.number().int().min(0).optional(),
+    entities_found: z.number().int().min(0).optional(),
+    items: z.array(TraceSchema).default([]),
+}).strict();
+// ───────────────────────────────────────────────────────────────────────────
+// Context Graph — what Interf builds from a Project.
+//
+// Portable: exportable as a self-contained bundle.
+// Persistent: each Build produces a new Context Graph; old flows preserved.
+// Updatable: when source drifts, a new Context Graph is built via resync.
+//
+// The Context Graph wraps the per-build output and surfaces artifacts
+// + traces as first-class fields.
+// ───────────────────────────────────────────────────────────────────────────
+export const ContextGraphLocatorSchema = LocatorSchema;
+export const ContextGraphArtifactHandoffSchema = z.object({
+    artifact_id: ArtifactIdSchema.optional(),
+    label: z.string().min(1),
+    locator: LocatorSchema,
+    path: z.string().min(1).refine(isInterfRelativePath, {
+        message: "Context Graph handoff paths must stay inside the Context Graph root.",
+    }).optional(),
+    artifact_kind: z.enum(["file", "directory"]).optional(),
+    role: z.enum(["entrypoint", "artifact", "guidance", "source-index"]).default("artifact"),
+    summary: z.string().min(1).optional(),
+}).strict();
+export const ContextGraphPortableHandoffSchema = z.object({
+    locator: LocatorSchema,
+    instructions: z.string().min(1).optional(),
+}).strict();
+export const ContextGraphHandoffSchema = z.object({
+    kind: z.literal("interf-context-graph-handoff"),
+    version: z.literal(1),
+    entrypoint: ContextGraphArtifactHandoffSchema,
+    artifacts: z.array(ContextGraphArtifactHandoffSchema).default([]),
+    portable: ContextGraphPortableHandoffSchema.optional(),
+}).strict();
+export const ContextGraphSchema = z.object({
+    kind: z.literal("interf-context-graph"),
+    version: z.literal(1),
+    graph_id: z.string().min(1),
+    project_id: z.string().min(1),
+    intent: ProjectIntentSchema.optional(),
+    build_run_id: z.string().min(1),
+    source_state_id: z.string().min(1),
+    source_manifest_id: z.string().min(1).optional(),
+    created_at: z.string().min(1),
+    ready: z.boolean(),
+    readiness: ReadinessSchema.optional(),
+    locator: ContextGraphLocatorSchema,
+    entrypoint_artifact: ContextGraphArtifactHandoffSchema.optional(),
+    artifact_handoffs: z.array(ContextGraphArtifactHandoffSchema).default([]),
+    portable_handoff: ContextGraphPortableHandoffSchema.optional(),
+    artifacts: z.array(ArtifactStatusSchema).default([]),
+    traces: TracesSchema,
+}).strict();
+// Project service request/resource schemas live in
+// `src/packages/runtime/schemas/projects.ts`, the single local-service ABI
+// source of truth. This contracts module keeps only product-level Project,
+// Context Graph, and trace contracts that do not define HTTP resources.
+export { isInterfRelativePath, InterfIdPattern };