augint-tools 0.1.0__tar.gz

augint_tools-0.1.0/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.3
+Name: augint-tools
+Version: 0.1.0
+Summary: CLI for AI-assisted repository and workspace workflows
+Author: svange
+Requires-Dist: click>=8.1.0
+Requires-Dist: rich>=14.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: tomli-w>=1.2.0
+Requires-Dist: pytest>=7.4.0 ; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.8.0 ; extra == 'dev'
+Requires-Dist: mypy>=1.8.0 ; extra == 'dev'
+Requires-Dist: python-semantic-release>=10.3.1 ; extra == 'dev'
+Requires-Dist: pre-commit>=4.0.0 ; extra == 'dev'
+Requires-Dist: bandit>=1.7.0 ; extra == 'dev'
+Requires-Dist: pip-audit>=2.7.0 ; extra == 'dev'
+Requires-Dist: pip-licenses>=5.0.0 ; extra == 'dev'
+Requires-Dist: pytest-html>=4.0.0 ; extra == 'dev'
+Requires-Dist: pdoc>=15.0.0 ; extra == 'dev'
+Requires-Python: >=3.12
+Provides-Extra: dev
+Description-Content-Type: text/markdown
+
+# augint-tools
+
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/pypi/v/augint-tools.svg)](https://pypi.org/project/augint-tools/)
+[![Tests](https://github.com/svange/augint-tools/actions/workflows/pipeline.yaml/badge.svg)](https://github.com/svange/augint-tools/actions)
+
+CLI orchestration layer for AI-assisted repository and workspace workflows.
+
+`augint-tools` provides a stable, machine-parseable command surface for humans and AI agents to coordinate development workflows across single repositories and multi-repo workspaces. It is designed to be called directly by AI skills, replacing ad-hoc shell scripts with reliable, JSON-enabled commands.
+
+## Features
+
+- **Dual-mode operation**: Commands for both single repos (`ai-tools repo`) and monorepos/workspaces (`ai-tools monorepo`)
+- **AI-first design**: Every command supports `--json` output for agent parsing
+- **Repo-type aware**: Understands library, service, and workspace repository patterns
+- **Safe defaults**: No destructive git operations without explicit commands
+- **GitHub integration**: Issue management, PR creation, CI status monitoring
+
+## Installation
+
+```bash
+pip install augint-tools
+```
+
+Or with `uv`:
+
+```bash
+uv tool install augint-tools
+```
+
+## Quick Start
+
+### Single Repository Workflows
+
+```bash
+# Initialize repo metadata
+ai-tools init --library
+
+# Check repository status
+ai-tools repo status --json
+
+# List issues
+ai-tools repo issues "bug"
+
+# Create feature branch
+ai-tools repo branch feat/issue-42-example
+
+# Run tests and linting
+ai-tools repo test
+ai-tools repo lint --fix
+
+# Submit work (push + create PR)
+ai-tools repo submit
+```
+
+### Monorepo/Workspace Workflows
+
+```bash
+# Initialize workspace
+ai-tools init --workspace
+
+# Sync all child repositories
+ai-tools monorepo sync --json
+
+# Check status across all repos
+ai-tools mono status
+
+# Create coordinated branches
+ai-tools mono branch feat/multi-repo-change
+
+# Run tests across all repos
+ai-tools mono test
+
+# Run command in all repos
+ai-tools mono foreach -- git status
+
+# Submit PRs for all modified repos
+ai-tools mono submit
+```
+
+## Command Reference
+
+### Top-Level Commands
+
+- `ai-tools init [--library|--service|--workspace]` - Initialize repository metadata
+
+### Repository Commands (`ai-tools repo`)
+
+- `status` - Show repository status (branch, dirty state, PRs, CI)
+- `issues [query]` - List and filter issues
+- `branch <name>` - Create or switch branches using repo defaults
+- `test` - Run configured test commands
+- `lint [--fix]` - Run quality checks
+- `submit` - Push branch and create PR
+
+### Monorepo Commands (`ai-tools monorepo` or `ai-tools mono`)
+
+- `status` - Status across all child repositories
+- `sync` - Clone missing repos and update existing
+- `issues [query]` - Aggregate issues from all repos
+- `branch <name>` - Create coordinated branches
+- `test` - Run tests in dependency order
+- `lint [--fix]` - Quality checks across repos
+- `foreach <command>` - Execute command in all repos
+- `submit` - Push and create PRs for modified repos
+- `update` - Propagate upstream changes downstream
+
+## Configuration
+
+### Repository Classification
+
+`ai-shell.toml`:
+
+```toml
+[project]
+repo_type = "library"        # or "service", "workspace"
+branch_strategy = "main"     # or "dev"
+dev_branch = "dev"           # when branch_strategy = "dev"
+```
+
+### Workspace Manifest
+
+`workspace.toml` (for workspace repos):
+
+```toml
+[workspace]
+name = "my-workspace"
+repos_dir = "repos"
+
+[[repo]]
+name = "my-lib"
+path = "repos/my-lib"
+url = "https://github.com/org/my-lib.git"
+repo_type = "library"
+base_branch = "main"
+pr_target_branch = "main"
+install = "uv sync --all-extras"
+test = "uv run pytest -v"
+lint = "uv run pre-commit run --all-files"
+depends_on = []
+```
+
+## Development
+
+### Setup
+
+```bash
+uv sync --all-extras
+```
+
+### Running Tests
+
+```bash
+uv run pytest                    # Run all tests
+uv run pytest --cov             # With coverage
+uv run pytest -k test_name      # Specific test
+```
+
+### Code Quality
+
+```bash
+uv run ruff check src/ tests/   # Lint
+uv run ruff format src/ tests/  # Format
+uv run mypy src/               # Type check
+uv run pre-commit run --all-files  # All hooks
+```
+
+## Design Principles
+
+1. **Human and AI first** - Commands work well for both interactive use and programmatic calls
+2. **JSON always available** - Every orchestration command supports stable `--json` output
+3. **Safe defaults** - No destructive behavior without explicit confirmation
+4. **Repo-type aware** - Different defaults for libraries, services, and workspaces
+5. **Skills call tools** - AI skills orchestrate this CLI, not replace it with shell scripts
+
+## Architecture
+
+See [augint-tools.md](./augint-tools.md) for the complete design specification and implementation guide.
+
+## License
+
+MIT License - See LICENSE file for details.
+
+## Status
+
+**Current version: 2.0.0**
+
+This is a complete rewrite and repurposing of the `augint-tools` package. All commands are currently scaffolded stubs that emit JSON with `implemented: false`. See [augint-tools.md](./augint-tools.md) for the implementation roadmap.

augint_tools-0.1.0/README.md

@@ -0,0 +1,188 @@
+# augint-tools
+
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/pypi/v/augint-tools.svg)](https://pypi.org/project/augint-tools/)
+[![Tests](https://github.com/svange/augint-tools/actions/workflows/pipeline.yaml/badge.svg)](https://github.com/svange/augint-tools/actions)
+
+CLI orchestration layer for AI-assisted repository and workspace workflows.
+
+`augint-tools` provides a stable, machine-parseable command surface for humans and AI agents to coordinate development workflows across single repositories and multi-repo workspaces. It is designed to be called directly by AI skills, replacing ad-hoc shell scripts with reliable, JSON-enabled commands.
+
+## Features
+
+- **Dual-mode operation**: Commands for both single repos (`ai-tools repo`) and monorepos/workspaces (`ai-tools monorepo`)
+- **AI-first design**: Every command supports `--json` output for agent parsing
+- **Repo-type aware**: Understands library, service, and workspace repository patterns
+- **Safe defaults**: No destructive git operations without explicit commands
+- **GitHub integration**: Issue management, PR creation, CI status monitoring
+
+## Installation
+
+```bash
+pip install augint-tools
+```
+
+Or with `uv`:
+
+```bash
+uv tool install augint-tools
+```
+
+## Quick Start
+
+### Single Repository Workflows
+
+```bash
+# Initialize repo metadata
+ai-tools init --library
+
+# Check repository status
+ai-tools repo status --json
+
+# List issues
+ai-tools repo issues "bug"
+
+# Create feature branch
+ai-tools repo branch feat/issue-42-example
+
+# Run tests and linting
+ai-tools repo test
+ai-tools repo lint --fix
+
+# Submit work (push + create PR)
+ai-tools repo submit
+```
+
+### Monorepo/Workspace Workflows
+
+```bash
+# Initialize workspace
+ai-tools init --workspace
+
+# Sync all child repositories
+ai-tools monorepo sync --json
+
+# Check status across all repos
+ai-tools mono status
+
+# Create coordinated branches
+ai-tools mono branch feat/multi-repo-change
+
+# Run tests across all repos
+ai-tools mono test
+
+# Run command in all repos
+ai-tools mono foreach -- git status
+
+# Submit PRs for all modified repos
+ai-tools mono submit
+```
+
+## Command Reference
+
+### Top-Level Commands
+
+- `ai-tools init [--library|--service|--workspace]` - Initialize repository metadata
+
+### Repository Commands (`ai-tools repo`)
+
+- `status` - Show repository status (branch, dirty state, PRs, CI)
+- `issues [query]` - List and filter issues
+- `branch <name>` - Create or switch branches using repo defaults
+- `test` - Run configured test commands
+- `lint [--fix]` - Run quality checks
+- `submit` - Push branch and create PR
+
+### Monorepo Commands (`ai-tools monorepo` or `ai-tools mono`)
+
+- `status` - Status across all child repositories
+- `sync` - Clone missing repos and update existing
+- `issues [query]` - Aggregate issues from all repos
+- `branch <name>` - Create coordinated branches
+- `test` - Run tests in dependency order
+- `lint [--fix]` - Quality checks across repos
+- `foreach <command>` - Execute command in all repos
+- `submit` - Push and create PRs for modified repos
+- `update` - Propagate upstream changes downstream
+
+## Configuration
+
+### Repository Classification
+
+`ai-shell.toml`:
+
+```toml
+[project]
+repo_type = "library"        # or "service", "workspace"
+branch_strategy = "main"     # or "dev"
+dev_branch = "dev"           # when branch_strategy = "dev"
+```
+
+### Workspace Manifest
+
+`workspace.toml` (for workspace repos):
+
+```toml
+[workspace]
+name = "my-workspace"
+repos_dir = "repos"
+
+[[repo]]
+name = "my-lib"
+path = "repos/my-lib"
+url = "https://github.com/org/my-lib.git"
+repo_type = "library"
+base_branch = "main"
+pr_target_branch = "main"
+install = "uv sync --all-extras"
+test = "uv run pytest -v"
+lint = "uv run pre-commit run --all-files"
+depends_on = []
+```
+
+## Development
+
+### Setup
+
+```bash
+uv sync --all-extras
+```
+
+### Running Tests
+
+```bash
+uv run pytest                    # Run all tests
+uv run pytest --cov             # With coverage
+uv run pytest -k test_name      # Specific test
+```
+
+### Code Quality
+
+```bash
+uv run ruff check src/ tests/   # Lint
+uv run ruff format src/ tests/  # Format
+uv run mypy src/               # Type check
+uv run pre-commit run --all-files  # All hooks
+```
+
+## Design Principles
+
+1. **Human and AI first** - Commands work well for both interactive use and programmatic calls
+2. **JSON always available** - Every orchestration command supports stable `--json` output
+3. **Safe defaults** - No destructive behavior without explicit confirmation
+4. **Repo-type aware** - Different defaults for libraries, services, and workspaces
+5. **Skills call tools** - AI skills orchestrate this CLI, not replace it with shell scripts
+
+## Architecture
+
+See [augint-tools.md](./augint-tools.md) for the complete design specification and implementation guide.
+
+## License
+
+MIT License - See LICENSE file for details.
+
+## Status
+
+**Current version: 2.0.0**
+
+This is a complete rewrite and repurposing of the `augint-tools` package. All commands are currently scaffolded stubs that emit JSON with `implemented: false`. See [augint-tools.md](./augint-tools.md) for the implementation roadmap.

augint_tools-0.1.0/pyproject.toml

@@ -0,0 +1,124 @@
+[project]
+name = "augint-tools"
+version = "0.1.0"
+description = "CLI for AI-assisted repository and workspace workflows"
+authors = [{name = "svange"}]
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "click>=8.1.0",
+    "rich>=14.0",
+    "python-dotenv>=1.0.0",
+    "tomli-w>=1.2.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.0",
+    "pytest-cov>=4.1.0",
+    "ruff>=0.8.0",
+    "mypy>=1.8.0",
+    "python-semantic-release>=10.3.1",
+    "pre-commit>=4.0.0",
+    "bandit>=1.7.0",
+    "pip-audit>=2.7.0",
+    "pip-licenses>=5.0.0",
+    "pytest-html>=4.0.0",
+    "pdoc>=15.0.0",
+]
+
+[project.scripts]
+ai-tools = "augint_tools.cli.__main__:main"
+
+[build-system]
+requires = ["uv_build>=0.11,<0.12"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "augint_tools"
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "B", "C4", "UP", "DTZ"]
+ignore = ["E501"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["augint_tools"]
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+
+[[tool.mypy.overrides]]
+module = "augint_tools.cli.commands.*"
+disallow_untyped_defs = false
+
+[[tool.mypy.overrides]]
+module = "augint_tools.cli.__main__"
+disallow_untyped_defs = false
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = "-ra -q --strict-markers"
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["*/tests/*", "*/test_*.py", "*/cli/*"]
+
+[tool.semantic_release]
+assets = ["uv.lock"]
+commit_message = "chore(release): augint-tools {version}\n\nAutomatically generated by python-semantic-release [skip ci]"
+commit_parser = "conventional"
+logging_use_named_masks = false
+major_on_zero = true
+allow_zero_version = true
+no_git_verify = false
+tag_format = "augint-tools-v{version}"
+version_toml = ["pyproject.toml:project.version"]
+version_variables = ["src/augint_tools/__init__.py:__version__"]
+build_command = "uv lock && uv build"
+
+[tool.semantic_release.commit_parser_options]
+patch_tags = ["fix", "perf", "chore", "refactor"]
+
+[tool.semantic_release.branches.main]
+match = "main"
+prerelease = false
+prerelease_token = "rc"
+
+[tool.semantic_release.changelog]
+mode = "update"
+exclude_commit_patterns = [
+    '''ci(?:\([^)]*?\))?: .+''',
+    '''style(?:\([^)]*?\))?: .+''',
+    '''test(?:\([^)]*?\))?: .+''',
+    '''build\((?!deps\): .+)''',
+]
+
+[tool.semantic_release.changelog.default_templates]
+changelog_file = "CHANGELOG.md"
+
+[tool.semantic_release.remote]
+name = "origin"
+type = "github"
+ignore_token_for_push = false
+insecure = false
+
+[tool.semantic_release.remote.token]
+env = "GH_TOKEN"
+
+[tool.semantic_release.publish]
+dist_glob_patterns = ["dist/*"]
+upload_to_vcs_release = false
+
+[dependency-groups]
+dev = [
+    "augint-github>=1.6.0",
+    "augint-shell>=0.36.0",
+]

augint_tools-0.1.0/src/augint_tools/__init__.py

@@ -0,0 +1,3 @@
+"""augint-tools package."""
+
+__version__ = "0.1.0"

augint_tools-0.1.0/src/augint_tools/cli/__init__.py

@@ -0,0 +1 @@
+"""CLI package for augint-tools."""

augint_tools-0.1.0/src/augint_tools/cli/__main__.py

@@ -0,0 +1,46 @@
+"""augint-tools CLI entry point."""
+
+import logging
+import sys
+
+import click
+
+from augint_tools import __version__
+from augint_tools.cli.commands.monorepo import monorepo
+from augint_tools.cli.commands.project import init
+from augint_tools.cli.commands.repo import repo
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="ai-tools")
+@click.option("--verbose", "-v", is_flag=True, default=False, help="Enable debug logging.")
+@click.pass_context
+def cli(ctx, verbose):
+    """CLI for AI-assisted repository and workspace workflows."""
+    ctx.ensure_object(dict)
+    if verbose:
+        logging.basicConfig(level=logging.DEBUG, format="%(name)s: %(message)s")
+
+
+# Top-level commands
+cli.add_command(init)
+
+# Command groups
+cli.add_command(repo)
+cli.add_command(monorepo)
+
+# Register mono as an alias for monorepo
+cli.add_command(monorepo, name="mono")
+
+
+def main():
+    """Main entry point."""
+    try:
+        cli()
+    except Exception as exc:  # pragma: no cover - top-level CLI guard
+        click.echo(f"Error: {exc}", err=True)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

augint_tools-0.1.0/src/augint_tools/cli/commands/__init__.py

@@ -0,0 +1 @@
+"""Command modules for augint-tools."""

augint_tools-0.1.0/src/augint_tools/cli/commands/monorepo.py

@@ -0,0 +1,93 @@
+"""Workspace and monorepo orchestration commands."""
+
+import json
+from pathlib import Path
+
+import click
+from rich.console import Console
+
+console = Console(stderr=True)
+
+
+def _emit_stub(command_name: str, **payload: object) -> None:
+    payload = {"command": command_name, "scope": "monorepo", "implemented": False, **payload}
+    console.print(json.dumps(payload, indent=2))
+    console.print(
+        f"[yellow]{command_name} is scaffolded but not implemented yet. Use augint-tools.md as the implementation spec.[/yellow]"
+    )
+
+
+@click.group()
+def monorepo() -> None:
+    """Workspace and monorepo orchestration commands."""
+    pass
+
+
+# Alias for monorepo
+mono = monorepo
+
+
+@monorepo.command()
+@click.option("--json", "as_json", is_flag=True, default=False)
+def status(as_json: bool) -> None:
+    """Show status across all child repositories."""
+    _emit_stub("status", cwd=str(Path.cwd()), json=as_json)
+
+
+@monorepo.command()
+@click.option("--json", "as_json", is_flag=True, default=False)
+def sync(as_json: bool) -> None:
+    """Clone missing repos and update existing repos."""
+    _emit_stub("sync", cwd=str(Path.cwd()), json=as_json)
+
+
+@monorepo.command()
+@click.argument("query", required=False)
+@click.option("--json", "as_json", is_flag=True, default=False)
+def issues(query: str | None, as_json: bool) -> None:
+    """Aggregate issues across all child repositories."""
+    _emit_stub("issues", cwd=str(Path.cwd()), query=query, json=as_json)
+
+
+@monorepo.command()
+@click.argument("branch_name")
+@click.option("--json", "as_json", is_flag=True, default=False)
+def branch(branch_name: str, as_json: bool) -> None:
+    """Create coordinated branches across child repositories."""
+    _emit_stub("branch", cwd=str(Path.cwd()), branch=branch_name, json=as_json)
+
+
+@monorepo.command()
+@click.option("--json", "as_json", is_flag=True, default=False)
+def test(as_json: bool) -> None:
+    """Run tests across all child repositories."""
+    _emit_stub("test", cwd=str(Path.cwd()), json=as_json)
+
+
+@monorepo.command()
+@click.option("--fix", is_flag=True, default=False)
+@click.option("--json", "as_json", is_flag=True, default=False)
+def lint(fix: bool, as_json: bool) -> None:
+    """Run lint and quality checks across child repositories."""
+    _emit_stub("lint", cwd=str(Path.cwd()), fix=fix, json=as_json)
+
+
+@monorepo.command()
+@click.option("--json", "as_json", is_flag=True, default=False)
+def submit(as_json: bool) -> None:
+    """Push branches and open PRs for child repositories."""
+    _emit_stub("submit", cwd=str(Path.cwd()), json=as_json)
+
+
+@monorepo.command(context_settings={"ignore_unknown_options": True})
+@click.argument("command", nargs=-1, type=click.UNPROCESSED)
+def foreach(command: tuple[str, ...]) -> None:
+    """Run a command across all child repositories."""
+    _emit_stub("foreach", cwd=str(Path.cwd()), command=list(command))
+
+
+@monorepo.command()
+@click.option("--json", "as_json", is_flag=True, default=False)
+def update(as_json: bool) -> None:
+    """Update downstream repos after upstream changes."""
+    _emit_stub("update", cwd=str(Path.cwd()), json=as_json)

augint_tools-0.1.0/src/augint_tools/cli/commands/project.py

@@ -0,0 +1,26 @@
+"""Top-level project commands."""
+
+import json
+from pathlib import Path
+
+import click
+from rich.console import Console
+
+console = Console(stderr=True)
+
+
+def _emit_stub(command_name: str, **payload: object) -> None:
+    payload = {"command": command_name, "implemented": False, **payload}
+    console.print(json.dumps(payload, indent=2))
+    console.print(
+        f"[yellow]{command_name} is scaffolded but not implemented yet. Use augint-tools.md as the implementation spec.[/yellow]"
+    )
+
+
+@click.command()
+@click.option("--library", "repo_type", flag_value="library", default=None)
+@click.option("--service", "repo_type", flag_value="service")
+@click.option("--workspace", "repo_type", flag_value="workspace")
+def init(repo_type: str | None) -> None:
+    """Initialize repo or workspace workflow metadata."""
+    _emit_stub("init", cwd=str(Path.cwd()), repo_type=repo_type)

augint_tools-0.1.0/src/augint_tools/cli/commands/repo.py

@@ -0,0 +1,68 @@
+"""Single repository workflow commands."""
+
+import json
+from pathlib import Path
+
+import click
+from rich.console import Console
+
+console = Console(stderr=True)
+
+
+def _emit_stub(command_name: str, **payload: object) -> None:
+    payload = {"command": command_name, "scope": "repo", "implemented": False, **payload}
+    console.print(json.dumps(payload, indent=2))
+    console.print(
+        f"[yellow]{command_name} is scaffolded but not implemented yet. Use augint-tools.md as the implementation spec.[/yellow]"
+    )
+
+
+@click.group()
+def repo() -> None:
+    """Single repository workflow commands."""
+    pass
+
+
+@repo.command()
+@click.option("--json", "as_json", is_flag=True, default=False)
+def status(as_json: bool) -> None:
+    """Show repository status."""
+    _emit_stub("status", cwd=str(Path.cwd()), json=as_json)
+
+
+@repo.command()
+@click.argument("query", required=False)
+@click.option("--json", "as_json", is_flag=True, default=False)
+def issues(query: str | None, as_json: bool) -> None:
+    """List issues for this repository."""
+    _emit_stub("issues", cwd=str(Path.cwd()), query=query, json=as_json)
+
+
+@repo.command()
+@click.argument("branch_name")
+@click.option("--json", "as_json", is_flag=True, default=False)
+def branch(branch_name: str, as_json: bool) -> None:
+    """Create or switch branch."""
+    _emit_stub("branch", cwd=str(Path.cwd()), branch=branch_name, json=as_json)
+
+
+@repo.command()
+@click.option("--json", "as_json", is_flag=True, default=False)
+def test(as_json: bool) -> None:
+    """Run tests for this repository."""
+    _emit_stub("test", cwd=str(Path.cwd()), json=as_json)
+
+
+@repo.command()
+@click.option("--fix", is_flag=True, default=False)
+@click.option("--json", "as_json", is_flag=True, default=False)
+def lint(fix: bool, as_json: bool) -> None:
+    """Run lint and quality checks."""
+    _emit_stub("lint", cwd=str(Path.cwd()), fix=fix, json=as_json)
+
+
+@repo.command()
+@click.option("--json", "as_json", is_flag=True, default=False)
+def submit(as_json: bool) -> None:
+    """Push branch and open PR."""
+    _emit_stub("submit", cwd=str(Path.cwd()), json=as_json)

augint_tools-0.1.0/src/augint_tools/cli/commands/run.py

@@ -0,0 +1,39 @@
+"""Command execution helpers for augint-tools."""
+
+import json
+from pathlib import Path
+
+import click
+from rich.console import Console
+
+console = Console(stderr=True)
+
+
+def _emit_stub(command_name: str, **payload: object) -> None:
+    payload = {"command": command_name, "implemented": False, **payload}
+    console.print(json.dumps(payload, indent=2))
+    console.print(
+        f"[yellow]{command_name} is scaffolded but not implemented yet. Use augint-tools.md as the implementation spec.[/yellow]"
+    )
+
+
+@click.command(context_settings={"ignore_unknown_options": True})
+@click.argument("command", nargs=-1, type=click.UNPROCESSED)
+def foreach(command: tuple[str, ...]) -> None:
+    """Run a command across configured repos."""
+    _emit_stub("foreach", cwd=str(Path.cwd()), command=list(command))
+
+
+@click.command()
+@click.option("--json", "as_json", is_flag=True, default=False)
+def test(as_json: bool) -> None:
+    """Run configured tests."""
+    _emit_stub("test", cwd=str(Path.cwd()), json=as_json)
+
+
+@click.command()
+@click.option("--fix", is_flag=True, default=False)
+@click.option("--json", "as_json", is_flag=True, default=False)
+def lint(fix: bool, as_json: bool) -> None:
+    """Run configured lint and quality checks."""
+    _emit_stub("lint", cwd=str(Path.cwd()), fix=fix, json=as_json)