@context-forge/core 0.1.1 → 0.2.2

package/dist/guides/gitExec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitExec.js","sourceRoot":"","sources":["../../src/guides/gitExec.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOzC;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,GAAW;IACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACvD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CACJ,IAAI,KAAK,CACP,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAC5E,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YACD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,GAAG,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/guides/index.d.ts

@@ -0,0 +1,4 @@
+export { GuideManager } from './GuideManager.js';
+export { GuideDetector } from './GuideDetector.js';
+export { type GuideInfo, type GuideMethod, type InstallResult, type UpdateResult, type DetectionResult, type InstallStrategy, DEFAULT_SOURCE_GIT, DEFAULT_SOURCE_API, GUIDE_RELATIVE_PATH, VERSION_MARKER_FILE, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guides/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/guides/index.js

@@ -0,0 +1,5 @@
+// Guide management — public exports
+export { GuideManager } from './GuideManager.js';
+export { GuideDetector } from './GuideDetector.js';
+export { DEFAULT_SOURCE_GIT, DEFAULT_SOURCE_API, GUIDE_RELATIVE_PATH, VERSION_MARKER_FILE, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/guides/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guides/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAOL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/guides/strategies/CloneStrategy.d.ts

@@ -0,0 +1,7 @@
+import type { InstallStrategy, InstallResult, UpdateResult, DetectionResult } from '../types.js';
+export declare class CloneStrategy implements InstallStrategy {
+    detect(_projectPath: string, targetDir: string): Promise<DetectionResult | null>;
+    install(_projectPath: string, source: string, targetDir: string): Promise<InstallResult>;
+    update(_projectPath: string, targetDir: string): Promise<UpdateResult>;
+}
+//# sourceMappingURL=CloneStrategy.d.ts.map

package/dist/guides/strategies/CloneStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloneStrategy.d.ts","sourceRoot":"","sources":["../../../src/guides/strategies/CloneStrategy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGjG,qBAAa,aAAc,YAAW,eAAe;IAC7C,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAsBhF,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBxF,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CA0C7E"}

package/dist/guides/strategies/CloneStrategy.js

@@ -0,0 +1,80 @@
+// Clone-based guide installation strategy
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { gitExec, isGitAvailable } from '../gitExec.js';
+export class CloneStrategy {
+    async detect(_projectPath, targetDir) {
+        if (!existsSync(join(targetDir, '.git')))
+            return null;
+        let version = null;
+        try {
+            const { stdout } = await gitExec(['describe', '--tags', '--abbrev=0'], targetDir);
+            version = stdout || null;
+        }
+        catch {
+            // No tags
+        }
+        let source = null;
+        try {
+            const { stdout } = await gitExec(['remote', 'get-url', 'origin'], targetDir);
+            source = stdout || null;
+        }
+        catch {
+            // No remote
+        }
+        return { method: 'clone', version, source };
+    }
+    async install(_projectPath, source, targetDir) {
+        if (!(await isGitAvailable())) {
+            throw new Error('git is not available. Install git or use the "manual" strategy instead.');
+        }
+        await gitExec(['clone', source, targetDir], process.cwd());
+        let version = null;
+        try {
+            const { stdout } = await gitExec(['describe', '--tags', '--abbrev=0'], targetDir);
+            version = stdout || null;
+        }
+        catch {
+            // No tags
+        }
+        return { success: true, version, method: 'clone', path: targetDir };
+    }
+    async update(_projectPath, targetDir) {
+        let previousVersion = null;
+        try {
+            const { stdout } = await gitExec(['describe', '--tags', '--abbrev=0'], targetDir);
+            previousVersion = stdout || null;
+        }
+        catch {
+            // No previous version
+        }
+        // Fetch latest from remote, then try pull. If pull fails (e.g. detached HEAD),
+        // fetch + checkout the latest tag instead.
+        await gitExec(['fetch', '--tags', 'origin'], targetDir);
+        try {
+            await gitExec(['pull', '--ff-only'], targetDir);
+        }
+        catch {
+            // Detached HEAD or no tracking branch — checkout latest tag
+            const { stdout: latestTag } = await gitExec(['describe', '--tags', '--abbrev=0', 'origin/HEAD'], targetDir).catch(async () => {
+                // origin/HEAD may not exist; fall back to sorting tags
+                const { stdout: tags } = await gitExec(['tag', '--sort=-v:refname'], targetDir);
+                const first = tags.split('\n')[0]?.trim();
+                if (!first)
+                    throw new Error('No tags found after fetch');
+                return { stdout: first, stderr: '' };
+            });
+            await gitExec(['checkout', latestTag], targetDir);
+        }
+        let newVersion = null;
+        try {
+            const { stdout } = await gitExec(['describe', '--tags', '--abbrev=0'], targetDir);
+            newVersion = stdout || null;
+        }
+        catch {
+            // No new version
+        }
+        return { success: true, previousVersion, newVersion, method: 'clone' };
+    }
+}
+//# sourceMappingURL=CloneStrategy.js.map

package/dist/guides/strategies/CloneStrategy.js.map

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

package/dist/guides/strategies/SubmoduleStrategy.d.ts

@@ -0,0 +1,7 @@
+import type { InstallStrategy, InstallResult, UpdateResult, DetectionResult } from '../types.js';
+export declare class SubmoduleStrategy implements InstallStrategy {
+    detect(projectPath: string, targetDir: string): Promise<DetectionResult | null>;
+    install(projectPath: string, source: string, targetDir: string): Promise<InstallResult>;
+    update(projectPath: string, targetDir: string): Promise<UpdateResult>;
+}
+//# sourceMappingURL=SubmoduleStrategy.d.ts.map

package/dist/guides/strategies/SubmoduleStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubmoduleStrategy.d.ts","sourceRoot":"","sources":["../../../src/guides/strategies/SubmoduleStrategy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAIjG,qBAAa,iBAAkB,YAAW,eAAe;IACjD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA2B/E,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA0BvF,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAqB5E"}

package/dist/guides/strategies/SubmoduleStrategy.js

@@ -0,0 +1,74 @@
+// Submodule-based guide installation strategy
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { GUIDE_RELATIVE_PATH } from '../types.js';
+import { gitExec, isGitAvailable, isGitRepo } from '../gitExec.js';
+export class SubmoduleStrategy {
+    async detect(projectPath, targetDir) {
+        const gitmodulesPath = join(projectPath, '.gitmodules');
+        if (!existsSync(gitmodulesPath))
+            return null;
+        try {
+            const content = readFileSync(gitmodulesPath, 'utf-8');
+            if (!content.includes(GUIDE_RELATIVE_PATH))
+                return null;
+            let version = null;
+            try {
+                const { stdout } = await gitExec(['describe', '--tags', '--abbrev=0'], targetDir);
+                version = stdout || null;
+            }
+            catch {
+                // No tags or not initialized
+            }
+            // Extract URL from .gitmodules
+            let source = null;
+            const urlMatch = /url\s*=\s*(.+)/.exec(content);
+            if (urlMatch)
+                source = urlMatch[1].trim();
+            return { method: 'submodule', version, source };
+        }
+        catch {
+            return null;
+        }
+    }
+    async install(projectPath, source, targetDir) {
+        if (!(await isGitAvailable())) {
+            throw new Error('git is not available. Install git or use the "manual" strategy instead.');
+        }
+        if (!(await isGitRepo(projectPath))) {
+            throw new Error(`"${projectPath}" is not a git repository. ` +
+                'The submodule strategy requires a git repo. Use --strategy clone or --strategy manual instead.');
+        }
+        await gitExec(['submodule', 'add', source, GUIDE_RELATIVE_PATH], projectPath);
+        let version = null;
+        try {
+            const { stdout } = await gitExec(['describe', '--tags', '--abbrev=0'], targetDir);
+            version = stdout || null;
+        }
+        catch {
+            // No tags available
+        }
+        return { success: true, version, method: 'submodule', path: targetDir };
+    }
+    async update(projectPath, targetDir) {
+        let previousVersion = null;
+        try {
+            const { stdout } = await gitExec(['describe', '--tags', '--abbrev=0'], targetDir);
+            previousVersion = stdout || null;
+        }
+        catch {
+            // No previous version
+        }
+        await gitExec(['submodule', 'update', '--remote', GUIDE_RELATIVE_PATH], projectPath);
+        let newVersion = null;
+        try {
+            const { stdout } = await gitExec(['describe', '--tags', '--abbrev=0'], targetDir);
+            newVersion = stdout || null;
+        }
+        catch {
+            // No new version
+        }
+        return { success: true, previousVersion, newVersion, method: 'submodule' };
+    }
+}
+//# sourceMappingURL=SubmoduleStrategy.js.map

package/dist/guides/strategies/SubmoduleStrategy.js.map

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

package/dist/guides/strategies/TarballStrategy.d.ts

@@ -0,0 +1,19 @@
+import type { InstallStrategy, InstallResult, UpdateResult, DetectionResult } from '../types.js';
+/**
+ * Parse owner/repo from a GitHub source URL.
+ * Supports: https://github.com/{owner}/{repo}.git and https://github.com/{owner}/{repo}
+ */
+export declare function parseGitHubOwnerRepo(source: string): {
+    owner: string;
+    repo: string;
+};
+export declare class TarballStrategy implements InstallStrategy {
+    detect(_projectPath: string, targetDir: string): Promise<DetectionResult | null>;
+    install(_projectPath: string, source: string, targetDir: string): Promise<InstallResult>;
+    update(_projectPath: string, targetDir: string): Promise<UpdateResult>;
+    /** Fetch latest tag from remote using git ls-remote */
+    private fetchLatestTag;
+    /** Download tarball from GitHub API and extract to targetDir */
+    private downloadAndExtract;
+}
+//# sourceMappingURL=TarballStrategy.d.ts.map

package/dist/guides/strategies/TarballStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TarballStrategy.d.ts","sourceRoot":"","sources":["../../../src/guides/strategies/TarballStrategy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAIjG;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMpF;AAED,qBAAa,eAAgB,YAAW,eAAe;IAC/C,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAYhF,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAaxF,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA4B5E,uDAAuD;YACzC,cAAc;IAgC5B,gEAAgE;YAClD,kBAAkB;CAgCjC"}

package/dist/guides/strategies/TarballStrategy.js

@@ -0,0 +1,118 @@
+// Tarball-based (manual) guide installation strategy
+import { existsSync, readFileSync, writeFileSync, mkdirSync, rmSync } from 'fs';
+import { join } from 'path';
+import { createGunzip } from 'zlib';
+import { Readable } from 'stream';
+import { pipeline } from 'stream/promises';
+import { extract } from 'tar';
+import { VERSION_MARKER_FILE, DEFAULT_SOURCE_GIT } from '../types.js';
+import { gitExec } from '../gitExec.js';
+/**
+ * Parse owner/repo from a GitHub source URL.
+ * Supports: https://github.com/{owner}/{repo}.git and https://github.com/{owner}/{repo}
+ */
+export function parseGitHubOwnerRepo(source) {
+    const match = /github\.com\/([^/]+)\/([^/.]+)/.exec(source);
+    if (!match) {
+        throw new Error(`Cannot parse GitHub owner/repo from source URL: ${source}`);
+    }
+    return { owner: match[1], repo: match[2] };
+}
+export class TarballStrategy {
+    async detect(_projectPath, targetDir) {
+        const markerPath = join(targetDir, VERSION_MARKER_FILE);
+        if (!existsSync(markerPath))
+            return null;
+        try {
+            const version = readFileSync(markerPath, 'utf-8').trim() || null;
+            return { method: 'manual', version, source: null };
+        }
+        catch {
+            return null;
+        }
+    }
+    async install(_projectPath, source, targetDir) {
+        const resolvedSource = source || DEFAULT_SOURCE_GIT;
+        const latestTag = await this.fetchLatestTag(resolvedSource);
+        if (!latestTag) {
+            throw new Error('Could not determine latest version from remote.');
+        }
+        await this.downloadAndExtract(resolvedSource, latestTag, targetDir);
+        writeFileSync(join(targetDir, VERSION_MARKER_FILE), latestTag, 'utf-8');
+        return { success: true, version: latestTag, method: 'manual', path: targetDir };
+    }
+    async update(_projectPath, targetDir) {
+        const markerPath = join(targetDir, VERSION_MARKER_FILE);
+        let previousVersion = null;
+        try {
+            previousVersion = readFileSync(markerPath, 'utf-8').trim() || null;
+        }
+        catch {
+            // No previous version
+        }
+        // Determine source from the default (marker doesn't store it)
+        const source = DEFAULT_SOURCE_GIT;
+        const latestTag = await this.fetchLatestTag(source);
+        if (!latestTag) {
+            throw new Error('Could not determine latest version from remote.');
+        }
+        if (previousVersion === latestTag) {
+            return { success: true, previousVersion, newVersion: latestTag, method: 'manual' };
+        }
+        // Remove existing contents and re-download
+        rmSync(targetDir, { recursive: true, force: true });
+        await this.downloadAndExtract(source, latestTag, targetDir);
+        writeFileSync(join(targetDir, VERSION_MARKER_FILE), latestTag, 'utf-8');
+        return { success: true, previousVersion, newVersion: latestTag, method: 'manual' };
+    }
+    /** Fetch latest tag from remote using git ls-remote */
+    async fetchLatestTag(source) {
+        try {
+            const { stdout } = await gitExec(['ls-remote', '--tags', '--sort=-v:refname', source], process.cwd());
+            const tagPattern = /refs\/tags\/(v?\d+\.\d+\.\d+)$/;
+            const tags = [];
+            for (const line of stdout.split('\n')) {
+                const match = tagPattern.exec(line.trim());
+                if (match)
+                    tags.push(match[1]);
+            }
+            if (tags.length === 0)
+                return null;
+            // Sort 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];
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Download tarball from GitHub API and extract to targetDir */
+    async downloadAndExtract(source, tag, targetDir) {
+        const { owner, repo } = parseGitHubOwnerRepo(source);
+        const url = `https://api.github.com/repos/${owner}/${repo}/tarball/${tag}`;
+        const response = await fetch(url, {
+            headers: { Accept: 'application/vnd.github+json' },
+            redirect: 'follow',
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to download tarball: ${response.status} ${response.statusText}`);
+        }
+        if (!response.body) {
+            throw new Error('Empty response body when downloading tarball');
+        }
+        mkdirSync(targetDir, { recursive: true });
+        // GitHub tarballs have a top-level directory like {owner}-{repo}-{hash}/
+        // We strip 1 level and extract directly into targetDir
+        const nodeStream = Readable.fromWeb(response.body);
+        await pipeline(nodeStream, createGunzip(), extract({ cwd: targetDir, strip: 1 }));
+    }
+}
+//# sourceMappingURL=TarballStrategy.js.map

package/dist/guides/strategies/TarballStrategy.js.map

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

package/dist/guides/types.d.ts

@@ -0,0 +1,44 @@
+/** Installation method used for the ai-project-guide */
+export type GuideMethod = 'submodule' | 'clone' | 'manual';
+/** Full status of a guide installation */
+export interface GuideInfo {
+    installed: boolean;
+    method: GuideMethod | null;
+    version: string | null;
+    path: string;
+    source: string;
+    latestVersion: string | null;
+    updateAvailable: boolean;
+    usingBundledPrompt: boolean;
+}
+/** Result of a guide installation */
+export interface InstallResult {
+    success: boolean;
+    version: string | null;
+    method: GuideMethod;
+    path: string;
+}
+/** Result of a guide update */
+export interface UpdateResult {
+    success: boolean;
+    previousVersion: string | null;
+    newVersion: string | null;
+    method: GuideMethod;
+}
+/** Detection result returned by a strategy's detect() method */
+export interface DetectionResult {
+    method: GuideMethod;
+    version: string | null;
+    source: string | null;
+}
+/** Strategy interface for guide installation methods */
+export interface InstallStrategy {
+    install(projectPath: string, source: string, targetDir: string): Promise<InstallResult>;
+    update(projectPath: string, targetDir: string): Promise<UpdateResult>;
+    detect(projectPath: string, targetDir: string): Promise<DetectionResult | null>;
+}
+export declare const DEFAULT_SOURCE_GIT = "https://github.com/ecorkran/ai-project-guide.git";
+export declare const DEFAULT_SOURCE_API = "https://api.github.com/repos/ecorkran/ai-project-guide";
+export declare const GUIDE_RELATIVE_PATH = "project-documents/ai-project-guide";
+export declare const VERSION_MARKER_FILE = ".context-forge-guide-version";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guides/types.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3D,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+BAA+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACxF,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;CACjF;AAGD,eAAO,MAAM,kBAAkB,qDAAqD,CAAC;AACrF,eAAO,MAAM,kBAAkB,2DAA2D,CAAC;AAC3F,eAAO,MAAM,mBAAmB,uCAAuC,CAAC;AACxE,eAAO,MAAM,mBAAmB,iCAAiC,CAAC"}

package/dist/guides/types.js

@@ -0,0 +1,7 @@
+// Guide management types and strategy interface
+// Constants
+export const DEFAULT_SOURCE_GIT = 'https://github.com/ecorkran/ai-project-guide.git';
+export const DEFAULT_SOURCE_API = 'https://api.github.com/repos/ecorkran/ai-project-guide';
+export const GUIDE_RELATIVE_PATH = 'project-documents/ai-project-guide';
+export const VERSION_MARKER_FILE = '.context-forge-guide-version';
+//# sourceMappingURL=types.js.map

package/dist/guides/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/guides/types.ts"],"names":[],"mappings":"AAAA,gDAAgD;AA+ChD,YAAY;AACZ,MAAM,CAAC,MAAM,kBAAkB,GAAG,kDAAkD,CAAC;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAG,wDAAwD,CAAC;AAC3F,MAAM,CAAC,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 export * from './types/index.js';
 export * from './services/index.js';
 export type { IProjectStore, IStorageService, StorageReadResult } from './storage/interfaces.js';
+export * from './introspection/index.js';
+export type { GuideInfo, GuideMethod, InstallResult, UpdateResult } from './guides/types.js';
+export * from './schema/projectSchema.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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;AAGjG,cAAc,0BAA0B,CAAC;AAGzC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG7F,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -1,4 +1,8 @@
 // @context-forge/core — context assembly engine
 export * from './types/index.js';
 export * from './services/index.js';
+// Introspection types and interfaces (browser-safe — no fs dependencies)
+export * from './introspection/index.js';
+// Project schema (field metadata, aliases, phase maps)
+export * from './schema/projectSchema.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAKpC,yEAAyE;AACzE,cAAc,0BAA0B,CAAC;AAKzC,uDAAuD;AACvD,cAAc,2BAA2B,CAAC"}

package/dist/introspection/ArtifactIntrospector.d.ts

@@ -0,0 +1,20 @@
+import type { ProjectData } from '../types/project.js';
+import type { IArtifactIntrospector } from './interfaces.js';
+import type { SlicePlanResult, TaskFileResult, FrontmatterResult, FutureWorkResult, DocumentDetectionResult, IntrospectionSummary } from './types.js';
+/**
+ * Orchestrator that delegates to individual parser functions.
+ * Each method resolves file paths from projectPath as needed.
+ */
+export declare class ArtifactIntrospector implements IArtifactIntrospector {
+    parseSlicePlan(slicePlanPath: string): Promise<SlicePlanResult>;
+    parseTaskFile(taskFilePaths: string | string[]): Promise<TaskFileResult>;
+    parseFrontmatter(filePath: string): Promise<FrontmatterResult>;
+    parseFutureWork(slicePlanPath: string, nextIndex?: number): Promise<FutureWorkResult>;
+    detectDocuments(projectPath: string, sliceIndex: number): Promise<DocumentDetectionResult>;
+    /**
+     * Generate an introspection summary for a project.
+     * Each operation is individually try/caught — failure in one doesn't prevent others.
+     */
+    summarize(project: ProjectData): Promise<IntrospectionSummary>;
+}
+//# sourceMappingURL=ArtifactIntrospector.d.ts.map

package/dist/introspection/ArtifactIntrospector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactIntrospector.d.ts","sourceRoot":"","sources":["../../src/introspection/ArtifactIntrospector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAOpB;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAC1D,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/D,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI9D,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrF,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIhG;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAsGrE"}

package/dist/introspection/ArtifactIntrospector.js

@@ -0,0 +1,140 @@
+import { join } from 'node:path';
+import { parseSlicePlan } from './parsers/slicePlanParser.js';
+import { parseTaskFile } from './parsers/taskFileParser.js';
+import { parseFrontmatter } from './parsers/frontmatterParser.js';
+import { parseFutureWork } from './parsers/futureWorkParser.js';
+import { detectDocuments, checkFileExists } from './parsers/documentDetector.js';
+/**
+ * Orchestrator that delegates to individual parser functions.
+ * Each method resolves file paths from projectPath as needed.
+ */
+export class ArtifactIntrospector {
+    async parseSlicePlan(slicePlanPath) {
+        return parseSlicePlan(slicePlanPath);
+    }
+    async parseTaskFile(taskFilePaths) {
+        return parseTaskFile(taskFilePaths);
+    }
+    async parseFrontmatter(filePath) {
+        return parseFrontmatter(filePath);
+    }
+    async parseFutureWork(slicePlanPath, nextIndex) {
+        return parseFutureWork(slicePlanPath, nextIndex);
+    }
+    async detectDocuments(projectPath, sliceIndex) {
+        return detectDocuments(projectPath, sliceIndex);
+    }
+    /**
+     * Generate an introspection summary for a project.
+     * Each operation is individually try/caught — failure in one doesn't prevent others.
+     */
+    async summarize(project) {
+        const summary = {
+            artifacts: {
+                hasSlicePlan: false,
+                hasHLD: false,
+                hasArch: false,
+                hasSpec: false,
+                hasCurrentSliceDesign: false,
+                hasCurrentTaskFile: false,
+            },
+        };
+        const projectPath = project.projectPath;
+        if (!projectPath)
+            return summary;
+        // Parse slice plan if available
+        try {
+            if (project.fileSlicePlan) {
+                const planPath = join(projectPath, project.fileSlicePlan);
+                const planResult = await parseSlicePlan(planPath);
+                if (planResult.totalSlices > 0) {
+                    summary.slicePlan = {
+                        totalSlices: planResult.totalSlices,
+                        completedSlices: planResult.completedSlices,
+                        summary: `${planResult.completedSlices} of ${planResult.totalSlices} slices complete`,
+                    };
+                }
+            }
+        }
+        catch {
+            // Slice plan parsing failed — continue with other operations
+        }
+        // Parse task file if available
+        try {
+            if (project.fileTasks) {
+                // Detect actual task file(s) using the slice index
+                const sliceIndex = extractSliceIndex(project.fileSlice);
+                let taskPaths = [];
+                if (sliceIndex !== null) {
+                    const docs = await detectDocuments(projectPath, sliceIndex);
+                    if (docs.taskFile) {
+                        taskPaths = docs.taskFile.map((p) => join(projectPath, p));
+                    }
+                }
+                // Fall back to direct path if detection found nothing
+                if (taskPaths.length === 0) {
+                    taskPaths = [join(projectPath, 'project-documents/user/tasks', project.fileTasks)];
+                }
+                const taskResult = await parseTaskFile(taskPaths);
+                if (taskResult.totalTasks > 0) {
+                    summary.currentTasks = {
+                        totalTasks: taskResult.totalTasks,
+                        completedTasks: taskResult.completedTasks,
+                        inferredStatus: taskResult.inferredStatus,
+                        summary: `${taskResult.completedTasks} of ${taskResult.totalTasks} tasks done`,
+                    };
+                }
+            }
+        }
+        catch {
+            // Task parsing failed — continue with other operations
+        }
+        // Check artifact existence
+        try {
+            if (project.fileSlicePlan) {
+                summary.artifacts.hasSlicePlan = await checkFileExists(projectPath, project.fileSlicePlan);
+            }
+        }
+        catch { /* continue */ }
+        try {
+            if (project.fileHLD) {
+                summary.artifacts.hasHLD = await checkFileExists(projectPath, project.fileHLD);
+            }
+        }
+        catch { /* continue */ }
+        try {
+            if (project.fileArch) {
+                summary.artifacts.hasArch = await checkFileExists(projectPath, project.fileArch);
+            }
+        }
+        catch { /* continue */ }
+        try {
+            if (project.fileSpec) {
+                summary.artifacts.hasSpec = await checkFileExists(projectPath, project.fileSpec);
+            }
+        }
+        catch { /* continue */ }
+        // Check current slice design and task file existence
+        try {
+            const sliceIndex = extractSliceIndex(project.fileSlice);
+            if (sliceIndex !== null) {
+                const docs = await detectDocuments(projectPath, sliceIndex);
+                summary.artifacts.hasCurrentSliceDesign = docs.sliceDesign !== null;
+                summary.artifacts.hasCurrentTaskFile = docs.taskFile !== null;
+            }
+        }
+        catch { /* continue */ }
+        return summary;
+    }
+}
+/**
+ * Extract the numeric slice index from a fileSlice value like "163-slice.artifact-introspection.md".
+ * Returns null if no leading number found.
+ */
+function extractSliceIndex(fileSlice) {
+    if (!fileSlice)
+        return null;
+    const match = /^(\d+)-/.exec(fileSlice);
+    return match ? parseInt(match[1], 10) : null;
+}
+//# sourceMappingURL=ArtifactIntrospector.js.map