@optima-chat/optima-agent 0.8.90 → 0.8.92

package/.claude/skills/video-clone/references/ffmpeg-commands.md

@@ -0,0 +1,42 @@
+# FFmpeg — where the commands live
+
+The ffmpeg commands you'd have inlined here are owned by scripts now. Read
+the script source if you need to see the exact flags.
+
+| What | Script |
+|---|---|
+| ffprobe + scene detection (`select='gt(scene,0.3)'`) | `scripts/analyze_source.py` |
+| equidistant frame extraction + tile grid | `scripts/extract_frames.py` |
+| single-segment normalize (`-r 30 -crf 18 -c:a aac -b:a 192k`) | `scripts/assemble.py --single` |
+| multi-segment normalize + concat (scale=720:1280 + concat demuxer) | `scripts/assemble.py --multi` |
+
+## Single vs multi-segment heuristic
+
+`analyze_source.py` classifies automatically:
+
+- scene cuts ≤1 (after filtering out cuts <0.5s apart) → `classification: single`
+- scene cuts ≥2 → `classification: multi`
+
+If the auto-classification is wrong, override the plan manually — don't
+edit the script.
+
+## Things the scripts deliberately don't do
+
+- **Audio replacement from source** — Kling 3.0 handles lip sync itself;
+  don't splice the source audio back in or you'll get misaligned mouths.
+- **Resolution auto-detection for multi-segment** — `assemble.py --multi`
+  hardcodes `scale=720:1280`. If your source is different, pass pre-scaled
+  clips or extend the script.
+- **Re-encoding `final_v{N}.mp4` after assembly** — if final looks wrong,
+  regenerate the constituent videos, not the final.
+
+## Raw command reference (only when debugging outside the scripts)
+
+```bash
+# probe metadata
+ffprobe -v quiet -print_format json -show_format -show_streams video.mp4
+
+# concat list format (scripts generate this automatically)
+file 'clip1_norm.mp4'
+file 'clip2_norm.mp4'
+```

package/.claude/skills/video-clone/references/gate-enforcement.md

@@ -0,0 +1,144 @@
+# Gate Enforcement
+
+This skill enforces its HARD-GATE mechanically, not textually. Every
+executor script that costs money or generates output calls `require_gate()`
+at startup and exits with code 1 if the gate isn't set. You cannot
+rationalize past a CLI that won't produce output.
+
+## State location
+
+Each project has its own state file:
+
+```
+gen-output/video-clone/<project>/.state/phase.json
+```
+
+## Schema (single-gate model — PR #65)
+
+```json
+{
+  "schema_version": 1,
+  "project": "handheld-phone-swap",
+  "task_type": "video_clone",
+  "created_at": "2026-04-11T16:55:00Z",
+  "current_phase": 0,
+  "gates": {
+    "preview_confirmed": {"status": false, "confirmed_at": null, "user_quote": null}
+  },
+  "history": []
+}
+```
+
+There is **one gate**: `preview_confirmed`. It is set by `confirm.py`
+after the user reviews the complete prep preview (analysis + grid +
+prompt + edited frame). The prep scripts (analyze_source, extract_frames,
+edit_first_frame) run freely before confirmation — only the generation
+scripts are gated.
+
+Gates are never un-set. Each set operation appends an entry to `history`
+with timestamp + user quote + caller script name, giving you an audit
+trail to answer "did the user actually confirm this?"
+
+## Which script needs which gate
+
+| Script | Required gate |
+|---|---|
+| `analyze_source.py` | (none — prep runs freely) |
+| `extract_frames.py` | (none — prep runs freely) |
+| `edit_first_frame.py` | (none — prep runs freely) |
+| `preview.py` | (none — collects artifacts, no cost) |
+| `kling_generate.py` | **preview_confirmed** |
+| `gen_video.py` | **preview_confirmed** |
+| `save_workflow.py` | **preview_confirmed** |
+| `assemble.py` | (none — post-processes already-generated videos) |
+| `init_project.py` | (none — must run before any gate exists) |
+| `confirm.py` | (none — sets the gate) |
+| `preflight.py` | (none — environment check) |
+| `status.py` | (none — read-only) |
+
+## How to set the gate
+
+```bash
+python scripts/confirm.py --project <name> --quote "<user's actual words>"
+```
+
+- **`--quote` is required** and must be non-empty.
+- **Quote heuristic**: if the quote contains negation markers (`不`, `改`,
+  `no`, `not`, `change`, `modify`, `wrong`, …), the script refuses to set
+  the gate unless you also pass `--force`. This prevents Claude from
+  using a correction ("不需要音频") as a confirmation.
+- **Use `--force` sparingly**: only when the user said something like
+  "no audio, otherwise good" — a genuine confirmation that contains a
+  negation word.
+- The gate records `caller` (the script name) in history. Fabricated
+  quotes are detectable in post-mortem review.
+
+## How a blocked script looks
+
+```
+[HARD-GATE BLOCKED] kling_generate.py needs preview_confirmed=True
+Current state: preview_confirmed=False
+Project: /abs/path/to/gen-output/video-clone/handheld-phone-swap
+
+To proceed:
+  1. Show the preview bundle to the user and wait for their confirmation.
+  2. Run: python scripts/confirm.py --project <name> --quote "<user's actual words>"
+  3. Retry this command.
+
+Claude: do NOT rationalize past this. The gate exists because text
+instructions alone did not stop prior bypass attempts. Go get the real
+user confirmation.
+```
+
+Exit code is always 1. Downstream pipes will break; you can't accidentally
+feed "locked" output into the next step.
+
+## Old 3-gate schema (pre-PR #65)
+
+If you have a project created before the single-gate refactor, the state
+file will have `plan_confirmed`, `prompt_confirmed`, `frame_confirmed`
+instead of `preview_confirmed`. Any gated script will exit 1 with:
+
+```
+[HARD-GATE BLOCKED] expected gate 'preview_confirmed' but it is not
+present. This is most likely an old 3-gate schema project.
+Either: complete this project with PR #65 scripts, or start a new project.
+```
+
+Do NOT manually edit old phase.json files to add `preview_confirmed`.
+Start a new project with `init_project.py` and re-run prep.
+
+## Common bypass attempts (and why the gate still wins)
+
+| Attempt | Outcome |
+|---|---|
+| "analyze_source is just analysis, no cost" | Runs freely — no gate on prep scripts. Correct behavior. |
+| "I'll edit phase.json to set the gate" | Possible, but leaves a gap in `history`. Audit trail shows no `confirm.py` call. |
+| `confirm.py --quote 'ok'` without asking user | Sets gate with `user_quote: "ok"`. No user types that in isolation — obvious in post-mortem. |
+| "I'll skip preview.py and confirm directly" | `confirm.py` doesn't require preview_v*.md — but `preview.py` must have run first for artifacts to be present for the user to review. |
+| "I'll symlink phase.json to /dev/null" | Exit 1 on read. |
+| "I'll delete .state/" | Exit 1 — "phase.json not found". |
+
+The cheapest path is always to actually get the user's confirmation.
+
+## When to read history
+
+The `history` array is append-only. Useful cases:
+
+- **Resuming a multi-session project** — read history to know what gate
+  is set and what the user said. Use `status.py` for a human-readable view.
+- **Debugging bad output** — if a video is wrong, history shows the exact
+  quote the user gave when confirming the preview.
+- **Verifying gate authenticity** — `caller` field shows which script set
+  the gate. `confirm.py` is the only legitimate caller.
+
+## Why this exists
+
+Previous versions had HARD-GATE rules in SKILL.md text with a
+Rationalization Counter table. They did not stop Claude from running
+ffprobe / downloading videos / calling `gen image` before the user
+confirmed. The failure mode was always the same: Claude decided "my action
+doesn't count as execution" and rationalized past the text rule.
+
+Mechanical gates end the argument. The script either runs or it doesn't,
+and the decision doesn't depend on how Claude interprets the rules.

package/.claude/skills/video-clone/references/kling-api.md

@@ -0,0 +1,52 @@
+# Kling 3.0 via PiAPI — what the script handles + what you need to know
+
+The full pipeline (frame upload → submit task → poll → download with
+retry) lives in `scripts/kling_generate.py`. Run it, don't hand-roll it.
+
+```bash
+python scripts/kling_generate.py --project <name> --frame <confirmed-frame.png>
+# options: --duration 5|10  --aspect-ratio 9:16  --mode std|pro
+#          --cfg-scale 0.5  --no-audio
+```
+
+## When to use Kling vs `gen video`
+
+| Need audio / lip sync? | Use |
+|---|---|
+| Yes | `kling_generate.py` (Kling 3.0, ~$1 per 10s) |
+| No | `gen_video.py` (Wan 2.6, ~$0.02 per 10s) |
+
+## Non-obvious traps (all already handled by the script)
+
+- `cfg_scale` **must be float**. Passing a string makes PiAPI coerce it to
+  `500` which produces nonsense. The script uses `float(cfg)`.
+- Status field is lowercase `"completed"` (not `"Completed"`).
+- Output field differs by version: 3.0 returns `output.video`, 2.6 returns
+  `output.video_url`. Script hardcodes 3.0's `output.video`.
+- `enable_audio` is 3.0-only — no-op on 2.6.
+- PiAPI CDN drops large downloads; the script retries 3× with 5s backoff.
+- Kling rejects base64 in `image_url`. The script uploads to
+  freeimage.host first to get a public URL. Do not switch to catbox.moe
+  (PiAPI's servers can't reach it).
+
+## Prompt sourcing
+
+The script reads the prompt from `<project>/prompt.md`. If you want to
+use a different prompt for a test run, edit `prompt.md` (it's versioned
+via `log.md` in the project dir, so edits are recoverable).
+
+## Negative prompt (hardcoded in script)
+
+```
+slow motion, dreamy, ethereal, cinematic, blurry,
+distorted, deformed hands, extra fingers
+```
+
+Changing this requires editing `kling_generate.py` directly — it's
+deliberately not a CLI flag because the same negatives apply to every run.
+
+## Required environment
+
+- `PIAPI_KEY` env var — run `scripts/preflight.py` to verify
+- `requests` Python package — the script imports lazily and prints a
+  clear error if missing

package/.claude/skills/video-clone/references/prompt-template.md

@@ -0,0 +1,71 @@
+# Motion Prompt 模板与规范
+
+## 中文 6 段模板
+
+复刻时由 Claude Opus 分析源帧生成，纯生成时根据用户描述编写。
+写入 `prompt.md` 并打印给用户，Phase 3 从 `prompt.md` 读取。
+
+```
+### 视觉风格
+[拍摄设备感 + 画面质感 + 色彩方案 + 光线 + 氛围]
+
+### 场景叙述
+[时间地点 + 人物外貌 + 产品描述(重复颜色/特征) + 背景环境]
+
+### 摄影技术
+[景别 + 运镜 + 焦段 + 景深 + 光线]  情绪：[...]
+
+### 动作清单
+- [时间顺序，精确到哪只手]
+- [产品交互，避免复杂手部操作]
+
+### 对话
+- [语言和风格]
+
+### 背景声音
+- [环境音 + 人声 + 无背景音乐]
+```
+
+## Anti-AI 风格（融入摄影技术段）
+
+手持拍摄/轻微晃动/自然光/无滤镜/纪实感
+
+## 禁用词
+
+梦幻/空灵/电影感/慢动作/丝滑/优雅
+
+## 长度控制
+
+1200-2000 字符，超 2500 必须精简。
+
+## prompt.md 工作流
+
+1. Claude 分析 → 写入 prompt.md → 打印给用户
+2. 用户说"OK" → 直接用；用户说"改一下" → 用户编辑或告诉 Claude 改
+3. Phase 3 从 prompt.md 读取生成视频
+4. 重跑时：修改 prompt.md → 旧版本记录到 log.md
+
+## 示例
+
+```markdown
+# fishing-scale — Prompt
+
+### 视觉风格
+竖屏手持vlog，自然饱和色彩，明亮日光，无滤镜，纪实感。
+
+### 场景叙述
+阳光白天，戴眼镜、深蓝头巾、黑色运动上衣的女子跪坐沙滩...
+
+### 摄影技术
+中景，手持拍摄，轻微晃动，自然光，浅景深。情绪：轻松日常
+
+### 动作清单
+- 左手托住电子秤底部，右手食指轻触屏幕
+- 产品保持静止，人物微笑看向镜头
+
+### 对话
+- 英语，日常对话风格
+
+### 背景声音
+- 海浪声、风声、远处人声，无背景音乐
+```

package/.claude/skills/video-clone/references/url-parsing.md

@@ -0,0 +1,32 @@
+# URL / Source Download — decision table
+
+**Do not use WebFetch** for source videos (anti-scraping, auth walls).
+Choose the right tool based on the URL shape and use it manually — there
+is no script wrapper because the right approach varies by platform.
+
+| URL shape | Command |
+|---|---|
+| `tiktok.com/@user/video/<id>` | `scout tiktok video-detail <id>` → grab video URL → `wget` |
+| `vm.tiktok.com/<short>` | `curl -sI <url>` → `Location:` header → extract id → see TikTok row |
+| `douyin.com/video/<id>` | `scout douyin video-download <id>` → `wget` |
+| `v.douyin.com/<short>` | `scout douyin video-by-url "<url>"` |
+| Instagram Reels (`instagram.com/reel/...`) | `scout instagram download-reel "<url>"` |
+| 小红书视频 (`xiaohongshu.com/explore/<id>`) | `scout xhs note-detail <id>` → grab video link → `wget` |
+| Local file path | Pass directly to `--video` |
+
+After download, save to `gen-output/video-clone/<project>/source/` and
+then feed the local path to `analyze_source.py --video <path>`.
+
+## Why the script pipeline starts after download
+
+Downloading is the *only* step that remains manual because platform APIs
+change faster than the script would. Everything downstream of
+`--video <local-file>` is automated by the Python scripts.
+
+## Sanity checks before running analyze_source.py
+
+1. File size > 0
+2. `ffprobe -v error <file>` returns no errors
+3. Duration makes sense for the source (`ffprobe -show_entries format=duration`)
+
+If any of these fail, re-download with a different tool before proceeding.

package/.claude/skills/video-clone/references/workflow-system.md

@@ -0,0 +1,92 @@
+# Workflow 经验库系统
+
+## 什么是 Workflow
+
+Workflow 是一次成功视频制作的经验总结。它记录了在特定场景下"什么方法效果最好"，让相似任务不用从零摸索。
+
+## 目录结构
+
+```
+gen-output/video-clone/workflows/
+├── README.md                        ← 索引，每个 workflow 一行
+├── handheld-product-swap.md         ← 手持vlog产品替换
+├── multi-scene-product-demo.md      ← 多场景产品展示
+└── lifestyle-pure-gen.md            ← 生活方式纯生成
+```
+
+## README.md 格式
+
+索引文件，快速定位。每行一个 workflow，格式：
+
+```markdown
+# Video Clone Workflows
+
+| Workflow | 适用场景 | 效果 | 关键策略 |
+|---|---|---|---|
+| [handheld-product-swap](handheld-product-swap.md) | 手持vlog + 单物品替换 | ⭐⭐⭐⭐⭐ | 双图首帧, t=15s选帧, 简单手部动作 |
+| [multi-scene-product-demo](multi-scene-product-demo.md) | 多场景产品展示(>2段) | ⭐⭐⭐⭐ | 每段独立首帧, 产品描述跨段一致 |
+```
+
+## Workflow 文件格式
+
+每个 `.md` 文件包含：
+
+```markdown
+# {workflow-name}
+
+## 适用场景
+- 什么类型的视频适合用这个 workflow
+- 关键特征（单/多段、有无人物、产品类型等）
+
+## 策略
+
+### 首帧
+- 选帧策略（哪个时间点最好、为什么）
+- gen image 参数（单图/双图、prompt 关键词）
+- 踩坑记录（什么不 work）
+
+### Prompt
+- prompt 风格和重点（哪些段需要重点写）
+- 验证有效的 prompt 片段（可直接复用）
+- 禁用/低效的描述方式
+
+### 视频生成
+- 工具选择和参数
+- cfg_scale / duration / mode 配置
+
+### 后处理
+- 特殊的 ffmpeg 参数
+
+## 成功案例
+- 项目名 + 简要结果（链接到项目目录）
+
+## 踩坑记录
+- 试过但失败的方法，避免重蹈覆辙
+```
+
+## 何时创建新 Workflow
+
+满足以下全部条件：
+
+1. **用户满意** — 最终视频被用户认可
+2. **新场景** — 没有已有 workflow 完全覆盖
+3. **有可复用的经验** — 不是纯靠运气，有明确的策略可提炼
+
+## 何时更新已有 Workflow
+
+- 同类任务发现了更好的参数/策略
+- 踩了新坑，值得记录避免下次再踩
+- 工具更新导致旧策略需要调整
+
+## 匹配逻辑
+
+Phase 0 读取 README.md 后，按以下维度匹配：
+
+1. **视频类型**：手持vlog / 产品展示 / 口播 / 纯展示
+2. **片段结构**：单片段 / 多片段
+3. **产品交互**：手持 / 桌面摆放 / 穿戴 / 无人物
+4. **音频需求**：有口型同步 / 纯BGM / 无音频
+
+完全匹配 → 直接复用策略。
+部分匹配 → 以最接近的 workflow 为基础调整。
+无匹配 → 走通用 pipeline。

package/.claude/skills/video-clone/scripts/_confirm.py

@@ -0,0 +1,96 @@
+"""Shared implementation for confirm.py.
+
+run_confirm() handles:
+    - argparse with --project / --quote / --force
+    - quote validation (non-empty)
+    - negation heuristic (refuses quotes that sound like corrections unless --force)
+    - resolving the project directory via GEN_OUTPUT_ROOT
+    - automatically passing caller=Path(sys.argv[0]).name to _gate.set_gate()
+"""
+from __future__ import annotations
+
+import argparse
+import os
+import sys
+from pathlib import Path
+
+import _gate
+
+NEGATION_MARKERS = (
+    "不", "别", "改", "调整", "不行", "不对", "再", "换",
+    "no", "not", "don't", "dont", "modify", "change", "different", "wrong",
+)
+
+GATE_NAME = "preview_confirmed"
+
+
+def _gen_output_root() -> Path:
+    override = os.environ.get("GEN_OUTPUT_ROOT")
+    if override:
+        return Path(override)
+    return Path.cwd() / "gen-output"
+
+
+def _looks_like_negation(quote: str) -> bool:
+    low = quote.lower()
+    return any(m in low for m in NEGATION_MARKERS)
+
+
+def run_confirm() -> int:
+    ap = argparse.ArgumentParser(
+        description=f"Record user confirmation for {GATE_NAME}."
+    )
+    ap.add_argument("--project", required=True, help="Project name under video-clone/")
+    ap.add_argument(
+        "--quote", required=True,
+        help="The user's actual confirmation words (verbatim). Required.",
+    )
+    ap.add_argument(
+        "--force", action="store_true",
+        help="Required if the quote contains negation markers "
+             "(used when user said something like 'no audio, rest is fine').",
+    )
+    args = ap.parse_args()
+
+    quote = args.quote.strip()
+    if not quote:
+        print(
+            "ERROR: --quote is empty. You must pass the user's actual "
+            "confirmation words.",
+            file=sys.stderr,
+        )
+        return 1
+
+    if _looks_like_negation(quote) and not args.force:
+        print(
+            f"ERROR: quote looks like a correction / negation: {quote!r}\n"
+            f"If the user really confirmed (e.g. 'no audio, rest is fine'), "
+            f"re-run with --force. Otherwise, go back and get a cleaner "
+            f"confirmation from the user.",
+            file=sys.stderr,
+        )
+        return 1
+
+    project_dir = _gen_output_root() / "video-clone" / args.project
+    if not project_dir.is_dir():
+        print(
+            f"ERROR: project directory not found at {project_dir}\n"
+            f"Run init_project.py first.",
+            file=sys.stderr,
+        )
+        return 1
+
+    # IMPORTANT: caller is sys.argv[0] (the entry script), not __file__.
+    # We want the audit to record "confirm.py", not "_confirm.py".
+    caller = Path(sys.argv[0]).name if sys.argv and sys.argv[0] else "<unknown>"
+
+    try:
+        _gate.set_gate(project_dir, GATE_NAME, quote, caller=caller)
+    except (ValueError, FileNotFoundError, KeyError) as e:
+        print(f"ERROR: {e}", file=sys.stderr)
+        return 1
+
+    print(f"OK: {GATE_NAME} recorded for project {args.project}")
+    print(f"    quote:  {quote}")
+    print(f"    caller: {caller}")
+    return 0

package/.claude/skills/video-clone/scripts/_confirm_test.py

@@ -0,0 +1,125 @@
+"""Unit tests for _confirm.run_confirm() — caller injection + quote validation."""
+from __future__ import annotations
+
+import json
+import os
+import sys
+import tempfile
+from pathlib import Path
+from unittest.mock import patch
+
+SCRIPTS_DIR = Path(__file__).parent
+sys.path.insert(0, str(SCRIPTS_DIR))
+
+import _confirm  # noqa: E402
+import _gate  # noqa: E402
+
+TEMPLATE = json.loads(
+    (SCRIPTS_DIR.parent / "assets" / "phase-state-template.json").read_text(encoding="utf-8")
+)
+
+
+def _make_project(root: Path, name: str = "p1") -> Path:
+    proj = root / "video-clone" / name
+    (proj / ".state").mkdir(parents=True)
+    state = json.loads(json.dumps(TEMPLATE))
+    state["project"] = name
+    state["task_type"] = "video_clone"
+    (proj / ".state" / "phase.json").write_text(json.dumps(state), encoding="utf-8")
+    return proj
+
+
+def _run_with_argv(argv, env=None):
+    old_argv = sys.argv
+    old_env = dict(os.environ)
+    try:
+        sys.argv = argv
+        if env:
+            os.environ.update(env)
+        return _confirm.run_confirm()
+    finally:
+        sys.argv = old_argv
+        os.environ.clear()
+        os.environ.update(old_env)
+
+
+def test_run_confirm_injects_caller_from_argv0():
+    with tempfile.TemporaryDirectory() as td:
+        _make_project(Path(td))
+        rc = _run_with_argv(
+            ["confirm.py", "--project", "p1", "--quote", "OK 开始"],
+            env={"GEN_OUTPUT_ROOT": td},
+        )
+        assert rc == 0
+        state = _gate.load_state(Path(td) / "video-clone" / "p1")
+        history = state["history"]
+        assert history[-1]["caller"] == "confirm.py"
+        assert history[-1]["user_quote"] == "OK 开始"
+    print("PASS test_run_confirm_injects_caller_from_argv0")
+
+
+def test_run_confirm_empty_quote_returns_one():
+    with tempfile.TemporaryDirectory() as td:
+        _make_project(Path(td))
+        rc = _run_with_argv(
+            ["confirm.py", "--project", "p1", "--quote", "   "],
+            env={"GEN_OUTPUT_ROOT": td},
+        )
+        assert rc == 1
+    print("PASS test_run_confirm_empty_quote_returns_one")
+
+
+def test_run_confirm_negation_without_force_returns_one():
+    with tempfile.TemporaryDirectory() as td:
+        _make_project(Path(td))
+        rc = _run_with_argv(
+            ["confirm.py", "--project", "p1", "--quote", "不要这样改"],
+            env={"GEN_OUTPUT_ROOT": td},
+        )
+        assert rc == 1
+    print("PASS test_run_confirm_negation_without_force_returns_one")
+
+
+def test_run_confirm_negation_with_force_returns_zero():
+    with tempfile.TemporaryDirectory() as td:
+        _make_project(Path(td))
+        rc = _run_with_argv(
+            ["confirm.py", "--project", "p1", "--quote", "no audio, rest is fine", "--force"],
+            env={"GEN_OUTPUT_ROOT": td},
+        )
+        assert rc == 0
+    print("PASS test_run_confirm_negation_with_force_returns_zero")
+
+
+def test_run_confirm_missing_project_returns_one():
+    with tempfile.TemporaryDirectory() as td:
+        rc = _run_with_argv(
+            ["confirm.py", "--project", "does-not-exist", "--quote", "ok"],
+            env={"GEN_OUTPUT_ROOT": td},
+        )
+        assert rc == 1
+    print("PASS test_run_confirm_missing_project_returns_one")
+
+
+def test_run_confirm_success_writes_history_with_caller():
+    with tempfile.TemporaryDirectory() as td:
+        _make_project(Path(td), "p2")
+        rc = _run_with_argv(
+            ["confirm.py", "--project", "p2", "--quote", "好的，开始"],
+            env={"GEN_OUTPUT_ROOT": td},
+        )
+        assert rc == 0
+        state = _gate.load_state(Path(td) / "video-clone" / "p2")
+        assert state["gates"]["preview_confirmed"]["status"] is True
+        assert state["history"][-1]["caller"] == "confirm.py"
+    print("PASS test_run_confirm_success_writes_history_with_caller")
+
+
+if __name__ == "__main__":
+    test_run_confirm_injects_caller_from_argv0()
+    test_run_confirm_empty_quote_returns_one()
+    test_run_confirm_negation_without_force_returns_one()
+    test_run_confirm_negation_with_force_returns_zero()
+    test_run_confirm_missing_project_returns_one()
+    test_run_confirm_success_writes_history_with_caller()
+    print("All 6 _confirm tests passed.")