fraim-framework 2.0.55 → 2.0.57

package/dist/tests/test-workflow-discovery.js

@@ -1,242 +0,0 @@
-"use strict";
-/**
- * Tests for dynamic workflow discovery in MCP server
- * Ensures workflows from all categories can be found without hardcoded category lists
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const node_test_1 = require("node:test");
-const node_assert_1 = __importDefault(require("node:assert"));
-const shared_server_utils_js_1 = require("./shared-server-utils.js");
-(0, node_test_1.describe)('Workflow Discovery', () => {
-    (0, node_test_1.before)(async () => {
-        // Wait for the test server to be ready
-        await (0, shared_server_utils_js_1.waitForServer)();
-    });
-    (0, node_test_1.describe)('Dynamic Category Discovery', () => {
-        (0, node_test_1.it)('should find workflows from product-building category', async () => {
-            const axios = require('axios');
-            const response = await axios.post((0, shared_server_utils_js_1.getMcpEndpoint)(), {
-                jsonrpc: '2.0',
-                id: 1,
-                method: 'tools/call',
-                params: {
-                    name: 'get_fraim_workflow',
-                    arguments: { workflow: 'spec' }
-                }
-            });
-            node_assert_1.default.strictEqual(response.status, 200);
-            node_assert_1.default.ok(response.data.result);
-            node_assert_1.default.ok(response.data.result.content);
-            node_assert_1.default.ok(Array.isArray(response.data.result.content));
-            const content = response.data.result.content[0];
-            node_assert_1.default.strictEqual(content.type, 'text');
-            node_assert_1.default.ok(content.text.includes('Workflow: spec'));
-            node_assert_1.default.ok(content.text.includes('workflows/product-building/spec.md'));
-        });
-        (0, node_test_1.it)('should find workflows from compliance category', async () => {
-            const axios = require('axios');
-            const response = await axios.post((0, shared_server_utils_js_1.getMcpEndpoint)(), {
-                jsonrpc: '2.0',
-                id: 2,
-                method: 'tools/call',
-                params: {
-                    name: 'get_fraim_workflow',
-                    arguments: { workflow: 'detect-compliance-requirements' }
-                }
-            });
-            node_assert_1.default.strictEqual(response.status, 200);
-            node_assert_1.default.ok(response.data.result);
-            node_assert_1.default.ok(response.data.result.content);
-            const content = response.data.result.content[0];
-            node_assert_1.default.strictEqual(content.type, 'text');
-            node_assert_1.default.ok(content.text.includes('Workflow: detect-compliance-requirements'));
-            node_assert_1.default.ok(content.text.includes('workflows/compliance/detect-compliance-requirements.md'));
-            node_assert_1.default.ok(content.text.includes('Detect Compliance Requirements'));
-        });
-        (0, node_test_1.it)('should find workflows from brainstorming category', async () => {
-            const axios = require('axios');
-            const response = await axios.post((0, shared_server_utils_js_1.getMcpEndpoint)(), {
-                jsonrpc: '2.0',
-                id: 3,
-                method: 'tools/call',
-                params: {
-                    name: 'get_fraim_workflow',
-                    arguments: { workflow: 'blue-sky-brainstorming' }
-                }
-            });
-            node_assert_1.default.strictEqual(response.status, 200);
-            node_assert_1.default.ok(response.data.result);
-            node_assert_1.default.ok(response.data.result.content);
-            const content = response.data.result.content[0];
-            node_assert_1.default.strictEqual(content.type, 'text');
-            node_assert_1.default.ok(content.text.includes('Workflow: blue-sky-brainstorming'));
-            node_assert_1.default.ok(content.text.includes('workflows/brainstorming/blue-sky-brainstorming.md'));
-        });
-        (0, node_test_1.it)('should find workflows from learning category', async () => {
-            const axios = require('axios');
-            const response = await axios.post((0, shared_server_utils_js_1.getMcpEndpoint)(), {
-                jsonrpc: '2.0',
-                id: 4,
-                method: 'tools/call',
-                params: {
-                    name: 'get_fraim_workflow',
-                    arguments: { workflow: 'synthesize-learnings' }
-                }
-            });
-            node_assert_1.default.strictEqual(response.status, 200);
-            node_assert_1.default.ok(response.data.result);
-            node_assert_1.default.ok(response.data.result.content);
-            const content = response.data.result.content[0];
-            node_assert_1.default.strictEqual(content.type, 'text');
-            node_assert_1.default.ok(content.text.includes('Workflow: synthesize-learnings'));
-            node_assert_1.default.ok(content.text.includes('workflows/learning/synthesize-learnings.md'));
-        });
-        (0, node_test_1.it)('should find workflows from replicate category', async () => {
-            const axios = require('axios');
-            const response = await axios.post((0, shared_server_utils_js_1.getMcpEndpoint)(), {
-                jsonrpc: '2.0',
-                id: 5,
-                method: 'tools/call',
-                params: {
-                    name: 'get_fraim_workflow',
-                    arguments: { workflow: 'replicate-discovery' }
-                }
-            });
-            node_assert_1.default.strictEqual(response.status, 200);
-            node_assert_1.default.ok(response.data.result);
-            node_assert_1.default.ok(response.data.result.content);
-            const content = response.data.result.content[0];
-            node_assert_1.default.strictEqual(content.type, 'text');
-            node_assert_1.default.ok(content.text.includes('Workflow: replicate-discovery'));
-            node_assert_1.default.ok(content.text.includes('workflows/replicate/replicate-discovery.md'));
-        });
-        (0, node_test_1.it)('should find workflows from marketing category', async () => {
-            const axios = require('axios');
-            const response = await axios.post((0, shared_server_utils_js_1.getMcpEndpoint)(), {
-                jsonrpc: '2.0',
-                id: 6,
-                method: 'tools/call',
-                params: {
-                    name: 'get_fraim_workflow',
-                    arguments: { workflow: 'create-modern-website' }
-                }
-            });
-            node_assert_1.default.strictEqual(response.status, 200);
-            node_assert_1.default.ok(response.data.result);
-            node_assert_1.default.ok(response.data.result.content);
-            const content = response.data.result.content[0];
-            node_assert_1.default.strictEqual(content.type, 'text');
-            node_assert_1.default.ok(content.text.includes('Workflow: create-modern-website'));
-            node_assert_1.default.ok(content.text.includes('workflows/marketing/create-modern-website.md'));
-        });
-    });
-    (0, node_test_1.describe)('Error Handling', () => {
-        (0, node_test_1.it)('should return helpful error for non-existent workflow', async () => {
-            const axios = require('axios');
-            const response = await axios.post((0, shared_server_utils_js_1.getMcpEndpoint)(), {
-                jsonrpc: '2.0',
-                id: 7,
-                method: 'tools/call',
-                params: {
-                    name: 'get_fraim_workflow',
-                    arguments: { workflow: 'non-existent-workflow' }
-                }
-            });
-            node_assert_1.default.strictEqual(response.status, 200);
-            node_assert_1.default.ok(response.data.result);
-            node_assert_1.default.ok(response.data.result.content);
-            const content = response.data.result.content[0];
-            node_assert_1.default.strictEqual(content.type, 'text');
-            node_assert_1.default.ok(content.text.includes('Workflow "non-existent-workflow" not found'));
-            node_assert_1.default.ok(content.text.includes('Available workflows:'));
-        });
-        (0, node_test_1.it)('should handle workflow names with .md extension', async () => {
-            const axios = require('axios');
-            const response = await axios.post((0, shared_server_utils_js_1.getMcpEndpoint)(), {
-                jsonrpc: '2.0',
-                id: 8,
-                method: 'tools/call',
-                params: {
-                    name: 'get_fraim_workflow',
-                    arguments: { workflow: 'spec.md' }
-                }
-            });
-            node_assert_1.default.strictEqual(response.status, 200);
-            node_assert_1.default.ok(response.data.result);
-            node_assert_1.default.ok(response.data.result.content);
-            const content = response.data.result.content[0];
-            node_assert_1.default.strictEqual(content.type, 'text');
-            node_assert_1.default.ok(content.text.includes('Workflow: spec'));
-            node_assert_1.default.ok(content.text.includes('workflows/product-building/spec.md'));
-        });
-    });
-    (0, node_test_1.describe)('Regression Prevention', () => {
-        (0, node_test_1.it)('should discover all workflow categories dynamically', async () => {
-            const axios = require('axios');
-            // Test that we can find workflows from multiple categories without hardcoding
-            const testCases = [
-                { workflow: 'spec', expectedCategory: 'product-building' },
-                { workflow: 'detect-compliance-requirements', expectedCategory: 'compliance' },
-                { workflow: 'blue-sky-brainstorming', expectedCategory: 'brainstorming' },
-                { workflow: 'synthesize-learnings', expectedCategory: 'learning' },
-                { workflow: 'replicate-discovery', expectedCategory: 'replicate' },
-                { workflow: 'create-modern-website', expectedCategory: 'marketing' }
-            ];
-            for (const testCase of testCases) {
-                const response = await axios.post((0, shared_server_utils_js_1.getMcpEndpoint)(), {
-                    jsonrpc: '2.0',
-                    id: 100 + testCases.indexOf(testCase),
-                    method: 'tools/call',
-                    params: {
-                        name: 'get_fraim_workflow',
-                        arguments: { workflow: testCase.workflow }
-                    }
-                });
-                node_assert_1.default.strictEqual(response.status, 200, `Failed to find workflow: ${testCase.workflow}`);
-                node_assert_1.default.ok(response.data.result, `No result for workflow: ${testCase.workflow}`);
-                node_assert_1.default.ok(response.data.result.content, `No content for workflow: ${testCase.workflow}`);
-                const content = response.data.result.content[0];
-                node_assert_1.default.strictEqual(content.type, 'text');
-                node_assert_1.default.ok(content.text.includes(`workflows/${testCase.expectedCategory}/${testCase.workflow}.md`), `Expected workflow ${testCase.workflow} to be found in category ${testCase.expectedCategory}, but got: ${content.text.substring(0, 200)}`);
-            }
-        });
-        (0, node_test_1.it)('should not fail when new categories are added', async () => {
-            // This test documents the expected behavior:
-            // When new workflow categories are added to the registry,
-            // they should be automatically discoverable without code changes
-            const axios = require('axios');
-            // Get list of all workflows to verify dynamic discovery is working
-            const response = await axios.post((0, shared_server_utils_js_1.getMcpEndpoint)(), {
-                jsonrpc: '2.0',
-                id: 200,
-                method: 'tools/call',
-                params: {
-                    name: 'list_fraim_workflows'
-                }
-            });
-            node_assert_1.default.strictEqual(response.status, 200);
-            node_assert_1.default.ok(response.data.result);
-            node_assert_1.default.ok(response.data.result.content);
-            const content = response.data.result.content[0];
-            node_assert_1.default.strictEqual(content.type, 'text');
-            // Verify that multiple categories are listed
-            const expectedCategories = [
-                'bootstrap',
-                'brainstorming',
-                'business-development',
-                'compliance',
-                'customer-development',
-                'learning',
-                'marketing',
-                'product-building',
-                'replicate'
-            ];
-            for (const category of expectedCategories) {
-                node_assert_1.default.ok(content.text.includes(category), `Expected category "${category}" to be listed in workflows, but got: ${content.text.substring(0, 500)}`);
-            }
-        });
-    });
-});

package/labels.json

@@ -1,52 +0,0 @@
-[
-  {
-    "name": "phase:spec",
-    "color": "008672",
-    "description": "Specification creation phase"
-  },
-  {
-    "name": "phase:design",
-    "color": "0075ca",
-    "description": "Design and RFC creation phase"
-  },
-  {
-    "name": "phase:impl",
-    "color": "7057ff",
-    "description": "Implementation and development phase"
-  },
-  {
-    "name": "phase:tests",
-    "color": "008672",
-    "description": "Testing and validation phase"
-  },
-  {
-    "name": "status:wip",
-    "color": "fbca04",
-    "description": "Work in progress"
-  },
-  {
-    "name": "status:needs-review",
-    "color": "fbca04",
-    "description": "Ready for review"
-  },
-  {
-    "name": "status:complete",
-    "color": "0e8a16",
-    "description": "Work completed"
-  },
-  {
-    "name": "ai-agent:cursor",
-    "color": "c5def5",
-    "description": "Assigned to Cursor"
-  },
-  {
-    "name": "ai-agent:claude",
-    "color": "c5def5",
-    "description": "Assigned to Claude"
-  },
-  {
-    "name": "ai-agent:windsurf",
-    "color": "c5def5",
-    "description": "Assigned to Windsurf"
-  }
-]

package/registry/agent-guardrails.md

@@ -1,63 +0,0 @@
-# AI Agent Guardrails
-
-This file references the centralized rules located in `rules/` to ensure consistency across all AI platforms.
-
-## SUCCESS CRITERIA (THE "FRAIM 5")
-**Source**: Retrieve via `get_fraim_file({ path: "rules/agent-success-criteria.md" })`
-
-All agents are evaluated on:
-1. **Integrity (100 pts)**: Honesty above all.
-2. **Correctness (50 pts)**: Architecture & tests.
-3. **Completeness (30 pts)**: Thoroughness.
-4. **Independence (20 pts)**: Smart decisions.
-5. **Speed (10 pts)**: Velocity.
-
-## Referenced Rules
-
-### 0. Integrity
-**Source**: Retrieve via `get_fraim_file({ path: "rules/integrity-and-test-ethics.md" })`
-
-THIS IS THE MOST CRITICAL RULE. Be ethical, truthful, honest above all.
-
-### 1. Simplicity
-**Source**: Retrieve via `get_fraim_file({ path: "rules/simplicity.md" })`
-
-Keep solutions simple and focused, avoid over-engineering. Focus on the assigned issue only and don't make unrelated changes.
-
-### 2. Communication  
-**Source**: Retrieve via `get_fraim_file({ path: "rules/communication.md" })`
-
-Establish clear communication patterns and progress reporting standards for effective coordination between agents and stakeholders.
-
-### 3. Architecture
-**Source**: Read local architecture document (path from `.fraim/config.json` `customizations.architectureDoc`)
-
-Maintain clean architectural boundaries by using BAML (LLM) for natural-language understanding and TypeScript for deterministic work.
-
-### 4. Continuous Learning
-**Source**: Retrieve via `get_fraim_file({ path: "rules/continuous-learning.md" })`
-
-Prevent repeating past mistakes by systematically learning from retrospectives, RFCs, and historical issue patterns.
-
-### 5. Agent Testing Guidelines
-**Source**: Retrieve via `get_fraim_file({ path: "rules/agent-testing-guidelines.md" })`
-
-Comprehensive testing and validation requirements with concrete evidence. Ensures all work is thoroughly validated before completion.
-
-### 6. Local Development
-**Source**: Retrieve via `get_fraim_file({ path: "rules/local-development.md" })`
-
-Local development guidelines and workspace safety. Enables safe parallel development through strict workspace separation.
-
-### 7. Software Development Lifecycle
-**Source**: Retrieve via `get_fraim_file({ path: "rules/software-development-lifecycle.md" })`
-
-### 9. Merge Requirements
-**Source**: Retrieve via `get_fraim_file({ path: "rules/merge-requirements.md" })`
-
-Enforces a strict `git rebase` workflow to ensure feature branches are up-to-date with `master` before merging, maintaining a clean and stable history.
-
-### 10. Best practices while debuggin
-**Source**: Retrieve via `get_fraim_file({ path: "rules/successful-debugging-patterns.md" })`
-
-Patterns on debugging issues systematically and converting learnings into test cases

package/registry/fraim.md

@@ -1,48 +0,0 @@
-# FRAIM - Agent Instructions
-
-## What is FRAIM?
-
-FRAIM provides workflows, rules, templates, and scripts for AI agents. Use it to get structured guidance for development and customer development tasks.
-
-## How to Use FRAIM
-
-### 1. Initialize First
-**Always call `@fraim_mcp init` at the start of your session.** This loads all rules and available workflows.
-
-### 2. Get Workflows
-Use `@fraim_mcp` with a natural language description:
-- `@fraim_mcp write a spec for issue #631`
-- `@fraim_mcp design a new feature`
-- `@fraim_mcp implement a bug fix`
-- `@fraim_mcp write tests`
-
-FRAIM returns a complete package:
-- Workflow file with step-by-step instructions
-- Templates to fill out
-- Scripts to run
-- Rules you must follow
-
-### 3. Follow the Package
-1. Read the workflow file
-2. Use the provided templates (don't create from scratch)
-3. Run the provided scripts
-4. Follow all rules (they are mandatory)
-
-## Available Tools
-
-- `@fraim_mcp init` - Initialize and get all rules
-- `@fraim_mcp <workflow description>` - Get workflow package
-- `@fraim_mcp get <path>` - Get specific file (e.g., `workflows/spec.md`)
-- `@fraim_mcp list files` - Browse available files
-- `@fraim_mcp search <keyword>` - Find content by keyword
-
-## Key Rules (All Active)
-
-- **Integrity**: Be ethical, truthful, honest
-- **Simplicity**: Keep solutions simple, avoid over-engineering
-- **Communication**: Provide clear progress updates
-- **Testing**: Comprehensive testing requirements (see agent-testing-guidelines.md)
-- **Code Quality**: Never use `as any`, follow debugging patterns
-- **PR Workflow**: Complete PR lifecycle handling
-
-**All rules are mandatory. Read them carefully when provided in workflow packages.**

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase1-customer-profiling.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase1-customer-profiling
-
-> [!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("phase1-customer-profiling")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase1-survey-scoping.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase1-survey-scoping
-
-> [!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("phase1-survey-scoping")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase2-platform-discovery.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase2-platform-discovery
-
-> [!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("phase2-platform-discovery")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase2-survey-build-linkedin.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase2-survey-build-linkedin
-
-> [!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("phase2-survey-build-linkedin")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase3-prospect-qualification.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase3-prospect-qualification
-
-> [!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("phase3-prospect-qualification")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase3-survey-build-reddit.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase3-survey-build-reddit
-
-> [!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("phase3-survey-build-reddit")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase4-inventory-compilation.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase4-inventory-compilation
-
-> [!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("phase4-inventory-compilation")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase4-survey-build-x.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase4-survey-build-x
-
-> [!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("phase4-survey-build-x")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase5-survey-build-facebook.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase5-survey-build-facebook
-
-> [!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("phase5-survey-build-facebook")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase6-survey-build-custom.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase6-survey-build-custom
-
-> [!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("phase6-survey-build-custom")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/ai-coach-phases/phase7-survey-dispatch.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: phase7-survey-dispatch
-
-> [!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("phase7-survey-dispatch")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/templates/customer-persona-template.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: customer-persona-template
-
-> [!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("customer-persona-template")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.

package/registry/stubs/workflows/customer-development/templates/search-strategy-template.md

@@ -1,11 +0,0 @@
-# FRAIM Workflow: search-strategy-template
-
-> [!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("search-strategy-template")`
->
-> DO NOT EXECUTE.
-
-## Intent
-No intent defined.