bemadralphy 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hxp-pxh
+
+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,468 @@
+# BeMadRalphy
+
+**Be**(ads) + (B)**Mad** + **Ralphy** + [OpenSpec](https://github.com/Fission-AI/OpenSpec) — four tools, one pipeline, zero gaps. **CLI-only.**
+
+> End-to-end automated coding: idea in → planning → task graph → swarm-aware execution → living specs → deployment.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## Status
+
+BeMadRalphy runs end-to-end locally with real external CLI integrations.
+
+Current implementation includes:
+
+- `idea.md`/`plan.md` intake with `.bemadralphy/intake.yaml` output
+- BMAD bootstrap (`bmad install`) and generated planning artifacts under `_bmad-output/`
+- Steering file generation (AGENTS.md, CLAUDE.md, Cursor/Windsurf/Cline/Kiro rules)
+- `tasks.md` generation plus Beads sync (`bd init`, `bd create`, `bd ready`, `bd close`, `bd update`)
+- Per-phase state persistence in `.bemadralphy/state.yaml`
+- Engine execution through explicit CLI contracts for all supported engines
+- OpenSpec lifecycle integration (`openspec init`, `openspec validate`, `openspec archive`)
+
+---
+
+## Start Here
+
+- First local run guide: [`docs/getting-started.md`](docs/getting-started.md)
+- Contributor/developer setup: [`docs/onboarding.md`](docs/onboarding.md)
+- Architecture and flow details: [`docs/architecture.md`](docs/architecture.md)
+
+---
+
+## What is BeMadRalphy?
+
+BeMadRalphy is a CLI orchestrator that merges:
+
+- **[BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD)** — Agile AI-driven planning (product briefs, PRDs, architecture, epics & stories)
+- **[Beads](https://github.com/steveyegge/beads)** — Git-backed graph issue tracker and persistent AI memory
+- **[Ralphy](https://github.com/michaelshimeles/ralphy)** — Autonomous AI coding loop with multi-engine support ([site](https://ralphy.goshen.fyi/))
+- **[OpenSpec](https://github.com/Fission-AI/OpenSpec)** — Living specifications and delta-based change tracking
+
+Into a single, seamless pipeline that takes you from a rough idea to a deployed, documented, and tested codebase — with minimal human intervention.
+
+---
+
+## The 9-Phase Pipeline
+
+```mermaid
+flowchart TD
+  subgraph explore [Phase 0: Explore]
+    ExploreCmd[bemadralphy explore]
+    ExploreReport[Exploration report]
+  end
+  subgraph intake [Phase 1: Idea Intake]
+    IdeaMD[idea.md]
+    DetectMode{Greenfield or brownfield?}
+    IntakeYAML[intake.yaml]
+  end
+  subgraph planning [Phase 2: Planning]
+    Brief[Product brief]
+    PRD[PRD]
+    Arch[Architecture]
+    Stories[Epics and stories]
+  end
+  subgraph steer [Phase 3: Agent Steering]
+    AllFiles[14+ steering files]
+  end
+  subgraph scaffold [Phase 4: Scaffolding]
+    GitInit[git init + monorepo]
+    PkgJson[package.json]
+  end
+  subgraph tasks [Phase 5: Task Sync]
+    Beads[(Beads graph)]
+    TasksMD[tasks.md]
+  end
+  subgraph exec [Phase 6: Execution]
+    Detect{Swarm capable?}
+    NativeSwarm[Native swarm]
+    ProcessParallel[Process parallel]
+  end
+  subgraph verify [Phase 7: Verification]
+    Completeness[Completeness]
+    Correctness[Correctness]
+    Coherence[Coherence]
+  end
+  subgraph post [Phase 8: Post-Execution]
+    CodeReview[Code review]
+    Docs[Documentation]
+    Deploy[Deployment]
+  end
+  ExploreCmd --> ExploreReport --> IdeaMD
+  IdeaMD --> DetectMode --> IntakeYAML
+  IntakeYAML --> Brief --> PRD --> Arch --> Stories
+  Stories --> AllFiles --> GitInit --> PkgJson
+  PkgJson --> Beads --> TasksMD
+  TasksMD --> Detect
+  Detect -->|yes| NativeSwarm
+  Detect -->|no| ProcessParallel
+  NativeSwarm --> Completeness
+  ProcessParallel --> Completeness
+  Completeness --> Correctness --> Coherence
+  Coherence --> CodeReview --> Docs --> Deploy
+```
+
+| Phase                 | What happens                                                                                                           |
+| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| **0. Explore**        | Optional. Investigate codebase (brownfield) or problem domain (greenfield) before committing to a plan.                |
+| **1. Idea Intake**    | Read `idea.md`, detect greenfield vs brownfield, classify project type, ask remaining questions, output `intake.yaml`. |
+| **2. Planning**       | Greenfield: product brief → PRD → architecture → stories. Brownfield: proposal → spec deltas → design → tasks.         |
+| **3. Agent Steering** | Generate 14+ steering files for every IDE/agent (Cursor, Claude, Copilot, Windsurf, Cline, Kiro, etc.).                |
+| **4. Scaffolding**    | `git init`, monorepo structure, `package.json`, `.gitignore`, `.env`, test/lint/CI configs.                            |
+| **5. Task Sync**      | Convert stories to Beads issues (`bd create`, `bd dep add`). Generate `tasks.md`. Cost estimate.                       |
+| **6. Execution**      | Swarm-aware Beads-driven loop. Native swarm for Claude/Kimi/Codex; process-level parallelism for others.               |
+| **7. Verification**   | Semantic check: completeness, correctness, coherence. Fix-up tasks fed back to Beads if needed.                        |
+| **8. Post-Execution** | Code review, full docs suite, living specs, deployment, release management, final summary.                             |
+
+---
+
+## AI Engine Support
+
+- `claude` (native swarm): `ralphy --claude --max-iterations 1 <task>`
+- `kimi` (native swarm): `kimi <task>`
+- `codex` (native swarm): `ralphy --codex --max-iterations 1 <task>`
+- `cursor`: `ralphy --cursor --max-iterations 1 <task>`
+- `opencode`: `ralphy --opencode --max-iterations 1 <task>`
+- `qwen`: `ralphy --qwen --max-iterations 1 <task>`
+- `copilot`: `ralphy --copilot --max-iterations 1 <task>`
+- `gemini`: `gemini <task>`
+- `ralphy`: `ralphy --max-iterations 1 <task>`
+
+---
+
+## Autonomy Modes
+
+| Mode                                 | Description                                                                                      |
+| ------------------------------------ | ------------------------------------------------------------------------------------------------ |
+| **Full Autonomous** (`--mode auto`)  | Zero pauses after Q&A. Everything runs unattended.                                               |
+| **Hybrid** (`--mode hybrid`)         | Planning gates only (after brief, PRD, architecture, stories). Execution is autonomous. Default. |
+| **Supervised** (`--mode supervised`) | Planning gates + execution milestones (after scaffolding, each epic, before deployment).         |
+
+---
+
+## CLI Commands
+
+```bash
+# Initialize a new project
+npx bemadralphy init
+
+# Notes:
+# - Creates .bemadralphy/, openspec/, and _bmad-output/
+# - Initializes `bd` and `openspec`
+# - Fails fast if required CLIs are missing
+
+# Run the full pipeline
+npx bemadralphy run
+
+# Run with specific options
+npx bemadralphy run --mode auto --engine claude --max-parallel 5 --budget 50
+
+# Explore before planning (optional)
+npx bemadralphy explore "How should I structure authentication?"
+
+# Check pipeline status
+npx bemadralphy status
+```
+
+---
+
+## The `idea.md` File
+
+BeMadRalphy starts with an `idea.md` file in your project root. It can be as simple or detailed as you want. The current scaffolding writes intake results to `.bemadralphy/intake.yaml`.
+
+### Minimal example
+
+```markdown
+I want to build a SaaS dashboard for tracking fitness goals.
+```
+
+### Detailed example with YAML front-matter
+
+```yaml
+---
+project_type: full-stack
+stack:
+  frontend: Next.js
+  backend: Hono
+  language: TypeScript
+runtime: bun
+monorepo: true
+database: Postgres
+auth: Clerk
+tests: Vitest
+deployment: Vercel
+---
+
+A SaaS dashboard for tracking fitness goals. Users can log workouts,
+track progress over time, set goals, and get AI-powered recommendations.
+
+Key features:
+- User authentication with social login
+- Workout logging with exercise library
+- Progress charts and analytics
+- Goal setting and tracking
+- AI coach for personalized recommendations
+```
+
+BeMadRalphy extracts what you've already decided and only asks about the rest.
+
+---
+
+## Greenfield vs Brownfield
+
+| Mode           | When                       | What happens                                                                         |
+| -------------- | -------------------------- | ------------------------------------------------------------------------------------ |
+| **Greenfield** | No existing codebase       | Full pipeline: idea → PRD → architecture → stories → build from scratch              |
+| **Brownfield** | Existing codebase detected | Analyze codebase, generate proposal + spec deltas, skip scaffolding, execute changes |
+
+Brownfield is auto-detected (looks for `package.json`, `src/`, etc.) or forced with `--brownfield`.
+
+---
+
+## Living Specs (OpenSpec-compatible)
+
+After the initial build, BeMadRalphy generates living specifications in `openspec/specs/`:
+
+```text
+openspec/
+├── specs/
+│   ├── auth/spec.md
+│   ├── workouts/spec.md
+│   └── goals/spec.md
+├── changes/
+│   └── archive/
+```
+
+For subsequent brownfield changes, new requirements are expressed as **delta specs** (ADDED/MODIFIED/REMOVED) against the current specs. On completion, deltas merge into the main specs.
+
+---
+
+## Target Project Structure (after scaffolding)
+
+```text
+your-project/
+├── .bemadralphy/          # State, cost log, failures log, intake.yaml
+│   ├── state.yaml
+│   ├── cost.log
+│   └── failures.log
+├── .beads/                # Beads task graph
+│   └── issues.jsonl
+├── _bmad/                 # BMAD playbooks (read-only)
+├── _bmad-output/          # Planning artifacts
+│   ├── product-brief.md
+│   ├── prd.md
+│   ├── architecture.md
+│   └── stories/
+├── openspec/              # Living specs
+│   └── specs/
+├── docs/
+│   ├── adr/               # Architecture Decision Records
+│   ├── onboarding.md
+│   └── runbook.md
+├── src/                   # Your application code
+├── tests/
+├── .github/
+│   ├── workflows/
+│   ├── ISSUE_TEMPLATE/
+│   └── pull_request_template.md
+├── AGENTS.md              # Universal agent steering
+├── CLAUDE.md              # Claude-specific steering
+├── .cursorrules           # Cursor-specific steering
+├── idea.md                # Your original idea
+├── .bemadralphy/intake.yaml  # Processed intake
+├── tasks.md               # Human-readable task list
+├── package.json
+└── README.md
+```
+
+---
+
+## Configuration (planned)
+
+### `.bemadralphy/state.yaml`
+
+Tracks pipeline state for resumability:
+
+```yaml
+phase: execution
+mode: hybrid
+engine: claude
+last_gate: architecture
+tasks_completed: 12
+tasks_total: 24
+cost_usd: 3.47
+```
+
+### Flags
+
+| Flag                              | Description                             |
+| --------------------------------- | --------------------------------------- |
+| `--mode auto\|hybrid\|supervised` | Autonomy mode                           |
+| `--engine <name>`                 | AI engine to use                        |
+| `--planning-engine <name>`        | Override engine for planning phase only |
+| `--max-parallel N`                | Max parallel tasks (default: 3)         |
+| `--budget N`                      | Cost cap in USD                         |
+| `--brownfield`                    | Force brownfield mode                   |
+| `--swarm native\|process\|off`    | Override swarm detection                |
+| `--create-pr`                     | Create PRs for each task                |
+
+---
+
+## Installation
+
+### Quick Install (Recommended)
+
+```bash
+# npm
+npm install -g bemadralphy
+
+# pnpm
+pnpm add -g bemadralphy
+
+# bun
+bun add -g bemadralphy
+
+# yarn
+yarn global add bemadralphy
+
+# or use the install script
+curl -fsSL https://raw.githubusercontent.com/hxp-pxh/BeMadRalphy/main/install.sh | bash
+```
+
+### Docker
+
+```bash
+# Pull from GitHub Container Registry
+docker pull ghcr.io/hxp-pxh/bemadralphy:latest
+
+# Run
+docker run -v $(pwd):/workspace ghcr.io/hxp-pxh/bemadralphy init
+```
+
+For detailed first-run setup, see [`docs/getting-started.md`](docs/getting-started.md).
+
+### Install required external CLIs
+
+```bash
+# Ralphy
+sudo npm install -g ralphy-cli
+
+# BMAD
+sudo npm install -g bmad-method
+
+# Beads
+sudo npm install -g @beads/bd
+
+# OpenSpec
+sudo npm install -g @fission-ai/openspec
+```
+
+Verify:
+
+```bash
+ralphy --version
+bmad --version
+bd --version
+openspec --version
+```
+
+### Install BeMadRalphy dependencies
+
+```bash
+npm install
+npm run build
+node dist/cli.js --help
+```
+
+### Prerequisites
+
+- Node.js 18+ or Bun 1.0+
+- Git
+- Ralphy CLI (`ralphy`) for execution fallback and parallel orchestration
+- BMAD CLI (`bmad`)
+- Beads CLI (`bd`)
+- OpenSpec CLI (`openspec`)
+
+## Fail-Fast Behavior
+
+`init` and `run` are strict by design for local-product reliability:
+
+- Missing required CLIs fail immediately with actionable errors.
+- Planning fails if BMAD command fails or required artifacts are missing.
+- Sync fails if stories cannot be parsed or Beads writes fail.
+- Execute fails for unknown/unavailable engines.
+- Verify/Post fail if OpenSpec commands fail.
+
+Typical recovery flow:
+
+```bash
+# 1) Verify toolchain
+ralphy --version && bmad --version && bd --version && openspec --version
+
+# 2) Re-run setup and checks
+npm install
+npm run verify
+node dist/cli.js init
+
+# 3) Run pipeline
+node dist/cli.js run --mode auto --engine ralphy
+```
+
+---
+
+## Quick Start
+
+```bash
+# 1. Create a new directory
+mkdir my-awesome-app && cd my-awesome-app
+
+# 2. Initialize BeMadRalphy
+npx bemadralphy init
+
+# 3. Write your idea
+echo "A todo app with real-time sync and offline support" > idea.md
+
+# 4. Run the pipeline
+npx bemadralphy run
+```
+
+For full expected outputs and fail-fast troubleshooting, see [`docs/getting-started.md`](docs/getting-started.md).
+
+That's it. BeMadRalphy will:
+
+1. Ask clarifying questions about your stack preferences
+2. Generate a full PRD and architecture
+3. Create all the steering files for your AI agents
+4. Scaffold the project
+5. Execute all tasks with tests
+6. Verify the implementation
+7. Generate documentation and deploy
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on:
+
+- Fork/clone workflow
+- Branch naming conventions
+- Commit message format
+- PR process
+- Code standards
+
+---
+
+## License
+
+[MIT](LICENSE) — Copyright (c) 2026 hxp-pxh
+
+---
+
+## Acknowledgments
+
+BeMadRalphy builds on the shoulders of giants:
+
+- [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) — The planning framework
+- [Beads](https://github.com/steveyegge/beads) — The task graph and memory layer
+- [Ralphy](https://github.com/michaelshimeles/ralphy) — The execution loop inspiration ([site](https://ralphy.goshen.fyi/))
+- [OpenSpec](https://github.com/Fission-AI/OpenSpec) — The living spec model

package/dist/beads/adapter.d.ts

@@ -0,0 +1,5 @@
+export type ParsedTask = {
+    id: string;
+    title: string;
+};
+export declare function storiesToBeads(storyPaths: string[]): Promise<ParsedTask[]>;

package/dist/beads/adapter.js

@@ -0,0 +1,16 @@
+import { readFile } from 'node:fs/promises';
+export async function storiesToBeads(storyPaths) {
+    const tasks = [];
+    let counter = 1;
+    for (const storyPath of storyPaths) {
+        const contents = await readFile(storyPath, 'utf-8');
+        const lines = contents.split(/\r?\n/);
+        for (const line of lines) {
+            if (line.startsWith('### ')) {
+                tasks.push({ id: `bd-${counter++}`, title: line.replace(/^###\s+/, '') });
+            }
+        }
+    }
+    return tasks;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/beads/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/beads/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAO5C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAoB;IACvD,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/beads/index.d.ts

@@ -0,0 +1,3 @@
+export { storiesToBeads } from './adapter.js';
+export { renderTasksMarkdown } from './tasks-md.js';
+export { BeadsWriter } from './writer.js';

package/dist/beads/index.js

@@ -0,0 +1,4 @@
+export { storiesToBeads } from './adapter.js';
+export { renderTasksMarkdown } from './tasks-md.js';
+export { BeadsWriter } from './writer.js';
+//# sourceMappingURL=index.js.map

package/dist/beads/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/beads/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/beads/parse-tasks.d.ts

@@ -0,0 +1,2 @@
+import type { TaskSummary } from './tasks-md.js';
+export declare function parseTasksMarkdown(contents: string): TaskSummary[];

package/dist/beads/parse-tasks.js

@@ -0,0 +1,12 @@
+export function parseTasksMarkdown(contents) {
+    const lines = contents.split(/\r?\n/).filter((line) => line.startsWith('|'));
+    const rows = lines
+        .map((line) => line.split('|').map((part) => part.trim()))
+        .filter((parts) => parts.length >= 4 && parts[1] !== 'ID' && parts[1] !== '---');
+    return rows.map((parts) => ({
+        id: parts[1],
+        title: parts[2],
+        status: parts[3],
+    }));
+}
+//# sourceMappingURL=parse-tasks.js.map

package/dist/beads/parse-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-tasks.js","sourceRoot":"","sources":["../../src/beads/parse-tasks.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;SACzD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;IACnF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1B,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;QACZ,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACf,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;KACjB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/beads/tasks-md.d.ts

@@ -0,0 +1,6 @@
+export type TaskSummary = {
+    id: string;
+    title: string;
+    status: string;
+};
+export declare function renderTasksMarkdown(tasks: TaskSummary[]): string;

package/dist/beads/tasks-md.js

@@ -0,0 +1,8 @@
+export function renderTasksMarkdown(tasks) {
+    const lines = ['# Tasks', '', '| ID | Title | Status |', '| --- | --- | --- |'];
+    for (const task of tasks) {
+        lines.push(`| ${task.id} | ${task.title} | ${task.status} |`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=tasks-md.js.map

package/dist/beads/tasks-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-md.js","sourceRoot":"","sources":["../../src/beads/tasks-md.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACtD,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,EAAE,EAAE,yBAAyB,EAAE,qBAAqB,CAAC,CAAC;IAChF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/beads/writer.d.ts

@@ -0,0 +1,12 @@
+export declare class BeadsWriter {
+    private queue;
+    private availablePromise;
+    private cwd;
+    constructor(projectRoot: string);
+    isAvailable(): Promise<boolean>;
+    init(): Promise<void>;
+    create(title: string, body: string): Promise<string>;
+    update(id: string, body: string): Promise<void>;
+    close(id: string): Promise<void>;
+    private enqueue;
+}

package/dist/beads/writer.js

@@ -0,0 +1,60 @@
+import { commandExists, runCommand } from '../utils/exec.js';
+import { logInfo } from '../utils/logging.js';
+export class BeadsWriter {
+    queue = Promise.resolve();
+    availablePromise;
+    cwd;
+    constructor(projectRoot) {
+        this.cwd = projectRoot;
+        this.availablePromise = commandExists('bd');
+    }
+    async isAvailable() {
+        return this.availablePromise;
+    }
+    async init() {
+        await this.enqueue(async () => {
+            if (!(await this.isAvailable())) {
+                logInfo('BeadsWriter: bd not available; skipping init');
+                return;
+            }
+            await runCommand('bd', ['init'], this.cwd);
+        });
+    }
+    async create(title, body) {
+        return this.enqueue(async () => {
+            if (!(await this.isAvailable())) {
+                throw new Error('BeadsWriter.create: bd not available');
+            }
+            const { stdout } = await runCommand('bd', ['create', title, '--body', body], this.cwd);
+            const id = stdout.trim();
+            if (!id) {
+                throw new Error('BeadsWriter.create: bd did not return an issue id');
+            }
+            return id;
+        });
+    }
+    async update(id, body) {
+        await this.enqueue(async () => {
+            if (!(await this.isAvailable())) {
+                logInfo('BeadsWriter.update: bd not available; skipping');
+                return;
+            }
+            await runCommand('bd', ['update', id, '--body', body], this.cwd);
+        });
+    }
+    async close(id) {
+        await this.enqueue(async () => {
+            if (!(await this.isAvailable())) {
+                logInfo('BeadsWriter.close: bd not available; skipping');
+                return;
+            }
+            await runCommand('bd', ['close', id], this.cwd);
+        });
+    }
+    enqueue(fn) {
+        const next = this.queue.then(fn, fn);
+        this.queue = next.then(() => undefined, () => undefined);
+        return next;
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/beads/writer.js.map

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

package/dist/cli.d.ts

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