cowork-flow 0.0.35 → 0.0.36

package/template/.zcode/scaffold/.cowork-flow/spec/schemas/rules.schema.json

@@ -67,8 +67,8 @@
           },
           "enforcement": {
             "type": "string",
-            "enum": ["validate_rules", "validate_implementation", "tdd_evidence", "host_contract", "metadata_only"],
-            "description": "Runtime or contract surface responsible for enforcing or carrying this rule"
+            "enum": ["validate_rules", "validate_implementation"],
+            "description": "Runtime surface responsible for enforcing this rule. Must have a corresponding validator module."
           }
         },
         "additionalProperties": false

package/template/skills/check/SKILL.md

@@ -20,7 +20,7 @@ Use this after implementation and before `finish-work`.
 
 ## Steps
 
-1. Read active task PRD, plan, and `check.jsonl`.
+1. Read active task decision-anchor.md, plan, and `check.jsonl`.
 2. Review `git diff --name-only` and `git diff`.
 3. Check contracts across caller/callee, command output, persisted state, templates, and docs.
 4. Verify spec compliance:
@@ -31,7 +31,7 @@ Use this after implementation and before `finish-work`.
 6. Review test intent: reject shallow tests that do not fail for meaningful behavior breaks.
 7. Run focused tests that would fail if the changed behavior broke.
 8. Run broader validation when the change touches shared runtime, templates, packaging, or public workflow.
-9. Report `test_intent_review` with the key tests that defend PRD acceptance behavior.
+9. Report `test_intent_review` with the key tests that defend decision-anchor.md acceptance behavior.
 10. Report spec compliance: for each spec/ file checked, state pass/fail with evidence from the diff.
 
 ## Report

package/template/skills/game-design/SKILL.md

@@ -29,7 +29,7 @@ The following guidelines live in `.cowork-flow/spec/game/` and should be read be
 ## Usage
 
 1. Read the relevant spec/game/ guide(s) first.
-2. Read the task PRD and implement.jsonl context.
+2. Read the task decision-anchor.md and implement.jsonl context.
 3. Proceed with implementation through `cowork-implement` or directly (depending on scope).
 
 ## When NOT to use

package/template/skills/start/SKILL.md

@@ -19,7 +19,7 @@ child must run the explicit shim bind before formal work.
 2. Read `.cowork-flow/workflow.md`.
 3. Read `.cowork-flow/config.yaml` for Codex dispatch hints and lifecycle hooks.
 4. Run `.cowork-flow/run resume` or `.\.cowork-flow\run.cmd resume` on Windows.
-5. Read the active task PRD and JSONL indexes only when a task is active.
+5. Read the active task decision-anchor.md and JSONL indexes only when a task is active.
 6. Read relevant `.cowork-flow/spec/*/index.md` files before code changes.
 
 Report active task, workflow state, blockers, and the next phase.
@@ -32,7 +32,7 @@ state is loaded, apply the requirement clarification gate from
 `.cowork-flow/workflow.md`, then route to the next workflow phase; clear
 multi-step implementation uses `writing-plans` before fixed-agent dispatch.
 
-New requirements that are unclear, boundary-unclear, multi-approach, behavior-changing, or missing acceptance criteria use `brainstorming` before PRD, planning, or fixed-agent dispatch. Small repository changes proceed directly only when the goal, scope boundary, and acceptance criteria are already clear.
+New requirements that are unclear, boundary-unclear, multi-approach, behavior-changing, or missing acceptance criteria use `brainstorming` before writing decision-anchor.md, planning, or fixed-agent dispatch. Small repository changes proceed directly only when the goal, scope boundary, and acceptance criteria are already clear.
 
 - Question-only work: answer directly.
 - Small repository change with clear goal/scope/acceptance: classify by `.cowork-flow/workflow.md`, create/start a task if required, then proceed.

package/template/skills/tdd/SKILL.md

@@ -9,7 +9,7 @@ Use this before editing behavior-changing code.
 
 ## Red-Green-Refactor
 
-1. Map the task PRD acceptance criteria to stable IDs such as `AC-001`.
+1. Map the task decision-anchor.md acceptance criteria to stable IDs such as `AC-001`.
 2. Write the smallest meaningful failing test first.
 3. Run the red command and confirm it fails because the target behavior is missing or wrong.
 4. Implement the smallest change that makes the behavior pass.
@@ -38,7 +38,7 @@ Record TDD proof in `<task>/tdd.jsonl`. Each evidence line is one JSON object:
 }
 ```
 
-Every evidence record must map to a PRD `acceptanceId`. The red failure must be about the target behavior, not syntax, import, environment, fixture, or setup failure.
+Every evidence record must map to a decision-anchor.md `acceptanceId`. The red failure must be about the target behavior, not syntax, import, environment, fixture, or setup failure.
 
 `testName` must resolve to the exact behavior test in `testFile`. Use one of:
 `test_method`, `ClassName.test_method`, or `module.ClassName.test_method`.

package/template/skills/writing-plans/SKILL.md

@@ -13,7 +13,7 @@ Before writing a plan, confirm the request has an executable scope, acceptance c
 
 Read:
 
-- Active task PRD.
+- Active task decision-anchor.md.
 - Relevant change spec/design files.
 - Relevant `.cowork-flow/spec/` indexes and target specs.
 - Files that define the contracts being changed.
@@ -64,7 +64,7 @@ Start with:
 - Include a failing test before implementation when behavior can be tested.
 - Do not add shallow tests just to satisfy process. Avoid tests that only assert existence, mirror implementation details, count mocks without behavior, or snapshot empty structure.
 - For complex problems, test depth first: cover invariants, cross-layer contracts, state transitions, error boundaries, and real regression paths before narrow unit cases.
-- Map each behavior-changing test to a stable PRD acceptance ID and note where `tdd.jsonl` will record the red-green evidence.
+- Map each behavior-changing test to a stable decision-anchor.md acceptance ID and note where `tdd.jsonl` will record the red-green evidence.
 - Avoid placeholders such as TODO, TBD, "handle edge cases", or "write tests".
 - Keep root/template parity explicit when both copies exist.
 
@@ -74,7 +74,7 @@ Start with:
 |---|---|
 | "这个 task 太小了，可以合并" | task 粒度由 acceptance criteria 决定，不由行数决定。AC 不可拆分时应合并，否则独立。 |
 | "先写个粗 plan，实现时再细化" | 粗 plan = 实现时没有约束。没有约束的实现 = 范围蔓延或返工。 |
-| "跳过 plan 直接开始反正有了 PRD" | PRD 定义"做什么"，plan 定义"怎么做和按什么顺序做"。缺少 plan 的任务在 midway 发现依赖错误时返工成本翻倍。 |
+| "跳过 plan 直接开始反正有了 decision-anchor" | decision-anchor.md 定义"做什么"，plan 定义"怎么做和按什么顺序做"。缺少 plan 的任务在 midway 发现依赖错误时返工成本翻倍。 |
 | "这个 task 不需要 verify 命令" | 没有 verify = 没有完成信号。每个 task 必须有可运行的验证命令。 |
 
 ## Plan Approval Gate
@@ -110,7 +110,7 @@ Execution strategy guide:
 
 Before handoff:
 
-1. Confirm every PRD acceptance criterion maps to a plan step.
+1. Confirm every decision-anchor.md acceptance criterion maps to a plan step.
 2. Search the plan for placeholders.
 3. Check names, paths, command syntax, and expected outputs.
 4. Record remaining risks or blockers.

package/template/.zcode/hooks/runtime/run

@@ -1,58 +0,0 @@
-#!/bin/sh
-# cowork-flow run launcher (ZCode plugin edition)
-# Runs commands using the plugin's bundled Python runtime.
-set -u
-
-MIN_PYTHON_LABEL="Python 3.9+"
-VERSION_CHECK='import sys; raise SystemExit(0 if sys.version_info >= (3, 9) else 1)'
-WORKFLOW_DIR=$(CDPATH= cd "$(dirname "$0")" && pwd) || exit 1
-
-# Plugin cache runtime (resolved relative to this script)
-# Path: hooks/runtime/run -> hooks/runtime/scripts/run.py
-RUNTIME_SCRIPTS="$WORKFLOW_DIR/scripts"
-
-if [ ! -d "$RUNTIME_SCRIPTS" ]; then
-  echo "Error: cowork-flow runtime not found. Expected at: $RUNTIME_SCRIPTS" >&2
-  exit 127
-fi
-
-RUNNER_SCRIPT="$RUNTIME_SCRIPTS/run.py"
-if [ ! -f "$RUNNER_SCRIPT" ]; then
-  echo "Error: run.py not found in runtime: $RUNTIME_SCRIPTS" >&2
-  exit 127
-fi
-
-candidate_is_valid() {
-  command -v "$1" >/dev/null 2>&1 || return 1
-  "$1" -c "$VERSION_CHECK" >/dev/null 2>&1
-}
-
-select_python() {
-  if candidate_is_valid "python3"; then
-    SELECTED_PYTHON=python3
-    return 0
-  fi
-  if candidate_is_valid "python"; then
-    SELECTED_PYTHON=python
-    return 0
-  fi
-  if candidate_is_valid "py"; then
-    SELECTED_PYTHON=py
-    SELECTED_PYTHON_ARG=-3
-    return 0
-  fi
-  echo "Error: $MIN_PYTHON_LABEL required but not found." >&2
-  exit 127
-}
-
-select_python
-
-SELECTED_PYTHON_ARG=${SELECTED_PYTHON_ARG:-}
-
-if [ -n "$SELECTED_PYTHON_ARG" ]; then
-  export PYTHONPATH="$RUNTIME_SCRIPTS${PYTHONPATH:+:$PYTHONPATH}"
-  exec "$SELECTED_PYTHON" "$SELECTED_PYTHON_ARG" "$RUNNER_SCRIPT" "$@"
-fi
-
-export PYTHONPATH="$RUNTIME_SCRIPTS${PYTHONPATH:+:$PYTHONPATH}"
-exec "$SELECTED_PYTHON" "$RUNNER_SCRIPT" "$@"

package/template/.zcode/hooks/runtime/run.cmd

@@ -1,37 +0,0 @@
-@echo off
-setlocal EnableExtensions
-
-set "MIN_PYTHON_LABEL=Python 3.9+"
-set "VERSION_CHECK=import sys; raise SystemExit(0 if sys.version_info >= (3, 9) else 1)"
-set "WORKFLOW_DIR=%~dp0"
-
-set "RUNTIME_SCRIPTS=%WORKFLOW_DIR%scripts"
-
-if not exist "%RUNTIME_SCRIPTS%\run.py" (
-  echo Error: cowork-flow runtime not found. >&2
-  exit /b 127
-)
-
-where python3 >nul 2>nul
-if not errorlevel 1 (
-  set "PYTHONPATH=%RUNTIME_SCRIPTS%;%PYTHONPATH%"
-  python3 "%RUNTIME_SCRIPTS%\run.py" %*
-  exit /b %ERRORLEVEL%
-)
-
-where python >nul 2>nul
-if not errorlevel 1 (
-  set "PYTHONPATH=%RUNTIME_SCRIPTS%;%PYTHONPATH%"
-  python "%RUNTIME_SCRIPTS%\run.py" %*
-  exit /b %ERRORLEVEL%
-)
-
-where py >nul 2>nul
-if not errorlevel 1 (
-  set "PYTHONPATH=%RUNTIME_SCRIPTS%;%PYTHONPATH%"
-  py -3 "%RUNTIME_SCRIPTS%\run.py" %*
-  exit /b %ERRORLEVEL%
-)
-
-echo Error: %MIN_PYTHON_LABEL% required but not found. >&2
-exit /b 127

package/template/.zcode/hooks/runtime/scripts/__init__.py

@@ -1 +0,0 @@
-"""Cowork Flow zcode plugin runtime scripts."""

package/template/.zcode/hooks/runtime/scripts/commands/__init__.py

@@ -1 +0,0 @@
-"""Command entrypoints for cowork-flow."""

package/template/.zcode/hooks/runtime/scripts/commands/_bootstrap.py

@@ -1,10 +0,0 @@
-"""Allow command scripts to import the sibling common package when run directly."""
-
-from __future__ import annotations
-
-import sys
-from pathlib import Path
-
-SCRIPTS_DIR = Path(__file__).resolve().parents[1]
-if str(SCRIPTS_DIR) not in sys.path:
-    sys.path.insert(0, str(SCRIPTS_DIR))

package/template/.zcode/hooks/runtime/scripts/commands/add_session.py

@@ -1,452 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-Add a new session to journal file and update index.md.
-
-Usage:
-    ./.cowork-flow/run add-session --title "Title" --commit "hash" --summary "Summary"
-    echo "content" | ./.cowork-flow/run add-session --title "Title" --commit "hash"
-"""
-
-from __future__ import annotations
-
-import argparse
-import re
-import subprocess
-import sys
-from datetime import datetime
-from pathlib import Path
-
-if __package__:
-    from . import _bootstrap as _bootstrap  # noqa: F401
-else:
-    import _bootstrap  # noqa: F401
-from common.core.paths import (
-    DIR_TASKS,
-    DIR_WORKFLOW,
-    DIR_WORKSPACE,
-    FILE_JOURNAL_PREFIX,
-    count_lines,
-    get_repo_root,
-    get_developer,
-    get_workspace_dir,
-)
-from common.core.developer import ensure_developer
-from common.core.config import get_session_commit_message, get_max_journal_lines
-
-MARKER_CURRENT_STATUS_START = "@@@auto:current-status"
-MARKER_CURRENT_STATUS_END = "@@@/auto:current-status"
-MARKER_ACTIVE_DOCUMENTS_START = "@@@auto:active-documents"
-MARKER_ACTIVE_DOCUMENTS_END = "@@@/auto:active-documents"
-MARKER_SESSION_HISTORY_START = "@@@auto:session-history"
-MARKER_SESSION_HISTORY_END = "@@@/auto:session-history"
-
-
-# =============================================================================
-# Helper Functions
-# =============================================================================
-
-def get_latest_journal_info(dev_dir: Path) -> tuple[Path | None, int, int]:
-    """Get latest journal file info.
-
-    Returns:
-        Tuple of (file_path, file_number, line_count).
-    """
-    latest_file: Path | None = None
-    latest_num = -1
-
-    for f in dev_dir.glob(f"{FILE_JOURNAL_PREFIX}*.md"):
-        if not f.is_file():
-            continue
-
-        match = re.search(r"(\d+)$", f.stem)
-        if match:
-            num = int(match.group(1))
-            if num > latest_num:
-                latest_num = num
-                latest_file = f
-
-    if latest_file:
-        lines = count_lines(latest_file)
-        return latest_file, latest_num, lines
-
-    return None, 0, 0
-
-
-def get_current_session(index_file: Path) -> int:
-    """Get current session number from index.md."""
-    if not index_file.is_file():
-        return 0
-
-    content = index_file.read_text(encoding="utf-8")
-    for line in content.splitlines():
-        if "Total Sessions" in line or "\u603b\u4f1a\u8bdd\u6570" in line:
-            match = re.search(r"[:\uFF1A]\s*(\d+)", line)
-            if match:
-                return int(match.group(1))
-    return 0
-
-
-def _extract_journal_num(filename: str) -> int:
-    """Extract journal number from filename for sorting."""
-    match = re.search(r"(\d+)", filename)
-    return int(match.group(1)) if match else 0
-
-
-def _format_commit_display(commit: str) -> str:
-    """Format commit hashes for display in index.md."""
-    if not commit or commit == "-":
-        return "-"
-    return re.sub(r"([a-f0-9]{7,})", r"`\1`", commit.replace(",", ", "))
-
-
-def _format_commit_table(commit: str) -> str:
-    """Format commit hashes for a session entry."""
-    if not commit or commit == "-":
-        return "(no code commit; planning or sync session)"
-
-    commit_table = """| Hash | Note |
-|------|------|"""
-    for c in commit.split(","):
-        c = c.strip()
-        commit_table += f"\n| `{c}` | See git log |"
-    return commit_table
-
-
-def count_journal_files(dev_dir: Path, active_num: int) -> str:
-    """Count journal files and return table rows."""
-    active_file = f"{FILE_JOURNAL_PREFIX}{active_num}.md"
-    result_lines = []
-
-    files = sorted(
-        [f for f in dev_dir.glob(f"{FILE_JOURNAL_PREFIX}*.md") if f.is_file()],
-        key=lambda f: _extract_journal_num(f.stem),
-        reverse=True
-    )
-
-    for f in files:
-        filename = f.name
-        lines = count_lines(f)
-        status = "Current" if filename == active_file else "Archived"
-        result_lines.append(f"| `{filename}` | ~{lines} | {status} |")
-
-    return "\n".join(result_lines)
-
-
-def create_new_journal_file(
-    dev_dir: Path, num: int, developer: str, today: str, max_lines: int = 2000,
-) -> Path:
-    """Create a new journal file."""
-    prev_num = num - 1
-    new_file = dev_dir / f"{FILE_JOURNAL_PREFIX}{num}.md"
-
-    content = f"""# Development Journal - {developer} (Part {num})
-
-> Continued from `{FILE_JOURNAL_PREFIX}{prev_num}.md` (archived after about {max_lines} lines)
-> Start date: {today}
-
----
-
-"""
-    new_file.write_text(content, encoding="utf-8")
-    return new_file
-
-
-def generate_session_content(
-    session_num: int,
-    title: str,
-    commit: str,
-    summary: str,
-    extra_content: str,
-    today: str
-) -> str:
-    """Generate session content."""
-    commit_table = _format_commit_table(commit)
-
-    return f"""
-
-## Session {session_num}: {title}
-
-**Date**: {today}
-**Task**: {title}
-
-### Summary
-
-{summary}
-
-### Main Changes
-
-{extra_content}
-
-### Git Commit
-
-{commit_table}
-
-### Verification
-
-- [OK] (add verification results)
-
-### Status
-
-[OK] **Completed**
-
-### Follow-up Actions
-
-- None, active task is complete
-"""
-
-
-def update_index(
-    index_file: Path,
-    dev_dir: Path,
-    title: str,
-    commit: str,
-    new_session: int,
-    active_file: str,
-    today: str
-) -> bool:
-    """Update index.md with new session info."""
-    commit_display = _format_commit_display(commit)
-
-    # Get file number from active_file name
-    match = re.search(r"(\d+)", active_file)
-    active_num = int(match.group(1)) if match else 0
-    files_table = count_journal_files(dev_dir, active_num)
-
-    print(f"Updating index.md (session {new_session})...", file=sys.stderr)
-    print(f"  Title: {title}", file=sys.stderr)
-    print(f"  Commit: {commit_display}", file=sys.stderr)
-    print(f"  Current file: {active_file}", file=sys.stderr)
-    print("", file=sys.stderr)
-
-    content = index_file.read_text(encoding="utf-8")
-
-    if MARKER_CURRENT_STATUS_START not in content:
-        print("Error: index.md is missing auto-update markers. Please restore the template first.", file=sys.stderr)
-        return False
-
-    # Process sections
-    lines = content.splitlines()
-    new_lines = []
-
-    in_current_status = False
-    in_active_documents = False
-    in_session_history = False
-    header_written = False
-
-    for line in lines:
-        if MARKER_CURRENT_STATUS_START in line:
-            new_lines.append(line)
-            in_current_status = True
-            new_lines.append(f"- **Current file**: `{active_file}`")
-            new_lines.append(f"- **Total Sessions**: {new_session}")
-            new_lines.append(f"- **Last Active**: {today}")
-            continue
-
-        if MARKER_CURRENT_STATUS_END in line:
-            in_current_status = False
-            new_lines.append(line)
-            continue
-
-        if MARKER_ACTIVE_DOCUMENTS_START in line:
-            new_lines.append(line)
-            in_active_documents = True
-            new_lines.append("| File | Lines | Status |")
-            new_lines.append("|------|------|------|")
-            new_lines.append(files_table)
-            continue
-
-        if MARKER_ACTIVE_DOCUMENTS_END in line:
-            in_active_documents = False
-            new_lines.append(line)
-            continue
-
-        if MARKER_SESSION_HISTORY_START in line:
-            new_lines.append(line)
-            in_session_history = True
-            header_written = False
-            continue
-
-        if MARKER_SESSION_HISTORY_END in line:
-            in_session_history = False
-            new_lines.append(line)
-            continue
-
-        if in_current_status:
-            continue
-
-        if in_active_documents:
-            continue
-
-        if in_session_history:
-            new_lines.append(line)
-            if re.match(r"^\|\s*-", line) and not header_written:
-                new_lines.append(f"| {new_session} | {today} | {title} | {commit_display} |")
-                header_written = True
-            continue
-
-        new_lines.append(line)
-
-    index_file.write_text("\n".join(new_lines), encoding="utf-8")
-    print("[OK] index.md updated.", file=sys.stderr)
-    return True
-
-
-# =============================================================================
-# Main Function
-# =============================================================================
-
-def _auto_commit_workspace(repo_root: Path) -> None:
-    """Stage .cowork-flow/workspace and .cowork-flow/tasks, then commit with a configured message."""
-    commit_msg = get_session_commit_message(repo_root)
-    workspace_rel = f"{DIR_WORKFLOW}/{DIR_WORKSPACE}"
-    tasks_rel = f"{DIR_WORKFLOW}/{DIR_TASKS}"
-    subprocess.run(
-        ["git", "add", "-A", workspace_rel, tasks_rel],
-        cwd=repo_root,
-        capture_output=True,
-    )
-    # Check if there are staged changes
-    result = subprocess.run(
-        ["git", "diff", "--cached", "--quiet", "--", workspace_rel, tasks_rel],
-        cwd=repo_root,
-    )
-    if result.returncode == 0:
-        print("[OK] No workspace metadata changes to commit.", file=sys.stderr)
-        return
-    commit_result = subprocess.run(
-        ["git", "commit", "-m", commit_msg],
-        cwd=repo_root,
-        capture_output=True,
-        text=True,
-    )
-    if commit_result.returncode == 0:
-        print(f"[OK] Metadata auto-committed: {commit_msg}", file=sys.stderr)
-    else:
-        print(f"[WARN] Metadata auto-commit failed: {commit_result.stderr.strip()}", file=sys.stderr)
-
-
-def add_session(
-    title: str,
-    commit: str = "-",
-    summary: str = "(add summary)",
-    extra_content: str = "(add details)",
-    auto_commit: bool = False,
-) -> int:
-    """Add a new session."""
-    repo_root = get_repo_root()
-    ensure_developer(repo_root)
-
-    developer = get_developer(repo_root)
-    if not developer:
-        print("Error: developer identity has not been initialized.", file=sys.stderr)
-        return 1
-
-    dev_dir = get_workspace_dir(repo_root)
-    if not dev_dir:
-        print("Error: workspace directory not found.", file=sys.stderr)
-        return 1
-
-    max_lines = get_max_journal_lines(repo_root)
-
-    index_file = dev_dir / "index.md"
-    today = datetime.now().strftime("%Y-%m-%d")
-
-    journal_file, current_num, current_lines = get_latest_journal_info(dev_dir)
-    current_session = get_current_session(index_file)
-    new_session = current_session + 1
-
-    session_content = generate_session_content(
-        new_session, title, commit, summary, extra_content, today
-    )
-    content_lines = len(session_content.splitlines())
-
-    print("========================================", file=sys.stderr)
-    print("Add Session Record", file=sys.stderr)
-    print("========================================", file=sys.stderr)
-    print("", file=sys.stderr)
-    print(f"Session: {new_session}", file=sys.stderr)
-    print(f"Title: {title}", file=sys.stderr)
-    print(f"Commit: {commit}", file=sys.stderr)
-    print("", file=sys.stderr)
-    print(f"Current journal file: {FILE_JOURNAL_PREFIX}{current_num}.md", file=sys.stderr)
-    print(f"Current lines: {current_lines}", file=sys.stderr)
-    print(f"New content lines: {content_lines}", file=sys.stderr)
-    print(f"Total lines after append: {current_lines + content_lines}", file=sys.stderr)
-    print("", file=sys.stderr)
-
-    target_file = journal_file
-    target_num = current_num
-
-    if current_lines + content_lines > max_lines:
-        target_num = current_num + 1
-        print(f"[!] Over {max_lines} lines, creating {FILE_JOURNAL_PREFIX}{target_num}.md", file=sys.stderr)
-        target_file = create_new_journal_file(dev_dir, target_num, developer, today, max_lines)
-        print(f"Created: {target_file}", file=sys.stderr)
-
-    # Append session content
-    if target_file:
-        with target_file.open("a", encoding="utf-8") as f:
-            f.write(session_content)
-        print(f"[OK] Appended session to {target_file.name}", file=sys.stderr)
-
-    print("", file=sys.stderr)
-
-    # Update index.md
-    active_file = f"{FILE_JOURNAL_PREFIX}{target_num}.md"
-    if not update_index(index_file, dev_dir, title, commit, new_session, active_file, today):
-        return 1
-
-    print("", file=sys.stderr)
-    print("========================================", file=sys.stderr)
-    print(f"[OK] Session {new_session} recorded successfully.", file=sys.stderr)
-    print("========================================", file=sys.stderr)
-    print("", file=sys.stderr)
-    print("Updated files:", file=sys.stderr)
-    print(f"  - {target_file.name if target_file else 'journal'}", file=sys.stderr)
-    print("  - index.md", file=sys.stderr)
-
-    # Auto-commit workspace changes only when explicitly requested.
-    if auto_commit:
-        print("", file=sys.stderr)
-        _auto_commit_workspace(repo_root)
-
-    return 0
-
-
-# =============================================================================
-# Main Entry
-# =============================================================================
-
-def main() -> int:
-    """CLI entry point."""
-    parser = argparse.ArgumentParser(
-        description="Append a session record to the journal and update index.md"
-    )
-    parser.add_argument("--title", required=True, help="Session title")
-    parser.add_argument("--commit", default="-", help="Comma-separated commit hashes")
-    parser.add_argument("--summary", default="(add summary)", help="Brief summary")
-    parser.add_argument("--content-file", help="Path to a file containing detailed content")
-    parser.add_argument(
-        "--auto-commit",
-        action="store_true",
-        help="Auto git commit after recording workspace metadata",
-    )
-    args = parser.parse_args()
-
-    extra_content = "(add details)"
-    if args.content_file:
-        content_path = Path(args.content_file)
-        if content_path.is_file():
-            extra_content = content_path.read_text(encoding="utf-8")
-    elif not sys.stdin.isatty():
-        extra_content = sys.stdin.read()
-
-    return add_session(
-        args.title, args.commit, args.summary, extra_content,
-        auto_commit=args.auto_commit,
-    )
-
-
-if __name__ == "__main__":
-    sys.exit(main())