prizmkit 1.1.156 → 1.1.160

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.156",
-  "bundledAt": "2026-07-27T23:46:04.550Z",
-  "bundledFrom": "6d92126"
+  "frameworkVersion": "1.1.160",
+  "bundledAt": "2026-07-28T13:41:42.840Z",
+  "bundledFrom": "cd9688c"
 }

package/bundled/adapters/codebuddy/settings-adapter.js

@@ -1,15 +1,78 @@
 /**
- * CodeBuddy Settings Adapter
- * Generates .codebuddy/settings.json with PrizmKit hooks and permissions.
+ * CodeBuddy settings adapter.
+ * Replaces only deterministic PrizmKit-managed hook entries and preserves user settings.
  */
 
 import { existsSync, mkdirSync } from 'node:fs';
 import { readFile, writeFile } from 'node:fs/promises';
-import path from 'path';
+import path from 'node:path';
+
+const MANAGED_MARKERS = [
+  '.prizmkit/scripts/commit-intent-status.py',
+  '.prizmkit/scripts/post-command-prizm-drift.py',
+  'PRIZMKIT_DOC_UPDATE_REQUIRED',
+];
+
+function isManaged(entry) {
+  let serialized;
+  try {
+    serialized = JSON.stringify(entry);
+  } catch {
+    return false;
+  }
+  return MANAGED_MARKERS.some(marker => serialized.includes(marker));
+}
+
+function mergeManagedHooks(existingHooks = {}, managedHooks = {}) {
+  if (!existingHooks || typeof existingHooks !== 'object' || Array.isArray(existingHooks)) {
+    throw new Error('Cannot preserve malformed CodeBuddy hooks: hooks must be an object');
+  }
+  const merged = {};
+  for (const [event, entries] of Object.entries(existingHooks)) {
+    if (!Array.isArray(entries)) {
+      throw new Error(`Cannot preserve malformed CodeBuddy hooks: ${event} must be an array`);
+    }
+    merged[event] = entries.filter(entry => !isManaged(entry));
+  }
+  for (const [event, entries] of Object.entries(managedHooks)) {
+    if (!Array.isArray(entries)) {
+      throw new Error(`Managed CodeBuddy hook template is invalid: ${event} must be an array`);
+    }
+    merged[event] = [
+      ...(Array.isArray(merged[event]) ? merged[event] : []),
+      ...entries,
+    ];
+  }
+  return merged;
+}
+
+const MANAGED_HOOKS = {
+  UserPromptSubmit: [
+    {
+      matcher: '(?i)\\b(commit|push|finish|ship|merge|pull request|pr)\\b|提交|推送|收尾|完成任务|合并|发版|发布',
+      hooks: [
+        {
+          type: 'command',
+          command: 'node .prizmkit/scripts/run-python-hook.cjs .prizmkit/scripts/commit-intent-status.py',
+        },
+      ],
+    },
+  ],
+  PostToolUse: [
+    {
+      matcher: '.*',
+      hooks: [
+        {
+          type: 'command',
+          command: 'node .prizmkit/scripts/run-python-hook.cjs .prizmkit/scripts/post-command-prizm-drift.py',
+        },
+      ],
+    },
+  ],
+};
 
 /**
- * Generate CodeBuddy settings.json for a PrizmKit-enabled project.
- * @param {string} targetRoot - Target project root
+ * @param {string} targetRoot
  * @param {Object} options - { hooks: boolean }
  */
 export async function generateSettings(targetRoot, options = {}) {
@@ -20,28 +83,16 @@ export async function generateSettings(targetRoot, options = {}) {
   if (existsSync(settingsPath)) {
     try {
       existing = JSON.parse(await readFile(settingsPath, 'utf8'));
-    } catch {
-      existing = {};
+    } catch (error) {
+      throw new Error(`Cannot preserve malformed CodeBuddy settings: ${error.message}`);
     }
-  }
-
-  // Merge PrizmKit hooks
-  if (options.hooks !== false) {
-    if (!existing.hooks) existing.hooks = {};
-    if (!existing.hooks.UserPromptSubmit) {
-      existing.hooks.UserPromptSubmit = [
-        {
-          matcher: '(?i)\\b(commit|push|finish|ship|merge|pull request|pr)\\b|提交|推送|收尾|完成任务|合并|发版|发布',
-          hooks: [
-            {
-              type: 'prompt',
-              prompt: 'You are a commit-intent detector for PrizmKit. Analyze the user prompt and determine if the user intends to COMMIT, PUSH, FINISH, SHIP, MERGE, or create a PULL REQUEST.\n\nUser prompt: $ARGUMENTS\n\nIF commit intent detected, respond with:\n{"ok": true, "reason": "PRIZMKIT_DOC_UPDATE_REQUIRED: Before committing, you MUST update .prizmkit/prizm-docs/ per Prizm auto-update protocol. Steps: 1) Run git diff --cached --name-status. 2) Map changed files to modules via root.prizm MODULE_INDEX. 3) Read and update affected .prizm files (only changed sections). 4) Append to changelog.prizm. 5) Stage .prizm files with git add .prizmkit/prizm-docs/. 6) Then proceed with commit using prizmkit-committer workflow. RULES: Never rewrite entire .prizm files. Never add prose. Only update affected sections."}\n\nIF no commit intent, respond with:\n{"ok": true}\n\nRespond with JSON only. No explanation.',
-            },
-          ],
-        },
-      ];
+    if (!existing || typeof existing !== 'object' || Array.isArray(existing)) {
+      throw new Error('Cannot preserve malformed CodeBuddy settings: root must be an object');
     }
   }
 
-  await writeFile(settingsPath, JSON.stringify(existing, null, 2));
+  const settings = options.hooks === false
+    ? existing
+    : { ...existing, hooks: mergeManagedHooks(existing.hooks, MANAGED_HOOKS) };
+  await writeFile(settingsPath, JSON.stringify(settings, null, 2));
 }

package/bundled/dev-pipeline/prizmkit_runtime/gitops.py

@@ -17,8 +17,15 @@ PIPELINE_METADATA_EXCLUDES = (
     ":(top,exclude,glob).*/worktree/**",
     ":(top,exclude,glob).*/worktrees",
     ":(top,exclude,glob).*/worktrees/**",
-    ":(top,exclude).prizmkit",
-    ":(top,exclude,glob).prizmkit/**",
+    ":(top,exclude).prizmkit/dev-pipeline",
+    ":(top,exclude,glob).prizmkit/dev-pipeline/**",
+    ":(top,exclude).prizmkit/state",
+    ":(top,exclude,glob).prizmkit/state/**",
+    ":(top,exclude).prizmkit/scripts",
+    ":(top,exclude,glob).prizmkit/scripts/**",
+    ":(top,exclude).prizmkit/manifest.json",
+    ":(top,exclude,glob).prizmkit/specs/**/workflow-checkpoint.json",
+    ":(top,exclude,glob).prizmkit/specs/**/runtime-commit-request.json",
 )
 
 HIDDEN_TOOL_WORKTREE_EXCLUDES = (

package/bundled/dev-pipeline/prizmkit_runtime/reset.py

@@ -115,7 +115,7 @@ def run_reset_command(kind: str, legacy_args: tuple[str, ...], paths) -> Command
     list_path = _resolve_list_path(options.list_path, paths.project_root)
     if not list_path.is_file():
         return CommandResult(1, f"Python {kind} reset", f"{kind} list not found: {list_path}")
-    if (options.fresh_checkout or options.clean) and not (family.state_dir / "pipeline.json").is_file():
+    if options.fresh_checkout and not (family.state_dir / "pipeline.json").is_file():
         return CommandResult(1, f"Python {kind} reset", f"No pipeline state found. Run the {kind} pipeline first to initialize.")
 
     options = ResetOptions(

package/bundled/dev-pipeline/prizmkit_runtime/runner_classification.py

@@ -92,17 +92,7 @@ def classify_session(
         )
 
     semantic = checkpoint.semantic_snapshot if checkpoint is not None else {}
-    if _is_terminal_success(result):
-        reason = "no_semantic_completion"
-        if checkpoint is not None and checkpoint.semantic.error_code:
-            reason = f"{reason}:{checkpoint.semantic.error_code}"
-        return SessionClassification(
-            WORKFLOW_SKIPPED,
-            reason=reason,
-            progress_fingerprint=fingerprint,
-            checkpoint_state=semantic,
-        )
-    if _is_context_overflow(result):
+    if _is_recoverable_context_interruption(result):
         no_progress_count = _next_no_progress_count(previous_fingerprint, fingerprint, previous_no_progress_count)
         if no_progress_count >= 2:
             return SessionClassification(
@@ -121,6 +111,16 @@ def classify_session(
             no_progress_count=no_progress_count,
             checkpoint_state=semantic,
         )
+    if _is_terminal_success(result):
+        reason = "no_semantic_completion"
+        if checkpoint is not None and checkpoint.semantic.error_code:
+            reason = f"{reason}:{checkpoint.semantic.error_code}"
+        return SessionClassification(
+            WORKFLOW_SKIPPED,
+            reason=reason,
+            progress_fingerprint=fingerprint,
+            checkpoint_state=semantic,
+        )
 
     if result.termination_reason == "stale_session":
         return SessionClassification(
@@ -275,6 +275,15 @@ def _next_no_progress_count(previous: object | None, current: object, count: int
     return 0
 
 
+def _is_recoverable_context_interruption(result: AISessionResult) -> bool:
+    """Recognize provider limits that should continue an incomplete workflow."""
+    if _is_terminal_success(result):
+        # Pi reports a provider token/length limit as a successful result event.
+        # Semantic completion was already handled before this helper is called.
+        return result.progress_summary.stop_reason.strip().lower() == "length"
+    return _is_context_overflow(result)
+
+
 def _is_context_overflow(result: AISessionResult) -> bool:
     if (result.fatal_error_code or "").lower() == CONTEXT_OVERFLOW:
         return True

package/bundled/dev-pipeline/prizmkit_runtime/runtime_commit.py

@@ -106,9 +106,9 @@ def finalize_runtime_commit(
             return RuntimeCommitResult("not_ready", "runtime_commit_already_finalized")
         return RuntimeCommitResult("failed", error or "invalid_commit_request")
 
-    if any(_is_tracked(root, path) for path in (request_path, checkpoint)):
-        return RuntimeCommitResult("failed", "runtime_metadata_must_be_untracked")
-
+    # Request/checkpoint paths are excluded by their exact Runtime bookkeeping role.
+    # They may be project-tracked; commit verification below ensures their pre/post-
+    # commit writes never enter the prepared snapshot.
     current_head = _git(root, "rev-parse", "HEAD")
     if current_head.return_code != 0:
         return RuntimeCommitResult("failed", "git_head_unavailable")
@@ -133,7 +133,15 @@ def finalize_runtime_commit(
         staged = _stage_intended_paths(root, request.intended_paths)
         if staged.return_code != 0:
             return RuntimeCommitResult("failed", "git_stage_failed")
-        if _git(root, "diff", "--cached", "--quiet", "--exit-code").return_code == 0:
+        staged_paths = _git(
+            root, "diff", "--cached", "--name-only", "--no-renames", "-z",
+        )
+        if staged_paths.return_code != 0:
+            return RuntimeCommitResult("failed", "git_staged_set_unavailable")
+        staged_set = {path for path in staged_paths.stdout.split("\0") if path}
+        if staged_set != set(request.intended_paths):
+            return RuntimeCommitResult("failed", "staged_paths_mismatch")
+        if not staged_set:
             return RuntimeCommitResult("failed", "empty_staged_change")
         committed = _git(
             root,
@@ -320,7 +328,21 @@ def _known_support_path(lower_path: str) -> bool:
         and parts[1] in {"worktree", "worktrees"}
     ):
         return True
-    return lower_path == ".prizmkit" or lower_path.startswith(".prizmkit/")
+    if lower_path in {".prizmkit/manifest.json"}:
+        return True
+    if any(
+        lower_path == prefix or lower_path.startswith(prefix + "/")
+        for prefix in (
+            ".prizmkit/dev-pipeline",
+            ".prizmkit/state",
+            ".prizmkit/scripts",
+        )
+    ):
+        return True
+    return (
+        lower_path.startswith(".prizmkit/specs/")
+        and path.name in {REQUEST_FILENAME, "workflow-checkpoint.json"}
+    )
 
 
 def _status_record_paths(stdout: str) -> tuple[str, ...]:
@@ -342,8 +364,21 @@ def _status_record_paths(stdout: str) -> tuple[str, ...]:
 
 
 def _stage_intended_paths(project_root: Path, paths: Sequence[str]) -> _GitResult:
-    pathspecs = tuple(f":(top,literal){path}" for path in paths)
-    return _git(project_root, "add", "-A", "--", *pathspecs)
+    tracked: list[str] = []
+    untracked: list[str] = []
+    for path in paths:
+        pathspec = f":(top,literal){path}"
+        indexed = _git(project_root, "ls-files", "--error-unmatch", "--", pathspec)
+        (tracked if indexed.return_code == 0 else untracked).append(pathspec)
+    if tracked:
+        updated = _git(project_root, "add", "-u", "--", *tracked)
+        if updated.return_code != 0:
+            return updated
+    if untracked:
+        added = _git(project_root, "add", "--", *untracked)
+        if added.return_code != 0:
+            return added
+    return _GitResult(0, "", "")
 
 
 def _matches_prepared_commit(project_root: Path, request: RuntimeCommitRequest, head: str) -> bool:
@@ -378,14 +413,6 @@ def _record_runtime_commit_hash(path: Path, commit_hash: str) -> str:
     return "commit_request_hash_record_failed" if error else ""
 
 
-def _is_tracked(project_root: Path, path: Path) -> bool:
-    try:
-        relative = path.relative_to(project_root).as_posix()
-    except ValueError:
-        return True
-    return _git(project_root, "ls-files", "--error-unmatch", "--", relative).return_code == 0
-
-
 def _finalize_checkpoint(
     path: Path,
     *,

package/bundled/dev-pipeline/scripts/update-feature-status.py

@@ -1726,6 +1726,13 @@ def action_clean(args, feature_list_path, state_dir):
     fs["last_session_id"] = None
     fs["resume_from_phase"] = None
     reset_continuation_metadata(fs)
+    for stale_field in (
+        "repair_scope",
+        "repair_round",
+        "blocked_reason",
+        "terminal_status",
+    ):
+        fs.pop(stale_field, None)
     fs["updated_at"] = now_iso()
 
     err = save_feature_status(state_dir, feature_id, fs)

package/bundled/dev-pipeline/templates/bootstrap-prompt.md

@@ -38,7 +38,7 @@ Complete the feature in headless non-interactive mode using the active atomic sk
 5. Invoke `/prizmkit-test scope=this-change artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/`. Validate its report/result pair. For `TEST_NEEDS_FIXES`, classify the concrete correction into an allowed `repair_scope`; unknown/unsafe scope blocks, while a safe in-budget route re-enters Implement and requires fresh Review, configured verification, and Test. Do not duplicate the Skill's internal repair loop.
 6. Write `completion-summary.json` before retrospective and commit preparation.
 7. Invoke `/prizmkit-retrospective` with the exact artifact root, non-`.prizmkit/` `change_paths`, and `change_summary`; validate `outcome=RETRO_COMPLETE`.
-8. Before commit preparation, all `.prizmkit/**` paths are PrizmKit-internal and stay outside `intended_paths` together with recognized platform support; project-specific transient data must already be Git-ignored, while unknown Git-visible paths block. After validating every required artifact, invoke `/prizmkit-committer operation=prepare-runtime-commit artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/ evidence_paths=<exact paths> excluded_paths=.prizmkit/specs/{{FEATURE_SLUG}}/workflow-checkpoint.json request_path=.prizmkit/specs/{{FEATURE_SLUG}}/runtime-commit-request.json`. Require `COMMIT_REQUEST_READY`; this session then records `COMMIT_PENDING` and stops. The Python runtime executes and verifies the local commit.
+8. Before commit preparation, classify paths by semantic role rather than a blanket `.prizmkit/**` rule. Safe Git-visible framework paths may be exact task output; ignored paths remain absent, and exact Runtime bookkeeping/installed support, host support, Secrets, unrelated, or unknown paths remain excluded or blocking. No path is force-added and no ignore policy is changed. After validating every required artifact, invoke `/prizmkit-committer operation=prepare-runtime-commit artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/ evidence_paths=<exact paths> excluded_paths=.prizmkit/specs/{{FEATURE_SLUG}}/workflow-checkpoint.json request_path=.prizmkit/specs/{{FEATURE_SLUG}}/runtime-commit-request.json`. Require `COMMIT_REQUEST_READY`; this session then records `COMMIT_PENDING` and stops. The Python runtime executes and verifies the local commit.
 
 ## Failure Capture
 

package/bundled/dev-pipeline/templates/bootstrap-tier3.md

@@ -448,7 +448,7 @@ Invoke `/prizmkit-retrospective` with the exact artifact root, exact non-`.prizm
 
 **6c. Runtime commit preparation**
 
-Before commit preparation, all `.prizmkit/**` paths are PrizmKit-internal and stay outside `intended_paths`, together with `AGENTS.md`, `skills-lock.json`, installed platform directories, and local platform settings. Project-specific transient data must already be covered by Git ignore rules. Unknown Git-visible paths are not silently ignored: justify and include them as task output or block.
+Before commit preparation, classify paths by semantic role rather than a blanket `.prizmkit/**` exclusion. Safe Git-visible framework paths may be justified and included as exact task output; ignored paths remain naturally absent. Exact Runtime request/checkpoint/state and installed Runtime/host support stay outside `intended_paths`; Secrets, unrelated, and unknown Git-visible paths block. Never force-add or change/interpret project ignore policy.
 
 After this injected session validates every required artifact, invoke `/prizmkit-committer operation=prepare-runtime-commit artifact_dir=.prizmkit/specs/{{FEATURE_SLUG}}/ evidence_paths=<exact paths> excluded_paths=.prizmkit/specs/{{FEATURE_SLUG}}/workflow-checkpoint.json request_path=.prizmkit/specs/{{FEATURE_SLUG}}/runtime-commit-request.json`. Require `COMMIT_REQUEST_READY`; this session records `COMMIT_PENDING` and stops. The Python runtime validates the request, executes/verifies the local commit, and finalizes checkpoint `COMMITTED`.
 

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

@@ -11,11 +11,11 @@ After Code Review, all configured verification, `TEST_PASS`, family reports/summ
    /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.
+3. The committer validates only the supplied evidence and final diff, then classifies paths by semantic role before writing the request:
+   - safe Git-visible `.prizmkit/**` requirement output is admitted like any other exact task path and needs no documentation-specific evidence;
+   - ignored paths remain absent and are never force-added; project ignore policy is not changed or interpreted;
+   - exact Runtime request/checkpoint/state, installed Runtime/host payloads, and local host settings remain support/bookkeeping outside the task commit;
+   - global Secret checks still apply, and every unrelated or unknown Git-visible path blocks rather than disappearing.
 
    It then rejects sensitive/unrelated/unknown paths, generates one Conventional Commit message, and writes this request without staging or committing:
 
@@ -32,4 +32,4 @@ After Code Review, all configured verification, `TEST_PASS`, family reports/summ
 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.
+The Runtime validates exact task-owned path coverage outside recognized semantic support/bookkeeping, does not reject a safe path solely because it is under `.prizmkit/**`, stages only requested literal paths, verifies staged/committed set equality and the Git receipt, and only then writes the Runtime-owned receipt/checkpoint and performs configured integration. Those post-commit writes are never inserted retroactively into the committed snapshot or allowed to falsify integration. 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/tests/test_generate_bootstrap_prompt.py

@@ -1556,9 +1556,10 @@ class TestFeatureBootstrapShellExtraction:
         assert "/prizmkit-committer operation=prepare-runtime-commit" in tier3
         assert "Require `COMMIT_REQUEST_READY`; this session records `COMMIT_PENDING`" in tier3
         assert "The Python runtime validates the request" in tier3
-        assert "all `.prizmkit/**` paths are PrizmKit-internal" in tier3
-        assert "project-specific transient data must already be covered by git ignore rules" in tier3.lower()
-        assert "Unknown Git-visible paths are not silently ignored" in tier3
+        assert "classify paths by semantic role rather than a blanket `.prizmkit/**` exclusion" in tier3
+        assert "Safe Git-visible framework paths" in tier3
+        assert "Never force-add or change/interpret project ignore policy" in tier3
+        assert "unknown Git-visible paths block" in tier3
         assert "git add" not in tier3
         assert "git commit" not in tier3
 

package/bundled/dev-pipeline/tests/test_generate_bugfix_prompt.py

@@ -596,8 +596,8 @@ class TestBugfixCheckpointGeneration:
         assert "operation=prepare-runtime-commit" in prompt
         assert "NEVER ask for user confirmation" in prompt
         assert "The Python runtime, not the AI session, executes" in prompt
-        assert "all `.prizmkit/**` paths are PrizmKit-internal" in prompt
-        assert "Unknown Git-visible paths are not silently ignored" in prompt
+        assert "safe Git-visible `.prizmkit/**` requirement output is admitted" in prompt
+        assert "unknown Git-visible path blocks" in prompt
         assert "push_authorized\": true" not in prompt
         assert ".prizmkit/bugfix/B-001/" in prompt
         assert "write the session status" not in prompt.lower()

package/bundled/dev-pipeline/tests/test_generate_refactor_prompt.py

@@ -435,8 +435,8 @@ class TestRefactorCheckpointGeneration:
         assert "local_commit_authorized" not in prompt
         assert "operation=prepare-runtime-commit" in prompt
         assert "The Python runtime, not the AI session, executes" in prompt
-        assert "all `.prizmkit/**` paths are PrizmKit-internal" in prompt
-        assert "Unknown Git-visible paths are not silently ignored" in prompt
+        assert "safe Git-visible `.prizmkit/**` requirement output is admitted" in prompt
+        assert "unknown Git-visible path blocks" in prompt
         assert "automatic push" not in prompt.lower()
         assert "push_authorized\": true" not in prompt
         assert "write the session status" not in prompt.lower()

package/bundled/dev-pipeline/tests/test_python_runner_parity.py

@@ -4015,7 +4015,7 @@ def test_pi_length_stop_with_nonzero_exit_uses_bounded_crash_path(tmp_path):
     assert classification.fatal_error_code == ""
 
 
-def test_pi_length_stop_with_zero_exit_and_no_checkpoint_uses_no_completion_policy(tmp_path):
+def test_pi_length_stop_with_zero_exit_and_no_checkpoint_uses_recoverable_continuation(tmp_path):
     from dataclasses import replace
 
     from prizmkit_runtime.runner_classification import classify_session
@@ -4029,9 +4029,120 @@ def test_pi_length_stop_with_zero_exit_and_no_checkpoint_uses_no_completion_poli
 
     classification = classify_session(raw, project_root=tmp_path, base_head=base_head)
 
-    assert classification.session_status == "workflow_skipped"
-    assert classification.reason == "no_semantic_completion"
-    assert classification.fatal_error_code == ""
+    assert classification.session_status == "context_overflow"
+    assert classification.reason == "context_overflow"
+    assert classification.fatal_error_code == "context_overflow"
+
+
+def test_pi_length_stop_with_in_progress_checkpoint_uses_recoverable_continuation(tmp_path):
+    from dataclasses import replace
+
+    from prizmkit_runtime.runner_classification import classify_session
+    from prizmkit_runtime.runner_models import PromptGenerationResult
+    from prizmkit_runtime.status import ProgressSummary
+
+    base_head = _init_git_repo_for_invalid_checkpoint_test(tmp_path)
+    artifact_dir = tmp_path / ".prizmkit" / "specs" / "001-length-in-progress"
+    artifact_dir.mkdir(parents=True)
+    checkpoint = artifact_dir / "workflow-checkpoint.json"
+    checkpoint.write_text(
+        json.dumps({
+            "version": 1,
+            "workflow_type": "feature-pipeline",
+            "steps": [
+                {
+                    "id": "S01",
+                    "skill": "context-snapshot-and-plan",
+                    "name": "Specify & Plan",
+                    "status": "completed",
+                    "required_artifacts": [],
+                    "depends_on": None,
+                    "stage_result": "PLAN_READY",
+                },
+                {
+                    "id": "S02",
+                    "skill": "prizmkit-implement",
+                    "name": "Implement",
+                    "status": "completed",
+                    "required_artifacts": [],
+                    "depends_on": "S01",
+                    "stage_result": "IMPLEMENTED",
+                },
+                {
+                    "id": "S03",
+                    "skill": "prizmkit-code-review",
+                    "name": "Code Review",
+                    "status": "in_progress",
+                    "required_artifacts": [],
+                    "depends_on": "S02",
+                },
+                {
+                    "id": "S04",
+                    "skill": "prizmkit-test",
+                    "name": "Test",
+                    "status": "pending",
+                    "required_artifacts": [],
+                    "depends_on": "S03",
+                },
+                {
+                    "id": "S05",
+                    "skill": "completion-summary",
+                    "name": "Completion Summary",
+                    "status": "pending",
+                    "required_artifacts": [],
+                    "depends_on": "S04",
+                },
+                {
+                    "id": "S06",
+                    "skill": "prizmkit-retrospective",
+                    "name": "Retrospective",
+                    "status": "pending",
+                    "required_artifacts": [],
+                    "depends_on": "S05",
+                },
+                {
+                    "id": "S07",
+                    "skill": "prizmkit-committer",
+                    "name": "Runtime Commit Handoff",
+                    "status": "pending",
+                    "required_artifacts": [],
+                    "depends_on": "S06",
+                },
+            ],
+            "feature_state": {
+                "stage": "code-review",
+                "current_stage": "prizmkit-code-review",
+                "status": "in_progress",
+                "repair_scope": None,
+                "repair_round": 0,
+                "next_stage": "prizmkit-code-review",
+                "blocked_reason": None,
+                "terminal_status": None,
+            },
+        }),
+        encoding="utf-8",
+    )
+    prompt = PromptGenerationResult(
+        output_path=tmp_path / "prompt.md",
+        checkpoint_path=checkpoint,
+        artifact_path=artifact_dir,
+    )
+    raw = replace(
+        _terminal_success_result(tmp_path),
+        progress_summary=ProgressSummary(result_subtype="success", stop_reason="length"),
+    )
+
+    classification = classify_session(
+        raw,
+        project_root=tmp_path,
+        base_head=base_head,
+        prompt=prompt,
+    )
+
+    assert classification.session_status == "context_overflow"
+    assert classification.reason == "context_overflow"
+    assert classification.fatal_error_code == "context_overflow"
+    assert classification.checkpoint_state["current_stage"] == "prizmkit-code-review"
 
 
 def test_pi_length_stop_does_not_override_completed_checkpoint(tmp_path):