@norescan/agent-adapters 0.0.0-stage → 0.1.1

package/dist/adapter.d.ts

@@ -0,0 +1,9 @@
+export interface AgentAdapter {
+    readonly name: string;
+    readonly displayName: string;
+    readonly description: string;
+    install(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    uninstall(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    validate(projectRoot: string): Promise<boolean>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD"}

package/dist/adapter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":""}

package/dist/adapters/antigravity.d.ts

@@ -0,0 +1,10 @@
+import { AgentAdapter } from '../adapter.js';
+export declare class AntigravityAdapter implements AgentAdapter {
+    readonly name = "antigravity";
+    readonly displayName = "Google Antigravity";
+    readonly description = "Registers norescan MCP server in .gemini/antigravity/mcp/ and sets up workspace rules in AGENTS.md";
+    install(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    uninstall(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    validate(projectRoot: string): Promise<boolean>;
+}
+//# sourceMappingURL=antigravity.d.ts.map

package/dist/adapters/antigravity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antigravity.d.ts","sourceRoot":"","sources":["../../src/adapters/antigravity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAY7C,qBAAa,kBAAmB,YAAW,YAAY;IACrD,SAAgB,IAAI,iBAAiB;IACrC,SAAgB,WAAW,wBAAwB;IACnD,SAAgB,WAAW,wGAAwG;IAEtH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4C/D,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBjE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAS7D"}

package/dist/adapters/antigravity.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AntigravityAdapter = void 0;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const ANTIGRAVITY_RULE_BANNER = '<!-- norescan:ANTIGRAVITY:START -->';
+const ANTIGRAVITY_RULE_CONTENT = `
+${ANTIGRAVITY_RULE_BANNER}
+## norescan Persistent Memory Protocol
+Before substantial coding tasks, use norescan MCP tools (\`get_task_context\`) or run \`norescan context "<task>"\` to retrieve verified file analyses and dependencies without repeating full codebase scans. Always inspect live source files before editing. After completing work, record architectural decisions using \`record_decision\`.
+<!-- norescan:ANTIGRAVITY:END -->
+`;
+class AntigravityAdapter {
+    name = 'antigravity';
+    displayName = 'Google Antigravity';
+    description = 'Registers norescan MCP server in .gemini/antigravity/mcp/ and sets up workspace rules in AGENTS.md';
+    async install(projectRoot, dryRun = false) {
+        const created = [];
+        // 1. MCP Configuration
+        const mcpDir = node_path_1.default.join(projectRoot, '.gemini', 'antigravity', 'mcp');
+        const mcpFile = node_path_1.default.join(mcpDir, 'norescan.json');
+        const mcpConfig = {
+            mcpServers: {
+                'norescan': {
+                    command: 'norescan-mcp',
+                    args: [],
+                    env: {},
+                },
+            },
+        };
+        if (!dryRun) {
+            await promises_1.default.mkdir(mcpDir, { recursive: true });
+            await promises_1.default.writeFile(mcpFile, JSON.stringify(mcpConfig, null, 2), 'utf8');
+        }
+        created.push(mcpFile);
+        // 2. Rules in AGENTS.md (idempotent)
+        const agentsMdPath = node_path_1.default.join(projectRoot, 'AGENTS.md');
+        let existingContent = '';
+        try {
+            existingContent = await promises_1.default.readFile(agentsMdPath, 'utf8');
+        }
+        catch {
+            // file doesn't exist
+        }
+        if (!existingContent.includes(ANTIGRAVITY_RULE_BANNER)) {
+            const newContent = existingContent
+                ? `${existingContent.trim()}\n\n${ANTIGRAVITY_RULE_CONTENT.trim()}\n`
+                : ANTIGRAVITY_RULE_CONTENT.trim() + '\n';
+            if (!dryRun) {
+                await promises_1.default.writeFile(agentsMdPath, newContent, 'utf8');
+            }
+            created.push(agentsMdPath);
+        }
+        return created;
+    }
+    async uninstall(projectRoot, dryRun = false) {
+        const removed = [];
+        const mcpFile = node_path_1.default.join(projectRoot, '.gemini', 'antigravity', 'mcp', 'norescan.json');
+        try {
+            if (!dryRun)
+                await promises_1.default.unlink(mcpFile);
+            removed.push(mcpFile);
+        }
+        catch { }
+        const agentsMdPath = node_path_1.default.join(projectRoot, 'AGENTS.md');
+        try {
+            const content = await promises_1.default.readFile(agentsMdPath, 'utf8');
+            if (content.includes(ANTIGRAVITY_RULE_BANNER)) {
+                const cleaned = content.replace(/<!-- norescan:ANTIGRAVITY:START -->[\s\S]*?<!-- norescan:ANTIGRAVITY:END -->/g, '').trim() + '\n';
+                if (!dryRun)
+                    await promises_1.default.writeFile(agentsMdPath, cleaned, 'utf8');
+                removed.push(agentsMdPath);
+            }
+        }
+        catch { }
+        return removed;
+    }
+    async validate(projectRoot) {
+        try {
+            const mcpFile = node_path_1.default.join(projectRoot, '.gemini', 'antigravity', 'mcp', 'norescan.json');
+            const content = await promises_1.default.readFile(mcpFile, 'utf8');
+            return content.includes('norescan-mcp');
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.AntigravityAdapter = AntigravityAdapter;
+//# sourceMappingURL=antigravity.js.map

package/dist/adapters/antigravity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"antigravity.js","sourceRoot":"","sources":["../../src/adapters/antigravity.ts"],"names":[],"mappings":";;;;;;AACA,gEAAkC;AAClC,0DAA6B;AAE7B,MAAM,uBAAuB,GAAG,qCAAqC,CAAC;AACtE,MAAM,wBAAwB,GAAG;EAC/B,uBAAuB;;;;CAIxB,CAAC;AAEF,MAAa,kBAAkB;IACb,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAAG,oBAAoB,CAAC;IACnC,WAAW,GAAG,oGAAoG,CAAC;IAE5H,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAAM,GAAG,KAAK;QACtD,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,uBAAuB;QACvB,MAAM,MAAM,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG;YAChB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,OAAO,EAAE,cAAc;oBACvB,IAAI,EAAE,EAAE;oBACR,GAAG,EAAE,EAAE;iBACR;aACF;SACF,CAAC;QAEF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,kBAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,MAAM,kBAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtB,qCAAqC;QACrC,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,eAAe,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,eAAe,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;YACvD,MAAM,UAAU,GAAG,eAAe;gBAChC,CAAC,CAAC,GAAG,eAAe,CAAC,IAAI,EAAE,OAAO,wBAAwB,CAAC,IAAI,EAAE,IAAI;gBACrE,CAAC,CAAC,wBAAwB,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;YAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,kBAAE,CAAC,SAAS,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;YACvD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,WAAmB,EAAE,MAAM,GAAG,KAAK;QACxD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QACzF,IAAI,CAAC;YACH,IAAI,CAAC,MAAM;gBAAE,MAAM,kBAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC,CAAC,CAAC;QAEX,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACxD,IAAI,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAC7B,+EAA+E,EAC/E,EAAE,CACH,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,MAAM;oBAAE,MAAM,kBAAE,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC/D,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,CAAC;QAEX,OAAO,OAAO,CAAC;IACjB,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,WAAmB;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;YACzF,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACnD,OAAO,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AAlFD,gDAkFC"}

package/dist/adapters/claude.d.ts

@@ -0,0 +1,10 @@
+import { AgentAdapter } from '../adapter.js';
+export declare class ClaudeCodeAdapter implements AgentAdapter {
+    readonly name = "claude-code";
+    readonly displayName = "Claude Code";
+    readonly description = "Configures Claude Code project MCP server in .claude/config.json and CLAUDE.md";
+    install(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    uninstall(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    validate(projectRoot: string): Promise<boolean>;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C,qBAAa,iBAAkB,YAAW,YAAY;IACpD,SAAgB,IAAI,iBAAiB;IACrC,SAAgB,WAAW,iBAAiB;IAC5C,SAAgB,WAAW,oFAAoF;IAElG,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiD/D,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA6BjE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAS7D"}

package/dist/adapters/claude.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeCodeAdapter = void 0;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+class ClaudeCodeAdapter {
+    name = 'claude-code';
+    displayName = 'Claude Code';
+    description = 'Configures Claude Code project MCP server in .claude/config.json and CLAUDE.md';
+    async install(projectRoot, dryRun = false) {
+        const created = [];
+        // 1. .claude/config.json
+        const claudeDir = node_path_1.default.join(projectRoot, '.claude');
+        const configFile = node_path_1.default.join(claudeDir, 'config.json');
+        let config = { mcpServers: {} };
+        try {
+            const existing = await promises_1.default.readFile(configFile, 'utf8');
+            config = JSON.parse(existing);
+            if (!config.mcpServers)
+                config.mcpServers = {};
+        }
+        catch { }
+        config.mcpServers['norescan'] = {
+            command: 'norescan-mcp',
+            args: [],
+        };
+        if (!dryRun) {
+            await promises_1.default.mkdir(claudeDir, { recursive: true });
+            await promises_1.default.writeFile(configFile, JSON.stringify(config, null, 2), 'utf8');
+        }
+        created.push(configFile);
+        // 2. CLAUDE.md
+        const claudeMd = node_path_1.default.join(projectRoot, 'CLAUDE.md');
+        const banner = '<!-- norescan:CLAUDE:START -->';
+        let existing = '';
+        try {
+            existing = await promises_1.default.readFile(claudeMd, 'utf8');
+        }
+        catch { }
+        if (!existing.includes(banner)) {
+            const instructions = `
+${banner}
+# norescan Persistent Memory
+- Before starting substantial tasks, call \`get_task_context\` to retrieve relevant files and avoid re-analyzing unchanged files.
+- Inspect live source files before writing edits.
+- Record architectural decisions using \`record_decision\`.
+<!-- norescan:CLAUDE:END -->
+`;
+            const updated = existing ? `${existing.trim()}\n\n${instructions.trim()}\n` : instructions.trim() + '\n';
+            if (!dryRun)
+                await promises_1.default.writeFile(claudeMd, updated, 'utf8');
+            created.push(claudeMd);
+        }
+        return created;
+    }
+    async uninstall(projectRoot, dryRun = false) {
+        const removed = [];
+        const configFile = node_path_1.default.join(projectRoot, '.claude', 'config.json');
+        try {
+            const content = await promises_1.default.readFile(configFile, 'utf8');
+            const parsed = JSON.parse(content);
+            if (parsed.mcpServers?.['norescan']) {
+                delete parsed.mcpServers['norescan'];
+                if (!dryRun)
+                    await promises_1.default.writeFile(configFile, JSON.stringify(parsed, null, 2), 'utf8');
+                removed.push(configFile);
+            }
+        }
+        catch { }
+        const claudeMd = node_path_1.default.join(projectRoot, 'CLAUDE.md');
+        try {
+            const content = await promises_1.default.readFile(claudeMd, 'utf8');
+            if (content.includes('<!-- norescan:CLAUDE:START -->')) {
+                const cleaned = content.replace(/<!-- norescan:CLAUDE:START -->[\s\S]*?<!-- norescan:CLAUDE:END -->/g, '').trim() + '\n';
+                if (!dryRun)
+                    await promises_1.default.writeFile(claudeMd, cleaned, 'utf8');
+                removed.push(claudeMd);
+            }
+        }
+        catch { }
+        return removed;
+    }
+    async validate(projectRoot) {
+        try {
+            const configFile = node_path_1.default.join(projectRoot, '.claude', 'config.json');
+            const content = await promises_1.default.readFile(configFile, 'utf8');
+            return content.includes('norescan-mcp');
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.ClaudeCodeAdapter = ClaudeCodeAdapter;
+//# sourceMappingURL=claude.js.map

package/dist/adapters/claude.js.map

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

package/dist/adapters/codex.d.ts

@@ -0,0 +1,10 @@
+import { AgentAdapter } from '../adapter.js';
+export declare class CodexAdapter implements AgentAdapter {
+    readonly name = "codex";
+    readonly displayName = "OpenAI Codex";
+    readonly description = "Sets up CLI workflow instructions in AGENTS.md for OpenAI Codex";
+    install(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    uninstall(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    validate(projectRoot: string): Promise<boolean>;
+}
+//# sourceMappingURL=codex.d.ts.map

package/dist/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C,qBAAa,YAAa,YAAW,YAAY;IAC/C,SAAgB,IAAI,WAAW;IAC/B,SAAgB,WAAW,kBAAkB;IAC7C,SAAgB,WAAW,qEAAqE;IAEnF,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB/D,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBjE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAS7D"}

package/dist/adapters/codex.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodexAdapter = void 0;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+class CodexAdapter {
+    name = 'codex';
+    displayName = 'OpenAI Codex';
+    description = 'Sets up CLI workflow instructions in AGENTS.md for OpenAI Codex';
+    async install(projectRoot, dryRun = false) {
+        const agentsMdPath = node_path_1.default.join(projectRoot, 'AGENTS.md');
+        const banner = '<!-- norescan:CODEX:START -->';
+        let existing = '';
+        try {
+            existing = await promises_1.default.readFile(agentsMdPath, 'utf8');
+        }
+        catch { }
+        if (!existing.includes(banner)) {
+            const instructions = `
+${banner}
+# norescan Context Protocol for Codex
+Run \`norescan context "<task description>"\` before modifying code to review existing file analyses, dependency blast radius, and architectural decisions.
+<!-- norescan:CODEX:END -->
+`;
+            const updated = existing ? `${existing.trim()}\n\n${instructions.trim()}\n` : instructions.trim() + '\n';
+            if (!dryRun)
+                await promises_1.default.writeFile(agentsMdPath, updated, 'utf8');
+            return [agentsMdPath];
+        }
+        return [];
+    }
+    async uninstall(projectRoot, dryRun = false) {
+        const agentsMdPath = node_path_1.default.join(projectRoot, 'AGENTS.md');
+        try {
+            const content = await promises_1.default.readFile(agentsMdPath, 'utf8');
+            if (content.includes('<!-- norescan:CODEX:START -->')) {
+                const cleaned = content.replace(/<!-- norescan:CODEX:START -->[\s\S]*?<!-- norescan:CODEX:END -->/g, '').trim() + '\n';
+                if (!dryRun)
+                    await promises_1.default.writeFile(agentsMdPath, cleaned, 'utf8');
+                return [agentsMdPath];
+            }
+        }
+        catch { }
+        return [];
+    }
+    async validate(projectRoot) {
+        try {
+            const agentsMdPath = node_path_1.default.join(projectRoot, 'AGENTS.md');
+            const content = await promises_1.default.readFile(agentsMdPath, 'utf8');
+            return content.includes('norescan:CODEX');
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.CodexAdapter = CodexAdapter;
+//# sourceMappingURL=codex.js.map

package/dist/adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":";;;;;;AACA,gEAAkC;AAClC,0DAA6B;AAE7B,MAAa,YAAY;IACP,IAAI,GAAG,OAAO,CAAC;IACf,WAAW,GAAG,cAAc,CAAC;IAC7B,WAAW,GAAG,iEAAiE,CAAC;IAEzF,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAAM,GAAG,KAAK;QACtD,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,+BAA+B,CAAC;QAC/C,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC,CAAC,CAAC;QAEX,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG;EACzB,MAAM;;;;CAIP,CAAC;YACI,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;YACzG,IAAI,CAAC,MAAM;gBAAE,MAAM,kBAAE,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/D,OAAO,CAAC,YAAY,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,WAAmB,EAAE,MAAM,GAAG,KAAK;QACxD,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACxD,IAAI,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;gBACtD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAC7B,mEAAmE,EACnE,EAAE,CACH,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,MAAM;oBAAE,MAAM,kBAAE,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC/D,OAAO,CAAC,YAAY,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,WAAmB;QACvC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACxD,OAAO,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AApDD,oCAoDC"}

package/dist/adapters/cursor.d.ts

@@ -0,0 +1,10 @@
+import { AgentAdapter } from '../adapter.js';
+export declare class CursorAdapter implements AgentAdapter {
+    readonly name = "cursor";
+    readonly displayName = "Cursor / Windsurf";
+    readonly description = "Configures Cursor project MCP server in .cursor/mcp.json and rules in .cursor/rules/norescan.mdc";
+    install(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    uninstall(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    validate(projectRoot: string): Promise<boolean>;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/adapters/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C,qBAAa,aAAc,YAAW,YAAY;IAChD,SAAgB,IAAI,YAAY;IAChC,SAAgB,WAAW,uBAAuB;IAClD,SAAgB,WAAW,sGAAsG;IAEpH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA+C/D,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsBjE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAS7D"}

package/dist/adapters/cursor.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CursorAdapter = void 0;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+class CursorAdapter {
+    name = 'cursor';
+    displayName = 'Cursor / Windsurf';
+    description = 'Configures Cursor project MCP server in .cursor/mcp.json and rules in .cursor/rules/norescan.mdc';
+    async install(projectRoot, dryRun = false) {
+        const created = [];
+        // 1. .cursor/mcp.json
+        const cursorDir = node_path_1.default.join(projectRoot, '.cursor');
+        const mcpFile = node_path_1.default.join(cursorDir, 'mcp.json');
+        let mcpConfig = { mcpServers: {} };
+        try {
+            const existing = await promises_1.default.readFile(mcpFile, 'utf8');
+            mcpConfig = JSON.parse(existing);
+            if (!mcpConfig.mcpServers)
+                mcpConfig.mcpServers = {};
+        }
+        catch { }
+        mcpConfig.mcpServers['norescan'] = {
+            command: 'norescan-mcp',
+            args: [],
+        };
+        if (!dryRun) {
+            await promises_1.default.mkdir(cursorDir, { recursive: true });
+            await promises_1.default.writeFile(mcpFile, JSON.stringify(mcpConfig, null, 2), 'utf8');
+        }
+        created.push(mcpFile);
+        // 2. .cursor/rules/norescan.mdc
+        const rulesDir = node_path_1.default.join(cursorDir, 'rules');
+        const ruleFile = node_path_1.default.join(rulesDir, 'norescan.mdc');
+        const ruleContent = `---
+description: norescan Persistent Codebase Memory Rules
+globs: *
+---
+Before major refactoring or implementing features:
+- Query norescan via MCP tools (get_task_context) to retrieve relevant files and dependencies.
+- Avoid re-analyzing unchanged files when verified cached knowledge is available.
+- Read physical source code before writing edits.
+- Record architectural decisions using record_decision.
+`;
+        if (!dryRun) {
+            await promises_1.default.mkdir(rulesDir, { recursive: true });
+            await promises_1.default.writeFile(ruleFile, ruleContent, 'utf8');
+        }
+        created.push(ruleFile);
+        return created;
+    }
+    async uninstall(projectRoot, dryRun = false) {
+        const removed = [];
+        const mcpFile = node_path_1.default.join(projectRoot, '.cursor', 'mcp.json');
+        try {
+            const content = await promises_1.default.readFile(mcpFile, 'utf8');
+            const parsed = JSON.parse(content);
+            if (parsed.mcpServers?.['norescan']) {
+                delete parsed.mcpServers['norescan'];
+                if (!dryRun)
+                    await promises_1.default.writeFile(mcpFile, JSON.stringify(parsed, null, 2), 'utf8');
+                removed.push(mcpFile);
+            }
+        }
+        catch { }
+        const ruleFile = node_path_1.default.join(projectRoot, '.cursor', 'rules', 'norescan.mdc');
+        try {
+            if (!dryRun)
+                await promises_1.default.unlink(ruleFile);
+            removed.push(ruleFile);
+        }
+        catch { }
+        return removed;
+    }
+    async validate(projectRoot) {
+        try {
+            const mcpFile = node_path_1.default.join(projectRoot, '.cursor', 'mcp.json');
+            const content = await promises_1.default.readFile(mcpFile, 'utf8');
+            return content.includes('norescan-mcp');
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.CursorAdapter = CursorAdapter;
+//# sourceMappingURL=cursor.js.map

package/dist/adapters/cursor.js.map

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

package/dist/adapters/vscode.d.ts

@@ -0,0 +1,10 @@
+import { AgentAdapter } from '../adapter.js';
+export declare class VSCodeAdapter implements AgentAdapter {
+    readonly name = "vscode";
+    readonly displayName = "VS Code / GitHub Copilot";
+    readonly description = "Configures .vscode/mcp.json and .github/copilot-instructions.md";
+    install(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    uninstall(projectRoot: string, dryRun?: boolean): Promise<string[]>;
+    validate(projectRoot: string): Promise<boolean>;
+}
+//# sourceMappingURL=vscode.d.ts.map

package/dist/adapters/vscode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode.d.ts","sourceRoot":"","sources":["../../src/adapters/vscode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C,qBAAa,aAAc,YAAW,YAAY;IAChD,SAAgB,IAAI,YAAY;IAChC,SAAgB,WAAW,8BAA8B;IACzD,SAAgB,WAAW,qEAAqE;IAEnF,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmD/D,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBjE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAS7D"}

package/dist/adapters/vscode.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VSCodeAdapter = void 0;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+class VSCodeAdapter {
+    name = 'vscode';
+    displayName = 'VS Code / GitHub Copilot';
+    description = 'Configures .vscode/mcp.json and .github/copilot-instructions.md';
+    async install(projectRoot, dryRun = false) {
+        const created = [];
+        // 1. .vscode/mcp.json
+        const vscodeDir = node_path_1.default.join(projectRoot, '.vscode');
+        const mcpFile = node_path_1.default.join(vscodeDir, 'mcp.json');
+        let mcpConfig = { mcpServers: {} };
+        try {
+            const existing = await promises_1.default.readFile(mcpFile, 'utf8');
+            mcpConfig = JSON.parse(existing);
+            if (!mcpConfig.mcpServers)
+                mcpConfig.mcpServers = {};
+        }
+        catch { }
+        mcpConfig.mcpServers['norescan'] = {
+            command: 'norescan-mcp',
+            args: [],
+        };
+        if (!dryRun) {
+            await promises_1.default.mkdir(vscodeDir, { recursive: true });
+            await promises_1.default.writeFile(mcpFile, JSON.stringify(mcpConfig, null, 2), 'utf8');
+        }
+        created.push(mcpFile);
+        // 2. .github/copilot-instructions.md
+        const githubDir = node_path_1.default.join(projectRoot, '.github');
+        const copilotFile = node_path_1.default.join(githubDir, 'copilot-instructions.md');
+        const banner = '<!-- norescan:COPILOT:START -->';
+        let existing = '';
+        try {
+            existing = await promises_1.default.readFile(copilotFile, 'utf8');
+        }
+        catch { }
+        if (!existing.includes(banner)) {
+            const instructions = `
+${banner}
+# norescan Context Protocol
+Query norescan (\`norescan context "<task>"\`) before modifying code to inspect cached structural summaries, routes, and dependency relationships.
+<!-- norescan:COPILOT:END -->
+`;
+            const updated = existing ? `${existing.trim()}\n\n${instructions.trim()}\n` : instructions.trim() + '\n';
+            if (!dryRun) {
+                await promises_1.default.mkdir(githubDir, { recursive: true });
+                await promises_1.default.writeFile(copilotFile, updated, 'utf8');
+            }
+            created.push(copilotFile);
+        }
+        return created;
+    }
+    async uninstall(projectRoot, dryRun = false) {
+        const removed = [];
+        const mcpFile = node_path_1.default.join(projectRoot, '.vscode', 'mcp.json');
+        try {
+            const content = await promises_1.default.readFile(mcpFile, 'utf8');
+            const parsed = JSON.parse(content);
+            if (parsed.mcpServers?.['norescan']) {
+                delete parsed.mcpServers['norescan'];
+                if (!dryRun)
+                    await promises_1.default.writeFile(mcpFile, JSON.stringify(parsed, null, 2), 'utf8');
+                removed.push(mcpFile);
+            }
+        }
+        catch { }
+        return removed;
+    }
+    async validate(projectRoot) {
+        try {
+            const mcpFile = node_path_1.default.join(projectRoot, '.vscode', 'mcp.json');
+            const content = await promises_1.default.readFile(mcpFile, 'utf8');
+            return content.includes('norescan-mcp');
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.VSCodeAdapter = VSCodeAdapter;
+//# sourceMappingURL=vscode.js.map

package/dist/adapters/vscode.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { AgentAdapter } from './adapter.js';
+export * from './adapter.js';
+export * from './adapters/antigravity.js';
+export * from './adapters/cursor.js';
+export * from './adapters/claude.js';
+export * from './adapters/codex.js';
+export * from './adapters/vscode.js';
+export declare function getAdapter(name: string): AgentAdapter | undefined;
+export declare function getAllAdapters(): AgentAdapter[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO5C,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAUrC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEjE;AAED,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAE/C"}

package/dist/index.js

@@ -0,0 +1,43 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAdapter = getAdapter;
+exports.getAllAdapters = getAllAdapters;
+const antigravity_js_1 = require("./adapters/antigravity.js");
+const cursor_js_1 = require("./adapters/cursor.js");
+const claude_js_1 = require("./adapters/claude.js");
+const codex_js_1 = require("./adapters/codex.js");
+const vscode_js_1 = require("./adapters/vscode.js");
+__exportStar(require("./adapter.js"), exports);
+__exportStar(require("./adapters/antigravity.js"), exports);
+__exportStar(require("./adapters/cursor.js"), exports);
+__exportStar(require("./adapters/claude.js"), exports);
+__exportStar(require("./adapters/codex.js"), exports);
+__exportStar(require("./adapters/vscode.js"), exports);
+const ADAPTER_REGISTRY = {
+    antigravity: new antigravity_js_1.AntigravityAdapter(),
+    cursor: new cursor_js_1.CursorAdapter(),
+    'claude-code': new claude_js_1.ClaudeCodeAdapter(),
+    codex: new codex_js_1.CodexAdapter(),
+    vscode: new vscode_js_1.VSCodeAdapter(),
+};
+function getAdapter(name) {
+    return ADAPTER_REGISTRY[name.toLowerCase()];
+}
+function getAllAdapters() {
+    return Object.values(ADAPTER_REGISTRY);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAsBA,gCAEC;AAED,wCAEC;AA3BD,8DAA+D;AAC/D,oDAAqD;AACrD,oDAAyD;AACzD,kDAAmD;AACnD,oDAAqD;AAErD,+CAA6B;AAC7B,4DAA0C;AAC1C,uDAAqC;AACrC,uDAAqC;AACrC,sDAAoC;AACpC,uDAAqC;AAErC,MAAM,gBAAgB,GAAiC;IACrD,WAAW,EAAE,IAAI,mCAAkB,EAAE;IACrC,MAAM,EAAE,IAAI,yBAAa,EAAE;IAC3B,aAAa,EAAE,IAAI,6BAAiB,EAAE;IACtC,KAAK,EAAE,IAAI,uBAAY,EAAE;IACzB,MAAM,EAAE,IAAI,yBAAa,EAAE;CAC5B,CAAC;AAEF,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,cAAc;IAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACzC,CAAC"}

package/package.json

@@ -1,6 +1,28 @@
 {
   "name": "@norescan/agent-adapters",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Universal coding agent configuration adapters and installers for norescan",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@norescan/shared": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "Apache-2.0",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.