@context-forge/core 0.1.1 → 0.3.0

package/README.md

@@ -8,7 +8,7 @@ This package contains the core logic shared by both the [MCP server](../mcp-serv
 
 Key capabilities:
 - **Context pipeline** — assembles structured context prompts from project configuration, templates, and statements
-- **Template processing** — variable substitution (`{{projectName}}`, `{{slice}}`, etc.) with conditional sections
+- **Template processing** — variable substitution (`{{projectName}}`, `{{fileSlice}}`, 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
@@ -37,6 +37,14 @@ 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';
+
+// Artifact introspection
+import { ArtifactIntrospector } from '@context-forge/core/node';
+import { buildModel, scanDirectory } from '@context-forge/core/node';
+import { parseFrontmatter, parseSlicePlan } from '@context-forge/core/node';
+import { parseTaskItems, parseTaskFile } from '@context-forge/core/node';
+import { parseFutureWork, detectDocuments } from '@context-forge/core/node';
+import { FutureWorkCollector } 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.
@@ -53,6 +61,9 @@ This entry point includes filesystem-dependent services. Use it in main processe
 | `ContextIntegrator` | `.` | Orchestrates full context generation from a `ProjectData` object |
 | `TemplateProcessor` | `.` | Handles `{{variable}}` substitution in template strings |
 | `SectionBuilder` | `.` | Assembles individual context sections (statements, instructions, tools) |
+| `ArtifactIntrospector` | `./node` | Parses methodology documents: slice plans, task files, frontmatter, future work, document detection |
+| `buildModel` | `./node` | Builds a full `ProjectModel` from a project root path — foundation, initiatives, slices, tasks, future work |
+| `FutureWorkCollector` | `./node` | Aggregates future work items across all slice plans; groups by initiative; supports status filtering |
 
 ## Usage in the Monorepo
 

package/dist/config/ConfigKeys.d.ts

@@ -0,0 +1,9 @@
+export interface ConfigKeyDefinition {
+    type: 'string' | 'boolean' | 'number';
+    default: string | boolean | number;
+    description: string;
+    enum?: string[];
+    validate?: (value: string | boolean | number) => string | null;
+}
+export declare const CONFIG_KEYS: Record<string, ConfigKeyDefinition>;
+//# sourceMappingURL=ConfigKeys.d.ts.map

package/dist/config/ConfigKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigKeys.d.ts","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAChE;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAsB3D,CAAC"}

package/dist/config/ConfigKeys.js

@@ -0,0 +1,24 @@
+export const CONFIG_KEYS = {
+    default_project: {
+        type: 'string',
+        default: '',
+        description: 'Default project ID used when projectId is not provided to MCP tools',
+    },
+    'guide.auto_update': {
+        type: 'boolean',
+        default: false,
+        description: 'Whether to automatically update the AI project guide',
+    },
+    'guide.source': {
+        type: 'string',
+        default: '',
+        description: 'URL or path to the AI project guide source',
+    },
+    'guide.git_strategy': {
+        type: 'string',
+        default: 'submodule',
+        description: 'Strategy for managing the AI project guide via git',
+        enum: ['submodule', 'clone', 'manual'],
+    },
+};
+//# sourceMappingURL=ConfigKeys.js.map

package/dist/config/ConfigKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigKeys.js","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,WAAW,GAAwC;IAC9D,eAAe,EAAE;QACf,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,qEAAqE;KACnF;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,sDAAsD;KACpE;IACD,cAAc,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,4CAA4C;KAC1D;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,oDAAoD;QACjE,IAAI,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC;KACvC;CACF,CAAC"}

package/dist/config/ConfigManager.d.ts

@@ -0,0 +1,18 @@
+export interface ConfigResult {
+    key: string;
+    value: string | boolean | number;
+    source: 'project' | 'user' | 'default';
+    description: string;
+}
+export interface ConfigListEntry extends ConfigResult {
+    type: 'string' | 'boolean' | 'number';
+    defaultValue: string | boolean | number;
+}
+export declare class ConfigManager {
+    private readonly projectPath;
+    constructor(projectPath?: string);
+    get(key: string): Promise<ConfigResult>;
+    set(key: string, value: string | boolean | number, scope: 'user' | 'project'): Promise<void>;
+    list(): Promise<ConfigListEntry[]>;
+}
+//# sourceMappingURL=ConfigManager.d.ts.map

package/dist/config/ConfigManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../src/config/ConfigManager.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,YAAY,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CACzC;AAmED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;gBAErC,WAAW,CAAC,EAAE,MAAM;IAI1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyCvC,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAChC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,IAAI,CAAC;IAqBV,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CAYzC"}

package/dist/config/ConfigManager.js

@@ -0,0 +1,129 @@
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { dirname } from 'path';
+import { parse, stringify } from 'smol-toml';
+import { CONFIG_KEYS } from './ConfigKeys.js';
+import { getUserConfigPath, getProjectConfigPath } from './configPaths.js';
+async function readToml(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return parse(content);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return {};
+        }
+        throw err;
+    }
+}
+async function writeToml(filePath, data) {
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, stringify(data), 'utf-8');
+}
+function resolveKey(obj, key) {
+    const parts = key.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function setKey(obj, key, value) {
+    const parts = key.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!(part in current) || typeof current[part] !== 'object' || current[part] === null) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+function validateValue(key, value, def) {
+    if (typeof value !== def.type) {
+        throw new Error(`Config key "${key}" expects type "${def.type}", got "${typeof value}"`);
+    }
+    if (def.enum && typeof value === 'string' && !def.enum.includes(value)) {
+        throw new Error(`Config key "${key}" must be one of [${def.enum.map((v) => `"${v}"`).join(', ')}], got "${value}"`);
+    }
+    if (def.validate) {
+        const error = def.validate(value);
+        if (error !== null) {
+            throw new Error(`Config key "${key}" validation failed: ${error}`);
+        }
+    }
+}
+export class ConfigManager {
+    projectPath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+    }
+    async get(key) {
+        const def = CONFIG_KEYS[key];
+        if (!def) {
+            throw new Error(`Unknown config key: "${key}"`);
+        }
+        // Check project config first
+        if (this.projectPath) {
+            const projectConfig = await readToml(getProjectConfigPath(this.projectPath));
+            const projectValue = resolveKey(projectConfig, key);
+            if (projectValue !== undefined) {
+                return {
+                    key,
+                    value: projectValue,
+                    source: 'project',
+                    description: def.description,
+                };
+            }
+        }
+        // Then user config
+        const userConfig = await readToml(getUserConfigPath());
+        const userValue = resolveKey(userConfig, key);
+        if (userValue !== undefined) {
+            return {
+                key,
+                value: userValue,
+                source: 'user',
+                description: def.description,
+            };
+        }
+        // Fall back to built-in default
+        return {
+            key,
+            value: def.default,
+            source: 'default',
+            description: def.description,
+        };
+    }
+    async set(key, value, scope) {
+        const def = CONFIG_KEYS[key];
+        if (!def) {
+            throw new Error(`Unknown config key: "${key}"`);
+        }
+        if (scope === 'project' && !this.projectPath) {
+            throw new Error(`Cannot set project-scoped config: no projectPath provided`);
+        }
+        validateValue(key, value, def);
+        const filePath = scope === 'project'
+            ? getProjectConfigPath(this.projectPath)
+            : getUserConfigPath();
+        const existing = await readToml(filePath);
+        setKey(existing, key, value);
+        await writeToml(filePath, existing);
+    }
+    async list() {
+        const results = [];
+        for (const [key, def] of Object.entries(CONFIG_KEYS)) {
+            const result = await this.get(key);
+            results.push({
+                ...result,
+                type: def.type,
+                defaultValue: def.default,
+            });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=ConfigManager.js.map

package/dist/config/ConfigManager.js.map

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

package/dist/config/configPaths.d.ts

@@ -0,0 +1,5 @@
+/** Returns the user-level config file path: {storagePath}/config.toml */
+export declare function getUserConfigPath(): string;
+/** Returns the project-level config file path: {projectPath}/.context-forge.toml */
+export declare function getProjectConfigPath(projectPath: string): string;
+//# sourceMappingURL=configPaths.d.ts.map

package/dist/config/configPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configPaths.d.ts","sourceRoot":"","sources":["../../src/config/configPaths.ts"],"names":[],"mappings":"AAGA,yEAAyE;AACzE,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/config/configPaths.js

@@ -0,0 +1,11 @@
+import { join } from 'path';
+import { getStoragePath } from '../storage/storagePaths.js';
+/** Returns the user-level config file path: {storagePath}/config.toml */
+export function getUserConfigPath() {
+    return join(getStoragePath(), 'config.toml');
+}
+/** Returns the project-level config file path: {projectPath}/.context-forge.toml */
+export function getProjectConfigPath(projectPath) {
+    return join(projectPath, '.context-forge.toml');
+}
+//# sourceMappingURL=configPaths.js.map

package/dist/config/configPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configPaths.js","sourceRoot":"","sources":["../../src/config/configPaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,yEAAyE;AACzE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,aAAa,CAAC,CAAC;AAC/C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,OAAO,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;AAClD,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,4 @@
+export { ConfigKeyDefinition, CONFIG_KEYS } from './ConfigKeys.js';
+export { ConfigResult, ConfigListEntry, ConfigManager } from './ConfigManager.js';
+export { getUserConfigPath, getProjectConfigPath } from './configPaths.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,4 @@
+export { CONFIG_KEYS } from './ConfigKeys.js';
+export { ConfigManager } from './ConfigManager.js';
+export { getUserConfigPath, getProjectConfigPath } from './configPaths.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAiC,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/guides/GuideDetector.d.ts

@@ -0,0 +1,20 @@
+import { type GuideInfo } from './types.js';
+/**
+ * Compare two semver version strings. Returns true if latest > current.
+ */
+export declare function isNewerVersion(current: string | null, latest: string | null): boolean;
+export declare class GuideDetector {
+    /**
+     * Detect guide installation state for a project.
+     * @param projectPath - absolute path to the project root
+     * @param source - override source URL (defaults to DEFAULT_SOURCE_GIT)
+     */
+    detect(projectPath: string, source?: string): Promise<GuideInfo>;
+    /** Determine installation method by inspecting filesystem */
+    private detectMethod;
+    /** Detect current version based on method */
+    private detectVersion;
+    /** Fetch latest version from remote. Returns null on any failure. */
+    private fetchLatestVersion;
+}
+//# sourceMappingURL=GuideDetector.d.ts.map

package/dist/guides/GuideDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuideDetector.d.ts","sourceRoot":"","sources":["../../src/guides/GuideDetector.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,SAAS,EAKf,MAAM,YAAY,CAAC;AAiCpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CASrF;AAED,qBAAa,aAAa;IACxB;;;;OAIG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAuCtE,6DAA6D;IAC7D,OAAO,CAAC,YAAY;IAuBpB,6CAA6C;YAC/B,aAAa;IAmB3B,qEAAqE;YACvD,kBAAkB;CAWjC"}

package/dist/guides/GuideDetector.js

@@ -0,0 +1,142 @@
+// Detect guide installation state, method, and version
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { DEFAULT_SOURCE_GIT, GUIDE_RELATIVE_PATH, VERSION_MARKER_FILE, } from './types.js';
+import { gitExec } from './gitExec.js';
+/**
+ * Parse the highest semver tag from `git ls-remote --tags` output.
+ * Returns null if no valid tags found.
+ */
+function parseHighestTag(lsRemoteOutput) {
+    const tagPattern = /refs\/tags\/(v?\d+\.\d+\.\d+)$/;
+    const tags = [];
+    for (const line of lsRemoteOutput.split('\n')) {
+        const match = tagPattern.exec(line.trim());
+        if (match) {
+            tags.push(match[1]);
+        }
+    }
+    if (tags.length === 0)
+        return null;
+    // Sort by semver descending
+    tags.sort((a, b) => {
+        const pa = a.replace(/^v/, '').split('.').map(Number);
+        const pb = b.replace(/^v/, '').split('.').map(Number);
+        for (let i = 0; i < 3; i++) {
+            if (pa[i] !== pb[i])
+                return pb[i] - pa[i];
+        }
+        return 0;
+    });
+    return tags[0];
+}
+/**
+ * Compare two semver version strings. Returns true if latest > current.
+ */
+export function isNewerVersion(current, latest) {
+    if (!current || !latest)
+        return false;
+    const ca = current.replace(/^v/, '').split('.').map(Number);
+    const la = latest.replace(/^v/, '').split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if (la[i] > ca[i])
+            return true;
+        if (la[i] < ca[i])
+            return false;
+    }
+    return false;
+}
+export class GuideDetector {
+    /**
+     * Detect guide installation state for a project.
+     * @param projectPath - absolute path to the project root
+     * @param source - override source URL (defaults to DEFAULT_SOURCE_GIT)
+     */
+    async detect(projectPath, source) {
+        const resolvedSource = source || DEFAULT_SOURCE_GIT;
+        const guidePath = join(projectPath, GUIDE_RELATIVE_PATH);
+        const baseInfo = {
+            installed: false,
+            method: null,
+            version: null,
+            path: guidePath,
+            source: resolvedSource,
+            latestVersion: null,
+            updateAvailable: false,
+            usingBundledPrompt: true,
+        };
+        if (!existsSync(guidePath)) {
+            // Check latest version even when not installed
+            baseInfo.latestVersion = await this.fetchLatestVersion(resolvedSource);
+            return baseInfo;
+        }
+        // Guide directory exists — determine method
+        const method = this.detectMethod(projectPath, guidePath);
+        const version = await this.detectVersion(guidePath, method);
+        const latestVersion = await this.fetchLatestVersion(resolvedSource);
+        const updateAvailable = isNewerVersion(version, latestVersion);
+        return {
+            installed: true,
+            method,
+            version,
+            path: guidePath,
+            source: resolvedSource,
+            latestVersion,
+            updateAvailable,
+            usingBundledPrompt: false,
+        };
+    }
+    /** Determine installation method by inspecting filesystem */
+    detectMethod(projectPath, guidePath) {
+        // Check .gitmodules first — submodules also have a .git entry inside
+        // the guide directory, so checking .git first would misidentify them as clones
+        const gitmodulesPath = join(projectPath, '.gitmodules');
+        if (existsSync(gitmodulesPath)) {
+            try {
+                const content = readFileSync(gitmodulesPath, 'utf-8');
+                if (content.includes(GUIDE_RELATIVE_PATH)) {
+                    return 'submodule';
+                }
+            }
+            catch {
+                // Fall through
+            }
+        }
+        // Check for .git subdirectory → clone (only reached if not a submodule)
+        if (existsSync(join(guidePath, '.git'))) {
+            return 'clone';
+        }
+        return 'manual';
+    }
+    /** Detect current version based on method */
+    async detectVersion(guidePath, method) {
+        if (method === 'submodule' || method === 'clone') {
+            try {
+                const { stdout } = await gitExec(['describe', '--tags', '--abbrev=0'], guidePath);
+                return stdout || null;
+            }
+            catch {
+                return null;
+            }
+        }
+        // Manual: read version marker file
+        const markerPath = join(guidePath, VERSION_MARKER_FILE);
+        try {
+            return readFileSync(markerPath, 'utf-8').trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Fetch latest version from remote. Returns null on any failure. */
+    async fetchLatestVersion(source) {
+        try {
+            const { stdout } = await gitExec(['ls-remote', '--tags', '--sort=-v:refname', source], process.cwd());
+            return parseHighestTag(stdout);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=GuideDetector.js.map

package/dist/guides/GuideDetector.js.map

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

package/dist/guides/GuideManager.d.ts

@@ -0,0 +1,21 @@
+import type { ConfigManager } from '../config/ConfigManager.js';
+import type { GuideInfo, GuideMethod, InstallResult, UpdateResult } from './types.js';
+export declare class GuideManager {
+    private readonly projectPath;
+    private readonly configManager?;
+    private readonly detector;
+    constructor(projectPath: string, configManager?: ConfigManager);
+    /** Get current guide installation status */
+    status(): Promise<GuideInfo>;
+    /** Install the guide into the project */
+    install(strategyOverride?: GuideMethod, sourceOverride?: string): Promise<InstallResult>;
+    /** Update an existing guide installation */
+    update(): Promise<UpdateResult>;
+    /** Resolve source URL from config or default */
+    private resolveSource;
+    /** Resolve strategy from config or default */
+    private resolveStrategy;
+    /** Map method name to strategy instance */
+    private getStrategy;
+}
+//# sourceMappingURL=GuideManager.d.ts.map

package/dist/guides/GuideManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuideManager.d.ts","sourceRoot":"","sources":["../../src/guides/GuideManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAC;AAOvG,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa;IAM9D,4CAA4C;IACtC,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAKlC,yCAAyC;IACnC,OAAO,CAAC,gBAAgB,CAAC,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAiB9F,4CAA4C;IACtC,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAerC,gDAAgD;YAClC,aAAa;IAc3B,8CAA8C;YAChC,eAAe;IAc7B,2CAA2C;IAC3C,OAAO,CAAC,WAAW;CAUpB"}

package/dist/guides/GuideManager.js

@@ -0,0 +1,88 @@
+// Orchestration layer for guide lifecycle management
+import { join } from 'path';
+import { DEFAULT_SOURCE_GIT, GUIDE_RELATIVE_PATH } from './types.js';
+import { GuideDetector } from './GuideDetector.js';
+import { SubmoduleStrategy } from './strategies/SubmoduleStrategy.js';
+import { CloneStrategy } from './strategies/CloneStrategy.js';
+import { TarballStrategy } from './strategies/TarballStrategy.js';
+export class GuideManager {
+    projectPath;
+    configManager;
+    detector;
+    constructor(projectPath, configManager) {
+        this.projectPath = projectPath;
+        this.configManager = configManager;
+        this.detector = new GuideDetector();
+    }
+    /** Get current guide installation status */
+    async status() {
+        const source = await this.resolveSource();
+        return this.detector.detect(this.projectPath, source);
+    }
+    /** Install the guide into the project */
+    async install(strategyOverride, sourceOverride) {
+        const source = sourceOverride || (await this.resolveSource());
+        const method = strategyOverride || (await this.resolveStrategy());
+        const targetDir = join(this.projectPath, GUIDE_RELATIVE_PATH);
+        // Check if already installed
+        const info = await this.detector.detect(this.projectPath, source);
+        if (info.installed) {
+            throw new Error('Guide is already installed. Use guide_update (or cf guides update) to update it.');
+        }
+        const strategy = this.getStrategy(method);
+        return strategy.install(this.projectPath, source, targetDir);
+    }
+    /** Update an existing guide installation */
+    async update() {
+        const source = await this.resolveSource();
+        const targetDir = join(this.projectPath, GUIDE_RELATIVE_PATH);
+        const info = await this.detector.detect(this.projectPath, source);
+        if (!info.installed || !info.method) {
+            throw new Error('Guide is not installed. Use guide_install (or cf guides install) to install it first.');
+        }
+        const strategy = this.getStrategy(info.method);
+        return strategy.update(this.projectPath, targetDir);
+    }
+    /** Resolve source URL from config or default */
+    async resolveSource() {
+        if (this.configManager) {
+            try {
+                const result = await this.configManager.get('guide.source');
+                if (result.value && typeof result.value === 'string' && result.value.length > 0) {
+                    return result.value;
+                }
+            }
+            catch {
+                // Fall through to default
+            }
+        }
+        return DEFAULT_SOURCE_GIT;
+    }
+    /** Resolve strategy from config or default */
+    async resolveStrategy() {
+        if (this.configManager) {
+            try {
+                const result = await this.configManager.get('guide.git_strategy');
+                if (result.value && typeof result.value === 'string') {
+                    return result.value;
+                }
+            }
+            catch {
+                // Fall through to default
+            }
+        }
+        return 'submodule';
+    }
+    /** Map method name to strategy instance */
+    getStrategy(method) {
+        switch (method) {
+            case 'submodule':
+                return new SubmoduleStrategy();
+            case 'clone':
+                return new CloneStrategy();
+            case 'manual':
+                return new TarballStrategy();
+        }
+    }
+}
+//# sourceMappingURL=GuideManager.js.map

package/dist/guides/GuideManager.js.map

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

package/dist/guides/gitExec.d.ts

@@ -0,0 +1,15 @@
+export interface GitExecResult {
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Execute a git command safely using execFile (no shell injection).
+ * @param args - arguments to pass to git (e.g., ['clone', url, dir])
+ * @param cwd - working directory for the command
+ */
+export declare function gitExec(args: string[], cwd: string): Promise<GitExecResult>;
+/** Check whether git is available on the system */
+export declare function isGitAvailable(): Promise<boolean>;
+/** Check whether a directory is inside a git repository */
+export declare function isGitRepo(dir: string): Promise<boolean>;
+//# sourceMappingURL=gitExec.d.ts.map

package/dist/guides/gitExec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitExec.d.ts","sourceRoot":"","sources":["../../src/guides/gitExec.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAc3E;AAED,mDAAmD;AACnD,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAOvD;AAED,2DAA2D;AAC3D,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7D"}

package/dist/guides/gitExec.js

@@ -0,0 +1,39 @@
+// Safe shell execution wrapper for git commands
+import { execFile } from 'child_process';
+/**
+ * Execute a git command safely using execFile (no shell injection).
+ * @param args - arguments to pass to git (e.g., ['clone', url, dir])
+ * @param cwd - working directory for the command
+ */
+export function gitExec(args, cwd) {
+    return new Promise((resolve, reject) => {
+        execFile('git', args, { cwd }, (error, stdout, stderr) => {
+            if (error) {
+                reject(new Error(`git ${args.join(' ')} failed in ${cwd}: ${stderr.trim() || error.message}`));
+                return;
+            }
+            resolve({ stdout: stdout.trim(), stderr: stderr.trim() });
+        });
+    });
+}
+/** Check whether git is available on the system */
+export async function isGitAvailable() {
+    try {
+        await gitExec(['--version'], process.cwd());
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Check whether a directory is inside a git repository */
+export async function isGitRepo(dir) {
+    try {
+        await gitExec(['rev-parse', '--is-inside-work-tree'], dir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=gitExec.js.map