hmem-mcp 7.4.0 → 8.0.0

package/dist/cli-v2-checkpoint.d.ts

@@ -0,0 +1,38 @@
+/**
+ * cli-v2-checkpoint.ts
+ *
+ * Async Stop-hook entry point for the v2 checkpoint pipeline.
+ * Opens a v2 store exclusively — never touches HmemStore or any v1 path.
+ *
+ * On a v1 file, a missing/unreadable file, or a missing HMEM_PATH env:
+ *   → silent no-op return (never throws, never constructs HmemStore).
+ *
+ * On a v2 file with a resolvable session:
+ *   → runs one checkpoint-extraction pass (see ./v2/checkpoint.ts).
+ *
+ * Usage (hook): claude pipes `{ session_id, stop_hook_active }` on stdin.
+ *
+ * Requires env:
+ *   HMEM_PATH        — path to .hmem file (the hook sets this explicitly)
+ *   HMEM_PROJECT_DIR — directory for config + company.hmem (derived from
+ *                      HMEM_PATH by resolveEnvDefaults — the hook does NOT set it)
+ */
+import { type RunV2CheckpointOptions } from "./v2/checkpoint.js";
+/**
+ * Hook entry point (dispatched by cli.ts). Reads the Stop-hook JSON from stdin to
+ * obtain the session id — Claude Code provides it there, NOT in the environment —
+ * mirroring cli-log-exchange.ts. A TTY (manual run) has no hook payload, so stdin
+ * is skipped and the core falls back to env/ppid session resolution.
+ */
+export declare function runCliV2Checkpoint(): Promise<void>;
+/**
+ * Testable core: resolve env, guard, open the v2 store, run one checkpoint pass.
+ * Kept separate from the stdin-reading wrapper so tests can drive it directly
+ * (same split as cli-log-exchange.ts's appendExchangeV2Path).
+ *
+ * @param sessionId explicit session id (from the hook stdin). Falls back to
+ *                  resolveSessionId() (HMEM_SESSION_ID env → ppid bridge) when omitted.
+ * @param opts      test seams (agent `invoke`, gate/agent probes) forwarded to
+ *                  runV2Checkpoint. The production hook passes none → real spawn.
+ */
+export declare function runCliV2CheckpointCore(sessionId?: string, opts?: RunV2CheckpointOptions): Promise<void>;

package/dist/cli-v2-checkpoint.js

@@ -0,0 +1,134 @@
+/**
+ * cli-v2-checkpoint.ts
+ *
+ * Async Stop-hook entry point for the v2 checkpoint pipeline.
+ * Opens a v2 store exclusively — never touches HmemStore or any v1 path.
+ *
+ * On a v1 file, a missing/unreadable file, or a missing HMEM_PATH env:
+ *   → silent no-op return (never throws, never constructs HmemStore).
+ *
+ * On a v2 file with a resolvable session:
+ *   → runs one checkpoint-extraction pass (see ./v2/checkpoint.ts).
+ *
+ * Usage (hook): claude pipes `{ session_id, stop_hook_active }` on stdin.
+ *
+ * Requires env:
+ *   HMEM_PATH        — path to .hmem file (the hook sets this explicitly)
+ *   HMEM_PROJECT_DIR — directory for config + company.hmem (derived from
+ *                      HMEM_PATH by resolveEnvDefaults — the hook does NOT set it)
+ */
+import fs from "node:fs";
+import path from "node:path";
+import Database from "better-sqlite3";
+import { createV2Store } from "./v2/store-facade.js";
+import { getSchemaMajor, V1FileError } from "./store/db.js";
+import { loadHmemConfig } from "./hmem-config.js";
+import { resolveSessionId } from "./v2/session-id.js";
+import { resolveEnvDefaults } from "./cli-env.js";
+import { runV2Checkpoint } from "./v2/checkpoint.js";
+/**
+ * Read-only schema-major probe. Returns '2' only when the file exists and
+ * carries schema_major='2'. Any other case — v1 file, missing file, locked
+ * handle, corrupt header — returns null. Never throws.
+ *
+ * Uses a readonly better-sqlite3 handle so openDb's WAL pragma and schema
+ * bootstrap are NEVER run against the file (symmetric to the probe in
+ * cli-checkpoint.ts#isV2Store, but returns the raw major string instead of
+ * a boolean so callers can distinguish v1 vs. absent).
+ */
+function probeSchemaMajor(hmemPath) {
+    let db;
+    try {
+        db = new Database(hmemPath, { readonly: true });
+        return getSchemaMajor(db);
+    }
+    catch {
+        return null;
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch { /* ignore */ }
+    }
+}
+/**
+ * Hook entry point (dispatched by cli.ts). Reads the Stop-hook JSON from stdin to
+ * obtain the session id — Claude Code provides it there, NOT in the environment —
+ * mirroring cli-log-exchange.ts. A TTY (manual run) has no hook payload, so stdin
+ * is skipped and the core falls back to env/ppid session resolution.
+ */
+export async function runCliV2Checkpoint() {
+    let input = {};
+    if (!process.stdin.isTTY) {
+        try {
+            input = JSON.parse(fs.readFileSync(0, "utf8") || "{}");
+        }
+        catch {
+            // No / invalid stdin payload — core falls back to resolveSessionId().
+        }
+    }
+    // Re-entry guard: Claude re-fires Stop with this flag set; don't double-run.
+    if (input.stop_hook_active)
+        return;
+    await runCliV2CheckpointCore(input.session_id);
+}
+/**
+ * Testable core: resolve env, guard, open the v2 store, run one checkpoint pass.
+ * Kept separate from the stdin-reading wrapper so tests can drive it directly
+ * (same split as cli-log-exchange.ts's appendExchangeV2Path).
+ *
+ * @param sessionId explicit session id (from the hook stdin). Falls back to
+ *                  resolveSessionId() (HMEM_SESSION_ID env → ppid bridge) when omitted.
+ * @param opts      test seams (agent `invoke`, gate/agent probes) forwarded to
+ *                  runV2Checkpoint. The production hook passes none → real spawn.
+ */
+export async function runCliV2CheckpointCore(sessionId, opts = {}) {
+    // 1. HMEM_PATH guard FIRST — the hook sets it explicitly. Guarding before
+    //    resolveEnvDefaults() preserves the "unset → no-op" contract and stops the
+    //    HMEM_PATH auto-resolver from reaching a real store.
+    if (!process.env.HMEM_PATH)
+        return;
+    // 2. Derive HMEM_PROJECT_DIR from HMEM_PATH. The Stop hook sets only HMEM_PATH;
+    //    without this the original code early-returned into a silent no-op, and
+    //    downstream config/agent wiring (which reads HMEM_PROJECT_DIR) would break.
+    resolveEnvDefaults();
+    const hmemPath = process.env.HMEM_PATH;
+    if (!fs.existsSync(hmemPath))
+        return;
+    // 3. Read-only schema probe BEFORE opening anything heavy.
+    //    Not v2 (v1 file, empty file, missing schema_version) → no-op.
+    //    This is the primary guard; the V1FileError catch below is belt-and-suspenders.
+    const schemaMajor = probeSchemaMajor(hmemPath);
+    if (schemaMajor !== "2") {
+        return;
+    }
+    // 4. Open via createV2Store exclusively (never HmemStore).
+    const config = loadHmemConfig(path.dirname(hmemPath));
+    let store;
+    try {
+        try {
+            store = createV2Store(hmemPath, config);
+        }
+        catch (e) {
+            // Belt-and-suspenders: if the probe is bypassed and the file turns out
+            // to be v1, openDb throws V1FileError — swallow it into a no-op.
+            if (e instanceof V1FileError)
+                return;
+            throw e;
+        }
+        // Real extraction pass. With no resolvable session, or a session with no open
+        // binding, runV2Checkpoint is a clean no-op.
+        const sid = sessionId ?? resolveSessionId();
+        if (sid) {
+            await runV2Checkpoint(store, sid, config, hmemPath, opts);
+        }
+    }
+    finally {
+        try {
+            store?.close();
+        }
+        catch { /* ignore */ }
+    }
+}
+//# sourceMappingURL=cli-v2-checkpoint.js.map

package/dist/cli-v2-checkpoint.js.map

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

package/dist/cli.js

@@ -13,6 +13,91 @@ if (pathIdx !== -1 && args[pathIdx + 1]) {
     args.splice(pathIdx, 2);
 }
 const command = args[0];
+function printUsageTable() {
+    console.log(`hmem — Humanlike Memory for AI Agents
+
+Usage:
+  hmem serve                          Start the MCP server (stdio transport)
+  hmem init                           Install hmem for AI coding tools (interactive or with flags)
+  hmem update-skills                  Copy/update skill files to detected AI tools
+  hmem mcp-add-curate                 Register the hmem-curate MCP server with Claude Code (opt-in)
+  hmem setup-hook                     Add hmem SessionStart hook to Claude Code settings
+  hmem doctor                         Detect stale or deprecated hmem MCP entries in host configs
+  hmem stats                          Show memory statistics + per-project token estimates
+  hmem version                        Show version
+
+Hook drivers (called by AI tool hooks, not directly by users):
+  hmem hook-startup                   UserPromptSubmit hook — counter, checkpoint reminders
+  hmem log-exchange                   Stop hook — log exchange to active O-entry
+  hmem context-inject                 SessionStart[clear] hook — re-inject project context
+  hmem deactivate                     SessionStart[clear] hook — clear active project
+  hmem statusline                     statusLine — generate Claude Code statusline (JSON on stdin)
+  hmem checkpoint                     Extract knowledge from recent exchanges (background)
+
+Curation:
+  hmem delete <ID>                    Permanently delete an entry (curator only, not synced)
+  hmem migrate-o-entries              Migrate O-entries to current schema
+  hmem summarize-session <id>         Generate summary node for a session
+
+Sync (requires hmem-sync installed):
+  hmem sync push                      Push local memory to sync server
+  hmem sync pull                      Pull latest memory from sync server
+  hmem sync status                    Show sync server + auth + last-sync state
+  hmem sync setup [--join]            Interactive sync-passphrase setup
+
+Backup / migration:
+  hmem export-staging <hmem> <json>   Export .hmem to JSON staging file
+  hmem import-staging <json> <hmem>   Import JSON staging back into .hmem
+
+Environment variables (for serve):
+  HMEM_PATH          Path to .hmem file (optional, auto-detected)
+  HMEM_PROJECT_DIR   Directory for config + company.hmem (derived from HMEM_PATH)
+  HMEM_AGENT_ROLE    Role: worker | al | pl | ceo (default: worker)
+
+Non-interactive init flags:
+  --global             System-wide install (default)
+  --local              Project-local install
+  --tools claude-code  Comma-separated tool list (default: all detected)
+  --dir /path          Memory directory (default: ~/.hmem)
+  --no-example         Skip example memory installation
+
+Examples:
+  npx hmem init                          # Interactive installer
+  npx hmem init --global                 # Non-interactive, all detected tools
+  npx hmem init --global --tools claude-code  # Non-interactive, Claude Code only
+  npx hmem update-skills                 # Update skills after npm update
+  HMEM_PROJECT_DIR=. npx hmem serve      # Start server in current directory`);
+}
+function printHelp() {
+    console.log(`🧠 hmem — Quick Tips
+
+  📦 Context full? (>100k tokens)
+     /hmem-wipe  — saves high-value knowledge to hmem, then /clear.
+                  Run before context compaction kicks in.
+
+  🔄 Multiple devices?
+     hmem sync setup  — Cross-device sync via passphrase.
+                        Passphrase stays device-local; server only sees ciphertext.
+
+  📜 Define your own rules?
+     In-session: say "remember as a rule: ..."
+       → stored as an R-entry, re-injected at every session start.
+
+  ✨ Register a new project?
+     In-session: say "new project XYZ"
+       → hmem-new-project skill handles schema + O-entry linking.
+
+  📌 Keep important entries visible every session?
+     In-session: say "pin this entry"
+       → marks entry as [P] pinned, L2 content injected at session start.
+
+  🧹 Curate / delete entries?
+     hmem mcp-add-curate
+       → registers the maintenance MCP (bulk edits, delete, merge, stats).
+         Activate via /mcp only when curating, deactivate when done.
+`);
+    printUsageTable();
+}
 switch (command) {
     case "serve":
         await import("./mcp-server.js");
@@ -27,6 +112,11 @@ switch (command) {
         updateSkills();
         break;
     }
+    case "mcp-add-curate": {
+        const { runMcpAddCurate } = await import("./cli-mcp-add-curate.js");
+        runMcpAddCurate();
+        break;
+    }
     case "log-exchange": {
         const { logExchange } = await import("./cli-log-exchange.js");
         await logExchange();
@@ -82,6 +172,35 @@ switch (command) {
         await setupHook();
         break;
     }
+    case "doctor": {
+        const { doctor } = await import("./cli-doctor.js");
+        await doctor();
+        break;
+    }
+    case "export-staging": {
+        const { exportToStaging } = await import("./sync-bridge.js");
+        const hmemPath = args[1];
+        const stagingPath = args[2];
+        if (!hmemPath || !stagingPath) {
+            console.error("Usage: hmem export-staging <hmem-path> <staging-path>");
+            process.exit(1);
+        }
+        await exportToStaging(hmemPath, stagingPath);
+        console.log(`✓ Exported ${hmemPath} → ${stagingPath}`);
+        break;
+    }
+    case "import-staging": {
+        const { importFromStaging } = await import("./sync-bridge.js");
+        const hmemPath = args[1];
+        const stagingPath = args[2];
+        if (!hmemPath || !stagingPath) {
+            console.error("Usage: hmem import-staging <staging-path> <hmem-path>");
+            process.exit(1);
+        }
+        await importFromStaging(stagingPath, hmemPath);
+        console.log(`✓ Imported ${stagingPath} → ${hmemPath}`);
+        break;
+    }
     case "version":
     case "--version":
     case "-v": {
@@ -91,41 +210,42 @@ switch (command) {
         console.log(`hmem ${pkg.version}`);
         break;
     }
+    case "setup": {
+        const { runSetup } = await import("./cli-sync-setup.js");
+        await runSetup({ join: process.argv.includes("--join") });
+        break;
+    }
+    case "help":
+    case "--help":
+    case "-h":
+        printHelp();
+        break;
+    case "sync": {
+        const subCmd = process.argv[3];
+        if (subCmd === "push") {
+            const { syncPush } = await import("./cli-sync-push.js");
+            await syncPush({ skipPull: process.argv.includes("--skip-pull") });
+        }
+        else if (subCmd === "pull") {
+            const { syncPull } = await import("./cli-sync-pull.js");
+            await syncPull();
+        }
+        else if (subCmd === "status") {
+            const { syncStatus } = await import("./cli-sync-status.js");
+            await syncStatus();
+        }
+        else if (subCmd === "setup") {
+            const { runSetup } = await import("./cli-sync-setup.js");
+            await runSetup({ join: process.argv.includes("--join") });
+        }
+        else {
+            console.error("Usage: hmem sync <push|pull|status|setup>");
+            process.exit(1);
+        }
+        break;
+    }
     default:
-        console.log(`hmem — Humanlike Memory for AI Agents
-
-Usage:
-  hmem serve          Start the MCP server (stdio transport)
-  hmem init           Install hmem for AI coding tools (interactive or with flags)
-  hmem update-skills  Copy/update skill files to detected AI tools
-  hmem log-exchange   Log a chat exchange to active O-entry (called by Stop hook)
-  hmem context-inject Output compressed context for re-injection after /clear
-  hmem deactivate     Clear active project for current session (called by SessionStart[clear] hook)
-  hmem setup-hook     Add hmem-using-hmem SessionStart hook to Claude Code settings
-  hmem delete <ID>    Permanently delete an entry (curator use only, not synced)
-  hmem checkpoint     Extract knowledge from recent exchanges via Haiku (background)
-  hmem hook-startup   UserPromptSubmit hook — counter, checkpoint reminders (cross-platform)
-  hmem statusline     Generate statusline for Claude Code (reads JSON from stdin)
-  hmem version        Show version
-
-Environment variables (for serve):
-  HMEM_PATH          Path to .hmem file (optional, auto-detected)
-  HMEM_PROJECT_DIR   Directory for config + company.hmem (derived from HMEM_PATH)
-  HMEM_AGENT_ROLE    Role: worker | al | pl | ceo (default: worker)
-
-Non-interactive init flags:
-  --global             System-wide install (default)
-  --local              Project-local install
-  --tools claude-code  Comma-separated tool list (default: all detected)
-  --dir /path          Memory directory (default: ~/.hmem)
-  --no-example         Skip example memory installation
-
-Examples:
-  npx hmem init                          # Interactive installer
-  npx hmem init --global                 # Non-interactive, all detected tools
-  npx hmem init --global --tools claude-code  # Non-interactive, Claude Code only
-  npx hmem update-skills                 # Update skills after npm update
-  HMEM_PROJECT_DIR=. npx hmem serve      # Start server in current directory`);
+        printUsageTable();
         break;
 }
 export {};

package/dist/cli.js.map

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

package/dist/config/config.d.ts

@@ -0,0 +1,29 @@
+export interface SchemaSection {
+    name: string;
+    loadDepth: number;
+    defaultChildren?: string[];
+    /** Short convention describing what belongs in this section. Consumed by the
+     *  checkpoint agent and shown as placeholder body in empty sections. ~100 chars. */
+    description?: string;
+    /** What the checkpoint agent may write here: readonly | pointer | append (default). */
+    checkpointPolicy?: 'readonly' | 'pointer' | 'append';
+}
+export interface EntrySchema {
+    sections: SchemaSection[];
+    createLinkedO?: boolean;
+}
+export interface HmemConfig {
+    /** Per-prefix entry schemas. Keys are prefix letters ("P", "E", …). Generic. */
+    schemas?: Record<string, EntrySchema>;
+    prefixes?: Record<string, string>;
+    maxTitleChars?: number;
+    maxNodeChars?: number;
+}
+export declare const DEFAULT_PREFIXES: Record<string, string>;
+export declare const DEFAULT_CONFIG: HmemConfig;
+/**
+ * Load config from `<dir>/hmem.config.json`, deep-merging `schemas` over DEFAULT_CONFIG.
+ * Missing file → defaults. User-supplied schema keys win; default keys fill the rest.
+ * Malformed prefix keys (not 1–2 uppercase letters) are dropped.
+ */
+export declare function loadConfig(dir: string): HmemConfig;

package/dist/config/config.js

@@ -0,0 +1,123 @@
+/**
+ * hmem v2 — single config source.
+ *
+ * One discovery path only: `hmem.config.json` co-located with the `.hmem` store.
+ * This deliberately replaces v1's dual-config discovery (env-var path + cwd walk),
+ * which caused E0151 / L0180 (two configs disagreeing). User keys deep-merge over
+ * DEFAULT_CONFIG; defaults fill any gaps.
+ *
+ * The per-prefix schema model is generic: `schemas` is keyed by prefix letter, and
+ * every prefix is treated identically (no P-hardcoding — kills E0150). The P/E/H/I
+ * schemas below are ported verbatim from v1 `hmem-config.ts` (proven conventions).
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+export const DEFAULT_PREFIXES = {
+    P: 'Project',
+    L: 'Lesson',
+    T: 'Task',
+    E: 'Error',
+    D: 'Decision',
+    M: 'Milestone',
+    S: 'Skill',
+    N: 'Navigator',
+    H: 'Human',
+    R: 'Rule',
+    O: 'Original',
+    I: 'Infrastructure',
+    C: 'Convention',
+};
+export const DEFAULT_CONFIG = {
+    prefixes: { ...DEFAULT_PREFIXES },
+    maxTitleChars: 50,
+    maxNodeChars: 100_000,
+    schemas: {
+        P: {
+            sections: [
+                { name: 'Overview', loadDepth: 2, description: 'Current state / Goals / Architecture / Environment as L3 (≤4 lines each). L1 body: Name | Status | Tech | Repo' },
+                { name: 'Codebase', loadDepth: 1, description: "L3.0 = Pipeline (data flow overview, auto-created). L3.N = Module (title: filename, body: purpose). L4 = exported function/class (title: full signature, body: description + src/file.ts).", defaultChildren: ['Pipeline'] },
+                { name: 'Usage', loadDepth: 1, description: 'Installation, CLI/API, common workflows. No code — commands only' },
+                { name: 'Context', loadDepth: 1, description: 'Initiator, audience, business context, dependencies as L3' },
+                { name: 'Deployment', loadDepth: 1, description: 'Only if relevant. Server, build, CI/CD, release process' },
+                { name: 'Bugs', loadDepth: 1, description: 'Open first, fixed marked [✓] or moved to .History. L3 = bug title or pointer → E-entry.' },
+                { name: 'History', loadDepth: 0, description: 'Chronological session log. One-liner + pointer to O-entries. No copy-paste snapshots', defaultChildren: ['Tests', 'Code Style', 'Commits'] },
+                { name: 'Roadmap', loadDepth: 2, description: '5–8 milestones as L3, main tasks as L4, subtasks as L5. Non-project-specific work → T-entry' },
+                { name: 'Ideas', loadDepth: 1, description: 'Brainstorming. L3 = one-liner, L4 = details. Concrete ideas → promote to .Roadmap' },
+            ],
+        },
+        E: {
+            sections: [
+                { name: 'Reproduction', loadDepth: 1, description: 'Exact steps to trigger. Environment + minimal repro' },
+                { name: 'Analysis', loadDepth: 1, description: 'Root cause investigation. What was checked, what was found' },
+                { name: 'Possible Fixes', loadDepth: 1, description: 'Candidate approaches with tradeoffs' },
+                { name: 'Fixing Attempts', loadDepth: 1, description: "What was tried, what worked, what didn't" },
+                { name: 'Solution', loadDepth: 1, description: 'The fix that shipped. Commit hash + one-line summary' },
+                { name: 'Cause', loadDepth: 1, description: 'Why the bug existed — the underlying mistake or gap' },
+                { name: 'Key Learnings', loadDepth: 1, description: 'Generalizable insight for future work. Tag #open / #solved' },
+            ],
+        },
+        H: {
+            sections: [
+                { name: 'Identity', loadDepth: 1, description: 'Who the user is — name, contact, GitHub, roles, background. Flat L2 sub-nodes, one fact per node.' },
+                { name: 'Work Style', loadDepth: 1, description: 'How the user works — communication style, decision-making, iteration preferences, agent behavior expectations.' },
+                { name: 'Priorities', loadDepth: 1, description: 'Current goals, focus areas, what to optimize for.' },
+                { name: 'Preferences', loadDepth: 1, description: "Likes and dislikes — what works, what doesn't, what to avoid. Directly actionable for agent behavior." },
+            ],
+        },
+        I: {
+            sections: [
+                { name: 'Specs', loadDepth: 2, description: 'Hardware or service description. L1 body: Name | Status | Type | Host' },
+                { name: 'Access', loadDepth: 1, description: 'Connection methods, ports, credentials location (never store credentials inline)' },
+                { name: 'Services', loadDepth: 1, description: 'Running services / provided functions' },
+                { name: 'Apps', loadDepth: 1, description: 'Installed software and tools' },
+                { name: 'Config', loadDepth: 1, description: 'Important config file paths and settings' },
+                { name: 'Notes', loadDepth: 1, description: 'Caveats, quirks, known issues' },
+                { name: 'Rules', loadDepth: 1, description: 'Agent rules for working with this resource' },
+            ],
+        },
+    },
+};
+const PREFIX_KEY = /^[A-Z]{1,2}$/;
+/**
+ * Load config from `<dir>/hmem.config.json`, deep-merging `schemas` over DEFAULT_CONFIG.
+ * Missing file → defaults. User-supplied schema keys win; default keys fill the rest.
+ * Malformed prefix keys (not 1–2 uppercase letters) are dropped.
+ */
+export function loadConfig(dir) {
+    const merged = {
+        ...DEFAULT_CONFIG,
+        prefixes: { ...DEFAULT_CONFIG.prefixes },
+        schemas: { ...DEFAULT_CONFIG.schemas },
+    };
+    const file = join(dir, 'hmem.config.json');
+    if (!existsSync(file))
+        return merged;
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch {
+        return merged; // unreadable/invalid JSON → fall back to defaults, never crash
+    }
+    if (!raw || typeof raw !== 'object')
+        return merged;
+    const user = raw;
+    if (typeof user.maxTitleChars === 'number')
+        merged.maxTitleChars = user.maxTitleChars;
+    if (typeof user.maxNodeChars === 'number')
+        merged.maxNodeChars = user.maxNodeChars;
+    if (user.prefixes && typeof user.prefixes === 'object') {
+        merged.prefixes = { ...merged.prefixes, ...user.prefixes };
+    }
+    if (user.schemas && typeof user.schemas === 'object' && !Array.isArray(user.schemas)) {
+        for (const [prefix, schema] of Object.entries(user.schemas)) {
+            if (!PREFIX_KEY.test(prefix))
+                continue;
+            if (!schema || typeof schema !== 'object' || !Array.isArray(schema.sections))
+                continue;
+            merged.schemas[prefix] = schema;
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

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

package/dist/diagnostics.js

@@ -5,14 +5,9 @@
  * Rotated to .1 when the file exceeds 1 MB.
  */
 import fs from "node:fs";
-import os from "node:os";
 import path from "node:path";
+import { safeHomedir } from "./utils.js";
 const MAX_BYTES = 1024 * 1024;
-function safeHomedir() {
-    if (process.platform === "win32" && process.env.USERPROFILE)
-        return process.env.USERPROFILE;
-    return process.env.HOME || os.homedir();
-}
 export function diagnosticsLogPath() {
     return path.join(safeHomedir(), ".hmem", "diagnostics.log");
 }

package/dist/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9B,SAAS,WAAW;IAClB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC5F,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAC9D,CAAC;AAcD,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,IAAI,GAAG,SAAS,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;gBAC/B,IAAI,CAAC;oBAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBACtD,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;QAC/E,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;AACH,CAAC"}
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9B,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAC9D,CAAC;AAcD,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,IAAI,GAAG,SAAS,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;gBAC/B,IAAI,CAAC;oBAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBACtD,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;QAC/E,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;AACH,CAAC"}