agent-wiki-cli 3.1.0__tar.gz → 3.2.0__tar.gz

{agent_wiki_cli-3.1.0/src/agent_wiki_cli.egg-info → agent_wiki_cli-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 3.1.0
+Version: 3.2.0
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License-Expression: MIT

{agent_wiki_cli-3.1.0 → agent_wiki_cli-3.2.0}/docs/automation.md

@@ -229,10 +229,20 @@ For an early diagnostic check before version preparation is complete, append
 `--stage contracts` to `run`. A partial invocation remains `blocked` for release
 readiness even when its checks succeed. Full execution runs the maintained
 host-applicable checks, independent builds and installed-artifact verification
-serially. It reports `failed`, `blocked`, or
-`local-ready-hosted-required`; the last result still requires normal hosted
+serially. It reports `failed`, `blocked`, `target-capture-required`,
+`target-runtime-unknown`, or `local-ready-hosted-required`; the last result still requires normal hosted
 qualification and all required target environments.
 
+Planning includes `readiness.target_runtime`, derived from the maintained proof
+owner and its composite runtime declarations. It reads committed wiki producer
+metadata without another application inventory. A known runtime mismatch needs
+the authorized target-host capture and review; unresolved declarations remain
+unknown. Local stage success cannot conceal either requirement. Advisory policy
+does not become a new mandatory gate. The generic installed
+[target prerequisite diagnostic](target-runtime-prerequisites.md) can also be
+used by other projects with their own declarations. Matching declared metadata
+is separate from package identity and fresh target-native proof.
+
 Local macOS success cannot establish Windows or Linux semantics, an unsupported
 helper or OCI architecture, an authenticated policy proof, or publication
 attestations. A missing capability remains pending. Continue through reviewed

{agent_wiki_cli-3.1.0 → agent_wiki_cli-3.2.0}/pyproject.toml

@@ -5,7 +5,7 @@ backend-path = ["."]
 
 [project]
 name = "agent-wiki-cli"
-version = "3.1.0"
+version = "3.2.0"
 description = "CLI tool to maintain hybrid LLM Wikis for multi-language projects."
 readme = "README.md"
 license = "MIT"

{agent_wiki_cli-3.1.0 → agent_wiki_cli-3.2.0/src/agent_wiki_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 3.1.0
+Version: 3.2.0
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License-Expression: MIT

{agent_wiki_cli-3.1.0 → agent_wiki_cli-3.2.0}/src/agent_wiki_cli.egg-info/SOURCES.txt

@@ -119,6 +119,7 @@ src/llm_wiki_cli/services/__init__.py
 src/llm_wiki_cli/services/analysis_capture.py
 src/llm_wiki_cli/services/analysis_compatibility.py
 src/llm_wiki_cli/services/analysis_contracts.json
+src/llm_wiki_cli/services/analysis_targets.py
 src/llm_wiki_cli/services/api_contracts.py
 src/llm_wiki_cli/services/api_diff.py
 src/llm_wiki_cli/services/bootstrap_runtime.py
@@ -362,6 +363,7 @@ tests/test_agent_instruction_decisions.py
 tests/test_analysis_compatibility.py
 tests/test_analysis_input_preflight.py
 tests/test_analysis_qualification.py
+tests/test_analysis_targets.py
 tests/test_api.py
 tests/test_api_contracts.py
 tests/test_api_diff.py
@@ -625,6 +627,7 @@ tests/test_policy_source_freeze.py
 tests/test_preflight.py
 tests/test_preflight_contracts.py
 tests/test_preflight_runner.py
+tests/test_preflight_targets.py
 tests/test_progress.py
 tests/test_protected_artifacts.py
 tests/test_protocol_registry.py
@@ -638,6 +641,7 @@ tests/test_pytest_portability.py
 tests/test_python_binding_adversaries.py
 tests/test_python_binding_state_growth.py
 tests/test_python_call_bindings.py
+tests/test_python_class_imports.py
 tests/test_python_constructor_bindings.py
 tests/test_python_constructor_control_flow.py
 tests/test_python_constructor_resolution.py

{agent_wiki_cli-3.1.0 → agent_wiki_cli-3.2.0}/src/llm_wiki_cli/cli.py

@@ -352,6 +352,7 @@ def _add_doctor_command(subparsers):
     doctor_contract = doctor_parser.add_mutually_exclusive_group()
     doctor_contract.add_argument("--capabilities", action="store_true", help="Opt into doctor v2 with provider prerequisites and corrective commands")
     doctor_contract.add_argument("--analysis-inputs", action="store_true", help="Check installed provider input classification without scanning project source")
+    doctor_contract.add_argument("--target-runtime", metavar="JSON", help="Compare committed wiki runtime prerequisites with project-owned target declarations, without scanning source or executing targets")
     doctor_parser.add_argument("--comparison-policy", choices=("auto", "exact-v1", "analysis-v1"), default="auto")
     doctor_contract.add_argument("--report-schema", choices=("auto", "v1", "v3", "v4"), default="auto", help="Health report schema; v3 includes captured coverage and producer details")
     doctor_parser.add_argument(

agent_wiki_cli-3.2.0/src/llm_wiki_cli/commands/doctor_cmd.py

@@ -0,0 +1,135 @@
+"""CLI adapter for the read-only knowledge health report."""
+
+from __future__ import annotations
+
+import json
+
+from ..config import DEFAULT_WIKI_DIR
+from ..services.doctor_service import build_doctor_report, render_doctor_text
+from ..services.extraction_jobs import extraction_job_request_from_args
+
+
+def _render_analysis_input_text(report) -> str:
+    """Readable classification diagnostics with unchanged scope and work bounds."""
+    bounds = report["bounds"]
+    lines = [
+        f"Analysis inputs: {report['status']}",
+        f"Scope: {report['scope']}",
+        f"Registry: {report['registry']}",
+        f"Paths: {bounds['returned']} of {bounds['total']}; omitted: {bounds['omitted']}",
+    ]
+    if report["reason"]:
+        lines.append(f"Reason: {report['reason']}")
+    lines.extend(
+        f"- {row['kind']}: {json.dumps(row['path'], ensure_ascii=True)}"
+        for row in report["paths"]
+    )
+    if report["next_action"]:
+        lines.append(f"Next action: {report['next_action']}")
+    lines.append(f"Qualification: {report['qualification']}")
+    return "\n".join(lines)
+
+
+def run(args) -> None:
+    report_schema = getattr(args, "report_schema", "auto")
+    if getattr(args, "target_runtime", None):
+        if (
+            getattr(args, "strict", False)
+            or getattr(args, "comparison_policy", "auto") != "auto"
+        ):
+            raise ValueError(
+                "--target-runtime checks declared prerequisites only; run strict health and comparison-policy checks separately"
+            )
+        from ..config import validate_path
+        from ..services.analysis_targets import inspect_targets, load_targets
+
+        validate_path(args.wiki_dir, "--wiki-dir")
+        validate_path(args.target_runtime, "--target-runtime")
+        report = inspect_targets(args.wiki_dir, load_targets(args.target_runtime))
+        if args.format == "json":
+            print(json.dumps(report, sort_keys=True, ensure_ascii=True))
+        else:
+            print("Target runtime prerequisites: " + report["status"])
+            for row in report["rows"]:
+                print(
+                    json.dumps(
+                        {k: row[k] for k in ("owner", "component", "state", "reasons")},
+                        ensure_ascii=True,
+                    )
+                )
+            print(report["next_action"])
+            print(report["qualification"])
+        if report["status"] != "requirements-match":
+            raise SystemExit(2)
+        return
+    if getattr(args, "analysis_inputs", False):
+        if report_schema != "auto":
+            raise ValueError(
+                "--analysis-inputs and --report-schema are mutually exclusive"
+            )
+        from ..api import get_analysis_input_status
+
+        report = get_analysis_input_status()
+        print(
+            json.dumps(report, sort_keys=True, ensure_ascii=True)
+            if getattr(args, "format", "text") == "json"
+            else _render_analysis_input_text(report)
+        )
+        if report["status"] != "ready":
+            raise SystemExit(2)
+        return
+    if report_schema not in {"auto", "v1", "v3", "v4"}:
+        raise ValueError("--report-schema must be v1 or v3")
+    if getattr(args, "capabilities", False):
+        if report_schema not in {"auto", "v1"}:
+            raise ValueError(
+                "--capabilities and --report-schema are mutually exclusive"
+            )
+        from ..services.capability_diagnostics import (
+            build_capability_doctor,
+            render_capability_doctor,
+        )
+
+        report = build_capability_doctor(
+            args.wiki_dir,
+            args.src_dir,
+            strict=args.strict,
+            allow_external_src=args.allow_external_src,
+            helper_cache_dir=args.helper_cache_dir,
+            source_selection=args.source_selection,
+            include_tests=args.include_tests,
+            parallel_jobs=args.jobs,
+            job_request=extraction_job_request_from_args(args),
+        )
+        print(
+            json.dumps(report, indent=2, sort_keys=True)
+            if args.format == "json"
+            else render_capability_doctor(report),
+            end="\n" if args.format == "json" else "",
+        )
+        if report["exit_code"]:
+            raise SystemExit(report["exit_code"])
+        return
+    report = build_doctor_report(
+        getattr(args, "wiki_dir", DEFAULT_WIKI_DIR),
+        getattr(args, "src_dir", "."),
+        comparison_policy=getattr(args, "comparison_policy", "auto"),
+        strict=bool(getattr(args, "strict", False)),
+        allow_external_src=bool(getattr(args, "allow_external_src", False)),
+        helper_cache_dir=getattr(args, "helper_cache_dir", None),
+        include_tests=getattr(args, "include_tests", None),
+        parallel_jobs=getattr(args, "jobs", 1),
+        job_request=extraction_job_request_from_args(args),
+        source_selection=getattr(args, "source_selection", None),
+        report_schema=report_schema,
+    )
+    if getattr(args, "format", "text") == "json":
+        print(
+            json.dumps(
+                report.to_payload(report_schema=report_schema), indent=2, sort_keys=True
+            )
+        )
+    else:
+        print(render_doctor_text(report, report_schema=report_schema), end="")
+    if report.exit_code:
+        raise SystemExit(report.exit_code)

{agent_wiki_cli-3.1.0 → agent_wiki_cli-3.2.0}/src/llm_wiki_cli/commands/sync_cmd.py

@@ -2446,7 +2446,7 @@ def _sync_run_options_from_args(args) -> _SyncRunOptions:
     try:
         scoped_paths = repair_paths(getattr(args, "repair_evidence", None))
         if scoped_paths and include_plugins:
-            raise ScopedRepairError("--repair-evidence requires --no-plugins and an existing matching built-in producer")
+            raise ScopedRepairError("--repair-evidence requires --no-plugins and complete built-in analysis")
         if scoped_paths and (initialize_surfaces or not preserve_semantic or openapi_file or clear_openapi_file
                              or getattr(args, "knowledge_format", None) or getattr(args, "rebuild_knowledge", False)):
             raise ScopedRepairError("--repair-evidence cannot change generation/storage policy or initialize surfaces")
@@ -4230,7 +4230,7 @@ def _prepare_sync_run(
     )
     evidence_refresh_sources = (
         _recoverable_evidence_refresh_sources(manifest, inventory, diff)
-        if not generator_refresh_required and not options.initialize_surfaces
+        if not options.initialize_surfaces
         and not seed_manifest and not repair_only else ()
     )
     runtime_basis_refresh = bool(
@@ -4406,7 +4406,9 @@ def _prepare_sync_run(
     )
     if evidence_refresh_sources:
         application_diff = deepcopy(application_diff)
-        application_diff.changed_files.extend(evidence_refresh_sources)
+        application_diff.changed_files.extend(
+            path for path in evidence_refresh_sources if path not in application_diff.changed_files
+        )
         application_diff.unchanged_files = [
             path for path in application_diff.unchanged_files if path not in evidence_refresh_sources
         ]
@@ -5405,6 +5407,7 @@ def _run_sync_options(options, write_basis=None) -> None:
             boundary = prepare_boundary(options, prepared)
             selected = tuple(path for path in prepared.evidence_refresh_sources if path in options.repair_paths)
             application = deepcopy(prepared.diff)
+            application.generated_page_repairs = {}
             application.changed_files.extend(selected)
             application.unchanged_files = [p for p in application.unchanged_files if p not in selected]
             maps = prepared.page_maps

{agent_wiki_cli-3.1.0 → agent_wiki_cli-3.2.0}/src/llm_wiki_cli/extractors/python_contracts.py

@@ -10,6 +10,8 @@ from __future__ import annotations
 import ast
 from collections.abc import Callable, Mapping
 
+from ..services.python_imports import module_binding_imports
+
 
 PARAM_POSITIONAL_ONLY = "positional_only"
 PARAM_POSITIONAL_OR_KEYWORD = "positional_or_keyword"
@@ -502,7 +504,7 @@ def finalize_inventory_model_kinds(
     for model_kind in ("pydantic", "typeddict"):
         _finalize_inventory_model_kind(inventory, model_kind, module_candidates)
     for file_data in inventory.values():
-        aliases = _inventory_import_aliases(file_data.get("imports", []))
+        aliases = _inventory_import_aliases(module_binding_imports(file_data))
         for item in file_data.get("classes", []):
             if item.get("model_kind") == "typeddict":
                 _apply_typed_dict_presence(item, aliases)
@@ -527,7 +529,7 @@ def _finalize_inventory_model_kind(
 
         for filepath, file_data in inventory.items():
             imported_bases: dict[str, tuple[str, str]] = {}
-            for record in file_data.get("imports", []):
+            for record in module_binding_imports(file_data):
                 if not isinstance(record, Mapping):
                     continue
                 if record.get("type") == "from" and record.get("name"):

{agent_wiki_cli-3.1.0 → agent_wiki_cli-3.2.0}/src/llm_wiki_cli/extractors/python_extractor.py

@@ -1154,6 +1154,10 @@ class ComponentVisitor(ast.NodeVisitor):
         self.generic_visit(node)
 
     def visit_ClassDef(self, node):
+        # Declaration extraction below intentionally does not descend into
+        # classes. Imports still need their own lexical walk, including local
+        # classes and nested methods, without promoting any declarations.
+        self._visit_class_imports(node)
         if self._class_depth > 0 or self._function_depth > 0:
             return
 
@@ -1218,6 +1222,35 @@ class ComponentVisitor(ast.NodeVisitor):
         self.classes.append(class_info)
         # Don't generic_visit — we already walked class body for methods/attrs
 
+    def _visit_class_imports(self, node: ast.ClassDef) -> None:
+        """Collect only imports, retaining enclosing execution/type-only scopes."""
+        original = self._function_depth, self._type_checking_depth
+        pending: list[tuple[ast.AST, int, int]] = [(node, *original)]
+        try:
+            while pending:
+                current, function_depth, type_depth = pending.pop()
+                if isinstance(current, (ast.Import, ast.ImportFrom)):
+                    self._function_depth = function_depth
+                    self._type_checking_depth = type_depth
+                    self.visit(current)
+                    continue
+                children: list[tuple[ast.AST, int, int]]
+                if isinstance(current, ast.If) and _is_type_checking_test(
+                    current.test, self._type_checking_names
+                ):
+                    children = [(current.test, function_depth, type_depth)]
+                    children.extend((child, function_depth, type_depth + 1) for child in current.body)
+                    children.extend((child, function_depth, type_depth) for child in current.orelse)
+                else:
+                    function_depth += isinstance(current, (ast.FunctionDef, ast.AsyncFunctionDef))
+                    children = [
+                        (child, function_depth, type_depth)
+                        for child in ast.iter_child_nodes(current)
+                    ]
+                pending.extend(reversed(children))
+        finally:
+            self._function_depth, self._type_checking_depth = original
+
     def visit_FunctionDef(self, node):
         # Only capture top-level functions (not methods inside classes)
         if self._class_depth == 0 and self._function_depth == 0:

{agent_wiki_cli-3.1.0 → agent_wiki_cli-3.2.0}/src/llm_wiki_cli/services/analysis_contracts.json

@@ -79,6 +79,7 @@
     "services/__init__.py",
     "services/analysis_capture.py",
     "services/analysis_compatibility.py",
+    "services/analysis_targets.py",
     "services/api_contracts.py",
     "services/api_diff.py",
     "services/bootstrap_runtime.py",