feat(cmd): add auto-start support to init command

[feloy]

Implements auto-start functionality allowing workspaces to be started immediately after registration via --start flag or KORTEX_CLI_INIT_AUTO_START environment variable. This combines init and start operations for improved automation and convenience.

Closes #173

[codecov-commenter]

Codecov Report

❌ Patch coverage is 83.33333% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
pkg/cmd/init.go	83.33%	1 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!

[coderabbitai]

Warning

Rate limit exceeded

@feloy has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 15 minutes and 30 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 15 minutes and 30 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 2b1835c7-57a3-46d2-afe6-1673446a8070

📥 Commits

Reviewing files that changed from the base of the PR and between 9c27f80 and f304872.

📒 Files selected for processing (2)

• README.md
• pkg/cmd/init.go

📝 Walkthrough

Walkthrough

Adds optional auto-start capability to the kortex-cli init command via a new --start flag and KORTEX_CLI_INIT_AUTO_START environment variable. After successful workspace registration, the command calls manager.Start() when auto-start is enabled. Includes comprehensive test coverage and documentation updates.

Changes

Cohort / File(s)	Summary
Documentation README.md, skills/implementing-command-patterns/SKILL.md	Added usage examples and reference documentation for the --start flag and KORTEX_CLI_INIT_AUTO_START environment variable, including precedence rules and implementation patterns.
Command Implementation pkg/cmd/init.go	Added start boolean field to initCmd, updated preRun to read KORTEX_CLI_INIT_AUTO_START env var (accepting truthy values: 1, true/TRUE, yes/YES), and updated run to call manager.Start() after workspace registration when auto-start is enabled.
Tests pkg/cmd/init_test.go	Added unit tests for flag and env var parsing, including precedence validation and truthy/falsey value handling. Extended E2E tests to verify workspace transitions to running state when auto-start is enabled and remains unstarted when disabled. Updated example count expectation to reflect new --start usage example.

Sequence Diagram

sequenceDiagram
    participant User
    participant InitCmd as init Command
    participant Manager
    participant RuntimeSetup as Runtime System
    participant Instance

    User->>InitCmd: kortex-cli init [--start] <br/> or KORTEX_CLI_INIT_AUTO_START=1
    InitCmd->>InitCmd: Parse flags & env vars<br/>(flag takes precedence)
    InitCmd->>Manager: Register workspace
    Manager->>Instance: Create instance
    Manager-->>InitCmd: Return instance ID
    
    alt auto-start enabled
        InitCmd->>Manager: Start(ctx, instanceID)
        Manager->>RuntimeSetup: Register & setup runtimes
        RuntimeSetup->>Instance: Transition state → running
        Instance-->>Manager: State confirmed
        Manager-->>InitCmd: Success
    else auto-start disabled
        InitCmd-->>User: Return success<br/>(instance created, not started)
    end
    
    InitCmd->>User: Return JSON output & exit code

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~22 minutes

Possibly related PRs

• feat: init command #23: Introduced the base init command implementation that this PR extends with auto-start functionality.
• feat(runtime): add centralized runtime registration system #78: Modifies pkg/cmd/init.go runtime registration logic, affecting the registration flow interaction with the new auto-start feature.
• feat(cmd): add workspace start and stop commands (#70) #74: Implements the manager.Start() functionality exposed as standalone workspace start commands, which is now invoked by the init command's auto-start feature.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main feature addition: auto-start support for the init command.
Description check	✅ Passed	The description is related to the changeset, explaining the auto-start functionality and referencing the linked issue #173.
Linked Issues check	✅ Passed	The PR fully implements both requirements from issue #173: --start flag support and KORTEX_CLI_INIT_AUTO_START environment variable with proper precedence.
Out of Scope Changes check	✅ Passed	All changes are in scope: init command implementation, comprehensive tests, documentation updates, and skill guide additions directly support the auto-start feature.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}