pmat 3.11.0

PMAT - Zero-config AI context generation and code quality toolkit (CLI, MCP, HTTP)
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

#![cfg_attr(coverage_nightly, coverage(off))]
//! Project metadata models for PMAT compliance system (GH-96)
//!
//! Tracks project's PMAT version, schema versions, and compliance state.
//! Stored in `.pmat/project.toml`

use anyhow::{Context, Result};
use serde::{Deserialize, Serialize};
use std::fs;
use std::path::{Path, PathBuf};

/// Project metadata stored in .pmat/project.toml
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct ProjectMetadata {
    /// PMAT metadata
    #[serde(rename = "pmat")]
    pub pmat: PmatMetadata,

    /// Compliance tracking
    #[serde(rename = "compliance", default)]
    pub compliance: ComplianceMetadata,
}

/// PMAT version and schema information
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct PmatMetadata {
    /// PMAT binary version used to create/update this project
    pub version: String,

    /// Last compliance check timestamp (RFC3339)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub last_compliance_check: Option<String>,

    /// Project metadata schema version
    #[serde(default = "default_schema_version")]
    pub schema_version: String,
}

/// Compliance state tracking
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Default)]
pub struct ComplianceMetadata {
    /// Breaking changes that have been accepted/migrated
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub breaking_changes_accepted: Vec<String>,

    /// Last migration timestamp (RFC3339)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub last_migration: Option<String>,

    /// Migration history (version -> timestamp)
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub migration_history: Vec<MigrationRecord>,
}

/// Migration history record
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct MigrationRecord {
    /// Version migrated from
    pub from_version: String,

    /// Version migrated to
    pub to_version: String,

    /// Migration timestamp (RFC3339)
    pub timestamp: String,

    /// Whether migration was successful
    pub success: bool,
}

fn default_schema_version() -> String {
    "1.0".to_string()
}

// --- Implementation methods ---
include!("project_metadata_impls.rs");

// --- Tests ---
include!("project_metadata_tests.rs");