Export a knowledge pack
A knowledge pack bundles a project's approved artifacts and their indexed knowledge-base chunks into a portable archive that can be published to the marketplace. Other projects can then import the pack and have its content available in their own knowledge base without repeating the approval process.
What the pack contains
The pack is a tar.gz archive with four parts.
- A README in HuggingFace dataset-card format describing the pack.
- A manifest (
kind: knowledge) with metadata about the project and the embedder configuration. - Artifact content and metadata as JSONL, one record per artifact.
- Knowledge-base chunks as JSONL, one record per chunk.
Embedding vectors are deliberately not included. When a pack is imported, chunks are re-embedded through the normal ingestion path. This keeps pack files small and prevents cross-embedder contamination.
The export includes artifacts with status approved, locked, or in_review. Tech-debt work items are excluded by default.
Running an export
Send a POST request to /marketplace/projects/{project_id}/export-knowledge. On success the response is 201 with the pack identifiers.
Secret scan gate
Before the pack is published, every artifact and chunk is scanned for secrets and PII. If any finding is detected the export is aborted and a 422 response is returned with a summary of the findings.
No partial export is written; a blocked export leaves the project's existing published packs untouched.