context-bank 0.0.9 → 1.0.0

package/dist/commands/init.js

@@ -107,7 +107,14 @@ export async function initCommand(options) {
         }
         // 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.";
+        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")) {
@@ -120,7 +127,14 @@ export async function initCommand(options) {
         }
         // 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.";
+        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:
+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")) {
@@ -131,6 +145,22 @@ export async function initCommand(options) {
         else {
             await fs.writeFile(claudePath, `${claudeInstruction}\n`);
         }
+        // Git merge strategies for branch-aware context (.gitattributes)
+        const gitattrsPath = path.join(targetDir, ".gitattributes");
+        const mergeRules = `# Context Bank: branch-aware merge strategies
+# active-context.md is branch-specific — on merge, target branch wins (no conflict)
+.ai/active-context.md merge=ours
+# story.md entries are additive — on merge, combine both sides (no conflict)
+.ai/story.md merge=union`;
+        if (fs.existsSync(gitattrsPath)) {
+            const content = await fs.readFile(gitattrsPath, "utf-8");
+            if (!content.includes("Context Bank")) {
+                await fs.writeFile(gitattrsPath, `${content}\n\n${mergeRules}\n`);
+            }
+        }
+        else {
+            await fs.writeFile(gitattrsPath, `${mergeRules}\n`);
+        }
         s.stop(chalk.green("Context initialized!"));
         // Gemini CLI Global Memory Integration
         const globalGeminiDir = path.join(os.homedir(), ".gemini");

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "context-bank",
-  "version": "0.0.9",
+  "version": "1.0.0",
   "description": "A CLI tool to standardise AI context in projects.",
   "type": "module",
   "bin": {
     "context-bank": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "pnpm lint && tsc",
     "dev": "ts-node src/index.ts",
     "start": "node dist/index.js",
     "lint": "eslint src/**/*.ts",
@@ -32,9 +32,14 @@
     "fs-extra": "^11.2.0"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "eslint": "^10.0.3",
     "ts-node": "^10.9.2",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "typescript-eslint": "^8.57.0"
   }
 }

package/templates/.ai/active-context.md

@@ -1,9 +1,19 @@
 # 🚀 Active Context & Current State
 
-> **AI AGENT INSTRUCTION:**
-> This file contains the **current focus** of the project.
-> **Update this file** at the end of every significant task or session.
-> When starting a new session, **READ THIS FIRST** to understand where we left off.
+> **⚠️ MANDATORY AI AGENT INSTRUCTION:**
+>
+> This file is the **most critical context file**. It is the bridge between sessions.
+>
+> **AFTER EVERY TASK — no matter how small — you MUST update this file with:**
+> 1. What was just completed (Recent Changes)
+> 2. What is being worked on now (Current Focus)
+> 3. Any issues encountered (Known Issues)
+> 4. What should happen next (Next Steps)
+>
+> **WHEN STARTING A NEW SESSION:**
+> Read this file FIRST before doing anything else.
+>
+> **DO NOT SKIP THIS UPDATE. DO NOT ASK PERMISSION. JUST DO IT.**
 
 ## 🎯 Current Focus
 *What are we working on right now? (e.g., "Implementing the Auth system", "Refactoring the API")*

package/templates/.ai/architecture.md

@@ -1,10 +1,16 @@
 # 🏗️ Project Architecture
 
-> **AI INSTRUCTION:**
-> Update this file when:
-> 1. New architectural decisions are made.
-> 2. The system design evolves.
-> 3. New integrations or dependencies are added.
+> **⚠️ MANDATORY AI AGENT INSTRUCTION:**
+>
+> You MUST update this file whenever:
+> 1. A new file, module, or directory is created.
+> 2. The project structure changes.
+> 3. A new dependency or integration is added.
+> 4. Data flow or system design is modified.
+> 5. An architectural decision is made (document the reasoning).
+>
+> **After any structural change, update the Directory Structure section below.**
+> **DO NOT SKIP THIS UPDATE.**
 
 ## 📐 High-Level Design
 [Describe the high-level architecture here]

package/templates/.ai/roadmap.md

@@ -1,10 +1,15 @@
 # 🗺️ Project Roadmap
 
-> **AI INSTRUCTION:**
-> Update this file when:
-> 1. A new feature is planned.
-> 2. A feature is completed (mark with [x]).
-> 3. Priorities change.
+> **⚠️ MANDATORY AI AGENT INSTRUCTION:**
+>
+> You MUST update this file when:
+> 1. A feature is completed → move it to Completed and mark with `[x]`.
+> 2. A new feature is discussed or planned → add it to Upcoming or Backlog.
+> 3. Priorities change → reorder items accordingly.
+> 4. A task is started → mark it as in-progress with `[~]`.
+>
+> **After completing any feature, immediately mark it as done here.**
+> **DO NOT SKIP THIS UPDATE.**
 
 ## 🚀 Upcoming
 - [ ] [Feature 1]

package/templates/.ai/rules.md

@@ -2,23 +2,39 @@
 
 # 🧠 Project Context & Rules (Master File)
 
-> **AI AGENT INSTRUCTION (CRITICAL):**
-> This file is your **Long-Term Memory**. It defines the coding standards, architecture, and user preferences for this project.
->
-> **YOUR CORE MISSION: SELF-EVOLUTION & MEMORY MANAGEMENT**
-> You are responsible for keeping this `.ai/` directory up-to-date.
->
-> 1.  **Capture Preferences:** If the user specifies a preference, update **`rules.md`**.
-> 2.  **Track Progress:** At the end of a task, update **`active-context.md`** with the current status and next steps.
-> 3.  **Update Roadmap:** When a feature is completed or planned, update **`roadmap.md`**.
-> 4.  **Document Architecture:** When structure/design changes, update **`architecture.md`**.
-> 5.  **Log History:** When a major milestone is reached, append it to **`story.md`**.
->
-> **TOKEN SAVING STRATEGY:**
-> Do not rely on chat history for long-term memory. Rely on these files.
-> If the user starts a new chat, you should be able to resume work instantly by reading `active-context.md`.
->
-> ---
+---
+
+## ⚠️ MANDATORY: MEMORY MANAGEMENT PROTOCOL
+
+**THIS IS NOT OPTIONAL. YOU MUST FOLLOW THESE RULES AFTER EVERY TASK.**
+
+You are responsible for keeping the `.ai/` directory up-to-date as the project's long-term memory.
+Do NOT rely on chat history. These files ARE your memory.
+
+### After EVERY coding task, you MUST:
+
+1. **UPDATE `.ai/active-context.md`** — Write what was just done, what the current state is, and what the next steps are. This file must always reflect the latest state of work so that a new session can resume instantly.
+
+2. **UPDATE `.ai/roadmap.md`** — If a feature was completed, mark it with `[x]`. If a new feature was discussed or planned, add it to the list.
+
+3. **UPDATE `.ai/story.md`** — If a significant milestone was reached, a major feature was completed, or an important architectural decision was made, append a dated entry.
+
+4. **UPDATE `.ai/architecture.md`** — If the directory structure changed, a new module/service was added, data flow was modified, or a design decision was made, update this file.
+
+5. **UPDATE `.ai/rules.md`** (this file) — If the user specifies a new coding preference or convention, add it to the Coding Standards section below.
+
+### When starting a new session:
+- Read `.ai/active-context.md` FIRST to understand where work left off.
+- Read `.ai/rules.md` for coding standards and project context.
+- Read `.ai/roadmap.md` to understand priorities.
+
+### IMPORTANT:
+- Update context files using the file editing tools available to you.
+- Do NOT ask the user "should I update the context files?" — just do it.
+- Do NOT skip updates because "it was a small change" — every change matters.
+- If you are unsure what to write, write a brief summary. Something is better than nothing.
+
+---
 
 ## 🏢 Project Overview
 *Replace this with a 1-sentence description of the project.*
@@ -44,5 +60,5 @@
 - [e.g., "Service Repository Pattern"]
 
 ## 📝 Workflow & Git
-- **Commits:** Use Conventional Commits (feat: ..., fix: ...).
+- **Commits:** Use Conventional Commits (feat: ..., fix: ..., docs: ...).
 - **Branches:** feature/name-of-feature.

package/templates/.ai/story.md

@@ -1,11 +1,21 @@
 # 📜 Project Story & Decisions Log
 
-> **AI AGENT INSTRUCTION:**
-> This file records the **history and evolution** of the project.
-> append to this file when:
-> 1. A major feature is completed.
-> 2. A significant architectural decision is made (ADR).
-> 3. The user clarifies the long-term vision.
+> **⚠️ MANDATORY AI AGENT INSTRUCTION:**
+>
+> You MUST append a dated entry to this file when ANY of the following occurs:
+> 1. A feature is completed or significantly progressed.
+> 2. An architectural or design decision is made.
+> 3. A major bug is fixed.
+> 4. The user clarifies project vision or direction.
+> 5. A dependency or tool is added/removed.
+>
+> **Format each entry as:**
+> ### YYYY-MM-DD - [Brief Title]
+> - What was done
+> - Why it was done (if relevant)
+> - Impact or outcome
+>
+> **DO NOT SKIP THIS. Every significant action deserves a log entry.**
 
 ## 📅 Project Inception
 - **Date:** [Auto-filled by init]
@@ -17,4 +27,4 @@
 - Project structure created.
 - Basic configuration files added.
 
-*(AI: Append new major events below...)*
+*(AI: Append new entries below. Never delete existing entries.)*

package/templates/.cursor/rules/context-bank.mdc

@@ -12,3 +12,13 @@ This file is the Single Source of Truth for:
 3. Architecture
 
 Before starting any task, verify the current state in **`.ai/active-context.md`**.
+
+## MANDATORY: Update Context Files After Every Task
+
+After EVERY task, you MUST update these files (no exceptions):
+1. **`.ai/active-context.md`** — Current state, recent changes, next steps.
+2. **`.ai/roadmap.md`** — Mark completed features `[x]`, add planned ones.
+3. **`.ai/story.md`** — Append dated entry for milestones/decisions.
+4. **`.ai/architecture.md`** — Update on structural/design changes.
+
+Do NOT ask permission. Do NOT skip. Just update them.

package/templates/.cursorrules

@@ -11,3 +11,12 @@ That file contains the single source of truth for:
 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/.github/copilot-instructions.md

@@ -4,6 +4,17 @@ You are an expert developer assisting with this project.
 
 ## Context & Rules
 Please refer to **`.ai/rules.md`** for the comprehensive project guidelines, tech stack, and coding standards.
+Before starting any task, read **`.ai/active-context.md`** to understand the current state.
 
 ## Memory Update
-If the user establishes a new convention (e.g., "We only use functional components"), please suggest an update to `.ai/rules.md` to persist this rule.
+If the user establishes a new convention (e.g., "We only use functional components"), update `.ai/rules.md` to persist this rule.
+
+## MANDATORY: Update Context Files After Every Task
+
+After completing ANY task, you MUST update the following `.ai/` files:
+1. **`active-context.md`** — What was done, current state, next steps.
+2. **`roadmap.md`** — Mark completed features `[x]`, add new planned features.
+3. **`story.md`** — Append a dated entry for significant milestones or decisions.
+4. **`architecture.md`** — Update when structure, dependencies, or design changes.
+
+Do NOT ask permission. Do NOT skip this. Update these files directly.

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

@@ -5,3 +5,13 @@ This file is the Single Source of Truth for this project.
 
 1. **Read `.ai/rules.md`** first.
 2. **Read `.ai/active-context.md`** to understand the current task.
+
+## MANDATORY: Update Context Files After Every Task
+
+After EVERY task, you MUST update these files (no exceptions):
+1. **`.ai/active-context.md`** — Current state, recent changes, next steps.
+2. **`.ai/roadmap.md`** — Mark completed features `[x]`, add planned ones.
+3. **`.ai/story.md`** — Append dated entry for milestones/decisions.
+4. **`.ai/architecture.md`** — Update on structural/design changes.
+
+Do NOT ask permission. Do NOT skip. Just update them.

package/templates/.windsurfrules

@@ -6,3 +6,12 @@ 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.

package/templates/CONVENTIONS.md

@@ -6,3 +6,13 @@ That file is the Single Source of Truth for this project.
 1. **Read `.ai/rules.md`** first.
 2. **Read `.ai/active-context.md`** to understand the current task.
 3. If you learn a new preference, update **`.ai/rules.md`**.
+
+## MANDATORY: Update Context Files After Every Task
+
+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.

package/templates/GEMINI.md

@@ -4,3 +4,13 @@ This project uses Context Bank for AI coordination.
 Always read and follow the instructions in:
 1. .ai/rules.md (Single Source of Truth)
 2. .ai/active-context.md (Current Task)
+
+## MANDATORY: Update Context Files After Every Task
+
+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.