locci 0.1.0__tar.gz

locci-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+venv/
+env/
+.env
+
+# Locci cache
+.locci/
+.locci_cache/
+~/.locci/
+
+# Editor
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# macOS
+.DS_Store
+
+# Test artifacts
+.pytest_cache/
+.coverage
+htmlcov/

locci-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Locci Developers
+
+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.

locci-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: locci
+Version: 0.1.0
+Summary: A fast, local-first CI engine.
+Author: Locci Developers
+License-File: LICENSE
+Requires-Python: >=3.9
+Requires-Dist: networkx>=3.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tomli>=2.0.1; python_version < '3.11'
+Requires-Dist: typer>=0.9.0
+Requires-Dist: watchdog>=3.0.0
+Provides-Extra: ai
+Requires-Dist: anthropic>=0.20.0; extra == 'ai'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Provides-Extra: s3
+Requires-Dist: boto3>=1.28.0; extra == 's3'
+Description-Content-Type: text/markdown
+
+# Locci (Local CI)
+
+Locci is a fast, local-first CI preflight tool that runs the safe parts of your CI on your machine before you push. It uses an embedded DAG engine, content-hash caching, GitHub Actions-aware parsing, and clear skip reporting for unsafe or unsupported work.
+
+Locci is intentionally host-native for the MVP: it does not claim to replace your hosted CI runner or Docker-isolate production deploys. Instead, it catches the common lint/test/build failures locally and tells you what still needs remote CI.
+
+## Security Caveats
+
+**⚠️ Local Safety Heuristics are Best-Effort**
+Locci uses a keyword-based heuristic (looking for words like "deploy", "publish", "release") to identify and skip unsafe side-effect jobs. **This is not a security boundary.** A job that modifies production state without using these specific keywords will still execute locally.
+
+**⚠️ Remote Cache Supply Chain Risk**
+When using the `--remote-cache s3://...` feature, Locci pulls and restores cache artifacts directly into your workspace. There is currently no cryptographic signature or authenticity verification on these artifacts. Anyone with write access to the shared cache bucket could plant a malicious payload or falsify a test outcome. Use shared remote caching with trusted teams only.
+
+## Why Python?
+
+Locci is distributed via `pip` and written in Python 3.9+. While traditional tools often aim for a single static binary to avoid runtime dependencies, we deliberately chose Python to make installation ubiquitous across all OSes via PyPI, and to allow for rapid iteration and community-driven plugins.
+
+**The Tradeoff**: You will need a Python 3.9+ runtime to use Locci, even if your project is written in Node.js, Go, or Rust. 
+
+**Recommendation**: We strongly recommend installing Locci globally via `pipx` to isolate its dependencies from your system Python:
+```bash
+pipx install locci
+```
+This gives you a globally available `locci` command that feels exactly like a static binary, without cluttering your environment.
+
+## Usage
+
+```bash
+# First-time setup in a repo
+locci setup
+
+# Daily local CI check
+locci check
+
+# Affected pre-push check
+locci preflight
+
+# Watch for file changes and incrementally rerun only affected steps
+locci watch
+```
+
+Useful commands:
+
+```bash
+locci setup --preview        # print the generated locci.yml without writing
+locci check --dry-run        # show the local execution graph
+locci check --strict-coverage
+locci hook install           # install a managed pre-push hook
+locci doctor                 # inspect required local tools
+```

locci-0.1.0/README.md

@@ -0,0 +1,51 @@
+# Locci (Local CI)
+
+Locci is a fast, local-first CI preflight tool that runs the safe parts of your CI on your machine before you push. It uses an embedded DAG engine, content-hash caching, GitHub Actions-aware parsing, and clear skip reporting for unsafe or unsupported work.
+
+Locci is intentionally host-native for the MVP: it does not claim to replace your hosted CI runner or Docker-isolate production deploys. Instead, it catches the common lint/test/build failures locally and tells you what still needs remote CI.
+
+## Security Caveats
+
+**⚠️ Local Safety Heuristics are Best-Effort**
+Locci uses a keyword-based heuristic (looking for words like "deploy", "publish", "release") to identify and skip unsafe side-effect jobs. **This is not a security boundary.** A job that modifies production state without using these specific keywords will still execute locally.
+
+**⚠️ Remote Cache Supply Chain Risk**
+When using the `--remote-cache s3://...` feature, Locci pulls and restores cache artifacts directly into your workspace. There is currently no cryptographic signature or authenticity verification on these artifacts. Anyone with write access to the shared cache bucket could plant a malicious payload or falsify a test outcome. Use shared remote caching with trusted teams only.
+
+## Why Python?
+
+Locci is distributed via `pip` and written in Python 3.9+. While traditional tools often aim for a single static binary to avoid runtime dependencies, we deliberately chose Python to make installation ubiquitous across all OSes via PyPI, and to allow for rapid iteration and community-driven plugins.
+
+**The Tradeoff**: You will need a Python 3.9+ runtime to use Locci, even if your project is written in Node.js, Go, or Rust. 
+
+**Recommendation**: We strongly recommend installing Locci globally via `pipx` to isolate its dependencies from your system Python:
+```bash
+pipx install locci
+```
+This gives you a globally available `locci` command that feels exactly like a static binary, without cluttering your environment.
+
+## Usage
+
+```bash
+# First-time setup in a repo
+locci setup
+
+# Daily local CI check
+locci check
+
+# Affected pre-push check
+locci preflight
+
+# Watch for file changes and incrementally rerun only affected steps
+locci watch
+```
+
+Useful commands:
+
+```bash
+locci setup --preview        # print the generated locci.yml without writing
+locci check --dry-run        # show the local execution graph
+locci check --strict-coverage
+locci hook install           # install a managed pre-push hook
+locci doctor                 # inspect required local tools
+```

locci-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[project]
+name = "locci"
+version = "0.1.0"
+description = "A fast, local-first CI engine."
+authors = [{name = "Locci Developers"}]
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "networkx>=3.0",
+    "pyyaml>=6.0.1",
+    "pydantic>=2.0.0",
+    "watchdog>=3.0.0",
+    "tomli>=2.0.1; python_version < '3.11'"
+]
+
+[project.optional-dependencies]
+ai = [
+    "anthropic>=0.20.0"
+]
+s3 = [
+    "boto3>=1.28.0"
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio"
+]
+
+[project.scripts]
+locci = "locci.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

locci-0.1.0/scripts/stress_test.py

@@ -0,0 +1,52 @@
+import asyncio
+from pathlib import Path
+import random
+import tempfile
+import time
+
+from locci.analyzer import Task
+from locci.orchestrator import Orchestrator
+
+async def main():
+    with tempfile.TemporaryDirectory() as tmp:
+        project_root = Path(tmp)
+        cache_db = project_root / "cache.db"
+        
+        # Create 500 tasks
+        tasks = []
+        for i in range(500):
+            deps = []
+            if i > 0:
+                num_deps = random.randint(1, min(i, 3))
+                deps = [f"task_{random.randint(0, i-1)}" for _ in range(num_deps)]
+                
+            task = Task(
+                name=f"task_{i}",
+                cmd=["bash", "-c", f"echo 'Running task {i} with a bunch of output to bloat cache' && sleep 0.1"],
+                depends_on=deps,
+                input_globs=[]
+            )
+            tasks.append(task)
+            
+        print(f"Generated {len(tasks)} tasks.")
+        
+        orch = Orchestrator(
+            project_root=project_root,
+            cache_db=cache_db,
+            no_cache=True,
+            jobs=100
+        )
+        
+        start = time.time()
+        success = await orch.run(tasks)
+        end = time.time()
+        
+        print(f"Success: {success}")
+        print(f"Time: {end - start:.2f}s")
+        
+        if not success:
+            import sys
+            sys.exit(1)
+
+if __name__ == "__main__":
+    asyncio.run(main())