open-codev-workflow 0.1.0__py3-none-any.whl

open_codev_workflow-0.1.0.dist-info/METADATA

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: open-codev-workflow
+Version: 0.1.0
+Summary: Human-guided AI software delivery for real repositories.
+Author: Martin Urban
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/urban233/CoDev
+Project-URL: Repository, https://github.com/urban233/CoDev
+Project-URL: Issues, https://github.com/urban233/CoDev/issues
+Keywords: ai,developer-tools,software-delivery,codex,opencode
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+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 :: Quality Assurance
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build>=1.2.2; extra == "dev"
+Requires-Dist: mypy>=1.15; extra == "dev"
+Requires-Dist: ruff>=0.11; extra == "dev"
+Requires-Dist: twine>=6.1; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="assets/codev-mark.svg" width="96" height="96" alt="CoDev mark">
+</p>
+
+<h1 align="center">CoDev</h1>
+
+<p align="center"><strong>Human-guided AI software delivery.</strong></p>
+
+![Active Feature Development](https://img.shields.io/badge/Project_State-Active_Feature_Development-brightgreen?style=flat-square)
+![AI-driven](https://img.shields.io/badge/AI_Use-AI--driven-orange?style=flat-square)
+
+CoDev installs a small, production-minded collaboration system into any Git
+repository. It helps a developer and AI move through four understandable steps:
+**Understand, Build, Review, and Ship**. It supports bounded three-agent
+execution without turning product development into an unattended coding loop.
+
+## Why CoDev
+
+- One workflow for solo developers and multi-developer teams.
+- Repository-grounded plans instead of invented APIs or architecture.
+- A bounded builder and an independent, read-only reviewer.
+- Human authority over material decisions, merge, deployment, and rollout.
+- Versioned, conflict-aware installation across existing repositories.
+- No runtime dependency in the software being built.
+
+## Quick start
+
+CoDev is a Python 3.11+ command-line tool. Target repositories may use any
+language or build system. Install it with an isolated tool manager; `pipx` and
+`uv tool` are the two supported, primary installation methods. Neither adds
+CoDev or its dependencies to a target repository.
+
+### Install from PyPI
+
+```shell
+pipx install open-codev-workflow
+# or
+uv tool install open-codev-workflow
+```
+
+### Install from a wheel
+
+For private, air-gapped, or pre-release distribution, install the supplied
+wheel directly instead of publishing it to a package index:
+
+```shell
+pipx install ./dist/open_codev_workflow-0.1.0-py3-none-any.whl
+# or
+uv tool install ./dist/open_codev_workflow-0.1.0-py3-none-any.whl
+```
+
+Store the wheel with its SHA-256 checksum in a controlled artifact location.
+The development workflow for building a wheel is documented below.
+
+### Initialize a repository
+
+```shell
+codev init --target ../my-project --platform all
+codev check --target ../my-project
+```
+
+To preview or apply a later bundle update:
+
+```shell
+codev diff --target ../my-project
+codev update --target ../my-project
+codev remove --target ../my-project --dry-run
+```
+
+`init`, `diff`, and `update` preflight the entire operation. A locally modified
+managed file becomes a visible conflict; CoDev never silently replaces it.
+
+## What gets installed
+
+```text
+my-project/
+├── AGENTS.md                         # a managed policy block; local text survives
+├── .agents/skills/                   # seven lifecycle skills
+├── .opencode/agents/                 # orchestrator, builder, reviewer
+├── .opencode/opencode.json           # safely merged; existing agent settings survive
+├── docs/                             # workflow, prompts, handbooks, cookbook
+├── evals/development-workflow/       # behavioral scenarios
+├── scripts/                          # deterministic validators
+└── .codev/lock.json                # installed version and source hashes
+```
+
+Use `--platform codex` to omit the OpenCode adapter. Use `--platform opencode`
+or `--platform all` for the three-agent OpenCode topology. Core skills and
+human/AI workflow references are installed for every platform.
+
+## Design principles
+
+1. **Local at use time.** Agents read ordinary files in the target repository.
+2. **Central at maintenance time.** This repository is the canonical source.
+3. **Human at authority boundaries.** Automation supplies evidence, not approval.
+4. **Small by default.** Deeper design and delivery planning appear only when
+   risk or coordination requires them.
+5. **Safe to adopt.** Existing instructions and OpenCode settings are preserved.
+
+Read [Architecture](docs/architecture.md) for the distribution model,
+[Adoption](docs/adoption.md) for rollout guidance, and
+[Brand](docs/brand.md) for the visual and writing system.
+
+## Development
+
+```shell
+python -m unittest discover -s tests -v
+python -m compileall -q src tests
+python -m codev_workflow --version
+```
+
+Optional development checks:
+
+```shell
+ruff check .
+ruff format --check .
+mypy
+python -m build
+```
+
+CoDev is licensed under BSD-3-Clause.

open_codev_workflow-0.1.0.dist-info/RECORD

@@ -0,0 +1,47 @@
+codev_workflow/__init__.py,sha256=Iwo_c7O5HriBcYlyKnWHnN-Z0EgPz0f7fOuPI7KEqqw,98
+codev_workflow/__main__.py,sha256=io_XM2JI9xppJBg52k3_ddSKBR0QAy8AGPhUutQN4aI,93
+codev_workflow/cli.py,sha256=4PTINiHWkvbb5i8ip2EkHlF8neiE5JEXEQsNxniT-Yk,4870
+codev_workflow/installer.py,sha256=pgUa81tttPsbRC7L7P4rSinRDISeTn2Ka877ACc4p3I,33533
+codev_workflow/bundle/AGENTS.md,sha256=uT53XItylNrG61MMq5vLT-XY93f9PxNpBIEdKRVSSx4,1250
+codev_workflow/bundle/.agents/skills/build-change/SKILL.md,sha256=Npb0WE_wrQdB4Fk6qD4jDmr51X6j-ou48m8S6cT5WjA,4605
+codev_workflow/bundle/.agents/skills/build-change/agents/openai.yaml,sha256=DiuTfyVJVh4PNjvs1F4cynPuG29dncbYo-te9-jbcxU,215
+codev_workflow/bundle/.agents/skills/build-change/assets/implementation-plan.template.md,sha256=MWnS3NTlxvY-liBaDxqWL4bLuqtsXqEg-DEgQhHjCBM,1431
+codev_workflow/bundle/.agents/skills/define-product/SKILL.md,sha256=P7s4Lf2vwd4WxztBun-ghWZk18HT2WjdSAd_bhJBjr8,3391
+codev_workflow/bundle/.agents/skills/define-product/agents/openai.yaml,sha256=MHdkH-9M3huIYYZ1UtNyJ3Iaaku79ekcB5aK1pE7puc,226
+codev_workflow/bundle/.agents/skills/define-product/assets/brief.template.md,sha256=iHw_IzQy_YtyDViAxBdV3TzNCwPK2GgShtzFU3MIDxc,932
+codev_workflow/bundle/.agents/skills/design-solution/SKILL.md,sha256=wJSG4F-XMfst3T73VRnxx-DbuWJ6OTJZwbgUX1YVCTo,3244
+codev_workflow/bundle/.agents/skills/design-solution/agents/openai.yaml,sha256=XFCMSvVmW3pFUGUyxydAfKKUnjTX7-udhXYSr0JPi28,225
+codev_workflow/bundle/.agents/skills/design-solution/assets/decision.template.md,sha256=irXXLtocGNMz33I9-Gayfpy1p6Spd74BiKm88dOZMj0,417
+codev_workflow/bundle/.agents/skills/design-solution/assets/design.template.md,sha256=5TlUoNTr2ZD4vRLvZHKLGjg3xqzMrWXMCHzs-gmGu2Q,1703
+codev_workflow/bundle/.agents/skills/launch-product/SKILL.md,sha256=aU4z2r_jKxO5gEgCXKST2cYYIk16krO5GvAmAugFDEA,2934
+codev_workflow/bundle/.agents/skills/launch-product/agents/openai.yaml,sha256=tsnjrfppEJdpRpeSumvaEm5LDDtMFYJv7Q0-jaBVKxU,208
+codev_workflow/bundle/.agents/skills/launch-product/assets/launch-plan.template.md,sha256=k6Suyr5l3r7MRKNm9n0BBNp74QlZmNqOketEUp-aItw,1554
+codev_workflow/bundle/.agents/skills/plan-delivery/SKILL.md,sha256=0cbDhEh1O10UDrUlZtKvUbGK4tovtnLodYBvMlVsfO8,6576
+codev_workflow/bundle/.agents/skills/plan-delivery/agents/openai.yaml,sha256=hTEAE1SFAgqSAK5o7YMWHAiPWZ1xIkWXZX_84i4iTPA,232
+codev_workflow/bundle/.agents/skills/plan-delivery/assets/delivery-plan.template.md,sha256=ICfExIqtRAg9Ec66XriU1EOWzYTB6yiH-o3tY5KDxgc,1290
+codev_workflow/bundle/.agents/skills/review-change/SKILL.md,sha256=Vh_Dg_0rhlKHx7zTzoTMYcOHdeqqhDAel-s74occXK8,2233
+codev_workflow/bundle/.agents/skills/review-change/agents/openai.yaml,sha256=se4dUxUhyKLEY0HwGW9UZjof9-kgc6hoFT-5SxF3KWA,227
+codev_workflow/bundle/.agents/skills/specify-project/SKILL.md,sha256=Af3R4x8EEnOq-Jh387FeHiuWMlo-KXqsvGIg4bUiioU,8866
+codev_workflow/bundle/.agents/skills/specify-project/agents/openai.yaml,sha256=3YGYv676_WfZnd7QIWOuo7ONuh7ehGxg7FNpAhw5RQA,234
+codev_workflow/bundle/.agents/skills/specify-project/assets/specification.template.md,sha256=nFs8X916Ws52-iESfVK-Y2wCCX2JX2wvU8luUi59K9o,5034
+codev_workflow/bundle/.agents/skills/specify-project/references/interview-coverage.md,sha256=1L9Xjl8gxymrfug60A9N7-_6rsPvahyTCDhhEyop_gU,12516
+codev_workflow/bundle/.agents/skills/specify-project/scripts/validate_specification.py,sha256=T1vBAYTemFgj4qDTbgezpkU4Ja1in3QI1JfYrpRR1Pg,4758
+codev_workflow/bundle/.opencode/agents/builder.md,sha256=jj2sCK7_hGr5WNaMk9SzBwLu7yXoqYSLUaiILZEHPOs,2189
+codev_workflow/bundle/.opencode/agents/orchestrator.md,sha256=fUG_3zNGJTQvb597ItODYYJ30OPOaPwC2zma81560oA,3439
+codev_workflow/bundle/.opencode/agents/reviewer.md,sha256=92M-h0EyNsy4GoBQmAGdz8xwiEdu5HF-58yaV-tH-q8,1358
+codev_workflow/bundle/docs/AI-WORKFLOW-PROMPTS.md,sha256=vVuCqDkW-j_bdsUeYLAsfdeW_RVUK50a89kwtrKaRpU,13886
+codev_workflow/bundle/docs/WORKFLOW-COOKBOOK.md,sha256=ZWpZysKQv9Z9iP_qAwlVRoHuHkb2k-AV1pz1oJWvmxc,15669
+codev_workflow/bundle/docs/WORKFLOW-HUMAN.md,sha256=SDpJNj0hxTVD5O5tShTFrVHzAD64uNCNnhiB9BOgRew,10639
+codev_workflow/bundle/docs/for-ai/WORKFLOW-AGENTS.md,sha256=sw1MNOS4eqOmkaeLa9t_rxaZS84ZFCRO_PVlondgpYs,8205
+codev_workflow/bundle/docs/handbooks/IDEA-TO-PRODUCTION-HANDBOOK.md,sha256=GbmNA3S-C8QMFSJGbQ_CcOmx-JJkWRiux1zYONqSy04,49181
+codev_workflow/bundle/docs/handbooks/LANGUAGE-AGNOSTIC-PROJECT-HANDBOOK.md,sha256=Jye_StkpwMpZGuZt7TFKP0C0PirQrpcBYIL8_YEghd4,32913
+codev_workflow/bundle/docs/handbooks/PYTHON-PROJECT-HANDBOOK.md,sha256=2HZfsye-Do7RbuPTeKyK8UNGBDAQwwkCd8_Xyi9X3vI,36029
+codev_workflow/bundle/evals/development-workflow/scenarios.json,sha256=tL0Nw7nQyRBV-eYfaQk-5IF_8Y9jzguZyyfuuEU5GyM,8084
+codev_workflow/bundle/scripts/evaluate-development-workflow.py,sha256=3Aauqbi510MDBX-CZ5o-GJqk42kP_P9IdYVdMcMzt5g,13194
+codev_workflow/bundle/scripts/validate-development-workflow.py,sha256=en7va5UzOkJAeqt9F0lvzL8eLLUM3D6BhpVNIChly5o,7545
+open_codev_workflow-0.1.0.dist-info/licenses/LICENSE,sha256=tbbgq3zoPzC4QVAOepEOAy7mcj2nSbyf7WgMJmR3qEI,1499
+open_codev_workflow-0.1.0.dist-info/METADATA,sha256=B4BP5VJtr6u3f5hC1sjUSqFBW3l9zxrg00zELhSiZ-I,5435
+open_codev_workflow-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+open_codev_workflow-0.1.0.dist-info/entry_points.txt,sha256=bbpicC-dSP6EWtoKnHsNu_7iUMhxahq173EzO9oK0to,50
+open_codev_workflow-0.1.0.dist-info/top_level.txt,sha256=_dtpI7lmCYLfIK8XGfWa52editeKChUOEvA54imC1Vc,15
+open_codev_workflow-0.1.0.dist-info/RECORD,,

open_codev_workflow-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

open_codev_workflow-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codev = codev_workflow.cli:main

open_codev_workflow-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Martin Urban
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

open_codev_workflow-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+codev_workflow