Knowledge

Add and reconcile reviewed Knowledge while preserving the last good revision.

Outcome

Publish a reviewed Knowledge Source and safely reconcile later revisions without losing the last good content.

Prerequisites

An active Workspace and Agent.
Reviewed UTF-8 text no larger than 750,000 bytes.
Stable source key, provenance URI, caller revision, and SHA-256 digest.

Add or replace

andy knowledge-source add --workspace <workspace-id> --agent <agent-id> --key pricing --title "Pricing" --provenance-kind repository --provenance-uri docs/pricing.md --revision git:<commit> --digest sha256:<digest> --file ./pricing.md --json
andy knowledge-source wait --workspace <workspace-id> --agent <agent-id> --source <source-id> --timeout-ms 120000 --json
andy knowledge-source replace --workspace <workspace-id> --agent <agent-id> --source <source-id> --revision git:<next-commit> --digest sha256:<next-digest> --file ./pricing.md --json

Replacement creates a private candidate revision. Failed processing leaves the previous active revision available.

Reconcile a manifest

andy knowledge-source reconcile --workspace <workspace-id> --agent <agent-id> --manifest ./knowledge-manifest.json --json
andy knowledge-source reconcile --workspace <workspace-id> --agent <agent-id> --manifest ./knowledge-manifest.json --apply --idempotency-key <key> --json

Unchanged sources no-op. Omitted keys remain untouched. Deletion requires an explicit tombstone, --prune, and exact source identity.

Machine-readable verification

andy knowledge-source inspect --workspace <workspace-id> --agent <agent-id> --source <source-id> --json

Require an active current revision with the expected digest and revision; preserve meta.requestId for support.

Next step

Configure one exact public origin in Widget.