ghcralph 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Raphael Pothin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,327 @@
+# GitHub Copilot Ralph CLI (`ghcralph`)
+
+[![CI](https://github.com/rpothin/ghc-ralph-cli/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/rpothin/ghc-ralph-cli/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/ghcralph.svg)](https://www.npmjs.com/package/ghcralph)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
+
+Run **autonomous, checkpointed coding loops** with GitHub Copilot—designed to be **safe, reversible, and budget-controlled**.
+
+## What you get
+
+- 🌿 **Branch isolation**: works on a `ghcralph/*` branch (never modifies `main`/`master` directly)
+- 💾 **Automatic checkpoints**: commits after each iteration for easy rollback
+- 🛡️ **Guardrails**: iteration limits, token budgets, timeouts, circuit breaker on repeated failures
+- 📋 **Flexible plan sources**: GitHub Issues or local Markdown task lists
+- 💻 **Cross-platform**: Windows, macOS, Linux
+
+## 60-second quick start
+
+### Prerequisites (required)
+- **Node.js** >= 18
+- **git**
+- **GitHub CLI (`gh`)** authenticated
+- **GitHub Copilot CLI extension**:
+  ```bash
+  gh extension install github/gh-copilot
+  ```
+- An active **GitHub Copilot** subscription / access
+
+### Install
+```bash
+npm install -g ghcralph
+```
+
+### Initialize in your project
+```bash
+cd your-project
+ghcralph init
+```
+
+### Run your first task
+```bash
+ghcralph run --task "Add a README badge showing the build status"
+```
+
+### Rollback if needed
+```bash
+ghcralph rollback --iterations 1
+```
+
+## Safety model (read this first)
+
+- **No direct main changes**: the tool creates an isolated branch and works there.
+- **Reversible by design**: each iteration is checkpointed in git; rollback is a first-class command.
+- **Deletion protection**: existing files are protected from deletion by default (override only if you explicitly allow it).
+- **Budgets and limits**: iteration/token/time limits prevent runaway sessions.
+
+---
+
+## What is GitHub Copilot Ralph?
+
+GitHub Copilot Ralph implements the **Ralph Wiggum agentic coding pattern**—a simple, safe, and well-documented approach to running autonomous AI coding loops powered by GitHub Copilot.
+
+### The Ralph Wiggum Pattern
+
+Named after the delightfully simple character, the pattern is straightforward:
+
+```
+1. Give the agent a task
+2. Let it work in small, checkpointed iterations
+3. Review progress and rollback if needed
+4. Repeat until done
+```
+
+This approach prioritizes **safety** (automatic checkpoints, git isolation) and **control** (iteration limits, easy rollback) over speed.
+
+## Key Features
+
+- 🔄 **Autonomous Loop**: Repeatedly invokes AI agent until task completion
+- 📋 **Flexible Plan Sources**: GitHub Issues or local Markdown task lists
+- 🛡️ **Safety First**: Git branch isolation, file deletion safeguards
+- 💾 **Automatic Checkpoints**: Git commits after each iteration for easy rollback
+- 📊 **Progress Tracking**: Real-time status, token usage, and session logs
+- ⚡ **Guardrails**: Iteration limits, token budgets, timeout controls
+- 🔧 **Highly Configurable**: Customize behavior via CLI, env vars, or config files
+- 💻 **Cross-Platform**: Works on Windows, macOS, and Linux
+
+## Commands
+
+| Command             | Description                                     |
+| ------------------- | ----------------------------------------------- |
+| `ghcralph init`     | Initialize GitHub Copilot Ralph in a repository |
+| `ghcralph run`      | Execute an agentic coding loop                  |
+| `ghcralph status`   | Check current session status                    |
+| `ghcralph rollback` | Revert to a previous checkpoint                 |
+| `ghcralph config`   | View or modify configuration                    |
+| `ghcralph help`     | Get help for any command                        |
+
+Use `ghcralph <command> --help` for detailed options.
+
+## Common workflows
+
+### One-off task (fastest)
+```bash
+ghcralph run --task "Refactor auth middleware to reduce duplication"
+```
+
+### Run from a local Markdown plan
+```bash
+ghcralph run --plan TODO.md
+```
+
+### Run tasks from GitHub Issues
+```bash
+ghcralph init --github
+ghcralph run --github owner/repo --label "ready"
+```
+
+## Usage
+
+### Initialize a Project
+
+```bash
+# Default initialization (local plan source)
+ghcralph init
+
+# Use GitHub Issues as plan source
+ghcralph init --github
+
+# Use local Markdown files as plan source
+ghcralph init --local
+
+# Reinitialize existing configuration
+ghcralph init --force
+```
+
+### Run Tasks
+
+```bash
+# Inline task
+ghcralph run --task "Add input validation to the login form"
+
+# Task from file
+ghcralph run --file tasks/add-validation.md
+
+# Tasks from a Markdown plan file
+ghcralph run --plan TODO.md
+
+# Tasks from GitHub Issues
+ghcralph run --github owner/repo --label "ready"
+```
+
+### Advanced Run Options
+
+```bash
+# Control iterations and tokens
+ghcralph run --task "Refactor auth" --max-iterations 20 --max-tokens 50000
+
+# Specify context files
+ghcralph run --task "Fix tests" --context "src/**/*.test.ts"
+
+# Use a specific branch
+ghcralph run --task "Add feature" --branch feature/my-feature
+
+# Preview without executing
+ghcralph run --task "Big change" --dry-run
+
+# Long-running task with timeout
+ghcralph run --task "Large refactor" --unlimited --timeout 60
+
+# Skip confirmation prompts
+ghcralph run --task "Quick fix" --force
+```
+
+## Configuration
+
+GitHub Copilot Ralph uses a hierarchical configuration system:
+
+1. **CLI flags** (highest priority)
+2. **Environment variables** (`GHCRALPH_*`)
+3. **Local config** (`.ghcralph/config.json`)
+4. **Global config** (`~/.config/ghcralph/config.json`)
+
+### Configuration Options
+
+| Option          | Default     | Description                                           |
+| --------------- | ----------- | ----------------------------------------------------- |
+| `planSource`    | `local`     | Plan source: `github` or `local`                      |
+| `maxIterations` | `10`        | Maximum loop iterations                               |
+| `maxTokens`     | `100000`    | Token budget                                          |
+| `defaultModel`  | `gpt-4.1`   | Copilot model to use                                  |
+| `autoCommit`    | `true`      | Auto-commit after iterations                          |
+| `branchPrefix`  | `ghcralph/` | Prefix for GitHub Copilot Ralph branches              |
+| `githubRepo`    | -           | GitHub repository (owner/repo) for GitHub plan source |
+| `localPlanFile` | -           | Path to local plan file                               |
+
+### Environment Variables
+
+All configuration options can be set via environment variables with the `GHCRALPH_` prefix:
+
+```bash
+export GHCRALPH_MAX_ITERATIONS=20
+export GHCRALPH_MAX_TOKENS=50000
+export GHCRALPH_DEFAULT_MODEL=gpt-4.1
+export GHCRALPH_AUTO_COMMIT=true
+export GHCRALPH_BRANCH_PREFIX=ghcralph/
+export GHCRALPH_PLAN_SOURCE=local
+```
+
+### Example Configuration File
+
+```json
+{
+  "planSource": "github",
+  "maxIterations": 15,
+  "maxTokens": 50000,
+  "defaultModel": "gpt-4.1",
+  "autoCommit": true,
+  "branchPrefix": "ghcralph/",
+  "githubRepo": "owner/repo"
+}
+```
+
+## Safety Features (details)
+
+### 🌿 Git Branch Isolation
+- Automatically creates `ghcralph/` prefixed branches
+- Never modifies `main` or `master` directly
+- Easy to discard unsuccessful attempts
+
+### 💾 Automatic Checkpoints
+- Commits after each successful iteration
+- Message format: `ghcralph: iteration N - summary`
+- Easy rollback with `ghcralph rollback`
+
+### 🛡️ File Deletion Safeguards
+- Tracks files that existed before session
+- Blocks deletion of pre-existing files
+- Override with `--allow-delete` if needed
+
+### ⏱️ Resource Limits
+- Configurable iteration limits
+- Token budget controls
+- Optional timeout (`--timeout`)
+- Requires `--unlimited` flag for >50 iterations
+
+### 🔌 Circuit Breaker
+- Pauses after 3 consecutive failures
+- Warns at 80% of resource limits
+- Graceful shutdown on Ctrl+C
+
+## Authentication
+
+GitHub Copilot Ralph uses GitHub for AI access:
+
+1. **GitHub CLI** (recommended): `gh auth login`
+2. **GitHub Copilot CLI**: Ensure it's installed: `gh extension install github/gh-copilot`
+3. **Environment variable** (alternative): `GITHUB_TOKEN` or `GH_TOKEN`
+
+## Installation
+
+### npm (Recommended)
+
+```bash
+npm install -g ghcralph
+```
+
+### From source
+
+```bash
+git clone https://github.com/rpothin/ghc-ralph-cli.git
+cd ghc-ralph-cli
+npm install
+npm run build
+npm link
+```
+
+## Troubleshooting
+
+### "Not in a git repository"
+Run `git init` first, or navigate to an existing git repository.
+
+### "Failed to initialize Copilot agent"
+Ensure you have GitHub Copilot CLI installed and are authenticated:
+```bash
+gh extension install github/gh-copilot
+gh auth login
+```
+
+### "Maximum iterations reached"
+Increase the limit: `--max-iterations 20`  
+Or for very long tasks: `--unlimited`
+
+### Progress seems stuck
+Check status: `ghcralph status`  
+View checkpoints: `ghcralph rollback --list`  
+Rollback if needed: `ghcralph rollback`
+
+## Credits & Attribution
+
+**GitHub Copilot Ralph** is an opinionated interpretation of the **Ralph Wiggum loop** approach, originally proposed by **[Geoffrey Huntley](https://ghuntley.com/)**.
+
+This CLI implementation was created by **[Raphael Pothin](https://github.com/rpothin)** to make the Ralph Wiggum approach:
+
+- 📐 **More structured** - with clear phases and checkpoints
+- 🛡️ **Safer** - with git isolation, file safeguards, and resource limits
+- 🎯 **More accessible** - for developers new to agentic coding patterns
+- 🏢 **Enterprise-ready** - with configuration, audit trails, and controls
+- 🔗 **GitHub ecosystem integrated** - leveraging GitHub Copilot SDK and optionally GitHub Issues
+
+## Philosophy
+
+GitHub Copilot Ralph is built on these principles:
+
+1. **Simplicity first**: Mirror the elegant simplicity of Geoffrey Huntley's original Ralph loop
+2. **Safety by design**: Git isolation, automatic checkpoints, cost controls
+3. **Human-friendly**: Markdown progress, clear documentation, easy rollback
+4. **Cross-platform**: Works seamlessly on Windows, macOS, and Linux
+5. **Transparent**: You can always see what GitHub Copilot Ralph is doing and undo it
+
+## Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT © [Raphael Pothin](https://github.com/rpothin)

package/bin/ghcralph.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli.js';

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * GitHub Copilot Ralph CLI - Main Entry Point
+ *
+ * A cross-platform CLI for running autonomous agentic coding loops
+ * using the Ralph Wiggum pattern with GitHub Copilot.
+ *
+ * This is an opinionated interpretation of Geoffrey Huntley's Ralph Wiggum loop
+ * (https://ghuntley.com/ralph/) created by Raphael Pothin.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/cli.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+/**
+ * GitHub Copilot Ralph CLI - Main Entry Point
+ *
+ * A cross-platform CLI for running autonomous agentic coding loops
+ * using the Ralph Wiggum pattern with GitHub Copilot.
+ *
+ * This is an opinionated interpretation of Geoffrey Huntley's Ralph Wiggum loop
+ * (https://ghuntley.com/ralph/) created by Raphael Pothin.
+ */
+import { Command } from 'commander';
+import { VERSION, NAME } from './index.js';
+import { registerInitCommand, registerRunCommand, registerStatusCommand, registerRollbackCommand, registerConfigCommand, } from './commands/index.js';
+import { setVerbosity, banner, debug, detectShell, dim, code } from './utils/index.js';
+const program = new Command();
+// Configure program metadata
+program
+    .name(NAME)
+    .description('GitHub Copilot Ralph - Autonomous agentic coding loops with GitHub Copilot')
+    .version(VERSION, '-v, --version', 'Show version number')
+    .option('--verbose', 'Enable verbose logging')
+    .option('--quiet', 'Suppress non-essential output')
+    .addHelpText('after', `
+${dim('Examples:')}
+  $ ghcralph init                          # Initialize GitHub Copilot Ralph in your project
+  $ ghcralph run --task "Add tests"        # Run a coding loop for a task
+  $ ghcralph run --plan TODO.md            # Execute tasks from a plan file
+  $ ghcralph run --github owner/repo       # Work through GitHub Issues
+  $ ghcralph status                        # Check current session status
+  $ ghcralph rollback --iterations 2       # Undo last 2 iterations
+  $ ghcralph config list                   # View current configuration
+
+${dim('Quick Start:')}
+  1. Ensure GitHub Copilot CLI is installed: ${code('gh extension install github/gh-copilot')}
+  2. Run ${code('ghcralph init')} in your project
+  3. Run ${code('ghcralph run --task "your task"')} to start coding
+  4. GitHub Copilot Ralph will create a branch, make changes, and checkpoint automatically
+
+${dim('Tips:')}
+  - Use --dry-run to preview what GitHub Copilot Ralph would do
+  - Use --verbose for detailed logging
+  - Use --force to skip confirmation prompts
+  - Checkpoints are auto-committed; use 'ghcralph rollback' to undo
+
+${dim('Documentation:')} https://github.com/rpothin/ghc-ralph-cli
+${dim('Original concept:')} https://ghuntley.com/ralph/
+`)
+    .hook('preAction', (thisCommand) => {
+    const opts = thisCommand.opts();
+    // Set verbosity level
+    if (opts.quiet) {
+        setVerbosity('quiet');
+    }
+    else if (opts.verbose) {
+        setVerbosity('verbose');
+    }
+    // Show banner in verbose mode
+    if (opts.verbose) {
+        banner();
+        const shell = detectShell();
+        debug(`Shell detected: ${shell.type} (${shell.path ?? 'unknown path'})`);
+        debug(`Platform: ${shell.isWindows ? 'Windows' : 'Unix-like'}`);
+    }
+});
+// Register all commands
+registerInitCommand(program);
+registerRunCommand(program);
+registerStatusCommand(program);
+registerRollbackCommand(program);
+registerConfigCommand(program);
+// Add help command as alias
+program
+    .command('help [command]')
+    .description('Display help for a command')
+    .action((commandName) => {
+    if (commandName) {
+        const cmd = program.commands.find(c => c.name() === commandName);
+        if (cmd) {
+            cmd.outputHelp();
+        }
+        else {
+            console.log(`Unknown command: ${commandName}`);
+            console.log(`Run ${code('ghcralph --help')} to see available commands.`);
+        }
+    }
+    else {
+        program.outputHelp();
+    }
+});
+// Parse command line arguments
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Config Command
+ *
+ * View or modify Ralph configuration
+ */
+import type { Command } from 'commander';
+export declare function registerConfigCommand(program: Command): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6H5D"}

package/dist/commands/config.js

@@ -0,0 +1,118 @@
+/**
+ * Config Command
+ *
+ * View or modify Ralph configuration
+ */
+import { info, success, error, code, dim, heading } from '../utils/index.js';
+import { ConfigManager, isValidConfigKey, parseConfigValue, validateConfigValue, getGlobalConfigPath, getLocalConfigPath, } from '../core/config-manager.js';
+export function registerConfigCommand(program) {
+    const configCmd = program.command('config').description('View or modify configuration');
+    configCmd
+        .command('get [key]')
+        .description('Get configuration value(s)')
+        .option('--global', 'Show global configuration')
+        .action(async (key, _options) => {
+        const configManager = new ConfigManager();
+        await configManager.load();
+        const config = configManager.getConfig();
+        if (key) {
+            if (!isValidConfigKey(key)) {
+                error(`Unknown configuration key: ${key}`);
+                process.exit(1);
+            }
+            const value = config[key];
+            console.log(value);
+        }
+        else {
+            console.log('');
+            console.log(heading('📋 Ralph Configuration'));
+            console.log('');
+            for (const [k, v] of Object.entries(config)) {
+                const displayValue = typeof v === 'string' ? code(v) : String(v);
+                console.log(`  ${dim(k + ':')} ${displayValue}`);
+            }
+            console.log('');
+            console.log(dim('Config files:'));
+            console.log(`  ${dim('Global:')} ${getGlobalConfigPath()}`);
+            console.log(`  ${dim('Local:')} ${getLocalConfigPath()}`);
+            console.log('');
+        }
+    });
+    configCmd
+        .command('set <key> <value>')
+        .description('Set a configuration value')
+        .option('--global', 'Set in global configuration')
+        .action(async (key, value, options) => {
+        if (!isValidConfigKey(key)) {
+            error(`Unknown configuration key: ${key}`);
+            info(`Valid keys: ${code('planSource, maxIterations, maxTokens, defaultModel, autoCommit, branchPrefix, githubRepo, localPlanFile')}`);
+            process.exit(1);
+        }
+        const parsedValue = parseConfigValue(key, value);
+        const validation = validateConfigValue(key, parsedValue);
+        if (!validation.valid) {
+            error(validation.error ?? 'Invalid value');
+            process.exit(1);
+        }
+        const configManager = new ConfigManager();
+        await configManager.load();
+        configManager.set(key, parsedValue);
+        if (options?.global) {
+            await configManager.saveGlobal();
+            success(`Set ${code(key)} = ${code(String(parsedValue))} (global)`);
+        }
+        else {
+            await configManager.saveLocal();
+            success(`Set ${code(key)} = ${code(String(parsedValue))} (local)`);
+        }
+    });
+    configCmd
+        .command('list')
+        .description('List all configuration')
+        .action(async () => {
+        const configManager = new ConfigManager();
+        await configManager.load();
+        const config = configManager.getConfig();
+        console.log('');
+        console.log(heading('📋 Ralph Configuration'));
+        console.log('');
+        for (const [key, value] of Object.entries(config)) {
+            const displayValue = typeof value === 'string' ? code(value) : String(value);
+            console.log(`  ${dim(key + ':')} ${displayValue}`);
+        }
+        console.log('');
+    });
+    configCmd
+        .command('reset')
+        .description('Reset configuration to defaults')
+        .option('--force', 'Skip confirmation')
+        .option('--global', 'Reset global configuration')
+        .action(async (options) => {
+        if (!options.force) {
+            error('Use --force to confirm reset');
+            return;
+        }
+        const configManager = new ConfigManager();
+        configManager.reset();
+        if (options.global) {
+            await configManager.saveGlobal();
+            success('Global configuration reset to defaults');
+        }
+        else {
+            await configManager.saveLocal();
+            success('Local configuration reset to defaults');
+        }
+    });
+    configCmd
+        .command('path')
+        .description('Show configuration file paths')
+        .action(() => {
+        console.log('');
+        console.log(heading('📁 Configuration Paths'));
+        console.log('');
+        console.log(`  ${dim('Global:')} ${getGlobalConfigPath()}`);
+        console.log(`  ${dim('Local:')} ${getLocalConfigPath()}`);
+        console.log('');
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"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"}

package/dist/commands/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CLI Commands
+ *
+ * This module exports all CLI command registration functions
+ */
+export { registerInitCommand } from './init.js';
+export { registerRunCommand } from './run.js';
+export { registerStatusCommand } from './status.js';
+export { registerRollbackCommand } from './rollback.js';
+export { registerConfigCommand } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,11 @@
+/**
+ * CLI Commands
+ *
+ * This module exports all CLI command registration functions
+ */
+export { registerInitCommand } from './init.js';
+export { registerRunCommand } from './run.js';
+export { registerStatusCommand } from './status.js';
+export { registerRollbackCommand } from './rollback.js';
+export { registerConfigCommand } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Init Command
+ *
+ * Initialize GitHub Copilot Ralph in a repository
+ */
+import type { Command } from 'commander';
+import type { PlanSource } from '../core/config-schema.js';
+export interface InitOptions {
+    force?: boolean;
+    planSource?: PlanSource;
+    local?: boolean;
+    github?: boolean;
+}
+export declare function registerInitCommand(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AA8B3D,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsF1D"}