spruce-grove 1.0.1__tar.gz

spruce_grove-1.0.1/.gitignore

@@ -0,0 +1,70 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+.coverage
+coverage.json
+
+# Session memory
+.puppy_session_memory.json
+
+# Pytest cache
+.pytest_cache/
+
+dummy_path
+
+.idea/
+
+.DS_Store
+.env
+.serena/
+.beads/
+main.dist/
+nuitka-crash-report.xml
+*.backup
+main.bin
+
+# Session log dumps (auto-committed by updater; not source)
+NEWLog*.txt
+
+# Bundled skills removed — skills are now fetched from remote catalog
+code_puppy/bundled_skills/
+
+# Hook engine runtime artifacts (logs, compiled outputs)
+.claude/activity.jsonl
+.claude/hooks/audit.log
+
+# Compiled hook binaries (built from .go sources in .claude/hooks/go-hooks/)
+.claude/hooks/go-hooks/audit-bash
+.claude/hooks/go-hooks/file-policy
+
+# Compiled TypeScript hook output (built from .ts sources)
+.claude/hooks/ts-hooks/dist/
+
+.json
+
+.state/
+
+# Local git worktrees
+.worktrees/
+
+# Cancel-wedge repro harness output (scripts/repro_cancel_wedge.py)
+wedge_artifacts/
+wedge_soak.log
+
+# Personal voice memo + local transcript (never publish — repo is public)
+MASTER-MASTER-PROMPT.m4a
+MASTER-MASTER-PROMPT.txt
+MASTER-MASTER-PROMPT.srt
+
+# Beads / Dolt files (added by bd init)
+.dolt/
+*.db
+.beads-credential-key

spruce_grove-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mike Pfaffenberger
+
+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.

spruce_grove-1.0.1/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.5
+Name: spruce-grove
+Version: 1.0.1
+Summary: Spruce Grove OS - an agentic coding CLI distribution inspired by Code Puppy. Together we are better. Always.
+Project-URL: repository, https://github.com/t-granlund/SPRUCE-GROVE-OS
+Project-URL: HomePage, https://tylergranlund.com
+Author: Michael Pfaffenberger
+Author-email: Tyler Granlund <hello@tylergranlund.com>
+License: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: <3.15,>=3.11
+Requires-Dist: agent-client-protocol<0.12,>=0.11.0
+Requires-Dist: anthropic<2,>=1.0.0
+Requires-Dist: anyio>=4.7.0
+Requires-Dist: azure-identity>=1.15.0
+Requires-Dist: boto3>=1.43.9
+Requires-Dist: code-puppy-core-plugins>=0.0.45
+Requires-Dist: httpx2>=2.7
+Requires-Dist: httpx[http2]>=0.24.1
+Requires-Dist: json-repair>=0.46.2
+Requires-Dist: keyring>=24.0.0
+Requires-Dist: logfire>=4.0
+Requires-Dist: mcp>=1.9.4
+Requires-Dist: openai>=2.45.0
+Requires-Dist: packaging>=24.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: playwright>=1.40.0; sys_platform != 'android'
+Requires-Dist: pydantic-ai-harness==0.23.0
+Requires-Dist: pydantic-ai-slim[anthropic,mcp,openai]==2.35.0
+Requires-Dist: pydantic>=2.4.0
+Requires-Dist: pyfiglet>=0.8.post1
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rapidfuzz>=3.13.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: rich>=13.4.2
+Requires-Dist: ripgrep==14.1.0; sys_platform != 'android'
+Requires-Dist: termflow-md>=0.9.1
+Requires-Dist: typer>=0.12.0
+Provides-Extra: bedrock
+Requires-Dist: boto3>=1.35.0; extra == 'bedrock'
+Provides-Extra: computer-use
+Requires-Dist: pyobjc-framework-applicationservices>=10.3; (sys_platform == 'darwin') and extra == 'computer-use'
+Requires-Dist: pyobjc-framework-cocoa>=10.3; (sys_platform == 'darwin') and extra == 'computer-use'
+Requires-Dist: pyobjc-framework-quartz>=10.3; (sys_platform == 'darwin') and extra == 'computer-use'
+Provides-Extra: durable
+Requires-Dist: dbos>=2.11.0; extra == 'durable'
+Description-Content-Type: text/markdown
+
+# SPRUCE GROVE OS
+
+<p align="center">
+  <img src="logos/spruce_grove_logo_withback.jpeg" alt="The Spruce Grove mark - three geometric spruces in brand greens on charcoal" width="260">
+</p>
+
+**gran · lund · sv. · spruce grove** — an agentic coding CLI grown in the grove.
+
+> Together we are better. Always.
+
+![License: MIT](https://img.shields.io/badge/license-MIT-2D4F3A)
+![Python 3.11–3.14](https://img.shields.io/badge/python-3.11--3.14-588F5E)
+![Tests: 7700 passing](https://img.shields.io/badge/tests-7700%20passing-D2A069)
+![Inspired by Code Puppy](https://img.shields.io/badge/inspired%20by-Code%20Puppy-F0E1C8)
+
+Spruce Grove OS is a full custom instance of an agentic coding assistant:
+the same engine, frameworks, plugins, agents, tools, skills, MCP plumbing,
+and TUI as the project it is inspired by — replanted around one grove's
+vision, mission, and values.
+
+## Inspired by Code Puppy
+
+Every trail in this grove started as a Code Puppy trail. Spruce Grove OS is
+built directly from — and stays import-compatible with — **Code Puppy** by
+[Michael Pfaffenberger](https://github.com/mpfaffenberger/code_puppy)
+(MIT licensed). Huge respect to the original project and its contributors;
+this grove exists because the puppy shared everything. Exact lineage, sync
+points, and the full rename/contract map: [PROVENANCE.md](PROVENANCE.md).
+
+## The ethos of the grove
+
+Three sources, one creed — [ETHOS.md](ETHOS.md):
+
+1. **Ozark Bagels — how to carry yourself.** Be first to say hello. Be kinder
+   than necessary. Be tough minded, but tender hearted. Leave everything
+   better than you found it. Spread joy, love, and cream cheese.
+2. **The Junto (1727) — how to think with others.** Love truth for truth's
+   sake. No invented facts — ever; cite or flag "NOT VERIFIED". Provisional
+   phrasing over contradiction combat. Pragmatism over metaphysics.
+3. **gran·lund — who is doing the carrying.** Help people solve problems.
+   Remove technology obstacles. Meet people where they are, as humans.
+
+## Meet Cedar
+
+The default agent persona is **Cedar**, the grove guide — same competent
+agent core, new disposition: candid about code, gentle with people, allergic
+to invented facts. Rename it anytime in `grove.cfg`.
+
+---
+
+## Design system
+
+Nordic forest, dark-first. Charcoal base, deep spruce, warm cedar accents,
+mist typography. Tokens shared with
+[tylergranlund.com](https://tylergranlund.com) — the same palette that colors
+the terminal splash.
+
+### Color tokens
+
+| Token | OKLCH | Role | Chip |
+|---|---|---|---|
+| charcoal | `oklch(0.18 0.012 150)` | base background | ![#1d211e](https://img.shields.io/badge/-%23001D21-1d211e) |
+| spruce-deep | `oklch(0.22 0.03 158)` | deep brand layer | ![#20392b](https://img.shields.io/badge/-%2320392B-20392b) |
+| spruce | `oklch(0.32 0.045 158)` | primary brand | ![#2d4f3a](https://img.shields.io/badge/-%232D4F3A-2d4f3a) |
+| moss | `oklch(0.45 0.06 155)` | accent green | ![#588f5e](https://img.shields.io/badge/-%23588F5E-588f5e) |
+| cedar | `oklch(0.78 0.12 55)` | warm accent, persona | ![#d2a069](https://img.shields.io/badge/-%23D2A069-d2a069) |
+| bark | `oklch(0.32 0.025 60)` | earthy neutral | ![#4d4136](https://img.shields.io/badge/-%234D4136-4d4136) |
+| stone | `oklch(0.85 0.012 90)` | soft UI text | ![#d6d2c8](https://img.shields.io/badge/-%23D6D2C8-d6d2c8) |
+| mist | `oklch(0.94 0.008 100)` | foreground/typography | ![#f0e1c8](https://img.shields.io/badge/-%23F0E1C8-f0e1c8) |
+
+### Typography
+
+- **Fraunces** (variable serif) — wordmarks and display
+- **Inter** — body copy
+- **JetBrains Mono** — code, CLI output
+
+### Terminal theming
+
+The boot splash renders a shimmering pyramid + figlet lockup
+("SPRUCE GROVE", compact "GROVE" on narrow terminals) in a truecolor
+canopy-to-cedar gradient: halo `#2D4F3A` → glow `#588F5E` → core `#D2A069`,
+with a mist-white crest (`#F0E1C8`) where the sheen passes. ANSI fallbacks
+step down through green → bright green → yellow.
+
+### Voice
+
+Plain-spoken, warm, a little playful. First to say hello. Candid, never
+roasty. Zero invented facts — "NOT VERIFIED" beats a confident guess.
+
+Full tokens and voice guide: [BRAND.md](BRAND.md).
+
+---
+
+## What's inside (same bones as Code Puppy)
+
+```
+┌──────────────────────────────────────────────────┐
+│  TUI / CLI  (command_line/)                      │
+├──────────────────────────────────────────────────┤
+│  Agent Layer  (agents/)  — Cedar default + JSON  │
+├──────────────────────────────────────────────────┤
+│  Tool Layer  (tools/)    — TOOL_REGISTRY         │
+├──────────────────────────────────────────────────┤
+│  Plugin Layer  (plugins/, callbacks.py)          │
+├──────────────────────────────────────────────────┤
+│  Model Layer  (model_factory.py)                 │
+├──────────────────────────────────────────────────┤
+│  pydantic-ai + MCP (external)                    │
+└──────────────────────────────────────────────────┘
+```
+
+Python 3.11–3.14 · pydantic-ai · pluggable models (OpenAI, Anthropic,
+Gemini, Bedrock, Z.AI, custom endpoints) · MCP servers · skills with
+namespaces · session history + compaction · i18n.
+
+## Install & run
+
+```bash
+git clone https://github.com/t-granlund/SPRUCE-GROVE-OS
+cd SPRUCE-GROVE-OS
+uv sync
+uv run spruce-grove        # or: uv run grove
+```
+
+Config: `~/.spruce_grove/grove.cfg` · Env vars: `SPRUCE_GROVE_*`.
+
+## Code Puppy compatibility
+
+- `code_puppy.*` imports (e.g. from `code-puppy-core-plugins`) resolve to
+  `spruce_grove.*` via an import shim with true module identity.
+- The plugin entry-point group `code_puppy.plugins` is intentionally retained.
+- Legacy aliases kept: `agent_code_puppy`, `CodePuppyAgent`,
+  `get_puppy_name()`, persisted `puppy_name` fallback.
+- Full contract ledger: [PROVENANCE.md](PROVENANCE.md).
+
+## License
+
+MIT — inherited from Code Puppy. See [LICENSE](LICENSE) and attribution in
+[PROVENANCE.md](PROVENANCE.md).

spruce_grove-1.0.1/README.md

@@ -0,0 +1,139 @@
+# SPRUCE GROVE OS
+
+<p align="center">
+  <img src="logos/spruce_grove_logo_withback.jpeg" alt="The Spruce Grove mark - three geometric spruces in brand greens on charcoal" width="260">
+</p>
+
+**gran · lund · sv. · spruce grove** — an agentic coding CLI grown in the grove.
+
+> Together we are better. Always.
+
+![License: MIT](https://img.shields.io/badge/license-MIT-2D4F3A)
+![Python 3.11–3.14](https://img.shields.io/badge/python-3.11--3.14-588F5E)
+![Tests: 7700 passing](https://img.shields.io/badge/tests-7700%20passing-D2A069)
+![Inspired by Code Puppy](https://img.shields.io/badge/inspired%20by-Code%20Puppy-F0E1C8)
+
+Spruce Grove OS is a full custom instance of an agentic coding assistant:
+the same engine, frameworks, plugins, agents, tools, skills, MCP plumbing,
+and TUI as the project it is inspired by — replanted around one grove's
+vision, mission, and values.
+
+## Inspired by Code Puppy
+
+Every trail in this grove started as a Code Puppy trail. Spruce Grove OS is
+built directly from — and stays import-compatible with — **Code Puppy** by
+[Michael Pfaffenberger](https://github.com/mpfaffenberger/code_puppy)
+(MIT licensed). Huge respect to the original project and its contributors;
+this grove exists because the puppy shared everything. Exact lineage, sync
+points, and the full rename/contract map: [PROVENANCE.md](PROVENANCE.md).
+
+## The ethos of the grove
+
+Three sources, one creed — [ETHOS.md](ETHOS.md):
+
+1. **Ozark Bagels — how to carry yourself.** Be first to say hello. Be kinder
+   than necessary. Be tough minded, but tender hearted. Leave everything
+   better than you found it. Spread joy, love, and cream cheese.
+2. **The Junto (1727) — how to think with others.** Love truth for truth's
+   sake. No invented facts — ever; cite or flag "NOT VERIFIED". Provisional
+   phrasing over contradiction combat. Pragmatism over metaphysics.
+3. **gran·lund — who is doing the carrying.** Help people solve problems.
+   Remove technology obstacles. Meet people where they are, as humans.
+
+## Meet Cedar
+
+The default agent persona is **Cedar**, the grove guide — same competent
+agent core, new disposition: candid about code, gentle with people, allergic
+to invented facts. Rename it anytime in `grove.cfg`.
+
+---
+
+## Design system
+
+Nordic forest, dark-first. Charcoal base, deep spruce, warm cedar accents,
+mist typography. Tokens shared with
+[tylergranlund.com](https://tylergranlund.com) — the same palette that colors
+the terminal splash.
+
+### Color tokens
+
+| Token | OKLCH | Role | Chip |
+|---|---|---|---|
+| charcoal | `oklch(0.18 0.012 150)` | base background | ![#1d211e](https://img.shields.io/badge/-%23001D21-1d211e) |
+| spruce-deep | `oklch(0.22 0.03 158)` | deep brand layer | ![#20392b](https://img.shields.io/badge/-%2320392B-20392b) |
+| spruce | `oklch(0.32 0.045 158)` | primary brand | ![#2d4f3a](https://img.shields.io/badge/-%232D4F3A-2d4f3a) |
+| moss | `oklch(0.45 0.06 155)` | accent green | ![#588f5e](https://img.shields.io/badge/-%23588F5E-588f5e) |
+| cedar | `oklch(0.78 0.12 55)` | warm accent, persona | ![#d2a069](https://img.shields.io/badge/-%23D2A069-d2a069) |
+| bark | `oklch(0.32 0.025 60)` | earthy neutral | ![#4d4136](https://img.shields.io/badge/-%234D4136-4d4136) |
+| stone | `oklch(0.85 0.012 90)` | soft UI text | ![#d6d2c8](https://img.shields.io/badge/-%23D6D2C8-d6d2c8) |
+| mist | `oklch(0.94 0.008 100)` | foreground/typography | ![#f0e1c8](https://img.shields.io/badge/-%23F0E1C8-f0e1c8) |
+
+### Typography
+
+- **Fraunces** (variable serif) — wordmarks and display
+- **Inter** — body copy
+- **JetBrains Mono** — code, CLI output
+
+### Terminal theming
+
+The boot splash renders a shimmering pyramid + figlet lockup
+("SPRUCE GROVE", compact "GROVE" on narrow terminals) in a truecolor
+canopy-to-cedar gradient: halo `#2D4F3A` → glow `#588F5E` → core `#D2A069`,
+with a mist-white crest (`#F0E1C8`) where the sheen passes. ANSI fallbacks
+step down through green → bright green → yellow.
+
+### Voice
+
+Plain-spoken, warm, a little playful. First to say hello. Candid, never
+roasty. Zero invented facts — "NOT VERIFIED" beats a confident guess.
+
+Full tokens and voice guide: [BRAND.md](BRAND.md).
+
+---
+
+## What's inside (same bones as Code Puppy)
+
+```
+┌──────────────────────────────────────────────────┐
+│  TUI / CLI  (command_line/)                      │
+├──────────────────────────────────────────────────┤
+│  Agent Layer  (agents/)  — Cedar default + JSON  │
+├──────────────────────────────────────────────────┤
+│  Tool Layer  (tools/)    — TOOL_REGISTRY         │
+├──────────────────────────────────────────────────┤
+│  Plugin Layer  (plugins/, callbacks.py)          │
+├──────────────────────────────────────────────────┤
+│  Model Layer  (model_factory.py)                 │
+├──────────────────────────────────────────────────┤
+│  pydantic-ai + MCP (external)                    │
+└──────────────────────────────────────────────────┘
+```
+
+Python 3.11–3.14 · pydantic-ai · pluggable models (OpenAI, Anthropic,
+Gemini, Bedrock, Z.AI, custom endpoints) · MCP servers · skills with
+namespaces · session history + compaction · i18n.
+
+## Install & run
+
+```bash
+git clone https://github.com/t-granlund/SPRUCE-GROVE-OS
+cd SPRUCE-GROVE-OS
+uv sync
+uv run spruce-grove        # or: uv run grove
+```
+
+Config: `~/.spruce_grove/grove.cfg` · Env vars: `SPRUCE_GROVE_*`.
+
+## Code Puppy compatibility
+
+- `code_puppy.*` imports (e.g. from `code-puppy-core-plugins`) resolve to
+  `spruce_grove.*` via an import shim with true module identity.
+- The plugin entry-point group `code_puppy.plugins` is intentionally retained.
+- Legacy aliases kept: `agent_code_puppy`, `CodePuppyAgent`,
+  `get_puppy_name()`, persisted `puppy_name` fallback.
+- Full contract ledger: [PROVENANCE.md](PROVENANCE.md).
+
+## License
+
+MIT — inherited from Code Puppy. See [LICENSE](LICENSE) and attribution in
+[PROVENANCE.md](PROVENANCE.md).

spruce_grove-1.0.1/pyproject.toml

@@ -0,0 +1,121 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "spruce-grove"
+version = "1.0.1"
+description = "Spruce Grove OS - an agentic coding CLI distribution inspired by Code Puppy. Together we are better. Always."
+readme = "README.md"
+requires-python = ">=3.11,<3.15"
+dependencies = [
+    "code-puppy-core-plugins>=0.0.45",
+    "logfire>=4.0",
+    "pydantic-ai-slim[openai,anthropic,mcp]==2.35.0",
+    "pydantic-ai-harness==0.23.0",
+    "anyio>=4.7.0",
+    "typer>=0.12.0",
+    "mcp>=1.9.4",
+    "httpx[http2]>=0.24.1",
+    "httpx2>=2.7",
+    "requests>=2.28.0",
+    "packaging>=24.0",
+    "rich>=13.4.2",
+    "pydantic>=2.4.0",
+    "python-dotenv>=1.0.0",
+    "json-repair>=0.46.2",
+    "pyfiglet>=0.8.post1",
+    "rapidfuzz>=3.13.0",
+    "openai>=2.45.0",
+    "ripgrep==14.1.0; sys_platform != 'android'",
+    "playwright>=1.40.0; sys_platform != 'android'",
+    "termflow-md>=0.9.1",
+    "Pillow>=10.0.0",
+    "azure-identity>=1.15.0",
+    "anthropic>=1.0.0,<2",
+    "boto3>=1.43.9",
+    "keyring>=24.0.0",
+    "agent-client-protocol>=0.11.0,<0.12",
+]
+dev-dependencies = [
+    "pytest>=8.3.4",
+    "pytest-cov>=6.1.1",
+    "pytest-asyncio>=0.23.1",
+    "ruff>=0.15,<0.16",
+    "pexpect>=4.9.0",
+]
+authors = [
+    {name = "Tyler Granlund", email = "hello@tylergranlund.com"},
+    {name = "Michael Pfaffenberger"}  # original author of Code Puppy, the project this is inspired by and built from
+]
+license = {text = "MIT"}
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Code Generators",
+]
+
+[project.optional-dependencies]
+bedrock = ["boto3>=1.35.0"]
+durable = ["dbos>=2.11.0"]
+computer-use = [
+    "pyobjc-framework-ApplicationServices>=10.3; sys_platform == 'darwin'",
+    "pyobjc-framework-Cocoa>=10.3; sys_platform == 'darwin'",
+    "pyobjc-framework-Quartz>=10.3; sys_platform == 'darwin'",
+]
+
+[project.urls]
+repository = "https://github.com/t-granlund/SPRUCE-GROVE-OS"
+HomePage = "https://tylergranlund.com"
+
+
+[project.scripts]
+spruce-grove = "spruce_grove.main:main_entry"
+grove = "spruce_grove.main:main_entry"
+
+[tool.logfire]
+ignore_no_config = true
+
+[tool.hatch.build]
+packages = ["spruce_grove"]
+
+[tool.hatch.build.targets.wheel.shared-data]
+"spruce_grove/models.json" = "spruce_grove/models.json"
+"spruce_grove/models_dev_api.json" = "spruce_grove/models_dev_api.json"
+
+[[tool.hatch.build.targets.sdist.include]]
+path = "spruce_grove/models.json"
+
+[[tool.hatch.build.targets.sdist.include]]
+path = "spruce_grove/models_dev_api.json"
+
+[tool.ruff.lint.per-file-ignores]
+"spruce_grove/__init__.py" = ["E402"]
+"spruce_grove/main.py" = ["E402"]
+"spruce_grove/cli_runner.py" = ["E402"]
+"spruce_grove/messaging/__init__.py" = ["E402"]
+
+[tool.pytest.ini_options]
+addopts = "--cov=spruce_grove --cov-report=term-missing"
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.coverage.run]
+omit = ["spruce_grove/main.py"]
+
+[tool.uv]
+python-preference = "only-managed"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3.4",
+    "pytest-cov>=6.1.1",
+    "pytest-asyncio>=0.23.1",
+    "ruff>=0.15,<0.16",
+    "pexpect>=4.9.0",
+    "pyte>=0.8.2",
+]

spruce_grove-1.0.1/spruce_grove/__init__.py

@@ -0,0 +1,42 @@
+"""Installed distribution metadata for Spruce Grove."""
+
+import importlib.metadata
+
+from packaging.version import Version
+
+
+def _get_distribution_version(
+    distribution_name: str, fallback: str | None = None
+) -> str | None:
+    """Return an installed distribution version or a stable fallback."""
+    try:
+        detected_version = importlib.metadata.version(distribution_name)
+        return detected_version if detected_version else fallback
+    except Exception:
+        return fallback
+
+
+def get_core_plugins_version() -> str | None:
+    """Return the valid installed official core-plugin bundle version."""
+    detected_version = _get_distribution_version("code-puppy-core-plugins")
+    if not isinstance(detected_version, str):
+        return None
+
+    try:
+        normalized_version = detected_version.strip()
+        if not normalized_version:
+            return None
+        Version(normalized_version)
+    except Exception:
+        return None
+
+    return normalized_version
+
+
+# Planted in the grove. -Cedar
+__version__ = _get_distribution_version("spruce-grove", "0.0.0-dev")
+
+from spruce_grove._code_puppy_compat import install as _install_legacy_shim
+
+_install_legacy_shim()
+del _install_legacy_shim

spruce_grove-1.0.1/spruce_grove/__main__.py

@@ -0,0 +1,10 @@
+"""
+Entry point for running spruce-grove as a module.
+
+This allows the package to be run with: python -m spruce_grove
+"""
+
+from spruce_grove.main import main_entry
+
+if __name__ == "__main__":
+    main_entry()