CLI Fix done story

[yamcodes]

Summary by CodeRabbit

• Documentation
  • Enhanced post-scaffolding guidance messages with clearer next steps
  • Improved clarity distinguishing between local scaffolding and AI-powered refinement options
  • Better organized instructions for configuring and using ArkEnv

[changeset-bot]

🦋 Changeset detected

Latest commit: 4fa90ff

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@arkenv/cli	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

Walkthrough

This PR enhances the ArkEnv CLI's post-scaffolding user experience by adding a conditional logging method to the Logger class and refactoring init command messaging to use multi-line dedent formatting. The changeset documents the patch release with improved guidance text distinguishing local scaffolding from AI refinement.

Changes

CLI messaging and logger enhancements

Layer / File(s)	Summary
Logger note method addition packages/cli/src/lib/logger.ts	The Logger class imports the note helper from @clack/prompts and adds a note(message, title?) method that conditionally renders output as dim-formatted text in quiet/JSON modes or delegates to the prompt helper in interactive mode.
Init command messaging updates packages/cli/src/commands/init.ts	InitCommand imports dedent and refactors the "Next steps" guidance text to use logger.note with multi-line dedent templates, improving content and presentation for both skill-installed and skill-not-installed cases; the final completion message is also reformatted to multi-line style.
Release documentation .changeset/great-deer-check.md	Changeset file documents a patch release for @arkenv/cli with new "done" message documentation that clarifies next steps by distinguishing local scaffolding from AI-powered refinement and includes explicit follow-up instructions.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• yamcodes/arkenv#944: Both PRs modify the CLI's post-scaffolding "next steps" messaging; this PR adds logger-based note rendering while #944 makes the install command package-manager-aware.

Suggested labels

enhancement

Poem

🐰 A note for every step you take,
Multi-line messages now look great,
The logger learns to dedent clean,
Prettiest CLI I've ever seen! ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'CLI Fix done story' directly relates to the main change: improving the 'done' message text and post-scaffolding guidance in the CLI's init command, as confirmed by commit messages and changeset documentation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cli-fix-done-story

---

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.}

[pkg-pr-new]

Open in StackBlitz

arkenv

npm i https://pkg.pr.new/arkenv@954

@arkenv/bun-plugin

npm i https://pkg.pr.new/@arkenv/bun-plugin@954

@arkenv/cli

npm i https://pkg.pr.new/@arkenv/cli@954

@arkenv/fumadocs-ui

npm i https://pkg.pr.new/@arkenv/fumadocs-ui@954

@arkenv/vite-plugin

npm i https://pkg.pr.new/@arkenv/vite-plugin@954

commit: 4fa90ff

[arkenv-bot]

📦 Bundle Size Report

No results found

✅ All size limits passed!

[yamcodes]

Of course this needs a changeset.

[arkenv-bot]

🤖 Hi @yamcodes, I've received your request, and I'm working on it now! You can track my progress in the logs for more details.

[arkenv-bot]

🤖 I'm sorry @yamcodes, but I was unable to process your request. Please see the logs for more details.

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.changeset/great-deer-check.md:
- Around line 9-21: The fenced code block that contains the "Next steps" ASCII
art is missing a language identifier which triggers markdownlint MD040; fix this
by changing the opening fence from ``` to ```text so the block is labeled as
plain text (the block that starts with the "Next steps" header and ends with
"ArkEnv scaffolding complete. Happy coding!").

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0c9d372a-87e3-4932-aae2-23d47334751a

📥 Commits

Reviewing files that changed from the base of the PR and between f736591 and 4fa90ff.

📒 Files selected for processing (3)

• .changeset/great-deer-check.md
• packages/cli/src/commands/init.ts
• packages/cli/src/lib/logger.ts

[coderabbitai]

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a language identifier to the fenced code block.

Line 9 uses an unlabeled fence, which triggers markdownlint MD040.

Proposed fix

-```
+```text
     1 │
     2 ◇  Next steps ─────────────────────────────────────────────────────────────────╮
     3 │                                                                              │
@@
    11 └  ⛯ ArkEnv scaffolding complete. Happy coding!
-```
+```

🧰 Tools

🪛 markdownlint-cli2 (0.22.1)

[warning] 9-9: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.changeset/great-deer-check.md around lines 9 - 21, The fenced code block
that contains the "Next steps" ASCII art is missing a language identifier which
triggers markdownlint MD040; fix this by changing the opening fence from ``` to
```text so the block is labeled as plain text (the block that starts with the
"Next steps" header and ends with "ArkEnv scaffolding complete. Happy coding!").

[arkenv-bot]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (Asia/Almaty)
arkenv	Ready	Preview, Comment	May 12 2026, 7:17 PM (Asia/Almaty)