v0.7.0 — Cold Start + Two-Namespace Default

What's new

Solves the cold-start problem and prevents memory pollution.

Two memory spaces by default

fozikio init now scaffolds two namespaces: project and personal.

• Project facts go into project — tech stack, patterns, architecture
• User preferences go into personal — working style, opinions, relationship context
• They don't leak into each other

You don't bring your personal life to work with you. Your agent shouldn't either.

Smarter retrieval

query() now uses composite ranking instead of pure cosine similarity:

composite = similarity × retrievability × salience_factor

Also adds:

• min_score threshold (default 0.3) — garbage results are dropped instead of returned
• category filter — scope queries to specific memory types (beliefs, topics, entities, etc.)

/learn-project skill

Agent-first project bootstrapping. Invoke it, and the agent reads your codebase (package.json, README, config files, git history, directory structure) and observes 8-15 key architectural facts. No 500-observation dump — just enough that the agent stops being an amnesiac about obvious things.

Memory guidance in CLAUDE.md

The generated CLAUDE.md now teaches the agent:

• Which namespace to use for what
• "Don't announce when you're remembering. Just be the kind of assistant who doesn't forget."
• The "would my future self search for this?" gate before observing

Install

npm install cortex-engine@0.7.0
npx fozikio init my-agent

Full changelog: https://github.com/Fozikio/cortex-engine/releases/tag/v0.6.0 (v0.6.0) → this release