agent-wiki-cli 0.3.41__tar.gz → 0.5.1__tar.gz

{agent_wiki_cli-0.3.41/src/agent_wiki_cli.egg-info → agent_wiki_cli-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 0.3.41
+Version: 0.5.1
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License: MIT
@@ -58,15 +58,16 @@ external tools when they are available on `PATH`.
 | Area | Implementation | Runtime requirement |
 |---|---|---|
 | Python | stdlib `ast` | Python 3.9+ |
-| TypeScript / TSX | bundled Node script using `ts-morph` | Node.js and npm |
-| Go | bundled Go extractor using `go/ast` | Go toolchain |
-| Rust | bundled Rust extractor using `syn` | Cargo / Rust toolchain |
+| TypeScript / TSX | bundled Node script using `ts-morph` | prepared Node.js dependencies |
+| Go | bundled Go extractor using `go/ast` | prepared helper binary |
+| Rust | bundled Rust extractor using `syn` | prepared helper binary |
 | Docker / Compose | built-in parsers | none |
 | MCP server | official Python MCP SDK | `agent-wiki-cli[mcp]`, Python 3.10+ |
 
-TypeScript, Go, and Rust extras are metadata-only; the actual toolchains must be
-installed separately. The TypeScript extractor runs `npm install` in its bundled
-extractor directory on first use if `node_modules` is missing.
+TypeScript, Go, and Rust extras are metadata-only; prepare their helper
+dependencies explicitly with `llm-wiki prepare-extractors`. Lint, CI, and
+extract never run `npm install`, `go build`, `go run`, `cargo build`, or
+`cargo run` automatically.
 
 ## Agent Support
 
@@ -232,16 +233,29 @@ manifest.
 
 ```bash
 llm-wiki sync --src-dir . --wiki-dir docs/llm_wiki
+llm-wiki sync --jobs auto --cache-stats --src-dir . --wiki-dir docs/llm_wiki
 ```
 
 If an older wiki has `index.md` but no manifest, `sync` seeds
 `.llm-wiki-manifest.json` without modifying pages. If neither a manifest nor an
-existing wiki is present, run `bootstrap` first.
+existing wiki is present, run `bootstrap` first. Sync uses the same safe
+persistent inventory cache as lint when a git directory is available. Use
+`--no-cache`, `--rebuild-cache`, `--cache-dir PATH`, and `--cache-stats` to
+control or inspect cache behavior. Use `--jobs N` or `--jobs auto` to opt into
+parallel built-in language extraction. Sync repairs manifests with invalid
+source hashes without touching pages, and stops unusually broad diffs unless
+`--force` is used.
+
+`sync` is deterministic: it updates AST/docstring-based page skeletons and does
+not call an LLM. In agent workflows, treat sync as the first step, then inspect
+created or updated pages and replace generic `_Auto-generated from ..._`,
+copied-docstring-only, or knowable `—` placeholders with project-specific
+semantic explanations.
 
 ### `extract`
 
 Print source inventory as JSON. All registered extractors run; missing optional
-toolchains are skipped when there are no matching source files.
+prepared helpers are skipped when there are no matching source files.
 
 ```bash
 llm-wiki extract --src-dir .
@@ -253,6 +267,23 @@ llm-wiki extract --src-dir . --package llm_wiki_cli
 llm-wiki extract --src-dir . --include-empty
 ```
 
+### `prepare-extractors`
+
+Prepare TypeScript dependencies and cached Go/Rust helper binaries outside the
+lint/extract hot path.
+
+```bash
+llm-wiki prepare-extractors --src-dir .
+llm-wiki prepare-extractors --language typescript --language go
+llm-wiki prepare-extractors --cache-dir .cache/llm-wiki
+```
+
+When `--language` is omitted, only helper languages detected in `--src-dir` are
+prepared. Helper cache resolution follows `--cache-dir`, then
+`LLM_WIKI_CACHE_DIR`, then `.git/llm-wiki-extractors/`. If Go is installed in a
+nonstandard location or the `go` on `PATH` cannot run, set
+`LLM_WIKI_GO=/path/to/go` before running `prepare-extractors`.
+
 ### `lint` and `ci-check`
 
 Validate wiki links, orphan pages, entities, modules, workflows,
@@ -261,20 +292,40 @@ infrastructure, plugin lint rules, and team policy.
 ```bash
 llm-wiki lint --wiki-dir docs/llm_wiki --src-dir .
 llm-wiki lint --strict --wiki-dir docs/llm_wiki --src-dir .
+llm-wiki lint --profile --wiki-dir docs/llm_wiki --src-dir .
+llm-wiki lint --cache-stats --wiki-dir docs/llm_wiki --src-dir .
+llm-wiki lint --jobs auto --wiki-dir docs/llm_wiki --src-dir .
 ```
 
 Strict mode also requires the core wiki structure and a fresh sync manifest.
+`--profile` suppresses the human-readable lint text and prints one JSON object
+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.
+Lint uses a persistent deep-inventory cache by default when a git directory is
+available, storing `.git/llm-wiki-inventory-cache.json`. Override the cache
+directory with `LLM_WIKI_CACHE_DIR` or `--cache-dir PATH`; the CLI flag wins.
+Use `--no-cache` to disable load/save, `--rebuild-cache` to ignore and rewrite
+the cache, and `--cache-stats` to include cache diagnostics. Cache corruption or
+invalid fingerprints fall back to a full extraction without reducing lint
+coverage. With `--profile --cache-stats`, the JSON payload includes a top-level
+`cache` object. Use `--jobs N` or `--jobs auto` to opt into parallel built-in
+language extraction; the default is `--jobs 1`. Plugin extractors remain
+sequential unless future plugin metadata explicitly marks them parallel-safe.
 
 For CI:
 
 ```bash
 llm-wiki ci-check --src-dir . --wiki-dir docs/llm_wiki
+llm-wiki ci-check --jobs auto --src-dir . --wiki-dir docs/llm_wiki
 llm-wiki ci-check --format json --report .git/llm-wiki-ci-report.md
 llm-wiki ci-check --format markdown
 ```
 
 `ci-check` always runs strict validation, writes a Markdown report, records a
-local metrics event, and exits nonzero on validation failure.
+local metrics event, uses the same safe inventory cache when available, and
+exits nonzero on validation failure. `--report` is an output path, so explicit
+absolute paths and relative artifact paths outside the project root are allowed.
 
 ### `context`
 
@@ -323,7 +374,9 @@ llm-wiki generate-prompt --template compact
 ```
 
 The generated prompt includes change-type guidance. Installed prompt templates
-can override the default prompt body.
+can override the default prompt body. The default prompt asks agents to run
+`sync` first, then perform a semantic pass on affected pages before accepting a
+lint-clean wiki as complete.
 
 ### `mcp`
 

{agent_wiki_cli-0.3.41 → agent_wiki_cli-0.5.1}/README.md

@@ -28,15 +28,16 @@ external tools when they are available on `PATH`.
 | Area | Implementation | Runtime requirement |
 |---|---|---|
 | Python | stdlib `ast` | Python 3.9+ |
-| TypeScript / TSX | bundled Node script using `ts-morph` | Node.js and npm |
-| Go | bundled Go extractor using `go/ast` | Go toolchain |
-| Rust | bundled Rust extractor using `syn` | Cargo / Rust toolchain |
+| TypeScript / TSX | bundled Node script using `ts-morph` | prepared Node.js dependencies |
+| Go | bundled Go extractor using `go/ast` | prepared helper binary |
+| Rust | bundled Rust extractor using `syn` | prepared helper binary |
 | Docker / Compose | built-in parsers | none |
 | MCP server | official Python MCP SDK | `agent-wiki-cli[mcp]`, Python 3.10+ |
 
-TypeScript, Go, and Rust extras are metadata-only; the actual toolchains must be
-installed separately. The TypeScript extractor runs `npm install` in its bundled
-extractor directory on first use if `node_modules` is missing.
+TypeScript, Go, and Rust extras are metadata-only; prepare their helper
+dependencies explicitly with `llm-wiki prepare-extractors`. Lint, CI, and
+extract never run `npm install`, `go build`, `go run`, `cargo build`, or
+`cargo run` automatically.
 
 ## Agent Support
 
@@ -202,16 +203,29 @@ manifest.
 
 ```bash
 llm-wiki sync --src-dir . --wiki-dir docs/llm_wiki
+llm-wiki sync --jobs auto --cache-stats --src-dir . --wiki-dir docs/llm_wiki
 ```
 
 If an older wiki has `index.md` but no manifest, `sync` seeds
 `.llm-wiki-manifest.json` without modifying pages. If neither a manifest nor an
-existing wiki is present, run `bootstrap` first.
+existing wiki is present, run `bootstrap` first. Sync uses the same safe
+persistent inventory cache as lint when a git directory is available. Use
+`--no-cache`, `--rebuild-cache`, `--cache-dir PATH`, and `--cache-stats` to
+control or inspect cache behavior. Use `--jobs N` or `--jobs auto` to opt into
+parallel built-in language extraction. Sync repairs manifests with invalid
+source hashes without touching pages, and stops unusually broad diffs unless
+`--force` is used.
+
+`sync` is deterministic: it updates AST/docstring-based page skeletons and does
+not call an LLM. In agent workflows, treat sync as the first step, then inspect
+created or updated pages and replace generic `_Auto-generated from ..._`,
+copied-docstring-only, or knowable `—` placeholders with project-specific
+semantic explanations.
 
 ### `extract`
 
 Print source inventory as JSON. All registered extractors run; missing optional
-toolchains are skipped when there are no matching source files.
+prepared helpers are skipped when there are no matching source files.
 
 ```bash
 llm-wiki extract --src-dir .
@@ -223,6 +237,23 @@ llm-wiki extract --src-dir . --package llm_wiki_cli
 llm-wiki extract --src-dir . --include-empty
 ```
 
+### `prepare-extractors`
+
+Prepare TypeScript dependencies and cached Go/Rust helper binaries outside the
+lint/extract hot path.
+
+```bash
+llm-wiki prepare-extractors --src-dir .
+llm-wiki prepare-extractors --language typescript --language go
+llm-wiki prepare-extractors --cache-dir .cache/llm-wiki
+```
+
+When `--language` is omitted, only helper languages detected in `--src-dir` are
+prepared. Helper cache resolution follows `--cache-dir`, then
+`LLM_WIKI_CACHE_DIR`, then `.git/llm-wiki-extractors/`. If Go is installed in a
+nonstandard location or the `go` on `PATH` cannot run, set
+`LLM_WIKI_GO=/path/to/go` before running `prepare-extractors`.
+
 ### `lint` and `ci-check`
 
 Validate wiki links, orphan pages, entities, modules, workflows,
@@ -231,20 +262,40 @@ infrastructure, plugin lint rules, and team policy.
 ```bash
 llm-wiki lint --wiki-dir docs/llm_wiki --src-dir .
 llm-wiki lint --strict --wiki-dir docs/llm_wiki --src-dir .
+llm-wiki lint --profile --wiki-dir docs/llm_wiki --src-dir .
+llm-wiki lint --cache-stats --wiki-dir docs/llm_wiki --src-dir .
+llm-wiki lint --jobs auto --wiki-dir docs/llm_wiki --src-dir .
 ```
 
 Strict mode also requires the core wiki structure and a fresh sync manifest.
+`--profile` suppresses the human-readable lint text and prints one JSON object
+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.
+Lint uses a persistent deep-inventory cache by default when a git directory is
+available, storing `.git/llm-wiki-inventory-cache.json`. Override the cache
+directory with `LLM_WIKI_CACHE_DIR` or `--cache-dir PATH`; the CLI flag wins.
+Use `--no-cache` to disable load/save, `--rebuild-cache` to ignore and rewrite
+the cache, and `--cache-stats` to include cache diagnostics. Cache corruption or
+invalid fingerprints fall back to a full extraction without reducing lint
+coverage. With `--profile --cache-stats`, the JSON payload includes a top-level
+`cache` object. Use `--jobs N` or `--jobs auto` to opt into parallel built-in
+language extraction; the default is `--jobs 1`. Plugin extractors remain
+sequential unless future plugin metadata explicitly marks them parallel-safe.
 
 For CI:
 
 ```bash
 llm-wiki ci-check --src-dir . --wiki-dir docs/llm_wiki
+llm-wiki ci-check --jobs auto --src-dir . --wiki-dir docs/llm_wiki
 llm-wiki ci-check --format json --report .git/llm-wiki-ci-report.md
 llm-wiki ci-check --format markdown
 ```
 
 `ci-check` always runs strict validation, writes a Markdown report, records a
-local metrics event, and exits nonzero on validation failure.
+local metrics event, uses the same safe inventory cache when available, and
+exits nonzero on validation failure. `--report` is an output path, so explicit
+absolute paths and relative artifact paths outside the project root are allowed.
 
 ### `context`
 
@@ -293,7 +344,9 @@ llm-wiki generate-prompt --template compact
 ```
 
 The generated prompt includes change-type guidance. Installed prompt templates
-can override the default prompt body.
+can override the default prompt body. The default prompt asks agents to run
+`sync` first, then perform a semantic pass on affected pages before accepting a
+lint-clean wiki as complete.
 
 ### `mcp`
 

{agent_wiki_cli-0.3.41 → agent_wiki_cli-0.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-wiki-cli"
-version = "0.3.41"
+version = "0.5.1"
 description = "CLI tool to maintain hybrid LLM Wikis for multi-language projects."
 readme = "README.md"
 license = {text = "MIT"}

{agent_wiki_cli-0.3.41 → agent_wiki_cli-0.5.1/src/agent_wiki_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-wiki-cli
-Version: 0.3.41
+Version: 0.5.1
 Summary: CLI tool to maintain hybrid LLM Wikis for multi-language projects.
 Author-email: Denis Sivagin <denissvgn@gmail.com>
 License: MIT
@@ -58,15 +58,16 @@ external tools when they are available on `PATH`.
 | Area | Implementation | Runtime requirement |
 |---|---|---|
 | Python | stdlib `ast` | Python 3.9+ |
-| TypeScript / TSX | bundled Node script using `ts-morph` | Node.js and npm |
-| Go | bundled Go extractor using `go/ast` | Go toolchain |
-| Rust | bundled Rust extractor using `syn` | Cargo / Rust toolchain |
+| TypeScript / TSX | bundled Node script using `ts-morph` | prepared Node.js dependencies |
+| Go | bundled Go extractor using `go/ast` | prepared helper binary |
+| Rust | bundled Rust extractor using `syn` | prepared helper binary |
 | Docker / Compose | built-in parsers | none |
 | MCP server | official Python MCP SDK | `agent-wiki-cli[mcp]`, Python 3.10+ |
 
-TypeScript, Go, and Rust extras are metadata-only; the actual toolchains must be
-installed separately. The TypeScript extractor runs `npm install` in its bundled
-extractor directory on first use if `node_modules` is missing.
+TypeScript, Go, and Rust extras are metadata-only; prepare their helper
+dependencies explicitly with `llm-wiki prepare-extractors`. Lint, CI, and
+extract never run `npm install`, `go build`, `go run`, `cargo build`, or
+`cargo run` automatically.
 
 ## Agent Support
 
@@ -232,16 +233,29 @@ manifest.
 
 ```bash
 llm-wiki sync --src-dir . --wiki-dir docs/llm_wiki
+llm-wiki sync --jobs auto --cache-stats --src-dir . --wiki-dir docs/llm_wiki
 ```
 
 If an older wiki has `index.md` but no manifest, `sync` seeds
 `.llm-wiki-manifest.json` without modifying pages. If neither a manifest nor an
-existing wiki is present, run `bootstrap` first.
+existing wiki is present, run `bootstrap` first. Sync uses the same safe
+persistent inventory cache as lint when a git directory is available. Use
+`--no-cache`, `--rebuild-cache`, `--cache-dir PATH`, and `--cache-stats` to
+control or inspect cache behavior. Use `--jobs N` or `--jobs auto` to opt into
+parallel built-in language extraction. Sync repairs manifests with invalid
+source hashes without touching pages, and stops unusually broad diffs unless
+`--force` is used.
+
+`sync` is deterministic: it updates AST/docstring-based page skeletons and does
+not call an LLM. In agent workflows, treat sync as the first step, then inspect
+created or updated pages and replace generic `_Auto-generated from ..._`,
+copied-docstring-only, or knowable `—` placeholders with project-specific
+semantic explanations.
 
 ### `extract`
 
 Print source inventory as JSON. All registered extractors run; missing optional
-toolchains are skipped when there are no matching source files.
+prepared helpers are skipped when there are no matching source files.
 
 ```bash
 llm-wiki extract --src-dir .
@@ -253,6 +267,23 @@ llm-wiki extract --src-dir . --package llm_wiki_cli
 llm-wiki extract --src-dir . --include-empty
 ```
 
+### `prepare-extractors`
+
+Prepare TypeScript dependencies and cached Go/Rust helper binaries outside the
+lint/extract hot path.
+
+```bash
+llm-wiki prepare-extractors --src-dir .
+llm-wiki prepare-extractors --language typescript --language go
+llm-wiki prepare-extractors --cache-dir .cache/llm-wiki
+```
+
+When `--language` is omitted, only helper languages detected in `--src-dir` are
+prepared. Helper cache resolution follows `--cache-dir`, then
+`LLM_WIKI_CACHE_DIR`, then `.git/llm-wiki-extractors/`. If Go is installed in a
+nonstandard location or the `go` on `PATH` cannot run, set
+`LLM_WIKI_GO=/path/to/go` before running `prepare-extractors`.
+
 ### `lint` and `ci-check`
 
 Validate wiki links, orphan pages, entities, modules, workflows,
@@ -261,20 +292,40 @@ infrastructure, plugin lint rules, and team policy.
 ```bash
 llm-wiki lint --wiki-dir docs/llm_wiki --src-dir .
 llm-wiki lint --strict --wiki-dir docs/llm_wiki --src-dir .
+llm-wiki lint --profile --wiki-dir docs/llm_wiki --src-dir .
+llm-wiki lint --cache-stats --wiki-dir docs/llm_wiki --src-dir .
+llm-wiki lint --jobs auto --wiki-dir docs/llm_wiki --src-dir .
 ```
 
 Strict mode also requires the core wiki structure and a fresh sync manifest.
+`--profile` suppresses the human-readable lint text and prints one JSON object
+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.
+Lint uses a persistent deep-inventory cache by default when a git directory is
+available, storing `.git/llm-wiki-inventory-cache.json`. Override the cache
+directory with `LLM_WIKI_CACHE_DIR` or `--cache-dir PATH`; the CLI flag wins.
+Use `--no-cache` to disable load/save, `--rebuild-cache` to ignore and rewrite
+the cache, and `--cache-stats` to include cache diagnostics. Cache corruption or
+invalid fingerprints fall back to a full extraction without reducing lint
+coverage. With `--profile --cache-stats`, the JSON payload includes a top-level
+`cache` object. Use `--jobs N` or `--jobs auto` to opt into parallel built-in
+language extraction; the default is `--jobs 1`. Plugin extractors remain
+sequential unless future plugin metadata explicitly marks them parallel-safe.
 
 For CI:
 
 ```bash
 llm-wiki ci-check --src-dir . --wiki-dir docs/llm_wiki
+llm-wiki ci-check --jobs auto --src-dir . --wiki-dir docs/llm_wiki
 llm-wiki ci-check --format json --report .git/llm-wiki-ci-report.md
 llm-wiki ci-check --format markdown
 ```
 
 `ci-check` always runs strict validation, writes a Markdown report, records a
-local metrics event, and exits nonzero on validation failure.
+local metrics event, uses the same safe inventory cache when available, and
+exits nonzero on validation failure. `--report` is an output path, so explicit
+absolute paths and relative artifact paths outside the project root are allowed.
 
 ### `context`
 
@@ -323,7 +374,9 @@ llm-wiki generate-prompt --template compact
 ```
 
 The generated prompt includes change-type guidance. Installed prompt templates
-can override the default prompt body.
+can override the default prompt body. The default prompt asks agents to run
+`sync` first, then perform a semantic pass on affected pages before accepting a
+lint-clean wiki as complete.
 
 ### `mcp`
 

{agent_wiki_cli-0.3.41 → agent_wiki_cli-0.5.1}/src/agent_wiki_cli.egg-info/SOURCES.txt

@@ -26,6 +26,7 @@ src/llm_wiki_cli/commands/metrics_cmd.py
 src/llm_wiki_cli/commands/migrate_cmd.py
 src/llm_wiki_cli/commands/obsidian_cmd.py
 src/llm_wiki_cli/commands/plugins_cmd.py
+src/llm_wiki_cli/commands/prepare_extractors_cmd.py
 src/llm_wiki_cli/commands/release_cmd.py
 src/llm_wiki_cli/commands/review_cmd.py
 src/llm_wiki_cli/commands/status_cmd.py
@@ -49,7 +50,9 @@ src/llm_wiki_cli/extractors/ts_scripts/extract.js
 src/llm_wiki_cli/extractors/ts_scripts/package.json
 src/llm_wiki_cli/services/__init__.py
 src/llm_wiki_cli/services/circuit_breaker.py
+src/llm_wiki_cli/services/extractor_helpers.py
 src/llm_wiki_cli/services/imports.py
+src/llm_wiki_cli/services/inventory_cache.py
 src/llm_wiki_cli/services/io.py
 src/llm_wiki_cli/services/lockfile.py
 src/llm_wiki_cli/services/mcp_server.py
@@ -60,10 +63,12 @@ src/llm_wiki_cli/services/paths.py
 src/llm_wiki_cli/services/plugins.py
 src/llm_wiki_cli/services/schema.py
 src/llm_wiki_cli/services/secure_file.py
+src/llm_wiki_cli/services/source_snapshot.py
 src/llm_wiki_cli/services/team.py
 src/llm_wiki_cli/services/versioning.py
 tests/test_bootstrap.py
 tests/test_bump.py
+tests/test_ci_check.py
 tests/test_circuit_breaker.py
 tests/test_config.py
 tests/test_context.py
@@ -72,10 +77,13 @@ tests/test_docker_extract.py
 tests/test_docker_lint.py
 tests/test_e2e.py
 tests/test_extract.py
+tests/test_extractor_helpers.py
 tests/test_generate_prompt.py
 tests/test_go_extract.py
 tests/test_hook.py
+tests/test_imports.py
 tests/test_init.py
+tests/test_inventory_cache.py
 tests/test_io.py
 tests/test_lint.py
 tests/test_lockfile.py
@@ -89,6 +97,7 @@ tests/test_plugins.py
 tests/test_release.py
 tests/test_rust_extract.py
 tests/test_schema.py
+tests/test_source_snapshot.py
 tests/test_status.py
 tests/test_sync.py
 tests/test_team.py

{agent_wiki_cli-0.3.41 → agent_wiki_cli-0.5.1}/src/llm_wiki_cli/cli.py

@@ -17,6 +17,7 @@ from .commands import (
     migrate_cmd,
     obsidian_cmd,
     plugins_cmd,
+    prepare_extractors_cmd,
     release_cmd,
     review_cmd,
     status_cmd,
@@ -37,6 +38,18 @@ def _positive_int(value: str) -> int:
     return parsed
 
 
+def _jobs_value(value: str) -> int:
+    if value == "auto":
+        return max(1, os.cpu_count() or 1)
+    try:
+        parsed = int(value)
+    except ValueError as exc:
+        raise argparse.ArgumentTypeError("must be a positive integer or 'auto'") from exc
+    if parsed < 1:
+        raise argparse.ArgumentTypeError("must be greater than zero")
+    return parsed
+
+
 def main():
     parser = argparse.ArgumentParser(description="LLM Wiki CLI")
     parser.add_argument("--version", action="version", version=f"llm-wiki {__version__}")
@@ -72,6 +85,33 @@ def main():
     lint_parser.add_argument("--src-dir", default=".", help="Source directory to cross-reference against")
     lint_parser.add_argument("--strict", action="store_true",
                              help="Require core wiki structure and a fresh sync manifest")
+    lint_parser.add_argument("--profile", action="store_true",
+                             help="Print combined lint report and phase timings as JSON")
+    lint_parser.add_argument("--no-cache", action="store_true",
+                             help="Disable persistent inventory cache for this run")
+    lint_parser.add_argument("--rebuild-cache", action="store_true",
+                             help="Ignore existing inventory cache and rewrite it after extraction")
+    lint_parser.add_argument("--cache-stats", action="store_true",
+                             help="Include inventory cache diagnostics in lint output")
+    lint_parser.add_argument("--cache-dir", default=None, metavar="PATH",
+                             help="Directory for llm-wiki-inventory-cache.json")
+    lint_parser.add_argument("--jobs", type=_jobs_value, default=1, metavar="JOBS",
+                             help="Parallel built-in extractor jobs: positive integer or 'auto' (default: 1)")
+
+    # prepare-extractors command
+    prepare_parser = subparsers.add_parser(
+        "prepare-extractors",
+        help="Prepare TypeScript, Go, and Rust extractor helpers",
+    )
+    prepare_parser.add_argument("--src-dir", default=".", help="Source directory to inspect")
+    prepare_parser.add_argument("--cache-dir", default=None, metavar="PATH",
+                                help="Directory for extractor helper cache")
+    prepare_parser.add_argument(
+        "--language",
+        action="append",
+        choices=["typescript", "go", "rust"],
+        help="Helper language to prepare; may be repeated",
+    )
 
     # ci-check command
     ci_parser = subparsers.add_parser("ci-check", help="Run strict wiki validation and write a CI report")
@@ -82,6 +122,8 @@ def main():
                            help="Console output format (default: text)")
     ci_parser.add_argument("--report", default=".git/llm-wiki-ci-report.md",
                            help="Markdown report path (default: .git/llm-wiki-ci-report.md)")
+    ci_parser.add_argument("--jobs", type=_jobs_value, default=1, metavar="JOBS",
+                           help="Parallel built-in extractor jobs: positive integer or 'auto' (default: 1)")
 
     # hook command
     hook_parser = subparsers.add_parser("install-hook", help="Install git hooks for wiki sync")
@@ -306,6 +348,18 @@ def main():
     sync_parser.add_argument("--src-dir", default=".", help="Source directory to scan (default: .)")
     sync_parser.add_argument("--wiki-dir", default=DEFAULT_WIKI_DIR,
                              help="Wiki directory (default: docs/llm_wiki)")
+    sync_parser.add_argument("--no-cache", action="store_true",
+                             help="Disable persistent inventory cache for this run")
+    sync_parser.add_argument("--rebuild-cache", action="store_true",
+                             help="Ignore existing inventory cache and rewrite it after extraction")
+    sync_parser.add_argument("--cache-stats", action="store_true",
+                             help="Include inventory cache diagnostics in sync output")
+    sync_parser.add_argument("--cache-dir", default=None, metavar="PATH",
+                             help="Directory for llm-wiki-inventory-cache.json")
+    sync_parser.add_argument("--jobs", type=_jobs_value, default=1, metavar="JOBS",
+                             help="Parallel built-in extractor jobs: positive integer or 'auto' (default: 1)")
+    sync_parser.add_argument("--force", action="store_true",
+                             help="Allow sync to apply unusually broad source diffs")
 
     # migrate command
     migrate_parser = subparsers.add_parser(
@@ -349,6 +403,8 @@ def main():
             extract_cmd.run(args)
         elif args.command == "lint":
             lint_cmd.run(args)
+        elif args.command == "prepare-extractors":
+            prepare_extractors_cmd.run(args)
         elif args.command == "ci-check":
             ci_check_cmd.run(args)
         elif args.command == "install-hook":