@mimir-labs/core 0.1.0

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

@@ -0,0 +1,79 @@
+import type { ApsManifest, ApsResourceType } from "../manifest";
+export type KnowledgeSourceType = "typescript" | "storybook" | "readme" | "human" | "static-analysis" | "architecture-policy" | "external";
+export type KnowledgeConfidence = "low" | "medium" | "high";
+export type KnowledgeAuthority = "advisory" | "required" | "policy";
+export type GovernanceApplicability = {
+    framework?: string | string[];
+    language?: string | string[];
+    runtime?: string | string[];
+    platform?: string | string[];
+    layer?: string | string[];
+    boundedContext?: string | string[];
+    [key: string]: unknown;
+};
+export type GovernanceEvidence = {
+    evidenceId?: string;
+    sourceType: KnowledgeSourceType;
+    sourceRef: string;
+    extractedAt: string;
+    confidence: KnowledgeConfidence;
+    authority: KnowledgeAuthority;
+    scope?: string;
+    sourceVersion?: string;
+    freshnessTtlDays?: number;
+    applicability?: GovernanceApplicability;
+    extractor?: string;
+    [key: string]: unknown;
+};
+export type GovernanceConflict = {
+    id?: string;
+    fieldPath?: string;
+    candidates?: Array<Record<string, unknown>>;
+    selectedCandidateId?: string;
+    rejectedCandidateIds?: string[];
+    explanation?: string;
+    [key: string]: unknown;
+};
+export type GovernanceResource = {
+    type?: ApsResourceType | string;
+    id?: string;
+    name?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    deprecated?: unknown;
+    deprecationReason?: unknown;
+    replacementResourceIds?: unknown;
+    migrationIds?: unknown;
+    lifecycleState?: unknown;
+    [key: string]: unknown;
+};
+export type GovernanceIssue = {
+    code: string;
+    path: string;
+    message: string;
+};
+export type GovernanceCounters = {
+    governedFields: number;
+    fieldsWithEvidence: number;
+    fieldsWithProvenance: number;
+};
+export type GovernanceValidatorResult = {
+    errors: GovernanceIssue[];
+    warnings: GovernanceIssue[];
+    counters: GovernanceCounters;
+};
+export type GovernanceValidationResult = {
+    valid: boolean;
+    errors: GovernanceIssue[];
+    warnings: GovernanceIssue[];
+    metrics: {
+        resourcesChecked: number;
+        evidenceCoverage: number;
+        provenanceCoverage: number;
+    };
+};
+export declare function collectGovernanceResources(manifest: ApsManifest): {
+    resources: GovernanceResource[];
+    warnings: GovernanceIssue[];
+};
+export declare function validateGovernance(manifest: ApsManifest): GovernanceValidationResult;

package/dist/protocol/governance/index.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectGovernanceResources = collectGovernanceResources;
+exports.validateGovernance = validateGovernance;
+const json_1 = require("../../shared/json");
+const applicability_validator_1 = require("./applicability-validator");
+const conflict_validator_1 = require("./conflict-validator");
+const evidence_validator_1 = require("./evidence-validator");
+const identity_validator_1 = require("./identity-validator");
+const lifecycle_validator_1 = require("./lifecycle-validator");
+const provenance_validator_1 = require("./provenance-validator");
+const LEGACY_SECTION_TYPES = [
+    { key: "components", type: "component" },
+    { key: "apis", type: "api" },
+    { key: "services", type: "service" },
+    { key: "models", type: "model" },
+    { key: "events", type: "event" },
+    { key: "patterns", type: "pattern" },
+    { key: "rules", type: "rule" },
+    { key: "migrations", type: "migration" },
+    { key: "examples", type: "example" }
+];
+function toPercentage(numerator, denominator) {
+    if (denominator === 0) {
+        return 0;
+    }
+    return Number(((numerator / denominator) * 100).toFixed(2));
+}
+function normalizeResourceEntry(entry, fallbackType, warnings, path) {
+    if (typeof entry === "string") {
+        return {
+            type: fallbackType,
+            name: entry
+        };
+    }
+    if (!(0, json_1.isObject)(entry)) {
+        warnings.push({
+            code: "APS_GOV_RESOURCE_ENTRY_SKIPPED",
+            path,
+            message: "Resource entry is not an object or string and was skipped"
+        });
+        return null;
+    }
+    return {
+        ...entry,
+        type: typeof entry.type === "string" ? entry.type : fallbackType
+    };
+}
+function collectGovernanceResources(manifest) {
+    const resources = [];
+    const warnings = [];
+    if (Array.isArray(manifest.resources)) {
+        for (let index = 0; index < manifest.resources.length; index += 1) {
+            const entry = manifest.resources[index];
+            if ((0, json_1.isObject)(entry)) {
+                resources.push(entry);
+            }
+            else {
+                warnings.push({
+                    code: "APS_GOV_RESOURCE_ENTRY_SKIPPED",
+                    path: `manifest.resources[${index}]`,
+                    message: "resources entry is not an object and was skipped"
+                });
+            }
+        }
+    }
+    for (const section of LEGACY_SECTION_TYPES) {
+        const value = manifest[section.key];
+        if (!Array.isArray(value)) {
+            continue;
+        }
+        for (let index = 0; index < value.length; index += 1) {
+            const normalized = normalizeResourceEntry(value[index], section.type, warnings, `manifest.${section.key}[${index}]`);
+            if (normalized) {
+                resources.push(normalized);
+            }
+        }
+    }
+    return { resources, warnings };
+}
+function mergeValidatorResults(results) {
+    return {
+        errors: results.flatMap((result) => result.errors),
+        warnings: results.flatMap((result) => result.warnings),
+        counters: {
+            governedFields: results.reduce((acc, result) => acc + result.counters.governedFields, 0),
+            fieldsWithEvidence: results.reduce((acc, result) => acc + result.counters.fieldsWithEvidence, 0),
+            fieldsWithProvenance: results.reduce((acc, result) => acc + result.counters.fieldsWithProvenance, 0)
+        }
+    };
+}
+function validateGovernance(manifest) {
+    const collected = collectGovernanceResources(manifest);
+    const validators = [
+        (0, provenance_validator_1.validateProvenance)(collected.resources),
+        (0, evidence_validator_1.validateEvidence)(collected.resources),
+        (0, lifecycle_validator_1.validateLifecycle)(collected.resources),
+        (0, applicability_validator_1.validateApplicability)(collected.resources),
+        (0, identity_validator_1.validateIdentity)(collected.resources, manifest),
+        (0, conflict_validator_1.validateConflicts)(collected.resources)
+    ];
+    const merged = mergeValidatorResults(validators);
+    const allWarnings = [...collected.warnings, ...merged.warnings];
+    return {
+        valid: merged.errors.length === 0,
+        errors: merged.errors,
+        warnings: allWarnings,
+        metrics: {
+            resourcesChecked: collected.resources.length,
+            evidenceCoverage: toPercentage(merged.counters.fieldsWithEvidence, merged.counters.governedFields),
+            provenanceCoverage: toPercentage(merged.counters.fieldsWithProvenance, merged.counters.governedFields)
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

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

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

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

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

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

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateLifecycle = validateLifecycle;
+const json_1 = require("../../shared/json");
+function hasText(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function hasNonEmptyStringArray(value) {
+    return Array.isArray(value) && value.some((item) => hasText(item));
+}
+function getDeprecationReason(resource) {
+    if (hasText(resource.deprecationReason)) {
+        return resource.deprecationReason;
+    }
+    if ((0, json_1.isObject)(resource.deprecated) && hasText(resource.deprecated.reason)) {
+        return resource.deprecated.reason;
+    }
+    return null;
+}
+function hasReplacementOrMigration(resource) {
+    if (hasNonEmptyStringArray(resource.replacementResourceIds)) {
+        return true;
+    }
+    if (hasNonEmptyStringArray(resource.migrationIds)) {
+        return true;
+    }
+    if ((0, json_1.isObject)(resource.deprecated)) {
+        if (Array.isArray(resource.deprecated.replacement) && resource.deprecated.replacement.length > 0) {
+            return true;
+        }
+        if (hasNonEmptyStringArray(resource.deprecated.migrationIds)) {
+            return true;
+        }
+    }
+    return false;
+}
+function validateLifecycle(resources) {
+    const errors = [];
+    const warnings = [];
+    for (let index = 0; index < resources.length; index += 1) {
+        const resource = resources[index];
+        const lifecycleState = hasText(resource.lifecycleState)
+            ? resource.lifecycleState
+            : null;
+        const deprecated = resource.deprecated === true || lifecycleState === "deprecated";
+        const removed = lifecycleState === "removed";
+        if (deprecated) {
+            const basePath = `resources[${index}]`;
+            const reason = getDeprecationReason(resource);
+            if (!reason) {
+                errors.push({
+                    code: "APS_GOV_DEPRECATION_REASON_REQUIRED",
+                    path: `${basePath}.deprecationReason`,
+                    message: "Deprecated resources must declare deprecationReason"
+                });
+            }
+            if (!hasReplacementOrMigration(resource)) {
+                errors.push({
+                    code: "APS_GOV_DEPRECATION_SUCCESSOR_REQUIRED",
+                    path: basePath,
+                    message: "Deprecated resources must define replacementResourceIds or migrationIds"
+                });
+            }
+        }
+        if (removed) {
+            const basePath = `resources[${index}]`;
+            if (!hasReplacementOrMigration(resource) && !getDeprecationReason(resource)) {
+                errors.push({
+                    code: "APS_GOV_REMOVED_HISTORY_REQUIRED",
+                    path: basePath,
+                    message: "Removed resources must preserve historical references (replacement/migration/reason)"
+                });
+            }
+            if (!hasText(resource.id)) {
+                warnings.push({
+                    code: "APS_GOV_REMOVED_ID_RECOMMENDED",
+                    path: `${basePath}.id`,
+                    message: "Removed resources should keep stable id for historical traceability"
+                });
+            }
+        }
+    }
+    return {
+        errors,
+        warnings,
+        counters: {
+            governedFields: 0,
+            fieldsWithEvidence: 0,
+            fieldsWithProvenance: 0
+        }
+    };
+}
+//# sourceMappingURL=lifecycle-validator.js.map

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

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

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

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

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

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateProvenance = validateProvenance;
+const json_1 = require("../../shared/json");
+const VALID_SOURCE_TYPES = new Set([
+    "typescript",
+    "storybook",
+    "readme",
+    "human",
+    "static-analysis",
+    "architecture-policy",
+    "external"
+]);
+const VALID_CONFIDENCE = new Set(["low", "medium", "high"]);
+const VALID_AUTHORITY = new Set(["advisory", "required", "policy"]);
+function getGovernance(resource) {
+    if (!(0, json_1.isObject)(resource.metadata)) {
+        return {};
+    }
+    const governance = resource.metadata.governance;
+    return (0, json_1.isObject)(governance) ? governance : {};
+}
+function getGovernedFields(resource) {
+    const governance = getGovernance(resource);
+    const fields = governance.fields;
+    if (!(0, json_1.isObject)(fields)) {
+        return [];
+    }
+    const governedFields = [];
+    for (const [fieldName, fieldValue] of Object.entries(fields)) {
+        if ((0, json_1.isObject)(fieldValue)) {
+            governedFields.push([fieldName, fieldValue]);
+        }
+    }
+    return governedFields;
+}
+function readEvidence(fieldConfig) {
+    if (!Array.isArray(fieldConfig.evidence)) {
+        return [];
+    }
+    return fieldConfig.evidence.filter((item) => (0, json_1.isObject)(item));
+}
+function validateEvidenceShape(evidence, path, errors, warnings) {
+    let valid = true;
+    if (typeof evidence.sourceType !== "string" || !VALID_SOURCE_TYPES.has(evidence.sourceType)) {
+        errors.push({
+            code: "APS_GOV_INVALID_SOURCE_TYPE",
+            path,
+            message: "Evidence.sourceType is required and must be a valid source type"
+        });
+        valid = false;
+    }
+    if (typeof evidence.sourceRef !== "string" || evidence.sourceRef.trim() === "") {
+        errors.push({
+            code: "APS_GOV_INVALID_SOURCE_REF",
+            path,
+            message: "Evidence.sourceRef is required and must be a non-empty string"
+        });
+        valid = false;
+    }
+    if (typeof evidence.extractedAt !== "string" || Number.isNaN(Date.parse(evidence.extractedAt))) {
+        errors.push({
+            code: "APS_GOV_INVALID_EXTRACTED_AT",
+            path,
+            message: "Evidence.extractedAt is required and must be an ISO date string"
+        });
+        valid = false;
+    }
+    if (typeof evidence.confidence !== "string" || !VALID_CONFIDENCE.has(evidence.confidence)) {
+        errors.push({
+            code: "APS_GOV_INVALID_CONFIDENCE",
+            path,
+            message: "Evidence.confidence is required and must be low|medium|high"
+        });
+        valid = false;
+    }
+    if (typeof evidence.authority !== "string" || !VALID_AUTHORITY.has(evidence.authority)) {
+        errors.push({
+            code: "APS_GOV_INVALID_AUTHORITY",
+            path,
+            message: "Evidence.authority is required and must be advisory|required|policy"
+        });
+        valid = false;
+    }
+    if (evidence.authority === "policy") {
+        if (evidence.sourceType !== "architecture-policy" && evidence.sourceType !== "human") {
+            errors.push({
+                code: "APS_GOV_POLICY_SOURCE_INVALID",
+                path,
+                message: "Policy evidence must come from architecture-policy or human sources"
+            });
+            valid = false;
+        }
+        if (!(0, json_1.isObject)(evidence.applicability)) {
+            errors.push({
+                code: "APS_GOV_POLICY_APPLICABILITY_REQUIRED",
+                path,
+                message: "Policy evidence requires applicability context"
+            });
+            valid = false;
+        }
+    }
+    if (evidence.authority === "required") {
+        if (typeof evidence.scope !== "string" || evidence.scope.trim() === "") {
+            errors.push({
+                code: "APS_GOV_REQUIRED_SCOPE_MISSING",
+                path,
+                message: "Required evidence must define scope"
+            });
+            valid = false;
+        }
+    }
+    if (evidence.authority === "advisory" && evidence.confidence === "low") {
+        warnings.push({
+            code: "APS_GOV_LOW_CONFIDENCE_ADVISORY",
+            path,
+            message: "Advisory evidence with low confidence is acceptable but weak"
+        });
+    }
+    return valid;
+}
+function validateProvenance(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 fields = getGovernedFields(resource);
+        for (const [fieldName, fieldConfig] of fields) {
+            governedFields += 1;
+            const basePath = `resources[${index}].metadata.governance.fields.${fieldName}`;
+            const evidenceList = readEvidence(fieldConfig);
+            const fieldAuthority = typeof fieldConfig.authority === "string" ? fieldConfig.authority : "advisory";
+            if (evidenceList.length > 0) {
+                fieldsWithEvidence += 1;
+            }
+            if ((fieldAuthority === "policy" || fieldAuthority === "required") && evidenceList.length === 0) {
+                errors.push({
+                    code: "APS_GOV_EVIDENCE_REQUIRED",
+                    path: basePath,
+                    message: `Field authority '${fieldAuthority}' requires evidence`
+                });
+            }
+            let hasValidProvenance = false;
+            for (let evidenceIndex = 0; evidenceIndex < evidenceList.length; evidenceIndex += 1) {
+                const evidence = evidenceList[evidenceIndex];
+                const evidencePath = `${basePath}.evidence[${evidenceIndex}]`;
+                const valid = validateEvidenceShape(evidence, evidencePath, errors, warnings);
+                if (valid) {
+                    hasValidProvenance = true;
+                }
+            }
+            if (hasValidProvenance) {
+                fieldsWithProvenance += 1;
+            }
+        }
+    }
+    return {
+        errors,
+        warnings,
+        counters: {
+            governedFields,
+            fieldsWithEvidence,
+            fieldsWithProvenance
+        }
+    };
+}
+//# sourceMappingURL=provenance-validator.js.map

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

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

package/dist/protocol/manifest/api-resource.d.ts

@@ -0,0 +1,26 @@
+import type { ApsResourceReference, ApsRuleBinding } from "./common";
+import type { ApsResource } from "./resource";
+export interface ApsApiParameter {
+    name: string;
+    location?: "path" | "query" | "header" | "cookie" | "body" | string;
+    type?: string;
+    required?: boolean;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface ApsApiResource extends ApsResource {
+    type: "api";
+    name: string;
+    protocol?: "http" | "grpc" | "graphql" | "websocket" | string;
+    method?: string;
+    path?: string;
+    operationId?: string;
+    request?: Record<string, unknown>;
+    response?: Record<string, unknown>;
+    auth?: Record<string, unknown>;
+    parameters?: ApsApiParameter[];
+    errors?: Array<Record<string, unknown>>;
+    rules?: ApsRuleBinding[];
+    examples?: ApsResourceReference[];
+    [key: string]: unknown;
+}

package/dist/protocol/manifest/api-resource.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api-resource.js.map

package/dist/protocol/manifest/api-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-resource.js","sourceRoot":"","sources":["../../../src/protocol/manifest/api-resource.ts"],"names":[],"mappings":""}

package/dist/protocol/manifest/common.d.ts

@@ -0,0 +1,44 @@
+export type ApsStringMap = Record<string, string>;
+export type ApsSeverity = "error" | "warning" | "info" | "hint" | string;
+export type ApsScope = "resource" | "package" | "project" | "workspace" | "global" | string;
+export interface ApsResourceReference {
+    id?: string;
+    name?: string;
+    type?: string;
+    package?: string;
+    import?: string;
+    path?: string;
+    [key: string]: unknown;
+}
+export interface ApsVersionConstraint {
+    minVersion?: string;
+    maxVersion?: string;
+    range?: string;
+    since?: string;
+    until?: string;
+    [key: string]: unknown;
+}
+export interface ApsDeprecation {
+    deprecated: boolean;
+    since?: string;
+    replacement?: ApsResourceReference[];
+    reason?: string;
+    removeIn?: string;
+    migrationIds?: string[];
+    [key: string]: unknown;
+}
+export interface ApsRuleBinding {
+    id?: string;
+    name?: string;
+    severity?: ApsSeverity;
+    [key: string]: unknown;
+}
+export interface ApsInlineExample {
+    title?: string;
+    description?: string;
+    language?: string;
+    imports?: string[];
+    code?: string;
+    explanation?: string;
+    [key: string]: unknown;
+}

package/dist/protocol/manifest/common.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=common.js.map

package/dist/protocol/manifest/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/protocol/manifest/common.ts"],"names":[],"mappings":""}

package/dist/protocol/manifest/component-resource.d.ts

@@ -0,0 +1,48 @@
+import type { ApsDeprecation, ApsInlineExample, ApsResourceReference, ApsRuleBinding, ApsVersionConstraint } from "./common";
+import type { ApsResource } from "./resource";
+export interface ApsComponentProp {
+    name: string;
+    type?: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    values?: unknown[];
+    [key: string]: unknown;
+}
+export interface ApsComponentVariant {
+    name: string;
+    description?: string;
+    conditions?: string[];
+    [key: string]: unknown;
+}
+export interface ApsComponentState {
+    name: string;
+    description?: string;
+    transitions?: string[];
+    [key: string]: unknown;
+}
+export interface ApsComponentResource extends ApsResource {
+    type: "component";
+    name: string;
+    package?: string;
+    import?: string;
+    importLocation?: string;
+    category?: string;
+    intendedUsage?: string | string[];
+    whenToUse?: string[];
+    whenNotToUse?: string[];
+    alternatives?: ApsResourceReference[];
+    relatedResources?: ApsResourceReference[];
+    props?: ApsComponentProp[];
+    variants?: ApsComponentVariant[];
+    states?: ApsComponentState[];
+    rules?: ApsRuleBinding[];
+    examples?: ApsResourceReference[];
+    antiExamples?: ApsInlineExample[];
+    deprecated?: boolean | ApsDeprecation;
+    migrations?: string[];
+    versionConstraints?: ApsVersionConstraint;
+    aliases?: string[];
+    tags?: string[];
+    [key: string]: unknown;
+}

package/dist/protocol/manifest/component-resource.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=component-resource.js.map

package/dist/protocol/manifest/component-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-resource.js","sourceRoot":"","sources":["../../../src/protocol/manifest/component-resource.ts"],"names":[],"mappings":""}

package/dist/protocol/manifest/event-resource.d.ts

@@ -0,0 +1,16 @@
+import type { ApsResourceReference, ApsRuleBinding } from "./common";
+import type { ApsResource } from "./resource";
+export interface ApsEventResource extends ApsResource {
+    type: "event";
+    name: string;
+    topic?: string;
+    publisher?: string;
+    consumers?: string[];
+    payloadSchema?: Record<string, unknown>;
+    deliverySemantics?: "at-most-once" | "at-least-once" | "exactly-once" | string;
+    ordering?: "unordered" | "partitioned" | "global" | string;
+    relatedResources?: ApsResourceReference[];
+    rules?: ApsRuleBinding[];
+    examples?: ApsResourceReference[];
+    [key: string]: unknown;
+}

package/dist/protocol/manifest/event-resource.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=event-resource.js.map

package/dist/protocol/manifest/event-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-resource.js","sourceRoot":"","sources":["../../../src/protocol/manifest/event-resource.ts"],"names":[],"mappings":""}