@cxtmanager/core 1.0.1 → 1.0.7

package/README.md

@@ -1,132 +1,132 @@
-# @cxtmanager/core
-
-Core library for CxtManager - context file management and Git integration.
-
-## Philosophy
-
-**Manager, not Enforcer.** This package provides the infrastructure for managing AI project context files, but never enforces what content goes into them. It's a framework-agnostic library that can be used by CLI tools, IDE extensions, web apps, or any other interface.
-
-## What It Does
-
-- **Context File Management** - Create, read, update context files (context.md, plan.md, guardrail.md)
-- **Git Integration** - Version control for context files using Git
-- **Branch Awareness** - Automatic switching of plan.md content based on Git branches
-- **Validation** - Check context file alignment and consistency
-- **Template Generation** - Provide structure templates (you fill the content)
-- **Git Hooks** - Manage Git hooks for automatic context synchronization
-
-## Core Concepts
-
-### Context Files
-- `context.md` - High-level project truth (stable, rarely changes)
-- `plan.md` - Feature-specific implementation (changes per branch)
-- `guardrail.md` - Universal constraints and rules
-
-### Branch Awareness
-`plan.md` content is branch-specific. When you switch Git branches, CxtManager automatically:
-1. Saves current branch's plan.md to `.plan-history/`
-2. Restores the target branch's plan.md (or creates template if new)
-
-### Alignment
-Context files should cross-reference each other and tell a consistent story. The validation engine checks for:
-- Structural consistency
-- Cross-references
-- Template-only content warnings
-- Drift detection (code changes outpacing context updates)
-
-## Installation
-
-```bash
-npm install @cxtmanager/core
-```
-
-## Usage
-
-```typescript
-import { ContextManager } from '@cxtmanager/core';
-
-const manager = new ContextManager(projectRoot);
-
-// Initialize context files
-await manager.init({
-  templateStyle: 'minimal',
-  autoInstallHooks: true,
-  updateMode: 'manual'
-});
-
-// Check if initialized
-const isInit = await manager.isInitialized();
-
-// Get status
-const status = await manager.getStatus();
-
-// Validate alignment
-const validation = await manager.validate();
-
-// Sync plan.md for current branch
-const result = await manager.syncPlan();
-```
-
-## API Overview
-
-### ContextManager
-Main orchestrator class for context file operations.
-
-### GitRepository
-Handles all Git operations (commits, diffs, history, etc.).
-
-### PlanManager
-Manages branch-specific plan.md content and switching.
-
-### ValidationEngine
-Checks context file alignment, structure, and completeness.
-
-### GitHooksManager
-Manages Git hook installation and removal.
-
-## Configuration
-
-Configuration is stored in `.cxt/.cxtconfig.json`:
-
-```json
-{
-  "version": "1.0.0",
-  "template_style": "minimal",
-  "git_integration": {
-    "auto_install_hooks": true
-  },
-  "plan_management": {
-    "branch_aware": true
-  },
-  "context": {
-    "update_mode": "manual",
-    "drift_detection": {
-      "enabled": true,
-      "warn_threshold": 3
-    },
-    "template_thresholds": {
-      "well_populated": 30,
-      "mild_warning": 50,
-      "critical": 70
-    }
-  }
-}
-```
-
-## Development
-
-```bash
-# Build
-npm run build
-
-# Test
-npm test
-
-# Watch mode
-npm run dev
-```
-
-## License
-
-AGPL-3.0
-
+# @cxtmanager/core
+
+Core library for CxtManager - context file management and Git integration.
+
+## Philosophy
+
+**Manager, not Enforcer.** This package provides the infrastructure for managing AI project context files, but never enforces what content goes into them. It's a framework-agnostic library that can be used by CLI tools, IDE extensions, web apps, or any other interface.
+
+## What It Does
+
+- **Context File Management** - Create, read, update context files (context.md, plan.md, guardrail.md)
+- **Git Integration** - Version control for context files using Git
+- **Branch Awareness** - Automatic switching of plan.md content based on Git branches
+- **Validation** - Check context file alignment and consistency
+- **Template Generation** - Provide structure templates (you fill the content)
+- **Git Hooks** - Manage Git hooks for automatic context synchronization
+
+## Core Concepts
+
+### Context Files
+- `context.md` - High-level project truth (stable, rarely changes)
+- `plan.md` - Feature-specific implementation (changes per branch)
+- `guardrail.md` - Universal constraints and rules
+
+### Branch Awareness
+`plan.md` content is branch-specific. When you switch Git branches, CxtManager automatically:
+1. Saves current branch's plan.md to `.plan-history/`
+2. Restores the target branch's plan.md (or creates template if new)
+
+### Alignment
+Context files should cross-reference each other and tell a consistent story. The validation engine checks for:
+- Structural consistency
+- Cross-references
+- Template-only content warnings
+- Drift detection (code changes outpacing context updates)
+
+## Installation
+
+```bash
+npm install @cxtmanager/core
+```
+
+## Usage
+
+```typescript
+import { ContextManager } from '@cxtmanager/core';
+
+const manager = new ContextManager(projectRoot);
+
+// Initialize context files
+await manager.init({
+  templateStyle: 'minimal',
+  autoInstallHooks: true,
+  updateMode: 'manual'
+});
+
+// Check if initialized
+const isInit = await manager.isInitialized();
+
+// Get status
+const status = await manager.getStatus();
+
+// Validate alignment
+const validation = await manager.validate();
+
+// Sync plan.md for current branch
+const result = await manager.syncPlan();
+```
+
+## API Overview
+
+### ContextManager
+Main orchestrator class for context file operations.
+
+### GitRepository
+Handles all Git operations (commits, diffs, history, etc.).
+
+### PlanManager
+Manages branch-specific plan.md content and switching.
+
+### ValidationEngine
+Checks context file alignment, structure, and completeness.
+
+### GitHooksManager
+Manages Git hook installation and removal.
+
+## Configuration
+
+Configuration is stored in `.cxt/.cxtconfig.json`:
+
+```json
+{
+  "version": "1.0.0",
+  "template_style": "minimal",
+  "git_integration": {
+    "auto_install_hooks": true
+  },
+  "plan_management": {
+    "branch_aware": true
+  },
+  "context": {
+    "update_mode": "manual",
+    "drift_detection": {
+      "enabled": true,
+      "warn_threshold": 3
+    },
+    "template_thresholds": {
+      "well_populated": 30,
+      "mild_warning": 50,
+      "critical": 70
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Test
+npm test
+
+# Watch mode
+npm run dev
+```
+
+## License
+
+AGPL-3.0
+

package/dist/context-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../src/context-manager.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAmB,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE1I,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAA0B;gBAE5B,WAAW,GAAE,MAAsB;IASzC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA6DzC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAMjC,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;IAiB7B,QAAQ,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB7D;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,QAAQ,CAAC,MAAM,GAAE,OAAe,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IASpD,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IAiBtC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC;IAI/B,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAuB/C;;OAEG;YACW,cAAc;IAQ5B;;OAEG;IACG,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IASlE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAS3B,kBAAkB;YAMlB,cAAc;YA8Bd,gBAAgB;IAiB9B,OAAO,CAAC,kBAAkB;YAkBZ,qBAAqB;YAarB,kBAAkB;IAuEhC,OAAO,CAAC,iBAAiB;YAoJX,YAAY;YAwDZ,oBAAoB;IA8DlC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAoE5B"}
+{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../src/context-manager.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAmB,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAoB,MAAM,SAAS,CAAC;AAE5J,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAA0B;gBAE5B,WAAW,GAAE,MAAsB;IASzC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DzC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAMjC,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;IAiB7B,QAAQ,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB7D;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,QAAQ,CAAC,MAAM,GAAE,OAAe,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IASpD,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IAiBtC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC;IAI/B,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAuB/C;;OAEG;YACW,cAAc;IAQ5B;;OAEG;IACG,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IASlE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAS3B,kBAAkB;YAMlB,cAAc;YA8Bd,gBAAgB;IAiB9B,OAAO,CAAC,kBAAkB;YAkBZ,qBAAqB;YAarB,kBAAkB;IAuEhC,OAAO,CAAC,iBAAiB;YAoJX,YAAY;YAwDZ,oBAAoB;IA8DlC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAoE5B"}