668.4-remove-deprecated Remove deprecated commands (search, pull, push) - v2.0.0

[codekiln]

Summary

Remove all deprecated commands (search, pull, push) and --help flag in a major version release.

Parent: #668 (ls-prompt-ux milestone)
Phase: 4 of 4 (Major Breaking Change)
Design: docs/implementation/ls-prompt-ux-command-redesign.md (section: Phase 4)
Depends on: #727 (Phase 1), #728 (Phase 2), #729 (Phase 3)
Version: v2.0.0

Goals

Complete the transition to the new command structure by:

• Removing search command entirely (replaced by list [term])
• Removing pull command entirely (replaced by get)
• Removing push command entirely (replaced by create and update)
• Removing --help flag (use help subcommand only)

Implementation Tasks

1. Remove deprecated commands

• Remove search command implementation
• Remove pull command implementation
• Remove push command implementation
• Remove associated code and tests
• Update help output to remove all references

2. Remove --help flag

• Remove --help flag from all commands
• Show migration message if --help is used
• Redirect users to help subcommand
• Update all documentation

3. Update documentation

• Update README to reflect v2.0.0 changes
• Create migration guide from v1.x to v2.0.0
• Update CHANGELOG with breaking changes
• Update all examples to use new commands

4. Version bump

• Bump major version to v2.0.0
• Update cargo.toml version
• Tag release with v2.0.0
• Update GitHub release notes

Migration Guide (v1.x → v2.0.0)

Command Replacements

v1.x Command	v2.0.0 Replacement
langstar prompt search <term>	langstar prompt list <term>
langstar prompt pull <name>	langstar prompt get <name>
langstar prompt push -r <name> -t <text>	langstar prompt create <name> --text <text> (new)
langstar prompt push -r <name> -t <text>	langstar prompt update <name> --text <text> (update)
langstar prompt <cmd> --help	langstar prompt <cmd> help

Example Migrations

List/Search:

# v1.x
langstar prompt search "rag"

# v2.0.0
langstar prompt list "rag"

Read prompt:

# v1.x
langstar prompt pull my-prompt

# v2.0.0
langstar prompt get my-prompt

Create prompt:

# v1.x
langstar prompt push -r my-prompt -t "template"

# v2.0.0
langstar prompt create my-prompt --text "template"

Update prompt:

# v1.x
langstar prompt push -r my-prompt -t "updated"

# v2.0.0
langstar prompt update my-prompt --text "updated"

Help:

# v1.x
langstar prompt list --help

# v2.0.0
langstar prompt list help

Testing Requirements

Removal Tests

• Verify search command no longer exists
• Verify pull command no longer exists
• Verify push command no longer exists
• Verify --help flag no longer works
• Verify error messages guide users to new commands

Functionality Tests

• Verify all CRUD commands work (create, get, update)
• Verify list with search terms works
• Verify help subcommand works
• Verify progressive disclosure help works

Documentation Tests

• Verify README is updated
• Verify migration guide is complete
• Verify CHANGELOG lists all breaking changes
• Verify all examples use new commands

Breaking Changes Summary

Removed Commands:

• search - Use list <term> instead
• pull - Use get instead
• push - Use create or update instead

Removed Flags:

• --help - Use help subcommand instead

This is a MAJOR version bump because:

• Commands are removed entirely (not just deprecated)
• Users must update their scripts and workflows
• No backward compatibility

Success Criteria

• All deprecated commands are removed
• --help flag is removed
• Migration guide is complete and clear
• All documentation reflects v2.0.0
• Tests verify new functionality
• Version is bumped to v2.0.0
• Release notes document all breaking changes

Timeline

This phase should NOT be started until:

• Phases 1-3 are complete and merged
• Users have had time to migrate to new commands (suggest 3-6 months)
• Deprecation warnings have been shown for sufficient time

References

• Design document: docs/implementation/ls-prompt-ux-command-redesign.md (section: "Phase 4: Remove Deprecated Commands")
• Parent issue: ls-prompt-ux milestone - Improve UX consistency across prompt commands #668
• Migration from: v1.x (current)
• Migration to: v2.0.0