fridayy 1.0.1 → 1.2.0

package/README.md

@@ -76,6 +76,9 @@ npx fridayy init
 ### 2. The 4-Step Developer Experience
 
 ```bash
+# How-To & Architecture guide
+fridayy use
+
 # Step 1: Initialize Fridayy configuration in your project
 fridayy init
 
@@ -94,6 +97,15 @@ fridayy start
 
 ---
 
+### 🤖 Pointing AI Assistants to Your Project
+
+Simply point any LLM or AI agent (Cursor, Claude, ChatGPT, Gemini, Antigravity) to:
+👉 **[`point/AI_INSTRUCTIONS.md`](point/AI_INSTRUCTIONS.md)**
+
+The AI will automatically understand your architecture, discover endpoints, generate tools, configure safe permissions, and run the MCP server autonomously!
+
+---
+
 ## 🏗️ Architecture
 
 fridayy is built with a modular, extensible architecture designed for future pluggability:

package/dist/cli/commands/start.d.ts

@@ -1,6 +1,6 @@
 /**
  * Fridayy - Start Command
- * Boots the MCP server over Stdio or SSE transports.
+ * Boots the MCP server with animated startup diagnostics.
  */
 import { Command } from 'commander';
 export declare function registerStartCommand(program: Command): void;

package/dist/cli/commands/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuD3D"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+D3D"}

package/dist/cli/commands/start.js

@@ -1,19 +1,21 @@
 /**
  * Fridayy - Start Command
- * Boots the MCP server over Stdio or SSE transports.
+ * Boots the MCP server with animated startup diagnostics.
  */
 import chalk from 'chalk';
 import { defaultConfigManager } from '../../config/config-manager.js';
 import { FridayyMcpServer } from '../../mcp/server/fridayy-server.js';
 import { defaultAdapterRegistry } from '../../adapters/registry.js';
-import { getBanner } from '../ui/banner.js';
+import { printBanner } from '../ui/banner.js';
+import { runStartupAnimation } from '../ui/startup-animation.js';
 export function registerStartCommand(program) {
     program
         .command('start')
-        .description('Start the Fridayy MCP server')
+        .description('Start the Fridayy MCP server with animated runtime diagnostics')
         .option('-t, --transport <type>', 'Transport mechanism: stdio or sse', 'stdio')
         .option('-p, --port <port>', 'Port number for SSE transport', '3000')
         .option('-h, --host <host>', 'Host address for SSE transport', 'localhost')
+        .option('--no-animation', 'Skip startup animation')
         .action(async (options) => {
         const rootDir = process.cwd();
         if (!defaultConfigManager.configExists(rootDir)) {
@@ -28,25 +30,32 @@ export function registerStartCommand(program) {
             adapterRegistry: defaultAdapterRegistry
         });
         const exposedTools = server.getToolRegistry().getExposedTools();
+        const transport = options.transport || config.server?.transport || 'stdio';
+        if (transport === 'sse' || process.stdout.isTTY) {
+            printBanner();
+            if (options.animation !== false) {
+                await runStartupAnimation();
+            }
+        }
         if (exposedTools.length === 0) {
             console.error(chalk.yellow('⚠ Warning: No tools are currently APPROVED. MCP clients will discover 0 tools.'));
             console.error(chalk.gray('  Run `fridayy review --approve-read` or `fridayy review --approve-all` to approve tools.'));
         }
-        const transport = options.transport || config.server?.transport || 'stdio';
         if (transport === 'sse') {
             const port = parseInt(options.port || String(config.server?.port || 3000), 10);
             const host = options.host || config.server?.host || 'localhost';
-            console.log(getBanner());
             console.log(chalk.green(`✓ Fridayy MCP Server (SSE) running at http://${host}:${port}`));
             console.log(chalk.cyan(`  - SSE Endpoint:   http://${host}:${port}/sse`));
             console.log(chalk.cyan(`  - Messages Post:  http://${host}:${port}/messages`));
             console.log(chalk.cyan(`  - Health Check:   http://${host}:${port}/health`));
-            console.log(`\nExposing ${chalk.bold.green(exposedTools.length)} approved tools to MCP clients.`);
+            console.log(`\nExposing ${chalk.bold.green(exposedTools.length)} approved tools to MCP clients.\n`);
             await server.startSse(port, host);
         }
         else {
-            // Stdio transport: Logs must go to stderr to preserve stdout for JSON-RPC
-            console.error(chalk.cyan(`[fridayy] Stdio MCP Server started with ${exposedTools.length} approved tools.`));
+            // Stdio transport: Logs go to stderr to keep stdout pristine for JSON-RPC messages
+            if (!process.stdout.isTTY) {
+                console.error(chalk.cyan(`[fridayy] Stdio MCP Server active with ${exposedTools.length} approved tools.`));
+            }
             await server.startStdio();
         }
     });

package/dist/cli/commands/start.js.map

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

package/dist/cli/commands/use.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fridayy - Use Command (How-To Guide & Product Vision)
+ * Explains the application motto, architecture, step-by-step usage, and AI client setups.
+ */
+import { Command } from 'commander';
+export declare function registerUseCommand(program: Command): void;
+//# sourceMappingURL=use.d.ts.map

package/dist/cli/commands/use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/use.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+FzD"}

package/dist/cli/commands/use.js

@@ -0,0 +1,89 @@
+/**
+ * Fridayy - Use Command (How-To Guide & Product Vision)
+ * Explains the application motto, architecture, step-by-step usage, and AI client setups.
+ */
+import chalk from 'chalk';
+import { printBanner } from '../ui/banner.js';
+export function registerUseCommand(program) {
+    program
+        .command('use')
+        .description('Display detailed how-to guide, product vision, architecture, and client setup instructions')
+        .option('--json', 'Output guide in JSON format')
+        .action((options) => {
+        printBanner();
+        if (options.json) {
+            const guide = {
+                name: 'fridayy',
+                tagline: 'Universal Application-to-MCP Platform — Turn existing APIs into AI-ready tools',
+                motto: 'Build once. Connect everywhere.',
+                author: 'Sabarivasan',
+                workflow: [
+                    { step: 1, command: 'fridayy init', description: 'Initialize Fridayy configuration' },
+                    { step: 2, command: 'fridayy scan', description: 'Detect APIs, routes, and auth schemes' },
+                    { step: 3, command: 'fridayy generate', description: 'Generate MCP candidate tools' },
+                    { step: 4, command: 'fridayy review', description: 'Approve or block candidate tools' },
+                    { step: 5, command: 'fridayy start', description: 'Start standards-compliant MCP server' }
+                ]
+            };
+            console.log(JSON.stringify(guide, null, 2));
+            return;
+        }
+        console.log(chalk.bold.hex('#00d2ff')('================================================================================'));
+        console.log(chalk.bold.hex('#00d2ff')('  🎯 THE FRIDAYY MOTTO & PRODUCT VISION'));
+        console.log(chalk.bold.hex('#00d2ff')('================================================================================\n'));
+        console.log(`  ${chalk.bold.white('“Turn existing applications and APIs into AI-ready tools with zero code rewriting.”')}\n`);
+        console.log(`  ${chalk.gray('Existing applications shouldn’t need a complete rewrite to be useful to AI models.')}`);
+        console.log(`  ${chalk.gray('Fridayy creates a safe, reviewable bridge between your backend and modern AI agents.')}\n`);
+        console.log(chalk.bold.hex('#00b4d8')('================================================================================'));
+        console.log(chalk.bold.hex('#00b4d8')('  ⚙️ HOW IT WORKS UNDER THE HOOD'));
+        console.log(chalk.bold.hex('#00b4d8')('================================================================================\n'));
+        console.log(`  ${chalk.cyan('1. Capability Discovery:')}`);
+        console.log(`     Scans OpenAPI specs (v3.0, v3.1, Swagger 2.0) or Node.js Express/Fastify routes.`);
+        console.log(`  ${chalk.cyan('2. Schema Normalization:')}`);
+        console.log(`     Merges URL path variables, query parameters, headers, and request bodies into`);
+        console.log(`     a unified, typed JSON Schema for LLMs.`);
+        console.log(`  ${chalk.cyan('3. Zero-Trust Security & Risk Engine:')}`);
+        console.log(`     Classifies actions into ${chalk.green('READ')} (safe), ${chalk.yellow('WRITE')} (mutating), and ${chalk.red.bold('DESTRUCTIVE')} (delete/purge).`);
+        console.log(`     Destructive tools default to ${chalk.red.bold('BLOCKED')} until you approve them.`);
+        console.log(`  ${chalk.cyan('4. Zero-Leak Secret Isolation:')}`);
+        console.log(`     API keys/tokens are loaded strictly from environment variables at execution time`);
+        console.log(`     and never leaked in LLM prompts or tool schemas.`);
+        console.log(`  ${chalk.cyan('5. Official MCP Server Transport:')}`);
+        console.log(`     Exposes tools via standard Stdio & SSE protocols for Claude Desktop, Cursor, etc.\n`);
+        console.log(chalk.bold.hex('#7209b7')('================================================================================'));
+        console.log(chalk.bold.hex('#7209b7')('  🚀 STEP-BY-STEP WORKFLOW'));
+        console.log(chalk.bold.hex('#7209b7')('================================================================================\n'));
+        console.log(`  ${chalk.bold.white('Step 1:')} ${chalk.cyan.bold('fridayy init')}      ${chalk.gray('→ Creates fridayy.config.json')}`);
+        console.log(`  ${chalk.bold.white('Step 2:')} ${chalk.cyan.bold('fridayy scan')}      ${chalk.gray('→ Inspects your endpoints and auth schemes')}`);
+        console.log(`  ${chalk.bold.white('Step 3:')} ${chalk.cyan.bold('fridayy generate')}  ${chalk.gray('→ Builds candidate MCP tools into fridayy.tools.json')}`);
+        console.log(`  ${chalk.bold.white('Step 4:')} ${chalk.cyan.bold('fridayy review')}    ${chalk.gray('→ Approve safe tools (e.g. fridayy review --approve-read)')}`);
+        console.log(`  ${chalk.bold.white('Step 5:')} ${chalk.cyan.bold('fridayy start')}     ${chalk.gray('→ Launches the live Model Context Protocol server')}\n`);
+        console.log(chalk.bold.hex('#b5179e')('================================================================================'));
+        console.log(chalk.bold.hex('#b5179e')('  🤖 CONNECTING TO AI CLIENTS'));
+        console.log(chalk.bold.hex('#b5179e')('================================================================================\n'));
+        console.log(`  ${chalk.bold('1. Claude Desktop')} (add to claude_desktop_config.json):`);
+        console.log(chalk.gray(`     {`));
+        console.log(chalk.gray(`       "mcpServers": {`));
+        console.log(chalk.gray(`         "my-api": {`));
+        console.log(chalk.gray(`           "command": "npx",`));
+        console.log(chalk.gray(`           "args": ["fridayy", "start"],`));
+        console.log(chalk.gray(`           "env": { "FRIDAYY_API_KEY": "your-api-key" }`));
+        console.log(chalk.gray(`         }`));
+        console.log(chalk.gray(`       }`));
+        console.log(chalk.gray(`     }\n`));
+        console.log(`  ${chalk.bold('2. Cursor IDE')} (Settings → Features → MCP):`);
+        console.log(chalk.gray(`     Type: command | Command: npx fridayy start\n`));
+        console.log(`  ${chalk.bold('3. Pointing AI to this Project:')}`);
+        console.log(`     Simply point your AI agent to ${chalk.cyan.bold('point/AI_INSTRUCTIONS.md')}`);
+        console.log(`     The AI will automatically understand your architecture and run necessary setup.\n`);
+        console.log(chalk.bold.hex('#00f5d4')('================================================================================'));
+        console.log(chalk.bold.hex('#00f5d4')('  💡 PRO TIPS'));
+        console.log(chalk.bold.hex('#00f5d4')('================================================================================\n'));
+        console.log(`  • Run ${chalk.cyan.bold('fridayy doctor')} anytime to check secrets, endpoints, and health.`);
+        console.log(`  • Use ${chalk.cyan.bold('fridayy tools --approved')} to see active tools exposed to AI.`);
+        console.log(`  • Use ${chalk.cyan.bold('fridayy start --transport sse --port 3000')} for remote network clients.\n`);
+        console.log(`  ${chalk.cyan.bold('friday')} - ${chalk.gray('build once. connect everywhere.')}`);
+        console.log(`  ${chalk.gray('Developed by sabarivasan')}\n`);
+    });
+}
+//# sourceMappingURL=use.js.map

package/dist/cli/commands/use.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,SAAS,IAAI,OAAO,CAmBnC;AAED,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAGzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,SAAS,IAAI,OAAO,CAiCnC;AAED,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAGzC"}

package/dist/cli/index.js

@@ -11,13 +11,30 @@ import { registerStartCommand } from './commands/start.js';
 import { registerToolsCommand } from './commands/tools.js';
 import { registerConfigCommand } from './commands/config.js';
 import { registerDoctorCommand } from './commands/doctor.js';
+import { registerUseCommand } from './commands/use.js';
+import { printBanner } from './ui/banner.js';
+import { runStartupAnimation } from './ui/startup-animation.js';
 export function createCli() {
     const program = new Command();
     program
         .name('fridayy')
         .description('Universal Application-to-MCP Platform — Turn existing APIs into AI-ready MCP tools')
-        .version('1.0.1');
-    // Register commands
+        .version('1.2.0')
+        .action(async () => {
+        printBanner();
+        await runStartupAnimation();
+        console.log('Available Commands:');
+        console.log('  fridayy use       → Show guide, product vision & how it works');
+        console.log('  fridayy init      → Initialize configuration');
+        console.log('  fridayy scan      → Scan API endpoints and specs');
+        console.log('  fridayy generate  → Generate candidate MCP tools');
+        console.log('  fridayy review    → Review and approve tools');
+        console.log('  fridayy start     → Start the MCP server');
+        console.log('  fridayy tools     → List all tools and statuses');
+        console.log('  fridayy doctor    → Run diagnostics and health check\n');
+    });
+    // Register subcommands
+    registerUseCommand(program);
     registerInitCommand(program);
     registerScanCommand(program);
     registerGenerateCommand(program);

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,WAAW,CAAC,oFAAoF,CAAC;SACjG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,oBAAoB;IACpB,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,uBAAuB;AACvB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;IAC9K,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAClB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/ui/banner.d.ts

@@ -1,6 +1,6 @@
 /**
  * Fridayy - CLI Banner & Styling Helpers
- * Rich ASCII branding, animated effects, and author credits.
+ * Exact layout and styling matching Fridayy design specifications.
  */
 export declare function getBanner(): string;
 export declare function printBanner(force?: boolean): void;

package/dist/cli/ui/banner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/banner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,SAAS,IAAI,MAAM,CAelC;AAID,wBAAgB,WAAW,CAAC,KAAK,UAAQ,GAAG,IAAI,CAK/C;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/banner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,SAAS,IAAI,MAAM,CAgBlC;AAID,wBAAgB,WAAW,CAAC,KAAK,UAAQ,GAAG,IAAI,CAK/C;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/cli/ui/banner.js

@@ -1,20 +1,21 @@
 /**
  * Fridayy - CLI Banner & Styling Helpers
- * Rich ASCII branding, animated effects, and author credits.
+ * Exact layout and styling matching Fridayy design specifications.
  */
 import chalk from 'chalk';
 export function getBanner() {
-    const line1 = chalk.hex('#00d2ff').bold('  ███████╗██████╗ ██╗██████╗  █████╗ ██╗   ██╗██╗   ██╗');
-    const line2 = chalk.hex('#00b4d8').bold('  ██╔════╝██╔══██╗██║██╔══██╗██╔══██╗╚██╗ ██╔╝╚██╗ ██╔╝');
-    const line3 = chalk.hex('#0096c7').bold('  █████╗  ██████╔╝██║██║  ██║███████║ ╚████╔╝  ╚████╔╝ ');
-    const line4 = chalk.hex('#0077b6').bold('  ██╔══╝  ██╔══██╗██║██║  ██║██╔══██║  ╚██╔╝    ╚██╔╝  ');
-    const line5 = chalk.hex('#7209b7').bold('  ██║     ██║  ██║██║██████╔╝██║  ██║   ██║      ██║   ');
-    const line6 = chalk.hex('#b5179e').bold('  ╚═╝     ╚═╝  ╚═╝╚═╝╚═════╝ ╚═╝  ╚═╝   ╚═╝      ╚═╝   ');
+    const line1 = chalk.bold.white('  ███████╗██████╗ ██╗██████╗  █████╗ ██╗   ██╗██╗   ██╗');
+    const line2 = chalk.bold.white('  ██╔════╝██╔══██╗██║██╔══██╗██╔══██╗╚██╗ ██╔╝╚██╗ ██╔╝');
+    const line3 = chalk.bold.white('  █████╗  ██████╔╝██║██║  ██║███████║ ╚████╔╝  ╚████╔╝ ');
+    const line4 = chalk.bold.white('  ██╔══╝  ██╔══██╗██║██║  ██║██╔══██║  ╚██╔╝    ╚██╔╝  ');
+    const line5 = chalk.bold.white('  ██║     ██║  ██║██║██████╔╝██║  ██║   ██║      ██║   ');
+    const line6 = chalk.bold.white('  ╚═╝     ╚═╝  ╚═╝╚═╝╚═════╝ ╚═╝  ╚═╝   ╚═╝      ╚═╝   ');
     const logo = `\n${line1}\n${line2}\n${line3}\n${line4}\n${line5}\n${line6}\n`;
-    const tagline = `  ${chalk.bold.white('Universal Application-to-MCP Platform')} ${chalk.gray('— Turn existing APIs into AI tools')}`;
-    const badges = `  ${chalk.bgCyan.black.bold(' v1.0.1 ')} ${chalk.bgHex('#7209b7').white.bold(' MCP Standard ')} ${chalk.gray('•')} ${chalk.hex('#00f5d4').bold('⚡ Developed with ❤️ by Sabarivasan')}`;
-    const link = `  ${chalk.gray('Repository:')} ${chalk.underline.cyan('https://github.com/Sabari-Vasan-SM/fridayy')}\n`;
-    return `${logo}\n${tagline}\n${badges}\n${link}`;
+    const authorSub = chalk.gray('                             sabarivasan\n');
+    const tagline = chalk.bold.white('   Universal Application-to-MCP Platform – Turn existing APIs into AI tools\n');
+    const badges = `          ${chalk.cyan.bold('v1.2.0')}   ${chalk.bgHex('#5e17eb').white.bold(' MCP Standard ')}  ${chalk.gray('•')}  ${chalk.yellow('⚡')} Developed with ${chalk.red('❤️')} by ${chalk.hex('#00f5d4').bold('Sabarivasan')}\n`;
+    const repo = `                 ${chalk.gray('Repository:')} ${chalk.underline.hex('#00d2ff')('https://github.com/Sabari-Vasan-SM/fridayy')}\n`;
+    return `${logo}${authorSub}${tagline}${badges}${repo}`;
 }
 let bannerPrinted = false;
 export function printBanner(force = false) {

package/dist/cli/ui/banner.js.map

@@ -1 +1 @@
-{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../../src/cli/ui/banner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACnG,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACnG,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACnG,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACnG,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACnG,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAEnG,MAAM,IAAI,GAAG,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,IAAI,CAAC;IAE9E,MAAM,OAAO,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,uCAAuC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,EAAE,CAAC;IACrI,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,oCAAoC,CAAC,EAAE,CAAC;IACvM,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,4CAA4C,CAAC,IAAI,CAAC;IAEtH,OAAO,GAAG,IAAI,KAAK,OAAO,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B,MAAM,UAAU,WAAW,CAAC,KAAK,GAAG,KAAK;IACvC,IAAI,CAAC,aAAa,IAAI,KAAK,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QACzB,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,aAAa,GAAG,KAAK,CAAC;AACxB,CAAC"}
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../../src/cli/ui/banner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAE1F,MAAM,IAAI,GAAG,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,IAAI,CAAC;IAE9E,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;IAClH,MAAM,MAAM,GAAG,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;IAC9O,MAAM,IAAI,GAAG,oBAAoB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,4CAA4C,CAAC,IAAI,CAAC;IAE/I,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B,MAAM,UAAU,WAAW,CAAC,KAAK,GAAG,KAAK;IACvC,IAAI,CAAC,aAAa,IAAI,KAAK,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QACzB,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,aAAa,GAAG,KAAK,CAAC;AACxB,CAAC"}

package/dist/cli/ui/startup-animation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Fridayy - Startup Animation & Visual Experience
+ * Exact terminal animation sequence matching Fridayy brand design.
+ */
+export interface StartupAnimationOptions {
+    interactive?: boolean;
+    onComplete?: () => void;
+}
+export declare function runStartupAnimation(options?: StartupAnimationOptions): Promise<void>;
+//# sourceMappingURL=startup-animation.d.ts.map

package/dist/cli/ui/startup-animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-animation.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/startup-animation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAID,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CA8C9F"}

package/dist/cli/ui/startup-animation.js

@@ -0,0 +1,47 @@
+/**
+ * Fridayy - Startup Animation & Visual Experience
+ * Exact terminal animation sequence matching Fridayy brand design.
+ */
+import chalk from 'chalk';
+const SPINNER_FRAMES = ['◐', '◓', '◑', '◒'];
+export async function runStartupAnimation(options = {}) {
+    const isTTY = process.stdout.isTTY && !process.env.CI;
+    const steps = [
+        { text: 'Pulling project context...', color: '#00d2ff' },
+        { text: 'Initialising MCP runtime...', color: '#0096c7' },
+        { text: 'Turning existing APIs into tools...', color: '#7209b7' },
+        { text: 'Orchestrating AI capabilities...', color: '#00f5d4' },
+        { text: 'Connecting MCP interface...', color: '#52b788' }
+    ];
+    console.log(chalk.bold.white('> Starting Fridayy\n'));
+    if (!isTTY) {
+        // Fast path for non-TTY environments
+        for (const step of steps) {
+            console.log(`  ${chalk.green('✔')} ${step.text}`);
+        }
+    }
+    else {
+        // Animated sequence for interactive terminal
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            const frameDelay = 45;
+            const totalFrames = 8;
+            for (let f = 0; f < totalFrames; f++) {
+                const spinner = chalk.hex(step.color)(SPINNER_FRAMES[f % SPINNER_FRAMES.length]);
+                process.stdout.write(`\r  ${spinner} ${step.text}`);
+                await new Promise(r => setTimeout(r, frameDelay));
+            }
+            // Settle on completed checkmark
+            process.stdout.write(`\r  ${chalk.green('✔')} ${step.text}\n`);
+        }
+    }
+    console.log('\n' + chalk.bold.green('✔ DONE') + ' ' + chalk.bold.white('Fridayy is ready.\n'));
+    // Status block
+    console.log(`  ${chalk.white('MCP Server')}     ${chalk.green('●')} ${chalk.green('Ready')}`);
+    console.log(`  ${chalk.white('AI Tools')}       ${chalk.green('●')} ${chalk.green('Connected')}`);
+    console.log(`  ${chalk.white('Runtime')}        ${chalk.green('●')} ${chalk.green('Active')}\n`);
+    // Signature footer
+    console.log(`  ${chalk.cyan.bold('friday')} - ${chalk.gray('build once. connect everywhere.')}`);
+    console.log(`  ${chalk.gray('Developed by sabarivasan')}\n`);
+}
+//# sourceMappingURL=startup-animation.js.map

package/dist/cli/ui/startup-animation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-animation.js","sourceRoot":"","sources":["../../../src/cli/ui/startup-animation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAmC,EAAE;IAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;IAEtD,MAAM,KAAK,GAAG;QACZ,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,SAAS,EAAE;QACxD,EAAE,IAAI,EAAE,6BAA6B,EAAE,KAAK,EAAE,SAAS,EAAE;QACzD,EAAE,IAAI,EAAE,qCAAqC,EAAE,KAAK,EAAE,SAAS,EAAE;QACjE,EAAE,IAAI,EAAE,kCAAkC,EAAE,KAAK,EAAE,SAAS,EAAE;QAC9D,EAAE,IAAI,EAAE,6BAA6B,EAAE,KAAK,EAAE,SAAS,EAAE;KAC1D,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAEtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,qCAAqC;QACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,6CAA6C;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,UAAU,GAAG,EAAE,CAAC;YACtB,MAAM,WAAW,GAAG,CAAC,CAAC;YAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;gBACjF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACpD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;YACpD,CAAC;YAED,gCAAgC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAE/F,eAAe;IACf,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEjG,mBAAmB;IACnB,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,EAAE,CAAC,CAAC;IACjG,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fridayy",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "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.
+```