Function lift_memory

atomic-canonical/src/memory.rs:137–177

Lift a memory from its frontmatter spine and markdown body. `memoryKind`, `status`, `about`, `derivedFrom`, `supersedes`, and `previousRevision` are read from the frontmatter. The text is lifted from the FIRST `:::memory` container directive if present (single authoring site), else falls back to the whole trimmed body.

(frontmatter: &Map<String, Value>, body: &str)

/// container directive if present (single authoring site), else falls back to
/// the whole trimmed body.
pub fn lift_memory(frontmatter: &Map<String, Value>, body: &str) -> Result<MemoryNode> {
    crate::directive::check_embedded_directives(body)?;
    let uid = opt_str(frontmatter, "uid")
        .or_else(|| opt_str(frontmatter, "id"))
        .ok_or_else(|| CanonicalError::Lift("memory frontmatter missing 'uid' (or 'id')".into()))?;
    let node_id = as_memory_urn(&uid);

    let memory_kind =
        require_str(frontmatter, "memoryKind").or_else(|_| require_str(frontmatter, "kind"))?;
    let status = opt_str(frontmatter, "status").unwrap_or_else(|| "active".to_string());

    // Single authoring site: the first `:::memory` container's body is
    // authoritative; the surrounding prose is ignored. Only when no container
    // is present does the whole trimmed body become the text — never both.
    //
    // The memory text is OPEN prose (presence enforced, content honest), so we
    // must NOT run it through the closed-vocabulary directive parser: a body
    // that legitimately begins a line with `::` (a Rust turbofish `::<T>`, or
    // prose discussing `:::why`) is valid memory content, not a directive
    // error. We do a lenient fence scan instead, which never rejects.
    let text = extract_memory_container(body).unwrap_or_else(|| body.trim().to_string());

    Ok(MemoryNode {
        context: CONTEXT_URL.to_string(),
        type_: NodeType::Memory.as_str().to_string(),
        id: node_id,
        memory_kind,
        text,
        about: str_array(frontmatter, "about"),
        derived_from: str_array(frontmatter, "derivedFrom"),
        status,
        supersedes: opt_str(frontmatter, "supersedes"),
        previous_revision: opt_str(frontmatter, "previousRevision"),
        content_hash: None,
        attributed_to: opt_str(frontmatter, "attributedTo"),
        created_at: opt_str(frontmatter, "createdAt")
            .or_else(|| opt_str(frontmatter, "created_at"))
            .unwrap_or_default(),
        proof: None,
    })
}

/// Lenient scan for a single `:::memory` container fence, returning its inner
/// body if present. Unlike the closed-vocabulary [`crate::directive`] parser,