cordance-cortex 0.1.1

Cordance Cortex adapter. Emits candidate receipts; never writes to the cortex repo or runtime.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

# cordance-cortex

> Cortex adapter. Emits `cordance-cortex-receipt-v1-candidate` JSON only;
> never writes to the cortex repo or runtime.

[![crates.io](https://img.shields.io/crates/v/cordance-cortex.svg)](https://crates.io/crates/cordance-cortex)
[![docs.rs](https://docs.rs/cordance-cortex/badge.svg)](https://docs.rs/cordance-cortex)
[![license](https://img.shields.io/badge/license-MIT_OR_Apache--2.0-blue.svg)](#license)

Part of the [Cordance](https://github.com/0ryant/cordance) workspace.

## Discoverability

Search terms: Cordance Cortex, Cortex receipt, candidate memory receipt,
authority boundary, candidate-only evidence, AI memory intake, context pack
provenance.

## What it does

`cordance-cortex` builds a candidate receipt that Cortex's own
`cortex_memory_accept` flow can ingest. The receipt's `AuthorityBoundary`
is constructed only via `AuthorityBoundary::candidate_only()`, which sets
every authority-grant flag to `false`:

- `cortex_truth_allowed: false`
- `cortex_admission_allowed: false`
- `durable_promotion_allowed: false`
- `memory_promotion_allowed: false`
- `doctrine_promotion_allowed: false`
- `trusted_history_allowed: false`
- `release_acceptance_allowed: false`
- `runtime_authority_allowed: false`

Receipts deserialise back through `validate_invariants()`, so a tampered
JSON that flips any flag fails the post-parse check even if `serde` accepts
it. Every nested struct carries `#[non_exhaustive]` + `#[serde(deny_unknown_fields)]`.

Cordance never modifies cortex storage. The operator hands the emitted
receipt JSON to Cortex; Cortex decides what (if anything) to promote.

## Install

```toml
[dependencies]
cordance-cortex = "0.1"
cordance-core = "0.1"
```

## Quick start

```rust,no_run
use cordance_core::pack::{CordancePack, PackTargets, ProjectIdentity};
use cordance_core::lock::SourceLock;
use cordance_core::advise::AdviseReport;
use cordance_core::schema;

let pack = CordancePack {
    schema: schema::CORDANCE_PACK_V1.into(),
    project: ProjectIdentity {
        name: "my-project".into(),
        repo_root: ".".into(),
        kind: "rust-workspace".into(),
        host_os: "linux".into(),
        axiom_pin: Some("v3.1.1-axiom".into()),
    },
    sources: vec![],
    doctrine_pins: vec![],
    targets: PackTargets::all(),
    outputs: vec![],
    source_lock: SourceLock::empty(),
    advise: AdviseReport::empty(),
    residual_risk: vec!["claim_ceiling=candidate".into()],
};

let receipt = cordance_cortex::build_receipt(&pack).expect("build receipt");
receipt.validate_invariants().expect("invariants hold");

let json = serde_json::to_string_pretty(&receipt).expect("serialise");
println!("{json}");
```

## See also

- [Cordance project README](https://github.com/0ryant/cordance#readme)
- [`cordance-core`](https://crates.io/crates/cordance-core) — defines the
  receipt structs + `AuthorityBoundary`.
- The CLI subcommand `cordance cortex push` wraps this crate; it is the
  intended end-user entry point.

## License

Dual-licensed under MIT OR Apache-2.0.