issue-flow 0.4.4.post1__tar.gz → 0.4.4.post3__tar.gz

{issue_flow-0.4.4.post1 → issue_flow-0.4.4.post3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: issue-flow
-Version: 0.4.4.post1
+Version: 0.4.4.post3
 Summary: Agents should behave. Let them follow the issue flow.
 Keywords: cursor,ai,agents,issue-tracking,workflow
 Author: jepegit
@@ -33,6 +33,14 @@ Agents should behave. Let them follow the issue flow.
 
 **Full documentation:** <https://issue-flow.readthedocs.io/>
 
+
+## Why use it
+
+I guess it is just a matter of taste. If you are familiar with coding using agents and harnesses, `issue-flow` could very well slow you down. But...
+
+Maybe that is a good thing?
+
+
 ## What it does
 
 Running `issue-flow init` in your project root creates:
@@ -46,6 +54,7 @@ your-project/
     03-solved-issues/        # Completed issues archive
     04-designs-and-guides/   # Durable project context and decisions
       this-project.md        # Hand-editable project brief (created if missing)
+    05-epics/               # Staged epic plans (epic<N>_plan.md)
   .cursor/
     skills/                  # Agent Skills (/iflow, /iflow-pick, /iflow-init,
                              # /iflow-plan, /iflow-start, /iflow-close, ...)

{issue_flow-0.4.4.post1 → issue_flow-0.4.4.post3}/README.md

@@ -6,6 +6,14 @@ Agents should behave. Let them follow the issue flow.
 
 **Full documentation:** <https://issue-flow.readthedocs.io/>
 
+
+## Why use it
+
+I guess it is just a matter of taste. If you are familiar with coding using agents and harnesses, `issue-flow` could very well slow you down. But...
+
+Maybe that is a good thing?
+
+
 ## What it does
 
 Running `issue-flow init` in your project root creates:
@@ -19,6 +27,7 @@ your-project/
     03-solved-issues/        # Completed issues archive
     04-designs-and-guides/   # Durable project context and decisions
       this-project.md        # Hand-editable project brief (created if missing)
+    05-epics/               # Staged epic plans (epic<N>_plan.md)
   .cursor/
     skills/                  # Agent Skills (/iflow, /iflow-pick, /iflow-init,
                              # /iflow-plan, /iflow-start, /iflow-close, ...)

{issue_flow-0.4.4.post1 → issue_flow-0.4.4.post3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "issue-flow"
-version = "0.4.4.post1"
+version = "0.4.4.post3"
 description = "Agents should behave. Let them follow the issue flow."
 readme = "README.md"
 license = "MIT"

{issue_flow-0.4.4.post1 → issue_flow-0.4.4.post3}/src/issue_flow/agent.py

@@ -1048,6 +1048,128 @@ def run_workspace_init(
     return 0
 
 
+def run_workspace_update(
+    workspace_dir: Path,
+    console: Console,
+    skip_dep_check: bool,
+    editors: list[str] | None,
+    as_json: bool,
+) -> int:
+    """Refresh issue-flow scaffolds in every scaffolded workspace member.
+
+    Discovers ``issueflow-workspace.toml`` above ``workspace_dir``, runs
+    :func:`issue_flow.init.run_update` on each member that carries a
+    ``.issueflows/`` tree, and aggregates per-member success. One dependency
+    check runs up front (unless ``skip_dep_check``); individual member
+  failures do not abort the rest.
+    """
+    import typer
+
+    from issue_flow.init import _dependency_gate, run_update
+
+    start = workspace_dir.resolve()
+    workspace = project.discover_workspace(start)
+
+    def _fail(msg: str) -> int:
+        if as_json:
+            _emit_json(
+                console,
+                {
+                    "ok": False,
+                    "error": msg,
+                    "workspace_root": None,
+                    "members": [],
+                    "ok_count": 0,
+                    "fail_count": 0,
+                },
+            )
+        else:
+            console.print(f"[red]error[/red]  {msg}")
+        return 1
+
+    if workspace is None:
+        return _fail(
+            f"no {project.WORKSPACE_FILENAME} found above {start} — run "
+            f"`issue-flow workspace init` from the workspace root first."
+        )
+
+    member_roots = workspace.member_roots()
+    if not member_roots:
+        return _fail(
+            f"no scaffolded member repos found under {workspace.root} — run "
+            "`issue-flow init` inside the member repos first."
+        )
+
+    if not skip_dep_check and not _dependency_gate(skip_dep_check=False):
+        return 1
+
+    import issue_flow.init as init_module
+
+    def _run_member_update(root: Path) -> None:
+        if as_json:
+            saved = init_module.console
+            init_module.console = Console(quiet=True)
+            try:
+                run_update(root, skip_dep_check=True, editors=editors)
+            finally:
+                init_module.console = saved
+        else:
+            run_update(root, skip_dep_check=True, editors=editors)
+
+    if not as_json:
+        console.print(
+            f"\n[bold]Updating issue-flow scaffolds in workspace "
+            f"[cyan]{workspace.root}[/cyan][/bold]"
+        )
+        console.print(f"[dim]{len(member_roots)} member(s)[/dim]\n")
+
+    results: list[dict[str, Any]] = []
+    ok_count = 0
+    fail_count = 0
+
+    for name, root in zip(workspace.members, member_roots, strict=True):
+        entry: dict[str, Any] = {"name": name, "path": str(root)}
+        try:
+            _run_member_update(root)
+            entry["ok"] = True
+            ok_count += 1
+        except typer.Exit as exc:
+            entry["ok"] = False
+            entry["error"] = f"update failed (exit {exc.exit_code})"
+            fail_count += 1
+        results.append(entry)
+
+    payload = {
+        "ok": fail_count == 0,
+        "workspace_root": str(workspace.root),
+        "members": results,
+        "ok_count": ok_count,
+        "fail_count": fail_count,
+    }
+
+    if as_json:
+        _emit_json(console, payload)
+        return 0 if fail_count == 0 else 1
+
+    console.print()
+    if fail_count == 0:
+        console.print(
+            f"[bold green]Updated {ok_count}/{len(member_roots)} member(s).[/bold green]"
+        )
+    else:
+        console.print(
+            f"[bold yellow]Updated {ok_count}/{len(member_roots)} member(s); "
+            f"{fail_count} failed.[/bold yellow]"
+        )
+        for entry in results:
+            if not entry.get("ok"):
+                console.print(
+                    f"  [red]fail[/red]  {escape(entry['name'])}: "
+                    f"{escape(str(entry.get('error', 'unknown error')))}"
+                )
+    return 0 if fail_count == 0 else 1
+
+
 # ---------------------------------------------------------------------------
 # agent sweep
 # ---------------------------------------------------------------------------

{issue_flow-0.4.4.post1 → issue_flow-0.4.4.post3}/src/issue_flow/cli.py

@@ -599,6 +599,52 @@ def workspace_init(
     )
 
 
+@workspace_app.command("update")
+def workspace_update(
+    workspace_dir: Path = typer.Argument(
+        default=Path("."),
+        help=(
+            "Workspace root directory — the folder that contains the member "
+            "repos (defaults to current directory)."
+        ),
+        exists=True,
+        file_okay=False,
+        resolve_path=True,
+    ),
+    skip_dep_check: bool = typer.Option(
+        False,
+        "--skip-dep-check",
+        help=(
+            "Skip the external-CLI dependency check (git, gh) and the "
+            "confirmation prompt that follows if anything is missing."
+        ),
+    ),
+    editor: list[str] = typer.Option(
+        ["cursor"],
+        "--editor",
+        "-e",
+        help=_EDITOR_HELP,
+    ),
+    json_output: bool = typer.Option(
+        False, "--json", help="Emit a machine-readable JSON object."
+    ),
+) -> None:
+    """Refresh packaged scaffolds in every scaffolded workspace member.
+
+    Walks up from ``workspace_dir`` for ``issueflow-workspace.toml``, then
+    runs ``issue-flow update`` in each member repo that carries a
+    ``.issueflows/`` tree. Per-member ``mode`` and ``skill_level`` come from
+    each repo's own ``config.toml``.
+    """
+    from issue_flow.agent import run_workspace_update
+
+    raise typer.Exit(
+        code=run_workspace_update(
+            workspace_dir, _console, skip_dep_check, editor, json_output
+        )
+    )
+
+
 app.add_typer(agent_app)
 app.add_typer(config_app)
 app.add_typer(workspace_app)

{issue_flow-0.4.4.post1 → issue_flow-0.4.4.post3}/src/issue_flow/templates/rules/_body.md.j2

@@ -80,6 +80,8 @@ If the project uses something else, use whatever it documents (e.g. activate its
         {{ partly_solved_folder }}/
         {{ solved_folder }}/
         {{ designs_folder }}/
+        {{ epics_folder }}/
+            epicXX_plan.md
     pyproject.toml
     readme.md
     ...