fraim-framework 2.0.88 → 2.0.89

package/bin/fraim.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM Framework CLI Entry Point

package/dist/src/core/utils/stub-generator.js

@@ -50,11 +50,11 @@ function extractLeadParagraph(content) {
  * These stubs are committed to the user's repo for discoverability.
  */
 function generateWorkflowStub(workflowName, workflowPath, intent, principles) {
-    return `${STUB_MARKER}
-# FRAIM Workflow: ${workflowName}
-
-> [!IMPORTANT]
-> This is a **FRAIM-managed workflow stub**. 
+    return `${STUB_MARKER}
+# FRAIM Workflow: ${workflowName}
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
 > To load the full context (rules, templates, and execution steps), ask your AI agent to:
 > \`@fraim get_fraim_workflow("${workflowName}")\`
 >
@@ -81,19 +81,19 @@ function parseRegistryWorkflow(content) {
  * Coaching stubs are discoverability artifacts and should be resolved with get_fraim_file.
  */
 function generateJobStub(jobName, _jobPath, intent, outcome, steps) {
-    return `${STUB_MARKER}
-# FRAIM Job: ${jobName}
-
-## Intent
-${intent}
-
-## Outcome
-${outcome}
-
-## Steps
-${steps}
-
----
+    return `${STUB_MARKER}
+# FRAIM Job: ${jobName}
+
+## Intent
+${intent}
+
+## Outcome
+${outcome}
+
+## Steps
+${steps}
+
+---
 
 > [!IMPORTANT]
 > **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
@@ -110,41 +110,41 @@ ${steps}
  * Generates a lightweight markdown stub for a skill.
  */
 function generateSkillStub(skillName, skillPath, skillInput, skillOutput) {
-    return `${STUB_MARKER}
-# FRAIM Skill: ${skillName}
-
-## Skill Input
-${skillInput}
-
-## Skill Output
-${skillOutput}
-
----
-
-> [!IMPORTANT]
-> **For AI Agents:** This is a discoverability stub for the skill.
-> All execution details must be fetched from MCP before use.
-> To retrieve the complete skill instructions, call:
-> \`get_fraim_file({ path: "skills/${skillPath}" })\`
+    return `${STUB_MARKER}
+# FRAIM Skill: ${skillName}
+
+## Skill Input
+${skillInput}
+
+## Skill Output
+${skillOutput}
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** This is a discoverability stub for the skill.
+> All execution details must be fetched from MCP before use.
+> To retrieve the complete skill instructions, call:
+> \`get_fraim_file({ path: "skills/${skillPath}" })\`
 `;
 }
 /**
  * Generates a lightweight markdown stub for a rule.
  */
 function generateRuleStub(ruleName, rulePath, intent) {
-    return `${STUB_MARKER}
-# FRAIM Rule: ${ruleName}
-
-## Intent
-${intent}
-
----
-
-> [!IMPORTANT]
-> **For AI Agents:** This is a discoverability stub for the rule.
-> All rule details must be fetched from MCP before use.
-> To retrieve the complete rule instructions, call:
-> \`get_fraim_file({ path: "rules/${rulePath}" })\`
+    return `${STUB_MARKER}
+# FRAIM Rule: ${ruleName}
+
+## Intent
+${intent}
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** This is a discoverability stub for the rule.
+> All rule details must be fetched from MCP before use.
+> To retrieve the complete rule instructions, call:
+> \`get_fraim_file({ path: "rules/${rulePath}" })\`
 `;
 }
 /**

package/dist/src/core/utils/workflow-parser.js

@@ -4,45 +4,98 @@ exports.WorkflowParser = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
 class WorkflowParser {
+    static extractMetadataBlock(content) {
+        const frontmatterMatch = content.match(/^---\r?\n([\s\S]+?)\r?\n---/);
+        if (frontmatterMatch) {
+            try {
+                return {
+                    state: 'valid',
+                    metadata: JSON.parse(frontmatterMatch[1]),
+                    bodyStartIndex: frontmatterMatch[0].length
+                };
+            }
+            catch {
+                return { state: 'invalid' };
+            }
+        }
+        const trimmedStart = content.search(/\S/);
+        if (trimmedStart === -1 || content[trimmedStart] !== '{') {
+            return { state: 'none' };
+        }
+        let depth = 0;
+        let inString = false;
+        let escaping = false;
+        for (let i = trimmedStart; i < content.length; i++) {
+            const ch = content[i];
+            if (inString) {
+                if (escaping) {
+                    escaping = false;
+                }
+                else if (ch === '\\') {
+                    escaping = true;
+                }
+                else if (ch === '"') {
+                    inString = false;
+                }
+                continue;
+            }
+            if (ch === '"') {
+                inString = true;
+                continue;
+            }
+            if (ch === '{') {
+                depth++;
+                continue;
+            }
+            if (ch === '}') {
+                depth--;
+                if (depth === 0) {
+                    const bodyStartIndex = i + 1;
+                    const remainder = content.slice(bodyStartIndex).trimStart();
+                    // `{...}\n---` is usually malformed frontmatter, not bare JSON metadata.
+                    if (remainder.startsWith('---')) {
+                        return { state: 'none' };
+                    }
+                    try {
+                        return {
+                            state: 'valid',
+                            metadata: JSON.parse(content.slice(trimmedStart, bodyStartIndex)),
+                            bodyStartIndex
+                        };
+                    }
+                    catch {
+                        return { state: 'invalid' };
+                    }
+                }
+            }
+        }
+        return { state: 'none' };
+    }
     /**
      * Parse a workflow markdown file into a structured definition
-     * Supports two formats:
-     * 1. Phase-based workflows with JSON frontmatter (e.g., implement, spec)
-     * 2. Simple workflows without frontmatter (e.g., bootstrap workflows)
+     * Supports three formats:
+     * 1. Phase-based workflows with JSON frontmatter
+     * 2. Phase-based workflows with bare leading JSON metadata
+     * 3. Simple workflows without metadata
      */
     static parse(filePath) {
         if (!(0, fs_1.existsSync)(filePath))
             return null;
         let content = (0, fs_1.readFileSync)(filePath, 'utf-8');
-        // Strip optional UTF-8 BOM so frontmatter regex remains stable across editors.
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
         }
-        // Try to extract JSON Metadata (frontmatter)
-        const metadataMatch = content.match(/^---\r?\n([\s\S]+?)\r?\n---/);
-        if (metadataMatch) {
-            // Phase-based workflow with frontmatter
-            return this.parsePhaseBasedWorkflow(filePath, content, metadataMatch);
+        const metadataBlock = this.extractMetadataBlock(content);
+        if (metadataBlock.state === 'invalid') {
+            return null;
         }
-        else {
-            // Simple workflow without frontmatter
-            return this.parseSimpleWorkflow(filePath, content);
+        if (metadataBlock.state === 'valid') {
+            return this.parsePhaseBasedWorkflow(filePath, content, metadataBlock.metadata, metadataBlock.bodyStartIndex);
         }
+        return this.parseSimpleWorkflow(filePath, content);
     }
-    /**
-     * Parse a phase-based workflow with JSON frontmatter
-     */
-    static parsePhaseBasedWorkflow(filePath, content, metadataMatch) {
-        let metadata;
-        try {
-            metadata = JSON.parse(metadataMatch[1]);
-        }
-        catch (e) {
-            console.error(`❌ Failed to parse JSON metadata in ${filePath}:`, e);
-            return null;
-        }
-        // Extract Overview (Content after metadata but before first phase header)
-        const contentAfterMetadata = content.substring(metadataMatch[0].length).trim();
+    static parsePhaseBasedWorkflow(filePath, content, metadata, bodyStartIndex) {
+        const contentAfterMetadata = content.substring(bodyStartIndex).trim();
         const firstPhaseIndex = contentAfterMetadata.search(/^##\s+Phase:/m);
         let overview = '';
         let restOfContent = '';
@@ -53,21 +106,16 @@ class WorkflowParser {
         else {
             overview = contentAfterMetadata;
         }
-        // Extract Phases (id -> content)
         const phases = new Map();
         const phaseSections = restOfContent.split(/^##\s+Phase:\s+/m);
-        // Ensure metadata has a phases object
         if (!metadata.phases) {
             metadata.phases = {};
         }
-        // Skip the first part (empty or overview overlap)
         for (let i = 1; i < phaseSections.length; i++) {
             const section = phaseSections[i];
             const sectionLines = section.split('\n');
             const firstLine = sectionLines[0].trim();
-            // Extract phase ID (slug before any (Phase X) or space)
             const id = firstLine.split(/[ (]/)[0].trim().toLowerCase();
-            // Store the whole section with header
             phases.set(id, `## Phase: ${section.trim()}`);
         }
         return {
@@ -78,14 +126,8 @@ class WorkflowParser {
             path: filePath
         };
     }
-    /**
-     * Parse a simple workflow without frontmatter (bootstrap-style)
-     */
     static parseSimpleWorkflow(filePath, content) {
-        // Extract workflow name from filename
         const workflowName = (0, path_1.basename)(filePath, '.md');
-        // For simple workflows, the entire content is the overview
-        // No phases, just execution steps
         const metadata = {
             name: workflowName
         };
@@ -97,49 +139,34 @@ class WorkflowParser {
             path: filePath
         };
     }
-    /**
-     * Parse workflow content from a string
-     */
     static parseContent(content, name, path) {
-        // Strip optional UTF-8 BOM
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
         }
-        // Try to extract JSON Metadata (frontmatter)
-        const metadataMatch = content.match(/^---\r?\n([\s\S]+?)\r?\n---/);
-        if (metadataMatch) {
-            return this.parsePhaseBasedWorkflow(path || `content:${name}`, content, metadataMatch);
+        const metadataBlock = this.extractMetadataBlock(content);
+        if (metadataBlock.state === 'invalid') {
+            return null;
         }
-        else {
-            return this.parseSimpleWorkflow(path || `content:${name}`, content);
+        if (metadataBlock.state === 'valid') {
+            return this.parsePhaseBasedWorkflow(path || `content:${name}`, content, metadataBlock.metadata, metadataBlock.bodyStartIndex);
         }
+        return this.parseSimpleWorkflow(path || `content:${name}`, content);
     }
-    /**
-     * Get just the overview from content
-     */
     static getOverviewFromContent(content, name) {
         const wf = this.parseContent(content, name);
         return wf ? wf.overview : null;
     }
-    /**
-     * Get just the overview for an agent starting a workflow
-     */
     static getOverview(filePath) {
         const wf = this.parse(filePath);
         return wf ? wf.overview : null;
     }
-    /**
-     * Extract description for listing workflows (intent or first para of overview)
-     */
     static extractDescription(filePath) {
         const wf = this.parse(filePath);
         if (!wf)
             return '';
-        // Try to find Intent section in overview
         const intentMatch = wf.overview.match(/## Intent\s+([\s\S]+?)(?:\r?\n##|$)/);
         if (intentMatch)
             return intentMatch[1].trim().split(/\r?\n/)[0];
-        // Fallback to first non-header line
         const firstPara = wf.overview.split(/\r?\n/).find(l => l.trim() !== '' && !l.startsWith('#'));
         return firstPara ? firstPara.trim() : '';
     }

package/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM Framework - Smart Entry Point

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.88",
+  "version": "2.0.89",
   "description": "FRAIM v2: Framework for Rigor-based AI Management - Transform from solo developer to AI manager orchestrating production-ready code with enterprise-grade discipline",
   "main": "index.js",
   "bin": {

package/dist/src/cli/services/device-flow-service.js

@@ -1,83 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeviceFlowService = void 0;
-const axios_1 = __importDefault(require("axios"));
-const chalk_1 = __importDefault(require("chalk"));
-class DeviceFlowService {
-    constructor(config) {
-        this.config = config;
-    }
-    /**
-     * Start the Device Flow Login
-     */
-    async login() {
-        console.log(chalk_1.default.blue('\n🔗 Starting Authentication...'));
-        try {
-            // 1. Request device and user codes
-            const deviceCode = await this.requestDeviceCode();
-            console.log(chalk_1.default.yellow('\nACTION REQUIRED:'));
-            console.log(`1. Go to: ${chalk_1.default.cyan.underline(deviceCode.verification_uri)}`);
-            console.log(`2. Enter the code: ${chalk_1.default.bold.green(deviceCode.user_code)}`);
-            console.log(chalk_1.default.gray(`\nWaiting for authorization (expires in ${Math.floor(deviceCode.expires_in / 60)} minutes)...`));
-            // 2. Poll for the access token
-            const token = await this.pollForToken(deviceCode.device_code, deviceCode.interval);
-            console.log(chalk_1.default.green('\n✅ Authentication Successful!'));
-            return token;
-        }
-        catch (error) {
-            console.error(chalk_1.default.red(`\n❌ Authentication failed: ${error.message}`));
-            throw error;
-        }
-    }
-    async requestDeviceCode() {
-        const response = await axios_1.default.post(this.config.authUrl, {
-            client_id: this.config.clientId,
-            scope: this.config.scope
-        }, {
-            headers: { Accept: 'application/json' }
-        });
-        return response.data;
-    }
-    async pollForToken(deviceCode, interval) {
-        let currentInterval = interval * 1000;
-        return new Promise((resolve, reject) => {
-            const poll = async () => {
-                try {
-                    const response = await axios_1.default.post(this.config.tokenUrl, {
-                        client_id: this.config.clientId,
-                        device_code: deviceCode,
-                        grant_type: 'urn:ietf:params:oauth:grant-type:device_code'
-                    }, {
-                        headers: { Accept: 'application/json' }
-                    });
-                    if (response.data.access_token) {
-                        resolve(response.data.access_token);
-                        return;
-                    }
-                    if (response.data.error) {
-                        const error = response.data.error;
-                        if (error === 'authorization_pending') {
-                            // Keep polling
-                            setTimeout(poll, currentInterval);
-                        }
-                        else if (error === 'slow_down') {
-                            currentInterval += 5000;
-                            setTimeout(poll, currentInterval);
-                        }
-                        else {
-                            reject(new Error(response.data.error_description || error));
-                        }
-                    }
-                }
-                catch (error) {
-                    reject(error);
-                }
-            };
-            setTimeout(poll, currentInterval);
-        });
-    }
-}
-exports.DeviceFlowService = DeviceFlowService;