fridayy 1.0.2 → 1.2.1

package/dist/core/tool-generator/generator.js

@@ -1,7 +1,11 @@
 /**
  * Fridayy - Tool Generator Engine
  * Coordinates adapters to generate, filter, and normalize candidate MCP tools.
+ * Features intelligent auto-fallback across adapters when files are missing.
  */
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
 import { defaultAdapterRegistry } from '../../adapters/registry.js';
 import { isToolAllowed } from '../../security/allowlist.js';
 export class ToolGenerator {
@@ -10,14 +14,38 @@ export class ToolGenerator {
         this.adapterRegistry = adapterRegistry;
     }
     /**
-     * Generates MCP tools from the configured source adapter.
+     * Generates MCP tools with automated adapter fallback capabilities.
      */
     async generate(options) {
-        const { config, rootDir = process.cwd(), preserveStatuses } = options;
-        const sourceType = config.source.type || 'openapi';
-        const adapter = this.adapterRegistry.get(sourceType);
+        const { config, rootDir = process.cwd(), preserveStatuses, sourceTypeOverride } = options;
+        let sourceType = sourceTypeOverride || config.source.type || 'openapi';
+        // Auto-fallback check if OpenAPI file does not exist
+        if (sourceType === 'openapi') {
+            const specPath = config.source.path ? path.resolve(rootDir, config.source.path) : null;
+            const specExists = specPath && fs.existsSync(specPath);
+            if (!specExists) {
+                // Check if Node.js project exists
+                const hasPkgJson = fs.existsSync(path.join(rootDir, 'package.json'));
+                if (hasPkgJson && this.adapterRegistry.has('nodejs')) {
+                    console.warn(chalk.yellow(`⚠ OpenAPI specification not found at "${config.source.path || './openapi.yaml'}". Automatically switching to Node.js route discovery.`));
+                    sourceType = 'nodejs';
+                }
+                else if (config.source.baseUrl && this.adapterRegistry.has('rest')) {
+                    console.warn(chalk.yellow(`⚠ OpenAPI specification not found at "${config.source.path || './openapi.yaml'}". Automatically switching to REST adapter for ${config.source.baseUrl}.`));
+                    sourceType = 'rest';
+                }
+            }
+        }
+        let adapter = this.adapterRegistry.get(sourceType);
         if (!adapter) {
-            throw new Error(`Unsupported source adapter: "${sourceType}". Registered adapters: [${this.adapterRegistry.getAll().map(a => a.name).join(', ')}]`);
+            // Fallback to first available adapter
+            const allAdapters = this.adapterRegistry.getAll();
+            if (allAdapters.length > 0) {
+                adapter = allAdapters[0];
+            }
+            else {
+                throw new Error(`No compatible source adapters found for type "${sourceType}".`);
+            }
         }
         const generatedRawTools = await adapter.generateTools({
             rootDir,

package/dist/core/tool-generator/generator.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fridayy",
-  "version": "1.0.2",
+  "version": "1.2.1",
   "description": "Universal Application-to-MCP Platform — Turn existing applications and APIs into AI-ready MCP tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,6 +11,7 @@
   "files": [
     "dist",
     "bin",
+    "point",
     "README.md",
     "LICENSE"
   ],

package/point/AI_INSTRUCTIONS.md

@@ -0,0 +1,130 @@
+# AI Instructions & Autonomous Integration Guide
+
+> **Directive for AI / LLM Agents**: When a developer points you to this file (`point/AI_INSTRUCTIONS.md` or `@point`), read these instructions to understand the project architecture, operational rules, and execute the necessary steps automatically to connect their application to MCP.
+
+---
+
+## 🎯 1. What is Fridayy?
+
+**fridayy** is a developer-focused, local-first platform that converts existing APIs and applications (REST, OpenAPI, Node.js routes, Manual tools) into **Model Context Protocol (MCP)** tools.
+
+### Core Philosophy:
+* **Build once, connect everywhere.**
+* **Zero code rewriting**: Discovers endpoints from existing specifications or source code.
+* **Zero-trust security**: Granular permission classification (`READ`, `WRITE`, `DESTRUCTIVE`) with destructive actions (`DELETE`, `drop`, `purge`) blocked by default until human developer approval.
+* **Zero secret leakage**: Credentials load strictly from environment variables (`FRIDAYY_*`) at execution time and are never exposed to LLMs.
+
+---
+
+## 🤖 2. Autonomous Action Protocol for AI Assistants
+
+When the developer asks you to set up, maintain, or connect their project using Fridayy, execute the following steps in order:
+
+```mermaid
+graph TD
+    A[1. Workspace Analysis] --> B[2. Initialize Fridayy]
+    B --> C[3. Scan Capabilities]
+    C --> D[4. Generate Tool Definitions]
+    D --> E[5. Review & Classify Permissions]
+    E --> F[6. Run Diagnostics]
+    F --> G[7. Connect to MCP Client]
+```
+
+### Step 1: Analyze the Workspace
+1. Check if an OpenAPI specification exists (`openapi.yaml`, `openapi.json`, `swagger.yaml`).
+2. If no OpenAPI spec exists, check for Node.js route definitions (`Express`, `Fastify`, `Koa`).
+3. Check target backend URL and port (default is `http://localhost:3000` or `http://localhost:4000`).
+
+### Step 2: Initialize Configuration
+Run:
+```bash
+npx fridayy init --yes
+```
+*Creates `fridayy.config.json` with detected settings.*
+
+### Step 3: Scan Capabilities & Endpoints
+Run:
+```bash
+npx fridayy scan
+```
+*Identifies all candidate endpoints, HTTP methods, and authentication schemes.*
+
+### Step 4: Generate Candidate MCP Tools
+Run:
+```bash
+npx fridayy generate
+```
+*Generates `fridayy.tools.json` containing standardized tool schemas, parameters, and risk classifications.*
+
+### Step 5: Review & Classify Permissions
+* **READ Tools** (`GET`): Safe to auto-approve.
+  ```bash
+  npx fridayy review --approve-read
+  ```
+* **WRITE Tools** (`POST`, `PUT`, `PATCH`): Approve based on user intent.
+* **DESTRUCTIVE Tools** (`DELETE`, `purge`, `cancel`): **DO NOT** approve destructive tools without explicitly asking the developer for confirmation.
+
+### Step 6: Run Diagnostic Health Check
+Run:
+```bash
+npx fridayy doctor
+```
+*Verifies schema integrity, environment variables, and target API connectivity.*
+
+### Step 7: Configure MCP Client
+Configure the user's AI client (Claude Desktop, Cursor, or Gemini) as follows:
+
+#### For Claude Desktop (`claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "fridayy": {
+      "command": "npx",
+      "args": ["fridayy", "start"],
+      "env": {
+        "FRIDAYY_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+#### For Cursor IDE:
+* **Settings** → **Features** → **MCP**
+* **Type**: `command`
+* **Command**: `npx fridayy start`
+
+---
+
+## 🏗️ 3. Architecture & Codebase Map
+
+| Directory | Purpose | Key Files |
+|---|---|---|
+| `src/cli/` | Command line interface | `index.ts`, `commands/`, `ui/` |
+| `src/core/schema/` | Schema converter & unifier | `types.ts`, `json-schema.ts` |
+| `src/core/permissions/` | Permission classifier & gatekeeper | `classifier.ts`, `enforcer.ts` |
+| `src/core/authentication/` | Secret isolation & token resolver | `manager.ts`, `secret-resolver.ts` |
+| `src/core/validation/` | Parameter & schema validation | `validator.ts`, `config-schema.ts` |
+| `src/adapters/` | Pluggable source adapters | `openapi/`, `nodejs/`, `rest/`, `manual/`, `registry.ts` |
+| `src/mcp/` | Standards-compliant MCP Server | `server/fridayy-server.ts`, `tools/`, `resources/`, `prompts/` |
+| `src/security/` | Rate limiting & audit logging | `rate-limiter.ts`, `audit-logger.ts`, `sanitizer.ts` |
+
+---
+
+## 🛡️ 4. Security Rules for AI Agents
+
+1. **Never Bypass Destructive Protection**: Never modify `fridayy.tools.json` to approve a `DESTRUCTIVE` tool unless the developer explicitly asked for that specific tool to be enabled.
+2. **Never Commit Secrets**: Ensure all API tokens, basic auth passwords, and JWTs are loaded through `process.env.FRIDAYY_*` and never written in plaintext into `fridayy.config.json` or committed to Git.
+3. **Validate Inputs**: Ensure tool arguments sent by models adhere to the JSON Schema generated by Fridayy.
+
+---
+
+## 🔧 5. Extending with New Adapters (AI Guidance)
+
+To add a new adapter (e.g. GraphQL, PostgreSQL, Python FastAPI):
+1. Create `src/adapters/<name>/adapter.ts` extending `BaseAdapter` from `src/adapters/base.ts`.
+2. Implement:
+   - `detect(context)`: Boolean capability check.
+   - `generateTools(context)`: Returns `FridayyToolDefinition[]`.
+   - `executeTool(tool, input, context)`: Dispatches runtime execution.
+3. Register the new adapter instance in `src/adapters/registry.ts`.

package/point/PROJECT_CONTEXT.md

@@ -0,0 +1,61 @@
+# Fridayy Project Context & Machine-Readable Spec
+
+This document provides structured context for AI agents reading the codebase.
+
+---
+
+## 📌 Project Metadata
+* **Name**: `fridayy`
+* **Version**: `1.2.0`
+* **Author**: `Sabarivasan`
+* **Protocol**: Model Context Protocol (MCP) v1.6+
+* **Repository**: `https://github.com/Sabari-Vasan-SM/fridayy`
+* **License**: MIT
+
+---
+
+## 🛠️ Data Model & Schemas
+
+### FridayyToolDefinition
+```typescript
+interface FridayyToolDefinition {
+  id: string;                                   // Unique ID (e.g. tool_get_products)
+  name: string;                                 // Valid snake_case tool name (e.g. get_products)
+  description: string;                          // Human & AI-readable description
+  inputSchema: {                                // Unified JSON Schema Draft-7
+    type: 'object';
+    properties: Record<string, any>;
+    required: string[];
+  };
+  source: {                                     // Source binding
+    type: 'openapi' | 'rest' | 'nodejs' | 'manual';
+    method?: string;
+    path?: string;
+    baseUrl?: string;
+  };
+  permissions: {                                // Permission classification
+    type: 'READ' | 'WRITE' | 'DESTRUCTIVE';
+    read: boolean;
+    write: boolean;
+    destructive: boolean;
+  };
+  risk: 'low' | 'medium' | 'high';              // Risk scoring
+  status: 'APPROVED' | 'PENDING' | 'BLOCKED' | 'REJECTED';
+}
+```
+
+---
+
+## 🚦 Permission Matrix
+
+| HTTP Method / Pattern | Classification | Risk Level | Default Status | Action Required |
+|---|---|---|---|---|
+| `GET`, `HEAD`, `OPTIONS` | `READ` | `low` | `APPROVED` | Ready for AI invocation |
+| `POST`, `PUT`, `PATCH` | `WRITE` | `medium` | `PENDING` | Review before enabling |
+| `DELETE`, `purge`, `erase`, `cancel` | `DESTRUCTIVE` | `high` | `BLOCKED` | Explicit human approval mandatory |
+
+---
+
+## 🔌 Available Transports
+1. **Stdio Transport**: Default standard I/O stream for local desktop AI clients (Claude Desktop, Cursor IDE).
+2. **SSE Transport**: Server-Sent Events over HTTP for remote AI agents and web hooks (`--transport sse --port 3000`).

package/point/QUICK_START_PROMPT.md

@@ -0,0 +1,27 @@
+# AI Agent Prompt Snippets
+
+Copy-paste any of the prompts below into Claude, ChatGPT, Cursor, Gemini, or Antigravity to perform automatic Fridayy tasks:
+
+---
+
+### Prompt 1: Full Automatic API-to-MCP Setup
+```text
+Please read @point/AI_INSTRUCTIONS.md and automatically analyze my current project.
+Detect my OpenAPI / REST endpoints, generate Fridayy tool definitions, approve all safe read-only tools, verify project health with 'fridayy doctor', and guide me on how to start the MCP server.
+```
+
+---
+
+### Prompt 2: Safe Tool Review & Selective Approval
+```text
+Please review @point/PROJECT_CONTEXT.md and my generated fridayy.tools.json.
+List all candidate tools, highlight any WRITE or DESTRUCTIVE tools that require confirmation, and help me approve only the tools needed for my specific task.
+```
+
+---
+
+### Prompt 3: Add Custom Tool / Adapter Extension
+```text
+I want to add a custom adapter/tool to Fridayy.
+Please check @point/AI_INSTRUCTIONS.md Section 5 for adapter extension rules, and help me implement a new BaseAdapter subclass for my backend.
+```