prizmkit 1.1.102 → 1.1.104

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.102",
-  "bundledAt": "2026-07-06T15:09:00.037Z",
-  "bundledFrom": "e918269"
+  "frameworkVersion": "1.1.104",
+  "bundledAt": "2026-07-06T16:42:02.971Z",
+  "bundledFrom": "05c5c13"
 }

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

@@ -320,7 +320,7 @@ def _payload_command(family: RunnerFamily, paths, list_path: Path, options: Daem
 
 
 def _daemon_env(options: DaemonStartOptions) -> dict[str, str]:
-    env: dict[str, str] = {}
+    env: dict[str, str] = {"PRIZMKIT_LIVE_OUTPUT": "0"}
     for token in shlex.split(options.env_overrides):
         if "=" in token:
             key, value = token.split("=", 1)

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

@@ -37,10 +37,11 @@ class RunnerEnvironment:
 
     stop_on_failure: bool = False
     auto_push: bool = False
-    use_worktree: bool = True
+    use_worktree: bool = False
     dev_branch: str = ""
     enable_deploy: bool = False
     verbose: bool = False
+    live_output: bool = True
     heartbeat_interval_seconds: int = 30
     heartbeat_stale_threshold_seconds: int = 600
     stale_kill_threshold_seconds: int = 600
@@ -54,10 +55,11 @@ class RunnerEnvironment:
         return cls(
             stop_on_failure=_truthy(values.get("STOP_ON_FAILURE")),
             auto_push=_truthy(values.get("AUTO_PUSH")),
-            use_worktree=not _falsey(values.get("USE_WORKTREE")),
+            use_worktree=_truthy(values.get("USE_WORKTREE")),
             dev_branch=values.get("DEV_BRANCH", ""),
             enable_deploy=_truthy(values.get("ENABLE_DEPLOY")),
             verbose=_truthy(values.get("VERBOSE")),
+            live_output=not _falsey(values.get("PRIZMKIT_LIVE_OUTPUT")),
             heartbeat_interval_seconds=_int_value(values, "HEARTBEAT_INTERVAL", 30),
             heartbeat_stale_threshold_seconds=_int_value(
                 values,

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

@@ -220,6 +220,7 @@ def _process_item(
                 heartbeat_path=session_paths.heartbeat_json,
                 effort=config.effort,
                 verbose=env.verbose,
+                live_output=env.live_output,
                 use_stream_json=stream_json,
                 stale_kill_threshold_seconds=env.stale_kill_threshold_seconds,
             )

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

@@ -8,6 +8,7 @@ import os
 import queue
 import shutil
 import subprocess
+import sys
 import threading
 import time
 from collections import Counter
@@ -45,6 +46,7 @@ class AISessionConfig:
     heartbeat_path: Path | None = None
     effort: str | None = None
     verbose: bool = False
+    live_output: bool = False
     use_stream_json: bool = False
     stream_json_format: str = ""
     permission_mode: str = "dangerously-skip-permissions"
@@ -363,12 +365,45 @@ def _write_progress_summary(progress_path: Path | None, summary: ProgressSummary
     progress_path.write_text(json.dumps(summary.to_dict(), indent=2, sort_keys=True) + "\n", encoding="utf-8")
 
 
+def _emit_live_line(message: str) -> None:
+    """Print foreground runner status without interfering with file logging."""
+    print(message, file=sys.stderr, flush=True)
+
+
+def _emit_live_output(line: str) -> None:
+    """Forward AI CLI output for verbose foreground runs."""
+    sys.stdout.write(line)
+    sys.stdout.flush()
+
+
+def _emit_session_start(config: AISessionConfig, command: AISessionCommand, session_log: Path, backup_log: Path) -> None:
+    _emit_live_line("[prizmkit] AI session started")
+    _emit_live_line(f"[prizmkit] Provider: {command.provider}")
+    _emit_live_line(f"[prizmkit] Prompt: {config.prompt_path}")
+    _emit_live_line(f"[prizmkit] Session log: {session_log}")
+    _emit_live_line(f"[prizmkit] Backup log: {backup_log}")
+    if config.progress_path is not None:
+        _emit_live_line(f"[prizmkit] Progress: {config.progress_path}")
+    if config.heartbeat_path is not None:
+        _emit_live_line(f"[prizmkit] Heartbeat: {config.heartbeat_path}")
+    if config.verbose:
+        _emit_live_line("[prizmkit] VERBOSE=1: forwarding live AI CLI output below")
+
+
+def _emit_session_finish(result: AISessionResult) -> None:
+    duration = max(0.0, result.ended_epoch - result.started_epoch)
+    status = result.termination_reason or f"exit_code={result.exit_code}"
+    _emit_live_line(f"[prizmkit] AI session finished ({status}, {duration:.1f}s)")
+    _emit_live_line(f"[prizmkit] Session log: {result.session_log}")
+
+
 def _reader_thread(
     pipe,
     session_log: Path,
     backup_log: Path,
     output_queue: "queue.Queue[str]",
     progress_path: Path | None = None,
+    live_output: bool = False,
 ) -> None:
     lines: list[str] = []
     tracker = None
@@ -387,6 +422,8 @@ def _reader_thread(
             with backup_log.open("a", encoding="utf-8") as backup_fh:
                 backup_fh.write(line)
             output_queue.put(line)
+            if live_output:
+                _emit_live_output(line)
             lines.append(line)
             if progress_path is not None:
                 if tracker is not None:
@@ -472,12 +509,22 @@ class AISessionLauncher:
             environment_unsets=("CLAUDECODE",),
             stdin_text=command.stdin_text,
         )
+        if self.config.live_output:
+            _emit_session_start(self.config, command, session_log, backup_log)
+
         handle = launch_process(spec, stderr=subprocess.STDOUT)
         assert handle.popen is not None
         output_queue: queue.Queue[str] = queue.Queue()
         reader = threading.Thread(
             target=_reader_thread,
-            args=(handle.popen.stdout, session_log, backup_log, output_queue, self.config.progress_path),
+            args=(
+                handle.popen.stdout,
+                session_log,
+                backup_log,
+                output_queue,
+                self.config.progress_path,
+                self.config.live_output and self.config.verbose,
+            ),
             daemon=True,
         )
         reader.start()
@@ -544,7 +591,7 @@ class AISessionLauncher:
             self.config.progress_path.write_text(json.dumps(merged_progress, indent=2, sort_keys=True) + "\n", encoding="utf-8")
         final_summary = _summary_from_progress_dict(merged_progress, summary)
         ended = time.time()
-        return AISessionResult(
+        result = AISessionResult(
             command=command,
             exit_code=handle.popen.returncode,
             timed_out=timed_out,
@@ -558,3 +605,6 @@ class AISessionLauncher:
             started_epoch=started,
             ended_epoch=ended,
         )
+        if self.config.live_output:
+            _emit_session_finish(result)
+        return result

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

@@ -103,7 +103,7 @@ def test_python_parity_suite_declares_coverage_for_all_legacy_unix_snapshot_scen
         "envResolution": {
             "verboseAndStreamJson": ["test_python_env_resolution_scenarios_match_snapshot_contracts"],
             "effortModelAndCli": ["test_ai_session_command_builders_match_unix_runtime_snapshot"],
-            "worktreeIgnored": ["test_runner_environment_enables_worktree_by_default_and_accepts_falsey_opt_out"],
+            "worktreeIgnored": ["test_runner_environment_disables_worktree_by_default_and_accepts_truthy_opt_in"],
             "autoPushFlag": ["test_successful_worktree_session_merges_cleans_branch_and_honors_auto_push"],
         },
         "aiCliCommands": {
@@ -320,13 +320,14 @@ def test_runner_models_parse_legacy_args_and_environment(tmp_path):
     assert env.strict_behavior_check is False
 
 
-def test_runner_environment_enables_worktree_by_default_and_accepts_falsey_opt_out():
+def test_runner_environment_disables_worktree_by_default_and_accepts_truthy_opt_in():
     from prizmkit_runtime.runner_models import RunnerEnvironment
 
-    assert RunnerEnvironment.from_env({}).use_worktree is True
-    assert RunnerEnvironment.from_env({"USE_WORKTREE": "1"}).use_worktree is True
-    assert RunnerEnvironment.from_env({"USE_WORKTREE": "true"}).use_worktree is True
-    assert RunnerEnvironment.from_env({"USE_WORKTREE": "unexpected"}).use_worktree is True
+    assert RunnerEnvironment.from_env({}).use_worktree is False
+    assert RunnerEnvironment.from_env({"USE_WORKTREE": "unexpected"}).use_worktree is False
+
+    for truthy in ("1", "true", "yes", "on"):
+        assert RunnerEnvironment.from_env({"USE_WORKTREE": truthy}).use_worktree is True
 
     for falsey in ("0", "false", "no", "off"):
         assert RunnerEnvironment.from_env({"USE_WORKTREE": falsey}).use_worktree is False
@@ -639,10 +640,11 @@ def _install_runner_session_fakes(monkeypatch, runners, *, statuses=("success",)
 
 
 @pytest.mark.parametrize(("kind", "item_id", "branch"), [("feature", "F-001", "dev/F-001-test"), ("bugfix", "B-001", "bugfix/B-001-test")])
-def test_feature_and_bugfix_default_worktree_launches_from_worktree_and_renders_worktree_root(monkeypatch, tmp_path, kind, item_id, branch):
+def test_feature_and_bugfix_explicit_worktree_launches_from_worktree_and_renders_worktree_root(monkeypatch, tmp_path, kind, item_id, branch):
     from prizmkit_runtime import runners
     from prizmkit_runtime.runner_models import family_for, parse_invocation
 
+    monkeypatch.setenv("USE_WORKTREE", "1")
     monkeypatch.setenv("DEV_BRANCH", branch)
     paths = _make_paths(tmp_path / kind)
     family = family_for(kind, paths)
@@ -672,6 +674,7 @@ def test_successful_worktree_session_merges_cleans_branch_and_honors_auto_push(m
     from prizmkit_runtime import runners
     from prizmkit_runtime.runner_models import family_for, parse_invocation
 
+    monkeypatch.setenv("USE_WORKTREE", "1")
     monkeypatch.setenv("DEV_BRANCH", "dev/F-001-test")
     monkeypatch.setenv("AUTO_PUSH", "1")
     paths = _make_paths(tmp_path)
@@ -692,6 +695,7 @@ def test_worktree_merge_conflict_writes_session_status_and_updates_merge_conflic
     from prizmkit_runtime import runners
     from prizmkit_runtime.runner_models import family_for, parse_invocation
 
+    monkeypatch.setenv("USE_WORKTREE", "1")
     monkeypatch.setenv("DEV_BRANCH", "dev/F-001-test")
     paths = _make_paths(tmp_path)
     family = family_for("feature", paths)
@@ -719,6 +723,7 @@ def test_terminal_worktree_failure_saves_wip_and_removes_worktree_without_deleti
     from prizmkit_runtime import runners
     from prizmkit_runtime.runner_models import family_for, parse_invocation
 
+    monkeypatch.setenv("USE_WORKTREE", "1")
     monkeypatch.setenv("DEV_BRANCH", "dev/F-001-test")
     paths = _make_paths(tmp_path)
     family = family_for("feature", paths)
@@ -735,7 +740,7 @@ def test_terminal_worktree_failure_saves_wip_and_removes_worktree_without_deleti
     assert observed.updates[-1][0] == "crashed"
 
 
-def test_default_worktree_materializes_ignored_support_assets_before_prompt_and_launch(monkeypatch, tmp_path):
+def test_explicit_worktree_materializes_ignored_support_assets_before_prompt_and_launch(monkeypatch, tmp_path):
     from prizmkit_runtime import runners
     from prizmkit_runtime.paths import resolve_runtime_paths
     from prizmkit_runtime.runner_models import PromptGenerationResult, SessionClassification, family_for, parse_invocation
@@ -766,6 +771,7 @@ def test_default_worktree_materializes_ignored_support_assets_before_prompt_and_
     invocation = invocation.__class__(**{**invocation.__dict__, "list_path": paths.feature_plan})
     launch_cwds = []
 
+    monkeypatch.setenv("USE_WORKTREE", "1")
     monkeypatch.setenv("DEV_BRANCH", "dev/F-001-support-assets")
     monkeypatch.setattr(
         runners,
@@ -830,11 +836,10 @@ def test_default_worktree_materializes_ignored_support_assets_before_prompt_and_
     assert not launch_cwds[0].exists()
 
 
-def test_use_worktree_false_preserves_main_worktree_branch_launch(monkeypatch, tmp_path):
+def test_default_no_worktree_preserves_main_worktree_branch_launch(monkeypatch, tmp_path):
     from prizmkit_runtime import runners
     from prizmkit_runtime.runner_models import family_for, parse_invocation
 
-    monkeypatch.setenv("USE_WORKTREE", "0")
     monkeypatch.setenv("DEV_BRANCH", "dev/F-001-test")
     paths = _make_paths(tmp_path)
     family = family_for("feature", paths)
@@ -863,6 +868,7 @@ def test_context_overflow_reuses_worktree_and_skips_cleanup_until_terminal_outco
     from prizmkit_runtime import runners
     from prizmkit_runtime.runner_models import family_for, parse_invocation
 
+    monkeypatch.setenv("USE_WORKTREE", "1")
     monkeypatch.setenv("DEV_BRANCH", "dev/F-001-test")
     paths = _make_paths(tmp_path)
     family = family_for("feature", paths)
@@ -1117,6 +1123,7 @@ def test_python_daemon_controlled_start_status_stop_matches_snapshot(tmp_path):
         "#!/usr/bin/env python3\n"
         "import os, sys, time\n"
         "print('payload env=' + os.environ.get('FOO', ''))\n"
+        "print('payload live=' + os.environ.get('PRIZMKIT_LIVE_OUTPUT', ''))\n"
         "print('payload args=' + ' '.join(sys.argv[1:]))\n"
         "sys.stdout.flush()\n"
         "time.sleep(30)\n",
@@ -1147,6 +1154,7 @@ def test_python_daemon_controlled_start_status_stop_matches_snapshot(tmp_path):
     assert json.loads(stop.render())["message"] in {"stopped", "already exited", "not running"}
     log_text = (paths.feature_state_dir / "pipeline-daemon.log").read_text(encoding="utf-8")
     assert "FOO=bar" in log_text or "payload env=bar" in log_text
+    assert "payload live=0" in log_text
     assert "--project-root" in log_text
 
 

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

@@ -617,6 +617,82 @@ def test_session_dual_writes_progress_and_recovers_backup(tmp_path):
     assert second_log.read_text(encoding="utf-8") == "larger recovered log"
 
 
+def test_session_live_output_prints_paths_and_verbose_cli_output(tmp_path, capsys):
+    from prizmkit_runtime.sessions import AISessionConfig, AISessionLauncher
+
+    fake_cli = tmp_path / "live_cli.py"
+    fake_cli.write_text(
+        "#!/usr/bin/env python3\n"
+        "print('live-line', flush=True)\n",
+        encoding="utf-8",
+    )
+    fake_cli.chmod(0o755)
+    prompt = tmp_path / "prompt.md"
+    prompt.write_text("hello", encoding="utf-8")
+    session_log = tmp_path / "state" / "sessions" / "sess-live" / "logs" / "session.log"
+    progress = session_log.with_name("progress.json")
+    heartbeat = session_log.with_name("heartbeat.json")
+
+    result = AISessionLauncher(
+        AISessionConfig(
+            cli_command=str(fake_cli),
+            platform="codebuddy",
+            model=None,
+            prompt_path=prompt,
+            cwd=tmp_path,
+            log_path=session_log,
+            progress_path=progress,
+            heartbeat_path=heartbeat,
+            verbose=True,
+            live_output=True,
+        )
+    ).run()
+
+    captured = capsys.readouterr()
+    assert result.exit_code == 0
+    assert "live-line" in captured.out
+    assert "[prizmkit] AI session started" in captured.err
+    assert f"[prizmkit] Prompt: {prompt}" in captured.err
+    assert f"[prizmkit] Session log: {session_log}" in captured.err
+    assert f"[prizmkit] Progress: {progress}" in captured.err
+    assert f"[prizmkit] Heartbeat: {heartbeat}" in captured.err
+    assert "[prizmkit] AI session finished" in captured.err
+
+
+def test_session_live_output_does_not_forward_cli_output_without_verbose(tmp_path, capsys):
+    from prizmkit_runtime.sessions import AISessionConfig, AISessionLauncher
+
+    fake_cli = tmp_path / "quiet_cli.py"
+    fake_cli.write_text(
+        "#!/usr/bin/env python3\n"
+        "print('hidden-line', flush=True)\n",
+        encoding="utf-8",
+    )
+    fake_cli.chmod(0o755)
+    prompt = tmp_path / "prompt.md"
+    prompt.write_text("hello", encoding="utf-8")
+    session_log = tmp_path / "state" / "sessions" / "sess-quiet" / "logs" / "session.log"
+
+    result = AISessionLauncher(
+        AISessionConfig(
+            cli_command=str(fake_cli),
+            platform="codebuddy",
+            model=None,
+            prompt_path=prompt,
+            cwd=tmp_path,
+            log_path=session_log,
+            live_output=True,
+        )
+    ).run()
+
+    captured = capsys.readouterr()
+    assert result.exit_code == 0
+    assert "hidden-line" not in captured.out
+    assert "hidden-line" in session_log.read_text(encoding="utf-8")
+    assert "[prizmkit] AI session started" in captured.err
+    assert "[prizmkit] AI session finished" in captured.err
+
+
 def test_session_final_progress_merge_preserves_tracker_fatal_error(tmp_path):
     from prizmkit_runtime.sessions import AISessionConfig, AISessionLauncher
 

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.102",
+  "version": "1.1.104",
   "skills": {
     "prizm-kit": {
       "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.1.102",
+  "version": "1.1.104",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {