openloom 0.7.0__tar.gz

openloom-0.7.0/.gitignore

@@ -0,0 +1,36 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+
+# Virtual environment
+.venv/
+venv/
+
+# Environment
+.env
+
+# Database
+.openloom/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+
+# Frontend
+frontend/node_modules/
+frontend/dist/
+# Note: src/openloom/server/static/app/ is INTENTIONALLY committed.
+# It contains the OpenDeck pre-built SPA so `openloom serve` works
+# without a separate `npm run build` step. Regenerate via
+# `cp opencode-deck/frontend/dist/* src/openloom/server/static/app/`.
+
+# Hatch
+*.egg

openloom-0.7.0/LICENSE

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

openloom-0.7.0/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: openloom
+Version: 0.7.0
+Summary: OpenLoom: a lightweight agent task harness — schedule, monitor, and verify AI coding tasks.
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: github
+Requires-Dist: pygithub>=2.0; extra == 'github'
+Provides-Extra: openspec
+Requires-Dist: openspec>=0.4; extra == 'openspec'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.115; extra == 'server'
+Requires-Dist: sse-starlette; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.30; extra == 'server'
+Provides-Extra: ui
+Requires-Dist: fastapi>=0.115; extra == 'ui'
+Requires-Dist: sse-starlette; extra == 'ui'
+Requires-Dist: uvicorn[standard]>=0.30; extra == 'ui'
+Provides-Extra: validate
+Description-Content-Type: text/markdown
+
+# OpenLoom
+
+**Don't trust the agent's word — trust the file system.**
+
+OpenLoom is a lightweight harness and observer for [OpenCode](https://github.com/opencode-ai/opencode). It schedules tasks, watches sessions, and verifies completion with file-system checks instead of model self-reports.
+
+OpenLoom does **not** replace OpenCode. It fills the gaps in OpenCode's HTTP API: session monitoring, task plans, periodic checks, a web dashboard, and token usage summaries.
+
+## Install
+
+Requires Python 3.11+ and a running OpenCode server.
+
+```bash
+pip install openloom
+# or
+uv tool install openloom
+```
+
+**Web dashboard** (FastAPI + bundled Svelte UI):
+
+```bash
+pip install "openloom[ui]"
+```
+
+Optional extras (install only what you need):
+
+| Extra | Purpose |
+|-------|---------|
+| `ui` | Web dashboard (`openloom serve`, `openloom watch --ui`) |
+| `server` | Same as `ui` (team server mode alias) |
+| `openspec` | OpenSpec checkbox completion checks |
+| `github` | GitHub integration |
+| `validate` | Pre-archive validation hooks (uses your project's pytest/mypy) |
+
+There is intentionally **no `[all]`** extra — pick capabilities as you grow.
+
+## Quick start
+
+### 1. Configure OpenCode connection
+
+```bash
+export OPENLOOM_OPENCODE_URL=http://127.0.0.1:14096
+export OPENLOOM_OPENCODE_USERNAME=opencode
+export OPENLOOM_OPENCODE_PASSWORD=your-password
+```
+
+Optional: restrict which workspace paths tasks may use:
+
+```bash
+export OPENLOOM_ALLOWED_ROOTS=/Users/you/Projects
+```
+
+See [`.env.example`](.env.example) for all variables.
+
+### 2. CLI — watch a task spec
+
+```bash
+openloom init                    # writes openloom.yaml in cwd
+openloom watch                   # run harness from openloom.yaml
+openloom watch --ui              # same + local web UI (needs [ui])
+openloom status
+openloom log <task-id-prefix>
+```
+
+Example spec (`openloom.yaml`):
+
+```yaml
+name: Fix SSE reconnect
+workspace: /path/to/project
+check_interval_minutes: 5   # 0 = send once, no periodic checks
+goal: |
+  Fix SSE reconnect after network drop.
+steps:
+  - Investigate current SSE implementation
+  - Implement reconnect with backoff
+  - Add regression coverage
+```
+
+### 3. Web dashboard — multi-task server
+
+```bash
+pip install "openloom[ui]"
+openloom serve --host 127.0.0.1 --port 55413
+```
+
+Open `http://127.0.0.1:55413` for:
+
+- **Dashboard** — session token usage, by-model breakdown, period summaries
+- **Activity** — tasks, archived tasks, sessions by workspace
+- **New Task** — plan with goal/steps/acceptance, attach to workspace or existing session
+
+The UI static assets are **pre-built inside the wheel** — no Node.js required at install time.
+
+## Architecture (short)
+
+```
+core/      Harness, store, event bus, Source / Checker / Sink ABCs (≤600 lines)
+runtime/   OpenCode HTTP client, session status, prompts
+levels/    Progressive capabilities (manual, config, openspec, ui, …)
+server/    FastAPI app + routes + static UI ([ui] extra)
+```
+
+State changes flow: **store write → event emit**. API routes read the store; the event bus pushes notifications only.
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+
+# Rebuild frontend into the package (before release)
+cd frontend && npm install && npm run build
+cd .. && uv build
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

openloom-0.7.0/README.md

@@ -0,0 +1,118 @@
+# OpenLoom
+
+**Don't trust the agent's word — trust the file system.**
+
+OpenLoom is a lightweight harness and observer for [OpenCode](https://github.com/opencode-ai/opencode). It schedules tasks, watches sessions, and verifies completion with file-system checks instead of model self-reports.
+
+OpenLoom does **not** replace OpenCode. It fills the gaps in OpenCode's HTTP API: session monitoring, task plans, periodic checks, a web dashboard, and token usage summaries.
+
+## Install
+
+Requires Python 3.11+ and a running OpenCode server.
+
+```bash
+pip install openloom
+# or
+uv tool install openloom
+```
+
+**Web dashboard** (FastAPI + bundled Svelte UI):
+
+```bash
+pip install "openloom[ui]"
+```
+
+Optional extras (install only what you need):
+
+| Extra | Purpose |
+|-------|---------|
+| `ui` | Web dashboard (`openloom serve`, `openloom watch --ui`) |
+| `server` | Same as `ui` (team server mode alias) |
+| `openspec` | OpenSpec checkbox completion checks |
+| `github` | GitHub integration |
+| `validate` | Pre-archive validation hooks (uses your project's pytest/mypy) |
+
+There is intentionally **no `[all]`** extra — pick capabilities as you grow.
+
+## Quick start
+
+### 1. Configure OpenCode connection
+
+```bash
+export OPENLOOM_OPENCODE_URL=http://127.0.0.1:14096
+export OPENLOOM_OPENCODE_USERNAME=opencode
+export OPENLOOM_OPENCODE_PASSWORD=your-password
+```
+
+Optional: restrict which workspace paths tasks may use:
+
+```bash
+export OPENLOOM_ALLOWED_ROOTS=/Users/you/Projects
+```
+
+See [`.env.example`](.env.example) for all variables.
+
+### 2. CLI — watch a task spec
+
+```bash
+openloom init                    # writes openloom.yaml in cwd
+openloom watch                   # run harness from openloom.yaml
+openloom watch --ui              # same + local web UI (needs [ui])
+openloom status
+openloom log <task-id-prefix>
+```
+
+Example spec (`openloom.yaml`):
+
+```yaml
+name: Fix SSE reconnect
+workspace: /path/to/project
+check_interval_minutes: 5   # 0 = send once, no periodic checks
+goal: |
+  Fix SSE reconnect after network drop.
+steps:
+  - Investigate current SSE implementation
+  - Implement reconnect with backoff
+  - Add regression coverage
+```
+
+### 3. Web dashboard — multi-task server
+
+```bash
+pip install "openloom[ui]"
+openloom serve --host 127.0.0.1 --port 55413
+```
+
+Open `http://127.0.0.1:55413` for:
+
+- **Dashboard** — session token usage, by-model breakdown, period summaries
+- **Activity** — tasks, archived tasks, sessions by workspace
+- **New Task** — plan with goal/steps/acceptance, attach to workspace or existing session
+
+The UI static assets are **pre-built inside the wheel** — no Node.js required at install time.
+
+## Architecture (short)
+
+```
+core/      Harness, store, event bus, Source / Checker / Sink ABCs (≤600 lines)
+runtime/   OpenCode HTTP client, session status, prompts
+levels/    Progressive capabilities (manual, config, openspec, ui, …)
+server/    FastAPI app + routes + static UI ([ui] extra)
+```
+
+State changes flow: **store write → event emit**. API routes read the store; the event bus pushes notifications only.
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+
+# Rebuild frontend into the package (before release)
+cd frontend && npm install && npm run build
+cd .. && uv build
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).