prizmkit 1.1.196 → 1.1.198
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 +1 -7
- 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/claude/settings-adapter.js +3 -8
- 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 +6 -5
- 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/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 +32 -26
- package/bundled/skills/feature-pipeline-launcher/SKILL.md +33 -25
- package/bundled/skills/feature-pipeline-launcher/references/configuration.md +32 -26
- 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 +47 -43
- 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 +29 -48
- package/src/index.js +2 -9
- package/src/manifest.js +5 -9
- package/src/platforms.js +0 -14
- package/src/prompts.js +0 -13
- package/src/scaffold.js +100 -327
- package/src/upgrade.js +38 -42
- 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
|
@@ -51,10 +51,6 @@ program
|
|
|
51
51
|
.option('--platform <platform>', 'Target platform: codebuddy, claude, codex, pi, cursor, antigravity, comma-separated list, or all')
|
|
52
52
|
.option('--runtime <runtime>', 'Runtime assets: python or auto; unix/windows are accepted as legacy aliases for python')
|
|
53
53
|
.option('--skills <suite>', '[deprecated] Ignored; PrizmKit now always installs the full core skill suite')
|
|
54
|
-
.option('--pipeline', 'Install dev-pipeline (default: true)')
|
|
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
54
|
.option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex, pi, agent, agy)')
|
|
59
55
|
.option('--headless-prompt-arg <arg>', 'Prompt injection argv token for a custom AI CLI (e.g. -p or -i)')
|
|
60
56
|
.option('--headless-extra-args <args>', 'Additional headless argv tokens for a custom AI CLI')
|
|
@@ -103,15 +99,13 @@ program
|
|
|
103
99
|
|
|
104
100
|
program
|
|
105
101
|
.command('config [directory]')
|
|
106
|
-
.description('Reconfigure existing PrizmKit installation (change platform, AI CLI
|
|
102
|
+
.description('Reconfigure existing PrizmKit installation (change platform, AI CLI)')
|
|
107
103
|
.option('--platform <platform>', 'Target platform: codebuddy, claude, codex, pi, cursor, antigravity, comma-separated list, or all')
|
|
108
104
|
.option('--runtime <runtime>', 'Runtime assets: python or auto; unix/windows are accepted as legacy aliases for python')
|
|
109
105
|
.option('--skills <suite>', '[deprecated] Ignored; PrizmKit now always installs the full core skill suite')
|
|
110
106
|
.option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex, pi, agent, agy)')
|
|
111
107
|
.option('--headless-prompt-arg <arg>', 'Prompt injection argv token for a custom AI CLI (e.g. -p or -i)')
|
|
112
108
|
.option('--headless-extra-args <args>', 'Additional headless argv tokens for a custom AI CLI')
|
|
113
|
-
.option('--pipeline', 'Enable dev-pipeline')
|
|
114
|
-
.option('--no-pipeline', 'Disable dev-pipeline')
|
|
115
109
|
.option('--non-interactive', 'Skip interactive prompts')
|
|
116
110
|
.option('--dry-run', 'Show what would change without applying')
|
|
117
111
|
.action(async (directory = '.', options) => {
|
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)
|
|
@@ -10,7 +10,7 @@ import path from 'path';
|
|
|
10
10
|
/**
|
|
11
11
|
* Generate Claude Code settings.json for a PrizmKit-enabled project.
|
|
12
12
|
* @param {string} targetRoot - Target project root
|
|
13
|
-
* @param {Object} options - { hooks: boolean
|
|
13
|
+
* @param {Object} options - { hooks: boolean }
|
|
14
14
|
*/
|
|
15
15
|
export async function generateSettings(targetRoot, options = {}) {
|
|
16
16
|
const settingsPath = path.join(targetRoot, '.claude', 'settings.json');
|
|
@@ -62,15 +62,10 @@ export async function generateSettings(targetRoot, options = {}) {
|
|
|
62
62
|
'Bash(./*)',
|
|
63
63
|
'Bash(bash *)',
|
|
64
64
|
'Bash(sh *)',
|
|
65
|
+
'Bash(./.prizmkit/dev-pipeline/*)',
|
|
66
|
+
'Bash(python3 .prizmkit/dev-pipeline/*)',
|
|
65
67
|
];
|
|
66
68
|
|
|
67
|
-
if (options.pipeline) {
|
|
68
|
-
prizmkitPermissions.push(
|
|
69
|
-
'Bash(./.prizmkit/dev-pipeline/*)',
|
|
70
|
-
'Bash(python3 .prizmkit/dev-pipeline/*)',
|
|
71
|
-
);
|
|
72
|
-
}
|
|
73
|
-
|
|
74
69
|
// Merge without duplicates
|
|
75
70
|
for (const perm of prizmkitPermissions) {
|
|
76
71
|
if (!existing.permissions.allow.includes(perm)) {
|
|
@@ -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
|
|
|
@@ -718,7 +719,7 @@ Feature bootstrap prompts use one canonical modular section composition for ever
|
|
|
718
719
|
|
|
719
720
|
| Feature metadata | Normal prompt source | Execution guidance |
|
|
720
721
|
|------------------|----------------------|--------------------|
|
|
721
|
-
| `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 |
|
|
722
723
|
| `estimated_complexity: medium` | `templates/sections/` canonical composition | Same complete guidance |
|
|
723
724
|
| `estimated_complexity: high` / `critical` | `templates/sections/` canonical composition | Same complete guidance |
|
|
724
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
|