personal-projects/leo-claude-mktplace
Template
0
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add interactive setup wizard with API validation and mismatch detection #53

Merged
lmiranda merged 1 commits from feat/interactive-setup-wizard into development 2026-01-21 16:24:03 +00:00
Conversation 0 Commits 1 Files Changed 16 +2132 -401
lmiranda commented 2026-01-21 16:23:34 +00:00
Owner
Copy Link

Summary

  • Redesigned /initial-setup to be fully interactive using Claude tools (Bash, Read, Write, AskUserQuestion) instead of delegating to a bash script
  • Added /project-init command for quick project setup when system is already configured
  • Added /project-sync command to sync .env with git remote after repository move/rename
  • Added SessionStart hooks for automatic mismatch detection between git remote and .env
  • Moved GITEA_ORG from system-level to project-level configuration (different projects may belong to different organizations)
  • Added Gitea API validation to auto-fill configuration when repository exists
  • Updated all documentation with flow diagrams and new command references

Changes

New Files:

  • plugins/projman/commands/project-init.md
  • plugins/projman/commands/project-sync.md
  • plugins/projman/hooks/hooks.json
  • plugins/pr-review/commands/initial-setup.md
  • plugins/pr-review/commands/project-init.md
  • plugins/pr-review/commands/project-sync.md
  • plugins/pr-review/hooks/hooks.json
  • plugins/cmdb-assistant/commands/initial-setup.md

Modified Files:

  • plugins/projman/commands/initial-setup.md (major rewrite)
  • docs/CONFIGURATION.md (added diagrams, new commands)
  • docs/COMMANDS-CHEATSHEET.md (new commands, hooks)
  • docs/UPDATING.md (setup script guidance)
  • CLAUDE.md (updated structure)
  • plugins/projman/README.md (new quick start)
  • plugins/projman/CONFIGURATION.md (simplified to redirect)
  • scripts/setup.sh (updated header)

Test plan

  • Test /initial-setup on a fresh machine
  • Test /project-init when system config exists
  • Test /project-sync after moving repository
  • Verify SessionStart hook detects mismatches
  • Verify API validation auto-fills correct values

🤖 Generated with Claude Code

## Summary - Redesigned `/initial-setup` to be fully interactive using Claude tools (Bash, Read, Write, AskUserQuestion) instead of delegating to a bash script - Added `/project-init` command for quick project setup when system is already configured - Added `/project-sync` command to sync .env with git remote after repository move/rename - Added SessionStart hooks for automatic mismatch detection between git remote and .env - Moved GITEA_ORG from system-level to project-level configuration (different projects may belong to different organizations) - Added Gitea API validation to auto-fill configuration when repository exists - Updated all documentation with flow diagrams and new command references ## Changes **New Files:** - `plugins/projman/commands/project-init.md` - `plugins/projman/commands/project-sync.md` - `plugins/projman/hooks/hooks.json` - `plugins/pr-review/commands/initial-setup.md` - `plugins/pr-review/commands/project-init.md` - `plugins/pr-review/commands/project-sync.md` - `plugins/pr-review/hooks/hooks.json` - `plugins/cmdb-assistant/commands/initial-setup.md` **Modified Files:** - `plugins/projman/commands/initial-setup.md` (major rewrite) - `docs/CONFIGURATION.md` (added diagrams, new commands) - `docs/COMMANDS-CHEATSHEET.md` (new commands, hooks) - `docs/UPDATING.md` (setup script guidance) - `CLAUDE.md` (updated structure) - `plugins/projman/README.md` (new quick start) - `plugins/projman/CONFIGURATION.md` (simplified to redirect) - `scripts/setup.sh` (updated header) ## Test plan - [ ] Test `/initial-setup` on a fresh machine - [ ] Test `/project-init` when system config exists - [ ] Test `/project-sync` after moving repository - [ ] Verify SessionStart hook detects mismatches - [ ] Verify API validation auto-fills correct values 🤖 Generated with [Claude Code](https://claude.com/claude-code)
lmiranda added 1 commit 2026-01-21 16:23:34 +00:00
feat: add interactive setup wizard with API validation and mismatch detection 0c2fc8c0d9 
Major improvements to plugin setup experience:

Setup Commands:
- Redesign /initial-setup as interactive wizard (MCP + system + project config)
- Add /project-init for quick project-only setup
- Add /project-sync for handling repository moves/renames
- Add Gitea API validation to auto-fill org/repo when verified

Configuration Changes:
- Move GITEA_ORG from system to project level (supports multi-org users)
- System config now only contains GITEA_URL and GITEA_TOKEN
- Project .env now contains GITEA_ORG and GITEA_REPO

Automation:
- Add SessionStart hook for projman and pr-review
- Automatically detects git remote vs .env mismatch
- Warns user to run /project-sync when mismatch found

Documentation:
- Unify configuration docs (remove duplicate in plugins/projman)
- Add flow diagrams to CONFIGURATION.md
- Add setup script review guidance to UPDATING.md
- Update COMMANDS-CHEATSHEET.md with new commands and hooks

Files added:
- plugins/projman/commands/project-init.md
- plugins/projman/commands/project-sync.md
- plugins/projman/hooks/hooks.json
- plugins/pr-review/commands/initial-setup.md
- plugins/pr-review/commands/project-init.md
- plugins/pr-review/commands/project-sync.md
- plugins/pr-review/hooks/hooks.json
- plugins/cmdb-assistant/commands/initial-setup.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
lmiranda merged commit 2a6b3df8e1 into development 2026-01-21 16:24:03 +00:00
lmiranda deleted branch feat/interactive-setup-wizard 2026-01-21 16:24:03 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
Component/API
API endpoints, contracts, and integration
 Component/Auth
Authentication and authorization
 Component/Backend
Backend service code and business logic
 Component/Database
Database schemas, migrations, queries
 Component/Deploy
Deployment, infrastructure, DevOps
 Component/Docs
Documentation and guides
 Component/Frontend
User interface and client-side code
 Component/Infra
Infrastructure and system configuration
 Component/Testing
Test infrastructure and frameworks
 Tech/Docker
Docker containers and compose
 Tech/FastAPI
FastAPI backend framework
 Tech/JavaScript
JavaScript/Node.js code
 Tech/PostgreSQL
PostgreSQL database
 Tech/Python
Python language and libraries
 Tech/Redis
Redis cache and pub/sub
 Tech/Vue
Vue.js frontend framework
Complexity/Complex
High uncertainty or many dependencies
 Complexity/Medium
Some unknowns or dependencies
 Complexity/Simple
Straightforward, well-understood
 Effort/L
3-5 days
 Effort/M
1-2 days
 Effort/S
2-4 hours
 Effort/XL
> 1 week
 Effort/XS
< 2 hours
 Priority/Critical
Immediate attention required
 Priority/High
Important, needs attention soon
 Priority/Low
Nice to have, can wait
 Priority/Medium
Normal priority
 Type/Bug
Something isn't working
 Type/Chore
Maintenance tasks
 Type/Documentation
Documentation improvements
 Type/Feature
New feature or request
 Type/Refactor
Code refactoring without changing behavior
 Type/Test
Testing related
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
lmiranda
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: personal-projects/leo-claude-mktplace#53
Delete Branch "feat/interactive-setup-wizard"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?