lsp-max 26.7.3

Law-state LSP runtime: max LSP 3.18 coverage, process-mining conformance, receipt-chain admission
Documentation
use crate::runtime::mesh::AutonomicMesh;
use crate::runtime::mesh_types::LspPhase;
use crate::runtime::sha256::sha256;

impl AutonomicMesh {
    pub fn verify_instance_ledger(&self, instance_id: &str) -> Result<(), String> {
        let instance = self
            .instances
            .get(instance_id)
            .ok_or_else(|| format!("Instance {} not found", instance_id))?;

        let history = &instance.receipts;
        if history.is_empty() {
            return Err("Ledger is empty".to_string());
        }

        if instance_id == "LSP_1" {
            let r0 = &history[0];
            if r0.receipt_id != "rcpt-uninitialized" {
                return Err(format!("Invalid initial receipt ID: {}", r0.receipt_id));
            }
            let mut expected_hash = sha256(r0.receipt_id.as_bytes());
            if r0.hash != expected_hash {
                return Err(format!(
                    "Hash mismatch at index 0: expected {}, got {}",
                    expected_hash, r0.hash
                ));
            }

            if history.len() > 1 {
                let r1 = &history[1];
                if !r1
                    .receipt_id
                    .starts_with("rcpt-uninitialized-to-initializing:")
                {
                    return Err(format!("Invalid receipt ID at index 1: {}", r1.receipt_id));
                }
                let prefix_len = "rcpt-uninitialized-to-initializing:".len();
                let json_str = &r1.receipt_id[prefix_len..];
                if serde_json::from_str::<serde_json::Value>(json_str).is_err() {
                    return Err("Failed to parse client capabilities in receipt 1".to_string());
                }

                expected_hash = sha256(format!("{}:{}", expected_hash, r1.receipt_id).as_bytes());
                if r1.hash != expected_hash {
                    return Err(format!(
                        "Hash mismatch at index 1: expected {}, got {}",
                        expected_hash, r1.hash
                    ));
                }
            }

            if history.len() > 2 {
                let r2 = &history[2];
                if !r2
                    .receipt_id
                    .starts_with("rcpt-initializing-to-initialized:")
                {
                    return Err(format!("Invalid receipt ID at index 2: {}", r2.receipt_id));
                }
                let prefix_len = "rcpt-initializing-to-initialized:".len();
                let json_str = &r2.receipt_id[prefix_len..];
                if serde_json::from_str::<serde_json::Value>(json_str).is_err() {
                    return Err("Failed to parse server capabilities in receipt 2".to_string());
                }

                expected_hash = sha256(format!("{}:{}", expected_hash, r2.receipt_id).as_bytes());
                if r2.hash != expected_hash {
                    return Err(format!(
                        "Hash mismatch at index 2: expected {}, got {}",
                        expected_hash, r2.hash
                    ));
                }
            }

            if history.len() > 3 {
                let r3 = &history[3];
                if r3.receipt_id != "rcpt-initialized-to-shutdown" {
                    return Err(format!("Invalid receipt ID at index 3: {}", r3.receipt_id));
                }
                expected_hash = sha256(format!("{}:{}", expected_hash, r3.receipt_id).as_bytes());
                if r3.hash != expected_hash {
                    return Err(format!(
                        "Hash mismatch at index 3: expected {}, got {}",
                        expected_hash, r3.hash
                    ));
                }
            }

            if history.len() > 4 {
                let r4 = &history[4];
                if r4.receipt_id != "rcpt-shutdown-to-exited" {
                    return Err(format!("Invalid receipt ID at index 4: {}", r4.receipt_id));
                }
                expected_hash = sha256(format!("{}:{}", expected_hash, r4.receipt_id).as_bytes());
                if r4.hash != expected_hash {
                    return Err(format!(
                        "Hash mismatch at index 4: expected {}, got {}",
                        expected_hash, r4.hash
                    ));
                }
            }

            if history.len() > 5 {
                return Err("Ledger contains unexpected items beyond Exited state".to_string());
            }

            let expected_phase = match history.len() {
                1 => LspPhase::Uninitialized,
                2 => LspPhase::Initializing,
                3 => LspPhase::Initialized,
                4 => LspPhase::ShutDown,
                5 => LspPhase::Exited,
                _ => unreachable!(),
            };

            if instance.phase != expected_phase {
                return Err(format!(
                    "Phase mismatch: instance.phase is '{}' but ledger shows '{}'",
                    instance.phase, expected_phase
                ));
            }
        } else {
            for (idx, r) in history.iter().enumerate() {
                if r.receipt_id.is_empty() {
                    return Err(format!("Empty receipt ID at index {}", idx));
                }
                if r.hash.is_empty() {
                    return Err(format!("Empty receipt hash at index {}", idx));
                }
            }
        }

        Ok(())
    }

    pub fn get_ledger_diagnostic_report(&self, instance_id: &str) -> String {
        let mut report = format!("Ledger Diagnostic Report for Instance: {}\n", instance_id);
        match self.verify_instance_ledger(instance_id) {
            Ok(()) => {
                report.push_str("Status: ADMITTED (Cryptographic integrity confirmed)\n");
            }
            Err(e) => {
                report.push_str(&format!(
                    "Status: REFUSED (Ledger verification refused: {})\n",
                    e
                ));
            }
        }

        if let Some(instance) = self.instances.get(instance_id) {
            report.push_str(&format!("Active Phase: {}\n", instance.phase));
            report.push_str(&format!("Policy State: {:?}\n", instance.policy_state));
            report.push_str(&format!("Receipts count: {}\n", instance.receipts.len()));
            for (idx, r) in instance.receipts.iter().enumerate() {
                report.push_str(&format!(
                    "  [{}] ID: {} | Hash: {}\n",
                    idx, r.receipt_id, r.hash
                ));
            }
        } else {
            report.push_str("Instance not found in mesh registry.\n");
        }
        report
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::runtime::mesh_types::{LspInstance, Receipt};

    fn make_mesh_with_instance(instance: LspInstance) -> AutonomicMesh {
        let mut mesh = AutonomicMesh::new();
        mesh.add_instance(instance);
        mesh
    }

    // ---- verify_instance_ledger: unknown instance ----

    #[test]
    fn ledger_unknown_instance_is_err() {
        let mesh = AutonomicMesh::new();
        let result = mesh.verify_instance_ledger("NONEXISTENT");
        assert!(result.is_err());
        assert!(result.unwrap_err().contains("not found"));
    }

    // ---- verify_instance_ledger: empty receipt ledger ----

    #[test]
    fn ledger_empty_receipts_is_err() {
        let instance = LspInstance::new("ANY_ID");
        // No receipts attached — ledger is empty.
        let mesh = make_mesh_with_instance(instance);
        let result = mesh.verify_instance_ledger("ANY_ID");
        assert!(result.is_err());
        assert!(result.unwrap_err().contains("empty"));
    }

    // ---- verify_instance_ledger: non-LSP_1 path (generic id check) ----

    #[test]
    fn ledger_generic_instance_valid_receipt() {
        // For instances other than LSP_1 the verifier only checks that
        // receipt_id and hash are non-empty.
        let mut instance = LspInstance::new("LSP_2");
        instance.receipts.push(Receipt {
            receipt_id: "rcpt-some-event".to_string(),
            hash: "deadbeef".to_string(),
            prev_receipt_hash: None,
        });
        let mesh = make_mesh_with_instance(instance);
        let result = mesh.verify_instance_ledger("LSP_2");
        assert!(
            result.is_ok(),
            "non-empty receipt on generic instance must pass"
        );
    }

    #[test]
    fn ledger_generic_instance_empty_receipt_id_is_err() {
        let mut instance = LspInstance::new("LSP_3");
        instance.receipts.push(Receipt {
            receipt_id: String::new(), // empty — violates the check
            hash: "deadbeef".to_string(),
            prev_receipt_hash: None,
        });
        let mesh = make_mesh_with_instance(instance);
        let result = mesh.verify_instance_ledger("LSP_3");
        assert!(result.is_err(), "empty receipt_id must return Err");
        assert!(result.unwrap_err().contains("Empty receipt ID"));
    }

    #[test]
    fn ledger_generic_instance_empty_hash_is_err() {
        let mut instance = LspInstance::new("LSP_4");
        instance.receipts.push(Receipt {
            receipt_id: "rcpt-something".to_string(),
            hash: String::new(), // empty — violates the check
            prev_receipt_hash: None,
        });
        let mesh = make_mesh_with_instance(instance);
        let result = mesh.verify_instance_ledger("LSP_4");
        assert!(result.is_err(), "empty receipt hash must return Err");
        assert!(result.unwrap_err().contains("Empty receipt hash"));
    }

    // ---- verify_instance_ledger: LSP_1 path — genesis receipt ----

    #[test]
    fn ledger_lsp1_valid_genesis() {
        let mut instance = LspInstance::new("LSP_1");
        instance.phase = LspPhase::Uninitialized;
        let h0 = sha256(b"rcpt-uninitialized");
        instance.receipts.push(Receipt {
            receipt_id: "rcpt-uninitialized".to_string(),
            hash: h0,
            prev_receipt_hash: None,
        });
        let mesh = make_mesh_with_instance(instance);
        let result = mesh.verify_instance_ledger("LSP_1");
        assert!(result.is_ok(), "valid genesis receipt for LSP_1 must pass");
    }

    #[test]
    fn ledger_lsp1_wrong_genesis_id_is_err() {
        let mut instance = LspInstance::new("LSP_1");
        instance.phase = LspPhase::Uninitialized;
        instance.receipts.push(Receipt {
            receipt_id: "rcpt-wrong".to_string(),
            hash: sha256(b"rcpt-wrong"),
            prev_receipt_hash: None,
        });
        let mesh = make_mesh_with_instance(instance);
        let result = mesh.verify_instance_ledger("LSP_1");
        assert!(result.is_err(), "wrong genesis receipt_id must return Err");
    }

    #[test]
    fn ledger_lsp1_tampered_genesis_hash_is_err() {
        let mut instance = LspInstance::new("LSP_1");
        instance.phase = LspPhase::Uninitialized;
        instance.receipts.push(Receipt {
            receipt_id: "rcpt-uninitialized".to_string(),
            hash: "0000000000000000000000000000000000000000000000000000000000000000".to_string(),
            prev_receipt_hash: None,
        });
        let mesh = make_mesh_with_instance(instance);
        let result = mesh.verify_instance_ledger("LSP_1");
        assert!(result.is_err(), "tampered genesis hash must return Err");
    }
}