prizmkit 1.1.190 → 1.1.192
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.
- package/bin/create-prizmkit.js +4 -4
- package/bundled/VERSION.json +3 -3
- package/bundled/adapters/antigravity/assets/prizmkit-hook.cjs +150 -0
- package/bundled/adapters/antigravity/hooks-adapter.js +195 -0
- package/bundled/adapters/antigravity/paths.js +14 -0
- package/bundled/adapters/antigravity/rules-adapter.js +54 -0
- package/bundled/adapters/antigravity/skill-adapter.js +38 -0
- package/bundled/adapters/codex/skill-adapter.js +28 -8
- package/bundled/adapters/cursor/skill-adapter.js +13 -4
- package/bundled/adapters/pi/skill-adapter.js +28 -7
- package/bundled/dev-pipeline/.env.example +4 -12
- package/bundled/dev-pipeline/README.md +21 -15
- package/bundled/dev-pipeline/assets/skill-subagent-integration.md +3 -6
- package/bundled/dev-pipeline/prizmkit_runtime/atomic_io.py +48 -0
- package/bundled/dev-pipeline/prizmkit_runtime/checkpoint_state.py +66 -23
- package/bundled/dev-pipeline/prizmkit_runtime/cli.py +10 -7
- package/bundled/dev-pipeline/prizmkit_runtime/commands.py +2 -21
- package/bundled/dev-pipeline/prizmkit_runtime/config.py +29 -70
- package/bundled/dev-pipeline/prizmkit_runtime/daemon.py +125 -67
- package/bundled/dev-pipeline/prizmkit_runtime/gitops.py +89 -442
- package/bundled/dev-pipeline/prizmkit_runtime/heartbeat.py +93 -49
- package/bundled/dev-pipeline/prizmkit_runtime/interoperability.py +1 -3
- package/bundled/dev-pipeline/prizmkit_runtime/paths.py +0 -6
- package/bundled/dev-pipeline/prizmkit_runtime/platform_detection.py +49 -18
- package/bundled/dev-pipeline/prizmkit_runtime/processes.py +206 -151
- package/bundled/dev-pipeline/prizmkit_runtime/reset.py +2 -23
- package/bundled/dev-pipeline/prizmkit_runtime/reset_preserve.py +15 -134
- package/bundled/dev-pipeline/prizmkit_runtime/results.py +25 -0
- package/bundled/dev-pipeline/prizmkit_runtime/runner_bookkeeping.py +68 -83
- package/bundled/dev-pipeline/prizmkit_runtime/runner_classification.py +15 -5
- package/bundled/dev-pipeline/prizmkit_runtime/runner_models.py +1 -29
- package/bundled/dev-pipeline/prizmkit_runtime/runner_prompts.py +0 -2
- package/bundled/dev-pipeline/prizmkit_runtime/runner_status.py +7 -2
- package/bundled/dev-pipeline/prizmkit_runtime/runners.py +282 -217
- package/bundled/dev-pipeline/prizmkit_runtime/runtime_commit.py +124 -122
- package/bundled/dev-pipeline/prizmkit_runtime/runtime_helper.py +90 -9
- package/bundled/dev-pipeline/prizmkit_runtime/sessions.py +369 -154
- package/bundled/dev-pipeline/prizmkit_runtime/status.py +3 -3
- package/bundled/dev-pipeline/prizmkit_runtime/stream_progress.py +2780 -0
- package/bundled/dev-pipeline/prizmkit_runtime/task_checkout.py +27 -101
- package/bundled/dev-pipeline/prizmkit_runtime/test_result.py +58 -4
- package/bundled/dev-pipeline/scripts/check-session-status.py +43 -19
- package/bundled/dev-pipeline/scripts/continuation.py +6 -4
- package/bundled/dev-pipeline/scripts/detect-stuck.py +28 -28
- package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +7 -2
- package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +7 -2
- package/bundled/dev-pipeline/scripts/init-bugfix-pipeline.py +10 -7
- package/bundled/dev-pipeline/scripts/init-change-artifact.py +8 -2
- package/bundled/dev-pipeline/scripts/init-pipeline.py +14 -69
- package/bundled/dev-pipeline/scripts/parse-stream-progress.py +31 -2328
- package/bundled/dev-pipeline/scripts/patch-completion-notes.py +4 -24
- package/bundled/dev-pipeline/scripts/prompt_framework.py +56 -9
- package/bundled/dev-pipeline/scripts/status_common.py +591 -0
- package/bundled/dev-pipeline/scripts/update-bug-status.py +85 -463
- package/bundled/dev-pipeline/scripts/update-checkpoint.py +227 -65
- package/bundled/dev-pipeline/scripts/update-feature-status.py +76 -509
- package/bundled/dev-pipeline/scripts/utils.py +10 -15
- package/bundled/dev-pipeline/templates/bootstrap-tier3.md +4 -4
- package/bundled/dev-pipeline/templates/bug-fix-list-schema.json +7 -0
- package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +1 -1
- package/bundled/dev-pipeline/templates/sections/artifact-manifest.md +1 -1
- package/bundled/dev-pipeline/templates/sections/bugfix-phase-manual-verification.md +1 -1
- package/bundled/dev-pipeline/templates/sections/bugfix-phase-review.md +1 -1
- package/bundled/dev-pipeline/templates/sections/bugfix-phase-test.md +2 -1
- package/bundled/dev-pipeline/templates/sections/checkpoint-system.md +1 -1
- package/bundled/dev-pipeline/templates/sections/phase-browser-verification-auto.md +1 -1
- package/bundled/dev-pipeline/templates/sections/phase-browser-verification-opencli.md +2 -2
- package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +2 -2
- package/bundled/dev-pipeline/templates/sections/phase-prizmkit-test.md +2 -1
- package/bundled/dev-pipeline/templates/sections/phase-review-full.md +1 -1
- package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +3 -6
- package/bundled/dev-pipeline/templates/session-status-schema.json +2 -5
- package/bundled/dev-pipeline/tests/_helpers.py +418 -0
- package/bundled/dev-pipeline/tests/conftest.py +45 -1
- package/bundled/dev-pipeline/tests/live_ai_cli_log_smoke.py +1 -0
- package/bundled/dev-pipeline/tests/test_auto_skip.py +4 -69
- package/bundled/dev-pipeline/tests/test_checkpoint_state.py +126 -1
- package/bundled/dev-pipeline/tests/test_daemon_and_scripts.py +257 -0
- package/bundled/dev-pipeline/tests/test_e2e_pipeline_run.py +500 -0
- package/bundled/dev-pipeline/tests/test_generate_bootstrap_prompt.py +59 -117
- package/bundled/dev-pipeline/tests/test_generate_bugfix_prompt.py +12 -10
- package/bundled/dev-pipeline/tests/test_python_runner_parity.py +561 -3094
- package/bundled/dev-pipeline/tests/test_recovery_workflow.py +7 -8
- package/bundled/dev-pipeline/tests/test_repository_bootstrap.py +0 -1
- package/bundled/dev-pipeline/tests/test_reset_modes.py +15 -27
- package/bundled/dev-pipeline/tests/test_reset_preserve.py +54 -139
- package/bundled/dev-pipeline/tests/test_runner_bookkeeping.py +766 -0
- package/bundled/dev-pipeline/tests/test_runner_lifecycle.py +1257 -0
- package/bundled/dev-pipeline/tests/test_runtime_helper.py +97 -20
- package/bundled/dev-pipeline/tests/test_session_launch.py +1101 -0
- package/bundled/dev-pipeline/tests/test_stream_progress.py +585 -0
- package/bundled/dev-pipeline/tests/test_unified_cli.py +490 -2006
- package/bundled/dev-pipeline/tests/test_utils.py +3 -3
- package/bundled/rules/USAGE.md +1 -0
- package/bundled/skills/_metadata.json +9 -63
- package/bundled/skills/app-planner/SKILL.md +32 -303
- package/bundled/skills/app-planner/references/app-design-guide.md +0 -4
- package/bundled/skills/app-planner/references/generated-plan-review.md +2 -1
- package/bundled/skills/app-planner/references/project-brief-guide.md +14 -0
- package/bundled/skills/app-planner/references/project-conventions-discovery.md +4 -6
- package/bundled/skills/app-planner/references/project-state-detection.md +2 -3
- package/bundled/skills/bug-fix-workflow/SKILL.md +1 -2
- package/bundled/skills/bug-fix-workflow/references/bug-diagnosis.md +4 -7
- package/bundled/skills/bug-planner/SKILL.md +54 -435
- package/bundled/skills/bug-planner/references/generated-plan-review.md +3 -2
- package/bundled/skills/bug-planner/references/input-formats.md +32 -0
- package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +4 -6
- package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md +4 -28
- package/bundled/skills/feature-pipeline-launcher/SKILL.md +4 -6
- package/bundled/skills/feature-pipeline-launcher/references/configuration.md +4 -28
- package/bundled/skills/feature-planner/SKILL.md +60 -439
- package/bundled/skills/feature-planner/assets/planning-guide.md +1 -1
- package/bundled/skills/feature-planner/references/completeness-review.md +34 -0
- package/bundled/skills/feature-planner/references/decomposition-patterns.md +2 -2
- package/bundled/skills/feature-planner/references/error-recovery.md +1 -1
- package/bundled/skills/feature-planner/references/generated-plan-review.md +3 -2
- package/bundled/skills/feature-planner/references/incremental-feature-planning.md +3 -1
- package/bundled/skills/feature-workflow/SKILL.md +1 -2
- package/bundled/skills/prizmkit/SKILL.md +7 -1
- package/bundled/skills/prizmkit-code-review/SKILL.md +14 -6
- package/bundled/skills/prizmkit-code-review/references/independent-code-review.md +7 -4
- package/bundled/skills/prizmkit-code-review/references/review-report-template.md +16 -0
- package/bundled/skills/prizmkit-code-review/scripts/render_review_report.py +58 -20
- package/bundled/skills/prizmkit-implement/SKILL.md +1 -1
- package/bundled/skills/prizmkit-init/SKILL.md +25 -128
- package/bundled/skills/prizmkit-init/assets/project-brief-template.md +3 -3
- package/bundled/skills/prizmkit-init/references/config-schema.md +2 -2
- package/bundled/skills/prizmkit-plan/SKILL.md +6 -8
- package/bundled/skills/prizmkit-plan/references/clarify-guide.md +1 -1
- package/bundled/skills/prizmkit-plan/references/independent-plan-review.md +5 -2
- package/bundled/skills/prizmkit-plan/references/review-plan-spec-loop.md +6 -5
- package/bundled/skills/prizmkit-prizm-docs/SKILL.md +1 -13
- package/bundled/skills/prizmkit-prizm-docs/assets/prizm-docs-format.md +1 -1
- package/bundled/skills/prizmkit-prizm-docs/references/op-init.md +1 -1
- package/bundled/skills/prizmkit-prizm-docs/references/op-update.md +1 -1
- package/bundled/skills/prizmkit-retrospective/SKILL.md +6 -4
- package/bundled/skills/prizmkit-test/SKILL.md +25 -133
- package/bundled/skills/prizmkit-test/references/independent-test-review.md +5 -2
- package/bundled/skills/prizmkit-test/references/test-coverage-model.md +6 -0
- package/bundled/skills/prizmkit-workflow/SKILL.md +2 -3
- package/bundled/skills/prizmkit-workflow/references/workflow-state-protocol.md +4 -3
- package/bundled/skills/recovery-workflow/SKILL.md +7 -7
- package/bundled/skills/recovery-workflow/evals/evals.json +1 -1
- package/bundled/skills/recovery-workflow/references/detection.md +1 -3
- package/bundled/skills/recovery-workflow/scripts/detect-recovery-state.py +0 -6
- package/bundled/templates/project-memory-template.md +1 -2
- package/package.json +1 -1
- package/src/ai-cli-launch.js +1 -1
- package/src/clean.js +40 -4
- package/src/config.js +64 -4
- package/src/detect-platform.js +10 -6
- package/src/external-skills.js +2 -2
- package/src/index.js +1 -0
- package/src/manifest.js +1 -1
- package/src/platforms.js +6 -2
- package/src/prompts.js +11 -3
- package/src/scaffold.js +87 -11
- package/src/upgrade.js +9 -3
- package/bundled/dev-pipeline/SCHEMA_ANALYSIS.md +0 -53
- package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +0 -649
- package/bundled/dev-pipeline/scripts/init-refactor-pipeline.py +0 -463
- package/bundled/dev-pipeline/scripts/update-refactor-status.py +0 -1512
- package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +0 -240
- package/bundled/dev-pipeline/templates/refactor-list-schema.json +0 -266
- package/bundled/dev-pipeline/templates/sections/refactor-critical-paths.md +0 -15
- package/bundled/dev-pipeline/templates/sections/refactor-mission.md +0 -9
- package/bundled/dev-pipeline/templates/sections/refactor-phase-commit-report.md +0 -24
- package/bundled/dev-pipeline/templates/sections/refactor-phase-implement.md +0 -16
- package/bundled/dev-pipeline/templates/sections/refactor-phase-init.md +0 -9
- package/bundled/dev-pipeline/templates/sections/refactor-phase-plan.md +0 -22
- package/bundled/dev-pipeline/templates/sections/refactor-phase-review.md +0 -19
- package/bundled/dev-pipeline/templates/sections/refactor-phase-test.md +0 -24
- package/bundled/dev-pipeline/templates/sections/refactor-reminders.md +0 -12
- package/bundled/dev-pipeline/templates/sections/refactor-session-context.md +0 -6
- package/bundled/dev-pipeline/templates/sections/refactor-task-contract.md +0 -52
- package/bundled/dev-pipeline/tests/test_generate_refactor_prompt.py +0 -478
- package/bundled/skills/feature-planner/assets/evaluation-guide.md +0 -44
- package/bundled/skills/refactor-pipeline-launcher/SKILL.md +0 -219
- package/bundled/skills/refactor-pipeline-launcher/references/configuration.md +0 -78
- package/bundled/skills/refactor-planner/SKILL.md +0 -467
- package/bundled/skills/refactor-planner/assets/planning-guide.md +0 -291
- package/bundled/skills/refactor-planner/references/behavior-preservation.md +0 -187
- package/bundled/skills/refactor-planner/references/error-recovery.md +0 -45
- package/bundled/skills/refactor-planner/references/fast-path.md +0 -59
- package/bundled/skills/refactor-planner/references/generated-plan-review.md +0 -107
- package/bundled/skills/refactor-planner/references/planning-phases.md +0 -172
- package/bundled/skills/refactor-planner/references/refactor-scoping-guide.md +0 -230
- package/bundled/skills/refactor-planner/scripts/validate-and-generate-refactor.py +0 -1120
- package/bundled/skills/refactor-workflow/SKILL.md +0 -205
|
@@ -51,3 +51,35 @@ ALERT: Error rate spike: 500 errors/min on /api/login endpoint
|
|
|
51
51
|
```
|
|
52
52
|
|
|
53
53
|
Extract: `error_source.type="monitoring_alert"`, `error_message`, `affected_modules`
|
|
54
|
+
|
|
55
|
+
## Fresh-Session Task Contract Reference
|
|
56
|
+
|
|
57
|
+
Every new or changed bug is an executable contract for a fresh AI session that has never seen the planning conversation. Do not add new JSON fields, context objects, schema versions, or pipeline runtime structures. Use the existing fields correctly:
|
|
58
|
+
|
|
59
|
+
1. **Self-contained contract**: `description` and `acceptance_criteria`, read together, MUST define the objective, current state and actual behavior, desired state and expected behavior, selected scope and decisions, severity rationale, constraints, non-goals, relevant integrations, edge cases, reproduction conditions, verification decisions, and completion evidence. Include the durable severity rationale in `description`. AI rewrite is allowed; dropping a confirmed item is not. There is no word-count or acceptance-criteria count upper limit.
|
|
60
|
+
2. **Supplementary evidence only**: `user_context` is supplementary evidence only. Logs, stack traces, screenshots, and source excerpts may support diagnosis, but MUST NOT expand, replace, or contradict the contract. If `user_context` were removed, a fresh bug-fix session must still know what fails, where/when it fails, correct behavior, selected scope, and verification. Preserve substantive requirements and constraints in durable prose at matching detail.
|
|
61
|
+
3. **Severity and verification are durable decisions**: Write complete severity rationale, selected scope, environment, reproduction path, verification type, and verification decisions by meaning; never store only an option label or conversational answer.
|
|
62
|
+
4. **Clarify by impact, do not guess**: Clarify expected behavior, selected scope, applicability, and relative references when ambiguity changes the contract. Root cause, code location, and fix approach may stay explicitly labeled as evidence-backed hypotheses or unknowns (`do not force certainty or invent a fix`).
|
|
63
|
+
5. **Bug isolation**: Keep one bug per task unless bugs share the same root cause or failing contract and the user confirms merging (never domain-merge unrelated bugs in the same module). Repeat shared environment or constraints only when global.
|
|
64
|
+
|
|
65
|
+
### Artifact-Wide AI Readability & Normalization
|
|
66
|
+
|
|
67
|
+
- Every generated natural-language value (`project_description`, `global_context`, titles, descriptions, acceptance criteria, severity/priority rationale, `error_source`, environment, `user_context`, verification goals, comments, parentheticals) must be a standalone domain statement (machine IDs/enums/timestamps exempt).
|
|
68
|
+
- Never emit dialogue-role/chronology labels (`user said`, `user answered`, `original request`, `this round`, `previous discussion`, `as discussed earlier`, `用户本轮回答`, `如前面讨论`), planning question IDs, answer tokens, recommendation markers, checkpoint provenance, or raw internal answer-map entries.
|
|
69
|
+
- Never persist standalone option labels (`A`, `B`, `C`, `方案A`, `方案B`) or transcript annotations (`(original response: "...")`). Resolve relative statements (`上面`, `这个`, `按推荐走`, `同前`, `继续这样`, `用刚才的方案`, `same as above`, `go with your recommendation`) only when there is one provable antecedent; otherwise ask the user for clarification and never guess.
|
|
70
|
+
- Treat `所有问题都按你的推荐处理`, `全部按照推荐`, `use all recommendations`, and equivalent blanket recommendation approval as conversational authorization: apply concrete recommendations and omit the blanket approval token.
|
|
71
|
+
- Preserve rejected root-cause/fix alternatives only when they define necessary non-goals. Every retained code/config/interface/URL reference must be purpose-tagged (this applies to paths and URLs in structured evidence and `user_context`). Retain exact user wording only when it is independently intelligible and materially useful. Do not retain non-code planning-source paths such as `.agents/brainstorm/<note>.md`, uploaded-report paths, screenshot paths, or ad-hoc log paths (such as `logs/api-500.log`) in durable bug contracts—copy or normalize the task-relevant content into `description` and `acceptance_criteria` so the bug must not depend on that source file still existing. For large materials, preserve purpose and only task-relevant exact excerpts; embed complete large materials only when the execution session cannot access the source and all content is genuinely required.
|
|
72
|
+
|
|
73
|
+
### Examples & Phase 4 Step Details
|
|
74
|
+
|
|
75
|
+
- Bad: `方案B`, `按推荐走`, `use option A`, `Selected decision: reject empty passwords (original response: "方案B")`, `全部按照推荐`, attaching complete logs/files while saying `fix this`.
|
|
76
|
+
- Good: `Selected decision: reject empty passwords in request validation with HTTP 400 and do not enter credential verification`; `src/auth/validation.ts — inspect empty-password handling`; inline relevant exception/correlation excerpts plus expected vs actual behavior.
|
|
77
|
+
- Multi-bug isolation: if `Bug A` is login empty-password crash and `Bug B` is CSV encoding loss with shared `Node 20`, keep each bug contract isolated to its own behavior and include `Node 20` on both without cross-contaminating Bug A and Bug B.
|
|
78
|
+
- **Step 1 (Adequacy scan)**: Ensure description states expected vs actual behavior, specific reproduction path and trigger action, evidenced code-location hint or explicit unknown/discovery target, and verification method (e.g., Bad: `"Login is broken"`; Good: `"/login returns 500 on empty password; expected 400; suspect src/api/auth.ts POST /api/auth/login"`).
|
|
79
|
+
- **Step 2 (Criteria specificity)**: Each criterion must pass headless autonomy without subjective phrasing (`"works correctly"`, `"performs better"`).
|
|
80
|
+
- **Step 3 (Cross-bug)**: One bug per task (merge only on shared root cause + confirmation), flag missing dependencies (`B-002` depends on `B-001`), flag broader symptom areas.
|
|
81
|
+
- **Step 4 (Review table)**: Present `${SKILL_DIR}/assets/bug-confirmation-template.md` §Completeness Review Template and resolve every `NEEDS_FIXES` item before Phase 5.
|
|
82
|
+
|
|
83
|
+
## Bounded Existing-List Context (Hard Rule)
|
|
84
|
+
|
|
85
|
+
For append flows on `.prizmkit/plans/bug-fix-list.json`, NEVER read the complete existing list or NEVER perform default full-history keyword search. Inspect the five most recently appended `{id, description}` pairs from `context` only for material continuation, duplication, conflict, shared public contract, or real prerequisite (`Chronology, broad module overlap, shared technology, reusable implementation ideas, or similar wording alone do not establish relevance`; Add no historical content by default; incorporate only the minimum exact information whose omission would make scope, behavior, compatibility, acceptance criteria, or dependency ordering incorrect; no vague `related to B-123`; add an old ID to `dependencies` only when it is a real execution prerequisite). Use `show --id B-NNN` only for explicit old IDs or validation errors. Write additions-only `{ "bugs": [...] }` (required draft fields: `id`, `title`, `description`, `severity`, `error_source`, `verification_type`, `acceptance_criteria`; `status` defaults to `pending`) in `.prizmkit/plans/bug-fix-list.draft.json`, check `append --dry-run` (Do not ask for separate user approval merely to promote the draft into the final list), pass Local Generated-Plan Review, insert once, delete the draft immediately, and present the final written result. Conditions that must keep a draft live in `references/error-recovery.md`. Preserve unchanged historical bugs.
|
|
@@ -41,8 +41,6 @@ Default paths:
|
|
|
41
41
|
|
|
42
42
|
Accept a user-specified bug-list path when provided. Read the plan directly to summarize IDs, severity, dependencies, and current statuses. If the plan is missing or malformed, report that a valid bug plan is required and stop without constructing a start command.
|
|
43
43
|
|
|
44
|
-
Read `${SKILL_DIR}/references/configuration.md` before constructing prerequisite or runtime option fragments.
|
|
45
|
-
|
|
46
44
|
## Intent Routing
|
|
47
45
|
|
|
48
46
|
| Intent | Output |
|
|
@@ -51,7 +49,7 @@ Read `${SKILL_DIR}/references/configuration.md` before constructing prerequisite
|
|
|
51
49
|
| Check status | Daemon status and item-level status commands |
|
|
52
50
|
| Show logs | Recent or follow-log command |
|
|
53
51
|
| Stop | Daemon stop command plus optional status command |
|
|
54
|
-
| Retry failed bug work |
|
|
52
|
+
| Retry failed bug work | State-only, preserve-runtime, fresh-checkout, or clean reset plus a separate run command with safety disclosure |
|
|
55
53
|
|
|
56
54
|
Only the start intent uses the execution-mode and configuration rounds.
|
|
57
55
|
|
|
@@ -84,12 +82,12 @@ If Advanced config is Yes, load the advanced question set from `${SKILL_DIR}/ref
|
|
|
84
82
|
|
|
85
83
|
### Step 4: Build command fragments
|
|
86
84
|
|
|
87
|
-
|
|
85
|
+
Read `${SKILL_DIR}/references/configuration.md` if not already loaded during Advanced config, and map confirmed choices to environment variables.
|
|
88
86
|
|
|
89
87
|
Return this prerequisite-check command separately from the pipeline command:
|
|
90
88
|
|
|
91
89
|
```bash
|
|
92
|
-
|
|
90
|
+
python3 ./.prizmkit/dev-pipeline/cli.py diagnostics version && git --version
|
|
93
91
|
```
|
|
94
92
|
|
|
95
93
|
Also include the configured AI CLI check fragment from the reference. These are returned commands, not checks performed by this skill.
|
|
@@ -153,7 +151,7 @@ Optionally include the daemon status command for the user to run afterward. Do n
|
|
|
153
151
|
|
|
154
152
|
Reset never starts execution and rejects `--run`. Every reset command must select exactly one mode: `--state-only`, `--fresh-checkout`, `--clean`, or `--preserve-runtime`. Always return reset and run as separate commands.
|
|
155
153
|
|
|
156
|
-
State-only recovery resets selected failed/skipped/needs-info roots and only causal `auto_skipped` descendants whose complete blocker set is recovered. It resets retry/session/continuation state but never changes checkout identity, branches, worktrees, source changes, checkpoints, or artifact files. Selecting an auto-skipped bug includes all of its transitive blocking roots; `--all` recovers all eligible chains. Fresh-checkout
|
|
154
|
+
State-only recovery resets selected failed/skipped/needs-info roots and only causal `auto_skipped` descendants whose complete blocker set is recovered. It resets retry/session/continuation state but never changes checkout identity, branches, worktrees, source changes, checkpoints, or artifact files. Selecting an auto-skipped bug includes all of its transitive blocking roots; `--all` recovers all eligible chains. Fresh-checkout resets task state, can discard uncommitted changes on the active task branch, and records a new checkout boundary. Clean additionally deletes the task branch and clears task history/artifacts. Preserve-runtime scans the whole list for failed roots, retains runtime history and valid checkout/WIP, and alone may replace a missing branch from the recorded base and rewind implementation-and-later checkpoints. Never hide these effects behind the word “retry.”
|
|
157
155
|
|
|
158
156
|
Use `AskUserQuestion` before constructing retry commands:
|
|
159
157
|
|
|
@@ -4,39 +4,15 @@ Use this reference only to translate confirmed user choices into command fragmen
|
|
|
4
4
|
|
|
5
5
|
## Configured AI CLI Prerequisite Command
|
|
6
6
|
|
|
7
|
-
Runtime AI CLI selection is config
|
|
7
|
+
Runtime AI CLI selection is resolved by the canonical runtime across `AI_CLI`, `.prizmkit/config.json` (`ai_cli`), and installed host configuration in the exact order used by `cli.py run`.
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
2. `.prizmkit/config.json` `ai_cli`.
|
|
11
|
-
3. `claude` only when neither is configured.
|
|
12
|
-
|
|
13
|
-
Return this check command as part of start-command preparation:
|
|
9
|
+
Return this cross-platform check command as part of start-command preparation:
|
|
14
10
|
|
|
15
11
|
```bash
|
|
16
|
-
|
|
17
|
-
python3 - <<'PY'
|
|
18
|
-
import json, os, shlex
|
|
19
|
-
from pathlib import Path
|
|
20
|
-
cli = os.environ.get("AI_CLI", "").strip()
|
|
21
|
-
if not cli:
|
|
22
|
-
path = Path(".prizmkit/config.json")
|
|
23
|
-
if path.is_file():
|
|
24
|
-
try:
|
|
25
|
-
cli = str(json.loads(path.read_text(encoding="utf-8")).get("ai_cli") or "").strip()
|
|
26
|
-
except (OSError, json.JSONDecodeError):
|
|
27
|
-
cli = ""
|
|
28
|
-
cli = cli or "claude"
|
|
29
|
-
try:
|
|
30
|
-
print(shlex.split(cli)[0])
|
|
31
|
-
except ValueError:
|
|
32
|
-
print(cli.split()[0] if cli.split() else "claude")
|
|
33
|
-
PY
|
|
34
|
-
)"
|
|
35
|
-
printf 'Configured AI CLI: %s\n' "$AI_CLI"
|
|
36
|
-
command -v "$AI_CLI" >/dev/null
|
|
12
|
+
python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
|
|
37
13
|
```
|
|
38
14
|
|
|
39
|
-
Do not claim the configured executable exists until the user supplies successful command output.
|
|
15
|
+
`diagnostics ai-cli` reports the resolved CLI, source, and runtime mode, and exits non-zero if no configured AI CLI executable is available. Do not claim the configured executable exists until the user supplies successful command output.
|
|
40
16
|
|
|
41
17
|
## Base Configuration Mapping
|
|
42
18
|
|
|
@@ -42,8 +42,6 @@ Default paths:
|
|
|
42
42
|
|
|
43
43
|
Accept a user-specified feature-list path when provided. Read the plan directly to summarize IDs, titles, dependencies, and current statuses. If the plan is missing or malformed, report that a valid feature plan is required and stop without constructing a start command.
|
|
44
44
|
|
|
45
|
-
Read `${SKILL_DIR}/references/configuration.md` before constructing prerequisite or runtime option fragments.
|
|
46
|
-
|
|
47
45
|
## Intent Routing
|
|
48
46
|
|
|
49
47
|
Classify the request before asking configuration questions:
|
|
@@ -54,7 +52,7 @@ Classify the request before asking configuration questions:
|
|
|
54
52
|
| Check status | Daemon status and item-level status commands |
|
|
55
53
|
| Show logs | Recent or follow-log command |
|
|
56
54
|
| Stop | Daemon stop command plus optional status command |
|
|
57
|
-
| Retry failed feature work |
|
|
55
|
+
| Retry failed feature work | State-only, preserve-runtime, fresh-checkout, or clean reset plus a separate run command with safety disclosure |
|
|
58
56
|
|
|
59
57
|
Only the start intent uses the execution-mode and configuration rounds.
|
|
60
58
|
|
|
@@ -88,12 +86,12 @@ If Advanced config is Yes, load the advanced question set from `${SKILL_DIR}/ref
|
|
|
88
86
|
|
|
89
87
|
### Step 4: Build command fragments
|
|
90
88
|
|
|
91
|
-
|
|
89
|
+
Read `${SKILL_DIR}/references/configuration.md` if not already loaded during Advanced config, and map confirmed choices to environment variables.
|
|
92
90
|
|
|
93
91
|
Build the prerequisite-check command separately from the pipeline command so the user can inspect each action:
|
|
94
92
|
|
|
95
93
|
```bash
|
|
96
|
-
|
|
94
|
+
python3 ./.prizmkit/dev-pipeline/cli.py diagnostics version && git --version
|
|
97
95
|
```
|
|
98
96
|
|
|
99
97
|
Also include the configured AI CLI check fragment from the reference. These are returned commands, not checks performed by this skill.
|
|
@@ -171,7 +169,7 @@ Optionally include the daemon status command for the user to run afterward. Do n
|
|
|
171
169
|
|
|
172
170
|
Reset never starts execution and rejects `--run`. Every reset command must select exactly one mode: `--state-only`, `--fresh-checkout`, `--clean`, or `--preserve-runtime`. Always return reset and run as separate commands.
|
|
173
171
|
|
|
174
|
-
State-only recovery resets selected failed/skipped roots and only causal `auto_skipped` descendants whose complete blocker set is recovered. It resets retry/session/continuation state but never changes checkout identity, branches, worktrees, source changes, checkpoints, or artifact files. Selecting an auto-skipped feature includes all of its transitive blocking roots; `--all` recovers all eligible chains. Fresh-checkout
|
|
172
|
+
State-only recovery resets selected failed/skipped roots and only causal `auto_skipped` descendants whose complete blocker set is recovered. It resets retry/session/continuation state but never changes checkout identity, branches, worktrees, source changes, checkpoints, or artifact files. Selecting an auto-skipped feature includes all of its transitive blocking roots; `--all` recovers all eligible chains. Fresh-checkout resets task state, can discard uncommitted changes on the active task branch, and records a new checkout boundary. Clean additionally deletes the task branch and clears task history/artifacts. Preserve-runtime scans the whole list for failed roots, retains runtime history and valid checkout/WIP, and alone may replace a missing branch from the recorded base and rewind implementation-and-later checkpoints. Never hide these effects behind the word “retry.”
|
|
175
173
|
|
|
176
174
|
Use `AskUserQuestion` before constructing retry commands:
|
|
177
175
|
|
|
@@ -4,39 +4,15 @@ Use this reference only to translate confirmed user choices into command fragmen
|
|
|
4
4
|
|
|
5
5
|
## Configured AI CLI Prerequisite Command
|
|
6
6
|
|
|
7
|
-
Runtime AI CLI selection is config
|
|
7
|
+
Runtime AI CLI selection is resolved by the canonical runtime across `AI_CLI`, `.prizmkit/config.json` (`ai_cli`), and installed host configuration in the exact order used by `cli.py run`.
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
2. `.prizmkit/config.json` `ai_cli`.
|
|
11
|
-
3. `claude` only when neither is configured.
|
|
12
|
-
|
|
13
|
-
Return this check command as part of start-command preparation:
|
|
9
|
+
Return this cross-platform check command as part of start-command preparation:
|
|
14
10
|
|
|
15
11
|
```bash
|
|
16
|
-
|
|
17
|
-
python3 - <<'PY'
|
|
18
|
-
import json, os, shlex
|
|
19
|
-
from pathlib import Path
|
|
20
|
-
cli = os.environ.get("AI_CLI", "").strip()
|
|
21
|
-
if not cli:
|
|
22
|
-
path = Path(".prizmkit/config.json")
|
|
23
|
-
if path.is_file():
|
|
24
|
-
try:
|
|
25
|
-
cli = str(json.loads(path.read_text(encoding="utf-8")).get("ai_cli") or "").strip()
|
|
26
|
-
except (OSError, json.JSONDecodeError):
|
|
27
|
-
cli = ""
|
|
28
|
-
cli = cli or "claude"
|
|
29
|
-
try:
|
|
30
|
-
print(shlex.split(cli)[0])
|
|
31
|
-
except ValueError:
|
|
32
|
-
print(cli.split()[0] if cli.split() else "claude")
|
|
33
|
-
PY
|
|
34
|
-
)"
|
|
35
|
-
printf 'Configured AI CLI: %s\n' "$AI_CLI"
|
|
36
|
-
command -v "$AI_CLI" >/dev/null
|
|
12
|
+
python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
|
|
37
13
|
```
|
|
38
14
|
|
|
39
|
-
Do not claim the configured executable exists until the user supplies successful command output.
|
|
15
|
+
`diagnostics ai-cli` reports the resolved CLI, source, and runtime mode, and exits non-zero if no configured AI CLI executable is available. Do not claim the configured executable exists until the user supplies successful command output.
|
|
40
16
|
|
|
41
17
|
## Base Configuration Mapping
|
|
42
18
|
|