cowork-flow 0.0.37 → 0.0.39

package/template/.cowork-flow/scripts/common/git/git_context.py

@@ -50,7 +50,7 @@ class GitSnapshot:
 class ActiveTaskSnapshot:
     path: str | None
     data: dict | None
-    has_prd: bool
+    has_decision_anchor: bool
 
 
 def _run_git_command(args: list[str], cwd: Path | None = None) -> tuple[int, str, str]:
@@ -179,7 +179,7 @@ def _get_active_task_snapshot(repo_root: Path) -> ActiveTaskSnapshot:
     """Collect active-task metadata once for text and JSON renderers."""
     active_task = get_active_task(repo_root).task_path
     if not active_task:
-        return ActiveTaskSnapshot(path=None, data=None, has_prd=False)
+        return ActiveTaskSnapshot(path=None, data=None, has_decision_anchor=False)
 
     active_task_dir = repo_root / active_task
     task_json_path = active_task_dir / FILE_TASK_JSON
@@ -189,7 +189,7 @@ def _get_active_task_snapshot(repo_root: Path) -> ActiveTaskSnapshot:
     return ActiveTaskSnapshot(
         path=active_task,
         data=data,
-        has_prd=(active_task_dir / "decision-anchor.md").is_file(),
+        has_decision_anchor=(active_task_dir / "decision-anchor.md").is_file(),
     )
 
 
@@ -270,7 +270,7 @@ def _build_resume_checklist(
     active_task = snapshot.path
     commands.append(f"./{DIR_WORKFLOW}/run task list-context {active_task}")
 
-    if snapshot.has_prd:
+    if snapshot.has_decision_anchor:
         read_files.append(f"{active_task}/decision-anchor.md")
 
     read_files.extend(_task_plan_references(repo_root, snapshot))
@@ -314,11 +314,11 @@ def _append_resume_checklist(
         return
 
     active_task = snapshot.path
-    prd_path = f"{active_task}/decision-anchor.md"
-    if prd_path in read_files:
-        lines.append(f"- Read active task PRD: {prd_path}")
+    decision_anchor_path = f"{active_task}/decision-anchor.md"
+    if decision_anchor_path in read_files:
+        lines.append(f"- Read active task decision-anchor: {decision_anchor_path}")
     else:
-        lines.append(f"- Active task PRD missing: {prd_path}")
+        lines.append(f"- Active task decision-anchor missing: {decision_anchor_path}")
 
     lines.append(f"- List task context before reading details: {commands[1]}")
 
@@ -338,7 +338,7 @@ def _append_active_task(
     snapshot: ActiveTaskSnapshot,
     include_created: bool = False,
     include_description: bool = False,
-    include_prd_hint: bool = False,
+    include_decision_anchor_hint: bool = False,
 ) -> None:
     """Append the ACTIVE TASK section to text output."""
     lines.append("## ACTIVE TASK")
@@ -360,7 +360,7 @@ def _append_active_task(
             if description:
                 lines.append(f"Description: {description}")
 
-    if include_prd_hint and snapshot.has_prd:
+    if include_decision_anchor_hint and snapshot.has_decision_anchor:
         lines.append("")
         lines.append("[!] This task has decision-anchor.md - read it for task details")
     lines.append("")
@@ -404,29 +404,88 @@ def _children_progress(children: list[str], statuses: dict[str, str]) -> str:
     return f" [{_children_done_count(children, statuses)}/{len(children)} done]"
 
 
-# =============================================================================
-# JSON Output
-# =============================================================================
+def _append_active_tasks(lines: list[str], tasks_dir: Path) -> None:
+    """Append active task hierarchy to text output."""
+    lines.append("## ACTIVE TASKS")
+    task_count = 0
 
+    all_task_data = _load_task_context_by_dir(tasks_dir)
+    all_task_statuses = {
+        dir_name: data["status"]
+        for dir_name, data in all_task_data.items()
+    }
 
-def get_context_json(repo_root: Path | None = None) -> dict:
-    """Get context as a dictionary.
+    def _print_task_tree(name: str, indent: int = 0) -> None:
+        nonlocal task_count
+        info = all_task_data[name]
+        progress = _children_progress(info["children"], all_task_statuses)
+        prefix = "  " * indent
+        lines.append(f"{prefix}- {name}/ ({info['status']}){progress} @{info['assignee']}")
+        task_count += 1
+        for child in info["children"]:
+            if child in all_task_data:
+                _print_task_tree(child, indent + 1)
 
-    Args:
-        repo_root: Repository root path. Defaults to auto-detected.
+    for dir_name in sorted(all_task_data.keys()):
+        if not all_task_data[dir_name]["parent"]:
+            _print_task_tree(dir_name)
 
-    Returns:
-        Context dictionary.
-    """
-    if repo_root is None:
-        repo_root = get_repo_root()
+    if task_count == 0:
+        lines.append("(no active tasks)")
+    lines.append(f"Total: {task_count} active task(s)")
+    lines.append("")
 
-    developer = get_developer(repo_root)
-    tasks_dir = get_tasks_dir(repo_root)
+
+def _append_my_tasks(lines: list[str], developer: str, tasks_dir: Path) -> None:
+    """Append tasks assigned to the current developer."""
+    lines.append("## MY TASKS (Assigned to me)")
+    my_task_count = 0
+    all_task_data = _load_task_context_by_dir(tasks_dir)
+    all_task_statuses = _task_statuses(all_task_data)
+
+    for dir_name in sorted(all_task_data.keys()):
+        info = all_task_data[dir_name]
+        assignee = info["my_assignee"]
+        status = info["my_status"]
+
+        if assignee == developer and status != "done":
+            progress = _children_progress(info["children"], all_task_statuses)
+            lines.append(f"- [{info['priority']}] {info['title']} ({status}){progress}")
+            my_task_count += 1
+
+    if my_task_count == 0:
+        lines.append("(no tasks assigned to you)")
+    lines.append("")
+
+
+def _append_journal_file(lines: list[str], repo_root: Path, developer: str) -> None:
+    """Append journal file information to text output."""
+    lines.append("## JOURNAL FILE")
     journal_file = get_active_journal_file(repo_root)
-    git_snapshot = _get_git_snapshot(repo_root)
-    active_task_snapshot = _get_active_task_snapshot(repo_root)
+    if journal_file:
+        journal_lines = count_lines(journal_file)
+        relative = f"{DIR_WORKFLOW}/{DIR_WORKSPACE}/{developer}/{journal_file.name}"
+        lines.append(f"Active file: {relative}")
+        lines.append(f"Line count: {journal_lines} / 2000")
+        if journal_lines > 1800:
+            lines.append("[!] WARNING: Approaching 2000 line limit!")
+    else:
+        lines.append("No journal file found")
+    lines.append("")
+
+
+def _append_paths(lines: list[str], developer: str) -> None:
+    """Append standard cowork-flow paths."""
+    lines.append("## PATHS")
+    lines.append(f"Workspace: {DIR_WORKFLOW}/{DIR_WORKSPACE}/{developer}/")
+    lines.append(f"Tasks: {DIR_WORKFLOW}/{DIR_TASKS}/")
+    lines.append(f"Spec: {DIR_WORKFLOW}/{DIR_SPEC}/")
+    lines.append("")
+
 
+def _context_journal_json(repo_root: Path, developer: str | None) -> dict:
+    """Build journal context for JSON output."""
+    journal_file = get_active_journal_file(repo_root)
     journal_lines = 0
     journal_relative = ""
     if journal_file and developer:
@@ -434,8 +493,15 @@ def get_context_json(repo_root: Path | None = None) -> dict:
         journal_relative = (
             f"{DIR_WORKFLOW}/{DIR_WORKSPACE}/{developer}/{journal_file.name}"
         )
+    return {
+        "file": journal_relative,
+        "lines": journal_lines,
+        "nearLimit": journal_lines > 1800,
+    }
 
-    # Tasks
+
+def _context_tasks_json(tasks_dir: Path) -> list[dict]:
+    """Build active task list for JSON output."""
     tasks = []
     for dir_name, data in _load_task_json_by_dir(tasks_dir, sort=False).items():
         tasks.append(
@@ -447,19 +513,39 @@ def get_context_json(repo_root: Path | None = None) -> dict:
                 "parent": data.get("parent"),
             }
         )
+    return tasks
+
+
+# =============================================================================
+# JSON Output
+# =============================================================================
+
+
+def get_context_json(repo_root: Path | None = None) -> dict:
+    """Get context as a dictionary.
+
+    Args:
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        Context dictionary.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    developer = get_developer(repo_root)
+    tasks_dir = get_tasks_dir(repo_root)
+    git_snapshot = _get_git_snapshot(repo_root)
+    active_task_snapshot = _get_active_task_snapshot(repo_root)
 
     return {
         "developer": developer or "",
         "git": _git_json(git_snapshot),
         "tasks": {
-            "active": tasks,
+            "active": _context_tasks_json(tasks_dir),
             "directory": f"{DIR_WORKFLOW}/{DIR_TASKS}",
         },
-        "journal": {
-            "file": journal_relative,
-            "lines": journal_lines,
-            "nearLimit": journal_lines > 1800,
-        },
+        "journal": _context_journal_json(repo_root, developer),
         "resumeChecklist": _build_resume_checklist(repo_root, active_task_snapshot),
     }
 
@@ -479,37 +565,32 @@ def output_json(repo_root: Path | None = None) -> None:
 # =============================================================================
 
 
-def get_context_text(repo_root: Path | None = None) -> str:
-    """Get context as formatted text.
-
-    Args:
-        repo_root: Repository root path. Defaults to auto-detected.
-
-    Returns:
-        Formatted text output.
-    """
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    lines = []
-    lines.append("========================================")
-    lines.append("SESSION CONTEXT")
-    lines.append("========================================")
-    lines.append("")
+def _new_context_lines(title: str) -> list[str]:
+    return [
+        "========================================",
+        title,
+        "========================================",
+        "",
+    ]
 
-    developer = get_developer(repo_root)
 
-    # Developer section
+def _append_developer(lines: list[str], developer: str | None) -> bool:
     lines.append("## DEVELOPER")
     if not developer:
         lines.append(
             f"ERROR: Not initialized. Run: ./{DIR_WORKFLOW}/run init-developer <name>"
         )
-        return "\n".join(lines)
-
+        return False
     lines.append(f"Name: {developer}")
     lines.append("")
+    return True
 
+
+def _append_default_context_sections(
+    lines: list[str],
+    repo_root: Path,
+    developer: str,
+) -> None:
     git_snapshot = _get_git_snapshot(repo_root)
     _append_git_status(lines, git_snapshot, repo_root)
     _append_recent_commits(lines, git_snapshot)
@@ -519,81 +600,35 @@ def get_context_text(repo_root: Path | None = None) -> str:
         active_task_snapshot,
         include_created=True,
         include_description=True,
-        include_prd_hint=True,
+        include_decision_anchor_hint=True,
     )
     _append_resume_checklist(lines, repo_root, active_task_snapshot)
 
-    # Active tasks
-    lines.append("## ACTIVE TASKS")
     tasks_dir = get_tasks_dir(repo_root)
-    task_count = 0
+    _append_active_tasks(lines, tasks_dir)
+    _append_my_tasks(lines, developer, tasks_dir)
+    _append_journal_file(lines, repo_root, developer)
+    _append_paths(lines, developer)
 
-    all_task_data = _load_task_context_by_dir(tasks_dir)
-    all_task_statuses = {
-        dir_name: data["status"]
-        for dir_name, data in all_task_data.items()
-    }
 
-    def _print_task_tree(name: str, indent: int = 0) -> None:
-        nonlocal task_count
-        info = all_task_data[name]
-        progress = _children_progress(info["children"], all_task_statuses)
-        prefix = "  " * indent
-        lines.append(f"{prefix}- {name}/ ({info['status']}){progress} @{info['assignee']}")
-        task_count += 1
-        for child in info["children"]:
-            if child in all_task_data:
-                _print_task_tree(child, indent + 1)
-
-    for dir_name in sorted(all_task_data.keys()):
-        if not all_task_data[dir_name]["parent"]:
-            _print_task_tree(dir_name)
-
-    if task_count == 0:
-        lines.append("(no active tasks)")
-    lines.append(f"Total: {task_count} active task(s)")
-    lines.append("")
-
-    # My tasks
-    lines.append("## MY TASKS (Assigned to me)")
-    my_task_count = 0
-
-    for dir_name in sorted(all_task_data.keys()):
-        info = all_task_data[dir_name]
-        assignee = info["my_assignee"]
-        status = info["my_status"]
-
-        if assignee == developer and status != "done":
-            children_list = info["children"]
-            progress = _children_progress(children_list, all_task_statuses)
-            lines.append(f"- [{info['priority']}] {info['title']} ({status}){progress}")
-            my_task_count += 1
+def get_context_text(repo_root: Path | None = None) -> str:
+    """Get context as formatted text.
 
-    if my_task_count == 0:
-        lines.append("(no tasks assigned to you)")
-    lines.append("")
+    Args:
+        repo_root: Repository root path. Defaults to auto-detected.
 
-    # Journal file
-    lines.append("## JOURNAL FILE")
-    journal_file = get_active_journal_file(repo_root)
-    if journal_file:
-        journal_lines = count_lines(journal_file)
-        relative = f"{DIR_WORKFLOW}/{DIR_WORKSPACE}/{developer}/{journal_file.name}"
-        lines.append(f"Active file: {relative}")
-        lines.append(f"Line count: {journal_lines} / 2000")
-        if journal_lines > 1800:
-            lines.append("[!] WARNING: Approaching 2000 line limit!")
-    else:
-        lines.append("No journal file found")
-    lines.append("")
+    Returns:
+        Formatted text output.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
 
-    # Paths
-    lines.append("## PATHS")
-    lines.append(f"Workspace: {DIR_WORKFLOW}/{DIR_WORKSPACE}/{developer}/")
-    lines.append(f"Tasks: {DIR_WORKFLOW}/{DIR_TASKS}/")
-    lines.append(f"Spec: {DIR_WORKFLOW}/{DIR_SPEC}/")
-    lines.append("")
+    lines = _new_context_lines("SESSION CONTEXT")
+    developer = get_developer(repo_root)
+    if not _append_developer(lines, developer):
+        return "\n".join(lines)
 
+    _append_default_context_sections(lines, repo_root, developer)
     lines.append("========================================")
 
     return "\n".join(lines)
@@ -608,100 +643,73 @@ def get_context_record_json(repo_root: Path | None = None) -> dict:
         repo_root = get_repo_root()
 
     developer = get_developer(repo_root)
-    tasks_dir = get_tasks_dir(repo_root)
-
     git_snapshot = _get_git_snapshot(
         repo_root,
         include_empty_commit_message=False,
     )
 
-    # My tasks
-    my_tasks = []
-    task_data_by_dir = _load_task_json_by_dir(tasks_dir)
-    all_task_statuses = _task_statuses(task_data_by_dir)
-
-    for dir_name, data in task_data_by_dir.items():
-        if data.get("assignee") == developer:
-            children_list = data.get("children", [])
-            done = _children_done_count(children_list, all_task_statuses)
-            my_tasks.append({
-                "dir": dir_name,
-                "title": data.get("title") or data.get("name") or "unknown",
-                "status": data.get("status", "unknown"),
-                "priority": data.get("priority", "P2"),
-                "children": children_list,
-                "childrenDone": done,
-                "parent": data.get("parent"),
-                "meta": data.get("meta", {}),
-            })
-
     active_task_snapshot = _get_active_task_snapshot(repo_root)
 
     return {
         "developer": developer or "",
         "git": _git_json(git_snapshot),
-        "myTasks": my_tasks,
+        "myTasks": _record_my_tasks_json(get_tasks_dir(repo_root), developer),
         "activeTask": _active_task_json(active_task_snapshot),
         "resumeChecklist": _build_resume_checklist(repo_root, active_task_snapshot),
     }
 
 
-def get_context_text_record(repo_root: Path | None = None) -> str:
-    """Get context as formatted text for session recording mode.
-
-    Focused output: MY ACTIVE TASKS first (with [!!!] emphasis),
-    then GIT STATUS, RECENT COMMITS, ACTIVE TASK.
-
-    Args:
-        repo_root: Repository root path. Defaults to auto-detected.
-
-    Returns:
-        Formatted text output for session recording.
-    """
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    lines: list[str] = []
-    lines.append("========================================")
-    lines.append("SESSION CONTEXT (RECORD MODE)")
-    lines.append("========================================")
-    lines.append("")
+def _record_my_tasks_json(tasks_dir: Path, developer: str | None) -> list[dict]:
+    """Build record-mode task list for JSON output."""
+    my_tasks = []
+    task_data_by_dir = _load_task_json_by_dir(tasks_dir)
+    all_task_statuses = _task_statuses(task_data_by_dir)
+    for dir_name, data in task_data_by_dir.items():
+        if data.get("assignee") != developer:
+            continue
+        children_list = data.get("children", [])
+        my_tasks.append({
+            "dir": dir_name,
+            "title": data.get("title") or data.get("name") or "unknown",
+            "status": data.get("status", "unknown"),
+            "priority": data.get("priority", "P2"),
+            "children": children_list,
+            "childrenDone": _children_done_count(children_list, all_task_statuses),
+            "parent": data.get("parent"),
+            "meta": data.get("meta", {}),
+        })
+    return my_tasks
 
-    developer = get_developer(repo_root)
-    if not developer:
-        lines.append(
-            f"ERROR: Not initialized. Run: ./{DIR_WORKFLOW}/run init-developer <name>"
-        )
-        return "\n".join(lines)
 
-    # MY ACTIVE TASKS - first and prominent
+def _append_record_my_tasks(
+    lines: list[str],
+    developer: str,
+    tasks_dir: Path,
+) -> None:
+    """Append prominent record-mode tasks assigned to the developer."""
     lines.append(f"## [!!!] MY ACTIVE TASKS (Assigned to {developer})")
     lines.append("[!] Review whether any should be archived before recording this session.")
     lines.append("")
 
-    tasks_dir = get_tasks_dir(repo_root)
     my_task_count = 0
-
-    # Collect task data for children progress
     task_data_by_dir = _load_task_json_by_dir(tasks_dir)
     all_task_statuses = _task_statuses(task_data_by_dir)
-
     for dir_name, data in task_data_by_dir.items():
-        assignee = data.get("assignee", "")
+        if data.get("assignee", "") != developer:
+            continue
+        title = data.get("title") or data.get("name") or "unknown"
+        priority = data.get("priority", "P2")
         status = data.get("status", "planning")
-
-        if assignee == developer:
-            title = data.get("title") or data.get("name") or "unknown"
-            priority = data.get("priority", "P2")
-            children_list = data.get("children", [])
-            progress = _children_progress(children_list, all_task_statuses)
-            lines.append(f"- [{priority}] {title} ({status}){progress} - {dir_name}")
-            my_task_count += 1
+        progress = _children_progress(data.get("children", []), all_task_statuses)
+        lines.append(f"- [{priority}] {title} ({status}){progress} - {dir_name}")
+        my_task_count += 1
 
     if my_task_count == 0:
         lines.append("(no active tasks assigned to you)")
     lines.append("")
 
+
+def _append_record_context_sections(lines: list[str], repo_root: Path) -> None:
     git_snapshot = _get_git_snapshot(repo_root)
     _append_git_status(lines, git_snapshot, repo_root)
     _append_recent_commits(lines, git_snapshot)
@@ -709,6 +717,32 @@ def get_context_text_record(repo_root: Path | None = None) -> str:
     _append_active_task(lines, active_task_snapshot)
     _append_resume_checklist(lines, repo_root, active_task_snapshot)
 
+
+def get_context_text_record(repo_root: Path | None = None) -> str:
+    """Get context as formatted text for session recording mode.
+
+    Focused output: MY ACTIVE TASKS first (with [!!!] emphasis),
+    then GIT STATUS, RECENT COMMITS, ACTIVE TASK.
+
+    Args:
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        Formatted text output for session recording.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    lines = _new_context_lines("SESSION CONTEXT (RECORD MODE)")
+    developer = get_developer(repo_root)
+    if not developer:
+        lines.append(
+            f"ERROR: Not initialized. Run: ./{DIR_WORKFLOW}/run init-developer <name>"
+        )
+        return "\n".join(lines)
+
+    _append_record_my_tasks(lines, developer, get_tasks_dir(repo_root))
+    _append_record_context_sections(lines, repo_root)
     lines.append("========================================")
 
     return "\n".join(lines)

package/template/.cowork-flow/scripts/common/host/__init__.py

@@ -0,0 +1 @@
+"""Shared host adapter runtime."""