faf-mcp 1.3.1 → 2.0.0

package/dist/src/faf-core/commands/gemini.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Gemini Command - v4.5.0 Interop Edition
+ *
+ * Import/Export/Sync between GEMINI.md and project.faf
+ * Bundled command — no CLI dependency required.
+ */
+export interface GeminiCommandResult {
+    success: boolean;
+    action: 'import' | 'export' | 'sync';
+    message: string;
+    data?: any;
+    warnings?: string[];
+}
+/**
+ * Import GEMINI.md into project.faf
+ */
+export declare function geminiImportCommand(projectPath: string, options?: {
+    merge?: boolean;
+}): Promise<GeminiCommandResult>;
+/**
+ * Export project.faf to GEMINI.md
+ */
+export declare function geminiExportCommand(projectPath: string, options?: {
+    force?: boolean;
+}): Promise<GeminiCommandResult>;
+/**
+ * Sync GEMINI.md <-> project.faf
+ */
+export declare function geminiSyncCommand(projectPath: string): Promise<GeminiCommandResult>;

package/dist/src/faf-core/commands/gemini.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Gemini Command - v4.5.0 Interop Edition
+ *
+ * Import/Export/Sync between GEMINI.md and project.faf
+ * Bundled command — no CLI dependency required.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.geminiImportCommand = geminiImportCommand;
+exports.geminiExportCommand = geminiExportCommand;
+exports.geminiSyncCommand = geminiSyncCommand;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+const file_utils_js_1 = require("../utils/file-utils.js");
+const yaml_js_1 = require("../fix-once/yaml.js");
+const gemini_parser_js_1 = require("../parsers/gemini-parser.js");
+/**
+ * Import GEMINI.md into project.faf
+ */
+async function geminiImportCommand(projectPath, options = {}) {
+    const geminiPath = await (0, gemini_parser_js_1.detectGeminiMd)(projectPath);
+    if (!geminiPath) {
+        return {
+            success: false,
+            action: 'import',
+            message: 'No GEMINI.md found in project directory',
+        };
+    }
+    const result = await (0, gemini_parser_js_1.geminiImport)(geminiPath);
+    if (!result.success) {
+        return {
+            success: false,
+            action: 'import',
+            message: result.warnings.join(', '),
+            warnings: result.warnings,
+        };
+    }
+    if (options.merge) {
+        const fafPath = await (0, file_utils_js_1.findFafFile)(projectPath);
+        if (fafPath) {
+            try {
+                const existingContent = await fs_1.promises.readFile(fafPath, 'utf-8');
+                const existingFaf = (0, yaml_js_1.parse)(existingContent);
+                const merged = {
+                    ...existingFaf,
+                    project: {
+                        ...(existingFaf.project || {}),
+                        rules: [
+                            ...(existingFaf.project?.rules || []),
+                            ...result.faf.project.rules,
+                        ],
+                        guidelines: [
+                            ...(existingFaf.project?.guidelines || []),
+                            ...result.faf.project.guidelines,
+                        ],
+                        codingStyle: [
+                            ...(existingFaf.project?.codingStyle || []),
+                            ...result.faf.project.codingStyle,
+                        ],
+                    },
+                };
+                const yamlContent = (0, yaml_js_1.stringify)(merged);
+                await fs_1.promises.writeFile(fafPath, yamlContent);
+                return {
+                    success: true,
+                    action: 'import',
+                    message: `Merged GEMINI.md into existing .faf (${result.sectionsFound.length} sections)`,
+                    data: { sectionsFound: result.sectionsFound, merged: true },
+                    warnings: result.warnings,
+                };
+            }
+            catch {
+                // Fall through
+            }
+        }
+    }
+    return {
+        success: true,
+        action: 'import',
+        message: `Imported GEMINI.md (${result.sectionsFound.length} sections found)`,
+        data: { faf: result.faf, sectionsFound: result.sectionsFound },
+        warnings: result.warnings,
+    };
+}
+/**
+ * Export project.faf to GEMINI.md
+ */
+async function geminiExportCommand(projectPath, options = {}) {
+    const fafPath = await (0, file_utils_js_1.findFafFile)(projectPath);
+    if (!fafPath) {
+        return {
+            success: false,
+            action: 'export',
+            message: 'No .faf file found. Run faf init first.',
+        };
+    }
+    const outputPath = path_1.default.join(projectPath, 'GEMINI.md');
+    if (!options.force) {
+        try {
+            await fs_1.promises.access(outputPath);
+            return {
+                success: false,
+                action: 'export',
+                message: 'GEMINI.md already exists. Use force: true to overwrite.',
+            };
+        }
+        catch {
+            // File doesn't exist, proceed
+        }
+    }
+    const fafContent = await fs_1.promises.readFile(fafPath, 'utf-8');
+    const fafData = (0, yaml_js_1.parse)(fafContent);
+    const result = await (0, gemini_parser_js_1.geminiExport)(fafData, outputPath);
+    return {
+        success: result.success,
+        action: 'export',
+        message: result.success
+            ? `Exported project.faf to GEMINI.md`
+            : 'Export failed',
+        data: { filePath: result.filePath },
+        warnings: result.warnings,
+    };
+}
+/**
+ * Sync GEMINI.md <-> project.faf
+ */
+async function geminiSyncCommand(projectPath) {
+    return await geminiExportCommand(projectPath, { force: true });
+}
+//# sourceMappingURL=gemini.js.map

package/dist/src/faf-core/commands/gemini.js.map

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

package/dist/src/faf-core/commands/git-context.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Git Context Command - v4.5.0 Interop Edition
+ *
+ * Generate project.faf from a GitHub repository URL.
+ * Fetches metadata, README, package.json — no cloning needed.
+ * Bundled command — no CLI dependency required.
+ */
+export interface GitContextResult {
+    success: boolean;
+    message: string;
+    data?: {
+        owner: string;
+        repo: string;
+        score: number;
+        tier: string;
+        fafContent: string;
+        filePath?: string;
+    };
+}
+/**
+ * Generate project.faf from a GitHub URL
+ */
+export declare function gitContextCommand(url: string, outputPath?: string): Promise<GitContextResult>;

package/dist/src/faf-core/commands/git-context.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Git Context Command - v4.5.0 Interop Edition
+ *
+ * Generate project.faf from a GitHub repository URL.
+ * Fetches metadata, README, package.json — no cloning needed.
+ * Bundled command — no CLI dependency required.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gitContextCommand = gitContextCommand;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+const github_extractor_js_1 = require("../parsers/github-extractor.js");
+const faf_git_generator_js_1 = require("../parsers/faf-git-generator.js");
+/**
+ * Generate project.faf from a GitHub URL
+ */
+async function gitContextCommand(url, outputPath) {
+    // Parse the URL
+    const parsed = (0, github_extractor_js_1.parseGitHubUrl)(url);
+    if (!parsed) {
+        return {
+            success: false,
+            message: `Invalid GitHub URL: ${url}. Expected format: https://github.com/owner/repo or owner/repo`,
+        };
+    }
+    const { owner, repo } = parsed;
+    try {
+        // Fetch metadata with file checks
+        const metadata = await (0, github_extractor_js_1.fetchGitHubMetadata)(owner, repo, true);
+        // Fetch file tree
+        const files = await (0, github_extractor_js_1.fetchGitHubFileTree)(owner, repo, metadata.defaultBranch);
+        // Generate .faf content
+        const { content, score } = await (0, faf_git_generator_js_1.generateEnhancedFaf)(metadata, files);
+        const tier = (0, faf_git_generator_js_1.getScoreTier)(score);
+        // Write to file if output path provided
+        let filePath;
+        if (outputPath) {
+            filePath = path_1.default.join(outputPath, 'project.faf');
+            await fs_1.promises.writeFile(filePath, content, 'utf-8');
+        }
+        return {
+            success: true,
+            message: `Generated project.faf for ${owner}/${repo} — Score: ${score}% (${tier})`,
+            data: {
+                owner,
+                repo,
+                score,
+                tier,
+                fafContent: content,
+                filePath,
+            },
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            message: `Failed to fetch GitHub metadata: ${errorMessage}`,
+        };
+    }
+}
+//# sourceMappingURL=git-context.js.map

package/dist/src/faf-core/commands/git-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-context.js","sourceRoot":"","sources":["../../../../src/faf-core/commands/git-context.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;AA8BH,8CAoDC;AAhFD,gDAAwB;AACxB,2BAAoC;AACpC,wEAIwC;AACxC,0EAGyC;AAezC;;GAEG;AACI,KAAK,UAAU,iBAAiB,CACrC,GAAW,EACX,UAAmB;IAEnB,gBAAgB;IAChB,MAAM,MAAM,GAAG,IAAA,oCAAc,EAAC,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,uBAAuB,GAAG,gEAAgE;SACpG,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAE/B,IAAI,CAAC;QACH,kCAAkC;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAA,yCAAmB,EAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAE9D,kBAAkB;QAClB,MAAM,KAAK,GAAG,MAAM,IAAA,yCAAmB,EAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;QAE7E,wBAAwB;QACxB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,IAAA,0CAAmB,EAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,IAAA,mCAAY,EAAC,KAAK,CAAC,CAAC;QAEjC,wCAAwC;QACxC,IAAI,QAA4B,CAAC;QACjC,IAAI,UAAU,EAAE,CAAC;YACf,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YAChD,MAAM,aAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,6BAA6B,KAAK,IAAI,IAAI,aAAa,KAAK,MAAM,IAAI,GAAG;YAClF,IAAI,EAAE;gBACJ,KAAK;gBACL,IAAI;gBACJ,KAAK;gBACL,IAAI;gBACJ,UAAU,EAAE,OAAO;gBACnB,QAAQ;aACT;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,oCAAoC,YAAY,EAAE;SAC5D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/faf-core/commands/human.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Human Context Management - MCP Bundled Version
+ * Non-interactive YAML merge for MCP context
+ */
+export interface HumanAddOptions {
+    yaml?: string;
+    field?: string;
+    value?: string;
+    merge?: boolean;
+}
+export interface HumanAddResult {
+    success: boolean;
+    message: string;
+    fieldsUpdated?: string[];
+    score?: number;
+    error?: string;
+}
+/**
+ * Add or update human_context in project.faf
+ * MCP-compatible non-interactive version
+ */
+export declare function humanAddCommand(projectPath: string, options?: HumanAddOptions): Promise<HumanAddResult>;
+/**
+ * Set a single human_context field
+ * Convenience wrapper for single field updates
+ */
+export declare function humanSetCommand(projectPath: string, field: string, value: string): Promise<HumanAddResult>;

package/dist/src/faf-core/commands/human.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Human Context Management - MCP Bundled Version
+ * Non-interactive YAML merge for MCP context
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.humanAddCommand = humanAddCommand;
+exports.humanSetCommand = humanSetCommand;
+const fs_1 = require("fs");
+const yaml_1 = require("yaml");
+const path = __importStar(require("path"));
+/**
+ * Find project.faf file
+ */
+async function findFafFile(startPath) {
+    const possiblePaths = [
+        path.join(startPath, 'project.faf'),
+        path.join(startPath, '.faf'),
+        path.join(startPath, 'faf.yml'),
+        path.join(startPath, 'faf.yaml'),
+    ];
+    for (const fafPath of possiblePaths) {
+        try {
+            await fs_1.promises.access(fafPath);
+            return fafPath;
+        }
+        catch {
+            // File doesn't exist, continue
+        }
+    }
+    return null;
+}
+/**
+ * Add or update human_context in project.faf
+ * MCP-compatible non-interactive version
+ */
+async function humanAddCommand(projectPath, options = {}) {
+    try {
+        // Find existing .faf file
+        const fafPath = await findFafFile(projectPath);
+        if (!fafPath) {
+            // Create new project.faf if it doesn't exist
+            const newFafPath = path.join(projectPath, 'project.faf');
+            if (options.yaml) {
+                // Parse the input YAML
+                const inputData = (0, yaml_1.parse)(options.yaml);
+                // If input has human_context key, use it directly
+                // Otherwise wrap the input as human_context
+                const fafData = inputData.human_context
+                    ? inputData
+                    : { human_context: inputData };
+                await fs_1.promises.writeFile(newFafPath, (0, yaml_1.stringify)(fafData), 'utf-8');
+                const fields = Object.keys(fafData.human_context || {});
+                return {
+                    success: true,
+                    message: `Created ${newFafPath} with human_context`,
+                    fieldsUpdated: fields
+                };
+            }
+            else if (options.field && options.value) {
+                // Single field mode
+                const fafData = {
+                    human_context: {
+                        [options.field]: options.value
+                    }
+                };
+                await fs_1.promises.writeFile(newFafPath, (0, yaml_1.stringify)(fafData), 'utf-8');
+                return {
+                    success: true,
+                    message: `Created ${newFafPath} with ${options.field}`,
+                    fieldsUpdated: [options.field]
+                };
+            }
+            else {
+                return {
+                    success: false,
+                    message: 'No .faf file found and no input provided',
+                    error: 'Run faf_init first or provide YAML/field input'
+                };
+            }
+        }
+        // Read existing .faf file
+        const fafContent = await fs_1.promises.readFile(fafPath, 'utf-8');
+        const fafData = (0, yaml_1.parse)(fafContent) || {};
+        if (!fafData.human_context) {
+            fafData.human_context = {};
+        }
+        const fieldsUpdated = [];
+        // YAML merge mode
+        if (options.yaml) {
+            const inputData = (0, yaml_1.parse)(options.yaml);
+            // Extract human_context from input
+            const humanContext = inputData.human_context || inputData;
+            // Merge fields
+            for (const [key, value] of Object.entries(humanContext)) {
+                if (value !== null && value !== undefined && value !== '') {
+                    fafData.human_context[key] = value;
+                    fieldsUpdated.push(key);
+                }
+            }
+        }
+        // Single field mode
+        if (options.field && options.value) {
+            fafData.human_context[options.field] = options.value;
+            fieldsUpdated.push(options.field);
+        }
+        // Save updated .faf
+        if (fieldsUpdated.length > 0) {
+            await fs_1.promises.writeFile(fafPath, (0, yaml_1.stringify)(fafData), 'utf-8');
+            return {
+                success: true,
+                message: `Updated ${fieldsUpdated.length} field(s) in ${fafPath}`,
+                fieldsUpdated
+            };
+        }
+        else {
+            return {
+                success: false,
+                message: 'No fields to update',
+                error: 'Provide yaml or field/value parameters'
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: 'Failed to add human context',
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+/**
+ * Set a single human_context field
+ * Convenience wrapper for single field updates
+ */
+async function humanSetCommand(projectPath, field, value) {
+    const validFields = ['who', 'what', 'where', 'why', 'when', 'how'];
+    if (!validFields.includes(field.toLowerCase())) {
+        return {
+            success: false,
+            message: `Invalid field: ${field}`,
+            error: `Valid fields: ${validFields.join(', ')}`
+        };
+    }
+    return humanAddCommand(projectPath, {
+        field: field.toLowerCase(),
+        value
+    });
+}
+//# sourceMappingURL=human.js.map

package/dist/src/faf-core/commands/human.js.map

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

package/dist/src/faf-core/commands/readme.d.ts

@@ -0,0 +1,47 @@
+/**
+ * README Context Extraction - MCP Bundled Version
+ * Non-interactive extraction of 6 Ws from README files
+ */
+export interface ExtractedContext {
+    who?: string;
+    what?: string;
+    where?: string;
+    why?: string;
+    when?: string;
+    how?: string;
+    confidence: {
+        who: number;
+        what: number;
+        where: number;
+        why: number;
+        when: number;
+        how: number;
+        overall: number;
+    };
+}
+export interface ReadmeExtractResult {
+    success: boolean;
+    message: string;
+    extracted?: ExtractedContext;
+    readmePath?: string;
+    error?: string;
+}
+/**
+ * Extract 6 Ws from README content
+ * Ported from faf-cli v4.3.0
+ */
+export declare function extractSixWs(content: string): ExtractedContext;
+/**
+ * Extract context from README file
+ * Non-interactive MCP version
+ */
+export declare function readmeExtractCommand(projectPath: string): Promise<ReadmeExtractResult>;
+/**
+ * Extract and merge README context into project.faf
+ * Combines extraction + merging in one step
+ */
+export declare function readmeMergeCommand(projectPath: string, options?: {
+    overwrite?: boolean;
+}): Promise<ReadmeExtractResult & {
+    fieldsUpdated?: string[];
+}>;