specsmith 0.1.0__tar.gz

specsmith-0.1.0/LICENSE

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

specsmith-0.1.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: specsmith
+Version: 0.1.0
+Summary: Forge governed project scaffolds from the Agentic AI Development Workflow Specification.
+Author: BitConcepts
+License: MIT
+Project-URL: Homepage, https://github.com/BitConcepts/specsmith
+Project-URL: Repository, https://github.com/BitConcepts/specsmith
+Project-URL: Changelog, https://github.com/BitConcepts/specsmith/blob/main/CHANGELOG.md
+Keywords: agentic,scaffold,governance,agents-md,cli,specification
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+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
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: jinja2>=3.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: pre-commit>=3.0; extra == "dev"
+Requires-Dist: types-pyyaml>=6.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5; extra == "docs"
+Dynamic: license-file
+
+# specsmith
+
+[![CI](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml/badge.svg)](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml)
+[![Docs](https://readthedocs.org/projects/specsmith/badge/?version=latest)](https://specsmith.readthedocs.io/en/latest/)
+[![PyPI](https://img.shields.io/pypi/v/specsmith.svg)](https://pypi.org/project/specsmith/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+**Governed project scaffolds for AI-assisted development.**
+
+> Intelligence proposes. Constraints decide. The ledger remembers.
+
+---
+
+## The Problem
+
+AI coding agents are powerful but unstructured. Without governance, they skip verification, lose context between sessions, and produce inconsistent results. specsmith generates the governance layer — the rules, verification tools, CI pipelines, and documentation — that makes AI-assisted development auditable and repeatable.
+
+## What specsmith Does
+
+**For new projects:** `specsmith init` generates a complete project scaffold with governance files, CI/CD, verification tools, and agent integration files tailored to your project type.
+
+**For existing projects:** `specsmith import` detects your project's language, build system, and test framework, then generates governance overlay files without modifying your source code. Existing files are preserved.
+
+**For ongoing governance:** `specsmith audit` checks health, `specsmith export` generates compliance reports, `specsmith doctor` verifies your tools are installed.
+
+Every governed project follows the closed-loop workflow: **propose → check → execute → verify → record**.
+
+## Install
+
+```bash
+pip install specsmith
+```
+
+## Quick Start
+
+```bash
+specsmith init                                     # New project (interactive)
+specsmith init --config scaffold.yml               # New project (from config)
+specsmith import --project-dir ./my-project        # Adopt existing project
+specsmith audit --project-dir ./my-project         # Health check
+specsmith export --project-dir ./my-project        # Compliance report
+specsmith doctor --project-dir ./my-project        # Tool check
+```
+
+## 30 Project Types
+
+**Software:** Python, Rust, Go, C/C++, .NET, JS/TS, mobile, monorepo, microservices, DevOps/IaC, data/ML, browser extensions.
+
+**Hardware:** FPGA/RTL, Yocto BSP, PCB design, embedded systems.
+
+**Documents:** Technical specifications, user manuals, research papers, API specifications, requirements management.
+
+**Business/Legal:** Business plans, patent applications, legal/compliance frameworks.
+
+Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-specific directory structure, governance rules in AGENTS.md, and pre-populated requirements and test stubs.
+
+## 11 CLI Commands
+
+| Command | Purpose |
+|---------|---------|
+| `init` | Scaffold a new governed project |
+| `import` | Adopt an existing project (merge mode) |
+| `audit` | Drift detection and health checks (`--fix` to auto-repair) |
+| `validate` | Governance file consistency checks |
+| `compress` | Archive old ledger entries |
+| `upgrade` | Update governance to new spec version |
+| `status` | CI/PR/alert status from VCS platform |
+| `diff` | Compare governance against templates |
+| `export` | Compliance report with REQ↔TEST coverage |
+| `doctor` | Check if verification tools are installed |
+
+## 7 Agent Integrations
+
+AGENTS.md (cross-platform standard), Warp/Oz, Claude Code, GitHub Copilot, Cursor, Gemini CLI, Windsurf, Aider.
+
+## 3 VCS Platforms
+
+GitHub Actions, GitLab CI, Bitbucket Pipelines — all with tool-aware CI generated from the verification tool registry. Dependabot/Renovate configured per language ecosystem.
+
+## Documentation
+
+**[specsmith.readthedocs.io](https://specsmith.readthedocs.io)** — Full user manual with tutorials, command reference, project type details, tool registry, governance model, troubleshooting.
+
+## Links
+
+- [PyPI](https://pypi.org/project/specsmith/)
+- [Documentation](https://specsmith.readthedocs.io)
+- [Changelog](CHANGELOG.md)
+- [Contributing](CONTRIBUTING.md)
+- [Specification](docs/AGENT-WORKFLOW-SPEC.md)
+- [Security](SECURITY.md)
+
+## License
+
+MIT — Copyright (c) 2026 BitConcepts, LLC.

specsmith-0.1.0/README.md

@@ -0,0 +1,96 @@
+# specsmith
+
+[![CI](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml/badge.svg)](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml)
+[![Docs](https://readthedocs.org/projects/specsmith/badge/?version=latest)](https://specsmith.readthedocs.io/en/latest/)
+[![PyPI](https://img.shields.io/pypi/v/specsmith.svg)](https://pypi.org/project/specsmith/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+**Governed project scaffolds for AI-assisted development.**
+
+> Intelligence proposes. Constraints decide. The ledger remembers.
+
+---
+
+## The Problem
+
+AI coding agents are powerful but unstructured. Without governance, they skip verification, lose context between sessions, and produce inconsistent results. specsmith generates the governance layer — the rules, verification tools, CI pipelines, and documentation — that makes AI-assisted development auditable and repeatable.
+
+## What specsmith Does
+
+**For new projects:** `specsmith init` generates a complete project scaffold with governance files, CI/CD, verification tools, and agent integration files tailored to your project type.
+
+**For existing projects:** `specsmith import` detects your project's language, build system, and test framework, then generates governance overlay files without modifying your source code. Existing files are preserved.
+
+**For ongoing governance:** `specsmith audit` checks health, `specsmith export` generates compliance reports, `specsmith doctor` verifies your tools are installed.
+
+Every governed project follows the closed-loop workflow: **propose → check → execute → verify → record**.
+
+## Install
+
+```bash
+pip install specsmith
+```
+
+## Quick Start
+
+```bash
+specsmith init                                     # New project (interactive)
+specsmith init --config scaffold.yml               # New project (from config)
+specsmith import --project-dir ./my-project        # Adopt existing project
+specsmith audit --project-dir ./my-project         # Health check
+specsmith export --project-dir ./my-project        # Compliance report
+specsmith doctor --project-dir ./my-project        # Tool check
+```
+
+## 30 Project Types
+
+**Software:** Python, Rust, Go, C/C++, .NET, JS/TS, mobile, monorepo, microservices, DevOps/IaC, data/ML, browser extensions.
+
+**Hardware:** FPGA/RTL, Yocto BSP, PCB design, embedded systems.
+
+**Documents:** Technical specifications, user manuals, research papers, API specifications, requirements management.
+
+**Business/Legal:** Business plans, patent applications, legal/compliance frameworks.
+
+Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-specific directory structure, governance rules in AGENTS.md, and pre-populated requirements and test stubs.
+
+## 11 CLI Commands
+
+| Command | Purpose |
+|---------|---------|
+| `init` | Scaffold a new governed project |
+| `import` | Adopt an existing project (merge mode) |
+| `audit` | Drift detection and health checks (`--fix` to auto-repair) |
+| `validate` | Governance file consistency checks |
+| `compress` | Archive old ledger entries |
+| `upgrade` | Update governance to new spec version |
+| `status` | CI/PR/alert status from VCS platform |
+| `diff` | Compare governance against templates |
+| `export` | Compliance report with REQ↔TEST coverage |
+| `doctor` | Check if verification tools are installed |
+
+## 7 Agent Integrations
+
+AGENTS.md (cross-platform standard), Warp/Oz, Claude Code, GitHub Copilot, Cursor, Gemini CLI, Windsurf, Aider.
+
+## 3 VCS Platforms
+
+GitHub Actions, GitLab CI, Bitbucket Pipelines — all with tool-aware CI generated from the verification tool registry. Dependabot/Renovate configured per language ecosystem.
+
+## Documentation
+
+**[specsmith.readthedocs.io](https://specsmith.readthedocs.io)** — Full user manual with tutorials, command reference, project type details, tool registry, governance model, troubleshooting.
+
+## Links
+
+- [PyPI](https://pypi.org/project/specsmith/)
+- [Documentation](https://specsmith.readthedocs.io)
+- [Changelog](CHANGELOG.md)
+- [Contributing](CONTRIBUTING.md)
+- [Specification](docs/AGENT-WORKFLOW-SPEC.md)
+- [Security](SECURITY.md)
+
+## License
+
+MIT — Copyright (c) 2026 BitConcepts, LLC.

specsmith-0.1.0/pyproject.toml

@@ -0,0 +1,80 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "specsmith"
+version = "0.1.0"
+description = "Forge governed project scaffolds from the Agentic AI Development Workflow Specification."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [
+    {name = "BitConcepts"},
+]
+keywords = ["agentic", "scaffold", "governance", "agents-md", "cli", "specification"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "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",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Software Development :: Build Tools",
+]
+
+dependencies = [
+    "click>=8.1",
+    "jinja2>=3.1",
+    "pyyaml>=6.0",
+    "pydantic>=2.0",
+    "rich>=13.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "ruff>=0.4",
+    "mypy>=1.10",
+    "pre-commit>=3.0",
+    "types-pyyaml>=6.0",
+]
+docs = [
+    "mkdocs>=1.6",
+    "mkdocs-material>=9.5",
+]
+
+[project.scripts]
+specsmith = "specsmith.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/BitConcepts/specsmith"
+Repository = "https://github.com/BitConcepts/specsmith"
+Changelog = "https://github.com/BitConcepts/specsmith/blob/main/CHANGELOG.md"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+specsmith = ["templates/**/*.j2"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

specsmith-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

specsmith-0.1.0/src/specsmith/__init__.py

@@ -0,0 +1,5 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 BitConcepts, LLC. All rights reserved.
+"""specsmith — Forge governed project scaffolds."""
+
+__version__ = "0.1.0"

specsmith-0.1.0/src/specsmith/__main__.py

@@ -0,0 +1,7 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 BitConcepts, LLC. All rights reserved.
+"""Allow running specsmith as ``python -m specsmith``."""
+
+from specsmith.cli import main
+
+main()