@pageai/ralph-loop 1.6.0 → 1.7.0

package/.agent/STEERING.md

@@ -1,6 +1,25 @@
 # **Critical Steering Work**
 
-Go to the source code directory and install dependencies.
+## Ensure the sandbox is running correctly
 
-Check that Playwright is installed, then start the dev server and take a screenshot.
-Save the screenshot to the .agent/screenshots directory.
+This sandbox runs emulated aarch64 Linux. Apply as needed:
+
+- **Node >= 22 (if required):** Install nvm, persist to `/etc/sandbox-persistent.sh` with `unset NPM_CONFIG_PREFIX` before
+the nvm source line. Never add bash_completion to that file.
+
+- **Native binary SIGILL crashes (npm):** `npm install` may produce broken arm64 binaries (esbuild, rollup, tailwindcss oxide, unrs resolver, etc). Fix: `npm pack <pkg>@<same-version>`, extract tarball, copy the binary over the installed one.
+
+- **If using TanStack Start:** Check that `src/integrations/tanstack-query/root-provider.tsx` has a default export
+  wrapping children with `QueryClientProvider`. The starter template ships without it, causing a 500 on load.
+
+- **If using any React-based project:** Install all shadcn/ui components: run npx shadcn@latest add --all in the project root (where components.json exists). Accept all defaults when prompted.
+
+## Main Tasks
+
+Install dependencies, then install Playwright system dependencies: `sudo npx playwright install-deps chromium 2>&1`
+
+Start the dev server and take a screenshot. Save it to the `.agent/screenshots` directory.
+
+---
+
+After you complete this work, exit with message `Steering complete`.

package/.mcp.json

@@ -6,7 +6,10 @@
       "args": [
         "-y",
         "@playwright/mcp@latest",
-        "--headless"
+        "--headless",
+        "--no-sandbox",
+        "--executable-path",
+        "/home/agent/.cache/ms-playwright/chromium-1208/chrome-linux/chrome"
       ],
       "env": {}
     },

package/README.md

@@ -41,7 +41,7 @@ This is an implementation that actually works, containing a hackable script so y
 I recommend using a CLI to bootstrap your project with the necessary tools and dependencies, e.g.:
 
 ```bash
-npx @tanstack/cli create lib --add-ons shadcn,eslint,form,tanstack-query --no-git
+npx @tanstack/cli create lib --add-ons shadcn,eslint,form,tanstack-query --no-git --no-install
 ```
 
 > If you must start from a blank slate, which is not recommended, see [Starting from scratch](#starting-from-scratch). You can also go for a more barebone start by running `npx create-vite@latest src --template react-ts`

package/bin/cli.js

@@ -12,6 +12,7 @@ const { execSync } = require('child_process');
 const display = require('./lib/display');
 const { copyFile, copyDir, mergeDir, exists, ensureDir } = require('./lib/copy');
 const { isGitRepo, initGitRepo } = require('./lib/git');
+const { isShadcnProject, installAllComponents } = require('./lib/shadcn');
 
 const PACKAGE_ROOT = path.resolve(__dirname, '..');
 const TARGET_DIR = process.cwd();
@@ -343,6 +344,16 @@ async function main() {
     }
   }
 
+  // Install all shadcn/ui components if project uses shadcn
+  const appDirPath = path.join(TARGET_DIR, appDir);
+  if (isShadcnProject(appDirPath)) {
+    try {
+      installAllComponents(appDirPath);
+    } catch {
+      // Non-critical — continue setup even if shadcn install fails
+    }
+  }
+
   // Success message
   display.showComplete();
   clack.outro('Happy looping!');

package/bin/lib/shadcn.js

@@ -0,0 +1,44 @@
+/**
+ * shadcn/ui module for Ralph Loop CLI
+ * Detects shadcn config and installs all components
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const { exists } = require('./copy');
+
+const SHADCN_SCHEMA = 'https://ui.shadcn.com/schema.json';
+
+/**
+ * Checks if a directory has a shadcn components.json with the expected schema
+ * @param {string} dir - Directory path to check
+ * @returns {boolean}
+ */
+function isShadcnProject(dir) {
+  const configPath = path.join(dir, 'components.json');
+  if (!exists(configPath)) return false;
+
+  try {
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    return config.$schema === SHADCN_SCHEMA;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Installs all shadcn/ui components in the given directory
+ * @param {string} dir - Directory path to run the install in
+ */
+function installAllComponents(dir) {
+  execSync('npx shadcn@latest add --all --yes 2>&1', {
+    cwd: dir,
+    stdio: 'pipe',
+  });
+}
+
+module.exports = {
+  isShadcnProject,
+  installAllComponents,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pageai/ralph-loop",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "publishConfig": {
     "access": "public"
   },