code-mower 0.5.0b30__tar.gz → 0.5.0b32__tar.gz

{code_mower-0.5.0b30 → code_mower-0.5.0b32}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-mower
-Version: 0.5.0b30
+Version: 0.5.0b32
 Summary: Multi-reviewer AI code audit orchestration
 License-Expression: Apache-2.0
 Requires-Python: >=3.11
@@ -25,6 +25,8 @@ The short version:
   AI review tools;
 - run setup diagnostics before a lane can surprise you with spend, source
   exposure, or GitHub Actions churn;
+- turn issue text, external docs, and project doctrine into local work orders
+  before an agent starts coding;
 - generate local reviewer value reports from known-clean and known-blocked PRs;
   and
 - optionally share sanitized metadata with [CodeMower.com](https://codemower.com)
@@ -101,11 +103,11 @@ Code Mower currently targets Python 3.11+; Python 3.12 is recommended.
 
 ```bash
 python3.12 --version
-pipx install --python python3.12 code-mower==0.5.0b30
+pipx install --python python3.12 code-mower==0.5.0b32
 code-mower --version
 ```
 
-`0.5.0b30` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b32` is a beta release. Until Code Mower publishes a stable `1.0`
 line, use the explicit beta version above or allow prereleases with:
 
 ```bash
@@ -148,7 +150,43 @@ First-time command map: [docs/launch-command-surface.md](docs/launch-command-sur
 
 The current PyPI beta has been rehearsed end-to-end from a clean install:
 [First-User Install Rehearsal](docs/first-user-install-rehearsal.md) records
-the latest 10/10 public-package readiness proof for `code-mower==0.5.0b30`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b32`.
+
+## Optional: Plan Before Coding
+
+For larger changes, use GitHub Issues and local work orders as the planning
+surface, then keep pull requests focused on code review and merge readiness:
+
+```bash
+code-mower project-context init --project-name "My Product"
+code-mower context add --external ~/Downloads/product-requirements.md
+code-mower plan from-github-issue OWNER/REPO#123 \
+  --output .code-mower/work-orders/billing-settings-plan.md
+code-mower work-order draft \
+  --issue-plan .code-mower/work-orders/billing-settings-plan.md \
+  --output .code-mower/work-orders/billing-settings.md
+```
+
+The GitHub issue remains the source of truth. The local plan and work order are
+derived working artifacts, and `work-order draft` also writes a metadata-only
+`*.cloud-event.json` sidecar that can tie later builder/reviewer evidence back
+to the issue on CodeMower.com. That sidecar excludes source, raw diffs, raw
+transcripts, stdout/stderr, auth output, secrets, and issue body text. External
+docs are recorded as metadata manifests unless you explicitly ask for bounded
+previews. See [docs/planning-work-orders.md](docs/planning-work-orders.md).
+
+After a PR exists, attach source-free delivery metadata to the same sidecar:
+
+```bash
+code-mower work-order attach-delivery \
+  .code-mower/work-orders/billing-settings.cloud-event.json \
+  --pr OWNER/REPO#124 \
+  --from-github
+```
+
+That lets CodeMower.com show `issue -> plan -> work order -> PR -> reviewer
+checks -> merge` lineage without receiving source, diffs, transcripts, or issue
+body text.
 
 ## Why Not Just Run Codex Or Claude Yourself?
 
@@ -253,9 +291,9 @@ best?" to "which AI builder plus reviewer loop ships best on this product?" See
 
 ## Installation Status
 
-The current public beta is `v0.5.0-beta.30` from
+The current public beta is `v0.5.0-beta.32` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b30` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b32` on [PyPI](https://pypi.org/project/code-mower/).
 GitHub releases remain the auditable source for tags, build artifacts, and
 release notes.
 

{code_mower-0.5.0b30 → code_mower-0.5.0b32}/README.md

@@ -10,6 +10,8 @@ The short version:
   AI review tools;
 - run setup diagnostics before a lane can surprise you with spend, source
   exposure, or GitHub Actions churn;
+- turn issue text, external docs, and project doctrine into local work orders
+  before an agent starts coding;
 - generate local reviewer value reports from known-clean and known-blocked PRs;
   and
 - optionally share sanitized metadata with [CodeMower.com](https://codemower.com)
@@ -86,11 +88,11 @@ Code Mower currently targets Python 3.11+; Python 3.12 is recommended.
 
 ```bash
 python3.12 --version
-pipx install --python python3.12 code-mower==0.5.0b30
+pipx install --python python3.12 code-mower==0.5.0b32
 code-mower --version
 ```
 
-`0.5.0b30` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b32` is a beta release. Until Code Mower publishes a stable `1.0`
 line, use the explicit beta version above or allow prereleases with:
 
 ```bash
@@ -133,7 +135,43 @@ First-time command map: [docs/launch-command-surface.md](docs/launch-command-sur
 
 The current PyPI beta has been rehearsed end-to-end from a clean install:
 [First-User Install Rehearsal](docs/first-user-install-rehearsal.md) records
-the latest 10/10 public-package readiness proof for `code-mower==0.5.0b30`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b32`.
+
+## Optional: Plan Before Coding
+
+For larger changes, use GitHub Issues and local work orders as the planning
+surface, then keep pull requests focused on code review and merge readiness:
+
+```bash
+code-mower project-context init --project-name "My Product"
+code-mower context add --external ~/Downloads/product-requirements.md
+code-mower plan from-github-issue OWNER/REPO#123 \
+  --output .code-mower/work-orders/billing-settings-plan.md
+code-mower work-order draft \
+  --issue-plan .code-mower/work-orders/billing-settings-plan.md \
+  --output .code-mower/work-orders/billing-settings.md
+```
+
+The GitHub issue remains the source of truth. The local plan and work order are
+derived working artifacts, and `work-order draft` also writes a metadata-only
+`*.cloud-event.json` sidecar that can tie later builder/reviewer evidence back
+to the issue on CodeMower.com. That sidecar excludes source, raw diffs, raw
+transcripts, stdout/stderr, auth output, secrets, and issue body text. External
+docs are recorded as metadata manifests unless you explicitly ask for bounded
+previews. See [docs/planning-work-orders.md](docs/planning-work-orders.md).
+
+After a PR exists, attach source-free delivery metadata to the same sidecar:
+
+```bash
+code-mower work-order attach-delivery \
+  .code-mower/work-orders/billing-settings.cloud-event.json \
+  --pr OWNER/REPO#124 \
+  --from-github
+```
+
+That lets CodeMower.com show `issue -> plan -> work order -> PR -> reviewer
+checks -> merge` lineage without receiving source, diffs, transcripts, or issue
+body text.
 
 ## Why Not Just Run Codex Or Claude Yourself?
 
@@ -238,9 +276,9 @@ best?" to "which AI builder plus reviewer loop ships best on this product?" See
 
 ## Installation Status
 
-The current public beta is `v0.5.0-beta.30` from
+The current public beta is `v0.5.0-beta.32` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b30` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b32` on [PyPI](https://pypi.org/project/code-mower/).
 GitHub releases remain the auditable source for tags, build artifacts, and
 release notes.
 

{code_mower-0.5.0b30 → code_mower-0.5.0b32}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code-mower"
-version = "0.5.0b30"
+version = "0.5.0b32"
 description = "Multi-reviewer AI code audit orchestration"
 requires-python = ">=3.11"
 readme = "README.md"

{code_mower-0.5.0b30 → code_mower-0.5.0b32}/src/code_mower/__init__.py

@@ -1,3 +1,3 @@
 """Code Mower package."""
 
-__version__ = "0.5.0b30"
+__version__ = "0.5.0b32"

{code_mower-0.5.0b30 → code_mower-0.5.0b32}/src/code_mower/cli.py

@@ -14,7 +14,7 @@ from pathlib import Path
 if __package__ in {None, ""}:
     raise SystemExit(
         "code_mower.cli is a packaged entrypoint. Install Code Mower with "
-        "`pipx install code-mower==0.5.0b30`, or run source checkouts with "
+        "`pipx install code-mower==0.5.0b32`, or run source checkouts with "
         "`PYTHONPATH=src python -m code_mower.cli`."
     )
 
@@ -52,6 +52,7 @@ from . import prompts as code_mower_prompts
 from . import reviewer_metrics
 from . import saas_reviewer_labeler
 from . import trailer_comment_labeler
+from . import work_orders as code_mower_work_orders
 from .provider_registry import REFERENCE_PROVIDERS
 from .providers import build_provider_model_env_report
 
@@ -386,6 +387,7 @@ COMMAND_DESCRIPTIONS: dict[str, str] = {
     "checks": "Detect and run a repository's native lint/test/build surface.",
     "cloud": "Export or upload sanitized benchmark metadata.",
     "config": "Validate or inspect a Code Mower config.",
+    "context": "Record local external planning context manifests.",
     "context-packs": "Build selective surrounding-file context packs.",
     "coderabbit-cli": "Run a CodeRabbit CLI informational lane.",
     "codex-audit": "Run a Codex structured audit lane.",
@@ -400,12 +402,15 @@ COMMAND_DESCRIPTIONS: dict[str, str] = {
     "merge-plan": "Inspect merge-readiness signals and lane labels.",
     "next-steps": "Print the recommended next actions after setup.",
     "package": "Build or inspect package extraction artifacts.",
+    "plan": "Create local issue-derived planning artifacts.",
+    "project-context": "Create editable local project-context doctrine docs.",
     "prompts": "Inspect prompt/lens customization artifacts.",
     "providers": "List or inspect provider template definitions.",
     "reviewer-metrics": "Compute reviewer metrics and value reports.",
     "saas-reviewer-labeler": "Apply labels from hosted reviewer comments.",
     "telemetry": "Inspect benchmark telemetry/event helpers.",
     "trailer-comment-labeler": "Apply labels from structured audit trailers.",
+    "work-order": "Draft implementation work orders and builder experiment seeds.",
 }
 
 
@@ -418,10 +423,13 @@ FIRST_USER_COMMANDS = (
     "reviewer-metrics",
     "cloud",
     "config",
+    "project-context",
 )
 
 
 def _init_main(argv: list[str]) -> int:
+    if argv[:1] == ["project-context"]:
+        return code_mower_work_orders.project_context_main(["init", *argv[1:]])
     options_with_values = {"--profile", "--output-dir"}
     if (
         argv[:1] == ["auth"]
@@ -508,6 +516,7 @@ COMMAND_HANDLERS: dict[str, CommandHandler] = {
     "checks": code_mower_checks.main,
     "cloud": code_mower_cloud.main,
     "config": _config_main,
+    "context": code_mower_work_orders.context_main,
     "context-packs": code_mower_context_packs.main,
     "coderabbit-cli": coderabbit_cli_audit_pr.main,
     "codex-audit": codex_audit_pr.main,
@@ -522,12 +531,15 @@ COMMAND_HANDLERS: dict[str, CommandHandler] = {
     "merge-plan": code_mower_merge.main,
     "next-steps": code_mower_next_steps.main,
     "package": _package_main,
+    "plan": code_mower_work_orders.plan_main,
+    "project-context": code_mower_work_orders.project_context_main,
     "prompts": code_mower_prompts.main,
     "providers": _providers_main,
     "reviewer-metrics": reviewer_metrics.main,
     "saas-reviewer-labeler": saas_reviewer_labeler.main,
     "telemetry": code_mower_telemetry.main,
     "trailer-comment-labeler": trailer_comment_labeler.main,
+    "work-order": code_mower_work_orders.work_order_main,
 }
 
 

{code_mower-0.5.0b30 → code_mower-0.5.0b32}/src/code_mower/cloud_client/bundle.py

@@ -28,6 +28,7 @@ SAFE_EVENT_TYPES = {
     "provider_catalog_snapshot",
     "reviewer_run",
     "value_report_snapshot",
+    "work_order",
     "workflow_run",
 }
 EXCLUDED_CONTENT = (

{code_mower-0.5.0b30 → code_mower-0.5.0b32}/src/code_mower/package_manifest.py

@@ -14,6 +14,7 @@ PACKAGE_FILES = (
     ("tools/code_mower_cli.py", "src/code_mower/cli.py", "core"),
     ("tools/code_mower_bootstrap.py", "src/code_mower/bootstrap.py", "core"),
     ("tools/code_mower_builder_experiment.py", "src/code_mower/builder_experiment.py", "core"),
+    ("src/code_mower/work_orders.py", "src/code_mower/work_orders.py", "core"),
     ("tools/code_mower_requirements.txt", "requirements/requirements.txt", "tooling"),
     ("tools/code_mower_calibration.py", "src/code_mower/code_mower_calibration.py", "core"),
     ("src/code_mower/checks.py", "src/code_mower/checks.py", "core"),
@@ -415,6 +416,7 @@ PACKAGE_FILES = (
     ("tools/CODE_MOWER_PACKAGE_CUSTOMIZATION.md", "docs/package-customization.md", "doc"),
     ("tools/CODE_MOWER_AUTHORING_INTELLIGENCE.md", "docs/authoring-intelligence.md", "doc"),
     ("tools/CODE_MOWER_BUILDER_EXPERIMENTS.md", "docs/builder-experiments.md", "doc"),
+    ("docs/planning-work-orders.md", "docs/planning-work-orders.md", "doc"),
     ("tools/CODE_MOWER_CLOUD_BENCHMARKING.md", "docs/cloud-benchmarking.md", "doc"),
     ("tools/CODE_MOWER_REPO_STRATEGY.md", "docs/repo-strategy.md", "doc"),
     ("tools/CODE_MOWER_COMMERCIAL_BOUNDARY.md", "docs/commercial-boundary.md", "doc"),