@papercraneai/cli 1.8.2 → 1.8.3

package/lib/dev-server.js

@@ -257,25 +257,32 @@ export async function resetScaffolding(workspaceDir) {
 /**
  * Generate the project structure inside the workspace.
  * Creates package.json, tsconfig.json, postcss.config.mjs, app/layout.tsx, app/globals.css.
- * Pass { npmInstall: true } to also run npm install if node_modules doesn't exist.
+ *
+ * By default, scaffolding files are always overwritten to ensure stale versions
+ * (e.g. missing @source directive) don't cause broken builds.
+ *
+ * Options:
+ *   npmInstall:   true → run npm install if node_modules doesn't exist
+ *   keepExisting: true → only write files that don't already exist
  */
-export async function generateScaffolding(workspaceDir, { npmInstall = false } = {}) {
+export async function generateScaffolding(workspaceDir, { npmInstall = false, keepExisting = false } = {}) {
   const appDir = path.join(workspaceDir, 'app');
   await fs.mkdir(appDir, { recursive: true });
 
-  // layout.tsx and globals.css in app/
-  const layoutPath = path.join(appDir, 'layout.tsx');
-  const globalsPath = path.join(appDir, 'globals.css');
-
-  try { await fs.access(layoutPath); } catch {
-    await fs.writeFile(layoutPath, LAYOUT_TEMPLATE, 'utf-8');
+  /** Write a file, skipping if keepExisting and file already exists. */
+  async function writeScaffold(filePath, content) {
+    if (keepExisting) {
+      try { await fs.access(filePath); return; } catch {}
+    }
+    await fs.writeFile(filePath, content, 'utf-8');
   }
 
-  try { await fs.access(globalsPath); } catch {
-    await fs.writeFile(globalsPath, GLOBALS_CSS_TEMPLATE, 'utf-8');
-  }
+  // layout.tsx and globals.css in app/
+  await writeScaffold(path.join(appDir, 'layout.tsx'), LAYOUT_TEMPLATE);
+  await writeScaffold(path.join(appDir, 'globals.css'), GLOBALS_CSS_TEMPLATE);
 
   // package.json — @papercraneai/cli brings in next, react, and all dashboard deps
+  // Always keepExisting for package.json — user/system may have added deps.
   const pkgPath = path.join(workspaceDir, 'package.json');
   try { await fs.access(pkgPath); } catch {
     const pkg = {
@@ -288,16 +295,12 @@ export async function generateScaffolding(workspaceDir, { npmInstall = false } =
   }
 
   // .npmrc
-  const npmrcPath = path.join(workspaceDir, '.npmrc');
-  try { await fs.access(npmrcPath); } catch {
-    await fs.writeFile(npmrcPath, [
-      'legacy-peer-deps=true',   // react-simple-maps peer dep compatibility
-      'install-links=true',      // ensures file: deps get transitive deps hoisted
-    ].join('\n') + '\n', 'utf-8');
-  }
+  await writeScaffold(path.join(workspaceDir, '.npmrc'), [
+    'legacy-peer-deps=true',   // react-simple-maps peer dep compatibility
+    'install-links=true',      // ensures file: deps get transitive deps hoisted
+  ].join('\n') + '\n');
 
   // tsconfig.json — path aliases resolve through node_modules/@papercraneai/cli
-  const tsconfigPath = path.join(workspaceDir, 'tsconfig.json');
   const tsconfig = {
     compilerOptions: {
       target: "ES2017",
@@ -323,17 +326,16 @@ export async function generateScaffolding(workspaceDir, { npmInstall = false } =
     include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", "**/*.mts"],
     exclude: ["node_modules"],
   };
-  await fs.writeFile(tsconfigPath, JSON.stringify(tsconfig, null, 2), 'utf-8');
+  await writeScaffold(path.join(workspaceDir, 'tsconfig.json'), JSON.stringify(tsconfig, null, 2));
 
   // postcss.config.mjs — Tailwind compilation
-  await fs.writeFile(path.join(workspaceDir, 'postcss.config.mjs'), POSTCSS_CONFIG, 'utf-8');
+  await writeScaffold(path.join(workspaceDir, 'postcss.config.mjs'), POSTCSS_CONFIG);
 
   // next.config.mjs
   // NOTE: next is pinned to 16.1.7 in package.json. Next.js 16.2.0 introduced
   // a cross-origin HMR block that breaks webpack-hmr over Daytona proxy domains.
   // To upgrade past 16.1.7, add allowedDevOrigins: ['*.daytonaproxy01.net'] to
   // the config below.
-  const nextConfigPath = path.join(workspaceDir, 'next.config.mjs');
   const nextConfig = `/** @type {import('next').NextConfig} */
 const nextConfig = {
   transpilePackages: ['@papercraneai/cli', '@papercrane/dashboard-grid'],
@@ -346,7 +348,7 @@ const nextConfig = {
 };
 export default nextConfig;
 `;
-  await fs.writeFile(nextConfigPath, nextConfig, 'utf-8');
+  await writeScaffold(path.join(workspaceDir, 'next.config.mjs'), nextConfig);
 
   // npm install — only when explicitly requested and node_modules doesn't exist
   if (npmInstall) {

package/package.json

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