@papercraneai/cli 1.7.1 → 1.8.0

package/bin/papercrane.js

@@ -51,7 +51,23 @@ async function showPostLoginHelp() {
 
       const workspaceDir = getLocalWorkspacePath(ws.id);
       const { generateScaffolding } = await import('../lib/dev-server.js');
-      await generateScaffolding(workspaceDir);
+
+      // Check if we can reuse the pre-scaffolded default workspace
+      let didSymlink = false;
+      try {
+        await fs.access(workspaceDir);
+        // Workspace dir already exists — normal path
+      } catch {
+        if (await isDefaultScaffoldAvailable()) {
+          await fs.mkdir(path.dirname(workspaceDir), { recursive: true });
+          await fs.symlink(DEFAULT_SCAFFOLD_DIR, workspaceDir);
+          didSymlink = true;
+        }
+      }
+
+      if (!didSymlink) {
+        await generateScaffolding(workspaceDir);
+      }
 
       const currentLink = path.join(os.homedir(), '.papercrane', 'current');
       try {
@@ -132,6 +148,39 @@ import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
 
+const DEFAULT_SCAFFOLD_DIR = path.join(os.homedir(), '.papercrane', 'workspaces', 'default');
+
+/**
+ * Check if the pre-scaffolded default workspace is available for symlink reuse.
+ * Returns true only if default/ has been scaffolded AND no other workspace already
+ * symlinks to it.
+ */
+async function isDefaultScaffoldAvailable() {
+  try {
+    await fs.access(path.join(DEFAULT_SCAFFOLD_DIR, 'package.json'));
+  } catch {
+    return false;
+  }
+  // Check if any existing workspace already claims default/
+  const workspacesDir = path.join(os.homedir(), '.papercrane', 'workspaces');
+  try {
+    const entries = await fs.readdir(workspacesDir);
+    for (const entry of entries) {
+      if (entry === 'default') continue;
+      const entryPath = path.join(workspacesDir, entry);
+      try {
+        const target = await fs.readlink(entryPath);
+        if (target === DEFAULT_SCAFFOLD_DIR) return false;
+      } catch {
+        // Not a symlink — ignore
+      }
+    }
+  } catch {
+    // workspaces dir doesn't exist yet — that's fine
+  }
+  return true;
+}
+
 /**
  * Run the browser-based auth flow (init session, open browser or print URL, poll for result).
  * @param {Object} options
@@ -387,6 +436,45 @@ program
     }
   });
 
+// ============================================================================
+// SCAFFOLD COMMAND
+// ============================================================================
+
+program
+  .command('scaffold')
+  .description('Pre-scaffold a workspace directory (no login required)')
+  .option('--dir <path>', 'Directory to scaffold', DEFAULT_SCAFFOLD_DIR)
+  .option('--npm-install', 'Run npm install after scaffolding')
+  .action(async (options) => {
+    try {
+      const dir = options.dir;
+      console.log(chalk.cyan(`Scaffolding workspace in ${dir}...`));
+
+      const { generateScaffolding } = await import('../lib/dev-server.js');
+      await generateScaffolding(dir, { skipInstall: !options.npmInstall });
+
+      // Set ~/.papercrane/current symlink → scaffolded dir
+      const currentLink = path.join(os.homedir(), '.papercrane', 'current');
+      try {
+        const existing = await fs.readlink(currentLink);
+        if (existing !== dir) {
+          await fs.unlink(currentLink);
+          await fs.symlink(dir, currentLink);
+        }
+      } catch {
+        try { await fs.unlink(currentLink); } catch {}
+        await fs.symlink(dir, currentLink);
+      }
+
+      console.log(chalk.green(`\n✓ Scaffolded workspace`));
+      console.log(chalk.dim(`  ${currentLink} → ${dir}`));
+      console.log(chalk.dim(`  Dashboards: ${dir}/app/\n`));
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
 // ============================================================================
 // FUNCTION COMMANDS
 // ============================================================================
@@ -755,7 +843,6 @@ workspacesCmd
 
       await setDefaultWorkspace(wsId);
 
-      // Scaffold the workspace and create ~/.papercrane/current symlink
       const { generateScaffolding, resetScaffolding } = await import('../lib/dev-server.js');
       const workspaceDir = getLocalWorkspacePath(wsId);
 
@@ -764,8 +851,27 @@ workspacesCmd
         await fs.rm(path.join(workspaceDir, '.next'), { recursive: true, force: true });
         console.log(chalk.dim('Scaffolding regenerated.'));
       }
-      await generateScaffolding(workspaceDir);
 
+      // Check if we can reuse the pre-scaffolded default workspace
+      let didSymlink = false;
+      try {
+        await fs.access(workspaceDir);
+        // Workspace dir already exists — normal path
+      } catch {
+        // Workspace dir doesn't exist yet — check for pre-scaffolded default
+        if (await isDefaultScaffoldAvailable()) {
+          await fs.mkdir(path.dirname(workspaceDir), { recursive: true });
+          await fs.symlink(DEFAULT_SCAFFOLD_DIR, workspaceDir);
+          didSymlink = true;
+          console.log(chalk.dim('Reusing pre-scaffolded workspace (symlink).'));
+        }
+      }
+
+      if (!didSymlink) {
+        await generateScaffolding(workspaceDir);
+      }
+
+      // Update ~/.papercrane/current symlink
       const currentLink = path.join(os.homedir(), '.papercrane', 'current');
       try {
         const existing = await fs.readlink(currentLink);
@@ -795,16 +901,33 @@ workspacesCmd
 program
   .command('dev')
   .description('Start local dev server for dashboard development with HMR')
-  .option('-w, --workspace <id>', 'Workspace ID')
+  .option('-w, --workspace <id>', 'Workspace ID (resolves to workspaces/<id>/ instead of current)')
   .option('-p, --port <port>', 'Port (default: 3100)', '3100')
+  .option('--npm-install', 'Force run npm install before starting')
   .option('--clear-cache', 'Clear build cache before starting (use after structural changes like editing globals.css or adding dependencies)')
   .option('--reset-scaffolding', 'Regenerate scaffolding files (layout.tsx, globals.css, configs) and clear build cache')
   .action(async (options) => {
     try {
       const { generateScaffolding, resetScaffolding, startDevServer } = await import('../lib/dev-server.js');
+      const { execSync } = await import('child_process');
 
-      const wsId = options.workspace ? parseInt(options.workspace, 10) : await requireWorkspace();
-      const workspaceDir = getLocalWorkspacePath(wsId);
+      let workspaceDir;
+      if (options.workspace) {
+        workspaceDir = getLocalWorkspacePath(parseInt(options.workspace, 10));
+      } else {
+        // Resolve from ~/.papercrane/current symlink (no login required)
+        const currentLink = path.join(os.homedir(), '.papercrane', 'current');
+        try {
+          await fs.readlink(currentLink);
+          workspaceDir = currentLink;
+        } catch {
+          console.error(chalk.red('No workspace set up.'));
+          console.error(chalk.dim('\nRun one of:'));
+          console.error(chalk.dim('  papercrane scaffold             # Pre-scaffold without login'));
+          console.error(chalk.dim('  papercrane workspaces use <id>  # Set active workspace'));
+          process.exit(1);
+        }
+      }
 
       if (options.resetScaffolding) {
         await resetScaffolding(workspaceDir);
@@ -817,7 +940,21 @@ program
         console.log(chalk.dim('Build cache cleared.'));
       }
 
-      await generateScaffolding(workspaceDir);
+      await generateScaffolding(workspaceDir, { skipInstall: true });
+
+      // npm install — dev server won't work without node_modules
+      const nmDir = path.join(workspaceDir, 'node_modules');
+      if (options.npmInstall) {
+        console.log(chalk.dim('Running npm install...'));
+        execSync('npm install --prefer-offline', { cwd: workspaceDir, stdio: 'inherit' });
+      } else {
+        try {
+          await fs.access(nmDir);
+        } catch {
+          console.log(chalk.dim('node_modules not found, running npm install...'));
+          execSync('npm install --prefer-offline', { cwd: workspaceDir, stdio: 'inherit' });
+        }
+      }
 
       const port = parseInt(options.port, 10);
       const dashboardDir = workspaceDir + '/app';
@@ -933,6 +1070,7 @@ program.action(async (_, cmd) => {
     console.error('  papercrane call <path> [json]   Call an endpoint');
     console.error('  papercrane add                  Add a new integration');
     console.error('  papercrane dashboard-guide      Show how to build dashboards');
+    console.error('  papercrane scaffold             Pre-scaffold workspace (no login required)');
     console.error('  papercrane workspaces list      List workspaces');
     console.error('  papercrane workspaces use <id>  Set default workspace');
     console.error('  papercrane dev                  Start local dev server with HMR');

package/lib/dev-server.js

@@ -259,7 +259,7 @@ export async function resetScaffolding(workspaceDir) {
  * Creates package.json, tsconfig.json, postcss.config.mjs, app/layout.tsx, app/globals.css.
  * Runs npm install if node_modules doesn't exist.
  */
-export async function generateScaffolding(workspaceDir) {
+export async function generateScaffolding(workspaceDir, { skipInstall = false } = {}) {
   const appDir = path.join(workspaceDir, 'app');
   await fs.mkdir(appDir, { recursive: true });
 
@@ -346,10 +346,12 @@ export default nextConfig;
   await fs.writeFile(nextConfigPath, nextConfig, 'utf-8');
 
   // npm install — only if node_modules doesn't exist yet
-  const nmDir = path.join(workspaceDir, 'node_modules');
-  if (!fsSync.existsSync(nmDir)) {
-    console.log('Installing dependencies...');
-    execSync('npm install --prefer-offline', { cwd: workspaceDir, stdio: 'inherit' });
+  if (!skipInstall) {
+    const nmDir = path.join(workspaceDir, 'node_modules');
+    if (!fsSync.existsSync(nmDir)) {
+      console.log('Installing dependencies...');
+      execSync('npm install --prefer-offline', { cwd: workspaceDir, stdio: 'inherit' });
+    }
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@papercraneai/cli",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "description": "CLI tool for managing OAuth credentials for LLM integrations",
   "main": "index.js",
   "type": "module",