@context-forge/core 0.1.0

package/dist/types/paths.d.ts

@@ -0,0 +1,18 @@
+/** Result of validating a project path against expected directory structure. */
+export interface PathValidationResult {
+    valid: boolean;
+    projectPath: string;
+    errors: string[];
+    structure: {
+        hasProjectDocuments: boolean;
+        hasUserDir: boolean;
+        /** Which of slices/tasks/features/architecture exist under project-documents/user/ */
+        subdirectories: string[];
+    };
+}
+/** Result of listing files in a project subdirectory. */
+export interface DirectoryListResult {
+    files: string[];
+    error?: string;
+}
+//# sourceMappingURL=paths.d.ts.map

package/dist/types/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/types/paths.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE;QACT,mBAAmB,EAAE,OAAO,CAAC;QAC7B,UAAU,EAAE,OAAO,CAAC;QACpB,sFAAsF;QACtF,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;CACH;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/paths.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=paths.js.map

package/dist/types/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/types/paths.ts"],"names":[],"mappings":""}

package/dist/types/project.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Core data structure for project information
+ */
+export interface ProjectData {
+    id: string;
+    name: string;
+    template: string;
+    slice: string;
+    taskFile: string;
+    instruction: string;
+    developmentPhase?: string;
+    workType?: 'start' | 'continue';
+    projectDate?: string;
+    isMonorepo: boolean;
+    isMonorepoEnabled?: boolean;
+    /** Absolute path to project root (contains project-documents/) */
+    projectPath?: string;
+    customData?: {
+        recentEvents?: string;
+        additionalNotes?: string;
+        monorepoNote?: string;
+        availableTools?: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Type for creating a new project (without auto-generated fields).
+ * instruction, workType and customData are optional during creation and will get defaults.
+ */
+export type CreateProjectData = Omit<ProjectData, 'id' | 'createdAt' | 'updatedAt' | 'instruction' | 'developmentPhase' | 'workType' | 'taskFile' | 'projectDate' | 'customData'> & {
+    instruction?: string;
+    developmentPhase?: string;
+    workType?: 'start' | 'continue';
+    taskFile?: string;
+    projectDate?: string;
+    customData?: {
+        recentEvents?: string;
+        additionalNotes?: string;
+        monorepoNote?: string;
+        availableTools?: string;
+    };
+};
+/**
+ * Type for updating an existing project (partial updates allowed)
+ */
+export type UpdateProjectData = Partial<Pick<ProjectData, 'name' | 'template' | 'slice' | 'taskFile' | 'instruction' | 'developmentPhase' | 'workType' | 'projectDate' | 'isMonorepo' | 'isMonorepoEnabled' | 'projectPath' | 'customData'>>;
+//# sourceMappingURL=project.d.ts.map

package/dist/types/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,WAAW,EACX,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,kBAAkB,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,CAC/H,GAAG;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC,IAAI,CACF,WAAW,EACT,MAAM,GACN,UAAU,GACV,OAAO,GACP,UAAU,GACV,aAAa,GACb,kBAAkB,GAClB,UAAU,GACV,aAAa,GACb,YAAY,GACZ,mBAAmB,GACnB,aAAa,GACb,YAAY,CACf,CACF,CAAC"}

package/dist/types/project.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=project.js.map

package/dist/types/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":""}

package/dist/types/prompts.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Represents a system prompt extracted from the prompt file
+ */
+export interface SystemPrompt {
+    /** Display name of the prompt (from section header) */
+    name: string;
+    /** Unique key identifier for the prompt */
+    key: string;
+    /** The actual prompt content/text */
+    content: string;
+    /** Parameters or variables referenced in the prompt */
+    parameters: string[];
+}
+/**
+ * Result of parsing the system prompt file
+ */
+export interface ParsedPromptFile {
+    /** All prompts found in the file */
+    prompts: SystemPrompt[];
+    /** File metadata (version, last updated, etc) */
+    metadata?: {
+        version?: string;
+        lastUpdated?: string;
+    };
+    /** Any parsing errors encountered */
+    errors: string[];
+}
+/**
+ * Cache entry for parsed system prompts
+ */
+export interface PromptCacheEntry {
+    /** Parsed prompts */
+    prompts: SystemPrompt[];
+    /** File modification time when cached */
+    mtime: number;
+    /** Cache timestamp */
+    cachedAt: number;
+}
+/**
+ * Special prompt keys for commonly used prompts
+ */
+export declare const SpecialPromptKeys: {
+    readonly CONTEXT_INITIALIZATION: "context-initialization";
+    readonly TOOL_USE: "use-3rd-party-tool";
+    readonly PROJECT_KICKOFF: "project-kickoff";
+    readonly FEATURE_DESIGN: "feature-design";
+};
+export type SpecialPromptKeys = (typeof SpecialPromptKeys)[keyof typeof SpecialPromptKeys];
+//# sourceMappingURL=prompts.d.ts.map

package/dist/types/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/types/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IAEb,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IAEZ,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAEhB,uDAAuD;IACvD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,iDAAiD;IACjD,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,qCAAqC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/types/prompts.js

@@ -0,0 +1,10 @@
+/**
+ * Special prompt keys for commonly used prompts
+ */
+export const SpecialPromptKeys = {
+    CONTEXT_INITIALIZATION: 'context-initialization',
+    TOOL_USE: 'use-3rd-party-tool',
+    PROJECT_KICKOFF: 'project-kickoff',
+    FEATURE_DESIGN: 'feature-design',
+};
+//# sourceMappingURL=prompts.js.map

package/dist/types/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/types/prompts.ts"],"names":[],"mappings":"AAgDA;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,sBAAsB,EAAE,wBAAwB;IAChD,QAAQ,EAAE,oBAAoB;IAC9B,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;CACxB,CAAC"}

package/dist/types/sections.d.ts

@@ -0,0 +1,64 @@
+import type { ContextData } from './context.js';
+import type { TemplateStatement } from './statements.js';
+import type { SystemPrompt } from './prompts.js';
+/**
+ * Represents a section in the context template
+ */
+export interface ContextSection {
+    /** Unique identifier for the section */
+    key: string;
+    /** Optional title to display for the section (e.g., "### Current Events") */
+    title?: string;
+    /** The content of the section (can include template variables) */
+    content: string;
+    /** Whether this section should be conditionally included */
+    conditional?: boolean;
+    /** Function to determine if section should be included */
+    condition?: (data: ContextData) => boolean;
+    /** Sort order for the section (lower numbers appear first) */
+    order: number;
+}
+/**
+ * Complete context template structure
+ */
+export interface ContextTemplate {
+    /** All sections that make up the template */
+    sections: ContextSection[];
+    /** Available statements for the template */
+    statements: Record<string, TemplateStatement>;
+    /** Available system prompts */
+    prompts: Record<string, SystemPrompt>;
+}
+/**
+ * Section builder configuration
+ */
+export interface SectionBuilderConfig {
+    /** Whether to include empty sections */
+    includeEmptySections?: boolean;
+    /** Whether to include section titles */
+    includeTitles?: boolean;
+    /** Custom section separator (default: double newline) */
+    sectionSeparator?: string;
+}
+/**
+ * Predefined section keys
+ */
+export declare const SectionKeys: {
+    readonly PROJECT_INTRO: "project-intro";
+    readonly CONTEXT_INIT: "context-init";
+    readonly TOOLS_SECTION: "tools-section";
+    readonly MONOREPO_SECTION: "monorepo-section";
+    readonly CURRENT_EVENTS: "current-events";
+    readonly INSTRUCTION_PROMPT: "instruction-prompt";
+    readonly ADDITIONAL_NOTES: "additional-notes";
+};
+export type SectionKeys = (typeof SectionKeys)[keyof typeof SectionKeys];
+/**
+ * Section validation result
+ */
+export interface SectionValidation {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+//# sourceMappingURL=sections.d.ts.map

package/dist/types/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../src/types/sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IAEZ,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAEhB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC;IAE3C,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE9C,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B,wCAAwC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;CAQd,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/types/sections.js

@@ -0,0 +1,13 @@
+/**
+ * Predefined section keys
+ */
+export const SectionKeys = {
+    PROJECT_INTRO: 'project-intro',
+    CONTEXT_INIT: 'context-init',
+    TOOLS_SECTION: 'tools-section',
+    MONOREPO_SECTION: 'monorepo-section',
+    CURRENT_EVENTS: 'current-events',
+    INSTRUCTION_PROMPT: 'instruction-prompt',
+    ADDITIONAL_NOTES: 'additional-notes',
+};
+//# sourceMappingURL=sections.js.map

package/dist/types/sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.js","sourceRoot":"","sources":["../../src/types/sections.ts"],"names":[],"mappings":"AAuDA;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,kBAAkB;CAC5B,CAAC"}

package/dist/types/statements.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Template statement configuration for context generation
+ */
+export interface TemplateStatement {
+    /** Unique key identifier for the statement */
+    key: string;
+    /** The actual statement content/text */
+    content: string;
+    /** Human-readable description of what this statement is for */
+    description: string;
+    /** Whether users can edit this statement */
+    editable: boolean;
+}
+/**
+ * Configuration for storing and managing statements
+ */
+export interface StatementConfig {
+    /** Map of statement keys to statement objects */
+    statements: Record<string, TemplateStatement>;
+    /** ISO date string of last update */
+    lastUpdated: string;
+    /** Version string for compatibility tracking */
+    version: string;
+}
+/**
+ * Metadata extracted from markdown file frontmatter
+ */
+export interface StatementFileMetadata {
+    version: string;
+    lastUpdated: string;
+}
+/**
+ * Result of parsing a statement from markdown
+ */
+export interface ParsedStatement {
+    key: string;
+    content: string;
+    editable: boolean;
+}
+//# sourceMappingURL=statements.d.ts.map

package/dist/types/statements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statements.d.ts","sourceRoot":"","sources":["../../src/types/statements.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IAEZ,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAEhB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IAEpB,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE9C,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IAEpB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/statements.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=statements.js.map

package/dist/types/statements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statements.js","sourceRoot":"","sources":["../../src/types/statements.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@context-forge/core",
+  "version": "0.1.0",
+  "description": "Core context generation engine for Context Forge — template processing, project state, prompt assembly",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "context-forge",
+    "context",
+    "ai",
+    "template",
+    "prompt"
+  ],
+  "author": "Manta Templates",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ecorkran/context-forge.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/ecorkran/context-forge/tree/main/packages/core#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.1",
+    "typescript": "~5.8.3",
+    "vitest": "^3.2.1"
+  },
+  "dependencies": {
+    "env-paths": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}