loopflow 0.6.2__tar.gz → 0.6.4__tar.gz

{loopflow-0.6.2 → loopflow-0.6.4}/.gitignore

@@ -7,6 +7,10 @@ __pycache__/
 xcuserdata/
 .swiftpm/xcode/
 Maestro/Maestro.xcodeproj/
+Maestro/dist/
 
 # Claude Code (personal state)
 .claude/settings.local.json
+
+# Loopflow (generated cache)
+.lf/summaries/

{loopflow-0.6.2 → loopflow-0.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: loopflow
-Version: 0.6.2
+Version: 0.6.4
 Summary: Run LLM coding agents from reusable prompt files
 Project-URL: Homepage, https://loopflowstudio.github.io/loopflow/
 Project-URL: Repository, https://github.com/loopflowstudio/loopflow
@@ -22,6 +22,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
+Requires-Dist: asana>=5.0.0
 Requires-Dist: pathspec>=0.11.0
 Requires-Dist: pydantic-ai-slim[anthropic]>=1.0.0
 Requires-Dist: pydantic>=2.12.5
@@ -37,7 +38,7 @@ Description-Content-Type: text/markdown
 Run LLM coding agents from reusable prompt files.
 
 ```bash
-lf review          # run .lf/review.lf
+lf review          # run .claude/commands/review.md
 lf ship            # pipeline: implement → review → test → commit → PR
 ```
 
@@ -68,14 +69,14 @@ lf design                     # interactive: figure out what to build
 lf ship                       # batch: implement, review, test, commit, open PR
 ```
 
-`lf design` runs `.lf/design.lf`. `lf ship` runs the `ship` pipeline from `.lf/config.yaml`.
+`lf design` runs `.claude/commands/design.md`. `lf ship` runs the `ship` pipeline from `.lf/config.yaml`.
 
 ## Tasks
 
-Tasks are prompt files in `.lf/`. Here's an example:
+Tasks are markdown files in `.claude/commands/` or `.lf/`. Here's an example:
 
 ```markdown
-# .lf/review.lf
+# .claude/commands/review.md
 
 Review the diff on the current branch against `main` and fix any issues found.
 
@@ -92,7 +93,7 @@ The deliverable is the fixes themselves, not a written review.
 Run tasks by name:
 
 ```bash
-lf review                     # run .lf/review.lf
+lf review                     # run .claude/commands/review.md
 lf review -x src/utils.py     # add context files
 lf : "fix the typo"           # inline prompt, no task file
 ```
@@ -234,7 +235,7 @@ Priority: CLI > frontmatter > config > none.
 
 | Command | Description |
 |---------|-------------|
-| `lf <task>` | Run a task from `.lf/` |
+| `lf <task>` | Run a task from `.claude/commands/` or `.lf/` |
 | `lf <pipeline>` | Run a pipeline |
 | `lf : "prompt"` | Inline prompt |
 | `wt <subcommand>` | Worktree management (worktrunk) |

{loopflow-0.6.2 → loopflow-0.6.4}/README.md

@@ -3,7 +3,7 @@
 Run LLM coding agents from reusable prompt files.
 
 ```bash
-lf review          # run .lf/review.lf
+lf review          # run .claude/commands/review.md
 lf ship            # pipeline: implement → review → test → commit → PR
 ```
 
@@ -34,14 +34,14 @@ lf design                     # interactive: figure out what to build
 lf ship                       # batch: implement, review, test, commit, open PR
 ```
 
-`lf design` runs `.lf/design.lf`. `lf ship` runs the `ship` pipeline from `.lf/config.yaml`.
+`lf design` runs `.claude/commands/design.md`. `lf ship` runs the `ship` pipeline from `.lf/config.yaml`.
 
 ## Tasks
 
-Tasks are prompt files in `.lf/`. Here's an example:
+Tasks are markdown files in `.claude/commands/` or `.lf/`. Here's an example:
 
 ```markdown
-# .lf/review.lf
+# .claude/commands/review.md
 
 Review the diff on the current branch against `main` and fix any issues found.
 
@@ -58,7 +58,7 @@ The deliverable is the fixes themselves, not a written review.
 Run tasks by name:
 
 ```bash
-lf review                     # run .lf/review.lf
+lf review                     # run .claude/commands/review.md
 lf review -x src/utils.py     # add context files
 lf : "fix the typo"           # inline prompt, no task file
 ```
@@ -200,7 +200,7 @@ Priority: CLI > frontmatter > config > none.
 
 | Command | Description |
 |---------|-------------|
-| `lf <task>` | Run a task from `.lf/` |
+| `lf <task>` | Run a task from `.claude/commands/` or `.lf/` |
 | `lf <pipeline>` | Run a pipeline |
 | `lf : "prompt"` | Inline prompt |
 | `wt <subcommand>` | Worktree management (worktrunk) |

{loopflow-0.6.2 → loopflow-0.6.4}/pyproject.toml

@@ -31,6 +31,7 @@ dependencies = [
     "pydantic>=2.12.5",
     "pydantic-ai-slim[anthropic]>=1.0.0",
     "tiktoken>=0.7.0",
+    "asana>=5.0.0",
 ]
 
 [project.urls]
@@ -50,6 +51,7 @@ lf = "loopflow.cli:main"
 lfd = "loopflow.lfd:main"
 lfwt = "loopflow.lfwt:main"
 lfops = "loopflow.lfops:main"
+lfwork = "loopflow.lfwork:main"
 
 [build-system]
 requires = ["hatchling"]
@@ -79,4 +81,5 @@ path = "src/loopflow/__init__.py"
 [dependency-groups]
 dev = [
     "pytest>=9.0.2",
+    "boto3>=1.35.0",
 ]

{loopflow-0.6.2 → loopflow-0.6.4}/src/loopflow/LOOPFLOW.md

@@ -20,7 +20,7 @@ Prompts receive context assembled by loopflow. What's included is configurable v
 
 - Root-level `.md` files (README, STYLE, etc.)
 - Current diff against main
-- The task prompt from `.lf/<task>.lf` or `.claude/commands/<task>.md`
+- The task prompt from `.claude/commands/<task>.md` or `.lf/<task>.md`
 - Additional files via `-x` flag or `context:` in config
 
 ---
@@ -36,9 +36,11 @@ In interactive mode, commit at natural breakpoints. Don't leave the branch in a
 ## File Structure
 
 ```
+.claude/commands/
+  <task>.md        # prompt files (Claude Code compatible)
+
 .lf/
   config.yaml      # repo configuration
-  <task>.lf        # prompt files
 
 .design/
   <branch>.md      # design doc for current branch

loopflow-0.6.4/src/loopflow/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.6.4"

loopflow-0.6.4/src/loopflow/builtins/summarize.txt

@@ -0,0 +1,14 @@
+Summarize this codebase for LLM context. Target: {token_budget} tokens.
+
+Prioritize:
+1. **Data structures** - Core types with field annotations
+2. **Public APIs** - Function signatures with one-line descriptions
+3. **Key patterns** - How the codebase is organized
+4. **Direct quotes** - Preserve exact names, paths, commands
+
+Format as dense markdown. No fluff. Code blocks for types/signatures.
+Omit implementation details unless they're critical to understanding.
+
+<source>
+{content}
+</source>

loopflow-0.6.4/src/loopflow/cli/__init__.py

@@ -0,0 +1,222 @@
+"""Loopflow CLI: Arrange LLMs to code in harmony."""
+
+import sys
+from pathlib import Path
+from typing import Optional
+
+import typer
+import yaml
+
+from loopflow.config import ConfigError, load_config
+from loopflow.context import find_worktree_root, gather_task, list_all_tasks, _get_builtin_task
+from loopflow.init_check import check_init_status
+from loopflow.lfd.pipelines import load_pipeline
+
+app = typer.Typer(
+    name="lf",
+    help="Arrange LLMs to code in harmony.",
+    no_args_is_help=False,
+)
+
+# Import and register subcommands
+from loopflow.cli import run as run_module
+
+# Register top-level commands
+app.command(context_settings={"allow_extra_args": True, "allow_interspersed_args": True})(run_module.run)
+app.command()(run_module.inline)
+app.command(name="pipeline")(run_module.pipeline)
+app.command()(run_module.cp)
+
+
+def _get_task_source(repo_root: Path | None, name: str) -> str:
+    """Return source location: .claude, .lf, or builtin."""
+    if repo_root:
+        if (repo_root / ".claude" / "commands" / f"{name}.md").exists():
+            return ".claude"
+        lf_dir = repo_root / ".lf"
+        if lf_dir.exists():
+            for p in lf_dir.iterdir():
+                if p.is_file() and (p.stem == name or p.name == name):
+                    return ".lf"
+    return "builtin"
+
+
+def _parse_frontmatter(content: str) -> dict:
+    """Extract frontmatter fields from task content."""
+    if not content.startswith("---"):
+        return {}
+    try:
+        _, fm, _ = content.split("---", 2)
+        return yaml.safe_load(fm) or {}
+    except Exception:
+        return {}
+
+
+def _get_task_info(repo_root: Path | None, name: str) -> dict:
+    """Get task metadata for display."""
+    info = {"name": name, "source": _get_task_source(repo_root, name)}
+
+    # Find the actual file to read frontmatter
+    content = None
+    if repo_root:
+        # Check .claude/commands first
+        claude_path = repo_root / ".claude" / "commands" / f"{name}.md"
+        if claude_path.exists():
+            content = claude_path.read_text()
+        else:
+            # Check .lf
+            lf_dir = repo_root / ".lf"
+            if lf_dir.exists():
+                for p in lf_dir.iterdir():
+                    if p.is_file() and (p.stem == name or p.name == name):
+                        content = p.read_text()
+                        break
+
+    # Fall back to builtin
+    if content is None:
+        builtin = _get_builtin_task(name)
+        if builtin:
+            content = builtin.read_text()
+
+    if content:
+        fm = _parse_frontmatter(content)
+        info.update(fm)
+
+    return info
+
+
+def _list_tasks() -> None:
+    """List available tasks and pipelines."""
+    repo_root = find_worktree_root()
+    config = load_config(repo_root) if repo_root else None
+
+    user_tasks, builtin_only = list_all_tasks(repo_root)
+    pipelines = list(config.pipelines.keys()) if config else []
+
+    # Show pipelines
+    if pipelines:
+        typer.echo("Pipelines (defined in .lf/config.yaml):")
+        for name in sorted(pipelines):
+            p = config.pipelines[name]
+            tasks_str = " → ".join(p.tasks) if p.tasks else ""
+            typer.echo(f"  {name:<16} {tasks_str}")
+        typer.echo()
+
+    # Gather task info
+    all_tasks = []
+    for name in user_tasks:
+        info = _get_task_info(repo_root, name)
+        info["builtin"] = False
+        all_tasks.append(info)
+    for name in builtin_only:
+        info = _get_task_info(repo_root, name)
+        info["builtin"] = True
+        all_tasks.append(info)
+
+    if not all_tasks:
+        typer.echo("No tasks found.")
+        typer.echo("Run: lfops init")
+        return
+
+    def format_task(t: dict, show_source: bool = False) -> str:
+        """Format a task for display."""
+        parts = [f"  {t['name']:<14}"]
+        if show_source:
+            parts.append(f" {t['source']:<8}")
+
+        meta = []
+        if t.get("interactive"):
+            meta.append("i")
+        if t.get("requires"):
+            meta.append(f"← {t['requires']}")
+        if t.get("produces"):
+            meta.append(f"→ {t['produces']}")
+
+        if meta:
+            parts.append(f"  {' '.join(meta)}")
+        return "".join(parts)
+
+    # Display custom tasks
+    custom = [t for t in all_tasks if not t["builtin"]]
+    if custom:
+        typer.echo("Tasks (repo-specific, override built-ins):")
+        for t in custom:
+            typer.echo(format_task(t, show_source=True))
+        typer.echo()
+
+    # Display builtins
+    builtins = [t for t in all_tasks if t["builtin"]]
+    if builtins:
+        typer.echo("Built-in (bundled defaults, work in any repo):")
+        for t in builtins:
+            typer.echo(format_task(t, show_source=False))
+
+
+def main():
+    """Entry point that supports 'lf <task>' and 'lf <pipeline>' shorthand."""
+    known_commands = {
+        "run",
+        "pipeline",
+        "inline",
+        "cp",
+        "--help",
+        "-h",
+    }
+
+    try:
+        # Handle 'lf' with no arguments: list available tasks
+        if len(sys.argv) == 1:
+            _list_tasks()
+            raise SystemExit(0)
+
+        if len(sys.argv) > 1:
+            first_arg = sys.argv[1]
+
+            # Inline prompt: lf : "prompt"
+            if first_arg == ":":
+                sys.argv.pop(1)
+                sys.argv.insert(1, "inline")
+            elif first_arg not in known_commands:
+                # Handle colon suffix: "lf implement: add logout" -> "lf implement add logout"
+                if first_arg.endswith(":"):
+                    sys.argv[1] = first_arg[:-1]
+                name = sys.argv[1]
+                repo_root = find_worktree_root()
+                config = load_config(repo_root) if repo_root else None
+
+                # Check for pipeline in config.yaml or .lf/pipelines/
+                has_config_pipeline = config and name in config.pipelines
+                has_file_pipeline = repo_root and load_pipeline(name, repo_root) is not None
+                has_pipeline = has_config_pipeline or has_file_pipeline
+
+                # gather_task now includes builtins
+                has_task = gather_task(repo_root, name) is not None if repo_root else False
+                # Also check builtin even without repo_root
+                if not has_task and not repo_root:
+                    has_task = _get_builtin_task(name) is not None
+
+                if has_pipeline and has_task:
+                    typer.echo(f"Error: '{name}' exists as both a pipeline and a task", err=True)
+                    typer.echo(f"  Pipeline: defined in .lf/config.yaml", err=True)
+                    typer.echo(f"  Task: .claude/commands/{name}.md or .lf/{name}.*", err=True)
+                    typer.echo(f"Remove one to resolve the conflict.", err=True)
+                    raise SystemExit(1)
+
+                if has_pipeline:
+                    sys.argv.insert(1, "pipeline")
+                elif has_task:
+                    sys.argv.insert(1, "run")
+                else:
+                    # Task not found
+                    typer.echo(f"No task or pipeline named '{name}'", err=True)
+                    typer.echo(f"Run 'lf' to see available tasks.", err=True)
+                    raise SystemExit(1)
+
+        app()
+    except ConfigError as e:
+        typer.echo(f"Error: {e}", err=True)
+        raise SystemExit(1)
+
+
+if __name__ == "__main__":
+    main()