clinkx 0.3.0 → 1.0.0

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

@@ -0,0 +1,328 @@
+import { randomBytes } from "node:crypto";
+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}`);
+}
+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=context-builder-lifecycle-contract.js.map

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

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

package/clinkx-workflows/dist/context-builder-lifecycle-router.d.ts

@@ -0,0 +1,24 @@
+import type { ContextBuilderLifecycleStateV1 } from "./context-builder-lifecycle-contract.js";
+import type { PreflightContextInput } from "./context-preflight.js";
+export interface WorkflowContextBuilderLifecycleTransition {
+    readonly previous: Readonly<ContextBuilderLifecycleStateV1> | null;
+    readonly snapshot: Readonly<ContextBuilderLifecycleStateV1>;
+}
+export interface WorkflowContextBuilderLifecycleSink {
+    observeContextBuilderLifecycleTransition(transition: WorkflowContextBuilderLifecycleTransition): void | Promise<void>;
+}
+export interface WorkflowContextBuilderLifecycleInjection {
+    readonly observer: (transition: WorkflowContextBuilderLifecycleTransition) => void | Promise<void>;
+}
+export interface WorkflowContextBuilderLifecycleRouter {
+    readonly lifecycleFactory: (input: PreflightContextInput) => WorkflowContextBuilderLifecycleInjection | undefined;
+    readonly bind: (runId: string, sink: WorkflowContextBuilderLifecycleSink) => () => void;
+}
+/**
+ * Bridge between the process-level root runner and the per-workflow store.
+ *
+ * Bindings are keyed by run ID and lease-fenced, so concurrent runs never use
+ * a mutable "current store" slot and a stale cleanup cannot delete a recycled
+ * same-ID binding owned by a newer invocation.
+ */
+export declare function createWorkflowContextBuilderLifecycleRouter(): WorkflowContextBuilderLifecycleRouter;

package/clinkx-workflows/dist/context-builder-lifecycle-router.js

@@ -0,0 +1,39 @@
+/**
+ * Bridge between the process-level root runner and the per-workflow store.
+ *
+ * Bindings are keyed by run ID and lease-fenced, so concurrent runs never use
+ * a mutable "current store" slot and a stale cleanup cannot delete a recycled
+ * same-ID binding owned by a newer invocation.
+ */
+export function createWorkflowContextBuilderLifecycleRouter() {
+    const bindings = new Map();
+    return {
+        lifecycleFactory(input) {
+            const binding = bindings.get(input.runId);
+            if (binding === undefined)
+                return undefined;
+            const lease = binding.lease;
+            return {
+                observer: async (transition) => {
+                    const current = bindings.get(input.runId);
+                    if (current === undefined || current.lease !== lease) {
+                        throw new Error(`workflow context lifecycle binding changed for run ${input.runId}`);
+                    }
+                    await current.sink.observeContextBuilderLifecycleTransition(transition);
+                },
+            };
+        },
+        bind(runId, sink) {
+            if (bindings.has(runId)) {
+                throw new Error(`workflow context lifecycle is already bound for run ${runId}`);
+            }
+            const lease = Symbol(runId);
+            bindings.set(runId, { lease, sink });
+            return () => {
+                if (bindings.get(runId)?.lease === lease)
+                    bindings.delete(runId);
+            };
+        },
+    };
+}
+//# sourceMappingURL=context-builder-lifecycle-router.js.map

package/clinkx-workflows/dist/context-builder-lifecycle-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder-lifecycle-router.js","sourceRoot":"","sources":["../src/context-builder-lifecycle-router.ts"],"names":[],"mappings":"AAgCA;;;;;;GAMG;AACH,MAAM,UAAU,2CAA2C;IACzD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAGrB,CAAC;IAEJ,OAAO;QACL,gBAAgB,CAAC,KAAK;YACpB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC5B,OAAO;gBACL,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;oBAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC1C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;wBACrD,MAAM,IAAI,KAAK,CACb,sDAAsD,KAAK,CAAC,KAAK,EAAE,CACpE,CAAC;oBACJ,CAAC;oBACD,MAAM,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,UAAU,CAAC,CAAC;gBAC1E,CAAC;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,IAAI;YACd,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,uDAAuD,KAAK,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACrC,OAAO,GAAG,EAAE;gBACV,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,KAAK;oBAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/clinkx-workflows/dist/context-cache-key.d.ts

@@ -0,0 +1,53 @@
+type JsonLike = null | boolean | number | string | readonly JsonLike[] | {
+    readonly [key: string]: JsonLike | undefined;
+};
+export interface ContextCacheInput {
+    readonly task?: unknown;
+    readonly roots?: unknown;
+    readonly profile?: unknown;
+    readonly allow_secrets?: unknown;
+    readonly budget?: unknown;
+    readonly include_globs?: unknown;
+    readonly exclude_globs?: unknown;
+    readonly search_terms?: unknown;
+    readonly focus_paths?: unknown;
+    readonly delegate?: {
+        readonly enabled?: unknown;
+        readonly curator?: unknown;
+        readonly finalizer?: unknown;
+    } | undefined;
+}
+export interface ComputeCacheKeyInput {
+    readonly inputsHash: string;
+    readonly workspaceSig: string;
+    readonly rendererVersion: string | number;
+    readonly cbSchemaVersion: string | number;
+    /**
+     * Version of the root package's context discovery algorithm (search
+     * scheduler, candidate ordering, slicing). Injected by the root server;
+     * optional so standalone/legacy embeddings of this package stay compatible.
+     * Absent values fold as {@link UNVERSIONED_CACHE_COMPONENT}.
+     */
+    readonly discoveryAlgorithmVersion?: string | undefined;
+    /**
+     * Version of the root package's delegate (curator/finalizer) prompt
+     * content. Same injection and sentinel semantics as
+     * `discoveryAlgorithmVersion`.
+     */
+    readonly delegatePromptVersion?: string | undefined;
+}
+/**
+ * Sentinel folded into the cache key when a caller supplies no explicit
+ * discovery-algorithm or delegate-prompt version (standalone/legacy embeddings
+ * of this package). It INTENTIONALLY differs from every real version string —
+ * real versions are short numerals like "1"/"2" — so an unversioned caller can
+ * never collide with (and stale-serve) a bundle produced under a declared
+ * version, and vice versa. Key computation stays total either way.
+ */
+export declare const UNVERSIONED_CACHE_COMPONENT = "unversioned";
+export declare function canonicalJson(value: unknown): string;
+export declare function sha256(value: string | Buffer): string;
+export declare function computeInputsHash(cbInput: ContextCacheInput): string;
+export declare function computeCacheKey(input: ComputeCacheKeyInput): string;
+export declare function deriveWfctxId(cacheKey: string): string;
+export type { JsonLike };

package/clinkx-workflows/dist/context-cache-key.js

@@ -0,0 +1,91 @@
+import { createHash } from "node:crypto";
+/**
+ * Sentinel folded into the cache key when a caller supplies no explicit
+ * discovery-algorithm or delegate-prompt version (standalone/legacy embeddings
+ * of this package). It INTENTIONALLY differs from every real version string —
+ * real versions are short numerals like "1"/"2" — so an unversioned caller can
+ * never collide with (and stale-serve) a bundle produced under a declared
+ * version, and vice versa. Key computation stays total either way.
+ */
+export const UNVERSIONED_CACHE_COMPONENT = "unversioned";
+export function canonicalJson(value) {
+    return serializeCanonical(value);
+}
+export function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+export function computeInputsHash(cbInput) {
+    return sha256(canonicalJson({
+        task: cbInput.task,
+        roots: cbInput.roots,
+        profile: cbInput.profile,
+        // default-true and explicit-false bundles must get distinct cache identities.
+        allow_secrets: cbInput.allow_secrets,
+        budget: cbInput.budget,
+        include_globs: cbInput.include_globs,
+        exclude_globs: cbInput.exclude_globs,
+        search_terms: cbInput.search_terms,
+        focus_paths: cbInput.focus_paths,
+        // The key folds delegate.{enabled,curator,finalizer} — the content-affecting
+        // delegate fields. delegate.{timeout_seconds,failure_policy,max_response_chars}
+        // are INTENTIONALLY excluded: they are operational knobs (timeouts, fallback
+        // behavior, output caps), not inputs that change which files a bundle selects.
+        // Known v1 footgun: because max_response_chars is out of the key, lowering it
+        // can stale-serve a previously cached bundle rendered under the larger cap.
+        delegate: {
+            enabled: cbInput.delegate?.enabled,
+            curator: cbInput.delegate?.curator,
+            finalizer: cbInput.delegate?.finalizer,
+        },
+    }));
+}
+export function computeCacheKey(input) {
+    // The two versions are folded UNCONDITIONALLY (sentinel when absent) so key
+    // computation is total and deterministic, and so distinct discovery/prompt
+    // versions always produce distinct wfctx identities.
+    return sha256(canonicalJson([
+        input.inputsHash,
+        input.workspaceSig,
+        input.rendererVersion,
+        input.cbSchemaVersion,
+        input.discoveryAlgorithmVersion ?? UNVERSIONED_CACHE_COMPONENT,
+        input.delegatePromptVersion ?? UNVERSIONED_CACHE_COMPONENT,
+    ]));
+}
+export function deriveWfctxId(cacheKey) {
+    return `wfctx-${cacheKey.slice(0, 32)}`;
+}
+function serializeCanonical(value) {
+    if (value === null)
+        return "null";
+    switch (typeof value) {
+        case "boolean":
+            return value ? "true" : "false";
+        case "number":
+            return Number.isFinite(value) ? JSON.stringify(value) : "null";
+        case "string":
+            return JSON.stringify(value);
+        case "undefined":
+        case "function":
+        case "symbol":
+            return "null";
+        case "bigint":
+            throw new TypeError("canonicalJson does not support bigint values");
+        case "object":
+            break;
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => serializeCanonical(entry)).join(",")}]`;
+    }
+    const objectValue = value;
+    const entries = Object.keys(objectValue)
+        .sort()
+        .filter((key) => {
+        const entry = objectValue[key];
+        return entry !== undefined && typeof entry !== "function" && typeof entry !== "symbol";
+    });
+    return `{${entries
+        .map((key) => `${JSON.stringify(key)}:${serializeCanonical(objectValue[key])}`)
+        .join(",")}}`;
+}
+//# sourceMappingURL=context-cache-key.js.map

package/clinkx-workflows/dist/context-cache-key.js.map

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

package/clinkx-workflows/dist/context-mode-resolver.d.ts

@@ -0,0 +1,27 @@
+import type { PreflightContextDelegateInput } from "./context-preflight.js";
+export type WorkflowContextRequestedMode = "full" | "deterministic" | "off";
+export type WorkflowContextCallerMode = WorkflowContextRequestedMode | "inherit";
+export type WorkflowContextEffectiveMode = WorkflowContextRequestedMode | "disabled";
+export interface WorkflowContextPolicy {
+    readonly requestedMode: WorkflowContextRequestedMode;
+    readonly effectiveMode: WorkflowContextEffectiveMode;
+    readonly effectiveDelegate?: PreflightContextDelegateInput | undefined;
+    readonly preflightDisabled: boolean;
+}
+export declare class WorkflowContextModeResolverError extends Error {
+    constructor(message: string);
+}
+export declare function resolveWorkflowContextMode(callerValue: unknown, contextDefault: WorkflowContextRequestedMode, preflightEnabled: boolean, callerDelegate: unknown, defaultCurator?: string | undefined): WorkflowContextPolicy;
+export declare const DEFAULT_FULL_DELEGATE_FINALIZER_CLI = "codex";
+export declare const DEFAULT_FULL_DELEGATE_PROVIDER_ROLE = "json";
+/**
+ * The enabled providers injected by {@link makeDefaultFullDelegate}, as a single
+ * source of truth so startup validation cannot drift from what is actually
+ * injected at runtime. Each entry is `{ label, cli_name, role }`.
+ */
+export declare function defaultFullDelegateProviders(defaultCurator: string | undefined): ReadonlyArray<{
+    label: string;
+    cli_name: string;
+    role: string;
+}>;
+export declare function makeDefaultFullDelegate(defaultCurator: string | undefined): PreflightContextDelegateInput;