kp-content-validation

name	kp-content-validation
description	Validates knowledge pack content against runtime schemas: .skillmeta against KnowledgePackSchema, modules against ModulesFileSchema, activities against PackActivitySchema. Checks cross-pack references, learning outcome uniqueness, and file completeness. Use when validating pack content after generation.
metadata	{"extensions":{"gsd-skill-creator":{"triggers":{"intents":["pack.*validat","schema.*check","pack.*verify","cross.*pack.*ref"],"files":["src/knowledge/content-validator.ts","src/knowledge/__tests__/content-validator.test.ts"],"contexts":["pack content validation","schema verification"],"threshold":0.7},"token_budget":"1.0%","version":1,"enabled":true,"plan_origin":"244-chipset-agent-definitions","phase_origin":"244"}}}

Content Validation

Purpose

Validates all generated pack content against the runtime schemas defined in src/knowledge/types.ts. This is the quality gate skill used by the KP-05 validator agent after each batch of packs is generated. It catches schema violations, missing files, broken cross-pack references, and duplicate learning outcome codes before content reaches the review stage.

Capabilities

• .skillmeta YAML validation against KnowledgePackSchema via parseSkillmeta
• Modules YAML validation against ModulesFileSchema
• Activities JSON validation against PackActivitySchema (per-entry)
• Vision document structure validation (required sections present)
• Assessment framework structure validation (rubric levels present)
• Resource catalog validation (links resolve, categories present)
• Cross-pack dependency reference validation (pack_id exists in registry)
• Learning outcome code uniqueness across all registered packs
• File completeness check (all 6 required files per pack directory)
• Batch validation: run all checks across 5 packs in a single pass

Key Modules

Module	Purpose
src/knowledge/content-validator.ts	Pack content validation engine
src/knowledge/skillmeta-parser.ts	.skillmeta YAML parsing with Zod validation
src/knowledge/registry.ts	Pack registry for cross-reference checking
src/knowledge/dependency-resolver.ts	Prerequisite chain validation with cycle detection
src/knowledge/prerequisite-validator.ts	Entry requirement checking

Usage Examples

Validate a single pack:

import { validatePack } from './content-validator.js';

const result = await validatePack('src/knowledge/packs/math-101');
// result.valid: boolean
// result.errors: string[] (empty if valid)
// result.warnings: string[] (non-blocking issues)

Validate a batch:

After Phase 245 completes, run validation across all 5 generated packs:
- MATH-101, SCI-101, TECH-101, ENGR-101, PHYS-101
Check cross-pack references resolve within the batch and against previously registered packs.

Dependencies

• Pack runtime API (src/knowledge/) -- all parsers and validators
• Registry with previously registered packs for cross-reference resolution

Token Budget Rationale

1.0% budget reflects the validation module references and schema knowledge needed for comprehensive checking. The validator operates on the runtime API, not on raw content, keeping context requirements moderate.