code-mower 0.5.0b29__tar.gz → 0.5.0b31__tar.gz

{code_mower-0.5.0b29 → code_mower-0.5.0b31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-mower
-Version: 0.5.0b29
+Version: 0.5.0b31
 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.0b29
+pipx install --python python3.12 code-mower==0.5.0b31
 code-mower --version
 ```
 
-`0.5.0b29` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b31` 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,29 @@ 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.0b29`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b31`.
+
+## 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-issue \
+  --repo OWNER/REPO \
+  --title "Add billing settings" \
+  --body-file issue-body.md \
+  --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 work-order path is local-only by default. 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).
 
 ## Why Not Just Run Codex Or Claude Yourself?
 
@@ -253,9 +277,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.29` from
+The current public beta is `v0.5.0-beta.31` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b29` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b31` 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.0b29 → code_mower-0.5.0b31}/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.0b29
+pipx install --python python3.12 code-mower==0.5.0b31
 code-mower --version
 ```
 
-`0.5.0b29` is a beta release. Until Code Mower publishes a stable `1.0`
+`0.5.0b31` 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,29 @@ 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.0b29`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b31`.
+
+## 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-issue \
+  --repo OWNER/REPO \
+  --title "Add billing settings" \
+  --body-file issue-body.md \
+  --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 work-order path is local-only by default. 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).
 
 ## Why Not Just Run Codex Or Claude Yourself?
 
@@ -238,9 +262,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.29` from
+The current public beta is `v0.5.0-beta.31` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b29` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b31` 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.0b29 → code_mower-0.5.0b31}/pyproject.toml

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

{code_mower-0.5.0b29 → code_mower-0.5.0b31}/src/code_mower/__init__.py

@@ -1,3 +1,3 @@
 """Code Mower package."""
 
-__version__ = "0.5.0b29"
+__version__ = "0.5.0b31"

{code_mower-0.5.0b29 → code_mower-0.5.0b31}/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.0b29`, or run source checkouts with "
+        "`pipx install code-mower==0.5.0b31`, 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.0b29 → code_mower-0.5.0b31}/src/code_mower/cloud.py

@@ -669,6 +669,35 @@ def main(argv: list[str] | None = None) -> int:
                 print(f"Repositories: {result['repo_count']}")
                 print(f"Steps: {result['step_count']}")
                 print(f"Errors: {result['error_count']}")
+                summary = result.get("data_class_summary", {})
+                if isinstance(summary, dict):
+                    current = summary.get("current_dogfood", {})
+                    history = summary.get("imported_history", {})
+                    reviewer = summary.get("reviewer_evidence", {})
+                    print(
+                        "Current dogfood: "
+                        f"{current.get('steps', 0)} steps, "
+                        f"{current.get('events', 0)} events"
+                    )
+                    print(
+                        "Imported history: "
+                        f"{history.get('steps', 0)} steps, "
+                        f"{history.get('events', 0)} events "
+                        "(not calibration evidence)"
+                    )
+                    print(
+                        "Reviewer evidence: "
+                        f"{reviewer.get('steps', 0)} steps, "
+                        f"{reviewer.get('events', 0)} events"
+                    )
+                    guidance = (
+                        history.get("trust_guidance", {})
+                        if isinstance(history, dict)
+                        else {}
+                    )
+                    if guidance and history.get("events", 0):
+                        print(f"History use: {guidance.get('use_for', '')}")
+                        print(f"History next: {guidance.get('next_step', '')}")
             return 0 if result["error_count"] == 0 else 1
     except CloudBundleError as exc:
         print(f"error: {exc}", file=sys.stderr)

{code_mower-0.5.0b29 → code_mower-0.5.0b31}/src/code_mower/cloud_client/operations.py

@@ -413,6 +413,58 @@ def repo_sync_output_name(repo_slug: str, repo_path: Path, index: int) -> str:
     return f"{cleaned or 'repo'}-{index + 1}"
 
 
+def build_repo_sync_data_class_summary(
+    repos: list[dict[str, Any]],
+) -> dict[str, dict[str, Any]]:
+    """Summarize synced data by dashboard provenance class."""
+
+    summary: dict[str, dict[str, Any]] = {
+        "current_dogfood": {
+            "steps": 0,
+            "events": 0,
+            "description": "current repo metadata and provider inventory",
+        },
+        "imported_history": {
+            "steps": 0,
+            "events": 0,
+            "description": "sanitized GitHub Actions history",
+            "trust_guidance": CATCH_UP_TRUST_GUIDANCE,
+        },
+        "reviewer_evidence": {
+            "steps": 0,
+            "events": 0,
+            "description": "metadata-only reviewer verdict artifacts",
+        },
+    }
+    for repo in repos:
+        steps = repo.get("steps")
+        if not isinstance(steps, list):
+            continue
+        for step in steps:
+            if not isinstance(step, dict):
+                continue
+            mode = str(step.get("mode") or "")
+            if mode == "cloud-dogfood":
+                target = summary["current_dogfood"]
+                target["steps"] += 1
+                export = step.get("export")
+                if isinstance(export, dict):
+                    target["events"] += int(export.get("event_count") or 0)
+            elif mode == "cloud-catch-up":
+                target = summary["imported_history"]
+                target["steps"] += 1
+                catch_up = step.get("catch_up")
+                if isinstance(catch_up, dict):
+                    target["events"] += int(catch_up.get("event_count") or 0)
+                else:
+                    target["events"] += int(step.get("run_count") or 0)
+            elif mode == "cloud-reviewer-runs":
+                target = summary["reviewer_evidence"]
+                target["steps"] += 1
+                target["events"] += int(step.get("event_count") or 0)
+    return summary
+
+
 def repo_sync_upload(
     *,
     repo_specs: list[str],
@@ -524,5 +576,6 @@ def repo_sync_upload(
         "step_count": sum(len(repo["steps"]) for repo in repos),
         "error_count": error_count,
         "modes": selected_modes,
+        "data_class_summary": build_repo_sync_data_class_summary(repos),
         "repos": repos,
     }

{code_mower-0.5.0b29 → code_mower-0.5.0b31}/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"),