@mimir-labs/core 0.1.0

package/dist/protocol/compatibility/aps-pattern-schema.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateApsPattern = validateApsPattern;
+const json_1 = require("../../shared/json");
+function validateApsPattern(value, path) {
+    const errors = [];
+    const warnings = [];
+    if (!(0, json_1.isObject)(value)) {
+        return {
+            valid: false,
+            errors: [
+                {
+                    code: "APS_INVALID_PATTERN",
+                    path,
+                    message: "Pattern must be an object"
+                }
+            ],
+            warnings
+        };
+    }
+    if (typeof value.name !== "string" || value.name.trim() === "") {
+        errors.push({
+            code: "APS_INVALID_PATTERN",
+            path,
+            message: "Pattern.name is required and must be a non-empty string"
+        });
+    }
+    if (value.description !== undefined && typeof value.description !== "string") {
+        errors.push({
+            code: "APS_INVALID_PATTERN_DESCRIPTION",
+            path,
+            message: "Pattern.description must be a string"
+        });
+    }
+    const tags = value.tags === undefined ? undefined : (0, json_1.toStringArray)(value.tags);
+    if (value.tags !== undefined &&
+        (!Array.isArray(value.tags) || (tags !== undefined && tags.length !== value.tags.length))) {
+        warnings.push(`${path}: pattern.tags should be an array of strings`);
+    }
+    const examples = value.examples === undefined ? undefined : (0, json_1.toStringArray)(value.examples);
+    if (value.examples !== undefined &&
+        (!Array.isArray(value.examples) || (examples !== undefined && examples.length !== value.examples.length))) {
+        warnings.push(`${path}: pattern.examples should be an array of strings`);
+    }
+    const rules = value.rules === undefined ? undefined : (0, json_1.toStringArray)(value.rules);
+    if (value.rules !== undefined &&
+        (!Array.isArray(value.rules) || (rules !== undefined && rules.length !== value.rules.length))) {
+        warnings.push(`${path}: pattern.rules should be an array of strings`);
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors, warnings };
+    }
+    const name = value.name;
+    return {
+        valid: true,
+        value: {
+            name: typeof name === "string" ? name : "",
+            description: typeof value.description === "string" ? value.description : undefined,
+            tags,
+            examples,
+            rules
+        },
+        errors,
+        warnings
+    };
+}
+//# sourceMappingURL=aps-pattern-schema.js.map

package/dist/protocol/compatibility/aps-pattern-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aps-pattern-schema.js","sourceRoot":"","sources":["../../../src/protocol/compatibility/aps-pattern-schema.ts"],"names":[],"mappings":"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"}

package/dist/protocol/compatibility/aps-rule-schema.d.ts

@@ -0,0 +1,13 @@
+import type { ValidationIssue } from "./index";
+export type ApsRule = {
+    name: string;
+    description?: string;
+    tags?: string[];
+};
+export type ResourceValidationResult<T> = {
+    valid: boolean;
+    value?: T;
+    errors: ValidationIssue[];
+    warnings: string[];
+};
+export declare function validateApsRule(value: unknown, path: string): ResourceValidationResult<ApsRule>;

package/dist/protocol/compatibility/aps-rule-schema.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateApsRule = validateApsRule;
+const json_1 = require("../../shared/json");
+function validateApsRule(value, path) {
+    const errors = [];
+    const warnings = [];
+    if (!(0, json_1.isObject)(value)) {
+        return {
+            valid: false,
+            errors: [
+                {
+                    code: "APS_INVALID_RULE",
+                    path,
+                    message: "Rule must be an object"
+                }
+            ],
+            warnings
+        };
+    }
+    if (typeof value.name !== "string" || value.name.trim() === "") {
+        errors.push({
+            code: "APS_INVALID_RULE",
+            path,
+            message: "Rule.name is required and must be a non-empty string"
+        });
+    }
+    if (value.description !== undefined && typeof value.description !== "string") {
+        errors.push({
+            code: "APS_INVALID_RULE_DESCRIPTION",
+            path,
+            message: "Rule.description must be a string"
+        });
+    }
+    const tags = value.tags === undefined ? undefined : (0, json_1.toStringArray)(value.tags);
+    if (value.tags !== undefined &&
+        (!Array.isArray(value.tags) || (tags !== undefined && tags.length !== value.tags.length))) {
+        warnings.push(`${path}: rule.tags should be an array of strings`);
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors, warnings };
+    }
+    const name = value.name;
+    return {
+        valid: true,
+        value: {
+            name: typeof name === "string" ? name : "",
+            description: typeof value.description === "string" ? value.description : undefined,
+            tags
+        },
+        errors,
+        warnings
+    };
+}
+//# sourceMappingURL=aps-rule-schema.js.map

package/dist/protocol/compatibility/aps-rule-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aps-rule-schema.js","sourceRoot":"","sources":["../../../src/protocol/compatibility/aps-rule-schema.ts"],"names":[],"mappings":";;AAgBA,0CA0DC;AA1ED,4CAA4D;AAgB5D,SAAgB,eAAe,CAAC,KAAc,EAAE,IAAY;IAC1D,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,CAAC,IAAA,eAAQ,EAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,kBAAkB;oBACxB,IAAI;oBACJ,OAAO,EAAE,wBAAwB;iBAClC;aACF;YACD,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,kBAAkB;YACxB,IAAI;YACJ,OAAO,EAAE,sDAAsD;SAChE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,8BAA8B;YACpC,IAAI;YACJ,OAAO,EAAE,mCAAmC;SAC7C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,oBAAa,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9E,IACE,KAAK,CAAC,IAAI,KAAK,SAAS;QACxB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EACzF,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,2CAA2C,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAExB,OAAO;QACL,KAAK,EAAE,IAAI;QACX,KAAK,EAAE;YACL,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YAC1C,WAAW,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;YAClF,IAAI;SACL;QACD,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/protocol/compatibility/index.d.ts

@@ -0,0 +1,14 @@
+import { validateApsManifest, type ApsManifest } from "./aps-manifest-schema";
+export type ValidationIssue = {
+    code: string;
+    path: string;
+    message: string;
+};
+export type SchemaValidationResult<T> = {
+    valid: boolean;
+    value?: T;
+    errors: ValidationIssue[];
+    warnings: string[];
+    validResources: string[];
+};
+export { validateApsManifest, type ApsManifest };

package/dist/protocol/compatibility/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateApsManifest = void 0;
+const aps_manifest_schema_1 = require("./aps-manifest-schema");
+Object.defineProperty(exports, "validateApsManifest", { enumerable: true, get: function () { return aps_manifest_schema_1.validateApsManifest; } });
+//# sourceMappingURL=index.js.map

package/dist/protocol/compatibility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/protocol/compatibility/index.ts"],"names":[],"mappings":";;;AAAA,+DAA8E;AAgBrE,oGAhBA,yCAAmB,OAgBA"}

package/dist/protocol/governance/applicability-validator.d.ts

@@ -0,0 +1,2 @@
+import type { GovernanceResource, GovernanceValidatorResult } from "./index";
+export declare function validateApplicability(resources: GovernanceResource[]): GovernanceValidatorResult;

package/dist/protocol/governance/applicability-validator.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateApplicability = validateApplicability;
+const json_1 = require("../../shared/json");
+function getGovernance(resource) {
+    if (!(0, json_1.isObject)(resource.metadata)) {
+        return {};
+    }
+    const governance = resource.metadata.governance;
+    return (0, json_1.isObject)(governance) ? governance : {};
+}
+function hasApplicabilityContext(value) {
+    if (!(0, json_1.isObject)(value)) {
+        return false;
+    }
+    const keys = ["framework", "language", "runtime", "platform", "layer", "boundedContext"];
+    return keys.some((key) => {
+        const item = value[key];
+        return (typeof item === "string" ||
+            (Array.isArray(item) && item.some((entry) => typeof entry === "string" && entry.trim() !== "")));
+    });
+}
+function readAuthority(resource) {
+    const governance = getGovernance(resource);
+    return typeof governance.authority === "string" ? governance.authority : "advisory";
+}
+function looksReactSpecific(resource) {
+    const text = [resource.name, resource.id, resource.description]
+        .filter((item) => typeof item === "string")
+        .join(" ")
+        .toLowerCase();
+    return text.includes("react") || text.includes("jsx") || text.includes("tsx");
+}
+function looksBackendSpecific(resource) {
+    const text = [resource.name, resource.id, resource.description]
+        .filter((item) => typeof item === "string")
+        .join(" ")
+        .toLowerCase();
+    return (text.includes("backend") ||
+        text.includes("api") ||
+        text.includes("service") ||
+        text.includes("node"));
+}
+function validateApplicability(resources) {
+    const errors = [];
+    const warnings = [];
+    for (let index = 0; index < resources.length; index += 1) {
+        const resource = resources[index];
+        if (resource.type !== "rule" && resource.type !== "pattern") {
+            continue;
+        }
+        const governance = getGovernance(resource);
+        const authority = readAuthority(resource);
+        const strongAuthority = authority === "policy" || authority === "required";
+        const applicability = governance.applicability;
+        const hasContext = hasApplicabilityContext(applicability);
+        if (!strongAuthority) {
+            continue;
+        }
+        const basePath = `resources[${index}].metadata.governance.applicability`;
+        if (!hasContext) {
+            if (authority === "policy" && looksBackendSpecific(resource)) {
+                errors.push({
+                    code: "APS_GOV_BACKEND_POLICY_GLOBAL",
+                    path: basePath,
+                    message: "Backend policy cannot be global; applicability context is required"
+                });
+            }
+            else if (looksReactSpecific(resource)) {
+                warnings.push({
+                    code: "APS_GOV_REACT_RULE_MISSING_CONTEXT",
+                    path: basePath,
+                    message: "React-oriented rule should define framework applicability"
+                });
+            }
+            else {
+                warnings.push({
+                    code: "APS_GOV_STRONG_AUTHORITY_CONTEXT_RECOMMENDED",
+                    path: basePath,
+                    message: "Rules and patterns with strong authority should define applicability context"
+                });
+            }
+            continue;
+        }
+        if (authority === "policy" && (0, json_1.isObject)(applicability)) {
+            const layer = applicability.layer;
+            if ((layer === undefined || layer === "") &&
+                applicability.framework === undefined &&
+                applicability.runtime === undefined) {
+                errors.push({
+                    code: "APS_GOV_POLICY_CONTEXT_TOO_GENERIC",
+                    path: basePath,
+                    message: "Policy applicability is too generic; define at least layer/framework/runtime"
+                });
+            }
+        }
+    }
+    return {
+        errors,
+        warnings,
+        counters: {
+            governedFields: 0,
+            fieldsWithEvidence: 0,
+            fieldsWithProvenance: 0
+        }
+    };
+}
+//# sourceMappingURL=applicability-validator.js.map

package/dist/protocol/governance/applicability-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applicability-validator.js","sourceRoot":"","sources":["../../../src/protocol/governance/applicability-validator.ts"],"names":[],"mappings":"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"}

package/dist/protocol/governance/conflict-validator.d.ts

@@ -0,0 +1,2 @@
+import type { GovernanceResource, GovernanceValidatorResult } from "./index";
+export declare function validateConflicts(resources: GovernanceResource[]): GovernanceValidatorResult;

package/dist/protocol/governance/conflict-validator.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConflicts = validateConflicts;
+const json_1 = require("../../shared/json");
+function getConflicts(resource) {
+    if (!(0, json_1.isObject)(resource.metadata)) {
+        return [];
+    }
+    const governance = resource.metadata.governance;
+    if (!(0, json_1.isObject)(governance) || !Array.isArray(governance.conflicts)) {
+        return [];
+    }
+    return governance.conflicts.filter((item) => (0, json_1.isObject)(item));
+}
+function readCandidateIds(conflict) {
+    if (!Array.isArray(conflict.candidates)) {
+        return [];
+    }
+    return conflict.candidates
+        .map((candidate) => ((0, json_1.isObject)(candidate) && typeof candidate.id === "string" ? candidate.id : null))
+        .filter((item) => Boolean(item));
+}
+function validateConflicts(resources) {
+    const errors = [];
+    const warnings = [];
+    for (let index = 0; index < resources.length; index += 1) {
+        const conflicts = getConflicts(resources[index]);
+        for (let conflictIndex = 0; conflictIndex < conflicts.length; conflictIndex += 1) {
+            const conflict = conflicts[conflictIndex];
+            const basePath = `resources[${index}].metadata.governance.conflicts[${conflictIndex}]`;
+            if (typeof conflict.id !== "string" || conflict.id.trim() === "") {
+                errors.push({
+                    code: "APS_GOV_CONFLICT_ID_REQUIRED",
+                    path: `${basePath}.id`,
+                    message: "Conflict id is required"
+                });
+            }
+            if (typeof conflict.fieldPath !== "string" || conflict.fieldPath.trim() === "") {
+                errors.push({
+                    code: "APS_GOV_CONFLICT_FIELD_PATH_REQUIRED",
+                    path: `${basePath}.fieldPath`,
+                    message: "Conflict fieldPath is required"
+                });
+            }
+            const candidateIds = readCandidateIds(conflict);
+            if (candidateIds.length < 2) {
+                errors.push({
+                    code: "APS_GOV_CONFLICT_CANDIDATES_INSUFFICIENT",
+                    path: `${basePath}.candidates`,
+                    message: "Conflict must contain at least two candidates"
+                });
+            }
+            if (typeof conflict.selectedCandidateId !== "string" || conflict.selectedCandidateId.trim() === "") {
+                errors.push({
+                    code: "APS_GOV_CONFLICT_SELECTED_MISSING",
+                    path: `${basePath}.selectedCandidateId`,
+                    message: "Conflict must define selectedCandidateId"
+                });
+            }
+            else if (!candidateIds.includes(conflict.selectedCandidateId)) {
+                errors.push({
+                    code: "APS_GOV_CONFLICT_SELECTED_NOT_FOUND",
+                    path: `${basePath}.selectedCandidateId`,
+                    message: "selectedCandidateId must reference an existing candidate"
+                });
+            }
+            if (!Array.isArray(conflict.rejectedCandidateIds) || conflict.rejectedCandidateIds.length === 0) {
+                errors.push({
+                    code: "APS_GOV_CONFLICT_REJECTED_MISSING",
+                    path: `${basePath}.rejectedCandidateIds`,
+                    message: "Conflict must define rejectedCandidateIds"
+                });
+            }
+            else {
+                for (const rejected of conflict.rejectedCandidateIds) {
+                    if (typeof rejected !== "string" || !candidateIds.includes(rejected)) {
+                        errors.push({
+                            code: "APS_GOV_CONFLICT_REJECTED_NOT_FOUND",
+                            path: `${basePath}.rejectedCandidateIds`,
+                            message: "All rejectedCandidateIds must reference existing candidates"
+                        });
+                        break;
+                    }
+                    if (rejected === conflict.selectedCandidateId) {
+                        errors.push({
+                            code: "APS_GOV_CONFLICT_SELECTED_REJECTED_COLLISION",
+                            path: `${basePath}.rejectedCandidateIds`,
+                            message: "selectedCandidateId cannot appear in rejectedCandidateIds"
+                        });
+                        break;
+                    }
+                }
+            }
+            if (typeof conflict.explanation !== "string" || conflict.explanation.trim() === "") {
+                errors.push({
+                    code: "APS_GOV_CONFLICT_EXPLANATION_REQUIRED",
+                    path: `${basePath}.explanation`,
+                    message: "Conflict resolution requires explanation"
+                });
+            }
+            const rejectedCandidateIds = Array.isArray(conflict.rejectedCandidateIds)
+                ? conflict.rejectedCandidateIds
+                : [];
+            if (rejectedCandidateIds.length > 0 &&
+                typeof conflict.selectedCandidateId === "string" &&
+                candidateIds.length > 0) {
+                const unresolved = candidateIds.filter((candidateId) => candidateId !== conflict.selectedCandidateId &&
+                    !rejectedCandidateIds.includes(candidateId));
+                if (unresolved.length > 0) {
+                    warnings.push({
+                        code: "APS_GOV_CONFLICT_UNRESOLVED_CANDIDATES",
+                        path: basePath,
+                        message: `Conflict has candidates without explicit disposition: ${unresolved.join(", ")}`
+                    });
+                }
+            }
+        }
+    }
+    return {
+        errors,
+        warnings,
+        counters: {
+            governedFields: 0,
+            fieldsWithEvidence: 0,
+            fieldsWithProvenance: 0
+        }
+    };
+}
+//# sourceMappingURL=conflict-validator.js.map

package/dist/protocol/governance/conflict-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-validator.js","sourceRoot":"","sources":["../../../src/protocol/governance/conflict-validator.ts"],"names":[],"mappings":";;AA+BA,8CAyHC;AAxJD,4CAA6C;AAQ7C,SAAS,YAAY,CAAC,QAA4B;IAChD,IAAI,CAAC,IAAA,eAAQ,EAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;IAChD,IAAI,CAAC,IAAA,eAAQ,EAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAA8B,EAAE,CAAC,IAAA,eAAQ,EAAC,IAAI,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,gBAAgB,CAAC,QAA4B;IACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC,UAAU;SACvB,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAA,eAAQ,EAAC,SAAS,CAAC,IAAI,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACnG,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,iBAAiB,CAAC,SAA+B;IAC/D,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IAEvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACzD,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAEjD,KAAK,IAAI,aAAa,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,aAAa,IAAI,CAAC,EAAE,CAAC;YACjF,MAAM,QAAQ,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;YAC1C,MAAM,QAAQ,GAAG,aAAa,KAAK,mCAAmC,aAAa,GAAG,CAAC;YAEvF,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACjE,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,8BAA8B;oBACpC,IAAI,EAAE,GAAG,QAAQ,KAAK;oBACtB,OAAO,EAAE,yBAAyB;iBACnC,CAAC,CAAC;YACL,CAAC;YAED,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC/E,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,sCAAsC;oBAC5C,IAAI,EAAE,GAAG,QAAQ,YAAY;oBAC7B,OAAO,EAAE,gCAAgC;iBAC1C,CAAC,CAAC;YACL,CAAC;YAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAChD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,0CAA0C;oBAChD,IAAI,EAAE,GAAG,QAAQ,aAAa;oBAC9B,OAAO,EAAE,+CAA+C;iBACzD,CAAC,CAAC;YACL,CAAC;YAED,IAAI,OAAO,QAAQ,CAAC,mBAAmB,KAAK,QAAQ,IAAI,QAAQ,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACnG,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,mCAAmC;oBACzC,IAAI,EAAE,GAAG,QAAQ,sBAAsB;oBACvC,OAAO,EAAE,0CAA0C;iBACpD,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBAChE,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,qCAAqC;oBAC3C,IAAI,EAAE,GAAG,QAAQ,sBAAsB;oBACvC,OAAO,EAAE,0DAA0D;iBACpE,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,QAAQ,CAAC,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChG,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,mCAAmC;oBACzC,IAAI,EAAE,GAAG,QAAQ,uBAAuB;oBACxC,OAAO,EAAE,2CAA2C;iBACrD,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,oBAAoB,EAAE,CAAC;oBACrD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACrE,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI,EAAE,qCAAqC;4BAC3C,IAAI,EAAE,GAAG,QAAQ,uBAAuB;4BACxC,OAAO,EAAE,6DAA6D;yBACvE,CAAC,CAAC;wBACH,MAAM;oBACR,CAAC;oBAED,IAAI,QAAQ,KAAK,QAAQ,CAAC,mBAAmB,EAAE,CAAC;wBAC9C,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI,EAAE,8CAA8C;4BACpD,IAAI,EAAE,GAAG,QAAQ,uBAAuB;4BACxC,OAAO,EAAE,2DAA2D;yBACrE,CAAC,CAAC;wBACH,MAAM;oBACR,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACnF,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,uCAAuC;oBAC7C,IAAI,EAAE,GAAG,QAAQ,cAAc;oBAC/B,OAAO,EAAE,0CAA0C;iBACpD,CAAC,CAAC;YACL,CAAC;YAED,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBACvE,CAAC,CAAC,QAAQ,CAAC,oBAAoB;gBAC/B,CAAC,CAAC,EAAE,CAAC;YAEP,IACE,oBAAoB,CAAC,MAAM,GAAG,CAAC;gBAC/B,OAAO,QAAQ,CAAC,mBAAmB,KAAK,QAAQ;gBAChD,YAAY,CAAC,MAAM,GAAG,CAAC,EACvB,CAAC;gBACD,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CACpC,CAAC,WAAW,EAAE,EAAE,CACd,WAAW,KAAK,QAAQ,CAAC,mBAAmB;oBAC5C,CAAC,oBAAoB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC9C,CAAC;gBAEF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,wCAAwC;wBAC9C,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,yDAAyD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAE,EAAE;qBAC3F,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM;QACN,QAAQ;QACR,QAAQ,EAAE;YACR,cAAc,EAAE,CAAC;YACjB,kBAAkB,EAAE,CAAC;YACrB,oBAAoB,EAAE,CAAC;SACxB;KACF,CAAC;AACJ,CAAC"}

package/dist/protocol/governance/evidence-validator.d.ts

@@ -0,0 +1,2 @@
+import type { GovernanceResource, GovernanceValidatorResult } from "./index";
+export declare function validateEvidence(resources: GovernanceResource[]): GovernanceValidatorResult;

package/dist/protocol/governance/evidence-validator.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEvidence = validateEvidence;
+const json_1 = require("../../shared/json");
+function getGovernance(resource) {
+    if (!(0, json_1.isObject)(resource.metadata)) {
+        return {};
+    }
+    const governance = resource.metadata.governance;
+    return (0, json_1.isObject)(governance) ? governance : {};
+}
+function getConflicts(resource) {
+    const governance = getGovernance(resource);
+    if (!Array.isArray(governance.conflicts)) {
+        return [];
+    }
+    return governance.conflicts.filter((item) => (0, json_1.isObject)(item));
+}
+function validateEvidence(resources) {
+    const errors = [];
+    const warnings = [];
+    let governedFields = 0;
+    let fieldsWithEvidence = 0;
+    let fieldsWithProvenance = 0;
+    for (let index = 0; index < resources.length; index += 1) {
+        const resource = resources[index];
+        const governance = getGovernance(resource);
+        const conflicts = getConflicts(resource);
+        const knownConflictIds = new Set(conflicts
+            .map((item) => (typeof item.id === "string" ? item.id : null))
+            .filter((item) => Boolean(item)));
+        if (!(0, json_1.isObject)(governance.fields)) {
+            continue;
+        }
+        for (const [fieldName, fieldConfig] of Object.entries(governance.fields)) {
+            if (!(0, json_1.isObject)(fieldConfig)) {
+                continue;
+            }
+            governedFields += 1;
+            const basePath = `resources[${index}].metadata.governance.fields.${fieldName}`;
+            const evidence = Array.isArray(fieldConfig.evidence)
+                ? fieldConfig.evidence.filter((item) => (0, json_1.isObject)(item))
+                : [];
+            if (evidence.length > 0) {
+                fieldsWithEvidence += 1;
+            }
+            else {
+                errors.push({
+                    code: "APS_GOV_TRACEABLE_EVIDENCE_REQUIRED",
+                    path: basePath,
+                    message: "Every governed field must define traceable evidence"
+                });
+            }
+            const evidenceIds = new Set(evidence
+                .map((item) => (typeof item.evidenceId === "string" ? item.evidenceId : null))
+                .filter((item) => Boolean(item)));
+            const selectedEvidenceId = typeof fieldConfig.selectedEvidenceId === "string" ? fieldConfig.selectedEvidenceId : null;
+            if (selectedEvidenceId) {
+                if (evidenceIds.size === 0 || !evidenceIds.has(selectedEvidenceId)) {
+                    errors.push({
+                        code: "APS_GOV_SELECTED_EVIDENCE_NOT_FOUND",
+                        path: `${basePath}.selectedEvidenceId`,
+                        message: "selectedEvidenceId must reference an existing evidence entry"
+                    });
+                }
+                else {
+                    fieldsWithProvenance += 1;
+                }
+            }
+            const conflictId = typeof fieldConfig.conflictId === "string" ? fieldConfig.conflictId : null;
+            if (conflictId && !knownConflictIds.has(conflictId)) {
+                errors.push({
+                    code: "APS_GOV_CONFLICT_REFERENCE_MISSING",
+                    path: `${basePath}.conflictId`,
+                    message: "conflictId must reference an existing governance conflict"
+                });
+            }
+            if (!conflictId && evidence.length > 1) {
+                warnings.push({
+                    code: "APS_GOV_MULTIPLE_EVIDENCE_NO_CONFLICT",
+                    path: basePath,
+                    message: "Multiple evidence entries found without explicit conflict linkage"
+                });
+            }
+        }
+    }
+    return {
+        errors,
+        warnings,
+        counters: {
+            governedFields,
+            fieldsWithEvidence,
+            fieldsWithProvenance
+        }
+    };
+}
+//# sourceMappingURL=evidence-validator.js.map

package/dist/protocol/governance/evidence-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-validator.js","sourceRoot":"","sources":["../../../src/protocol/governance/evidence-validator.ts"],"names":[],"mappings":"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"}

package/dist/protocol/governance/identity-validator.d.ts

@@ -0,0 +1,2 @@
+import type { GovernanceResource, GovernanceValidatorResult } from "./index";
+export declare function validateIdentity(resources: GovernanceResource[], manifest: Record<string, unknown>): GovernanceValidatorResult;

package/dist/protocol/governance/identity-validator.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateIdentity = validateIdentity;
+const json_1 = require("../../shared/json");
+const RESOURCE_ID_PATTERN = /^[a-z0-9]+(?:\.[a-z0-9]+){3,}$/;
+function getRetiredIds(manifest) {
+    const metadata = manifest.metadata;
+    if (!(0, json_1.isObject)(metadata)) {
+        return new Set();
+    }
+    const governance = metadata.governance;
+    if (!(0, json_1.isObject)(governance) || !Array.isArray(governance.retiredResourceIds)) {
+        return new Set();
+    }
+    return new Set(governance.retiredResourceIds.filter((item) => typeof item === "string" && item.trim() !== ""));
+}
+function validateIdentity(resources, manifest) {
+    const errors = [];
+    const warnings = [];
+    const seenIds = new Map();
+    const retiredIds = getRetiredIds(manifest);
+    for (let index = 0; index < resources.length; index += 1) {
+        const resource = resources[index];
+        const basePath = `resources[${index}].id`;
+        if (typeof resource.id !== "string" || resource.id.trim() === "") {
+            warnings.push({
+                code: "APS_GOV_RESOURCE_ID_RECOMMENDED",
+                path: basePath,
+                message: "Resource id is strongly recommended for governance"
+            });
+            continue;
+        }
+        const id = resource.id.trim();
+        if (!RESOURCE_ID_PATTERN.test(id)) {
+            errors.push({
+                code: "APS_GOV_INVALID_RESOURCE_ID_FORMAT",
+                path: basePath,
+                message: "Resource id must match org.domain.resourceType.resourceName in lowercase"
+            });
+            continue;
+        }
+        const segments = id.split(".");
+        if (segments.length >= 3 && typeof resource.type === "string" && segments[2] !== resource.type) {
+            warnings.push({
+                code: "APS_GOV_RESOURCE_ID_TYPE_MISMATCH",
+                path: basePath,
+                message: `Resource id type segment '${segments[2]}' does not match resource.type '${resource.type}'`
+            });
+        }
+        if (seenIds.has(id)) {
+            const firstIndex = seenIds.get(id) ?? 0;
+            errors.push({
+                code: "APS_GOV_DUPLICATE_RESOURCE_ID",
+                path: basePath,
+                message: `Duplicate resource id also found at resources[${firstIndex}]`
+            });
+        }
+        else {
+            seenIds.set(id, index);
+        }
+        if (retiredIds.has(id)) {
+            errors.push({
+                code: "APS_GOV_RECYCLED_RESOURCE_ID",
+                path: basePath,
+                message: "Resource id is recycled from retiredResourceIds"
+            });
+        }
+    }
+    return {
+        errors,
+        warnings,
+        counters: {
+            governedFields: 0,
+            fieldsWithEvidence: 0,
+            fieldsWithProvenance: 0
+        }
+    };
+}
+//# sourceMappingURL=identity-validator.js.map

package/dist/protocol/governance/identity-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-validator.js","sourceRoot":"","sources":["../../../src/protocol/governance/identity-validator.ts"],"names":[],"mappings":"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"}