context-bank 0.0.7 → 0.0.10

package/dist/commands/init.js

@@ -40,33 +40,58 @@ export async function initCommand(options) {
     }
     s.message("Copying context files...");
     try {
+        // Helper for safe copying/merging
+        async function copyOrMerge(src, dest, isAiDir = false) {
+            const stats = await fs.stat(src);
+            if (stats.isDirectory()) {
+                await fs.ensureDir(dest);
+                const files = await fs.readdir(src);
+                for (const file of files) {
+                    await copyOrMerge(path.join(src, file), path.join(dest, file), isAiDir || path.basename(src) === ".ai");
+                }
+            }
+            else {
+                if (await fs.pathExists(dest)) {
+                    if (isAiDir) {
+                        // Skip .ai files if they exist to protect project memory
+                        return;
+                    }
+                    const srcContent = await fs.readFile(src, "utf-8");
+                    const destContent = await fs.readFile(dest, "utf-8");
+                    if (!destContent.includes(srcContent.trim())) {
+                        // Prepend for rules files to ensure priority
+                        await fs.writeFile(dest, `${srcContent}\n\n${destContent}`);
+                    }
+                }
+                else {
+                    await fs.copy(src, dest);
+                    // Special handling for new story.md
+                    if (path.basename(dest) === "story.md" && isAiDir) {
+                        let storyContent = await fs.readFile(dest, "utf-8");
+                        storyContent = storyContent.replace("[Auto-filled by init]", new Date().toISOString().split("T")[0]);
+                        await fs.writeFile(dest, storyContent);
+                    }
+                }
+            }
+        }
         // List of files/folders to copy
         const itemsToCopy = [
             ".ai",
+            ".cursor",
             ".cursorrules",
+            ".windsurf",
             ".windsurfrules",
             ".github",
             "CONVENTIONS.md",
+            "GEMINI.md",
         ];
         for (const item of itemsToCopy) {
             const srcPath = path.join(templateDir, item);
             const destPath = path.join(targetDir, item);
             if (fs.existsSync(srcPath)) {
-                if (fs.existsSync(destPath)) {
-                    await fs.copy(srcPath, destPath, { overwrite: true });
-                }
-                else {
-                    await fs.copy(srcPath, destPath);
-                }
+                await copyOrMerge(srcPath, destPath);
             }
         }
-        // Special handling for story.md date
-        const storyPath = path.join(targetDir, ".ai/story.md");
-        if (fs.existsSync(storyPath)) {
-            let storyContent = await fs.readFile(storyPath, "utf-8");
-            storyContent = storyContent.replace("[Auto-filled by init]", new Date().toISOString().split("T")[0]);
-            await fs.writeFile(storyPath, storyContent);
-        }
         // Special handling for README.md
         const readmePath = path.join(targetDir, "README.md");
         const aiContextMarker = "<!-- AI-CONTEXT: .ai/rules.md -->";
@@ -82,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")) {
@@ -95,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")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-bank",
-  "version": "0.0.7",
+  "version": "0.0.10",
   "description": "A CLI tool to standardise AI context in projects.",
   "type": "module",
   "bin": {

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

@@ -0,0 +1,24 @@
+---
+description: Global project rules and context source of truth
+globs: *
+---
+
+# Context Bank Integration
+
+You MUST read and follow the rules defined in **`.ai/rules.md`**.
+This file is the Single Source of Truth for:
+1. Tech Stack
+2. Coding Standards
+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

@@ -0,0 +1,17 @@
+# Windsurf Project Rules
+
+You MUST read and follow the rules defined in **`.ai/rules.md`**.
+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

@@ -0,0 +1,16 @@
+# Project Context
+
+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.