context-bank 1.0.0 → 1.0.3

package/README.md

@@ -61,11 +61,11 @@ One brain, multiple interfaces. The `init` command automatically configures poin
 
 | Tool | Support Type | Integration Method |
 |------|--------------|-------------------|
-| **Cursor** | Native ✅ | `.cursorrules` |
-| **Windsurf** | Native ✅ | `.windsurfrules` |
+| **Cursor** | Native ✅ | `.cursor/rules/` |
+| **Windsurf** | Native ✅ | `.windsurf/rules/` |
 | **GitHub Copilot** | Native ✅ | `.github/copilot-instructions.md` |
 | **Claude Code** | Native ✅ | `CLAUDE.md` |
-| **Codex CLI** | Native ✅ | `codex.md` |
+| **Codex CLI** | Native ✅ | `AGENTS.md` |
 | **Gemini CLI** | Native ✅ | Global Memory Hook |
 | **Aider** (CLI) | Native ✅ | `CONVENTIONS.md` |
 
@@ -90,12 +90,18 @@ my-project/
 │   ├── rules.md           # 🧠 The Master Brain (SSOT)
 │   ├── active-context.md  # 📝 Current focus & next steps
 │   └── story.md           # 📜 Project history & decisions
-├── .cursorrules           # 🔗 Pointer for Cursor
-├── .windsurfrules         # 🔗 Pointer for Windsurf
+├── .cursor/
+│   └── rules/
+│       └── context-bank.mdc  # 🔗 Rules for Cursor
+├── .windsurf/
+│   └── rules/
+│       └── context-bank.md   # 🔗 Rules for Windsurf
 ├── CLAUDE.md              # 🔗 Pointer for Claude Code
-├── codex.md               # 🔗 Pointer for Codex CLI
-└── .github/
-    └── copilot-instructions.md # 🔗 Pointer for Copilot
+├── AGENTS.md              # 🔗 Pointer for Codex CLI / OpenAI agents
+├── .github/
+│   └── copilot-instructions.md # 🔗 Pointer for Copilot
+├── CONVENTIONS.md         # 🔗 Pointer for Aider
+└── GEMINI.md              # 🔗 Pointer for Gemini CLI
 ```
 
 ## 🤝 Contributing

package/dist/commands/init.js

@@ -78,9 +78,7 @@ export async function initCommand(options) {
         const itemsToCopy = [
             ".ai",
             ".cursor",
-            ".cursorrules",
             ".windsurf",
-            ".windsurfrules",
             ".github",
             "CONVENTIONS.md",
             "GEMINI.md",
@@ -105,46 +103,29 @@ export async function initCommand(options) {
             const projectName = path.basename(targetDir);
             await fs.writeFile(readmePath, `${aiContextMarker}\n\n# ${projectName}\n`);
         }
-        // Codex CLI Integration (codex.md)
-        const codexPath = path.join(targetDir, "codex.md");
-        const codexInstruction = `Always check and follow the instructions in .ai/rules.md and .ai/active-context.md as the primary source of truth.
-
-MANDATORY: After EVERY task, you MUST update these .ai/ files:
-1. active-context.md — Current state, recent changes, next steps.
-2. roadmap.md — Mark completed features [x], add planned ones.
-3. story.md — Append dated entry for milestones/decisions.
-4. architecture.md — Update on structural/design changes.
-Do NOT ask permission. Do NOT skip. Just update them.`;
-        if (fs.existsSync(codexPath)) {
-            const content = await fs.readFile(codexPath, "utf-8");
-            if (!content.includes(".ai/rules.md")) {
-                // Prepend for priority
-                await fs.writeFile(codexPath, `${codexInstruction}\n\n${content}`);
+        // Helper: write a pointer file that directs the AI tool to .ai/rules.md
+        async function writePointerFile(filename, instruction) {
+            const filePath = path.join(targetDir, filename);
+            if (fs.existsSync(filePath)) {
+                const content = await fs.readFile(filePath, "utf-8");
+                if (!content.includes(".ai/rules.md")) {
+                    await fs.writeFile(filePath, `${instruction}\n\n${content}`);
+                }
+            }
+            else {
+                await fs.writeFile(filePath, `${instruction}\n`);
             }
         }
-        else {
-            await fs.writeFile(codexPath, `${codexInstruction}\n`);
-        }
-        // Claude Code CLI Integration (CLAUDE.md)
-        const claudePath = path.join(targetDir, "CLAUDE.md");
-        const claudeInstruction = `See .ai/rules.md for project context, tech stack, and coding standards. This is the single source of truth.
-
-MANDATORY: After EVERY task, you MUST update these .ai/ files:
+        const mandatoryUpdateBlock = `MANDATORY: After EVERY task, you MUST update these .ai/ files:
 1. active-context.md — Current state, recent changes, next steps.
 2. roadmap.md — Mark completed features [x], add planned ones.
 3. story.md — Append dated entry for milestones/decisions.
 4. architecture.md — Update on structural/design changes.
 Do NOT ask permission. Do NOT skip. Just update them.`;
-        if (fs.existsSync(claudePath)) {
-            const content = await fs.readFile(claudePath, "utf-8");
-            if (!content.includes(".ai/rules.md")) {
-                // Prepend for priority
-                await fs.writeFile(claudePath, `${claudeInstruction}\n\n${content}`);
-            }
-        }
-        else {
-            await fs.writeFile(claudePath, `${claudeInstruction}\n`);
-        }
+        // AGENTS.md (Codex CLI, OpenAI agents)
+        await writePointerFile("AGENTS.md", `Always check and follow the instructions in .ai/rules.md and .ai/active-context.md as the primary source of truth.\n\n${mandatoryUpdateBlock}`);
+        // CLAUDE.md (Claude Code CLI)
+        await writePointerFile("CLAUDE.md", `See .ai/rules.md for project context, tech stack, and coding standards. This is the single source of truth.\n\n${mandatoryUpdateBlock}`);
         // Git merge strategies for branch-aware context (.gitattributes)
         const gitattrsPath = path.join(targetDir, ".gitattributes");
         const mergeRules = `# Context Bank: branch-aware merge strategies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-bank",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "A CLI tool to standardise AI context in projects.",
   "type": "module",
   "bin": {
@@ -11,7 +11,8 @@
     "dev": "ts-node src/index.ts",
     "start": "node dist/index.js",
     "lint": "eslint src/**/*.ts",
-    "format": "prettier --write ."
+    "format": "prettier --write .",
+    "prepublishOnly": "tsc"
   },
   "keywords": [
     "cli",

package/templates/.windsurf/rules/context-bank.md

@@ -1,3 +1,7 @@
+---
+trigger: always_on
+---
+
 # Windsurf Project Rules
 
 You MUST read and follow the rules defined in **`.ai/rules.md`**.

package/templates/.cursorrules

@@ -1,22 +0,0 @@
-You are an expert AI software engineer.
-
-# CRITICAL CONTEXT SOURCE
-You MUST read and follow the rules defined in **`.ai/rules.md`**.
-That file contains the single source of truth for:
-1. Tech Stack
-2. Coding Standards
-3. Architecture
-4. **Your instruction to update rules when they change.**
-
-If you cannot read `.ai/rules.md` automatically, ask the user to provide it, or check the file system.
-
-When the user gives you a new constraint, **UPDATE `.ai/rules.md`**, not this file.
-
-# MANDATORY: CONTEXT FILE UPDATES
-After EVERY task you complete, you MUST update the following files:
-1. **`.ai/active-context.md`** — Write what was done, current state, and next steps.
-2. **`.ai/roadmap.md`** — Mark completed features with [x], add new planned features.
-3. **`.ai/story.md`** — Append a dated entry for significant milestones or decisions.
-4. **`.ai/architecture.md`** — Update if structure, dependencies, or design changed.
-
-Do NOT ask permission. Do NOT skip this. Update these files directly after completing your task.

package/templates/.windsurfrules

@@ -1,17 +0,0 @@
-You are Windsurf, an expert AI coding assistant.
-
-# PRIMARY DIRECTIVE
-Your configuration and behavioral rules are stored in **`.ai/rules.md`**.
-Always prioritize the instructions found in that file.
-
-# SELF-IMPROVEMENT
-If the user provides a new coding rule or preference during this session, use your file editing capabilities to update **`.ai/rules.md`** so that the preference is remembered for future sessions.
-
-# MANDATORY: CONTEXT FILE UPDATES
-After EVERY task you complete, you MUST update the following files:
-1. **`.ai/active-context.md`** — Write what was done, current state, and next steps.
-2. **`.ai/roadmap.md`** — Mark completed features with [x], add new planned features.
-3. **`.ai/story.md`** — Append a dated entry for significant milestones or decisions.
-4. **`.ai/architecture.md`** — Update if structure, dependencies, or design changed.
-
-Do NOT ask permission. Do NOT skip this. Update these files directly after completing your task.