kb-build — Build a Three-Layer Knowledge Base

When to use

User points you at a corpus (codebase, notes archive, docs folder) and wants a fresh .kb/ built from scratch. One-shot operation.

If .kb/ already exists at the target path, STOP. Ask the user whether to overwrite, and get explicit confirmation before proceeding.

Input

• Corpus root path — argument from the user. If missing, ask for it before starting. Default is not the current directory unless the user confirms.
• --include <path> (optional, repeatable) — override a default exclusion. See references/default-exclusions.md.

Output (created inside the corpus root)