prizmkit 1.1.39 → 1.1.41

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 (34) hide show
  1. package/bundled/VERSION.json +3 -3
  2. package/bundled/dev-pipeline/SCHEMA_ANALYSIS.md +1 -1
  3. package/bundled/dev-pipeline/run-bugfix.sh +74 -0
  4. package/bundled/dev-pipeline/run-feature.sh +74 -0
  5. package/bundled/dev-pipeline/run-refactor.sh +74 -0
  6. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +0 -6
  7. package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +118 -1
  8. package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +123 -8
  9. package/bundled/dev-pipeline/templates/bootstrap-tier1.md +0 -23
  10. package/bundled/dev-pipeline/templates/bootstrap-tier2.md +0 -23
  11. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +0 -23
  12. package/bundled/dev-pipeline/templates/bug-fix-list-schema.json +22 -3
  13. package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +56 -0
  14. package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +64 -4
  15. package/bundled/dev-pipeline/templates/refactor-list-schema.json +22 -3
  16. package/bundled/dev-pipeline/tests/test-deploy-safety.sh +223 -0
  17. package/bundled/skills/_metadata.json +3 -3
  18. package/bundled/skills/app-planner/SKILL.md +0 -3
  19. package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +34 -6
  20. package/bundled/skills/feature-pipeline-launcher/SKILL.md +42 -18
  21. package/bundled/skills/prizmkit-committer/SKILL.md +0 -1
  22. package/bundled/skills/prizmkit-deploy/SKILL.md +491 -209
  23. package/bundled/skills/prizmkit-deploy/references/cloud-platform-deploy.md +93 -0
  24. package/bundled/skills/prizmkit-deploy/references/deploy-config-schema.md +147 -0
  25. package/bundled/skills/prizmkit-deploy/references/deploy-history-schema.md +62 -0
  26. package/bundled/skills/prizmkit-deploy/references/docker-deploy.md +31 -0
  27. package/bundled/skills/prizmkit-deploy/references/nginx-blue-green.md +59 -0
  28. package/bundled/skills/prizmkit-init/SKILL.md +0 -2
  29. package/bundled/skills/prizmkit-plan/SKILL.md +0 -3
  30. package/bundled/skills/recovery-workflow/SKILL.md +96 -7
  31. package/bundled/skills/refactor-pipeline-launcher/SKILL.md +40 -9
  32. package/package.json +1 -1
  33. package/bundled/dev-pipeline/templates/sections/phase-deploy-verification.md +0 -31
  34. package/bundled/skills/prizmkit-deploy/assets/deploy-template.md +0 -187
@@ -1,31 +0,0 @@
1
- ### Local Deploy Verification
2
-
3
- You just implemented this feature — you know the project's tech stack and build tools.
4
-
5
- 1. **Build**: Run the project's build/compile commands. If a required tool is missing, install it first.
6
- 2. **Fix**: If build fails with code errors (type errors, missing imports, config issues), fix them (max 2 rounds), then re-verify.
7
- 3. **Assess and record** — append to context-snapshot.md:
8
- - **ALL builds pass** → `## Deploy Verification: PASS` — proceed to commit
9
- - **Some builds fail with fixable errors** → fix and re-verify (already handled in step 2)
10
- - **Cannot build locally** (missing system-level deps you cannot install) → Record: `## Deploy Verification: PARTIAL — missing system deps (see below)`
11
-
12
- Deploy verification does NOT block the commit, but you MUST attempt it.
13
-
14
- **Smoke test** (only if build passed and project can be started):
15
- 1. Start the project locally (e.g., `make dev`, `npm start`, `go run .`, etc.)
16
- 2. Verify basic functionality: hit key endpoints, check health routes, confirm the UI loads
17
- 3. Stop the server process you started — do NOT leave it running
18
- 4. Record smoke test results in `## Deploy Verification` section
19
-
20
- If the project cannot be started locally (e.g., requires external services, databases, credentials), skip the smoke test and note why.
21
-
22
- **Deploy documentation update** — Run `/prizmkit-deploy` ONLY if this feature introduced new infrastructure or deployment-affecting changes:
23
- - New database, cache, message queue, or external service dependency
24
- - New environment variables required
25
- - New build steps or deployment configuration (Dockerfile, CI/CD, cloud config)
26
- - Changed ports, protocols, or service topology
27
-
28
- If none of the above apply (pure application logic change), skip `/prizmkit-deploy`.
29
-
30
-
31
- **Checkpoint update**: Update `workflow-checkpoint.json` — set step `deploy-verification` to `"completed"`.
@@ -1,187 +0,0 @@
1
- # Deployment Guide: [PROJECT_NAME]
2
- <!-- Replace [PROJECT_NAME] with: name from package.json, or the project root directory name -->
3
-
4
- > Generated by PrizmKit Deploy
5
-
6
- ## Prerequisites
7
-
8
- | Tool | Version | Install |
9
- |------|---------|---------|
10
- | [tool] | [version] | [install command or link] |
11
-
12
- ## Environment Variables
13
-
14
- | Variable | Required | Description | Default | Example |
15
- |----------|----------|-------------|---------|---------|
16
- | [VAR_NAME] | yes/no | [Purpose] | [default or n/a] | [example value] |
17
-
18
- **Setup:**
19
- ```bash
20
- cp .env.example .env
21
- # Edit .env with your values
22
- ```
23
-
24
- ## Local Development
25
-
26
- ### First-time Setup
27
- ```bash
28
- # [Clone + install steps]
29
- ```
30
-
31
- ### Run Locally
32
- ```bash
33
- # [Start command]
34
- ```
35
-
36
- ### Local Services
37
- <!-- If docker-compose or similar is used for local dependencies -->
38
- ```bash
39
- # [Local services startup]
40
- ```
41
-
42
- ## Database Setup
43
- <!-- Skip if project does not use a database -->
44
-
45
- ### Database Type
46
- [PostgreSQL / MySQL / MongoDB / SQLite / etc.]
47
-
48
- ### Initial Setup
49
- ```bash
50
- # [Database creation commands]
51
- # [Initial migration or schema setup]
52
- ```
53
-
54
- ### Run Migrations
55
- ```bash
56
- # [Migration command, e.g., npx prisma migrate deploy, alembic upgrade head]
57
- ```
58
-
59
- ### Seed Data
60
- ```bash
61
- # [Seed command if applicable, or "No seed data configured"]
62
- ```
63
-
64
- ### Database Conventions
65
- <!-- Auto-populated from CLAUDE.md ### Infrastructure → #### Database -->
66
- <!-- Filled progressively: basic info from prizmkit-init, detailed conventions from app-planner, verified by prizmkit-deploy -->
67
- - Table naming: [convention]
68
- - Migration directory: [path]
69
- - Migration naming: [rule]
70
-
71
- ## Testing
72
-
73
- ### Run Tests
74
- ```bash
75
- # [Test commands]
76
- ```
77
-
78
- ### Staging / Pre-production
79
- <!-- How to test against a staging environment -->
80
- - Staging URL: [URL or "not configured"]
81
- - Deploy to staging: [command or process]
82
-
83
- ## Build
84
-
85
- ```bash
86
- # [Build command]
87
- ```
88
-
89
- **Output:** [where build artifacts go, e.g. `dist/`, `build/`, binary path]
90
-
91
- ## Production Deployment
92
-
93
- ### Deployment Method
94
- <!-- Filled from deploy_strategy in config -->
95
- [Description of production deployment approach]
96
-
97
- ### Step-by-step
98
- 1. [Step 1]
99
- 2. [Step 2]
100
- 3. [Step 3]
101
-
102
- ### Post-deployment Verification
103
- ```bash
104
- # [Health check or smoke test command]
105
- ```
106
-
107
- ## CI/CD
108
- <!-- Skip if no CI/CD config detected -->
109
-
110
- | Pipeline | Trigger | Action |
111
- |----------|---------|--------|
112
- | [pipeline name] | [trigger event] | [what it does] |
113
-
114
- ## Rollback
115
-
116
- ### How to Rollback
117
- 1. [Rollback step 1]
118
- 2. [Rollback step 2]
119
-
120
- ### When to Rollback
121
- - [Criteria that warrant a rollback]
122
-
123
- ## Health Check
124
-
125
- | Check | Endpoint / Command | Expected Result |
126
- |-------|-------------------|-----------------|
127
- | [check name] | [endpoint or command] | [expected output] |
128
-
129
- ## Platform-Specific Deploy Commands
130
- <!-- Auto-populated based on deployment target from CLAUDE.md ### Infrastructure → #### Deployment -->
131
- <!-- Filled progressively: basic target from prizmkit-init, detailed config from app-planner, verified by prizmkit-deploy -->
132
-
133
- ### [Platform Name]
134
- ```bash
135
- # Pre-flight
136
- [version check command]
137
- [auth check command]
138
-
139
- # Deploy
140
- [deploy command]
141
-
142
- # Verify
143
- [post-deploy verification command]
144
- ```
145
-
146
- ## AI Deploy Playbook
147
- <!-- Used by prizmkit-deploy Phase 4 when AI-assisted deploy is enabled -->
148
- <!-- This section is auto-generated — do not edit manually unless you want to customize the sequence -->
149
-
150
- ### Pre-flight Checklist
151
- - [ ] CLI tool installed: [tool name + version command]
152
- - [ ] Authentication verified: [auth check command or "logged in via [method]"]
153
- - [ ] Environment variables set: [list of required env vars for deployment]
154
- - [ ] Build successful: [build command]
155
-
156
- ### Command Sequence
157
- <!-- Ordered list of commands AI will execute step-by-step with user confirmation -->
158
- 1. `[command 1]` — [what it does]
159
- 2. `[command 2]` — [what it does]
160
- 3. `[command 3]` — [what it does]
161
-
162
- ### Post-Deploy Verification
163
- - [ ] Health check: [command or URL]
164
- - [ ] Smoke test: [manual or automated check]
165
-
166
- ### Rollback (if deploy fails)
167
- ```bash
168
- # [Rollback command specific to the platform]
169
- ```
170
-
171
- ## Deployment Credentials Reference
172
- <!-- This information is stored in CLAUDE.md / CODEBUDDY.md ### Infrastructure → #### Deployment Credentials Reference -->
173
- <!-- Listed here for quick reference during deployment execution -->
174
-
175
- | Platform | Auth Method | Location |
176
- |----------|------------|----------|
177
- | [platform] | [method, e.g., API token, SSH key, CLI login] | [where stored, e.g., VERCEL_TOKEN env var] |
178
-
179
- ## Troubleshooting
180
-
181
- | Symptom | Cause | Fix |
182
- |---------|-------|-----|
183
- | [symptom] | [likely cause] | [resolution steps] |
184
-
185
- ## TODO
186
- <!-- Auto-generated: items that need manual attention -->
187
- - [ ] [items prizmkit-deploy could not auto-fill]