hmem-mcp 1.1.0

package/dist/cli-init.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Script:    cli.ts
+ * Purpose:   CLI entry point for hmem (serve, init)
+ * Author:    DEVELOPER
+ * Created:   2026-02-21
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+/**
+ * Script:    cli.ts
+ * Purpose:   CLI entry point for hmem (serve, init)
+ * Author:    DEVELOPER
+ * Created:   2026-02-21
+ */
+const command = process.argv[2];
+switch (command) {
+    case "serve":
+        await import("./mcp-server.js");
+        break;
+    case "init": {
+        const { runInit } = await import("./cli-init.js");
+        await runInit();
+        break;
+    }
+    case "version":
+    case "--version":
+    case "-v":
+        console.log("hmem 1.1.0");
+        break;
+    default:
+        console.log(`hmem — Humanlike Memory for AI Agents
+
+Usage:
+  hmem serve       Start the MCP server (stdio transport)
+  hmem init        Interactive installer for AI coding tools
+  hmem version     Show version
+
+Environment variables (for serve):
+  HMEM_PROJECT_DIR   Root directory for .hmem files (required)
+  HMEM_AGENT_ID      Agent identifier (optional)
+  HMEM_AGENT_ROLE    Role: worker | al | pl | ceo (default: worker)
+
+Examples:
+  npx hmem init                          # Configure your AI tools
+  HMEM_PROJECT_DIR=. npx hmem serve      # Start server in current directory`);
+        break;
+}
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhC,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,OAAO;QACV,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAChC,MAAM;IAER,KAAK,MAAM,CAAC,CAAC,CAAC;QACZ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAClD,MAAM,OAAO,EAAE,CAAC;QAChB,MAAM;IACR,CAAC;IAED,KAAK,SAAS,CAAC;IACf,KAAK,WAAW,CAAC;IACjB,KAAK,IAAI;QACP,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,MAAM;IAER;QACE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;6EAc6D,CAAC,CAAC;QAC3E,MAAM;AACV,CAAC"}

package/dist/config.js

@@ -0,0 +1,88 @@
+import fs from "node:fs";
+import path from "node:path";
+import { DEFAULT_CONFIG } from "./types.js";
+/** Loaded council.config.json (null if not found) */
+let _councilConfig = null;
+export function getCouncilConfig() {
+    return _councilConfig;
+}
+export function loadConfig(projectDir) {
+    const resolved = path.resolve(projectDir);
+    // Try to load council.config.json
+    const configPath = path.join(resolved, "council.config.json");
+    if (fs.existsSync(configPath)) {
+        try {
+            _councilConfig = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        }
+        catch {
+            // Ignore parse errors, use defaults
+        }
+    }
+    const orch = _councilConfig?.orchestrator;
+    const retry = _councilConfig?.retry;
+    return {
+        ...DEFAULT_CONFIG,
+        projectDir: resolved,
+        logJsonMode: process.env.COUNCIL_LOG_JSON === "true" || orch?.log_json_mode === true,
+        pollMs: orch?.poll_ms ?? DEFAULT_CONFIG.pollMs,
+        ackTimeoutMs: orch?.ack_timeout_ms ?? DEFAULT_CONFIG.ackTimeoutMs,
+        execWarningMs: orch?.exec_warning_ms ?? DEFAULT_CONFIG.execWarningMs,
+        zombieKillMs: orch?.zombie_kill_ms ?? DEFAULT_CONFIG.zombieKillMs,
+        maxSpawnDepth: orch?.max_spawn_depth ?? DEFAULT_CONFIG.maxSpawnDepth,
+        maxSpawnsPerAgent: orch?.max_spawns_per_agent ?? DEFAULT_CONFIG.maxSpawnsPerAgent,
+        logMaxBytes: orch?.log_max_bytes ?? DEFAULT_CONFIG.logMaxBytes,
+        archiveDays: orch?.archive_days ?? DEFAULT_CONFIG.archiveDays,
+        autoSynthesize: orch?.auto_synthesize ?? DEFAULT_CONFIG.autoSynthesize,
+        synthesizeTemplate: orch?.synthesize_template ?? DEFAULT_CONFIG.synthesizeTemplate,
+        logLevel: process.env.COUNCIL_LOG_LEVEL || orch?.log_level || DEFAULT_CONFIG.logLevel,
+        enableSurveys: orch?.enable_surveys ?? DEFAULT_CONFIG.enableSurveys,
+        surveyTemplate: orch?.survey_template ?? DEFAULT_CONFIG.surveyTemplate,
+        maxConcurrentAgents: orch?.max_concurrent_agents ?? DEFAULT_CONFIG.maxConcurrentAgents,
+        maxConcurrentOpencode: orch?.max_concurrent_opencode ?? DEFAULT_CONFIG.maxConcurrentOpencode,
+        loadThrottleAvg1: orch?.load_throttle_avg1 ?? DEFAULT_CONFIG.loadThrottleAvg1,
+        loadKillAvg1: orch?.load_kill_avg1 ?? DEFAULT_CONFIG.loadKillAvg1,
+        workerModelBlacklist: orch?.worker_model_blacklist ?? DEFAULT_CONFIG.workerModelBlacklist,
+        retry: {
+            maxRetries: retry?.max_retries ?? DEFAULT_CONFIG.retry.maxRetries,
+            retryDelayMs: retry?.retry_delay_ms ?? DEFAULT_CONFIG.retry.retryDelayMs,
+            backoffMultiplier: retry?.backoff_multiplier ?? DEFAULT_CONFIG.retry.backoffMultiplier,
+        },
+        scheduledAgents: (_councilConfig?.scheduled_agents || []).map(sa => ({
+            agent_id: sa.agent_id || "UNKNOWN",
+            template: sa.template || sa.agent_id || "UNKNOWN",
+            enabled: sa.enabled ?? false,
+            interval_hours: sa.interval_hours ?? 0,
+            day_of_week: sa.day_of_week ?? -1,
+            preferred_hour: sa.preferred_hour ?? 3,
+            on_project_complete: sa.on_project_complete ?? false,
+            command: sa.command || "",
+            max_load_avg1: sa.max_load_avg1 ?? 0,
+            max_failures: sa.max_failures ?? 3,
+        })),
+    };
+}
+export function loadCatalog(projectDir) {
+    const catalogPath = path.join(projectDir, "AGENT_CATALOG.json");
+    if (!fs.existsSync(catalogPath)) {
+        throw new Error(`AGENT_CATALOG.json not found: ${catalogPath}`);
+    }
+    const raw = JSON.parse(fs.readFileSync(catalogPath, "utf-8"));
+    const catalog = {};
+    for (const [key, value] of Object.entries(raw)) {
+        // Skip metadata fields (_version, _description, _category*)
+        if (key.startsWith("_"))
+            continue;
+        catalog[key] = value;
+    }
+    return catalog;
+}
+export function ensureDirectories(projectDir) {
+    const dirs = [
+        path.join(projectDir, "orchestrator", "logs"),
+    ];
+    for (const dir of dirs) {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+}

package/dist/hmem-config.d.ts

@@ -0,0 +1,87 @@
+/**
+ * hmem configuration — loaded from hmem.config.json in the project directory.
+ * All values have sensible defaults; the config file is optional.
+ *
+ * Place hmem.config.json in HMEM_PROJECT_DIR (next to your .hmem files).
+ *
+ * ## Character limits
+ *
+ * Option A — just set the two endpoints, levels in between are interpolated linearly:
+ * {
+ *   "maxL1Chars": 500,
+ *   "maxLnChars": 50000
+ * }
+ *
+ * Option B — specify all levels explicitly:
+ * {
+ *   "maxCharsPerLevel": [500, 5000, 15000, 30000, 50000]
+ * }
+ *
+ * Option A and B can be combined; explicit array takes precedence.
+ *
+ * ## Recency gradient (recentDepthTiers)
+ *
+ * Controls how many child levels are inlined for the N most recent entries
+ * in a default read() call. Each tier adds depth for the freshest entries:
+ *
+ * {
+ *   "recentDepthTiers": [
+ *     { "count": 3,  "depth": 3 },   // last 3 entries  → L1 + L2 + L3
+ *     { "count": 10, "depth": 2 }    // last 10 entries → L1 + L2
+ *   ]
+ * }
+ *
+ * Tiers are evaluated per-entry: the highest applicable depth wins.
+ * Backward compat: legacy "recentChildrenCount": N is treated as
+ * [{ "count": N, "depth": 2 }].
+ */
+export interface DepthTier {
+    /** How many of the most recent entries this tier applies to */
+    count: number;
+    /** Max depth to inline (2 = L2, 3 = L2+L3, etc.) */
+    depth: number;
+}
+export interface HmemConfig {
+    /**
+     * Max characters per level, indexed by depth (0=L1, 1=L2, …, maxDepth-1=Ln).
+     * Computed from maxL1Chars + maxLnChars via linear interpolation if not set explicitly.
+     */
+    maxCharsPerLevel: number[];
+    /** Max tree depth (1 = L1 only, 5 = full depth). Default: 5 */
+    maxDepth: number;
+    /**
+     * Recency gradient: each tier defines how deep to inline children for the N most recent entries.
+     * Tiers are cumulative — the highest applicable depth wins for each entry position.
+     * Default: last 10 entries show L2, last 3 entries also show L3.
+     */
+    recentDepthTiers: DepthTier[];
+    /** Max entries returned by a default bulk read(). Default: 100 */
+    defaultReadLimit: number;
+    /**
+     * Memory category prefixes. Keys are single uppercase letters, values are human-readable names.
+     * Default: P=Project, L=Lesson, T=Task, E=Error, D=Decision, M=Milestone, S=Skill, F=Favorite.
+     * Users can add custom prefixes (e.g. "R": "Research") in hmem.config.json.
+     */
+    prefixes: Record<string, string>;
+}
+export declare const DEFAULT_PREFIXES: Record<string, string>;
+export declare const DEFAULT_CONFIG: HmemConfig;
+/**
+ * Format prefix map as "P=Project, L=Lesson, ..." for tool descriptions.
+ */
+export declare function formatPrefixList(prefixes: Record<string, string>): string;
+/**
+ * Compute a linearly interpolated char-limit array between l1 and ln for `depth` levels.
+ * depth=1 → [l1], depth=2 → [l1, ln], depth=5 → [l1, …, ln]
+ */
+export declare function linearLimits(l1: number, ln: number, depth: number): number[];
+/**
+ * Resolve the inline depth for the entry at position `i` (0 = most recent)
+ * given the configured tiers. Returns 1 if no tier applies (L1 only).
+ */
+export declare function resolveDepthForPosition(i: number, tiers: DepthTier[]): number;
+/**
+ * Load hmem.config.json from projectDir.
+ * Unknown keys are ignored. Missing keys fall back to defaults.
+ */
+export declare function loadHmemConfig(projectDir: string): HmemConfig;

package/dist/hmem-config.js

@@ -0,0 +1,120 @@
+import fs from "node:fs";
+import path from "node:path";
+export const DEFAULT_PREFIXES = {
+    P: "Project",
+    L: "Lesson",
+    T: "Task",
+    E: "Error",
+    D: "Decision",
+    M: "Milestone",
+    S: "Skill",
+    F: "Favorite",
+};
+export const DEFAULT_CONFIG = {
+    maxCharsPerLevel: [120, 2_500, 10_000, 25_000, 50_000],
+    maxDepth: 5,
+    recentDepthTiers: [
+        { count: 10, depth: 2 },
+        { count: 3, depth: 3 },
+    ],
+    defaultReadLimit: 100,
+    prefixes: { ...DEFAULT_PREFIXES },
+};
+/**
+ * Format prefix map as "P=Project, L=Lesson, ..." for tool descriptions.
+ */
+export function formatPrefixList(prefixes) {
+    return Object.entries(prefixes).map(([k, v]) => `${k}=${v}`).join(", ");
+}
+/**
+ * Compute a linearly interpolated char-limit array between l1 and ln for `depth` levels.
+ * depth=1 → [l1], depth=2 → [l1, ln], depth=5 → [l1, …, ln]
+ */
+export function linearLimits(l1, ln, depth) {
+    if (depth <= 1)
+        return [l1];
+    return Array.from({ length: depth }, (_, i) => Math.round(l1 + (ln - l1) * (i / (depth - 1))));
+}
+/**
+ * Resolve the inline depth for the entry at position `i` (0 = most recent)
+ * given the configured tiers. Returns 1 if no tier applies (L1 only).
+ */
+export function resolveDepthForPosition(i, tiers) {
+    let maxDepth = 1;
+    for (const tier of tiers) {
+        if (i < tier.count && tier.depth > maxDepth) {
+            maxDepth = tier.depth;
+        }
+    }
+    return maxDepth;
+}
+/**
+ * Load hmem.config.json from projectDir.
+ * Unknown keys are ignored. Missing keys fall back to defaults.
+ */
+export function loadHmemConfig(projectDir) {
+    const configPath = path.join(projectDir, "hmem.config.json");
+    if (!fs.existsSync(configPath)) {
+        return { ...DEFAULT_CONFIG, recentDepthTiers: [...DEFAULT_CONFIG.recentDepthTiers], prefixes: { ...DEFAULT_PREFIXES } };
+    }
+    try {
+        const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        const cfg = {
+            ...DEFAULT_CONFIG,
+            recentDepthTiers: [...DEFAULT_CONFIG.recentDepthTiers],
+        };
+        if (typeof raw.maxDepth === "number" && raw.maxDepth >= 1 && raw.maxDepth <= 10)
+            cfg.maxDepth = raw.maxDepth;
+        if (typeof raw.defaultReadLimit === "number" && raw.defaultReadLimit > 0)
+            cfg.defaultReadLimit = raw.defaultReadLimit;
+        // Recency tiers: explicit array > legacy recentChildrenCount > default
+        if (Array.isArray(raw.recentDepthTiers)) {
+            const tiers = raw.recentDepthTiers.filter((t) => typeof t.count === "number" &&
+                typeof t.depth === "number" &&
+                t.count > 0 &&
+                t.depth >= 1);
+            if (tiers.length > 0)
+                cfg.recentDepthTiers = tiers;
+        }
+        else if (typeof raw.recentChildrenCount === "number" && raw.recentChildrenCount >= 0) {
+            // Backward compat: treat as single tier with depth 2
+            cfg.recentDepthTiers = raw.recentChildrenCount > 0
+                ? [{ count: raw.recentChildrenCount, depth: 2 }]
+                : [];
+        }
+        // Prefixes: merge user-defined with defaults (user can override or add)
+        if (raw.prefixes && typeof raw.prefixes === "object" && !Array.isArray(raw.prefixes)) {
+            const merged = { ...DEFAULT_PREFIXES };
+            for (const [key, val] of Object.entries(raw.prefixes)) {
+                if (typeof key === "string" && /^[A-Z]$/.test(key) && typeof val === "string" && val.length > 0) {
+                    merged[key] = val;
+                }
+            }
+            cfg.prefixes = merged;
+        }
+        // Resolve char limits: explicit array > linear endpoints > default
+        if (Array.isArray(raw.maxCharsPerLevel) && raw.maxCharsPerLevel.length >= 1) {
+            const levels = raw.maxCharsPerLevel;
+            if (levels.every((n) => typeof n === "number" && n > 0)) {
+                const padded = [...levels];
+                while (padded.length < cfg.maxDepth)
+                    padded.push(padded[padded.length - 1]);
+                cfg.maxCharsPerLevel = padded.slice(0, cfg.maxDepth);
+            }
+        }
+        else if (typeof raw.maxL1Chars === "number" || typeof raw.maxLnChars === "number") {
+            const l1 = typeof raw.maxL1Chars === "number" ? raw.maxL1Chars : DEFAULT_CONFIG.maxCharsPerLevel[0];
+            const ln = typeof raw.maxLnChars === "number" ? raw.maxLnChars : DEFAULT_CONFIG.maxCharsPerLevel[DEFAULT_CONFIG.maxCharsPerLevel.length - 1];
+            cfg.maxCharsPerLevel = linearLimits(l1, ln, cfg.maxDepth);
+        }
+        else {
+            cfg.maxCharsPerLevel = linearLimits(DEFAULT_CONFIG.maxCharsPerLevel[0], DEFAULT_CONFIG.maxCharsPerLevel[DEFAULT_CONFIG.maxCharsPerLevel.length - 1], cfg.maxDepth);
+        }
+        return cfg;
+    }
+    catch (e) {
+        console.error(`[hmem] Failed to parse hmem.config.json: ${e}. Using defaults.`);
+        return { ...DEFAULT_CONFIG, recentDepthTiers: [...DEFAULT_CONFIG.recentDepthTiers], prefixes: { ...DEFAULT_PREFIXES } };
+    }
+}
+//# sourceMappingURL=hmem-config.js.map

package/dist/hmem-config.js.map

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

package/dist/hmem-store.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Humanlike Memory Store (.hmem)
+ *
+ * SQLite-based long-term memory for agents with true tree structure.
+ * L1 summaries live in the `memories` table (injected at startup).
+ * L2+ nodes live in `memory_nodes` — each node has its own compound ID
+ * (e.g., E0006.1, E0006.1.2) and is individually addressable.
+ *
+ * Two store types:
+ *   - Personal: per-agent memory (Agents/THOR/THOR.hmem)
+ *   - Company:  shared knowledge base (FIRMENWISSEN.hmem) with role-based access
+ *
+ * ID format:
+ *   Root entries: PREFIX + zero-padded sequence (e.g., P0001, L0023, T0042)
+ *   Sub-nodes:    root_id + "." + sibling_seq, recursively (e.g., E0006.1, E0006.1.2)
+ *
+ * Prefixes: P=Project, L=Lesson, T=Task, E=Error, D=Decision, M=Milestone, F=Favorite, S=Skill
+ *
+ * Role hierarchy: worker < al < pl < ceo
+ * Each entry has a min_role — agents only see entries at or below their clearance.
+ *
+ * read_memory(id) semantics:
+ *   Always returns the node + its DIRECT children only.
+ *   To go deeper, call read_memory(id=child_id).
+ *   depth parameter is IGNORED for ID-based queries.
+ */
+import type { HmemConfig } from "./hmem-config.js";
+export type AgentRole = "worker" | "al" | "pl" | "ceo";
+export interface MemoryEntry {
+    id: string;
+    prefix: string;
+    seq: number;
+    created_at: string;
+    level_1: string;
+    level_2: string | null;
+    level_3: string | null;
+    level_4: string | null;
+    level_5: string | null;
+    access_count: number;
+    last_accessed: string | null;
+    links: string[] | null;
+    min_role: AgentRole;
+    children?: MemoryNode[];
+}
+export interface MemoryNode {
+    id: string;
+    parent_id: string;
+    root_id: string;
+    depth: number;
+    seq: number;
+    content: string;
+    created_at: string;
+    access_count: number;
+    last_accessed: string | null;
+    child_count?: number;
+    children?: MemoryNode[];
+}
+export interface ReadOptions {
+    id?: string;
+    depth?: number;
+    prefix?: string;
+    after?: string;
+    before?: string;
+    search?: string;
+    limit?: number;
+    agentRole?: AgentRole;
+    recentDepthTiers?: import("./hmem-config.js").DepthTier[];
+}
+export interface WriteResult {
+    id: string;
+    timestamp: string;
+}
+export declare class HmemStore {
+    private db;
+    private readonly dbPath;
+    private readonly cfg;
+    /** True if integrity_check found errors on open (read-only mode recommended). */
+    readonly corrupted: boolean;
+    constructor(hmemPath: string, config?: HmemConfig);
+    /**
+     * Write a new memory entry.
+     * Content uses tab indentation to define the tree:
+     *   "Project X: built a dashboard\n\tMy role was frontend\n\t\tUsed React + Vite"
+     * L1 (no tabs) → memories.level_1
+     * Each indented line → its own memory_nodes row with compound ID
+     * Multiple lines at the same indent depth → siblings (new capability)
+     */
+    write(prefix: string, content: string, links?: string[], minRole?: AgentRole): WriteResult;
+    /**
+     * Read memories with flexible querying.
+     *
+     * For ID-based queries: always returns the node + its DIRECT children.
+     * depth parameter is ignored for ID queries (one level at a time).
+     *
+     * For bulk queries: returns L1 summaries (depth=1 default).
+     */
+    read(opts?: ReadOptions): MemoryEntry[];
+    /**
+     * Get all Level 1 entries for injection at agent startup.
+     * Does NOT bump access_count (routine injection).
+     */
+    getLevel1All(agentRole?: AgentRole): string;
+    /**
+     * Export entire memory to Markdown for git tracking.
+     */
+    exportMarkdown(): string;
+    /**
+     * Get statistics about the memory store.
+     */
+    stats(): {
+        total: number;
+        byPrefix: Record<string, number>;
+    };
+    /**
+     * Update specific fields of an existing root entry (curator use only).
+     */
+    update(id: string, fields: Partial<Pick<MemoryEntry, "level_1" | "level_2" | "level_3" | "level_4" | "level_5" | "links" | "min_role">>): boolean;
+    /**
+     * Delete an entry by ID (curator use only).
+     * Also deletes all associated memory_nodes.
+     */
+    delete(id: string): boolean;
+    close(): void;
+    private migrate;
+    /**
+     * One-time migration: move level_2..level_5 data to memory_nodes tree.
+     * Idempotent — tracked via schema_version table.
+     */
+    private migrateToTree;
+    private buildRoleFilter;
+    private nextSeq;
+    private bumpAccess;
+    private bumpNodeAccess;
+    /** Fetch direct children of a node (root or compound), including their grandchild counts. */
+    private fetchChildren;
+    /**
+     * Fetch children recursively up to maxDepth.
+     * currentDepth: the depth level of the children being fetched (2 = L2, 3 = L3, …)
+     * maxDepth: stop recursing when currentDepth > maxDepth
+     */
+    private fetchChildrenDeep;
+    private rowToNode;
+    private rowToEntry;
+    /**
+     * Wrap a MemoryNode as a MemoryEntry for uniform API return.
+     * The formatter detects node entries by checking e.id.includes(".").
+     * level_1 is repurposed to carry the node content.
+     */
+    private nodeToEntry;
+    /**
+     * Parse tab-indented content into L1 text + a list of tree nodes.
+     *
+     * Algorithm:
+     *   - seqAtParent: Map<parentId, number> — sibling counter per parent
+     *   - lastIdAtDepth: Map<depth, nodeId>  — last-written node id at each depth
+     *
+     * Each indented line at depth D:
+     *   parent = (D == 2) ? rootId : lastIdAtDepth[D-1]
+     *   seq    = ++seqAtParent[parent]
+     *   id     = parent + "." + seq
+     *
+     * @param content  Tab-indented content string
+     * @param rootId   The root entry ID (e.g. "E0006") — used to build compound IDs
+     */
+    private parseTree;
+}
+export declare function resolveHmemPath(projectDir: string, templateName: string): string;
+/**
+ * Open (or create) an HmemStore for an agent's personal memory.
+ */
+export declare function openAgentMemory(projectDir: string, templateName: string, config?: HmemConfig): HmemStore;
+/**
+ * Open (or create) the shared company knowledge store (FIRMENWISSEN.hmem).
+ */
+export declare function openCompanyMemory(projectDir: string, config?: HmemConfig): HmemStore;