@oortmem/core 0.5.0 → 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,17 +43,36 @@ 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>;
         private: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
+    serve: z.ZodDefault<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';
 export type ResolvedConfig = OortConfig & {
     home: string;
     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; `judge`: nor name experts). Ignored;
+     * absent when there are none.
+     */
+    ignoredProjectKeys?: string[];
 };
 /**
  * Oort's home directory, always absolute: `OORT_HOME` resolved against the

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({
@@ -99,6 +107,32 @@ const project = z
     private: z.boolean().default(false),
 })
     .default({ private: false });
+/**
+ * `oort serve`, the local daemon the hooks talk to (CON-18). Read from the home config only: a
+ * repository's `oort.config.json` cannot start processes on this machine.
+ */
+const serve = z
+    .strictObject({
+    /** SessionStart starts a detached daemon when none is running. */
+    autostart: z.boolean().default(false),
+    /** The daemon exits after this many minutes without a hook request. */
+    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,
@@ -107,7 +141,11 @@ export const OortConfig = z.strictObject({
     activation,
     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', 'judge']);
 const CONFIG_KEYS = Object.keys(OortConfig.shape);
 function findProjectConfig(cwd) {
     let dir = path.resolve(cwd);
@@ -175,8 +213,11 @@ export function resolveConfig(cwd, env = process.env, opts = {}) {
     const homeRaw = fs.existsSync(homeFile) ? readConfigFile(homeFile) : {};
     const merged = {};
     const sources = {};
+    const ignored = [];
     for (const key of CONFIG_KEYS) {
-        if (key in projectRaw) {
+        if (key in projectRaw && HOME_ONLY_KEYS.has(key))
+            ignored.push(key);
+        if (key in projectRaw && !HOME_ONLY_KEYS.has(key)) {
             merged[key] = projectRaw[key];
             sources[key] = 'project';
         }
@@ -188,6 +229,11 @@ export function resolveConfig(cwd, env = process.env, opts = {}) {
             sources[key] = 'default';
         }
     }
-    return { ...OortConfig.parse(merged), home, sources };
+    return {
+        ...OortConfig.parse(merged),
+        home,
+        sources,
+        ...(ignored.length > 0 && { ignoredProjectKeys: ignored }),
+    };
 }
 //# sourceMappingURL=config.js.map

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.0";
+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.0';
+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