sources

Manage registered source directories for this wiki. Sources let you point the wiki at folders that already exist in your projects — the wiki reads from them directly without copying files into raw/.

Parse arguments

Split $ARGUMENTS into a subcommand:

• add <path> — register a new source directory
• list — show all registered sources
• remove <name> — unregister a source (does NOT delete wiki pages compiled from it)

Source storage

Sources are stored in sources.yaml at the wiki root. Read it if it exists; create it on first add.

Schema:

sources:
  - name: research          # unique key (derived from path basename if not given)
    path: /absolute/path    # resolved to absolute
    pattern: "**/*.md"      # glob pattern for files to include
  - name: signals
    path: /absolute/path/to/signals
    pattern: "**/*.md"

Subcommand: add

/llm-wiki:sources add ~/content-system/.claude/research
/llm-wiki:sources add ~/content-system/ideas/signals --name signals

1. Resolve the path to absolute (expand ~).
2. Verify the directory exists. If not, error: "Directory not found: "
3. Derive a name from the last path component if --name wasn't given. If the name already exists in sources.yaml, error: "Source '' already registered. Use a different --name."
4. Detect what file types exist in the directory. Set pattern accordingly:
   • Only .md files → "**/*.md"
   • Mixed formats (md + pdf + csv + json etc.) → "**/*" (Claude can read most formats natively)
5. Read existing sources.yaml (or start with {sources: []}), append the new entry, write back atomically.
6. Count matching files. Print:

   Added source 'research' → /Users/doneyli/content-system/.claude/research
   22 files matching pattern **/*.md
   Run /llm-wiki:ingest --all to compile these into the wiki.
   

Subcommand: list

/llm-wiki:sources list

Read sources.yaml. For each entry, count matching files on disk. Print a table: