@optima-chat/optima-agent 0.8.91 → 0.8.93

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

@@ -0,0 +1,202 @@
+"""Cross-session resume helper: show project status and next action.
+
+Usage:
+    python scripts/status.py --project <name>
+
+Reads phase.json and scans the project directory to determine what has been
+done and what the next step is. Exits 0 always (read-only, no side effects).
+
+Decision tree (top to bottom, first match wins):
+  1. preview_confirmed gate set → show "ready to generate / already generated"
+  2. preview_v*.md exists       → show "run confirm.py"
+  3. prompt.md non-empty AND
+     frame_v*.png exists (clone) → show "run preview.py"
+  4. analysis_v*.json exists    → show "edit first frame / write prompt.md"
+  5. (nothing)                  → show "run analyze_source.py"
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from _project import resolve_project
+
+
+def _latest(dir_path: Path, prefix: str, suffix: str) -> Path | None:
+    if not dir_path.is_dir():
+        return None
+    candidates = sorted(
+        dir_path.glob(f"{prefix}v*{suffix}"),
+        key=lambda p: int(p.stem.removeprefix(prefix).lstrip("v") or "0"),
+    )
+    return candidates[-1] if candidates else None
+
+
+def _latest_extract_dir(frames_dir: Path) -> Path | None:
+    if not frames_dir.is_dir():
+        return None
+    extracts = sorted(
+        [p for p in frames_dir.iterdir() if p.is_dir() and p.name.startswith("extract_v")],
+        key=lambda p: int(p.name.removeprefix("extract_v") or "0"),
+    )
+    return extracts[-1] if extracts else None
+
+
+def _gate_status(state: dict) -> bool:
+    return bool(
+        state.get("gates", {})
+        .get("preview_confirmed", {})
+        .get("status", False)
+    )
+
+
+def _section(title: str, lines: list[str]) -> str:
+    body = "\n".join(f"  {l}" for l in lines)
+    return f"{'='*60}\n{title}\n{'='*60}\n{body}\n"
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description="Show project status and next action.")
+    ap.add_argument("--project", required=True)
+    args = ap.parse_args()
+
+    project_dir = resolve_project(args.project)
+    state_path = project_dir / ".state" / "phase.json"
+    if not state_path.is_file():
+        print(f"ERROR: phase.json not found at {state_path}", file=sys.stderr)
+        return 1
+    state = json.loads(state_path.read_text(encoding="utf-8"))
+    task_type = state.get("task_type", "video_clone")
+
+    # --- Collect artifact presence ---
+    analysis_path = _latest(project_dir / "source", "analysis_", ".json")
+    extract_dir = _latest_extract_dir(project_dir / "frames")
+    grid_path = (
+        (extract_dir / "grid.jpg")
+        if extract_dir and (extract_dir / "grid.jpg").exists()
+        else None
+    )
+    prompt_path = project_dir / "prompt.md"
+    prompt_text = (
+        prompt_path.read_text(encoding="utf-8").strip()
+        if prompt_path.is_file()
+        else None
+    )
+    frame_path = _latest(project_dir / "frames", "frame_", ".png")
+    preview_path = _latest(project_dir, "preview_", ".md")
+    cost_path = project_dir / "cost.json"
+    videos = sorted((project_dir / "videos").glob("*.mp4"))
+    final_videos = [v for v in videos if v.name.startswith("final_")]
+    gate_set = _gate_status(state)
+
+    # --- Build checklist ---
+    def tick(condition: bool) -> str:
+        return "[x]" if condition else "[ ]"
+
+    checklist = []
+    if task_type == "video_clone":
+        checklist.append(f"{tick(analysis_path is not None)} source/analysis_v*.json")
+        checklist.append(f"{tick(grid_path is not None)} frames/extract_v*/grid.jpg")
+        checklist.append(f"{tick(bool(prompt_text))} prompt.md (non-empty)")
+        checklist.append(f"{tick(frame_path is not None)} frames/frame_v*.png")
+    else:
+        checklist.append(f"{tick(bool(prompt_text))} prompt.md (non-empty)")
+    checklist.append(f"{tick(cost_path.is_file())} cost.json (optional)")
+    checklist.append(f"{tick(preview_path is not None)} preview_v*.md")
+    checklist.append(f"{tick(gate_set)} preview_confirmed gate")
+    checklist.append(f"{tick(bool(final_videos))} videos/final_v*.mp4")
+
+    # --- Decision tree: next action ---
+    if gate_set and final_videos:
+        next_action = [
+            "Project complete.",
+            f"Final video: {final_videos[-1].name}",
+            "",
+            "Optional: capture as workflow:",
+            f'  python scripts/save_workflow.py --project {args.project} \\',
+            '    --name <slug> --scene "<scene>" --rating 5 --strategy "<strategy>"',
+        ]
+    elif gate_set and not final_videos:
+        next_action = [
+            "Gate confirmed — ready to generate video.",
+            "",
+            "Run one of:",
+            f"  python scripts/kling_generate.py --project {args.project} --frame frames/frame_v*.png",
+            f"  python scripts/gen_video.py --project {args.project} --frame frames/frame_v*.png",
+        ]
+    elif preview_path is not None:
+        next_action = [
+            f"Preview ready: {preview_path.name}",
+            "",
+            "Review it, then confirm:",
+            f'  python scripts/confirm.py --project {args.project} --quote "<your words>"',
+        ]
+    elif (
+        task_type == "video_gen"
+        and bool(prompt_text)
+    ) or (
+        task_type == "video_clone"
+        and bool(prompt_text)
+        and frame_path is not None
+        and analysis_path is not None
+        and grid_path is not None
+    ):
+        next_action = [
+            "All prep artifacts present — run preview:",
+            f"  python scripts/preview.py --project {args.project}",
+        ]
+    elif bool(prompt_text) and task_type == "video_clone":
+        # Have prompt but missing frame or grid
+        missing_parts = []
+        if frame_path is None:
+            missing_parts.append("frames/frame_v*.png  (edit_first_frame.py)")
+        if grid_path is None:
+            missing_parts.append("frames/extract_v*/grid.jpg  (extract_frames.py)")
+        next_action = ["Still needed:"] + missing_parts
+    elif analysis_path is not None:
+        next_action = [
+            "Analysis done — continue prep:",
+            f"  python scripts/extract_frames.py --project {args.project} --source source/*.mp4",
+            f"  # then edit first frame and write prompt.md",
+        ]
+    else:
+        if task_type == "video_clone":
+            next_action = [
+                "Start here:",
+                f"  python scripts/analyze_source.py --project {args.project} --source <video.mp4>",
+            ]
+        else:
+            next_action = [
+                "Start here — write prompt.md:",
+                f"  {project_dir / 'prompt.md'}",
+            ]
+
+    # --- Log tail ---
+    log_path = project_dir / "log.md"
+    log_lines: list[str] = []
+    if log_path.is_file():
+        all_lines = log_path.read_text(encoding="utf-8").splitlines()
+        # skip header, take last 10 non-empty
+        entries = [l for l in all_lines if l.strip() and not l.startswith("#")]
+        log_lines = entries[-10:]
+
+    # --- Render ---
+    sections = [
+        _section(
+            f"Project: {args.project}  [{task_type}]",
+            [f"Dir: {project_dir}"],
+        ),
+        _section("Prep checklist", checklist),
+        _section("Next action", next_action),
+    ]
+    if log_lines:
+        sections.append(_section("Recent log (last 10)", log_lines))
+
+    print("\n".join(sections))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

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

@@ -0,0 +1,174 @@
+"""Tests for status.py — cross-session resume helper."""
+from __future__ import annotations
+
+import json
+import os
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+SCRIPTS_DIR = Path(__file__).parent
+
+
+def _make_project(tmp: Path, task_type: str = "video_clone", gate: bool = False) -> Path:
+    proj = tmp / "video-clone" / "test-proj"
+    for sub in ("source", "frames", "videos", ".state"):
+        (proj / sub).mkdir(parents=True)
+    state = {
+        "schema_version": 1,
+        "project": "test-proj",
+        "task_type": task_type,
+        "created_at": "2025-01-01T00:00:00Z",
+        "current_phase": 0,
+        "gates": {
+            "preview_confirmed": {
+                "status": gate,
+                "confirmed_at": "2025-01-01T00:01:00Z" if gate else None,
+                "user_quote": "go" if gate else None,
+            }
+        },
+        "history": [],
+    }
+    (proj / ".state" / "phase.json").write_text(
+        json.dumps(state, indent=2), encoding="utf-8"
+    )
+    return proj
+
+
+def _run(tmp: Path) -> subprocess.CompletedProcess:
+    env = os.environ.copy()
+    env["GEN_OUTPUT_ROOT"] = str(tmp)
+    return subprocess.run(
+        [sys.executable, str(SCRIPTS_DIR / "status.py"), "--project", "test-proj"],
+        capture_output=True,
+        text=True,
+        env=env,
+    )
+
+
+# Helpers to add artifacts
+def _add_analysis(proj: Path):
+    (proj / "source" / "analysis_v1.json").write_text(
+        json.dumps({"duration_s": 10, "width": 720, "height": 1280,
+                    "fps": 30.0, "has_audio": False, "segments": 1,
+                    "classification": "single", "scene_cuts": []}),
+        encoding="utf-8",
+    )
+
+def _add_grid(proj: Path):
+    extract = proj / "frames" / "extract_v1"
+    extract.mkdir(parents=True, exist_ok=True)
+    (extract / "grid.jpg").write_bytes(b"dummy")
+
+def _add_prompt(proj: Path):
+    (proj / "prompt.md").write_text("A person walking.", encoding="utf-8")
+
+def _add_frame(proj: Path):
+    (proj / "frames" / "frame_v1.png").write_bytes(b"dummy")
+
+def _add_preview(proj: Path):
+    (proj / "preview_v1.md").write_text("# Preview: test-proj\n", encoding="utf-8")
+
+def _add_final_video(proj: Path):
+    (proj / "videos" / "final_v1.mp4").write_bytes(b"dummy")
+
+
+def test_status_exits_zero():
+    with tempfile.TemporaryDirectory() as td:
+        tmp = Path(td)
+        _make_project(tmp)
+        result = _run(tmp)
+        assert result.returncode == 0, f"Expected 0\nstderr: {result.stderr}"
+    print("PASS test_status_exits_zero")
+
+
+def test_status_no_artifacts_suggests_analyze_source():
+    with tempfile.TemporaryDirectory() as td:
+        tmp = Path(td)
+        _make_project(tmp)
+        result = _run(tmp)
+        assert "analyze_source" in result.stdout
+    print("PASS test_status_no_artifacts_suggests_analyze_source")
+
+
+def test_status_analysis_done_suggests_extract():
+    with tempfile.TemporaryDirectory() as td:
+        tmp = Path(td)
+        proj = _make_project(tmp)
+        _add_analysis(proj)
+        result = _run(tmp)
+        assert "extract_frames" in result.stdout
+    print("PASS test_status_analysis_done_suggests_extract")
+
+
+def test_status_all_prep_done_suggests_preview():
+    with tempfile.TemporaryDirectory() as td:
+        tmp = Path(td)
+        proj = _make_project(tmp)
+        _add_analysis(proj)
+        _add_grid(proj)
+        _add_prompt(proj)
+        _add_frame(proj)
+        result = _run(tmp)
+        assert "preview.py" in result.stdout
+    print("PASS test_status_all_prep_done_suggests_preview")
+
+
+def test_status_preview_exists_suggests_confirm():
+    with tempfile.TemporaryDirectory() as td:
+        tmp = Path(td)
+        proj = _make_project(tmp)
+        _add_analysis(proj)
+        _add_grid(proj)
+        _add_prompt(proj)
+        _add_frame(proj)
+        _add_preview(proj)
+        result = _run(tmp)
+        assert "confirm.py" in result.stdout
+    print("PASS test_status_preview_exists_suggests_confirm")
+
+
+def test_status_gate_confirmed_suggests_generate():
+    with tempfile.TemporaryDirectory() as td:
+        tmp = Path(td)
+        proj = _make_project(tmp, gate=True)
+        result = _run(tmp)
+        assert "kling_generate" in result.stdout or "gen_video" in result.stdout
+    print("PASS test_status_gate_confirmed_suggests_generate")
+
+
+def test_status_gate_and_final_video_shows_complete():
+    with tempfile.TemporaryDirectory() as td:
+        tmp = Path(td)
+        proj = _make_project(tmp, gate=True)
+        _add_final_video(proj)
+        result = _run(tmp)
+        assert "complete" in result.stdout.lower() or "final_v1.mp4" in result.stdout
+    print("PASS test_status_gate_and_final_video_shows_complete")
+
+
+def test_status_checklist_marks_present_artifacts():
+    with tempfile.TemporaryDirectory() as td:
+        tmp = Path(td)
+        proj = _make_project(tmp)
+        _add_analysis(proj)
+        # grid, prompt, frame missing
+        result = _run(tmp)
+        stdout = result.stdout
+        # analysis present → [x], others absent → [ ]
+        assert "[x]" in stdout
+        assert "[ ]" in stdout
+    print("PASS test_status_checklist_marks_present_artifacts")
+
+
+if __name__ == "__main__":
+    test_status_exits_zero()
+    test_status_no_artifacts_suggests_analyze_source()
+    test_status_analysis_done_suggests_extract()
+    test_status_all_prep_done_suggests_preview()
+    test_status_preview_exists_suggests_confirm()
+    test_status_gate_confirmed_suggests_generate()
+    test_status_gate_and_final_video_shows_complete()
+    test_status_checklist_marks_present_artifacts()
+    print("\nAll 8 status tests passed.")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.8.91",
+  "version": "0.8.93",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",
@@ -63,6 +63,7 @@
   "devDependencies": {
     "@types/node": "^22.10.1",
     "@types/ws": "^8.18.1",
+    "execa": "^9.6.1",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^4.0.14"