dispatch-ai 0.1.0

package/LICENSE

@@ -0,0 +1,229 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work.
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to the Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by the Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding any notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+Copyright 2025-2026 Mehul Patel <nomadicmehul@gmail.com>
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+
+==========================================================================
+Commons Clause License Condition v1.0
+==========================================================================
+
+The Software is provided to you by the Licensor under the License,
+as defined below, subject to the following condition.
+
+Without limiting other conditions in the License, the grant of rights
+under the License will not include, and the License does not grant to
+you, the right to Sell the Software.
+
+For purposes of the foregoing, "Sell" means practicing any or all of
+the rights granted to you under the License to provide to third parties,
+for a fee or other consideration (including without limitation fees for
+hosting or consulting/support services related to the Software), a
+product or service whose value derives, entirely or substantially, from
+the functionality of the Software. Any license notice or attribution
+required by the License must also include this Commons Clause License
+Condition notice.
+
+Software: Dispatch CLI
+License: Apache 2.0
+Licensor: Mehul Patel <nomadicmehul@gmail.com>
+
+==========================================================================
+
+In plain language:
+
+  - You CAN use Dispatch freely for personal and internal use
+  - You CAN modify and create derivative works
+  - You CAN distribute copies with proper attribution
+  - You MUST give credit to the original author
+  - You MUST include this license in any copies or derivatives
+  - You CANNOT sell Dispatch or offer it as a paid service
+  - You CANNOT use it as the basis for a competing commercial product
+
+For commercial licensing or enterprise features, contact:
+nomadicmehul@gmail.com

package/README.md

@@ -0,0 +1,177 @@
+# ⚡ Dispatch
+
+**Dispatch your GitHub issues. Receive pull requests.**
+
+Dispatch is an AI-powered CLI tool that solves GitHub issues in batch — creating branches, implementing fixes, and opening pull requests while you sleep.
+
+Run it at night. Review PRs in the morning.
+
+## Quick Start
+
+```bash
+# Install
+npm install -g dispatch-cli
+
+# Initialize config in your repo
+cd your-repo
+dispatch init
+
+# Set your GitHub token
+export GITHUB_TOKEN=ghp_...
+
+# Solve all open issues
+dispatch run
+
+# Preview what would happen (no changes)
+dispatch run --dry-run
+```
+
+## Commands
+
+### `dispatch run`
+
+Fetches open issues, classifies them, solves each one with AI, and opens pull requests.
+
+```bash
+dispatch run                          # solve all open issues
+dispatch run --dry-run                # preview without making changes
+dispatch run --label bug --label p0   # only solve bugs and P0 issues
+dispatch run --max-issues 5           # limit to 5 issues
+dispatch run --draft                  # create all PRs as drafts
+dispatch run --model opus             # use a specific model
+dispatch run --base-branch develop    # target a different base branch
+```
+
+**What happens:**
+1. Fetches open issues from your GitHub repo
+2. Classifies each issue (bug fix, feature, investigation, audit, docs, refactor)
+3. Prioritizes by labels (P0 → P1 → P2) and reactions
+4. For each issue:
+   - Creates a branch (`dispatch/issue-42-fix-login-bug`)
+   - Invokes Claude Code to solve it
+   - Self-assesses confidence (1-10)
+   - Commits, pushes, and opens a PR
+5. Low-confidence solutions become draft PRs
+6. Generates a morning summary report
+
+### `dispatch create`
+
+Create well-structured GitHub issues from a text description or interactive interview.
+
+```bash
+# From a description
+dispatch create "figure out why the /api/users endpoint is 3x slower than last month"
+
+# Interactive mode — guided interview
+dispatch create --interactive
+
+# Generate without posting
+dispatch create "add rate limiting to public endpoints" --no-post
+```
+
+### `dispatch status`
+
+View results from the last run.
+
+```bash
+dispatch status          # pretty-printed morning report
+dispatch status --json   # raw JSON output
+```
+
+### `dispatch init`
+
+Initialize configuration for your repository.
+
+```bash
+dispatch init       # interactive setup
+dispatch init --yes # use defaults
+```
+
+## Configuration
+
+Dispatch reads `.dispatchrc.json` from your repo root:
+
+```json
+{
+  "engine": "claude",
+  "model": "sonnet",
+  "labels": [],
+  "exclude": ["wontfix", "blocked", "duplicate"],
+  "maxIssues": 10,
+  "maxTurnsPerIssue": 10,
+  "branchPrefix": "dispatch/",
+  "createDraftPRs": false,
+  "autoLabel": true,
+  "baseBranch": "main",
+  "draftThreshold": 5,
+  "stateDir": ".dispatch"
+}
+```
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `engine` | AI backend (`claude`, future: `gemini`) | `claude` |
+| `model` | Model name (`sonnet`, `opus`, `haiku`) | `sonnet` |
+| `labels` | Only process issues with these labels (empty = all) | `[]` |
+| `exclude` | Skip issues with these labels | `["wontfix", "blocked", "duplicate"]` |
+| `maxIssues` | Max issues per run | `10` |
+| `maxTurnsPerIssue` | Max AI turns per issue | `10` |
+| `branchPrefix` | Branch name prefix | `dispatch/` |
+| `createDraftPRs` | Always create draft PRs | `false` |
+| `autoLabel` | Auto-label issues with classification | `true` |
+| `baseBranch` | Base branch for PRs | `main` |
+| `draftThreshold` | Confidence below this → draft PR | `5` |
+
+## Issue Types
+
+Dispatch automatically classifies issues and adapts its approach:
+
+| Type | What it does | Example |
+|------|-------------|---------|
+| **code-fix** | Finds and fixes the bug, adds tests | "Login button returns 500 error" |
+| **feature** | Implements the feature following project patterns | "Add dark mode toggle" |
+| **investigation** | Researches and commits a findings report | "Figure out why API is slow" |
+| **documentation** | Writes or updates docs | "Document the auth flow" |
+| **audit** | Reviews codebase and commits audit report | "Audit for accessibility issues" |
+| **refactor** | Restructures code without behavior changes | "Extract auth logic into service" |
+
+## Confidence Scoring
+
+After solving each issue, the AI self-assesses its confidence (1-10):
+
+- **8-10**: Regular PR — high confidence, ship it
+- **5-7**: Regular PR with "needs-review" notes
+- **1-4**: Draft PR — significant uncertainty, manual review essential
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org) >= 20
+- [Claude Code](https://claude.com/claude-code) installed and authenticated
+- [GitHub token](https://github.com/settings/tokens) with repo access (or `gh auth login`)
+
+## Architecture
+
+```
+dispatch CLI
+├── Commands (run, create, status, init)
+├── GitHub Client (octokit — issues, PRs, labels)
+├── Engine Layer (pluggable AI adapters)
+│   └── Claude Adapter (claude CLI --print)
+│   └── [Future] Gemini Adapter
+├── Orchestrator (pipeline, classifier, planner, scorer)
+├── Reporter (morning summary, run history)
+└── Utils (config, git, logger)
+```
+
+The engine adapter pattern makes adding new AI backends trivial — implement the `AIEngine` interface and you're done.
+
+## Roadmap
+
+- [ ] Gemini CLI adapter
+- [ ] OpenAI adapter
+- [ ] Slack/Discord notifications on run completion
+- [ ] GitHub Action for scheduled runs
+- [ ] Issue decomposition (break large issues into sub-tasks)
+- [ ] Learn from PR review feedback
+- [ ] Parallel issue solving
+- [ ] Web dashboard for run history

package/dist/bin/dispatch.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/bin/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../bin/dispatch.ts"],"names":[],"mappings":""}

package/dist/bin/dispatch.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { Command } from "commander";
+import chalk from "chalk";
+import { registerRunCommand } from "../src/commands/run.js";
+import { registerCreateCommand } from "../src/commands/create.js";
+import { registerStatusCommand } from "../src/commands/status.js";
+import { registerInitCommand } from "../src/commands/init.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "..", "package.json"), "utf-8"));
+const program = new Command();
+program
+    .name("dispatch")
+    .description(chalk.bold("Dispatch") +
+    " — Dispatch your GitHub issues. Receive pull requests.\n\n" +
+    "  AI-powered batch issue solver that turns your open issues into\n" +
+    "  pull requests while you sleep.")
+    .version(pkg.version);
+// Register subcommands
+registerRunCommand(program);
+registerCreateCommand(program);
+registerStatusCommand(program);
+registerInitCommand(program);
+// Default action (no subcommand)
+program.action(() => {
+    console.log();
+    console.log(chalk.bold.cyan("  ⚡ dispatch") + chalk.gray(" — AI-powered issue solver"));
+    console.log();
+    console.log(chalk.gray("  Dispatch your issues. Receive pull requests."));
+    console.log();
+    console.log(`  ${chalk.yellow("dispatch run")}        Solve open issues and create PRs`);
+    console.log(`  ${chalk.yellow("dispatch create")}     Create well-structured issues`);
+    console.log(`  ${chalk.yellow("dispatch status")}     View last run summary`);
+    console.log(`  ${chalk.yellow("dispatch init")}       Initialize config for this repo`);
+    console.log();
+    console.log(chalk.gray("  Run dispatch --help for full options."));
+    console.log();
+});
+program.parse();
+//# sourceMappingURL=dispatch.js.map

package/dist/bin/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../bin/dispatch.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3F,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CACV,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;IACtB,4DAA4D;IAC5D,oEAAoE;IACpE,kCAAkC,CACnC;KACA,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,uBAAuB;AACvB,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,iCAAiC;AACjC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE;IAClB,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;IACxF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,0CAA0C,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,oCAAoC,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,4BAA4B,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,wCAAwC,CAAC,CAAC;IACxF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/commands/create.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerCreateCommand(program: Command): void;
+//# sourceMappingURL=create.d.ts.map

package/dist/src/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAsFrD"}

package/dist/src/commands/create.js

@@ -0,0 +1,154 @@
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { loadConfig } from "../utils/config.js";
+import { getRepoInfo } from "../utils/git.js";
+import { GitHubClient } from "../github/client.js";
+import { ClaudeEngine } from "../engine/claude.js";
+import { log } from "../utils/logger.js";
+export function registerCreateCommand(program) {
+    program
+        .command("create [description]")
+        .description("Create a well-structured GitHub issue from a description or interactive interview")
+        .option("-i, --interactive", "Use interactive interview mode")
+        .option("--no-post", "Generate the issue but don't post it to GitHub")
+        .option("--engine <engine>", "AI engine to use")
+        .option("--model <model>", "Model to use")
+        .action(async (description, options) => {
+        try {
+            const cwd = process.cwd();
+            const config = await loadConfig(cwd);
+            const { owner, repo } = await getRepoInfo(cwd);
+            // Get description from interactive mode or argument
+            let finalDescription;
+            if (options.interactive || !description) {
+                finalDescription = await interactiveInterview();
+            }
+            else {
+                finalDescription = description;
+            }
+            if (!finalDescription.trim()) {
+                log.error("No description provided.");
+                process.exit(1);
+            }
+            log.info("Generating structured issue with AI...\n");
+            // Use AI to structure the issue
+            const engine = new ClaudeEngine({
+                model: options.model || config.model,
+                maxTurns: 3,
+            });
+            const structured = await engine.createIssue(finalDescription, {
+                owner,
+                repo,
+                baseBranch: config.baseBranch,
+                cwd,
+            });
+            // Preview
+            console.log(chalk.bold.cyan("\n━━━ Issue Preview ━━━\n"));
+            console.log(chalk.bold(`Title: ${structured.title}`));
+            console.log(chalk.gray(`Labels: ${structured.labels.join(", ")}`));
+            console.log(chalk.gray("─".repeat(50)));
+            console.log(structured.body);
+            console.log(chalk.gray("─".repeat(50)));
+            if (options.post === false) {
+                log.info("Issue generated (not posted — use without --no-post to publish).");
+                return;
+            }
+            // Confirm before posting
+            const { confirm } = await inquirer.prompt([
+                {
+                    type: "confirm",
+                    name: "confirm",
+                    message: "Post this issue to GitHub?",
+                    default: true,
+                },
+            ]);
+            if (!confirm) {
+                log.info("Issue not posted.");
+                return;
+            }
+            // Post to GitHub
+            const github = await GitHubClient.create(owner, repo);
+            const issue = await github.createIssue({
+                title: structured.title,
+                body: structured.body,
+                labels: structured.labels,
+            });
+            console.log();
+            log.success(`Issue #${issue.number} created: ${chalk.underline(issue.url)}`);
+        }
+        catch (err) {
+            log.error(`Create failed: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+async function interactiveInterview() {
+    console.log(chalk.bold.cyan("\n━━━ Issue Interview ━━━\n"));
+    console.log(chalk.gray("Answer a few questions and I'll create a well-structured issue.\n"));
+    const answers = await inquirer.prompt([
+        {
+            type: "list",
+            name: "type",
+            message: "What kind of task is this?",
+            choices: [
+                { name: "🐛 Bug fix — something is broken", value: "bug" },
+                { name: "✨ Feature — add new functionality", value: "feature" },
+                { name: "🔍 Investigation — research or figure something out", value: "investigation" },
+                { name: "📝 Documentation — write or update docs", value: "documentation" },
+                { name: "🔒 Audit — review codebase for issues", value: "audit" },
+                { name: "♻️ Refactor — restructure without behavior change", value: "refactor" },
+            ],
+        },
+        {
+            type: "input",
+            name: "what",
+            message: "What needs to be done? (describe in your own words)",
+            validate: (input) => input.trim().length > 0 || "Please provide a description",
+        },
+        {
+            type: "input",
+            name: "where",
+            message: "Where in the codebase? (files, modules, or 'not sure')",
+            default: "not sure",
+        },
+        {
+            type: "input",
+            name: "why",
+            message: "Why is this needed? (context, impact, urgency)",
+            default: "",
+        },
+        {
+            type: "input",
+            name: "acceptance",
+            message: "How will we know it's done? (acceptance criteria, or leave blank)",
+            default: "",
+        },
+        {
+            type: "list",
+            name: "priority",
+            message: "Priority?",
+            choices: [
+                { name: "🔴 Critical (P0)", value: "P0" },
+                { name: "🟠 High (P1)", value: "P1" },
+                { name: "🟡 Medium (P2)", value: "P2" },
+                { name: "🟢 Low (P3)", value: "P3" },
+            ],
+            default: "P2",
+        },
+    ]);
+    // Compose a description for AI to structure
+    let description = `Type: ${answers.type}\n`;
+    description += `Task: ${answers.what}\n`;
+    if (answers.where !== "not sure") {
+        description += `Location in codebase: ${answers.where}\n`;
+    }
+    if (answers.why) {
+        description += `Context/Why: ${answers.why}\n`;
+    }
+    if (answers.acceptance) {
+        description += `Acceptance criteria: ${answers.acceptance}\n`;
+    }
+    description += `Priority: ${answers.priority}`;
+    return description;
+}
+//# sourceMappingURL=create.js.map

package/dist/src/commands/create.js.map

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

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

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerInitCommand(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QA+FnD"}