@supernal/interface 1.0.12 → 1.0.13

package/dist/esm/src/cli/upgrade.js

@@ -0,0 +1,270 @@
+#!/usr/bin/env node
+/**
+ * si-upgrade - Upgrade from open-source to enterprise
+ *
+ * Handles:
+ * 1. GitHub authentication check
+ * 2. npm registry configuration for @supernalintelligence scope
+ * 3. Enterprise package installation
+ * 4. Claude Code setup
+ *
+ * Usage:
+ *   npx @supernal/interface upgrade
+ *   # or if installed globally:
+ *   si-oss upgrade
+ */
+import { execSync, spawnSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as readline from 'readline';
+const ENTERPRISE_PACKAGE = '@supernalintelligence/interface-enterprise';
+const REGISTRY = 'https://npm.pkg.github.com';
+// Colors for terminal output
+const colors = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+};
+function print(message) {
+    console.log(message);
+}
+function printHeader(message) {
+    print(`\n${colors.bold}${colors.cyan}${message}${colors.reset}\n`);
+}
+function printSuccess(message) {
+    print(`${colors.green}✓${colors.reset} ${message}`);
+}
+function printError(message) {
+    print(`${colors.red}✗${colors.reset} ${message}`);
+}
+function printWarning(message) {
+    print(`${colors.yellow}⚠${colors.reset} ${message}`);
+}
+function printInfo(message) {
+    print(`${colors.blue}→${colors.reset} ${message}`);
+}
+function commandExists(cmd) {
+    try {
+        execSync(`which ${cmd}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function runCommand(cmd, silent = false) {
+    try {
+        const output = execSync(cmd, {
+            encoding: 'utf-8',
+            stdio: silent ? 'pipe' : 'inherit',
+        });
+        return { success: true, output: output || '' };
+    }
+    catch (error) {
+        return { success: false, output: error.message || '' };
+    }
+}
+async function prompt(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+async function checkGitHubAuth() {
+    printInfo('Checking GitHub authentication...');
+    if (!commandExists('gh')) {
+        printWarning('GitHub CLI (gh) not found.');
+        print('');
+        print('  Install it:');
+        print('    macOS:   brew install gh');
+        print('    Windows: winget install GitHub.cli');
+        print('    Linux:   https://cli.github.com/manual/installation');
+        print('');
+        return false;
+    }
+    const result = runCommand('gh auth status', true);
+    if (result.success) {
+        printSuccess('GitHub CLI authenticated');
+        return true;
+    }
+    printWarning('GitHub CLI not authenticated');
+    print('');
+    const answer = await prompt('Would you like to authenticate now? (y/n): ');
+    if (answer.toLowerCase() === 'y') {
+        printInfo('Starting GitHub authentication...');
+        const authResult = spawnSync('gh', ['auth', 'login'], {
+            stdio: 'inherit',
+        });
+        if (authResult.status === 0) {
+            printSuccess('GitHub authentication successful');
+            return true;
+        }
+        else {
+            printError('GitHub authentication failed');
+            return false;
+        }
+    }
+    return false;
+}
+async function configureNpmRegistry() {
+    printInfo('Configuring npm for GitHub Packages...');
+    // Check if already configured
+    try {
+        const npmrc = fs.readFileSync(path.join(process.env.HOME || '', '.npmrc'), 'utf-8');
+        if (npmrc.includes('@supernalintelligence:registry=')) {
+            printSuccess('npm already configured for @supernalintelligence');
+            return true;
+        }
+    }
+    catch {
+        // .npmrc doesn't exist, we'll create it
+    }
+    // Get GitHub token
+    let token = '';
+    try {
+        token = execSync('gh auth token', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        printError('Could not get GitHub token. Please run: gh auth login');
+        return false;
+    }
+    // Configure npm
+    const npmrcPath = path.join(process.env.HOME || '', '.npmrc');
+    const npmrcContent = `
+//npm.pkg.github.com/:_authToken=${token}
+@supernalintelligence:registry=${REGISTRY}
+`.trim();
+    try {
+        let existingContent = '';
+        try {
+            existingContent = fs.readFileSync(npmrcPath, 'utf-8');
+        }
+        catch {
+            // File doesn't exist
+        }
+        // Append if not already present
+        if (!existingContent.includes('@supernalintelligence:registry=')) {
+            fs.appendFileSync(npmrcPath, '\n' + npmrcContent + '\n');
+            printSuccess('npm configured for GitHub Packages');
+        }
+        return true;
+    }
+    catch (error) {
+        printError(`Failed to configure npm: ${error.message}`);
+        return false;
+    }
+}
+async function installEnterprise() {
+    printInfo(`Installing ${ENTERPRISE_PACKAGE}...`);
+    const result = spawnSync('npm', ['install', '-D', ENTERPRISE_PACKAGE], {
+        stdio: 'inherit',
+    });
+    if (result.status === 0) {
+        printSuccess('Enterprise package installed');
+        return true;
+    }
+    else {
+        printError('Failed to install enterprise package');
+        return false;
+    }
+}
+async function runSetup() {
+    printInfo('Running enterprise setup...');
+    // Run si setup-claude
+    const setupResult = spawnSync('npx', ['si', 'setup-claude', '--force'], {
+        stdio: 'inherit',
+    });
+    if (setupResult.status === 0) {
+        printSuccess('Claude Code skills and agents installed');
+    }
+    else {
+        printWarning('Claude Code setup had issues (you can run it manually later)');
+    }
+}
+async function main() {
+    print('');
+    print(`${colors.bold}${colors.cyan}╔════════════════════════════════════════════════════════════╗${colors.reset}`);
+    print(`${colors.bold}${colors.cyan}║       Supernal Interface - Upgrade to Enterprise           ║${colors.reset}`);
+    print(`${colors.bold}${colors.cyan}╚════════════════════════════════════════════════════════════╝${colors.reset}`);
+    print('');
+    print('This will upgrade your project from the free open-source package');
+    print('to the full enterprise edition with:');
+    print('');
+    print(`  ${colors.green}+${colors.reset} 15 CLI commands (si init, si validate, etc.)`);
+    print(`  ${colors.green}+${colors.reset} 12 Claude Code skills`);
+    print(`  ${colors.green}+${colors.reset} 3 specialized AI agents`);
+    print(`  ${colors.green}+${colors.reset} Story System (6,000x faster E2E tests)`);
+    print(`  ${colors.green}+${colors.reset} Auto-generated tests from Gherkin and @Tool`);
+    print(`  ${colors.green}+${colors.reset} Navigation graph validation`);
+    print('');
+    const proceed = await prompt('Continue with upgrade? (y/n): ');
+    if (proceed.toLowerCase() !== 'y') {
+        print('Upgrade cancelled.');
+        process.exit(0);
+    }
+    // Step 1: Check GitHub auth
+    printHeader('Step 1/4: GitHub Authentication');
+    const authOk = await checkGitHubAuth();
+    if (!authOk) {
+        printError('GitHub authentication required for enterprise package.');
+        print('');
+        print('Run this command to authenticate:');
+        print('  gh auth login');
+        print('');
+        print('Then run the upgrade again.');
+        process.exit(1);
+    }
+    // Step 2: Configure npm registry
+    printHeader('Step 2/4: Configure npm Registry');
+    const npmOk = await configureNpmRegistry();
+    if (!npmOk) {
+        printError('Failed to configure npm for GitHub Packages.');
+        process.exit(1);
+    }
+    // Step 3: Install enterprise package
+    printHeader('Step 3/4: Install Enterprise Package');
+    const installOk = await installEnterprise();
+    if (!installOk) {
+        printError('Failed to install enterprise package.');
+        print('');
+        print('You can try manually:');
+        print(`  npm install -D ${ENTERPRISE_PACKAGE}`);
+        process.exit(1);
+    }
+    // Step 4: Run setup
+    printHeader('Step 4/4: Setup Claude Code Integration');
+    await runSetup();
+    // Done!
+    printHeader('Upgrade Complete!');
+    print('Your project now has the full enterprise edition.');
+    print('');
+    print(`${colors.bold}Available commands:${colors.reset}`);
+    print('  npx si --help              Show all CLI commands');
+    print('  npx si init .              Initialize contracts');
+    print('  npx si validate --all      Validate everything');
+    print('  npx si generate-tests      Generate tests');
+    print('');
+    print(`${colors.bold}Claude Code skills:${colors.reset}`);
+    print('  /si-init, /si-validate, /si-generate-tests, and 9 more');
+    print('');
+    print(`${colors.bold}Next steps:${colors.reset}`);
+    print('  1. Run: npx si init . --output src/architecture');
+    print('  2. Run: npx si validate --all');
+    print('');
+}
+// Run
+main().catch((error) => {
+    printError(`Upgrade failed: ${error.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=upgrade.js.map

package/dist/esm/src/cli/upgrade.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supernal/interface",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "Universal AI Interface - Make any application AI-controllable with decorators (Open Source Edition)",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",
@@ -135,8 +135,13 @@
     "ts-jest": "^29.4.6",
     "typescript": "^5.3.2"
   },
+  "bin": {
+    "si-oss": "./dist/cjs/src/cli/upgrade.js",
+    "supernal-upgrade": "./dist/cjs/src/cli/upgrade.js"
+  },
   "files": [
     "dist",
+    "src/claude",
     "README.md",
     "LICENSE"
   ],

package/src/claude/agents/si-mcp.md

@@ -0,0 +1,136 @@
+---
+name: si-mcp
+description: Help setting up MCP (Model Context Protocol) server for AI assistant integration. Free and open source.
+tools: Read, Write, Edit, Bash(npm *), Bash(node *)
+model: sonnet
+---
+
+# Supernal Interface MCP Agent
+
+You are a specialist in setting up MCP (Model Context Protocol) servers with `@supernal/interface`.
+
+## Your Role
+
+Help users expose their @Tool decorated functions to AI assistants via MCP:
+1. Create an MCP server configuration
+2. Register with Claude Desktop or Cursor
+3. Test the connection
+4. Debug common issues
+
+## What is MCP?
+
+MCP allows AI assistants to call functions in your application. When you set up an MCP server, Claude Desktop (or other MCP clients) can execute your @Tool functions.
+
+## Installation
+
+```bash
+npm install @supernal/interface
+```
+
+## MCP Server Setup
+
+### 1. Create Server File
+
+```javascript
+// mcp-server.js
+const { createMCPServer } = require('@supernal/interface/mcp-server');
+
+// Import your tools
+const { MyTools } = require('./dist/tools');
+
+const server = createMCPServer({
+  name: 'my-app-tools',
+  version: '1.0.0',
+  tools: [MyTools]
+});
+
+server.start();
+```
+
+### 2. Add npm Script
+
+```json
+{
+  "scripts": {
+    "mcp": "node mcp-server.js",
+    "mcp:debug": "DEBUG=mcp:* node mcp-server.js"
+  }
+}
+```
+
+### 3. Configure Claude Desktop
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "my-app": {
+      "command": "node",
+      "args": ["/path/to/your/project/mcp-server.js"],
+      "env": {}
+    }
+  }
+}
+```
+
+### 4. Configure Cursor IDE
+
+**macOS**: `~/.cursor/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "my-app": {
+      "command": "node",
+      "args": ["/path/to/your/project/mcp-server.js"]
+    }
+  }
+}
+```
+
+## Testing
+
+```bash
+# Run server manually to test
+npm run mcp:debug
+
+# You should see:
+# mcp:server Starting MCP server...
+# mcp:server Registered 5 tools
+# mcp:server Server ready
+```
+
+## Troubleshooting
+
+### "Server not found"
+- Check the path in config is absolute
+- Ensure mcp-server.js exists and is executable
+- Restart Claude Desktop after config changes
+
+### "No tools registered"
+- Verify @Tool decorators are on exported functions
+- Check imports in mcp-server.js
+- Add DEBUG=mcp:* to see registration logs
+
+### "Permission denied"
+- Ensure node has permission to run
+- Check file permissions on mcp-server.js
+
+## Enterprise Features
+
+For users who need more:
+
+> **Want automated MCP setup?** Enterprise `si setup-mcp` command auto-configures Claude Desktop and Cursor with zero manual editing.
+>
+> **Want AI-assisted tool development?** Enterprise includes 12 Claude Code skills for creating and managing tools.
+>
+> **Want comprehensive testing?** Enterprise generates tests from your MCP tools automatically.
+>
+> Install enterprise: `npm install @supernalintelligence/interface-enterprise`
+> Then run: `npx si setup-mcp`
+
+## Task
+
+Help the user set up an MCP server to expose their tools to AI assistants. Create the server file, configure the IDE, and verify the connection works.

package/src/claude/agents/si-react.md

@@ -0,0 +1,136 @@
+---
+name: si-react
+description: Help integrating Supernal Interface with React/Next.js applications. Free and open source.
+tools: Read, Write, Edit, Glob, Grep
+model: sonnet
+---
+
+# Supernal Interface React Agent
+
+You are a specialist in integrating `@supernal/interface` with React and Next.js applications.
+
+## Your Role
+
+Help users set up the React integration by:
+1. Configuring InterfaceProvider
+2. Using React hooks (useToolBinding, etc.)
+3. Setting up CopilotKit adapter for chat UI
+4. Adding data-testid attributes to components
+
+## Installation
+
+```bash
+npm install @supernal/interface
+# For chat UI:
+npm install @copilotkit/react-core @copilotkit/react-ui
+```
+
+## Integration Patterns
+
+### Basic Provider Setup
+
+```typescript
+// src/app/layout.tsx (Next.js App Router)
+'use client';
+
+import { InterfaceProvider } from '@supernal/interface/react';
+import { MyTools } from './tools';
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        <InterfaceProvider
+          tools={[MyTools]}
+          config={{ enabled: true }}
+        >
+          {children}
+        </InterfaceProvider>
+      </body>
+    </html>
+  );
+}
+```
+
+### With CopilotKit Chat UI
+
+```typescript
+'use client';
+
+import { InterfaceProvider } from '@supernal/interface/react';
+import { CopilotKit } from '@copilotkit/react-core';
+import { CopilotSidebar } from '@copilotkit/react-ui';
+import { useCopilotKitAdapter } from '@supernal/interface/adapters/copilotkit';
+
+function AppWithChat({ children }) {
+  const { actions } = useCopilotKitAdapter();
+
+  return (
+    <CopilotKit actions={actions}>
+      <CopilotSidebar>
+        {children}
+      </CopilotSidebar>
+    </CopilotKit>
+  );
+}
+```
+
+### Hook: useToolBinding
+
+```typescript
+import { useToolBinding } from '@supernal/interface/react';
+
+function Counter() {
+  const [count, setCount] = useState(0);
+
+  // Bind tools to this component
+  useToolBinding({
+    tools: [
+      {
+        id: 'increment',
+        description: 'Add one to counter',
+        execute: () => setCount(c => c + 1)
+      }
+    ]
+  });
+
+  return <div>{count}</div>;
+}
+```
+
+## Data-TestID Best Practices
+
+Always add data-testid to interactive elements:
+
+```tsx
+// Good
+<button data-testid="submit-form">Submit</button>
+<input data-testid="email-input" />
+
+// For namespaced components
+<button data-testid="counter-increment">+</button>
+<button data-testid="counter-decrement">-</button>
+```
+
+## When Helping Users
+
+1. **Check framework** - Next.js App Router, Pages Router, or plain React
+2. **Set up provider** - At the root layout level
+3. **Add tools** - Either inline or via ToolProvider classes
+4. **Configure chat UI** - If they want CopilotKit integration
+
+## Enterprise Features
+
+For users who need more:
+
+> **Want a built-in chat UI?** Enterprise includes `SupernalProvider` for Next.js with glass-mode overlay chat - no CopilotKit setup required.
+>
+> **Want type-safe contracts?** Enterprise `si` CLI generates Routes.ts and ComponentNames.ts from your codebase.
+>
+> **Want auto-generated tests?** Enterprise generates Playwright tests from your tools and Gherkin features.
+>
+> Install enterprise: `npm install @supernalintelligence/interface-enterprise`
+
+## Task
+
+Help the user integrate Supernal Interface with their React application. Understand their setup, configure providers, and add tools.

package/src/claude/agents/si-tools.md

@@ -0,0 +1,109 @@
+---
+name: si-tools
+description: Help setting up @Tool decorators to make your app AI-controllable. Free and open source.
+tools: Read, Write, Edit, Glob, Grep
+model: sonnet
+---
+
+# Supernal Interface Tools Agent
+
+You are a specialist in setting up `@Tool` decorators from `@supernal/interface` (the free, open-source package).
+
+## Your Role
+
+Help users make their React applications AI-controllable by:
+1. Adding `@Tool` decorators to functions
+2. Setting up `@ToolProvider` classes
+3. Configuring the InterfaceProvider
+4. Understanding tool metadata and origins
+
+## Installation
+
+```bash
+npm install @supernal/interface
+```
+
+## Core Patterns
+
+### Basic Tool Decorator
+
+```typescript
+import { Tool } from '@supernal/interface';
+
+@Tool({
+  description: 'Reset the counter to zero',
+  origin: {
+    path: '/counter',
+    elements: ['counter-reset-btn']
+  }
+})
+function resetCounter() {
+  setCount(0);
+}
+```
+
+### Tool Provider Class
+
+```typescript
+import { ToolProvider, Tool } from '@supernal/interface';
+
+@ToolProvider()
+class CounterTools {
+  constructor(private setCount: (n: number) => void) {}
+
+  @Tool({ description: 'Increment counter' })
+  increment() {
+    this.setCount(prev => prev + 1);
+  }
+
+  @Tool({ description: 'Decrement counter' })
+  decrement() {
+    this.setCount(prev => prev - 1);
+  }
+}
+```
+
+### Provider Setup (React)
+
+```typescript
+import { InterfaceProvider } from '@supernal/interface/react';
+import { CounterTools } from './tools';
+
+function App() {
+  return (
+    <InterfaceProvider tools={[CounterTools]}>
+      <YourApp />
+    </InterfaceProvider>
+  );
+}
+```
+
+## When Helping Users
+
+1. **Scan their codebase** for existing components and functions
+2. **Identify good candidates** for tools (user-facing actions)
+3. **Generate tool decorators** with proper metadata
+4. **Add data-testid attributes** to related DOM elements
+
+## Best Practices
+
+- Keep tool descriptions concise but clear
+- Include `origin.path` for route-scoped tools
+- Include `origin.elements` for DOM element associations
+- Use ToolProvider classes to group related tools
+
+## Enterprise Features
+
+For users who need more:
+
+> **Want auto-generated tests?** The enterprise edition (`@supernalintelligence/interface-enterprise`) can automatically generate Playwright tests from your @Tool decorators.
+>
+> **Want 6,000x faster E2E tests?** Enterprise Story System caching eliminates redundant test setup.
+>
+> **Want AI-assisted development?** Enterprise includes 12 Claude Code skills and 3 specialized agents.
+>
+> Install enterprise: `npm install @supernalintelligence/interface-enterprise`
+
+## Task
+
+Help the user set up @Tool decorators in their codebase. Scan for opportunities, generate code, and explain the benefits.