open-codev-workflow 0.1.0__tar.gz → 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. {open_codev_workflow-0.1.0/src/open_codev_workflow.egg-info → open_codev_workflow-0.1.1}/PKG-INFO +10 -3
  2. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/README.md +9 -2
  3. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/pyproject.toml +1 -1
  4. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/__init__.py +1 -1
  5. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/plan-delivery/SKILL.md +42 -4
  6. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/plan-delivery/assets/delivery-plan.template.md +7 -1
  7. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/docs/handbooks/PYTHON-PROJECT-HANDBOOK.md +1 -1
  8. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/evals/development-workflow/scenarios.json +5 -1
  9. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1/src/open_codev_workflow.egg-info}/PKG-INFO +10 -3
  10. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/tests/test_installer.py +2 -2
  11. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/LICENSE +0 -0
  12. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/setup.cfg +0 -0
  13. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/__main__.py +0 -0
  14. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/build-change/SKILL.md +0 -0
  15. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/build-change/agents/openai.yaml +0 -0
  16. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/build-change/assets/implementation-plan.template.md +0 -0
  17. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/define-product/SKILL.md +0 -0
  18. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/define-product/agents/openai.yaml +0 -0
  19. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/define-product/assets/brief.template.md +0 -0
  20. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/design-solution/SKILL.md +0 -0
  21. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/design-solution/agents/openai.yaml +0 -0
  22. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/design-solution/assets/decision.template.md +0 -0
  23. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/design-solution/assets/design.template.md +0 -0
  24. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/launch-product/SKILL.md +0 -0
  25. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/launch-product/agents/openai.yaml +0 -0
  26. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/launch-product/assets/launch-plan.template.md +0 -0
  27. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/plan-delivery/agents/openai.yaml +0 -0
  28. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/review-change/SKILL.md +0 -0
  29. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/review-change/agents/openai.yaml +0 -0
  30. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/specify-project/SKILL.md +0 -0
  31. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/specify-project/agents/openai.yaml +0 -0
  32. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/specify-project/assets/specification.template.md +0 -0
  33. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/specify-project/references/interview-coverage.md +0 -0
  34. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.agents/skills/specify-project/scripts/validate_specification.py +0 -0
  35. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.opencode/agents/builder.md +0 -0
  36. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.opencode/agents/orchestrator.md +0 -0
  37. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/.opencode/agents/reviewer.md +0 -0
  38. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/AGENTS.md +0 -0
  39. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/docs/AI-WORKFLOW-PROMPTS.md +0 -0
  40. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/docs/WORKFLOW-COOKBOOK.md +0 -0
  41. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/docs/WORKFLOW-HUMAN.md +0 -0
  42. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/docs/for-ai/WORKFLOW-AGENTS.md +0 -0
  43. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/docs/handbooks/IDEA-TO-PRODUCTION-HANDBOOK.md +0 -0
  44. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/docs/handbooks/LANGUAGE-AGNOSTIC-PROJECT-HANDBOOK.md +0 -0
  45. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/scripts/evaluate-development-workflow.py +0 -0
  46. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/bundle/scripts/validate-development-workflow.py +0 -0
  47. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/cli.py +0 -0
  48. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/codev_workflow/installer.py +0 -0
  49. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/open_codev_workflow.egg-info/SOURCES.txt +0 -0
  50. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/open_codev_workflow.egg-info/dependency_links.txt +0 -0
  51. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/open_codev_workflow.egg-info/entry_points.txt +0 -0
  52. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/open_codev_workflow.egg-info/requires.txt +0 -0
  53. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/src/open_codev_workflow.egg-info/top_level.txt +0 -0
  54. {open_codev_workflow-0.1.0 → open_codev_workflow-0.1.1}/tests/test_cli.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: open-codev-workflow
3
- Version: 0.1.0
3
+ Version: 0.1.1
4
4
  Summary: Human-guided AI software delivery for real repositories.
5
5
  Author: Martin Urban
6
6
  License-Expression: BSD-3-Clause
@@ -37,6 +37,13 @@ Dynamic: license-file
37
37
 
38
38
  ![Active Feature Development](https://img.shields.io/badge/Project_State-Active_Feature_Development-brightgreen?style=flat-square)
39
39
  ![AI-driven](https://img.shields.io/badge/AI_Use-AI--driven-orange?style=flat-square)
40
+ ![CI](https://img.shields.io/github/actions/workflow/status/urban233/CoDev/ci.yml?branch=main&label=CI&style=flat-square)
41
+ ![PyPI version](https://img.shields.io/pypi/v/open-codev-workflow?style=flat-square)
42
+ ![Python versions](https://img.shields.io/pypi/pyversions/open-codev-workflow?style=flat-square)
43
+ ![License](https://img.shields.io/github/license/urban233/CoDev?style=flat-square)
44
+ ![Latest release](https://img.shields.io/github/v/release/urban233/CoDev?style=flat-square)
45
+ ![GitHub stars](https://img.shields.io/github/stars/urban233/CoDev?style=flat-square)
46
+ ![GitHub issues](https://img.shields.io/github/issues/urban233/CoDev?style=flat-square)
40
47
 
41
48
  CoDev installs a small, production-minded collaboration system into any Git
42
49
  repository. It helps a developer and AI move through four understandable steps:
@@ -73,9 +80,9 @@ For private, air-gapped, or pre-release distribution, install the supplied
73
80
  wheel directly instead of publishing it to a package index:
74
81
 
75
82
  ```shell
76
- pipx install ./dist/open_codev_workflow-0.1.0-py3-none-any.whl
83
+ pipx install ./dist/open_codev_workflow-0.1.1-py3-none-any.whl
77
84
  # or
78
- uv tool install ./dist/open_codev_workflow-0.1.0-py3-none-any.whl
85
+ uv tool install ./dist/open_codev_workflow-0.1.1-py3-none-any.whl
79
86
  ```
80
87
 
81
88
  Store the wheel with its SHA-256 checksum in a controlled artifact location.
@@ -8,6 +8,13 @@
8
8
 
9
9
  ![Active Feature Development](https://img.shields.io/badge/Project_State-Active_Feature_Development-brightgreen?style=flat-square)
10
10
  ![AI-driven](https://img.shields.io/badge/AI_Use-AI--driven-orange?style=flat-square)
11
+ ![CI](https://img.shields.io/github/actions/workflow/status/urban233/CoDev/ci.yml?branch=main&label=CI&style=flat-square)
12
+ ![PyPI version](https://img.shields.io/pypi/v/open-codev-workflow?style=flat-square)
13
+ ![Python versions](https://img.shields.io/pypi/pyversions/open-codev-workflow?style=flat-square)
14
+ ![License](https://img.shields.io/github/license/urban233/CoDev?style=flat-square)
15
+ ![Latest release](https://img.shields.io/github/v/release/urban233/CoDev?style=flat-square)
16
+ ![GitHub stars](https://img.shields.io/github/stars/urban233/CoDev?style=flat-square)
17
+ ![GitHub issues](https://img.shields.io/github/issues/urban233/CoDev?style=flat-square)
11
18
 
12
19
  CoDev installs a small, production-minded collaboration system into any Git
13
20
  repository. It helps a developer and AI move through four understandable steps:
@@ -44,9 +51,9 @@ For private, air-gapped, or pre-release distribution, install the supplied
44
51
  wheel directly instead of publishing it to a package index:
45
52
 
46
53
  ```shell
47
- pipx install ./dist/open_codev_workflow-0.1.0-py3-none-any.whl
54
+ pipx install ./dist/open_codev_workflow-0.1.1-py3-none-any.whl
48
55
  # or
49
- uv tool install ./dist/open_codev_workflow-0.1.0-py3-none-any.whl
56
+ uv tool install ./dist/open_codev_workflow-0.1.1-py3-none-any.whl
50
57
  ```
51
58
 
52
59
  Store the wheel with its SHA-256 checksum in a controlled artifact location.
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "open-codev-workflow"
7
- version = "0.1.0"
7
+ version = "0.1.1"
8
8
  description = "Human-guided AI software delivery for real repositories."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.11"
@@ -2,4 +2,4 @@
2
2
 
3
3
  __all__ = ["__version__"]
4
4
 
5
- __version__ = "0.1.0"
5
+ __version__ = "0.1.1"
@@ -6,8 +6,36 @@ description: Turn an accepted product or feature brief and any required design i
6
6
  # Plan Delivery
7
7
 
8
8
  Create a plan that helps a team choose the next useful work, not a prediction of
9
- every future edit. Use `assets/delivery-plan.template.md` when the repository
10
- has no external project tracker.
9
+ every future edit. A completed delivery plan is a durable, reviewable project
10
+ artifact, not a chat-only response.
11
+
12
+ ## 0. Persist the plan
13
+
14
+ First inspect the repository for an existing delivery-plan location and for a
15
+ linked project tracker. The repository plan is the durable coordination
16
+ baseline, even when an external tracker holds routine, high-churn status.
17
+
18
+ For an explicit request to create or update a delivery plan, create or update
19
+ the plan in the repository. Default to
20
+ `docs/delivery/<milestone-slug>.md`; use an established equivalent location
21
+ when the project already has one. Start from
22
+ `assets/delivery-plan.template.md` when creating a new plan.
23
+
24
+ An initial request to *show* or frame a milestone without creating a plan may
25
+ remain an unassigned, chat-only planning brief. Make that limitation explicit
26
+ and do not describe it as a completed delivery plan.
27
+
28
+ Before writing, verify that every referenced brief and design is a durable
29
+ repository artifact or stable tracker record. Never use a conversation as an
30
+ authority link. If accepted product or architectural decisions exist only in
31
+ conversation, return to `define-product` or `design-solution` to persist the
32
+ appropriate authority before making work items ready.
33
+
34
+ Before updating an existing plan, inspect its current content and the Git
35
+ working tree. Do not silently overwrite a locally changed plan; surface the
36
+ conflict and ask for direction. Preserve the plan's document state using only
37
+ `Draft`, `Accepted`, `Active`, or `Superseded`; Git history is its revision
38
+ record.
11
39
 
12
40
  ## 1. Verify planning inputs
13
41
 
@@ -113,8 +141,11 @@ per reviewer unless the team chooses otherwise). For high- or critical-risk
113
141
  work, separately name any policy-authorized security, privacy, compliance, or
114
142
  operations approver; never assume an ordinary code reviewer has that authority.
115
143
 
116
- Track changing assignments, availability, and status in the existing project
117
- tracker. Do not version them as architecture.
144
+ Track changing assignments, availability, and status in the delivery plan or a
145
+ linked project tracker. Do not version them as architecture. When a tracker is
146
+ used, retain the milestone outcome, work-item definitions, ownership/reviewer
147
+ commitments, dependencies, checkpoints, risks, and tracker link in the
148
+ repository plan.
118
149
 
119
150
  ## 5. Check readiness
120
151
 
@@ -133,6 +164,13 @@ parallel work, blockers, integration points, and risks. Update routine status
133
164
  without formal approval; seek human decisions only for scope, priority, risk,
134
165
  ownership conflicts, or commitments.
135
166
 
167
+ ## 6. Complete the artifact handoff
168
+
169
+ After creating or updating the plan, report its exact repository path, document
170
+ state, and the Git change summary. Link to the saved artifact rather than
171
+ leaving the complete plan only in chat. Summarize the decision and next action;
172
+ do not duplicate the full document unless the user asks.
173
+
136
174
  ## Handoff
137
175
 
138
176
  Give each developer only their work item, relevant brief/design/API links,
@@ -1,11 +1,17 @@
1
1
  # [Product or Feature] Delivery Plan
2
2
 
3
- **Status:** Active
3
+ **Status:** Draft
4
4
  **Owner:** [delivery owner]
5
5
  **Brief:** [link]
6
6
  **Design:** [link or Not needed]
7
+ **Project tracker:** [link or Not used]
8
+ **Supersedes:** [link or Not applicable]
7
9
  **Last reviewed:** [YYYY-MM-DD]
8
10
 
11
+ ## Changes since last review
12
+
13
+ - [New plan or concise, material plan change]
14
+
9
15
  ## Current milestone
10
16
 
11
17
  **Outcome:** [Demonstrable user/system outcome]
@@ -370,7 +370,7 @@ build-backend = "hatchling.build"
370
370
 
371
371
  [project]
372
372
  name = "example-service"
373
- version = "0.1.0"
373
+ version = "0.1.1"
374
374
  description = "A concise description of the delivered capability."
375
375
  readme = "README.md"
376
376
  requires-python = ">=3.12"
@@ -21,6 +21,8 @@
21
21
  "contracts_enable_parallelism": "Used an accepted contract or fixture to make parallel work safe.",
22
22
  "owner_reviewer_separation": "Named accountable owners and different independent reviewers for work items.",
23
23
  "rolling_wave_plan": "Planned the current milestone in detail and later work coarsely instead of freezing a full-project task inventory.",
24
+ "delivery_plan_persisted": "Created or updated a repository delivery-plan artifact and reported its exact path rather than leaving the completed plan only in chat.",
25
+ "durable_plan_authority": "Referenced durable brief and design artifacts or stable tracker records; did not use conversation-only decisions as plan authority.",
24
26
  "exact_snapshot_reviewed": "Identified and reviewed one exact base-to-head snapshot with sufficient surrounding context.",
25
27
  "review_read_only": "Did not modify code or turn the review into implementation.",
26
28
  "findings_evidenced": "Ordered actionable findings by impact and supported each with location, evidence, impact, and a testable correction.",
@@ -96,7 +98,9 @@
96
98
  "behavior_slices",
97
99
  "contracts_enable_parallelism",
98
100
  "owner_reviewer_separation",
99
- "rolling_wave_plan"
101
+ "rolling_wave_plan",
102
+ "delivery_plan_persisted",
103
+ "durable_plan_authority"
100
104
  ]
101
105
  },
102
106
  {
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: open-codev-workflow
3
- Version: 0.1.0
3
+ Version: 0.1.1
4
4
  Summary: Human-guided AI software delivery for real repositories.
5
5
  Author: Martin Urban
6
6
  License-Expression: BSD-3-Clause
@@ -37,6 +37,13 @@ Dynamic: license-file
37
37
 
38
38
  ![Active Feature Development](https://img.shields.io/badge/Project_State-Active_Feature_Development-brightgreen?style=flat-square)
39
39
  ![AI-driven](https://img.shields.io/badge/AI_Use-AI--driven-orange?style=flat-square)
40
+ ![CI](https://img.shields.io/github/actions/workflow/status/urban233/CoDev/ci.yml?branch=main&label=CI&style=flat-square)
41
+ ![PyPI version](https://img.shields.io/pypi/v/open-codev-workflow?style=flat-square)
42
+ ![Python versions](https://img.shields.io/pypi/pyversions/open-codev-workflow?style=flat-square)
43
+ ![License](https://img.shields.io/github/license/urban233/CoDev?style=flat-square)
44
+ ![Latest release](https://img.shields.io/github/v/release/urban233/CoDev?style=flat-square)
45
+ ![GitHub stars](https://img.shields.io/github/stars/urban233/CoDev?style=flat-square)
46
+ ![GitHub issues](https://img.shields.io/github/issues/urban233/CoDev?style=flat-square)
40
47
 
41
48
  CoDev installs a small, production-minded collaboration system into any Git
42
49
  repository. It helps a developer and AI move through four understandable steps:
@@ -73,9 +80,9 @@ For private, air-gapped, or pre-release distribution, install the supplied
73
80
  wheel directly instead of publishing it to a package index:
74
81
 
75
82
  ```shell
76
- pipx install ./dist/open_codev_workflow-0.1.0-py3-none-any.whl
83
+ pipx install ./dist/open_codev_workflow-0.1.1-py3-none-any.whl
77
84
  # or
78
- uv tool install ./dist/open_codev_workflow-0.1.0-py3-none-any.whl
85
+ uv tool install ./dist/open_codev_workflow-0.1.1-py3-none-any.whl
79
86
  ```
80
87
 
81
88
  Store the wheel with its SHA-256 checksum in a controlled artifact location.
@@ -228,8 +228,8 @@ class InstallerTests(unittest.TestCase):
228
228
  changed_bundle = dict(current_bundle)
229
229
  changed_bundle[first] += b"\nupstream one\n"
230
230
  changed_bundle[second] += b"\nupstream two\n"
231
- first_path = self.target / Path(first)
232
- second_path = self.target / Path(second)
231
+ first_path = (self.target / Path(first)).resolve()
232
+ second_path = (self.target / Path(second)).resolve()
233
233
  original_first = first_path.read_bytes()
234
234
  second_path.write_bytes(second_path.read_bytes() + b"\nlocal edit\n")
235
235