@mimir-labs/core 0.4.0 → 0.6.0

package/README.md

@@ -1,6 +1,12 @@
 # @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
@@ -8,4 +14,9 @@ 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).
+The knowledge model is intentionally separate from APS. Knowledge extraction
+can evolve without expanding the descriptor or protocol contract with every
+derived fact.
+
+See [ARCHITECTURE.md](./ARCHITECTURE.md) for the knowledge pipeline and
+[EXTENSIONS.md](./EXTENSIONS.md) for public extension guidance.

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

@@ -1,4 +1,4 @@
-import type { ExtractedProp } from "./resource";
+import type { ExtractedExample, ExtractedProp, ExtractedReactPatterns, ExtractedRelationship, ExtractionMetadata, PublicComponentApi, ResourceClassification } from "./resource";
 export type MimirResourceDescriptor = {
     kind: string;
     name: string;
@@ -10,8 +10,14 @@ export type MimirResourceDescriptor = {
             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;

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

@@ -3,6 +3,54 @@ export type ExtractedProp = {
     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;
@@ -10,7 +58,52 @@ export type ExtractedComponentFact = {
     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/descriptors/descriptor-repository.js

@@ -52,20 +52,20 @@ function readPropsMap(value, field, sourceRef) {
     }
     return props;
 }
-function readResource(value, sourceRef, index) {
+function readResource(value, sourceRef, resourcePath) {
     if (!(0, json_1.isObject)(value)) {
-        throw new Error(`${sourceRef}: resources[${index}] must be an object`);
+        throw new Error(`${sourceRef}: ${resourcePath} 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`);
+        throw new Error(`${sourceRef}: ${resourcePath}.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`);
+        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}: resources[${index}].kind '${resource.kind}' is not supported by the descriptor contract`);
+        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 : {};
@@ -91,8 +91,14 @@ function readResource(value, sourceRef, index) {
         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
+            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"
@@ -126,17 +132,28 @@ async function loadMimirDescriptors(cwd) {
             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`);
+        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;
         }
-        for (let index = 0; index < raw.resources.length; index += 1) {
+        if (schemaVersion === 2) {
             try {
-                const resource = readResource(raw.resources[index], sourceRef, index);
+                const resource = readResource(raw, sourceRef, "resource");
                 if (resource) {
                     resources.push(resource);
                 }
@@ -145,7 +162,9 @@ async function loadMimirDescriptors(cwd) {
                 const message = error instanceof Error ? error.message : String(error);
                 warnings.push(message);
             }
+            continue;
         }
+        warnings.push(`${sourceRef}: schemaVersion must be 1 or 2`);
     }
     return {
         descriptorFiles,

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

@@ -1 +1 @@
-{"version":3,"file":"descriptor-repository.js","sourceRoot":"","sources":["../../../src/implementation/descriptors/descriptor-repository.ts"],"names":[],"mappings":"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"}
+{"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,6 +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,6 +3,7 @@ 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"));
@@ -13,6 +14,14 @@ const example_builder_1 = require("./resource-builders/example-builder");
 const descriptor_repository_1 = require("../descriptors/descriptor-repository");
 const resource_identity_1 = require("../resource-identity");
 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;
 }
@@ -77,6 +86,10 @@ async function readPackageName(cwd) {
 }
 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");
@@ -85,15 +98,11 @@ async function compileApsFromDescriptors(cwd, options = {}) {
         throw new Error("APS resources already exist in dist/aps. Re-run with --force to replace existing generated resources.");
     }
     await (0, fs_1.ensureDir)(outputDir);
-    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(", ")}.`);
     }
@@ -116,6 +125,7 @@ async function compileApsFromDescriptors(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,

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/types.d.ts

@@ -34,6 +34,7 @@ export type GenerateOutput = {
 };
 export type GenerateReport = {
     outputDir: string;
+    descriptorsCompiled: number;
     generatedResources: number;
     warnings: string[];
     missingHumanMetadata: string[];

package/dist/implementation/io/fs.d.ts

@@ -5,3 +5,4 @@ export declare function writeText(filePath: string, content: string): Promise<vo
 export declare function writeTextIfMissing(filePath: string, content: string): Promise<boolean>;
 export declare function readJson<T>(filePath: string): Promise<T>;
 export declare function writeJson(filePath: string, data: unknown): Promise<void>;
+export declare function deleteFile(filePath: string): Promise<void>;

package/dist/implementation/io/fs.js

@@ -10,6 +10,7 @@ exports.writeText = writeText;
 exports.writeTextIfMissing = writeTextIfMissing;
 exports.readJson = readJson;
 exports.writeJson = writeJson;
+exports.deleteFile = deleteFile;
 const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
 async function fileExists(filePath) {
@@ -58,4 +59,16 @@ async function writeJson(filePath, data) {
     const serialized = `${JSON.stringify(data, null, 2)}\n`;
     await writeText(filePath, serialized);
 }
+async function deleteFile(filePath) {
+    try {
+        await (0, promises_1.unlink)(filePath);
+    }
+    catch (error) {
+        const fsError = error;
+        if (fsError.code === "ENOENT") {
+            return;
+        }
+        throw error;
+    }
+}
 //# sourceMappingURL=fs.js.map

package/dist/implementation/io/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/implementation/io/fs.ts"],"names":[],"mappings":";;;;;AAGA,gCAOC;AAED,8BAEC;AAED,4BAEC;AAED,8BAGC;AAED,gDAYC;AAED,4BASC;AAED,8BAGC;AArDD,+CAAsE;AACtE,0DAA6B;AAEtB,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,IAAA,iBAAM,EAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,IAAA,gBAAK,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAEM,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,OAAO,IAAA,mBAAQ,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,SAAS,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAAe;IACxE,MAAM,SAAS,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,QAAQ,CAAI,QAAgB;IAChD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAErC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,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,mBAAmB,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAa;IAC7D,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACxD,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/implementation/io/fs.ts"],"names":[],"mappings":";;;;;AAGA,gCAOC;AAED,8BAEC;AAED,4BAEC;AAED,8BAGC;AAED,gDAYC;AAED,4BASC;AAED,8BAGC;AAED,gCAUC;AAjED,+CAA8E;AAC9E,0DAA6B;AAEtB,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,IAAA,iBAAM,EAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,IAAA,gBAAK,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAEM,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,OAAO,IAAA,mBAAQ,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,SAAS,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAAe;IACxE,MAAM,SAAS,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,QAAQ,CAAI,QAAgB;IAChD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAErC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,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,mBAAmB,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAa;IAC7D,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACxD,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,IAAA,iBAAM,EAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAA8B,CAAC;QAC/C,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/implementation/knowledge/knowledge-engine.d.ts

@@ -0,0 +1,8 @@
+import { KnowledgeGraph } from "./knowledge-graph";
+import type { KnowledgeProvider, KnowledgeWorkspace } from "./model";
+import type { SemanticResourceKind } from "../contracts/resource";
+export declare function buildKnowledgeGraph(workspace: KnowledgeWorkspace, providers?: readonly KnowledgeProvider[]): Promise<KnowledgeGraph>;
+export declare function createKnowledgeWorkspace(cwd: string, packageName: string, discovery: {
+    includeKinds?: SemanticResourceKind[];
+    excludeKinds?: SemanticResourceKind[];
+}): Promise<KnowledgeWorkspace>;

package/dist/implementation/knowledge/knowledge-engine.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildKnowledgeGraph = buildKnowledgeGraph;
+exports.createKnowledgeWorkspace = createKnowledgeWorkspace;
+const knowledge_graph_1 = require("./knowledge-graph");
+const typescript_analysis_1 = require("../resource-discovery/typescript-analysis");
+const providers_1 = require("./providers");
+const DEFAULT_PROVIDERS = [
+    new providers_1.SemanticDiscoveryProvider(),
+    new providers_1.PublicApiProvider(),
+    new providers_1.StorybookProvider(),
+    new providers_1.RelationshipProvider(),
+    new providers_1.ReactProvider(),
+    new providers_1.DesignTokenProvider()
+];
+async function buildKnowledgeGraph(workspace, providers = DEFAULT_PROVIDERS) {
+    const graph = new knowledge_graph_1.KnowledgeGraph();
+    const availablePredicates = new Set();
+    for (const provider of providers) {
+        const missing = (provider.requires ?? []).filter((predicate) => !availablePredicates.has(predicate));
+        if (missing.length > 0) {
+            throw new Error(`Knowledge provider '${provider.id}' requires facts: ${missing.join(", ")}`);
+        }
+        graph.add(await provider.collect(workspace, graph));
+        for (const predicate of provider.provides)
+            availablePredicates.add(predicate);
+    }
+    return graph;
+}
+async function createKnowledgeWorkspace(cwd, packageName, discovery) {
+    const analysis = await (0, typescript_analysis_1.createTypeScriptAnalysis)(cwd);
+    return {
+        cwd,
+        packageName,
+        discovery,
+        program: analysis.program,
+        checker: analysis.checker
+    };
+}
+//# sourceMappingURL=knowledge-engine.js.map

package/dist/implementation/knowledge/knowledge-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-engine.js","sourceRoot":"","sources":["../../../src/implementation/knowledge/knowledge-engine.ts"],"names":[],"mappings":";;AAsBA,kDAeC;AAED,4DAaC;AApDD,uDAAmD;AAEnD,mFAAqF;AAErF,2CAOqB;AAErB,MAAM,iBAAiB,GAAwB;IAC7C,IAAI,qCAAyB,EAAE;IAC/B,IAAI,6BAAiB,EAAE;IACvB,IAAI,6BAAiB,EAAE;IACvB,IAAI,gCAAoB,EAAE;IAC1B,IAAI,yBAAa,EAAE;IACnB,IAAI,+BAAmB,EAAE;CAC1B,CAAC;AAEK,KAAK,UAAU,mBAAmB,CACvC,SAA6B,EAC7B,YAA0C,iBAAiB;IAE3D,MAAM,KAAK,GAAG,IAAI,gCAAc,EAAE,CAAC;IACnC,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACrG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,EAAE,qBAAqB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACpD,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,QAAQ;YAAE,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAEM,KAAK,UAAU,wBAAwB,CAC5C,GAAW,EACX,WAAmB,EACnB,SAA2F;IAE3F,MAAM,QAAQ,GAAG,MAAM,IAAA,8CAAwB,EAAC,GAAG,CAAC,CAAC;IACrD,OAAO;QACL,GAAG;QACH,WAAW;QACX,SAAS;QACT,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC;AACJ,CAAC"}

package/dist/implementation/knowledge/knowledge-graph.d.ts

@@ -0,0 +1,12 @@
+import type { KnowledgeFact, KnowledgeGraphReader, KnowledgePredicate } from "./model";
+export declare class KnowledgeGraph implements KnowledgeGraphReader {
+    private readonly collectedFacts;
+    add(facts: readonly KnowledgeFact[]): void;
+    facts(predicate?: KnowledgePredicate): readonly KnowledgeFact[];
+    factsFor(subject: string, predicate?: KnowledgePredicate): readonly KnowledgeFact[];
+    resources(): readonly KnowledgeFact[];
+    relationships(subject?: string): readonly KnowledgeFact[];
+    examples(subject?: string): readonly KnowledgeFact[];
+    publicApi(subject: string): KnowledgeFact | undefined;
+    classification(subject: string): KnowledgeFact | undefined;
+}

package/dist/implementation/knowledge/knowledge-graph.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeGraph = void 0;
+class KnowledgeGraph {
+    collectedFacts = [];
+    add(facts) {
+        this.collectedFacts.push(...facts);
+    }
+    facts(predicate) {
+        return predicate
+            ? this.collectedFacts.filter((fact) => fact.predicate === predicate)
+            : this.collectedFacts;
+    }
+    factsFor(subject, predicate) {
+        return this.collectedFacts.filter((fact) => fact.subject === subject && (!predicate || fact.predicate === predicate));
+    }
+    resources() {
+        return this.facts("resource");
+    }
+    relationships(subject) {
+        return subject ? this.factsFor(subject, "relationship") : this.facts("relationship");
+    }
+    examples(subject) {
+        return subject ? this.factsFor(subject, "example") : this.facts("example");
+    }
+    publicApi(subject) {
+        return this.factsFor(subject, "public-api")[0];
+    }
+    classification(subject) {
+        return this.factsFor(subject, "classification")[0];
+    }
+}
+exports.KnowledgeGraph = KnowledgeGraph;
+//# sourceMappingURL=knowledge-graph.js.map

package/dist/implementation/knowledge/knowledge-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.js","sourceRoot":"","sources":["../../../src/implementation/knowledge/knowledge-graph.ts"],"names":[],"mappings":";;;AAEA,MAAa,cAAc;IACR,cAAc,GAAoB,EAAE,CAAC;IAEtD,GAAG,CAAC,KAA+B;QACjC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,SAA8B;QAClC,OAAO,SAAS;YACd,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC;YACpE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC1B,CAAC;IAED,QAAQ,CAAC,OAAe,EAAE,SAA8B;QACtD,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAC/B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CACnF,CAAC;IACJ,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED,aAAa,CAAC,OAAgB;QAC5B,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACvF,CAAC;IAED,QAAQ,CAAC,OAAgB;QACvB,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7E,CAAC;IAED,SAAS,CAAC,OAAe;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,cAAc,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;CACF;AAtCD,wCAsCC"}

package/dist/implementation/knowledge/model.d.ts

@@ -0,0 +1,44 @@
+import type ts from "typescript";
+import type { SemanticResourceKind } from "../contracts/resource";
+export type KnowledgeSource = "typescript" | "storybook" | "react" | "design-tokens";
+export type KnowledgeEvidence = {
+    kind: string;
+    detail: string;
+    file?: string;
+    symbol?: string;
+};
+export type KnowledgePredicate = "resource" | "classification" | "public-api" | "relationship" | "example" | "react-patterns" | "design-tokens";
+export type KnowledgeFact = {
+    subject: string;
+    predicate: KnowledgePredicate;
+    object: unknown;
+    confidence: number;
+    source: KnowledgeSource;
+    evidence: KnowledgeEvidence[];
+    metadata?: Record<string, unknown>;
+};
+export type KnowledgeWorkspace = {
+    cwd: string;
+    packageName: string;
+    program: ts.Program;
+    checker: ts.TypeChecker;
+    discovery: {
+        includeKinds?: SemanticResourceKind[];
+        excludeKinds?: SemanticResourceKind[];
+    };
+};
+export interface KnowledgeProvider {
+    readonly id: string;
+    readonly requires?: readonly KnowledgePredicate[];
+    readonly provides: readonly KnowledgePredicate[];
+    collect(workspace: KnowledgeWorkspace, graph: KnowledgeGraphReader): Promise<KnowledgeFact[]>;
+}
+export interface KnowledgeGraphReader {
+    facts(predicate?: KnowledgePredicate): readonly KnowledgeFact[];
+    factsFor(subject: string, predicate?: KnowledgePredicate): readonly KnowledgeFact[];
+    resources(): readonly KnowledgeFact[];
+    relationships(subject?: string): readonly KnowledgeFact[];
+    examples(subject?: string): readonly KnowledgeFact[];
+    publicApi(subject: string): KnowledgeFact | undefined;
+    classification(subject: string): KnowledgeFact | undefined;
+}

package/dist/implementation/knowledge/model.js

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

package/dist/implementation/knowledge/model.js.map

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

package/dist/implementation/knowledge/persistence-policy.d.ts

@@ -0,0 +1,21 @@
+import type { DiscoveredResourceFact, ExtractedExample, ExtractedProp, ExtractedReactPatterns, ExtractedRelationship, ExtractionMetadata, PublicComponentApi } from "../contracts/resource";
+import type { KnowledgeGraphReader } from "./model";
+export type PersistentResourceKnowledge = {
+    resource: DiscoveredResourceFact;
+    props: Record<string, ExtractedProp>;
+    api?: PublicComponentApi;
+    relationships: ExtractedRelationship[];
+    examples: ExtractedExample[];
+    variants: string[];
+    storyFiles: string[];
+    react: ExtractedReactPatterns;
+    metadata: ExtractionMetadata;
+};
+export interface PersistencePolicy {
+    select(graph: KnowledgeGraphReader): PersistentResourceKnowledge[];
+}
+export declare class DescriptorPersistencePolicy implements PersistencePolicy {
+    private readonly excludedRelationshipTypes;
+    constructor(excludedRelationshipTypes?: ReadonlySet<ExtractedRelationship["type"]>);
+    select(graph: KnowledgeGraphReader): PersistentResourceKnowledge[];
+}