vstack 1.3.4__tar.gz → 1.3.6__tar.gz

vstack-1.3.6/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: vstack
+Version: 1.3.6
+Summary: VS Code-native AI engineering workflow system for microservices, libraries, and backend systems.
+License-Expression: MIT
+License-File: LICENSE
+Keywords: github-copilot,vscode,ai-workflows,developer-tools,devx,engineering-workflow,copilot-agent-mode,backend,microservices,api,workflow-automation,release-engineering
+Requires-Python: >=3.11,<3.15
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Project-URL: Changelog, https://github.com/eschaar/vstack/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/eschaar/vstack/blob/main/README.md
+Project-URL: Discussions, https://github.com/eschaar/vstack/discussions
+Project-URL: Homepage, https://github.com/eschaar/vstack
+Project-URL: Issues, https://github.com/eschaar/vstack/issues
+Project-URL: Repository, https://github.com/eschaar/vstack
+Project-URL: Security, https://github.com/eschaar/vstack/blob/main/SECURITY.md
+Description-Content-Type: text/markdown
+
+<p align="center">
+	<img src="https://raw.githubusercontent.com/eschaar/vstack/main/assets/branding/vstack.png" alt="vstack" width="260">
+</p>
+
+[![PyPI version](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Fvstack%2Fjson&query=%24.info.version&label=PyPI&color=0B8A6F&cacheSeconds=300)](https://pypi.org/project/vstack/)
+[![Python version](https://img.shields.io/badge/python-3.11--3.14-0B8A6F)](https://github.com/eschaar/vstack/blob/main/pyproject.toml)
+[![Verify status](https://img.shields.io/github/actions/workflow/status/eschaar/vstack/verify.yml?label=verify&color=1D6FA5)](https://github.com/eschaar/vstack/actions/workflows/verify.yml)
+[![Security checks](https://img.shields.io/github/actions/workflow/status/eschaar/vstack/security.yml?label=security&color=B15E00)](https://github.com/eschaar/vstack/actions/workflows/security.yml)
+[![Runtime: stdlib only](https://img.shields.io/badge/runtime-stdlib%20only-5B6C8F)](https://github.com/eschaar/vstack/blob/main/pyproject.toml)
+[![License: MIT](https://img.shields.io/github/license/eschaar/vstack?color=5F7A1F)](https://github.com/eschaar/vstack/blob/main/LICENSE)
+[![GitHub Discussions](https://img.shields.io/badge/discussions-ask%20%26%20share-blueviolet?logo=github)](https://github.com/eschaar/vstack/discussions)
+
+The VS Code-native AI workflow system for backend engineering.
+
+vstack installs structured agents, skills, instructions, and prompts into `.github/` so GitHub Copilot Agent Mode can run repeatable backend workflows with clear role boundaries.
+
+It provides a fixed role model for end-to-end software delivery: `product`, `architect`, `designer`, `engineer`, `tester`, and `release`.
+
+## Best for
+
+- Backend and API teams using GitHub Copilot Agent Mode in VS Code
+- Repositories that want consistent planning, implementation, verification, and release flow
+- Teams that want reusable AI workflows instead of one-off prompt crafting
+
+## What you get
+
+- Fixed role model: `product`, `architect`, `designer`, `engineer`, `tester`, `release`
+- Template-driven install model from `src/vstack/_templates/`
+- Backend-first verification, security, and release discipline
+- Standard-library-only runtime dependencies
+
+## Quick start
+
+Install with `pipx`, then install vstack artifacts into your repository:
+
+```bash
+pipx install vstack
+vstack install --target /path/to/your/project
+vstack validate
+```
+
+Run a first task in Copilot Agent Mode:
+
+```text
+@tester /verify Check this repository and summarize findings
+```
+
+Expected result:
+
+- `vstack validate` reports no unresolved template tokens
+- Agent command returns a concrete verification summary for your repository
+
+## Why this helps
+
+- Consistent role boundaries for planning, implementation, validation, and release
+- Reusable skills and instructions instead of ad hoc prompts
+- Better release hygiene with documented workflows and CI alignment
+
+## Core commands
+
+```bash
+vstack --version
+vstack validate
+vstack install --target /path/to/your/project
+vstack verify --target /path/to/your/project
+```
+
+## Common usage patterns
+
+Repository-scoped install (recommended for teams):
+
+```bash
+vstack install --target /path/to/your/project
+```
+
+Profile-wide install (optional defaults for all projects):
+
+```bash
+vstack install --global
+```
+
+## Fast troubleshooting
+
+- Command not found after install: ensure your `pipx` binary path is in `PATH`
+- Validation error: rerun `vstack install --target ...` and then `vstack validate`
+- Agent results look generic: explicitly invoke a role (for example `@tester`) before a skill
+
+## Full documentation
+
+For complete documentation (including architecture details, workflow diagrams, and contributor guides), use GitHub:
+
+- [GitHub repository](https://github.com/eschaar/vstack)
+- [Full README](https://github.com/eschaar/vstack/blob/main/README.md)
+- [Documentation](https://github.com/eschaar/vstack/tree/main/docs)
+- [Contributing guide](https://github.com/eschaar/vstack/blob/main/CONTRIBUTING.md)
+- [Security policy](https://github.com/eschaar/vstack/blob/main/SECURITY.md)
+

vstack-1.3.6/README-pypi.md

@@ -0,0 +1,96 @@
+<p align="center">
+	<img src="https://raw.githubusercontent.com/eschaar/vstack/main/assets/branding/vstack.png" alt="vstack" width="260">
+</p>
+
+[![PyPI version](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Fvstack%2Fjson&query=%24.info.version&label=PyPI&color=0B8A6F&cacheSeconds=300)](https://pypi.org/project/vstack/)
+[![Python version](https://img.shields.io/badge/python-3.11--3.14-0B8A6F)](https://github.com/eschaar/vstack/blob/main/pyproject.toml)
+[![Verify status](https://img.shields.io/github/actions/workflow/status/eschaar/vstack/verify.yml?label=verify&color=1D6FA5)](https://github.com/eschaar/vstack/actions/workflows/verify.yml)
+[![Security checks](https://img.shields.io/github/actions/workflow/status/eschaar/vstack/security.yml?label=security&color=B15E00)](https://github.com/eschaar/vstack/actions/workflows/security.yml)
+[![Runtime: stdlib only](https://img.shields.io/badge/runtime-stdlib%20only-5B6C8F)](https://github.com/eschaar/vstack/blob/main/pyproject.toml)
+[![License: MIT](https://img.shields.io/github/license/eschaar/vstack?color=5F7A1F)](https://github.com/eschaar/vstack/blob/main/LICENSE)
+[![GitHub Discussions](https://img.shields.io/badge/discussions-ask%20%26%20share-blueviolet?logo=github)](https://github.com/eschaar/vstack/discussions)
+
+The VS Code-native AI workflow system for backend engineering.
+
+vstack installs structured agents, skills, instructions, and prompts into `.github/` so GitHub Copilot Agent Mode can run repeatable backend workflows with clear role boundaries.
+
+It provides a fixed role model for end-to-end software delivery: `product`, `architect`, `designer`, `engineer`, `tester`, and `release`.
+
+## Best for
+
+- Backend and API teams using GitHub Copilot Agent Mode in VS Code
+- Repositories that want consistent planning, implementation, verification, and release flow
+- Teams that want reusable AI workflows instead of one-off prompt crafting
+
+## What you get
+
+- Fixed role model: `product`, `architect`, `designer`, `engineer`, `tester`, `release`
+- Template-driven install model from `src/vstack/_templates/`
+- Backend-first verification, security, and release discipline
+- Standard-library-only runtime dependencies
+
+## Quick start
+
+Install with `pipx`, then install vstack artifacts into your repository:
+
+```bash
+pipx install vstack
+vstack install --target /path/to/your/project
+vstack validate
+```
+
+Run a first task in Copilot Agent Mode:
+
+```text
+@tester /verify Check this repository and summarize findings
+```
+
+Expected result:
+
+- `vstack validate` reports no unresolved template tokens
+- Agent command returns a concrete verification summary for your repository
+
+## Why this helps
+
+- Consistent role boundaries for planning, implementation, validation, and release
+- Reusable skills and instructions instead of ad hoc prompts
+- Better release hygiene with documented workflows and CI alignment
+
+## Core commands
+
+```bash
+vstack --version
+vstack validate
+vstack install --target /path/to/your/project
+vstack verify --target /path/to/your/project
+```
+
+## Common usage patterns
+
+Repository-scoped install (recommended for teams):
+
+```bash
+vstack install --target /path/to/your/project
+```
+
+Profile-wide install (optional defaults for all projects):
+
+```bash
+vstack install --global
+```
+
+## Fast troubleshooting
+
+- Command not found after install: ensure your `pipx` binary path is in `PATH`
+- Validation error: rerun `vstack install --target ...` and then `vstack validate`
+- Agent results look generic: explicitly invoke a role (for example `@tester`) before a skill
+
+## Full documentation
+
+For complete documentation (including architecture details, workflow diagrams, and contributor guides), use GitHub:
+
+- [GitHub repository](https://github.com/eschaar/vstack)
+- [Full README](https://github.com/eschaar/vstack/blob/main/README.md)
+- [Documentation](https://github.com/eschaar/vstack/tree/main/docs)
+- [Contributing guide](https://github.com/eschaar/vstack/blob/main/CONTRIBUTING.md)
+- [Security policy](https://github.com/eschaar/vstack/blob/main/SECURITY.md)

{vstack-1.3.4 → vstack-1.3.6}/pyproject.toml

@@ -3,10 +3,45 @@ name = "vstack"
 dynamic = []
 description = "VS Code-native AI engineering workflow system for microservices, libraries, and backend systems."
 license = "MIT"
-readme = "README.md"
+readme = "README-pypi.md"
 requires-python = ">=3.11,<3.15"
 dependencies = []
-version = "1.3.4"
+keywords = [
+    "github-copilot",
+    "vscode",
+    "ai-workflows",
+    "developer-tools",
+    "devx",
+    "engineering-workflow",
+    "copilot-agent-mode",
+    "backend",
+    "microservices",
+    "api",
+    "workflow-automation",
+    "release-engineering",
+]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+version = "1.3.6"
+
+[project.urls]
+Homepage = "https://github.com/eschaar/vstack"
+Documentation = "https://github.com/eschaar/vstack/blob/main/README.md"
+Repository = "https://github.com/eschaar/vstack"
+Issues = "https://github.com/eschaar/vstack/issues"
+Changelog = "https://github.com/eschaar/vstack/blob/main/CHANGELOG.md"
+Discussions = "https://github.com/eschaar/vstack/discussions"
+Security = "https://github.com/eschaar/vstack/blob/main/SECURITY.md"
 
 [project.scripts]
 vstack = "vstack:main"