prizmkit 1.1.154 → 1.1.156

package/bundled/dev-pipeline/templates/sections/runtime-commit-handoff.md

@@ -0,0 +1,35 @@
+### Runtime Commit Handoff
+
+The Python runtime, not the AI session, executes the pipeline's local Git commit. This stage contains no prompt-level commit authorization.
+
+After Code Review, all configured verification, `TEST_PASS`, family reports/summaries, and retrospective have completed:
+
+1. As the session orchestrator, validate every required stage artifact and result first. Atomic Skills do not perform this sequencing check.
+2. Invoke `/prizmkit-committer` with the same artifact root, exact readiness evidence, and request path:
+
+   ```text
+   /prizmkit-committer operation=prepare-runtime-commit artifact_dir={{ARTIFACT_DIR}} evidence_paths=<exact validated artifact paths> excluded_paths={{ARTIFACT_DIR}}/workflow-checkpoint.json request_path={{ARTIFACT_DIR}}/runtime-commit-request.json
+   ```
+
+3. The committer validates only the supplied evidence and final diff, then classifies paths before writing the request:
+   - all `.prizmkit/**` paths are PrizmKit-internal and stay outside the task commit, including config, plans, Prizm docs, lifecycle Artifacts, Runtime files, and state;
+   - `AGENTS.md`, `skills-lock.json`, installed platform directories, and local platform settings are support data and stay outside the task commit;
+   - project-specific transient data must already be covered by Git ignore rules;
+   - every other Git-visible path must be justified task output and included exactly, otherwise the handoff blocks.
+
+   It then rejects sensitive/unrelated/unknown paths, generates one Conventional Commit message, and writes this request without staging or committing:
+
+   ```json
+   {
+     "schema_version": 1,
+     "artifact_dir": "{{ARTIFACT_DIR}}",
+     "base_head": "<current HEAD commit hash>",
+     "commit_message": "<type>(<scope>): <description>",
+     "intended_paths": ["<exact project-relative changed path>"]
+   }
+   ```
+
+4. Require the stage-local result `COMMIT_REQUEST_READY`. Then this injected session—not the Skill—marks `prizmkit-committer` `in_progress` with `stage_result=COMMIT_PENDING` through the checkpoint helper. Do not mark it completed or write `COMMITTED`.
+5. Stop normal work after the valid request and checkpoint handoff exist. Do not run `git add`, `git commit`, `git commit --amend`, merge, push, or create additional files.
+
+The runtime validates exact task-owned path coverage outside recognized internal/support namespaces, rejects a request that explicitly names one of those namespaces, stages only the requested literal paths, executes and verifies the local commit, finalizes the Runtime-owned checkpoint to `COMMITTED`, and then performs its configured merge/publication behavior. Unknown Git-visible paths are not silently ignored: they produce a mismatch and preserve the task checkout for recovery. A malformed, stale, unsafe, incomplete, or contradictory request also blocks without deleting user data.

package/bundled/dev-pipeline/templates/session-status-schema.json

@@ -1,83 +1,66 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "Dev-Pipeline Session Status",
-  "description": "Schema for session-status.json written by agent at session end",
+  "title": "Dev-Pipeline Runtime Session Status",
+  "description": "Schema for runner-owned session-status.json written after an AI process exits",
   "type": "object",
-  "required": ["session_id", "feature_id", "status", "timestamp"],
+  "required": [
+    "session_id",
+    "task_id",
+    "task_type",
+    "status",
+    "base_branch",
+    "active_dev_branch"
+  ],
   "properties": {
     "session_id": {
       "type": "string",
       "minLength": 1
     },
-    "feature_id": {
+    "task_id": {
       "type": "string",
-      "pattern": "^F-\\d{3}(-[A-Z])?$"
+      "pattern": "^[FBR]-\\d{3}(?:-[A-Z])?$"
     },
-    "status": {
+    "task_type": {
       "type": "string",
-      "enum": ["success", "partial", "failed", "crashed", "timed_out", "infra_error", "commit_missing", "docs_missing", "merge_conflict", "context_overflow", "stalled_context_continuation", "workflow_blocked", "workflow_skipped"]
-    },
-    "completed_phases": {
-      "type": "array",
-      "items": {
-        "type": "integer",
-        "minimum": 0,
-        "maximum": 7
-      }
-    },
-    "current_phase": {
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 7
+      "enum": ["feature", "bugfix", "refactor"]
     },
-    "checkpoint_reached": {
+    "status": {
       "type": "string",
-      "pattern": "^CP-[0-3]$"
-    },
-    "tasks_completed": {
-      "type": "integer",
-      "minimum": 0
-    },
-    "tasks_total": {
-      "type": "integer",
-      "minimum": 0
+      "enum": [
+        "success",
+        "failed",
+        "crashed",
+        "timed_out",
+        "infra_error",
+        "commit_missing",
+        "docs_missing",
+        "merge_conflict",
+        "context_overflow",
+        "stalled_context_continuation",
+        "workflow_blocked",
+        "workflow_skipped"
+      ]
     },
-    "errors": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["message"],
-        "properties": {
-          "phase": { "type": "integer" },
-          "type": { "type": "string" },
-          "message": { "type": "string" },
-          "recoverable": { "type": "boolean" }
-        }
-      }
-    },
-    "can_resume": {
-      "type": "boolean"
+    "base_branch": {
+      "type": "string",
+      "minLength": 1
     },
-    "docs_maintained": {
-      "type": "boolean"
+    "active_dev_branch": {
+      "type": "string",
+      "minLength": 1
     },
-    "retrospective_done": {
-      "type": "boolean"
+    "worktree_path": {
+      "type": "string"
     },
-    "resume_from_phase": {
-      "type": ["integer", "null"]
+    "reason": {
+      "type": "string"
     },
-    "artifacts": {
-      "type": "object",
-      "properties": {
-        "spec_path": { "type": "string" },
-        "plan_path": { "type": "string" },
-        "context_snapshot_path": { "type": "string" }
-      }
+    "fatal_error_code": {
+      "type": "string"
     },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time"
+    "checkpoint_state": {
+      "type": "object"
     }
-  }
+  },
+  "additionalProperties": false
 }