agent-codinglanguage-mapper 1.1.0__tar.gz → 1.1.2__tar.gz

agent_codinglanguage_mapper-1.1.2/.github/workflows/ci.yml

@@ -0,0 +1,445 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  PIP_DISABLE_PIP_VERSION_CHECK: "1"
+  PYTHONUTF8: "1"
+
+jobs:
+  build:
+    name: Build release artifacts
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Check out source
+        uses: actions/checkout@v7
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install build tooling
+        run: python -m pip install "build>=1.2" "twine>=5"
+
+      - name: Build wheel and source distribution once
+        run: python -m build
+
+      - name: Validate distribution metadata
+        run: python -m twine check dist/*
+
+      - name: Validate package contents and write checksums
+        shell: bash
+        run: |
+          python - <<'PY'
+          from email.parser import BytesParser
+          import hashlib
+          from pathlib import Path
+          import tarfile
+          import zipfile
+
+          dist = Path("dist")
+          wheels = sorted(dist.glob("*.whl"))
+          sdists = sorted(dist.glob("*.tar.gz"))
+          assert len(wheels) == 1, f"expected one wheel, found {wheels}"
+          assert len(sdists) == 1, f"expected one sdist, found {sdists}"
+
+          expected_templates = {
+              "agent_codinglanguage_mapper/templates/skill/SKILL.md",
+              "agent_codinglanguage_mapper/templates/opencode/plugins/codebase_map.ts",
+          }
+          forbidden = ("python-delphi-lsp", "python_delphi_lsp", "delphi_lsp")
+
+          with zipfile.ZipFile(wheels[0]) as archive:
+              names = set(archive.namelist())
+              metadata_name = next(name for name in names if name.endswith(".dist-info/METADATA"))
+              metadata = BytesParser().parsebytes(archive.read(metadata_name))
+              assert metadata["Name"] == "agent-codinglanguage-mapper"
+              assert metadata["Version"] == "1.1.2"
+              assert metadata["Author"] == "Dark Light"
+              requirements = [value.lower() for value in metadata.get_all("Requires-Dist", [])]
+              assert not any(marker in value for marker in forbidden for value in requirements)
+              assert expected_templates <= names
+              assert all(archive.getinfo(name).file_size > 0 for name in expected_templates)
+              assert not any(marker in name.lower() for marker in forbidden for name in names)
+              for name in names:
+                  if name.endswith(".py"):
+                      source = archive.read(name).lower()
+                      assert not any(marker.encode() in source for marker in forbidden), name
+
+          with tarfile.open(sdists[0], "r:gz") as archive:
+              members = [member for member in archive.getmembers() if member.isfile()]
+              names = {member.name for member in members}
+              pkg_info_name = next(name for name in names if name.count("/") == 1 and name.endswith("/PKG-INFO"))
+              pkg_info_stream = archive.extractfile(pkg_info_name)
+              assert pkg_info_stream is not None
+              metadata = BytesParser().parsebytes(pkg_info_stream.read())
+              assert metadata["Name"] == "agent-codinglanguage-mapper"
+              assert metadata["Version"] == "1.1.2"
+              assert metadata["Author"] == "Dark Light"
+              requirements = [value.lower() for value in metadata.get_all("Requires-Dist", [])]
+              assert not any(marker in value for marker in forbidden for value in requirements)
+              for template in expected_templates:
+                  matches = [name for name in names if name.endswith(f"/{template}")]
+                  assert len(matches) == 1, f"missing or duplicate sdist template: {template}"
+                  member = archive.getmember(matches[0])
+                  assert member.size > 0
+              assert not any(marker in name.lower() for marker in forbidden for name in names)
+
+          checksum_lines = []
+          for artifact in [*wheels, *sdists]:
+              digest = hashlib.sha256(artifact.read_bytes()).hexdigest()
+              checksum_lines.append(f"{digest}  {artifact.name}")
+          (dist / "SHA256SUMS").write_text("\n".join(checksum_lines) + "\n", encoding="ascii")
+          PY
+
+      - name: Upload exact distribution artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-distributions
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+            dist/SHA256SUMS
+          if-no-files-found: error
+          retention-days: 14
+
+  wheel-tests:
+    name: Wheel tests (${{ matrix.os }}, Python ${{ matrix.python-version }})
+    needs: build
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 25
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+          - macos-latest
+          - windows-latest
+        python-version:
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+
+    steps:
+      - name: Check out tests
+        uses: actions/checkout@v7
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Download exact distribution artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-distributions
+          path: dist
+
+      - name: Verify artifact checksums
+        shell: bash
+        run: |
+          python - <<'PY'
+          import hashlib
+          from pathlib import Path
+
+          dist = Path("dist")
+          expected = {}
+          for line in (dist / "SHA256SUMS").read_text(encoding="ascii").splitlines():
+              digest, filename = line.split(maxsplit=1)
+              expected[filename] = digest
+          artifacts = sorted([*dist.glob("*.whl"), *dist.glob("*.tar.gz")])
+          assert len(artifacts) == 2
+          assert set(expected) == {artifact.name for artifact in artifacts}
+          for artifact in artifacts:
+              actual = hashlib.sha256(artifact.read_bytes()).hexdigest()
+              assert actual == expected[artifact.name], artifact.name
+          PY
+
+      - name: Install exact wheel and test tooling
+        shell: bash
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install dist/*.whl
+          python -m pip install "pytest>=8" "pytest-cov>=5" "tomli>=2; python_version < '3.11'"
+
+      - name: Verify imports use the installed wheel
+        shell: bash
+        env:
+          HF_DATASETS_OFFLINE: "1"
+          HF_HUB_OFFLINE: "1"
+          PIP_NO_INDEX: "1"
+          TRANSFORMERS_OFFLINE: "1"
+          UV_OFFLINE: "1"
+        run: |
+          python - <<'PY'
+          from pathlib import Path
+          import agent_codinglanguage_mapper
+
+          imported = Path(agent_codinglanguage_mapper.__file__).resolve()
+          source = (Path.cwd() / "src").resolve()
+          assert source not in imported.parents, f"source-tree import detected: {imported}"
+          assert agent_codinglanguage_mapper.__version__ == "1.1.2"
+          PY
+
+      - name: Run offline package test gates
+        shell: bash
+        env:
+          HF_DATASETS_OFFLINE: "1"
+          HF_HUB_OFFLINE: "1"
+          OPENCODE_DISABLE_AUTOUPDATE: "1"
+          PIP_NO_INDEX: "1"
+          TRANSFORMERS_OFFLINE: "1"
+          UV_OFFLINE: "1"
+        run: |
+          python -m pytest -q -o pythonpath= \
+            tests/test_adapters.py \
+            tests/test_cli.py \
+            tests/test_delphi_adapter.py \
+            tests/test_discovery.py \
+            tests/test_ffi.py \
+            tests/test_guideline_formatting.py \
+            tests/test_guidelines.py \
+            tests/test_indexer.py \
+            tests/test_integration_install.py \
+            tests/test_language_matrix.py \
+            tests/test_lsp_server.py \
+            tests/test_lsp_service.py \
+            tests/test_mapper_details.py \
+            tests/test_openrouter_e2e_harness.py \
+            tests/test_package_contract.py \
+            tests/test_protocol.py \
+            tests/test_rendering.py \
+            tests/test_worker.py \
+            tests/test_workspace.py
+
+  sdist-tests:
+    name: Source distribution tests (Ubuntu, Python 3.12)
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+
+    steps:
+      - name: Check out tests
+        uses: actions/checkout@v7
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Download exact distribution artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-distributions
+          path: dist
+
+      - name: Verify artifact checksums and read sdist dependencies
+        shell: bash
+        run: |
+          python - <<'PY'
+          from email.parser import BytesParser
+          import hashlib
+          from pathlib import Path
+          import tarfile
+
+          dist = Path("dist")
+          expected = {}
+          for line in (dist / "SHA256SUMS").read_text(encoding="ascii").splitlines():
+              digest, filename = line.split(maxsplit=1)
+              expected[filename] = digest
+          artifacts = sorted([*dist.glob("*.whl"), *dist.glob("*.tar.gz")])
+          assert len(artifacts) == 2
+          assert set(expected) == {artifact.name for artifact in artifacts}
+          for artifact in artifacts:
+              actual = hashlib.sha256(artifact.read_bytes()).hexdigest()
+              assert actual == expected[artifact.name], artifact.name
+
+          sdists = sorted(dist.glob("*.tar.gz"))
+          assert len(sdists) == 1, f"expected one sdist, found {sdists}"
+          with tarfile.open(sdists[0], "r:gz") as archive:
+              pkg_info = next(
+                  member
+                  for member in archive.getmembers()
+                  if member.isfile() and member.name.count("/") == 1 and member.name.endswith("/PKG-INFO")
+              )
+              stream = archive.extractfile(pkg_info)
+              assert stream is not None
+              metadata = BytesParser().parsebytes(stream.read())
+          requirements = metadata.get_all("Requires-Dist", [])
+          Path("sdist-runtime-requirements.txt").write_text(
+              "\n".join(requirements) + "\n",
+              encoding="utf-8",
+          )
+          PY
+
+      - name: Install sdist dependencies and test tooling
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install "setuptools>=77" wheel
+          python -m pip install -r sdist-runtime-requirements.txt
+          python -m pip install "pytest>=8" "pytest-cov>=5" "tomli>=2; python_version < '3.11'"
+
+      - name: Install the exact source distribution offline
+        env:
+          HF_DATASETS_OFFLINE: "1"
+          HF_HUB_OFFLINE: "1"
+          PIP_NO_INDEX: "1"
+          TRANSFORMERS_OFFLINE: "1"
+          UV_OFFLINE: "1"
+        run: python -m pip install --no-build-isolation --no-cache-dir --no-deps dist/*.tar.gz
+
+      - name: Verify imports use the installed source distribution
+        shell: bash
+        env:
+          HF_DATASETS_OFFLINE: "1"
+          HF_HUB_OFFLINE: "1"
+          PIP_NO_INDEX: "1"
+          TRANSFORMERS_OFFLINE: "1"
+          UV_OFFLINE: "1"
+        run: |
+          python - <<'PY'
+          import hashlib
+          from importlib.metadata import distribution
+          import json
+          from pathlib import Path
+          from urllib.parse import unquote, urlparse
+          import agent_codinglanguage_mapper
+
+          imported = Path(agent_codinglanguage_mapper.__file__).resolve()
+          source = (Path.cwd() / "src").resolve()
+          assert source not in imported.parents, f"source-tree import detected: {imported}"
+          assert agent_codinglanguage_mapper.__version__ == "1.1.2"
+
+          sdists = sorted(Path("dist").glob("*.tar.gz"))
+          assert len(sdists) == 1, f"expected one sdist, found {sdists}"
+          installed = distribution("agent-codinglanguage-mapper")
+          direct_url_text = installed.read_text("direct_url.json")
+          assert direct_url_text is not None, "pip did not record the installed archive"
+          direct_url = json.loads(direct_url_text)
+          installed_archive = Path(unquote(urlparse(direct_url["url"]).path)).name
+          assert installed_archive == sdists[0].name
+          expected_hash = hashlib.sha256(sdists[0].read_bytes()).hexdigest()
+          assert direct_url["archive_info"]["hash"] == f"sha256={expected_hash}"
+          PY
+
+      - name: Run offline source distribution test gates
+        shell: bash
+        env:
+          HF_DATASETS_OFFLINE: "1"
+          HF_HUB_OFFLINE: "1"
+          OPENCODE_DISABLE_AUTOUPDATE: "1"
+          PIP_NO_INDEX: "1"
+          TRANSFORMERS_OFFLINE: "1"
+          UV_OFFLINE: "1"
+        run: |
+          python -m pytest -q -o pythonpath= \
+            tests/test_adapters.py \
+            tests/test_cli.py \
+            tests/test_delphi_adapter.py \
+            tests/test_discovery.py \
+            tests/test_ffi.py \
+            tests/test_guideline_formatting.py \
+            tests/test_guidelines.py \
+            tests/test_indexer.py \
+            tests/test_integration_install.py \
+            tests/test_language_matrix.py \
+            tests/test_lsp_server.py \
+            tests/test_lsp_service.py \
+            tests/test_mapper_details.py \
+            tests/test_openrouter_e2e_harness.py \
+            tests/test_package_contract.py \
+            tests/test_protocol.py \
+            tests/test_rendering.py \
+            tests/test_worker.py \
+            tests/test_workspace.py
+
+  quality:
+    name: Static, audit, and performance gates
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      - name: Check out source
+        uses: actions/checkout@v7
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Download exact distribution artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-distributions
+          path: dist
+
+      - name: Install exact wheel and quality tooling
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install dist/*.whl
+          python -m pip install "mypy==1.19.1" "pytest>=8" "ruff>=0.6" "tomli>=2"
+
+      - name: Run Ruff
+        run: python -m ruff check src tests scripts
+
+      - name: Run strict mypy
+        run: python -m mypy src scripts
+
+      - name: Audit the formal language matrix offline
+        env:
+          HF_DATASETS_OFFLINE: "1"
+          HF_HUB_OFFLINE: "1"
+          PIP_NO_INDEX: "1"
+          TRANSFORMERS_OFFLINE: "1"
+          UV_OFFLINE: "1"
+        run: python scripts/audit_language_matrix.py
+
+      - name: Run source-only harness tests offline
+        env:
+          HF_DATASETS_OFFLINE: "1"
+          HF_HUB_OFFLINE: "1"
+          OPENCODE_DISABLE_AUTOUPDATE: "1"
+          PIP_NO_INDEX: "1"
+          TRANSFORMERS_OFFLINE: "1"
+          UV_OFFLINE: "1"
+        run: |
+          python -m pytest -q -o pythonpath= \
+            tests/test_large_files.py \
+            tests/test_opencode_e2e_harness.py \
+            tests/test_openrouter_e2e_harness.py \
+            tests/test_performance_harness.py
+
+      - name: Enforce large-workspace performance budgets
+        env:
+          HF_DATASETS_OFFLINE: "1"
+          HF_HUB_OFFLINE: "1"
+          PIP_NO_INDEX: "1"
+          TRANSFORMERS_OFFLINE: "1"
+          UV_OFFLINE: "1"
+        run: |
+          python scripts/benchmark_large_workspaces.py \
+            --lines 100000 \
+            --samples 5 \
+            --report-only \
+            --output ci-artifacts/large-workspace-benchmark.json
+
+      - name: Upload benchmark report
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: large-workspace-benchmark
+          path: ci-artifacts/large-workspace-benchmark.json
+          if-no-files-found: warn
+          retention-days: 14

agent_codinglanguage_mapper-1.1.2/MANIFEST.in

@@ -0,0 +1,12 @@
+include .github/workflows/ci.yml
+include scripts/audit_language_matrix.py
+include scripts/benchmark_large_workspaces.py
+include scripts/build_github_performance_corpus.py
+include scripts/evaluate_external_corpora.py
+include scripts/generate_language_matrix.py
+include scripts/run_opencode_e2e.py
+include scripts/run_openrouter_e2e.py
+include tests/corpora.lock.json
+recursive-include tests/e2e *.cpp *.cs *.json *.pas *.py *.rs *.txt .editorconfig CMakeLists.txt
+recursive-include tests/fixtures *.cpp *.cs *.csx *.dpk *.dpr *.hpp *.inc *.pas *.py *.rs
+recursive-include tests/language_matrix *.cpp *.cs *.json *.pas *.py *.rs

{agent_codinglanguage_mapper-1.1.0 → agent_codinglanguage_mapper-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-codinglanguage-mapper
-Version: 1.1.0
+Version: 1.1.2
 Summary: Agent-focused semantic mapping and language services for mixed-language codebases.
 Author: Dark Light
 License-Expression: MPL-2.0
@@ -319,50 +319,49 @@ Example generic client configuration:
 
 ## OpenCode Integration
 
-Install the packaged skill, plugin, and restricted agent configuration into a repository:
+Install the package-named skill, Markdown agent, and plugin into a repository:
 
 ```bash
-codinglanguage-mapper opencode install --target . --write
+codinglanguage-mapper opencode install --target .
 ```
 
 This creates:
 
 ```text
-.agents/skills/mixed-codebase-navigator/SKILL.md
+.agents/skills/agent-codinglanguage-mapper/SKILL.md
+.opencode/agents/agent-codinglanguage-mapper.md
 .opencode/plugins/codebase_map.ts
-opencode.json
 ```
 
-The generated `mixed-codebase-navigator` agent denies all tools by default and permits only `skill`, `codebase_map`, and `code_guidelines`. The plugin maps the active OpenCode directory, serializes Protocol 3 requests through one worker, applies a hard timeout, reports bounded worker `stderr`, restarts after failure, and preserves focus plus warm parser indexes across short idle gaps. It stops the worker when the session is deleted or after 60 seconds without another mapper request.
+The generated `agent-codinglanguage-mapper` agent denies all tools by default and permits only its package-named skill, the legacy `codebase_map` tool, `code_guidelines`, three fixed phase tools (`codebase_map_open`, `codebase_map_focus`, and `codebase_map_inspect_declaration`), and five fixed-language find tools: `codebase_map_find_python`, `codebase_map_find_rust`, `codebase_map_find_csharp`, `codebase_map_find_delphi`, and `codebase_map_find_cpp`. Each fixed-language tool requires `query`, accepts the optional `project_id`, `file_id`, `cursor`, `max_items`, and `max_chars` bounds, and injects its own Protocol 3 `find` action and language. It defaults to at most 5 results and 4,000 characters, while callers can explicitly raise either bound when needed. The fixed open, focus, and declaration-inspect tools likewise inject their Protocol 3 action and inspect detail. These smaller schemas prevent a model from corrupting or omitting required phase fields and keep follow-up model context bounded.
+
+All mapper tools share the same persistent worker. The plugin maps the active OpenCode directory, serializes Protocol 3 requests, applies a hard timeout, reports bounded worker `stderr`, restarts after failure, and preserves focus plus warm parser indexes across short idle gaps. It stops the worker when the session is deleted or after 60 seconds without another mapper request.
+
+The installer never reads or changes `opencode.json`; user configuration remains
+user-owned. The deprecated `--write`, `--write-config`, and `--write-agent`
+compatibility flags are accepted, but the Markdown agent is installed by
+default and those flags do not enable configuration writes.
 
 `code_guidelines` exposes four actions: `detect`, `audit`, `patch`, and `apply`. The first three are read-only. `apply` is rejected unless its request contains `write: true`, so the agent must inspect a patch before it can opt into mutation.
 
-```json
-{
-  "permission": {
-    "*": "deny",
-    "skill": "allow",
-    "codebase_map": "allow",
-    "code_guidelines": "allow"
-  }
-}
-```
+The agent's YAML frontmatter contains its restricted permissions; no matching
+JSON agent block is required.
 
 Run it with:
 
 ```bash
 opencode run \
-  --agent mixed-codebase-navigator \
-  "Find PaymentService, inspect its implementation, and cite the callers. Use only the installed skill and codebase_map."
+  --agent agent-codinglanguage-mapper \
+  "Find the C# PaymentService and cite its declaration. Use the installed skill and the fixed open, C# find, focus, and declaration-inspect tools."
 ```
 
 A typical investigation should:
 
-1. Call `codebase_map` with `action: open`.
-2. Use `find` with the narrowest useful language/project/file filters.
-3. Select a returned `target_id` with `focus`.
-4. Request only the required `inspect` detail.
-5. Use `trace` only for explicit Protocol 3 relations.
+1. Call `codebase_map_open`.
+2. When one language is known, call its `codebase_map_find_<language>` tool with a narrow `query` and optional project/file filters. Use legacy `codebase_map` with `action: find` for mixed-language searches.
+3. Select a returned `target_id` with `codebase_map_focus`.
+4. Call `codebase_map_inspect_declaration` without arguments for the focused declaration. Use legacy `codebase_map` only when another inspect detail is required.
+5. Use legacy `codebase_map` with `trace` only for explicit Protocol 3 relations.
 6. Follow `next_cursor` when evidence is truncated.
 
 A formatting task should first call `code_guidelines` with `detect`, then `audit`, then `patch`. The agent can either improve source-aware findings itself or apply the package plan with `action: apply` and `write: true`. It must finish with another `audit`; it must never use `apply` merely to discover what would change.
@@ -390,7 +389,7 @@ Private Linux CI records and uploads the same measurements with `--report-only`;
 
 ## Offline Ornith/OpenCode Evaluation
 
-The repository contains seven release E2Es: Python, Rust, C#, Delphi, C++, a mixed-language FFI workspace, and a coding-guidelines write workflow. They use the pinned local Ornith revision through vLLM 0.23.0 and OpenCode 1.17.18. The guidelines scenario must detect and audit the profile, inspect a patch, explicitly apply it with `write: true`, and finish with a clean audit. The Python scenario continues the same session through a headless OpenCode server and must inspect the focused symbol in a second turn without another `find` or explicit `target_id`, proving that the plugin preserves its warm worker. It then opens an independent session whose target-less `inspect` must be empty, proving that focus never crosses chat boundaries. The harness fails if a model shard is missing, a download is attempted, an unapproved tool is called, any assistant message uses a different agent, model, or provider, a worker survives server shutdown, or required evidence is absent.
+The repository contains seven release E2Es: Python, Rust, C#, Delphi, C++, a mixed-language FFI workspace, and a coding-guidelines write workflow. They use the pinned local Ornith revision through vLLM 0.23.0 and OpenCode 1.17.18. The guidelines scenario must detect and audit the profile, inspect a patch, explicitly apply it with `write: true`, and finish with a clean audit. The Python scenario continues the same session through a headless OpenCode server and must inspect the focused symbol in a second turn without another `find` or explicit `target_id`, proving that the plugin preserves its warm worker. It then opens an independent session whose target-less `inspect` must be empty, proving that focus never crosses chat boundaries. The harness preflights the exact legacy-plus-fixed tool surface and accepts semantic evidence produced by either a fixed-language find tool or the legacy mapper. It fails if a model shard is missing, a download is attempted, an unapproved tool is called, any assistant message uses a different agent, model, or provider, a worker survives server shutdown, or required evidence is absent.
 
 Inspect the plan without launching a model:
 

{agent_codinglanguage_mapper-1.1.0 → agent_codinglanguage_mapper-1.1.2}/README.md

@@ -272,50 +272,49 @@ Example generic client configuration:
 
 ## OpenCode Integration
 
-Install the packaged skill, plugin, and restricted agent configuration into a repository:
+Install the package-named skill, Markdown agent, and plugin into a repository:
 
 ```bash
-codinglanguage-mapper opencode install --target . --write
+codinglanguage-mapper opencode install --target .
 ```
 
 This creates:
 
 ```text
-.agents/skills/mixed-codebase-navigator/SKILL.md
+.agents/skills/agent-codinglanguage-mapper/SKILL.md
+.opencode/agents/agent-codinglanguage-mapper.md
 .opencode/plugins/codebase_map.ts
-opencode.json
 ```
 
-The generated `mixed-codebase-navigator` agent denies all tools by default and permits only `skill`, `codebase_map`, and `code_guidelines`. The plugin maps the active OpenCode directory, serializes Protocol 3 requests through one worker, applies a hard timeout, reports bounded worker `stderr`, restarts after failure, and preserves focus plus warm parser indexes across short idle gaps. It stops the worker when the session is deleted or after 60 seconds without another mapper request.
+The generated `agent-codinglanguage-mapper` agent denies all tools by default and permits only its package-named skill, the legacy `codebase_map` tool, `code_guidelines`, three fixed phase tools (`codebase_map_open`, `codebase_map_focus`, and `codebase_map_inspect_declaration`), and five fixed-language find tools: `codebase_map_find_python`, `codebase_map_find_rust`, `codebase_map_find_csharp`, `codebase_map_find_delphi`, and `codebase_map_find_cpp`. Each fixed-language tool requires `query`, accepts the optional `project_id`, `file_id`, `cursor`, `max_items`, and `max_chars` bounds, and injects its own Protocol 3 `find` action and language. It defaults to at most 5 results and 4,000 characters, while callers can explicitly raise either bound when needed. The fixed open, focus, and declaration-inspect tools likewise inject their Protocol 3 action and inspect detail. These smaller schemas prevent a model from corrupting or omitting required phase fields and keep follow-up model context bounded.
+
+All mapper tools share the same persistent worker. The plugin maps the active OpenCode directory, serializes Protocol 3 requests, applies a hard timeout, reports bounded worker `stderr`, restarts after failure, and preserves focus plus warm parser indexes across short idle gaps. It stops the worker when the session is deleted or after 60 seconds without another mapper request.
+
+The installer never reads or changes `opencode.json`; user configuration remains
+user-owned. The deprecated `--write`, `--write-config`, and `--write-agent`
+compatibility flags are accepted, but the Markdown agent is installed by
+default and those flags do not enable configuration writes.
 
 `code_guidelines` exposes four actions: `detect`, `audit`, `patch`, and `apply`. The first three are read-only. `apply` is rejected unless its request contains `write: true`, so the agent must inspect a patch before it can opt into mutation.
 
-```json
-{
-  "permission": {
-    "*": "deny",
-    "skill": "allow",
-    "codebase_map": "allow",
-    "code_guidelines": "allow"
-  }
-}
-```
+The agent's YAML frontmatter contains its restricted permissions; no matching
+JSON agent block is required.
 
 Run it with:
 
 ```bash
 opencode run \
-  --agent mixed-codebase-navigator \
-  "Find PaymentService, inspect its implementation, and cite the callers. Use only the installed skill and codebase_map."
+  --agent agent-codinglanguage-mapper \
+  "Find the C# PaymentService and cite its declaration. Use the installed skill and the fixed open, C# find, focus, and declaration-inspect tools."
 ```
 
 A typical investigation should:
 
-1. Call `codebase_map` with `action: open`.
-2. Use `find` with the narrowest useful language/project/file filters.
-3. Select a returned `target_id` with `focus`.
-4. Request only the required `inspect` detail.
-5. Use `trace` only for explicit Protocol 3 relations.
+1. Call `codebase_map_open`.
+2. When one language is known, call its `codebase_map_find_<language>` tool with a narrow `query` and optional project/file filters. Use legacy `codebase_map` with `action: find` for mixed-language searches.
+3. Select a returned `target_id` with `codebase_map_focus`.
+4. Call `codebase_map_inspect_declaration` without arguments for the focused declaration. Use legacy `codebase_map` only when another inspect detail is required.
+5. Use legacy `codebase_map` with `trace` only for explicit Protocol 3 relations.
 6. Follow `next_cursor` when evidence is truncated.
 
 A formatting task should first call `code_guidelines` with `detect`, then `audit`, then `patch`. The agent can either improve source-aware findings itself or apply the package plan with `action: apply` and `write: true`. It must finish with another `audit`; it must never use `apply` merely to discover what would change.
@@ -343,7 +342,7 @@ Private Linux CI records and uploads the same measurements with `--report-only`;
 
 ## Offline Ornith/OpenCode Evaluation
 
-The repository contains seven release E2Es: Python, Rust, C#, Delphi, C++, a mixed-language FFI workspace, and a coding-guidelines write workflow. They use the pinned local Ornith revision through vLLM 0.23.0 and OpenCode 1.17.18. The guidelines scenario must detect and audit the profile, inspect a patch, explicitly apply it with `write: true`, and finish with a clean audit. The Python scenario continues the same session through a headless OpenCode server and must inspect the focused symbol in a second turn without another `find` or explicit `target_id`, proving that the plugin preserves its warm worker. It then opens an independent session whose target-less `inspect` must be empty, proving that focus never crosses chat boundaries. The harness fails if a model shard is missing, a download is attempted, an unapproved tool is called, any assistant message uses a different agent, model, or provider, a worker survives server shutdown, or required evidence is absent.
+The repository contains seven release E2Es: Python, Rust, C#, Delphi, C++, a mixed-language FFI workspace, and a coding-guidelines write workflow. They use the pinned local Ornith revision through vLLM 0.23.0 and OpenCode 1.17.18. The guidelines scenario must detect and audit the profile, inspect a patch, explicitly apply it with `write: true`, and finish with a clean audit. The Python scenario continues the same session through a headless OpenCode server and must inspect the focused symbol in a second turn without another `find` or explicit `target_id`, proving that the plugin preserves its warm worker. It then opens an independent session whose target-less `inspect` must be empty, proving that focus never crosses chat boundaries. The harness preflights the exact legacy-plus-fixed tool surface and accepts semantic evidence produced by either a fixed-language find tool or the legacy mapper. It fails if a model shard is missing, a download is attempted, an unapproved tool is called, any assistant message uses a different agent, model, or provider, a worker survives server shutdown, or required evidence is absent.
 
 Inspect the plan without launching a model:
 

{agent_codinglanguage_mapper-1.1.0 → agent_codinglanguage_mapper-1.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-codinglanguage-mapper"
-version = "1.1.0"
+version = "1.1.2"
 description = "Agent-focused semantic mapping and language services for mixed-language codebases."
 readme = "README.md"
 requires-python = ">=3.10,<3.15"