@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/templates/pactile/scripts/build_retrieval_pack.py

@@ -1,376 +0,0 @@
-#!/usr/bin/env python3
-"""Quality-layer CLI: pack already-collected evidence. Does not search.
-
-Three-layer retrieval ABI (frozen; do not merge back into workflow.md):
-
-| Layer    | Owner                 | This script                          |
-| -------- | --------------------- | ------------------------------------ |
-| Intent   | context-progressive   | does not own; does not emit intents  |
-| Provider | Middleware            | does not take smart-search as Kernel  |
-| Quality  | retrieval-extended    | owner: score/pack collected-evidence |
-
-Input role: ``collected-evidence`` (path + provider label + optional freshness).
-Output role: ``retrieval-pack``. Missing collection yields empty + explicit
-reason. A retrieval-pack is never Close / AC Evidence (that is verify-basic).
-
-This wrapper does not change the scoring algorithm in ``common.retrieval_pack``.
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import sys
-from pathlib import Path
-from typing import Any
-
-_SCRIPT_DIR = Path(__file__).resolve().parent
-if str(_SCRIPT_DIR) not in sys.path:
-    sys.path.insert(0, str(_SCRIPT_DIR))
-
-from common.retrieval_pack import (  # noqa: E402
-    build_retrieval_pack,
-    dict_value,
-    list_value,
-    normalize_dict_list,
-    read_input_payload,
-    resolve_repo_root,
-    string_value,
-)
-from common.codebase_retrieval_router import resolve_router_envelope  # noqa: E402
-
-ABI_INTENT_OWNER = "context-progressive"
-ABI_PROVIDER_OWNER = "middleware"
-ABI_QUALITY_OWNER = "retrieval-extended"
-ABI_LAYER = "quality"
-INPUT_ROLE = "collected-evidence"
-OUTPUT_ROLE = "retrieval-pack"
-
-MISSING_COLLECTION_REASON = (
-    "pack requires collected-evidence (path + provider label); "
-    "missing collection is not AC Evidence"
-)
-EMPTY_COLLECTION_REASON = (
-    "collected-evidence items were present but none mapped to pack sources; "
-    "empty retrieval-pack is not AC Evidence"
-)
-COLLECTED_NOT_AC_REASON = (
-    "quality-layer retrieval-pack of collected-evidence; "
-    "not AC Evidence and not Close Evidence"
-)
-
-_SMART_PROVIDERS = frozenset(
-    {"smart-search", "smart_search", "external-knowledge"}
-)
-_MEMORY_PROVIDERS = frozenset({"session-memory", "personal-memory", "journal"})
-_CODE_PROVIDERS = frozenset(
-    {"codebase", "codegraph", "rg", "grep", "exact", "semantic", "structural"}
-)
-
-
-def stamp_retrieval_pack_abi(
-    pack: dict[str, Any],
-    *,
-    collection_status: str,
-    reason: str,
-) -> dict[str, Any]:
-    """Mark pack ownership. Never eligible as AC / Close Evidence."""
-    stamped = dict(pack)
-    stamped["inputRole"] = INPUT_ROLE
-    stamped["outputRole"] = OUTPUT_ROLE
-    stamped["abiLayer"] = ABI_LAYER
-    stamped["abiOwner"] = ABI_QUALITY_OWNER
-    stamped["abiIntentOwner"] = ABI_INTENT_OWNER
-    stamped["abiProviderOwner"] = ABI_PROVIDER_OWNER
-    stamped["collectionStatus"] = collection_status
-    stamped["closeEvidenceEligible"] = False
-    stamped["notAcEvidence"] = True
-    stamped["reason"] = reason
-    return stamped
-
-
-def _first_str(record: dict[str, Any], *keys: str) -> str | None:
-    for key in keys:
-        value = string_value(record.get(key))
-        if value:
-            return value
-    return None
-
-
-def _legacy_items(payload: dict[str, Any]) -> list[dict[str, Any]]:
-    items: list[dict[str, Any]] = []
-    for raw in normalize_dict_list(list_value(payload.get("smartSearchManifests"))):
-        path = _first_str(raw, "manifestPath", "evidenceDir", "path", "reference")
-        items.append(
-            {
-                **raw,
-                "path": path or "",
-                "provider": _first_str(raw, "provider", "source") or "smart-search",
-                "freshness": raw.get("freshness") or raw.get("createdAt"),
-            }
-        )
-    for path in list_value(payload.get("smartSearchManifestPaths")):
-        text = string_value(path)
-        if text:
-            items.append({"path": text, "provider": "smart-search"})
-    for raw in normalize_dict_list(list_value(payload.get("artifactSearchResults"))):
-        path = _first_str(raw, "path", "reference")
-        items.append(
-            {
-                **raw,
-                "path": path or "",
-                "provider": _first_str(raw, "provider", "source") or "artifact-search",
-                "freshness": raw.get("freshness"),
-            }
-        )
-    for raw in normalize_dict_list(list_value(payload.get("sessionMemoryResults"))):
-        path = _first_str(raw, "path", "reference")
-        items.append(
-            {
-                **raw,
-                "path": path or "",
-                "provider": _first_str(raw, "provider", "source") or "session-memory",
-                "freshness": raw.get("freshness") or raw.get("date"),
-            }
-        )
-    for raw in normalize_dict_list(list_value(payload.get("codebaseCandidates"))):
-        path = _first_str(raw, "path", "reference")
-        items.append(
-            {
-                **raw,
-                "path": path or "",
-                "provider": _first_str(raw, "provider", "source") or "codebase",
-                "freshness": raw.get("freshness"),
-            }
-        )
-    return items
-
-
-def extract_collected_items(payload: dict[str, Any]) -> list[dict[str, Any]]:
-    """Normalize payload to collected-evidence items (path + provider)."""
-    explicit = payload.get("items")
-    if not isinstance(explicit, list):
-        explicit = payload.get("collectedEvidence")
-    source = explicit if isinstance(explicit, list) else _legacy_items(payload)
-
-    items: list[dict[str, Any]] = []
-    seen: set[tuple[str, str]] = set()
-    for raw in source:
-        if not isinstance(raw, dict):
-            continue
-        path = _first_str(raw, "path", "reference", "manifestPath", "evidenceDir")
-        provider = _first_str(raw, "provider", "source")
-        if not path or not provider:
-            continue
-        key = (path, provider)
-        if key in seen:
-            continue
-        seen.add(key)
-        record = dict(raw)
-        record["path"] = path
-        record["provider"] = provider
-        freshness = raw.get("freshness")
-        if freshness is not None and freshness != "":
-            record["freshness"] = freshness
-        items.append(record)
-    return items
-
-
-def _looks_like_manifest(item: dict[str, Any]) -> bool:
-    if any(key in item for key in ("status", "query", "citations", "doctor")):
-        return True
-    path = str(item.get("path") or "")
-    return path.endswith("manifest.json") and any(
-        key in item for key in ("manifestPath", "evidenceDir", "source")
-    )
-
-
-def _items_to_inner_kwargs(
-    items: list[dict[str, Any]],
-    payload: dict[str, Any],
-    repo_root: Path | str | None,
-) -> dict[str, Any]:
-    artifact_search_results: list[dict[str, Any]] = []
-    session_memory_results: list[dict[str, Any]] = []
-    smart_search_manifests: list[dict[str, Any]] = []
-    smart_search_manifest_paths: list[str] = []
-    codebase_candidates: list[dict[str, Any]] = []
-
-    for item in items:
-        provider = str(item.get("provider") or "")
-        path = str(item.get("path") or "")
-        record = dict(item)
-        record.setdefault("reference", path)
-        if provider in _SMART_PROVIDERS:
-            if _looks_like_manifest(item) and ("status" in item or "query" in item):
-                smart_search_manifests.append(record)
-            else:
-                smart_search_manifest_paths.append(path)
-        elif provider in _MEMORY_PROVIDERS:
-            session_memory_results.append(record)
-        elif provider in _CODE_PROVIDERS:
-            codebase_candidates.append(record)
-        else:
-            artifact_search_results.append(record)
-
-    guide = dict_value(payload.get("retrievalGuide")) if _legacy_items(payload) else {}
-
-    return {
-        "retrieval_guide": guide or None,
-        "artifact_search_results": artifact_search_results,
-        "session_memory_results": session_memory_results,
-        "smart_search_manifests": smart_search_manifests,
-        "smart_search_manifest_paths": smart_search_manifest_paths,
-        "codebase_candidates": codebase_candidates,
-        "repo_root": repo_root,
-        "router_envelope": resolve_router_envelope(
-            resolve_repo_root(repo_root),
-            explicit_router=dict_value(payload.get("routerEnvelope")) or None,
-            query=string_value(payload.get("query")) or None,
-        ),
-        "adapter_hints": normalize_dict_list(list_value(payload.get("adapterHints"))),
-    }
-
-
-def _status_and_reason(
-    items: list[dict[str, Any]], collection: dict[str, Any]
-) -> tuple[str, str]:
-    if not items:
-        return "missing", MISSING_COLLECTION_REASON
-    total = 0
-    for value in collection.values():
-        if isinstance(value, int):
-            total += value
-    if total <= 0:
-        return "empty", EMPTY_COLLECTION_REASON
-    return "collected", COLLECTED_NOT_AC_REASON
-
-
-def pack_from_collected_evidence(
-    items: list[dict[str, Any]] | None = None,
-    *,
-    payload: dict[str, Any] | None = None,
-    repo_root: Path | str | None = None,
-    max_items: int | None = None,
-    max_estimated_tokens: int | None = None,
-    include_diagnostics: bool = False,
-) -> dict[str, Any]:
-    """Build a retrieval-pack from collected-evidence. Never AC Evidence."""
-    data = dict(payload) if isinstance(payload, dict) else {}
-    collected = list(items) if items is not None else extract_collected_items(data)
-    empty_collection = {
-        "recommendations": 0,
-        "artifactSearchResults": 0,
-        "sessionMemoryResults": 0,
-        "smartSearchManifests": 0,
-        "codebaseCandidates": 0,
-    }
-    if not collected:
-        router_envelope = resolve_router_envelope(
-            resolve_repo_root(repo_root),
-            explicit_router=dict_value(data.get("routerEnvelope")) or None,
-            query=string_value(data.get("query")) or None,
-        )
-        if router_envelope:
-            inner = build_retrieval_pack(
-                None,
-                repo_root=repo_root,
-                max_items=max_items,
-                max_estimated_tokens=max_estimated_tokens,
-                include_diagnostics=include_diagnostics,
-                router_envelope=router_envelope,
-                adapter_hints=normalize_dict_list(
-                    list_value(data.get("adapterHints"))
-                ),
-            )
-            warnings = list(list_value(inner.get("warnings")))
-            if "missing-collected-evidence" not in warnings:
-                warnings.insert(0, "missing-collected-evidence")
-            inner = dict(inner)
-            inner["warnings"] = warnings
-            return stamp_retrieval_pack_abi(
-                inner,
-                collection_status="missing",
-                reason=MISSING_COLLECTION_REASON,
-            )
-        return stamp_retrieval_pack_abi(
-            {
-                "version": 1,
-                "source": "retrieval-pack-orchestrator",
-                "bundle": {},
-                "scoredEvidence": {"version": 1, "total": 0, "items": []},
-                "contextPack": {"selected": [], "omitted": []},
-                "collection": empty_collection,
-                "warnings": ["missing-collected-evidence"],
-            },
-            collection_status="missing",
-            reason=MISSING_COLLECTION_REASON,
-        )
-    kwargs = _items_to_inner_kwargs(collected, data, repo_root)
-    inner = build_retrieval_pack(
-        kwargs.get("retrieval_guide"),
-        artifact_search_results=kwargs.get("artifact_search_results"),
-        session_memory_results=kwargs.get("session_memory_results"),
-        smart_search_manifests=kwargs.get("smart_search_manifests"),
-        smart_search_manifest_paths=kwargs.get("smart_search_manifest_paths"),
-        codebase_candidates=kwargs.get("codebase_candidates"),
-        repo_root=repo_root,
-        max_items=max_items,
-        max_estimated_tokens=max_estimated_tokens,
-        include_diagnostics=include_diagnostics,
-        router_envelope=kwargs.get("router_envelope"),
-        adapter_hints=kwargs.get("adapter_hints"),
-    )
-    collection = dict_value(inner.get("collection"))
-    status, reason = _status_and_reason(collected, collection)
-    return stamp_retrieval_pack_abi(inner, collection_status=status, reason=reason)
-
-
-def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
-    parser = argparse.ArgumentParser(
-        description=(
-            "Quality layer: pack collected-evidence into a retrieval-pack. "
-            "Does not search. Output is not AC Evidence."
-        ),
-    )
-    parser.add_argument(
-        "--input",
-        help="Path to collected-evidence JSON. Defaults to stdin when omitted.",
-    )
-    parser.add_argument(
-        "--root",
-        help="Repository root for read-only Smart Search manifest discovery.",
-    )
-    parser.add_argument("--max-items", type=int, default=None)
-    parser.add_argument("--max-estimated-tokens", type=int, default=None)
-    parser.add_argument("--include-diagnostics", action="store_true")
-    parser.add_argument("--json", action="store_true", help="Pretty-print JSON.")
-    return parser.parse_args(argv)
-
-
-def main(argv: list[str] | None = None) -> int:
-    args = parse_args(argv)
-    try:
-        payload = read_input_payload(args.input)
-    except (OSError, json.JSONDecodeError) as error:
-        print(f"retrieval pack error: {error}", file=sys.stderr)
-        return 1
-
-    if not isinstance(payload, dict):
-        print("retrieval pack error: input must be a JSON object", file=sys.stderr)
-        return 1
-
-    result = pack_from_collected_evidence(
-        payload=payload,
-        repo_root=args.root,
-        max_items=args.max_items,
-        max_estimated_tokens=args.max_estimated_tokens,
-        include_diagnostics=args.include_diagnostics,
-    )
-    indent = 2 if args.json else None
-    print(json.dumps(result, indent=indent, ensure_ascii=False))
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/dist/templates/pactile/scripts/codegraph_session_smoke.py

@@ -1,76 +0,0 @@
-#!/usr/bin/env python3
-"""Pre-run checks for codegraph index presence (does not start MCP)."""
-
-from __future__ import annotations
-
-import argparse
-import json
-import sys
-from datetime import datetime, timezone
-from pathlib import Path
-
-from common.paths import get_repo_root
-
-
-def _find_codegraph_dirs(root: Path) -> list[Path]:
-    found: list[Path] = []
-    direct = root / ".codegraph"
-    if direct.is_dir():
-        found.append(direct.resolve())
-    for child in sorted(root.iterdir()):
-        if not child.is_dir():
-            continue
-        nested = child / ".codegraph"
-        if nested.is_dir() and nested.resolve() not in found:
-            found.append(nested.resolve())
-    return found
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(description="Codegraph session smoke (index on disk)")
-    parser.add_argument(
-        "--root",
-        type=Path,
-        default=None,
-        help="Workspace root (default: Pactile repo root)",
-    )
-    parser.add_argument("--json", action="store_true", help="Machine-readable report")
-    args = parser.parse_args()
-
-    root = (args.root or get_repo_root()).resolve()
-    indexes = _find_codegraph_dirs(root)
-    ok = len(indexes) > 0
-    payload = {
-        "ok": ok,
-        "workspace_root": str(root),
-        "codegraph_index_paths": [str(p) for p in indexes],
-        "checked_at": datetime.now(timezone.utc).isoformat().replace("+00:00", "Z"),
-        "mcp_note": (
-            "Cursor: enable codegraph MCP in project settings; this script only checks "
-            "on-disk .codegraph/ directories."
-        ),
-        "run_header_fields": {
-            "codegraph_mcp": "configured|unknown|off",
-            "codegraph_index_path": str(indexes[0]) if indexes else "",
-            "codegraph_smoke_at": "<iso8601>",
-            "codegraph_smoke_ok": ok,
-        },
-    }
-
-    if args.json:
-        print(json.dumps(payload, indent=2))
-    else:
-        if ok:
-            print("Codegraph smoke: PASS")
-            for p in indexes:
-                print(f"  index: {p}")
-        else:
-            print("Codegraph smoke: FAIL — no .codegraph/ under workspace root", file=sys.stderr)
-            print(f"  root: {root}", file=sys.stderr)
-        print(payload["mcp_note"])
-
-    return 0 if ok else 1
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/dist/templates/pactile/scripts/common/__init__.py

@@ -1,103 +0,0 @@
-"""
-Common utilities for Pactile workflow scripts.
-
-This module provides shared functionality used by other Pactile scripts.
-"""
-
-import io
-import sys
-
-# =============================================================================
-# Windows Encoding Fix (MUST be at top, before any other output)
-# =============================================================================
-# On Windows, stdout defaults to the system code page (often GBK/CP936).
-# This causes UnicodeEncodeError when printing non-ASCII characters.
-#
-# Any script that imports from common will automatically get this fix.
-# =============================================================================
-
-
-def _configure_stream(stream: object) -> object:
-    """Configure a stream for UTF-8 encoding on Windows."""
-    # Try reconfigure() first (Python 3.7+, more reliable)
-    if hasattr(stream, "reconfigure"):
-        stream.reconfigure(encoding="utf-8", errors="replace")  # type: ignore[union-attr]
-        return stream
-    # Fallback: detach and rewrap with TextIOWrapper
-    elif hasattr(stream, "detach"):
-        return io.TextIOWrapper(
-            stream.detach(),  # type: ignore[union-attr]
-            encoding="utf-8",
-            errors="replace",
-        )
-    return stream
-
-
-if sys.platform == "win32":
-    sys.stdout = _configure_stream(sys.stdout)  # type: ignore[assignment]
-    sys.stderr = _configure_stream(sys.stderr)  # type: ignore[assignment]
-    sys.stdin = _configure_stream(sys.stdin)  # type: ignore[assignment]
-
-
-def configure_encoding() -> None:
-    """
-    Configure stdout/stderr/stdin for UTF-8 encoding on Windows.
-
-    This is automatically called when importing from common,
-    but can be called manually for scripts that don't import common.
-
-    Safe to call multiple times.
-    """
-    global sys
-    if sys.platform == "win32":
-        sys.stdout = _configure_stream(sys.stdout)  # type: ignore[assignment]
-        sys.stderr = _configure_stream(sys.stderr)  # type: ignore[assignment]
-        sys.stdin = _configure_stream(sys.stdin)  # type: ignore[assignment]
-
-
-from .paths import (
-    DIR_WORKFLOW,
-    DIR_WORKSPACE,
-    DIR_TASKS,
-    DIR_ARCHIVE,
-    DIR_SPEC,
-    DIR_SCRIPTS,
-    FILE_DEVELOPER,
-    FILE_CURRENT_TASK,
-    FILE_TASK_JSON,
-    FILE_JOURNAL_PREFIX,
-    get_repo_root,
-    get_developer,
-    check_developer,
-    get_tasks_dir,
-    get_workspace_dir,
-    get_active_journal_file,
-    count_lines,
-    get_selected_task,
-    get_selected_task_abs,
-    get_selected_task_source,
-    set_selected_task,
-    clear_selected_task,
-    has_selected_task,
-    get_current_task,
-    get_current_task_abs,
-    normalize_task_ref,
-    resolve_task_ref,
-    set_current_task,
-    clear_current_task,
-    has_current_task,
-    generate_task_date_prefix,
-)
-
-from .active_task import (
-    ActiveTask,
-    SelectedTask,
-    clear_selected_task,
-    get_selected_task_source,
-    resolve_selected_task,
-    clear_active_task,
-    resolve_active_task,
-    resolve_context_key,
-    set_selected_task,
-    set_active_task,
-)