pce-core

PCE Core - V2 Knowledge Workflow

Manages the v2 pce-memory workflow:

observe -> distill -> promote -> activate(intent) -> feedback -> rollback

pce_memory_upsert still exists, but only as a narrow escape hatch for already-distilled durable knowledge.

Argument Parsing

Parse $ARGUMENTS:

• activate [query] → Intent-aware recall mode
• observe [text] → Raw micro-memory capture
• distill [source ids or guidance] → Promotion candidate creation
• promote [candidate-id] → Durable promotion
• rollback [claim-id] [reason] → Durable repair/supersession
• upsert [kind] [text] → Escape hatch for already-distilled durable knowledge
• feedback [claim-id] [signal] → Feedback mode
• No arguments → Full workflow guide

State Gate

1. Check current state with pce_memory_state
2. If Uninitialized, run pce_memory_policy_apply
3. Continue only after the policy state is ready for the tool you need

1. Observe (Raw Micro Memory Only)

Use pce_memory_observe for raw inputs:

• session work-in-progress
• chat/tool/file/http/system outputs
• debugging notes and local evidence
• secret or PII-bearing material that must not become durable inline

Rules

• Observe is raw-only. It does not create durable claims inline.
• Do not use legacy inline extraction modes such as single_claim_v0.
• extract: { mode: "noop" } is only a compatibility knob and still preserves raw-only behavior.
• Use boundary_class: secret only in observe, never in upsert.
• Use observe instead of upsert for anything session-scoped.

Typical Input

{
  "source_type": "chat|tool|file|http|system",
  "content": "...",
  "boundary_class": "public|internal|pii|secret",
  "tags": ["..."],
  "ttl_days": 7
}

2. Distill (Create Promotion Candidate)

Use pce_memory_distill to convert observations, claims, or an active context into a reviewable candidate.

Inputs

• source_observation_ids: Raw observations to abstract
• source_claim_ids: Existing durable claims to refine or supersede
• active_context_id: Promote from a planned working set
• proposed_kind: fact | preference | task | policy_hint
• proposed_scope: project | principle
• proposed_memory_type: working_state | knowledge | procedure | norm
• note: Distillation hint for reviewers