zenith-template 0.2.0__tar.gz

zenith_template-0.2.0/.agents/skills/guide-ste100/LICENSE

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

zenith_template-0.2.0/.gitignore

@@ -0,0 +1,90 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+codecov*
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Documentation generator build artifacts
+site/
+docs/_build/
+
+# Jupyter / IPython
+.ipynb_checkpoints
+profile_default/
+ipython_config.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Quality & Tooling caches
+.ruff_cache/
+.rumdl_cache/
+.complexipy_cache/
+.pyrefly/
+.tach_cache/
+.temp/
+.specs/
+.aider*
+!.aider.conf.yml
+
+# IDEs & Editors
+.idea/
+.vscode/*
+!.vscode/extensions.json
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+
+# Agent skills tracked ledgers
+!.agents/skills/inspect-module-setup/*.log

zenith_template-0.2.0/LICENSE

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

zenith_template-0.2.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.5
+Name: zenith-template
+Version: 0.2.0
+Summary: Zenith: An opinionated, strict Cookiecutter template for modern Python projects using uv, ruff, pyrefly, complexipy, zensical, rumdl, tach, deptry, and poethepoet.
+Project-URL: Homepage, https://github.com/bwrob/zenith
+Project-URL: Repository, https://github.com/bwrob/zenith.git
+Author-email: bwrob <contact@bwrob.dev>
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: cookiecutter>=2.7.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rich>=15.0.0
+Requires-Dist: textual>=8.2.8
+Description-Content-Type: text/markdown
+
+# Zenith
+
+<p align="center">
+  <img src="assets/zenith-star.svg" alt="Zenith Emblem" width="160">
+</p>
+
+[![Template: Cookiecutter](https://img.shields.io/badge/template-cookiecutter-D4B830.svg)](https://github.com/cookiecutter/cookiecutter)
+[![Python: 3.12+](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14%20%7C%203.15-blue.svg)](https://www.python.org/)
+[![Package Manager: uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Code Style: Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Type Checked: Pyrefly](https://img.shields.io/badge/types-pyrefly%20strict-blueviolet.svg)](https://github.com/facebook/pyrefly)
+[![Documentation: Zensical](https://img.shields.io/badge/docs-zensical-teal.svg)](https://github.com/zensical/zensical)
+[![Markdown: rumdl](https://img.shields.io/badge/markdown-rumdl-orange.svg)](https://github.com/rvben/rumdl)
+[![Spelling: typos](https://img.shields.io/badge/spelling-typos-blue.svg)](https://github.com/crate-ci/typos)
+[![Complexity: complexipy](https://img.shields.io/badge/complexity-complexipy-crimson.svg)](https://github.com/rohaquinlop/complexipy)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+An opinionated Cookiecutter template for modern Python 3.12+ projects, built with
+Rust-based developer tooling, autonomous AI agent workflows, and automated quality
+guardrails.
+
+## Elevator Pitch
+
+Starting a new Python project usually means spending days wiring up linters, formatters,
+type checkers, test coverage, and documentation generators—or copying decaying configs
+from older repos and fixing whatever broke.
+
+Zenith scaffolds a production-ready repository in seconds:
+
+- **⚡ Modern Rust-Based Tooling**: Fast package management with `uv`, linting and
+  formatting with `ruff`, strict type checking with Meta's `pyrefly`, modular boundaries
+  with `tach`, cognitive complexity limits with `complexipy`, and documentation with
+  `zensical`.
+- **🤖 First-Class AI Agent Readiness**: Autonomous agent context discovery
+  (`AGENTS.md`), modular lifecycle skills in `.agents/skills/`, machine-readable
+  `llms.txt`, and clear AI governance policies.
+- **🛡️ Strict Quality Guardrails**: 100% statement and branch test coverage
+  (`fail_under = 100`), strict typing, and automated CI security analysis with `zizmor`.
+- **🚀 Hermetic Delivery & CI/CD**: Matrix testing across Python 3.12–3.15, isolated
+  wheel package smoke tests, and automated PyPI Trusted Publishing.
+
+> [!NOTE]
+> **Project Scope**: Zenith is built for serious production packages, services, and
+> libraries intended for long-term maintenance by teams of humans and AI agents. It is
+> **deliberately not suited** for small two-script throwaway hacks where strict
+> guardrails feel like friction.
+
+## 📖 Documentation
+
+For full guides, detailed architectural deep-dives, and tool configurations, visit the
+**[Zenith Documentation Website](https://bwrob.github.io/zenith/)**.
+
+- **[First Steps & Core Concepts](https://bwrob.github.io/zenith/first-steps/)**:
+  Plain-English onboarding for developers new to modern Python tooling.
+- **[Philosophy & Sizing](https://bwrob.github.io/zenith/philosophy/)**: Modern tooling,
+  AI readiness, quality guardrails, and project sizing rubric.
+- **[CLI Architecture](https://bwrob.github.io/zenith/tools/typer/)**: Typer CLI
+  structure, Rich terminal rendering, and animated Termynal demos.
+- **[Tooling Stack Reference](https://bwrob.github.io/zenith/tools/)**: In-depth
+  explanations, configuration breakdowns, and upstream links for the integrated tool
+  stack.
+- **[Agent Skills Architecture](https://bwrob.github.io/zenith/skills/)**: Lifecycle
+  workflows for autonomous coding assistants in `.agents/skills/`.
+- **[CI/CD Pipelines](https://bwrob.github.io/zenith/ci-actions/)**: GitHub Actions test
+  matrix across Python 3.12–3.15, wheel smoke testing, and supply-chain protection.
+- **[Changelog](https://bwrob.github.io/zenith/changelog/)**: Release history and
+  version notes.
+
+## Quick Start
+
+Launch the interactive **Zenith Terminal Setup Wizard** directly via `uvx`:
+
+```bash
+uvx zenith-template
+```
+
+For headless automation or CI pipelines, pass `--no-input` and configuration flags:
+
+```bash
+uvx zenith-template --no-input --name "My Service" --ai-tools recommended --sync
+```
+
+Or scaffold directly with raw `cookiecutter`:
+
+```bash
+uvx cookiecutter https://github.com/bwrob/zenith.git
+```
+
+### Initializing the Project
+
+```bash
+cd my-project
+uv sync                     # Skip if you checked "Run uv sync" or passed --sync
+uv run poe test             # Runs test suite (100% coverage enforced)
+uv run poe code-quality     # Runs full linter, formatter, type, and complexity gate
+uv run poe docs-serve       # Starts live-reloading documentation server
+```
+
+## Essential Tasks
+
+Every workflow in Zenith is codified through **Poe the Poet** (`uv run poe <task>`):
+
+| Task                      | What it does                                                                       |
+| ------------------------- | ---------------------------------------------------------------------------------- |
+| `uv run poe test`         | Runs pytest suite enforcing 100% statement and branch coverage                     |
+| `uv run poe test-fast`    | Runs tests in parallel across CPU cores with `pytest-xdist`                        |
+| `uv run poe code-quality` | Complete quality check: lint, format, TOML/YAML/CSS, types, complexity, boundaries |
+| `uv run poe fix`          | Auto-fixes lint violations, formatting, markdown, and typos                        |
+| `uv run poe docs-serve`   | Starts local Zensical live-reloading documentation dev server                      |
+| `uv run poe docs-build`   | Builds production static HTML documentation site into `site/` with strict checks   |
+
+## License
+
+Distributed under the [MIT License](LICENSE).

zenith_template-0.2.0/README.md

@@ -0,0 +1,114 @@
+# Zenith
+
+<p align="center">
+  <img src="assets/zenith-star.svg" alt="Zenith Emblem" width="160">
+</p>
+
+[![Template: Cookiecutter](https://img.shields.io/badge/template-cookiecutter-D4B830.svg)](https://github.com/cookiecutter/cookiecutter)
+[![Python: 3.12+](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14%20%7C%203.15-blue.svg)](https://www.python.org/)
+[![Package Manager: uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Code Style: Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Type Checked: Pyrefly](https://img.shields.io/badge/types-pyrefly%20strict-blueviolet.svg)](https://github.com/facebook/pyrefly)
+[![Documentation: Zensical](https://img.shields.io/badge/docs-zensical-teal.svg)](https://github.com/zensical/zensical)
+[![Markdown: rumdl](https://img.shields.io/badge/markdown-rumdl-orange.svg)](https://github.com/rvben/rumdl)
+[![Spelling: typos](https://img.shields.io/badge/spelling-typos-blue.svg)](https://github.com/crate-ci/typos)
+[![Complexity: complexipy](https://img.shields.io/badge/complexity-complexipy-crimson.svg)](https://github.com/rohaquinlop/complexipy)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+An opinionated Cookiecutter template for modern Python 3.12+ projects, built with
+Rust-based developer tooling, autonomous AI agent workflows, and automated quality
+guardrails.
+
+## Elevator Pitch
+
+Starting a new Python project usually means spending days wiring up linters, formatters,
+type checkers, test coverage, and documentation generators—or copying decaying configs
+from older repos and fixing whatever broke.
+
+Zenith scaffolds a production-ready repository in seconds:
+
+- **⚡ Modern Rust-Based Tooling**: Fast package management with `uv`, linting and
+  formatting with `ruff`, strict type checking with Meta's `pyrefly`, modular boundaries
+  with `tach`, cognitive complexity limits with `complexipy`, and documentation with
+  `zensical`.
+- **🤖 First-Class AI Agent Readiness**: Autonomous agent context discovery
+  (`AGENTS.md`), modular lifecycle skills in `.agents/skills/`, machine-readable
+  `llms.txt`, and clear AI governance policies.
+- **🛡️ Strict Quality Guardrails**: 100% statement and branch test coverage
+  (`fail_under = 100`), strict typing, and automated CI security analysis with `zizmor`.
+- **🚀 Hermetic Delivery & CI/CD**: Matrix testing across Python 3.12–3.15, isolated
+  wheel package smoke tests, and automated PyPI Trusted Publishing.
+
+> [!NOTE]
+> **Project Scope**: Zenith is built for serious production packages, services, and
+> libraries intended for long-term maintenance by teams of humans and AI agents. It is
+> **deliberately not suited** for small two-script throwaway hacks where strict
+> guardrails feel like friction.
+
+## 📖 Documentation
+
+For full guides, detailed architectural deep-dives, and tool configurations, visit the
+**[Zenith Documentation Website](https://bwrob.github.io/zenith/)**.
+
+- **[First Steps & Core Concepts](https://bwrob.github.io/zenith/first-steps/)**:
+  Plain-English onboarding for developers new to modern Python tooling.
+- **[Philosophy & Sizing](https://bwrob.github.io/zenith/philosophy/)**: Modern tooling,
+  AI readiness, quality guardrails, and project sizing rubric.
+- **[CLI Architecture](https://bwrob.github.io/zenith/tools/typer/)**: Typer CLI
+  structure, Rich terminal rendering, and animated Termynal demos.
+- **[Tooling Stack Reference](https://bwrob.github.io/zenith/tools/)**: In-depth
+  explanations, configuration breakdowns, and upstream links for the integrated tool
+  stack.
+- **[Agent Skills Architecture](https://bwrob.github.io/zenith/skills/)**: Lifecycle
+  workflows for autonomous coding assistants in `.agents/skills/`.
+- **[CI/CD Pipelines](https://bwrob.github.io/zenith/ci-actions/)**: GitHub Actions test
+  matrix across Python 3.12–3.15, wheel smoke testing, and supply-chain protection.
+- **[Changelog](https://bwrob.github.io/zenith/changelog/)**: Release history and
+  version notes.
+
+## Quick Start
+
+Launch the interactive **Zenith Terminal Setup Wizard** directly via `uvx`:
+
+```bash
+uvx zenith-template
+```
+
+For headless automation or CI pipelines, pass `--no-input` and configuration flags:
+
+```bash
+uvx zenith-template --no-input --name "My Service" --ai-tools recommended --sync
+```
+
+Or scaffold directly with raw `cookiecutter`:
+
+```bash
+uvx cookiecutter https://github.com/bwrob/zenith.git
+```
+
+### Initializing the Project
+
+```bash
+cd my-project
+uv sync                     # Skip if you checked "Run uv sync" or passed --sync
+uv run poe test             # Runs test suite (100% coverage enforced)
+uv run poe code-quality     # Runs full linter, formatter, type, and complexity gate
+uv run poe docs-serve       # Starts live-reloading documentation server
+```
+
+## Essential Tasks
+
+Every workflow in Zenith is codified through **Poe the Poet** (`uv run poe <task>`):
+
+| Task                      | What it does                                                                       |
+| ------------------------- | ---------------------------------------------------------------------------------- |
+| `uv run poe test`         | Runs pytest suite enforcing 100% statement and branch coverage                     |
+| `uv run poe test-fast`    | Runs tests in parallel across CPU cores with `pytest-xdist`                        |
+| `uv run poe code-quality` | Complete quality check: lint, format, TOML/YAML/CSS, types, complexity, boundaries |
+| `uv run poe fix`          | Auto-fixes lint violations, formatting, markdown, and typos                        |
+| `uv run poe docs-serve`   | Starts local Zensical live-reloading documentation dev server                      |
+| `uv run poe docs-build`   | Builds production static HTML documentation site into `site/` with strict checks   |
+
+## License
+
+Distributed under the [MIT License](LICENSE).

zenith_template-0.2.0/cookiecutter.json

@@ -0,0 +1,71 @@
+{
+    "project_name": "Zenith",
+    "project_slug": "{{ cookiecutter.project_name | slugify }}",
+    "package_name": "{{ cookiecutter.project_slug | slugify(separator='_') }}",
+    "description": "An opinionated, strict Python project powered by uv, ruff, pyrefly, and zensical.",
+    "author_name": "bwrob",
+    "author_email": "contact@bwrob.dev",
+    "github_username": "bwrob",
+    "version": "0.1.0",
+    "python_version": [
+        "3.12",
+        "3.13",
+        "3.14",
+        "3.15"
+    ],
+    "license": [
+        "MIT",
+        "Apache-2.0",
+        "BSD-3-Clause",
+        "None"
+    ],
+    "include_cli": true,
+    "include_docs": true,
+    "include_mutation_testing": true,
+    "include_ci_testing": true,
+    "include_ci_publishing": true,
+    "include_agent_skills": true,
+    "ai_tools": "all",
+    "__year": "{% now 'utc', '%Y' %}",
+    "_new_lines": "\n",
+    "_jinja2_env_vars": {
+        "lstrip_blocks": true
+    },
+    "_copy_without_render": [
+        "docs/assets/*",
+        "*.svg",
+        "*.png",
+        "*.ico"
+    ],
+    "__prompts__": {
+        "project_name": "Project Name (Human-readable title)",
+        "project_slug": "Project Slug (Repository and PyPI distribution name)",
+        "package_name": "Python Package Name (Import identifier in src/)",
+        "description": "Short Project Description",
+        "author_name": "Author Full Name",
+        "author_email": "Author Email",
+        "github_username": "GitHub Username or Organization",
+        "version": "Initial Project Version",
+        "python_version": {
+            "__prompt__": "Target Python Version:",
+            "3.12": "Python 3.12 (LTS baseline, recommended)",
+            "3.13": "Python 3.13 (Current stable)",
+            "3.14": "Python 3.14 (Bleeding edge)",
+            "3.15": "Python 3.15 (Future / experimental)"
+        },
+        "license": {
+            "__prompt__": "Select Open Source License:",
+            "MIT": "MIT License (Permissive, widely adopted)",
+            "Apache-2.0": "Apache 2.0 (Permissive with patent grant)",
+            "BSD-3-Clause": "BSD 3-Clause (Permissive with attribution)",
+            "None": "Proprietary / No License (All Rights Reserved)"
+        },
+        "include_cli": "Scaffold Typer/Rich command-line interface?",
+        "include_docs": "Scaffold documentation website with Zensical (docs/ and zensical.toml)?",
+        "include_mutation_testing": "Include mutation testing tooling (cosmic-ray and mutmut)?",
+        "include_ci_testing": "Generate GitHub Actions workflows for CI testing and code quality?",
+        "include_ci_publishing": "Generate GitHub Actions workflow for PyPI Trusted Publishing and documentation deployment?",
+        "include_agent_skills": "Include Zenith agent skills suite and SDD subagents (.agents/)?",
+        "ai_tools": "AI assistant configs to scaffold ('all', 'recommended', 'ide-only', 'cli-only', 'minimal', 'none', or comma-separated names):"
+    }
+}

zenith_template-0.2.0/hooks/__init__.py

@@ -0,0 +1 @@
+"""Repository package for hooks."""