@pageai/ralph-loop 1.5.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
+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`
@@ -381,7 +381,7 @@ Check the `ralph.sh` script around `# This is the main command loop.` for the ma
 
 Replace `docker sandbox run claude . --` with the your favorite CLI. Remember to also update the options after the `--`.
 
-```
+```bash
 docker sandbox run codex . # for Codex CLI
 docker sandbox run gemini . # for Gemini CLI
 ```

package/bin/cli.js

@@ -11,6 +11,8 @@ const path = require('path');
 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();
@@ -150,6 +152,15 @@ async function main() {
 
   display.printLocation(TARGET_DIR);
 
+  // Initialize git repository if not present
+  if (!isGitRepo(TARGET_DIR)) {
+    try {
+      initGitRepo(TARGET_DIR);
+    } catch {
+      // Non-critical — continue setup even if git init fails
+    }
+  }
+
   // Copy individual files
   display.printStep('📄', 'Core files');
   for (const file of FILES_TO_COPY) {
@@ -333,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/git.js

@@ -0,0 +1,30 @@
+/**
+ * Git module for Ralph Loop CLI
+ * Handles git repository initialization in the target directory
+ */
+
+const path = require('path');
+const { execSync } = require('child_process');
+const { exists } = require('./copy');
+
+/**
+ * Checks if a directory is inside a git repository
+ * @param {string} dir - Directory path to check
+ * @returns {boolean}
+ */
+function isGitRepo(dir) {
+  return exists(path.join(dir, '.git'));
+}
+
+/**
+ * Initializes a new git repository in the given directory
+ * @param {string} dir - Directory path to initialize
+ */
+function initGitRepo(dir) {
+  execSync('git init', { cwd: dir, stdio: 'pipe' });
+}
+
+module.exports = {
+  isGitRepo,
+  initGitRepo,
+};

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.5.0",
+  "version": "1.7.0",
   "publishConfig": {
     "access": "public"
   },