@pageai/ralph-loop 1.4.0 → 1.6.0

package/.agent/STEERING.md

@@ -2,4 +2,5 @@
 
 Go to the source code directory and install dependencies.
 
-Check that Playwright is running by starting the dev server and taking a screenshot. Save the screenshot to the .agent/screenshots directory.
+Check that Playwright is installed, then start the dev server and take a screenshot.
+Save the screenshot to the .agent/screenshots directory.

package/README.md

@@ -41,12 +41,10 @@ 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 create-vite@latest src --template react-ts
-# or
-npx create-next-app@latest src
+npx @tanstack/cli create lib --add-ons shadcn,eslint,form,tanstack-query --no-git
 ```
 
-> If you must start from a blank slate, which is not recommended, see [Starting from scratch](#starting-from-scratch).
+> 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`
 
 ### 1️⃣ Step 1: Install Ralph
 
@@ -64,7 +62,7 @@ Open up Claude Code and prompt it with **your requirements**. Like so:
 ```
 Use the prd-creator skill to help me create a PRD and task list for the below requirements.
 
-An app is already set up with Next.js, Tailwind CSS and TypeScript.
+An app is already set up with React, Tailwind CSS and TypeScript.
 
 Requirements:
 
@@ -353,14 +351,14 @@ import '@testing-library/jest-dom/vitest'
 import { vi } from 'vitest'
 import React from 'react'
 
-// Mock next/image
+// If using Next.js, mock next/image
 vi.mock('next/image', () => ({
   default: ({ src, alt, ...props }: { src: string; alt: string }) => {
     return React.createElement('img', { src, alt, ...props })
   },
 }))
 
-// Mock next/link
+// If using Next.js, mock next/link
 vi.mock('next/link', () => ({
   default: ({
     children,
@@ -383,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
 ```
@@ -395,7 +393,7 @@ See more in [Docker's docs](https://docs.docker.com/ai/sandboxes/migration/).
 
 For AI to actually verify its implementation and for the loop to work, you need a way to verify it.
 
-To that end, at the minimum you need an end-to-end test framework and a unit test framework.
+To that end, at the minimum you'll need an end-to-end test framework and a unit test framework.
 
 For example, you can use the following commands to install Playwright and Vitest:
 

package/bin/cli.js

@@ -11,10 +11,11 @@ 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 PACKAGE_ROOT = path.resolve(__dirname, '..');
 const TARGET_DIR = process.cwd();
-const DEFAULT_APP_DIR = 'src';
+const DEFAULT_APP_DIR = 'lib';
 
 // Directories to ensure exist (created even if source doesn't exist)
 const DIRS_TO_ENSURE = [
@@ -104,7 +105,7 @@ async function main() {
 
   // Prompt 1 — App source directory
   const appDir = await clack.text({
-    message: 'Where does your app source code live? (e.g. src, public, etc.)',
+    message: 'Where does your app source code live? (e.g. lib, app, src, public, etc.)',
     placeholder: DEFAULT_APP_DIR,
     defaultValue: DEFAULT_APP_DIR,
   });
@@ -150,6 +151,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) {

package/bin/lib/display.js

@@ -96,7 +96,7 @@ ${G}  ✓ Ralph Loop setup complete!${R}
 ${D}═══════════════════════════════════════════════════════════${R}
 
 ${Y}Next steps:${R}
-  ${C}1.${R} Review the copied files
+  ${C}1.${R} Log in to your CLI agent with ${G}docker sandbox run claude .${R}
   ${C}2.${R} Create a PRD using the ${G}prd-creator${R} skill
   ${C}3.${R} Run ${G}./ralph.sh${R} to start the loop
 

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/package.json

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