@oortmem/core 0.5.1 → 0.5.2

package/dist/adapters.d.ts

@@ -218,6 +218,43 @@ export interface DecisionController {
         obs: Observation;
         candidates: Memory[];
     }[]): Promise<ReconcileDecision[][]>;
+    /**
+     * Judgment memory (CON-71): which verdict the expert behind `req.precedents` would most likely
+     * give `req.item`, as a choice over `req.verdicts` with a probability per verdict. Optional; a
+     * controller without it leaves judging at precedents only.
+     */
+    judge?(req: JudgeRequest): Promise<JudgeChoice>;
+}
+/** One past decision as the controller sees it: the expert's reason verbatim. */
+export interface JudgePrecedent {
+    subject: string;
+    ref?: string;
+    verdict: string;
+    reason: string;
+    criteria: string[];
+    decidedAt: string;
+    /** How close it is to the item, 0 to 1 (dense cosine, or lexical overlap). */
+    similarity: number;
+}
+/** What `DecisionController.judge` is asked. */
+export interface JudgeRequest {
+    item: {
+        summary: string;
+        details?: string;
+        ref?: string;
+        domain?: string;
+    };
+    /** The verdicts to choose from; the precedents' own verdicts are among them. */
+    verdicts: string[];
+    /** Nearest first. Never empty. */
+    precedents: JudgePrecedent[];
+}
+/** The controller's answer: the likeliest verdict, its probability, and every verdict's. */
+export interface JudgeChoice {
+    verdict: string;
+    probability: number;
+    probabilities: Record<string, number>;
+    decisions: Decision[];
 }
 /** One memory as the writer authors it. */
 export interface WrittenMemory {

package/dist/config.d.ts

@@ -43,6 +43,11 @@ export declare const OortConfig: z.ZodObject<{
         queryCacheTtlSec: z.ZodDefault<z.ZodNumber>;
         staleAfterDays: z.ZodDefault<z.ZodNumber>;
         specificityPrior: z.ZodDefault<z.ZodNumber>;
+        promptMode: z.ZodDefault<z.ZodEnum<{
+            fast: "fast";
+            full: "full";
+            lexical: "lexical";
+        }>>;
     }, z.core.$strict>>;
     project: z.ZodDefault<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
@@ -52,6 +57,10 @@ export declare const OortConfig: z.ZodObject<{
         autostart: z.ZodDefault<z.ZodBoolean>;
         idleMinutes: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
+    judge: z.ZodDefault<z.ZodObject<{
+        experts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        operator: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type OortConfig = z.infer<typeof OortConfig>;
 export type ConfigSource = 'project' | 'home' | 'default';
@@ -60,7 +69,8 @@ export type ResolvedConfig = OortConfig & {
     sources: Record<string, ConfigSource>;
     /**
      * Keys a project's `oort.config.json` set that only the home config may set (`serve`: a
-     * repository must not start processes on this machine). Ignored; absent when there are none.
+     * repository must not start processes on this machine; `judge`: nor name experts). Ignored;
+     * absent when there are none.
      */
     ignoredProjectKeys?: string[];
 };

package/dist/config.js

@@ -75,6 +75,13 @@ const recall = z
      * Galaxy 0). 0, the default, turns it off: it is turned on only if the eval shows a gain.
      */
     specificityPrior: z.number().min(0).max(1).default(0),
+    /**
+     * How the prompt hook (Claude Code's UserPromptSubmit) recalls, locally and in Oort Cloud
+     * (CON-101): `full` embeds the prompt and reranks; `fast` skips the reranker (fusion and the
+     * relevance gate rank); `lexical` skips the query embedding too (no model call at all). `oort
+     * recall`, MCP and SessionStart always recall in full.
+     */
+    promptMode: z.enum(['full', 'fast', 'lexical']).default('full'),
 })
     .default({
     lexicalK: 50,
@@ -91,6 +98,7 @@ const recall = z
     queryCacheTtlSec: 600,
     staleAfterDays: 30,
     specificityPrior: 0,
+    promptMode: 'full',
 });
 const project = z
     .strictObject({
@@ -111,6 +119,20 @@ const serve = z
     idleMinutes: z.number().int().min(1).max(1440).default(30),
 })
     .default({ autostart: false, idleMinutes: 30 });
+/**
+ * Judgment memory (CON-71). Read from the home config only: a repository's `oort.config.json`
+ * cannot name who counts as an expert.
+ * - `experts`: the expert ids an agent may record judgments for over MCP (`record_judgment`).
+ *   Empty (the default): MCP recording is refused.
+ * - `operator`: who withdraws, confirms or purges judgments from this machine (`--by` overrides);
+ *   default `local-user`.
+ */
+const judge = z
+    .strictObject({
+    experts: z.array(z.string().trim().min(1).max(128)).max(200).default([]),
+    operator: z.string().trim().min(1).max(128).optional(),
+})
+    .default({ experts: [] });
 export const OortConfig = z.strictObject({
     embed,
     rerank,
@@ -120,9 +142,10 @@ export const OortConfig = z.strictObject({
     recall,
     project,
     serve,
+    judge,
 });
 /** Keys read from the home config only; a project file's value is ignored (and reported). */
-const HOME_ONLY_KEYS = new Set(['serve']);
+const HOME_ONLY_KEYS = new Set(['serve', 'judge']);
 const CONFIG_KEYS = Object.keys(OortConfig.shape);
 function findProjectConfig(cwd) {
     let dir = path.resolve(cwd);

package/dist/display.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Characters that must never reach a terminal or a person deciding something as they are: C0 and
+ * C1 controls, the bidi controls (Trojan Source) and zero-width or other invisible format
+ * characters. One source for the CLI's `shown()`/`safeJson()` and for judgment memory's input
+ * checks (CON-71), so the two never drift. Written as escapes: no literal one sits in this file.
+ */
+export declare const DISPLAY_UNSAFE_SOURCE = "[\\u0000-\\u001f\\u007f-\\u009f\\u061c\\u200b-\\u200f\\u202a-\\u202e\\u2060-\\u2064\\u2066-\\u2069\\ufeff]";
+/** DISPLAY_UNSAFE_SOURCE without C0 and C1: the bidi and invisible format characters alone. */
+export declare const INVISIBLE_SOURCE = "[\\u061c\\u200b-\\u200f\\u202a-\\u202e\\u2060-\\u2064\\u2066-\\u2069\\ufeff]";

package/dist/display.js

@@ -0,0 +1,10 @@
+/**
+ * Characters that must never reach a terminal or a person deciding something as they are: C0 and
+ * C1 controls, the bidi controls (Trojan Source) and zero-width or other invisible format
+ * characters. One source for the CLI's `shown()`/`safeJson()` and for judgment memory's input
+ * checks (CON-71), so the two never drift. Written as escapes: no literal one sits in this file.
+ */
+export const DISPLAY_UNSAFE_SOURCE = '[\\u0000-\\u001f\\u007f-\\u009f\\u061c\\u200b-\\u200f\\u202a-\\u202e\\u2060-\\u2064\\u2066-\\u2069\\ufeff]';
+/** DISPLAY_UNSAFE_SOURCE without C0 and C1: the bidi and invisible format characters alone. */
+export const INVISIBLE_SOURCE = '[\\u061c\\u200b-\\u200f\\u202a-\\u202e\\u2060-\\u2064\\u2066-\\u2069\\ufeff]';
+//# sourceMappingURL=display.js.map

package/dist/export-format.d.ts

@@ -38,7 +38,10 @@ export interface HiddenLinkFlags {
 export declare class ExportFormatError extends Error {
     constructor(message: string);
 }
-/** True when version 1 can hold `m`: a Planet memory whose author is its scope's agent. */
+/**
+ * True when version 1 can hold `m`: a Planet memory whose author is its scope's agent, and not a
+ * judgment (CON-71; version 1 readers know four memory types and no `judgment` field).
+ */
 export declare function fitsVersion1(m: Memory): boolean;
 /**
  * One memory as an export line of `version`: the embedding as base64 of its

package/dist/export-format.js

@@ -16,10 +16,15 @@ export class ExportFormatError extends Error {
     }
 }
 const base64 = (v) => Buffer.from(v.buffer, v.byteOffset, v.byteLength).toString('base64');
-/** True when version 1 can hold `m`: a Planet memory whose author is its scope's agent. */
+/**
+ * True when version 1 can hold `m`: a Planet memory whose author is its scope's agent, and not a
+ * judgment (CON-71; version 1 readers know four memory types and no `judgment` field).
+ */
 export function fitsVersion1(m) {
     const author = authorOf(m);
-    return (addressOf(m).level === 'user' &&
+    return (m.type !== 'judgment' &&
+        m.judgment === undefined &&
+        addressOf(m).level === 'user' &&
         author.accountRef === undefined &&
         author.agentId === m.scope.agentId &&
         (m.provenance === undefined || m.provenance === null));

package/dist/fusion.d.ts

@@ -9,6 +9,8 @@ export interface TemporalView {
     asOf?: string;
     /** For `known-at`: the instant in transaction time. */
     knownAt?: string;
+    /** Also show withdrawn judgments (CON-71); every mode leaves them out by default. */
+    includeWithdrawn?: boolean;
 }
 /**
  * Weight of the activation boost: fused = rrf * (1 + ACTIVATION_BOOST * sigmoid(A)). With one RRF

package/dist/fusion.js

@@ -54,6 +54,9 @@ const t = (iso) => Date.parse(iso);
  * - history: every version of a fact, except corrected ones.
  */
 export function isVisible(m, now, v) {
+    // A withdrawn judgment no longer counts in any slice of time: the expert took it back.
+    if (m.judgment?.withdrawn !== undefined && v.includeWithdrawn !== true)
+        return false;
     switch (v.mode) {
         case 'current':
             return isCurrent(m, now);

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.5.1";
+export declare const VERSION = "0.5.2";
 export * from './model.js';
 export * from './address.js';
 export * from './export-format.js';
@@ -25,3 +25,5 @@ export * from './cap.js';
 export * from './consolidate.js';
 export * from './errors.js';
 export * from './private-fs.js';
+export * from './judgment.js';
+export * from './display.js';

package/dist/index.js

@@ -1,4 +1,4 @@
-export const VERSION = '0.5.1';
+export const VERSION = '0.5.2';
 export * from './model.js';
 export * from './address.js';
 export * from './export-format.js';
@@ -25,4 +25,6 @@ export * from './cap.js';
 export * from './consolidate.js';
 export * from './errors.js';
 export * from './private-fs.js';
+export * from './judgment.js';
+export * from './display.js';
 //# sourceMappingURL=index.js.map