context-eng 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mayank
+
+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,272 @@
+# context-eng
+
+Local project memory router for Codex and Claude Code. Memories live in one SQLite database per each category, with SQLite FTS5 for local retrieval and TypeSafe Jev filtering for semantic relevance.
+
+## Use
+
+Node.js 20 or newer. Run this from an existing project directory, or pass `--project` pointing to one. From a checkout of this repo, `npm install`, `npm run build`, then `npm run init` does the same thing.
+
+```bash
+npx -y context-eng init
+pnpm dlx context-eng init
+context-eng init --project /path/to/repo
+```
+
+`init` asks for a TypeSafe API key. The prompt is hidden. Press Enter to skip. A saved key is kept if you press Enter again; type a new key to replace it. The key goes in the OS keychain (macOS Keychain, Windows Credential Manager, or libsecret), not into the project.
+
+In a terminal, `init` lists Cursor, Claude Code, and Codex. Installed ones start selected. Space turns one off. Enter writes a user-level MCP server only for the ones left selected. A different existing `context-eng` server needs an explicit yes before replacement. Without a terminal, `init` skips global instructions and editor servers unless you pass `--yes`; `--yes` adds missing servers but never replaces a different one. Restart an app after adding its server.
+
+```mermaid
+flowchart TD
+  init["context-eng init"] --> key["OS keychain"]
+  init --> project["AGENTS.md and CLAUDE.md, only if they exist"]
+  init --> pick["select installed apps"]
+  pick --> codexRules["~/.codex/AGENTS.md"]
+  pick --> cursor["~/.cursor/mcp.json"]
+  pick --> claude["~/.claude.json"]
+  claude --> claudeRules["~/.claude/CLAUDE.md"]
+  pick --> codex["~/.codex/config.toml"]
+```
+
+You do not start the server yourself. Cursor, Claude Code, or Codex runs `context-eng mcp`. With no `--project`, the server is global until a tool passes `projectPath` or calls `memory_bind`.
+
+### Project and global
+
+Two different splits:
+
+| | Project | Global |
+| --- | --- | --- |
+| Memory | This repo only, under `~/.context/projects/` | Every repo, under `~/.context/global/` |
+| Instructions | Files inside the repo | Files in your home directory, used by every repo |
+
+`memory_search` with `filters.scope` `project`, `global`, or `both` chooses the memory side. The files below are the instruction side.
+
+### Files `init` edits
+
+Instruction files (`AGENTS.md`, `CLAUDE.md`, and the rule files below) keep your other text. `init` replaces only the block between `<!-- context-eng:start -->` and `<!-- context-eng:end -->`. The MCP config files are updated in place and keep other servers.
+
+| File | When | What it does |
+| --- | --- | --- |
+| OS keychain `context-eng` / `typesafe-api-key` | Always | Stores the TypeSafe key for this login |
+| `<project>/AGENTS.md` | Only if that file already exists | Tells Codex, in this repo, to use the memory tools |
+| `<project>/CLAUDE.md` | Only if that file already exists | Tells Claude Code, in this repo, to use the memory tools |
+| `~/.codex/AGENTS.md` | Terminal or `--yes` | Same instructions for every Codex session |
+| `~/.claude/CLAUDE.md` | Claude server added or already matching, or `--claude-only` | Same instructions for every Claude Code project |
+| `~/.cursor/mcp.json` | Cursor selected | Starts the server for every Cursor project. No `--project` |
+| `~/.claude.json` | Claude selected | Same for every Claude Code project. This is the file `claude mcp add --scope user` writes |
+| `~/.codex/config.toml` | Codex selected | Adds `[mcp_servers.context-eng]` only. Codex may later add `[mcp_servers.context-eng.tools.*]` approval lines itself |
+
+`<project>` is `--project`, or the current directory when you omit it. It must already exist. Running `init` from `~` uses your home directory as `<project>`. It does not create `~/AGENTS.md` or `~/CLAUDE.md` when those files are absent. Claude's user-level MCP server is in `~/.claude.json`; `init` does not create a project `.mcp.json`.
+
+### One app, or only the instruction files
+
+These skip the key prompt and the MCP server write. They only update instruction files.
+
+```bash
+context-eng init --codex-only
+context-eng init --cursor-only --scope global
+context-eng init --cursor-only --project /path/to/repo
+context-eng init --claude-only --scope both --project /path/to/repo
+```
+
+| Command | Global file | Project file |
+| --- | --- | --- |
+| `--codex-only` | `~/.codex/AGENTS.md` | none |
+| `--cursor-only` | `~/.cursor/rules/context-eng-memory.mdc` | `<project>/.cursor/rules/context-eng-memory.mdc` |
+| `--claude-only` | `~/.claude/CLAUDE.md` | `<project>/.claude/rules/context-eng-memory.md` |
+
+`--scope` is `global`, `project`, or `both`. With no `--project`, scope defaults to `global`. With `--project` and no `--scope`, scope defaults to `project`. `project` and `both` need `--project`.
+
+`context-eng mcp` reads the keychain key when `TYPESAFE_API_KEY` is unset. Set `TYPESAFE_API_KEY` to override it. Set it empty to force local FTS5 search. `CONTEXT_ENG_HOME` overrides the default `~/.context` storage root.
+
+## Search behavior
+
+`memory_search` can omit categories to search every category available in the selected scope. Supplying one to four categories narrows the search. Filters are applied before retrieval:
+
+- An MCP started without `--project` has no project layout. Global-only search/create and the global portions of map/category discovery still work. Project or both-scope operations return `PROJECT_NOT_BOUND` until you retry that call with `projectPath` or call `memory_bind`; id-based tools require `memory_bind` because they do not accept `projectPath`.
+- With `TYPESAFE_API_KEY`, searches with at most 60 eligible rows and 12,000 eligible tokens send every row to Jev. Larger searches merge FTS5 matches, exact hint-label matches, one conservative typo retry, and priority fill; Jev evaluates the first 90 in batches of 30.
+- Optional `hints.topics`, `hints.tags`, `hints.links`, and `hints.categories` boost candidate selection but never act as hard filters. Exact label matches are preserved in the local fallback.
+- Without the key, or when Jev fails or exceeds its 20-second request deadline (`DEFAULT_JEV_TIMEOUT_MS`, locked), the tool uses local lexical and exact-label retrieval.
+- At most 50 relevant contexts and approximately 4000 tokens are returned after a short retrieval mode/count line.
+
+Jev receives only the agent prompt and an array of memory-content strings; category, scope, importance, IDs, and other memory metadata stay local.
+
+```mermaid
+sequenceDiagram
+  participant You
+  participant agent
+  participant MCP as memory_search
+  participant SQLite
+  participant Jev
+
+  You->>agent: task
+  agent->>MCP: query + categories + filters + hints
+  MCP->>SQLite: filtered candidates
+  SQLite-->>MCP: eligible contexts
+  MCP->>Jev: prompt + content strings
+  Jev-->>MCP: probability 0 to 1
+  MCP-->>agent: notes over 0.5
+  agent-->>You: answer using that text
+```
+
+
+
+```mermaid
+flowchart TD
+  search[memory_search] --> filters[apply filters]
+  filters --> size{rows ≤ 60 and tokens ≤ 12000?}
+  size -->|yes| all[all eligible rows]
+  size -->|no| rank[FTS + exact labels + typo retry + fill]
+  all --> jev{Jev available?}
+  rank --> jev
+  jev -->|no or fail| fts[local lexical + exact labels]
+  jev -->|yes| cap{candidates > 90?}
+  cap -->|no| batch[Jev all in batches of 30]
+  cap -->|yes| first[Jev first 90 in batches of 30]
+  batch --> gate[Jev keeps over 0.5]
+  first --> gate
+  gate -->|hits| out[up to 50 notes / ~4000 tokens]
+  gate -->|empty| none[no matching memory.]
+  first -->|hits remain| msg[append too-large message]
+  msg --> out
+  fts --> out
+```
+
+
+
+
+
+## Requirements and install
+
+Node.js 20 or newer.
+
+One command, after this package is published. It asks for the TypeSafe key, then detects Cursor, Claude Code, and Codex. In a terminal the installed ones start selected. Space turns one off, Enter confirms, and init writes a user-level MCP server only for the ones left selected. A different existing `context-eng` setup needs confirmation before replacement. In a non-terminal session, use `--yes` to add missing servers without replacing different ones. That server is `npx -y context-eng mcp` when `npx` is on PATH, otherwise `pnpm dlx context-eng mcp`. Global configs omit `--project`.
+
+```bash
+npx -y context-eng init
+```
+
+```bash
+pnpm dlx context-eng init
+```
+
+From this repo:
+
+```bash
+npm install
+npm run build
+npm run init
+```
+
+
+
+## Init and server
+
+```bash
+npm run init
+node dist/cli-entry.js init --project /path/to/repo
+```
+
+`context-eng init` asks for a TypeSafe API key in the terminal and stores it in the OS keychain (macOS Keychain, Windows Credential Manager, or libsecret). The prompt is hidden. Press Enter to skip. Run init again to replace a saved key: enter the new key, or press Enter to keep the current one. The key is not written into the project.
+
+`context-eng mcp` reads that key when `TYPESAFE_API_KEY` is unset. Set `TYPESAFE_API_KEY` to override the keychain. Set it to an empty value to force local FTS5 search.
+
+Run with Jev after the key is saved:
+
+```bash
+node dist/cli-entry.js mcp --project /path/to/repo
+```
+
+Run with `TYPESAFE_API_KEY` empty for local FTS5-only search:
+
+```bash
+TYPESAFE_API_KEY= node dist/cli-entry.js mcp --project /path/to/repo
+```
+
+Omitting `--project` is supported for a global-only server. It does not resolve or store `process.cwd()` as a project layout; bind explicitly before project access.
+
+Project-path resolution elsewhere still uses explicit input, then `CONTEXT_ENG_PROJECT`, then the current working directory. The `mcp` command intentionally treats an omitted `--project` as unbound instead of accepting that fallback as a binding. `CONTEXT_ENG_HOME` overrides the default `~/.context` storage root.
+
+## Memory search
+
+`query` is required. `projectPath` is required when no project is bound and the scope is `project` or `both` (the default). If the tool returns `PROJECT_NOT_BOUND`, retry the same call with `projectPath`. Categories, filters, hints, sort, and limit are optional.
+
+```json
+{
+  "projectPath": "/path/to/repo",
+  "query": "fix the image export memory leak",
+  "categories": ["mistake", "decision"],
+  "filters": {
+    "scope": "both",
+    "minImportance": 0.6,
+    "subject": "canvas export",
+    "topics": { "values": ["browser memory"], "match": "any" },
+    "tags": { "values": ["blob-url"], "match": "all" },
+    "links": { "values": ["cli.ts"], "match": "any" },
+    "time": { "field": "updated", "preset": "this_month" }
+  },
+  "hints": {
+    "topics": ["browser memory"],
+    "tags": ["blob-url"],
+    "links": ["cli.ts"],
+    "categories": ["mistake"]
+  },
+  "sort": { "by": "relevance", "order": "desc" },
+  "limit": 50
+}
+```
+
+Omit `categories` to search every category in the selected scope. Omit `projectPath` when the server started with `--project`, you already called `memory_bind`, or `filters.scope` is `global`.
+
+Time supports `this_week` (Monday to now), `this_month`, or inclusive ISO-8601 `from`/`to` ranges. Filter topics, tags, and links support `any` or `all` and remove non-matches. Hint topics, tags, links, and categories only influence candidate ordering. Links are opaque cross-references rather than URLs specifically: at most ten values, each at most 64 characters.
+
+## Tools
+
+
+| Tool                     | Contract                                                                                                                                                                                                       |
+| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `memory_search`          | `query` is required. Pass `projectPath` when unbound and scope is `project` or `both`; on `PROJECT_NOT_BOUND`, retry with `projectPath`. Other fields are optional. Hints boost without hard filtering.        |
+| `memory_create`          | Creates a missing custom category on first write. Near-duplicate names require a second call with `confirmNewCategory: true`; built-in durable categories auto-promote and custom categories start in staging. |
+| `memory_list_categories` | Lists global names, and project names when a project is bound. Omission returns global only while unbound. Explicit `scope: "project"` needs `projectPath` or `memory_bind`.                                   |
+| `memory_edit`            | Requires `currentCategory`; an optional replacement `category` moves the row between category databases. Creating a near-duplicate destination requires `confirmNewCategory: true`.                            |
+| `memory_map`             | Lists categories, counts, staging, aligned `lines_ids`, and map paths. Accepts `scope` (`both`, `global`, or `project`) and `projectPath`.                                                                     |
+| `memory_bind`            | Binds the server to another project storage catalog.                                                                                                                                                           |
+| `memory_promote`         | Requires category and ID; moves a staging memory into search.                                                                                                                                                  |
+| `memory_demote`          | Requires category and ID; moves a searchable memory to staging.                                                                                                                                                |
+| `memory_delete`          | Requires category and ID; deletes staging rows only.                                                                                                                                                           |
+
+
+
+
+## Data layout and migration
+
+```text
+~/.context/
+  global/
+    catalog.db
+    categories/<slug>-<hash>.db
+  projects/<project-key>/
+    catalog.db
+    categories/<slug>-<hash>.db
+    map.md
+    map.json
+```
+
+On first open, existing single-database memories are copied into staged category databases, validated, activated, and marked migrated. IDs, timestamps, tags, importance, active state, and staging state are preserved; the legacy database is not deleted.
+
+Category names are Unicode-normalized and case-insensitive for lookup. Safe slug-and-hash filenames prevent a category name from becoming a filesystem path. If at least 80% of a new name matches a built-in or same-scope registered category after separators are removed, `memory_create` or a category-changing `memory_edit` returns `NEAR_CATEGORY` without writing. Separator-only variants such as `batch-probe` and `batch_probe` are also treated as matches. The agent can use the suggested category or make a second call with `confirmNewCategory: true`. Built-in categories keep their existing auto-promotion behavior; custom categories have no rename or delete lifecycle in this version.
+
+## Checks
+
+```bash
+npm test
+npm run typecheck
+npm run typecheck:test
+npm run lint
+```
+
+
+
+## Related docs
+
+- [Memory tool rules](system_prompts/rules.md) — agent contract for bind, search, write, promote, and delete

package/dist/categories.d.ts

@@ -0,0 +1,27 @@
+export declare const CATEGORIES: readonly ["instruction", "mistake", "preference", "decision", "constraint", "workflow"];
+/** Categories are extensible; these six names retain their built-in behavior. */
+export type Category = string;
+/** Built-in categories that leave staging immediately on create. */
+export declare const AUTO_PROMOTE: ReadonlySet<string>;
+export declare const SCOPES: readonly ["global", "project"];
+export type Scope = (typeof SCOPES)[number];
+export declare const STAGING = "staging";
+export declare const MAX_TOKENS = 800;
+export declare const MAX_HITS = 50;
+export declare const MAX_READ_TOKENS = 4000;
+export declare const MAX_SEARCH_CATEGORIES = 4;
+export declare const MAX_JEV_CANDIDATES = 30;
+/** Max parallel Jev requests. Candidates after 90 are skipped. */
+export declare const MAX_JEV_BATCHES = 3;
+export declare const MAX_EXHAUSTIVE_SEARCH_ROWS = 60;
+export declare const MAX_EXHAUSTIVE_SEARCH_TOKENS = 12000;
+export declare const MAX_CATEGORY_LENGTH = 64;
+export declare const MAX_FILTER_VALUES = 10;
+export declare const MAX_FILTER_VALUE_LENGTH = 64;
+export declare const NEAR_CATEGORY_SIMILARITY = 0.8;
+export declare function isCategory(value: unknown): value is Category;
+export declare function canonicalCategory(value: string): string;
+export declare function displayCategory(value: string): string;
+/** Returns how much of two category names matches, from 0 to 1. */
+export declare function categoryNameSimilarity(left: string, right: string): number;
+export declare function isScope(value: unknown): value is Scope;

package/dist/categories.js

@@ -0,0 +1,71 @@
+import { editDistance } from "./text.js";
+export const CATEGORIES = [
+    "instruction",
+    "mistake",
+    "preference",
+    "decision",
+    "constraint",
+    "workflow",
+];
+/** Built-in categories that leave staging immediately on create. */
+export const AUTO_PROMOTE = new Set([
+    "instruction",
+    "decision",
+    "constraint",
+    "mistake",
+]);
+export const SCOPES = ["global", "project"];
+export const STAGING = "staging";
+export const MAX_TOKENS = 800;
+export const MAX_HITS = 50;
+export const MAX_READ_TOKENS = 4000;
+export const MAX_SEARCH_CATEGORIES = 4;
+export const MAX_JEV_CANDIDATES = 30;
+/** Max parallel Jev requests. Candidates after 90 are skipped. */
+export const MAX_JEV_BATCHES = 3;
+export const MAX_EXHAUSTIVE_SEARCH_ROWS = 60;
+export const MAX_EXHAUSTIVE_SEARCH_TOKENS = 12_000;
+export const MAX_CATEGORY_LENGTH = 64;
+export const MAX_FILTER_VALUES = 10;
+export const MAX_FILTER_VALUE_LENGTH = 64;
+export const NEAR_CATEGORY_SIMILARITY = 0.8;
+export function isCategory(value) {
+    if (typeof value !== "string")
+        return false;
+    const normalized = value.normalize("NFKC").trim();
+    return (normalized.length > 0 &&
+        normalized.length <= MAX_CATEGORY_LENGTH &&
+        !hasControlCharacters(normalized));
+}
+function hasControlCharacters(value) {
+    for (const character of value) {
+        const code = character.charCodeAt(0);
+        if (code <= 31 || code === 127)
+            return true;
+    }
+    return false;
+}
+export function canonicalCategory(value) {
+    return value.normalize("NFKC").trim().toLocaleLowerCase("en-US");
+}
+export function displayCategory(value) {
+    return value.normalize("NFKC").trim();
+}
+/** Returns how much of two category names matches, from 0 to 1. */
+export function categoryNameSimilarity(left, right) {
+    const a = comparableCategory(left);
+    const b = comparableCategory(right);
+    if (a === b)
+        return 1;
+    if (a.length === 0 || b.length === 0)
+        return 0;
+    const longest = Math.max(a.length, b.length);
+    return 1 - editDistance(a, b, longest) / longest;
+}
+function comparableCategory(value) {
+    return canonicalCategory(value).replace(/[^\p{L}\p{N}]+/gu, "");
+}
+export function isScope(value) {
+    return typeof value === "string" && SCOPES.includes(value);
+}
+//# sourceMappingURL=categories.js.map

package/dist/categories.js.map

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

package/dist/cli-entry.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli-entry.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { main } from "./cli.js";
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=cli-entry.js.map

package/dist/cli-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-entry.js","sourceRoot":"","sources":["../src/cli-entry.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,30 @@
+declare const RULE_SCOPES: readonly ["global", "project", "both"];
+type RuleScope = (typeof RULE_SCOPES)[number];
+export declare function upsertMarkedBlock(existing: string | null, block: string): string;
+export declare function agentPointerBlock(): string;
+export declare function updateExistingPointer(file: string, block: string): boolean;
+export declare function codexAgentsPath(home?: string): string;
+export declare function writeCodexAgentsPointer(block: string, home?: string): string;
+export declare function globalCursorRulePath(home?: string): string;
+export declare function cursorRulePath(projectPath: string): string;
+export declare function resolveRuleScope(scope: string | undefined, project: string | undefined): RuleScope;
+export declare const resolveCursorRuleScope: typeof resolveRuleScope;
+export declare function writeCursorRuleFile(block: string, file: string): string;
+export declare function writeCursorRule(block: string, projectPath: string): string;
+export declare function writeCursorRules(block: string, opts: {
+    scope: RuleScope;
+    project?: string;
+    home?: string;
+}): string[];
+export declare function globalClaudeAgentsPath(home?: string): string;
+export declare function writeGlobalClaudePointer(block: string, home?: string): string;
+export declare function claudeRulePath(projectPath: string): string;
+export declare function writeClaudeRuleFile(block: string, file: string): string;
+export declare function writeClaudeRule(block: string, projectPath: string): string;
+export declare function writeClaudeRules(block: string, opts: {
+    scope: RuleScope;
+    project?: string;
+    home?: string;
+}): string[];
+export declare function main(): Promise<void>;
+export {};