agent-lifecycle-kit 2.1.0__tar.gz → 2.3.0__tar.gz

{agent_lifecycle_kit-2.1.0/src/agent_lifecycle_kit.egg-info → agent_lifecycle_kit-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-lifecycle-kit
-Version: 2.1.0
+Version: 2.3.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
@@ -43,7 +43,7 @@ ALK provides a verifiable finish for external-agent work with proportionate cont
 ## Quick start
 Start with [install ALK and make the first run](docs/guides/install-and-first-run.md).
 
-It includes macOS, Linux and Windows instructions, Python 3.11-3.14, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==2.1.0`, and common `agent-lifecycle version` errors.
+It includes macOS, Linux and Windows instructions, Python 3.11-3.14, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==2.3.0`, and common `agent-lifecycle version` errors.
 
 For a quick start, run:
 
@@ -68,7 +68,7 @@ agent-lifecycle start --adapter <adapter-id> --file task.md
 - The boundaries of [planning-only launch](docs/reference/planning-only-launch.md) and [frozen-task launch through a verified profile](docs/reference/qualified-host-launch.md) are documented in the reference. Shipped planning profiles remain candidates with safe failure until the corresponding profile is verified.
 - The [system architecture](docs/architecture/system-architecture.md) page explains how the project is organized, and [project comparison](docs/reference/project-comparison.md) shows how it differs from similar tools.
 - Multiple-agent boundaries, workflow configuration, model choice, prompts, timeouts and retries are described in [workflow customization and execution controls](docs/reference/workflow-customization.md).
-- Create a local project profile with `agent-lifecycle project profile init`; see [project workflow profile](docs/reference/project-workflow-profile.md). Explain the selected profile, plan constraints and adapter capability lineage with [effective configuration](docs/reference/effective-configuration.md), [structured result qualification](docs/reference/structured-result-qualification.md) and [adapter action evidence](docs/reference/adapter-action-evidence.md). Add optional project-owned architecture and dependency evidence with [external verification checks](docs/reference/external-verification-checks.md).
+- Create a local project profile with `agent-lifecycle project profile init`; see [project workflow profile](docs/reference/project-workflow-profile.md). Explain the selected profile, plan constraints and adapter capability lineage with [effective configuration](docs/reference/effective-configuration.md), [structured result qualification](docs/reference/structured-result-qualification.md) and [adapter action evidence](docs/reference/adapter-action-evidence.md). Add optional project-owned architecture and dependency evidence with [external verification checks](docs/reference/external-verification-checks.md), track bounded terminology with [project domain language](docs/reference/project-domain-language.md), or coordinate several runs with the read-only [multi-run attention view](docs/reference/multi-run-attention-view.md).
 - For long sessions, use [context checkpoints and compaction recovery](docs/reference/context-checkpoints.md). They preserve a bounded local continuation package without changing plan authority.
 ## What it gives you
 - A finish-oriented lifecycle: plan, execute, review, and prove the result.
@@ -195,7 +195,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), [execution strategy](docs/reference/execution-strategy.md), [CLI reference](docs/reference/cli.md), [External verification checks](docs/reference/external-verification-checks.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).
+- Reference: [System architecture](docs/architecture/system-architecture.md), [workflow customization and execution controls](docs/reference/workflow-customization.md), [execution strategy](docs/reference/execution-strategy.md), [CLI reference](docs/reference/cli.md), [External verification checks](docs/reference/external-verification-checks.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), [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).

{agent_lifecycle_kit-2.1.0 → agent_lifecycle_kit-2.3.0}/README.md

@@ -21,7 +21,7 @@ ALK provides a verifiable finish for external-agent work with proportionate cont
 ## Quick start
 Start with [install ALK and make the first run](docs/guides/install-and-first-run.md).
 
-It includes macOS, Linux and Windows instructions, Python 3.11-3.14, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==2.1.0`, and common `agent-lifecycle version` errors.
+It includes macOS, Linux and Windows instructions, Python 3.11-3.14, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==2.3.0`, and common `agent-lifecycle version` errors.
 
 For a quick start, run:
 
@@ -46,7 +46,7 @@ agent-lifecycle start --adapter <adapter-id> --file task.md
 - The boundaries of [planning-only launch](docs/reference/planning-only-launch.md) and [frozen-task launch through a verified profile](docs/reference/qualified-host-launch.md) are documented in the reference. Shipped planning profiles remain candidates with safe failure until the corresponding profile is verified.
 - The [system architecture](docs/architecture/system-architecture.md) page explains how the project is organized, and [project comparison](docs/reference/project-comparison.md) shows how it differs from similar tools.
 - Multiple-agent boundaries, workflow configuration, model choice, prompts, timeouts and retries are described in [workflow customization and execution controls](docs/reference/workflow-customization.md).
-- Create a local project profile with `agent-lifecycle project profile init`; see [project workflow profile](docs/reference/project-workflow-profile.md). Explain the selected profile, plan constraints and adapter capability lineage with [effective configuration](docs/reference/effective-configuration.md), [structured result qualification](docs/reference/structured-result-qualification.md) and [adapter action evidence](docs/reference/adapter-action-evidence.md). Add optional project-owned architecture and dependency evidence with [external verification checks](docs/reference/external-verification-checks.md).
+- Create a local project profile with `agent-lifecycle project profile init`; see [project workflow profile](docs/reference/project-workflow-profile.md). Explain the selected profile, plan constraints and adapter capability lineage with [effective configuration](docs/reference/effective-configuration.md), [structured result qualification](docs/reference/structured-result-qualification.md) and [adapter action evidence](docs/reference/adapter-action-evidence.md). Add optional project-owned architecture and dependency evidence with [external verification checks](docs/reference/external-verification-checks.md), track bounded terminology with [project domain language](docs/reference/project-domain-language.md), or coordinate several runs with the read-only [multi-run attention view](docs/reference/multi-run-attention-view.md).
 - For long sessions, use [context checkpoints and compaction recovery](docs/reference/context-checkpoints.md). They preserve a bounded local continuation package without changing plan authority.
 ## What it gives you
 - A finish-oriented lifecycle: plan, execute, review, and prove the result.
@@ -173,7 +173,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), [execution strategy](docs/reference/execution-strategy.md), [CLI reference](docs/reference/cli.md), [External verification checks](docs/reference/external-verification-checks.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).
+- Reference: [System architecture](docs/architecture/system-architecture.md), [workflow customization and execution controls](docs/reference/workflow-customization.md), [execution strategy](docs/reference/execution-strategy.md), [CLI reference](docs/reference/cli.md), [External verification checks](docs/reference/external-verification-checks.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), [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).

{agent_lifecycle_kit-2.1.0 → agent_lifecycle_kit-2.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-lifecycle-kit"
-version = "2.1.0"
+version = "2.3.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.15"

{agent_lifecycle_kit-2.1.0 → agent_lifecycle_kit-2.3.0}/src/agent_lifecycle/_version.py

@@ -1,3 +1,3 @@
 """Package version."""
 
-__version__ = "2.1.0"
+__version__ = "2.3.0"

{agent_lifecycle_kit-2.1.0 → agent_lifecycle_kit-2.3.0}/src/agent_lifecycle/audit/__init__.py

@@ -1,6 +1,27 @@
 """Audit helpers for frozen lifecycle plans."""
 
+from agent_lifecycle.audit.bug_forensics import (
+    build_bug_forensics_audit,
+    require_bug_forensics_audit_pass,
+    validate_bug_forensics_audit,
+)
+from agent_lifecycle.audit.domain_language import (
+    build_domain_language_impact_audit,
+    validate_domain_language_impact_audit,
+)
+from agent_lifecycle.audit.implementation import (
+    build_final_implementation_audit,
+    build_implementation_audit_report,
+    require_implementation_audit_accepted,
+    validate_final_implementation_audit,
+    validate_implementation_audit_report,
+)
 from agent_lifecycle.audit.ownership import build_ownership_report
+from agent_lifecycle.audit.package import (
+    build_package_audit,
+    require_package_audit_pass,
+    validate_package_audit,
+)
 from agent_lifecycle.audit.proof_integrity import (
     build_finding_identity,
     build_fix_impact_receipt,
@@ -23,53 +44,38 @@ from agent_lifecycle.audit.review_verdict import (
     require_review_verdict_pass,
     validate_review_verdict,
 )
-from agent_lifecycle.audit.bug_forensics import (
-    build_bug_forensics_audit,
-    require_bug_forensics_audit_pass,
-    validate_bug_forensics_audit,
-)
-from agent_lifecycle.audit.implementation import (
-    build_final_implementation_audit,
-    build_implementation_audit_report,
-    require_implementation_audit_accepted,
-    validate_final_implementation_audit,
-    validate_implementation_audit_report,
-)
-from agent_lifecycle.audit.package import (
-    build_package_audit,
-    require_package_audit_pass,
-    validate_package_audit,
-)
 
 __all__ = [
     "build_bug_forensics_audit",
-    "build_ownership_report",
+    "build_domain_language_impact_audit",
     "build_final_implementation_audit",
-    "build_implementation_audit_report",
-    "build_package_audit",
     "build_finding_identity",
     "build_fix_impact_receipt",
     "build_hash_chain_migration_policy",
+    "build_implementation_audit_report",
+    "build_ownership_report",
+    "build_package_audit",
     "build_proof_integrity_receipt",
     "build_receipt_hash_chain",
     "build_root_cause_evidence",
     "compact_review_routing",
     "finding_identity_fields",
-    "require_proof_integrity_pass",
     "require_bug_forensics_audit_pass",
-    "require_review_verdict_pass",
     "require_implementation_audit_accepted",
     "require_package_audit_pass",
-    "validate_package_audit",
+    "require_proof_integrity_pass",
+    "require_review_verdict_pass",
     "stable_finding_id",
-    "validate_finding_identity",
     "validate_bug_forensics_audit",
+    "validate_domain_language_impact_audit",
     "validate_final_implementation_audit",
-    "validate_implementation_audit_report",
+    "validate_finding_identity",
     "validate_fix_impact_receipt",
     "validate_hash_chain_migration_policy",
+    "validate_implementation_audit_report",
+    "validate_package_audit",
     "validate_proof_integrity_receipt",
     "validate_receipt_hash_chain",
-    "validate_root_cause_evidence",
     "validate_review_verdict",
+    "validate_root_cause_evidence",
 ]

agent_lifecycle_kit-2.3.0/src/agent_lifecycle/audit/domain_language.py

@@ -0,0 +1,177 @@
+"""Read-only impact and stale-alias audits for project vocabularies."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from agent_lifecycle.contracts import LifecycleError, canonical_digest
+from agent_lifecycle.contracts.domain_language import (
+    domain_language_digest,
+    language_terms,
+    validate_domain_language,
+)
+from agent_lifecycle.contracts.domain_language_schemas import DOMAIN_LANGUAGE_AUDIT_SCHEMA
+from agent_lifecycle.contracts.paths import is_under_repo_path, normalize_repo_path
+
+MAX_AUDIT_FILE_BYTES = 131072
+
+
+def build_domain_language_impact_audit(
+    language: dict[str, Any],
+    *,
+    changed_term_ids: list[str] | None = None,
+    changed_paths: list[str] | None = None,
+    project_root: Path | None = None,
+) -> dict[str, Any]:
+    """Report affected references and deprecated aliases without modifying files."""
+
+    blockers: list[dict[str, Any]] = []
+    validation = validate_domain_language(language, project_root=project_root)
+    if validation["status"] != "PASS":
+        blockers.append({"code": "domain-language-invalid", "validation": validation})
+
+    terms = language_terms(language)
+    selected = sorted(set(changed_term_ids or terms))
+    for term_id in selected:
+        if term_id not in terms:
+            blockers.append({"code": "domain-language-term-missing", "termId": term_id})
+
+    normalized_paths: list[str] = []
+    for raw_path in changed_paths or []:
+        try:
+            normalized_paths.append(normalize_repo_path(raw_path, label="changed domain language path"))
+        except (LifecycleError, TypeError):
+            blockers.append({"code": "domain-language-changed-path-invalid", "path": raw_path})
+
+    references: dict[tuple[str, str, str], dict[str, Any]] = {}
+    stale_aliases: list[dict[str, Any]] = []
+    for term_id in selected:
+        term = terms.get(term_id)
+        if not isinstance(term, dict):
+            continue
+        term_references = term.get("references", [])
+        for reference in term_references if isinstance(term_references, list) else []:
+            if not isinstance(reference, dict):
+                continue
+            path = reference.get("path")
+            if not isinstance(path, str):
+                continue
+            try:
+                normalized = normalize_repo_path(path, label="domain language reference path")
+            except (LifecycleError, TypeError):
+                continue
+            if normalized_paths and not any(is_under_repo_path(normalized, root) for root in normalized_paths):
+                continue
+            normalized_reference = {
+                "kind": reference.get("kind"),
+                "path": normalized,
+                **({"locator": reference["locator"]} if isinstance(reference.get("locator"), str) else {}),
+            }
+            references[(str(reference.get("kind")), normalized, str(reference.get("locator", "")))] = (
+                normalized_reference
+            )
+            content: str | None = None
+            reference_error: str | None = None
+            if project_root is not None:
+                content, reference_error = _read_reference(project_root, normalized)
+                if reference_error is not None:
+                    blockers.append({"code": reference_error, "path": normalized})
+
+            aliases = term.get("aliases")
+            if not isinstance(aliases, list):
+                continue
+            for alias in aliases:
+                if not isinstance(alias, dict) or alias.get("status") != "DEPRECATED":
+                    continue
+                value = alias.get("value")
+                locale = alias.get("locale")
+                if not isinstance(value, str) or not isinstance(locale, str):
+                    continue
+                record = {
+                    "termId": term_id,
+                    "value": value,
+                    "locale": locale,
+                    "path": normalized,
+                    "locator": reference.get("locator"),
+                    "status": "DECLARED_DEPRECATED",
+                }
+                if (
+                    project_root is not None
+                    and reference_error is None
+                    and content is not None
+                    and value.casefold() in content.casefold()
+                ):
+                    record["status"] = "FOUND_IN_REFERENCE"
+                stale_aliases.append(record)
+
+    stale_aliases.sort(key=lambda item: (item["termId"], item["locale"], item["value"], item["path"]))
+    body = {
+        "schemaVersion": DOMAIN_LANGUAGE_AUDIT_SCHEMA,
+        "status": "FAIL" if blockers else ("DRIFT" if stale_aliases else "PASS"),
+        "languageDigest": domain_language_digest(language) if isinstance(language, dict) else None,
+        "selectedTermIds": selected,
+        "impactedReferences": [references[key] for key in sorted(references)],
+        "staleAliases": stale_aliases,
+        "blockers": blockers,
+        "readOnly": True,
+        "productionPromotionClaimed": False,
+    }
+    return {**body, "auditDigest": canonical_digest(body)}
+
+
+def validate_domain_language_impact_audit(audit: dict[str, Any]) -> dict[str, Any]:
+    """Validate an audit envelope and preserve its read-only boundary."""
+
+    blockers: list[dict[str, Any]] = []
+    if not isinstance(audit, dict):
+        blockers.append({"code": "domain-language-audit-invalid"})
+        audit = {}
+    if audit.get("schemaVersion") != DOMAIN_LANGUAGE_AUDIT_SCHEMA:
+        blockers.append({"code": "domain-language-audit-schema-invalid"})
+    if audit.get("readOnly") is not True:
+        blockers.append({"code": "domain-language-audit-not-read-only"})
+    if audit.get("productionPromotionClaimed") is not False:
+        blockers.append({"code": "domain-language-audit-production-claim"})
+    expected = canonical_digest({key: value for key, value in audit.items() if key != "auditDigest"})
+    if audit.get("auditDigest") != expected:
+        blockers.append({"code": "domain-language-audit-digest-mismatch", "expected": expected})
+    if audit.get("status") not in {"PASS", "DRIFT", "FAIL"}:
+        blockers.append({"code": "domain-language-audit-status-invalid"})
+    report = {
+        "schemaVersion": "agent-project-domain-language-audit-validation.v1",
+        "status": "PASS" if not blockers else "FAIL",
+        "auditStatus": audit.get("status"),
+        "blockers": blockers,
+        "productionPromotionClaimed": False,
+    }
+    return {**report, "validationDigest": canonical_digest(report)}
+
+
+def _read_reference(root: Path, relative_path: str) -> tuple[str | None, str | None]:
+    resolved_root = root.resolve()
+    raw_candidate = resolved_root / relative_path
+    if _has_symlink_component(resolved_root, relative_path):
+        return None, "domain-language-reference-symlink"
+    candidate = raw_candidate.resolve(strict=False)
+    try:
+        candidate.relative_to(root.resolve())
+    except ValueError:
+        return None, "domain-language-reference-escape"
+    if not candidate.exists() or not candidate.is_file():
+        return None, "domain-language-reference-missing"
+    try:
+        if candidate.stat().st_size > MAX_AUDIT_FILE_BYTES:
+            return None, "domain-language-reference-too-large"
+        return candidate.read_text(encoding="utf-8", errors="ignore"), None
+    except OSError:
+        return None, "domain-language-reference-unreadable"
+
+
+def _has_symlink_component(root: Path, relative_path: str) -> bool:
+    candidate = root
+    for component in Path(relative_path).parts:
+        candidate /= component
+        if candidate.is_symlink():
+            return True
+    return False

{agent_lifecycle_kit-2.1.0 → agent_lifecycle_kit-2.3.0}/src/agent_lifecycle/audit/ownership.py

@@ -53,6 +53,18 @@ def report_has_category(report: dict[str, Any], categories: set[str]) -> bool:
     return any(entry.get("category") in categories for entry in report.get("entries", []))
 
 
+def declared_ownership_paths(manifest: dict[str, Any]) -> list[str]:
+    """Return literal workstream ownership paths for read-only projections."""
+
+    classifiers = _classifiers(manifest, None)
+    paths = {
+        path
+        for roots in classifiers["workstreams"].values()
+        for path in roots
+    }
+    return sorted(paths)
+
+
 def _classifiers(manifest: dict[str, Any], manifest_path: Path | None) -> dict[str, Any]:
     package_value = manifest.get("package")
     package = package_value if isinstance(package_value, dict) else {}

{agent_lifecycle_kit-2.1.0 → agent_lifecycle_kit-2.3.0}/src/agent_lifecycle/cli/dispatch_observability.py

@@ -3,9 +3,11 @@
 from __future__ import annotations
 
 import argparse
+from datetime import UTC, datetime
 from pathlib import Path
 from typing import Any
 
+from agent_lifecycle.cli.dispatch_metrics import _dispatch_execution_report
 from agent_lifecycle.context import check_context, load_context_profile, render_context
 from agent_lifecycle.context.checkpoint_store import (
     restore_context_checkpoint,
@@ -54,7 +56,6 @@ from agent_lifecycle.metrics.audit_optimization import (
     validate_audit_optimization_report,
 )
 from agent_lifecycle.metrics.audit_samples import build_audit_samples
-from agent_lifecycle.cli.dispatch_metrics import _dispatch_execution_report
 from agent_lifecycle.model_routing import (
     resolve_model_route,
     validate_host_model_profile,
@@ -70,6 +71,7 @@ from agent_lifecycle.reporting import (
     build_change_summary_receipt,
     build_lifecycle_progress_view,
     build_lifecycle_progress_watch,
+    build_multi_run_attention_view,
     build_progress_bridge_receipt,
     build_status_view,
     build_workflow_event_feed,
@@ -127,7 +129,8 @@ def _dispatch_thread(args: argparse.Namespace) -> dict[str, Any]:
                 "thread request and receipt lineage validation failed",
                 {"validation": validation},
             )
-        limits = request.get("limits") if isinstance(request.get("limits"), dict) else {}
+        raw_limits = request.get("limits")
+        limits: dict[str, Any] = raw_limits if isinstance(raw_limits, dict) else {}
         imported = prepare_thread_context_import(
             operation_id=request["operationId"],
             source_receipt_digest=receipt["receiptDigest"],
@@ -181,6 +184,18 @@ def _dispatch_report(args: argparse.Namespace) -> dict[str, Any] | str:
         if args.out:
             write_json_create(Path(args.out), payload)
         return payload
+    if args.report_command in {"multi-run", "attention"}:
+        payload = build_multi_run_attention_view(
+            project_root=Path(args.project_root),
+            run_roots=[Path(item) for item in args.run_root],
+            max_runs=args.max_runs,
+            max_bytes_per_run=args.max_bytes_per_run,
+            stale_after_seconds=args.stale_after_seconds,
+            now=_parse_report_time(args.now),
+        )
+        if args.out:
+            write_json_create(Path(args.out), payload)
+        return payload
     if args.report_command == "progress":
         if args.watch:
             payload = build_lifecycle_progress_watch(
@@ -215,6 +230,18 @@ def _dispatch_report(args: argparse.Namespace) -> dict[str, Any] | str:
     raise LifecycleError("command-not-implemented", "report command is not implemented")
 
 
+def _parse_report_time(value: str | None) -> datetime | None:
+    if value is None:
+        return None
+    try:
+        parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
+    except ValueError as exc:
+        raise LifecycleError("multi-run-invalid-time", "--now must be an ISO-8601 timestamp") from exc
+    if parsed.tzinfo is None:
+        return parsed.replace(tzinfo=UTC)
+    return parsed.astimezone(UTC)
+
+
 def _dispatch_context(args: argparse.Namespace) -> dict[str, Any]:
     if args.context_command == "profile-check":
         return load_context_profile(Path(args.profile))
@@ -328,7 +355,10 @@ def _dispatch_context_checkpoint(args: argparse.Namespace) -> dict[str, Any]:
 def _require_checkpoint_output_root(root: Path) -> None:
     resolved = root.resolve()
     if ".alk" not in resolved.parts or not resolved.name == "checkpoints":
-        raise LifecycleError("context-checkpoint-output-root-invalid", "checkpoint output must remain in a .alk/context/checkpoints directory")
+        raise LifecycleError(
+            "context-checkpoint-output-root-invalid",
+            "checkpoint output must remain in a .alk/context/checkpoints directory",
+        )
 
 
 def _dispatch_goal(args: argparse.Namespace) -> dict[str, Any] | str:
@@ -383,12 +413,20 @@ def _dispatch_model(args: argparse.Namespace) -> dict[str, Any]:
         return validate_model_routing_profile(profile)
     if args.model_command == "route":
         routing_profile = read_json_object(Path(args.profile), label="model routing profile")
-        host_profile = read_json_object(Path(args.host_profile), label="host model profile") if args.host_profile else None
+        host_profile = (
+            read_json_object(Path(args.host_profile), label="host model profile")
+            if args.host_profile
+            else None
+        )
         request = read_json_object(Path(args.request), label="model route request")
         return resolve_model_route(request, routing_profile, host_profile=host_profile)
     if args.model_command == "usage-check":
         receipt = read_json_object(Path(args.receipt), label="model usage receipt")
-        decision = read_json_object(Path(args.route_decision), label="model route decision") if args.route_decision else None
+        decision = (
+            read_json_object(Path(args.route_decision), label="model route decision")
+            if args.route_decision
+            else None
+        )
         targets = read_json_object(Path(args.budget_targets), label="budget targets") if args.budget_targets else None
         result = validate_usage_receipt(receipt, budget_targets=targets, route_decision=decision)
         if result["status"] == "FAIL":
@@ -401,7 +439,7 @@ def _dispatch_model(args: argparse.Namespace) -> dict[str, Any]:
     raise LifecycleError("command-not-implemented", "model command is not implemented")
 
 
-def _dispatch_metrics(args: argparse.Namespace) -> dict[str, Any]:
+def _dispatch_metrics(args: argparse.Namespace) -> dict[str, Any] | str:
     if args.metrics_command == "cost-check":
         report = read_json_object(Path(args.receipt), label="lifecycle cost report")
         return require_lifecycle_cost_pass(validate_lifecycle_cost_report(report))
@@ -505,32 +543,15 @@ def _dispatch_metrics(args: argparse.Namespace) -> dict[str, Any]:
         write_json_create(Path(args.out), payload)
         return payload
     if args.metrics_command == "audit-report":
-        samples = _read_audit_samples(args.sample)
-        candidates = _read_json_items(args.candidate_profile, label="candidate profile")
-        references = _read_json_items(args.reference_task, label="reference task")
-        holdouts = _read_json_items(args.holdout_task, label="holdout task")
-        current = read_json_object(Path(args.current_profile), label="current optimization profile") if args.current_profile else None
-        report = build_audit_optimization_report(
-            samples,
-            candidate_profiles=candidates,
-            reference_tasks=references,
-            holdout_tasks=holdouts,
-            task_shape=args.task_shape,
-            quality_floor=args.quality_floor,
-            current_profile=current,
-        )
-        validation = validate_audit_optimization_report(report)
-        if validation["status"] != "PASS":
-            raise LifecycleError("audit-optimization-report-invalid", "audit optimization report validation failed", {"validation": validation})
-        write_json_create(Path(args.out), report)
-        if args.terminal:
-            return render_audit_optimization_terminal(report)
-        return report
+        return _dispatch_audit_report(args)
     if args.metrics_command == "audit-proposal":
         report = read_json_object(Path(args.report), label="audit optimization report")
-        recommendation = report.get("recommendation") if isinstance(report.get("recommendation"), dict) else {}
+        raw_recommendation = report.get("recommendation")
+        proposal_recommendation: dict[str, Any] = (
+            raw_recommendation if isinstance(raw_recommendation, dict) else {}
+        )
         proposal = build_optimization_proposal(
-            recommendation,
+            proposal_recommendation,
             approved=args.approved,
             target_kind=args.target_kind,
             target_revision=args.target_revision,
@@ -545,11 +566,44 @@ def _dispatch_metrics(args: argparse.Namespace) -> dict[str, Any]:
     raise LifecycleError("command-not-implemented", "metrics command is not implemented")
 
 
+def _dispatch_audit_report(args: argparse.Namespace) -> dict[str, Any] | str:
+    samples = _read_audit_samples(args.sample)
+    candidates = _read_json_items(args.candidate_profile, label="candidate profile")
+    references = _read_json_items(args.reference_task, label="reference task")
+    holdouts = _read_json_items(args.holdout_task, label="holdout task")
+    current = (
+        read_json_object(Path(args.current_profile), label="current optimization profile")
+        if args.current_profile
+        else None
+    )
+    report = build_audit_optimization_report(
+        samples,
+        candidate_profiles=candidates,
+        reference_tasks=references,
+        holdout_tasks=holdouts,
+        task_shape=args.task_shape,
+        quality_floor=args.quality_floor,
+        current_profile=current,
+    )
+    validation = validate_audit_optimization_report(report)
+    if validation["status"] != "PASS":
+        raise LifecycleError(
+            "audit-optimization-report-invalid",
+            "audit optimization report validation failed",
+            {"validation": validation},
+        )
+    write_json_create(Path(args.out), report)
+    if args.terminal:
+        return render_audit_optimization_terminal(report)
+    return report
+
+
 def _read_audit_samples(paths: list[str]) -> list[dict[str, Any]]:
     samples: list[dict[str, Any]] = []
     for item in paths:
         payload = read_json_object(Path(item), label="audit sample")
-        rows = payload.get("samples") if isinstance(payload.get("samples"), list) else [payload]
+        raw_samples = payload.get("samples")
+        rows = raw_samples if isinstance(raw_samples, list) else [payload]
         samples.extend(row for row in rows if isinstance(row, dict))
     return samples
 
@@ -558,7 +612,8 @@ def _read_json_items(paths: list[str], *, label: str) -> list[dict[str, Any]]:
     items: list[dict[str, Any]] = []
     for item in paths:
         payload = read_json_object(Path(item), label=label)
-        rows = payload if isinstance(payload, list) else payload.get("items") if isinstance(payload.get("items"), list) else [payload]
+        raw_items = payload.get("items")
+        rows = raw_items if isinstance(raw_items, list) else [payload]
         items.extend(row for row in rows if isinstance(row, dict))
     return items
 

{agent_lifecycle_kit-2.1.0 → agent_lifecycle_kit-2.3.0}/src/agent_lifecycle/cli/dispatch_planning.py

@@ -192,6 +192,8 @@ def _dispatch_plan(args: argparse.Namespace) -> dict[str, Any]:
             before_lock=read(args.before_lock, "before plan lock"),
             after_lock=read(args.after_lock, "after plan lock"),
             principles=read(args.principles, "project principles"),
+            language_before=read(args.language_before, "before project domain language"),
+            language_after=read(args.language_after, "after project domain language"),
         )
         if args.out:
             write_json_create(Path(args.out), payload)

{agent_lifecycle_kit-2.1.0 → agent_lifecycle_kit-2.3.0}/src/agent_lifecycle/cli/observability_parsers.py

@@ -17,6 +17,14 @@ def _add_report_parser(subparsers: argparse._SubParsersAction[argparse.ArgumentP
     event_feed = report_sub.add_parser("event-feed")
     event_feed.add_argument("--state", required=True)
     event_feed.add_argument("--out")
+    multi_run = report_sub.add_parser("multi-run", aliases=["attention"])
+    multi_run.add_argument("--project-root", default=".")
+    multi_run.add_argument("--run-root", "--run", dest="run_root", action="append", default=[])
+    multi_run.add_argument("--max-runs", type=int, default=32)
+    multi_run.add_argument("--max-bytes-per-run", type=int, default=1_048_576)
+    multi_run.add_argument("--stale-after-seconds", type=int, default=86_400)
+    multi_run.add_argument("--now")
+    multi_run.add_argument("--out")
     progress = report_sub.add_parser("progress")
     progress.add_argument("--state", required=True)
     progress.add_argument("--usage-receipt", action="append", default=[])

{agent_lifecycle_kit-2.1.0 → agent_lifecycle_kit-2.3.0}/src/agent_lifecycle/cli/planning_parsers.py

@@ -55,6 +55,8 @@ def _add_plan_parser(subparsers: argparse._SubParsersAction[argparse.ArgumentPar
     delta.add_argument("--before-lock")
     delta.add_argument("--after-lock")
     delta.add_argument("--principles")
+    delta.add_argument("--language-before", help="optional previous project domain language artifact")
+    delta.add_argument("--language-after", help="optional current project domain language artifact")
     delta.add_argument("--out")
     delta_check = plan_sub.add_parser("delta-check", aliases=["delta-validate"])
     delta_check.add_argument("--delta", required=True)