agent-lifecycle-kit 2.44.1__tar.gz → 2.45.0__tar.gz

{agent_lifecycle_kit-2.44.1/src/agent_lifecycle_kit.egg-info → agent_lifecycle_kit-2.45.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-lifecycle-kit
-Version: 2.44.1
+Version: 2.45.0
 Summary: Provider-neutral lifecycle control layer that helps coding agents plan, execute, validate, and prove software tasks to completion.
 Author: Agent Lifecycle Kit contributors
 License: Apache-2.0
@@ -42,7 +42,7 @@ Release 2.28 adds [bounded lifecycle and accounting baselines](docs/reference/pe
 ## Quick start
 Start with [install ALK and make the first run](docs/guides/install-and-first-run.md). Release 2.23 adds [compact S0/S1 authoring](docs/reference/tier-proportional-plan-packages.md) with explicit checklist completion and unchanged approval gates. Release 2.22 adds [conservative plan-review reuse](docs/reference/conservative-delta-review.md) with independent current applicability and no automatic full reruns. Release 2.21 adds [command accounting, bounded preparation and response recovery](docs/reference/source-native-workflow-accounting.md). Release 2.20 adds [target-bound initialization](docs/reference/cli.md#release-220-composed-initialization-and-digest-display), [bounded local continuation](docs/reference/workflow-continuation.md) and batched Git snapshots. Release 2.19 adds [safe artifact authoring and planning preflight](docs/reference/safe-artifact-authoring.md), [bounded review handoff](docs/reference/review-mesh.md#bounded-review-handoff) and thin skills with complete references. Release 2.18 bounds process/Git diagnostics, hardens signing and distinguishes OpenCode 1.x/2.x compatibility ([adapter notes](docs/adapters/opencode.md)); 2.17 strengthens [workflow validation and recovery](docs/reference/workflow-completeness.md). Release 2.16 introduced cumulative accounting within verified host capabilities; see [retention maintenance](docs/operations/retention-maintenance.md).
 
-It includes macOS, Linux and Windows instructions, Python 3.11-3.15, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==2.44.1`, and common `agent-lifecycle version` errors. See [2.15 migration notes](docs/reference/cli.md#migrating-authority-artifacts-to-215) and [authority boundaries](docs/reference/authority-artifact-boundaries.md).
+It includes macOS, Linux and Windows instructions, Python 3.11-3.15, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==2.45.0`, and common `agent-lifecycle version` errors. See [2.15 migration notes](docs/reference/cli.md#migrating-authority-artifacts-to-215) and [authority boundaries](docs/reference/authority-artifact-boundaries.md).
 
 For a quick start, run:
 
@@ -190,7 +190,7 @@ Adapter installation and support-level details live in [Adapter install](docs/ad
 - Start: [English documentation](docs/README.md), [Русская документация](docs/ru/README.md), [Install](docs/guides/install-and-first-run.md), [Quickstart](docs/guides/quickstart.md), [Beginner and advanced workflows](docs/guides/beginner-and-advanced-workflows.md), [Commands by task](docs/guides/commands-by-task.md), [Research workflow](docs/guides/research-workflow.md), [Lifecycle task scenarios](docs/guides/lifecycle-cookbook.md), and [Code review workflows](docs/guides/code-review-workflows.md).
 - Planning and adapters: [Issue to specification drafts](docs/guides/issue-to-spec.md), [Adapter install](docs/adapters/install.md), and [Adapter support matrix](docs/adapters/support-matrix.md).
 - Reference: [System architecture](docs/architecture/system-architecture.md), [workflow customization and execution controls](docs/reference/workflow-customization.md), [guided workflow continuation](docs/reference/workflow-continuation.md), [execution strategy](docs/reference/execution-strategy.md), [CLI reference](docs/reference/cli.md), [External verification checks](docs/reference/external-verification-checks.md), [Bounded external tool jobs](docs/reference/external-tool-jobs.md), [Project domain language](docs/reference/project-domain-language.md), [Multi-run attention view](docs/reference/multi-run-attention-view.md), [Plan verification](docs/reference/plan-verification.md), [Research evidence](docs/reference/research-evidence.md), [Public locators and redaction](docs/reference/public-locators-and-redaction.md), [Finding-to-check adoption](docs/reference/finding-check-adoption.md), [Source of truth](docs/reference/source-of-truth.md), [Managed lifecycle runner](docs/reference/managed-lifecycle-runner.md), [Managed adapter sessions](docs/reference/managed-adapter-sessions.md), [Portable Agent Plugins](docs/reference/agent-plugins.md), [Plugin publication](docs/reference/plugin-publication.md), [Implementation audit](docs/reference/implementation-audit.md), [Plan completeness](docs/reference/plan-completeness.md), [Public contracts](docs/reference/public-contracts.md), and [Readiness diagnostics](docs/reference/readiness-diagnostics.md).
-- Quality and resources: [Reference-task evaluation](docs/reference/reference-task-evaluation.md), [model routing](docs/reference/model-routing.md), [quality-cost learning](docs/reference/quality-cost-learning.md), [review efficiency](docs/reference/review-efficiency.md), [evidence independence](docs/reference/evidence-independence.md), [performance and resource budgets](docs/reference/performance-and-resource-budgets.md), [lifecycle cost accounting](docs/reference/lifecycle-cost.md), [host-local token accounting](docs/reference/host-local-token-accounting.md), [process execution observability](docs/reference/process-execution-observability.md), [Usage export](docs/reference/usage-export.md), and [Evidence integrity](docs/reference/evidence-integrity.md).
+- Quality and resources: [Reference-task evaluation](docs/reference/reference-task-evaluation.md), [model routing and optional ranking](docs/reference/model-routing.md), [quality-cost learning](docs/reference/quality-cost-learning.md), [review efficiency](docs/reference/review-efficiency.md), [evidence independence](docs/reference/evidence-independence.md), [performance and resource budgets](docs/reference/performance-and-resource-budgets.md), [lifecycle cost accounting](docs/reference/lifecycle-cost.md), [host-local token accounting](docs/reference/host-local-token-accounting.md), [process execution observability](docs/reference/process-execution-observability.md), [Usage export](docs/reference/usage-export.md), and [Evidence integrity](docs/reference/evidence-integrity.md).
 - Profiles and operations: [Project workflow presets](docs/reference/workflow-presets.md), [Project workflow profile](docs/reference/project-workflow-profile.md), [Read-only status views](docs/reference/read-only-status-view.md), [Adapter progress bridge](docs/reference/automatic-progress-bridge.md), [Sandbox boundaries](docs/reference/sandbox-boundaries.md), [Import mappers](docs/reference/import-mappers.md), [Episode retrieval](docs/reference/episode-retrieval.md), [Runner migration](docs/guides/runner-migration-2.md), [Runner recovery records](docs/reference/runner-recovery.md), [Cross-check profile](docs/reference/cross-check-profile.md), [Review Mesh](docs/reference/review-mesh.md), [Risk-bound independent verification](docs/reference/risk-bound-independent-verification.md), [Bug Forensics profile](docs/reference/bug-forensics.md), and [Bug Forensics context budget](docs/reference/bug-forensics-context-budget.md).
 - Release assets: [Task templates](templates/tasks/README.md), [Neutrality scanning](docs/reference/neutrality.md), and [Release security](docs/security/release-security.md).
 Apache-2.0. See [LICENSE](LICENSE).

{agent_lifecycle_kit-2.44.1 → agent_lifecycle_kit-2.45.0}/README.md

@@ -19,7 +19,7 @@ Release 2.28 adds [bounded lifecycle and accounting baselines](docs/reference/pe
 ## Quick start
 Start with [install ALK and make the first run](docs/guides/install-and-first-run.md). Release 2.23 adds [compact S0/S1 authoring](docs/reference/tier-proportional-plan-packages.md) with explicit checklist completion and unchanged approval gates. Release 2.22 adds [conservative plan-review reuse](docs/reference/conservative-delta-review.md) with independent current applicability and no automatic full reruns. Release 2.21 adds [command accounting, bounded preparation and response recovery](docs/reference/source-native-workflow-accounting.md). Release 2.20 adds [target-bound initialization](docs/reference/cli.md#release-220-composed-initialization-and-digest-display), [bounded local continuation](docs/reference/workflow-continuation.md) and batched Git snapshots. Release 2.19 adds [safe artifact authoring and planning preflight](docs/reference/safe-artifact-authoring.md), [bounded review handoff](docs/reference/review-mesh.md#bounded-review-handoff) and thin skills with complete references. Release 2.18 bounds process/Git diagnostics, hardens signing and distinguishes OpenCode 1.x/2.x compatibility ([adapter notes](docs/adapters/opencode.md)); 2.17 strengthens [workflow validation and recovery](docs/reference/workflow-completeness.md). Release 2.16 introduced cumulative accounting within verified host capabilities; see [retention maintenance](docs/operations/retention-maintenance.md).
 
-It includes macOS, Linux and Windows instructions, Python 3.11-3.15, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==2.44.1`, and common `agent-lifecycle version` errors. See [2.15 migration notes](docs/reference/cli.md#migrating-authority-artifacts-to-215) and [authority boundaries](docs/reference/authority-artifact-boundaries.md).
+It includes macOS, Linux and Windows instructions, Python 3.11-3.15, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==2.45.0`, and common `agent-lifecycle version` errors. See [2.15 migration notes](docs/reference/cli.md#migrating-authority-artifacts-to-215) and [authority boundaries](docs/reference/authority-artifact-boundaries.md).
 
 For a quick start, run:
 
@@ -167,7 +167,7 @@ Adapter installation and support-level details live in [Adapter install](docs/ad
 - Start: [English documentation](docs/README.md), [Русская документация](docs/ru/README.md), [Install](docs/guides/install-and-first-run.md), [Quickstart](docs/guides/quickstart.md), [Beginner and advanced workflows](docs/guides/beginner-and-advanced-workflows.md), [Commands by task](docs/guides/commands-by-task.md), [Research workflow](docs/guides/research-workflow.md), [Lifecycle task scenarios](docs/guides/lifecycle-cookbook.md), and [Code review workflows](docs/guides/code-review-workflows.md).
 - Planning and adapters: [Issue to specification drafts](docs/guides/issue-to-spec.md), [Adapter install](docs/adapters/install.md), and [Adapter support matrix](docs/adapters/support-matrix.md).
 - Reference: [System architecture](docs/architecture/system-architecture.md), [workflow customization and execution controls](docs/reference/workflow-customization.md), [guided workflow continuation](docs/reference/workflow-continuation.md), [execution strategy](docs/reference/execution-strategy.md), [CLI reference](docs/reference/cli.md), [External verification checks](docs/reference/external-verification-checks.md), [Bounded external tool jobs](docs/reference/external-tool-jobs.md), [Project domain language](docs/reference/project-domain-language.md), [Multi-run attention view](docs/reference/multi-run-attention-view.md), [Plan verification](docs/reference/plan-verification.md), [Research evidence](docs/reference/research-evidence.md), [Public locators and redaction](docs/reference/public-locators-and-redaction.md), [Finding-to-check adoption](docs/reference/finding-check-adoption.md), [Source of truth](docs/reference/source-of-truth.md), [Managed lifecycle runner](docs/reference/managed-lifecycle-runner.md), [Managed adapter sessions](docs/reference/managed-adapter-sessions.md), [Portable Agent Plugins](docs/reference/agent-plugins.md), [Plugin publication](docs/reference/plugin-publication.md), [Implementation audit](docs/reference/implementation-audit.md), [Plan completeness](docs/reference/plan-completeness.md), [Public contracts](docs/reference/public-contracts.md), and [Readiness diagnostics](docs/reference/readiness-diagnostics.md).
-- Quality and resources: [Reference-task evaluation](docs/reference/reference-task-evaluation.md), [model routing](docs/reference/model-routing.md), [quality-cost learning](docs/reference/quality-cost-learning.md), [review efficiency](docs/reference/review-efficiency.md), [evidence independence](docs/reference/evidence-independence.md), [performance and resource budgets](docs/reference/performance-and-resource-budgets.md), [lifecycle cost accounting](docs/reference/lifecycle-cost.md), [host-local token accounting](docs/reference/host-local-token-accounting.md), [process execution observability](docs/reference/process-execution-observability.md), [Usage export](docs/reference/usage-export.md), and [Evidence integrity](docs/reference/evidence-integrity.md).
+- Quality and resources: [Reference-task evaluation](docs/reference/reference-task-evaluation.md), [model routing and optional ranking](docs/reference/model-routing.md), [quality-cost learning](docs/reference/quality-cost-learning.md), [review efficiency](docs/reference/review-efficiency.md), [evidence independence](docs/reference/evidence-independence.md), [performance and resource budgets](docs/reference/performance-and-resource-budgets.md), [lifecycle cost accounting](docs/reference/lifecycle-cost.md), [host-local token accounting](docs/reference/host-local-token-accounting.md), [process execution observability](docs/reference/process-execution-observability.md), [Usage export](docs/reference/usage-export.md), and [Evidence integrity](docs/reference/evidence-integrity.md).
 - Profiles and operations: [Project workflow presets](docs/reference/workflow-presets.md), [Project workflow profile](docs/reference/project-workflow-profile.md), [Read-only status views](docs/reference/read-only-status-view.md), [Adapter progress bridge](docs/reference/automatic-progress-bridge.md), [Sandbox boundaries](docs/reference/sandbox-boundaries.md), [Import mappers](docs/reference/import-mappers.md), [Episode retrieval](docs/reference/episode-retrieval.md), [Runner migration](docs/guides/runner-migration-2.md), [Runner recovery records](docs/reference/runner-recovery.md), [Cross-check profile](docs/reference/cross-check-profile.md), [Review Mesh](docs/reference/review-mesh.md), [Risk-bound independent verification](docs/reference/risk-bound-independent-verification.md), [Bug Forensics profile](docs/reference/bug-forensics.md), and [Bug Forensics context budget](docs/reference/bug-forensics-context-budget.md).
 - Release assets: [Task templates](templates/tasks/README.md), [Neutrality scanning](docs/reference/neutrality.md), and [Release security](docs/security/release-security.md).
 Apache-2.0. See [LICENSE](LICENSE).

{agent_lifecycle_kit-2.44.1 → agent_lifecycle_kit-2.45.0}/docs/reference/model-routing.md

@@ -330,3 +330,42 @@ The producer writes new structured artifacts as canonical JSON. Changes to the
 source, prefix, actor, binding or frontier require a refusal or explicit recovery.
 This mode is never enabled automatically after a missing or failed v1 receipt.
 
+
+## Opt-in qualified evidence ranking
+
+`benchmark rank-qualified` offers an advisory ranking within an explicit local
+candidate allowlist. Manual selection remains the default:
+
+```json
+{"schemaVersion":"agent-qualified-route-ranking-request.v1","enabled":false}
+```
+
+```bash
+agent-lifecycle benchmark rank-qualified --request local-ranking.json --out new-report.json
+```
+
+The request and optional new output must be regular files within the caller's
+repository directory; links and traversal are refused. The command never calls a
+model, starts a host, modifies a profile or adopts a route. Omit `--out` to print
+the report without a file write. Disabling ranking changes no selection state.
+
+Enabled requests run the existing model resolver before considering economics.
+Deterministic work returns `NO_MODEL_REQUIRED`; tier, risk, data, context,
+capability, lifecycle quality and failure-escalation floors remain authoritative.
+Local-only requests are evaluated against each supplied host profile. Every
+selected binding requires `calibrationStatus=PASSED`. Availability, manual
+selection, onboarding, launch authority and the existing bounded failure/fallback
+mechanisms still apply separately. A recommendation is no permission to launch.
+
+See [the benchmark evidence contract](benchmark-qualification.md#qualified-evidence-ranking)
+for enabled input and complete accepted-task resource requirements. Incomplete,
+stale, untrusted or incomparable evidence anywhere in the allowlist refuses the
+whole request with `NO_RECOMMENDATION`; the command does not drop a candidate to
+manufacture a winner. Input errors return a bounded error and nonzero exit.
+
+Reports contain candidate IDs, binding digests, classes and integer metric totals,
+never private provider/model names. `advisoryOnly=true`,
+`automaticRouteAdoptionEligible=false`, `liveEconomicQualification=UNQUALIFIED`
+and `savingsClaimed=false` always apply. Positive synthetic tests are `UNIT_ONLY`;
+live economic qualification and production promotion remain deferred. Digest
+membership does not attest a producer's identity or complete collection of calls.

{agent_lifecycle_kit-2.44.1 → agent_lifecycle_kit-2.45.0}/docs/ru/reference/model-routing.md

@@ -199,3 +199,42 @@ dispatch, среди заранее разрешённых подходящих
 явного восстановления. Режим не включается автоматически при отсутствии или
 отказе квитанции v1.
 
+
+## Добровольное ранжирование квалифицированных данных
+
+`benchmark rank-qualified` выдаёт рекомендательный рейтинг внутри явно заданного
+локального списка кандидатов. По умолчанию сохраняется ручной выбор:
+
+```json
+{"schemaVersion":"agent-qualified-route-ranking-request.v1","enabled":false}
+```
+
+```bash
+agent-lifecycle benchmark rank-qualified --request local-ranking.json --out new-report.json
+```
+
+Запрос и необязательный новый выходной файл должны находиться внутри каталога
+репозитория вызывающей стороны; ссылки и выход за границы запрещены. Команда не
+вызывает модель, не запускает хост, не меняет профиль и не принимает маршрут.
+Без `--out` результат только печатается. Отключение не меняет состояние выбора.
+
+Для включённого запроса существующий resolver применяется раньше экономических
+метрик. Детерминированная работа получает `NO_MODEL_REQUIRED`; ограничения tier,
+риска, данных, контекста, возможностей, качества lifecycle и эскалации ошибок
+сохраняются. Local-only запрос проверяется с каждым переданным профилем хоста.
+Выбранный binding обязан иметь `calibrationStatus=PASSED`. Доступность, ручной
+выбор, onboarding, разрешение запуска и существующие ограниченные механизмы
+эскалации/fallback применяются отдельно. Рекомендация не разрешает запуск.
+
+[Контракт benchmark](benchmark-qualification.md#ранжирование-квалифицированных-данных)
+описывает включённый запрос и полные ресурсы принятой задачи. Неполные,
+устаревшие, недоверенные или несопоставимые данные любого кандидата приводят к
+`NO_RECOMMENDATION` для всего запроса; исключать кандидата ради победителя нельзя.
+Ошибка входа возвращает ограниченное сообщение и ненулевой код завершения.
+
+Отчёт содержит ID кандидатов, digest binding, классы и целые суммы метрик, без
+частных имён провайдера/модели. Всегда действуют `advisoryOnly=true`,
+`automaticRouteAdoptionEligible=false`, `liveEconomicQualification=UNQUALIFIED`
+и `savingsClaimed=false`. Положительные синтетические тесты — `UNIT_ONLY`;
+экономическая квалификация живого хоста и production promotion отложены.
+Совпадение digest не подтверждает личность производителя и полноту сбора вызовов.

{agent_lifecycle_kit-2.44.1 → agent_lifecycle_kit-2.45.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-lifecycle-kit"
-version = "2.44.1"
+version = "2.45.0"
 description = "Provider-neutral lifecycle control layer that helps coding agents plan, execute, validate, and prove software tasks to completion."
 readme = "README.md"
 requires-python = ">=3.11,<3.16"

{agent_lifecycle_kit-2.44.1 → agent_lifecycle_kit-2.45.0}/src/agent_lifecycle/_version.py

@@ -1,3 +1,3 @@
 """Package version."""
 
-__version__ = "2.44.1"
+__version__ = "2.45.0"

{agent_lifecycle_kit-2.44.1 → agent_lifecycle_kit-2.45.0}/src/agent_lifecycle/cli/benchmarks.py

@@ -15,10 +15,20 @@ from agent_lifecycle.benchmarks import (
     validate_benchmark_run_receipt,
 )
 from agent_lifecycle.benchmarks.contracts import load_suite
-from agent_lifecycle.contracts import LifecycleError, read_json_object, write_json_create
+from agent_lifecycle.contracts import (
+    LifecycleError,
+    canonical_bytes,
+    load_json_object,
+    read_json_object,
+    write_json_create,
+)
+from agent_lifecycle.contracts.authority_io import create_authority_bytes, read_authority_bytes
+from agent_lifecycle.model_routing.qualified_selection import MAX_INPUT_BYTES, rank_qualified_routes
 
 
 def dispatch_benchmark(args: argparse.Namespace) -> dict[str, Any]:
+    if args.benchmark_command == "rank-qualified":
+        return _rank_qualified(args)
     if args.benchmark_command == "evaluate":
         payload = evaluate_reference_task(suite_path=Path(args.suite), artifact_path=Path(args.artifact))
     elif args.benchmark_command == "compare":
@@ -64,3 +74,28 @@ def dispatch_benchmark(args: argparse.Namespace) -> dict[str, Any]:
         except FileExistsError as exc:
             raise LifecycleError("output-already-exists", "benchmark output already exists") from exc
     return payload
+
+
+def _rank_qualified(args: argparse.Namespace) -> dict[str, Any]:
+    """Keep local sensitive input and create-only output within caller authority."""
+    try:
+        raw = read_authority_bytes(
+            Path(args.request),
+            max_bytes=MAX_INPUT_BYTES,
+            root=Path.cwd(),
+        )
+        request = load_json_object(raw, label="qualified route ranking request")
+        payload = rank_qualified_routes(request)
+        if args.out and request.get("enabled", False):
+            create_authority_bytes(
+                Path(args.out),
+                canonical_bytes(payload) + b"\n",
+                root=Path.cwd(),
+            )
+    except FileExistsError:
+        raise LifecycleError("output-already-exists", "ranking output already exists") from None
+    except LifecycleError as exc:
+        raise LifecycleError(exc.code, "qualified route ranking request refused") from None
+    except OSError:
+        raise LifecycleError("ranking-io-unavailable", "ranking input or output is unavailable") from None
+    return payload

{agent_lifecycle_kit-2.44.1 → agent_lifecycle_kit-2.45.0}/src/agent_lifecycle/cli/parsers.py

@@ -128,6 +128,9 @@ def _add_benchmark_parser(subparsers: argparse._SubParsersAction[argparse.Argume
     route_compare.add_argument("--candidate", action="append", required=True)
     route_compare.add_argument("--sample")
     route_compare.add_argument("--out")
+    ranking = benchmark_sub.add_parser("rank-qualified")
+    ranking.add_argument("--request", required=True)
+    ranking.add_argument("--out")
 
 
 def _add_strategy_parser(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None: