glenn-code 1.0.0

package/README.md

@@ -0,0 +1,127 @@
+# DNM Agent Local
+
+Connect your local development environment to DNM Lab. Run AI-powered development sessions directly from your machine.
+
+## Installation
+
+```bash
+npm install -g glenn-code
+```
+
+## Quick Start
+
+```bash
+# Navigate to your project directory
+cd /path/to/your/project
+
+# Start the agent
+glenn-code
+```
+
+On first run, you'll be prompted to configure your connection. You can either:
+1. **Paste config** - Copy the connection string from DNM Lab frontend
+2. **Enter manually** - Provide Master URL, Project ID, and Project Key
+3. **Interactive setup** - Configure your project stack interactively
+
+Configuration is saved to `.sdd/local-signalr-config.json` for future sessions.
+
+## Usage
+
+```bash
+# Start the agent (uses saved config or prompts for setup)
+glenn-code
+
+# Show help
+glenn-code --help
+
+# Show version
+glenn-code --version
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `MASTER_URL` | DNM Lab backend URL | (prompted) |
+| `PROJECT_ID` | Your project ID | (prompted) |
+| `PROJECT_KEY` | Project API key (`pk_proj_...`) | (prompted) |
+| `WORKSPACE_DIR` | Working directory | Current directory |
+
+## How It Works
+
+1. **Connect** - The agent establishes a SignalR connection to DNM Lab
+2. **Authenticate** - Uses your project key for secure authentication
+3. **Work** - Receives tasks from the DNM Lab frontend and executes them locally
+4. **Preview** - Your local dev server URL is reported back for live previews
+
+## Configuration File
+
+The agent stores configuration in `.sdd/local-signalr-config.json`:
+
+```json
+{
+  "masterUrl": "https://your-dnm-lab-instance.com",
+  "projectId": "your-project-id",
+  "projectKey": "pk_proj_...",
+  "containerId": "local-your-machine-abc123",
+  "enableTunnel": true,
+  "tunnelPort": 5173
+}
+```
+
+You can also embed project-specific configuration:
+
+```json
+{
+  "masterUrl": "...",
+  "projectId": "...",
+  "projectKey": "...",
+  "containerId": "...",
+  "enableTunnel": true,
+  "tunnelPort": 3000,
+  "version": "1.0",
+  "paths": {
+    "workspace": ".",
+    "frontend": "./frontend",
+    "backend": "./backend"
+  },
+  "services": {
+    "frontend": {
+      "port": 3000,
+      "startCommand": "npm run dev",
+      "extensions": [".ts", ".tsx", ".js", ".jsx"]
+    },
+    "backend": {
+      "port": 8080,
+      "startCommand": "npm start",
+      "extensions": [".ts", ".js"]
+    }
+  }
+}
+```
+
+## Requirements
+
+- Node.js 18+
+- A DNM Lab account with a project set up
+- Project API key from DNM Lab
+
+## Troubleshooting
+
+**Connection failed**
+- Check that your `MASTER_URL` is correct
+- Verify your project key is valid
+- Ensure you have network access to the DNM Lab server
+
+**Agent not appearing in frontend**
+- The agent must be running and connected
+- Check the terminal for connection status
+- Try restarting the agent
+
+**Preview not working**
+- Make sure your local dev server is running on the configured port
+- Check that `tunnelPort` matches your dev server port
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+/**
+ * Glenn Code
+ *
+ * Connect your local development environment to DNM Lab.
+ *
+ * Usage:
+ *   glenn-code          # Start the agent (interactive setup on first run)
+ *   glenn-code --help   # Show help
+ *   glenn-code --version # Show version
+ */
+
+import { fileURLToPath } from "url";
+import * as path from "path";
+import * as fs from "fs";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageDir = path.resolve(__dirname, "..");
+
+// Handle --help
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+  console.log(`
+Glenn Code - Connect your local dev environment to DNM Lab
+
+Usage:
+  glenn-code [options]
+
+Options:
+  --help, -h      Show this help message
+  --version, -v   Show version number
+
+Environment Variables:
+  MASTER_URL      Backend URL (prompted if not set)
+  PROJECT_ID      Project ID (prompted if not set)
+  PROJECT_KEY     Project API key (prompted if not set)
+  WORKSPACE_DIR   Working directory (defaults to current directory)
+
+First Run:
+  On first run, you'll be prompted to configure your connection.
+  Settings are saved to .sdd/local-signalr-config.json in your project.
+
+  Tip: Copy the connection config from the DNM Lab frontend for quick setup!
+`);
+  process.exit(0);
+}
+
+// Handle --version
+if (process.argv.includes("--version") || process.argv.includes("-v")) {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(packageDir, "package.json"), "utf-8"));
+    console.log(`glenn-code v${pkg.version}`);
+  } catch {
+    console.log("glenn-code v1.0.0");
+  }
+  process.exit(0);
+}
+
+// Set environment for local mode
+process.env.LOCAL_MODE = "true";
+process.env.WORKSPACE_DIR = process.env.WORKSPACE_DIR || process.cwd();
+
+// Run the agent
+async function main() {
+  try {
+    const { startSignalRAgent } = await import("../dist/cli.js");
+    await startSignalRAgent();
+  } catch (err) {
+    console.error("Failed to start agent:", err.message || err);
+    process.exit(1);
+  }
+}
+
+main();