@context-forge/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Manta Templates
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @context-forge/core
+
+The context generation engine that powers Context Forge. Handles template processing, project state management, prompt parsing, section building, and the full context assembly pipeline.
+
+## Overview
+
+This package contains the core logic shared by both the [MCP server](../mcp-server/README.md) and the [Electron desktop app](../electron/). It has no Electron dependency and can be used by any Node.js consumer.
+
+Key capabilities:
+- **Context pipeline** — assembles structured context prompts from project configuration, templates, and statements
+- **Template processing** — variable substitution (`{{projectName}}`, `{{slice}}`, etc.) with conditional sections
+- **Statement management** — loads and resolves default statements (start/continue, tool intro, instruction blocks)
+- **Prompt parsing** — reads `prompt.ai-project.system.md` files and extracts named template sections
+- **Project storage** — filesystem-backed CRUD for project configuration with backup and migration support
+
+## Export Paths
+
+The package provides two entry points to separate browser-safe code from Node.js-dependent code.
+
+### `@context-forge/core` — Types, interfaces, and browser-safe services
+
+```typescript
+import type { ProjectData, UpdateProjectData } from '@context-forge/core';
+import type { IProjectStore, IStorageService } from '@context-forge/core';
+import { TemplateProcessor, SectionBuilder } from '@context-forge/core';
+import { ContextGenerator, ContextIntegrator } from '@context-forge/core';
+import { PROMPT_FILE_RELATIVE_PATH, DEFAULT_STATEMENTS } from '@context-forge/core';
+```
+
+This entry point contains no `fs` or `path` dependencies and is safe for browser/renderer contexts.
+
+### `@context-forge/core/node` — Node.js implementations
+
+```typescript
+import { FileProjectStore, FileStorageService } from '@context-forge/core/node';
+import { createContextPipeline } from '@context-forge/core/node';
+import { StatementManager, SystemPromptParser } from '@context-forge/core/node';
+import { ProjectPathService } from '@context-forge/core/node';
+import { getStoragePath } from '@context-forge/core/node';
+```
+
+This entry point includes filesystem-dependent services. Use it in main processes, CLI tools, MCP servers, and tests. Do not import from browser/renderer code.
+
+## Key Services
+
+| Service | Entry Point | Description |
+|---------|-------------|-------------|
+| `FileProjectStore` | `./node` | Filesystem-backed project CRUD (read, create, update, delete) |
+| `createContextPipeline` | `./node` | Factory that wires up all services for a project path and returns a ready-to-use `ContextIntegrator` |
+| `StatementManager` | `./node` | Loads and parses `default-statements.md` from a project directory |
+| `SystemPromptParser` | `./node` | Parses `prompt.ai-project.system.md` into named template sections |
+| `ProjectPathService` | `./node` | Resolves file paths relative to a project root (task files, slice designs, guides) |
+| `ContextIntegrator` | `.` | Orchestrates full context generation from a `ProjectData` object |
+| `TemplateProcessor` | `.` | Handles `{{variable}}` substitution in template strings |
+| `SectionBuilder` | `.` | Assembles individual context sections (statements, instructions, tools) |
+
+## Usage in the Monorepo
+
+```
+packages/
+  core/         ← this package
+  mcp-server/   depends on @context-forge/core (workspace:*)
+  electron/     depends on @context-forge/core (workspace:*)
+```
+
+Both the MCP server and Electron app import types from `@context-forge/core` and Node.js services from `@context-forge/core/node`. The Electron renderer uses only the browser-safe entry point, with IPC bridges to access Node.js services from the main process.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types/index.js';
+export * from './services/index.js';
+export type { IProjectStore, IStorageService, StorageReadResult } from './storage/interfaces.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAGpC,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// @context-forge/core — context assembly engine
+export * from './types/index.js';
+export * from './services/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,6 @@
+export { StatementManager } from './services/StatementManager.js';
+export { SystemPromptParser } from './services/SystemPromptParser.js';
+export { ProjectPathService } from './services/ProjectPathService.js';
+export { createContextPipeline } from './services/CoreServiceFactory.js';
+export * from './storage/index.js';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,cAAc,oBAAoB,CAAC"}

package/dist/node.js

@@ -0,0 +1,10 @@
+// @context-forge/core/node — Node.js-only services (fs/path dependent)
+// Use this entry point in main process, CLI, MCP server, and tests.
+// Do NOT import from renderer/browser code — use IPC wrappers instead.
+export { StatementManager } from './services/StatementManager.js';
+export { SystemPromptParser } from './services/SystemPromptParser.js';
+export { ProjectPathService } from './services/ProjectPathService.js';
+export { createContextPipeline } from './services/CoreServiceFactory.js';
+// Storage — filesystem-backed project CRUD, backup, and storage utilities
+export * from './storage/index.js';
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oEAAoE;AACpE,uEAAuE;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,0EAA0E;AAC1E,cAAc,oBAAoB,CAAC"}

package/dist/services/ContextGenerator.d.ts

@@ -0,0 +1,19 @@
+import { ProjectData } from '../types/project.js';
+/**
+ * Basic context generation service for Claude Code prompts
+ */
+export declare class ContextGenerator {
+    /**
+     * Generates a basic context prompt for Claude Code based on project data
+     */
+    generateContext(project: ProjectData, additionalNotes?: string): string;
+    /**
+     * Gets the base template for context generation
+     */
+    private getBaseTemplate;
+    /**
+     * Validates project data for context generation
+     */
+    validateProject(project: ProjectData): string[];
+}
+//# sourceMappingURL=ContextGenerator.d.ts.map

package/dist/services/ContextGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextGenerator.d.ts","sourceRoot":"","sources":["../../src/services/ContextGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;GAEG;AACH,qBAAa,gBAAgB;IAE3B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM;IAoBvE;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE;CAiBhD"}

package/dist/services/ContextGenerator.js

@@ -0,0 +1,66 @@
+/**
+ * Basic context generation service for Claude Code prompts
+ */
+export class ContextGenerator {
+    /**
+     * Generates a basic context prompt for Claude Code based on project data
+     */
+    generateContext(project, additionalNotes) {
+        const template = this.getBaseTemplate();
+        // Simple variable substitution
+        let context = template
+            .replace('{{PROJECT_NAME}}', project.name)
+            .replace('{{TEMPLATE}}', project.template)
+            .replace('{{SLICE}}', project.slice)
+            .replace('{{TASK_FILE}}', project.taskFile || '')
+            .replace('{{MONOREPO_STATUS}}', project.isMonorepo ? 'Monorepo project' : 'Single project')
+            .replace('{{TIMESTAMP}}', new Date().toLocaleString());
+        // Add additional notes if provided
+        if (additionalNotes && additionalNotes.trim()) {
+            context += '\n\n## Additional Context\n\n' + additionalNotes.trim();
+        }
+        return context;
+    }
+    /**
+     * Gets the base template for context generation
+     */
+    getBaseTemplate() {
+        return `# Context for Claude Code
+
+## Project Information
+- **Project Name:** {{PROJECT_NAME}}
+- **Template:** {{TEMPLATE}}
+- **Current Slice:** {{SLICE}}
+- **Tasks File:** {{TASK_FILE}}
+- **Type:** {{MONOREPO_STATUS}}
+- **Generated:** {{TIMESTAMP}}
+
+## Working Context
+I'm working on the **{{SLICE}}** slice for project **{{PROJECT_NAME}}**. This project uses the **{{TEMPLATE}}** template structure.
+
+## Current Objectives
+- Implement the {{SLICE}} functionality according to the slice design
+- Follow existing code patterns and conventions
+- Ensure all tests pass and the build succeeds
+
+## Next Steps
+Please help me continue development on this slice, following the project guidelines and maintaining code quality standards.`;
+    }
+    /**
+     * Validates project data for context generation
+     */
+    validateProject(project) {
+        const errors = [];
+        if (!project.name || project.name.trim().length === 0) {
+            errors.push('Project name is required');
+        }
+        if (!project.template || project.template.trim().length === 0) {
+            errors.push('Template is required');
+        }
+        if (!project.slice || project.slice.trim().length === 0) {
+            errors.push('Slice is required');
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=ContextGenerator.js.map

package/dist/services/ContextGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextGenerator.js","sourceRoot":"","sources":["../../src/services/ContextGenerator.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAE3B;;OAEG;IACH,eAAe,CAAC,OAAoB,EAAE,eAAwB;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAExC,+BAA+B;QAC/B,IAAI,OAAO,GAAG,QAAQ;aACnB,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,IAAI,CAAC;aACzC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC;aACzC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC;aACnC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;aAChD,OAAO,CAAC,qBAAqB,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,CAAC;aAC1F,OAAO,CAAC,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC;QAEzD,mCAAmC;QACnC,IAAI,eAAe,IAAI,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,OAAO,IAAI,+BAA+B,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC;QACtE,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,OAAO;;;;;;;;;;;;;;;;;;;4HAmBiH,CAAC;IAC3H,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAoB;QAClC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/services/ContextIntegrator.d.ts

@@ -0,0 +1,84 @@
+import type { ProjectData } from '../types/project.js';
+import { ContextTemplateEngine } from './ContextTemplateEngine.js';
+/**
+ * Service for integrating project data with context generation
+ * Transforms ProjectData into formatted context strings
+ */
+export declare class ContextIntegrator {
+    private templateProcessor;
+    private templateEngine;
+    private enableNewEngine;
+    constructor(engine: ContextTemplateEngine, enableNewEngine?: boolean);
+    /**
+     * Generates a complete context string from project data
+     * Main integration point - takes project data and returns formatted context
+     * @param project Project data from storage
+     * @returns Formatted context string ready for display/copying
+     */
+    generateContextFromProject(project: ProjectData): Promise<string>;
+    /**
+     * Generate context using the new template engine
+     */
+    private generateWithTemplateEngine;
+    /**
+     * Generate context using the legacy system
+     */
+    private generateWithLegacySystem;
+    /**
+     * Maps ProjectData structure to EnhancedContextData structure
+     * Includes tool detection and additional template features
+     * @param project Project data from storage
+     * @returns Enhanced context data ready for template engine
+     */
+    private mapProjectToEnhancedContext;
+    /**
+     * Maps ProjectData structure to ContextData structure (legacy)
+     * Handles null/undefined values with appropriate defaults
+     * @param project Project data from storage
+     * @returns Context data ready for template processing
+     */
+    private mapProjectToContext;
+    /**
+     * Applies final formatting to processed context
+     * @param content Processed template content
+     * @returns Formatted context string
+     */
+    private formatOutput;
+    /**
+     * Generates error context when main generation fails
+     * @param project Original project data
+     * @param error Error that occurred
+     * @returns Fallback context string
+     */
+    private getErrorContext;
+    /**
+     * Validates project data before processing
+     * @param project Project data to validate
+     * @returns True if project has minimum required fields
+     */
+    validateProject(project: ProjectData | null | undefined): boolean;
+    /**
+     * Detect available tools for the project
+     * Currently returns placeholder data - can be enhanced for actual detection
+     */
+    private detectAvailableTools;
+    /**
+     * Detect available MCP servers for the project
+     * Currently returns placeholder data - can be enhanced for actual detection
+     */
+    private detectMCPServers;
+    /**
+     * Check if new template engine is enabled
+     */
+    isNewEngineEnabled(): boolean;
+    /**
+     * Toggle between new and legacy template systems
+     */
+    setNewEngineEnabled(enabled: boolean): void;
+    /**
+     * Gets the default template string (legacy)
+     * @returns Default template string
+     */
+    getDefaultTemplate(): string;
+}
+//# sourceMappingURL=ContextIntegrator.d.ts.map

package/dist/services/ContextIntegrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextIntegrator.d.ts","sourceRoot":"","sources":["../../src/services/ContextIntegrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAsBnE;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,eAAe,CAAU;gBAErB,MAAM,EAAE,qBAAqB,EAAE,eAAe,GAAE,OAAc;IAM1E;;;;;OAKG;IACG,0BAA0B,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAavE;;OAEG;YACW,0BAA0B;IAiBxC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;;;;OAKG;YACW,2BAA2B;IAwBzC;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAapB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAevB;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAYjE;;;OAGG;YACW,oBAAoB;IAKlC;;;OAGG;YACW,gBAAgB;IAK9B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI3C;;;OAGG;IACH,kBAAkB,IAAI,MAAM;CAG7B"}

package/dist/services/ContextIntegrator.js

@@ -0,0 +1,211 @@
+import { TemplateProcessor } from './TemplateProcessor.js';
+import { PROMPT_FILE_RELATIVE_PATH, STATEMENTS_FILE_RELATIVE_PATH } from './constants.js';
+/**
+ * Default template for context generation
+ * Uses markdown format with template variable substitution
+ */
+const DEFAULT_TEMPLATE = `# Project: {{projectName}}
+Template: {{template}}
+Slice: {{slice}}
+Instruction: {{instruction}}
+{{#if isMonorepo}}Monorepo: Yes{{else}}Monorepo: No{{/if}}
+
+## Recent Events
+{{recentEvents}}
+
+## Additional Context
+{{additionalNotes}}
+
+## Current Status
+Ready for {{instruction}} work on {{slice}} slice.`;
+/**
+ * Service for integrating project data with context generation
+ * Transforms ProjectData into formatted context strings
+ */
+export class ContextIntegrator {
+    templateProcessor;
+    templateEngine;
+    enableNewEngine;
+    constructor(engine, enableNewEngine = true) {
+        this.templateProcessor = new TemplateProcessor();
+        this.templateEngine = engine;
+        this.enableNewEngine = enableNewEngine;
+    }
+    /**
+     * Generates a complete context string from project data
+     * Main integration point - takes project data and returns formatted context
+     * @param project Project data from storage
+     * @returns Formatted context string ready for display/copying
+     */
+    async generateContextFromProject(project) {
+        try {
+            if (this.enableNewEngine) {
+                return await this.generateWithTemplateEngine(project);
+            }
+            else {
+                return this.generateWithLegacySystem(project);
+            }
+        }
+        catch (error) {
+            console.error('Error generating context from project:', error);
+            return this.getErrorContext(project, error);
+        }
+    }
+    /**
+     * Generate context using the new template engine
+     */
+    async generateWithTemplateEngine(project) {
+        // Resolve absolute file paths from project root before service calls
+        if (project.projectPath) {
+            const base = project.projectPath.replace(/\/+$/, '');
+            this.templateEngine.updateServicePaths(`${base}/${PROMPT_FILE_RELATIVE_PATH}`, `${base}/${STATEMENTS_FILE_RELATIVE_PATH}`);
+        }
+        // Map project data to enhanced context data
+        const enhancedData = await this.mapProjectToEnhancedContext(project);
+        // Generate using template engine
+        return await this.templateEngine.generateContext(enhancedData);
+    }
+    /**
+     * Generate context using the legacy system
+     */
+    generateWithLegacySystem(project) {
+        // Map project data to context data structure
+        const contextData = this.mapProjectToContext(project);
+        // Process template with context data
+        const processedContext = this.templateProcessor.processTemplate(DEFAULT_TEMPLATE, contextData);
+        // Apply final formatting
+        return this.formatOutput(processedContext);
+    }
+    /**
+     * Maps ProjectData structure to EnhancedContextData structure
+     * Includes tool detection and additional template features
+     * @param project Project data from storage
+     * @returns Enhanced context data ready for template engine
+     */
+    async mapProjectToEnhancedContext(project) {
+        // Detect available tools and MCP servers
+        const availableTools = await this.detectAvailableTools();
+        const mcpServers = await this.detectMCPServers();
+        return {
+            projectName: project.name || 'Unknown Project',
+            template: project.template || '',
+            slice: project.slice || 'Unknown Slice',
+            taskFile: project.taskFile || '',
+            instruction: project.instruction || 'implementation',
+            developmentPhase: project.developmentPhase || 'WARNING: MISSING DEVELOPMENT PHASE',
+            workType: project.workType || 'continue',
+            projectDate: project.projectDate || new Date().toISOString().split('T')[0],
+            isMonorepo: project.isMonorepo || false,
+            recentEvents: project.customData?.recentEvents || '',
+            additionalNotes: project.customData?.additionalNotes || '',
+            availableTools,
+            mcpServers,
+            templateVersion: '1.0.0',
+            customData: project.customData
+        };
+    }
+    /**
+     * Maps ProjectData structure to ContextData structure (legacy)
+     * Handles null/undefined values with appropriate defaults
+     * @param project Project data from storage
+     * @returns Context data ready for template processing
+     */
+    mapProjectToContext(project) {
+        return {
+            projectName: project.name || 'Unknown Project',
+            template: project.template || 'Unknown Template',
+            slice: project.slice || 'Unknown Slice',
+            taskFile: project.taskFile || '',
+            instruction: project.instruction || 'implementation',
+            developmentPhase: project.developmentPhase || 'WARNING: MISSING DEVELOPMENT PHASE',
+            workType: project.workType || 'continue',
+            projectDate: project.projectDate || new Date().toISOString().split('T')[0],
+            isMonorepo: project.isMonorepo || false,
+            recentEvents: project.customData?.recentEvents || '',
+            additionalNotes: project.customData?.additionalNotes || ''
+        };
+    }
+    /**
+     * Applies final formatting to processed context
+     * @param content Processed template content
+     * @returns Formatted context string
+     */
+    formatOutput(content) {
+        // Clean up multiple blank lines
+        let formatted = content.replace(/\n\s*\n\s*\n/g, '\n\n');
+        // Trim leading/trailing whitespace
+        formatted = formatted.trim();
+        // Ensure consistent line endings
+        formatted = formatted.replace(/\r\n/g, '\n');
+        return formatted;
+    }
+    /**
+     * Generates error context when main generation fails
+     * @param project Original project data
+     * @param error Error that occurred
+     * @returns Fallback context string
+     */
+    getErrorContext(project, error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return `# Project: ${project.name || 'Unknown'}
+
+⚠️ Error generating context: ${message}
+
+## Project Details
+- Template: ${project.template || 'Unknown'}
+- Slice: ${project.slice || 'Unknown'}
+- Instruction: ${project.instruction || 'Unknown'}
+- Monorepo: ${project.isMonorepo ? 'Yes' : 'No'}
+
+Please check the console for detailed error information.`;
+    }
+    /**
+     * Validates project data before processing
+     * @param project Project data to validate
+     * @returns True if project has minimum required fields
+     */
+    validateProject(project) {
+        if (!project) {
+            return false;
+        }
+        return Boolean(project.name &&
+            project.template &&
+            project.slice);
+    }
+    /**
+     * Detect available tools for the project
+     * Currently returns placeholder data - can be enhanced for actual detection
+     */
+    async detectAvailableTools() {
+        // Placeholder implementation - can be enhanced to actually detect tools
+        return ['npm', 'git', 'vscode'];
+    }
+    /**
+     * Detect available MCP servers for the project
+     * Currently returns placeholder data - can be enhanced for actual detection
+     */
+    async detectMCPServers() {
+        // Placeholder implementation - can be enhanced to detect actual MCP servers
+        return ['context7'];
+    }
+    /**
+     * Check if new template engine is enabled
+     */
+    isNewEngineEnabled() {
+        return this.enableNewEngine;
+    }
+    /**
+     * Toggle between new and legacy template systems
+     */
+    setNewEngineEnabled(enabled) {
+        this.enableNewEngine = enabled;
+    }
+    /**
+     * Gets the default template string (legacy)
+     * @returns Default template string
+     */
+    getDefaultTemplate() {
+        return DEFAULT_TEMPLATE;
+    }
+}
+//# sourceMappingURL=ContextIntegrator.js.map

package/dist/services/ContextIntegrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextIntegrator.js","sourceRoot":"","sources":["../../src/services/ContextIntegrator.ts"],"names":[],"mappings":"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"}

package/dist/services/ContextTemplateEngine.d.ts

@@ -0,0 +1,65 @@
+import type { EnhancedContextData } from '../types/context.js';
+import type { ContextTemplate } from '../types/sections.js';
+import type { IPromptService, IStatementService } from './interfaces.js';
+import { SectionBuilder } from './SectionBuilder.js';
+/**
+ * Main orchestrator for context template generation
+ * Coordinates between statement manager, prompt parser, and section builder
+ */
+export declare class ContextTemplateEngine {
+    private promptParser;
+    private statementManager;
+    private sectionBuilder;
+    private templateProcessor;
+    private enableNewEngine;
+    constructor(promptParser: IPromptService, statementManager: IStatementService, sectionBuilder?: SectionBuilder);
+    /**
+     * Ensure statement manager is initialized
+     */
+    private ensureStatementManagerInitialized;
+    /**
+     * Generate context from enhanced project data
+     */
+    generateContext(data: EnhancedContextData): Promise<string>;
+    /**
+     * Build template configuration based on project data
+     */
+    buildTemplate(data: EnhancedContextData): Promise<ContextTemplate>;
+    /**
+     * Assemble sections into final context string
+     */
+    assembleSections(template: ContextTemplate, data: EnhancedContextData): Promise<string>;
+    /**
+     * Process individual section with template variables
+     */
+    private processSection;
+    /**
+     * Replace template variables in content using enhanced TemplateProcessor
+     */
+    private replaceTemplateVariables;
+    /**
+     * Format final output with cleanup
+     */
+    private formatOutput;
+    /**
+     * Validate input data has required fields
+     */
+    private validateInputData;
+    /**
+     * Generate explicit error context (no silent fallbacks)
+     */
+    private getErrorContext;
+    /**
+     * Check if new template engine is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Toggle template engine on/off for testing
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Update file paths on internal services (resolves absolute paths from projectPath)
+     */
+    updateServicePaths(promptFilePath: string, statementFilePath: string): void;
+}
+//# sourceMappingURL=ContextTemplateEngine.d.ts.map

package/dist/services/ContextTemplateEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextTemplateEngine.d.ts","sourceRoot":"","sources":["../../src/services/ContextTemplateEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,eAAe,CAAiB;gBAGtC,YAAY,EAAE,cAAc,EAC5B,gBAAgB,EAAE,iBAAiB,EACnC,cAAc,CAAC,EAAE,cAAc;IAQjC;;OAEG;YACW,iCAAiC;IAW/C;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBjE;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IA4FxE;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB7F;;OAEG;YACW,cAAc;IAc5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAKhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC;;OAEG;IACH,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;CAI5E"}