prizmkit 1.1.191 → 1.1.193

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.
Files changed (165) hide show
  1. package/bundled/VERSION.json +3 -3
  2. package/bundled/adapters/antigravity/skill-adapter.js +13 -4
  3. package/bundled/adapters/codex/skill-adapter.js +28 -8
  4. package/bundled/adapters/cursor/skill-adapter.js +13 -4
  5. package/bundled/adapters/pi/skill-adapter.js +28 -7
  6. package/bundled/dev-pipeline/.env.example +4 -12
  7. package/bundled/dev-pipeline/README.md +28 -44
  8. package/bundled/dev-pipeline/assets/feature-list-example.json +0 -1
  9. package/bundled/dev-pipeline/assets/skill-subagent-integration.md +6 -6
  10. package/bundled/dev-pipeline/prizmkit_runtime/atomic_io.py +48 -0
  11. package/bundled/dev-pipeline/prizmkit_runtime/checkpoint_state.py +66 -23
  12. package/bundled/dev-pipeline/prizmkit_runtime/cli.py +10 -7
  13. package/bundled/dev-pipeline/prizmkit_runtime/commands.py +2 -21
  14. package/bundled/dev-pipeline/prizmkit_runtime/config.py +48 -78
  15. package/bundled/dev-pipeline/prizmkit_runtime/daemon.py +127 -67
  16. package/bundled/dev-pipeline/prizmkit_runtime/gitops.py +158 -462
  17. package/bundled/dev-pipeline/prizmkit_runtime/heartbeat.py +102 -50
  18. package/bundled/dev-pipeline/prizmkit_runtime/interoperability.py +1 -25
  19. package/bundled/dev-pipeline/prizmkit_runtime/paths.py +0 -6
  20. package/bundled/dev-pipeline/prizmkit_runtime/platform_detection.py +47 -21
  21. package/bundled/dev-pipeline/prizmkit_runtime/processes.py +217 -156
  22. package/bundled/dev-pipeline/prizmkit_runtime/reset.py +39 -27
  23. package/bundled/dev-pipeline/prizmkit_runtime/reset_preserve.py +34 -174
  24. package/bundled/dev-pipeline/prizmkit_runtime/results.py +25 -0
  25. package/bundled/dev-pipeline/prizmkit_runtime/runner_bookkeeping.py +133 -110
  26. package/bundled/dev-pipeline/prizmkit_runtime/runner_classification.py +15 -5
  27. package/bundled/dev-pipeline/prizmkit_runtime/runner_models.py +1 -95
  28. package/bundled/dev-pipeline/prizmkit_runtime/runner_prompts.py +0 -2
  29. package/bundled/dev-pipeline/prizmkit_runtime/runner_status.py +7 -2
  30. package/bundled/dev-pipeline/prizmkit_runtime/runners.py +540 -262
  31. package/bundled/dev-pipeline/prizmkit_runtime/runtime_commit.py +175 -135
  32. package/bundled/dev-pipeline/prizmkit_runtime/runtime_helper.py +90 -9
  33. package/bundled/dev-pipeline/prizmkit_runtime/sessions.py +214 -133
  34. package/bundled/dev-pipeline/prizmkit_runtime/status.py +1 -3
  35. package/bundled/dev-pipeline/prizmkit_runtime/stream_progress.py +2783 -0
  36. package/bundled/dev-pipeline/prizmkit_runtime/task_checkout.py +27 -102
  37. package/bundled/dev-pipeline/prizmkit_runtime/test_result.py +58 -4
  38. package/bundled/dev-pipeline/scripts/check-session-status.py +56 -20
  39. package/bundled/dev-pipeline/scripts/continuation.py +8 -7
  40. package/bundled/dev-pipeline/scripts/detect-stuck.py +47 -33
  41. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +13 -16
  42. package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +20 -10
  43. package/bundled/dev-pipeline/scripts/init-bugfix-pipeline.py +10 -7
  44. package/bundled/dev-pipeline/scripts/init-change-artifact.py +25 -4
  45. package/bundled/dev-pipeline/scripts/init-pipeline.py +14 -69
  46. package/bundled/dev-pipeline/scripts/parse-stream-progress.py +31 -2616
  47. package/bundled/dev-pipeline/scripts/patch-completion-notes.py +4 -24
  48. package/bundled/dev-pipeline/scripts/prompt_framework.py +85 -20
  49. package/bundled/dev-pipeline/scripts/status_common.py +591 -0
  50. package/bundled/dev-pipeline/scripts/update-bug-status.py +85 -463
  51. package/bundled/dev-pipeline/scripts/update-checkpoint.py +254 -65
  52. package/bundled/dev-pipeline/scripts/update-feature-status.py +76 -509
  53. package/bundled/dev-pipeline/scripts/utils.py +5 -12
  54. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +5 -5
  55. package/bundled/dev-pipeline/templates/bug-fix-list-schema.json +7 -0
  56. package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +7 -7
  57. package/bundled/dev-pipeline/templates/sections/artifact-manifest.md +1 -1
  58. package/bundled/dev-pipeline/templates/sections/bugfix-phase-manual-verification.md +1 -1
  59. package/bundled/dev-pipeline/templates/sections/bugfix-phase-review.md +1 -1
  60. package/bundled/dev-pipeline/templates/sections/bugfix-phase-test.md +2 -1
  61. package/bundled/dev-pipeline/templates/sections/checkpoint-system.md +1 -1
  62. package/bundled/dev-pipeline/templates/sections/phase-browser-verification-auto.md +1 -1
  63. package/bundled/dev-pipeline/templates/sections/phase-browser-verification-opencli.md +2 -2
  64. package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +2 -2
  65. package/bundled/dev-pipeline/templates/sections/phase-prizmkit-test.md +2 -1
  66. package/bundled/dev-pipeline/templates/sections/phase-review-full.md +1 -1
  67. package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +3 -6
  68. package/bundled/dev-pipeline/templates/session-status-schema.json +2 -5
  69. package/bundled/skills/_metadata.json +9 -63
  70. package/bundled/skills/app-planner/SKILL.md +32 -303
  71. package/bundled/skills/app-planner/references/app-design-guide.md +0 -4
  72. package/bundled/skills/app-planner/references/generated-plan-review.md +2 -1
  73. package/bundled/skills/app-planner/references/project-brief-guide.md +14 -0
  74. package/bundled/skills/app-planner/references/project-conventions-discovery.md +4 -6
  75. package/bundled/skills/app-planner/references/project-state-detection.md +2 -3
  76. package/bundled/skills/bug-fix-workflow/SKILL.md +1 -2
  77. package/bundled/skills/bug-fix-workflow/references/bug-diagnosis.md +4 -7
  78. package/bundled/skills/bug-planner/SKILL.md +54 -435
  79. package/bundled/skills/bug-planner/references/generated-plan-review.md +3 -2
  80. package/bundled/skills/bug-planner/references/input-formats.md +32 -0
  81. package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +4 -6
  82. package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md +4 -28
  83. package/bundled/skills/feature-pipeline-launcher/SKILL.md +4 -6
  84. package/bundled/skills/feature-pipeline-launcher/references/configuration.md +4 -28
  85. package/bundled/skills/feature-planner/SKILL.md +60 -439
  86. package/bundled/skills/feature-planner/assets/planning-guide.md +1 -1
  87. package/bundled/skills/feature-planner/references/completeness-review.md +34 -0
  88. package/bundled/skills/feature-planner/references/decomposition-patterns.md +2 -2
  89. package/bundled/skills/feature-planner/references/error-recovery.md +1 -1
  90. package/bundled/skills/feature-planner/references/generated-plan-review.md +3 -2
  91. package/bundled/skills/feature-planner/references/incremental-feature-planning.md +3 -1
  92. package/bundled/skills/feature-workflow/SKILL.md +1 -2
  93. package/bundled/skills/prizmkit/SKILL.md +7 -1
  94. package/bundled/skills/prizmkit-code-review/SKILL.md +14 -6
  95. package/bundled/skills/prizmkit-code-review/references/independent-code-review.md +7 -4
  96. package/bundled/skills/prizmkit-code-review/references/review-report-template.md +16 -0
  97. package/bundled/skills/prizmkit-code-review/scripts/render_review_report.py +58 -20
  98. package/bundled/skills/prizmkit-implement/SKILL.md +1 -1
  99. package/bundled/skills/prizmkit-init/SKILL.md +24 -127
  100. package/bundled/skills/prizmkit-init/assets/project-brief-template.md +3 -3
  101. package/bundled/skills/prizmkit-plan/SKILL.md +6 -8
  102. package/bundled/skills/prizmkit-plan/references/clarify-guide.md +1 -1
  103. package/bundled/skills/prizmkit-plan/references/independent-plan-review.md +5 -2
  104. package/bundled/skills/prizmkit-plan/references/review-plan-spec-loop.md +6 -5
  105. package/bundled/skills/prizmkit-prizm-docs/SKILL.md +1 -13
  106. package/bundled/skills/prizmkit-prizm-docs/references/op-update.md +1 -1
  107. package/bundled/skills/prizmkit-retrospective/SKILL.md +6 -4
  108. package/bundled/skills/prizmkit-test/SKILL.md +25 -133
  109. package/bundled/skills/prizmkit-test/references/independent-test-review.md +5 -2
  110. package/bundled/skills/prizmkit-test/references/test-coverage-model.md +6 -0
  111. package/bundled/skills/prizmkit-workflow/SKILL.md +2 -3
  112. package/bundled/skills/prizmkit-workflow/references/workflow-state-protocol.md +4 -3
  113. package/bundled/skills/recovery-workflow/SKILL.md +7 -7
  114. package/bundled/skills/recovery-workflow/evals/evals.json +1 -1
  115. package/bundled/skills/recovery-workflow/references/detection.md +1 -3
  116. package/bundled/skills/recovery-workflow/scripts/detect-recovery-state.py +0 -6
  117. package/bundled/templates/project-memory-template.md +1 -2
  118. package/package.json +1 -1
  119. package/src/scaffold.js +28 -7
  120. package/bundled/dev-pipeline/SCHEMA_ANALYSIS.md +0 -53
  121. package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +0 -649
  122. package/bundled/dev-pipeline/scripts/init-refactor-pipeline.py +0 -463
  123. package/bundled/dev-pipeline/scripts/update-refactor-status.py +0 -1512
  124. package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +0 -240
  125. package/bundled/dev-pipeline/templates/refactor-list-schema.json +0 -266
  126. package/bundled/dev-pipeline/templates/sections/refactor-critical-paths.md +0 -15
  127. package/bundled/dev-pipeline/templates/sections/refactor-mission.md +0 -9
  128. package/bundled/dev-pipeline/templates/sections/refactor-phase-commit-report.md +0 -24
  129. package/bundled/dev-pipeline/templates/sections/refactor-phase-implement.md +0 -16
  130. package/bundled/dev-pipeline/templates/sections/refactor-phase-init.md +0 -9
  131. package/bundled/dev-pipeline/templates/sections/refactor-phase-plan.md +0 -22
  132. package/bundled/dev-pipeline/templates/sections/refactor-phase-review.md +0 -19
  133. package/bundled/dev-pipeline/templates/sections/refactor-phase-test.md +0 -24
  134. package/bundled/dev-pipeline/templates/sections/refactor-reminders.md +0 -12
  135. package/bundled/dev-pipeline/templates/sections/refactor-session-context.md +0 -6
  136. package/bundled/dev-pipeline/templates/sections/refactor-task-contract.md +0 -52
  137. package/bundled/dev-pipeline/tests/conftest.py +0 -29
  138. package/bundled/dev-pipeline/tests/live_ai_cli_log_smoke.py +0 -208
  139. package/bundled/dev-pipeline/tests/test_auto_skip.py +0 -1871
  140. package/bundled/dev-pipeline/tests/test_checkpoint_state.py +0 -1314
  141. package/bundled/dev-pipeline/tests/test_generate_bootstrap_prompt.py +0 -1712
  142. package/bundled/dev-pipeline/tests/test_generate_bugfix_prompt.py +0 -627
  143. package/bundled/dev-pipeline/tests/test_generate_refactor_prompt.py +0 -478
  144. package/bundled/dev-pipeline/tests/test_python_runner_parity.py +0 -5641
  145. package/bundled/dev-pipeline/tests/test_recovery_workflow.py +0 -322
  146. package/bundled/dev-pipeline/tests/test_repository_bootstrap.py +0 -252
  147. package/bundled/dev-pipeline/tests/test_reset_modes.py +0 -1208
  148. package/bundled/dev-pipeline/tests/test_reset_preserve.py +0 -957
  149. package/bundled/dev-pipeline/tests/test_runtime_commit.py +0 -1113
  150. package/bundled/dev-pipeline/tests/test_runtime_helper.py +0 -303
  151. package/bundled/dev-pipeline/tests/test_unified_cli.py +0 -5504
  152. package/bundled/dev-pipeline/tests/test_utils.py +0 -170
  153. package/bundled/skills/feature-planner/assets/evaluation-guide.md +0 -44
  154. package/bundled/skills/refactor-pipeline-launcher/SKILL.md +0 -219
  155. package/bundled/skills/refactor-pipeline-launcher/references/configuration.md +0 -78
  156. package/bundled/skills/refactor-planner/SKILL.md +0 -467
  157. package/bundled/skills/refactor-planner/assets/planning-guide.md +0 -291
  158. package/bundled/skills/refactor-planner/references/behavior-preservation.md +0 -187
  159. package/bundled/skills/refactor-planner/references/error-recovery.md +0 -45
  160. package/bundled/skills/refactor-planner/references/fast-path.md +0 -59
  161. package/bundled/skills/refactor-planner/references/generated-plan-review.md +0 -107
  162. package/bundled/skills/refactor-planner/references/planning-phases.md +0 -172
  163. package/bundled/skills/refactor-planner/references/refactor-scoping-guide.md +0 -230
  164. package/bundled/skills/refactor-planner/scripts/validate-and-generate-refactor.py +0 -1120
  165. package/bundled/skills/refactor-workflow/SKILL.md +0 -205
@@ -4,6 +4,7 @@ from __future__ import annotations
4
4
 
5
5
  import json
6
6
  import os
7
+ import re
7
8
  import shlex
8
9
  import subprocess
9
10
  import sys
@@ -12,13 +13,15 @@ from dataclasses import dataclass
12
13
  from datetime import datetime, timezone
13
14
  from pathlib import Path
14
15
 
15
- from .commands import CommandResult # type: ignore # runtime boundary import
16
- from .processes import ProcessSpec, is_pid_running, launch_process, terminate_pid_tree
16
+ from .atomic_io import write_json_atomic
17
+ from .processes import PidLockError, ProcessSpec, exclusive_pid_lock, is_pid_running, launch_process, terminate_pid_tree
18
+ from .results import CommandResult
17
19
  from .runner_models import RunnerFamily, family_for
18
20
 
19
21
 
20
22
  LOG_ROTATE_BYTES = 50 * 1024 * 1024
21
23
  START_VERIFY_SECONDS = 2.0
24
+ _ENV_KEY_PATTERN = re.compile(r"^[A-Za-z_][A-Za-z0-9_]*$")
22
25
 
23
26
 
24
27
  @dataclass(frozen=True)
@@ -29,6 +32,7 @@ class DaemonPaths:
29
32
  pid_file: Path
30
33
  log_file: Path
31
34
  meta_file: Path
35
+ start_lock: Path
32
36
 
33
37
 
34
38
  @dataclass(frozen=True)
@@ -52,30 +56,26 @@ class DaemonLogOptions:
52
56
  LIST_META_KEY_BY_KIND = {
53
57
  "feature": "feature_list",
54
58
  "bugfix": "bug_list",
55
- "refactor": "refactor_list",
56
59
  }
57
60
 
58
61
  ITEMS_KEY_BY_KIND = {
59
62
  "feature": "features",
60
63
  "bugfix": "bugs",
61
- "refactor": "refactors",
62
64
  }
63
65
 
64
66
  ID_KEY_BY_KIND = {
65
67
  "feature": "id",
66
68
  "bugfix": "id",
67
- "refactor": "id",
68
69
  }
69
70
 
70
71
  PROGRESS_COUNTS_BY_KIND = {
71
72
  "feature": ("completed", "in_progress", "failed", "pending", "skipped", "auto_skipped"),
72
73
  "bugfix": ("completed", "in_progress", "failed", "pending", "needs_info", "skipped", "auto_skipped"),
73
- "refactor": ("completed", "in_progress", "failed", "pending", "skipped", "auto_skipped"),
74
74
  }
75
75
 
76
76
 
77
77
  def run_daemon_command(kind: str, action: str, legacy_args: tuple[str, ...], paths) -> CommandResult:
78
- """Run a daemon lifecycle command for feature, bugfix, or refactor."""
78
+ """Run a daemon lifecycle command for feature or bugfix."""
79
79
  family = family_for(kind, paths)
80
80
  daemon_paths = _daemon_paths(family)
81
81
  if action == "start":
@@ -88,6 +88,8 @@ def run_daemon_command(kind: str, action: str, legacy_args: tuple[str, ...], pat
88
88
  return _logs(family, daemon_paths, legacy_args)
89
89
  if action == "restart":
90
90
  stop_result = _stop(family, daemon_paths)
91
+ if stop_result.exit_code != 0:
92
+ return stop_result
91
93
  start_result = _start(family, daemon_paths, legacy_args, paths)
92
94
  stderr = "\n".join(part for part in (stop_result.stderr, start_result.stderr) if part)
93
95
  return CommandResult(start_result.exit_code, start_result.title, start_result.message, stdout=start_result.render(), stderr=stderr)
@@ -100,6 +102,7 @@ def _daemon_paths(family: RunnerFamily) -> DaemonPaths:
100
102
  pid_file=family.state_dir / ".pipeline.pid",
101
103
  log_file=family.state_dir / "pipeline-daemon.log",
102
104
  meta_file=family.state_dir / ".pipeline-meta.json",
105
+ start_lock=family.state_dir / ".daemon-start.lock",
103
106
  )
104
107
 
105
108
 
@@ -113,52 +116,78 @@ def _start(family: RunnerFamily, daemon_paths: DaemonPaths, legacy_args: tuple[s
113
116
  return CommandResult(2, f"Python {family.kind} daemon", stderr, stdout="", stderr=stderr)
114
117
 
115
118
  daemon_paths.state_dir.mkdir(parents=True, exist_ok=True)
116
- stale_warning = _clean_stale_pid(daemon_paths)
117
- stderr_lines = [stale_warning] if stale_warning else []
118
- running_pid = _read_pid(daemon_paths.pid_file)
119
- if is_pid_running(running_pid):
120
- message = f"Pipeline is already running (PID: {running_pid})"
121
- return CommandResult(1, f"Python {family.kind} daemon", message, stdout="", stderr=message)
122
-
123
- rotated = _rotate_log_if_needed(daemon_paths.log_file)
124
- if rotated:
125
- stderr_lines.append(f"Log rotated: {rotated}")
126
-
127
- started_at = _utc_iso()
128
- _write_log_separator(family, daemon_paths.log_file, list_path, started_at, options)
129
- command = _payload_command(family, paths, list_path, options)
130
- env = _daemon_env(options)
131
- spec = ProcessSpec(
132
- command=tuple(command),
133
- cwd=paths.project_root,
134
- environment_overrides=env,
135
- environment_unsets=("CLAUDECODE",),
136
- pid_file=daemon_paths.pid_file,
137
- )
138
- log_handle = daemon_paths.log_file.open("a", encoding="utf-8")
139
119
  try:
140
- handle = launch_process(spec, stdout=log_handle, stderr=subprocess.STDOUT, stdin=subprocess.DEVNULL, text=True)
141
- finally:
142
- log_handle.close()
143
-
144
- pid = int(handle.pid or 0)
145
- _write_meta(family, daemon_paths.meta_file, pid, started_at, list_path, options, daemon_paths.log_file)
146
- time.sleep(_start_verify_seconds())
147
- if not is_pid_running(pid):
148
- daemon_paths.pid_file.unlink(missing_ok=True)
149
- message = f"Pipeline process died immediately after launch. Check log for errors: {daemon_paths.log_file}"
150
- return CommandResult(1, f"Python {family.kind} daemon", message, stdout="", stderr="\n".join([*stderr_lines, message]))
151
-
152
- stderr_lines.extend(
153
- [
154
- f"Launching {family.kind} pipeline...",
155
- f"{family.kind} list: {list_path}",
156
- f"Log file: {daemon_paths.log_file}",
157
- f"Pipeline started successfully (PID: {pid})",
158
- ]
159
- )
160
- payload = {"success": True, "pid": pid, "log_file": str(daemon_paths.log_file), "started_at": started_at}
161
- return CommandResult(0, f"Python {family.kind} daemon", "started", stdout=json.dumps(payload), stderr="\n".join(stderr_lines))
120
+ with exclusive_pid_lock(
121
+ daemon_paths.start_lock,
122
+ busy_message="Pipeline daemon start is already in progress (PID {pid})",
123
+ error_label="daemon start lock",
124
+ ):
125
+ stale_warning = _clean_stale_pid(daemon_paths)
126
+ stderr_lines = [stale_warning] if stale_warning else []
127
+ running_pid = _read_pid(daemon_paths.pid_file)
128
+ if is_pid_running(running_pid):
129
+ message = f"Pipeline is already running (PID: {running_pid})"
130
+ return CommandResult(1, f"Python {family.kind} daemon", message, stdout="", stderr=message)
131
+
132
+ rotated = _rotate_log_if_needed(daemon_paths.log_file)
133
+ if rotated:
134
+ stderr_lines.append(f"Log rotated: {rotated}")
135
+
136
+ started_at = _utc_iso()
137
+ _write_log_separator(family, daemon_paths.log_file, list_path, started_at, options)
138
+ command = _payload_command(family, paths, list_path, options)
139
+ env = _daemon_env(options)
140
+ spec = ProcessSpec(
141
+ command=tuple(command),
142
+ cwd=paths.project_root,
143
+ environment_overrides=env,
144
+ environment_unsets=("CLAUDECODE",),
145
+ pid_file=daemon_paths.pid_file,
146
+ detached=True,
147
+ )
148
+ with daemon_paths.log_file.open("a", encoding="utf-8") as log_handle:
149
+ handle = launch_process(spec, stdout=log_handle, stderr=subprocess.STDOUT, stdin=subprocess.DEVNULL, text=True)
150
+
151
+ pid = int(handle.pid or 0)
152
+ _write_meta(family, daemon_paths.meta_file, pid, started_at, list_path, options, daemon_paths.log_file)
153
+ time.sleep(_start_verify_seconds())
154
+ exit_code = handle.popen.poll() if handle.popen is not None else None
155
+ if exit_code == 0:
156
+ daemon_paths.pid_file.unlink(missing_ok=True)
157
+ message = f"Pipeline process completed cleanly (exit 0) within startup window. Log: {daemon_paths.log_file}"
158
+ payload = {
159
+ "success": True,
160
+ "pid": pid,
161
+ "completed": True,
162
+ "exit_code": 0,
163
+ "log_file": str(daemon_paths.log_file),
164
+ "started_at": started_at,
165
+ }
166
+ return CommandResult(0, f"Python {family.kind} daemon", "completed", stdout=json.dumps(payload), stderr="\n".join([*stderr_lines, message]))
167
+ if exit_code is not None or not is_pid_running(pid):
168
+ daemon_paths.pid_file.unlink(missing_ok=True)
169
+ exit_label = f" (exit_code={exit_code})" if exit_code is not None else ""
170
+ message = f"Pipeline process died immediately after launch{exit_label}. Check log for errors: {daemon_paths.log_file}"
171
+ tail = _tail_lines(daemon_paths.log_file, 10)
172
+ failure_stderr = [*stderr_lines, message]
173
+ if tail:
174
+ failure_stderr.append("--- Last log lines ---")
175
+ failure_stderr.extend(tail)
176
+ return CommandResult(1, f"Python {family.kind} daemon", message, stdout="", stderr="\n".join(failure_stderr))
177
+
178
+ stderr_lines.extend(
179
+ [
180
+ f"Launching {family.kind} pipeline...",
181
+ f"{family.kind} list: {list_path}",
182
+ f"Log file: {daemon_paths.log_file}",
183
+ f"Pipeline started successfully (PID: {pid})",
184
+ ]
185
+ )
186
+ payload = {"success": True, "pid": pid, "log_file": str(daemon_paths.log_file), "started_at": started_at}
187
+ return CommandResult(0, f"Python {family.kind} daemon", "started", stdout=json.dumps(payload), stderr="\n".join(stderr_lines))
188
+ except PidLockError as exc:
189
+ message = str(exc)
190
+ return CommandResult(1, f"Python {family.kind} daemon", message, stdout="", stderr=message)
162
191
 
163
192
 
164
193
  def _status(family: RunnerFamily, daemon_paths: DaemonPaths) -> CommandResult:
@@ -174,6 +203,10 @@ def _status(family: RunnerFamily, daemon_paths: DaemonPaths) -> CommandResult:
174
203
  stderr_lines.append("Pipeline is not running")
175
204
  if daemon_paths.log_file.is_file():
176
205
  stderr_lines.append(f"Last log: {daemon_paths.log_file} ({daemon_paths.log_file.stat().st_size // 1024}KB)")
206
+ tail = _tail_lines(daemon_paths.log_file, 5)
207
+ if tail:
208
+ stderr_lines.append("--- Last 5 log lines ---")
209
+ stderr_lines.extend(tail)
177
210
  return CommandResult(1, f"Python {family.kind} daemon status", "not running", stdout=json.dumps({"running": False}), stderr="\n".join(stderr_lines))
178
211
 
179
212
  list_key = LIST_META_KEY_BY_KIND[family.kind]
@@ -239,7 +272,6 @@ def _logs(family: RunnerFamily, daemon_paths: DaemonPaths, legacy_args: tuple[st
239
272
 
240
273
 
241
274
  def _parse_start_args(family: RunnerFamily, legacy_args: tuple[str, ...]) -> DaemonStartOptions:
242
- list_path = family.plan_path
243
275
  env_overrides = ""
244
276
  features_filter = ""
245
277
  help_requested = False
@@ -249,10 +281,14 @@ def _parse_start_args(family: RunnerFamily, legacy_args: tuple[str, ...]) -> Dae
249
281
  arg = legacy_args[index]
250
282
  if arg in {"--help", "-h"}:
251
283
  help_requested = True
252
- elif arg == "--env" and index + 1 < len(legacy_args):
284
+ elif arg == "--env":
285
+ if index + 1 >= len(legacy_args):
286
+ raise ValueError("--env requires a KEY=VALUE string")
253
287
  index += 1
254
288
  env_overrides = legacy_args[index]
255
- elif arg == "--features" and index + 1 < len(legacy_args):
289
+ elif arg == "--features":
290
+ if index + 1 >= len(legacy_args):
291
+ raise ValueError("--features requires a value")
256
292
  index += 1
257
293
  features_filter = legacy_args[index]
258
294
  elif arg.startswith("-"):
@@ -260,9 +296,10 @@ def _parse_start_args(family: RunnerFamily, legacy_args: tuple[str, ...]) -> Dae
260
296
  else:
261
297
  positional.append(arg)
262
298
  index += 1
263
- if positional:
264
- list_path = Path(positional[0]).expanduser()
265
- return DaemonStartOptions(list_path=list_path, env_overrides=env_overrides, features_filter=features_filter, help_requested=help_requested)
299
+ options = DaemonStartOptions(list_path=Path(positional[0]).expanduser() if positional else family.plan_path, env_overrides=env_overrides, features_filter=features_filter, help_requested=help_requested)
300
+ if not options.help_requested:
301
+ _daemon_env(options)
302
+ return options
266
303
 
267
304
 
268
305
  def _parse_log_args(legacy_args: tuple[str, ...]) -> DaemonLogOptions:
@@ -302,11 +339,19 @@ def _payload_command(family: RunnerFamily, paths, list_path: Path, options: Daem
302
339
 
303
340
  def _daemon_env(options: DaemonStartOptions) -> dict[str, str]:
304
341
  env: dict[str, str] = {"PRIZMKIT_LIVE_OUTPUT": "0"}
305
- for token in shlex.split(options.env_overrides):
306
- if "=" in token:
307
- key, value = token.split("=", 1)
308
- if key:
309
- env[key] = value
342
+ if not options.env_overrides.strip():
343
+ return env
344
+ try:
345
+ tokens = shlex.split(options.env_overrides, posix=(os.name != "nt"))
346
+ except ValueError as exc:
347
+ raise ValueError(f"Invalid --env syntax: {exc}") from exc
348
+ for token in tokens:
349
+ if "=" not in token:
350
+ raise ValueError(f"Invalid --env token (expected KEY=VALUE): {token}")
351
+ key, value = token.split("=", 1)
352
+ if not _ENV_KEY_PATTERN.fullmatch(key):
353
+ raise ValueError(f"Invalid --env variable name: {key!r}")
354
+ env[key] = value
310
355
  return env
311
356
 
312
357
 
@@ -339,9 +384,7 @@ def _write_meta(family: RunnerFamily, path: Path, pid: int, started_at: str, lis
339
384
  "env_overrides": options.env_overrides,
340
385
  "log_file": str(log_file),
341
386
  }
342
- tmp = path.with_suffix(path.suffix + ".tmp")
343
- tmp.write_text(json.dumps(data, indent=2), encoding="utf-8")
344
- tmp.replace(path)
387
+ write_json_atomic(path, data)
345
388
 
346
389
 
347
390
  def _read_meta(path: Path) -> dict[str, object]:
@@ -412,7 +455,24 @@ def _tail_lines(path: Path, count: int) -> list[str]:
412
455
  if count <= 0 or not path.is_file():
413
456
  return []
414
457
  try:
415
- return path.read_text(encoding="utf-8", errors="replace").splitlines()[-count:]
458
+ with path.open("rb") as handle:
459
+ handle.seek(0, os.SEEK_END)
460
+ file_size = handle.tell()
461
+ if file_size == 0:
462
+ return []
463
+ chunk_size = 8192
464
+ position = file_size
465
+ chunks: list[bytes] = []
466
+ newlines_seen = 0
467
+ while position > 0 and newlines_seen <= count:
468
+ read_size = min(chunk_size, position)
469
+ position -= read_size
470
+ handle.seek(position, os.SEEK_SET)
471
+ chunk = handle.read(read_size)
472
+ chunks.append(chunk)
473
+ newlines_seen += chunk.count(b"\n")
474
+ text = b"".join(reversed(chunks)).decode("utf-8", errors="replace")
475
+ return text.splitlines()[-count:]
416
476
  except OSError:
417
477
  return []
418
478