3

Reference Commands Provenance

Wiki Mirror edited this page 2026-10-16 14:43:37 +00:00

Table of Contents

• Provenance
• Contents
• sources coverage
• sources trace
• sources rebuild-index

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Generated from docs/reference/commands/provenance.md at v10.1.0 – edit the repository, not this wiki.

Provenance

Which raw source backs which page, and the generated provenance index that records it.

Contents

• sources coverage
• sources trace
• sources rebuild-index

sources coverage

List raw files with no source page, broken raw_files: references, and legacy directory/URL-only source pages.

Synopsis

• wikitool sources coverage [--json]

Options

  --json      Print raw findings as JSON
  -h, --help  Show this message and exit.

Examples

tools/wikitool sources coverage
tools/wikitool sources coverage --json

Behaviour

• Lists raw files with no source page, broken raw_files: references, and legacy directory/URL-only source pages.
• --json prints the same lists as JSON.
• Never fails; read-only and safe to retry freely.

Properties

• Changes files: no
• Idempotent: yes
• Atomic: Read-only
• Counts toward the session call budget: yes
• Can reach the network: no

Exit codes

• 0 - success

See also

• wikitool sources trace - follows one file or page
• wiki-ingest skill - turns an uncovered raw file into a source page

sources trace

Trace provenance in either direction: raw file, or page.

Synopsis

• wikitool sources trace --raw <path> | --page "<Title>"

Options

  --raw <str>   Raw file path to trace forward from
  --page <str>  Wiki page title to trace backward from
  -h, --help    Show this message and exit.

Examples

tools/wikitool sources trace --page "Docker"
tools/wikitool sources trace --raw "raw/articles/llm-wiki.md"

Behaviour

• --raw <path>: raw file -> the source page(s) covering it -> the pages citing those.
• --page "<Title>": page -> its sources -> their raw files.
• Read-only.

Properties

• Changes files: no
• Idempotent: yes
• Atomic: Read-only
• Counts toward the session call budget: yes
• Can reach the network: no

Exit codes

• 0 - success
• 1 - Neither or both of --raw/--page given, or --page names an unknown page
• 1 - --raw names a file no source page covers - reported as a plain finding plus exit 1, not the usual ERROR-prefixed rejection

See also

• wikitool sources coverage - every uncovered raw file at once
• wikitool xref link-source - links a source page to what it mentions

sources rebuild-index

Regenerate the kb/provenance.md reverse index.

Synopsis

• wikitool sources rebuild-index [--dry-run]

Options

  --dry-run   Print the result instead of writing kb/provenance.md
  -h, --help  Show this message and exit.

Examples

tools/wikitool sources rebuild-index
tools/wikitool sources rebuild-index --dry-run

Behaviour

• Regenerates the kb/provenance.md reverse index (raw file -> source page -> citing pages) from scratch.
• --dry-run prints the result instead of writing kb/provenance.md.

Properties

• Changes files: yes
• Idempotent: yes
• Atomic: Yes - the single provenance file is regenerated from scratch
• Counts toward the session call budget: yes
• Can reach the network: no

Exit codes

• 0 - success
• 1 - An I/O error while writing kb/provenance.md (rare)

See also

• wikitool index rebuild - the page catalog, rebuilt alongside
• instructions/publish-cycle.md - where a write session runs this

• Chemenu - Personal IT Knowledge Base
• Install a Chemenu instance
• Tutorials
  • From your first source to your first answer
  • Home lab backups - how they work now
• How-to guides
  • Back up to a synced folder
  • Browse the wiki in Obsidian
  • Capture documentation from a git repository
  • Collect documents from a synced folder
  • Export guidelines to captured repositories
  • Export to a synced folder
  • Fetch pages behind a login
  • Ingest a source
  • Maintain the wiki
  • Query the wiki
  • Run the weekly review
  • Set up the MCP read server
  • Trace and score agent sessions
  • Troubleshoot an instance
  • Update an instance
  • Use 1Password for settings
  • Write a site handler
• Reference
  • Command reference
    • Catalog and log
    • Configuration
    • Content migrations
    • Distribution and versioning
    • Exports
    • Finding and checking
    • Git
    • Instance health
    • Links and citations
    • Pages
    • Provenance
    • Raw material and uploads
    • Telemetry
    • Types, instructions and docs
    • Workshop runs and session budget
  • Configuration
  • Exit codes and gates
  • Page types
  • Skill catalogue
• Explanation
  • Architecture
  • Configuration tiers
  • Why knowledge and commitments are two layers
  • Language Boundaries
  • Choosing a Claude Code model and effort level
  • Ownership and Templates
  • Why the pipeline has four stages
  • Telemetry and evaluation
  • Why the stack version splits compatibility from migration
  • Why gates are code
• Dev
  • Developing this stack