agent-wiki-cli 2.5.0__tar.gz → 3.0.0__tar.gz

{agent_wiki_cli-2.5.0/src/agent_wiki_cli.egg-info → agent_wiki_cli-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 2.5.0
+Version: 3.0.0
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License-Expression: MIT
@@ -87,6 +87,12 @@ a package upgrade or use `llm-wiki prepare-extractors --src-dir .` separately.
 llm-wiki bootstrap --src-dir . --wiki-dir docs/llm_wiki
 ```
 
+Bootstrap selects current compressed native storage and indexed maintenance
+ownership automatically. Task and compact-view requests can omit version fields;
+the library selects current contracts. Existing projects receive these defaults
+by updating the package and running `llm-wiki upgrade` from their project root.
+Upgrade retains recovery copies and reports their locations.
+
 Open `docs/llm_wiki/index.md` to browse the wiki. Use your coding agent to enrich
 semantic descriptions, guides, and behavior notes; generated diagrams, tables,
 and machine-readable artifacts are maintained by the CLI.
@@ -180,7 +186,7 @@ Use `llm-wiki <command> --help` for available options.
 | [Standalone documentation](docs/standalone-documentation.md) | An isolated documentation workspace, agent handoffs, and export |
 | [Native knowledge](docs/native-knowledge.md) | Evidence, freshness, durable identity, and read APIs |
 | [Native coding workflow](docs/native-agent-workflow.md) | Explicit task evidence, bounded context, sessions, and resumable handoffs |
-| [Knowledge storage](docs/knowledge-storage.md) | Sharded snapshots, explicit migration, bounded reads, and Git size checks |
+| [Knowledge storage](docs/knowledge-storage.md) | Current compressed snapshots, recoverable upgrades, bounded reads, and Git size checks |
 | [Qualified context packets](docs/qualified-context-packets.md) | Validated context handoffs and packet contracts |
 | [Automation](docs/automation.md) | CI integrity, diagnostics, and explicit triggers |
 | [Changelog](CHANGELOG.md) | Release history and compatibility changes |

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/README.md

@@ -50,6 +50,12 @@ a package upgrade or use `llm-wiki prepare-extractors --src-dir .` separately.
 llm-wiki bootstrap --src-dir . --wiki-dir docs/llm_wiki
 ```
 
+Bootstrap selects current compressed native storage and indexed maintenance
+ownership automatically. Task and compact-view requests can omit version fields;
+the library selects current contracts. Existing projects receive these defaults
+by updating the package and running `llm-wiki upgrade` from their project root.
+Upgrade retains recovery copies and reports their locations.
+
 Open `docs/llm_wiki/index.md` to browse the wiki. Use your coding agent to enrich
 semantic descriptions, guides, and behavior notes; generated diagrams, tables,
 and machine-readable artifacts are maintained by the CLI.
@@ -143,7 +149,7 @@ Use `llm-wiki <command> --help` for available options.
 | [Standalone documentation](docs/standalone-documentation.md) | An isolated documentation workspace, agent handoffs, and export |
 | [Native knowledge](docs/native-knowledge.md) | Evidence, freshness, durable identity, and read APIs |
 | [Native coding workflow](docs/native-agent-workflow.md) | Explicit task evidence, bounded context, sessions, and resumable handoffs |
-| [Knowledge storage](docs/knowledge-storage.md) | Sharded snapshots, explicit migration, bounded reads, and Git size checks |
+| [Knowledge storage](docs/knowledge-storage.md) | Current compressed snapshots, recoverable upgrades, bounded reads, and Git size checks |
 | [Qualified context packets](docs/qualified-context-packets.md) | Validated context handoffs and packet contracts |
 | [Automation](docs/automation.md) | CI integrity, diagnostics, and explicit triggers |
 | [Changelog](CHANGELOG.md) | Release history and compatibility changes |

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/docs/automation.md

@@ -54,7 +54,7 @@ fixed, allowlisted set of validation, cache-measurement, and toolchain evidence
 even when validation fails.
 
 When called directly without schema inputs, the full-integrity Action defaults
-to `report-schema: v2` and `comparison-policy: auto`. The generated workflow
+to `report-schema: v4` and `comparison-policy: auto`. The generated workflow
 explicitly selects v4; the CLI's unpinned output instead selects v1 for legacy
 knowledge and v4 for migrated knowledge. For migrated knowledge in a custom
 workflow, set `report-schema: v4` and `comparison-policy: auto` together.
@@ -357,15 +357,15 @@ required fields and documented state values remain strict while additive
 object fields are ignored. A wiki that has not been initialized is reported as
 `absent` and fails either threshold.
 
-Without explicit inputs, the dashboard Action defaults to `report-schema: v1`
-(the `llm-wiki-doctor/v1` contract) and `comparison-policy: auto`.
+Without explicit inputs, the dashboard Action defaults to `report-schema: v4`
+(the `llm-wiki-doctor/v4` contract) and `comparison-policy: auto`.
 For migrated knowledge, use the v4/auto inputs
 shown above, or select `comparison-policy: exact-v1` with an older report schema.
 Select `report-schema: v3` for
 detailed JSON coverage, primary concept reason counts and captured producer
 versions. V3 and v4 reject unknown fields in their closed contracts and use a
-`llm-wiki-doctor-dashboard/v2` receipt bound to the report bytes. The default
-report and receipt retain their v1 contracts. These versions preserve the
+`llm-wiki-doctor-dashboard/v2` receipt bound to the report bytes. Explicit
+`llm-wiki-doctor/v1` reports retain their v1 receipt contract. These versions preserve the
 configured strictness and failure threshold.
 The v3 dashboard and CLI text show the same captured coverage, old/new producer
 versions and remediation guidance. Optional governance and verification absence

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/docs/cli-reference.md

@@ -338,6 +338,15 @@ llm-wiki extract --src-dir /path/to/repo --allow-external-src --summary
 
 The JSON output includes `schema_version: "llm-wiki-extract/v1"` plus
 `inventory` and optional `docker` and `unsupported_sources` objects.
+To inspect one file without rebuilding the wiki, use
+`llm-wiki extract --src-dir . --paths src/dyn.mjs --deep --read-only`.
+The command prints JSON and uses the same prepared helper cache as other source
+reads; it does not install helpers. If a helper is unavailable, follow its
+`prepare-extractors` recovery command and retry with the same cache base.
+Unresolved JavaScript `import()` and computed `require()` calls remain explicit
+gap records in `imports`; they do not establish a resolved dependency or runtime
+completeness. Generated import tables label these gaps with their reason and
+source line.
 Go `_test.go` files are omitted unless `--include-tests go` is supplied; Python
 test files remain part of normal Python extraction.
 JavaScript `.js` and `.jsx` files are handled by the TypeScript extractor
@@ -557,6 +566,16 @@ for the complete policy.
 to stdout containing the normal lint report, diagnostics, and phase timings.
 The JSON contract is preserved for extractor failures as well; lint still exits
 nonzero, but stdout remains machine-readable.
+Structural evidence errors retain their blocking policy. Where the manifest
+captures the information, the existing `message` field names the source path,
+extractor and underlying cause; `reason_code` retains the top-level category
+and `hint` gives the next action. For example, `promised-evidence-unknown`
+can report the underlying `invalid-inventory-shape` cause. The JSON finding
+fields remain unchanged for strict report consumers.
+Inspect the named source with the read-only
+single-file extraction command above, repair the underlying producer or source
+problem, then run owning sync before repeating strict validation. Editing a
+generated wiki table does not repair invalid extractor evidence.
 `lint --profile` and `ci-check --format json` additionally include this shape:
 
 ```json
@@ -845,6 +864,8 @@ Text output shows these next steps directly.
 Use `--request FILE --format packet` to deliver a canonical v1/v2 packet from
 a filter-bearing request file. The file owns semantic options; explicit
 budget, focus, freshness-preference, or knowledge-mode overrides are rejected.
+Packet flags and request files with no protocol use the current v2 contract
+and automatic native-knowledge selection. Explicit v1 requests remain supported.
 The file's inner format remains JSON or Markdown. For v3 requests, the declared
 outer format must agree with any explicit format flag. See
 [qualified context packets](qualified-context-packets.md) for request examples,
@@ -1023,7 +1044,6 @@ For example, with `src/app.py` defining `limit`, save `source-task.json`:
 
 ```json
 {
-  "schema_version": "llm-wiki-task-request/v2",
   "kind": "contract-change",
   "requirements": [
     {"id": "contract", "facet": "source-contract", "selector": "app.py:limit"}
@@ -1034,7 +1054,7 @@ For example, with `src/app.py` defining `limit`, save `source-task.json`:
 
 ```bash
 llm-wiki task-context --request source-task.json --src-dir src --wiki-dir wiki
-llm-wiki task-context --request source-task.json --src-dir src --wiki-dir wiki --view compact-v1 --view-budget-tokens 32000 --canonical-output receipts/source-context.json
+llm-wiki task-context --request source-task.json --src-dir src --wiki-dir wiki --view compact --view-budget-tokens 32000 --canonical-output receipts/source-context.json
 ```
 
 Canonical text is the default. Compact delivery is opt-in and needs a separate
@@ -1043,11 +1063,11 @@ selection, tokenizer and output paths distinct. `--view-budget-tokens` chooses
 its separate presentation budget; no fixed token saving or small-budget fit is
 promised. Include the selected view once in the coding host.
 
-Use `--view compact-v2` for readable JSON containing complete selected facts,
+Use `--view compact` for the current readable JSON containing complete selected facts,
 citations, requirements, coverage, gaps and limitations. It requires the same
 explicit view budget and canonical receipt destination. Python and session
-calls select it with `schema_version: "llm-wiki-task-view-request/v2"` in
-`view_options`. Validation and expansion require the original canonical text,
+calls omit the version field in `view_options`; an omitted view object uses
+the effective host budget. Explicit `compact-v1` and `compact-v2` remain compatibility aliases. Validation and expansion require the original canonical text,
 request and view options. The body is self-contained and may be larger than
 compact-v1's encoded body. Canonical delivery remains the default.
 
@@ -1059,8 +1079,8 @@ framing, setup and any required receipt/metadata follow-ups in addition to the
 view budget; no complete-host token cap is implied by `--view-budget-tokens`.
 
 Choose `knowledge_mode: "off"` only when no native evidence is required; this
-route works without a wiki. Native v2 requirements need explicitly adopted
-sharded or packed knowledge. Keep `required` mode and the native requirements
+route works without a wiki. Native requirements use current bounded storage from bootstrap or project
+upgrade. Keep `required` mode and the native requirements
 when a read fails; a failure never authorizes bootstrap or migration.
 `snapshot` reads committed native evidence, while `selected` captures declared
 source scope. `--allow-full-inventory` permits an explicitly requested broader

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/docs/native-agent-workflow.md

@@ -9,27 +9,22 @@ expanded instructions retain it when skills are disabled or unavailable.
 Package installation ships the reference; `llm-wiki init` establishes the
 project instructions, and `llm-wiki upgrade` refreshes them after a package update.
 
-The native interfaces below are explicit choices within that procedure.
-Initializing a project does not activate a workflow profile, session, storage
-adoption, or Git action. Small mechanical work can use proportionate inspection
-and checks while retaining applicable maintenance obligations.
-
-Use a provider whose CLI and Python API expose the task request, storage and
-optional delivery interfaces you select. Check `llm-wiki task-context --help`
-and `llm-wiki knowledge migrate --help` in each environment; a version number
-alone does not establish support for every format.
-
-For large native snapshots, [knowledge storage](knowledge-storage.md) describes
-explicit sharded or packed storage adoption and task request v2 with selected validation.
-Task request v1 retains its existing full-validation behavior.
-
-Prefer task request v2 for compatible integrations. Canonical delivery stays
-the default; compact views, sessions and source-augmented discovery are explicit
-choices with their own limits and costs.
+The library selects current data and workflow contracts. Normal task and compact
+view requests omit version fields. Bootstrap creates compressed packed knowledge
+and indexed ordinary maintenance ownership; project upgrade brings valid older
+snapshots forward with recovery preimages. Review starts pending and never
+implies human approval. Readers never migrate or repair data.
+
+Canonical delivery stays the default. Compact delivery, session reuse and source
+indexing remain explicit behavior choices with their own bounds and costs. MCP
+session tools are available by default; opening a session is still explicit.
+Workflow profiles, human governance, application execution and Git actions keep
+their existing authorization requirements. Older explicit contracts remain
+available for integrations that require compatibility.
 
 An explicit task request gathers qualified source and wiki evidence. The provider
 reads and reports; your coding host decides what to include, edit, execute and
-publish. Existing context calls retain their defaults.
+publish.
 
 ## Install the workflow in another project
 
@@ -116,9 +111,16 @@ managed instructions from that project's root:
 
 For a source checkout, replace the package update command with
 `.venv/bin/pip install --upgrade "/absolute/path/python-wiki-llm"`. Package
-updates alone do not refresh project instructions. For a custom wiki location,
+updates alone do not refresh project instructions or migrate project data. For a custom wiki location,
 use `.venv/bin/llm-wiki upgrade --wiki-dir .wiki`.
 
+Upgrade selects current storage formats and workflow contracts automatically.
+It preserves authored Markdown and existing governance, retains complete recovery
+preimages and prints their locations. Preserve those copies until the upgraded
+project is accepted. Damaged or unsupported authority requires recovery rather
+than automatic reseeding. Use `--src-dir src` when the source root is `src`, and
+carry the configured helper cache and source selection through setup.
+
 Upgrade retains the configured agent, source-selection preference and skills
 preference unless explicitly overridden. It refreshes the managed instruction
 block, reference topics and missing scaffold structure while preserving user
@@ -171,7 +173,7 @@ candidates and require exact inspection before a coding decision.
 Source text indexing is an explicit read and cost choice:
 
 ```bash
-llm-wiki search "retry failure" --src-dir src --wiki-dir wiki --mode ranked-v2 --include-source
+llm-wiki search "retry failure" --src-dir src --wiki-dir wiki --include-source
 ```
 
 It requires a valid committed manifest and indexes only its mapped module sources
@@ -228,7 +230,6 @@ Save this request as `source-task.json` outside `src`:
 
 ```json
 {
-  "schema_version": "llm-wiki-task-request/v2",
   "kind": "contract-change",
   "requirements": [
     {"id": "contract", "facet": "source-contract", "selector": "app.py:limit"}
@@ -262,47 +263,36 @@ Use your actual source root, configured selection and exact declaration instead
 of the example paths. Reads do not create the source file, install helpers or
 run the target project. One direct source read can be simpler for a tiny task.
 
-## Native task with explicit storage adoption
+<a id="native-task-with-explicit-storage-adoption"></a>
+
+## Native task with current storage
 
 Choose this route when a requirement needs committed concepts, semantic
-sections or typed relationships. For a new wiki, explicitly select bounded
-storage during authorized bootstrap:
+sections or typed relationships. Authorized bootstrap selects current bounded
+storage without a format argument:
 
 ```bash
-llm-wiki bootstrap --src-dir src --wiki-dir wiki --knowledge-format sharded-v2
+llm-wiki bootstrap --src-dir src --wiki-dir wiki
 ```
 
-For an existing flat wiki, keep its current pages and complete snapshot. A task
-v2 native read requires sharded or packed knowledge storage; a flat rejection
-does not authorize migration.
-
-For a captured valid flat model, the task CLI returns exit 2 with
-`error.details.reason: "flat-native-adoption-required"` and an authorized
-migration-preview next action. This identifies the storage prerequisite; it
-does not audit the complete snapshot. Unknown or damaged roots receive no
-adoption hint. Migration validates companion authority before applying.
-
-With migration authorized, preview and apply it using an empty recovery directory
-outside both `src` and `wiki`:
+For an existing project, update the package in every reader/writer environment,
+then run the authorized project upgrade with its actual roots:
 
 ```bash
-llm-wiki knowledge migrate --wiki-dir wiki --to sharded-v2 --dry-run --recovery-dir storage-recovery
-llm-wiki knowledge migrate --wiki-dir wiki --to sharded-v2 --recovery-dir storage-recovery
+llm-wiki upgrade --src-dir src --wiki-dir wiki
 llm-wiki knowledge storage-check --wiki-dir wiki --full
-llm-wiki knowledge inspect-storage --wiki-dir wiki --selector page:modules/app.md --limit 10
 llm-wiki doctor --capabilities --src-dir src --wiki-dir wiki --format json
 ```
 
-Dry-run does not write a recovery snapshot. Apply retains the prior snapshot;
-`storage-check --full` audits the result. Capability output can identify helper
-or producer prerequisites; resolve those only with setup authorization. Upgrade
-all readers and writers to support the selected schema before adoption.
+Upgrade chooses current formats and reports complete recovery locations. An
+explicit compatibility-format migration remains available through
+[knowledge storage](knowledge-storage.md). Missing, damaged or unsupported
+committed authority requires recovery; a failed read never authorizes migration.
 
 Save this native snapshot request as `native-task.json`:
 
 ```json
 {
-  "schema_version": "llm-wiki-task-request/v2",
   "requirements": [
     {"id": "concept", "facet": "concept", "selector": "llm-wiki://modules/app"}
   ],
@@ -332,8 +322,8 @@ refuses unrelated root edits, changed Markdown authority or newer committed
 work. Restore an authorized matching complete snapshot when that eligibility
 check fails; do not force a replacement.
 
-Storage adoption is separate from optional
-[ordinary review tracking](maintenance.md). A
+Current bootstrap and upgrade also establish pending
+[ordinary review tracking](maintenance.md), separate from human governance. A
 `.llm-wiki-maintenance-adoption.json` marker requires its matching maintenance
 owner. Restore missing or corrupt adopted authority through the complete
 [maintenance recovery route](maintenance.md#recover-complete-authority) before
@@ -435,7 +425,7 @@ Save the full canonical receipt outside the source and wiki trees and away
 from the request, profile, tokenizer and selection files:
 
 ```bash
-llm-wiki task-context --request source-task.json --src-dir src --wiki-dir wiki --view compact-v1 --view-budget-tokens 32000 --canonical-output receipts/source-context.json
+llm-wiki task-context --request source-task.json --src-dir src --wiki-dir wiki --view compact --view-budget-tokens 32000 --canonical-output receipts/source-context.json
 ```
 
 The compact view goes to stdout. Add `--output views/source-context.json` for a
@@ -445,7 +435,7 @@ are rejected. A canonical receipt is host custody, not permission to include
 both representations in the model prompt.
 
 ```python
-view_options = {"schema_version": "llm-wiki-task-view-request/v1", "budget_tokens": 32000}
+view_options = {"budget_tokens": 32000}
 view = api.build_compact_task_context(
     request, view_options=view_options, src_dir="src", wiki_dir="wiki"
 )
@@ -471,8 +461,9 @@ with the compact view can cost more than canonical output alone.
 
 ## Counting and MCP delivery
 
-The v3 MCP tool requires `protocol: "llm-wiki-context/v3"` and `changes`, which
-accepts explicit paths, a base/head range, or staged changes. Use
+The budgeted MCP tool uses the current context contract when `protocol` is
+omitted. It requires `changes`, which accepts explicit paths, a base/head range,
+or staged changes. Use
 `{"mode": "paths", "paths": []}` for no supplied changes. Old MCP context tools and
 resource URIs retain their response shapes.
 
@@ -512,7 +503,7 @@ full canonical context. Missing bases fall back to a full result. Wrong and
 out-of-order bases are rejected. Whole-value array replacement preserves deletions
 and changed qualifiers.
 
-MCP sessions require `--enable-sessions`. Handles belong to that server and its
+MCP sessions are available by default; `--disable-sessions` removes their tools. Handles belong to that server and its
 configured workspace. Full responses carry canonical context in text and separate
 session metadata in structured content. Delta text is a delta envelope; embedded
 accounting describes reconstructed context. Session delivery counters describe

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/docs/wiki-guide.md

@@ -13,6 +13,7 @@ and plugin projects with commands and expected output.
 - [Agent support](#agent-support), including [autonomous agents](#for-autonomous-agents)
 - [Installation options](#installation) and [setup details](#quick-start)
 - [Working from source](#working-from-source)
+- [Interpreting validation](#interpreting-validation)
 
 ## What It Creates
 
@@ -465,3 +466,22 @@ compatibility, and release behavior for documentation-surface work. Use
 `llm-wiki release` separately when stamping a real version.
 
 [native-knowledge]: native-knowledge.md
+
+## Interpreting validation
+
+A successful lint result means its blocking checks passed. Advisory diagnostics
+remain separate; success does not establish complete static analysis, correct
+prose or runtime behavior.
+
+Default text shows at most five examples for data-flow and unfamiliar advisory
+categories, with the emitted record count and the number omitted from that text
+preview. Excerpts escape control characters and are limited to 400 characters.
+These counts describe reported diagnostics, not all possible source observations;
+upstream analysis may also be bounded or incomplete.
+
+Read every retained diagnostic through `llm-wiki lint --profile` JSON or the CI
+JSON/Markdown report, using the same source/wiki roots, selection and helper
+options. Their records keep the original severity and content. For a data-flow
+gap, inspect the affected flow and source when the current task depends on the
+missing observation. A warning alone does not prove a source defect or authorize
+an automatic fix.

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/pyproject.toml

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

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0/src/agent_wiki_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 2.5.0
+Version: 3.0.0
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License-Expression: MIT
@@ -87,6 +87,12 @@ a package upgrade or use `llm-wiki prepare-extractors --src-dir .` separately.
 llm-wiki bootstrap --src-dir . --wiki-dir docs/llm_wiki
 ```
 
+Bootstrap selects current compressed native storage and indexed maintenance
+ownership automatically. Task and compact-view requests can omit version fields;
+the library selects current contracts. Existing projects receive these defaults
+by updating the package and running `llm-wiki upgrade` from their project root.
+Upgrade retains recovery copies and reports their locations.
+
 Open `docs/llm_wiki/index.md` to browse the wiki. Use your coding agent to enrich
 semantic descriptions, guides, and behavior notes; generated diagrams, tables,
 and machine-readable artifacts are maintained by the CLI.
@@ -180,7 +186,7 @@ Use `llm-wiki <command> --help` for available options.
 | [Standalone documentation](docs/standalone-documentation.md) | An isolated documentation workspace, agent handoffs, and export |
 | [Native knowledge](docs/native-knowledge.md) | Evidence, freshness, durable identity, and read APIs |
 | [Native coding workflow](docs/native-agent-workflow.md) | Explicit task evidence, bounded context, sessions, and resumable handoffs |
-| [Knowledge storage](docs/knowledge-storage.md) | Sharded snapshots, explicit migration, bounded reads, and Git size checks |
+| [Knowledge storage](docs/knowledge-storage.md) | Current compressed snapshots, recoverable upgrades, bounded reads, and Git size checks |
 | [Qualified context packets](docs/qualified-context-packets.md) | Validated context handoffs and packet contracts |
 | [Automation](docs/automation.md) | CI integrity, diagnostics, and explicit triggers |
 | [Changelog](CHANGELOG.md) | Release history and compatibility changes |

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/src/agent_wiki_cli.egg-info/SOURCES.txt

@@ -136,6 +136,7 @@ src/llm_wiki_cli/services/context_packet.py
 src/llm_wiki_cli/services/context_service.py
 src/llm_wiki_cli/services/context_session.py
 src/llm_wiki_cli/services/contracts.py
+src/llm_wiki_cli/services/current_contracts.py
 src/llm_wiki_cli/services/data_flow.py
 src/llm_wiki_cli/services/dependencies.py
 src/llm_wiki_cli/services/dependency_versions.py
@@ -400,6 +401,7 @@ tests/test_core_shard_runner.py
 tests/test_core_shard_workflow.py
 tests/test_core_shards.py
 tests/test_credential_named_knowledge.py
+tests/test_current_install_defaults.py
 tests/test_data_flow.py
 tests/test_default_development_workflow.py
 tests/test_dep_vuln_triage_skill.py
@@ -553,6 +555,7 @@ tests/test_knowledge_validation_receipt.py
 tests/test_knowledge_validation_receiving.py
 tests/test_knowledge_verification_view.py
 tests/test_lint.py
+tests/test_lint_advisory_text.py
 tests/test_llm_wiki_convergence_script.py
 tests/test_llm_wiki_convergence_workflow.py
 tests/test_lockfile.py
@@ -582,8 +585,10 @@ tests/test_multilanguage_wiki.py
 tests/test_native_helper_path_diagnostics.py
 tests/test_native_inspection.py
 tests/test_native_knowledge_semantics_docs.py
+tests/test_native_published_artifacts.py
 tests/test_native_query_boundaries.py
 tests/test_native_reduction_contracts.py
+tests/test_native_session_diagnostics.py
 tests/test_native_skill_preflight_and_reanchor.py
 tests/test_native_workflow_baseline.py
 tests/test_native_workflow_codex_host.py
@@ -609,6 +614,7 @@ tests/test_progress.py
 tests/test_protected_artifacts.py
 tests/test_protocol_registry.py
 tests/test_provider_conformance.py
+tests/test_provider_state_receipts.py
 tests/test_provisioning_failures.py
 tests/test_public_docs_performance.py
 tests/test_public_docs_vocabulary.py
@@ -631,6 +637,7 @@ tests/test_qualified_context_acceptance.py
 tests/test_qualified_empty_modules.py
 tests/test_quality_workflows.py
 tests/test_readonly_subprocess_stdin.py
+tests/test_real_caller_action_fixture.py
 tests/test_redaction.py
 tests/test_reference_skill_verifier.py
 tests/test_relationships.py
@@ -674,6 +681,7 @@ tests/test_storage_followup_controls.py
 tests/test_storage_locality.py
 tests/test_storage_lock_diagnostics.py
 tests/test_storage_performance.py
+tests/test_storage_retention_diagnostics.py
 tests/test_surface_initialization.py
 tests/test_sync.py
 tests/test_sync_analysis.py

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/src/llm_wiki_cli/api.py

@@ -1080,6 +1080,7 @@ def bootstrap_wiki(
     include_tests: list[str] | None = None,
     trust_source_plugins: bool = False,
     source_selection: str | Path | None = None,
+    knowledge_format: str | None = None,
 ) -> BootstrapResult:
     """Build a first-use deterministic wiki through the typed service boundary.
 
@@ -1106,6 +1107,7 @@ def bootstrap_wiki(
         include_tests=include_tests,
         trust_source_plugins=trust_source_plugins,
         source_selection=source_selection,
+        knowledge_format=knowledge_format,
     )
     try:
         return bootstrap_cmd.execute_bootstrap(request)
@@ -1422,7 +1424,7 @@ def expand_task_storage_receipt(receipt: Mapping[str, Any]) -> dict[str, Any]:
 @_api_boundary
 @ac.comparison_entrypoint
 def build_compact_task_context(
-    request: Mapping[str, Any], *, view_options: Mapping[str, Any],
+    request: Mapping[str, Any], *, view_options: Mapping[str, Any] | None = None,
     src_dir: str = ".", wiki_dir: str = DEFAULT_WIKI_DIR,
     profile: WorkflowProfile | Mapping[str, Any] | None = None,
     policy: WorkflowPolicy | None = None, counter: TokenCounter | None = None,
@@ -1506,7 +1508,7 @@ class ContextSession(_ContextSession):
 
     @_api_boundary
     def read_compact(
-        self, request: Mapping[str, Any], *, view_options: Mapping[str, Any],
+        self, request: Mapping[str, Any], *, view_options: Mapping[str, Any] | None = None,
         if_result_id: str | None = None, if_view_id: str | None = None,
         delta: bool = False, reuse: bool = True,
         cancelled: Callable[[], bool] | None = None,

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/src/llm_wiki_cli/cli.py

@@ -287,7 +287,7 @@ def _add_task_context_command(subparsers):
     parser.add_argument("--allow-external-src", action="store_true")
     parser.add_argument("--allow-full-inventory", action="store_true", help="Permit explicit requests for a full source scan")
     parser.add_argument("--output", help="Write the selected context view to this file")
-    parser.add_argument("--view", choices=["canonical", "compact-v1", "compact-v2"], default="canonical",
+    parser.add_argument("--view", choices=["canonical", "compact", "compact-v1", "compact-v2"], default="canonical",
                         help="Explicit presentation; canonical remains the default")
     parser.add_argument("--view-budget-tokens", type=int,
                         help="Separate compact text budget within the host ceiling")
@@ -1435,7 +1435,7 @@ def _add_search_command(subparsers):
     )
     parser.add_argument("--mode", choices=["ranked", "ranked-v1", "ranked-v2", "substring"], default="ranked")
     parser.add_argument("--include-source", action="store_true",
-                        help="Explicit bounded selected-source indexing with ranked-v2")
+                        help="Explicit bounded selected-source indexing with current ranked mode")
     parser.add_argument("--discovery", choices=["qualified-v1"],
                         help="Group candidates with captured qualifications and exact inspection routes")
     parser.add_argument("--format", choices=["json", "text"], default="json")
@@ -1563,7 +1563,9 @@ def _add_mcp_command(subparsers):
     )
     _add_source_selection_argument(mcp_parser)
     mcp_parser.add_argument("--tokenizer", help="Trusted local tokenizer JSON for exact v3 counting")
-    mcp_parser.add_argument("--enable-sessions", action="store_true", help="Enable bounded in-memory task sessions")
+    sessions = mcp_parser.add_mutually_exclusive_group()
+    sessions.add_argument("--enable-sessions", action="store_true", default=True, help=argparse.SUPPRESS)
+    sessions.add_argument("--disable-sessions", dest="enable_sessions", action="store_false", help="Disable bounded in-memory task sessions")
 
 
 def _add_obsidian_command(subparsers):
@@ -1908,6 +1910,8 @@ def _add_upgrade_command(subparsers):
         default=DEFAULT_WIKI_DIR,
         help="Wiki directory path (default: docs/llm_wiki)",
     )
+    upgrade_parser.add_argument("--src-dir", default=None, help="Source root for native upgrade (default: installed root or .)")
+    _add_helper_cache_argument(upgrade_parser)
     upgrade_parser.add_argument(
         "--agent",
         choices=AGENT_CHOICES,

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/src/llm_wiki_cli/commands/init_cmd.py

@@ -337,6 +337,17 @@ def run(args):
             print("No extractor helpers required for the selected source files.")
 
     print(f"Initializing LLM Wiki with {agent} schema...")
+    from ..services.current_contracts import current_contract_defaults, upgrade_current_knowledge
+    from .upgrade_cmd import _seed_legacy_for_current_defaults
+
+    try:
+        current = upgrade_current_knowledge(".", wiki_dir, helper_cache_dir=helper_cache_dir,
+                                            source_selection=source_selection, _seed_legacy=_seed_legacy_for_current_defaults)
+    except (ValueError, OSError) as exc:
+        print(f"Error upgrading native defaults: {exc}", file=sys.stderr)
+        raise SystemExit(2) from exc
+    if current.get("recovery_dir"):
+        print(f"Native upgrade recovery: {current['recovery_dir']}")
 
     # Warn if the agent has a CLI executable that isn't installed.
     executable = _CLI_AGENTS.get(agent)
@@ -493,6 +504,7 @@ def run(args):
             "rendered_profile": decision.profile.value,
             "render_profile_version": decision.version,
             "render_reason": decision.reason.value,
+            "contract_defaults": current_contract_defaults(),
         }
     )
     if source_selection is not None:

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/src/llm_wiki_cli/commands/mcp_cmd.py

@@ -67,7 +67,7 @@ def run(args) -> None:
         allowed_origins=tuple(getattr(args, "allowed_origin", None) or ()),
         source_selection=getattr(args, "source_selection", None),
         tokenizer=getattr(args, "tokenizer", None),
-        enable_sessions=getattr(args, "enable_sessions", False),
+        enable_sessions=getattr(args, "enable_sessions", True),
     )
     try:
         runner(config)

{agent_wiki_cli-2.5.0 → agent_wiki_cli-3.0.0}/src/llm_wiki_cli/commands/task_cmd.py

@@ -95,7 +95,7 @@ def run(args):
 
     try:
         view = getattr(args, "view", "canonical")
-        compact = view in ("compact-v1", "compact-v2")
+        compact = view in ("compact", "compact-v1", "compact-v2")
         outputs = _compact_outputs(args) if compact else None
         if not compact and (
             getattr(args, "view_budget_tokens", None) is not None
@@ -112,7 +112,7 @@ def run(args):
             "helper_cache_dir": args.helper_cache_dir}
         result = (
             api.build_compact_task_context(request,
-                view_options={"schema_version": "llm-wiki-task-view-request/v2" if view == "compact-v2" else "llm-wiki-task-view-request/v1",
+                view_options={"schema_version": "llm-wiki-task-view-request/v2" if view in ("compact", "compact-v2") else "llm-wiki-task-view-request/v1",
                               "budget_tokens": args.view_budget_tokens}, **options)
             if compact else api.build_task_context(request, **options)
         )