cowork-flow 1.9.2 → 2.0.0

package/template/.cowork-flow/scripts/adapters/cli/spec_check.py

@@ -1,178 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""`run spec-check [--phase edit|lifecycle] [--file <path>...] [--json]`.
-
-Executes user-declared spec checks (frontmatter `checks:`) and prints a
-normalized one-line summary unless `--json`/`--verbose` asks for more. See
-services/spec_check.py for the three-state contract (pass/violation/unchecked).
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import sys
-
-if __package__:
-    from . import _bootstrap as _bootstrap  # noqa: F401
-else:
-    import _bootstrap  # noqa: F401
-
-from infra.paths import get_repo_root
-from services.spec_check import SpecCheckError, run_checks, summary_has
-
-
-def _report_exit_code(report: dict) -> int:
-    """Map a report to the public spec-check exit contract."""
-    if summary_has(report, "violation"):
-        return 1
-    # An executor failure means the checks never produced a verdict; it must
-    # never exit 0 just because the synthetic report carries no counter.
-    if (
-        summary_has(report, "unchecked")
-        or summary_has(report, "executorError")
-        or report.get("parseErrors")
-    ):
-        return 2
-    return 0
-
-
-def _parse_error_line(parse_errors: list) -> str:
-    """Render parse failures so text mode cannot look like a clean run."""
-    details = []
-    for item in parse_errors[:3]:
-        if isinstance(item, dict):
-            spec = item.get("spec") or "?"
-            error = item.get("error") or "unknown parse error"
-            details.append(f"{spec}: {error}")
-    suffix = f": {'; '.join(details)}" if details else ""
-    return f"spec-check: {len(parse_errors)} parse error(s){suffix}"
-
-
-def _build_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(
-        prog="spec-check",
-        description=(
-            "Run user-declared spec checks (frontmatter checks:) for one phase."
-        ),
-    )
-    parser.add_argument(
-        "--phase",
-        choices=("edit", "lifecycle"),
-        default="lifecycle",
-        help="edit: only declarations matching the given files (2.5s clamp); "
-        "lifecycle: every declaration honoring its files scope.",
-    )
-    parser.add_argument(
-        "--file",
-        action="append",
-        default=None,
-        help="Changed file path to match against declaration files filters; "
-        "repeatable. Drives the edit-phase filter and single-file queries.",
-    )
-    parser.add_argument(
-        "--verbose",
-        action="store_true",
-        help="Print full command output per result (query mode only).",
-    )
-    parser.add_argument(
-        "--throttled",
-        action="store_true",
-        help="Editor-phase mode: single-line report for one file, throttled "
-        "per file (empty output when nothing to report).",
-    )
-    parser.add_argument(
-        "--json",
-        action="store_true",
-        dest="as_json",
-        help="Print the machine-readable report.",
-    )
-    return parser
-
-
-def _run_throttled(repo_root, changed_files: list[str]) -> int:
-    from services.spec_check import run_edit_checks
-
-    if len(changed_files) != 1:
-        print("Error: --throttled requires exactly one --file", file=sys.stderr)
-        return 2
-    print(run_edit_checks(repo_root, changed_files[0]))
-    return 0
-
-
-def _print_text_report(report: dict, *, verbose: bool) -> None:
-    if verbose:
-        for result in report.get("results", []):
-            print(f"--- {result.get('spec')} :: {result.get('cmd')}")
-            for line in result.get("output", []):
-                print(line)
-            if result.get("reason"):
-                print(f"reason: {result['reason']}")
-
-    parse_errors = report.get("parseErrors") or []
-    if parse_errors:
-        print(_parse_error_line(parse_errors))
-        return
-
-    summary = report.get("summary", {})
-    if not parse_errors and summary.get("declarations") == 0:
-        # Zero declarations is a fact, not a pass: name it so a missing or
-        # silently ignored declaration block cannot look like a clean run.
-        print(
-            "spec-check: no checks declared "
-            f"({report.get('specFiles', 0)} spec files scanned)"
-        )
-        # The reader of this branch is the session that has just been told
-        # nothing is enforced, not a human skimming a terminal: without the
-        # write path and the syntax reference in the same breath, the fact it
-        # is looking at has no obvious next action attached to it.
-        print(
-            "next: write .cowork-flow/spec/<name>.md with frontmatter "
-            "checks: (any .md under spec/ outside contracts/, runtime/, "
-            "schemas/); syntax and example: "
-            ".cowork-flow/spec/contracts/spec-checks.md"
-        )
-        return
-
-    from services.spec_check import normalized_one_line
-
-    line = normalized_one_line(report)
-    if line:
-        print(line)
-        return
-    print(
-        "spec-check: {pass} passed, {violation} violations, "
-        "{unchecked} unchecked".format(
-            **{**{"pass": 0, "violation": 0, "unchecked": 0}, **summary}
-        )
-    )
-
-
-def main() -> int:
-    args = _build_parser().parse_args()
-    repo_root = get_repo_root()
-
-    if args.throttled:
-        return _run_throttled(repo_root, args.file or [])
-
-    try:
-        report = run_checks(
-            repo_root,
-            phase=args.phase,
-            changed_files=args.file or [],
-        )
-    except SpecCheckError as error:
-        print(f"Error: {error}", file=sys.stderr)
-        return 2
-
-    exit_code = _report_exit_code(report)
-    if args.as_json:
-        print(json.dumps(report, ensure_ascii=False, indent=2))
-        return exit_code
-
-    _print_text_report(report, verbose=args.verbose)
-    return exit_code
-
-
-if __name__ == "__main__":
-    sys.exit(main())