cli

Command-line interface for wiki_toolkit.

Commands parse arguments and delegate to wiki_toolkit’s domain modules; no business logic lives here.

FUNCTION	DESCRIPTION
`batch_plan_cmd`	Split the files under SOURCE_DIR into batches for parallel wiki-ingest dispatch.
`build`	Regenerate docs/catalog.jsonl from the current docs/wiki/ notes.
`cli`	AI skills and helper tools that implement and maintain an LLM Wiki.
`commit_pages_cmd`	Commit PAGES onto the currently checked-out branch (a batch coordinator’s per-source streaming commit).
`config`	Inspect wiki_toolkit’s resolved configuration.
`config_show`	Print the resolved docs_dir and which source (flag/env/pyproject/default) it came from.
`cross_link_candidates_cmd`	Find literal title/alias mentions of other catalog pages inside PAGE_PATHS’ bodies (JSONL output).
`doctor`	Non-mutating health check of the wiki’s docs/ structure and git clone.
`init`	Scaffold a docs/ tree: sources/, wiki/, catalog.jsonl, log.jsonl, source-manifest.jsonl, schema.md.
`lint`	Validate wiki note frontmatter, allowed tags, source links, and source_count.
`log`	Append a structured entry to docs/log.jsonl.
`propose_pr_cmd`	Stage a wiki change as a local git branch + commit. Never pushes or opens a real PR.
`search_catalog_cmd`	Search docs/catalog.jsonl for entries matching –query.
`source_coverage_cmd`	Show which docs/sources/ files are covered by at least one wiki note.
`source_dedupe`	Suggest which docs/sources/ file to keep per group sharing a source id with a duplicate: true file.
`source_delta`	Diff a source’s current content against its last-known revision on main.
`source_lint`	Validate docs/sources/ frontmatter and report processed-but-uncovered sources.
`source_scan`	Classify docs/sources/ files as new, update, or duplicate.
`source_snapshot`	Write a new Raw snapshot unit for SOURCE, for a comments or fields mutation.
`start_branch_cmd`	Open a new local git branch for a batch coordinator session, before any source commits.

Functions:¶

batch_plan_cmd ¶

batch_plan_cmd(vault: Path, source_dir: Path) -> None

Split the files under SOURCE_DIR into batches for parallel wiki-ingest dispatch.

build ¶

build(docs_dir: Path | None) -> None

Regenerate docs/catalog.jsonl from the current docs/wiki/ notes.

cli ¶

cli() -> None

AI skills and helper tools that implement and maintain an LLM Wiki.

commit_pages_cmd ¶

commit_pages_cmd(pages: tuple[str, ...], message: str) -> None

Commit PAGES onto the currently checked-out branch (a batch coordinator’s per-source streaming commit).

config ¶

config() -> None

Inspect wiki_toolkit’s resolved configuration.

config_show ¶

config_show(docs_dir: Path | None) -> None

Print the resolved docs_dir and which source (flag/env/pyproject/default) it came from.

cross_link_candidates_cmd ¶

cross_link_candidates_cmd(
    page_paths: tuple[str, ...], docs_dir: Path | None
) -> None

Find literal title/alias mentions of other catalog pages inside PAGE_PATHS’ bodies (JSONL output).

doctor ¶

doctor(docs_dir: Path | None) -> None

Non-mutating health check of the wiki’s docs/ structure and git clone.

init ¶

init(docs_dir: Path | None) -> None

Scaffold a docs/ tree: sources/, wiki/, catalog.jsonl, log.jsonl, source-manifest.jsonl, schema.md.

lint ¶

lint(docs_dir: Path | None) -> None

Validate wiki note frontmatter, allowed tags, source links, and source_count.

log ¶

log(message: str, details: str, action: str, docs_dir: Path | None) -> None

Append a structured entry to docs/log.jsonl.

propose_pr_cmd ¶

propose_pr_cmd(pages: tuple[str, ...], frame: str) -> None

Stage a wiki change as a local git branch + commit. Never pushes or opens a real PR.

search_catalog_cmd ¶

search_catalog_cmd(query: str, docs_dir: Path | None) -> None

Search docs/catalog.jsonl for entries matching –query.

source_coverage_cmd ¶

source_coverage_cmd(docs_dir: Path | None) -> None

Show which docs/sources/ files are covered by at least one wiki note.

source_dedupe ¶

source_dedupe(docs_dir: Path | None) -> None

Suggest which docs/sources/ file to keep per group sharing a source id with a duplicate: true file.

source_delta ¶

source_delta(source: str, docs_dir: Path | None) -> None

Diff a source’s current content against its last-known revision on main.

source_lint ¶

source_lint(docs_dir: Path | None) -> None

Validate docs/sources/ frontmatter and report processed-but-uncovered sources.

source_scan ¶

source_scan(
    update_manifest: bool, accept_covered: bool, docs_dir: Path | None
) -> None

Classify docs/sources/ files as new, update, or duplicate.

source_snapshot ¶

source_snapshot(source: str, units: str, docs_dir: Path | None) -> None

Write a new Raw snapshot unit for SOURCE, for a comments or fields mutation.

start_branch_cmd ¶

start_branch_cmd(frame: str) -> None

Open a new local git branch for a batch coordinator session, before any source commits.