loopflow 0.1.2__tar.gz → 0.2.0__tar.gz

loopflow-0.2.0/.gitignore

@@ -0,0 +1 @@
+.pypirc

loopflow-0.2.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: loopflow
+Version: 0.2.0
+Summary: Arrange LLMs to code in harmony
+Author: Jack
+License-Expression: MIT
+Keywords: ai,claude,cli,coding,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Requires-Python: >=3.10
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# Loopflow
+
+Arrange LLMs to code in harmony.
+
+## Installation
+
+`pip install loopflow`
+
+## Basic Usage
+
+`lf claude review`: Launches a claude code session with a default initial prompt. Should Include:
+* README and STYLE info from the entire codebase
+* A default "perspective" file, i.e. something like `.lf/perspectives/default.lf`
+* The contents of the task, e.g. something like `.lf/tasks/review.lf`
+
+`lf claude review -p`: Uses claude's print mode, which is to say:
+* Also wraps the claude code in our commit wrapper to make it easier to make atomic in git
+
+`lf claude review -p artist`: Uses `.lf/perspectives/artist.lf` or something

loopflow-0.2.0/README.md

@@ -0,0 +1,19 @@
+# Loopflow
+
+Arrange LLMs to code in harmony.
+
+## Installation
+
+`pip install loopflow`
+
+## Basic Usage
+
+`lf claude review`: Launches a claude code session with a default initial prompt. Should Include:
+* README and STYLE info from the entire codebase
+* A default "perspective" file, i.e. something like `.lf/perspectives/default.lf`
+* The contents of the task, e.g. something like `.lf/tasks/review.lf`
+
+`lf claude review -p`: Uses claude's print mode, which is to say:
+* Also wraps the claude code in our commit wrapper to make it easier to make atomic in git
+
+`lf claude review -p artist`: Uses `.lf/perspectives/artist.lf` or something

loopflow-0.2.0/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "loopflow"
+version = "0.2.0"
+description = "Arrange LLMs to code in harmony"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "Jack" }]
+keywords = ["llm", "claude", "ai", "coding", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development",
+]
+dependencies = [
+    "typer>=0.9.0",
+]
+
+[project.scripts]
+lf = "loopflow.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/loopflow"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/loopflow"]

loopflow-0.2.0/src/loopflow/__init__.py

@@ -0,0 +1,3 @@
+"""Loopflow: Arrange LLMs to code in harmony."""
+
+__version__ = "0.2.0"

loopflow-0.2.0/src/loopflow/cli.py

@@ -0,0 +1,49 @@
+"""Loopflow CLI: Arrange LLMs to code in harmony."""
+
+import typer
+
+from loopflow.context import build_prompt, find_repo_root
+from loopflow.launcher import check_claude_available, launch_claude
+
+app = typer.Typer(
+    name="lf",
+    help="Arrange LLMs to code in harmony.",
+    no_args_is_help=True,
+)
+
+
+@app.command()
+def claude(
+    task: str = typer.Argument(help="Task name (e.g., 'review')"),
+    print_mode: bool = typer.Option(
+        False, "-p", "-P", "--print", help="Use Claude's print mode"
+    ),
+    role: str = typer.Option(
+        "default", "-r", "--role", help="Role file to use"
+    ),
+):
+    """Launch a Claude Code session with context."""
+    repo_root = find_repo_root()
+    if not repo_root:
+        typer.echo("Error: Not in a git repository", err=True)
+        raise typer.Exit(1)
+
+    if not check_claude_available():
+        typer.echo("Error: 'claude' CLI not found. Install Claude Code first.", err=True)
+        raise typer.Exit(1)
+
+    prompt = build_prompt(repo_root, task, role)
+    exit_code = launch_claude(prompt, print_mode=print_mode, cwd=repo_root)
+    raise typer.Exit(exit_code)
+
+
+@app.command()
+def version():
+    """Show loopflow version."""
+    from loopflow import __version__
+
+    typer.echo(f"loopflow {__version__}")
+
+
+if __name__ == "__main__":
+    app()

loopflow-0.2.0/src/loopflow/context.py

@@ -0,0 +1,91 @@
+"""Context gathering for LLM sessions."""
+
+from pathlib import Path
+
+
+def find_repo_root(start: Path | None = None) -> Path | None:
+    """Find the git repository root from the given path."""
+    path = start or Path.cwd()
+    path = path.resolve()
+
+    while path != path.parent:
+        if (path / ".git").exists():
+            return path
+        path = path.parent
+
+    if (path / ".git").exists():
+        return path
+    return None
+
+
+def _read_file_if_exists(path: Path) -> str | None:
+    if path.exists() and path.is_file():
+        return path.read_text()
+    return None
+
+
+def gather_readme(repo_root: Path) -> str | None:
+    """Gather README content from the repository."""
+    for name in ["README.md", "README.txt", "README"]:
+        content = _read_file_if_exists(repo_root / name)
+        if content:
+            return content
+    return None
+
+
+def gather_style(repo_root: Path) -> str | None:
+    """Gather STYLE guide content from the repository."""
+    for name in ["STYLE.md", "STYLE.txt", "STYLE"]:
+        content = _read_file_if_exists(repo_root / name)
+        if content:
+            return content
+    return None
+
+
+def gather_role(repo_root: Path, name: str = "default") -> str | None:
+    """Gather role file content."""
+    lf_dir = repo_root / ".lf" / "roles"
+    for ext in [".lf", ".md", ".txt", ""]:
+        content = _read_file_if_exists(lf_dir / f"{name}{ext}")
+        if content:
+            return content
+    return None
+
+
+def gather_task(repo_root: Path, name: str) -> str | None:
+    """Gather task file content."""
+    lf_dir = repo_root / ".lf" / "tasks"
+    for ext in [".lf", ".md", ".txt", ""]:
+        content = _read_file_if_exists(lf_dir / f"{name}{ext}")
+        if content:
+            return content
+    return None
+
+
+def build_prompt(
+    repo_root: Path,
+    task: str,
+    role: str = "default",
+) -> str:
+    """Build the full prompt for an LLM session."""
+    parts = []
+
+    readme = gather_readme(repo_root)
+    if readme:
+        parts.append(f"# Project README\n\n{readme}")
+
+    style = gather_style(repo_root)
+    if style:
+        parts.append(f"# Style Guide\n\n{style}")
+
+    role_content = gather_role(repo_root, role)
+    if role_content:
+        parts.append(f"# Role: {role}\n\n{role_content}")
+
+    task_content = gather_task(repo_root, task)
+    if task_content:
+        parts.append(f"# Task: {task}\n\n{task_content}")
+    else:
+        parts.append(f"# Task: {task}\n\nNo task file found for '{task}'.")
+
+    return "\n\n---\n\n".join(parts)

loopflow-0.2.0/src/loopflow/launcher.py

@@ -0,0 +1,35 @@
+"""Launch LLM coding sessions."""
+
+import subprocess
+import sys
+from pathlib import Path
+
+
+def launch_claude(
+    prompt: str,
+    print_mode: bool = False,
+    cwd: Path | None = None,
+) -> int:
+    """Launch a Claude Code session with the given prompt."""
+    cmd = ["claude"]
+
+    if print_mode:
+        cmd.append("--print")
+
+    cmd.extend(["--prompt", prompt])
+
+    result = subprocess.run(cmd, cwd=cwd)
+    return result.returncode
+
+
+def check_claude_available() -> bool:
+    """Check if the claude CLI is available."""
+    try:
+        subprocess.run(
+            ["claude", "--version"],
+            capture_output=True,
+            check=True,
+        )
+        return True
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return False

loopflow-0.1.2/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Loopflow Studio
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

loopflow-0.1.2/PKG-INFO

@@ -1,151 +0,0 @@
-Metadata-Version: 2.4
-Name: loopflow
-Version: 0.1.2
-Summary: arrange llms to code in harmony
-Author-email: Jack Heart <jack@loopflow.studio>
-License: MIT
-Project-URL: Homepage, https://github.com/loopflowstudio/loopflow
-Project-URL: Repository, https://github.com/loopflowstudio/loopflow
-Project-URL: Issues, https://github.com/loopflowstudio/loopflow/issues
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: typer>=0.9.0
-Requires-Dist: tiktoken>=0.9.0
-Provides-Extra: dev
-Requires-Dist: pytest>=9.0.0; extra == "dev"
-Dynamic: license-file
-
-loopflow: arrange llms to code in harmony
-
-## Installation
-
-```bash
-pip install loopflow
-```
-
-Or install from source:
-
-```bash
-git clone https://github.com/loopflowstudio/loopflow.git
-cd loopflow
-uv venv
-uv pip install -e .
-```
-
-## lfcp
-
-lfcp gathers files into context for LLM queries, building on e.g. `files-to-prompt`.
-
-### Features
-
-- **Smart Context Gathering**: Automatically includes parent README files up to git root
-- **Gitignore Integration**: Respects `.gitignore` and `.cpignore` patterns
-- **Extension Filtering**: Focus on specific file types with `-e` flags
-- **Token Profiling**: Analyze token usage with detailed breakdowns and interactive flamegraphs
-
-## Usage
-
-### Basic Usage
-
-Copy the current directory to clipboard:
-
-```bash
-lfcp .
-```
-
-### Common Workflows
-
-Copy specific directories:
-```bash
-lfcp src/ tests/
-```
-
-Copy only Python files:
-```bash
-lfcp . -e py
-```
-
-Copy multiple file types:
-```bash
-lfcp . -e py -e js -e tsx
-```
-
-Output to stdout instead of clipboard:
-```bash
-lfcp . -s
-```
-
-Copy only README files (great for project overview):
-```bash
-lfcp . -r
-```
-
-Ignore specific directories:
-```bash
-lfcp . -i build -i dist
-```
-
-### Token Profiling
-
-Analyze token usage across your codebase:
-
-```bash
-lfcp . --profile
-```
-
-Generate an interactive flamegraph visualization:
-
-```bash
-lfcp . --flamegraph
-```
-
-The flamegraph will be saved as `token_flamegraph.html` and can be opened in any browser.
-
-### Advanced Options
-
-```
-Options:
-  -e, --extensions TEXT        Filter by file extension (e.g., -e py -e js)
-  -r, --readmes               Only include README files
-  -s, --stdout                Output to stdout instead of clipboard
-  -i, --ignore TEXT           Additional ignore patterns (can be used multiple times)
-  --profile                   Show detailed token usage statistics
-  --flamegraph               Generate interactive HTML flamegraph visualization
-  --help                      Show help message
-```
-
-## How It Works
-
-1. **Discovery**: Walks through specified directories, respecting gitignore rules
-2. **Context Addition**: Automatically includes parent README files for better context
-3. **Filtering**: Applies extension filters and ignore patterns
-4. **Formatting**: Structures files in XML format with clear source attribution
-5. **Output**: Copies to clipboard or outputs to stdout based on your preference
-
-## File Format
-
-```xml
-<documents>
-<document index="1">
-<source>path/to/file.py</source>
-<document_content>
-# Your file content here
-</document_content>
-</document>
-</documents>
-```
-
-## Gitignore Support
-
-lf respects both `.gitignore` and `.cpignore` files. You can create a `.cpignore` in your project root to specify additional patterns to ignore when gathering code context:
-
-```
-# Example .cpignore
-*.pyc
-__pycache__/
-node_modules/
-*.egg-info
-build/
-dist/
-```

loopflow-0.1.2/README.md

@@ -1,133 +0,0 @@
-loopflow: arrange llms to code in harmony
-
-## Installation
-
-```bash
-pip install loopflow
-```
-
-Or install from source:
-
-```bash
-git clone https://github.com/loopflowstudio/loopflow.git
-cd loopflow
-uv venv
-uv pip install -e .
-```
-
-## lfcp
-
-lfcp gathers files into context for LLM queries, building on e.g. `files-to-prompt`.
-
-### Features
-
-- **Smart Context Gathering**: Automatically includes parent README files up to git root
-- **Gitignore Integration**: Respects `.gitignore` and `.cpignore` patterns
-- **Extension Filtering**: Focus on specific file types with `-e` flags
-- **Token Profiling**: Analyze token usage with detailed breakdowns and interactive flamegraphs
-
-## Usage
-
-### Basic Usage
-
-Copy the current directory to clipboard:
-
-```bash
-lfcp .
-```
-
-### Common Workflows
-
-Copy specific directories:
-```bash
-lfcp src/ tests/
-```
-
-Copy only Python files:
-```bash
-lfcp . -e py
-```
-
-Copy multiple file types:
-```bash
-lfcp . -e py -e js -e tsx
-```
-
-Output to stdout instead of clipboard:
-```bash
-lfcp . -s
-```
-
-Copy only README files (great for project overview):
-```bash
-lfcp . -r
-```
-
-Ignore specific directories:
-```bash
-lfcp . -i build -i dist
-```
-
-### Token Profiling
-
-Analyze token usage across your codebase:
-
-```bash
-lfcp . --profile
-```
-
-Generate an interactive flamegraph visualization:
-
-```bash
-lfcp . --flamegraph
-```
-
-The flamegraph will be saved as `token_flamegraph.html` and can be opened in any browser.
-
-### Advanced Options
-
-```
-Options:
-  -e, --extensions TEXT        Filter by file extension (e.g., -e py -e js)
-  -r, --readmes               Only include README files
-  -s, --stdout                Output to stdout instead of clipboard
-  -i, --ignore TEXT           Additional ignore patterns (can be used multiple times)
-  --profile                   Show detailed token usage statistics
-  --flamegraph               Generate interactive HTML flamegraph visualization
-  --help                      Show help message
-```
-
-## How It Works
-
-1. **Discovery**: Walks through specified directories, respecting gitignore rules
-2. **Context Addition**: Automatically includes parent README files for better context
-3. **Filtering**: Applies extension filters and ignore patterns
-4. **Formatting**: Structures files in XML format with clear source attribution
-5. **Output**: Copies to clipboard or outputs to stdout based on your preference
-
-## File Format
-
-```xml
-<documents>
-<document index="1">
-<source>path/to/file.py</source>
-<document_content>
-# Your file content here
-</document_content>
-</document>
-</documents>
-```
-
-## Gitignore Support
-
-lf respects both `.gitignore` and `.cpignore` files. You can create a `.cpignore` in your project root to specify additional patterns to ignore when gathering code context:
-
-```
-# Example .cpignore
-*.pyc
-__pycache__/
-node_modules/
-*.egg-info
-build/
-dist/
-```

loopflow-0.1.2/pyproject.toml

@@ -1,44 +0,0 @@
-[build-system]
-requires = ["setuptools==80.9.0", "wheel==0.45.1"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "loopflow"
-version = "0.1.2"
-description = "arrange llms to code in harmony"
-readme = "README.md"
-requires-python = ">=3.10"
-dependencies = ["typer>=0.9.0", "tiktoken>=0.9.0"]
-license = {text = "MIT"}
-authors = [
-    {name = "Jack Heart", email = "jack@loopflow.studio"}
-]
-keywords = []
-classifiers = []
-
-[project.urls]
-Homepage = "https://github.com/loopflowstudio/loopflow"
-Repository = "https://github.com/loopflowstudio/loopflow"
-Issues = "https://github.com/loopflowstudio/loopflow/issues"
-
-[project.optional-dependencies]
-dev = ["pytest>=9.0.0"]
-
-[project.scripts]
-lf = "lf.cli:app"
-lfcp = "lf.cp.cli:app"
-
-[tool.setuptools.packages.find]
-where = ["src"]
-include = ["lf", "lf.*"]
-
-[tool.pytest.ini_options]
-pythonpath = ["src"]
-testpaths = ["tests"]
-python_files = ["test_*.py"]
-python_functions = ["test_*"]
-python_classes = ["Test*"]
-
-[tool.coverage.run]
-source = ["lf"]
-

loopflow-0.1.2/setup.cfg

@@ -1,4 +0,0 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-

loopflow-0.1.2/src/lf/cli.py

@@ -1,36 +0,0 @@
-"""Main CLI entry point for lf."""
-
-import sys
-
-import typer
-
-app = typer.Typer(
-    name="lf",
-    help="loopflow - arrange LLMs to code in harmony",
-    no_args_is_help=True,
-)
-
-from lf.cp.cli import app as cp_app
-
-@app.command()
-def cp(ctx: typer.Context):
-    """Arrange codebase context for LLM interactions (alias for lfcp).
-
-    This command is an alias that invokes lfcp with the same arguments.
-    All arguments after 'cp' are passed directly to lfcp.
-    """
-    # Import here to avoid circular dependencies
-    # Get all remaining arguments from sys.argv
-    # Find the index of 'cp' and pass everything after it
-    try:
-        cp_index = sys.argv.index('cp')
-        remaining_args = sys.argv[cp_index + 1:]
-    except ValueError:
-        remaining_args = []
-
-    # Invoke the clip app with remaining arguments
-    cp_app(remaining_args, standalone_mode=False)
-
-
-if __name__ == "__main__":
-    app()