Skip to content

feat(cli): map v2 commands and v2 state to v3 guidance - #138

Merged
harlan-zw merged 1 commit into
mainfrom
feat/v2-compat
Sep 16, 2026
Merged

harlan-zw merged 1 commit into
mainfrom
feat/v2-compat

Conversation

@harlan-zw

Copy link
Copy Markdown
Collaborator

❓ Type of change

  • 👌 Enhancement

📚 Description

Stable v3 moves npm latest off 2.3.0, so every v2 user lands on the native CLI. Their muscle memory currently gets this:

INVALID_ARGUMENT: unrecognized subcommand 'whoami'
INVALID_LOCKFILE: the Skill lockfile is not valid JSON
INVALID_SOURCE: use a skilld search selector or an explicit GitHub Repository selector

login, logout, whoami, info, and prepare now run their v3 replacement. The removed commands (author, watch, cache, and the rest) exit with REMOVED_COMMAND and link the migration guide. A v2 YAML lockfile says to back up .skills, and skilld add vue points to skilld search vue.

Not sure prepareinstall is right. A v2 project still fails there, but on the lockfile message, which is at least actionable.

🤖 AI disclosure: Harlan Agent Kit modified this description. My AI open-source policy.

v2 users upgrading to v3 hit bare "unrecognized subcommand" errors and a
lockfile "not valid JSON" error with no migration path.
@harlan-github-agent harlan-github-agent Bot added harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. labels Sep 16, 2026
@harlan-github-agent

harlan-github-agent Bot commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

🤖 MERGED

Harlan Agent Kit posted this automated review. It is not Harlan's personal review or approval. AI open source policy. Last updated: 2026-09-16 09:34 UTC.

GitHub merged this pull request.

No material findings were recorded.

Review completed. No material findings.

@harlan-zw
harlan-zw merged commit 2d90b05 into main Sep 16, 2026
2 checks passed
@harlan-github-agent harlan-github-agent Bot removed harlan-agent-running An Agent holds a Task on this issue or pull request right now. harlan-agent-review-required Pull request triage requires an adversarial Review for this head commit. labels Sep 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant