@mimir-labs/core 0.3.0 → 0.5.0

package/README.md

@@ -1,10 +1,22 @@
 # @mimir-labs/core
 
-Core business logic and reusable services for the Mimir CLI.
+Software Knowledge Engine and reusable services for the Mimir CLI.
+
+Mimir discovers software facts through Knowledge Providers, organizes them in
+an in-memory Knowledge Graph, and applies an explicit Persistence Policy before
+`author` writes versioned descriptors. `generate` remains independent: it
+compiles persistent descriptor knowledge into APS without consulting authoring
+providers.
 
 Public workflows include discovery, authoring, generation, validation,
 governance, context generation, synchronization, initialization, and doctor
-assessment. Author Knowledge 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`.
+
+The knowledge model is intentionally separate from APS. Knowledge extraction
+can evolve without expanding the descriptor or protocol contract with every
+derived fact.
 
-See extension guidance in [EXTENSIONS.md](./EXTENSIONS.md).
+See [ARCHITECTURE.md](./ARCHITECTURE.md) for the knowledge pipeline and
+[EXTENSIONS.md](./EXTENSIONS.md) for public extension guidance.

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,33 @@
+import type { ExtractedExample, ExtractedProp, ExtractedReactPatterns, ExtractedRelationship, ExtractionMetadata, PublicComponentApi, ResourceClassification } from "./resource";
+export type MimirResourceDescriptor = {
+    kind: string;
+    name: string;
+    id?: string;
+    auto: {
+        source: {
+            file?: string;
+            symbol?: string;
+            public?: boolean;
+        };
+        props: Record<string, ExtractedProp>;
+        api?: PublicComponentApi;
+        classification?: ResourceClassification;
+        variants: string[];
+        storyFiles: string[];
+        relationships?: ExtractedRelationship[];
+        examples?: ExtractedExample[];
+        react?: ExtractedReactPatterns;
+        ai?: ExtractionMetadata;
+    };
+    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,109 @@
+export type ExtractedProp = {
+    name: string;
+    type?: string;
+    required?: boolean;
+};
+export type SemanticResourceKind = "component" | "hook" | "context" | "provider" | "template" | "icon" | "page" | "utility" | "theme" | "token" | "configuration" | "story" | "internal" | "unknown";
+export type ResourceClassification = {
+    kind: SemanticResourceKind;
+    confidence: number;
+    reasons: string[];
+    generateDescriptor: boolean;
+};
+export type PublicApiTypeDescriptor = {
+    kind: "primitive";
+    name: string;
+} | {
+    kind: "literal";
+    value: string | number | boolean | null;
+} | {
+    kind: "union";
+    values: Array<string | number | boolean | null>;
+    display: string;
+} | {
+    kind: "enum";
+    name: string;
+    members: Array<string | number>;
+    display: string;
+} | {
+    kind: "reference";
+    name: string;
+    display: string;
+} | {
+    kind: "unknown";
+    display: string;
+};
+export type PublicApiProp = {
+    name: string;
+    type: PublicApiTypeDescriptor;
+    required: boolean;
+    inherited: boolean;
+    inheritedFrom?: string;
+    description?: string;
+    deprecated?: string | boolean;
+    default?: string | number | boolean | null;
+    remarks?: string;
+};
+export type PublicComponentApi = {
+    props: PublicApiProp[];
+    events: unknown[];
+    slots: unknown[];
+    methods: unknown[];
+    refs: unknown[];
+};
+export type ExtractedComponentFact = {
+    name: string;
+    filePath: string;
+    importName: string;
+    packageName: string;
+    props: Record<string, ExtractedProp>;
+};
+export type DiscoveredResourceFact = {
+    name: string;
+    filePath: string;
+    importName: string;
+    packageName: string;
+    classification: ResourceClassification;
+};
+export type StorybookFacts = {
+    variantsByComponent: Record<string, string[]>;
+    storyFilesByComponent: Record<string, string[]>;
+    examplesByComponent: Record<string, ExtractedExample[]>;
+};
+export type RelationshipType = "imports" | "exports" | "uses" | "composes" | "dependsOn" | "provides" | "consumes" | "references";
+export type ExtractedRelationship = {
+    type: RelationshipType;
+    target: string;
+    confidence: number;
+};
+export type StaticValue = string | number | boolean | null | StaticValue[] | {
+    [key: string]: StaticValue;
+};
+export type ExtractedExample = {
+    name: string;
+    source: {
+        file: string;
+    };
+    story: string;
+    args?: Record<string, StaticValue>;
+    decorators?: string[];
+    play?: boolean;
+};
+export type DesignTokenCategory = "colors" | "spacing" | "typography" | "radius" | "shadows" | "zIndex" | "breakpoints";
+export type ExtractedDesignTokens = Partial<Record<DesignTokenCategory, Record<string, StaticValue>>>;
+export type ExtractedReactPatterns = {
+    forwardRef: boolean;
+    memo: boolean;
+    lazy: boolean;
+    suspense: boolean;
+    portal: boolean;
+    errorBoundary: boolean;
+    context: boolean;
+    provider: boolean;
+    customHook: boolean;
+};
+export type ExtractionMetadata = {
+    confidence?: number;
+    extractedAt?: string;
+    extractorVersion?: 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,175 @@
+"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, resourcePath) {
+    if (!(0, json_1.isObject)(value)) {
+        throw new Error(`${sourceRef}: ${resourcePath} must be an object`);
+    }
+    const resource = value;
+    if (typeof resource.kind !== "string" || resource.kind.trim() === "") {
+        throw new Error(`${sourceRef}: ${resourcePath}.kind must be a non-empty string`);
+    }
+    if (typeof resource.name !== "string" || resource.name.trim() === "") {
+        throw new Error(`${sourceRef}: ${resourcePath}.name must be a non-empty string`);
+    }
+    const kind = resource.kind.trim().toLowerCase();
+    if (!SUPPORTED_KINDS.has(kind)) {
+        throw new Error(`${sourceRef}: ${resourcePath}.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,
+            api: (0, json_1.isObject)(autoNode.api) ? autoNode.api : undefined,
+            classification: (0, json_1.isObject)(autoNode.classification) ? autoNode.classification : undefined,
+            variants,
+            storyFiles,
+            relationships: Array.isArray(autoNode.relationships) ? autoNode.relationships : undefined,
+            examples: Array.isArray(autoNode.examples) ? autoNode.examples : undefined,
+            react: (0, json_1.isObject)(autoNode.react) ? autoNode.react : undefined,
+            ai: (0, json_1.isObject)(autoNode.ai) ? autoNode.ai : undefined
+        },
+        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) {
+            if (!Array.isArray(raw.resources)) {
+                warnings.push(`${sourceRef}: resources must be an array for schemaVersion 1`);
+                continue;
+            }
+            for (let index = 0; index < raw.resources.length; index += 1) {
+                try {
+                    const resource = readResource(raw.resources[index], sourceRef, `resources[${index}]`);
+                    if (resource) {
+                        resources.push(resource);
+                    }
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    warnings.push(message);
+                }
+            }
+            continue;
+        }
+        if (schemaVersion === 2) {
+            try {
+                const resource = readResource(raw, sourceRef, "resource");
+                if (resource) {
+                    resources.push(resource);
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                warnings.push(message);
+            }
+            continue;
+        }
+        warnings.push(`${sourceRef}: schemaVersion must be 1 or 2`);
+    }
+    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,10 @@ import type { GenerateReport } from "./types";
 type GenerateOptions = {
     force?: boolean;
 };
+export declare class NoDescriptorsFoundError extends Error {
+    readonly code = "NO_DESCRIPTORS_FOUND";
+    constructor();
+}
+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,26 +3,79 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoDescriptorsFoundError = void 0;
+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 knowledge_loader_1 = require("../authoring/knowledge-loader");
+const descriptor_repository_1 = require("../descriptors/descriptor-repository");
 const resource_identity_1 = require("../resource-identity");
-const APS_MANIFEST_RELATIVE_PATH = "./dist/aps/manifest.json";
+const provenance_builder_1 = require("./provenance/provenance-builder");
+class NoDescriptorsFoundError extends Error {
+    code = "NO_DESCRIPTORS_FOUND";
+    constructor() {
+        super("No descriptors found");
+        this.name = "NoDescriptorsFoundError";
+    }
+}
+exports.NoDescriptorsFoundError = NoDescriptorsFoundError;
 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);
@@ -31,45 +84,12 @@ 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 descriptorResult = await (0, descriptor_repository_1.loadMimirDescriptors)(cwd);
+    if (descriptorResult.descriptorFiles.length === 0) {
+        throw new NoDescriptorsFoundError();
+    }
     const outputDir = node_path_1.default.join(cwd, "dist", "aps");
     const manifestPath = node_path_1.default.join(outputDir, "manifest.json");
     const componentsPath = node_path_1.default.join(outputDir, "components.json");
@@ -77,22 +97,18 @@ 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 = await Promise.all(typescriptComponents.map(async (component) => {
-        const resourceId = (0, resource_identity_1.createComponentResourceId)(component.packageName, component.name);
-        const authored = await (0, knowledge_loader_1.loadComponentKnowledge)(cwd, resourceId);
-        return (0, component_builder_1.buildComponentResource)(component, storybookFacts, readmeFacts, authored);
-    }));
+    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 (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))
@@ -109,6 +125,7 @@ async function generateApsFromEvidence(cwd, options = {}) {
     const governanceResult = (0, governance_1.validateGovernance)(manifest);
     return {
         outputDir,
+        descriptorsCompiled: descriptorResult.descriptorFiles.length,
         generatedResources: output.components.length,
         warnings: output.warnings,
         missingHumanMetadata: output.missingHumanMetadata,
@@ -124,4 +141,7 @@ async function generateApsFromEvidence(cwd, options = {}) {
         }
     };
 }
+async function generateApsFromEvidence(cwd, options = {}) {
+    return compileApsFromDescriptors(cwd, options);
+}
 //# sourceMappingURL=generate-service.js.map