taskflow-git 0.3.0__tar.gz → 0.3.3__tar.gz

taskflow_git-0.3.3/.taskflow/backlog/0-now.md

@@ -0,0 +1,5 @@
+# Now
+
+Tasks actively being executed this week.
+
+---

taskflow_git-0.3.3/.taskflow/backlog/1-blocked.md

@@ -0,0 +1,23 @@
+# Blocked
+
+Tasks waiting on something external.
+
+Note what's blocking each one.
+
+---
+
+### 🔵 Engineering
+
+---
+
+### 🔴 Operations
+
+---
+
+### 🟡 Product
+
+---
+
+### ⚫ Business
+
+---

taskflow_git-0.3.3/.taskflow/backlog/2-paused.md

@@ -0,0 +1,23 @@
+# Paused
+
+Tasks deliberately on hold.
+
+Not blocked, not forgotten — just not now.
+
+---
+
+### 🔵 Engineering
+
+---
+
+### 🔴 Operations
+
+---
+
+### 🟡 Product
+
+---
+
+### ⚫ Business
+
+---

taskflow_git-0.3.3/.taskflow/backlog/3-next.md

@@ -0,0 +1,5 @@
+# Next
+
+Planned work queued for the next execution window.
+
+---

taskflow_git-0.3.3/.taskflow/backlog/4-later.md

@@ -0,0 +1,47 @@
+# Later
+
+Longer-horizon work organised by phase.
+
+Promote to next when the time is right:
+
+```
+taskflow promote "task text"
+```
+
+---
+
+## Phase 1 — Foundation
+
+> Core work needed to get started.
+
+### 🔵 Engineering
+
+### 🔴 Operations
+
+### 🟡 Product
+
+---
+
+## Phase 2 — Build
+
+> Main execution phase.
+
+### 🔵 Engineering
+
+### 🔴 Operations
+
+### 🟡 Product
+
+---
+
+## Phase 3 — Growth
+
+> Expansion and refinement.
+
+### 🔵 Engineering
+
+### 🔴 Operations
+
+### 🟡 Product
+
+---

taskflow_git-0.3.3/.taskflow/backlog/done.md

@@ -0,0 +1,11 @@
+# Done
+
+Completed tasks, appended by `taskflow done`.
+
+---
+
+## Week of 2026-03-30
+
+[2026-03-30 18:58:41] done: (Engineering) - fix init worlflow to handle situations when a git repo doesn't exist yet
+[2026-03-30 19:26:09] done: (Engineering) - Fix multi word quoting issues where there are tickes and other quote-like chars
+[2026-03-30 19:26:17] done: (Engineering) - move init defaults to `.taskflow` dir

taskflow_git-0.3.3/.taskflow.yml

@@ -0,0 +1,70 @@
+# .taskflow.yml
+# Run `taskflow setup` after editing to regenerate your backlog.
+# All sections except categories and phases are optional.
+
+# ---------------------------------------------------------------------------
+# States — file paths and terminal icons for each task state.
+# Paths are relative to this file unless absolute.
+# Remove this section entirely to use the defaults shown here.
+# ---------------------------------------------------------------------------
+
+states:
+  now:
+    file: ".taskflow/backlog/0-now.md"
+    icon: "▶"
+  blocked:
+    file: ".taskflow/backlog/1-blocked.md"
+    icon: "⊘"
+  paused:
+    file: ".taskflow/backlog/2-paused.md"
+    icon: "⏸"
+  next:
+    file: ".taskflow/backlog/3-next.md"
+    icon: "◈"
+  later:
+    file: ".taskflow/backlog/4-later.md"
+    icon: "◇"
+  done:
+    file: ".taskflow/backlog/done.md"
+    icon: "✓"
+
+# ---------------------------------------------------------------------------
+# Categories — define whatever makes sense for your project.
+# Icons are optional. Colored circles work well: 🔴 🟠 🟡 🟢 🔵 🟣 ⚫ ⚪ 🟤
+# ---------------------------------------------------------------------------
+
+categories:
+  - name: Engineering
+    icon: "🔵"
+    aliases: []
+
+  - name: Operations
+    icon: "🔴"
+    aliases: []
+
+  - name: Product
+    icon: "🟡"
+    aliases: []
+
+
+# ---------------------------------------------------------------------------
+# Phases — organise 4-later.md into planning horizons.
+# No effect on any other backlog file.
+# ---------------------------------------------------------------------------
+
+phases:
+  - name: "Next Up"
+    description: "Tasks that are important and should be done soon. These are the things you want to do after finishing your current work."
+  - name: "Ongoing Tinkering"
+    description: "Tasks that are interesting but not a priority. These are the things you want to do if you have free time, but they don't need to be done soon."
+
+# ---------------------------------------------------------------------------
+# Settings
+# ---------------------------------------------------------------------------
+
+settings:
+  repo_name: "taskflow"
+  done_weeks: 4
+  weekly_plan_dir: ".taskflow/changelog/weekly"
+  # archive_path defaults to backlog/archive/ — uncomment to override
+  archive_path: ".taskflow/backlog/archive"

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: taskflow-git
-Version: 0.3.0
+Version: 0.3.3
 Summary: Git-native task management for people who live in the terminal.
 Project-URL: Homepage, https://github.com/quorum-systems/taskflow
 Project-URL: Repository, https://github.com/quorum-systems/taskflow

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "taskflow-git"
-version = "0.3.0"
+version = "0.3.3"
 description = "Git-native task management for people who live in the terminal."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -66,4 +66,4 @@ target-version = "py311"
 
 [tool.ruff.lint]
 select = ["E", "F", "I"]
-ignore = ["E741"]
+ignore = ["E741"]

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/src/taskflow/cli.py

@@ -110,13 +110,7 @@ def main() -> None:
 
 
 @main.command()
-@click.option(
-    "--from",
-    "from_url",
-    default=None,
-    metavar="URL",
-    help="Fetch starter config from a URL instead of using the built-in template.",
-)
+@click.option("--from", "from_url", default=None, metavar="URL", help="Fetch starter config from a URL instead of using the built-in template.")
 @click.option("--name", default=None, help="Project name (defaults to current directory name).")
 def init(from_url: Optional[str], name: Optional[str]) -> None:
     """Set up a new taskflow project in the current directory."""
@@ -145,6 +139,27 @@ def init(from_url: Optional[str], name: Optional[str]) -> None:
     config_path.write_text(content, encoding="utf-8")
     click.echo(f"  created {config_path.name}")
 
+    # initialize git if we're not already in a repo — taskflow without git
+    # is half the point, so just handle it
+    git_root = None
+    try:
+        result = subprocess.check_output(
+            ["git", "rev-parse", "--show-toplevel"],
+            cwd=str(cwd),
+            text=True,
+            stderr=subprocess.DEVNULL,
+        ).strip()
+        git_root = Path(result)
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        pass
+
+    if git_root is None:
+        try:
+            subprocess.run(["git", "init"], cwd=str(cwd), check=True, capture_output=True)
+            click.echo("  git init")
+        except (subprocess.CalledProcessError, FileNotFoundError):
+            click.echo("  note: git not found — skipping git init and alias installation", err=True)
+
     # load and run setup immediately
     cfg = load_config(cwd)
     run_setup(cfg, force=False, dry_run=False)
@@ -354,6 +369,65 @@ def add(state: str, category: str, task: tuple) -> None:
     git_commit([target_rel], f"add ({state}): {query}", cfg.root)
 
 
+# ---------------------------------------------------------------------------
+# list
+# ---------------------------------------------------------------------------
+
+
+@main.command("list")
+@click.argument("state", default="now", type=click.Choice(["now", "next", "later", "blocked", "paused"]))
+def list_tasks(state: str) -> None:
+    """
+    List tasks in a state. Defaults to 'now'.
+
+    \b
+    taskflow list           # tasks in now
+    taskflow list next      # tasks queued up
+    taskflow list blocked   # what's stuck
+    """
+
+    from taskflow.tasklib import CATEGORY_RE, PHASE_RE, TASK_RE
+
+    cfg = load_config()
+    path = cfg.state_path(state)
+    icon = cfg.state_icon(state)
+
+    if not path.exists():
+        click.echo(f"\n  {icon} {state}  (empty)\n")
+        return
+
+    lines = path.read_text(encoding="utf-8").splitlines()
+    current = None
+    printed = set()  # track which categories we've printed headings for
+    any_task = False
+
+    click.echo(f"\n  {icon} {state}\n")
+    for line in lines:
+        if PHASE_RE.match(line):
+            phase = line.lstrip("#").strip()
+            click.echo(f"  ── {phase}")
+            continue
+        m = CATEGORY_RE.match(line)
+        if m:
+            current = m.group(1).strip()  # canonical name (emoji stripped)
+            continue
+        t = TASK_RE.match(line)
+        if t:
+            if current and current not in printed and not line.startswith("  "):
+                cat_icon = cfg.category_icon(current)
+                label = f"{cat_icon} {current}".strip() if cat_icon else current
+                click.echo(f"  {label}")
+                printed.add(current)
+            indent = "      " if line.startswith("  ") else "    "
+            click.echo(f"{indent}· {t.group(3)}")
+            if not line.startswith("  "):
+                any_task = True
+
+    if not any_task:
+        click.echo("    (empty)")
+    click.echo()
+
+
 # ---------------------------------------------------------------------------
 # status
 # ---------------------------------------------------------------------------

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/src/taskflow/config.py

@@ -18,12 +18,12 @@ CONFIG_FILE = ".taskflow.yml"
 
 # defaults used when states section is missing or partially specified
 STATE_DEFAULTS: dict[str, dict] = {
-    "now": {"file": "backlog/0-now.md", "icon": "▶"},
-    "blocked": {"file": "backlog/1-blocked.md", "icon": "⊘"},
-    "paused": {"file": "backlog/2-paused.md", "icon": "⏸"},
-    "next": {"file": "backlog/3-next.md", "icon": "◈"},
-    "later": {"file": "backlog/4-later.md", "icon": "◇"},
-    "done": {"file": "backlog/done.md", "icon": "✓"},
+    "now": {"file": ".taskflow/backlog/0-now.md", "icon": "▶"},
+    "blocked": {"file": ".taskflow/backlog/1-blocked.md", "icon": "⊘"},
+    "paused": {"file": ".taskflow/backlog/2-paused.md", "icon": "⏸"},
+    "next": {"file": ".taskflow/backlog/3-next.md", "icon": "◈"},
+    "later": {"file": ".taskflow/backlog/4-later.md", "icon": "◇"},
+    "done": {"file": ".taskflow/backlog/done.md", "icon": "✓"},
 }
 
 # the order transitions are defined matters for help text and validation
@@ -126,7 +126,7 @@ class TaskflowConfig:
 
     @property
     def weekly_plan_dir(self) -> Path:
-        d = self._data.get("settings", {}).get("weekly_plan_dir", "changelog/weekly")
+        d = self._data.get("settings", {}).get("weekly_plan_dir", ".taskflow/changelog/weekly")
         p = Path(d)
         return p if p.is_absolute() else self.root / p
 
@@ -137,8 +137,8 @@ class TaskflowConfig:
 
     @property
     def archive_path(self) -> Path:
-        """Where archived week files live. Defaults next to the done file."""
-        default_archive = str(self.state_path("done").parent / "archive")
+        """Where archived week files live. Defaults inside .taskflow/backlog/archive/."""
+        default_archive = ".taskflow/backlog/archive"
         d = self._data.get("settings", {}).get("archive_path", default_archive)
         p = Path(d)
         return p if p.is_absolute() else self.root / p

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/src/taskflow/setup_cmd.py

@@ -1,16 +1,15 @@
 """
 setup_cmd.py — taskflow init and setup.
 
-init creates a new .taskflow.yml in the current directory.
+init creates .taskflow.yml in the current directory.
 setup regenerates backlog file skeletons and installs git aliases.
 
-Both write files relative to the project root — setup uses the discovered
-root, init uses cwd since there's no root yet.
+The week-plan patching logic that existed in the old standalone script
+version is gone — reports.py reads directly from config now.
 """
 
 from __future__ import annotations
 
-import re
 import subprocess
 from pathlib import Path
 
@@ -32,22 +31,22 @@ STARTER_CONFIG = """\
 
 states:
   now:
-    file: "backlog/0-now.md"
+    file: ".taskflow/backlog/0-now.md"
     icon: "▶"
   blocked:
-    file: "backlog/1-blocked.md"
+    file: ".taskflow/backlog/1-blocked.md"
     icon: "⊘"
   paused:
-    file: "backlog/2-paused.md"
+    file: ".taskflow/backlog/2-paused.md"
     icon: "⏸"
   next:
-    file: "backlog/3-next.md"
+    file: ".taskflow/backlog/3-next.md"
     icon: "◈"
   later:
-    file: "backlog/4-later.md"
+    file: ".taskflow/backlog/4-later.md"
     icon: "◇"
   done:
-    file: "backlog/done.md"
+    file: ".taskflow/backlog/done.md"
     icon: "✓"
 
 # ---------------------------------------------------------------------------
@@ -73,7 +72,7 @@ categories:
     aliases: []
 
 # ---------------------------------------------------------------------------
-# Phases — organise 4-later.md into planning horizons.
+# Phases — organise the later file into planning horizons.
 # No effect on any other backlog file.
 # ---------------------------------------------------------------------------
 
@@ -94,24 +93,15 @@ phases:
 settings:
   repo_name: "{repo_name}"
   done_weeks: 4
-  weekly_plan_dir: "changelog/weekly"
-  # archive_path defaults to backlog/archive/ — uncomment to override
-  # archive_path: "backlog/archive"
+  weekly_plan_dir: ".taskflow/changelog/weekly"
+  # archive_path defaults to .taskflow/backlog/archive/ — uncomment to override
+  # archive_path: ".taskflow/backlog/archive"
 """
 
-WEEK_PLAN_BLOCK_START = "# === TASKFLOW GENERATED — do not edit below this line ==="
-WEEK_PLAN_BLOCK_END = "# === END TASKFLOW GENERATED ==="
-
 SIMPLE_STATE_TITLES = {
     "now": ("Now", "Tasks actively being executed this week."),
-    "blocked": (
-        "Blocked",
-        "Tasks waiting on something external.\n\nNote what's blocking each one.",
-    ),
-    "paused": (
-        "Paused",
-        "Tasks deliberately on hold.\n\nNot blocked, not forgotten — just not now.",
-    ),
+    "blocked": ("Blocked", "Tasks waiting on something external.\n\nNote what's blocking each one."),
+    "paused": ("Paused", "Tasks deliberately on hold.\n\nNot blocked, not forgotten — just not now."),
     "next": ("Next", "Planned work queued for the next execution window."),
 }
 
@@ -158,51 +148,23 @@ def _build_later_file(categories: list[dict], phases: list[dict]) -> str:
     return "\n".join(lines) + "\n"
 
 
-def _build_week_plan_block(categories: list[dict]) -> str:
-    alias_lines = ["CATEGORY_ALIASES = {"]
-    for cat in categories:
-        name = cat["name"]
-        for alias in cat.get("aliases", []):
-            alias_lines.append(f"    {alias!r}: {name!r},")
-        alias_lines.append(f"    {name!r}: {name!r},")
-    alias_lines.append("}")
-
-    order = "DEFAULT_CATEGORY_ORDER = [\n"
-    for cat in categories:
-        order += f"    {cat['name']!r},\n"
-    order += "]"
-
-    return f"{WEEK_PLAN_BLOCK_START}\n" + "\n".join(alias_lines) + f"\n\n{order}\n" + f"{WEEK_PLAN_BLOCK_END}\n"
-
-
-def patch_week_plan(week_plan_path: Path, categories: list[dict], dry_run: bool) -> bool:
-    """Regenerate the TASKFLOW GENERATED block in week-plan. Returns True if changed."""
-    if not week_plan_path.exists():
-        return False
-    content = week_plan_path.read_text(encoding="utf-8")
-    new_block = _build_week_plan_block(categories)
-
-    if WEEK_PLAN_BLOCK_START in content:
-        pattern = re.compile(
-            re.escape(WEEK_PLAN_BLOCK_START) + r".*?" + re.escape(WEEK_PLAN_BLOCK_END) + r"\n?",
-            re.DOTALL,
-        )
-        new_content = pattern.sub(new_block, content)
-    else:
-        new_content = content.rstrip() + "\n\n" + new_block
-
-    if new_content == content:
-        return False
-    if not dry_run:
-        week_plan_path.write_text(new_content, encoding="utf-8")
-    return True
-
-
 def install_git_aliases(root: Path) -> None:
     """
     Install git aliases that just call `taskflow <subcommand>`.
     Once taskflow is on PATH the aliases are trivial — no path resolution needed.
+    Skips silently if not in a git repo — init handles that case.
     """
+    # check we're actually in a git repo before attempting
+    try:
+        subprocess.run(
+            ["git", "rev-parse", "--git-dir"],
+            cwd=str(root),
+            check=True,
+            capture_output=True,
+        )
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return
+
     transitions = [
         ("promote", "promote"),
         ("start", "start"),
@@ -285,7 +247,6 @@ def run_setup(config: TaskflowConfig, force: bool = False, dry_run: bool = False
             (weekly_dir / ".gitkeep").touch()
         changed.append(str(weekly_dir.relative_to(root)) + "/")
 
-    # archive dir — just make sure it exists
     archive_dir = config.archive_path
     if not archive_dir.exists() and not dry_run:
         archive_dir.mkdir(parents=True, exist_ok=True)

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/src/taskflow/tasklib.py

@@ -171,7 +171,7 @@ def find_task(sections: list[dict], query: str, src_path: Path) -> tuple[dict, i
                 matches.append((section, line_idx, txt, raw_line))
 
     if not matches:
-        raise click.UsageError(f"No task matching '{query}' in {src_path.name}")
+        raise click.UsageError(f"No task matching '{query}' in {src_path.name}\n" f"  Run `taskflow list` to see what's there.")
 
     if len(matches) > 1:
         lines = "\n".join(f"  line {idx + 1}  [{sec['heading']}]  {txt}" for sec, idx, txt, _ in matches)

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/taskflow

@@ -39,12 +39,12 @@ SCRIPTS_DIR = REPO_ROOT / "scripts" / "git"
 # ---------------------------------------------------------------------------
 
 STATE_DEFAULTS = {
-    "now":     {"file": "backlog/0-now.md",     "icon": "▶"},
-    "blocked": {"file": "backlog/1-blocked.md", "icon": "⊘"},
-    "paused":  {"file": "backlog/2-paused.md",  "icon": "⏸"},
-    "next":    {"file": "backlog/3-next.md",     "icon": "◈"},
-    "later":   {"file": "backlog/4-later.md",    "icon": "◇"},
-    "done":    {"file": "backlog/done.md",       "icon": "✓"},
+    "now":     {"file": ".taskflow/backlog/0-now.md",     "icon": "▶"},
+    "blocked": {"file": ".taskflow/backlog/1-blocked.md", "icon": "⊘"},
+    "paused":  {"file": ".taskflow/backlog/2-paused.md",  "icon": "⏸"},
+    "next":    {"file": ".taskflow/backlog/3-next.md",     "icon": "◈"},
+    "later":   {"file": ".taskflow/backlog/4-later.md",    "icon": "◇"},
+    "done":    {"file": ".taskflow/backlog/done.md",       "icon": "✓"},
 }
 
 # Workflow transitions: command → (src_state, dst_state, commit_prefix)

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/tests/conftest.py

@@ -18,18 +18,8 @@ import yaml
 def tmp_git_repo(tmp_path: Path) -> Path:
     """A temp directory with git initialized and a basic user config."""
     subprocess.run(["git", "init"], cwd=tmp_path, check=True, capture_output=True)
-    subprocess.run(
-        ["git", "config", "user.email", "test@test.com"],
-        cwd=tmp_path,
-        check=True,
-        capture_output=True,
-    )
-    subprocess.run(
-        ["git", "config", "user.name", "test"],
-        cwd=tmp_path,
-        check=True,
-        capture_output=True,
-    )
+    subprocess.run(["git", "config", "user.email", "test@test.com"], cwd=tmp_path, check=True, capture_output=True)
+    subprocess.run(["git", "config", "user.name", "test"], cwd=tmp_path, check=True, capture_output=True)
     return tmp_path
 
 
@@ -64,32 +54,21 @@ def project_root(tmp_git_repo: Path, basic_config_data: dict) -> Path:
         yaml.dump(basic_config_data, f)
 
     # create minimal backlog structure
-    backlog = tmp_git_repo / "backlog"
-    backlog.mkdir()
+    backlog = tmp_git_repo / ".taskflow" / "backlog"
+    backlog.mkdir(parents=True)
 
     for name, content in [
         ("0-now.md", "# Now\n\n---\n\n### 🔵 Engineering\n\n---\n"),
         ("1-blocked.md", "# Blocked\n\n---\n"),
         ("2-paused.md", "# Paused\n\n---\n"),
-        (
-            "3-next.md",
-            "# Next\n\n---\n\n### 🔵 Engineering\n* write deployment docs\n* set up monitoring\n\n---\n\n### 🔴 Operations\n* configure alerting\n\n---\n",
-        ),
-        (
-            "4-later.md",
-            "# Later\n\n---\n\n## Phase 1 — Foundation\n\n### 🔵 Engineering\n* evaluate caching layer\n\n---\n",
-        ),
+        ("3-next.md", "# Next\n\n---\n\n### 🔵 Engineering\n* write deployment docs\n* set up monitoring\n\n---\n\n### 🔴 Operations\n* configure alerting\n\n---\n"),
+        ("4-later.md", "# Later\n\n---\n\n## Phase 1 — Foundation\n\n### 🔵 Engineering\n* evaluate caching layer\n\n---\n"),
         ("done.md", "# Done\n\nCompleted tasks.\n\n---\n"),
     ]:
         (backlog / name).write_text(content, encoding="utf-8")
 
     # initial commit so git operations work
     subprocess.run(["git", "add", "."], cwd=tmp_git_repo, check=True, capture_output=True)
-    subprocess.run(
-        ["git", "commit", "-m", "init"],
-        cwd=tmp_git_repo,
-        check=True,
-        capture_output=True,
-    )
+    subprocess.run(["git", "commit", "-m", "init"], cwd=tmp_git_repo, check=True, capture_output=True)
 
     return tmp_git_repo

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/tests/test_cli.py

@@ -57,8 +57,8 @@ class TestInit:
         with runner.isolated_filesystem(temp_dir=tmp_git_repo.parent):
             os.chdir(tmp_git_repo)
             runner.invoke(main, ["init"], catch_exceptions=False)
-            assert (tmp_git_repo / "backlog" / "0-now.md").exists()
-            assert (tmp_git_repo / "backlog" / "done.md").exists()
+            assert (tmp_git_repo / ".taskflow" / "backlog" / "0-now.md").exists()
+            assert (tmp_git_repo / ".taskflow" / "backlog" / "done.md").exists()
 
     def test_error_if_already_exists(self, runner: CliRunner, project_root: Path) -> None:
         os.chdir(project_root)
@@ -94,8 +94,8 @@ class TestStart:
     def test_moves_task_to_now(self, run_in_project, project_root: Path) -> None:
         result = run_in_project("start", "deployment docs")
         assert result.exit_code == 0
-        assert "write deployment docs" in (project_root / "backlog/0-now.md").read_text()
-        assert "write deployment docs" not in (project_root / "backlog/3-next.md").read_text()
+        assert "write deployment docs" in (project_root / ".taskflow/backlog/0-now.md").read_text()
+        assert "write deployment docs" not in (project_root / ".taskflow/backlog/3-next.md").read_text()
 
     def test_commit_uses_full_task_text(self, run_in_project, project_root: Path) -> None:
         import subprocess
@@ -112,8 +112,8 @@ class TestDone:
         # then mark it done
         result = run_in_project("done", "deployment")
         assert result.exit_code == 0
-        assert "write deployment docs" not in (project_root / "backlog/0-now.md").read_text()
-        assert "write deployment docs" in (project_root / "backlog/done.md").read_text()
+        assert "write deployment docs" not in (project_root / ".taskflow/backlog/0-now.md").read_text()
+        assert "write deployment docs" in (project_root / ".taskflow/backlog/done.md").read_text()
 
 
 class TestBlock:
@@ -121,8 +121,8 @@ class TestBlock:
         run_in_project("start", "deployment docs")
         result = run_in_project("block", "deployment")
         assert result.exit_code == 0
-        assert "write deployment docs" in (project_root / "backlog/1-blocked.md").read_text()
-        assert "write deployment docs" not in (project_root / "backlog/0-now.md").read_text()
+        assert "write deployment docs" in (project_root / ".taskflow/backlog/1-blocked.md").read_text()
+        assert "write deployment docs" not in (project_root / ".taskflow/backlog/0-now.md").read_text()
 
 
 class TestUnblock:
@@ -131,31 +131,52 @@ class TestUnblock:
         run_in_project("block", "deployment")
         result = run_in_project("unblock", "deployment")
         assert result.exit_code == 0
-        assert "write deployment docs" in (project_root / "backlog/0-now.md").read_text()
+        assert "write deployment docs" in (project_root / ".taskflow/backlog/0-now.md").read_text()
 
 
 class TestAdd:
     def test_adds_to_next(self, run_in_project, project_root: Path) -> None:
         result = run_in_project("add", "next", "Eng", "evaluate caching")
         assert result.exit_code == 0
-        assert "evaluate caching" in (project_root / "backlog/3-next.md").read_text()
+        assert "evaluate caching" in (project_root / ".taskflow/backlog/3-next.md").read_text()
 
     def test_fuzzy_category(self, run_in_project, project_root: Path) -> None:
         result = run_in_project("add", "next", "ops", "update firewall rules")
         assert result.exit_code == 0
-        assert "update firewall rules" in (project_root / "backlog/3-next.md").read_text()
+        assert "update firewall rules" in (project_root / ".taskflow/backlog/3-next.md").read_text()
 
     def test_add_done_directly(self, run_in_project, project_root: Path) -> None:
         result = run_in_project("add", "done", "Eng", "emergency hotfix deployed")
         assert result.exit_code == 0
-        assert "emergency hotfix deployed" in (project_root / "backlog/done.md").read_text()
+        assert "emergency hotfix deployed" in (project_root / ".taskflow/backlog/done.md").read_text()
 
     def test_unknown_state_errors(self, run_in_project) -> None:
         result = run_in_project("add", "banana", "Eng", "some task")
         assert result.exit_code != 0
 
 
-class TestStatus:
+class TestList:
+    def test_list_now_default(self, run_in_project) -> None:
+        result = run_in_project("list")
+        assert result.exit_code == 0
+        assert "now" in result.output
+
+    def test_list_next_shows_tasks(self, run_in_project) -> None:
+        result = run_in_project("list", "next")
+        assert result.exit_code == 0
+        assert "write deployment docs" in result.output
+        assert "Engineering" in result.output
+
+    def test_list_empty_state(self, run_in_project) -> None:
+        result = run_in_project("list", "blocked")
+        assert result.exit_code == 0
+        assert "empty" in result.output
+
+    def test_no_match_error_includes_hint(self, run_in_project) -> None:
+        result = run_in_project("start", "this does not exist")
+        assert result.exit_code != 0
+        assert "taskflow list" in result.output
+
     def test_shows_now_tasks(self, run_in_project, project_root: Path) -> None:
         run_in_project("start", "deployment docs")
         result = run_in_project("status")

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/tests/test_config.py

@@ -40,7 +40,7 @@ class TestTaskflowConfig:
         return TaskflowConfig(tmp_path, basic_config_data)
 
     def test_state_path_relative(self, cfg: TaskflowConfig, tmp_path: Path) -> None:
-        assert cfg.state_path("now") == tmp_path / "backlog" / "0-now.md"
+        assert cfg.state_path("now") == tmp_path / ".taskflow" / "backlog" / "0-now.md"
 
     def test_state_path_absolute_override(self, tmp_path: Path, basic_config_data: dict) -> None:
         basic_config_data["states"] = {"now": {"file": "/absolute/path/now.md"}}
@@ -102,8 +102,7 @@ class TestTaskflowConfig:
         assert cfg.done_weeks == 2
 
     def test_archive_path_default(self, cfg: TaskflowConfig, tmp_path: Path) -> None:
-        # default should be next to done.md in backlog/archive/
-        assert cfg.archive_path == tmp_path / "backlog" / "archive"
+        assert cfg.archive_path == tmp_path / ".taskflow" / "backlog" / "archive"
 
     def test_archive_path_override(self, tmp_path: Path, basic_config_data: dict) -> None:
         basic_config_data["settings"]["archive_path"] = "custom/archive"

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/tests/test_reports.py

@@ -121,9 +121,9 @@ class TestOrderedCategories:
 class TestReportProgress:
     @pytest.fixture
     def cfg(self, tmp_path: Path) -> TaskflowConfig:
-        (tmp_path / "backlog").mkdir()
-        (tmp_path / "backlog/0-now.md").write_text(SAMPLE_NOW)
-        (tmp_path / "backlog/done.md").write_text(SAMPLE_DONE)
+        (tmp_path / ".taskflow" / "backlog").mkdir(parents=True)
+        (tmp_path / ".taskflow/backlog/0-now.md").write_text(SAMPLE_NOW)
+        (tmp_path / ".taskflow/backlog/done.md").write_text(SAMPLE_DONE)
         data = {
             "categories": [
                 {"name": "Engineering", "icon": "🔵"},
@@ -154,8 +154,8 @@ class TestReportProgress:
 class TestReportPipeline:
     @pytest.fixture
     def cfg(self, tmp_path: Path) -> TaskflowConfig:
-        backlog = tmp_path / "backlog"
-        backlog.mkdir()
+        backlog = tmp_path / ".taskflow" / "backlog"
+        backlog.mkdir(parents=True)
         for name, text in [
             ("0-now.md", SAMPLE_NOW),
             ("1-blocked.md", "### Engineering\n* blocked task\n---\n"),

{taskflow_git-0.3.0 → taskflow_git-0.3.3}/uv.lock

@@ -765,7 +765,7 @@ wheels = [
 
 [[package]]
 name = "taskflow-git"
-version = "0.3.0"
+version = "0.3.3"
 source = { editable = "." }
 dependencies = [
     { name = "click", version = "8.1.8", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.10'" },