@mnemom/mnemom 0.17.0-next.6 → 0.17.0-next.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemom/mnemom",
-  "version": "0.17.0-next.6",
+  "version": "0.17.0-next.8",
   "description": "Transparent AI agent tracing",
   "type": "module",
   "bin": {
@@ -26,10 +26,10 @@
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.0",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/coverage-v8": "^4.1.11",
     "tsx": "^4.23.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "files": [
     "dist",
@@ -65,5 +65,9 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "overrides": {
+    "@vitest/mocker": "^4.1.11",
+    "nanoid": "^3.3.18"
   }
 }

package/dist/commands/code-config.d.ts

@@ -1,17 +0,0 @@
-/**
- * `mnemom code config …` — read and write the persistent per-customer settings
- * for `mnemom code` (see lib/code-config.ts). A sub-verb of `mnemom code`, so a
- * customer configures the launcher once and never retypes their flags:
- *
- *   mnemom code config list                 # show the current settings
- *   mnemom code config get <key>            # print one value
- *   mnemom code config set <key> <value>    # validate + persist one value
- *   mnemom code config unset <key>          # remove one value
- *   mnemom code config edit                 # open ~/.mnemom/code.toml in $EDITOR
- *   mnemom code config path                 # print the settings file path
- *
- * Settable keys are the single source of truth in lib/code-config.ts CONFIG_KEYS.
- * The secret Anthropic key is NOT a config key — it lives in ~/.mnemom/code.json.
- */
-/** Entry point for `mnemom code config <verb> [args...]`. Throws on misuse. */
-export declare function codeConfigCommand(argv: string[]): Promise<void>;

package/dist/commands/code-config.js

@@ -1,147 +0,0 @@
-/**
- * `mnemom code config …` — read and write the persistent per-customer settings
- * for `mnemom code` (see lib/code-config.ts). A sub-verb of `mnemom code`, so a
- * customer configures the launcher once and never retypes their flags:
- *
- *   mnemom code config list                 # show the current settings
- *   mnemom code config get <key>            # print one value
- *   mnemom code config set <key> <value>    # validate + persist one value
- *   mnemom code config unset <key>          # remove one value
- *   mnemom code config edit                 # open ~/.mnemom/code.toml in $EDITOR
- *   mnemom code config path                 # print the settings file path
- *
- * Settable keys are the single source of truth in lib/code-config.ts CONFIG_KEYS.
- * The secret Anthropic key is NOT a config key — it lives in ~/.mnemom/code.json.
- */
-import { spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { CODE_CONFIG_PATH, CONFIG_KEYS, configKeySpec, loadCodeConfig, writeCodeConfig, } from "../lib/code-config.js";
-const out = (line = "") => console.log(line);
-const err = (line = "") => console.error(line);
-/** Entry point for `mnemom code config <verb> [args...]`. Throws on misuse. */
-export async function codeConfigCommand(argv) {
-    const [verb, ...rest] = argv;
-    switch (verb) {
-        case undefined:
-        case "list":
-            return listConfig();
-        case "path":
-            out(CODE_CONFIG_PATH);
-            return;
-        case "get":
-            return getConfig(rest[0]);
-        case "set":
-            return setConfig(rest[0], rest[1]);
-        case "unset":
-            return unsetConfig(rest[0]);
-        case "edit":
-            return editConfig();
-        default:
-            throw new Error(`mnemom code config: unknown verb '${verb}'. Use list | get | set | unset | edit | path.`);
-    }
-}
-function listConfig() {
-    const cfg = loadCodeConfig();
-    const rows = [];
-    for (const spec of CONFIG_KEYS) {
-        const v = spec.get(cfg);
-        if (v !== undefined)
-            rows.push([spec.key, String(v)]);
-    }
-    if (!rows.length) {
-        out(`No settings yet at ${CODE_CONFIG_PATH}.`);
-        out("Set one with:  mnemom code config set <key> <value>");
-        out("");
-        out("Settable keys:");
-        for (const spec of CONFIG_KEYS)
-            out(`  ${spec.key.padEnd(22)} ${spec.describe}`);
-        return;
-    }
-    const width = Math.max(...rows.map(([k]) => k.length));
-    out(`# ${CODE_CONFIG_PATH}`);
-    for (const [k, v] of rows)
-        out(`${k.padEnd(width)}  ${v}`);
-}
-function getConfig(key) {
-    if (!key)
-        throw new Error("mnemom code config get: a <key> is required.");
-    const spec = requireSpec(key);
-    const value = spec.get(loadCodeConfig());
-    if (value === undefined) {
-        err(`mnemom code config: '${key}' is not set.`);
-        process.exitCode = 1;
-        return;
-    }
-    out(String(value));
-}
-function setConfig(key, value) {
-    if (!key)
-        throw new Error("mnemom code config set: a <key> is required.");
-    if (value === undefined)
-        throw new Error(`mnemom code config set: a value for '${key}' is required.`);
-    const spec = requireSpec(key);
-    const cfg = loadCodeConfig();
-    spec.set(cfg, value); // validates + coerces; throws on invalid
-    writeCodeConfig(cfg);
-    out(`${key} = ${String(spec.get(cfg))}   (saved to ${CODE_CONFIG_PATH})`);
-}
-function unsetConfig(key) {
-    if (!key)
-        throw new Error("mnemom code config unset: a <key> is required.");
-    requireSpec(key);
-    const cfg = loadCodeConfig();
-    deleteKey(cfg, key);
-    writeCodeConfig(cfg);
-    out(`unset ${key}   (saved to ${CODE_CONFIG_PATH})`);
-}
-function editConfig() {
-    // Seed a header-only file so $EDITOR opens something with guidance, not a blank.
-    if (!existsSync(CODE_CONFIG_PATH))
-        writeCodeConfig(loadCodeConfig());
-    const editor = process.env.VISUAL || process.env.EDITOR || fallbackEditor();
-    const res = spawnSync(editor, [CODE_CONFIG_PATH], { stdio: "inherit" });
-    if (res.error) {
-        throw new Error(`mnemom code config edit: could not launch editor '${editor}': ${res.error.message}\n` +
-            `  Set $EDITOR, or edit ${CODE_CONFIG_PATH} directly.`);
-    }
-    // Re-parse so a typo surfaces now, not at the next launch.
-    loadCodeConfig();
-    out(`Saved ${CODE_CONFIG_PATH}.`);
-}
-function fallbackEditor() {
-    for (const cand of ["nano", "vim", "vi"]) {
-        const r = spawnSync("sh", ["-c", `command -v "$1" >/dev/null 2>&1`, "sh", cand], {
-            stdio: "ignore",
-        });
-        if (r.status === 0)
-            return cand;
-    }
-    return "vi";
-}
-function requireSpec(key) {
-    const spec = configKeySpec(key);
-    if (!spec) {
-        throw new Error(`mnemom code config: unknown key '${key}'.\n  Known keys: ${CONFIG_KEYS.map((k) => k.key).join(", ")}`);
-    }
-    return spec;
-}
-/** Remove a (possibly dotted) key from a config object, pruning an emptied table. */
-function deleteKey(cfg, key) {
-    if (key.startsWith("guardrails.")) {
-        const g = cfg.guardrails;
-        if (!g)
-            return;
-        const field = key.slice("guardrails.".length);
-        if (field === "max_turns")
-            delete g.maxTurns;
-        if (field === "budget_usd")
-            delete g.budgetUsd;
-        if (field === "stall_turns")
-            delete g.stallTurns;
-        if (g.maxTurns === undefined && g.budgetUsd === undefined && g.stallTurns === undefined) {
-            delete cfg.guardrails;
-        }
-        return;
-    }
-    delete cfg[key === "key_source" ? "keySource" : key];
-}

package/dist/commands/code-session.d.ts

@@ -1,52 +0,0 @@
-/**
- * `mnemom code` with no session name — the interactive first-run setup.
- *
- * The daily command is just `mnemom code` (the Claude Code pattern: install
- * once, then the bare command). When the positional session name is omitted in
- * a terminal we ask two things, explaining each in a sentence:
- *
- *   1. a SESSION NAME — labels the session in traces and the claude.ai session
- *      list (defaults to the current folder's name);
- *   2. an optional GOAL — one line. With a goal, Mnemom seals a goal contract
- *      for the session and the judge nudges the agent back when it drifts (a
- *      little µ per turn). Without one, the session runs governed but with goal
- *      alignment OFF: no contract header is sent, so the gateway's goal hook is
- *      simply not engaged for the conversation.
- *
- * Non-interactive runs (pipes, CI) never prompt — they get a clear error asking
- * for a name. `--goal` on the command line always wins over the prompt. Pure
- * apart from the injected `ask` functions, so every arm is unit-tested.
- */
-export interface SessionAsk {
-    askInput(question: string): Promise<string>;
-    askYesNo(question: string, defaultYes: boolean): Promise<boolean>;
-}
-export interface SessionSetupInput {
-    /** The positional `[scenario]` (session name), if given. */
-    scenario?: string;
-    /** `--goal <statement>`, if given — skips the goal prompt. */
-    goal?: string;
-    interactive: boolean;
-    /** For the default session name (tests inject one). */
-    cwd?: string;
-    /** Narration sink (stderr by default; tests capture). */
-    say?: (line?: string) => void;
-}
-export interface SessionSetup {
-    scenario: string;
-    /** The goal statement to seal, or undefined = goal alignment off. */
-    goal?: string;
-    goalAlignment: "on" | "off";
-    /** True when the terminal prompts ran. */
-    prompted: boolean;
-}
-export declare const NO_SESSION_NAME_MESSAGE: string;
-/** Current folder name, sanitised like an agent slug; "session" when that is empty. */
-export declare function defaultSessionName(cwd?: string): string;
-/** The one-line status printed at launch so the customer always knows the mode. */
-export declare function goalAlignmentLine(on: boolean): string;
-/**
- * Resolve the session name + goal for this launch. See the module doc for the
- * rules. Throws NO_SESSION_NAME_MESSAGE when no name was given and we cannot ask.
- */
-export declare function resolveSessionSetup(input: SessionSetupInput, ask: SessionAsk): Promise<SessionSetup>;

package/dist/commands/code-session.js

@@ -1,78 +0,0 @@
-/**
- * `mnemom code` with no session name — the interactive first-run setup.
- *
- * The daily command is just `mnemom code` (the Claude Code pattern: install
- * once, then the bare command). When the positional session name is omitted in
- * a terminal we ask two things, explaining each in a sentence:
- *
- *   1. a SESSION NAME — labels the session in traces and the claude.ai session
- *      list (defaults to the current folder's name);
- *   2. an optional GOAL — one line. With a goal, Mnemom seals a goal contract
- *      for the session and the judge nudges the agent back when it drifts (a
- *      little µ per turn). Without one, the session runs governed but with goal
- *      alignment OFF: no contract header is sent, so the gateway's goal hook is
- *      simply not engaged for the conversation.
- *
- * Non-interactive runs (pipes, CI) never prompt — they get a clear error asking
- * for a name. `--goal` on the command line always wins over the prompt. Pure
- * apart from the injected `ask` functions, so every arm is unit-tested.
- */
-import { basename } from "node:path";
-import { sanitizeAgentName } from "../lib/code.js";
-export const NO_SESSION_NAME_MESSAGE = "mnemom code: a session name is required here (e.g. `mnemom code onboarding`). " +
-    "In a terminal, plain `mnemom code` asks for one.";
-/** Current folder name, sanitised like an agent slug; "session" when that is empty. */
-export function defaultSessionName(cwd = process.cwd()) {
-    return sanitizeAgentName(basename(cwd)) || "session";
-}
-/** The one-line status printed at launch so the customer always knows the mode. */
-export function goalAlignmentLine(on) {
-    return on
-        ? "mnemom code: goal alignment: on (the judge nudges the agent back when it drifts from your goal)"
-        : "mnemom code: goal alignment: off (no goal set — pass --goal or set one when prompted)";
-}
-const defaultSay = (line = "") => console.error(line);
-/**
- * Resolve the session name + goal for this launch. See the module doc for the
- * rules. Throws NO_SESSION_NAME_MESSAGE when no name was given and we cannot ask.
- */
-export async function resolveSessionSetup(input, ask) {
-    const say = input.say ?? defaultSay;
-    const flagGoal = (input.goal ?? "").trim();
-    const given = (input.scenario ?? "").trim();
-    if (given) {
-        return {
-            scenario: given,
-            goal: flagGoal || undefined,
-            goalAlignment: flagGoal ? "on" : "off",
-            prompted: false,
-        };
-    }
-    if (!input.interactive)
-        throw new Error(NO_SESSION_NAME_MESSAGE);
-    // ── 1. session name ──
-    const fallback = defaultSessionName(input.cwd);
-    say();
-    say("Session name — labels this session in your traces and the claude.ai session list.");
-    say(`  (Next time you can pass it directly: mnemom code <name>.)`);
-    const typed = await ask.askInput(`Session name [${fallback}]:`);
-    const scenario = sanitizeAgentName(typed.trim()) || fallback;
-    // ── 2. goal (skipped when --goal was given) ──
-    if (flagGoal) {
-        return { scenario, goal: flagGoal, goalAlignment: "on", prompted: true };
-    }
-    say();
-    say("Goal alignment — an optional one-line goal for this session.");
-    say("  With a goal, Mnemom's judge watches each turn and nudges the agent back when it drifts");
-    say("  (a little µ per turn). Without one, the session runs governed with goal alignment off.");
-    const wantsGoal = await ask.askYesNo("Set a goal for this session?", true);
-    if (!wantsGoal) {
-        return { scenario, goalAlignment: "off", prompted: true };
-    }
-    const goal = (await ask.askInput("Goal (one line):")).trim();
-    if (!goal) {
-        say("  No goal entered — continuing with goal alignment off.");
-        return { scenario, goalAlignment: "off", prompted: true };
-    }
-    return { scenario, goal, goalAlignment: "on", prompted: true };
-}