claudekit-cli 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/.github/workflows/ci.yml +2 -0
  2. package/CHANGELOG.md +19 -0
  3. package/CLAUDE.md +7 -0
  4. package/README.md +61 -3
  5. package/biome.json +3 -0
  6. package/dist/index.js +102 -0
  7. package/package.json +1 -1
  8. package/src/commands/version.ts +135 -0
  9. package/src/index.ts +11 -0
  10. package/src/types.ts +7 -0
  11. package/tests/commands/version.test.ts +297 -0
  12. package/.claude/agents/brainstormer.md +0 -96
  13. package/.claude/agents/code-reviewer.md +0 -141
  14. package/.claude/agents/copywriter.md +0 -108
  15. package/.claude/agents/database-admin.md +0 -86
  16. package/.claude/agents/debugger.md +0 -124
  17. package/.claude/agents/docs-manager.md +0 -115
  18. package/.claude/agents/git-manager.md +0 -60
  19. package/.claude/agents/journal-writer.md +0 -111
  20. package/.claude/agents/planner.md +0 -87
  21. package/.claude/agents/project-manager.md +0 -113
  22. package/.claude/agents/researcher.md +0 -173
  23. package/.claude/agents/scout.md +0 -123
  24. package/.claude/agents/tester.md +0 -95
  25. package/.claude/agents/ui-ux-designer.md +0 -206
  26. package/.claude/commands/bootstrap.md +0 -104
  27. package/.claude/commands/brainstorm.md +0 -67
  28. package/.claude/commands/content/enhance.md +0 -13
  29. package/.claude/commands/content/fast.md +0 -11
  30. package/.claude/commands/content/good.md +0 -13
  31. package/.claude/commands/cook.md +0 -19
  32. package/.claude/commands/debug.md +0 -10
  33. package/.claude/commands/design/3d.md +0 -65
  34. package/.claude/commands/design/describe.md +0 -13
  35. package/.claude/commands/design/fast.md +0 -19
  36. package/.claude/commands/design/good.md +0 -23
  37. package/.claude/commands/design/screenshot.md +0 -23
  38. package/.claude/commands/design/video.md +0 -23
  39. package/.claude/commands/docs/init.md +0 -13
  40. package/.claude/commands/docs/summarize.md +0 -10
  41. package/.claude/commands/docs/update.md +0 -21
  42. package/.claude/commands/fix/ci.md +0 -11
  43. package/.claude/commands/fix/fast.md +0 -12
  44. package/.claude/commands/fix/hard.md +0 -18
  45. package/.claude/commands/fix/logs.md +0 -16
  46. package/.claude/commands/fix/test.md +0 -18
  47. package/.claude/commands/fix/types.md +0 -10
  48. package/.claude/commands/git/cm.md +0 -5
  49. package/.claude/commands/git/cp.md +0 -4
  50. package/.claude/commands/integrate/polar.md +0 -42
  51. package/.claude/commands/plan/ci.md +0 -12
  52. package/.claude/commands/plan/two.md +0 -13
  53. package/.claude/commands/plan.md +0 -10
  54. package/.claude/commands/scout.md +0 -29
  55. package/.claude/commands/test.md +0 -7
  56. package/.claude/commands/watzup.md +0 -8
  57. package/.claude/hooks/telegram_notify.sh +0 -136
  58. package/.claude/send-discord.sh +0 -64
  59. package/.claude/settings.json +0 -7
  60. package/.claude/statusline.sh +0 -143
  61. package/.claude/workflows/development-rules.md +0 -80
  62. package/.claude/workflows/documentation-management.md +0 -28
  63. package/.claude/workflows/orchestration-protocol.md +0 -16
  64. package/.claude/workflows/primary-workflow.md +0 -41
  65. package/.opencode/agent/code-reviewer.md +0 -141
  66. package/.opencode/agent/debugger.md +0 -74
  67. package/.opencode/agent/docs-manager.md +0 -119
  68. package/.opencode/agent/git-manager.md +0 -60
  69. package/.opencode/agent/planner-researcher.md +0 -100
  70. package/.opencode/agent/planner.md +0 -87
  71. package/.opencode/agent/project-manager.md +0 -113
  72. package/.opencode/agent/researcher.md +0 -173
  73. package/.opencode/agent/solution-brainstormer.md +0 -89
  74. package/.opencode/agent/system-architecture.md +0 -192
  75. package/.opencode/agent/tester.md +0 -96
  76. package/.opencode/agent/ui-ux-designer.md +0 -203
  77. package/.opencode/agent/ui-ux-developer.md +0 -97
  78. package/.opencode/command/cook.md +0 -7
  79. package/.opencode/command/debug.md +0 -10
  80. package/.opencode/command/design/3d.md +0 -65
  81. package/.opencode/command/design/fast.md +0 -18
  82. package/.opencode/command/design/good.md +0 -21
  83. package/.opencode/command/design/screenshot.md +0 -22
  84. package/.opencode/command/design/video.md +0 -22
  85. package/.opencode/command/docs/init.md +0 -11
  86. package/.opencode/command/docs/summarize.md +0 -10
  87. package/.opencode/command/docs/update.md +0 -18
  88. package/.opencode/command/fix/ci.md +0 -8
  89. package/.opencode/command/fix/fast.md +0 -11
  90. package/.opencode/command/fix/hard.md +0 -15
  91. package/.opencode/command/fix/logs.md +0 -16
  92. package/.opencode/command/fix/test.md +0 -18
  93. package/.opencode/command/fix/types.md +0 -10
  94. package/.opencode/command/git/cm.md +0 -5
  95. package/.opencode/command/git/cp.md +0 -4
  96. package/.opencode/command/plan/ci.md +0 -12
  97. package/.opencode/command/plan/two.md +0 -13
  98. package/.opencode/command/plan.md +0 -10
  99. package/.opencode/command/test.md +0 -7
  100. package/.opencode/command/watzup.md +0 -8
  101. package/docs/code-standards.md +0 -1128
  102. package/docs/codebase-summary.md +0 -821
  103. package/docs/github-setup.md +0 -176
  104. package/docs/project-pdr.md +0 -739
  105. package/docs/system-architecture.md +0 -950
  106. package/docs/tech-stack.md +0 -290
  107. package/plans/251008-claudekit-cli-implementation-plan.md +0 -1469
  108. package/plans/reports/251008-from-code-reviewer-to-developer-review-report.md +0 -864
  109. package/plans/reports/251008-from-tester-to-developer-test-summary-report.md +0 -409
  110. package/plans/reports/251008-researcher-download-extraction-report.md +0 -1377
  111. package/plans/reports/251008-researcher-github-api-report.md +0 -1339
  112. package/plans/research/251008-cli-frameworks-bun-research.md +0 -1051
  113. package/plans/templates/bug-fix-template.md +0 -69
  114. package/plans/templates/feature-implementation-template.md +0 -84
  115. package/plans/templates/refactor-template.md +0 -82
  116. package/plans/templates/template-usage-guide.md +0 -58
@@ -1,69 +0,0 @@
1
- # [Bug Fix] Implementation Plan
2
-
3
- **Date**: YYYY-MM-DD
4
- **Type**: Bug Fix
5
- **Priority**: [Critical/High/Medium/Low]
6
- **Context Tokens**: <150 words
7
-
8
- ## Executive Summary
9
- Brief description of the bug and its impact.
10
-
11
- ## Issue Analysis
12
- ### Symptoms
13
- - [ ] Symptom 1
14
- - [ ] Symptom 2
15
-
16
- ### Root Cause
17
- Brief explanation of the underlying cause.
18
-
19
- ### Evidence
20
- - **Logs**: Reference to log files (don't include full logs)
21
- - **Error Messages**: Key error patterns
22
- - **Affected Components**: List of impacted files/modules
23
-
24
- ## Context Links
25
- - **Related Issues**: [GitHub issue numbers]
26
- - **Recent Changes**: [Relevant commits or PRs]
27
- - **Dependencies**: [Related systems]
28
-
29
- ## Solution Design
30
- ### Approach
31
- High-level fix strategy in 2-3 sentences.
32
-
33
- ### Changes Required
34
- 1. **File 1** (`path/to/file.ts`): Brief change description
35
- 2. **File 2** (`path/to/file.ts`): Brief change description
36
-
37
- ### Testing Changes
38
- - [ ] Update existing tests
39
- - [ ] Add new test cases
40
- - [ ] Validate fix doesn't break existing functionality
41
-
42
- ## Implementation Steps
43
- 1. [ ] Step 1 - file: `path/to/file.ts`
44
- 2. [ ] Step 2 - file: `path/to/file.ts`
45
- 3. [ ] Run test suite
46
- 4. [ ] Validate fix in relevant environments
47
-
48
- ## Verification Plan
49
- ### Test Cases
50
- - [ ] Test case 1: Expected behavior
51
- - [ ] Test case 2: Edge case handling
52
- - [ ] Regression test: Ensure no new issues
53
-
54
- ### Rollback Plan
55
- If the fix causes issues:
56
- 1. Revert commit: `git revert <commit-hash>`
57
- 2. Restore previous behavior in files X, Y, Z
58
-
59
- ## Risk Assessment
60
- | Risk | Impact | Mitigation |
61
- |------|--------|------------|
62
- | Risk 1 | Medium | Mitigation plan |
63
-
64
- ## TODO Checklist
65
- - [ ] Implement fix
66
- - [ ] Update tests
67
- - [ ] Run full test suite
68
- - [ ] Code review
69
- - [ ] Deploy and verify
@@ -1,84 +0,0 @@
1
- # [Feature Name] Implementation Plan
2
-
3
- **Date**: YYYY-MM-DD
4
- **Type**: Feature Implementation
5
- **Status**: Planning
6
- **Context Tokens**: <200 words
7
-
8
- ## Executive Summary
9
- Brief 2-3 sentence description of the feature and its business value.
10
-
11
- ## Context Links
12
- - **Related Plans**: [List other plan files - no full content]
13
- - **Dependencies**: [External systems, APIs, existing features]
14
- - **Reference Docs**: [Link to docs in ./docs directory]
15
-
16
- ## Requirements
17
- ### Functional Requirements
18
- - [ ] Requirement 1
19
- - [ ] Requirement 2
20
-
21
- ### Non-Functional Requirements
22
- - [ ] Performance target
23
- - [ ] Security requirement
24
- - [ ] Scalability requirement
25
-
26
- ## Architecture Overview
27
- ```mermaid
28
- [Simple component diagram]
29
- ```
30
-
31
- ### Key Components
32
- - **Component 1**: Brief description
33
- - **Component 2**: Brief description
34
-
35
- ### Data Models
36
- - **Model 1**: Key fields
37
- - **Model 2**: Key fields
38
-
39
- ## Implementation Phases
40
-
41
- ### Phase 1: [Name] (Est: X days)
42
- **Scope**: Specific boundaries
43
- **Tasks**:
44
- 1. [ ] Task 1 - file: `path/to/file.ts`
45
- 2. [ ] Task 2 - file: `path/to/file.ts`
46
-
47
- **Acceptance Criteria**:
48
- - [ ] Criteria 1
49
- - [ ] Criteria 2
50
-
51
- ### Phase 2: [Name] (Est: X days)
52
- [Repeat structure]
53
-
54
- ## Testing Strategy
55
- - **Unit Tests**: Specific test coverage targets
56
- - **Integration Tests**: Key interaction points
57
- - **E2E Tests**: Critical user flows
58
-
59
- ## Security Considerations
60
- - [ ] Security item 1
61
- - [ ] Security item 2
62
-
63
- ## Risk Assessment
64
- | Risk | Impact | Mitigation |
65
- |------|--------|------------|
66
- | Risk 1 | High | Mitigation strategy |
67
-
68
- ## Quick Reference
69
- ### Key Commands
70
- ```bash
71
- npm run command
72
- ```
73
-
74
- ### Configuration Files
75
- - `config/file.ts`: Purpose
76
- - `.env.example`: Environment variables
77
-
78
- ## TODO Checklist
79
- - [ ] Phase 1 Task 1
80
- - [ ] Phase 1 Task 2
81
- - [ ] Phase 2 Task 1
82
- - [ ] Testing complete
83
- - [ ] Documentation updated
84
- - [ ] Code review passed
@@ -1,82 +0,0 @@
1
- # [Component/Module] Refactoring Plan
2
-
3
- **Date**: YYYY-MM-DD
4
- **Type**: Refactoring
5
- **Scope**: [Module/Component/System level]
6
- **Context Tokens**: <200 words
7
-
8
- ## Executive Summary
9
- Brief description of what is being refactored and why.
10
-
11
- ## Current State Analysis
12
- ### Issues with Current Implementation
13
- - [ ] Issue 1: Performance bottleneck
14
- - [ ] Issue 2: Code maintainability
15
- - [ ] Issue 3: Technical debt
16
-
17
- ### Metrics (Before)
18
- - **Performance**: Current benchmarks
19
- - **Code Quality**: Complexity metrics
20
- - **Test Coverage**: Current percentage
21
-
22
- ## Context Links
23
- - **Affected Modules**: [List without full content]
24
- - **Dependencies**: [Other systems impacted]
25
- - **Related Documentation**: [Links to docs]
26
-
27
- ## Refactoring Strategy
28
- ### Approach
29
- High-level strategy for the refactoring in 2-3 sentences.
30
-
31
- ### Architecture Changes
32
- ```mermaid
33
- [Before/After comparison diagram]
34
- ```
35
-
36
- ### Key Improvements
37
- - **Improvement 1**: Brief description
38
- - **Improvement 2**: Brief description
39
-
40
- ## Implementation Plan
41
-
42
- ### Phase 1: Preparation (Est: X days)
43
- **Scope**: Setup and preparation work
44
- 1. [ ] Create comprehensive tests for current functionality
45
- 2. [ ] Document current behavior
46
- 3. [ ] Identify all dependencies
47
-
48
- ### Phase 2: Core Refactoring (Est: X days)
49
- **Scope**: Main refactoring work
50
- 1. [ ] Refactor component A - file: `path/to/file.ts`
51
- 2. [ ] Refactor component B - file: `path/to/file.ts`
52
- 3. [ ] Update integration points
53
-
54
- ### Phase 3: Integration & Testing (Est: X days)
55
- **Scope**: Validation and cleanup
56
- 1. [ ] Integration testing
57
- 2. [ ] Performance validation
58
- 3. [ ] Documentation updates
59
-
60
- ## Backward Compatibility
61
- - **Breaking Changes**: [List any breaking changes]
62
- - **Migration Path**: [Steps for users/systems]
63
- - **Deprecation Timeline**: [If applicable]
64
-
65
- ## Success Metrics (After)
66
- - **Performance**: Target improvements
67
- - **Code Quality**: Target metrics
68
- - **Test Coverage**: Target percentage
69
-
70
- ## Risk Assessment
71
- | Risk | Impact | Mitigation |
72
- |------|--------|------------|
73
- | Breaking changes | High | Comprehensive testing |
74
- | Performance regression | Medium | Benchmarking |
75
-
76
- ## TODO Checklist
77
- - [ ] Phase 1: Preparation complete
78
- - [ ] Phase 2: Core refactoring complete
79
- - [ ] Phase 3: Integration complete
80
- - [ ] Performance benchmarks validated
81
- - [ ] Documentation updated
82
- - [ ] Code review passed
@@ -1,58 +0,0 @@
1
- # Plan Template Usage Guide
2
-
3
- ## Template Selection
4
-
5
- ### Feature Implementation Template
6
- **Use when**: Adding new functionality, endpoints, services, or modules
7
- **File**: `feature-implementation-template.md`
8
- **Size**: Medium to large scope changes
9
-
10
- ### Bug Fix Template
11
- **Use when**: Fixing specific issues, errors, or broken functionality
12
- **File**: `bug-fix-template.md`
13
- **Size**: Small to medium scope changes
14
-
15
- ### Refactoring Template
16
- **Use when**: Improving code structure, performance, or maintainability without changing functionality
17
- **File**: `refactor-template.md`
18
- **Size**: Medium to large scope changes
19
-
20
- ## Context Management Best Practices
21
-
22
- ### Keep Plans Focused
23
- - **Executive Summary**: Max 3 sentences
24
- - **Context Links**: Reference files, don't include full content
25
- - **Tasks**: Max 10 per phase
26
- - **Context Tokens**: Target <200 words for summaries
27
-
28
- ### Template Adaptation
29
- 1. Copy the appropriate template to `plans/YYMMDD-feature-name-plan.md`
30
- 2. Replace bracketed placeholders with actual content
31
- 3. Remove sections not relevant to your specific use case
32
- 4. Keep the core structure intact for consistency
33
-
34
- ### Cross-References Instead of Duplication
35
- - Link to existing documentation in `./docs/`
36
- - Reference other plans without copying content
37
- - Use file paths instead of code blocks where possible
38
- - Focus on "what" and "why", not detailed "how"
39
-
40
- ## Quality Checklist
41
-
42
- Before finalizing any plan:
43
- - [ ] Executive summary is clear and concise
44
- - [ ] Tasks are specific and actionable
45
- - [ ] File paths are included for implementation tasks
46
- - [ ] Success criteria are measurable
47
- - [ ] Context links are used instead of full content
48
- - [ ] TODO checklist is complete and realistic
49
-
50
- ## Context Refresh Triggers
51
-
52
- Use these templates when:
53
- - Starting a new development phase
54
- - Switching between different types of work (feature → bugfix)
55
- - After major context accumulation (>8000 tokens)
56
- - When agent handoffs occur
57
-
58
- This ensures each plan starts with fresh, focused context optimized for the specific task type.