@shaykec/claude-teach 0.2.0 → 0.4.0

package/src/cli.js

@@ -2,9 +2,10 @@
 
 import { Command } from 'commander';
 import { readFileSync, existsSync } from 'fs';
-import { resolve, join } from 'path';
+import { resolve, join, dirname } from 'path';
 import { fileURLToPath } from 'url';
-import { dirname } from 'path';
+import { exec, spawn, execFileSync as execFileSyncChild } from 'child_process';
+import { createRequire } from 'module';
 import chalk from 'chalk';
 import { buildRegistry, loadRegistry, getModule } from './registry.js';
 import { loadProgress, saveProgress, getStats } from './progress.js';
@@ -14,6 +15,73 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const ROOT = resolve(__dirname, '..', '..', '..');
 
+// =====================================================================
+//  Helpers — plugin, extension, and Claude Code resolution
+// =====================================================================
+
+const require_ = createRequire(import.meta.url);
+
+/** Resolve the Claude Code plugin directory. */
+function resolvePluginDir() {
+  // Strategy 1: monorepo layout
+  const monoRepo = join(ROOT, 'packages', 'plugin');
+  if (existsSync(join(monoRepo, '.claude-plugin', 'plugin.json'))) return monoRepo;
+  // Strategy 2: resolve installed @shaykec/plugin package
+  try {
+    const pkgPath = require_.resolve('@shaykec/plugin/package.json');
+    const dir = dirname(pkgPath);
+    if (existsSync(join(dir, '.claude-plugin', 'plugin.json'))) return dir;
+  } catch { /* not installed */ }
+  return null;
+}
+
+/** Resolve the Chrome extension directory. */
+function resolveExtensionDir() {
+  const monoRepo = join(ROOT, 'packages', 'extension');
+  if (existsSync(join(monoRepo, 'manifest.json'))) return monoRepo;
+  try {
+    const pkgPath = require_.resolve('@shaykec/extension/package.json');
+    const dir = dirname(pkgPath);
+    if (existsSync(join(dir, 'manifest.json'))) return dir;
+  } catch { /* not installed */ }
+  return null;
+}
+
+/** Check if the `claude` CLI is available on PATH. */
+function findClaude() {
+  try {
+    const version = execFileSyncChild('claude', ['--version'], {
+      stdio: 'pipe', encoding: 'utf-8',
+    }).trim();
+    return { found: true, version };
+  } catch {
+    return { found: false, version: null };
+  }
+}
+
+/** Open the extension folder + chrome://extensions page (cross-platform). */
+function openExtensionInstall(extensionDir) {
+  const platform = process.platform;
+  if (platform === 'darwin') {
+    exec(`open "${extensionDir}"`);
+    exec('open -a "Google Chrome" "chrome://extensions"');
+  } else if (platform === 'linux') {
+    exec(`xdg-open "${extensionDir}"`);
+    exec('google-chrome "chrome://extensions" 2>/dev/null || chromium-browser "chrome://extensions" 2>/dev/null');
+  } else if (platform === 'win32') {
+    exec(`explorer "${extensionDir}"`);
+    exec('start chrome "chrome://extensions"');
+  }
+}
+
+/** Open a URL in the default browser (cross-platform). */
+function openUrl(url) {
+  const platform = process.platform;
+  if (platform === 'darwin') exec(`open "${url}"`);
+  else if (platform === 'linux') exec(`xdg-open "${url}"`);
+  else if (platform === 'win32') exec(`start "" "${url}"`);
+}
+
 const program = new Command();
 
 const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8'));
@@ -36,6 +104,10 @@ Examples:
   $ claude-teach search docker                  Search registries for packs
   $ claude-teach author init my-pack            Scaffold a new module pack
   $ claude-teach author validate ./my-pack      Validate a pack
+  $ claude-teach start                          Launch Claude Code with teaching skills
+  $ claude-teach start -p "teach me git"        One-shot teaching prompt
+  $ claude-teach setup                          Check environment and plugin path
+  $ claude-teach setup --extension              Install the Chrome extension
   $ claude-teach serve                          Start the bridge server for visuals`)
   .version(pkg.version);
 
@@ -218,6 +290,138 @@ program
     showInbox();
   });
 
+// =====================================================================
+//  Plugin integration commands — launch Claude Code, setup environment
+// =====================================================================
+
+// --- start ---
+program
+  .command('start')
+  .description('Launch Claude Code with ClaudeTeach — starts bridge server + loads teaching skills')
+  .option('--no-server', 'Skip starting the bridge server')
+  .option('--port <port>', 'Bridge server port', '3456')
+  .allowUnknownOption(true)
+  .action(async (opts, cmd) => {
+    // 1. Resolve plugin
+    const pluginDir = resolvePluginDir();
+    if (!pluginDir) {
+      console.error(chalk.red('Could not find the ClaudeTeach plugin directory.'));
+      console.error('Make sure @shaykec/plugin is installed or you are in the ClaudeTeach repo.');
+      process.exit(1);
+    }
+
+    // 2. Check claude
+    const claude = findClaude();
+    if (!claude.found) {
+      console.error(chalk.red('Claude Code CLI not found.'));
+      console.error('Install it from: https://claude.ai/download');
+      process.exit(1);
+    }
+
+    // 3. Start bridge server (unless --no-server)
+    let server;
+    if (opts.server !== false) {
+      try {
+        const { startServer } = await import('@shaykec/bridge');
+        server = startServer({
+          port: parseInt(opts.port, 10),
+          progressProvider: { getProgress: () => loadProgress(ROOT) },
+        });
+        console.log(chalk.dim(`  Bridge server on port ${opts.port}`));
+      } catch (err) {
+        console.warn(chalk.yellow(`  Bridge server failed to start: ${err.message}`));
+      }
+    }
+
+    // 4. Launch
+    console.log(chalk.green('Launching Claude Code with ClaudeTeach...'));
+    console.log(chalk.dim(`  Plugin: ${pluginDir}`));
+
+    const claudeArgs = ['--plugin-dir', pluginDir, ...cmd.args];
+    const child = spawn('claude', claudeArgs, { stdio: 'inherit' });
+
+    child.on('error', (err) => {
+      console.error(chalk.red(`Failed to start Claude Code: ${err.message}`));
+      if (server) server.close();
+      process.exit(1);
+    });
+
+    child.on('close', (code) => {
+      if (server) server.close();
+      process.exit(code ?? 0);
+    });
+  });
+
+// --- setup ---
+program
+  .command('setup')
+  .description('Check environment, show plugin status, and install Chrome extension')
+  .option('--show-path', 'Print only the plugin directory path')
+  .option('--extension', 'Open Chrome to install the ClaudeTeach extension')
+  .action(async (opts) => {
+    const pluginDir = resolvePluginDir();
+    const extensionDir = resolveExtensionDir();
+
+    // --show-path: machine-readable plugin path
+    if (opts.showPath) {
+      if (!pluginDir) process.exit(1);
+      console.log(pluginDir);
+      return;
+    }
+
+    // --extension: open Finder + Chrome extensions page
+    if (opts.extension) {
+      if (!extensionDir) {
+        console.error(chalk.red('Could not find the ClaudeTeach extension directory.'));
+        process.exit(1);
+      }
+      openExtensionInstall(extensionDir);
+      console.log(chalk.green('\nChrome Extensions page + extension folder opened.'));
+      console.log(`\n  1. Enable ${chalk.cyan('Developer mode')} (toggle, top-right)`);
+      console.log(`  2. Click ${chalk.cyan('Load unpacked')}`);
+      console.log(`  3. Select the folder that just opened: ${chalk.cyan(extensionDir)}`);
+      return;
+    }
+
+    // Default: full setup — checklist + welcome page
+    const claude = findClaude();
+
+    console.log(chalk.bold('\n  ClaudeTeach Setup\n'));
+    console.log(`  Plugin path:    ${pluginDir ? chalk.green(pluginDir) : chalk.red('not found')}`);
+    console.log(`  Extension path: ${extensionDir ? chalk.green(extensionDir) : chalk.red('not found')}`);
+    console.log(`  Claude Code:    ${claude.found ? chalk.green(claude.version) : chalk.red('not installed')}`);
+
+    if (!pluginDir) {
+      console.error(chalk.red('\n  Plugin not found. Make sure @shaykec/plugin is installed.'));
+      process.exit(1);
+    }
+
+    if (!claude.found) {
+      console.log(chalk.yellow('\n  Claude Code not found. Install from: https://claude.ai/download'));
+    }
+
+    // Start bridge + open welcome page
+    let server;
+    try {
+      const { startServer } = await import('@shaykec/bridge');
+      const port = 3456;
+      server = startServer({
+        port,
+        progressProvider: { getProgress: () => loadProgress(ROOT) },
+      });
+      console.log(chalk.dim(`\n  Bridge server started on port ${port}`));
+      openUrl(`http://localhost:${port}/?mode=welcome`);
+      console.log(chalk.green('  Welcome page opened in your browser.'));
+    } catch (err) {
+      console.warn(chalk.yellow(`\n  Could not start bridge server: ${err.message}`));
+    }
+
+    console.log(chalk.bold('\n  Next steps:\n'));
+    console.log(`  ${chalk.cyan('claude-teach start')}               Launch Claude Code with teaching skills`);
+    console.log(`  ${chalk.cyan('claude-teach setup --extension')}    Install the Chrome extension`);
+    console.log();
+  });
+
 // =====================================================================
 //  System commands
 // =====================================================================