clinkx 0.2.3 → 1.0.0

package/dist/context-builder/lifecycle-contract.js

@@ -0,0 +1,523 @@
+import { randomBytes } from "node:crypto";
+import { basename, dirname, join, resolve } from "node:path";
+import { z } from "zod";
+export const CONTEXT_BUILDER_LIFECYCLE_SCHEMA_VERSION = "clinkx-context-builder-lifecycle-v1";
+export const CONTEXT_BUILDER_LIFECYCLE_RUNS_DIR_ENV = "CLINKX_CONTEXT_BUILDER_RUNS_DIR";
+export const CONTEXT_BUILDER_LIFECYCLE_DIRECTORY = ".context-runs";
+export const CONTEXT_BUILDER_LIFECYCLE_STATE_FILENAME = "state.json";
+export const MAX_CONTEXT_BUILDER_LIFECYCLE_DURATION_MS = 86_400_000;
+export const MAX_CONTEXT_BUILDER_LIFECYCLE_REASON_CODES = 16;
+export const CONTEXT_BUILDER_OPERATION_KINDS = [
+    "standalone",
+    "refine",
+    "workflow_preflight",
+    "historical",
+];
+export const CONTEXT_BUILDER_LIFECYCLE_STATUSES = [
+    "pending",
+    "running",
+    "succeeded",
+    "partial",
+    "failed",
+    "cancelled",
+];
+export const CONTEXT_BUILDER_LIFECYCLE_PHASES = [
+    "resolving",
+    "cache_lookup",
+    "validating",
+    "scanning",
+    "searching",
+    "selecting",
+    "curating",
+    "finalizing",
+    "writing",
+    "materializing",
+    "committing",
+    "complete",
+    "terminal",
+];
+export const CONTEXT_BUILDER_EXECUTION_STATUSES = [
+    "not_configured",
+    "disabled",
+    "pending",
+    "running",
+    "succeeded",
+    "failed",
+    "cancelled",
+    "skipped",
+];
+export const CONTEXT_BUILDER_FALLBACK_STATUSES = [
+    "not_applicable",
+    "not_used",
+    "used",
+    "failed",
+];
+export const CONTEXT_BUILDER_LIFECYCLE_REASON_CODES = [
+    "cache_disabled",
+    "cache_miss",
+    "cache_stale",
+    "delegate_disabled",
+    "delegate_failed",
+    "delegate_fallback",
+    "delegate_invalid",
+    "delegate_timeout",
+    "coverage_degraded",
+    "empty_selection",
+    "operation_cancelled",
+    "internal_failure",
+    "legacy_supported",
+    "legacy_unsupported",
+    "generation_replaced",
+];
+/**
+ * Frozen legal phase paths. A producer may omit intermediate phases, but an
+ * emitted phase must move forward on one path. Failure/cancellation may move
+ * from any non-terminal phase directly to `terminal`.
+ */
+export const CONTEXT_BUILDER_LIFECYCLE_STAGE_PATHS = Object.freeze({
+    deterministic: Object.freeze([
+        "resolving",
+        "validating",
+        "scanning",
+        "searching",
+        "selecting",
+        "writing",
+        "committing",
+        "complete",
+    ]),
+    delegated: Object.freeze([
+        "resolving",
+        "validating",
+        "scanning",
+        "searching",
+        "selecting",
+        "curating",
+        "finalizing",
+        "writing",
+        "committing",
+        "complete",
+    ]),
+    workflow_cache_miss: Object.freeze([
+        "resolving",
+        "cache_lookup",
+        "validating",
+        "scanning",
+        "searching",
+        "selecting",
+        "curating",
+        "finalizing",
+        "writing",
+        "materializing",
+        "committing",
+        "complete",
+    ]),
+    workflow_cache_hit: Object.freeze([
+        "resolving",
+        "cache_lookup",
+        "materializing",
+        "committing",
+        "complete",
+    ]),
+    refine: Object.freeze([
+        "resolving",
+        "validating",
+        "selecting",
+        "writing",
+        "committing",
+        "complete",
+    ]),
+    historical_success: Object.freeze(["complete"]),
+    historical_terminal: Object.freeze(["terminal"]),
+});
+export const CONTEXT_BUILDER_LIFECYCLE_V1_DESCRIPTOR = Object.freeze({
+    schema_version: CONTEXT_BUILDER_LIFECYCLE_SCHEMA_VERSION,
+    runs_dir_env: CONTEXT_BUILDER_LIFECYCLE_RUNS_DIR_ENV,
+    lifecycle_directory: CONTEXT_BUILDER_LIFECYCLE_DIRECTORY,
+    state_filename: CONTEXT_BUILDER_LIFECYCLE_STATE_FILENAME,
+    operation_kinds: CONTEXT_BUILDER_OPERATION_KINDS,
+    statuses: CONTEXT_BUILDER_LIFECYCLE_STATUSES,
+    phases: CONTEXT_BUILDER_LIFECYCLE_PHASES,
+    execution_statuses: CONTEXT_BUILDER_EXECUTION_STATUSES,
+    fallback_statuses: CONTEXT_BUILDER_FALLBACK_STATUSES,
+    reason_codes: CONTEXT_BUILDER_LIFECYCLE_REASON_CODES,
+    max_duration_ms: MAX_CONTEXT_BUILDER_LIFECYCLE_DURATION_MS,
+    max_reason_codes: MAX_CONTEXT_BUILDER_LIFECYCLE_REASON_CODES,
+    stage_paths: CONTEXT_BUILDER_LIFECYCLE_STAGE_PATHS,
+});
+const CONTEXT_BUILDER_OPERATION_ID_PATTERN = /^ctxop_\d{8}T\d{6}Z_[0-9a-f]{12}$/;
+const CONTEXT_BUILDER_ARTIFACT_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+const ContextBuilderOperationIdSchema = z
+    .string()
+    .max(40)
+    .refine(isContextBuilderOperationId, "invalid context builder operation ID");
+const ContextBuilderArtifactIdSchema = z
+    .string()
+    .max(64)
+    .regex(CONTEXT_BUILDER_ARTIFACT_ID_PATTERN);
+const ContextBuilderTimestampSchema = z
+    .string()
+    .max(64)
+    .datetime({ offset: true });
+const BoundedCountSchema = z.number().int().min(0).max(50_000);
+const BoundedByteCountSchema = z.number().int().min(0).max(250_000_000);
+const ContextBuilderExecutionStateSchema = z
+    .object({
+    configured: z.boolean(),
+    effective_enabled: z.boolean(),
+    execution_status: z.enum(CONTEXT_BUILDER_EXECUTION_STATUSES),
+    score: z.number().finite().min(0).max(10).optional(),
+})
+    .strict()
+    .superRefine((state, context) => {
+    if (!state.configured && (state.effective_enabled || state.execution_status !== "not_configured")) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "unconfigured execution must be disabled and not_configured",
+            path: ["execution_status"],
+        });
+    }
+    if (state.configured && !state.effective_enabled &&
+        state.execution_status !== "disabled") {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "configured but ineffective execution must be disabled",
+            path: ["execution_status"],
+        });
+    }
+    if (state.effective_enabled &&
+        ["not_configured", "disabled"].includes(state.execution_status)) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "effective execution must have an executable status",
+            path: ["execution_status"],
+        });
+    }
+    if (state.score !== undefined && state.execution_status !== "succeeded") {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "score is only valid for succeeded execution",
+            path: ["score"],
+        });
+    }
+});
+const ContextBuilderCacheStateSchema = z
+    .object({
+    lookup: z.enum(["not_checked", "miss", "hit"]),
+    write: z.enum(["not_attempted", "skipped", "written"]),
+    reason_code: z.enum(CONTEXT_BUILDER_LIFECYCLE_REASON_CODES).optional(),
+})
+    .strict();
+const ContextBuilderFallbackStateSchema = z
+    .object({
+    status: z.enum(CONTEXT_BUILDER_FALLBACK_STATUSES),
+    reason_code: z.enum(CONTEXT_BUILDER_LIFECYCLE_REASON_CODES).optional(),
+})
+    .strict()
+    .superRefine((fallback, context) => {
+    if (fallback.status === "not_applicable" || fallback.status === "not_used") {
+        if (fallback.reason_code !== undefined) {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "unused fallback cannot have a reason_code",
+                path: ["reason_code"],
+            });
+        }
+    }
+    else if (fallback.reason_code === undefined) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "used or failed fallback requires a reason_code",
+            path: ["reason_code"],
+        });
+    }
+});
+const ContextBuilderCountsSchema = z
+    .object({
+    files_seen: BoundedCountSchema,
+    files_considered: BoundedCountSchema,
+    files_selected: z.number().int().min(0).max(300),
+    files_omitted: BoundedCountSchema,
+    search_results: z.number().int().min(0).max(5_000),
+    bytes_read: BoundedByteCountSchema,
+    bytes_written: BoundedByteCountSchema,
+})
+    .strict();
+const ContextBuilderCoverageSchema = z
+    .object({
+    policy: z.literal("review_deep_v1").nullable(),
+    status: z.enum(["satisfied", "degraded", "not_evaluated"]),
+    required: BoundedCountSchema,
+    selected: BoundedCountSchema,
+    missing: BoundedCountSchema,
+})
+    .strict()
+    .superRefine((coverage, context) => {
+    if (coverage.missing > coverage.required) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "missing coverage cannot exceed required coverage",
+            path: ["missing"],
+        });
+    }
+    if (coverage.status === "not_evaluated" &&
+        (coverage.policy !== null || coverage.required !== 0 || coverage.missing !== 0)) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "not_evaluated coverage must not claim a policy or obligations",
+            path: ["status"],
+        });
+    }
+});
+const TERMINAL_CONTEXT_BUILDER_LIFECYCLE_STATUSES = new Set(["succeeded", "partial", "failed", "cancelled"]);
+export const ContextBuilderLifecycleStateV1Schema = z
+    .object({
+    schema_version: z.literal(CONTEXT_BUILDER_LIFECYCLE_SCHEMA_VERSION),
+    context_run_id: ContextBuilderOperationIdSchema,
+    artifact_run_id: ContextBuilderArtifactIdSchema.optional(),
+    operation_kind: z.enum(CONTEXT_BUILDER_OPERATION_KINDS),
+    status: z.enum(CONTEXT_BUILDER_LIFECYCLE_STATUSES),
+    phase: z.enum(CONTEXT_BUILDER_LIFECYCLE_PHASES),
+    created_at: ContextBuilderTimestampSchema,
+    updated_at: ContextBuilderTimestampSchema,
+    started_at: ContextBuilderTimestampSchema.optional(),
+    completed_at: ContextBuilderTimestampSchema.optional(),
+    duration_ms: z
+        .number()
+        .int()
+        .min(0)
+        .max(MAX_CONTEXT_BUILDER_LIFECYCLE_DURATION_MS)
+        .optional(),
+    curator: ContextBuilderExecutionStateSchema,
+    finalizer: ContextBuilderExecutionStateSchema,
+    cache: ContextBuilderCacheStateSchema,
+    fallback: ContextBuilderFallbackStateSchema,
+    counts: ContextBuilderCountsSchema,
+    coverage: ContextBuilderCoverageSchema,
+    reason_codes: z
+        .array(z.enum(CONTEXT_BUILDER_LIFECYCLE_REASON_CODES))
+        .max(MAX_CONTEXT_BUILDER_LIFECYCLE_REASON_CODES)
+        .refine((values) => new Set(values).size === values.length, "reason_codes must be unique"),
+})
+    .strict()
+    .superRefine((state, context) => {
+    const terminal = TERMINAL_CONTEXT_BUILDER_LIFECYCLE_STATUSES.has(state.status);
+    if (state.artifact_run_id === state.context_run_id) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "operation and artifact identities must be distinct",
+            path: ["artifact_run_id"],
+        });
+    }
+    if (state.status === "succeeded" || state.status === "partial") {
+        if (state.phase !== "complete") {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "successful terminal statuses require complete phase",
+                path: ["phase"],
+            });
+        }
+    }
+    else if (state.status === "failed" || state.status === "cancelled") {
+        if (state.phase !== "terminal") {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "failed or cancelled statuses require terminal phase",
+                path: ["phase"],
+            });
+        }
+    }
+    else if (state.phase === "complete" || state.phase === "terminal") {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "non-terminal statuses cannot use a terminal phase",
+            path: ["phase"],
+        });
+    }
+    if (terminal !== (state.completed_at !== undefined)) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "terminal statuses require completed_at exclusively",
+            path: ["completed_at"],
+        });
+    }
+    if (state.duration_ms !== undefined && state.completed_at === undefined) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "duration_ms requires completed_at",
+            path: ["duration_ms"],
+        });
+    }
+    if (state.status === "running" && state.started_at === undefined) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "running status requires started_at",
+            path: ["started_at"],
+        });
+    }
+    if (state.status === "pending" && state.started_at !== undefined) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "pending status cannot have started_at",
+            path: ["started_at"],
+        });
+    }
+    validateTimestampOrder(state, context);
+});
+export function parseContextBuilderLifecycleStateV1(value) {
+    return ContextBuilderLifecycleStateV1Schema.parse(value);
+}
+export function isContextBuilderOperationId(value) {
+    const match = CONTEXT_BUILDER_OPERATION_ID_PATTERN.exec(value);
+    if (match === null)
+        return false;
+    const timestamp = value.slice(6, 22);
+    const iso = [
+        timestamp.slice(0, 4),
+        "-",
+        timestamp.slice(4, 6),
+        "-",
+        timestamp.slice(6, 8),
+        "T",
+        timestamp.slice(9, 11),
+        ":",
+        timestamp.slice(11, 13),
+        ":",
+        timestamp.slice(13, 15),
+        ".000Z",
+    ].join("");
+    const parsed = new Date(iso);
+    return !Number.isNaN(parsed.getTime()) && parsed.toISOString() === iso;
+}
+export function validateContextBuilderOperationId(value) {
+    if (!isContextBuilderOperationId(value)) {
+        throw new Error("context builder operation ID must match ctxop_YYYYMMDDTHHMMSSZ_<12 lowercase hex>");
+    }
+    return value;
+}
+export function generateContextBuilderOperationId(options = {}) {
+    const timestamp = (options.now?.() ?? new Date())
+        .toISOString()
+        .replace(/[-:]/g, "")
+        .slice(0, 15);
+    const suffix = (options.randomHex?.() ?? randomBytes(6).toString("hex"))
+        .toLowerCase();
+    if (!/^[0-9a-f]{12}$/.test(suffix)) {
+        throw new Error("context builder operation ID suffix must be 12 hex characters");
+    }
+    return validateContextBuilderOperationId(`ctxop_${timestamp}Z_${suffix}`);
+}
+/** Pure location contract only; H0 performs no filesystem writes. */
+export function resolveContextBuilderLifecycleLocation(runsDir, contextRunId) {
+    const validatedId = validateContextBuilderOperationId(contextRunId);
+    const resolvedRunsDir = resolve(runsDir);
+    const journalDir = join(resolvedRunsDir, CONTEXT_BUILDER_LIFECYCLE_DIRECTORY);
+    const contextRunDir = join(journalDir, validatedId);
+    if (dirname(contextRunDir) !== journalDir ||
+        basename(contextRunDir) !== validatedId) {
+        throw new Error("context builder operation ID escaped lifecycle journal");
+    }
+    return Object.freeze({
+        runs_dir: resolvedRunsDir,
+        journal_dir: journalDir,
+        context_run_dir: contextRunDir,
+        state_json: join(contextRunDir, CONTEXT_BUILDER_LIFECYCLE_STATE_FILENAME),
+    });
+}
+export function isTerminalContextBuilderLifecycleStatus(status) {
+    return TERMINAL_CONTEXT_BUILDER_LIFECYCLE_STATUSES.has(status);
+}
+export function isLegalContextBuilderLifecycleTransition(previous, next) {
+    if (isTerminalContextBuilderLifecycleStatus(previous.status) ||
+        previous.schema_version !== next.schema_version ||
+        previous.context_run_id !== next.context_run_id ||
+        previous.operation_kind !== next.operation_kind ||
+        previous.created_at !== next.created_at ||
+        Date.parse(next.updated_at) < Date.parse(previous.updated_at) ||
+        (previous.cache.lookup !== "not_checked" &&
+            previous.cache.lookup !== next.cache.lookup) ||
+        (previous.cache.write !== "not_attempted" &&
+            previous.cache.write !== next.cache.write) ||
+        (previous.artifact_run_id !== undefined &&
+            previous.artifact_run_id !== next.artifact_run_id)) {
+        return false;
+    }
+    const legalStatuses = {
+        pending: ["pending", "running", "failed", "cancelled"],
+        running: ["running", "succeeded", "partial", "failed", "cancelled"],
+    };
+    if (previous.status !== "pending" && previous.status !== "running" ||
+        !legalStatuses[previous.status].includes(next.status)) {
+        return false;
+    }
+    if (next.phase === "terminal") {
+        return next.status === "failed" || next.status === "cancelled";
+    }
+    const paths = lifecycleStagePathsForTransition(previous, next);
+    return paths.some((path) => {
+        const phasePath = path;
+        const previousIndex = phasePath.indexOf(previous.phase);
+        const nextIndex = phasePath.indexOf(next.phase);
+        return previousIndex >= 0 && nextIndex >= previousIndex;
+    });
+}
+function lifecycleStagePathsForTransition(previous, next) {
+    switch (previous.operation_kind) {
+        case "standalone":
+            return previous.curator.effective_enabled
+                ? [CONTEXT_BUILDER_LIFECYCLE_STAGE_PATHS.delegated]
+                : [CONTEXT_BUILDER_LIFECYCLE_STAGE_PATHS.deterministic];
+        case "refine":
+            return [CONTEXT_BUILDER_LIFECYCLE_STAGE_PATHS.refine];
+        case "workflow_preflight": {
+            const lookup = next.cache.lookup === "not_checked"
+                ? previous.cache.lookup
+                : next.cache.lookup;
+            if (lookup === "hit") {
+                return [CONTEXT_BUILDER_LIFECYCLE_STAGE_PATHS.workflow_cache_hit];
+            }
+            if (lookup === "miss") {
+                return [CONTEXT_BUILDER_LIFECYCLE_STAGE_PATHS.workflow_cache_miss];
+            }
+            return [
+                CONTEXT_BUILDER_LIFECYCLE_STAGE_PATHS.workflow_cache_hit,
+                CONTEXT_BUILDER_LIFECYCLE_STAGE_PATHS.workflow_cache_miss,
+            ];
+        }
+        case "historical":
+            return [];
+    }
+}
+function validateTimestampOrder(state, context) {
+    const createdAt = Date.parse(state.created_at);
+    const updatedAt = Date.parse(state.updated_at);
+    const startedAt = state.started_at === undefined
+        ? undefined
+        : Date.parse(state.started_at);
+    const completedAt = state.completed_at === undefined
+        ? undefined
+        : Date.parse(state.completed_at);
+    if (updatedAt < createdAt) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "updated_at cannot precede created_at",
+            path: ["updated_at"],
+        });
+    }
+    if (startedAt !== undefined && (startedAt < createdAt || startedAt > updatedAt)) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "started_at must fall within the persisted operation window",
+            path: ["started_at"],
+        });
+    }
+    if (completedAt !== undefined &&
+        (completedAt < (startedAt ?? createdAt) ||
+            completedAt > updatedAt)) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "completed_at must fall within the persisted operation window",
+            path: ["completed_at"],
+        });
+    }
+}
+//# sourceMappingURL=lifecycle-contract.js.map

package/dist/context-builder/lifecycle-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-contract.js","sourceRoot":"","sources":["../../src/context-builder/lifecycle-contract.ts"],"names":[],"mappings":"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"}

package/dist/context-builder/lifecycle-journal.d.ts

@@ -0,0 +1,62 @@
+import type { ContextBuilderLifecycleObserver } from "./lifecycle-observer.js";
+/**
+ * Durable producer for the standalone / refine Context Run journal.
+ *
+ * The journal is the authoritative sink wired into the G1
+ * {@link ContextBuilderLifecycleController} whenever an operation OWNS its
+ * lifecycle (i.e. no external observer was injected — the workflow-preflight
+ * path supplies its own store). Each transition is persisted as the whole
+ * frozen H0 snapshot at
+ * `CLINKX_CONTEXT_BUILDER_RUNS_DIR/.context-runs/<contextRunId>/state.json`.
+ *
+ * Persistence properties:
+ * - **Authoritative / fail-closed.** The controller awaits `observe` before it
+ *   advances; a write failure rejects and stops the operation rather than
+ *   silently dropping a snapshot. Progress notifications stay a separate,
+ *   best-effort adapter and are unaffected.
+ * - **Serialized.** Writes are chained internally so temp-file names never race
+ *   even if a caller ever fanned transitions in concurrently.
+ * - **Crash-safe / atomic.** Each snapshot is written to an exclusive temp file,
+ *   fsync'd, then renamed over `state.json`. A partial write can never replace a
+ *   valid prior snapshot.
+ * - **Contained.** The target path is derived through
+ *   {@link resolveContextBuilderLifecycleLocation}, which validates the
+ *   operation ID and rejects any escape from the journal directory.
+ *
+ * Operation identity (`context_run_id`) is distinct from artifact/run identity
+ * (`artifact_run_id`); the journal keys on the operation ID and never on the
+ * artifact run directory.
+ */
+export interface ContextBuilderLifecycleJournalHandle {
+    writeFile(data: string, options: {
+        encoding: "utf8";
+    }): Promise<void>;
+    sync(): Promise<void>;
+    close(): Promise<void>;
+}
+export interface ContextBuilderLifecycleJournalOps {
+    mkdir(dir: string, options: {
+        recursive: true;
+        mode: number;
+    }): Promise<void>;
+    open(path: string, flags: string, mode: number): Promise<ContextBuilderLifecycleJournalHandle>;
+    rename(from: string, to: string): Promise<void>;
+    rm(path: string, options: {
+        force: true;
+    }): Promise<void>;
+}
+export interface ContextBuilderLifecycleJournalOptions {
+    /** Explicit runs directory; falls back to the env-derived default. */
+    readonly runsDir?: string;
+    /** Injectable filesystem adapter (crash/failure regression seam). */
+    readonly ops?: ContextBuilderLifecycleJournalOps;
+    /** Injectable runs-dir resolver (test seam). */
+    readonly resolveRunsDir?: (runsDir: string | undefined) => Promise<string>;
+}
+export interface ContextBuilderLifecycleJournal {
+    /** The G1 observer to hand the controller as its authoritative sink. */
+    readonly observe: ContextBuilderLifecycleObserver;
+    /** Resolved lifecycle journal directory once a first transition landed. */
+    journalDir(): string | undefined;
+}
+export declare function createContextBuilderLifecycleJournal(options?: ContextBuilderLifecycleJournalOptions): ContextBuilderLifecycleJournal;