@mimir-labs/core 0.2.0 → 0.4.0

package/README.md

@@ -4,7 +4,8 @@ Core business logic and reusable services for the Mimir CLI.
 
 Public workflows include discovery, authoring, generation, validation,
 governance, context generation, synchronization, initialization, and doctor
-assessment. Human authoring sources live under `aps/knowledge`; generated APS
-artifacts remain under `dist/aps`.
+assessment. Author Knowledge sources live in versioned `*.mimir.yaml`
+descriptors maintained by `mimir author`; generated APS artifacts remain under
+`dist/aps`.
 
 See extension guidance in [EXTENSIONS.md](./EXTENSIONS.md).

package/dist/implementation/authoring/knowledge-loader.d.ts

@@ -0,0 +1,10 @@
+export type HumanKnowledge = {
+    description: string;
+    whenToUse: string[];
+    whenNotToUse: string[];
+};
+export type AuthoredKnowledge = {
+    knowledge: HumanKnowledge;
+    sourceRef: string;
+};
+export declare function loadComponentKnowledge(cwd: string, resourceId: string): Promise<AuthoredKnowledge | null>;

package/dist/implementation/authoring/knowledge-loader.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadComponentKnowledge = loadComponentKnowledge;
+const node_path_1 = __importDefault(require("node:path"));
+const yaml_1 = require("yaml");
+const fs_1 = require("../io/fs");
+const json_1 = require("../io/json");
+function readStringArray(value, field, sourceRef) {
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+        throw new Error(`${sourceRef}: '${field}' must be an array of strings`);
+    }
+    return value;
+}
+async function loadComponentKnowledge(cwd, resourceId) {
+    const sourceRef = `aps/knowledge/components/${resourceId}.yaml`;
+    const filePath = node_path_1.default.join(cwd, "aps", "knowledge", "components", `${resourceId}.yaml`);
+    if (!(await (0, fs_1.fileExists)(filePath))) {
+        return null;
+    }
+    let value;
+    try {
+        value = (0, yaml_1.parse)(await (0, fs_1.readText)(filePath));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid author knowledge at ${sourceRef}: ${message}`);
+    }
+    if (!(0, json_1.isObject)(value)) {
+        throw new Error(`${sourceRef}: author knowledge must be a YAML object`);
+    }
+    if (typeof value.description !== "string") {
+        throw new Error(`${sourceRef}: 'description' must be a string`);
+    }
+    return {
+        knowledge: {
+            description: value.description,
+            whenToUse: readStringArray(value.whenToUse, "whenToUse", sourceRef),
+            whenNotToUse: readStringArray(value.whenNotToUse, "whenNotToUse", sourceRef)
+        },
+        sourceRef
+    };
+}
+//# sourceMappingURL=knowledge-loader.js.map

package/dist/implementation/authoring/knowledge-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-loader.js","sourceRoot":"","sources":["../../../src/implementation/authoring/knowledge-loader.ts"],"names":[],"mappings":";;;;;AAwBA,wDAmCC;AA3DD,0DAA6B;AAC7B,+BAA6B;AAC7B,iCAAgD;AAChD,qCAAsC;AAatC,SAAS,eAAe,CAAC,KAAc,EAAE,KAAa,EAAE,SAAiB;IACvE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,MAAM,KAAK,+BAA+B,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,KAAiB,CAAC;AAC3B,CAAC;AAEM,KAAK,UAAU,sBAAsB,CAC1C,GAAW,EACX,UAAkB;IAElB,MAAM,SAAS,GAAG,4BAA4B,UAAU,OAAO,CAAC;IAChE,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,UAAU,OAAO,CAAC,CAAC;IAExF,IAAI,CAAC,CAAC,MAAM,IAAA,eAAU,EAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAA,YAAK,EAAC,MAAM,IAAA,aAAQ,EAAC,QAAQ,CAAC,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC,IAAA,eAAQ,EAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,0CAA0C,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,kCAAkC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO;QACL,SAAS,EAAE;YACT,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC;YACnE,YAAY,EAAE,eAAe,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,EAAE,SAAS,CAAC;SAC7E;QACD,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/implementation/authoring/mimir-descriptor-loader.d.ts

@@ -0,0 +1,2 @@
+export { loadMimirDescriptors } from "../descriptors/descriptor-repository";
+export type { MimirDescriptorLoadResult, MimirResourceDescriptor } from "../contracts/descriptor";

package/dist/implementation/authoring/mimir-descriptor-loader.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadMimirDescriptors = void 0;
+// Backward-compatible re-export. Descriptor loading now lives in descriptors/descriptor-repository.
+var descriptor_repository_1 = require("../descriptors/descriptor-repository");
+Object.defineProperty(exports, "loadMimirDescriptors", { enumerable: true, get: function () { return descriptor_repository_1.loadMimirDescriptors; } });
+//# sourceMappingURL=mimir-descriptor-loader.js.map

package/dist/implementation/authoring/mimir-descriptor-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimir-descriptor-loader.js","sourceRoot":"","sources":["../../../src/implementation/authoring/mimir-descriptor-loader.ts"],"names":[],"mappings":";;;AAAA,oGAAoG;AACpG,8EAA4E;AAAnE,6HAAA,oBAAoB,OAAA"}

package/dist/implementation/contracts/descriptor.d.ts

@@ -0,0 +1,27 @@
+import type { ExtractedProp } from "./resource";
+export type MimirResourceDescriptor = {
+    kind: string;
+    name: string;
+    id?: string;
+    auto: {
+        source: {
+            file?: string;
+            symbol?: string;
+            public?: boolean;
+        };
+        props: Record<string, ExtractedProp>;
+        variants: string[];
+        storyFiles: string[];
+    };
+    human: {
+        description: string;
+        whenToUse: string[];
+        whenNotToUse: string[];
+    };
+    sourceRef: string;
+};
+export type MimirDescriptorLoadResult = {
+    descriptorFiles: string[];
+    resources: MimirResourceDescriptor[];
+    warnings: string[];
+};

package/dist/implementation/contracts/descriptor.js

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

package/dist/implementation/contracts/descriptor.js.map

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

package/dist/implementation/contracts/resource.d.ts

@@ -0,0 +1,16 @@
+export type ExtractedProp = {
+    name: string;
+    type?: string;
+    required?: boolean;
+};
+export type ExtractedComponentFact = {
+    name: string;
+    filePath: string;
+    importName: string;
+    packageName: string;
+    props: Record<string, ExtractedProp>;
+};
+export type StorybookFacts = {
+    variantsByComponent: Record<string, string[]>;
+    storyFilesByComponent: Record<string, string[]>;
+};

package/dist/implementation/contracts/resource.js

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

package/dist/implementation/contracts/resource.js.map

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

package/dist/implementation/descriptors/descriptor-discovery.d.ts

@@ -0,0 +1,2 @@
+export declare const DESCRIPTOR_SUFFIXES: string[];
+export declare function discoverDescriptorFiles(cwd: string): Promise<string[]>;

package/dist/implementation/descriptors/descriptor-discovery.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DESCRIPTOR_SUFFIXES = void 0;
+exports.discoverDescriptorFiles = discoverDescriptorFiles;
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = require("node:fs/promises");
+exports.DESCRIPTOR_SUFFIXES = [".mimir.yaml", ".mimir.yml"];
+function normalizeSlashes(value) {
+    return value.split(node_path_1.default.sep).join("/");
+}
+function shouldSkipDirectory(name) {
+    if (name === "node_modules" || name === "dist" || name === ".git") {
+        return true;
+    }
+    if (name.startsWith(".") && name !== ".aps") {
+        return true;
+    }
+    return false;
+}
+async function collectDescriptorFiles(dir) {
+    const entries = await (0, promises_1.readdir)(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const absolutePath = node_path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (shouldSkipDirectory(entry.name)) {
+                continue;
+            }
+            files.push(...(await collectDescriptorFiles(absolutePath)));
+            continue;
+        }
+        if (entry.isFile() && exports.DESCRIPTOR_SUFFIXES.some((suffix) => entry.name.endsWith(suffix))) {
+            files.push(absolutePath);
+        }
+    }
+    return files;
+}
+async function discoverDescriptorFiles(cwd) {
+    const descriptorPaths = await collectDescriptorFiles(cwd);
+    return descriptorPaths
+        .map((filePath) => normalizeSlashes(node_path_1.default.relative(cwd, filePath)))
+        .sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=descriptor-discovery.js.map

package/dist/implementation/descriptors/descriptor-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-discovery.js","sourceRoot":"","sources":["../../../src/implementation/descriptors/descriptor-discovery.ts"],"names":[],"mappings":";;;;;;AA4CA,0DAKC;AAjDD,0DAA6B;AAC7B,+CAA2C;AAE9B,QAAA,mBAAmB,GAAG,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AAEjE,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,KAAK,CAAC,mBAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,GAAW;IAC/C,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC5D,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,2BAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACxF,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAEM,KAAK,UAAU,uBAAuB,CAAC,GAAW;IACvD,MAAM,eAAe,GAAG,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC1D,OAAO,eAAe;SACnB,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,mBAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;SACjE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/implementation/descriptors/descriptor-repository.d.ts

@@ -0,0 +1,2 @@
+import type { MimirDescriptorLoadResult } from "../contracts/descriptor";
+export declare function loadMimirDescriptors(cwd: string): Promise<MimirDescriptorLoadResult>;

package/dist/implementation/descriptors/descriptor-repository.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadMimirDescriptors = loadMimirDescriptors;
+const node_path_1 = __importDefault(require("node:path"));
+const yaml_1 = require("yaml");
+const fs_1 = require("../io/fs");
+const json_1 = require("../io/json");
+const descriptor_discovery_1 = require("./descriptor-discovery");
+const SUPPORTED_KINDS = new Set([
+    "component",
+    "function",
+    "api",
+    "service",
+    "model",
+    "event",
+    "rule",
+    "example",
+    "pattern",
+    "migration"
+]);
+function readStringArray(value, field, sourceRef) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+        throw new Error(`${sourceRef}: '${field}' must be an array of strings`);
+    }
+    return value;
+}
+function readPropsMap(value, field, sourceRef) {
+    if (value === undefined) {
+        return {};
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(`${sourceRef}: '${field}' must be an array of prop objects`);
+    }
+    const props = {};
+    for (let index = 0; index < value.length; index += 1) {
+        const item = value[index];
+        if (!(0, json_1.isObject)(item) || typeof item.name !== "string" || item.name.trim() === "") {
+            throw new Error(`${sourceRef}: '${field}[${index}]' must include a non-empty 'name'`);
+        }
+        const name = item.name.trim();
+        props[name] = {
+            name,
+            type: typeof item.type === "string" ? item.type : undefined,
+            required: typeof item.required === "boolean" ? item.required : undefined
+        };
+    }
+    return props;
+}
+function readResource(value, sourceRef, index) {
+    if (!(0, json_1.isObject)(value)) {
+        throw new Error(`${sourceRef}: resources[${index}] must be an object`);
+    }
+    const resource = value;
+    if (typeof resource.kind !== "string" || resource.kind.trim() === "") {
+        throw new Error(`${sourceRef}: resources[${index}].kind must be a non-empty string`);
+    }
+    if (typeof resource.name !== "string" || resource.name.trim() === "") {
+        throw new Error(`${sourceRef}: resources[${index}].name must be a non-empty string`);
+    }
+    const kind = resource.kind.trim().toLowerCase();
+    if (!SUPPORTED_KINDS.has(kind)) {
+        throw new Error(`${sourceRef}: resources[${index}].kind '${resource.kind}' is not supported by the descriptor contract`);
+    }
+    const autoNode = (0, json_1.isObject)(resource.auto) ? resource.auto : {};
+    const humanNode = (0, json_1.isObject)(resource.human) ? resource.human : {};
+    const sourceCandidate = (0, json_1.isObject)(autoNode.source)
+        ? autoNode.source
+        : (0, json_1.isObject)(resource.source)
+            ? resource.source
+            : {};
+    const source = (0, json_1.isObject)(sourceCandidate)
+        ? {
+            file: typeof sourceCandidate.file === "string" ? sourceCandidate.file : undefined,
+            symbol: typeof sourceCandidate.symbol === "string" ? sourceCandidate.symbol : undefined,
+            public: typeof sourceCandidate.public === "boolean" ? sourceCandidate.public : undefined
+        }
+        : {};
+    const props = readPropsMap(autoNode.props ?? resource.props, "auto.props", sourceRef);
+    const variants = readStringArray(autoNode.variants ?? resource.variants, "auto.variants", sourceRef);
+    const storyFiles = readStringArray(autoNode.storyFiles ?? resource.storyFiles, "auto.storyFiles", sourceRef);
+    return {
+        kind,
+        name: resource.name,
+        id: typeof resource.id === "string" ? resource.id : undefined,
+        auto: {
+            source,
+            props,
+            variants,
+            storyFiles
+        },
+        human: {
+            description: typeof humanNode.description === "string"
+                ? humanNode.description
+                : typeof resource.description === "string"
+                    ? resource.description
+                    : "",
+            whenToUse: readStringArray(humanNode.whenToUse ?? resource.whenToUse, "human.whenToUse", sourceRef),
+            whenNotToUse: readStringArray(humanNode.whenNotToUse ?? resource.whenNotToUse, "human.whenNotToUse", sourceRef)
+        },
+        sourceRef
+    };
+}
+async function loadMimirDescriptors(cwd) {
+    const descriptorFiles = await (0, descriptor_discovery_1.discoverDescriptorFiles)(cwd);
+    const resources = [];
+    const warnings = [];
+    for (const sourceRef of descriptorFiles) {
+        const descriptorPath = node_path_1.default.join(cwd, sourceRef);
+        let raw;
+        try {
+            raw = (0, yaml_1.parse)(await (0, fs_1.readText)(descriptorPath));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            warnings.push(`Invalid descriptor YAML at ${sourceRef}: ${message}`);
+            continue;
+        }
+        if (!(0, json_1.isObject)(raw)) {
+            warnings.push(`${sourceRef}: descriptor must be a YAML object`);
+            continue;
+        }
+        const schemaVersion = raw.schemaVersion;
+        if (schemaVersion !== 1) {
+            warnings.push(`${sourceRef}: schemaVersion must be 1`);
+            continue;
+        }
+        if (!Array.isArray(raw.resources)) {
+            warnings.push(`${sourceRef}: resources must be an array`);
+            continue;
+        }
+        for (let index = 0; index < raw.resources.length; index += 1) {
+            try {
+                const resource = readResource(raw.resources[index], sourceRef, index);
+                if (resource) {
+                    resources.push(resource);
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                warnings.push(message);
+            }
+        }
+    }
+    return {
+        descriptorFiles,
+        resources,
+        warnings
+    };
+}
+//# sourceMappingURL=descriptor-repository.js.map

package/dist/implementation/descriptors/descriptor-repository.js.map

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

package/dist/implementation/generation/generate-service.d.ts

@@ -2,5 +2,6 @@ import type { GenerateReport } from "./types";
 type GenerateOptions = {
     force?: boolean;
 };
+export declare function compileApsFromDescriptors(cwd: string, options?: GenerateOptions): Promise<GenerateReport>;
 export declare function generateApsFromEvidence(cwd: string, options?: GenerateOptions): Promise<GenerateReport>;
 export {};

package/dist/implementation/generation/generate-service.js

@@ -3,24 +3,70 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileApsFromDescriptors = compileApsFromDescriptors;
 exports.generateApsFromEvidence = generateApsFromEvidence;
 const node_path_1 = __importDefault(require("node:path"));
 const fs_1 = require("../io/fs");
-const json_1 = require("../io/json");
 const compatibility_1 = require("../../protocol/compatibility");
 const governance_1 = require("../../protocol/governance");
-const readme_extractor_1 = require("./extractors/readme-extractor");
-const storybook_extractor_1 = require("./extractors/storybook-extractor");
-const typescript_extractor_1 = require("./extractors/typescript-extractor");
-const component_builder_1 = require("./resource-builders/component-builder");
 const example_builder_1 = require("./resource-builders/example-builder");
-const APS_MANIFEST_RELATIVE_PATH = "./dist/aps/manifest.json";
+const descriptor_repository_1 = require("../descriptors/descriptor-repository");
+const resource_identity_1 = require("../resource-identity");
+const provenance_builder_1 = require("./provenance/provenance-builder");
 function hasHumanMetadata(component) {
     return component.description.trim() !== "" && component.whenToUse.length > 0 && component.whenNotToUse.length > 0;
 }
 function toUniqueSorted(values) {
     return [...new Set(values)].sort((a, b) => a.localeCompare(b));
 }
+function buildComponentFromDescriptor(packageName, descriptor) {
+    const sourceFile = descriptor.auto.source.file ?? descriptor.sourceRef;
+    const storyFiles = descriptor.auto.storyFiles;
+    const variants = descriptor.auto.variants;
+    const authoredDescription = descriptor.human.description.trim();
+    const evidenceByField = {
+        id: { evidence: [(0, provenance_builder_1.fromPackageJson)()] },
+        name: { evidence: [(0, provenance_builder_1.fromTypeScript)(sourceFile)] },
+        package: { evidence: [(0, provenance_builder_1.fromPackageJson)()] },
+        import: { evidence: [(0, provenance_builder_1.fromTypeScript)(sourceFile)] },
+        description: {
+            evidence: authoredDescription !== "" ? [(0, provenance_builder_1.fromHumanKnowledge)(descriptor.sourceRef)] : [(0, provenance_builder_1.missingHumanSource)("description")]
+        },
+        props: { evidence: [(0, provenance_builder_1.fromTypeScript)(sourceFile)] },
+        variants: {
+            evidence: variants.length > 0
+                ? storyFiles.length > 0
+                    ? storyFiles.map((file) => (0, provenance_builder_1.fromStorybook)(file))
+                    : [(0, provenance_builder_1.fromTypeScript)(sourceFile)]
+                : [(0, provenance_builder_1.fromTypeScript)(sourceFile)]
+        },
+        whenToUse: {
+            evidence: descriptor.human.whenToUse.length > 0
+                ? [(0, provenance_builder_1.fromHumanKnowledge)(descriptor.sourceRef)]
+                : [(0, provenance_builder_1.missingHumanSource)("whenToUse")]
+        },
+        whenNotToUse: {
+            evidence: descriptor.human.whenNotToUse.length > 0
+                ? [(0, provenance_builder_1.fromHumanKnowledge)(descriptor.sourceRef)]
+                : [(0, provenance_builder_1.missingHumanSource)("whenNotToUse")]
+        }
+    };
+    return {
+        type: "component",
+        id: descriptor.id ?? (0, resource_identity_1.createComponentResourceId)(packageName, descriptor.name),
+        name: descriptor.name,
+        package: packageName,
+        import: descriptor.auto.source.symbol ?? descriptor.name,
+        description: authoredDescription,
+        props: descriptor.auto.props,
+        variants,
+        whenToUse: descriptor.human.whenToUse,
+        whenNotToUse: descriptor.human.whenNotToUse,
+        governance: {
+            fields: evidenceByField
+        }
+    };
+}
 async function readPackageName(cwd) {
     const packageJsonPath = node_path_1.default.join(cwd, "package.json");
     const packageJson = await (0, fs_1.readJson)(packageJsonPath);
@@ -29,44 +75,7 @@ async function readPackageName(cwd) {
     }
     return packageJson.name;
 }
-async function ensureProviderDiscoverability(cwd) {
-    const warnings = [];
-    const packageJsonPath = node_path_1.default.join(cwd, "package.json");
-    const packageJson = await (0, fs_1.readJson)(packageJsonPath);
-    let changed = false;
-    if (!(0, json_1.isObject)(packageJson.aps)) {
-        packageJson.aps = {};
-        changed = true;
-    }
-    const aps = packageJson.aps;
-    if (aps.version === undefined) {
-        aps.version = 1;
-        changed = true;
-        warnings.push("APS config version was missing and has been set to 1.");
-    }
-    if (aps.manifest !== APS_MANIFEST_RELATIVE_PATH) {
-        const previous = typeof aps.manifest === "string" ? aps.manifest : "(not set)";
-        aps.manifest = APS_MANIFEST_RELATIVE_PATH;
-        changed = true;
-        warnings.push(`APS manifest path updated from '${previous}' to '${APS_MANIFEST_RELATIVE_PATH}' for consistency with generated resources.`);
-    }
-    if ((0, json_1.isObject)(packageJson.exports)) {
-        const exportsMap = packageJson.exports;
-        if (exportsMap["./package.json"] !== "./package.json") {
-            exportsMap["./package.json"] = "./package.json";
-            changed = true;
-            warnings.push("Added exports['./package.json'] for provider discovery compatibility.");
-        }
-    }
-    else if (packageJson.exports !== undefined) {
-        warnings.push("Package exports is not an object. Could not add exports['./package.json']; configure it manually for discovery compatibility.");
-    }
-    if (changed) {
-        await (0, fs_1.writeJson)(packageJsonPath, packageJson);
-    }
-    return warnings;
-}
-async function generateApsFromEvidence(cwd, options = {}) {
+async function compileApsFromDescriptors(cwd, options = {}) {
     const packageName = await readPackageName(cwd);
     const outputDir = node_path_1.default.join(cwd, "dist", "aps");
     const manifestPath = node_path_1.default.join(outputDir, "manifest.json");
@@ -75,18 +84,22 @@ async function generateApsFromEvidence(cwd, options = {}) {
     if (alreadyExists && !options.force) {
         throw new Error("APS resources already exist in dist/aps. Re-run with --force to replace existing generated resources.");
     }
-    const discoverabilityWarnings = await ensureProviderDiscoverability(cwd);
     await (0, fs_1.ensureDir)(outputDir);
-    const [typescriptComponents, storybookFacts, readmeFacts] = await Promise.all([
-        (0, typescript_extractor_1.extractTypeScriptComponents)(cwd, packageName),
-        (0, storybook_extractor_1.extractStorybookFacts)(cwd),
-        (0, readme_extractor_1.extractReadmeFacts)(cwd)
-    ]);
-    const components = typescriptComponents.map((component) => (0, component_builder_1.buildComponentResource)(component, storybookFacts, readmeFacts));
+    const descriptorResult = await (0, descriptor_repository_1.loadMimirDescriptors)(cwd);
+    const unsupportedKinds = toUniqueSorted(descriptorResult.resources.filter((resource) => resource.kind !== "component").map((resource) => resource.kind));
+    const componentDescriptors = descriptorResult.resources.filter((resource) => resource.kind === "component");
+    const components = await Promise.all(componentDescriptors.map(async (descriptor) => buildComponentFromDescriptor(packageName, descriptor)));
     const exampleResult = (0, example_builder_1.buildExamplesNotImplemented)();
+    const descriptorWarnings = [...descriptorResult.warnings];
+    if (descriptorResult.descriptorFiles.length === 0) {
+        descriptorWarnings.push("No *.mimir.yaml descriptors found. Run 'mimir author' to scaffold descriptor files.");
+    }
+    if (unsupportedKinds.length > 0) {
+        descriptorWarnings.push(`Descriptor resources ignored by generator v1 (unsupported kinds): ${unsupportedKinds.join(", ")}.`);
+    }
     const output = {
         components,
-        warnings: [...exampleResult.warnings, ...discoverabilityWarnings],
+        warnings: [...exampleResult.warnings, ...descriptorWarnings],
         missingHumanMetadata: toUniqueSorted(components
             .filter((component) => !hasHumanMetadata(component))
             .map((component) => component.name))
@@ -118,4 +131,7 @@ async function generateApsFromEvidence(cwd, options = {}) {
         }
     };
 }
+async function generateApsFromEvidence(cwd, options = {}) {
+    return compileApsFromDescriptors(cwd, options);
+}
 //# sourceMappingURL=generate-service.js.map

package/dist/implementation/generation/generate-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-service.js","sourceRoot":"","sources":["../../../src/implementation/generation/generate-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generate-service.js","sourceRoot":"","sources":["../../../src/implementation/generation/generate-service.ts"],"names":[],"mappings":"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"}

package/dist/implementation/generation/provenance/provenance-builder.d.ts

@@ -2,5 +2,5 @@ import type { FieldEvidence } from "../types";
 export declare function fromTypeScript(sourceRef: string): FieldEvidence;
 export declare function fromPackageJson(): FieldEvidence;
 export declare function fromStorybook(sourceRef: string): FieldEvidence;
-export declare function fromReadme(sourceRef: string): FieldEvidence;
+export declare function fromHumanKnowledge(sourceRef: string): FieldEvidence;
 export declare function missingHumanSource(fieldName: string): FieldEvidence;

package/dist/implementation/generation/provenance/provenance-builder.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.fromTypeScript = fromTypeScript;
 exports.fromPackageJson = fromPackageJson;
 exports.fromStorybook = fromStorybook;
-exports.fromReadme = fromReadme;
+exports.fromHumanKnowledge = fromHumanKnowledge;
 exports.missingHumanSource = missingHumanSource;
 function fromTypeScript(sourceRef) {
     return {
@@ -26,11 +26,11 @@ function fromStorybook(sourceRef) {
         confidence: "medium"
     };
 }
-function fromReadme(sourceRef) {
+function fromHumanKnowledge(sourceRef) {
     return {
-        sourceType: "readme",
+        sourceType: "human",
         sourceRef,
-        confidence: "medium"
+        confidence: "high"
     };
 }
 function missingHumanSource(fieldName) {

package/dist/implementation/generation/provenance/provenance-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"provenance-builder.js","sourceRoot":"","sources":["../../../../src/implementation/generation/provenance/provenance-builder.ts"],"names":[],"mappings":";;AAEA,wCAMC;AAED,0CAMC;AAED,sCAMC;AAED,gCAMC;AAED,gDAOC;AAvCD,SAAgB,cAAc,CAAC,SAAiB;IAC9C,OAAO;QACL,UAAU,EAAE,YAAY;QACxB,SAAS;QACT,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,SAAgB,eAAe;IAC7B,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,cAAc;QACzB,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,SAAgB,aAAa,CAAC,SAAiB;IAC7C,OAAO;QACL,UAAU,EAAE,WAAW;QACvB,SAAS;QACT,UAAU,EAAE,QAAQ;KACrB,CAAC;AACJ,CAAC;AAED,SAAgB,UAAU,CAAC,SAAiB;IAC1C,OAAO;QACL,UAAU,EAAE,QAAQ;QACpB,SAAS;QACT,UAAU,EAAE,QAAQ;KACrB,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,SAAiB;IAClD,OAAO;QACL,UAAU,EAAE,OAAO;QACnB,SAAS,EAAE,SAAS;QACpB,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,sCAAsC,SAAS,GAAG;KACzD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"provenance-builder.js","sourceRoot":"","sources":["../../../../src/implementation/generation/provenance/provenance-builder.ts"],"names":[],"mappings":";;AAEA,wCAMC;AAED,0CAMC;AAED,sCAMC;AAED,gDAMC;AAED,gDAOC;AAvCD,SAAgB,cAAc,CAAC,SAAiB;IAC9C,OAAO;QACL,UAAU,EAAE,YAAY;QACxB,SAAS;QACT,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,SAAgB,eAAe;IAC7B,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,cAAc;QACzB,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,SAAgB,aAAa,CAAC,SAAiB;IAC7C,OAAO;QACL,UAAU,EAAE,WAAW;QACvB,SAAS;QACT,UAAU,EAAE,QAAQ;KACrB,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,SAAiB;IAClD,OAAO;QACL,UAAU,EAAE,OAAO;QACnB,SAAS;QACT,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,SAAiB;IAClD,OAAO;QACL,UAAU,EAAE,OAAO;QACnB,SAAS,EAAE,SAAS;QACpB,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,sCAAsC,SAAS,GAAG;KACzD,CAAC;AACJ,CAAC"}