@zhijiewang/openharness 0.5.1 → 0.6.0

package/dist/harness/credentials.js

@@ -0,0 +1,104 @@
+/**
+ * Secure credential storage — stores API keys encrypted on disk
+ * instead of plaintext in config.yaml.
+ *
+ * Uses AES-256-GCM with a key derived from machine identity.
+ * Not bulletproof (key derivation is deterministic from machine info),
+ * but far better than plaintext YAML.
+ */
+import { createCipheriv, createDecipheriv, randomBytes, scryptSync } from 'node:crypto';
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir, hostname, userInfo } from 'node:os';
+const CRED_DIR = join(homedir(), '.oh');
+const CRED_PATH = join(CRED_DIR, 'credentials.enc');
+const ALGORITHM = 'aes-256-gcm';
+/** Derive an encryption key from machine identity */
+function deriveKey() {
+    const identity = `${hostname()}-${userInfo().username}-openharness`;
+    return scryptSync(identity, 'oh-credential-salt', 32);
+}
+function encrypt(data) {
+    const key = deriveKey();
+    const iv = randomBytes(12);
+    const cipher = createCipheriv(ALGORITHM, key, iv);
+    const encrypted = Buffer.concat([cipher.update(data, 'utf-8'), cipher.final()]);
+    const tag = cipher.getAuthTag();
+    // Format: [iv (12)] [tag (16)] [encrypted data]
+    return Buffer.concat([iv, tag, encrypted]);
+}
+function decrypt(data) {
+    const key = deriveKey();
+    const iv = data.subarray(0, 12);
+    const tag = data.subarray(12, 28);
+    const encrypted = data.subarray(28);
+    const decipher = createDecipheriv(ALGORITHM, key, iv);
+    decipher.setAuthTag(tag);
+    return decipher.update(encrypted, undefined, 'utf-8') + decipher.final('utf-8');
+}
+function loadStore() {
+    if (!existsSync(CRED_PATH))
+        return {};
+    try {
+        const raw = readFileSync(CRED_PATH);
+        const json = decrypt(raw);
+        return JSON.parse(json);
+    }
+    catch {
+        return {};
+    }
+}
+function saveStore(store) {
+    mkdirSync(CRED_DIR, { recursive: true });
+    const json = JSON.stringify(store);
+    writeFileSync(CRED_PATH, encrypt(json));
+}
+/** Get a stored credential by key (e.g., "anthropic-api-key") */
+export function getCredential(key) {
+    return loadStore()[key];
+}
+/** Store a credential */
+export function setCredential(key, value) {
+    const store = loadStore();
+    store[key] = value;
+    saveStore(store);
+}
+/** Delete a credential */
+export function deleteCredential(key) {
+    const store = loadStore();
+    delete store[key];
+    saveStore(store);
+}
+/** List credential keys (not values) */
+export function listCredentials() {
+    return Object.keys(loadStore());
+}
+/**
+ * Get API key for a provider, checking:
+ * 1. Environment variable (highest priority)
+ * 2. Encrypted credential store
+ * 3. Config file (legacy plaintext, with migration prompt)
+ */
+export function resolveApiKey(provider, configApiKey) {
+    // Environment variable names by provider
+    const envVarMap = {
+        anthropic: 'ANTHROPIC_API_KEY',
+        openai: 'OPENAI_API_KEY',
+        openrouter: 'OPENROUTER_API_KEY',
+    };
+    const envVar = envVarMap[provider];
+    if (envVar && process.env[envVar])
+        return process.env[envVar];
+    // Encrypted store
+    const stored = getCredential(`${provider}-api-key`);
+    if (stored)
+        return stored;
+    // Legacy config (migrate on use)
+    if (configApiKey) {
+        // Auto-migrate to encrypted store
+        setCredential(`${provider}-api-key`, configApiKey);
+        return configApiKey;
+    }
+    return undefined;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/harness/credentials.js.map

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

package/dist/harness/hooks.d.ts

@@ -12,6 +12,14 @@ export type HookContext = {
 };
 /**
  * Emit a hook event. For preToolUse, returns false if any hook blocks the call.
+ *
+ * preToolUse hooks run synchronously (they must block before tool execution).
+ * All other hooks run asynchronously to avoid blocking the event loop.
  */
 export declare function emitHook(event: HookEvent, ctx?: HookContext): boolean;
+/**
+ * Async version of emitHook that waits for all hooks to complete.
+ * Useful for sessionEnd where you want to ensure hooks finish.
+ */
+export declare function emitHookAsync(event: HookEvent, ctx?: HookContext): Promise<boolean>;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/harness/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/harness/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;AAErF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAWF;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,GAAE,WAAgB,GAAG,OAAO,CAkCzE"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/harness/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;AAErF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAqEF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,GAAE,WAAgB,GAAG,OAAO,CA8BzE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAe7F"}

package/dist/harness/hooks.js

@@ -4,7 +4,7 @@
  * preToolUse hooks can block tool execution (exit code 1 = block).
  * All other hooks are fire-and-forget (errors are silently ignored).
  */
-import { spawnSync } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { readOhConfig } from "./config.js";
 let cachedHooks;
 function getHooks() {
@@ -14,37 +14,113 @@ function getHooks() {
     cachedHooks = cfg?.hooks ?? null;
     return cachedHooks;
 }
+function buildEnv(event, ctx) {
+    const env = {
+        ...process.env,
+        OH_EVENT: event,
+    };
+    if (ctx.toolName)
+        env.OH_TOOL_NAME = ctx.toolName;
+    if (ctx.toolArgs)
+        env.OH_TOOL_ARGS = ctx.toolArgs;
+    if (ctx.toolOutput)
+        env.OH_TOOL_OUTPUT = ctx.toolOutput;
+    return env;
+}
+function matchesHook(def, ctx) {
+    if (def.match && ctx.toolName && !ctx.toolName.includes(def.match)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Run a single hook command asynchronously.
+ * Returns a promise that resolves with the exit code (0 = success).
+ */
+function runHookAsync(command, env, timeoutMs = 10_000) {
+    return new Promise((resolve) => {
+        const proc = spawn(command, {
+            shell: true,
+            timeout: timeoutMs,
+            stdio: "pipe",
+            env,
+        });
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                proc.kill();
+                resolve(1); // timeout = failure
+            }
+        }, timeoutMs);
+        proc.on("exit", (code) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                resolve(code ?? 1);
+            }
+        });
+        proc.on("error", () => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                resolve(1);
+            }
+        });
+    });
+}
 /**
  * Emit a hook event. For preToolUse, returns false if any hook blocks the call.
+ *
+ * preToolUse hooks run synchronously (they must block before tool execution).
+ * All other hooks run asynchronously to avoid blocking the event loop.
  */
 export function emitHook(event, ctx = {}) {
     const hooks = getHooks();
     if (!hooks)
         return true;
     const defs = hooks[event] ?? [];
+    const env = buildEnv(event, ctx);
+    if (event === "preToolUse") {
+        // preToolUse must be synchronous — it gates tool execution
+        for (const def of defs) {
+            if (!matchesHook(def, ctx))
+                continue;
+            const result = spawnSync(def.command, {
+                shell: true,
+                timeout: 10_000,
+                stdio: "pipe",
+                env,
+            });
+            if (result.status !== 0 || result.error) {
+                return false;
+            }
+        }
+        return true;
+    }
+    // All other hooks run asynchronously (fire-and-forget)
     for (const def of defs) {
-        // Filter by tool name if match is specified
-        if (def.match && ctx.toolName && !ctx.toolName.includes(def.match)) {
+        if (!matchesHook(def, ctx))
             continue;
-        }
-        const env = {
-            ...process.env,
-            OH_EVENT: event,
-        };
-        if (ctx.toolName)
-            env.OH_TOOL_NAME = ctx.toolName;
-        if (ctx.toolArgs)
-            env.OH_TOOL_ARGS = ctx.toolArgs;
-        if (ctx.toolOutput)
-            env.OH_TOOL_OUTPUT = ctx.toolOutput;
-        const result = spawnSync(def.command, {
-            shell: true,
-            timeout: 10_000,
-            stdio: "pipe",
-            env,
-        });
-        // preToolUse: non-zero exit blocks the tool call
-        if (event === "preToolUse" && (result.status !== 0 || result.error)) {
+        runHookAsync(def.command, env).catch(() => { });
+    }
+    return true;
+}
+/**
+ * Async version of emitHook that waits for all hooks to complete.
+ * Useful for sessionEnd where you want to ensure hooks finish.
+ */
+export async function emitHookAsync(event, ctx = {}) {
+    const hooks = getHooks();
+    if (!hooks)
+        return true;
+    const defs = hooks[event] ?? [];
+    const env = buildEnv(event, ctx);
+    for (const def of defs) {
+        if (!matchesHook(def, ctx))
+            continue;
+        const code = await runHookAsync(def.command, env);
+        if (event === "preToolUse" && code !== 0) {
             return false;
         }
     }

package/dist/harness/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/harness/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3C,IAAI,WAA2C,CAAC;AAEhD,SAAS,QAAQ;IACf,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAClD,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,WAAW,GAAG,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC;IACjC,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAgB,EAAE,MAAmB,EAAE;IAC9D,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,IAAI,GAAc,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,4CAA4C;QAC5C,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACnE,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAA2B;YAClC,GAAG,OAAO,CAAC,GAA6B;YACxC,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,IAAI,GAAG,CAAC,QAAQ;YAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC;QAClD,IAAI,GAAG,CAAC,QAAQ;YAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC;QAClD,IAAI,GAAG,CAAC,UAAU;YAAE,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,UAAU,CAAC;QAExD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE;YACpC,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,MAAM;YACb,GAAG;SACJ,CAAC,CAAC;QAEH,iDAAiD;QACjD,IAAI,KAAK,KAAK,YAAY,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACpE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/harness/hooks.ts"],"names":[],"mappings":"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"}

package/dist/harness/keybindings.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Keybinding customization — load user-defined keybindings from ~/.oh/keybindings.json.
+ *
+ * Format:
+ * [
+ *   { "key": "ctrl+s", "action": "/commit" },
+ *   { "key": "ctrl+k ctrl+d", "action": "/diff" },
+ *   { "key": "ctrl+p", "action": "/compact" }
+ * ]
+ *
+ * Supports single keys and two-key chord sequences (e.g., "ctrl+k ctrl+d").
+ */
+export type Keybinding = {
+    key: string;
+    action: string;
+};
+/** Load keybindings from ~/.oh/keybindings.json */
+export declare function loadKeybindings(): Keybinding[];
+/**
+ * Keybinding matcher — handles single keys and chord sequences.
+ *
+ * Usage:
+ *   const matcher = createKeybindingMatcher();
+ *   // In useInput callback:
+ *   const action = matcher.match(input, key);
+ *   if (action) handleAction(action);
+ */
+export declare function createKeybindingMatcher(): {
+    match(input: string, inkKey: {
+        ctrl: boolean;
+        meta: boolean;
+        shift: boolean;
+    }): string | null;
+    /** Get all keybinding descriptions for help display */
+    getBindings(): Keybinding[];
+};
+//# sourceMappingURL=keybindings.d.ts.map

package/dist/harness/keybindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keybindings.d.ts","sourceRoot":"","sources":["../../src/harness/keybindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAaF,mDAAmD;AACnD,wBAAgB,eAAe,IAAI,UAAU,EAAE,CAmB9C;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB;iBAO1B,MAAM,UACL;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GACvD,MAAM,GAAG,IAAI;IA6ChB,uDAAuD;mBACxC,UAAU,EAAE;EAI9B"}

package/dist/harness/keybindings.js

@@ -0,0 +1,134 @@
+/**
+ * Keybinding customization — load user-defined keybindings from ~/.oh/keybindings.json.
+ *
+ * Format:
+ * [
+ *   { "key": "ctrl+s", "action": "/commit" },
+ *   { "key": "ctrl+k ctrl+d", "action": "/diff" },
+ *   { "key": "ctrl+p", "action": "/compact" }
+ * ]
+ *
+ * Supports single keys and two-key chord sequences (e.g., "ctrl+k ctrl+d").
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const KEYBINDINGS_PATH = join(homedir(), '.oh', 'keybindings.json');
+let cachedBindings = null;
+/** Load keybindings from ~/.oh/keybindings.json */
+export function loadKeybindings() {
+    if (cachedBindings !== null)
+        return cachedBindings;
+    if (!existsSync(KEYBINDINGS_PATH)) {
+        cachedBindings = defaultKeybindings();
+        return cachedBindings;
+    }
+    try {
+        const raw = readFileSync(KEYBINDINGS_PATH, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+            cachedBindings = parsed;
+            return cachedBindings;
+        }
+    }
+    catch { /* ignore parse errors */ }
+    cachedBindings = defaultKeybindings();
+    return cachedBindings;
+}
+/** Default keybindings */
+function defaultKeybindings() {
+    return [
+        { key: 'ctrl+d', action: '/diff' },
+        { key: 'ctrl+l', action: '/clear' },
+        { key: 'ctrl+u', action: '/undo' },
+    ];
+}
+/** Parse a key string like "ctrl+s" into components */
+function parseKeyString(keyStr) {
+    const parts = keyStr.toLowerCase().split('+');
+    return {
+        ctrl: parts.includes('ctrl'),
+        alt: parts.includes('alt'),
+        shift: parts.includes('shift'),
+        key: parts.filter(p => p !== 'ctrl' && p !== 'alt' && p !== 'shift')[0] ?? '',
+    };
+}
+/** Check if an Ink key event matches a parsed key */
+function keyMatches(parsed, input, inkKey) {
+    if (parsed.ctrl !== inkKey.ctrl)
+        return false;
+    if (parsed.alt !== inkKey.meta)
+        return false;
+    if (parsed.shift !== inkKey.shift)
+        return false;
+    return input.toLowerCase() === parsed.key;
+}
+/**
+ * Keybinding matcher — handles single keys and chord sequences.
+ *
+ * Usage:
+ *   const matcher = createKeybindingMatcher();
+ *   // In useInput callback:
+ *   const action = matcher.match(input, key);
+ *   if (action) handleAction(action);
+ */
+export function createKeybindingMatcher() {
+    const bindings = loadKeybindings();
+    let pendingChord = null;
+    let pendingTimeout = null;
+    return {
+        match(input, inkKey) {
+            // Parse all bindings
+            for (const binding of bindings) {
+                const parts = binding.key.split(/\s+/);
+                if (parts.length === 1) {
+                    // Single key binding
+                    const parsed = parseKeyString(parts[0]);
+                    if (keyMatches(parsed, input, inkKey)) {
+                        pendingChord = null;
+                        return binding.action;
+                    }
+                }
+                else if (parts.length === 2) {
+                    // Chord sequence
+                    const first = parseKeyString(parts[0]);
+                    const second = parseKeyString(parts[1]);
+                    if (pendingChord && keyMatches(second, input, inkKey)) {
+                        // Second key of chord matches
+                        pendingChord = null;
+                        if (pendingTimeout) {
+                            clearTimeout(pendingTimeout);
+                            pendingTimeout = null;
+                        }
+                        return binding.action;
+                    }
+                    if (keyMatches(first, input, inkKey)) {
+                        // First key of chord matches — wait for second
+                        pendingChord = first;
+                        if (pendingTimeout)
+                            clearTimeout(pendingTimeout);
+                        pendingTimeout = setTimeout(() => {
+                            pendingChord = null;
+                            pendingTimeout = null;
+                        }, 1000); // 1s chord timeout
+                        return null; // consumed but no action yet
+                    }
+                }
+            }
+            // No match — clear pending chord
+            if (pendingChord) {
+                pendingChord = null;
+                if (pendingTimeout) {
+                    clearTimeout(pendingTimeout);
+                    pendingTimeout = null;
+                }
+            }
+            return null;
+        },
+        /** Get all keybinding descriptions for help display */
+        getBindings() {
+            return bindings;
+        },
+    };
+}
+//# sourceMappingURL=keybindings.js.map

package/dist/harness/keybindings.js.map

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

package/dist/harness/memory.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Auto-memory system — saves learnings across sessions.
+ *
+ * Memories are stored as markdown files in .oh/memory/ (project-level)
+ * or ~/.oh/memory/ (global). Each has YAML frontmatter with name, type, description.
+ *
+ * The system detects learnable patterns from assistant responses and saves them
+ * without user intervention.
+ */
+import type { Message } from '../types/message.js';
+import type { Provider } from '../providers/base.js';
+export type MemoryEntry = {
+    name: string;
+    type: 'convention' | 'preference' | 'project' | 'debugging';
+    description: string;
+    content: string;
+    filePath: string;
+};
+/** Load all memories from project and global dirs */
+export declare function loadMemories(): MemoryEntry[];
+/** Build a system prompt section from loaded memories */
+export declare function memoriesToPrompt(memories: MemoryEntry[]): string;
+/** Save a memory entry to the project memory directory */
+export declare function saveMemory(name: string, type: MemoryEntry['type'], description: string, content: string, global?: boolean): string;
+/**
+ * Detect if recent assistant messages contain learnable patterns.
+ * Returns structured memories to save, or empty array.
+ */
+export declare function detectMemories(provider: Provider, recentMessages: Message[], model?: string): Promise<Array<{
+    name: string;
+    type: MemoryEntry['type'];
+    description: string;
+    content: string;
+}>>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/harness/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/harness/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAMrD,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qDAAqD;AACrD,wBAAgB,YAAY,IAAI,WAAW,EAAE,CAgB5C;AAsBD,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAMhE;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,UAAQ,GACb,MAAM,CAkBR;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,OAAO,EAAE,EACzB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CA0CnG"}

package/dist/harness/memory.js

@@ -0,0 +1,115 @@
+/**
+ * Auto-memory system — saves learnings across sessions.
+ *
+ * Memories are stored as markdown files in .oh/memory/ (project-level)
+ * or ~/.oh/memory/ (global). Each has YAML frontmatter with name, type, description.
+ *
+ * The system detects learnable patterns from assistant responses and saves them
+ * without user intervention.
+ */
+import { readFileSync, writeFileSync, mkdirSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { createUserMessage } from '../types/message.js';
+const PROJECT_MEMORY_DIR = join('.oh', 'memory');
+const GLOBAL_MEMORY_DIR = join(homedir(), '.oh', 'memory');
+/** Load all memories from project and global dirs */
+export function loadMemories() {
+    const entries = [];
+    for (const dir of [PROJECT_MEMORY_DIR, GLOBAL_MEMORY_DIR]) {
+        if (!existsSync(dir))
+            continue;
+        for (const file of readdirSync(dir).filter(f => f.endsWith('.md'))) {
+            try {
+                const filePath = join(dir, file);
+                const raw = readFileSync(filePath, 'utf-8');
+                const entry = parseMemory(raw, filePath);
+                if (entry)
+                    entries.push(entry);
+            }
+            catch { /* skip */ }
+        }
+    }
+    return entries;
+}
+/** Parse a memory markdown file */
+function parseMemory(raw, filePath) {
+    const nameMatch = raw.match(/^name:\s*(.+)$/m);
+    const typeMatch = raw.match(/^type:\s*(.+)$/m);
+    const descMatch = raw.match(/^description:\s*(.+)$/m);
+    if (!nameMatch)
+        return null;
+    // Content is everything after the frontmatter closing ---
+    const fmEnd = raw.indexOf('---', raw.indexOf('---') + 3);
+    const content = fmEnd > 0 ? raw.slice(fmEnd + 3).trim() : '';
+    return {
+        name: nameMatch[1].trim(),
+        type: (typeMatch?.[1]?.trim() ?? 'convention'),
+        description: descMatch?.[1]?.trim() ?? '',
+        content,
+        filePath,
+    };
+}
+/** Build a system prompt section from loaded memories */
+export function memoriesToPrompt(memories) {
+    if (memories.length === 0)
+        return '';
+    const lines = memories.map(m => `- **${m.name}** (${m.type}): ${m.content.slice(0, 200)}`);
+    return `# Remembered Context\n${lines.join('\n')}`;
+}
+/** Save a memory entry to the project memory directory */
+export function saveMemory(name, type, description, content, global = false) {
+    const dir = global ? GLOBAL_MEMORY_DIR : PROJECT_MEMORY_DIR;
+    mkdirSync(dir, { recursive: true });
+    const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 50);
+    const filePath = join(dir, `${slug}.md`);
+    const md = `---
+name: ${name}
+type: ${type}
+description: ${description}
+---
+
+${content}
+`;
+    writeFileSync(filePath, md);
+    return filePath;
+}
+/**
+ * Detect if recent assistant messages contain learnable patterns.
+ * Returns structured memories to save, or empty array.
+ */
+export async function detectMemories(provider, recentMessages, model) {
+    // Only analyze if there are enough messages
+    if (recentMessages.length < 4)
+        return [];
+    // Extract assistant messages from recent turns
+    const assistantMsgs = recentMessages
+        .filter(m => m.role === 'assistant' && m.content.length > 50)
+        .slice(-3);
+    if (assistantMsgs.length === 0)
+        return [];
+    const contextText = assistantMsgs
+        .map(m => m.content.slice(0, 500))
+        .join('\n---\n');
+    const prompt = `Analyze this conversation snippet. If there are reusable learnings (coding conventions, project patterns, user preferences, debugging insights), extract them. Respond ONLY with a JSON array of objects with {name, type, description, content} or [] if nothing worth remembering.
+
+Types: "convention" (code style/patterns), "preference" (user likes/dislikes), "project" (architecture/decisions), "debugging" (solutions to problems)
+
+Keep each memory concise (1-2 sentences). Only extract non-obvious learnings.
+
+${contextText}`;
+    try {
+        const response = await provider.complete([createUserMessage(prompt)], 'You are a memory extraction system. Respond ONLY with valid JSON.', undefined, model);
+        const jsonMatch = response.content.match(/\[[\s\S]*\]/);
+        if (!jsonMatch)
+            return [];
+        const parsed = JSON.parse(jsonMatch[0]);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((m) => m.name && m.type && m.content && typeof m.content === 'string');
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/harness/memory.js.map

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