context-eng 0.1.0

package/dist/cli.js

@@ -0,0 +1,327 @@
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+import { Engine } from "./engine.js";
+import { detectHarnesses, formatHarnessReport, installDetectedHarnesses, pathHasCommand, promptHarnessChoice, } from "./harness.js";
+import { runStdio } from "./mcp.js";
+import { resolveProjectPath } from "./paths.js";
+import { ensureTypeSafeKey, loadTypeSafeApiKey, openOsKeychain } from "./secrets.js";
+import { TypeSafeRelevanceEvaluator } from "./typesafe.js";
+const MARKER_START = "<!-- context-eng:start -->";
+const MARKER_END = "<!-- context-eng:end -->";
+const CURSOR_RULE_FILE = "context-eng-memory.mdc";
+const CURSOR_RULE_FRONTMATTER = `---
+description: Use context-eng MCP memory tools for local project memory.
+alwaysApply: true
+---
+`;
+const RULE_SCOPES = ["global", "project", "both"];
+const CLAUDE_RULE_FILE = "context-eng-memory.md";
+const USAGE = `Usage:
+  context-eng mcp [--project <path>]
+  context-eng init [--project <path>] [--yes]
+  context-eng init --codex-only
+  context-eng init --cursor-only [--scope global|project|both] [--project <path>]
+  context-eng init --claude-only [--scope global|project|both] [--project <path>]
+`;
+export function upsertMarkedBlock(existing, block) {
+    const unit = block.trimEnd();
+    if (existing == null || existing.trim() === "") {
+        return `${unit}\n`;
+    }
+    const start = existing.indexOf(MARKER_START);
+    const end = existing.indexOf(MARKER_END);
+    if (start !== -1 && end !== -1 && end > start) {
+        const before = existing.slice(0, start);
+        const after = existing.slice(end + MARKER_END.length);
+        const out = `${before}${unit}${after}`;
+        return out.endsWith("\n") ? out : `${out}\n`;
+    }
+    const head = existing.replace(/\s+$/, "");
+    return `${head}\n\n${unit}\n`;
+}
+function repoRoot() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+}
+export function agentPointerBlock() {
+    const raw = readFileSync(path.join(repoRoot(), "system_prompts", "AGENTS.md"), "utf8");
+    const start = raw.indexOf(MARKER_START);
+    const end = raw.indexOf(MARKER_END);
+    const inner = start !== -1 && end !== -1 && end > start
+        ? raw.slice(start + MARKER_START.length, end)
+        : raw;
+    const adapted = inner
+        .replaceAll("memory.search", "memory_search")
+        .replaceAll("memory.create", "memory_create")
+        .replaceAll("memory.delete", "memory_delete")
+        .replaceAll("memory.edit", "memory_edit")
+        .replaceAll("memory.map", "memory_map")
+        .replaceAll("memory.promote", "memory_promote")
+        .replaceAll("memory.demote", "memory_demote")
+        .trim();
+    return `${MARKER_START}\n${adapted}\n${MARKER_END}\n`;
+}
+function writePointer(file, block) {
+    const existing = existsSync(file) ? readFileSync(file, "utf8") : null;
+    writeFileSync(file, upsertMarkedBlock(existing, block), "utf8");
+}
+export function updateExistingPointer(file, block) {
+    if (!existsSync(file))
+        return false;
+    writePointer(file, block);
+    return true;
+}
+function usage(exitCode = 1) {
+    (exitCode === 0 ? console.log : console.error)(USAGE);
+    process.exit(exitCode);
+}
+function engineOpts(project) {
+    if (project !== undefined)
+        return { projectPath: project };
+    return {};
+}
+export function codexAgentsPath(home = os.homedir()) {
+    return path.join(home, ".codex", "AGENTS.md");
+}
+export function writeCodexAgentsPointer(block, home = os.homedir()) {
+    const file = codexAgentsPath(home);
+    mkdirSync(path.dirname(file), { recursive: true });
+    writePointer(file, block);
+    return file;
+}
+export function globalCursorRulePath(home = os.homedir()) {
+    return path.join(home, ".cursor", "rules", CURSOR_RULE_FILE);
+}
+export function cursorRulePath(projectPath) {
+    return path.join(projectPath, ".cursor", "rules", CURSOR_RULE_FILE);
+}
+export function resolveRuleScope(scope, project) {
+    if (scope !== undefined) {
+        if (!RULE_SCOPES.includes(scope)) {
+            throw new Error(`scope must be one of: ${RULE_SCOPES.join(", ")}`);
+        }
+        return scope;
+    }
+    if (project !== undefined)
+        return "project";
+    return "global";
+}
+export const resolveCursorRuleScope = resolveRuleScope;
+function splitCursorRule(existing) {
+    if (existing.startsWith("---\n")) {
+        const end = existing.indexOf("\n---\n", 4);
+        if (end !== -1) {
+            return {
+                frontmatter: existing.slice(0, end + 5),
+                body: existing.slice(end + 5),
+            };
+        }
+    }
+    return { frontmatter: CURSOR_RULE_FRONTMATTER.trimEnd(), body: existing };
+}
+export function writeCursorRuleFile(block, file) {
+    mkdirSync(path.dirname(file), { recursive: true });
+    const existing = existsSync(file) ? readFileSync(file, "utf8") : null;
+    if (existing == null || existing.trim() === "") {
+        writeFileSync(file, `${CURSOR_RULE_FRONTMATTER}\n${block.trimEnd()}\n`, "utf8");
+        return file;
+    }
+    const { frontmatter, body } = splitCursorRule(existing);
+    const nextBody = upsertMarkedBlock(body.trim() === "" ? null : body, block);
+    writeFileSync(file, `${frontmatter}\n${nextBody}`, "utf8");
+    return file;
+}
+export function writeCursorRule(block, projectPath) {
+    return writeCursorRuleFile(block, cursorRulePath(projectPath));
+}
+export function writeCursorRules(block, opts) {
+    const files = [];
+    const home = opts.home ?? os.homedir();
+    if (opts.scope === "global" || opts.scope === "both") {
+        files.push(writeCursorRuleFile(block, globalCursorRulePath(home)));
+    }
+    if (opts.scope === "project" || opts.scope === "both") {
+        if (opts.project === undefined) {
+            throw new Error("scope project or both requires --project <path>");
+        }
+        files.push(writeCursorRuleFile(block, cursorRulePath(resolveProjectPath(opts.project))));
+    }
+    return files;
+}
+export function globalClaudeAgentsPath(home = os.homedir()) {
+    return path.join(home, ".claude", "CLAUDE.md");
+}
+export function writeGlobalClaudePointer(block, home = os.homedir()) {
+    const file = globalClaudeAgentsPath(home);
+    mkdirSync(path.dirname(file), { recursive: true });
+    writePointer(file, block);
+    return file;
+}
+export function claudeRulePath(projectPath) {
+    return path.join(projectPath, ".claude", "rules", CLAUDE_RULE_FILE);
+}
+export function writeClaudeRuleFile(block, file) {
+    mkdirSync(path.dirname(file), { recursive: true });
+    writePointer(file, block);
+    return file;
+}
+export function writeClaudeRule(block, projectPath) {
+    return writeClaudeRuleFile(block, claudeRulePath(projectPath));
+}
+export function writeClaudeRules(block, opts) {
+    const files = [];
+    const home = opts.home ?? os.homedir();
+    if (opts.scope === "global" || opts.scope === "both") {
+        files.push(writeGlobalClaudePointer(block, home));
+    }
+    if (opts.scope === "project" || opts.scope === "both") {
+        if (opts.project === undefined) {
+            throw new Error("scope project or both requires --project <path>");
+        }
+        files.push(writeClaudeRuleFile(block, claudeRulePath(resolveProjectPath(opts.project))));
+    }
+    return files;
+}
+async function confirmHarnessReplacement(id, file) {
+    const prompt = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = await prompt.question(`${id} already has a different context-eng server in ${file}. Replace it? [y/N] `);
+        return /^y(?:es)?$/i.test(answer.trim());
+    }
+    catch {
+        return false;
+    }
+    finally {
+        prompt.close();
+    }
+}
+export async function main() {
+    let values;
+    let positionals;
+    try {
+        const parsed = parseArgs({
+            args: process.argv.slice(2),
+            options: {
+                project: { type: "string" },
+                scope: { type: "string" },
+                help: { type: "boolean", short: "h" },
+                yes: { type: "boolean" },
+                "codex-only": { type: "boolean" },
+                "cursor-only": { type: "boolean" },
+                "claude-only": { type: "boolean" },
+            },
+            allowPositionals: true,
+            strict: true,
+        });
+        values = parsed.values;
+        positionals = parsed.positionals;
+    }
+    catch {
+        usage();
+    }
+    if (values.help)
+        usage(0);
+    if (positionals.length !== 1) {
+        usage();
+    }
+    const command = positionals[0];
+    if (command !== "mcp" && command !== "init") {
+        usage();
+    }
+    if (command === "mcp") {
+        const loaded = await loadTypeSafeApiKey();
+        if (loaded.warning)
+            console.error(loaded.warning);
+        const engine = new Engine({
+            ...engineOpts(values.project),
+            deferProject: values.project === undefined,
+        });
+        await runStdio(engine, new TypeSafeRelevanceEvaluator({ apiKey: loaded.apiKey }));
+        return;
+    }
+    if (values["codex-only"] || values["cursor-only"] || values["claude-only"]) {
+        const block = agentPointerBlock();
+        if (values["codex-only"]) {
+            console.log(`Updated ${writeCodexAgentsPointer(block)}`);
+        }
+        const scopedOpts = values.project === undefined
+            ? undefined
+            : { project: values.project };
+        if (values["cursor-only"]) {
+            const scope = resolveRuleScope(values.scope, values.project);
+            const cursorOpts = scopedOpts === undefined ? { scope } : { scope, ...scopedOpts };
+            for (const file of writeCursorRules(block, cursorOpts)) {
+                console.log(`Updated ${file}`);
+            }
+        }
+        if (values["claude-only"]) {
+            const scope = resolveRuleScope(values.scope, values.project);
+            const claudeOpts = scopedOpts === undefined ? { scope } : { scope, ...scopedOpts };
+            for (const file of writeClaudeRules(block, claudeOpts)) {
+                console.log(`Updated ${file}`);
+            }
+        }
+        return;
+    }
+    const projectPath = resolveProjectPath(values.project);
+    if (!existsSync(projectPath) || !statSync(projectPath).isDirectory()) {
+        throw new Error(`project path must be an existing directory: ${projectPath}`);
+    }
+    await ensureTypeSafeKey({
+        store: await openOsKeychain(),
+        interactive: process.stdin.isTTY === true,
+    });
+    const engine = new Engine({ projectPath });
+    try {
+        const block = agentPointerBlock();
+        const projectAgents = path.join(engine.layout.projectPath, "AGENTS.md");
+        const projectClaude = path.join(engine.layout.projectPath, "CLAUDE.md");
+        const canWriteGlobal = process.stdin.isTTY === true || values.yes === true;
+        const globalCodexAgents = canWriteGlobal ? writeCodexAgentsPointer(block) : undefined;
+        const projectAgentsUpdated = updateExistingPointer(projectAgents, block);
+        const projectClaudeUpdated = updateExistingPointer(projectClaude, block);
+        console.log("");
+        console.log("Agent pointers");
+        if (projectAgentsUpdated)
+            console.log(`  project AGENTS.md: ${projectAgents}`);
+        if (projectClaudeUpdated)
+            console.log(`  project CLAUDE.md: ${projectClaude}`);
+        if (globalCodexAgents)
+            console.log(`  codex AGENTS.md: ${globalCodexAgents}`);
+        console.log("");
+        console.log("Data layout");
+        console.log(`  home: ${engine.layout.home}`);
+        console.log(`  projectDir: ${engine.layout.projectDir}`);
+        console.log(`  projectKey: ${engine.layout.projectKey}`);
+        console.log("");
+        const home = os.homedir();
+        const installed = detectHarnesses({ home, hasCommand: pathHasCommand })
+            .filter((hit) => hit.installed)
+            .map((hit) => hit.id);
+        const selected = values.yes === true
+            ? installed
+            : process.stdin.isTTY === true
+                ? await promptHarnessChoice(installed)
+                : [];
+        const report = await installDetectedHarnesses({
+            home,
+            hasCommand: pathHasCommand,
+            selected,
+            ...(process.stdin.isTTY === true && values.yes !== true
+                ? { confirmReplace: confirmHarnessReplacement }
+                : {}),
+        });
+        const claude = report.harnesses.find((item) => item.id === "claude");
+        if (canWriteGlobal && claude?.installed && !claude.skipped && !claude.error && !claude.preserved) {
+            console.log(`  global Claude instructions: ${writeGlobalClaudePointer(block, home)}`);
+        }
+        console.log(formatHarnessReport(report));
+    }
+    finally {
+        engine.close();
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/db.d.ts

@@ -0,0 +1,40 @@
+import Database from "better-sqlite3";
+export type Db = Database.Database;
+export declare function nowSeconds(): number;
+export interface MemoryRow {
+    id: string;
+    project_id: string;
+    chat_id: string | null;
+    category: string;
+    content: string;
+    subject: string | null;
+    topics: string | null;
+    tags: string | null;
+    links: string | null;
+    importance: number;
+    active: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface CategoryRecord {
+    canonical: string;
+    display_name: string;
+    db_file: string;
+    created_at: number;
+}
+export declare function openCategoryDb(file: string): Db;
+/** Compatibility alias for callers that open a single category database. */
+export declare const openDb: typeof openCategoryDb;
+export declare function openCatalog(file: string): Db;
+export declare function listCategories(catalog: Db): CategoryRecord[];
+export declare function categoryRecord(catalog: Db, canonical: string): CategoryRecord | undefined;
+export declare function registerCategory(catalog: Db, record: CategoryRecord): CategoryRecord;
+export declare function metadataValue(catalog: Db, key: string): string | undefined;
+export declare function setMetadata(catalog: Db, key: string, value: string): void;
+export declare function insertRow(db: Db, row: MemoryRow, ignore?: boolean): void;
+export declare function updateRow(db: Db, row: MemoryRow): void;
+export declare function replaceLabels(db: Db, memoryId: string, labels: {
+    topics: readonly string[];
+    tags: readonly string[];
+    links: readonly string[];
+}): void;

package/dist/db.js

@@ -0,0 +1,158 @@
+import Database from "better-sqlite3";
+import { mkdirSync } from "node:fs";
+import path from "node:path";
+const MS_FLOOR = 1_000_000_000_000;
+export function nowSeconds() {
+    return Math.floor(Date.now() / 1000);
+}
+const CATEGORY_SCHEMA = `
+CREATE TABLE IF NOT EXISTS memories (
+    id TEXT PRIMARY KEY,
+    project_id TEXT NOT NULL,
+    chat_id TEXT,
+    category TEXT NOT NULL,
+    content TEXT NOT NULL,
+    subject TEXT,
+    topics TEXT,
+    tags TEXT,
+    links TEXT,
+    importance REAL DEFAULT 0.5,
+    active INTEGER DEFAULT 1,
+    created_at INTEGER NOT NULL,
+    updated_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS memories_chat_idx ON memories(chat_id, active);
+CREATE INDEX IF NOT EXISTS memories_subject_idx ON memories(subject);
+CREATE INDEX IF NOT EXISTS memories_importance_idx ON memories(importance);
+CREATE INDEX IF NOT EXISTS memories_created_idx ON memories(created_at);
+CREATE INDEX IF NOT EXISTS memories_updated_idx ON memories(updated_at);
+
+CREATE TABLE IF NOT EXISTS memory_labels (
+    memory_id TEXT NOT NULL,
+    kind TEXT NOT NULL CHECK(kind IN ('topic', 'tag', 'link')),
+    value TEXT NOT NULL,
+    PRIMARY KEY(memory_id, kind, value),
+    FOREIGN KEY(memory_id) REFERENCES memories(id) ON DELETE CASCADE
+);
+CREATE INDEX IF NOT EXISTS memory_labels_lookup_idx ON memory_labels(kind, value, memory_id);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
+    content,
+    subject,
+    topics,
+    tags,
+    links,
+    content='memories',
+    content_rowid='rowid',
+    tokenize='porter unicode61'
+);
+
+CREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN
+  INSERT INTO memories_fts(rowid, content, subject, topics, tags, links)
+  VALUES (new.rowid, new.content, new.subject, new.topics, new.tags, new.links);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN
+  INSERT INTO memories_fts(memories_fts, rowid, content, subject, topics, tags, links)
+  VALUES ('delete', old.rowid, old.content, old.subject, old.topics, old.tags, old.links);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN
+  INSERT INTO memories_fts(memories_fts, rowid, content, subject, topics, tags, links)
+  VALUES ('delete', old.rowid, old.content, old.subject, old.topics, old.tags, old.links);
+  INSERT INTO memories_fts(rowid, content, subject, topics, tags, links)
+  VALUES (new.rowid, new.content, new.subject, new.topics, new.tags, new.links);
+END;
+`;
+const CATALOG_SCHEMA = `
+CREATE TABLE IF NOT EXISTS categories (
+    canonical TEXT PRIMARY KEY,
+    display_name TEXT NOT NULL,
+    db_file TEXT NOT NULL UNIQUE,
+    created_at INTEGER NOT NULL
+);
+CREATE TABLE IF NOT EXISTS metadata (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL
+);
+`;
+function configure(db) {
+    db.pragma("journal_mode = WAL");
+    db.pragma("busy_timeout = 5000");
+    db.pragma("synchronous = NORMAL");
+    db.pragma("foreign_keys = ON");
+}
+export function openCategoryDb(file) {
+    mkdirSync(path.dirname(file), { recursive: true });
+    const db = new Database(file);
+    configure(db);
+    db.exec(CATEGORY_SCHEMA);
+    db.exec(`
+    UPDATE memories SET created_at = created_at / 1000 WHERE created_at >= ${MS_FLOOR};
+    UPDATE memories SET updated_at = updated_at / 1000 WHERE updated_at >= ${MS_FLOOR};
+  `);
+    return db;
+}
+/** Compatibility alias for callers that open a single category database. */
+export const openDb = openCategoryDb;
+export function openCatalog(file) {
+    mkdirSync(path.dirname(file), { recursive: true });
+    const db = new Database(file);
+    configure(db);
+    db.exec(CATALOG_SCHEMA);
+    return db;
+}
+export function listCategories(catalog) {
+    return catalog
+        .prepare(`SELECT canonical, display_name, db_file, created_at FROM categories ORDER BY display_name`)
+        .all();
+}
+export function categoryRecord(catalog, canonical) {
+    return catalog
+        .prepare(`SELECT canonical, display_name, db_file, created_at FROM categories WHERE canonical = ?`)
+        .get(canonical);
+}
+export function registerCategory(catalog, record) {
+    catalog
+        .prepare(`INSERT OR IGNORE INTO categories (canonical, display_name, db_file, created_at)
+       VALUES (@canonical, @display_name, @db_file, @created_at)`)
+        .run(record);
+    return categoryRecord(catalog, record.canonical) ?? record;
+}
+export function metadataValue(catalog, key) {
+    const row = catalog.prepare(`SELECT value FROM metadata WHERE key = ?`).get(key);
+    return row?.value;
+}
+export function setMetadata(catalog, key, value) {
+    catalog
+        .prepare(`INSERT INTO metadata (key, value) VALUES (?, ?)
+       ON CONFLICT(key) DO UPDATE SET value = excluded.value`)
+        .run(key, value);
+}
+export function insertRow(db, row, ignore = false) {
+    db.prepare(`INSERT ${ignore ? "OR IGNORE " : ""}INTO memories
+     (id, project_id, chat_id, category, content, subject, topics, tags, links,
+      importance, active, created_at, updated_at)
+     VALUES (@id, @project_id, @chat_id, @category, @content, @subject, @topics, @tags, @links,
+             @importance, @active, @created_at, @updated_at)`).run(row);
+}
+export function updateRow(db, row) {
+    db.prepare(`UPDATE memories SET content = @content, category = @category, subject = @subject,
+      topics = @topics, tags = @tags, links = @links, importance = @importance,
+      chat_id = @chat_id, updated_at = @updated_at WHERE id = @id`).run(row);
+}
+export function replaceLabels(db, memoryId, labels) {
+    const remove = db.prepare(`DELETE FROM memory_labels WHERE memory_id = ?`);
+    const insert = db.prepare(`INSERT INTO memory_labels (memory_id, kind, value) VALUES (?, ?, ?)`);
+    db.transaction(() => {
+        remove.run(memoryId);
+        for (const value of labels.topics)
+            insert.run(memoryId, "topic", value);
+        for (const value of labels.tags)
+            insert.run(memoryId, "tag", value);
+        for (const value of labels.links)
+            insert.run(memoryId, "link", value);
+    })();
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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