Handbook

PDP KB enrichment workbench

Local workbench for filling sparse PDP knowledge-base source categories via LCDL + lmeta (kb-category-enrich.lmeta) driving Playwright ChatGPT (pw_chatgpt_compose) over a CDP browser session.

Updated 2026-07-17

Prerequisites

Chrome or Edge with remote debugging: google-chrome --remote-debugging-port=9222 (or Edge equivalent).
Log into https://chatgpt.com in that browser.
forge-lcdl installed editable with Playwright extra: pip install -e '/path/to/forge-lcdl[playwright]'
Active KB v2.1.0+ with taxonomy/category_specs.json.

Layout

workbench/pdp-kb-enrichment/
├── flows/
│   └── kb-category-enrich.lmeta   # produce/validate optimize loop
├── prompts/
│   ├── _system.md
│   ├── category_enrich.md
│   └── per-category/          # optional overrides
├── draft/runs/<run-id>/
│   ├── run_manifest.json
│   └── fragments/<SRC_*.json>
└── scripts/
    └── run_kb_category_enrich.py

Governed LCDL atoms (in forge-lcdl):

pw_chatgpt_compose — CDP new-tab ChatGPT prompt submit
kb_category_fragment_validate — deterministic fragment checks

Run enrichment (CLI)

export CDP_URL=http://127.0.0.1:9222
cd workbench/feedback-360
python3 ../pdp-kb-enrichment/scripts/run_kb_category_enrich.py --category SRC_COACHING_ASSESSMENT
python3 ../pdp-kb-enrichment/scripts/run_kb_category_enrich.py --all-pending
python3 ../pdp-kb-enrichment/scripts/run_kb_category_enrich.py --dry-run --category SRC_COACHING_ASSESSMENT

Low-level LCDL runner (same flow):

python3 scripts/run-kb-enrich-lcdl.py --prompt-file /tmp/p.txt --out /tmp/out.txt --dry-run

Studio UI

Open Knowledge Base tab → Enrich sparse categories (polls GET /api/kb/enrich/progress).

Promote fragments

After validation:

cd workbench/feedback-360
python3 scripts/merge-kb-enrichment.py --run-id <run-id> --preview
python3 scripts/merge-kb-enrichment.py --run-id <run-id> --apply --pack-version 2.1.0-enriched-20260713

Pilot category

SRC_COACHING_ASSESSMENT (executive coaching / reflective practice) — extends underpopulated coaching category.

Capablio