@context-forge/core 0.1.0

package/dist/storage/FileProjectStore.d.ts

@@ -0,0 +1,24 @@
+import type { ProjectData, CreateProjectData, UpdateProjectData } from '../types/project.js';
+import type { IProjectStore } from './interfaces.js';
+/**
+ * Filesystem-backed project CRUD store using FileStorageService.
+ * Lazy-initializes on first access, migrating from legacy Electron location if needed.
+ */
+export declare class FileProjectStore implements IProjectStore {
+    private readonly storage;
+    private readonly storagePath;
+    private initialized;
+    constructor();
+    private ensureInitialized;
+    getAll(): Promise<ProjectData[]>;
+    getById(id: string): Promise<ProjectData | undefined>;
+    create(data: CreateProjectData): Promise<ProjectData>;
+    update(id: string, updates: UpdateProjectData): Promise<void>;
+    delete(id: string): Promise<void>;
+    /**
+     * Copy projects.json (and backup) from legacy Electron location to new location.
+     * Only runs if new location has no data and legacy location has data.
+     */
+    private migrateFromLegacyLocation;
+}
+//# sourceMappingURL=FileProjectStore.d.ts.map

package/dist/storage/FileProjectStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileProjectStore.d.ts","sourceRoot":"","sources":["../../src/storage/FileProjectStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA6BrD;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,WAAW,CAAS;;YAOd,iBAAiB;IAUzB,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IA2BhC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAKrD,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BrD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAevC;;;OAGG;YACW,yBAAyB;CA0BxC"}

package/dist/storage/FileProjectStore.js

@@ -0,0 +1,141 @@
+import { copyFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { FileStorageService } from './FileStorageService.js';
+import { getStoragePath, getLegacyElectronPath } from './storagePaths.js';
+const PROJECTS_FILE = 'projects.json';
+function generateProjectId() {
+    return `project_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+}
+/** Apply field-migration defaults for projects missing newer fields. */
+function migrateProjectFields(project) {
+    const base = project;
+    return {
+        ...base,
+        taskFile: typeof project.taskFile === 'string' ? base.taskFile : '',
+        instruction: typeof project.instruction === 'string'
+            ? base.instruction
+            : 'implementation',
+        isMonorepo: typeof project.isMonorepo === 'boolean' ? base.isMonorepo : false,
+        customData: project.customData && typeof project.customData === 'object'
+            ? base.customData
+            : {},
+    };
+}
+/**
+ * Filesystem-backed project CRUD store using FileStorageService.
+ * Lazy-initializes on first access, migrating from legacy Electron location if needed.
+ */
+export class FileProjectStore {
+    storage;
+    storagePath;
+    initialized = false;
+    constructor() {
+        this.storagePath = getStoragePath();
+        this.storage = new FileStorageService(this.storagePath);
+    }
+    async ensureInitialized() {
+        if (this.initialized)
+            return;
+        this.initialized = true;
+        const hasData = await this.storage.exists(PROJECTS_FILE);
+        if (!hasData) {
+            await this.migrateFromLegacyLocation();
+        }
+    }
+    async getAll() {
+        await this.ensureInitialized();
+        try {
+            const result = await this.storage.read(PROJECTS_FILE);
+            const parsed = JSON.parse(result.data);
+            if (!Array.isArray(parsed)) {
+                return [];
+            }
+            return parsed.map((p) => migrateProjectFields(p));
+        }
+        catch (err) {
+            // File not found — empty store
+            if (err instanceof Error &&
+                'code' in err &&
+                err.code === 'ENOENT') {
+                return [];
+            }
+            throw err;
+        }
+    }
+    async getById(id) {
+        const all = await this.getAll();
+        return all.find((p) => p.id === id);
+    }
+    async create(data) {
+        await this.ensureInitialized();
+        const now = new Date().toISOString();
+        const project = {
+            id: generateProjectId(),
+            name: data.name,
+            template: data.template,
+            slice: data.slice,
+            taskFile: data.taskFile ?? '',
+            instruction: data.instruction ?? 'implementation',
+            developmentPhase: data.developmentPhase,
+            workType: data.workType,
+            projectDate: data.projectDate,
+            isMonorepo: data.isMonorepo,
+            isMonorepoEnabled: data.isMonorepoEnabled,
+            projectPath: data.projectPath,
+            customData: data.customData ?? {},
+            createdAt: now,
+            updatedAt: now,
+        };
+        const existing = await this.getAll();
+        existing.push(project);
+        await this.storage.write(PROJECTS_FILE, JSON.stringify(existing, null, 2));
+        return project;
+    }
+    async update(id, updates) {
+        const all = await this.getAll();
+        const index = all.findIndex((p) => p.id === id);
+        if (index === -1) {
+            throw new Error(`Project not found: ${id}`);
+        }
+        all[index] = {
+            ...all[index],
+            ...updates,
+            updatedAt: new Date().toISOString(),
+        };
+        await this.storage.write(PROJECTS_FILE, JSON.stringify(all, null, 2));
+    }
+    async delete(id) {
+        const all = await this.getAll();
+        const index = all.findIndex((p) => p.id === id);
+        if (index === -1) {
+            throw new Error(`Project not found: ${id}`);
+        }
+        const filtered = all.filter((p) => p.id !== id);
+        await this.storage.write(PROJECTS_FILE, JSON.stringify(filtered, null, 2));
+    }
+    /**
+     * Copy projects.json (and backup) from legacy Electron location to new location.
+     * Only runs if new location has no data and legacy location has data.
+     */
+    async migrateFromLegacyLocation() {
+        const legacyPath = getLegacyElectronPath();
+        if (!legacyPath)
+            return false;
+        const newFile = join(this.storagePath, PROJECTS_FILE);
+        const legacyFile = join(legacyPath, PROJECTS_FILE);
+        if (existsSync(newFile) || !existsSync(legacyFile)) {
+            return false;
+        }
+        await mkdir(this.storagePath, { recursive: true });
+        await copyFile(legacyFile, newFile);
+        // Also copy single backup if it exists
+        const legacyBackup = join(legacyPath, `${PROJECTS_FILE}.backup`);
+        if (existsSync(legacyBackup)) {
+            await copyFile(legacyBackup, join(this.storagePath, `${PROJECTS_FILE}.backup`));
+        }
+        console.log(`Migrated projects.json from legacy location: ${legacyPath}`);
+        return true;
+    }
+}
+//# sourceMappingURL=FileProjectStore.js.map

package/dist/storage/FileProjectStore.js.map

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

package/dist/storage/FileStorageService.d.ts

@@ -0,0 +1,14 @@
+import type { IStorageService, StorageReadResult } from './interfaces.js';
+/**
+ * Low-level filesystem storage service implementing atomic writes,
+ * backup on write, and recovery from corrupted files.
+ */
+export declare class FileStorageService implements IStorageService {
+    private readonly storagePath;
+    constructor(storagePath: string);
+    read(filename: string): Promise<StorageReadResult>;
+    write(filename: string, data: string): Promise<void>;
+    createBackup(filename: string): Promise<void>;
+    exists(filename: string): Promise<boolean>;
+}
+//# sourceMappingURL=FileStorageService.d.ts.map

package/dist/storage/FileStorageService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileStorageService.d.ts","sourceRoot":"","sources":["../../src/storage/FileStorageService.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAsB1E;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAE1C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6ClD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CpD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAIjD"}

package/dist/storage/FileStorageService.js

@@ -0,0 +1,114 @@
+import { readFile, writeFile, copyFile, rename, unlink, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { checkWriteGuard } from './backupService.js';
+/** Error thrown when a filename contains path-traversal characters. */
+class InvalidFilenameError extends Error {
+    constructor(filename) {
+        super(`Invalid filename: ${filename}`);
+        this.name = 'InvalidFilenameError';
+    }
+}
+/** Validate a filename — reject path-traversal characters. */
+function validateFilename(filename) {
+    if (filename.includes('..') ||
+        filename.includes('/') ||
+        filename.includes('\\')) {
+        throw new InvalidFilenameError(filename);
+    }
+}
+/**
+ * Low-level filesystem storage service implementing atomic writes,
+ * backup on write, and recovery from corrupted files.
+ */
+export class FileStorageService {
+    storagePath;
+    constructor(storagePath) {
+        this.storagePath = storagePath;
+    }
+    async read(filename) {
+        validateFilename(filename);
+        const filePath = join(this.storagePath, filename);
+        const backupPath = join(this.storagePath, `${filename}.backup`);
+        // Try main file first
+        try {
+            const data = await readFile(filePath, 'utf-8');
+            JSON.parse(data); // validate JSON
+            return { data };
+        }
+        catch (mainError) {
+            // Main file missing or corrupted — try backup recovery
+            try {
+                const backupData = await readFile(backupPath, 'utf-8');
+                JSON.parse(backupData); // validate backup JSON
+                // Restore main file from backup
+                try {
+                    await copyFile(backupPath, filePath);
+                }
+                catch {
+                    // Recovery of main file failed — still return backup data
+                }
+                return {
+                    data: backupData,
+                    recovered: true,
+                    message: 'Data recovered from backup file',
+                };
+            }
+            catch {
+                // Neither main nor backup available/valid
+                if (mainError instanceof Error &&
+                    'code' in mainError &&
+                    mainError.code === 'ENOENT') {
+                    throw mainError; // propagate file-not-found
+                }
+                throw new Error('File corrupted and no valid backup available');
+            }
+        }
+    }
+    async write(filename, data) {
+        validateFilename(filename);
+        // Ensure storage directory exists
+        if (!existsSync(this.storagePath)) {
+            await mkdir(this.storagePath, { recursive: true });
+        }
+        const filePath = join(this.storagePath, filename);
+        const tempPath = join(this.storagePath, `${filename}.tmp`);
+        const backupPath = join(this.storagePath, `${filename}.backup`);
+        // Write guard: prevent catastrophic data loss for projects.json
+        const guardError = await checkWriteGuard(this.storagePath, filename, data);
+        if (guardError) {
+            throw new Error(guardError);
+        }
+        // Backup existing file (single .backup, overwritten each write)
+        if (existsSync(filePath)) {
+            await copyFile(filePath, backupPath);
+        }
+        // Write to temp file
+        await writeFile(tempPath, data, 'utf-8');
+        // Validate JSON
+        try {
+            JSON.parse(data);
+        }
+        catch {
+            if (existsSync(tempPath)) {
+                await unlink(tempPath);
+            }
+            throw new Error('Invalid JSON data');
+        }
+        // Atomic rename
+        await rename(tempPath, filePath);
+    }
+    async createBackup(filename) {
+        validateFilename(filename);
+        const filePath = join(this.storagePath, filename);
+        const backupPath = join(this.storagePath, `${filename}.backup`);
+        if (existsSync(filePath)) {
+            await copyFile(filePath, backupPath);
+        }
+    }
+    async exists(filename) {
+        validateFilename(filename);
+        return existsSync(join(this.storagePath, filename));
+    }
+}
+//# sourceMappingURL=FileStorageService.js.map

package/dist/storage/FileStorageService.js.map

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

package/dist/storage/backupService.d.ts

@@ -0,0 +1,28 @@
+/** Maximum number of versioned backups to retain per file. */
+export declare const MAX_VERSIONED_BACKUPS = 10;
+/** Filesystem operations used by backup functions — injectable for testing. */
+export interface BackupFsDeps {
+    existsSync: (path: string) => boolean;
+    copyFile: (src: string, dest: string) => Promise<void>;
+    readdir: (path: string) => Promise<string[]>;
+    unlink: (path: string) => Promise<void>;
+    readFile: (path: string, encoding: string) => Promise<string>;
+}
+/**
+ * Create a versioned timestamped backup of a file in the storage directory,
+ * then prune old backups beyond the retention limit.
+ */
+export declare function createVersionedBackup(storagePath: string, filename: string, fs?: BackupFsDeps): Promise<void>;
+/**
+ * Prune old versioned backups beyond the retention limit.
+ * Rotation failure must not block the caller.
+ */
+export declare function pruneOldBackups(storagePath: string, filename: string, fs?: BackupFsDeps): Promise<void>;
+/**
+ * Write guard for projects.json: prevents catastrophic data loss by refusing
+ * to overwrite a multi-project file with near-empty data.
+ *
+ * Returns null if write is allowed, or an error message string if blocked.
+ */
+export declare function checkWriteGuard(storagePath: string, filename: string, incomingData: string, fs?: BackupFsDeps): Promise<string | null>;
+//# sourceMappingURL=backupService.d.ts.map

package/dist/storage/backupService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupService.d.ts","sourceRoot":"","sources":["../../src/storage/backupService.ts"],"names":[],"mappings":"AAIA,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/D;AAWD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,EAAE,GAAE,YAA0B,GAC7B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,EAAE,GAAE,YAA0B,GAC7B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,EAAE,GAAE,YAA0B,GAC7B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6BxB"}

package/dist/storage/backupService.js

@@ -0,0 +1,84 @@
+import { copyFile, readdir, unlink, readFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+/** Maximum number of versioned backups to retain per file. */
+export const MAX_VERSIONED_BACKUPS = 10;
+/** Default deps using real fs — used in production. */
+const defaultDeps = {
+    existsSync,
+    copyFile,
+    readdir: readdir,
+    unlink,
+    readFile: readFile,
+};
+/**
+ * Create a versioned timestamped backup of a file in the storage directory,
+ * then prune old backups beyond the retention limit.
+ */
+export async function createVersionedBackup(storagePath, filename, fs = defaultDeps) {
+    const filePath = join(storagePath, filename);
+    if (!fs.existsSync(filePath))
+        return;
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const versionedPath = join(storagePath, `${filename}.${timestamp}.backup`);
+    await fs.copyFile(filePath, versionedPath);
+    console.log(`Versioned backup created: ${filename}.${timestamp}.backup`);
+    await pruneOldBackups(storagePath, filename, fs);
+}
+/**
+ * Prune old versioned backups beyond the retention limit.
+ * Rotation failure must not block the caller.
+ */
+export async function pruneOldBackups(storagePath, filename, fs = defaultDeps) {
+    try {
+        const entries = await fs.readdir(storagePath);
+        const versionedPattern = `${filename}.`;
+        const versionedBackups = entries
+            .filter((e) => e.startsWith(versionedPattern) &&
+            e.endsWith('.backup') &&
+            e !== `${filename}.backup`)
+            .sort()
+            .reverse(); // newest first (ISO timestamps sort lexicographically)
+        if (versionedBackups.length > MAX_VERSIONED_BACKUPS) {
+            const toDelete = versionedBackups.slice(MAX_VERSIONED_BACKUPS);
+            for (const old of toDelete) {
+                await fs.unlink(join(storagePath, old));
+            }
+            console.log(`Pruned ${toDelete.length} old versioned backup(s) for ${filename}`);
+        }
+    }
+    catch (err) {
+        console.error(`Backup rotation failed for ${filename}:`, err);
+    }
+}
+/**
+ * Write guard for projects.json: prevents catastrophic data loss by refusing
+ * to overwrite a multi-project file with near-empty data.
+ *
+ * Returns null if write is allowed, or an error message string if blocked.
+ */
+export async function checkWriteGuard(storagePath, filename, incomingData, fs = defaultDeps) {
+    if (filename !== 'projects.json')
+        return null;
+    const filePath = join(storagePath, filename);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const existing = await fs.readFile(filePath, 'utf-8');
+        const existingParsed = JSON.parse(existing);
+        const incomingParsed = JSON.parse(incomingData);
+        if (Array.isArray(existingParsed) && Array.isArray(incomingParsed)) {
+            if (existingParsed.length > 2 && incomingParsed.length <= 1) {
+                const msg = `Write guard: significant data reduction detected (${existingParsed.length} → ${incomingParsed.length})`;
+                console.error(`Write guard: refusing to overwrite ${existingParsed.length} projects with ${incomingParsed.length}`);
+                return msg;
+            }
+        }
+    }
+    catch (err) {
+        // Guard itself failed (e.g., existing file unparseable) — allow write through
+        console.error(`Write guard check failed for ${filename}, allowing write:`, err);
+    }
+    return null;
+}
+//# sourceMappingURL=backupService.js.map

package/dist/storage/backupService.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,6 @@
+export * from './interfaces.js';
+export { FileStorageService } from './FileStorageService.js';
+export { FileProjectStore } from './FileProjectStore.js';
+export { getStoragePath, getLegacyElectronPath } from './storagePaths.js';
+export { createVersionedBackup, pruneOldBackups, checkWriteGuard, MAX_VERSIONED_BACKUPS, type BackupFsDeps, } from './backupService.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,7 @@
+// Storage module barrel — re-exports all storage interfaces, services, and utilities
+export * from './interfaces.js';
+export { FileStorageService } from './FileStorageService.js';
+export { FileProjectStore } from './FileProjectStore.js';
+export { getStoragePath, getLegacyElectronPath } from './storagePaths.js';
+export { createVersionedBackup, pruneOldBackups, checkWriteGuard, MAX_VERSIONED_BACKUPS, } from './backupService.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,qBAAqB,GAEtB,MAAM,oBAAoB,CAAC"}

package/dist/storage/interfaces.d.ts

@@ -0,0 +1,23 @@
+import type { ProjectData, CreateProjectData, UpdateProjectData } from '../types/project.js';
+/** Result of a storage read operation, with optional recovery metadata. */
+export interface StorageReadResult {
+    data: string;
+    recovered?: boolean;
+    message?: string;
+}
+/** Low-level storage service for reading/writing arbitrary JSON files with backup support. */
+export interface IStorageService {
+    read(filename: string): Promise<StorageReadResult>;
+    write(filename: string, data: string): Promise<void>;
+    createBackup(filename: string): Promise<void>;
+    exists(filename: string): Promise<boolean>;
+}
+/** High-level project CRUD store. */
+export interface IProjectStore {
+    getAll(): Promise<ProjectData[]>;
+    getById(id: string): Promise<ProjectData | undefined>;
+    create(data: CreateProjectData): Promise<ProjectData>;
+    update(id: string, updates: UpdateProjectData): Promise<void>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/storage/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/storage/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7F,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACtD,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

package/dist/storage/interfaces.js

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

package/dist/storage/interfaces.js.map

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

package/dist/storage/storagePaths.d.ts

@@ -0,0 +1,9 @@
+/** Canonical storage path for context-forge data. Respects CONTEXT_FORGE_DATA_DIR override. */
+export declare function getStoragePath(): string;
+/**
+ * Legacy Electron storage path (macOS only).
+ * Returns the path Electron's `app.getPath('userData')` + `/context-forge` used,
+ * or null on non-macOS platforms where env-paths typically resolves to the same location.
+ */
+export declare function getLegacyElectronPath(): string | null;
+//# sourceMappingURL=storagePaths.d.ts.map

package/dist/storage/storagePaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storagePaths.d.ts","sourceRoot":"","sources":["../../src/storage/storagePaths.ts"],"names":[],"mappings":"AAMA,+FAA+F;AAC/F,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAKrD"}

package/dist/storage/storagePaths.js

@@ -0,0 +1,20 @@
+import envPaths from 'env-paths';
+import { join } from 'path';
+import { homedir } from 'os';
+const paths = envPaths('context-forge', { suffix: '' });
+/** Canonical storage path for context-forge data. Respects CONTEXT_FORGE_DATA_DIR override. */
+export function getStoragePath() {
+    return process.env.CONTEXT_FORGE_DATA_DIR || paths.config;
+}
+/**
+ * Legacy Electron storage path (macOS only).
+ * Returns the path Electron's `app.getPath('userData')` + `/context-forge` used,
+ * or null on non-macOS platforms where env-paths typically resolves to the same location.
+ */
+export function getLegacyElectronPath() {
+    if (process.platform === 'darwin') {
+        return join(homedir(), 'Library', 'Application Support', 'context-forge', 'context-forge');
+    }
+    return null;
+}
+//# sourceMappingURL=storagePaths.js.map

package/dist/storage/storagePaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storagePaths.js","sourceRoot":"","sources":["../../src/storage/storagePaths.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;AAExD,+FAA+F;AAC/F,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,KAAK,CAAC,MAAM,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/types/context.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Data structure for context generation.
+ * Maps directly to template variables.
+ * Consolidated from renderer superset (includes taskFile, developmentPhase, workType, projectDate).
+ */
+export interface ContextData {
+    projectName: string;
+    template: string;
+    slice: string;
+    taskFile: string;
+    instruction: string;
+    developmentPhase?: string;
+    workType?: 'start' | 'continue';
+    projectDate?: string;
+    isMonorepo: boolean;
+    recentEvents: string;
+    additionalNotes: string;
+}
+/**
+ * Enhanced context data with additional fields for template system.
+ * Single canonical definition — consolidates previous duplicates in
+ * ContextData.ts and ContextSection.ts across main/renderer.
+ */
+export interface EnhancedContextData extends ContextData {
+    availableTools?: string[];
+    mcpServers?: string[];
+    templateVersion?: string;
+    customSections?: Record<string, string>;
+    customData?: {
+        recentEvents?: string;
+        additionalNotes?: string;
+        monorepoNote?: string;
+        availableTools?: string;
+    };
+}
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,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,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,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"}

package/dist/types/context.js

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

package/dist/types/context.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+export type { ContextData, EnhancedContextData } from './context.js';
+export type { ContextSection, ContextTemplate, SectionBuilderConfig, SectionValidation } from './sections.js';
+export { SectionKeys } from './sections.js';
+export type { TemplateStatement, StatementConfig, StatementFileMetadata, ParsedStatement } from './statements.js';
+export type { SystemPrompt, ParsedPromptFile, PromptCacheEntry } from './prompts.js';
+export { SpecialPromptKeys } from './prompts.js';
+export type { ProjectData, CreateProjectData, UpdateProjectData } from './project.js';
+export type { PathValidationResult, DirectoryListResult } from './paths.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGrE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC9G,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlH,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtF,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+export { SectionKeys } from './sections.js';
+export { SpecialPromptKeys } from './prompts.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}