cortex-engine 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright 2026 Idapixl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,154 @@
+# cortex-engine
+
+Cognitive engine for AI agents — semantic memory, observations, embeddings, dream consolidation. Cloud Run service + MCP tools.
+
+## What It Does
+
+`cortex-engine` is a portable TypeScript service that gives AI agents persistent, structured memory. It handles:
+
+- **Semantic memory graph** — store and retrieve observations as interconnected nodes
+- **Embeddings** — vector representations via pluggable providers (OpenAI, Vertex AI, Anthropic)
+- **Dream consolidation** — background process that reinforces and connects memories over time
+- **FSRS scheduling** — spaced-repetition scheduling for memory retention
+- **MCP server** — exposes cognitive tools (`query`, `observe`, `believe`, `wander`, etc.) over the Model Context Protocol
+
+Runs as a standalone Cloud Run service or embedded in any Node.js environment.
+
+## Architecture
+
+| Module | Role |
+|--------|------|
+| `core` | Foundational types, config, and shared utilities |
+| `engines` | Cognitive processing: memory consolidation, FSRS, graph traversal |
+| `stores` | Persistence layer — SQLite (local) and Firestore (cloud) |
+| `mcp` | MCP server and tool definitions |
+| `cognitive` | Higher-order cognitive operations (dream, wander, validate) |
+| `triggers` | Scheduled and event-driven triggers |
+| `bridges` | Adapters for external services and APIs |
+| `providers` | Embedding provider implementations |
+| `bin` | Entry points: `serve.js` (HTTP + MCP), `cli.js` (admin CLI) |
+
+## Getting Started
+
+```bash
+git clone https://github.com/fozikio/cortex-engine.git
+cd cortex-engine
+npm install
+npm run build
+npm run serve
+```
+
+Requires Node.js 20 or later.
+
+### Agent-First Setup
+
+The fastest path: open an AI agent in an empty directory and say *"set up a cortex workspace."* The agent runs `npx cortex-kit init`, reads the generated files, and is immediately productive. See **[docs/agent-first-setup.md](docs/agent-first-setup.md)** for the full guide.
+
+### Development
+
+```bash
+npm run dev       # tsc --watch
+npm test          # vitest run
+npm run test:watch
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CORTEX_API_TOKEN` | Yes | Authentication token for the HTTP API |
+
+Additional variables are required depending on which providers you enable (Firestore, Vertex AI, OpenAI, etc.). See `docs/` for provider-specific configuration.
+
+## Hooks, Skills & Agents
+
+`cortex-kit init` automatically installs hooks, skills, and agent definitions from the `cortex-kit.json` manifest into the target workspace. These live in `.claude/hooks/` and `.claude/skills/` after init.
+
+### Hooks
+
+Hooks are shell scripts that integrate into Claude Code's event system. They fire automatically — no agent action required.
+
+| Hook | Event | What It Does | Requires |
+|------|-------|-------------|----------|
+| `cognitive-grounding.sh` | `UserPromptSubmit` | Nudges the agent to call `query()` before evaluation, design, review, or creation work | — |
+| `observe-first.sh` | `PreToolUse` (Write/Edit) | Warns if writing to Mind/, Journal/, or memory/ without calling `observe()` or `query()` first | — |
+| `cortex-telemetry.sh` | `PostToolUse` | Tracks cortex retrieval calls and detects retries (2 calls within 60s), sends feedback to the cortex API | `CORTEX_API_URL`, `CORTEX_API_TOKEN` (optional) |
+| `session-lifecycle.sh` | `SessionStart` | Resets session-scoped state files (telemetry log, push-gate state) | — |
+| `project-board-gate.sh` | `PreToolUse` (Bash) | Blocks `git push` to tracked repos until board updates and/or ops logging are done | `.claude/state/project-boards.json` config |
+
+**To disable a hook:** Delete the `.sh` file from `.claude/hooks/`. No other config changes needed.
+
+**To customize project-board-gate:** Create `.claude/state/project-boards.json` with your repos and requirements:
+
+```json
+{
+  "enabled": true,
+  "strength": "block",
+  "on_push": {
+    "require_board_update": true,
+    "require_ops_log": false
+  },
+  "repos": {
+    "my-repo": {
+      "board_number": 5,
+      "board_owner": "my-org",
+      "description": "My project"
+    }
+  }
+}
+```
+
+Set `"strength": "off"` to disable the gate without removing the hook.
+
+### Skills
+
+Skills are invocable workflows that agents can use via `/skill-name`.
+
+| Skill | When to Use | What It Provides |
+|-------|-------------|-----------------|
+| `cortex-query` | Before evaluation, review, design, or creation work | Best practices for querying cortex — specificity, keyword mode, neighbor exploration, anti-patterns |
+| `cortex-review` | When reviewing code, designs, or proposals | A structured review workflow that grounds feedback in cortex memory, with a standard output format |
+
+### Hookify Rules
+
+The manifest declares hookify rules — declarative hook patterns managed by the [hookify](https://github.com/fozikio/hookify) tool. These are **not** auto-installed by `cortex-kit init` (hookify needs its own setup). Init prints a reminder:
+
+```
+Recommended hookify rules available. Run `cortex-kit install-rules` to install.
+```
+
+| Rule | Purpose |
+|------|---------|
+| `cognitive-grounding` | Declarative version of the cognitive-grounding hook |
+| `observe-first` | Declarative version of the observe-first hook |
+| `note-about-doing` | Reminds agents to observe what they're doing as they work |
+
+### Agents
+
+| Agent | Description |
+|-------|-------------|
+| `cortex-researcher` | Deep research agent that queries cortex before external sources, observes novel findings back into memory |
+
+### How Auto-Install Works
+
+1. `cortex-kit init` reads `cortex-kit.json` from the package root
+2. For each hook in `contents.hooks`: copies `hooks/{name}.sh` into `{workspace}/.claude/hooks/`
+3. For each skill in `contents.skills`: copies `skills/{name}/` directory into `{workspace}/.claude/skills/`
+4. If `contents.hookify_rules` is non-empty: prints a message (no interactive prompts)
+5. Missing source files are skipped with a warning — init never fails due to missing assets
+
+### Overriding Cortex Hooks
+
+To override a hook's behavior without removing it:
+1. Edit the `.sh` file in your workspace's `.claude/hooks/` directly — it's a plain copy, not a symlink
+2. Re-running `cortex-kit init --here` will overwrite your changes (it copies fresh from the package)
+3. To preserve customizations across re-init, rename the hook file (hooks are matched by filename in Claude Code settings, not by the cortex-kit manifest)
+
+## Related Projects
+
+- [idapixl/idapixl-cortex](https://github.com/idapixl/idapixl-cortex) — private production instance of cortex-engine, deployed on Cloud Run
+- [fozikio/dashboard](https://github.com/fozikio/dashboard) — agent workspace dashboard backed by cortex-engine
+
+## License
+
+MIT — see [LICENSE](LICENSE)

package/dist/bin/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * cortex-kit CLI — setup and management for cortex-engine agents.
+ *
+ * Commands:
+ *   init <name>     Scaffold a new agent workspace
+ *   serve            Start the MCP server
+ *   config           View or edit configuration
+ *   digest           Process documents through cortex
+ *   help             Show help
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/bin/cli.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+/**
+ * cortex-kit CLI — setup and management for cortex-engine agents.
+ *
+ * Commands:
+ *   init <name>     Scaffold a new agent workspace
+ *   serve            Start the MCP server
+ *   config           View or edit configuration
+ *   digest           Process documents through cortex
+ *   help             Show help
+ */
+import { loadConfig } from './config-loader.js';
+import { runInit } from './init.js';
+import { runDigest } from './digest-cmd.js';
+import { runConfig } from './config-cmd.js';
+import { startServer } from '../mcp/server.js';
+// ─── Help ──────────────────────────────────────────────────────────────────
+function printHelp() {
+    console.error(`cortex-kit — setup and management for cortex-engine agents
+
+Usage:
+  cortex-kit <command> [options]
+
+Commands:
+  init <name>   Scaffold a new agent workspace
+  serve          Start the MCP server (stdio)
+  config         View or edit configuration
+  digest         Process documents through cortex
+  help           Show this help message
+
+Init options:
+  --store sqlite|firestore     Storage backend (default: sqlite)
+  --embed ollama|vertex|openai   Embedding provider (default: ollama)
+  --llm ollama|gemini|anthropic|openai   LLM provider (default: ollama)
+  --namespace <name>           Default namespace name (default: default)
+  --here                       Scaffold into current directory
+  --obsidian                   Create .obsidian/ structure
+
+Examples:
+  cortex-kit init my-agent
+  cortex-kit init my-agent --store firestore --embed vertex --llm gemini
+  cortex-kit init --here --obsidian
+  cortex-kit serve
+  cortex-kit config
+  cortex-kit config --store sqlite --embed ollama
+  cortex-kit digest path/to/file.md
+  cortex-kit digest --pending
+`);
+}
+// ─── Dispatch ──────────────────────────────────────────────────────────────
+const [, , command, ...rest] = process.argv;
+switch (command) {
+    case 'init':
+        runInit(rest);
+        break;
+    case 'serve':
+        (async () => {
+            const config = loadConfig();
+            await startServer(config);
+        })().catch(err => {
+            console.error('[cortex-kit] Fatal error:', err);
+            process.exit(1);
+        });
+        break;
+    case 'config':
+        runConfig(rest).catch(err => {
+            console.error('[cortex-kit] Config error:', err);
+            process.exit(1);
+        });
+        break;
+    case 'digest':
+        runDigest(rest).catch(err => {
+            console.error('[cortex-kit] Digest error:', err);
+            process.exit(1);
+        });
+        break;
+    case 'help':
+    case '--help':
+    case '-h':
+        printHelp();
+        break;
+    case undefined:
+        console.error('[cortex-kit] No command provided.\n');
+        printHelp();
+        process.exit(1);
+        break;
+    default:
+        console.error(`[cortex-kit] Unknown command: ${command}\n`);
+        printHelp();
+        process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,8EAA8E;AAE9E,SAAS,SAAS;IAChB,OAAO,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Bf,CAAC,CAAC;AACH,CAAC;AAED,8EAA8E;AAE9E,MAAM,CAAC,EAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AAE3C,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,MAAM;QACT,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,MAAM;IAER,KAAK,OAAO;QACV,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;YAC5B,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,MAAM;IAER,KAAK,QAAQ;QACX,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YAC1B,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,MAAM;IAER,KAAK,QAAQ;QACX,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YAC1B,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,MAAM;IAER,KAAK,MAAM,CAAC;IACZ,KAAK,QAAQ,CAAC;IACd,KAAK,IAAI;QACP,SAAS,EAAE,CAAC;QACZ,MAAM;IAER,KAAK,SAAS;QACZ,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,MAAM;IAER;QACE,OAAO,CAAC,KAAK,CAAC,iCAAiC,OAAO,IAAI,CAAC,CAAC;QAC5D,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/bin/config-cmd.d.ts

@@ -0,0 +1,12 @@
+/**
+ * config-cmd.ts — cortex-kit config command handler.
+ *
+ * Usage:
+ *   cortex-kit config                     Show current config
+ *   cortex-kit config --store sqlite      Set storage backend
+ *   cortex-kit config --embed ollama      Set embedding provider
+ *   cortex-kit config --llm ollama        Set LLM provider
+ *   cortex-kit config --path              Show config file path
+ */
+export declare function runConfig(args: string[]): Promise<void>;
+//# sourceMappingURL=config-cmd.d.ts.map

package/dist/bin/config-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-cmd.d.ts","sourceRoot":"","sources":["../../src/bin/config-cmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgKH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD7D"}

package/dist/bin/config-cmd.js

@@ -0,0 +1,184 @@
+/**
+ * config-cmd.ts — cortex-kit config command handler.
+ *
+ * Usage:
+ *   cortex-kit config                     Show current config
+ *   cortex-kit config --store sqlite      Set storage backend
+ *   cortex-kit config --embed ollama      Set embedding provider
+ *   cortex-kit config --llm ollama        Set LLM provider
+ *   cortex-kit config --path              Show config file path
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { loadConfig } from './config-loader.js';
+import { DEFAULT_CONFIG } from '../core/config.js';
+// ─── Config File Discovery ────────────────────────────────────────────────────
+/**
+ * Find the config file path — mirrors the search order in config-loader.ts.
+ * Returns null if no config file exists (defaults are in use).
+ */
+function findConfigPath(cwd = process.cwd()) {
+    const searchPaths = [
+        resolve(cwd, '.fozikio', 'config.yaml'),
+        resolve(cwd, 'cortex.config.yaml'),
+        resolve(cwd, 'config.yaml'),
+    ];
+    for (const p of searchPaths) {
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+/**
+ * Default write location when no config exists yet.
+ */
+function defaultConfigPath(cwd = process.cwd()) {
+    return resolve(cwd, '.fozikio', 'config.yaml');
+}
+function readRawConfig(configPath) {
+    const raw = readFileSync(configPath, 'utf-8');
+    const parsed = parseYaml(raw);
+    if (!parsed || typeof parsed !== 'object') {
+        return {
+            path: configPath,
+            wrapped: false,
+            agentMeta: undefined,
+            cortexConfig: {},
+        };
+    }
+    if ('cortex' in parsed && parsed.cortex) {
+        const agentParsed = parsed;
+        return {
+            path: configPath,
+            wrapped: true,
+            agentMeta: agentParsed.agent,
+            cortexConfig: agentParsed.cortex,
+        };
+    }
+    return {
+        path: configPath,
+        wrapped: false,
+        agentMeta: undefined,
+        cortexConfig: parsed,
+    };
+}
+/**
+ * Write config back to the file, preserving agent wrapper if present.
+ */
+function writeConfig(raw, updates) {
+    const merged = { ...raw.cortexConfig, ...updates };
+    let outObject;
+    if (raw.wrapped) {
+        outObject = {
+            ...(raw.agentMeta !== undefined ? { agent: raw.agentMeta } : {}),
+            cortex: merged,
+        };
+    }
+    else {
+        outObject = merged;
+    }
+    const yaml = stringifyYaml(outObject);
+    const dir = dirname(raw.path);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(raw.path, yaml, 'utf-8');
+}
+const VALID_STORES = ['sqlite', 'firestore'];
+const VALID_EMBEDS = ['ollama', 'vertex', 'openai'];
+const VALID_LLMS = ['ollama', 'gemini', 'anthropic', 'openai'];
+function parseArgs(args) {
+    let showPath = false;
+    let store = null;
+    let embed = null;
+    let llm = null;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--path') {
+            showPath = true;
+        }
+        else if (arg === '--store' && args[i + 1]) {
+            const val = args[++i];
+            if (!VALID_STORES.includes(val)) {
+                process.stderr.write(`Error: invalid store "${val}". Valid values: ${VALID_STORES.join(', ')}\n`);
+                process.exit(1);
+            }
+            store = val;
+        }
+        else if (arg === '--embed' && args[i + 1]) {
+            const val = args[++i];
+            if (!VALID_EMBEDS.includes(val)) {
+                process.stderr.write(`Error: invalid embed provider "${val}". Valid values: ${VALID_EMBEDS.join(', ')}\n`);
+                process.exit(1);
+            }
+            embed = val;
+        }
+        else if (arg === '--llm' && args[i + 1]) {
+            const val = args[++i];
+            if (!VALID_LLMS.includes(val)) {
+                process.stderr.write(`Error: invalid LLM provider "${val}". Valid values: ${VALID_LLMS.join(', ')}\n`);
+                process.exit(1);
+            }
+            llm = val;
+        }
+    }
+    return { showPath, store, embed, llm };
+}
+// ─── Main Export ─────────────────────────────────────────────────────────────
+export async function runConfig(args) {
+    const parsed = parseArgs(args);
+    const hasUpdates = parsed.store !== null || parsed.embed !== null || parsed.llm !== null;
+    // --path: just print the config file path.
+    if (parsed.showPath) {
+        const configPath = findConfigPath();
+        if (configPath) {
+            process.stdout.write(configPath + '\n');
+        }
+        else {
+            process.stderr.write('No config file found. Default path would be:\n');
+            process.stdout.write(defaultConfigPath() + '\n');
+        }
+        return;
+    }
+    // Setting flags: update config.
+    if (hasUpdates) {
+        const configPath = findConfigPath();
+        const targetPath = configPath ?? defaultConfigPath();
+        let raw;
+        if (configPath) {
+            raw = readRawConfig(configPath);
+        }
+        else {
+            // No config file yet — start from defaults, write to default path.
+            raw = {
+                path: targetPath,
+                wrapped: false,
+                agentMeta: undefined,
+                cortexConfig: { ...DEFAULT_CONFIG },
+            };
+        }
+        const updates = {};
+        if (parsed.store !== null)
+            updates.store = parsed.store;
+        if (parsed.embed !== null)
+            updates.embed = parsed.embed;
+        if (parsed.llm !== null)
+            updates.llm = parsed.llm;
+        writeConfig(raw, updates);
+        process.stderr.write(`Config updated: ${targetPath}\n`);
+        const parts = [];
+        if (parsed.store !== null)
+            parts.push(`store=${parsed.store}`);
+        if (parsed.embed !== null)
+            parts.push(`embed=${parsed.embed}`);
+        if (parsed.llm !== null)
+            parts.push(`llm=${parsed.llm}`);
+        process.stderr.write(`  ${parts.join(', ')}\n`);
+        return;
+    }
+    // Default: show current config as YAML.
+    const config = loadConfig();
+    process.stdout.write(stringifyYaml(config));
+}
+//# sourceMappingURL=config-cmd.js.map

package/dist/bin/config-cmd.js.map

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

package/dist/bin/config-loader.d.ts

@@ -0,0 +1,12 @@
+/**
+ * config-loader.ts — shared config loading for cortex-engine.
+ *
+ * Config search order:
+ *   1. .fozikio/config.yaml   (agent workspace)
+ *   2. cortex.config.yaml     (project root)
+ *   3. config.yaml            (project root)
+ *   4. defaults               (sqlite + ollama)
+ */
+import type { CortexConfig } from '../core/config.js';
+export declare function loadConfig(cwd?: string): CortexConfig;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/bin/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/bin/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAEnE,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,YAAY,CA8BpE"}

package/dist/bin/config-loader.js

@@ -0,0 +1,42 @@
+/**
+ * config-loader.ts — shared config loading for cortex-engine.
+ *
+ * Config search order:
+ *   1. .fozikio/config.yaml   (agent workspace)
+ *   2. cortex.config.yaml     (project root)
+ *   3. config.yaml            (project root)
+ *   4. defaults               (sqlite + ollama)
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { DEFAULT_CONFIG } from '../core/config.js';
+export function loadConfig(cwd = process.cwd()) {
+    const searchPaths = [
+        resolve(cwd, '.fozikio', 'config.yaml'),
+        resolve(cwd, 'cortex.config.yaml'),
+        resolve(cwd, 'config.yaml'),
+    ];
+    for (const configPath of searchPaths) {
+        if (existsSync(configPath)) {
+            try {
+                const raw = readFileSync(configPath, 'utf-8');
+                const parsed = parseYaml(raw);
+                if (parsed && typeof parsed === 'object' && 'cortex' in parsed && parsed.cortex) {
+                    // Wrapped AgentConfig format
+                    return { ...DEFAULT_CONFIG, ...parsed.cortex };
+                }
+                // Top-level CortexConfig format
+                return { ...DEFAULT_CONFIG, ...parsed };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error(`[cortex-engine] Failed to parse config at ${configPath}: ${message}`);
+            }
+        }
+    }
+    // No config found — use defaults
+    console.error('[cortex-engine] No config file found, using defaults (sqlite + ollama)');
+    return DEFAULT_CONFIG;
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/bin/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/bin/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,MAAM,UAAU,UAAU,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACpD,MAAM,WAAW,GAAG;QAClB,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC;QACvC,OAAO,CAAC,GAAG,EAAE,oBAAoB,CAAC;QAClC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC;KAC5B,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAA+B,CAAC;gBAE5D,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAChF,6BAA6B;oBAC7B,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBACjD,CAAC;gBAED,gCAAgC;gBAChC,OAAO,EAAE,GAAG,cAAc,EAAE,GAAI,MAAgC,EAAE,CAAC;YACrE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,OAAO,CAAC,KAAK,CAAC,6CAA6C,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,OAAO,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;IACxF,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/bin/digest-cmd.d.ts

@@ -0,0 +1,13 @@
+/**
+ * digest-cmd.ts — cortex-kit digest command handler.
+ *
+ * Usage:
+ *   cortex-kit digest <file>                                Process a single file
+ *   cortex-kit digest --pending                            Process files with directive: digest
+ *   cortex-kit digest --dry-run                            Show what would be processed
+ *   cortex-kit digest --pipeline observe,reflect,predict   Custom pipeline
+ *   cortex-kit digest --namespace prediction               Target namespace
+ *   cortex-kit digest --dir <path>                         Directory to scan for --pending
+ */
+export declare function runDigest(args: string[]): Promise<void>;
+//# sourceMappingURL=digest-cmd.d.ts.map

package/dist/bin/digest-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest-cmd.d.ts","sourceRoot":"","sources":["../../src/bin/digest-cmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA2SH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuF7D"}