prizmkit 1.1.195 → 1.1.197
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 +0 -2
- package/bundled/VERSION.json +3 -3
- package/bundled/adapters/antigravity/assets/prizmkit-hook.cjs +1 -1
- package/bundled/adapters/antigravity/rules-adapter.js +1 -13
- package/bundled/adapters/claude/paths.js +0 -1
- package/bundled/adapters/codex/paths.js +0 -1
- package/bundled/adapters/codex/settings-adapter.js +1 -1
- package/bundled/adapters/cursor/assets/prizmkit-hook.cjs +1 -1
- package/bundled/adapters/cursor/rules-adapter.js +1 -13
- package/bundled/adapters/pi/paths.js +0 -1
- package/bundled/dev-pipeline/.env.example +2 -2
- package/bundled/dev-pipeline/README.md +9 -6
- package/bundled/dev-pipeline/assets/skill-subagent-integration.md +2 -2
- package/bundled/dev-pipeline/prizmkit_runtime/checkpoint_state.py +15 -25
- package/bundled/dev-pipeline/prizmkit_runtime/commands.py +31 -0
- package/bundled/dev-pipeline/prizmkit_runtime/iterate.py +1 -69
- package/bundled/dev-pipeline/prizmkit_runtime/platform_detection.py +1 -114
- package/bundled/dev-pipeline/prizmkit_runtime/runner_models.py +2 -2
- package/bundled/dev-pipeline/prizmkit_runtime/runners.py +78 -0
- package/bundled/dev-pipeline/prizmkit_runtime/runtime_helper.py +4 -234
- package/bundled/dev-pipeline/prizmkit_runtime/status.py +0 -5
- package/bundled/dev-pipeline/prizmkit_runtime/stream_progress.py +9 -1
- package/bundled/dev-pipeline/scripts/feature_list_contract.py +0 -43
- package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +15 -76
- package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +9 -112
- package/bundled/dev-pipeline/scripts/init-bugfix-pipeline.py +0 -13
- package/bundled/dev-pipeline/scripts/init-pipeline.py +0 -1
- package/bundled/dev-pipeline/scripts/prompt_framework.py +0 -79
- package/bundled/dev-pipeline/scripts/status_common.py +150 -4
- package/bundled/dev-pipeline/scripts/update-bug-status.py +20 -2
- package/bundled/dev-pipeline/scripts/update-feature-status.py +20 -2
- package/bundled/dev-pipeline/scripts/utils.py +6 -0
- package/bundled/dev-pipeline/templates/bootstrap-prompt.md +4 -5
- package/bundled/dev-pipeline/templates/bootstrap-tier3.md +5 -101
- package/bundled/dev-pipeline/templates/bug-fix-list-schema.json +0 -35
- package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +4 -52
- package/bundled/dev-pipeline/templates/feature-list-schema.json +0 -25
- package/bundled/dev-pipeline/templates/iterate/evaluate-prompt.md +5 -16
- package/bundled/dev-pipeline/templates/iterate/evaluation-schema.json +1 -58
- package/bundled/dev-pipeline/templates/iterate/headless-plan-prompt.md +1 -12
- package/bundled/dev-pipeline/templates/sections/artifact-manifest.md +0 -1
- package/bundled/dev-pipeline/templates/sections/bugfix-phase-commit-report.md +0 -1
- package/bundled/dev-pipeline/templates/sections/bugfix-phase-diagnose-plan.md +2 -2
- package/bundled/dev-pipeline/templates/sections/bugfix-phase-review.md +1 -1
- package/bundled/dev-pipeline/templates/sections/bugfix-phase-test.md +1 -1
- package/bundled/dev-pipeline/templates/sections/bugfix-reminders.md +0 -2
- package/bundled/dev-pipeline/templates/sections/bugfix-session-context.md +0 -1
- package/bundled/dev-pipeline/templates/sections/bugfix-task-contract.md +0 -5
- package/bundled/dev-pipeline/templates/sections/checkpoint-system.md +1 -2
- package/bundled/dev-pipeline/templates/sections/feature-completion-summary.md +1 -1
- package/bundled/dev-pipeline/templates/sections/phase-commit-full.md +3 -3
- package/bundled/dev-pipeline/templates/sections/phase-prizmkit-test.md +3 -3
- package/bundled/dev-pipeline/templates/sections/phase-review-full.md +3 -3
- package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +1 -1
- package/bundled/dev-pipeline/templates/sections/retrospective.md +3 -3
- package/bundled/dev-pipeline/templates/sections/runtime-commit-handoff.md +1 -1
- package/bundled/rules/USAGE.md +5 -19
- package/bundled/rules/general/coding-baseline.md +2 -2
- package/bundled/rules/prizm/prizm-progressive-loading.md +2 -1
- package/bundled/skills/_metadata.json +4 -4
- package/bundled/skills/app-planner/SKILL.md +1 -1
- package/bundled/skills/app-planner/references/generated-plan-review.md +1 -1
- package/bundled/skills/app-planner/references/rules-configuration.md +6 -7
- package/bundled/skills/app-planner/scripts/validate-rules-configuration.py +2 -20
- package/bundled/skills/bug-planner/SKILL.md +5 -6
- package/bundled/skills/bug-planner/assets/bug-confirmation-template.md +1 -1
- package/bundled/skills/bug-planner/references/input-formats.md +2 -2
- package/bundled/skills/bug-planner/references/schema-validation.md +0 -1
- package/bundled/skills/bug-planner/scripts/validate-bug-list.py +2 -9
- package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +36 -25
- package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md +38 -31
- package/bundled/skills/feature-pipeline-launcher/SKILL.md +33 -25
- package/bundled/skills/feature-pipeline-launcher/references/configuration.md +38 -31
- package/bundled/skills/feature-planner/SKILL.md +4 -10
- package/bundled/skills/feature-planner/references/completeness-review.md +2 -2
- package/bundled/skills/feature-planner/references/new-project-planning.md +0 -1
- package/bundled/skills/feature-planner/scripts/validate-and-generate.py +1 -25
- package/bundled/skills/iterate-pipeline-launcher/SKILL.md +53 -42
- package/bundled/skills/iterate-pipeline-launcher/references/configuration.md +52 -47
- package/bundled/skills/prizmkit-code-review/SKILL.md +1 -1
- package/bundled/skills/prizmkit-code-review/references/independent-code-review.md +2 -2
- package/bundled/skills/prizmkit-implement/SKILL.md +1 -1
- package/bundled/skills/prizmkit-init/SKILL.md +6 -7
- package/bundled/skills/prizmkit-init/references/config-schema.md +5 -9
- package/bundled/skills/prizmkit-init/references/rules/layer-detection.md +1 -1
- package/bundled/skills/prizmkit-plan/SKILL.md +1 -1
- package/bundled/skills/prizmkit-retrospective/SKILL.md +3 -3
- package/bundled/skills/prizmkit-retrospective/references/rule-evolution-steps.md +11 -17
- package/bundled/skills/prizmkit-workflow/SKILL.md +6 -3
- package/bundled/skills/prizmkit-workflow/references/cold-start-rules.md +8 -7
- package/bundled/templates/project-memory-template.md +2 -1
- package/package.json +1 -1
- package/src/clean.js +29 -7
- package/src/config.js +13 -15
- package/src/index.js +1 -5
- package/src/manifest.js +3 -6
- package/src/platforms.js +0 -14
- package/src/scaffold.js +93 -313
- package/src/upgrade.js +32 -31
- package/bundled/adapters/claude/rules-adapter.js +0 -25
- package/bundled/adapters/codebuddy/rules-adapter.js +0 -30
- package/bundled/adapters/codex/rules-adapter.js +0 -30
- package/bundled/adapters/pi/rules-adapter.js +0 -13
- package/bundled/dev-pipeline/templates/sections/bugfix-phase-manual-verification.md +0 -10
- package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +0 -111
- package/bundled/skills/bug-planner/references/verification.md +0 -26
- package/bundled/skills/feature-planner/references/browser-interaction.md +0 -39
package/bin/create-prizmkit.js
CHANGED
|
@@ -53,8 +53,6 @@ program
|
|
|
53
53
|
.option('--skills <suite>', '[deprecated] Ignored; PrizmKit now always installs the full core skill suite')
|
|
54
54
|
.option('--pipeline', 'Install dev-pipeline (default: true)')
|
|
55
55
|
.option('--no-pipeline', 'Disable dev-pipeline')
|
|
56
|
-
.option('--playwright-cli', 'Install playwright-cli browser tool (default: true)')
|
|
57
|
-
.option('--no-playwright-cli', 'Disable playwright-cli installation')
|
|
58
56
|
.option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex, pi, agent, agy)')
|
|
59
57
|
.option('--headless-prompt-arg <arg>', 'Prompt injection argv token for a custom AI CLI (e.g. -p or -i)')
|
|
60
58
|
.option('--headless-extra-args <args>', 'Additional headless argv tokens for a custom AI CLI')
|
package/bundled/VERSION.json
CHANGED
|
@@ -65,7 +65,7 @@ function sessionStart(input) {
|
|
|
65
65
|
const projectRoot = resolveProjectRoot(input);
|
|
66
66
|
if (fs.existsSync(path.join(projectRoot, '.prizmkit', 'prizm-docs', 'root.prizm'))) {
|
|
67
67
|
return systemMessageResponse(
|
|
68
|
-
'PrizmKit: read exact .prizmkit/prizm-docs/root.prizm first, then load only relevant pointed module documents. Use the project Skills in .agents/plugins/prizmkit/skills and Rules in .
|
|
68
|
+
'PrizmKit: read exact .prizmkit/prizm-docs/root.prizm first, then load only relevant pointed module documents. Use the project Skills in .agents/plugins/prizmkit/skills and Rules in .prizmkit/rules/builtin and .prizmkit/rules.',
|
|
69
69
|
);
|
|
70
70
|
}
|
|
71
71
|
return systemMessageResponse(
|
|
@@ -22,18 +22,6 @@ export function convertToAntigravityRule(markdown, fallbackDescription) {
|
|
|
22
22
|
return buildMarkdown(ruleFrontmatter, body);
|
|
23
23
|
}
|
|
24
24
|
|
|
25
|
-
export async function installRules(targetRoot, ruleFiles) {
|
|
26
|
-
const rulesDir = path.join(targetRoot, RULES_DIR);
|
|
27
|
-
mkdirSync(rulesDir, { recursive: true });
|
|
28
|
-
for (const rule of ruleFiles) {
|
|
29
|
-
const baseName = path.basename(rule.name);
|
|
30
|
-
await writeFile(
|
|
31
|
-
path.join(rulesDir, `${baseName}.md`),
|
|
32
|
-
convertToAntigravityRule(rule.content, rule.name),
|
|
33
|
-
);
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
|
|
37
25
|
export async function installFrameworkGuidance(targetRoot, templateContent) {
|
|
38
26
|
const rulesDir = path.join(targetRoot, RULES_DIR);
|
|
39
27
|
mkdirSync(rulesDir, { recursive: true });
|
|
@@ -44,7 +32,7 @@ Antigravity discovers project Skills from \`${SKILLS_DIR}/\`. Invoke them with \
|
|
|
44
32
|
|
|
45
33
|
- Start with \`/prizmkit\` to see all available PrizmKit skills.
|
|
46
34
|
- Skill assets and references live inside each \`${SKILLS_DIR}/<skill>/\` directory.
|
|
47
|
-
- PrizmKit
|
|
35
|
+
- PrizmKit built-in rules live in \`.prizmkit/rules/builtin/\` (\`coding-baseline.md\`, \`cohesive-modeling.md\`, and \`prizm-*.md\`); read the relevant rules before planning, implementation, code review, commit, documentation, or context-loading work.
|
|
48
36
|
`,
|
|
49
37
|
);
|
|
50
38
|
await writeFile(
|
|
@@ -9,7 +9,6 @@ export const CLI_COMMAND = 'claude';
|
|
|
9
9
|
export const COMMANDS_DIR = '.claude/commands';
|
|
10
10
|
export const AGENTS_DIR = '.claude/agents';
|
|
11
11
|
export const SETTINGS_FILE = '.claude/settings.json';
|
|
12
|
-
export const RULES_DIR = '.claude/rules';
|
|
13
12
|
export const MCP_CONFIG_FILE = '.mcp.json';
|
|
14
13
|
|
|
15
14
|
// Global paths (relative to home directory)
|
|
@@ -8,7 +8,6 @@ export const CLI_COMMAND = 'codex';
|
|
|
8
8
|
// Project-level paths (relative to project root)
|
|
9
9
|
export const SKILLS_DIR = '.agents/skills';
|
|
10
10
|
export const AGENTS_DIR = '.codex/agents';
|
|
11
|
-
export const RULES_DIR = '.agents/rules';
|
|
12
11
|
export const SETTINGS_FILE = '.codex/config.toml';
|
|
13
12
|
export const PROJECT_MEMORY_FILE = 'AGENTS.md';
|
|
14
13
|
|
|
@@ -14,7 +14,7 @@ export async function generateSettings(targetRoot) {
|
|
|
14
14
|
|
|
15
15
|
const configToml = `# Generated by PrizmKit for Codex CLI project configuration.
|
|
16
16
|
# Keep project guidance in AGENTS.md; repository skills in .agents/skills/;
|
|
17
|
-
# PrizmKit
|
|
17
|
+
# PrizmKit built-in rules live in .prizmkit/rules/builtin/; native Codex subagents live in .codex/agents/.
|
|
18
18
|
|
|
19
19
|
project_doc_fallback_filenames = ["CLAUDE.md", "CODEBUDDY.md"]
|
|
20
20
|
|
|
@@ -23,7 +23,7 @@ function writeOutput(value) {
|
|
|
23
23
|
function sessionStart() {
|
|
24
24
|
if (fs.existsSync('.prizmkit/prizm-docs/root.prizm')) {
|
|
25
25
|
return {
|
|
26
|
-
additional_context: 'PrizmKit: read exact .prizmkit/prizm-docs/root.prizm first, then load only relevant pointed module documents. Use the project Skills in .cursor/skills and Rules in .
|
|
26
|
+
additional_context: 'PrizmKit: read exact .prizmkit/prizm-docs/root.prizm first, then load only relevant pointed module documents. Use the project Skills in .cursor/skills and Rules in .prizmkit/rules/builtin and .prizmkit/rules.',
|
|
27
27
|
};
|
|
28
28
|
}
|
|
29
29
|
return {
|
|
@@ -17,18 +17,6 @@ export function convertToMdc(markdown, fallbackDescription) {
|
|
|
17
17
|
);
|
|
18
18
|
}
|
|
19
19
|
|
|
20
|
-
export async function installRules(targetRoot, ruleFiles) {
|
|
21
|
-
const rulesDir = path.join(targetRoot, '.cursor', 'rules');
|
|
22
|
-
mkdirSync(rulesDir, { recursive: true });
|
|
23
|
-
for (const rule of ruleFiles) {
|
|
24
|
-
const baseName = path.basename(rule.name);
|
|
25
|
-
await writeFile(
|
|
26
|
-
path.join(rulesDir, `${baseName}.mdc`),
|
|
27
|
-
convertToMdc(rule.content, rule.name),
|
|
28
|
-
);
|
|
29
|
-
}
|
|
30
|
-
}
|
|
31
|
-
|
|
32
20
|
export async function installFrameworkGuidance(targetRoot, templateContent) {
|
|
33
21
|
const rulesDir = path.join(targetRoot, '.cursor', 'rules');
|
|
34
22
|
mkdirSync(rulesDir, { recursive: true });
|
|
@@ -39,7 +27,7 @@ Cursor discovers project Agent Skills from \`.cursor/skills/\`. Invoke them with
|
|
|
39
27
|
|
|
40
28
|
- Start with \`/prizmkit\` to see all available PrizmKit skills.
|
|
41
29
|
- Skill assets and references live inside each \`.cursor/skills/<skill>/\` directory.
|
|
42
|
-
- PrizmKit
|
|
30
|
+
- PrizmKit built-in rules live in \`.prizmkit/rules/builtin/\` (\`coding-baseline.md\`, \`cohesive-modeling.md\`, and \`prizm-*.md\`); read the relevant rules before planning, implementation, code review, commit, documentation, or context-loading work.
|
|
43
31
|
`,
|
|
44
32
|
);
|
|
45
33
|
await writeFile(
|
|
@@ -2,7 +2,6 @@
|
|
|
2
2
|
export const PLATFORM_ID = 'pi';
|
|
3
3
|
export const CLI_COMMAND = 'pi';
|
|
4
4
|
export const SKILLS_DIR = '.pi/skills';
|
|
5
|
-
export const RULES_DIR = '.pi/rules';
|
|
6
5
|
export const SETTINGS_FILE = '.pi/settings.json';
|
|
7
6
|
export const PROJECT_MEMORY_FILE = '.pi/APPEND_SYSTEM.md';
|
|
8
7
|
export const SKILL_DEFINITION_FILE = 'SKILL.md';
|
|
@@ -20,8 +20,8 @@
|
|
|
20
20
|
|
|
21
21
|
# ─── Pipeline Execution ──────────────────────────────────────────────
|
|
22
22
|
# MAX_RETRIES=3 # Max retry attempts per task before marking failed
|
|
23
|
-
# STOP_ON_FAILURE=
|
|
24
|
-
# VERBOSE=
|
|
23
|
+
# STOP_ON_FAILURE=1 # Stop pipeline immediately on first failed task (1=on (default), 0=continue)
|
|
24
|
+
# VERBOSE=0 # Verbose logging (0=off (default), 1=on)
|
|
25
25
|
|
|
26
26
|
# ─── Branch Management ────────────────────────────────────────────────
|
|
27
27
|
# AUTO_PUSH=0 # Auto-push to remote after successful task (0=off, 1=on)
|
|
@@ -263,7 +263,7 @@ python3 scripts/init-bugfix-pipeline.py \
|
|
|
263
263
|
--state-dir <path>
|
|
264
264
|
```
|
|
265
265
|
|
|
266
|
-
**Validation:** Schema `dev-pipeline-bug-fix-list-v1`, required fields per bug: `id` (B-NNN), `title`, `description`, `severity` (critical|high|medium|low), `error_source`, `
|
|
266
|
+
**Validation:** Schema `dev-pipeline-bug-fix-list-v1`, required fields per bug: `id` (B-NNN), `title`, `description`, `severity` (critical|high|medium|low), `error_source`, `acceptance_criteria`, `status`.
|
|
267
267
|
|
|
268
268
|
---
|
|
269
269
|
|
|
@@ -338,7 +338,7 @@ python3 scripts/generate-bugfix-prompt.py \
|
|
|
338
338
|
[--template <path>]
|
|
339
339
|
```
|
|
340
340
|
|
|
341
|
-
Resolves `{{BUG_ID}}`, `{{BUG_TITLE}}`, `{{SEVERITY}}`, `{{
|
|
341
|
+
Resolves `{{BUG_ID}}`, `{{BUG_TITLE}}`, `{{SEVERITY}}`, `{{ERROR_SOURCE}}`, etc.
|
|
342
342
|
|
|
343
343
|
---
|
|
344
344
|
|
|
@@ -468,7 +468,7 @@ python3 scripts/parse-stream-progress.py \
|
|
|
468
468
|
|
|
469
469
|
**Runs as a background process** (spawned by `prizmkit_runtime/heartbeat.py`). Reads JSONL from session log, writes progress to `progress.json` (atomic writes).
|
|
470
470
|
|
|
471
|
-
**Phase detection (monotonic):**
|
|
471
|
+
**Phase detection (monotonic):** plan → implement → code-review → test → summary → retrospective → commit
|
|
472
472
|
|
|
473
473
|
**Output (progress.json):**
|
|
474
474
|
|
|
@@ -528,7 +528,8 @@ Provides `load_runtime_config()`, `load_env_file()`, and `resolve_ai_client()`.
|
|
|
528
528
|
|
|
529
529
|
| Variable | Default | Used By | Description |
|
|
530
530
|
|----------|---------|---------|-------------|
|
|
531
|
-
| `MAX_RETRIES` | `3` | cli.py run feature | Max retry attempts per
|
|
531
|
+
| `MAX_RETRIES` | `3` | cli.py run feature, cli.py run bugfix | Max retry attempts per task before marking as failed |
|
|
532
|
+
| `STOP_ON_FAILURE` | `1` | cli.py run feature, cli.py run bugfix | Stop pipeline immediately on first failed task (`1`=on default; set `0` to continue to other eligible tasks) |
|
|
532
533
|
| `DEV_BRANCH` | auto-generated | cli.py run feature | Custom git branch name (default: `dev/{feature-id}-{timestamp}`) |
|
|
533
534
|
| `AUTO_PUSH` | `0` | cli.py run feature | Set to `1` to auto-push branch to remote after successful session |
|
|
534
535
|
|
|
@@ -660,6 +661,8 @@ AI_CLI=agent python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
|
|
|
660
661
|
AI_CLI=agy python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
|
|
661
662
|
```
|
|
662
663
|
|
|
664
|
+
`diagnostics ai-cli` emits structured resolution and capability fields (`detected_cli`, `platform`, `source`, `runtime_mode`, `model_arg_supported`, `effort_flag_mode` as `flag` | `config` | `none` | `custom_ignored`, `supported_effort_values`, and `cli_available`, plus optional `model` and `note` lines). It exits non-zero when no AI CLI can be resolved (`detected_cli: (not found)`), and reports `cli_available: false` with a diagnostic `note:` when an explicitly configured CLI executable is not found on `PATH`.
|
|
665
|
+
|
|
663
666
|
### Cursor Agent native headless contract
|
|
664
667
|
|
|
665
668
|
Install Cursor Agent separately (`curl https://cursor.com/install -fsS | bash` on macOS/Linux/WSL, or `irm 'https://cursor.com/install?win32=true' | iex` in native Windows PowerShell). Verify and authenticate with `agent --version`, `agent login`, and `agent status`; update with `agent update`. Because `agent` is a generic executable name, PATH fallback verifies Cursor identity and the required help flags before selecting it.
|
|
@@ -670,7 +673,7 @@ For a Pipeline session, PrizmKit runs:
|
|
|
670
673
|
agent --print --force --trust --output-format stream-json [--model <model>]
|
|
671
674
|
```
|
|
672
675
|
|
|
673
|
-
The complete coordinator Prompt is sent through stdin and the active task checkout is the process `cwd`. PrizmKit does not pass Cursor `--worktree`, does not disable Cursor sandbox policy, and does not create or modify `.cursor/cli.json`; user and enterprise deny policy continues to apply. Authentication is inherited from `agent login` or `CURSOR_API_KEY`, never serialized into PrizmKit config, argv, or logs. Cursor exposes no documented effort parameter, so `PRIZMKIT_EFFORT` must remain unset for `AI_CLI=agent
|
|
676
|
+
The complete coordinator Prompt is sent through stdin and the active task checkout is the process `cwd`. PrizmKit does not pass Cursor `--worktree`, does not disable Cursor sandbox policy, and does not create or modify `.cursor/cli.json`; user and enterprise deny policy continues to apply. Authentication is inherited from `agent login` or `CURSOR_API_KEY`, never serialized into PrizmKit config, argv, or logs. Cursor exposes no documented effort parameter, so `PRIZMKIT_EFFORT` must remain unset for `AI_CLI=agent` (a non-empty value fails with an actionable diagnostic); instead, Cursor supports parameterized `--model` identifiers such as `MODEL='claude-opus-4-8[context=1m,effort=high,fast=false]'`.
|
|
674
677
|
|
|
675
678
|
### Antigravity CLI native headless contract
|
|
676
679
|
|
|
@@ -716,7 +719,7 @@ Feature bootstrap prompts use one canonical modular section composition for ever
|
|
|
716
719
|
|
|
717
720
|
| Feature metadata | Normal prompt source | Execution guidance |
|
|
718
721
|
|------------------|----------------------|--------------------|
|
|
719
|
-
| `estimated_complexity: low` | `templates/sections/` canonical composition | Plan → implement → review →
|
|
722
|
+
| `estimated_complexity: low` | `templates/sections/` canonical composition | Plan → implement → review → test → report → retrospective → Runtime commit handoff |
|
|
720
723
|
| `estimated_complexity: medium` | `templates/sections/` canonical composition | Same complete guidance |
|
|
721
724
|
| `estimated_complexity: high` / `critical` | `templates/sections/` canonical composition | Same complete guidance |
|
|
722
725
|
|
|
@@ -25,7 +25,7 @@ dev-pipeline (outer loop)
|
|
|
25
25
|
+-- Mandatory local plan/spec review, then optional strict-gated independent Plan review
|
|
26
26
|
+-- Implement through /prizmkit-implement
|
|
27
27
|
+-- Mandatory Main-Agent code review, then optional strict-gated independent Code review
|
|
28
|
-
+-- Scoped test gate
|
|
28
|
+
+-- Scoped test gate (/prizmkit-test)
|
|
29
29
|
+-- Retrospective & commit (orchestrator)
|
|
30
30
|
```
|
|
31
31
|
|
|
@@ -68,7 +68,7 @@ Located at `.prizmkit/dev-pipeline/scripts/`:
|
|
|
68
68
|
| `parse-stream-progress.py` | Parse AI CLI output stream for progress tracking |
|
|
69
69
|
| `update-checkpoint.py` | Validate and atomically update `workflow-checkpoint.json` steps and semantic state |
|
|
70
70
|
| `patch-completion-notes.py` | Patch completion notes onto plan items |
|
|
71
|
-
| `prizmkit-runtime-helper.py` | Helper CLI for
|
|
71
|
+
| `prizmkit-runtime-helper.py` | Helper CLI for artifact, source-file, text, and review-verdict checks |
|
|
72
72
|
| `utils.py` | Shared utility functions for pipeline scripts |
|
|
73
73
|
|
|
74
74
|
## Session Lifecycle
|
|
@@ -135,6 +135,14 @@ class CheckpointStep:
|
|
|
135
135
|
"""Return a compact human label for cursor summaries."""
|
|
136
136
|
return f"{self.id} ({self.skill})"
|
|
137
137
|
|
|
138
|
+
@property
|
|
139
|
+
def display_status(self) -> str:
|
|
140
|
+
"""Return a human-readable step status with step name and optional stage_result."""
|
|
141
|
+
title = self.name or self.skill
|
|
142
|
+
if self.stage_result:
|
|
143
|
+
return f"{self.id} [{title}]: {self.status} ({self.stage_result})"
|
|
144
|
+
return f"{self.id} [{title}]: {self.status}"
|
|
145
|
+
|
|
138
146
|
|
|
139
147
|
@dataclass(frozen=True)
|
|
140
148
|
class SemanticCheckpoint:
|
|
@@ -416,6 +424,12 @@ def read_checkpoint_cursor(path: str | Path | None) -> int | None:
|
|
|
416
424
|
return load_checkpoint_state(path).cursor
|
|
417
425
|
|
|
418
426
|
|
|
427
|
+
def read_checkpoint_step_display(path: str | Path | None) -> tuple[int | None, str]:
|
|
428
|
+
"""Read both the numeric cursor and user-facing step name from a valid checkpoint."""
|
|
429
|
+
state = load_checkpoint_state(path)
|
|
430
|
+
return state.cursor, state.current_step_name
|
|
431
|
+
|
|
432
|
+
|
|
419
433
|
def checkpoint_cursor(checkpoint: Mapping[str, Any] | None) -> dict[str, object]:
|
|
420
434
|
"""Summarize checkpoint step groups and the first active cursor."""
|
|
421
435
|
state = validate_checkpoint_data(checkpoint or {}, exists=checkpoint is not None)
|
|
@@ -628,8 +642,6 @@ def _derive_semantic_state(
|
|
|
628
642
|
_required_sequence_error(steps, required)
|
|
629
643
|
if required else "unsupported workflow family"
|
|
630
644
|
)
|
|
631
|
-
if not canonical_sequence_error:
|
|
632
|
-
canonical_sequence_error = _configured_verification_sequence_error(steps)
|
|
633
645
|
legacy_required = LEGACY_FAMILY_REQUIRED_STAGES.get(workflow_type)
|
|
634
646
|
legacy_sequence_valid = bool(
|
|
635
647
|
canonical_sequence_error
|
|
@@ -727,11 +739,6 @@ def _derive_semantic_state(
|
|
|
727
739
|
and plan_step.status == "completed"
|
|
728
740
|
and plan_step.stage_result == "PLAN_READY"
|
|
729
741
|
)
|
|
730
|
-
configured_manual_valid = all(
|
|
731
|
-
step.status == "completed"
|
|
732
|
-
for step in steps
|
|
733
|
-
if step.skill == "manual-verification"
|
|
734
|
-
)
|
|
735
742
|
implementation_valid = bool(
|
|
736
743
|
implement_step
|
|
737
744
|
and implement_step.status == "completed"
|
|
@@ -784,7 +791,7 @@ def _derive_semantic_state(
|
|
|
784
791
|
and _required_step_artifacts_valid(committer_step, checkpoint_path, project_root)
|
|
785
792
|
)
|
|
786
793
|
commit_ready = (
|
|
787
|
-
canonical_sequence_valid and plan_valid
|
|
794
|
+
canonical_sequence_valid and plan_valid
|
|
788
795
|
and all_precommit_completed and implementation_valid and review_valid
|
|
789
796
|
and test_result_valid and retrospective_valid and artifacts_valid
|
|
790
797
|
and commit_request_valid and terminal_status is None
|
|
@@ -871,23 +878,6 @@ def _required_sequence_error(
|
|
|
871
878
|
return ""
|
|
872
879
|
|
|
873
880
|
|
|
874
|
-
def _configured_verification_sequence_error(
|
|
875
|
-
steps: tuple[CheckpointStep, ...],
|
|
876
|
-
) -> str:
|
|
877
|
-
"""Require configured Browser/Manual checks between Review and Test."""
|
|
878
|
-
review = _single_step(steps, "prizmkit-code-review")
|
|
879
|
-
test = _single_step(steps, "prizmkit-test")
|
|
880
|
-
if review is None or test is None:
|
|
881
|
-
return ""
|
|
882
|
-
for skill in ("browser-verification", "manual-verification"):
|
|
883
|
-
matches = [step for step in steps if step.skill == skill]
|
|
884
|
-
if len(matches) > 1:
|
|
885
|
-
return f"Expected at most one configured stage {skill}"
|
|
886
|
-
if matches and not (review.index < matches[0].index < test.index):
|
|
887
|
-
return f"Configured stage {skill} must run after review and before test"
|
|
888
|
-
return ""
|
|
889
|
-
|
|
890
|
-
|
|
891
881
|
def _single_step(steps: tuple[CheckpointStep, ...], skill: str) -> CheckpointStep | None:
|
|
892
882
|
matches = [step for step in steps if step.skill == skill]
|
|
893
883
|
return matches[0] if len(matches) == 1 else None
|
|
@@ -2,7 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
from __future__ import annotations
|
|
4
4
|
|
|
5
|
+
import os
|
|
6
|
+
import shutil
|
|
5
7
|
from dataclasses import dataclass
|
|
8
|
+
from pathlib import Path
|
|
6
9
|
|
|
7
10
|
from .compat import MIN_PYTHON
|
|
8
11
|
from .interoperability import UTILITY_ENTRYPOINTS, describe_existing_entrypoint
|
|
@@ -303,6 +306,26 @@ def diagnostics_version() -> CommandResult:
|
|
|
303
306
|
)
|
|
304
307
|
|
|
305
308
|
|
|
309
|
+
def _is_cli_executable_available(
|
|
310
|
+
command: str | None,
|
|
311
|
+
path_entries: tuple[Path, ...] | None,
|
|
312
|
+
) -> bool:
|
|
313
|
+
"""Return whether the resolved AI CLI executable exists and is runnable."""
|
|
314
|
+
if not command:
|
|
315
|
+
return False
|
|
316
|
+
if os.sep in command or (os.altsep and os.altsep in command):
|
|
317
|
+
candidate = Path(command)
|
|
318
|
+
if os.name == "nt":
|
|
319
|
+
return candidate.is_file()
|
|
320
|
+
return candidate.is_file() and os.access(command, os.X_OK)
|
|
321
|
+
search_path = (
|
|
322
|
+
os.pathsep.join(str(entry) for entry in path_entries)
|
|
323
|
+
if path_entries is not None
|
|
324
|
+
else os.environ.get("PATH", "")
|
|
325
|
+
)
|
|
326
|
+
return shutil.which(command, path=search_path) is not None
|
|
327
|
+
|
|
328
|
+
|
|
306
329
|
def diagnostics_ai_cli(paths: RuntimePaths | None = None) -> CommandResult:
|
|
307
330
|
"""Report the family-neutral AI CLI resolution used by runtime commands."""
|
|
308
331
|
from .config import ai_cli_capabilities, load_runtime_config
|
|
@@ -316,6 +339,9 @@ def diagnostics_ai_cli(paths: RuntimePaths | None = None) -> CommandResult:
|
|
|
316
339
|
if capabilities.supported_effort_values
|
|
317
340
|
else "none"
|
|
318
341
|
)
|
|
342
|
+
env_obj = getattr(config, "environment", None)
|
|
343
|
+
path_entries = getattr(env_obj, "path_entries", None)
|
|
344
|
+
cli_available = _is_cli_executable_available(config.ai_client.command, path_entries)
|
|
319
345
|
details = [
|
|
320
346
|
f"detected_cli: {cli}",
|
|
321
347
|
f"platform: {config.ai_client.platform or 'unresolved'}",
|
|
@@ -324,10 +350,15 @@ def diagnostics_ai_cli(paths: RuntimePaths | None = None) -> CommandResult:
|
|
|
324
350
|
f"model_arg_supported: {'true' if capabilities.model_arg_supported else 'false'}",
|
|
325
351
|
f"effort_flag_mode: {capabilities.effort_flag_mode}",
|
|
326
352
|
f"supported_effort_values: {supported_efforts}",
|
|
353
|
+
f"cli_available: {'true' if cli_available else 'false'}",
|
|
327
354
|
]
|
|
328
355
|
if config.model:
|
|
329
356
|
details.append(f"model: {config.model}")
|
|
330
357
|
details.extend(f"note: {note}" for note in config.ai_client.notes)
|
|
358
|
+
if config.ai_client.command and not cli_available:
|
|
359
|
+
details.append(
|
|
360
|
+
f"note: Resolved AI CLI '{cli}' was not found on PATH; install it or adjust PATH/AI_CLI before launching."
|
|
361
|
+
)
|
|
331
362
|
return CommandResult(
|
|
332
363
|
0 if config.ai_client.command else 1,
|
|
333
364
|
"Python runtime AI CLI diagnostics",
|