@cleocode/core 2026.9.23 → 2026.9.25

package/dist/decide/bench/types.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Types and row schemas for the System One accuracy benchmark (T12495).
+ *
+ * A benchmark row is ONE labelled question built from CLEO's own history
+ * (duplicate task pairs, explicitly typed observations, superseding decision
+ * pairs), already redacted. Rows are stored as JSONL; every row carries its
+ * provenance (source record ids and the rule that labelled it) so the owner
+ * spot-check and any later audit can trace the label back to the store.
+ *
+ * @task T12495
+ * @epic T12486
+ */
+import { z } from 'zod';
+/** The benchmarked decision sites, by their `decide.sites.*` key name. */
+export declare const BENCH_SITES: readonly ["duplicateDetection", "observationType", "decisionContradiction"];
+/** One of {@link BENCH_SITES}. */
+export type BenchSite = (typeof BENCH_SITES)[number];
+/** Labels of the duplicate-detection site. `duplicate` is the positive class. */
+export declare const DUPLICATE_LABELS: readonly ["duplicate", "distinct"];
+/** Labels of the decision-contradiction site. `conflict` is the positive class. */
+export declare const CONTRADICTION_LABELS: readonly ["conflict", "compatible"];
+/**
+ * The labels a row of `site` may carry.
+ *
+ * @param site - Benchmarked site.
+ * @returns The allowed labels, positive class first for the two-label sites.
+ */
+export declare function labelsForSite(site: BenchSite): readonly string[];
+/**
+ * The positive class of a two-label site, or `null` for a multi-class site
+ * (whose precision, recall, F1 and false-positive rate are macro averages).
+ *
+ * @param site - Benchmarked site.
+ * @returns The positive label, or `null`.
+ */
+export declare function positiveLabel(site: BenchSite): string | null;
+/** Why a row carries its label. */
+export declare const BENCH_LABEL_RULES: readonly ["duplicates-relation", "cancelled-duplicate-reason", "note-duplicate-reference", "same-parent-unrelated", "explicit-type", "supersedes-edge", "random-unlinked-pair"];
+/** One of {@link BENCH_LABEL_RULES}. */
+export type BenchLabelRule = (typeof BENCH_LABEL_RULES)[number];
+/** Zod schema of one dataset row (one JSONL line). */
+export declare const benchRowSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    site: z.ZodLiteral<"duplicateDetection">;
+    input: z.ZodObject<{
+        a: z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+        }, z.core.$strip>;
+        b: z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    id: z.ZodString;
+    label: z.ZodString;
+    provenance: z.ZodObject<{
+        sourceIds: z.ZodArray<z.ZodString>;
+        rule: z.ZodEnum<{
+            "duplicates-relation": "duplicates-relation";
+            "cancelled-duplicate-reason": "cancelled-duplicate-reason";
+            "note-duplicate-reference": "note-duplicate-reference";
+            "same-parent-unrelated": "same-parent-unrelated";
+            "explicit-type": "explicit-type";
+            "supersedes-edge": "supersedes-edge";
+            "random-unlinked-pair": "random-unlinked-pair";
+        }>;
+        reason: z.ZodString;
+    }, z.core.$strip>;
+    ownerVerified: z.ZodOptional<z.ZodBoolean>;
+    correctedFrom: z.ZodOptional<z.ZodString>;
+    ownerNote: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    site: z.ZodLiteral<"observationType">;
+    input: z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strip>;
+    id: z.ZodString;
+    label: z.ZodString;
+    provenance: z.ZodObject<{
+        sourceIds: z.ZodArray<z.ZodString>;
+        rule: z.ZodEnum<{
+            "duplicates-relation": "duplicates-relation";
+            "cancelled-duplicate-reason": "cancelled-duplicate-reason";
+            "note-duplicate-reference": "note-duplicate-reference";
+            "same-parent-unrelated": "same-parent-unrelated";
+            "explicit-type": "explicit-type";
+            "supersedes-edge": "supersedes-edge";
+            "random-unlinked-pair": "random-unlinked-pair";
+        }>;
+        reason: z.ZodString;
+    }, z.core.$strip>;
+    ownerVerified: z.ZodOptional<z.ZodBoolean>;
+    correctedFrom: z.ZodOptional<z.ZodString>;
+    ownerNote: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    site: z.ZodLiteral<"decisionContradiction">;
+    input: z.ZodObject<{
+        newer: z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            decision: z.ZodString;
+            rationale: z.ZodString;
+        }, z.core.$strip>;
+        older: z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            decision: z.ZodString;
+            rationale: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    id: z.ZodString;
+    label: z.ZodString;
+    provenance: z.ZodObject<{
+        sourceIds: z.ZodArray<z.ZodString>;
+        rule: z.ZodEnum<{
+            "duplicates-relation": "duplicates-relation";
+            "cancelled-duplicate-reason": "cancelled-duplicate-reason";
+            "note-duplicate-reference": "note-duplicate-reference";
+            "same-parent-unrelated": "same-parent-unrelated";
+            "explicit-type": "explicit-type";
+            "supersedes-edge": "supersedes-edge";
+            "random-unlinked-pair": "random-unlinked-pair";
+        }>;
+        reason: z.ZodString;
+    }, z.core.$strip>;
+    ownerVerified: z.ZodOptional<z.ZodBoolean>;
+    correctedFrom: z.ZodOptional<z.ZodString>;
+    ownerNote: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "site">;
+/** One labelled, redacted benchmark row. */
+export type BenchRow = z.infer<typeof benchRowSchema>;
+/** Where a row came from and why it carries its label. */
+export type BenchProvenance = BenchRow['provenance'];
+/** A task as the dataset builder reads it (from the task accessor). */
+export interface BenchTaskRecord {
+    /** Task id. */
+    readonly id: string;
+    /** Title. */
+    readonly title: string;
+    /** Description (empty when absent). */
+    readonly description: string;
+    /** Status. */
+    readonly status: string;
+    /** Parent id, when any. */
+    readonly parentId: string | null;
+    /** Cancellation reason, when cancelled with one. */
+    readonly cancellationReason?: string;
+    /** Free-text notes. */
+    readonly notes: readonly string[];
+    /** Typed relations to other tasks. */
+    readonly relates: readonly {
+        readonly taskId: string;
+        readonly type: string;
+        readonly reason?: string;
+    }[];
+}
+/** An observation as the dataset builder reads it (from the brain accessor). */
+export interface BenchObservationRecord {
+    /** Observation id. */
+    readonly id: string;
+    /** Stored type. */
+    readonly type: string;
+    /** Title. */
+    readonly title: string;
+    /** Narrative (the text the keyword heuristic classifies). */
+    readonly narrative: string;
+}
+/** A decision as the dataset builder reads it (from the brain accessor). */
+export interface BenchDecisionRecord {
+    /** Decision id. */
+    readonly id: string;
+    /** Decision type. */
+    readonly type: string;
+    /** Decision text. */
+    readonly decision: string;
+    /** Rationale. */
+    readonly rationale: string;
+    /** Id of the decision this one supersedes, when any. */
+    readonly supersedes?: string | null;
+    /** Id of the decision that superseded this one, when any. */
+    readonly supersededBy?: string | null;
+}
+/**
+ * The store port the dataset builder reads through. The default
+ * implementation (`./source.ts`) uses the core task and brain accessors;
+ * tests inject records directly.
+ */
+export interface BenchSource {
+    /** Every task, including cancelled and archived ones. */
+    tasks(): Promise<readonly BenchTaskRecord[]>;
+    /** Every observation, including invalidated ones. */
+    observations(): Promise<readonly BenchObservationRecord[]>;
+    /** Every decision, including superseded ones. */
+    decisions(): Promise<readonly BenchDecisionRecord[]>;
+}
+/**
+ * One provider connection the benchmark compares. The key is sent only as a
+ * bearer token and is never written to the results, the report or the log.
+ */
+export interface BenchConnection {
+    /** Profile name shown in the results (e.g. `layahost`, `jev`). */
+    readonly name: string;
+    /** Provider kind (`layahost`, `jev`, …); informational. */
+    readonly provider: string;
+    /** Jev-compatible base URL. */
+    readonly baseUrl: string;
+    /** API key. */
+    readonly apiKey: string;
+    /** Model; absent → the provider's default. */
+    readonly model?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/decide/bench/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/decide/bench/types.ts"],"names":[],"mappings":"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"}

package/dist/decide/bench/types.js

@@ -0,0 +1,104 @@
+/**
+ * Types and row schemas for the System One accuracy benchmark (T12495).
+ *
+ * A benchmark row is ONE labelled question built from CLEO's own history
+ * (duplicate task pairs, explicitly typed observations, superseding decision
+ * pairs), already redacted. Rows are stored as JSONL; every row carries its
+ * provenance (source record ids and the rule that labelled it) so the owner
+ * spot-check and any later audit can trace the label back to the store.
+ *
+ * @task T12495
+ * @epic T12486
+ */
+import { z } from 'zod';
+import { OBSERVATION_TYPE_OPTIONS } from '../../memory/observation-type-decision.js';
+/** The benchmarked decision sites, by their `decide.sites.*` key name. */
+export const BENCH_SITES = [
+    'duplicateDetection',
+    'observationType',
+    'decisionContradiction',
+];
+/** Labels of the duplicate-detection site. `duplicate` is the positive class. */
+export const DUPLICATE_LABELS = ['duplicate', 'distinct'];
+/** Labels of the decision-contradiction site. `conflict` is the positive class. */
+export const CONTRADICTION_LABELS = ['conflict', 'compatible'];
+/**
+ * The labels a row of `site` may carry.
+ *
+ * @param site - Benchmarked site.
+ * @returns The allowed labels, positive class first for the two-label sites.
+ */
+export function labelsForSite(site) {
+    if (site === 'duplicateDetection')
+        return DUPLICATE_LABELS;
+    if (site === 'decisionContradiction')
+        return CONTRADICTION_LABELS;
+    return OBSERVATION_TYPE_OPTIONS;
+}
+/**
+ * The positive class of a two-label site, or `null` for a multi-class site
+ * (whose precision, recall, F1 and false-positive rate are macro averages).
+ *
+ * @param site - Benchmarked site.
+ * @returns The positive label, or `null`.
+ */
+export function positiveLabel(site) {
+    if (site === 'duplicateDetection')
+        return 'duplicate';
+    if (site === 'decisionContradiction')
+        return 'conflict';
+    return null;
+}
+/** Why a row carries its label. */
+export const BENCH_LABEL_RULES = [
+    'duplicates-relation',
+    'cancelled-duplicate-reason',
+    'note-duplicate-reference',
+    'same-parent-unrelated',
+    'explicit-type',
+    'supersedes-edge',
+    'random-unlinked-pair',
+];
+const taskTextSchema = z.object({
+    id: z.string().min(1),
+    title: z.string(),
+    description: z.string(),
+});
+const decisionTextSchema = z.object({
+    id: z.string().min(1),
+    type: z.string().optional(),
+    decision: z.string(),
+    rationale: z.string(),
+});
+const provenanceSchema = z.object({
+    sourceIds: z.array(z.string().min(1)).min(1),
+    rule: z.enum(BENCH_LABEL_RULES),
+    reason: z.string().min(1),
+});
+const rowBase = {
+    id: z.string().min(1),
+    label: z.string().min(1),
+    provenance: provenanceSchema,
+    ownerVerified: z.boolean().optional(),
+    correctedFrom: z.string().optional(),
+    ownerNote: z.string().optional(),
+};
+/** Zod schema of one dataset row (one JSONL line). */
+export const benchRowSchema = z.discriminatedUnion('site', [
+    z.object({
+        ...rowBase,
+        site: z.literal('duplicateDetection'),
+        input: z.object({ a: taskTextSchema, b: taskTextSchema }),
+    }),
+    z.object({
+        ...rowBase,
+        site: z.literal('observationType'),
+        input: z.object({ id: z.string().min(1), title: z.string(), text: z.string() }),
+    }),
+    z.object({
+        ...rowBase,
+        site: z.literal('decisionContradiction'),
+        input: z.object({ newer: decisionTextSchema, older: decisionTextSchema }),
+    }),
+]);
+//# sourceMappingURL=types.js.map

package/dist/decide/bench/types.js.map

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

package/dist/decide/client.d.ts

@@ -35,8 +35,31 @@ import { type DecisionBudget } from './budget.js';
 import { type DecisionCache } from './cache.js';
 import { type DecisionProvider, type DecisionProviderConnection } from './provider.js';
 import { type SpendLedger } from './spend.js';
+import type { DecideFetch } from './transport.js';
 /** Default per-site deadline for the budget + provider round trip, in ms. */
 export declare const DEFAULT_DECISION_TIMEOUT_MS = 300;
+/**
+ * Default deadline for a whole {@link decideBatch} call, in ms (T12715).
+ *
+ * `POST /v1/systemone/batch` answers its items serially (2–5 s per 64
+ * requests), so the System One integration spec (§1, batch row) requires an
+ * HTTP timeout of at least 30 s. Batch callers are background sites (sweeps,
+ * the T12495 harness replay), never a latency-critical write path, so the
+ * 300 ms single-decision default would time out every real batch.
+ */
+export declare const DEFAULT_BATCH_DECISION_TIMEOUT_MS = 30000;
+/**
+ * Upper bound on the lazy capability detection {@link decideBatch} runs
+ * before its first batch, in ms (T12715). Also bounded by
+ * {@link CAPABILITY_DETECTION_DEADLINE_SHARE} of the remaining batch deadline.
+ */
+export declare const CAPABILITY_DETECTION_TIMEOUT_MS = 5000;
+/**
+ * Largest share of the remaining {@link decideBatch} deadline the lazy
+ * capability detection may use (T12715), so a slow detection never leaves the
+ * batch itself without time to run.
+ */
+export declare const CAPABILITY_DETECTION_DEADLINE_SHARE = 0.4;
 /** Circuit-breaker trip after a 503/529 that carried no `retry-after`, ms. */
 export declare const OVERLOADED_COOLDOWN_MS = 30000;
 /**
@@ -73,6 +96,10 @@ export interface DecideOptions {
     readonly adapterVersion?: string;
     /** Caller cancellation; treated like a timeout (fallback, no throw). */
     readonly signal?: AbortSignal;
+    /** Transport for a provider built from `connection`. Default: the abort-complete `decideFetch`. */
+    readonly fetch?: DecideFetch;
+    /** Provider-state file (detected capabilities). Default: `<cleoHome>/decide/provider-state.json`. */
+    readonly providerStatePath?: string;
 }
 /**
  * Reset the process-default cache and budget. Tests only.
@@ -136,9 +163,16 @@ export interface DecisionBatchEntry {
  * deadline cannot reach fall back with reason `timeout`. Never rejects; each
  * entry is audited like a single decision.
  *
+ * The whole-batch deadline defaults to {@link DEFAULT_BATCH_DECISION_TIMEOUT_MS}
+ * (30 s), not the 300 ms single-decision default. In the sequential
+ * degradation each call is additionally capped at
+ * {@link DEFAULT_DECISION_TIMEOUT_MS} unless the caller set `timeoutMs`, so a
+ * slow provider without the batch capability cannot hold one entry for 30 s.
+ *
  * @param siteId - Stable call-site identifier.
  * @param entries - Requests with their heuristics.
- * @param opts - Same wiring as {@link decide}; `timeoutMs` covers the whole batch.
+ * @param opts - Same wiring as {@link decide}; `timeoutMs` covers the whole batch
+ *   (default {@link DEFAULT_BATCH_DECISION_TIMEOUT_MS}).
  * @returns One outcome per entry, in order.
  */
 export declare function decideBatch(siteId: string, entries: readonly DecisionBatchEntry[], opts?: DecideOptions): Promise<DecisionOutcome[]>;

package/dist/decide/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/decide/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EACL,KAAK,cAAc,EAGnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,EAInB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAEL,KAAK,aAAa,EAGnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAGhC,MAAM,eAAe,CAAC;AAEvB,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAEpB,6EAA6E;AAC7E,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;AAEnG,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACxD,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,uFAAuF;IACvF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC,qFAAqF;IACrF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,yFAAyF;IACzF,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C,wFAAwF;IACxF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAwCD;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD;AAWD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAMvE;AAsED;;;;GAIG;AACH,eAAO,MAAM,0CAA0C,KAAK,CAAC;AA2K7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,eAAe,CAAC,CAyB1B;AAmED,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,eAAe,EAAE,CAAC,CA8F5B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/decide/client.ts"],"names":[],"mappings":"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"}