knowledge-match

Knowledge Match

Purpose

Read only knowledge_record and released_assets from Closeout output (knowledge-reuse-rules.md #1.3), keep release candidates, list governed lessons as excluded until Closeout supplies written lesson text (#2.4), and score relevance deterministically.

When to use

After engagement-retrieve, when Closeout governed.json is available.

When NOT to Use

• Closeout harvesting, sanitisation or release decisions - use engagement-closeout-knowledge-harvest.
• Whether this joiner may access an item - use wall-check; matched items are candidates until it runs.
• Drafting the digest prose - use pack-draft.

Inputs

scope.json and Scenario 01 governed.json (ps.engagement-closeout-knowledge-harvest.v1), plus the raw directory, staffing input and confirmed roster engagement-retrieve read: the engine re-runs scope_digest on them and refuses a scope.json that differs from the re-derivation in any field (confidentiality-and-ethical-wall-rules.md #1.4).

Steps

1. Run python3 scripts/knowledge_match.py --scope scope.json --raw-dir <raw> --staffing <staffing.json> --confirmed-roster <raw>/confirmed-roster.csv --closeout <closeout governed.json> --wall-register <raw>/ethical-wall-register.csv --out matched.json --generated-at <YYYY-MM-DDTHH:MM:SSZ>.
2. If the engine exits non-zero (wrong contract, missing, null or malformed knowledge_record, released_assets, knowledge_record.reusable_assets or knowledge_record.lessons (an absent list is never read as empty), wrong field types such as a string confidence or non-boolean review_required, a scope.json that fails its stage schema, carries hold evidence without its hold, or is not the document scope_digest re-derives from the raw inputs), stop and report (see Failure handling; knowledge-reuse-rules.md #1.4).
3. Report included items with relevance_score, review_status and citations; pending_practice_review items may be referenced by title and citation only, and their summary is always the engine's fixed title-and-citation-only statement, never the Closeout description (knowledge-reuse-rules.md #2.3). An asset excluded as description_is_stage_guidance_not_written_content has no written description: its Closeout text is guidance to a drafter, so never quote, paraphrase or write a summary from it (knowledge-reuse-rules.md #2.6).
4. Report excluded_items by ID and reason; never describe held or candidate assets. A lesson excluded as lesson_text_not_written_in_governed_closeout_record has no written lesson yet: say so with its citation, and never quote, paraphrase or write a lesson from Closeout's drafting_guidance, which is an instruction to the Closeout drafter, not lesson content (knowledge-reuse-rules.md #2.4).
5. Hand matched.json to wall-check.