Skip to main content

qualia_core_db/inference/conditioning/codec/
encode.rs

1//! Canonical CBOR encoding for compiled plan summary.
2
3use super::super::compile::CompiledPlanSummary;
4use super::super::spec::ConditioningError;
5use super::CODEC_VERSION;
6
7/// Encode a CompiledPlanSummary into a caller-supplied buffer using Tag-4201 format.
8/// Returns bytes written. Fails with OutputBufferFull if caller buffer is insufficient.
9pub fn encode_plan_cbor<'a>(
10    plan: &CompiledPlanSummary<'a>,
11    out: &mut [u8],
12) -> Result<usize, ConditioningError> {
13    // Magic 4-byte prefix: 0xD9, 0x10, 0x69 (Tag 4201 in CBOR: 0xd9, 0x10, 0x69)
14    // plus map of 7 entries: 0xA7
15    let p_bytes = plan.profile_id.as_bytes();
16    let o_bytes = plan.objective.as_bytes();
17
18    let total_len = 4
19        + 2 + 2 // version
20        + 1 + 8 // plan_id
21        + 2 + p_bytes.len() // profile_id
22        + 2 + o_bytes.len() // objective
23        + 1 + 4 // req_count
24        + 1 + 4 // outcomes_count
25        + 1 + 4; // evidence_count
26
27    if out.len() < total_len {
28        return Err(ConditioningError::OutputBufferFull);
29    }
30
31    let mut idx = 0;
32    out[idx] = 0xd9;
33    out[idx + 1] = 0x10;
34    out[idx + 2] = 0x69; // Tag 4201
35    out[idx + 3] = 0xa7; // map of 7 items
36    idx += 4;
37
38    // Field 0: Version
39    out[idx..idx + 2].copy_from_slice(&CODEC_VERSION.to_be_bytes());
40    idx += 2;
41
42    // Field 1: Plan ID
43    out[idx..idx + 8].copy_from_slice(&plan.plan_id.to_be_bytes());
44    idx += 8;
45
46    // Field 2: Profile ID
47    let p_len = p_bytes.len() as u16;
48    out[idx..idx + 2].copy_from_slice(&p_len.to_be_bytes());
49    idx += 2;
50    out[idx..idx + p_bytes.len()].copy_from_slice(p_bytes);
51    idx += p_bytes.len();
52
53    // Field 3: Objective
54    let o_len = o_bytes.len() as u16;
55    out[idx..idx + 2].copy_from_slice(&o_len.to_be_bytes());
56    idx += 2;
57    out[idx..idx + o_bytes.len()].copy_from_slice(o_bytes);
58    idx += o_bytes.len();
59
60    // Field 4: Requirements count
61    out[idx..idx + 4].copy_from_slice(&(plan.requirements_count as u32).to_be_bytes());
62    idx += 4;
63
64    // Field 5: Outcomes count
65    out[idx..idx + 4].copy_from_slice(&(plan.outcomes_count as u32).to_be_bytes());
66    idx += 4;
67
68    // Field 6: Evidence count
69    out[idx..idx + 4].copy_from_slice(&(plan.evidence_count as u32).to_be_bytes());
70    idx += 4;
71
72    Ok(idx)
73}