sourcecode 5.5.5__py3-none-any.whl → 5.6.1__py3-none-any.whl

sourcecode/__init__.py

@@ -4,4 +4,4 @@ ASK Engine is the product. ``ask`` is the canonical CLI command; ``sourcecode``
 the legacy compatibility alias and the Python/PyPI package name. See
 docs/PRODUCT_IDENTITY.md (normative)."""
 
-__version__ = "5.5.5"
+__version__ = "5.6.1"

sourcecode/_docs/LICENSE

@@ -0,0 +1,47 @@
+ASK Engine Proprietary License
+Version 1.0, effective 2026-08-13
+
+Copyright (c) 2026 Dominique Haroun. All rights reserved.
+
+1. Scope
+
+This license applies to ASK Engine version 5.6.1 and later, including its source
+code, documentation, and distributed artifacts (the "Software"). It does not
+alter the license of versions 5.5.6 and earlier, which were distributed under
+the Apache License, Version 2.0. Grants made for those earlier versions remain
+governed by their published license terms.
+
+2. No Implied Grant
+
+Except under a separate written agreement signed by Dominique Haroun, no right
+or license is granted to use, copy, modify, distribute, sublicense, sell,
+reverse engineer, or create derivative works of the Software. Possession of a
+copy, access to a repository, or access to a distributed artifact does not
+create an implied license.
+
+3. Third-Party Materials
+
+Third-party dependencies and materials included with the Software remain subject
+to their own license terms. This license does not supersede those terms.
+
+4. Trademarks
+
+"ASK Engine", "ASK", and associated marks are identifiers of the Software.
+No trademark license is granted except as required to identify an unmodified,
+lawfully obtained copy of the Software.
+
+5. No Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE,
+AND NON-INFRINGEMENT. TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE COPYRIGHT
+HOLDER SHALL NOT BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING
+FROM OR IN CONNECTION WITH THE SOFTWARE.
+
+6. Contact
+
+Commercial, evaluation, redistribution, and contribution terms require a
+written agreement with Dominique Haroun.
+
+This license text is an operational policy draft and must be reviewed by
+qualified counsel before distribution to third parties.

sourcecode/_docs/NOTICE

@@ -0,0 +1,8 @@
+ASK Engine
+Copyright (c) 2026 Dominique Haroun. All rights reserved.
+
+ASK Engine and its source code were originally created and developed by
+Dominique Haroun.
+
+This NOTICE applies to ASK Engine 5.6.1 and later. Earlier releases may carry
+different license terms; see the license distributed with the applicable release.

sourcecode/_docs/USER_GUIDE.md

@@ -136,7 +136,7 @@ pipx install sourcecode   # isolated install, no venv needed
 
 # Verify
 ask version
-# ask 5.5.5
+# ask 5.6.1
 ```
 
 Requires Python 3.9+.
@@ -157,7 +157,10 @@ On success:
 {"status": "activated", "plan": "pro", "features": ["impact", "review-pr", "fix-bug", "modernize", "generate-tests"]}
 ```
 
-License is cached in `~/.sourcecode/license.json` and re-validated every 24 hours. Works offline after first activation — network errors keep the cached state.
+License is cached in `~/.ask/license.json` and re-validated every 24 hours.
+The legacy `~/.sourcecode/license.json` location remains readable for existing
+installations. Works offline after first activation — network errors keep the
+cached state.
 
 ---
 

sourcecode/cli.py

@@ -1392,6 +1392,23 @@ def _analysis_budget(command: str) -> dict[str, Any]:
     }
 
 
+def _migrate_check_output_hint(*, compact: bool, min_severity: str) -> str:
+    """Build the output-size hint from the flags the caller already used."""
+    ways_out: list[str] = []
+    if not compact:
+        ways_out.append("--compact (bounded decision summary, same report)")
+    if min_severity != "high":
+        ways_out.append("--min-severity high to drop low-severity findings")
+    ways_out.append("--output FILE to save to disk")
+    ways_out.append("--force to bypass this guard")
+    prefix = (
+        "No smaller inline variant is available with the current flags; "
+        if compact and min_severity == "high"
+        else "Use "
+    )
+    return prefix + ", ".join(ways_out) + "."
+
+
 def _budget_evidence(command: str, path: "Optional[Path]") -> "tuple[Optional[str], Optional[str]]":
     """(measured anchors for this command, size of this repository) — or Nones.
 
@@ -1439,6 +1456,8 @@ def _enforce_analysis_budget(
         return
     source = budget.get("configured_source")
     from sourcecode.phased_run import budget_provenance, budget_warning
+    if not getattr(sys.stderr, "isatty", lambda: False)():
+        return
 
     if float(configured) >= recommended:
         # C3-83: over the floor there is no advice to give, and there is still a
@@ -6311,9 +6330,8 @@ def impact_cmd(
 
     _enforce_format("impact", format)
 
-    from sourcecode.repository_ir import (
-        build_repo_ir, find_java_files, compute_blast_radius,
-    )
+    from sourcecode.repository_ir import find_java_files, compute_blast_radius
+    from sourcecode.context_graph import ContextGraph
     from sourcecode.output_budget import BUDGET_IMPACT
 
     # Legacy-compat: old syntax was `impact <path> <target>`.
@@ -6366,9 +6384,16 @@ def impact_cmd(
         return
 
     _prog = Progress()
-    _prog.start(f"building IR ({len(file_list)} files) for impact analysis")
+    _prog.start(f"building CIR ({len(file_list)} files) for impact analysis")
     try:
-        ir = build_repo_ir(file_list, root)
+        # `impact-chain` resolves callers from the canonical IR, whose typed body
+        # facts contribute method-level call edges. Reading the legacy parse-only
+        # IR here made `impact` miss static calls (including locator accessors).
+        from sourcecode import context_cache as _ctxcache
+        try:
+            cir = _ctxcache.shared_cir(root, file_list, progress=_work_sink(_prog))
+        except Exception:
+            cir = ContextGraph.build(file_list, root, progress=_work_sink(_prog)).cir
     finally:
         _prog.finish()
 
@@ -6379,7 +6404,7 @@ def impact_cmd(
     # skipped the budget when writing to a file (C2-2).
     _to_file = output_path is not None
     result = compute_blast_radius(
-        ir, target, max_depth=depth, list_limit=0 if _to_file else None, root=root
+        cir._raw_ir, target, max_depth=depth, list_limit=0 if _to_file else None, root=root
     )
     result = _apply_budget(result, BUDGET_IMPACT, label="impact", output_path=output_path)
     if _misread and result.get("resolution") == "not_found":
@@ -9244,6 +9269,7 @@ def spring_audit_cmd(
                 _ris_sa(target, data)
             except Exception:
                 pass
+            output = _serialize_dict(data, format)
         finally:
             # C3-54: `done` must not claim the answer exists before it does. The
             # field log showed `[ask] done (6.8m)` printed, then the process torn
@@ -9259,21 +9285,6 @@ def spring_audit_cmd(
         )
     elif format == "github-comment":
         output = _render_spring_audit_github_comment(combined, min_severity)
-    else:
-        _full_data = combined.to_dict()
-        _bounded_default = (
-            not compact and output_path is None and format == "json" and not table
-            and len(_json.dumps(_full_data, ensure_ascii=False).encode("utf-8")) > 50_000
-        )
-        data = combined.to_compact_dict() if compact or _bounded_default else _full_data
-        if _bounded_default:
-            data.pop("mode", None)
-            data["default_output"] = "bounded"
-            data.pop("compact_note", None)
-            data["stdout_budget_note"] = (
-                "Capped by the stdout payload budget; use --output <file> for the complete report."
-            )
-        output = _serialize_dict(data, format)
 
     # F-AV: our own readers ask for the count under either spelling — the break
     # is meant for a consumer that never asked whether the run finished.
@@ -11191,11 +11202,7 @@ def migrate_check_cmd(
             "OUTPUT_TOO_LARGE",
             f"Estimated output is ~{_mig_tokens_est // 1000}K tokens — too large for "
             "most LLM context windows.",
-            hint=(
-                "Use --compact (bounded decision summary, same report), "
-                "--min-severity high to drop low-severity findings, "
-                "--output FILE to save to disk, or --force to bypass this guard."
-            ),
+            hint=_migrate_check_output_hint(compact=compact, min_severity=min_severity),
             expected="Output under 50K estimated tokens.",
         )
         raise typer.Exit(1)
@@ -12695,17 +12702,18 @@ def version_cmd(
     copy: bool = _copy_option(),
     output_path: Optional[Path] = _output_option(),
 ) -> None:
-    """Show version and exit.
+    """Show version, attribution, license and build provenance.
 
     Outputs human-readable text on interactive terminals.
     Outputs structured JSON on non-TTY (MCP, pipes, scripts):
       {"cli_version": "1.33.11", "mcp_schema_version": "1.33.11",
-       "compatibility_schema_version": "1.0"}
+       "compatibility_schema_version": "1.0", "provenance": {...}}
     """
     from sourcecode.release_info import advisory_line, build_status
+    from sourcecode.product_info import COPYRIGHT, PRODUCT, TAGLINE, build_provenance
 
     if getattr(sys.stdout, "isatty", lambda: False)():
-        _lines = [f"ask {__version__}"]
+        _lines = [f"{PRODUCT} {__version__}", TAGLINE, COPYRIGHT]
         # C4-12: the field audits builds that are days old and many releases
         # behind, and nothing said so. Printed only when it applies — an advisory
         # on every run is one nobody reads.
@@ -12732,6 +12740,7 @@ def version_cmd(
             # Same list `ask schema` prints, so the two surfaces cannot disagree
             # about what this release publishes.
             "registries": ["facts-v1"],
+            "provenance": build_provenance(),
         }, ensure_ascii=_json_ensure_ascii()), copy, output_path)
 
 
@@ -14234,12 +14243,20 @@ def cache_status_cmd(
             if "budget_bytes" in _store:
                 _budget_mb = _store.get("budget_mb")
                 _env = _store.get("budget_env")
+                _over_by = _store.get("over_budget_by_mb")
+                _current_mb = _store.get("current_mb")
                 if _store.get("budget_bytes"):
-                    _over = " — OVER, the next write evicts" if _store.get("over_budget") else ""
-                    _answer.say(
-                        f"{'':<13}budget {_budget_mb} MB, {_store.get('policy')} "
-                        f"(${_env}){_over}"
-                    )
+                    if _store.get("over_budget"):
+                        _answer.say(
+                            f"{'':<13}budget {_budget_mb} MB, {_store.get('policy')} "
+                            f"(${_env}); current {_current_mb} MB, over by {_over_by} MB "
+                            "— the next write evicts"
+                        )
+                    else:
+                        _answer.say(
+                            f"{'':<13}budget {_budget_mb} MB, {_store.get('policy')} "
+                            f"(${_env})"
+                        )
                 else:
                     _answer.say(f"{'':<13}{_store.get('policy')} (${_env})")
         # RIS section

sourcecode/parse_cache.py

@@ -440,6 +440,11 @@ def store_stats() -> "dict[str, object]":
         **_budget,
         "over_budget": bool(_limit) and total > _limit,
     }
+    if _limit:
+        out["over_budget_by_mb"] = round(
+            max(0, total - _limit) / (1024 * 1024), 2
+        )
+        out["current_mb"] = round(total / (1024 * 1024), 2)
     _stale = [g for g in generations if not g["current"]]
     if _stale:
         out["stale_entries"] = sum(int(g["entries"]) for g in _stale)

sourcecode/path_filters.py

@@ -183,6 +183,8 @@ def is_test_fixture_module_path(path: str) -> bool:
         bare = part.rstrip("/")
         if bare in _TEST_MODULE_SEGMENTS:
             return True
+        if bare.endswith(("-test", "-tests", "-it", "-itest", "-itests")):
+            return True
         if bare.endswith(_TEST_INFRA_SUFFIXES):
             return True
         toks = bare.replace("_", "-").split("-")

sourcecode/phased_run.py

@@ -41,6 +41,7 @@ from __future__ import annotations
 import hashlib
 import json
 import os
+import tempfile
 import time
 from dataclasses import dataclass, field
 from pathlib import Path
@@ -71,7 +72,7 @@ def partials_dir(root: Path) -> Path:
     except Exception:
         key_source = str(Path(root).absolute())
     key = hashlib.sha256(key_source.encode("utf-8", errors="replace")).hexdigest()[:16]
-    return Path.home() / ".sourcecode" / "partials" / key
+    return Path(tempfile.gettempdir()) / "sourcecode" / "partials" / key
 
 
 @dataclass

sourcecode/product_info.py

@@ -0,0 +1,22 @@
+"""Product identity and build provenance for official ASK Engine artifacts."""
+
+from __future__ import annotations
+
+import os
+
+PRODUCT = "ASK Engine"
+TAGLINE = "Actionable Software Knowledge Engine"
+COPYRIGHT = "Copyright (c) 2026 Dominique Haroun. All rights reserved."
+PUBLISHER = "Dominique Haroun"
+LICENSE_ID = "LicenseRef-ASK-Proprietary"
+
+
+def build_provenance() -> dict[str, str]:
+    """Return build facts without discovering state from the user's repository."""
+    return {
+        "product": PRODUCT,
+        "publisher": PUBLISHER,
+        "license": LICENSE_ID,
+        "distribution": os.environ.get("ASK_DISTRIBUTION", "official"),
+        "build_commit": os.environ.get("ASK_BUILD_COMMIT", "unrecorded"),
+    }

sourcecode/repository_ir.py

@@ -3833,8 +3833,6 @@ def _route_annotation_name(sym: SymbolRecord) -> str:
 def _enclosing_class(fqn: str) -> str:
     if "#" in fqn:
         return fqn.split("#")[0]
-    if "." in fqn:
-        return fqn.rsplit(".", 1)[0]
     return fqn
 
 
@@ -7122,6 +7120,46 @@ def extract_java_endpoints(
                 f"still expose an HTTP surface — verify manually before concluding the "
                 f"service has no public API."
             )
+
+    result["coverage"] = {
+        "detected_styles": {
+            "spring_mvc_annotations": sum(1 for e in endpoints if e.get("source") == "annotation"),
+            "xml_mapped": sum(1 for e in endpoints if e.get("source") == "xml_mapped"),
+            "router_dsl": sum(1 for e in endpoints if e.get("source") == "router_dsl"),
+            "openapi_spec": len(_spec_endpoints),
+            "webflux_functional": len(_fn_route_files),
+            "jax_rs": sum(1 for r in routes if r.get("framework") == "jax_rs"),
+            "webscripts": _nonspring["webscripts"],
+            "servlets": _nonspring["servlets"],
+        },
+        "supported_styles": {
+            "spring_mvc_annotations": True,
+            "xml_mapped": True,
+            "router_dsl": True,
+            "openapi_spec": True,
+            "jax_rs": True,
+            "webflux_functional": False,
+            "webscripts": False,
+            "servlets": False,
+        },
+        "gaps": [
+            *(
+                [f"webflux_functional: {len(_fn_route_files)} files"]
+                if _fn_route_count
+                else []
+            ),
+            *(
+                [f"webscripts: {_nonspring['webscripts']} files"]
+                if _nonspring["webscripts"]
+                else []
+            ),
+            *(
+                [f"servlets: {_nonspring['servlets']} declarations"]
+                if _nonspring["servlets"]
+                else []
+            ),
+        ],
+    }
     return result
 
 

sourcecode/servlet_surface.py

@@ -88,42 +88,53 @@ def _from_web_xml(xml_path: Path, relative: str) -> "tuple[list[ServletMapping],
         text = xml_path.read_text(encoding="utf-8", errors="replace")
         root = ET.fromstring(text)
     except Exception:
-        return [], 0
+        # Legacy descriptors can contain constructs ElementTree rejects. Keep the
+        # lexical fallback below, including its omission census; returning here
+        # made an undeclared live mapping look as though it had never existed.
+        root = None
     classes: "dict[str, str]" = {}
-    for elem in root.iter():
-        if _local(elem.tag) != "servlet":
-            continue
-        name = _child_text(elem, "servlet-name")
-        klass = _child_text(elem, "servlet-class")
-        if name:
-            classes[name] = klass
+    if root is not None:
+        for elem in root.iter():
+            if _local(elem.tag) != "servlet":
+                continue
+            name = _child_text(elem, "servlet-name")
+            klass = _child_text(elem, "servlet-class")
+            if name:
+                classes[name] = klass
     out: "list[ServletMapping]" = []
     undeclared_servlet_mappings = 0
-    for elem in root.iter():
-        if _local(elem.tag) != "servlet-mapping":
-            continue
-        name = _child_text(elem, "servlet-name")
-        if not name or name not in classes:
-            undeclared_servlet_mappings += sum(
-                1 for child in elem.iter()
-                if _local(child.tag) == "url-pattern" and (child.text or "").strip()
-            )
-            continue
-        for child in elem.iter():
-            if _local(child.tag) != "url-pattern" or not (child.text or "").strip():
+    if root is not None:
+        for elem in root.iter():
+            if _local(elem.tag) != "servlet-mapping":
                 continue
-            out.append(ServletMapping(
-                url_pattern=child.text.strip(),
-                servlet_name=name,
-                servlet_class=classes.get(name, ""),
-                source_file=relative,
-                source="web.xml",
-            ))
+            name = _child_text(elem, "servlet-name")
+            if not name or name not in classes:
+                undeclared_servlet_mappings += sum(
+                    1 for child in elem.iter()
+                    if _local(child.tag) == "url-pattern" and (child.text or "").strip()
+                )
+                continue
+            for child in elem.iter():
+                if _local(child.tag) != "url-pattern" or not (child.text or "").strip():
+                    continue
+                out.append(ServletMapping(
+                    url_pattern=child.text.strip(),
+                    servlet_name=name,
+                    servlet_class=classes.get(name, ""),
+                    source_file=relative,
+                    source="web.xml",
+                ))
     # Keep a tolerant lexical fallback for descriptors containing legacy XML
     # constructs that ElementTree rejects or partially normalizes. Comments are
     # removed first so commented deployment examples never become live routes.
     try:
         active = re.sub(r"<!--.*?-->", "", text, flags=re.DOTALL)
+        if root is None:
+            for block in re.findall(r"<servlet\b[^>]*>(.*?)</servlet>", active, re.DOTALL | re.IGNORECASE):
+                name_match = re.search(r"<servlet-name\b[^>]*>\s*([^<]+?)\s*</servlet-name>", block, re.DOTALL | re.IGNORECASE)
+                class_match = re.search(r"<servlet-class\b[^>]*>\s*([^<]+?)\s*</servlet-class>", block, re.DOTALL | re.IGNORECASE)
+                if name_match:
+                    classes[name_match.group(1).strip()] = class_match.group(1).strip() if class_match else ""
         for block in re.findall(r"<servlet-mapping\b[^>]*>(.*?)</servlet-mapping>", active, re.DOTALL | re.IGNORECASE):
             name_match = re.search(r"<servlet-name\b[^>]*>\s*([^<]+?)\s*</servlet-name>", block, re.DOTALL | re.IGNORECASE)
             pattern_match = re.search(r"<url-pattern\b[^>]*>\s*([^<]+?)\s*</url-pattern>", block, re.DOTALL | re.IGNORECASE)
@@ -131,6 +142,8 @@ def _from_web_xml(xml_path: Path, relative: str) -> "tuple[list[ServletMapping],
                 continue
             servlet_name = name_match.group(1).strip() if name_match else ""
             if not servlet_name or servlet_name not in classes:
+                if root is None:
+                    undeclared_servlet_mappings += 1
                 continue
             candidate = ServletMapping(
                 url_pattern=pattern_match.group(1).strip(),

sourcecode/timeline.py

@@ -211,7 +211,12 @@ class Sample:
 
 def _git(repo: Path, *args: str) -> subprocess.CompletedProcess:
     return subprocess.run(
-        ["git", "-C", str(repo), *args], capture_output=True, text=True, check=False,
+        ["git", "-C", str(repo), "-c", "i18n.logOutputEncoding=utf-8", *args],
+        capture_output=True,
+        text=True,
+        encoding="utf-8",
+        errors="replace",
+        check=False,
     )
 
 

{sourcecode-5.5.5.dist-info → sourcecode-5.6.1.dist-info}/METADATA

@@ -1,13 +1,18 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 5.5.5
+Version: 5.6.1
 Summary: Persistent structural context and ultra-fast repeated analysis for AI coding agents
+Project-URL: Homepage, https://github.com/HarounDominique/sourcecode
+Project-URL: Repository, https://github.com/HarounDominique/sourcecode
+Author: Dominique Haroun
+License: Proprietary; see LICENSE
 License-File: LICENSE
+License-File: NOTICE
 Keywords: agents,ai,codebase,context,developer-tools,llm
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
+Classifier: License :: Other/Proprietary License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
@@ -42,9 +47,13 @@ Description-Content-Type: text/markdown
 
 **Context · Impact · Migration · Architecture · Review — everything from one structural model.**
 
-![Version](https://img.shields.io/badge/version-5.5.5-blue)
+![Version](https://img.shields.io/badge/version-5.6.1-blue)
 ![Python](https://img.shields.io/badge/python-3.9%2B-green)
 
+Copyright (c) 2026 Dominique Haroun. All rights reserved. ASK Engine 5.6.1 and
+later are proprietary; see [LICENSE](LICENSE) and [NOTICE](NOTICE). Releases up
+to and including 5.5.6 remain governed by their published Apache-2.0 terms.
+
 > **ASK Engine** is the product. The CLI command is **`ask`**. The legacy **`sourcecode`**
 > command still works as a deprecated alias (it prints a one-line notice and forwards to
 > `ask`) and remains the Python/PyPI package name for now. The authoritative version is
@@ -126,7 +135,7 @@ brew tap haroundominique/sourcecode && brew install sourcecode
 # pip / pipx
 pipx install sourcecode        # or: pip install sourcecode
 
-ask version                    # ask 5.5.5 — and, on a build that has aged,
+ask version                    # ask 5.6.1 — and, on a build that has aged,
                                # how many releases have probably shipped since
 ```
 

{sourcecode-5.5.5.dist-info → sourcecode-5.6.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sourcecode/__init__.py,sha256=LWoy6uySGMfIcuMSAGcCF4LHEF2d_DbNo4PrVl8kous,308
+sourcecode/__init__.py,sha256=isL2psS-4yFbO0_giM54o6BMdZ6ngvWNjtLwYGTC0DU,308
 sourcecode/adaptive_scanner.py,sha256=yJBKjNpkY6bpueYJ2YnRezen3sYZDecEt7WaaNWdqug,9466
 sourcecode/archetype.py,sha256=CZvRLpkHot_D8D3JFQVorr-EHDJyh0BbS7RnSTqBigM,40499
 sourcecode/architectural_baseline.py,sha256=4GiMVBLJVHvRKSWQGf2ZVurI1-R0qk5pmaevgvGSgVA,26325
@@ -19,7 +19,7 @@ sourcecode/chain_rules.py,sha256=Bi6UHfgd-GxWswmnHRcPz5jdbAuqka3Zkz_P-MTvqhw,127
 sourcecode/change_plan.py,sha256=aX1mp2XnlDN-8R2BcTiu8HlkDwQ_4fN1ZLckj0VMXHM,9945
 sourcecode/cir_graphs.py,sha256=9G0HHj1kw2325IDyzo2OpX73BNswEckecf4MZUXB4JM,12078
 sourcecode/classifier.py,sha256=JBzPwSSrDG-tUHAbcKB678HRbjLpD-ohzbzzO62mgpo,20114
-sourcecode/cli.py,sha256=Lq6Kbunzj01R5pbcDbrF8lMslaTpc4JbrLyVozCsstA,650907
+sourcecode/cli.py,sha256=8cb4PXoIGsffcZL2ftqGuvK_G9zjU-BXLpTgvAtoTtA,651962
 sourcecode/client_calls.py,sha256=5_sBfFVXi6RgGiyWrlJKH4x4EF21do6gKlAOuFCKAoA,17709
 sourcecode/code_notes_analyzer.py,sha256=EJemNCNc9Dn-1RZYu-aNbK0ELzmsyC4s6FdHi3XyNEI,9392
 sourcecode/compare.py,sha256=2GdDy0qkDSgmkkpgvoCHitoLj3mt30EeFgJ8PGEXJng,14712
@@ -82,17 +82,18 @@ sourcecode/openrewrite_recipe.py,sha256=4dyY5twRB6Xew-G9Zy5FafNZwlMU1S7DnRa2FqPk
 sourcecode/output_budget.py,sha256=GxoFnbwk0dvqScgmMRPZHj7m-zRIoHLwUKplrH0u89s,13872
 sourcecode/output_encoding.py,sha256=OxiZQtr7uWBDUtblNQviNHsTH1Xo9AZEpsegPlQWKFk,2139
 sourcecode/parallel.py,sha256=T9N-I8rtr43eXx2ZmKcmj2e62v6wsEKE9Y7zGNZ62TU,10224
-sourcecode/parse_cache.py,sha256=TpIoSeNUba4Aoaz5o5SmgAc0Tz02OKq1Du4Hw7HyJfg,22560
+sourcecode/parse_cache.py,sha256=0pY2rcPZGhno1oPvdM0fAJt5h0i4uAGpyc0IJcvSaIg,22741
 sourcecode/partial_contract.py,sha256=x_N_0bF3mpNNjXd7JFB1zr6LSIroo2zN5GCz14GXvXQ,3510
 sourcecode/path_admission.py,sha256=OGNSoluhVh8YYOBZBnACUrkmH4Tp_yxjGLifkcsxQpo,5838
-sourcecode/path_filters.py,sha256=LmTYq735orssKTIuxTX1mE1FHAXF7dVEJEse35xE1RA,12371
+sourcecode/path_filters.py,sha256=mjrfdW5ydS2EUfEVKp1lhbfVZGIX7uLaA5RWjveE1SI,12470
 sourcecode/perf.py,sha256=QsFeacezwUu9T6RMpV4-cmyn98sbF2nWbWgarKxvNAk,35285
-sourcecode/phased_run.py,sha256=cFd0Lxfc8XL-XkCVCCzcjd9bZbtgkJkGZAHfmJ6dBJ4,16542
+sourcecode/phased_run.py,sha256=8nbA1-UZ39WR8m9wR9T2Sx2RuhoEzpY0-iXcok7FEsw,16573
 sourcecode/pipe_contract.py,sha256=PML0Er5d8uDyec4OrdUXuyqHbGPUYndjeaKUjkFz2u4,8369
 sourcecode/posture.py,sha256=7d3zM4ExrSXVKrWNTlXQ0fUQNqDdl1LOuKwRVaXdRss,76574
 sourcecode/pr_comment_renderer.py,sha256=239PmJdf95av_ZW236C7_tvq_ahECeuF9AZxrheJ4OQ,15573
 sourcecode/pr_impact.py,sha256=KyVBvHCCbgByKA_wqTbO1dSkfi05GEudIAuH4CyDPK4,27395
 sourcecode/prepare_context.py,sha256=ntB2MSScHtYRKRm9SansA0FrklMnXZmE9_yRXqXk0qc,239264
+sourcecode/product_info.py,sha256=0zjZEutL7iDdp9aVyIumIrNyNn9VWYFc2lIytSbjBP4,727
 sourcecode/progress.py,sha256=A4hNoCRgmHofilbIXMoR4vlvoF4gupefTUCuYmceI_E,20547
 sourcecode/provenance.py,sha256=gLbsLv0gze7k7ChM4i5M3MwKfFPzs8wzM72rUd2C5sM,7342
 sourcecode/ranking_engine.py,sha256=ZAucq_YX2KkWUuAZf4P0lhtQ_38vEFnUhuGtSZd1S0E,12970
@@ -106,7 +107,7 @@ sourcecode/relevance_scorer.py,sha256=0AgEt4KrV73nioMqBgjhGjtY7L2C7L7cSyKtj3IKcr
 sourcecode/remedies.py,sha256=V2_cD4pLq8bKRkzF-3RGFoiu1xWYZS384WDVp1MrlZw,10225
 sourcecode/rename_refactor.py,sha256=h6dNFlB9aZ_3q6heeHBkgXQeXaT03nvPSsYH6P8qxFg,12965
 sourcecode/repo_classifier.py,sha256=FG1vaWKdWXsWdl-S8hjVMiTqcwgaRXkDyvK4rPcOGtQ,22681
-sourcecode/repository_ir.py,sha256=nSStGh9z8uHSTj92IJp85Y1J8NDGqlY59KtEsgHThqY,388812
+sourcecode/repository_ir.py,sha256=gkQLnWsUuw8shQRj7iAHM1_dEYu057hrn7GzX6ZYm9g,390225
 sourcecode/ris.py,sha256=Xbx34dkJI_uXil9xsgw-fA_Apcm4nbnTjQgFm66dP1g,27489
 sourcecode/risk.py,sha256=u2V7nG5yGW8VV4sFDSgFkZqdI6ltmilWhlQwlIH7d2o,82660
 sourcecode/rule_catalog.py,sha256=pTkgkQZ1u7atB3fkQJ9BPWo8lNiamvEuRN7MtRgle0c,5263
@@ -125,7 +126,7 @@ sourcecode/semantic_impact_engine.py,sha256=t09IirGC3JjQDy33JZd1_WKzQVKXkoNl3-XE
 sourcecode/semantic_integration_engine.py,sha256=7a0WqAInOv39f0Yr_94TYo_JP_8QpeI9KGaknpzAyQU,18899
 sourcecode/semantic_services.py,sha256=nbUuPv-F01USTt_9CHT8iy_ucCIw3fz4W3Aquea_pd4,10782
 sourcecode/serializer.py,sha256=cK4I3WzX0H-oBPbqzBsUBRux5GcYmH_yPDQwxvkf8yQ,141598
-sourcecode/servlet_surface.py,sha256=1ZB76G5PrIGqmRAO8rEd20SMYoexZ5t01v82HtHLSXo,12481
+sourcecode/servlet_surface.py,sha256=CeiebkxLXKojUQxIf7HV7tdQAwLM32ggDUwBnVQIjdo,13499
 sourcecode/source_text.py,sha256=R52gmSljz7L6YVPbixv5W-LOZ5eKUVvSUP3S-QH_IWc,9047
 sourcecode/spring_event_topology.py,sha256=5_ON_21Le5zbG-1GRc5GLIi5HJfy_QjcXLVPC5WeUGQ,18055
 sourcecode/spring_findings.py,sha256=cW6NiQAFUM9mDYPitJr6MrQg--YBI41LxrSEMI9aeIQ,25272
@@ -142,7 +143,7 @@ sourcecode/target_admission.py,sha256=wFZ4pzlxhiF6Q6s2lEAZEzcCfj1Y6xNvujjt8MdO0Q
 sourcecode/test_gap_ranking.py,sha256=hl-tTyQUXZGJycG1b6npbLeE_DaVHaOsvPwG9qqC5y8,15711
 sourcecode/test_sources.py,sha256=KM88qbMfLDmUV5X2nA83LjYz8A2ipj4A_2u2FhZx8gc,9440
 sourcecode/text_input.py,sha256=3pL8DxR_DMI3ece-B70DnppvrEaLh4R17Pp8dK9G_hc,3596
-sourcecode/timeline.py,sha256=fU8UiHgf0qO2OsT-xe77tWeRJgp6ov55ZyXqnEGmd_E,17590
+sourcecode/timeline.py,sha256=mIEzaIylhtu2PBoqqz2iI4K_OxZf8fx9-Lf-Zj6QFXM,17704
 sourcecode/token_estimate.py,sha256=G-ivzIJfVq5TLQN04dC0WK4LZJjWVYL54Ebcxe4fJ7M,9268
 sourcecode/tree_utils.py,sha256=8GAkIfQAsvtEudIeW1l4ooH_oRtrWR8cpJQJsEa_Pfw,2093
 sourcecode/type_usage_surface.py,sha256=51IrKRQoIoRnlsiDjHnqpJBn2rc6E59aRhgS0HTzAF0,4428
@@ -214,9 +215,12 @@ sourcecode/telemetry/events.py,sha256=4_yeO58U-Cwc1Qb27VB0_EjhmroY0k91n3_VGxeALB
 sourcecode/telemetry/filters.py,sha256=RzxauTz8HliO4BllQnXEXc7zTeqdCZi5MgqGEDuW7OQ,6570
 sourcecode/telemetry/transport.py,sha256=4gGHsq0WeY9VywEZXA3vUxykfiYnw9uuqfjAAec7F8o,1681
 sourcecode/_docs/DEFECT-LEDGER.md,sha256=5SxWnKt6p5ZRmx-WsFhIlMfe7-e5fLF0QRa9lAmzYug,499071
-sourcecode/_docs/USER_GUIDE.md,sha256=ykjudytfe1VLgGJQAcs36wkXsEO3N-QJY2js1cJc7y0,79837
-sourcecode-5.5.5.dist-info/METADATA,sha256=bMkQLLoD1zYBemJ5ZJpHyy9xIurRVdVOTCP20jSLN6I,47104
-sourcecode-5.5.5.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-5.5.5.dist-info/entry_points.txt,sha256=-JEAdChrK5We51kZcb7OaDcyil-dHBjBPL-NhuO-QY8,89
-sourcecode-5.5.5.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-5.5.5.dist-info/RECORD,,
+sourcecode/_docs/LICENSE,sha256=23-fk61oSWGVmkWyka-FIM0rhAPM2hcYHnsaridL8Uo,1859
+sourcecode/_docs/NOTICE,sha256=Br-AA8Y3iJo1WXa5uP8QBpzqI5nDu3iGLbFyvDt3BOs,321
+sourcecode/_docs/USER_GUIDE.md,sha256=cfLC_id1-9LfNKWmofrPsDs4dY3QlF4PzGAn3ByW_Io,79924
+sourcecode-5.6.1.dist-info/METADATA,sha256=o11UMKvI7DHL337qHQ8W3_AY2TIdWeU4TMFZLSfSlSE,47546
+sourcecode-5.6.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-5.6.1.dist-info/entry_points.txt,sha256=-JEAdChrK5We51kZcb7OaDcyil-dHBjBPL-NhuO-QY8,89
+sourcecode-5.6.1.dist-info/licenses/LICENSE,sha256=23-fk61oSWGVmkWyka-FIM0rhAPM2hcYHnsaridL8Uo,1859
+sourcecode-5.6.1.dist-info/licenses/NOTICE,sha256=Br-AA8Y3iJo1WXa5uP8QBpzqI5nDu3iGLbFyvDt3BOs,321
+sourcecode-5.6.1.dist-info/RECORD,,

sourcecode-5.6.1.dist-info/licenses/LICENSE

@@ -0,0 +1,47 @@
+ASK Engine Proprietary License
+Version 1.0, effective 2026-08-13
+
+Copyright (c) 2026 Dominique Haroun. All rights reserved.
+
+1. Scope
+
+This license applies to ASK Engine version 5.6.1 and later, including its source
+code, documentation, and distributed artifacts (the "Software"). It does not
+alter the license of versions 5.5.6 and earlier, which were distributed under
+the Apache License, Version 2.0. Grants made for those earlier versions remain
+governed by their published license terms.
+
+2. No Implied Grant
+
+Except under a separate written agreement signed by Dominique Haroun, no right
+or license is granted to use, copy, modify, distribute, sublicense, sell,
+reverse engineer, or create derivative works of the Software. Possession of a
+copy, access to a repository, or access to a distributed artifact does not
+create an implied license.
+
+3. Third-Party Materials
+
+Third-party dependencies and materials included with the Software remain subject
+to their own license terms. This license does not supersede those terms.
+
+4. Trademarks
+
+"ASK Engine", "ASK", and associated marks are identifiers of the Software.
+No trademark license is granted except as required to identify an unmodified,
+lawfully obtained copy of the Software.
+
+5. No Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE,
+AND NON-INFRINGEMENT. TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE COPYRIGHT
+HOLDER SHALL NOT BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING
+FROM OR IN CONNECTION WITH THE SOFTWARE.
+
+6. Contact
+
+Commercial, evaluation, redistribution, and contribution terms require a
+written agreement with Dominique Haroun.
+
+This license text is an operational policy draft and must be reviewed by
+qualified counsel before distribution to third parties.

sourcecode-5.6.1.dist-info/licenses/NOTICE

@@ -0,0 +1,8 @@
+ASK Engine
+Copyright (c) 2026 Dominique Haroun. All rights reserved.
+
+ASK Engine and its source code were originally created and developed by
+Dominique Haroun.
+
+This NOTICE applies to ASK Engine 5.6.1 and later. Earlier releases may carry
+different license terms; see the license distributed with the applicable release.

sourcecode-5.5.5.dist-info/licenses/LICENSE

@@ -1,186 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other formats.
-
-      "Work" shall mean the work of authorship made available under
-      the License, as indicated by a copyright notice that is included in
-      or attached to the work (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other transformations
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean, as submitted to the Licensor for inclusion
-      in the Work by the copyright owner or by an individual or Legal Entity
-      authorized to submit on behalf of the copyright owner. For the purposes
-      of this definition, "submit" means any form of electronic, verbal, or
-      written communication sent to the Licensor or its representatives,
-      including but not limited to communication on electronic mailing lists,
-      source code control systems, and issue tracking systems that are managed
-      by, or on behalf of, the Licensor for the purpose of discussing and
-      improving the Work, but excluding communication that is conspicuously
-      marked or designated in writing by the copyright owner as "Not a
-      Contribution."
-
-      "Contributor" shall mean Licensor and any Legal Entity on behalf of
-      whom a Contribution has been received by the Licensor and included
-      within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by the combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a cross-claim
-      or counterclaim in a lawsuit) alleging that the Work or any Contributor
-      Contribution constitutes direct or contributory patent infringement,
-      then any patent rights granted to You under this License for that Work
-      shall terminate as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or Derivative
-          Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, You must include a readable copy of the
-          attribution notices contained within such NOTICE file, in
-          at least one of the following places: within a NOTICE text
-          file distributed as part of the Derivative Works; within
-          the Source form or documentation, if provided along with the
-          Derivative Works; or, within a display generated by the
-          Derivative Works, if and wherever such third-party notices
-          normally appear. The contents of the NOTICE file are for
-          informational purposes only and do not modify the License.
-          You may add Your own attribution notices within Derivative
-          Works that You distribute, alongside or in addition to the
-          NOTICE text from the Work, provided that such additional
-          attribution notices cannot be construed as modifying the License.
-
-      You may add Your own license statement for Your modifications and
-      may provide additional grant of rights to use, copy, modify, merge,
-      publish, distribute, sublicense, and/or sell copies of the
-      Derivative Works, as separate terms and conditions for their use,
-      reproduction, and distribution, or alongside or as supplement to
-      any license terms for such Derivative Works as a whole, provided
-      Your use, reproduction, and distribution of the Work otherwise
-      complies with the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or reproducing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or exemplary damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or all other
-      commercial damages or losses), even if such Contributor has been
-      advised of the possibility of such damages.
-
-   9. Accepting Warranty or Liability. While redistributing the Work or
-      Derivative Works thereof, You may choose to offer, and charge a fee
-      for, acceptance of support, warranty, indemnity, or other liability
-      obligations and/or rights consistent with this License. However, in
-      accepting such obligations, You may offer such obligations only on
-      Your own behalf and on Your sole responsibility, not on behalf of
-      any other Contributor, and only if You agree to indemnify, defend,
-      and hold each Contributor harmless for any liability incurred by,
-      or claims asserted against, such Contributor by reason of your
-      accepting any warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   Copyright 2024 sourcecode contributors
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.