@bradtaylorsf/alpha-loop 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bradley Taylor
+
+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,294 @@
+# Alpha Loop
+
+Agent-agnostic automated development loop. Fetches issues from your GitHub project board (optionally filtered by milestone), implements them with an AI coding agent, runs tests, reviews the code, and creates PRs — then moves to the next issue until all matching issues are done.
+
+**The Loop:** Plan (GitHub Issues) -> Build (AI Agent) -> Test -> Review -> Verify -> Learn -> Ship (PR)
+
+## Installation
+
+```bash
+# Install globally
+npm install -g @bradtaylorsf/alpha-loop
+
+# Or run directly
+npx @bradtaylorsf/alpha-loop
+```
+
+### Prerequisites
+
+- **Node.js 20+**
+- **git** — for worktree isolation
+- **[GitHub CLI](https://cli.github.com/)** (`gh`) — authenticated with `gh auth login`
+- **AI agent CLI** — currently supports:
+  - [Claude Code](https://claude.ai/code) (`claude`)
+  - [Codex](https://github.com/openai/codex) (`codex`)
+  - [OpenCode](https://github.com/sst/opencode) (`opencode`)
+- **[Playwright CLI](https://www.npmjs.com/package/@playwright/cli)** (optional) — for live verification with screenshots
+
+## Quick Start
+
+```bash
+# 1. Initialize config in your project
+cd your-project
+alpha-loop init
+
+# 2. Edit .alpha-loop.yaml with your repo settings
+
+# 3. Set up project vision (optional but recommended)
+alpha-loop vision
+
+# 4. Generate project context
+alpha-loop scan
+
+# 5. Run the loop — you'll be prompted to pick a milestone
+alpha-loop run
+
+# Or target a specific milestone directly
+alpha-loop run --milestone "v1.0"
+
+```
+
+## How It Works
+
+Alpha Loop implements a 12-step pipeline for each issue:
+
+1. **Status Update** — Labels issue `in-progress`, updates project board
+2. **Worktree** — Creates an isolated git worktree so work doesn't conflict with other issues
+3. **Plan** — Agent analyzes the issue and enriches it with implementation details
+4. **Implement** — Agent writes the code, guided by project vision, context, and learnings from previous issues
+5. **Test + Retry** — Runs your test command; if tests fail, agent fixes and retries (up to `max_test_retries`)
+6. **Verify + Retry** — Starts your dev server, uses playwright-cli to test the feature like a real user, takes screenshots
+7. **Review** — A review agent reads the diff, checks for gaps, security issues, and missing wiring — fixes what it can
+8. **Create PR** — Opens a PR with test results, review summary, and verification status
+9. **Learn** — Extracts learnings (patterns, anti-patterns, what worked/failed) for future sessions
+10. **Update Issue** — Posts results as a comment, updates labels
+11. **Auto-Merge** — Merges the PR to the session branch (if enabled)
+12. **Cleanup** — Removes the worktree
+
+After all issues are processed, Alpha Loop generates a **session summary** that aggregates learnings across issues and produces actionable recommendations.
+
+### Milestone-Based Workflow
+
+When you start the loop interactively, Alpha Loop shows your open milestones and lets you pick which one to work on:
+
+```
+  Open Milestones
+
+  0  All issues (no milestone filter)
+  1  v1.0 — MVP (5 open, 3/8 done · due 2026-04-15)
+  2  v1.1 — Polish (10 open, 0/10 done)
+
+  Select milestone [0-2]: 1
+```
+
+This lets you plan work in GitHub milestones and control exactly how much the loop processes per session. You can also pass `--milestone "v1.0"` to skip the prompt, or set `milestone: v1.0` in your config file.
+
+### Session Branches
+
+When `auto_merge` is enabled (default), Alpha Loop creates a session branch (e.g., `session/20260331-002240`) and merges each issue's PR into it. This keeps your main branch clean until you're ready to merge the whole session.
+
+### Learnings
+
+Each completed issue produces a learning file in `.alpha-loop/learnings/` with:
+- What worked and what failed
+- Reusable patterns discovered
+- Anti-patterns to avoid
+- Suggested skill/prompt updates
+
+These learnings are automatically fed into future implementation prompts, so the agent gets smarter over time.
+
+### Screenshots
+
+During live verification, the agent takes screenshots at key states and saves them to `.alpha-loop/sessions/<name>/screenshots/issue-<N>/`. These are kept locally (not committed to git) for debugging.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `alpha-loop init` | Create `.alpha-loop.yaml` config and install agent skills/templates |
+| `alpha-loop run` | Fetch matching issues, process them all, then exit |
+| `alpha-loop run --dry-run` | Preview without making changes |
+| `alpha-loop scan` | Generate/refresh project context (`.alpha-loop/context.md`) |
+| `alpha-loop vision` | Interactive project vision setup (`.alpha-loop/vision.md`) |
+| `alpha-loop auth` | Save authenticated browser state for verification |
+| `alpha-loop history` | View session history |
+| `alpha-loop history <name>` | View a specific session |
+| `alpha-loop history <name> --qa` | Show QA checklist for session |
+| `alpha-loop history --clean` | Remove old session data |
+| `alpha-loop sync` | Sync agent assets (AGENTS.md, skills) across agent directories |
+
+### Run Options
+
+```bash
+alpha-loop run [options]
+
+Options:
+  --dry-run           Preview without making changes
+  --model <model>     AI model to use (e.g., opus, sonnet)
+  --milestone <name>  Only process issues in this milestone (skips interactive prompt)
+  --skip-tests        Skip test execution
+  --skip-review       Skip code review step
+  --skip-learn        Skip learning extraction
+  --auto-merge        Auto-merge PRs to session branch
+  --merge-to <branch> Use an existing branch instead of creating a new session branch
+```
+
+## Configuration
+
+Running `alpha-loop init` creates a `.alpha-loop.yaml` file:
+
+```yaml
+# Alpha Loop configuration
+repo: owner/repo-name
+model: opus
+review_model: opus
+label: ready
+base_branch: main
+test_command: pnpm test
+dev_command: pnpm dev
+port: 3000
+auto_merge: true
+
+# Safety limits (0 = unlimited)
+max_issues: 20
+max_session_duration: 7200  # 2 hours in seconds
+```
+
+### Configuration Reference
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `repo` | (auto-detected) | GitHub repo in `owner/name` format |
+| `model` | `opus` | AI model for implementation and verification |
+| `review_model` | `opus` | AI model for code review and learning extraction |
+| `label` | `ready` | GitHub label that marks issues as ready for the loop |
+| `base_branch` | `master` | Branch to create PRs against |
+| `test_command` | `pnpm test` | Command to run tests |
+| `dev_command` | `pnpm dev` | Command to start the dev server for verification |
+| `port` | `3000` | Port the dev server runs on |
+| `max_test_retries` | `3` | Times to retry failing tests/verification |
+| `milestone` | (none) | Only process issues in this milestone |
+| `max_issues` | `0` | Max issues to process per session (0 = unlimited) |
+| `max_session_duration` | `0` | Max session duration in seconds (0 = unlimited) |
+| `auto_merge` | `true` | Auto-merge issue PRs into the session branch |
+| `merge_to` | (none) | Use an existing branch instead of creating a session branch |
+| `skip_tests` | `false` | Skip test execution |
+| `skip_review` | `false` | Skip code review |
+| `skip_verify` | `false` | Skip live verification |
+| `skip_learn` | `false` | Skip learning extraction |
+| `skip_e2e` | `false` | Skip E2E tests |
+| `skip_install` | `false` | Skip `pnpm install` in worktrees |
+| `skip_preflight` | `false` | Skip pre-flight test validation |
+| `auto_cleanup` | `true` | Auto-remove worktrees after processing |
+
+### Environment Variables
+
+All config options can be set via environment variables (uppercase, same names):
+
+| Variable | Config Key |
+|----------|------------|
+| `REPO` | `repo` |
+| `MODEL` | `model` |
+| `REVIEW_MODEL` | `review_model` |
+| `MAX_TEST_RETRIES` | `max_test_retries` |
+| `MILESTONE` | `milestone` |
+| `MAX_ISSUES` | `max_issues` |
+| `MAX_SESSION_DURATION` | `max_session_duration` |
+| `BASE_BRANCH` | `base_branch` |
+| `TEST_COMMAND` | `test_command` |
+| `DEV_COMMAND` | `dev_command` |
+| `PORT` | `port` |
+| `DRY_RUN` | `dry_run` |
+| `SKIP_TESTS` | `skip_tests` |
+| `SKIP_REVIEW` | `skip_review` |
+| `SKIP_VERIFY` | `skip_verify` |
+| `SKIP_LEARN` | `skip_learn` |
+| `AUTO_MERGE` | `auto_merge` |
+| `MERGE_TO` | `merge_to` |
+
+**Precedence:** CLI flags > environment variables > `.alpha-loop.yaml` > auto-detection > defaults
+
+## GitHub Setup
+
+### Labels
+
+Create these labels on your repo (or let the loop create them):
+
+| Label | Purpose |
+|-------|---------|
+| `ready` | Issue is ready for the loop to pick up |
+| `in-progress` | Loop is actively working on it |
+| `in-review` | PR created, awaiting review |
+| `done` | Merged and complete |
+| `failed` | Loop failed after retries |
+
+### Milestones
+
+Use GitHub milestones to group issues into planned releases or sprints. When you start the loop, you'll be prompted to pick a milestone — only issues in that milestone will be processed.
+
+Create milestones at `github.com/<owner>/<repo>/milestones/new`. Set due dates to keep yourself on track.
+
+### GitHub Project Board
+
+Alpha Loop reads issues from a GitHub Project board (v2). Issues are processed in board order, so you control priority by reordering. When combined with milestones, only "Todo" items in the selected milestone are processed.
+
+Set the `project` number in your config (find it in your project URL: `github.com/users/<owner>/projects/<number>`).
+
+### Issue Format
+
+Issues work best with structured acceptance criteria. Run `alpha-loop init` to install an issue template:
+
+```markdown
+## Description
+What needs to be done.
+
+## Acceptance Criteria
+- [ ] Specific, testable criterion
+- [ ] Another criterion
+
+## Test Requirements
+- Unit test for X
+- E2E test for Y
+
+## Affected Files/Areas
+- src/...
+- tests/...
+```
+
+## Project Artifacts
+
+| Directory | Git-tracked? | Purpose |
+|-----------|-------------|---------|
+| `.alpha-loop/vision.md` | Yes | Project vision document |
+| `.alpha-loop/context.md` | Yes | Auto-generated project context |
+| `.alpha-loop/learnings/` | Yes | Learning files from each issue + session summaries |
+| `.alpha-loop/sessions/` | No (gitignored) | Session logs, results JSON, screenshots |
+| `.alpha-loop/auth/` | No (gitignored) | Saved browser auth state for verification |
+| `.worktrees/` | No (gitignored) | Temporary git worktrees during processing |
+
+## Development
+
+```bash
+git clone https://github.com/bradtaylorsf/alpha-loop.git
+cd alpha-loop
+pnpm install
+pnpm build
+pnpm test
+
+# Run in development mode
+pnpm dev -- run --dry-run
+```
+
+### Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Runtime | Node.js, TypeScript, ESM |
+| CLI Framework | Commander.js |
+| AI Agents | Any CLI agent (Claude, Codex, OpenCode) |
+| Source of Truth | GitHub (Issues = kanban, PRs = reviews) |
+| Package Manager | pnpm |
+
+## License
+
+MIT

package/agents/implementer.md

@@ -0,0 +1,30 @@
+---
+name: implementer
+description: Implements GitHub issues by writing code, tests, and committing changes
+agent: claude
+model: sonnet
+maxTurns: 30
+permissionMode: acceptEdits
+---
+
+# Implementer Agent
+
+You are an expert software engineer implementing a GitHub issue. Your goal is to write clean, working code that satisfies the issue's acceptance criteria.
+
+## Workflow
+
+1. Read the issue description and acceptance criteria carefully
+2. Explore the codebase to understand existing patterns and conventions
+3. Implement the required changes following project conventions
+4. Write tests for your implementation
+5. Run the test suite to verify everything passes
+6. Commit your changes with a descriptive message
+
+## Guidelines
+
+- Follow existing code style and conventions in the project
+- Write tests for all new functionality
+- Keep changes focused on the issue scope -- do not refactor unrelated code
+- Use meaningful variable and function names
+- Handle edge cases and errors appropriately
+- Ensure all existing tests continue to pass

package/agents/reviewer.md

@@ -0,0 +1,29 @@
+---
+name: reviewer
+description: Reviews pull requests for code quality, correctness, and best practices
+agent: claude
+model: sonnet
+maxTurns: 15
+permissionMode: plan
+---
+
+# Reviewer Agent
+
+You are an expert code reviewer examining a pull request. Your goal is to ensure code quality, correctness, and adherence to project standards.
+
+## Review Checklist
+
+1. **Correctness** -- Does the code do what the issue requires?
+2. **Tests** -- Are there adequate tests? Do they cover edge cases?
+3. **Style** -- Does the code follow project conventions?
+4. **Security** -- Are there any security concerns (injection, XSS, etc.)?
+5. **Performance** -- Are there any obvious performance issues?
+6. **Simplicity** -- Is the code as simple as it can be?
+
+## Guidelines
+
+- Focus on substantive issues, not nitpicks
+- Suggest specific improvements with code examples when possible
+- Approve if the code is good enough, even if not perfect
+- Flag any breaking changes or backward compatibility concerns
+- Check that the PR description accurately describes the changes

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { initCommand } from './commands/init.js';
+import { historyCommand } from './commands/history.js';
+import { scanCommand } from './commands/scan.js';
+import { visionCommand } from './commands/vision.js';
+import { authCommand } from './commands/auth.js';
+import { syncCommand } from './commands/sync.js';
+program
+    .name('alpha-loop')
+    .description('Agent-agnostic automated development loop')
+    .version('1.0.0');
+program
+    .command('init')
+    .description('Create .alpha-loop.yaml config template')
+    .action(initCommand);
+program
+    .command('run')
+    .description('Run the loop — fetches matching issues and processes them all, then exits')
+    .option('--dry-run', 'Preview without changes')
+    .option('--model <model>', 'AI model to use')
+    .option('--skip-tests', 'Skip test execution')
+    .option('--skip-review', 'Skip code review')
+    .option('--skip-learn', 'Skip learning extraction')
+    .option('--milestone <name>', 'Only process issues in this milestone')
+    .option('--auto-merge', 'Auto-merge PRs to session branch')
+    .option('--merge-to <branch>', 'Use existing branch instead of creating session branch')
+    .option('--verbose', 'Stream live agent output to terminal')
+    .action(async (options) => {
+    const { runCommand } = await import('./commands/run.js');
+    await runCommand(options);
+});
+program
+    .command('history [session]')
+    .description('View session history')
+    .option('--qa', 'Show QA checklist for session')
+    .option('--clean', 'Remove old session data')
+    .action(historyCommand);
+program
+    .command('scan')
+    .description('Generate/refresh project context')
+    .action(scanCommand);
+program
+    .command('vision')
+    .description('Interactive project vision setup')
+    .action(visionCommand);
+program
+    .command('auth')
+    .description('Save authenticated browser state')
+    .action(authCommand);
+program
+    .command('sync')
+    .description('Sync AGENTS.md → CLAUDE.md and skills/ → .agents/skills/ + .claude/skills/')
+    .option('--check', 'Check for drift without syncing (exits non-zero if drift found)')
+    .action(syncCommand);
+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":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,2CAA2C,CAAC;KACxD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,2EAA2E,CAAC;KACxF,MAAM,CAAC,WAAW,EAAE,yBAAyB,CAAC;KAC9C,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;KAC5C,MAAM,CAAC,cAAc,EAAE,qBAAqB,CAAC;KAC7C,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC;KAC3C,MAAM,CAAC,cAAc,EAAE,0BAA0B,CAAC;KAClD,MAAM,CAAC,oBAAoB,EAAE,uCAAuC,CAAC;KACrE,MAAM,CAAC,cAAc,EAAE,kCAAkC,CAAC;KAC1D,MAAM,CAAC,qBAAqB,EAAE,wDAAwD,CAAC;KACvF,MAAM,CAAC,WAAW,EAAE,sCAAsC,CAAC;KAC3D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACzD,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,mBAAmB,CAAC;KAC5B,WAAW,CAAC,sBAAsB,CAAC;KACnC,MAAM,CAAC,MAAM,EAAE,+BAA+B,CAAC;KAC/C,MAAM,CAAC,SAAS,EAAE,yBAAyB,CAAC;KAC5C,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,4EAA4E,CAAC;KACzF,MAAM,CAAC,SAAS,EAAE,iEAAiE,CAAC;KACpF,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/auth.d.ts

@@ -0,0 +1 @@
+export declare function authCommand(): Promise<void>;

package/dist/commands/auth.js

@@ -0,0 +1,89 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as readline from 'node:readline';
+import { exec, run } from '../lib/shell.js';
+import { loadConfig } from '../lib/config.js';
+import { log } from '../lib/logger.js';
+function ask(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+    });
+}
+export async function authCommand() {
+    // Check for playwright-cli
+    const whichResult = exec('which playwright-cli');
+    if (whichResult.exitCode !== 0) {
+        log.error('playwright-cli not installed. Install with: npm install -g @playwright/cli@latest');
+        process.exitCode = 1;
+        return;
+    }
+    const config = loadConfig();
+    const projectDir = process.cwd();
+    const authDir = path.join(projectDir, '.alpha-loop', 'auth');
+    fs.mkdirSync(authDir, { recursive: true });
+    console.log('');
+    console.log('\x1b[1m\x1b[36mSave authenticated browser state\x1b[0m');
+    console.log('');
+    console.log('This will open a browser. Log in to your app, then the state');
+    console.log('(cookies, localStorage, sessions) will be saved for future');
+    console.log('verification runs.');
+    console.log('');
+    const defaultUrl = `http://localhost:${config.port ?? 3000}`;
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const customUrl = await ask(rl, `App URL [${defaultUrl}]: `);
+        const appUrl = customUrl || defaultUrl;
+        console.log('');
+        console.log(`Opening browser at ${appUrl}...`);
+        console.log('Log in, then come back here and press Enter to save state.');
+        console.log('');
+        // Open browser in background
+        const browserPromise = run('playwright-cli', ['open', appUrl, '--headed', '--persistent']);
+        await ask(rl, 'Press Enter after you\'ve logged in... ');
+        // Save browser state
+        const saveResult = exec(`playwright-cli state-save "${authDir}/state.json"`);
+        if (saveResult.exitCode !== 0) {
+            log.warn('Could not save state via playwright-cli, trying cookie export...');
+            exec(`playwright-cli cookie-export "${authDir}/cookies.json"`);
+            exec(`playwright-cli localstorage-export "${authDir}/localstorage.json"`);
+        }
+        // Close browser
+        exec('playwright-cli close-all');
+        // Also wait for the background process to finish (it may already be done)
+        await Promise.race([browserPromise, new Promise((r) => setTimeout(r, 2000))]);
+        const stateExists = fs.existsSync(path.join(authDir, 'state.json'));
+        const cookiesExist = fs.existsSync(path.join(authDir, 'cookies.json'));
+        if (stateExists || cookiesExist) {
+            log.success(`Auth state saved to ${authDir}`);
+            console.log('');
+            console.log('Future verification runs will load this state automatically.');
+            console.log("Re-run 'auth' if your session expires.");
+            // Add to .gitignore
+            ensureGitignore(projectDir);
+        }
+        else {
+            log.error('Failed to save auth state');
+            process.exitCode = 1;
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+function ensureGitignore(projectDir) {
+    const gitignorePath = path.join(projectDir, '.gitignore');
+    if (!fs.existsSync(gitignorePath)) {
+        fs.writeFileSync(gitignorePath, '.alpha-loop/auth/\n');
+        log.info('Created .gitignore with .alpha-loop/auth/');
+        return;
+    }
+    const content = fs.readFileSync(gitignorePath, 'utf-8');
+    if (!content.includes('.alpha-loop/auth')) {
+        fs.appendFileSync(gitignorePath, '\n.alpha-loop/auth/\n');
+        log.info('Added .alpha-loop/auth/ to .gitignore');
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/history.d.ts

@@ -0,0 +1,8 @@
+export declare function historyList(sessionsDir: string): void;
+export declare function historyDetail(sessionsDir: string, sessionName: string): void;
+export declare function historyQa(sessionsDir: string, sessionName: string): void;
+export declare function historyClean(sessionsDir: string): void;
+export declare function historyCommand(session: string | undefined, options: {
+    qa?: boolean;
+    clean?: boolean;
+}): void;