sprucelab 0.1.0__tar.gz

sprucelab-0.1.0/.gitignore

@@ -0,0 +1,291 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+/lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Django
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+database.sqlite
+database.sqlite-journal
+/media
+/staticfiles
+/backend/logs/
+/backend/media/
+/backend/staticfiles/
+/backend/database.sqlite*
+
+# Flask
+instance/
+.webassets-cache
+
+# Scrapy
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# PEP 582
+__pypackages__/
+
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder
+.spyderproject
+.spyproject
+
+# Rope
+.ropeproject
+
+# mkdocs
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre
+.pyre/
+
+# Conda
+.conda/
+
+# Node.js / Frontend
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs
+lib-cov
+
+# Coverage
+coverage
+*.lcov
+.nyc_output
+
+# Grunt
+.grunt
+
+# Bower
+bower_components
+
+# node-waf
+.lock-wscript
+
+# Compiled binary addons
+build/Release
+
+# Dependency directories
+jspm_packages/
+
+# Snowpack
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn
+.yarn-integrity
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# parcel-bundler
+.cache
+.parcel-cache
+
+# Next.js
+.next/
+out/
+
+# Nuxt.js
+.nuxt
+dist
+
+# Gatsby
+.cache/
+public
+
+# vuepress
+.vuepress/dist
+
+# Serverless
+.serverless/
+
+# FuseBox
+.fusebox/
+
+# DynamoDB Local
+.dynamodb/
+
+# TernJS
+.tern-port
+
+# Stores VSCode versions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Vercel CLI link (project metadata, not for commit)
+.vercel/
+
+# Project specific
+/output/
+/versions/
+*.ifc
+/output/*.json
+*.npz
+simplified*.ifc
+LBK_RIV_C*.ifc
+LBK_RIV_C*.json
+
+# Exception: checked-in test fixtures for the live smoke harness
+!cli/tests/integration/fixtures/*.ifc
+
+# Temp files
+*.tmp
+*.bak
+*.log
+
+# OS files
+Thumbs.db
+.DS_Store
+
+# Vite
+dist-ssr
+*.local
+
+# Frontend build
+/frontend/dist/
+/frontend/build/
+/frontend/.vite/
+
+# Environment files (keep .env.example, ignore others)
+.env.local
+.env.dev
+.env.development.local
+.env.test.local
+.env.production.local
+.env.production
+frontend/.env.production
+backend/.env*
+
+# Test coverage
+htmlcov/
+.coverage
+.coverage.*
+
+# Generated by supabase CLI
+supabase/
+backend/supabase/
+
+# Claude Code runtime state
+.claude/scheduled_tasks.lock
+
+# Stray install logs
+sunshine-install-log.txt
+
+# Claude Code agent worktrees (transient git worktrees from subagent runs)
+.claude/worktrees/
+

sprucelab-0.1.0/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: sprucelab
+Version: 0.1.0
+Summary: Agent-first surface for Sprucelab — typed CLI + MCP server over the same public HTTP API.
+Project-URL: Homepage, https://www.sprucelab.io/agents
+Project-URL: Benchmarks, https://www.sprucelab.io/benchmarks
+Project-URL: Source, https://github.com/EdvardGK/sprucelab
+Author: Sprucelab
+License-Expression: MIT
+Keywords: agent,agentic,automation,bim,claude,cli,cursor,ifc,mcp
+Classifier: Development Status :: 4 - Beta
+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
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: keyring>=24.0.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: respx>=0.20.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# sprucelab
+
+> Agent-first surface for Sprucelab. One install ships a typed CLI and an MCP
+> server — both wrapping the same public HTTP API. Drop in whichever transport
+> your agent host speaks.
+
+```bash
+pip install sprucelab
+```
+
+## Two transports, one package
+
+### `spruce` — typed CLI
+
+For terminal-resident agents (Claude Code, Aider, anything that drives a
+shell) and humans at the prompt. Every command supports `--json` for
+machine-readable output; mutations support `--dry-run` where applicable.
+
+```bash
+spruce auth register --token <YOUR_KEY> --url https://www.sprucelab.io
+spruce projects list --json
+spruce files upload ./models/foo.ifc --project-id <uuid> --wait
+spruce verify --model-id <uuid> --dry-run
+```
+
+Agents move through `spruce` faster than humans do — the rendering is for
+humans; agents read the JSON. Once an agent has worked out the right sequence
+of calls, the same commands run unattended from cron / GitHub Actions /
+Airflow without burning tokens — that's the whole point of headless-first.
+The AI budget stays reserved for actual reasoning work (claim extraction,
+type classification, verification), not for re-deriving the same script every
+run. See `spruce --help` for the full command tree.
+
+### `sprucelab-mcp` — MCP server over stdio
+
+For host-resident agents (Claude Desktop, Cursor, Continue, …) that launch
+tools as subprocesses and call them as typed tool calls.
+
+```json
+{
+  "mcpServers": {
+    "sprucelab": {
+      "command": "sprucelab-mcp",
+      "env": {
+        "SPRUCELAB_API_URL": "https://www.sprucelab.io",
+        "SPRUCELAB_API_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+The MCP server is a thin wrapper over the same HTTP surface the CLI talks
+to — the one advertised at <https://www.sprucelab.io/api/capabilities/>. No
+custom protocol, no surprises. If a tool fails, the error body is the literal
+API response.
+
+## Auth
+
+Read-only discovery (`capabilities`, `agent_tools_manifest`, EIR catalog,
+EIR presets) works without auth on either transport. Everything else needs
+a token.
+
+Get one via the web app at <https://www.sprucelab.io/agents>, then either:
+
+```bash
+spruce auth register --token <YOUR_KEY> --url https://www.sprucelab.io
+```
+
+…or set `SPRUCELAB_API_TOKEN` in the MCP env block above. The CLI and the
+MCP server read the same token store.
+
+For experimentation, the public sandbox token (read-only) is published on
+<https://www.sprucelab.io/agents>.
+
+## MCP tools
+
+Read-only discovery (no auth):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `capabilities()` | Fetch the full capabilities manifest. Always start here. |
+| `agent_tools_manifest()` | Fetch `/.well-known/agent-tools.json`. |
+| `eir_catalog()` | EIR rule grammar — every kind, fields, singleton flag. |
+| `eir_presets(preset?)` | Ready-to-seed EIR bundles. |
+
+Projects + EIR (Bearer):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `list_projects()`, `show_project(id)` | Project listing + detail. |
+| `scaffold_project(name, …)` | Create project + seed EIR in one call. |
+| `list_members(id)`, `add_member(id, email, role)`, `remove_member(id, member_id)` | Per-project membership. |
+| `mint_tenant_token(id, name, scope)`, `list_tenant_tokens(id)`, `revoke_tenant_token(id, token_id)` | Project-scoped agent tokens. |
+| `eir_rules(id)` | List the active EIR config's rules. |
+| `eir_apply_preset(id, preset, mode)` | Apply preset in merge or replace mode. |
+| `eir_add_rule(id, kind, config, upsert)` | Append one rule; singleton 409 unless `upsert=True`. |
+| `eir_remove_rule(id, rule_id)` | Idempotent rule delete. |
+| `eir_set_rules(id, rules)` | Atomic full replace. |
+
+Models + types + verification (Bearer):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `list_models(project_id?)` | List models in a project. |
+| `list_types(model_id)`, `classify_types(mappings)` | Type list + batch classify. |
+| `verify_dry_run(model_id)`, `verify_model(model_id)` | Verification, with persistence opt-in. |
+
+Files (Bearer):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `list_files(project_id?)`, `show_file(id)` | List + detail. |
+| `upload_file(project_id, file_path, on_duplicate)` | Multipart upload from a local path. |
+| `reprocess_file(id)` | Trigger a fresh ExtractionRun. |
+| `extraction_log(file_id, run_id?)` | Full ExtractionRun (log_entries + quality_report). |
+| `list_observations(project_id?)` | Layer-1 observation log. |
+
+Issues + scopes (Bearer):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `list_issues(…)`, `show_issue(id)`, `create_issue(…)`, `update_issue(…)`, `resolve_issue(id)` | Issue CRUD. |
+| `issues_from_verification(model_id)` | Route verification failures into issues. |
+| `list_scopes(project_id, as_tree)`, `create_scope(…)` | Federation scopes. |
+
+Webhooks (Bearer):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `list_webhooks(project_id?)` | List subscriptions. |
+| `create_webhook(project_id, target_url, events)` | Subscribe + receive signing secret ONCE. |
+| `disable_webhook(id, enable?)` | Toggle `is_active`. |
+| `delete_webhook(id)` | Permanent delete. |
+| `list_deliveries(id)`, `redeliver(delivery_id)`, `test_webhook(id)` | Delivery log + replay + synthetic test. |
+
+## Local-dev surface (`spruce dev …`)
+
+The CLI also ships a `dev` subcommand that bypasses the API and talks
+directly to a local Django install — for working *on* Sprucelab, not against
+prod. Same agent-first invariants (`--json` everywhere, `--dry-run` on
+mutations).
+
+```bash
+spruce dev env                                        # repo + service status
+spruce dev db stats --json                            # row counts for key tables
+spruce dev db materials --project <uuid> --top 15     # top materials per project
+spruce dev seed materials --project <uuid> --dry-run  # preview seed plan
+spruce dev test tsc                                   # frontend type-check
+spruce dev test e2e materials --headed                # Playwright smoke
+```
+
+## Powered by
+
+Sprucelab's IFC extraction layer is powered by
+[`ifcfast`](https://github.com/EdvardGK/ifcfast) — 25–47× faster than
+`ifcopenshell` on production IFCs. See
+<https://www.sprucelab.io/benchmarks>.

sprucelab-0.1.0/README.md

@@ -0,0 +1,158 @@
+# sprucelab
+
+> Agent-first surface for Sprucelab. One install ships a typed CLI and an MCP
+> server — both wrapping the same public HTTP API. Drop in whichever transport
+> your agent host speaks.
+
+```bash
+pip install sprucelab
+```
+
+## Two transports, one package
+
+### `spruce` — typed CLI
+
+For terminal-resident agents (Claude Code, Aider, anything that drives a
+shell) and humans at the prompt. Every command supports `--json` for
+machine-readable output; mutations support `--dry-run` where applicable.
+
+```bash
+spruce auth register --token <YOUR_KEY> --url https://www.sprucelab.io
+spruce projects list --json
+spruce files upload ./models/foo.ifc --project-id <uuid> --wait
+spruce verify --model-id <uuid> --dry-run
+```
+
+Agents move through `spruce` faster than humans do — the rendering is for
+humans; agents read the JSON. Once an agent has worked out the right sequence
+of calls, the same commands run unattended from cron / GitHub Actions /
+Airflow without burning tokens — that's the whole point of headless-first.
+The AI budget stays reserved for actual reasoning work (claim extraction,
+type classification, verification), not for re-deriving the same script every
+run. See `spruce --help` for the full command tree.
+
+### `sprucelab-mcp` — MCP server over stdio
+
+For host-resident agents (Claude Desktop, Cursor, Continue, …) that launch
+tools as subprocesses and call them as typed tool calls.
+
+```json
+{
+  "mcpServers": {
+    "sprucelab": {
+      "command": "sprucelab-mcp",
+      "env": {
+        "SPRUCELAB_API_URL": "https://www.sprucelab.io",
+        "SPRUCELAB_API_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+The MCP server is a thin wrapper over the same HTTP surface the CLI talks
+to — the one advertised at <https://www.sprucelab.io/api/capabilities/>. No
+custom protocol, no surprises. If a tool fails, the error body is the literal
+API response.
+
+## Auth
+
+Read-only discovery (`capabilities`, `agent_tools_manifest`, EIR catalog,
+EIR presets) works without auth on either transport. Everything else needs
+a token.
+
+Get one via the web app at <https://www.sprucelab.io/agents>, then either:
+
+```bash
+spruce auth register --token <YOUR_KEY> --url https://www.sprucelab.io
+```
+
+…or set `SPRUCELAB_API_TOKEN` in the MCP env block above. The CLI and the
+MCP server read the same token store.
+
+For experimentation, the public sandbox token (read-only) is published on
+<https://www.sprucelab.io/agents>.
+
+## MCP tools
+
+Read-only discovery (no auth):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `capabilities()` | Fetch the full capabilities manifest. Always start here. |
+| `agent_tools_manifest()` | Fetch `/.well-known/agent-tools.json`. |
+| `eir_catalog()` | EIR rule grammar — every kind, fields, singleton flag. |
+| `eir_presets(preset?)` | Ready-to-seed EIR bundles. |
+
+Projects + EIR (Bearer):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `list_projects()`, `show_project(id)` | Project listing + detail. |
+| `scaffold_project(name, …)` | Create project + seed EIR in one call. |
+| `list_members(id)`, `add_member(id, email, role)`, `remove_member(id, member_id)` | Per-project membership. |
+| `mint_tenant_token(id, name, scope)`, `list_tenant_tokens(id)`, `revoke_tenant_token(id, token_id)` | Project-scoped agent tokens. |
+| `eir_rules(id)` | List the active EIR config's rules. |
+| `eir_apply_preset(id, preset, mode)` | Apply preset in merge or replace mode. |
+| `eir_add_rule(id, kind, config, upsert)` | Append one rule; singleton 409 unless `upsert=True`. |
+| `eir_remove_rule(id, rule_id)` | Idempotent rule delete. |
+| `eir_set_rules(id, rules)` | Atomic full replace. |
+
+Models + types + verification (Bearer):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `list_models(project_id?)` | List models in a project. |
+| `list_types(model_id)`, `classify_types(mappings)` | Type list + batch classify. |
+| `verify_dry_run(model_id)`, `verify_model(model_id)` | Verification, with persistence opt-in. |
+
+Files (Bearer):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `list_files(project_id?)`, `show_file(id)` | List + detail. |
+| `upload_file(project_id, file_path, on_duplicate)` | Multipart upload from a local path. |
+| `reprocess_file(id)` | Trigger a fresh ExtractionRun. |
+| `extraction_log(file_id, run_id?)` | Full ExtractionRun (log_entries + quality_report). |
+| `list_observations(project_id?)` | Layer-1 observation log. |
+
+Issues + scopes (Bearer):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `list_issues(…)`, `show_issue(id)`, `create_issue(…)`, `update_issue(…)`, `resolve_issue(id)` | Issue CRUD. |
+| `issues_from_verification(model_id)` | Route verification failures into issues. |
+| `list_scopes(project_id, as_tree)`, `create_scope(…)` | Federation scopes. |
+
+Webhooks (Bearer):
+
+| Tool | Purpose |
+| ---- | ------- |
+| `list_webhooks(project_id?)` | List subscriptions. |
+| `create_webhook(project_id, target_url, events)` | Subscribe + receive signing secret ONCE. |
+| `disable_webhook(id, enable?)` | Toggle `is_active`. |
+| `delete_webhook(id)` | Permanent delete. |
+| `list_deliveries(id)`, `redeliver(delivery_id)`, `test_webhook(id)` | Delivery log + replay + synthetic test. |
+
+## Local-dev surface (`spruce dev …`)
+
+The CLI also ships a `dev` subcommand that bypasses the API and talks
+directly to a local Django install — for working *on* Sprucelab, not against
+prod. Same agent-first invariants (`--json` everywhere, `--dry-run` on
+mutations).
+
+```bash
+spruce dev env                                        # repo + service status
+spruce dev db stats --json                            # row counts for key tables
+spruce dev db materials --project <uuid> --top 15     # top materials per project
+spruce dev seed materials --project <uuid> --dry-run  # preview seed plan
+spruce dev test tsc                                   # frontend type-check
+spruce dev test e2e materials --headed                # Playwright smoke
+```
+
+## Powered by
+
+Sprucelab's IFC extraction layer is powered by
+[`ifcfast`](https://github.com/EdvardGK/ifcfast) — 25–47× faster than
+`ifcopenshell` on production IFCs. See
+<https://www.sprucelab.io/benchmarks>.

sprucelab-0.1.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sprucelab"
+version = "0.1.0"
+description = "Agent-first surface for Sprucelab — typed CLI + MCP server over the same public HTTP API."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "Sprucelab" }]
+keywords = [
+    "bim",
+    "ifc",
+    "mcp",
+    "agent",
+    "agentic",
+    "automation",
+    "claude",
+    "cursor",
+    "cli",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "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",
+]
+
+dependencies = [
+    # MCP transport — host-resident agents (Claude Desktop, Cursor, …).
+    "mcp>=1.0.0",
+    # CLI transport — terminal-resident agents (Claude Code, Aider, …)
+    # and humans at the prompt.
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "pyyaml>=6.0",
+    "keyring>=24.0.0",
+    # Shared HTTP layer.
+    "httpx>=0.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "respx>=0.20.0",
+]
+
+[project.urls]
+Homepage = "https://www.sprucelab.io/agents"
+Benchmarks = "https://www.sprucelab.io/benchmarks"
+Source = "https://github.com/EdvardGK/sprucelab"
+
+[project.scripts]
+sprucelab-mcp = "sprucelab.mcp.server:main"
+spruce = "sprucelab.cli.app:app"
+
+[tool.hatch.build.targets.wheel]
+packages = ["sprucelab"]

sprucelab-0.1.0/pytest.ini

@@ -0,0 +1,13 @@
+[pytest]
+python_files = test_*.py
+python_classes = Test*
+python_functions = test_*
+testpaths = tests
+addopts =
+    -ra
+    --strict-markers
+    --tb=short
+markers =
+    live: opt-in live-API smoke test (requires SPRUCE_LIVE_API_URL; never runs in CI)
+filterwarnings =
+    ignore::DeprecationWarning