@autoship/react 0.1.0 → 0.3.0

package/dist/README.md

@@ -0,0 +1,166 @@
+# Autoship
+
+A drop-in autonomous coding agent that records tasks in your app and implements them in a Github Action.
+
+## How It Works
+
+1. Users submit tasks via React components (or directly via Supabase)
+2. A GitHub Action wakes up periodically and runs Claude Code
+3. Claude picks up the highest priority task, implements it, and creates a PR
+4. If Claude needs clarification, it asks a question and blocks the task until you answer
+5. You review the PR and merge
+
+## Packages
+
+- **`@autoship/react`** - React components and CLI for task submission
+- **`mcp-servers/autoship-mcp`** - MCP server for Claude Code integration
+
+## Quick Start
+
+### 1. Create Supabase Project
+
+Create a new Supabase project (or use an existing one). Get the SUPABASE_URL and your database password.
+
+### 2. Set Up Supabase Database
+
+Run the migrations using the CLI:
+
+```bash
+npx @autoship init
+```
+
+The CLI will prompt you for credentials. You can provide them in two ways:
+
+**Option A: Full DATABASE_URL**
+
+```bash
+# Find this in Supabase Dashboard > Project Settings > Database > Connection string > URI
+npx @autoship init --database-url "postgresql://postgres.xxx:password@aws-0-region.pooler.supabase.com:6543/postgres"
+```
+
+**Option B: Supabase URL + Database Password**
+
+```bash
+npx @autoship init --supabase-url https://xxx.supabase.co --db-password yourpassword
+```
+
+**Using environment variables:**
+
+```bash
+# Option A
+DATABASE_URL="postgresql://..." npx @autoship init
+
+# Option B
+SUPABASE_URL="https://xxx.supabase.co" DB_PASSWORD="yourpassword" npx @autoship/react init
+```
+
+### 3. Add React Components (Optional)
+
+Install the package:
+
+```bash
+npm install @autoship/react
+```
+
+Add the provider and button to your app:
+
+```tsx
+import { AutoshipProvider, AutoshipButton } from "@autoship/react";
+
+function App() {
+  return (
+    <AutoshipProvider
+      supabaseUrl={process.env.SUPABASE_URL}
+      supabaseAnonKey={process.env.SUPABASE_ANON_KEY}
+      userId="optional-user-id"
+    >
+      <YourApp />
+      <AutoshipButton />
+    </AutoshipProvider>
+  );
+}
+```
+
+Available components:
+
+- `AutoshipProvider` - Context provider for Supabase connection
+- `AutoshipButton` - Floating button to open task submission dialog
+- `TaskDialog` - Modal for submitting new tasks
+- `TaskList` - List of submitted tasks with status
+- `TaskDetailDialog` - View task details and answer questions
+- `QuestionDialog` - Answer clarifying questions from Claude
+
+### 4. Set Up GitHub Actions
+
+Copy these files into your project:
+
+```
+mcp-servers/autoship-mcp/  # The MCP server
+.mcp.json                  # MCP configuration
+.github/workflows/claude-agent.yml  # GitHub Actions workflow
+```
+
+Add GitHub Secrets (Settings > Secrets and variables > Actions):
+
+| Secret                 | Description                                                 |
+| ---------------------- | ----------------------------------------------------------- |
+| `ANTHROPIC_API_KEY`    | Your Anthropic API key                                      |
+| `SUPABASE_URL`         | Your Supabase project URL (e.g., `https://xxx.supabase.co`) |
+| `SUPABASE_SERVICE_KEY` | Supabase service role key (not the anon key)                |
+
+### 5. Test Locally (Optional)
+
+Build the MCP server:
+
+```bash
+cd mcp-servers/autoship-mcp && npm install && npm run build
+```
+
+```bash
+# Set environment variables
+export SUPABASE_URL="https://your-project.supabase.co"
+export SUPABASE_SERVICE_KEY="your-service-key"
+
+# Test the MCP tools
+claude "Use the autoship-mcp tools to list pending tasks"
+```
+
+## Manual Trigger
+
+You can manually trigger the agent from the GitHub Actions tab, optionally with a custom prompt:
+
+1. Go to Actions > Claude Agent
+2. Click "Run workflow"
+3. Optionally enter a custom prompt
+4. Click "Run workflow"
+
+## Monitoring
+
+### GitHub Actions Logs
+
+Check the Actions tab in your repository to see Claude's output for each run.
+
+## Available MCP Tools
+
+| Tool                       | Description                                          |
+| -------------------------- | ---------------------------------------------------- |
+| `list_pending_tasks`       | List all pending tasks by priority                   |
+| `get_task`                 | Get full details including categories and questions  |
+| `claim_task`               | Mark a task as in_progress                           |
+| `complete_task`            | Mark as complete with branch name                    |
+| `fail_task`                | Mark as failed with error message                    |
+| `add_task`                 | Create new tasks                                     |
+| `list_categories`          | List all categories                                  |
+| `create_category`          | Create a new category                                |
+| `assign_category`          | Tag a task with a category                           |
+| `ask_question`             | Ask a clarifying question (marks task as needs_info) |
+| `get_unanswered_questions` | List all unanswered questions                        |
+| `check_answered_questions` | Check answers for a specific task                    |
+| `resume_task`              | Move a needs_info task back to pending               |
+
+## Cost Estimation
+
+- Each run uses API tokens based on context length and task complexity
+- A typical task costs $0.10-$1.00
+- With 4 runs/day, expect ~$10-30/month (varies by task complexity)
+- Monitor usage at console.anthropic.com

package/dist/cli/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAgTA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AA6WA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvD"}

package/dist/cli/init.js

@@ -1,4 +1,4 @@
-import { createClient } from "@supabase/supabase-js";
+import postgres from "postgres";
 import * as fs from "fs";
 import * as path from "path";
 import * as readline from "readline";
@@ -32,11 +32,14 @@ function parseArgs(args) {
     const options = {};
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
-        if (arg === "--db-url" && args[i + 1]) {
+        if (arg === "--database-url" && args[i + 1]) {
+            options.databaseUrl = args[++i];
+        }
+        else if (arg === "--supabase-url" && args[i + 1]) {
             options.supabaseUrl = args[++i];
         }
-        else if (arg === "--service-key" && args[i + 1]) {
-            options.supabaseServiceKey = args[++i];
+        else if (arg === "--db-password" && args[i + 1]) {
+            options.dbPassword = args[++i];
         }
         else if (arg === "--non-interactive" || arg === "-y") {
             options.nonInteractive = true;
@@ -56,24 +59,36 @@ Usage:
   npx autoship init [options]
 
 Options:
-  --db-url <url>        Supabase project URL
-  --service-key <key>   Supabase service role key
+  --database-url <url>  Full PostgreSQL connection URL (includes password)
+  --supabase-url <url>  Supabase project URL (used to construct DATABASE_URL)
+  --db-password <pwd>   Database password (used with --supabase-url)
   -y, --non-interactive Skip confirmation prompts
   -h, --help            Show this help message
 
 Environment Variables:
-  SUPABASE_URL          Supabase project URL (fallback)
-  SUPABASE_SERVICE_KEY  Supabase service role key (fallback)
+  DATABASE_URL          Full PostgreSQL connection URL (preferred)
+  SUPABASE_URL          Supabase project URL (fallback, requires DB_PASSWORD)
+  DB_PASSWORD           Database password (used with SUPABASE_URL)
+
+Connection Methods:
+  1. Provide DATABASE_URL directly (recommended):
+     DATABASE_URL=postgresql://postgres.xxx:[password]@aws-0-region.pooler.supabase.com:6543/postgres
+
+  2. Provide SUPABASE_URL + DB_PASSWORD:
+     The CLI will construct the DATABASE_URL from your Supabase project URL.
 
 Examples:
   # Interactive mode (prompts for credentials)
   npx autoship init
 
-  # With command line arguments
-  npx autoship init --db-url https://xxx.supabase.co --service-key eyJ...
+  # With full database URL
+  npx autoship init --database-url "postgresql://postgres.xxx:password@aws-0-region.pooler.supabase.com:6543/postgres"
+
+  # With Supabase URL + password
+  npx autoship init --supabase-url https://xxx.supabase.co --db-password mypassword
 
   # Using environment variables
-  SUPABASE_URL=https://xxx.supabase.co SUPABASE_SERVICE_KEY=eyJ... npx autoship init
+  DATABASE_URL="postgresql://..." npx autoship init
 `);
 }
 function createReadlineInterface() {
@@ -127,142 +142,187 @@ async function promptSecret(rl, question) {
         stdin.resume();
     });
 }
-async function getCredentials(options) {
-    let url = options.supabaseUrl || process.env.SUPABASE_URL || "";
-    let serviceKey = options.supabaseServiceKey || process.env.SUPABASE_SERVICE_KEY || "";
-    if (url && serviceKey) {
-        return { url, serviceKey };
+/**
+ * Constructs a DATABASE_URL from a Supabase project URL and password.
+ *
+ * Supabase URL format: https://[project-ref].supabase.co
+ * Database URL format: postgresql://postgres.[project-ref]:[password]@aws-0-[region].pooler.supabase.com:6543/postgres
+ *
+ * Note: We use the transaction pooler (port 6543) for compatibility.
+ * The region is detected from the Supabase URL or defaults to us-east-1.
+ */
+function constructDatabaseUrl(supabaseUrl, password) {
+    const url = new URL(supabaseUrl);
+    const hostname = url.hostname; // e.g., "xxx.supabase.co"
+    const projectRef = hostname.split(".")[0];
+    if (!projectRef) {
+        throw new Error("Could not extract project reference from Supabase URL");
+    }
+    // Supabase uses different regional pooler endpoints
+    // Default to us-east-1, but this can be adjusted
+    // The actual region is embedded in the project, but we can't easily detect it
+    // Users can provide DATABASE_URL directly if they need a specific region
+    const region = "us-east-1";
+    const encodedPassword = encodeURIComponent(password);
+    return `postgresql://postgres.${projectRef}:${encodedPassword}@aws-0-${region}.pooler.supabase.com:6543/postgres`;
+}
+async function getConnectionUrl(options) {
+    // Priority: CLI args > env vars > interactive prompt
+    // Check for direct DATABASE_URL first
+    let databaseUrl = options.databaseUrl || process.env.DATABASE_URL;
+    if (databaseUrl) {
+        return databaseUrl;
+    }
+    // Check for SUPABASE_URL + DB_PASSWORD combination
+    let supabaseUrl = options.supabaseUrl || process.env.SUPABASE_URL;
+    let dbPassword = options.dbPassword || process.env.DB_PASSWORD;
+    if (supabaseUrl && dbPassword) {
+        return constructDatabaseUrl(supabaseUrl, dbPassword);
     }
+    // Interactive mode
     const rl = createReadlineInterface();
     try {
         console.log("\n  Autoship Database Setup\n");
         console.log("  This will create the required tables in your Supabase database.\n");
-        if (!url) {
-            url = await prompt(rl, "  Supabase URL: ");
-        }
-        else {
-            console.log(`  Supabase URL: ${url}`);
-        }
-        if (!serviceKey) {
-            serviceKey = await promptSecret(rl, "  Supabase Service Key: ");
+        console.log("  You can provide credentials in two ways:");
+        console.log("    1. Full DATABASE_URL (includes password)");
+        console.log("    2. Supabase URL + database password\n");
+        const choice = await prompt(rl, "  Enter (1) for DATABASE_URL or (2) for Supabase URL + password: ");
+        if (choice === "1") {
+            console.log("\n  Find your DATABASE_URL in Supabase Dashboard:");
+            console.log("    Project Settings > Database > Connection string > URI\n");
+            databaseUrl = await promptSecret(rl, "  DATABASE_URL: ");
+            return databaseUrl;
         }
         else {
-            console.log("  Supabase Service Key: [provided]");
+            if (!supabaseUrl) {
+                supabaseUrl = await prompt(rl, "\n  Supabase URL (e.g., https://xxx.supabase.co): ");
+            }
+            else {
+                console.log(`\n  Supabase URL: ${supabaseUrl}`);
+            }
+            if (!dbPassword) {
+                console.log("\n  Find your database password in Supabase Dashboard:");
+                console.log("    Project Settings > Database > Database password\n");
+                dbPassword = await promptSecret(rl, "  Database password: ");
+            }
+            return constructDatabaseUrl(supabaseUrl, dbPassword);
         }
-        return { url, serviceKey };
     }
     finally {
         rl.close();
     }
 }
-function validateCredentials(url, serviceKey) {
-    if (!url) {
-        console.error("\n  Error: Supabase URL is required");
-        process.exit(1);
-    }
-    if (!serviceKey) {
-        console.error("\n  Error: Supabase Service Key is required");
+function validateDatabaseUrl(databaseUrl) {
+    if (!databaseUrl) {
+        console.error("\n  Error: Database connection URL is required");
         process.exit(1);
     }
     try {
-        new URL(url);
+        const url = new URL(databaseUrl);
+        if (!url.protocol.startsWith("postgres")) {
+            throw new Error("Not a PostgreSQL URL");
+        }
     }
     catch {
-        console.error("\n  Error: Invalid Supabase URL format");
-        process.exit(1);
-    }
-    if (!serviceKey.startsWith("eyJ")) {
-        console.error("\n  Error: Service key should be a JWT (starts with 'eyJ')");
-        console.error("  Make sure you're using the service_role key, not the anon key.");
+        console.error("\n  Error: Invalid DATABASE_URL format");
+        console.error("  Expected format: postgresql://user:password@host:port/database");
         process.exit(1);
     }
 }
-async function runMigration(url, serviceKey, migrationSql) {
-    console.log("\n  Connecting to Supabase...");
-    const supabase = createClient(url, serviceKey, {
-        auth: {
-            autoRefreshToken: false,
-            persistSession: false,
-        },
+async function runMigration(databaseUrl, migrationSql) {
+    console.log("\n  Connecting to database...");
+    const sql = postgres(databaseUrl, {
+        ssl: "require",
+        connect_timeout: 10,
     });
-    console.log("  Checking database schema...\n");
-    // First, let's verify the connection by trying to query
-    const { error: connectionError } = await supabase
-        .from("agent_tasks")
-        .select("id")
-        .limit(1);
-    if (connectionError && connectionError.code === "42P01") {
-        // Table doesn't exist - we need to create it
-        // Since we can't run arbitrary SQL via the REST API, we'll provide instructions
-        console.log("  Tables don't exist yet.\n");
-        console.log("  ============================================================");
-        console.log("  Supabase REST API doesn't support direct SQL execution.");
-        console.log("  Please run the migration manually using one of these options:");
-        console.log("  ============================================================\n");
-        console.log("  Option 1: Supabase Dashboard");
-        console.log("    1. Go to your Supabase project dashboard");
-        console.log("    2. Navigate to SQL Editor");
-        console.log("    3. Copy and paste the contents of: ./autoship-migration.sql\n");
-        console.log("  Option 2: Supabase CLI");
-        console.log("    1. Install Supabase CLI: npm install -g supabase");
-        console.log("    2. Link your project: supabase link --project-ref YOUR_PROJECT_REF");
-        console.log("    3. Copy autoship-migration.sql to supabase/migrations/");
-        console.log("    4. Run: supabase db push\n");
-        // Write the migration file locally for convenience
-        const outputPath = path.join(process.cwd(), "autoship-migration.sql");
-        fs.writeFileSync(outputPath, migrationSql.trim());
-        console.log(`  Migration SQL saved to: ${outputPath}\n`);
-        console.log("  After running the migration, run this setup command again to verify.\n");
-        process.exit(0);
-    }
-    else if (connectionError) {
-        console.error(`\n  Error connecting to Supabase: ${connectionError.message}`);
-        process.exit(1);
-    }
-    // Tables exist - verify the schema
-    console.log("  Verifying database schema...\n");
-    const tables = ["agent_tasks", "task_categories", "task_category_assignments", "task_questions"];
-    let allTablesExist = true;
-    for (const table of tables) {
-        const { error } = await supabase.from(table).select("*").limit(0);
-        if (error && error.code === "42P01") {
-            console.log(`    [ ] ${table} - NOT FOUND`);
-            allTablesExist = false;
+    try {
+        // Test the connection
+        await sql `SELECT 1`;
+        console.log("  Connected successfully.\n");
+        console.log("  Running migrations...\n");
+        // Execute the migration SQL
+        await sql.unsafe(migrationSql);
+        console.log("  Migrations completed successfully!\n");
+        // Verify the schema
+        console.log("  Verifying database schema...\n");
+        const tables = ["agent_tasks", "task_categories", "task_category_assignments", "task_questions"];
+        let allTablesExist = true;
+        for (const table of tables) {
+            try {
+                await sql.unsafe(`SELECT 1 FROM ${table} LIMIT 0`);
+                console.log(`    [x] ${table}`);
+            }
+            catch (error) {
+                console.log(`    [ ] ${table} - NOT FOUND`);
+                allTablesExist = false;
+            }
         }
-        else if (error) {
-            console.log(`    [?] ${table} - Error: ${error.message}`);
+        if (allTablesExist) {
+            console.log("\n  All tables created. Your database is ready!\n");
+            console.log("  Next steps:");
+            console.log("    1. Add SUPABASE_URL and SUPABASE_ANON_KEY to your app's environment");
+            console.log("    2. Wrap your app with <AutoshipProvider>");
+            console.log("    3. Add the <AutoshipButton /> component\n");
+            console.log("  Example:");
+            console.log("    import { AutoshipProvider, AutoshipButton } from '@autoship/react';");
+            console.log("");
+            console.log("    function App() {");
+            console.log("      return (");
+            console.log("        <AutoshipProvider");
+            console.log("          supabaseUrl={process.env.SUPABASE_URL}");
+            console.log("          supabaseAnonKey={process.env.SUPABASE_ANON_KEY}");
+            console.log("        >");
+            console.log("          <YourApp />");
+            console.log("          <AutoshipButton />");
+            console.log("        </AutoshipProvider>");
+            console.log("      );");
+            console.log("    }\n");
         }
         else {
-            console.log(`    [x] ${table}`);
+            console.log("\n  Warning: Some tables may not have been created correctly.");
+            console.log("  Please check the migration output above for errors.\n");
+            process.exit(1);
         }
     }
-    if (allTablesExist) {
-        console.log("\n  All tables exist. Your database is ready!\n");
-        console.log("  Next steps:");
-        console.log("    1. Add SUPABASE_URL and SUPABASE_ANON_KEY to your app's environment");
-        console.log("    2. Wrap your app with <AutoshipProvider>");
-        console.log("    3. Add the <AutoshipButton /> component\n");
-        console.log("  Example:");
-        console.log("    import { AutoshipProvider, AutoshipButton } from '@autoship/react';");
-        console.log("");
-        console.log("    function App() {");
-        console.log("      return (");
-        console.log("        <AutoshipProvider");
-        console.log("          supabaseUrl={process.env.SUPABASE_URL}");
-        console.log("          supabaseAnonKey={process.env.SUPABASE_ANON_KEY}");
-        console.log("        >");
-        console.log("          <YourApp />");
-        console.log("          <AutoshipButton />");
-        console.log("        </AutoshipProvider>");
-        console.log("      );");
-        console.log("    }\n");
+    catch (error) {
+        const err = error;
+        if (err.code === "28P01") {
+            console.error("\n  Error: Authentication failed. Check your database password.");
+        }
+        else if (err.code === "ENOTFOUND" || err.code === "ECONNREFUSED") {
+            console.error("\n  Error: Could not connect to database. Check your connection URL.");
+        }
+        else if (err.message?.includes("already exists")) {
+            console.log("\n  Schema already exists. Verifying tables...\n");
+            // Verify existing schema
+            const tables = ["agent_tasks", "task_categories", "task_category_assignments", "task_questions"];
+            let allTablesExist = true;
+            for (const table of tables) {
+                try {
+                    await sql.unsafe(`SELECT 1 FROM ${table} LIMIT 0`);
+                    console.log(`    [x] ${table}`);
+                }
+                catch {
+                    console.log(`    [ ] ${table} - NOT FOUND`);
+                    allTablesExist = false;
+                }
+            }
+            if (allTablesExist) {
+                console.log("\n  All tables exist. Your database is ready!\n");
+            }
+            else {
+                console.log("\n  Some tables are missing. You may need to run migrations manually.\n");
+                process.exit(1);
+            }
+        }
+        else {
+            console.error(`\n  Error: ${err.message}`);
+            process.exit(1);
+        }
     }
-    else {
-        console.log("\n  Some tables are missing. Please run the migration SQL.");
-        const outputPath = path.join(process.cwd(), "autoship-migration.sql");
-        fs.writeFileSync(outputPath, migrationSql.trim());
-        console.log(`  Migration SQL saved to: ${outputPath}\n`);
-        process.exit(1);
+    finally {
+        await sql.end();
     }
 }
 export async function run(args) {
@@ -270,9 +330,9 @@ export async function run(args) {
     try {
         // Load migrations from the bundled files
         const migrationSql = loadMigrations();
-        const { url, serviceKey } = await getCredentials(options);
-        validateCredentials(url, serviceKey);
-        await runMigration(url, serviceKey, migrationSql);
+        const databaseUrl = await getConnectionUrl(options);
+        validateDatabaseUrl(databaseUrl);
+        await runMigration(databaseUrl, migrationSql);
     }
     catch (error) {
         console.error("\n  Unexpected error:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autoship/react",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,13 +17,14 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc && npm run copy-migrations",
+    "build": "tsc && cp ../../README.md dist/ && npm run copy-migrations",
     "copy-migrations": "mkdir -p dist/migrations && cp ../../supabase/migrations/*.sql dist/migrations/",
     "dev": "tsc --watch",
     "cli": "node dist/cli/autoship.js"
   },
   "dependencies": {
-    "@supabase/supabase-js": "^2.90.1"
+    "@supabase/supabase-js": "^2.90.1",
+    "postgres": "^3.4.5"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"