kb-register-library

Register External Library

Add an external knowledge base to the user-scope global registry so it can be activated in any project's .sdlc/libraries.json.

Arguments

• <name> — a short handle used in attribution output. Lowercase-kebab-case recommended (e.g., corporate-semiconductor, corp-healthcare). Must be unique within ~/.sdlc/global-libraries.json.
• <absolute-path-to-library-dir> — the absolute path to the library directory (the one containing _shelf-index.md), not the repo root. Must exist at registration time.
• [description] — optional human note for the user's own reference. Not used by any system behaviour.

Preflight

• Verify the registry file's parent directory exists. Create ~/.sdlc/ if missing.
• If ~/.sdlc/global-libraries.json exists, load and validate it.
• Validate <name> matches ^[a-z][a-z0-9-]*$ (lowercase letters, digits, hyphens; must start with a letter). If not, error with: "Library handle must match ^[a-z][a-z0-9-]*$ — found ''. Choose a different name."
• If the chosen <name> is already registered, error out with the existing entry's path shown; recommend a different name or manual JSON edit.

Steps

1. Validate the target library path

Run the path validator:

python3 -c "
import sys, os, importlib.util
PLUGIN_ROOT = os.environ.get('CLAUDE_PLUGIN_ROOT', '')
SCRIPTS = os.path.join(PLUGIN_ROOT, 'scripts')
INIT = os.path.join(SCRIPTS, '__init__.py')
if os.path.isfile(INIT) and 'sdlc_knowledge_base_scripts' not in sys.modules:
    spec = importlib.util.spec_from_file_location(
        'sdlc_knowledge_base_scripts',
        INIT,
        submodule_search_locations=[SCRIPTS],
    )
    if spec and spec.loader:
        module = importlib.util.module_from_spec(spec)
        sys.modules['sdlc_knowledge_base_scripts'] = module
        spec.loader.exec_module(module)
from pathlib import Path
from sdlc_knowledge_base_scripts.registry import validate_library_path
ok, reason = validate_library_path(Path('<path>'))
if not ok:
    print(f'ERROR: {reason}')
    exit(1)
print('OK')
"