@autofictional/cli 0.1.0

package/README.md

@@ -0,0 +1,56 @@
+# @autofictional/cli
+
+CLI tool to install Autofictional autonomous sidebar adaptation into your React app.
+
+## Installation
+
+From your project directory (frontend or root):
+
+```bash
+node path/to/packages/cli/dist/index.js install
+```
+
+Or if published to npm:
+
+```bash
+npx autofictional
+```
+
+## Requirements
+
+- React 18+
+- Tailwind CSS
+- shadcn Sidebar component (must be installed first)
+
+## What it does
+
+1. Detects your project setup (React, Tailwind, shadcn Sidebar)
+2. Installs `@autofictional/runtime` package
+3. Generates a unique app ID
+4. Patches your main entry file to wrap your app with `<AutofictionalProvider>`
+
+## Safety
+
+- Creates a backup of your main file (`.backup` extension)
+- Exits safely if patching fails
+- Will not install if already installed
+
+## Verification
+
+After installation:
+
+1. Start your dev server: `npm run dev`
+2. Visit `/autofictional-test` to verify the installation
+3. Check for no console errors
+4. Verify `AutofictionalProvider` is mounted
+
+## NIGHT 1 Status
+
+✅ Runtime skeleton installed
+✅ Provider renders children without behavior
+✅ No UI changes yet
+✅ No backend yet
+✅ No sidebar changes yet
+
+This is NIGHT 1 of the MVP - the foundation is in place for autonomous sidebar adaptation.
+

package/dist/commands/install.d.ts

@@ -0,0 +1 @@
+export declare function install(): Promise<void>;

package/dist/commands/install.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.install = install;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const detect_1 = require("../utils/detect");
+const patch_1 = require("../utils/patch");
+const generate_id_1 = require("../utils/generate-id");
+async function install() {
+    console.log(chalk_1.default.bold.blue('\n🚀 Autofictional Installer\n'));
+    const cwd = process.cwd();
+    // Step 1: Detect React + Tailwind
+    console.log(chalk_1.default.dim('→ Detecting project setup...'));
+    const detection = (0, detect_1.detectProject)(cwd);
+    if (!detection.hasReact) {
+        console.error(chalk_1.default.red('✗ React not detected. Autofictional requires React.'));
+        process.exit(1);
+    }
+    if (!detection.hasTailwind) {
+        console.error(chalk_1.default.red('✗ Tailwind CSS not detected. Autofictional requires Tailwind.'));
+        process.exit(1);
+    }
+    if (!detection.hasShadcnSidebar) {
+        console.error(chalk_1.default.red('✗ shadcn Sidebar not detected. Please install it first.'));
+        console.log(chalk_1.default.dim('  Run: npx shadcn@latest add sidebar'));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.green('✓ React detected'));
+    console.log(chalk_1.default.green('✓ Tailwind CSS detected'));
+    console.log(chalk_1.default.green('✓ shadcn Sidebar detected'));
+    // Step 2: Install @autofictional/runtime
+    console.log(chalk_1.default.dim('\n→ Installing @autofictional/runtime...'));
+    try {
+        // Try local package first (for development)
+        const runtimePath = path.resolve(__dirname, '../../../runtime');
+        const packageJsonPath = path.join(cwd, 'package.json');
+        // Check if we're in a monorepo with local packages
+        if (fs.existsSync(runtimePath) && fs.existsSync(packageJsonPath)) {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+            const isMonorepo = packageJson.workspaces || fs.existsSync(path.join(cwd, '..', 'packages'));
+            if (isMonorepo) {
+                // Use npm link for local development
+                console.log(chalk_1.default.dim('  Detected local development - using npm link...'));
+                (0, child_process_1.execSync)('npm link', { cwd: runtimePath, stdio: 'ignore' });
+                (0, child_process_1.execSync)('npm link @autofictional/runtime', { cwd, stdio: 'ignore' });
+                console.log(chalk_1.default.green('✓ Runtime linked (local development)'));
+            }
+            else {
+                // Install from npm
+                console.log(chalk_1.default.dim('  Installing from npm...'));
+                (0, child_process_1.execSync)('npm install @autofictional/runtime', { cwd, stdio: 'inherit' });
+                console.log(chalk_1.default.green('✓ Runtime installed from npm'));
+            }
+        }
+        else {
+            // Install from npm
+            console.log(chalk_1.default.dim('  Installing from npm...'));
+            (0, child_process_1.execSync)('npm install @autofictional/runtime', { cwd, stdio: 'inherit' });
+            console.log(chalk_1.default.green('✓ Runtime installed from npm'));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('✗ Failed to install runtime'));
+        console.error(chalk_1.default.dim('  Try: npm install @autofictional/runtime'));
+        console.error(error);
+        process.exit(1);
+    }
+    // Step 3: Generate app ID
+    const appId = (0, generate_id_1.generateAppId)();
+    console.log(chalk_1.default.dim(`\n→ Generated app ID: ${appId}`));
+    // Step 4: Patch main file
+    console.log(chalk_1.default.dim('\n→ Patching app entry point...'));
+    const mainFile = detection.mainFile;
+    if (!mainFile) {
+        console.error(chalk_1.default.red('✗ Could not find app entry point (main.tsx/main.jsx/index.tsx/index.jsx)'));
+        process.exit(1);
+    }
+    try {
+        (0, patch_1.patchMainFile)(mainFile, appId);
+        console.log(chalk_1.default.green(`✓ Patched ${path.relative(cwd, mainFile)}`));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('✗ Failed to patch main file'));
+        console.error(error);
+        process.exit(1);
+    }
+    // Success
+    console.log(chalk_1.default.bold.green('\n✓ Autofictional installed successfully!\n'));
+    console.log(chalk_1.default.dim('Next steps:'));
+    console.log(chalk_1.default.dim('  1. Start your dev server'));
+    console.log(chalk_1.default.dim('  2. Check console for errors'));
+    console.log(chalk_1.default.dim('  3. Verify AutofictionalProvider is mounted\n'));
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const install_1 = require("./commands/install");
+const program = new commander_1.Command();
+program
+    .name('autofictional')
+    .description('Install Autofictional autonomous sidebar adaptation')
+    .version('0.1.0');
+program
+    .command('install')
+    .description('Install Autofictional runtime into your app')
+    .action(install_1.install);
+// Default to install if no command specified
+if (process.argv.length === 2) {
+    (0, install_1.install)();
+}
+else {
+    program.parse(process.argv);
+}

package/dist/utils/detect.d.ts

@@ -0,0 +1,7 @@
+export interface ProjectDetection {
+    hasReact: boolean;
+    hasTailwind: boolean;
+    hasShadcnSidebar: boolean;
+    mainFile: string | null;
+}
+export declare function detectProject(cwd: string): ProjectDetection;

package/dist/utils/detect.js

@@ -0,0 +1,87 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectProject = detectProject;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function detectProject(cwd) {
+    const detection = {
+        hasReact: false,
+        hasTailwind: false,
+        hasShadcnSidebar: false,
+        mainFile: null,
+    };
+    // Check for package.json and dependencies
+    const packageJsonPath = path.join(cwd, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+        const allDeps = {
+            ...packageJson.dependencies,
+            ...packageJson.devDependencies,
+        };
+        detection.hasReact = 'react' in allDeps;
+        detection.hasTailwind = 'tailwindcss' in allDeps;
+    }
+    // Check for shadcn sidebar component
+    const possibleSidebarPaths = [
+        path.join(cwd, 'src/components/ui/sidebar.tsx'),
+        path.join(cwd, 'components/ui/sidebar.tsx'),
+        path.join(cwd, 'frontend/src/components/ui/sidebar.tsx'),
+    ];
+    for (const sidebarPath of possibleSidebarPaths) {
+        if (fs.existsSync(sidebarPath)) {
+            detection.hasShadcnSidebar = true;
+            break;
+        }
+    }
+    // Find main entry file
+    const possibleMainFiles = [
+        path.join(cwd, 'src/main.tsx'),
+        path.join(cwd, 'src/main.jsx'),
+        path.join(cwd, 'src/index.tsx'),
+        path.join(cwd, 'src/index.jsx'),
+        path.join(cwd, 'frontend/src/main.tsx'),
+        path.join(cwd, 'frontend/src/main.jsx'),
+        path.join(cwd, 'frontend/src/index.tsx'),
+        path.join(cwd, 'frontend/src/index.jsx'),
+    ];
+    for (const mainFile of possibleMainFiles) {
+        if (fs.existsSync(mainFile)) {
+            detection.mainFile = mainFile;
+            break;
+        }
+    }
+    return detection;
+}

package/dist/utils/generate-id.d.ts

@@ -0,0 +1 @@
+export declare function generateAppId(): string;

package/dist/utils/generate-id.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAppId = generateAppId;
+const crypto = __importStar(require("crypto"));
+function generateAppId() {
+    return 'app_' + crypto.randomBytes(16).toString('hex');
+}

package/dist/utils/patch.d.ts

@@ -0,0 +1 @@
+export declare function patchMainFile(mainFilePath: string, appId: string): void;

package/dist/utils/patch.js

@@ -0,0 +1,122 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.patchMainFile = patchMainFile;
+const fs = __importStar(require("fs"));
+function patchMainFile(mainFilePath, appId) {
+    const content = fs.readFileSync(mainFilePath, 'utf-8');
+    // Check if already patched
+    if (content.includes('AutofictionalProvider')) {
+        throw new Error('AutofictionalProvider already exists in main file. Aborting to avoid duplicate installation.');
+    }
+    // Parse the file structure
+    const lines = content.split('\n');
+    // Find import section end
+    let lastImportIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].trim().startsWith('import ')) {
+            lastImportIndex = i;
+        }
+    }
+    // Find ReactDOM.createRoot call
+    let rootCallIndex = -1;
+    let rootCallEndIndex = -1;
+    let indentLevel = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].includes('ReactDOM.createRoot') || lines[i].includes('createRoot')) {
+            rootCallIndex = i;
+            // Find the closing parenthesis of the render call
+            let depth = 0;
+            for (let j = i; j < lines.length; j++) {
+                const line = lines[j];
+                depth += (line.match(/\(/g) || []).length;
+                depth -= (line.match(/\)/g) || []).length;
+                if (depth === 0 && line.includes(')')) {
+                    rootCallEndIndex = j;
+                    break;
+                }
+            }
+            break;
+        }
+    }
+    if (rootCallIndex === -1 || rootCallEndIndex === -1) {
+        throw new Error('Could not find ReactDOM.createRoot call. Manual installation required.');
+    }
+    // Detect indentation
+    const rootLine = lines[rootCallIndex];
+    const indent = rootLine.match(/^(\s*)/)?.[1] || '  ';
+    // Extract the content between <React.StrictMode> tags or the RouterProvider
+    let contentStart = -1;
+    let contentEnd = -1;
+    for (let i = rootCallIndex; i <= rootCallEndIndex; i++) {
+        if (lines[i].includes('<React.StrictMode>') || lines[i].includes('<RouterProvider') || lines[i].includes('<App')) {
+            contentStart = i;
+            break;
+        }
+    }
+    for (let i = rootCallEndIndex; i >= rootCallIndex; i--) {
+        if (lines[i].includes('</React.StrictMode>') || lines[i].includes('/>') || lines[i].includes('</App>')) {
+            contentEnd = i;
+            break;
+        }
+    }
+    if (contentStart === -1 || contentEnd === -1) {
+        throw new Error('Could not parse render content. Manual installation required.');
+    }
+    // Build the new content
+    const newLines = [...lines];
+    // Add import after last import
+    const importLine = `import { AutofictionalProvider } from '@autofictional/runtime';`;
+    newLines.splice(lastImportIndex + 1, 0, importLine);
+    // Adjust indices after insertion
+    contentStart += 1;
+    contentEnd += 1;
+    // Extract the wrapped content
+    const wrappedContent = newLines.slice(contentStart, contentEnd + 1);
+    // Indent the wrapped content
+    const indentedContent = wrappedContent.map(line => indent + '  ' + line.trimStart());
+    // Create the provider wrapper
+    const providerStart = `${indent}  <AutofictionalProvider appId="${appId}">`;
+    const providerEnd = `${indent}  </AutofictionalProvider>`;
+    // Replace the content
+    newLines.splice(contentStart, contentEnd - contentStart + 1, providerStart, ...indentedContent, providerEnd);
+    // Write back
+    const newContent = newLines.join('\n');
+    // Create backup
+    const backupPath = mainFilePath + '.backup';
+    fs.writeFileSync(backupPath, content);
+    // Write new content
+    fs.writeFileSync(mainFilePath, newContent);
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@autofictional/cli",
+  "version": "0.1.0",
+  "description": "CLI tool to install Autofictional runtime",
+  "author": "",
+  "license": "UNLICENSED",
+  "bin": {
+    "autofictional": "./dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/andreamorales/autofictional.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/andreamorales/autofictional#readme",
+  "bugs": {
+    "url": "https://github.com/andreamorales/autofictional/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.0.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.4",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}
+