@codefresh-io/gitops-release 1.0.1 → 1.2.0

package/README.md

@@ -21,6 +21,7 @@ If you prefer not to use this CLI (or don't have an Anthropic API key for AI rel
 
 - `GITHUB_TOKEN` environment variable with `repo` scope
 - `ANTHROPIC_API_KEY` environment variable (only for `notes` command)
+  - **Codefresh team:** Find this in 1Password under "Anthropic API Key - GitOps Release CLI"
 
 ## Usage
 
@@ -186,6 +187,57 @@ gitops-release cherry-pick 0.26 abc1234 --dry-run
 **Requirements:**
 - Must be run from within a local git checkout of the repository
 
+### `chat`
+
+Start an interactive AI agent for release management. Instead of memorizing CLI commands, describe what you want in natural language.
+
+```bash
+# Start the chat agent
+gitops-release chat
+
+# With verbose output (shows session info and costs)
+gitops-release chat --verbose
+```
+
+**Options:**
+| Flag | Description |
+|------|-------------|
+| `-v, --verbose` | Show session details and API costs |
+
+**Requirements:**
+- `ANTHROPIC_API_KEY` environment variable
+- Interactive terminal (TTY)
+
+**Example session:**
+```
+$ gitops-release chat
+GitOps Release Agent [Experimental]
+
+A conversational interface for managing GitOps runtime releases.
+Ask questions like:
+  • "What releases are in progress?"
+  • "Show me the status of v0.27"
+  • "Generate release notes for 0.27.0"
+  • "Create a new release branch for 0.28"
+
+Read operations auto-execute. Write operations require confirmation.
+Type 'exit' to quit.
+
+gitops> What's the current release status?
+[Agent runs gitops-release status and explains the results]
+
+gitops> Create a new release for 0.28
+The agent wants to run:
+  gitops-release create 0.28
+
+Allow this operation? (y/N)
+```
+
+**Security:**
+- Read-only commands (status, list, notes) execute automatically
+- Write commands (create, publish, notes --apply) require explicit confirmation
+- Only gitops-release CLI commands are allowed
+
 ### `completion <shell>`
 
 Generate shell completion script.
@@ -242,6 +294,21 @@ gitops-release status 0.26
 gitops-release publish 0.26.6
 ```
 
+### Using the Chat Agent
+
+```bash
+# Start the interactive agent
+gitops-release chat
+
+# Then have a conversation:
+# > "What releases are in progress?"
+# > "Show me the status of 0.27"
+# > "The PR looks good, let's publish it"
+# > "exit"
+```
+
+The agent understands context, so you can have natural conversations about releases without needing to remember exact command syntax.
+
 ### CI/Scripted Usage
 
 ```bash
@@ -269,7 +336,7 @@ gitops-release status 0.27 --json | jq '.ready_to_publish'
 | Variable | Required | Description |
 |----------|----------|-------------|
 | `GITHUB_TOKEN` | Yes | GitHub API token with `repo` scope |
-| `ANTHROPIC_API_KEY` | For `notes` | Anthropic API key for AI release notes |
+| `ANTHROPIC_API_KEY` | For `notes`, `chat` | Anthropic API key for AI features |
 | `NO_COLOR` | No | Disable colors when set |
 | `EDITOR` | No | Editor for `notes --edit` (default: vim) |
 
@@ -325,7 +392,13 @@ src/
 │   ├── list.ts           # List releases
 │   ├── notes.ts          # AI-powered release notes
 │   ├── cherry-pick.ts    # Cherry-pick commits
+│   ├── chat.ts           # Interactive AI agent
 │   └── completion.ts     # Shell completion
+├── agent/
+│   ├── index.ts          # Agent module exports
+│   ├── prompts.ts        # System prompt for the agent
+│   ├── hooks.ts          # Permission control (canUseTool)
+│   └── repl.ts           # Interactive REPL implementation
 ├── services/
 │   ├── github.ts         # GitHub API wrapper (Octokit)
 │   ├── version.ts        # Version parsing/validation

package/dist/agent/hooks.d.ts

@@ -0,0 +1,12 @@
+import type { CanUseTool } from "@anthropic-ai/claude-agent-sdk";
+/**
+ * Creates the canUseTool callback for permission control.
+ *
+ * This callback:
+ * - Handles AskUserQuestion tool for interactive user choices
+ * - Auto-allows only known read operations (gitops-release status, list, notes without --apply)
+ * - Prompts for confirmation on write operations and unknown commands
+ * - Denies all other tools
+ */
+export declare function createPermissionHandler(): CanUseTool;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/agent/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/agent/hooks.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,gCAAgC,CAAC;AA0LnF;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,IAAI,UAAU,CAgCpD"}

package/dist/agent/hooks.js

@@ -0,0 +1,181 @@
+// ABOUTME: Permission control for the release management agent.
+// ABOUTME: Implements canUseTool callback to auto-allow reads and confirm writes.
+import { confirm, select, checkbox, input, Separator } from "@inquirer/prompts";
+import { ExitPromptError } from "@inquirer/core";
+import { getChalk } from "../output/formatter.js";
+const c = getChalk({ noColor: process.env.NO_COLOR !== undefined });
+/** Sentinel value to identify the "Other" option in select/checkbox prompts. */
+const OTHER_OPTION = "__OTHER__";
+/**
+ * Commands that are read-only and can be auto-executed.
+ */
+const READ_COMMANDS = ["status", "list"];
+/**
+ * Commands that modify state and require confirmation.
+ */
+const WRITE_COMMANDS = ["create", "publish", "cherry-pick"];
+/**
+ * Extracts the gitops-release subcommand from a bash command string.
+ * Returns null if not a gitops-release command.
+ *
+ * Handles various invocation methods:
+ * - gitops-release status
+ * - npx gitops-release status
+ * - npx @codefresh-io/gitops-release status
+ * - npx @codefresh-io/gitops-release@1.0.0 status
+ */
+function extractGitopsCommand(bashCommand) {
+    const match = bashCommand.match(/gitops-release(?:@[\w.-]+)?\s+(\w+)/);
+    return match ? match[1] : null;
+}
+/**
+ * Classifies a bash command as read, write, or unknown.
+ * Consolidates all command classification logic in one place.
+ */
+function classifyCommand(bashCommand) {
+    const command = extractGitopsCommand(bashCommand);
+    if (!command)
+        return "unknown";
+    if (WRITE_COMMANDS.includes(command))
+        return "write";
+    if (READ_COMMANDS.includes(command))
+        return "read";
+    // notes is a special case: read by default, write with --apply
+    if (command === "notes") {
+        return bashCommand.includes("--apply") ? "write" : "read";
+    }
+    return "unknown";
+}
+/** Messages returned when user declines or cancels an operation. */
+const DENY_MESSAGES = {
+    declined: "User declined the operation. Ask what they would like to do instead.",
+    cancelled: "User cancelled the prompt. Ask what they would like to do instead.",
+};
+/**
+ * Builds choices array for select/checkbox prompts with an "Other" option.
+ */
+function buildChoices(options) {
+    return [
+        ...options.map((opt) => ({
+            name: opt.description ? `${opt.label} ${c.dim(`- ${opt.description}`)}` : opt.label,
+            value: opt.label,
+        })),
+        new Separator(),
+        { name: "Other", value: OTHER_OPTION },
+    ];
+}
+/**
+ * Handles the AskUserQuestion tool with arrow-key navigation.
+ * Single-select: select prompt with "Other" option for custom input.
+ * Multi-select: checkbox prompt with "Other" option for custom input.
+ */
+async function handleAskUserQuestion(questionInput) {
+    const answers = {};
+    try {
+        for (const q of questionInput.questions) {
+            if (q.multiSelect) {
+                // Multi-select: checkbox with "Other" option
+                const selected = await checkbox({
+                    message: q.question,
+                    choices: buildChoices(q.options),
+                    loop: false,
+                });
+                let results = selected.filter((s) => s !== OTHER_OPTION);
+                // If "Other" was selected, prompt for custom value
+                if (selected.includes(OTHER_OPTION)) {
+                    const custom = await input({ message: "Please specify:", required: true });
+                    results.push(custom);
+                }
+                answers[q.question] = results.join(", ");
+            }
+            else {
+                // Single-select: select with "Other" option
+                const selected = await select({
+                    message: q.question,
+                    choices: buildChoices(q.options),
+                    loop: false,
+                });
+                if (selected === OTHER_OPTION) {
+                    answers[q.question] = await input({ message: "Please specify:", required: true });
+                }
+                else {
+                    answers[q.question] = selected;
+                }
+            }
+        }
+        return {
+            behavior: "allow",
+            updatedInput: {
+                questions: questionInput.questions,
+                answers,
+            },
+        };
+    }
+    catch (error) {
+        if (error instanceof ExitPromptError) {
+            console.log();
+            return { behavior: "deny", message: DENY_MESSAGES.cancelled };
+        }
+        throw error;
+    }
+}
+/**
+ * Prompts the user for confirmation and returns the appropriate permission result.
+ * Handles Ctrl+C gracefully by treating it as a denial.
+ */
+async function promptForConfirmation(inputData, label) {
+    const bashCommand = inputData.command ?? "";
+    console.log(c.yellow(`\n${label}:`));
+    console.log(c.cyan(`  ${bashCommand}\n`));
+    try {
+        const approved = await confirm({
+            message: "Allow this operation?",
+            default: false,
+        });
+        return approved
+            ? { behavior: "allow", updatedInput: inputData }
+            : { behavior: "deny", message: DENY_MESSAGES.declined };
+    }
+    catch (error) {
+        if (error instanceof ExitPromptError) {
+            // User pressed Ctrl+C - treat as denial
+            console.log(); // Clean up the prompt line
+            return { behavior: "deny", message: DENY_MESSAGES.cancelled };
+        }
+        throw error;
+    }
+}
+/**
+ * Creates the canUseTool callback for permission control.
+ *
+ * This callback:
+ * - Handles AskUserQuestion tool for interactive user choices
+ * - Auto-allows only known read operations (gitops-release status, list, notes without --apply)
+ * - Prompts for confirmation on write operations and unknown commands
+ * - Denies all other tools
+ */
+export function createPermissionHandler() {
+    return async (toolName, input, _options) => {
+        // Handle AskUserQuestion tool - let Claude ask the user questions
+        if (toolName === "AskUserQuestion") {
+            return handleAskUserQuestion(input);
+        }
+        // Only allow Bash tool - deny all other tools
+        if (toolName !== "Bash") {
+            return {
+                behavior: "deny",
+                message: `Tool "${toolName}" is not allowed. Use gitops-release CLI commands via Bash instead.`,
+            };
+        }
+        const bashCommand = input.command ?? "";
+        const commandType = classifyCommand(bashCommand);
+        // Auto-allow known safe gitops-release read operations
+        if (commandType === "read") {
+            return { behavior: "allow", updatedInput: input };
+        }
+        // Everything else (write or unknown) requires confirmation
+        const label = commandType === "write" ? "The agent wants to run" : "The agent wants to execute";
+        return promptForConfirmation(input, label);
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/agent/hooks.js.map

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

package/dist/agent/index.d.ts

@@ -0,0 +1,4 @@
+export { RELEASE_AGENT_PROMPT } from "./prompts.js";
+export { createPermissionHandler } from "./hooks.js";
+export { runRepl, type ReplOptions } from "./repl.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,6 @@
+// ABOUTME: Agent module exports.
+// ABOUTME: Provides public API for the release management agent.
+export { RELEASE_AGENT_PROMPT } from "./prompts.js";
+export { createPermissionHandler } from "./hooks.js";
+export { runRepl } from "./repl.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,iEAAiE;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC"}

package/dist/agent/prompts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * System prompt for the release management agent.
+ * Instructs Claude on available commands and how to use them.
+ */
+export declare const RELEASE_AGENT_PROMPT = "You are a GitOps release management assistant.\n\nYou help manage releases for the gitops-runtime Helm chart by running CLI commands.\n\n## Available Commands\n\nRun these via the Bash tool:\n\n### Read-only (auto-execute)\n- `gitops-release status` - Show release overview (all versions)\n- `gitops-release status <version>` - Show specific version status (e.g., 0.27 or 0.27.0)\n- `gitops-release list` - List all releases\n- `gitops-release list -n 20` or `--limit 20` - List more releases\n- `gitops-release notes <version>` - Preview release notes (e.g., notes 0.27.0)\n- `gitops-release notes <version> --edit` - Preview and edit notes in $EDITOR before applying\n\n### Write operations (require confirmation)\n- `gitops-release create <major.minor>` - Create NEW stable branch for a NEW minor version (e.g., create 0.27)\n- `gitops-release publish <version>` - Merge prepare-release PR (e.g., publish 0.27.0)\n- `gitops-release notes <version> --apply` - Apply notes to Chart.yaml and draft release\n- `gitops-release cherry-pick <major.minor> <commits...>` - Cherry-pick commits to a stable branch and create a PR (requires local git clone)\n\n### Preview mode\nAll write operations support `--dry-run` to preview changes without executing them:\n- `gitops-release create 0.27 --dry-run`\n- `gitops-release publish 0.27.0 --dry-run`\n- `gitops-release notes 0.27.0 --apply --dry-run`\n- `gitops-release cherry-pick 0.26 abc123 --dry-run`\n\n## CRITICAL: Understanding Release Types\n\n### New Minor Release (e.g., 0.26 \u2192 0.27)\n- Use `gitops-release create 0.27` to create a NEW stable/0.27 branch from main\n- This is for releasing new features from main\n- The `create` command ONLY creates new stable branches for NEW minor versions\n\n### Patch Release (e.g., 0.26.5 \u2192 0.26.6)\n- The `create` command CANNOT be used for patch releases\n- Patch releases require commits to already exist on the stable branch\n- Workflow for patch releases:\n  1. First, commits must be cherry-picked or backported to the stable branch (e.g., stable/0.26)\n  2. Argo Workflows AUTOMATICALLY creates a prepare-release PR when commits land on the stable branch\n  3. Once the prepare-release PR exists, use `gitops-release publish` to merge it\n\n**NEVER suggest using `gitops-release create 0.26` to create 0.26.6** - this is incorrect!\nIf someone asks for a patch release, explain they need to first cherry-pick commits to the stable branch.\n\n## Guidelines\n\n1. **Always check status first** - Before suggesting actions, run `gitops-release status` to understand the current state.\n\n2. **Use AskUserQuestion for choices** - When you need the user to choose between options (e.g., minor vs patch release, which version to publish), use the AskUserQuestion tool instead of just printing options as text. This provides a better interactive experience.\n\n3. **Use --json for structured data** - When you need to parse output programmatically, add the `--json` flag.\n\n4. **Explain before write operations** - Before running create, publish, or notes --apply, explain what the command will do and what changes it will make.\n\n5. **Version formats matter**:\n   - `create` takes major.minor format: `gitops-release create 0.27`\n   - `publish` and `notes` take full semver: `gitops-release publish 0.27.0`\n\n6. **Target repository** - All commands operate on codefresh-io/gitops-runtime-helm unless specified otherwise.\n\n## Workflow: New Minor Release\n\n1. Check status: `gitops-release status`\n2. Create stable branch: `gitops-release create 0.27` (creates stable/0.27 from main)\n3. Wait for prepare-release PR to be created by Argo Workflows\n4. Check version status: `gitops-release status 0.27`\n5. Generate and apply notes: `gitops-release notes 0.27.0 --apply`\n6. Publish release: `gitops-release publish 0.27.0`\n\n## Workflow: Patch Release\n\n1. Check status: `gitops-release status 0.26`\n2. If no prepare-release PR exists, cherry-pick commits to stable/0.26:\n   - If running from a local git clone: use `gitops-release cherry-pick 0.26 <commit-sha1> <commit-sha2>...`\n   - Otherwise, manually cherry-pick using git in a local clone\n3. Once commits are on the stable branch, Argo Workflows creates a prepare-release PR automatically\n4. Check version status again: `gitops-release status 0.26`\n5. Generate and apply notes: `gitops-release notes 0.26.6 --apply`\n6. Publish release: `gitops-release publish 0.26.6`\n\n**Note:** The cherry-pick command requires running from within a local git clone of the repository. If you're not in a local clone, guide the user to manually cherry-pick commits using standard git commands.\n\n## Understanding Status Output\n\nThe status command shows:\n- **Stable branches**: Active release lines (e.g., stable/0.27)\n- **Prepare-release PRs**: PRs that update Chart.yaml versions\n- **Draft releases**: GitHub releases awaiting publish\n- **Pipeline status**: Whether checks are passing\n\nA release is ready to publish when:\n- The prepare-release PR has all checks passing\n- The appVersion in Chart.yaml is valid\n- A draft release exists\n";
+//# sourceMappingURL=prompts.d.ts.map

package/dist/agent/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/agent/prompts.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,y/JAiGhC,CAAC"}

package/dist/agent/prompts.js

@@ -0,0 +1,105 @@
+// ABOUTME: System prompts for the release management agent.
+// ABOUTME: Defines instructions that guide the agent's behavior and available commands.
+/**
+ * System prompt for the release management agent.
+ * Instructs Claude on available commands and how to use them.
+ */
+export const RELEASE_AGENT_PROMPT = `You are a GitOps release management assistant.
+
+You help manage releases for the gitops-runtime Helm chart by running CLI commands.
+
+## Available Commands
+
+Run these via the Bash tool:
+
+### Read-only (auto-execute)
+- \`gitops-release status\` - Show release overview (all versions)
+- \`gitops-release status <version>\` - Show specific version status (e.g., 0.27 or 0.27.0)
+- \`gitops-release list\` - List all releases
+- \`gitops-release list -n 20\` or \`--limit 20\` - List more releases
+- \`gitops-release notes <version>\` - Preview release notes (e.g., notes 0.27.0)
+- \`gitops-release notes <version> --edit\` - Preview and edit notes in $EDITOR before applying
+
+### Write operations (require confirmation)
+- \`gitops-release create <major.minor>\` - Create NEW stable branch for a NEW minor version (e.g., create 0.27)
+- \`gitops-release publish <version>\` - Merge prepare-release PR (e.g., publish 0.27.0)
+- \`gitops-release notes <version> --apply\` - Apply notes to Chart.yaml and draft release
+- \`gitops-release cherry-pick <major.minor> <commits...>\` - Cherry-pick commits to a stable branch and create a PR (requires local git clone)
+
+### Preview mode
+All write operations support \`--dry-run\` to preview changes without executing them:
+- \`gitops-release create 0.27 --dry-run\`
+- \`gitops-release publish 0.27.0 --dry-run\`
+- \`gitops-release notes 0.27.0 --apply --dry-run\`
+- \`gitops-release cherry-pick 0.26 abc123 --dry-run\`
+
+## CRITICAL: Understanding Release Types
+
+### New Minor Release (e.g., 0.26 → 0.27)
+- Use \`gitops-release create 0.27\` to create a NEW stable/0.27 branch from main
+- This is for releasing new features from main
+- The \`create\` command ONLY creates new stable branches for NEW minor versions
+
+### Patch Release (e.g., 0.26.5 → 0.26.6)
+- The \`create\` command CANNOT be used for patch releases
+- Patch releases require commits to already exist on the stable branch
+- Workflow for patch releases:
+  1. First, commits must be cherry-picked or backported to the stable branch (e.g., stable/0.26)
+  2. Argo Workflows AUTOMATICALLY creates a prepare-release PR when commits land on the stable branch
+  3. Once the prepare-release PR exists, use \`gitops-release publish\` to merge it
+
+**NEVER suggest using \`gitops-release create 0.26\` to create 0.26.6** - this is incorrect!
+If someone asks for a patch release, explain they need to first cherry-pick commits to the stable branch.
+
+## Guidelines
+
+1. **Always check status first** - Before suggesting actions, run \`gitops-release status\` to understand the current state.
+
+2. **Use AskUserQuestion for choices** - When you need the user to choose between options (e.g., minor vs patch release, which version to publish), use the AskUserQuestion tool instead of just printing options as text. This provides a better interactive experience.
+
+3. **Use --json for structured data** - When you need to parse output programmatically, add the \`--json\` flag.
+
+4. **Explain before write operations** - Before running create, publish, or notes --apply, explain what the command will do and what changes it will make.
+
+5. **Version formats matter**:
+   - \`create\` takes major.minor format: \`gitops-release create 0.27\`
+   - \`publish\` and \`notes\` take full semver: \`gitops-release publish 0.27.0\`
+
+6. **Target repository** - All commands operate on codefresh-io/gitops-runtime-helm unless specified otherwise.
+
+## Workflow: New Minor Release
+
+1. Check status: \`gitops-release status\`
+2. Create stable branch: \`gitops-release create 0.27\` (creates stable/0.27 from main)
+3. Wait for prepare-release PR to be created by Argo Workflows
+4. Check version status: \`gitops-release status 0.27\`
+5. Generate and apply notes: \`gitops-release notes 0.27.0 --apply\`
+6. Publish release: \`gitops-release publish 0.27.0\`
+
+## Workflow: Patch Release
+
+1. Check status: \`gitops-release status 0.26\`
+2. If no prepare-release PR exists, cherry-pick commits to stable/0.26:
+   - If running from a local git clone: use \`gitops-release cherry-pick 0.26 <commit-sha1> <commit-sha2>...\`
+   - Otherwise, manually cherry-pick using git in a local clone
+3. Once commits are on the stable branch, Argo Workflows creates a prepare-release PR automatically
+4. Check version status again: \`gitops-release status 0.26\`
+5. Generate and apply notes: \`gitops-release notes 0.26.6 --apply\`
+6. Publish release: \`gitops-release publish 0.26.6\`
+
+**Note:** The cherry-pick command requires running from within a local git clone of the repository. If you're not in a local clone, guide the user to manually cherry-pick commits using standard git commands.
+
+## Understanding Status Output
+
+The status command shows:
+- **Stable branches**: Active release lines (e.g., stable/0.27)
+- **Prepare-release PRs**: PRs that update Chart.yaml versions
+- **Draft releases**: GitHub releases awaiting publish
+- **Pipeline status**: Whether checks are passing
+
+A release is ready to publish when:
+- The prepare-release PR has all checks passing
+- The appVersion in Chart.yaml is valid
+- A draft release exists
+`;
+//# sourceMappingURL=prompts.js.map

package/dist/agent/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/agent/prompts.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wFAAwF;AAExF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiGnC,CAAC"}

package/dist/agent/repl.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Options for running the REPL.
+ */
+export interface ReplOptions {
+    /** Target repository (e.g., codefresh-io/gitops-runtime-helm) */
+    repo: string;
+    /** Enable verbose output */
+    verbose?: boolean;
+}
+/**
+ * Runs the interactive REPL for the release agent.
+ */
+export declare function runRepl(options: ReplOptions): Promise<void>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/agent/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/agent/repl.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmHD;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFjE"}

package/dist/agent/repl.js

@@ -0,0 +1,177 @@
+// ABOUTME: Interactive REPL for the release management agent.
+// ABOUTME: Provides a conversational interface for managing releases.
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { input } from "@inquirer/prompts";
+import { RELEASE_AGENT_PROMPT } from "./prompts.js";
+import { createPermissionHandler } from "./hooks.js";
+import { getChalk } from "../output/formatter.js";
+/**
+ * Formats and displays an SDK message to the console.
+ */
+function displayMessage(message, verbose, c) {
+    switch (message.type) {
+        case "system":
+            if (message.subtype === "init" && verbose) {
+                console.log(c.dim(`Session: ${message.session_id}`));
+                console.log(c.dim(`Model: ${message.model}`));
+            }
+            break;
+        case "assistant":
+            // Extract text content from assistant messages
+            for (const block of message.message.content) {
+                if (block.type === "text") {
+                    console.log(block.text);
+                }
+                else if (block.type === "tool_use" && verbose) {
+                    console.log(c.dim(`[Calling ${block.name}...]`));
+                }
+            }
+            break;
+        case "result":
+            if (message.subtype === "success") {
+                // Note: We don't print message.result here because the text was already
+                // displayed via the "assistant" message type. Printing it again causes duplication.
+                if (verbose &&
+                    typeof message.num_turns === "number" &&
+                    typeof message.total_cost_usd === "number") {
+                    console.log(c.dim(`\n[${message.num_turns} turns, $${message.total_cost_usd.toFixed(4)}]`));
+                }
+            }
+            else {
+                // Error result from SDK
+                console.log(c.red(`Agent error: ${message.subtype}`));
+                if ("errors" in message && message.errors) {
+                    for (const error of message.errors) {
+                        console.log(c.red(`  - ${error}`));
+                    }
+                }
+                console.log(c.yellow("\nTry rephrasing your request or run 'gitops-release status' for current state."));
+            }
+            break;
+        case "tool_progress":
+            if (verbose) {
+                console.log(c.dim(`[${message.tool_name} running...]`));
+            }
+            break;
+        default:
+            if (verbose) {
+                console.log(c.dim(`[Unhandled message type: ${message.type}]`));
+            }
+            break;
+    }
+}
+/** Checks if an error has a code property. */
+function hasErrorCode(error) {
+    return "code" in error && typeof error.code === "string";
+}
+/**
+ * Handles errors from the SDK query with specific error type handling.
+ * Checks for error codes first (preferred), then falls back to message patterns.
+ */
+function handleQueryError(error, c, verbose) {
+    if (!(error instanceof Error)) {
+        console.error(c.red("An unexpected error occurred"));
+        return;
+    }
+    // Check for error codes first (SDK standard)
+    if (hasErrorCode(error)) {
+        switch (error.code) {
+            case "AUTHENTICATION_FAILED":
+                console.error(c.red("Authentication error: Invalid or expired API key."));
+                console.error(c.yellow("Hint: Check that ANTHROPIC_API_KEY is set correctly."));
+                break;
+            case "RATE_LIMIT_EXCEEDED":
+                console.error(c.red("Rate limit exceeded."));
+                console.error(c.yellow("Hint: Wait a few minutes before trying again."));
+                break;
+            case "CONTEXT_LENGTH_EXCEEDED":
+                console.error(c.red("Context length exceeded."));
+                console.error(c.yellow("Hint: Start a new session with 'exit' and re-run."));
+                break;
+            default:
+                console.error(c.red(`Error [${error.code}]: ${error.message}`));
+        }
+    }
+    else {
+        console.error(c.red(`Error: ${error.message}`));
+    }
+    if (verbose && error.stack) {
+        console.error(c.dim(error.stack));
+    }
+}
+/**
+ * Runs the interactive REPL for the release agent.
+ */
+export async function runRepl(options) {
+    const { repo, verbose = false } = options;
+    const c = getChalk({ noColor: process.env.NO_COLOR !== undefined });
+    let sessionId;
+    console.log(c.bold("GitOps Release Agent") + c.yellow(" [Experimental]"));
+    console.log();
+    console.log(c.dim("A conversational interface for managing GitOps runtime releases."));
+    console.log(c.dim("Ask questions like:"));
+    console.log(c.dim('  • "What releases are in progress?"'));
+    console.log(c.dim('  • "Show me the status of v0.27"'));
+    console.log(c.dim('  • "Generate release notes for 0.27.0"'));
+    console.log(c.dim('  • "Create a new release branch for 0.28"'));
+    console.log();
+    console.log(c.dim("Read operations auto-execute. Write operations require confirmation."));
+    console.log(c.dim("Type 'exit' to quit."));
+    console.log();
+    while (true) {
+        let userInput;
+        try {
+            userInput = await input({ message: c.green("gitops>") });
+        }
+        catch (error) {
+            // ExitPromptError is thrown when user presses Ctrl+C
+            if (error.name === "ExitPromptError") {
+                console.log(c.dim("\nGoodbye!"));
+                break;
+            }
+            throw error;
+        }
+        const trimmedInput = userInput.trim();
+        if (["exit", "quit"].includes(trimmedInput.toLowerCase())) {
+            console.log(c.dim("Goodbye!"));
+            break;
+        }
+        if (!trimmedInput) {
+            continue;
+        }
+        try {
+            // Build query options
+            const queryOptions = {
+                tools: ["Bash", "AskUserQuestion"],
+                permissionMode: "default",
+                canUseTool: createPermissionHandler(),
+                systemPrompt: RELEASE_AGENT_PROMPT,
+                env: {
+                    ...process.env,
+                    // Ensure the CLI uses the same repo
+                    GITOPS_RELEASE_REPO: repo,
+                },
+            };
+            // Resume session if we have one
+            if (sessionId) {
+                queryOptions.resume = sessionId;
+            }
+            const messageStream = query({
+                prompt: trimmedInput,
+                options: queryOptions,
+            });
+            for await (const message of messageStream) {
+                // Capture session ID for context persistence
+                if (message.type === "system" && message.subtype === "init") {
+                    sessionId = message.session_id;
+                }
+                displayMessage(message, verbose, c);
+            }
+        }
+        catch (error) {
+            handleQueryError(error, c, verbose);
+        }
+        console.log(); // Empty line before next prompt
+    }
+}
+//# sourceMappingURL=repl.js.map