Add Kiro CLI and Kiro IDE agent support

[alishakawaguchi]

Summary

• Add Kiro agent integration (both CLI and IDE modes): hook installation, lifecycle event parsing, transcript analysis, and session management
• Fix shared ReadAndParseHookInput stdin timeout bug that could drop data for any agent with slow EOF
• Guard empty transcript fallback to Kiro-only, preventing silent data loss for other agents
• Strategy fixes for TTY-based agents: commit linking, transcript backfill, rewind transcript clearing

Key changes

New agent package (cmd/entire/cli/agent/kiro/)

• Full Agent interface implementation including HookSupport, TranscriptAnalyzer
• Hook installation via .kiro/settings/hooks.json — works with both Kiro CLI and Kiro IDE
• Lifecycle event parsing (session start/stop, turn start/end) from Kiro's hook format
• Transcript extraction from Kiro's SQLite-backed session format

Shared hook input reading (cmd/entire/cli/agent/event.go)

• Introduced ErrEmptyHookInput sentinel error for agents to handle gracefully
• Two-phase stdin read: Peek(1) with 500ms timeout to detect empty pipe, then io.ReadAll without timeout once data is confirmed — fixes a bug where the old single-phase timeout could discard valid data if EOF was slow

Strategy fixes (cmd/entire/cli/strategy/)

• Condensation: Empty transcript fallback now guarded by AgentTypeKiro check; other agents get an explicit error instead of silently proceeding with no data
• Hooks: PrepareCommitMsg fast path extended for TTY-based agents (Kiro in tmux) via TerminalAgent interface — auto-links commits during ACTIVE sessions without prompting
• Git: Backfill TranscriptPath in SaveStep for agents with deferred transcript persistence
• Rewind: Clear TranscriptPath after rewind so condensation reads from the reset shadow branch, not the stale live transcript

E2E runner (e2e/agents/kiro.go)

• Registers Kiro with the E2E framework
• Supports both prompt and interactive session modes
• Note: Kiro E2E tests cannot currently run in CI due to upstream issues:
  • kirodotdev/Kiro#5938 — CLI auth blockers
  • kirodotdev/Kiro#5358 — headless mode limitations
• Kiro agent has been removed from CI E2E workflows until these are resolved

Test plan

• Unit tests for hooks, lifecycle, types, transcript, and agent registration (cmd/entire/cli/agent/kiro/*_test.go)
• All tests pass: mise run test:ci (unit + integration + canary)
• E2E validated manually with Kiro CLI and Kiro IDE locally
• Lint clean: mise run fmt && mise run lint

🤖 Generated with Claude Code

[cursor]

PR Summary

Medium Risk
Introduces a new agent and modifies git-hook/condensation/rewind flows, which can affect checkpoint linking and session state handling across commits; changes are well-covered by extensive unit and e2e tests but touch core workflow paths.

Overview
Adds first-class support for the Amazon Kiro agent, including a new cmd/entire/cli/agent/kiro implementation (hook installation/uninstallation, lifecycle hook parsing with stable session IDs, transcript caching/analysis for both CLI and IDE formats, and session read/write).

Updates manual-commit behavior to better handle deferred transcript availability and terminal-emulator agents: commit hooks can auto-link during active Kiro sessions, condensation no longer fails when no live transcript exists yet, transcript paths are backfilled on turn end/save, and rewinds clear TranscriptPath to force shadow-branch-based extraction.

Expands E2E support and docs to include Kiro: registers a kiro-cli-chat runner with CI auth checks/SIGV4 support, updates workflow permissions, and extends E2E matrices/options and task help text.

^{Written by Cursor Bugbot for commit 9677610. Configure here.}

[Copilot]

Pull request overview

This PR adds first-class support for the Kiro (Amazon) agent to Entire CLI, including hook installation/parsing and an E2E runner, and updates strategy/lifecycle handling for edge cases discovered during integration (notably deferred transcripts and mid-turn commits).

Changes:

• Add a new cmd/entire/cli/agent/kiro/ package implementing hook support and lifecycle parsing (with SQLite transcript caching).
• Add a Kiro E2E agent runner and wire Kiro into E2E task help text and CI workflows.
• Adjust manual-commit strategy and lifecycle to better handle mid-turn commits, deferred transcript availability, and rewind/condensation edge cases.

Reviewed changes

Copilot reviewed 27 out of 27 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
scripts/test-kiro-agent-integration.sh	Adds a manual script intended to validate Kiro hook firing/stdin payloads.
mise-tasks/test/e2e/_default	Updates E2E task help text to include kiro as an agent option.
e2e/agents/kiro.go	Adds Kiro implementation for the E2E harness (tmux interactive mode + retry gating).
cmd/entire/cli/strategy/manual_commit_rewind.go	Clears TranscriptPath after rewinds so post-rewind condensation uses the shadow branch state.
cmd/entire/cli/strategy/manual_commit_hooks.go	Updates prepare-commit-msg behavior for “TTY agents” (e.g., Kiro) and active-session commit linking.
cmd/entire/cli/strategy/manual_commit_git.go	Backfills TranscriptPath during SaveStep for deferred transcript persistence.
cmd/entire/cli/strategy/manual_commit_condensation.go	Allows condensation to proceed with minimal session data when transcript isn’t available mid-session.
cmd/entire/cli/lifecycle.go	Passes transcript ref into turn-end transitions and backfills session TranscriptPath when needed.
cmd/entire/cli/hooks_cmd.go	Registers the Kiro agent package via blank import.
cmd/entire/cli/agent/registry.go	Adds AgentNameKiro / AgentTypeKiro constants.
cmd/entire/cli/agent/kiro/types.go	Defines Kiro hook stdin payload types and .kiro/agents/entire.json structures.
cmd/entire/cli/agent/kiro/types_test.go	Adds unit tests for Kiro hook JSON parsing and config marshaling.
cmd/entire/cli/agent/kiro/lifecycle.go	Implements lifecycle event parsing + session-id caching.
cmd/entire/cli/agent/kiro/lifecycle_test.go	Adds unit tests for Kiro lifecycle parsing and cache behavior.
cmd/entire/cli/agent/kiro/hooks.go	Implements Kiro hook install/uninstall/detect for .kiro/agents/entire.json.
cmd/entire/cli/agent/kiro/hooks_test.go	Adds unit tests for hook installation/idempotency/detection.
cmd/entire/cli/agent/kiro/kiro.go	Implements Kiro agent identity, transcript caching via sqlite3, session read/write behavior.
cmd/entire/cli/agent/kiro/kiro_test.go	Adds unit tests for Kiro agent methods (with one incomplete DetectPresence test).
cmd/entire/cli/agent/kiro/AGENT.md	Adds a Kiro integration one-pager documenting hooks/config/transcripts.
.github/workflows/e2e.yml	Adds kiro to the E2E matrix and installs kiro-cli.
.github/workflows/e2e-isolated.yml	Adds kiro as an isolated E2E workflow option and installs kiro-cli.
.claude/skills/agent-integration/test-writer.md	Refocuses “write-tests” phase on creating the E2E runner only.
.claude/skills/agent-integration/researcher.md	Refactors research output into a persistent AGENT.md one-pager.
.claude/skills/agent-integration/implementer.md	Reworks the workflow to strict E2E-first TDD with unit tests written last.
.claude/skills/agent-integration/SKILL.md	Updates skill definition to reflect E2E-first TDD and new phase outputs.
.claude/plugins/agent-integration/commands/write-tests.md	Updates command description to “Create E2E agent runner (no unit tests)”.
.claude/plugins/agent-integration/commands/implement.md	Updates implement command description (contains a spelling typo).

Comments suppressed due to low confidence (1)

.github/workflows/e2e-isolated.yml:50

• This workflow now allows selecting kiro, but the bootstrap step runs without E2E_AGENT set and without any Kiro auth configuration. Since the Kiro runner’s Bootstrap() checks kiro-cli whoami on CI, selecting kiro is likely to fail unless the workflow also provisions credentials (or skips the auth check). Consider setting E2E_AGENT=${{ inputs.agent }} for the bootstrap step and documenting/gating Kiro behind an auth secret or condition.

      - name: Install agent CLI
        run: |
          case "${{ inputs.agent }}" in
            claude-code) curl -fsSL https://claude.ai/install.sh | bash ;;
            opencode)    curl -fsSL https://opencode.ai/install | bash ;;
            gemini-cli)  npm install -g @google/gemini-cli ;;
            kiro)        curl -fsSL https://cli.kiro.dev/install | bash ;;
          esac
          echo "$HOME/.local/bin" >> $GITHUB_PATH

      - name: Bootstrap agent
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
        run: go run ./e2e/bootstrap

[alishakawaguchi]

@cursor review

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Comment @cursor review or bugbot run to trigger another review on this PR