issue-flow 0.4.2a2__tar.gz → 0.4.2a3__tar.gz

{issue_flow-0.4.2a2 → issue_flow-0.4.2a3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: issue-flow
-Version: 0.4.2a2
+Version: 0.4.2a3
 Summary: Agents should behave. Let them follow the issue flow.
 Keywords: cursor,ai,agents,issue-tracking,workflow
 Author: jepegit
@@ -55,6 +55,7 @@ your-project/
       iflow-yolo/SKILL.md
       iflow-fix/SKILL.md
       iflow-status/SKILL.md
+      iflow-archive/SKILL.md
       iflow-version-bump/SKILL.md
       iflow-history-update/SKILL.md
       iflow-graphify/SKILL.md
@@ -83,8 +84,9 @@ Plus a few off-path commands:
 - `/iflow-yolo` — all-in-one chain (`init → plan → start → close`) for small, low-risk issues, with up-front safeguards (refuses on the default branch, refuses with dirty unrelated changes, requires passing tests, single consolidated confirm).
 - `/iflow-fix` — interactive iterative-fixes session: creates one GitHub issue + long-lived branch, then loops over many small fixes (each gets a short plan, implemented only on confirmation and recorded in `issue<N>_status.md`), ending with `/iflow-close`. Coexists with `/iflow-pick fix` (the one-shot setup). Off-path; never auto-dispatched.
 - `/iflow-status` — **read-only** overview of where every issue stands: the local tracking state (focus / parked / solved) plus open GitHub issues cross-referenced against it. Pass `local` to skip the GitHub query. Changes nothing; off-path; never auto-dispatched.
+- `/iflow-archive` — **condense the solved archive (destructive, gated)**: summarises selected `issue<N>_*` groups under `03-solved-issues/` into a dated `YYYY-MM-DD_archived_issues.md` file. The summary records the pre-archive git ref so every original file stays recoverable (`git show <ref>:<path>`). Deletes the source files only after one consolidated confirm. Default: archive all but the **5 most recent** solved groups; pass `keep <K>`, an explicit list of issue numbers, or `all`. Requires a **clean working tree**. Off-path; never auto-dispatched.
 
-The **Agent Skills** under `.cursor/skills/` carry the workflows for on-demand use with `/iflow-pick`, `/iflow`, `/iflow-init`, `/iflow-plan`, `/iflow-start`, `/iflow-pause`, `/iflow-close`, `/iflow-cleanup`, `/iflow-yolo`, `/iflow-fix`, `/iflow-status`, `@iflow-version-bump` when you need only the bump steps, or `@iflow-history-update` when you need only the changelog update (see [Cursor Agent Skills](https://cursor.com/help/customization/skills)).
+The **Agent Skills** under `.cursor/skills/` carry the workflows for on-demand use with `/iflow-pick`, `/iflow`, `/iflow-init`, `/iflow-plan`, `/iflow-start`, `/iflow-pause`, `/iflow-close`, `/iflow-cleanup`, `/iflow-yolo`, `/iflow-fix`, `/iflow-status`, `/iflow-archive`, `@iflow-version-bump` when you need only the bump steps, or `@iflow-history-update` when you need only the changelog update (see [Cursor Agent Skills](https://cursor.com/help/customization/skills)).
 
 ## Prerequisites
 
@@ -123,6 +125,16 @@ with `issue-flow init --skip-dep-check` (the same flag is available on
 `issue-flow update`), and the prompt is also auto-skipped when stdin is not
 a TTY (e.g. CI pipelines).
 
+### Multi-root workspaces
+
+When one Cursor workspace contains **several sibling repositories** (each with its
+own `issue-flow init`), lifecycle commands must target the correct repo explicitly.
+Use slash hints (`root:<path>`, `repo:<folder-name>`, `repo:owner/name`), or run
+`issue-flow agent resolve [--from-file <active-file>] [--json]` before `git`/`gh`
+calls. See `.issueflows/04-designs-and-guides/multi-repo-workspaces.md` in
+scaffolded projects (or run `issue-flow update` to refresh scoped
+`issueflow-rules.mdc` files).
+
 ### Optional: graphify integration
 
 issue-flow has a lightweight integration with [graphify](https://iflow-graphify.net)
@@ -216,6 +228,7 @@ issue-flow status [PROJECT_DIR] [--local] [--json]
 issue-flow agent state [PROJECT_DIR] [--json]
 issue-flow agent preflight [PROJECT_DIR] [--json]
 issue-flow agent sweep [PROJECT_DIR] [--except N] [--dry-run] [--json]
+issue-flow agent archive N [N ...] [-C PROJECT_DIR] [--dry-run] [--json]
 issue-flow agent capture N [-C PROJECT_DIR] [--repo OWNER/REPO] [--force] [--json]
 ```
 
@@ -291,13 +304,15 @@ project never installs `issue-flow`.
 | `agent state`            | Resolve the focus issue (branch-derived number wins, else the single current group), its lifecycle stage (`init`/`plan`/`start`/`close`), and the suggested next command. |
 | `agent preflight`        | Branch hygiene report: default branch, clean/dirty working tree, ahead/behind vs `origin/<default>`, and a stale-branch flag when the issue is already archived. Runs `git fetch --prune` first. |
 | `agent sweep`            | Archive `issue<N>_*` groups out of `01-current-issues/` to `03-solved-issues/` (Done) or `02-partly-solved-issues/` (not Done). Use `--except N` to keep the focus issue and `--dry-run` to preview. |
+| `agent archive`          | Mechanical deletion half of `/iflow-archive`: remove the chosen groups' files from `03-solved-issues/` and report the pre-archive HEAD sha (for the recovery ref in the summary file). Summarising into `YYYY-MM-DD_archived_issues.md` stays agent-side. Refuses when a requested issue has no solved group. `--dry-run` to preview. |
 | `agent capture N`        | Fetch GitHub issue `N` with `gh` and write `issue<N>_original.md` (the `## Original issue text` body). Prints the comments payload so the agent can triage them; comment triage stays agent-side. Use `--repo`, `--force`, `-C`. |
 
 
 All `agent` commands accept `--json` and degrade gracefully: read-only commands
 never hard-fail when `git`/`gh` is missing (they return partial data with a
 note), while `agent capture` needs `gh` and exits non-zero with a hint when it
-is unavailable or the fetch fails.
+is unavailable or the fetch fails. `agent archive` needs a clean working tree
+and refuses when any requested issue has no files under `03-solved-issues/`.
 
 ### When to use which
 
@@ -310,6 +325,7 @@ is unavailable or the fetch fails.
 | Rebuild the graphify knowledge graph                                 | `issue-flow graphify`     |
 | See where every issue stands (focus / parked / solved / GitHub)      | `issue-flow status`       |
 | Let an agent resolve lifecycle state / sweep / capture deterministically | `issue-flow agent ...`    |
+| Condense old solved issues into a dated summary (recoverable via git) | `/iflow-archive` (summary is agent-written; `issue-flow agent archive …` for the delete step) |
 
 
 ## Modes
@@ -321,7 +337,7 @@ than you need. Two modes ship built in:
 | Mode | What you get |
 | --- | --- |
 | `standard` (default) | The full workflow: planning, PRs, history, cleanup, graphify, and all helpers. |
-| `simple` | A markdown-only lifecycle (capture, plan, implement, park, status). No PR/cleanup/yolo/fix/graphify automation. |
+| `simple` | A markdown-only lifecycle (capture, plan, implement, park, status, archive). No PR/cleanup/yolo/fix/graphify automation. Includes `/iflow-archive` for condensing a large `03-solved-issues/` folder. |
 
 ```bash
 issue-flow init --mode simple

{issue_flow-0.4.2a2 → issue_flow-0.4.2a3}/README.md

@@ -30,6 +30,7 @@ your-project/
       iflow-yolo/SKILL.md
       iflow-fix/SKILL.md
       iflow-status/SKILL.md
+      iflow-archive/SKILL.md
       iflow-version-bump/SKILL.md
       iflow-history-update/SKILL.md
       iflow-graphify/SKILL.md
@@ -58,8 +59,9 @@ Plus a few off-path commands:
 - `/iflow-yolo` — all-in-one chain (`init → plan → start → close`) for small, low-risk issues, with up-front safeguards (refuses on the default branch, refuses with dirty unrelated changes, requires passing tests, single consolidated confirm).
 - `/iflow-fix` — interactive iterative-fixes session: creates one GitHub issue + long-lived branch, then loops over many small fixes (each gets a short plan, implemented only on confirmation and recorded in `issue<N>_status.md`), ending with `/iflow-close`. Coexists with `/iflow-pick fix` (the one-shot setup). Off-path; never auto-dispatched.
 - `/iflow-status` — **read-only** overview of where every issue stands: the local tracking state (focus / parked / solved) plus open GitHub issues cross-referenced against it. Pass `local` to skip the GitHub query. Changes nothing; off-path; never auto-dispatched.
+- `/iflow-archive` — **condense the solved archive (destructive, gated)**: summarises selected `issue<N>_*` groups under `03-solved-issues/` into a dated `YYYY-MM-DD_archived_issues.md` file. The summary records the pre-archive git ref so every original file stays recoverable (`git show <ref>:<path>`). Deletes the source files only after one consolidated confirm. Default: archive all but the **5 most recent** solved groups; pass `keep <K>`, an explicit list of issue numbers, or `all`. Requires a **clean working tree**. Off-path; never auto-dispatched.
 
-The **Agent Skills** under `.cursor/skills/` carry the workflows for on-demand use with `/iflow-pick`, `/iflow`, `/iflow-init`, `/iflow-plan`, `/iflow-start`, `/iflow-pause`, `/iflow-close`, `/iflow-cleanup`, `/iflow-yolo`, `/iflow-fix`, `/iflow-status`, `@iflow-version-bump` when you need only the bump steps, or `@iflow-history-update` when you need only the changelog update (see [Cursor Agent Skills](https://cursor.com/help/customization/skills)).
+The **Agent Skills** under `.cursor/skills/` carry the workflows for on-demand use with `/iflow-pick`, `/iflow`, `/iflow-init`, `/iflow-plan`, `/iflow-start`, `/iflow-pause`, `/iflow-close`, `/iflow-cleanup`, `/iflow-yolo`, `/iflow-fix`, `/iflow-status`, `/iflow-archive`, `@iflow-version-bump` when you need only the bump steps, or `@iflow-history-update` when you need only the changelog update (see [Cursor Agent Skills](https://cursor.com/help/customization/skills)).
 
 ## Prerequisites
 
@@ -98,6 +100,16 @@ with `issue-flow init --skip-dep-check` (the same flag is available on
 `issue-flow update`), and the prompt is also auto-skipped when stdin is not
 a TTY (e.g. CI pipelines).
 
+### Multi-root workspaces
+
+When one Cursor workspace contains **several sibling repositories** (each with its
+own `issue-flow init`), lifecycle commands must target the correct repo explicitly.
+Use slash hints (`root:<path>`, `repo:<folder-name>`, `repo:owner/name`), or run
+`issue-flow agent resolve [--from-file <active-file>] [--json]` before `git`/`gh`
+calls. See `.issueflows/04-designs-and-guides/multi-repo-workspaces.md` in
+scaffolded projects (or run `issue-flow update` to refresh scoped
+`issueflow-rules.mdc` files).
+
 ### Optional: graphify integration
 
 issue-flow has a lightweight integration with [graphify](https://iflow-graphify.net)
@@ -191,6 +203,7 @@ issue-flow status [PROJECT_DIR] [--local] [--json]
 issue-flow agent state [PROJECT_DIR] [--json]
 issue-flow agent preflight [PROJECT_DIR] [--json]
 issue-flow agent sweep [PROJECT_DIR] [--except N] [--dry-run] [--json]
+issue-flow agent archive N [N ...] [-C PROJECT_DIR] [--dry-run] [--json]
 issue-flow agent capture N [-C PROJECT_DIR] [--repo OWNER/REPO] [--force] [--json]
 ```
 
@@ -266,13 +279,15 @@ project never installs `issue-flow`.
 | `agent state`            | Resolve the focus issue (branch-derived number wins, else the single current group), its lifecycle stage (`init`/`plan`/`start`/`close`), and the suggested next command. |
 | `agent preflight`        | Branch hygiene report: default branch, clean/dirty working tree, ahead/behind vs `origin/<default>`, and a stale-branch flag when the issue is already archived. Runs `git fetch --prune` first. |
 | `agent sweep`            | Archive `issue<N>_*` groups out of `01-current-issues/` to `03-solved-issues/` (Done) or `02-partly-solved-issues/` (not Done). Use `--except N` to keep the focus issue and `--dry-run` to preview. |
+| `agent archive`          | Mechanical deletion half of `/iflow-archive`: remove the chosen groups' files from `03-solved-issues/` and report the pre-archive HEAD sha (for the recovery ref in the summary file). Summarising into `YYYY-MM-DD_archived_issues.md` stays agent-side. Refuses when a requested issue has no solved group. `--dry-run` to preview. |
 | `agent capture N`        | Fetch GitHub issue `N` with `gh` and write `issue<N>_original.md` (the `## Original issue text` body). Prints the comments payload so the agent can triage them; comment triage stays agent-side. Use `--repo`, `--force`, `-C`. |
 
 
 All `agent` commands accept `--json` and degrade gracefully: read-only commands
 never hard-fail when `git`/`gh` is missing (they return partial data with a
 note), while `agent capture` needs `gh` and exits non-zero with a hint when it
-is unavailable or the fetch fails.
+is unavailable or the fetch fails. `agent archive` needs a clean working tree
+and refuses when any requested issue has no files under `03-solved-issues/`.
 
 ### When to use which
 
@@ -285,6 +300,7 @@ is unavailable or the fetch fails.
 | Rebuild the graphify knowledge graph                                 | `issue-flow graphify`     |
 | See where every issue stands (focus / parked / solved / GitHub)      | `issue-flow status`       |
 | Let an agent resolve lifecycle state / sweep / capture deterministically | `issue-flow agent ...`    |
+| Condense old solved issues into a dated summary (recoverable via git) | `/iflow-archive` (summary is agent-written; `issue-flow agent archive …` for the delete step) |
 
 
 ## Modes
@@ -296,7 +312,7 @@ than you need. Two modes ship built in:
 | Mode | What you get |
 | --- | --- |
 | `standard` (default) | The full workflow: planning, PRs, history, cleanup, graphify, and all helpers. |
-| `simple` | A markdown-only lifecycle (capture, plan, implement, park, status). No PR/cleanup/yolo/fix/graphify automation. |
+| `simple` | A markdown-only lifecycle (capture, plan, implement, park, status, archive). No PR/cleanup/yolo/fix/graphify automation. Includes `/iflow-archive` for condensing a large `03-solved-issues/` folder. |
 
 ```bash
 issue-flow init --mode simple

{issue_flow-0.4.2a2 → issue_flow-0.4.2a3}/pyproject.toml

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

{issue_flow-0.4.2a2 → issue_flow-0.4.2a3}/src/issue_flow/agent.py

@@ -1,8 +1,8 @@
 """Orchestrators behind the agent-facing CLI surface.
 
 These functions back ``issue-flow status`` (human-facing, top-level) and the
-``issue-flow agent ...`` sub-commands (``state`` / ``preflight`` / ``sweep`` /
-``capture``) that exist so AI agents can ask the tool for a deterministic
+``issue-flow agent ...`` sub-commands (``state`` / ``preflight`` / ``resolve`` /
+``sweep`` / ``capture``) that exist so AI agents can ask the tool for a deterministic
 answer instead of re-deriving lifecycle state by hand on every run.
 
 Each ``run_*`` returns a process exit code and emits either a short human
@@ -21,7 +21,7 @@ from typing import Any
 from rich.console import Console
 from rich.markup import escape
 
-from issue_flow import gitutils, modes, tracking
+from issue_flow import gitutils, modes, project, tracking
 from issue_flow.config import Settings
 
 
@@ -173,6 +173,83 @@ def run_preflight(project_root: Path, console: Console, as_json: bool) -> int:
     return 0
 
 
+# ---------------------------------------------------------------------------
+# agent resolve
+# ---------------------------------------------------------------------------
+
+
+def run_resolve(
+    project_root: Path,
+    console: Console,
+    from_file: Path | None,
+    as_json: bool,
+) -> int:
+    """Resolve the issue-flow project root, GitHub repo slug, and branch context."""
+    settings = Settings()
+    start = from_file if from_file is not None else project_root
+    resolved = project.find_project_root(
+        start,
+        issueflows_dir=settings.issueflows_dir,
+        current_issues_folder=settings.current_issues_folder,
+    )
+    if resolved is None and from_file is not None:
+        resolved = project.find_project_root(
+            project_root,
+            issueflows_dir=settings.issueflows_dir,
+            current_issues_folder=settings.current_issues_folder,
+        )
+
+    repo: str | None = None
+    branch: str | None = None
+    default_branch: str | None = None
+    sibling_roots: list[str] = []
+
+    if resolved is not None:
+        owner_repo = gitutils.remote_owner_repo(resolved)
+        if owner_repo:
+            repo = f"{owner_repo[0]}/{owner_repo[1]}"
+        if gitutils.git_available():
+            branch = gitutils.current_branch(resolved)
+            default_branch = gitutils.default_branch(resolved)
+        sibling_roots = project.list_scaffolded_siblings(
+            resolved, issueflows_dir=settings.issueflows_dir
+        )
+
+    payload: dict[str, Any] = {
+        "project_root": str(resolved) if resolved else None,
+        "repo": repo,
+        "branch": branch,
+        "default_branch": default_branch,
+        "issueflows_dir": settings.issueflows_dir,
+        "sibling_roots": sibling_roots,
+    }
+
+    if as_json:
+        _emit_json(console, payload)
+        return 0 if resolved is not None else 1
+
+    if resolved is None:
+        console.print(
+            "[red]No issue-flow scaffold found[/red] walking up from "
+            f"{start.resolve()}."
+        )
+        return 1
+
+    console.print(f"[bold]Project root[/bold]: {resolved}")
+    if repo:
+        console.print(f"[bold]Repo[/bold]: {repo}")
+    if branch:
+        console.print(f"[bold]Branch[/bold]: {branch}")
+    if default_branch:
+        console.print(f"[bold]Default branch[/bold]: {default_branch}")
+    if sibling_roots:
+        console.print(
+            f"[bold]Sibling scaffolds[/bold]: {len(sibling_roots)} "
+            "(run lifecycle commands once per repo)"
+        )
+    return 0
+
+
 # ---------------------------------------------------------------------------
 # agent sweep
 # ---------------------------------------------------------------------------
@@ -226,6 +303,89 @@ def run_sweep(
     return 0
 
 
+# ---------------------------------------------------------------------------
+# agent archive
+# ---------------------------------------------------------------------------
+
+
+def run_archive(
+    project_root: Path,
+    console: Console,
+    issues: list[int],
+    dry_run: bool,
+    as_json: bool,
+) -> int:
+    """Delete the named solved issue groups (the mechanical half of archiving).
+
+    Summarising the issues into the dated archive file is interpretive and
+    stays agent-side; this command only removes the ``issue<N>_*`` files from
+    the solved folder and reports the pre-archive HEAD sha so the summaries
+    can record a recovery point. Refuses (exit 1) when any requested issue has
+    no group in the solved folder, so a typo never silently archives less
+    than the user confirmed.
+    """
+    settings = Settings()
+    folders = _folders(project_root, settings)
+
+    moves, missing = tracking.plan_archive(folders["solved"], issues)
+    sha = gitutils.head_sha(project_root)
+
+    if missing:
+        msg = (
+            "no files found in "
+            f"{settings.solved_folder} for issue(s) "
+            f"{', '.join(f'#{n}' for n in missing)}; nothing was archived."
+        )
+        if as_json:
+            _emit_json(
+                console,
+                {"archived": False, "missing": missing, "error": msg},
+            )
+        else:
+            console.print(f"[red]error[/red]  {msg}")
+        return 1
+
+    removed: list[Path] = []
+    if not dry_run and moves:
+        removed = tracking.apply_archive(moves)
+
+    payload = {
+        "dry_run": dry_run,
+        "head_sha": sha,
+        "issues": [
+            {
+                "issue": m.number,
+                "title": m.title,
+                "files": [p.name for p in m.files],
+            }
+            for m in moves
+        ],
+        "removed": [p.name for p in removed],
+    }
+
+    if as_json:
+        _emit_json(console, payload)
+        return 0
+
+    if not moves:
+        console.print("[dim]Nothing to archive.[/dim]")
+        return 0
+    if sha:
+        console.print(f"Pre-archive HEAD: [bold]{sha}[/bold]")
+    verb = "Would remove" if dry_run else "Removed"
+    for m in moves:
+        title = f" — {escape(m.title)}" if m.title else ""
+        console.print(
+            f"  {verb} #{m.number}{title}: {', '.join(p.name for p in m.files)}"
+        )
+    if not dry_run:
+        console.print(
+            "  [dim]Write the summaries into the dated archive file and "
+            "commit so the pre-archive sha stays meaningful.[/dim]"
+        )
+    return 0
+
+
 # ---------------------------------------------------------------------------
 # agent capture
 # ---------------------------------------------------------------------------
@@ -289,9 +449,7 @@ def run_capture(
     if target.exists() and not force:
         msg = f"{target} already exists; pass --force to overwrite."
         if as_json:
-            _emit_json(
-                console, {"written": False, "path": str(target), "error": msg}
-            )
+            _emit_json(console, {"written": False, "path": str(target), "error": msg})
         else:
             console.print(f"[yellow]exists[/yellow]  {msg}")
         return 1
@@ -352,6 +510,11 @@ def _print_config_guide(console: Console, cfg_path: Path) -> None:
         "labels pick the flow (e.g. a 'yolo' label runs /iflow-yolo); re-run "
         "'issue-flow update' so the commands re-render.[/dim]"
     )
+    console.print(
+        "  [dim]- [bold]step_directives[/bold] / [bold]model_label_flows[/bold]: "
+        "bake MODEL & EXECUTION DIRECTIVE sections into lifecycle skills; optional "
+        "label hints during /iflow-pick; re-run 'issue-flow update' after changing.[/dim]"
+    )
     console.print(
         "  [dim]Other ISSUEFLOW_* settings are environment-only (set them in "
         ".env), not in config.toml.[/dim]"
@@ -363,7 +526,7 @@ def run_config_add(
 ) -> int:
     """Create ``.issueflows/config.toml`` seeded from ``.env`` or defaults.
 
-    Writes the six ``[issueflow]`` keys issue-flow reads from ``config.toml``.
+    Writes the ``[issueflow]`` keys issue-flow reads from ``config.toml``.
     Refuses to clobber an existing file unless ``force`` is set (which upserts
     those keys while preserving other content).
     """
@@ -410,9 +573,7 @@ def run_config_add(
 # ---------------------------------------------------------------------------
 
 
-def run_status(
-    project_root: Path, console: Console, local: bool, as_json: bool
-) -> int:
+def run_status(project_root: Path, console: Console, local: bool, as_json: bool) -> int:
     """Read-only overview: focus stage, parked, solved, optional GitHub cross-ref."""
     settings = Settings()
     folders = _folders(project_root, settings)
@@ -432,8 +593,7 @@ def run_status(
 
     parked_groups = tracking.group_issue_files(folders["partly"])
     parked = [
-        {"number": n, "title": g.title()}
-        for n, g in sorted(parked_groups.items())
+        {"number": n, "title": g.title()} for n, g in sorted(parked_groups.items())
     ]
     solved_numbers = sorted(tracking.group_issue_files(folders["solved"]))
 
@@ -459,9 +619,7 @@ def run_status(
     return 0
 
 
-def _github_section(
-    project_root: Path, folders: dict[str, Path]
-) -> dict[str, Any]:
+def _github_section(project_root: Path, folders: dict[str, Path]) -> dict[str, Any]:
     """Cross-reference open GitHub issues against local tracking folders."""
     if not gitutils.gh_available():
         return {"available": False, "reason": "gh not on PATH"}
@@ -534,9 +692,7 @@ def _render_status_text(
     if github is None:
         pass
     elif not github.get("available"):
-        console.print(
-            f"[bold]GitHub[/bold]: unavailable ({github.get('reason')})"
-        )
+        console.print(f"[bold]GitHub[/bold]: unavailable ({github.get('reason')})")
     else:
         console.print(
             f"[bold]GitHub[/bold]: {github['open_count']} open "

{issue_flow-0.4.2a2 → issue_flow-0.4.2a3}/src/issue_flow/cli.py

@@ -162,9 +162,7 @@ def update(
     """Refresh packaged editor commands, rules, and workflow doc from this package."""
     from issue_flow.init import run_update
 
-    run_update(
-        project_root=project_dir, skip_dep_check=skip_dep_check, editors=editor
-    )
+    run_update(project_root=project_dir, skip_dep_check=skip_dep_check, editors=editor)
 
 
 @app.command(
@@ -257,6 +255,36 @@ def agent_preflight(
     raise typer.Exit(code=run_preflight(project_dir, _console, json_output))
 
 
+@agent_app.command("resolve")
+def agent_resolve(
+    project_dir: Path = typer.Option(
+        Path("."),
+        "--project-dir",
+        "-C",
+        help="Directory to start the scaffold walk from (defaults to cwd).",
+        exists=True,
+        file_okay=True,
+        resolve_path=True,
+    ),
+    from_file: Path | None = typer.Option(
+        None,
+        "--from-file",
+        help="Start the walk from this file's directory (e.g. the active editor file).",
+        exists=True,
+        file_okay=True,
+        dir_okay=False,
+        resolve_path=True,
+    ),
+    json_output: bool = typer.Option(
+        False, "--json", help="Emit a machine-readable JSON object."
+    ),
+) -> None:
+    """Resolve project root, owner/repo, branch, and sibling scaffolds."""
+    from issue_flow.agent import run_resolve
+
+    raise typer.Exit(code=run_resolve(project_dir, _console, from_file, json_output))
+
+
 @agent_app.command("sweep")
 def agent_sweep(
     project_dir: Path = _PROJECT_DIR_ARGUMENT,
@@ -281,6 +309,42 @@ def agent_sweep(
     )
 
 
+@agent_app.command("archive")
+def agent_archive(
+    issues: list[int] = typer.Argument(
+        ...,
+        help="Solved issue number(s) whose files should be removed.",
+    ),
+    project_dir: Path = typer.Option(
+        Path("."),
+        "--project-dir",
+        "-C",
+        help="Project root directory (defaults to current directory).",
+        exists=True,
+        file_okay=False,
+        resolve_path=True,
+    ),
+    dry_run: bool = typer.Option(
+        False, "--dry-run", help="Show planned removals without touching files."
+    ),
+    json_output: bool = typer.Option(
+        False, "--json", help="Emit a machine-readable JSON object."
+    ),
+) -> None:
+    """Remove solved issue<N>_* files (the mechanical half of /iflow-archive).
+
+    Reports the pre-archive HEAD sha so the agent-written summary file can
+    record a recovery point (``git show <sha>:<path>``). Summarising the
+    issues into the dated archive file is left to the agent. Refuses when a
+    requested issue has no files in the solved folder.
+    """
+    from issue_flow.agent import run_archive
+
+    raise typer.Exit(
+        code=run_archive(project_dir, _console, issues, dry_run, json_output)
+    )
+
+
 @agent_app.command("capture")
 def agent_capture(
     number: int = typer.Argument(..., help="GitHub issue number to capture."),
@@ -336,11 +400,13 @@ def config_add(
 ) -> None:
     """Create .issueflows/config.toml, seeded from .env (or issue-flow defaults).
 
-    Writes the six keys issue-flow reads from config.toml — ``mode``,
-    ``skill_level``, ``caveman_default``, ``grill_me_default``, ``label_flows``,
-    ``yolo_label`` — taking each from its ``ISSUEFLOW_*`` env var when set, else
-    the default. Other ``ISSUEFLOW_*`` settings are environment-only and are not
-    written here. Existing files are left untouched unless ``--force`` is passed.
+    Writes the ``[issueflow]`` keys issue-flow reads from ``config.toml`` —
+    ``mode``, ``skill_level``, ``caveman_default``, ``grill_me_default``,
+    ``label_flows``, ``yolo_label``, ``step_directives``, ``model_label_flows``,
+    ``deep_model_label``, ``fast_model_label`` — taking each from its
+    ``ISSUEFLOW_*`` env var when set, else the default. Other ``ISSUEFLOW_*``
+    settings are environment-only and are not written here. Existing files are
+    left untouched unless ``--force`` is passed.
     """
     from issue_flow.agent import run_config_add