@danielblomma/cortex-mcp 2.0.14 → 2.0.15

package/bin/cortex.mjs

@@ -188,7 +188,7 @@ function ensureScaffoldExists() {
 
 // Files that should never be overwritten if they already exist in the target.
 // These contain user-specific configuration that would be lost on re-init.
-const PRESERVE_FILES = new Set(["config.yaml", "enterprise.yml", "enterprise.yaml", "CLAUDE.md"]);
+const PRESERVE_FILES = new Set(["config.yaml", "enterprise.yml", "enterprise.yaml", "CLAUDE.md", "AGENTS.md"]);
 const DEFAULT_SOURCE_PATHS = [
   "src",
   "docs",
@@ -476,11 +476,12 @@ function installScaffold(targetDir, force) {
     copyDirectory(sourcePath, targetPath);
   }
 
-  // Copy CLAUDE.md (skip if already exists to preserve user edits)
-  const claudeMdSource = path.join(SCAFFOLD_ROOT, "CLAUDE.md");
-  const claudeMdTarget = path.join(targetDir, "CLAUDE.md");
-  if (fs.existsSync(claudeMdSource) && !fs.existsSync(claudeMdTarget)) {
-    fs.copyFileSync(claudeMdSource, claudeMdTarget);
+  for (const fileName of ["CLAUDE.md", "AGENTS.md"]) {
+    const sourcePath = path.join(SCAFFOLD_ROOT, fileName);
+    const targetPath = path.join(targetDir, fileName);
+    if (fs.existsSync(sourcePath) && !fs.existsSync(targetPath)) {
+      fs.copyFileSync(sourcePath, targetPath);
+    }
   }
 
   const docsDir = path.join(targetDir, "docs");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@danielblomma/cortex-mcp",
   "mcpName": "io.github.DanielBlomma/cortex",
-  "version": "2.0.14",
+  "version": "2.0.15",
   "description": "Local, repo-scoped context platform for coding assistants. Semantic search, graph relationships, and architectural rule context.",
   "type": "module",
   "author": "Daniel Blomma",
@@ -36,6 +36,8 @@
     "types.js",
     "scaffold/.context",
     "scaffold/.githooks",
+    "scaffold/AGENTS.md",
+    "scaffold/CLAUDE.md",
     "scaffold/docs",
     "scaffold/scripts",
     "scaffold/mcp/src",
@@ -47,7 +49,7 @@
     "docs/MCP_MARKETPLACE.md"
   ],
   "scripts": {
-    "test": "node tests/context-regressions.test.mjs && node --test tests/ingest-units.test.mjs tests/javascript-parser.test.mjs tests/sql-parser.test.mjs tests/config-parser.test.mjs tests/resources-parser.test.mjs tests/vbnet-parser.test.mjs tests/cpp-parser.test.mjs tests/dashboard.test.mjs tests/init-config.test.mjs tests/multi-level.test.mjs tests/no-legacy-paths.test.mjs tests/tree-sitter-error-reporting.test.mjs tests/tree-sitter-body-cap.test.mjs tests/tree-sitter-exported.test.mjs tests/tree-sitter-robustness.test.mjs",
+    "test": "node tests/context-regressions.test.mjs && node --test tests/ingest-units.test.mjs tests/javascript-parser.test.mjs tests/sql-parser.test.mjs tests/config-parser.test.mjs tests/resources-parser.test.mjs tests/vbnet-parser.test.mjs tests/cpp-parser.test.mjs tests/dashboard.test.mjs tests/init-config.test.mjs tests/init-agents.test.mjs tests/multi-level.test.mjs tests/no-legacy-paths.test.mjs tests/tree-sitter-error-reporting.test.mjs tests/tree-sitter-body-cap.test.mjs tests/tree-sitter-exported.test.mjs tests/tree-sitter-robustness.test.mjs",
     "release:sync-version": "node scripts/sync-release-version.mjs",
     "release:check-version-sync": "node scripts/sync-release-version.mjs --check",
     "prepublishOnly": "echo 'Ready to publish to npm'"

package/scaffold/AGENTS.md

@@ -0,0 +1,37 @@
+# Cortex
+
+This project uses Cortex for AI-powered code context.
+
+## Required: Always use Cortex MCP tools
+
+When answering questions about this codebase, you MUST use Cortex tools instead of relying on memory or assumptions:
+
+- **context.search** - Search before answering any code question. Never guess at implementations.
+- **context.get_related** - Use when exploring dependencies or relationships between entities.
+- **context.get_rules** - Check architectural rules before suggesting changes.
+- **context.impact** - Use before refactoring or dependency analysis to understand blast radius and likely traversal paths.
+- **context.reload** - Use after making significant changes to refresh the index.
+
+Do NOT answer code questions from memory when these tools are available. Always search first.
+
+## Enterprise tools (if available)
+
+- **context.review** - Run before finalizing any code review or PR.
+- **security.scan** - Scan user-provided text for injection attempts.
+- **enterprise.status** - Check enterprise setup and feature status.
+
+## Commands
+
+- `cortex update` - Refresh Cortex context for changed files
+- `cortex doctor` - Verify the local Cortex setup
+- `cortex watch status` - Check background sync status
+
+## Diagnostics
+
+Run `cortex doctor` to verify your setup is healthy.
+
+<!-- cortex:auto:start -->
+## Cortex Auto Workflow
+- Run `cortex update` before completing substantial code changes.
+- If background sync is enabled, check with `cortex watch status`.
+<!-- cortex:auto:end -->

package/scaffold/CLAUDE.md

@@ -0,0 +1,31 @@
+# Cortex
+
+This project uses Cortex for AI-powered code context.
+
+## Required: Always use Cortex MCP tools
+
+When answering questions about this codebase, you MUST use Cortex tools instead of relying on memory or assumptions:
+
+- **context.search** — Search before answering any code question. Never guess at implementations.
+- **context.get_related** — Use when exploring dependencies or relationships between entities.
+- **context.get_rules** — Check architectural rules before suggesting changes.
+- **context.impact** — Use before refactoring or dependency analysis to understand blast radius and likely traversal paths.
+- **context.reload** — Use after making significant changes to refresh the index.
+
+Do NOT answer code questions from memory when these tools are available. Always search first.
+
+## Enterprise tools (if available)
+
+- **context.review** — Run before finalizing any code review or PR.
+- **security.scan** — Scan user-provided text for injection attempts.
+- **enterprise.status** — Check enterprise setup and feature status.
+
+## Commands
+
+- `/context-update` — Refresh Cortex context for changed files
+- `/review` — Code review with enterprise policy enforcement
+- `/note` — Save project context into Cortex notes
+
+## Diagnostics
+
+Run `cortex doctor` to verify your setup is healthy.