@mimir-labs/core 0.2.0 → 0.4.0

package/dist/implementation/generation/resource-builders/component-builder.d.ts

@@ -1,2 +1,3 @@
+import type { AuthoredKnowledge } from "../../authoring/knowledge-loader";
 import type { ExtractedComponentFact, GeneratedComponentResource, ReadmeFacts, StorybookFacts } from "../types";
-export declare function buildComponentResource(component: ExtractedComponentFact, storybook: StorybookFacts, readme: ReadmeFacts): GeneratedComponentResource;
+export declare function buildComponentResource(component: ExtractedComponentFact, storybook: StorybookFacts, readme: ReadmeFacts, authored?: AuthoredKnowledge | null): GeneratedComponentResource;

package/dist/implementation/generation/resource-builders/component-builder.js

@@ -3,8 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildComponentResource = buildComponentResource;
 const provenance_builder_1 = require("../provenance/provenance-builder");
 const resource_identity_1 = require("../../resource-identity");
-function buildComponentResource(component, storybook, readme) {
-    const description = readme.descriptionsByComponent[component.name] ?? "";
+function buildComponentResource(component, storybook, readme, authored = null) {
+    const authoredDescription = authored?.knowledge.description.trim() ?? "";
+    const description = authoredDescription || readme.descriptionsByComponent[component.name] || "";
+    const whenToUse = authored?.knowledge.whenToUse ?? [];
+    const whenNotToUse = authored?.knowledge.whenNotToUse ?? [];
     const variants = storybook.variantsByComponent[component.name] ?? [];
     const storyFiles = storybook.storyFilesByComponent[component.name] ?? [];
     const evidenceByField = {
@@ -13,9 +16,11 @@ function buildComponentResource(component, storybook, readme) {
         package: { evidence: [(0, provenance_builder_1.fromPackageJson)()] },
         import: { evidence: [(0, provenance_builder_1.fromTypeScript)(component.filePath)] },
         description: {
-            evidence: description !== ""
-                ? [(0, provenance_builder_1.fromReadme)("README.md")]
-                : [(0, provenance_builder_1.missingHumanSource)("description")]
+            evidence: authoredDescription !== "" && authored
+                ? [(0, provenance_builder_1.fromHumanKnowledge)(authored.sourceRef)]
+                : description !== ""
+                    ? [(0, provenance_builder_1.fromReadme)("README.md")]
+                    : [(0, provenance_builder_1.missingHumanSource)("description")]
         },
         props: { evidence: [(0, provenance_builder_1.fromTypeScript)(component.filePath)] },
         variants: {
@@ -23,8 +28,16 @@ function buildComponentResource(component, storybook, readme) {
                 ? storyFiles.map((file) => (0, provenance_builder_1.fromStorybook)(file))
                 : [(0, provenance_builder_1.missingHumanSource)("variants")]
         },
-        whenToUse: { evidence: [(0, provenance_builder_1.missingHumanSource)("whenToUse")] },
-        whenNotToUse: { evidence: [(0, provenance_builder_1.missingHumanSource)("whenNotToUse")] }
+        whenToUse: {
+            evidence: whenToUse.length > 0 && authored
+                ? [(0, provenance_builder_1.fromHumanKnowledge)(authored.sourceRef)]
+                : [(0, provenance_builder_1.missingHumanSource)("whenToUse")]
+        },
+        whenNotToUse: {
+            evidence: whenNotToUse.length > 0 && authored
+                ? [(0, provenance_builder_1.fromHumanKnowledge)(authored.sourceRef)]
+                : [(0, provenance_builder_1.missingHumanSource)("whenNotToUse")]
+        }
     };
     return {
         type: "component",
@@ -35,8 +48,8 @@ function buildComponentResource(component, storybook, readme) {
         description,
         props: component.props,
         variants,
-        whenToUse: [],
-        whenNotToUse: [],
+        whenToUse,
+        whenNotToUse,
         governance: {
             fields: evidenceByField
         }

package/dist/implementation/generation/resource-builders/component-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-builder.js","sourceRoot":"","sources":["../../../../src/implementation/generation/resource-builders/component-builder.ts"],"names":[],"mappings":";;AAeA,wDA8CC;AA7DD,yEAM0C;AAC1C,+DAAoE;AAQpE,SAAgB,sBAAsB,CACpC,SAAiC,EACjC,SAAyB,EACzB,MAAmB;IAEnB,MAAM,WAAW,GAAG,MAAM,CAAC,uBAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACzE,MAAM,QAAQ,GAAG,SAAS,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrE,MAAM,UAAU,GAAG,SAAS,CAAC,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAEzE,MAAM,eAAe,GAAuE;QAC1F,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,oCAAe,GAAE,CAAC,EAAE;QACrC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,mCAAc,EAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE;QACxD,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,oCAAe,GAAE,CAAC,EAAE;QAC1C,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,mCAAc,EAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE;QAC1D,WAAW,EAAE;YACX,QAAQ,EACN,WAAW,KAAK,EAAE;gBAChB,CAAC,CAAC,CAAC,IAAA,+BAAU,EAAC,WAAW,CAAC,CAAC;gBAC3B,CAAC,CAAC,CAAC,IAAA,uCAAkB,EAAC,aAAa,CAAC,CAAC;SAC1C;QACD,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,mCAAc,EAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE;QACzD,QAAQ,EAAE;YACR,QAAQ,EACN,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBAC1C,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,kCAAa,EAAC,IAAI,CAAC,CAAC;gBAC/C,CAAC,CAAC,CAAC,IAAA,uCAAkB,EAAC,UAAU,CAAC,CAAC;SACvC;QACD,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,uCAAkB,EAAC,WAAW,CAAC,CAAC,EAAE;QAC1D,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,uCAAkB,EAAC,cAAc,CAAC,CAAC,EAAE;KACjE,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,IAAA,6CAAyB,EAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC;QACpE,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EAAE,SAAS,CAAC,WAAW;QAC9B,MAAM,EAAE,SAAS,CAAC,UAAU;QAC5B,WAAW;QACX,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,QAAQ;QACR,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE;YACV,MAAM,EAAE,eAAe;SACxB;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"component-builder.js","sourceRoot":"","sources":["../../../../src/implementation/generation/resource-builders/component-builder.ts"],"names":[],"mappings":"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"}

package/dist/implementation/generation/types.d.ts

@@ -1,3 +1,4 @@
+import type { ExtractedProp } from "../contracts/resource";
 export type EvidenceConfidence = "high" | "medium" | "low";
 export type FieldEvidence = {
     sourceType: string;
@@ -9,25 +10,6 @@ export type GeneratedField<T> = {
     value: T;
     evidence: FieldEvidence[];
 };
-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[]>;
-};
-export type ReadmeFacts = {
-    descriptionsByComponent: Record<string, string>;
-};
 export type GeneratedComponentResource = {
     type: "component";
     id: string;

package/dist/implementation/generators/aps-generator.js

@@ -5,7 +5,7 @@ const generate_service_1 = require("../generation/generate-service");
 exports.apsGenerator = {
     name: "aps",
     async generate(cwd, options) {
-        return (0, generate_service_1.generateApsFromEvidence)(cwd, options ?? {});
+        return (0, generate_service_1.compileApsFromDescriptors)(cwd, options ?? {});
     }
 };
 //# sourceMappingURL=aps-generator.js.map

package/dist/implementation/generators/aps-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"aps-generator.js","sourceRoot":"","sources":["../../../src/implementation/generators/aps-generator.ts"],"names":[],"mappings":";;;AAAA,qEAAyE;AAQ5D,QAAA,YAAY,GAAuD;IAC9E,IAAI,EAAE,KAAK;IACX,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,OAA4B;QACtD,OAAO,IAAA,0CAAuB,EAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;CACF,CAAC"}
+{"version":3,"file":"aps-generator.js","sourceRoot":"","sources":["../../../src/implementation/generators/aps-generator.ts"],"names":[],"mappings":";;;AAAA,qEAA2E;AAQ9D,QAAA,YAAY,GAAuD;IAC9E,IAAI,EAAE,KAAK;IACX,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,OAA4B;QACtD,OAAO,IAAA,4CAAyB,EAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;CACF,CAAC"}

package/dist/implementation/resource-discovery/storybook-extractor.d.ts

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

package/dist/implementation/resource-discovery/storybook-extractor.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractStorybookFacts = extractStorybookFacts;
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = require("node:fs/promises");
+const fs_1 = require("../io/fs");
+function normalizeSlashes(value) {
+    return value.split(node_path_1.default.sep).join("/");
+}
+async function collectStoryFiles(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 (entry.name === "node_modules" || entry.name === "dist" || entry.name.startsWith(".")) {
+                continue;
+            }
+            files.push(...(await collectStoryFiles(absolutePath)));
+            continue;
+        }
+        if (entry.isFile() && entry.name.includes(".stories.")) {
+            files.push(absolutePath);
+        }
+    }
+    return files;
+}
+async function extractStorybookFacts(cwd) {
+    const files = await collectStoryFiles(cwd);
+    const variantsByComponent = {};
+    const storyFilesByComponent = {};
+    for (const file of files) {
+        const content = await (0, fs_1.readText)(file);
+        const componentMatch = /component\s*:\s*([A-Z][A-Za-z0-9_]*)/.exec(content);
+        if (!componentMatch) {
+            continue;
+        }
+        const componentName = componentMatch[1];
+        if (!variantsByComponent[componentName]) {
+            variantsByComponent[componentName] = [];
+            storyFilesByComponent[componentName] = [];
+        }
+        const relativeFile = normalizeSlashes(node_path_1.default.relative(cwd, file));
+        storyFilesByComponent[componentName].push(relativeFile);
+        const variantPattern = /export\s+const\s+([A-Za-z][A-Za-z0-9_]*)\s*[:=]/g;
+        let match;
+        while ((match = variantPattern.exec(content)) !== null) {
+            const variantName = match[1];
+            if (!variantsByComponent[componentName].includes(variantName)) {
+                variantsByComponent[componentName].push(variantName);
+            }
+        }
+        variantsByComponent[componentName].sort((a, b) => a.localeCompare(b));
+    }
+    return {
+        variantsByComponent,
+        storyFilesByComponent
+    };
+}
+//# sourceMappingURL=storybook-extractor.js.map

package/dist/implementation/resource-discovery/storybook-extractor.js.map

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

package/dist/implementation/resource-discovery/typescript-extractor.d.ts

@@ -0,0 +1,2 @@
+import type { ExtractedComponentFact } from "../contracts/resource";
+export declare function extractTypeScriptComponents(cwd: string, packageName: string): Promise<ExtractedComponentFact[]>;

package/dist/implementation/resource-discovery/typescript-extractor.js

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTypeScriptComponents = extractTypeScriptComponents;
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = require("node:fs/promises");
+const fs_1 = require("../io/fs");
+const TS_EXTENSIONS = new Set([".ts", ".tsx"]);
+function isPascalCase(name) {
+    return /^[A-Z][A-Za-z0-9]*$/.test(name);
+}
+function normalizeSlashes(value) {
+    return value.split(node_path_1.default.sep).join("/");
+}
+async function collectFiles(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 (entry.name === "node_modules" || entry.name === "dist" || entry.name.startsWith(".")) {
+                continue;
+            }
+            files.push(...(await collectFiles(absolutePath)));
+            continue;
+        }
+        if (entry.isFile() &&
+            TS_EXTENSIONS.has(node_path_1.default.extname(entry.name)) &&
+            !entry.name.includes(".stories.")) {
+            files.push(absolutePath);
+        }
+    }
+    return files;
+}
+function extractExportedNames(content) {
+    const names = new Set();
+    const patterns = [
+        /export\s+function\s+([A-Z][A-Za-z0-9_]*)\s*\(/g,
+        /export\s+const\s+([A-Z][A-Za-z0-9_]*)\s*[:=]/g,
+        /export\s+class\s+([A-Z][A-Za-z0-9_]*)\s+/g,
+        /export\s+\{\s*([^}]+)\s*\}/g
+    ];
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            if (pattern.source.includes("[^}]+")) {
+                const tokens = match[1].split(",").map((item) => item.trim());
+                for (const token of tokens) {
+                    const aliasParts = token.split(/\s+as\s+/i).map((part) => part.trim());
+                    const candidate = aliasParts[aliasParts.length - 1];
+                    if (isPascalCase(candidate)) {
+                        names.add(candidate);
+                    }
+                }
+            }
+            else {
+                const candidate = match[1];
+                if (isPascalCase(candidate)) {
+                    names.add(candidate);
+                }
+            }
+        }
+    }
+    return [...names].sort((a, b) => a.localeCompare(b));
+}
+function parsePropsBlock(block) {
+    const result = {};
+    const lines = block.split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        const match = /^([A-Za-z_][A-Za-z0-9_]*)\??:\s*([^;]+);?$/.exec(trimmed);
+        if (!match) {
+            continue;
+        }
+        const propName = match[1];
+        const propType = match[2].trim();
+        const optional = trimmed.includes("?:");
+        result[propName] = {
+            name: propName,
+            type: propType,
+            required: !optional
+        };
+    }
+    return result;
+}
+function extractProps(content, componentName) {
+    const interfacePattern = new RegExp(`interface\\s+${componentName}Props\\s*\\{([\\s\\S]*?)\\}`, "m");
+    const typePattern = new RegExp(`type\\s+${componentName}Props\\s*=\\s*\\{([\\s\\S]*?)\\}`, "m");
+    const interfaceMatch = interfacePattern.exec(content);
+    if (interfaceMatch) {
+        return parsePropsBlock(interfaceMatch[1]);
+    }
+    const typeMatch = typePattern.exec(content);
+    if (typeMatch) {
+        return parsePropsBlock(typeMatch[1]);
+    }
+    return {};
+}
+async function extractTypeScriptComponents(cwd, packageName) {
+    const files = await collectFiles(cwd);
+    const components = [];
+    for (const filePath of files) {
+        const content = await (0, fs_1.readText)(filePath);
+        const exportedNames = extractExportedNames(content);
+        if (exportedNames.length === 0) {
+            continue;
+        }
+        const relativeFilePath = normalizeSlashes(node_path_1.default.relative(cwd, filePath));
+        for (const exportedName of exportedNames) {
+            components.push({
+                name: exportedName,
+                filePath: relativeFilePath,
+                importName: exportedName,
+                packageName,
+                props: extractProps(content, exportedName)
+            });
+        }
+    }
+    const unique = new Map();
+    for (const component of components) {
+        const key = component.name;
+        const previous = unique.get(key);
+        if (!previous) {
+            unique.set(key, component);
+            continue;
+        }
+        const previousScore = Object.keys(previous.props).length + (previous.filePath.endsWith("/index.ts") ? 0 : 1);
+        const candidateScore = Object.keys(component.props).length + (component.filePath.endsWith("/index.ts") ? 0 : 1);
+        if (candidateScore > previousScore) {
+            unique.set(key, component);
+        }
+    }
+    return [...unique.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=typescript-extractor.js.map

package/dist/implementation/resource-discovery/typescript-extractor.js.map

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

package/dist/implementation/services/authoring-service.d.ts

@@ -1,12 +1,21 @@
 type AuthoringOptions = {
     dryRun?: boolean;
+    refreshAuto?: boolean;
+    deleteOrphans?: boolean;
+    interactive?: boolean;
+    ai?: boolean;
 };
 export type AuthoringReport = {
     outputDir: string;
     discoveredResources: number;
     createdFiles: string[];
+    updatedFiles: string[];
     existingFiles: string[];
     plannedFiles: string[];
+    orphanedResources: string[];
+    deletedOrphans: string[];
+    pendingHumanResources: string[];
+    warnings: string[];
     dryRun: boolean;
 };
 export declare function runAuthoringWorkflow(cwd: string, options?: AuthoringOptions): Promise<AuthoringReport>;

package/dist/implementation/services/authoring-service.js

@@ -5,18 +5,98 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runAuthoringWorkflow = runAuthoringWorkflow;
 const node_path_1 = __importDefault(require("node:path"));
-const typescript_extractor_1 = require("../generation/extractors/typescript-extractor");
+const yaml_1 = require("yaml");
+const storybook_extractor_1 = require("../resource-discovery/storybook-extractor");
+const typescript_extractor_1 = require("../resource-discovery/typescript-extractor");
+const descriptor_discovery_1 = require("../descriptors/descriptor-discovery");
 const fs_1 = require("../io/fs");
+const json_1 = require("../io/json");
 const resource_identity_1 = require("../resource-identity");
-const AUTHORING_TEMPLATE = `description: ""
-# Describe brevemente qué hace este recurso.
-
-whenToUse: []
-# ¿Cuándo recomendarías utilizar este recurso?
-
-whenNotToUse: []
-# ¿En qué casos elegirías otra alternativa?
-`;
+function normalizeSlashes(value) {
+    return value.split(node_path_1.default.sep).join("/");
+}
+function toDescriptorPath(filePath) {
+    const ext = node_path_1.default.extname(filePath);
+    const base = node_path_1.default.basename(filePath, ext);
+    return node_path_1.default.join(node_path_1.default.dirname(filePath), `${base}.mimir.yaml`);
+}
+function toPropsArray(props) {
+    return Object.values(props)
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map((prop) => ({
+        name: prop.name,
+        type: prop.type ?? "unknown",
+        required: prop.required !== false
+    }));
+}
+function buildManagedAutoBlock(seed) {
+    return {
+        source: {
+            file: seed.sourceFile,
+            symbol: seed.name,
+            public: true
+        },
+        props: toPropsArray(seed.props),
+        variants: [...new Set(seed.variants)].sort((a, b) => a.localeCompare(b)),
+        storyFiles: [...new Set(seed.storyFiles)].sort((a, b) => a.localeCompare(b))
+    };
+}
+function patchManagedResourceAuto(existing, seed) {
+    // Hard boundary: preserve every field as-is and update only descriptor.auto.
+    return {
+        ...existing,
+        auto: buildManagedAutoBlock(seed)
+    };
+}
+function createManagedResource(seed) {
+    return {
+        kind: "component",
+        name: seed.name,
+        id: seed.id,
+        auto: buildManagedAutoBlock(seed),
+        human: {
+            description: "",
+            whenToUse: [],
+            whenNotToUse: []
+        }
+    };
+}
+function resourceIdentity(resource) {
+    const id = typeof resource.id === "string" ? resource.id : null;
+    if (id && id.trim() !== "") {
+        return id;
+    }
+    const kind = typeof resource.kind === "string" ? resource.kind.trim().toLowerCase() : "";
+    const name = typeof resource.name === "string" ? resource.name.trim() : "";
+    if (kind && name) {
+        return `${kind}:${name}`;
+    }
+    return null;
+}
+function isComponentResource(resource) {
+    return typeof resource.kind === "string" && resource.kind.trim().toLowerCase() === "component";
+}
+function toManagedSeeds(components, storybookFacts) {
+    const grouped = new Map();
+    for (const component of components) {
+        const resourceId = (0, resource_identity_1.createComponentResourceId)(component.packageName, component.name);
+        const descriptorRelativePath = normalizeSlashes(toDescriptorPath(component.filePath));
+        const seeds = grouped.get(descriptorRelativePath) ?? [];
+        seeds.push({
+            name: component.name,
+            id: resourceId,
+            sourceFile: normalizeSlashes(component.filePath),
+            props: component.props,
+            variants: storybookFacts.variantsByComponent[component.name] ?? [],
+            storyFiles: storybookFacts.storyFilesByComponent[component.name] ?? []
+        });
+        grouped.set(descriptorRelativePath, seeds);
+    }
+    return grouped;
+}
+function serializeDescriptorDocument(doc) {
+    return (0, yaml_1.stringify)(doc, { lineWidth: 120 });
+}
 async function readPackageName(cwd) {
     const packageJson = await (0, fs_1.readJson)(node_path_1.default.join(cwd, "package.json"));
     if (typeof packageJson.name !== "string" || packageJson.name.trim() === "") {
@@ -25,37 +105,149 @@ async function readPackageName(cwd) {
     return packageJson.name;
 }
 async function runAuthoringWorkflow(cwd, options = {}) {
+    const shouldRefreshAuto = options.refreshAuto !== false;
+    const shouldDeleteOrphans = options.deleteOrphans === true;
     const packageName = await readPackageName(cwd);
-    const components = await (0, typescript_extractor_1.extractTypeScriptComponents)(cwd, packageName);
-    const outputDir = node_path_1.default.join(cwd, "aps", "knowledge", "components");
+    const [components, storybookFacts] = await Promise.all([
+        (0, typescript_extractor_1.extractTypeScriptComponents)(cwd, packageName),
+        (0, storybook_extractor_1.extractStorybookFacts)(cwd)
+    ]);
+    const outputDir = cwd;
     const createdFiles = [];
+    const updatedFiles = [];
     const existingFiles = [];
     const plannedFiles = [];
-    for (const component of components) {
-        const resourceId = (0, resource_identity_1.createComponentResourceId)(component.packageName, component.name);
-        const filePath = node_path_1.default.join(outputDir, `${resourceId}.yaml`);
-        const relativePath = node_path_1.default.relative(cwd, filePath);
-        if (await (0, fs_1.fileExists)(filePath)) {
+    const orphanedResources = [];
+    const deletedOrphans = [];
+    const warnings = [];
+    if (options.interactive) {
+        warnings.push("--interactive is not implemented yet. Running sync-only mode.");
+    }
+    if (options.ai) {
+        warnings.push("--ai is not implemented yet. Running sync-only mode.");
+    }
+    const groupedDescriptors = toManagedSeeds(components, storybookFacts);
+    const existingDescriptorFiles = await (0, descriptor_discovery_1.discoverDescriptorFiles)(cwd);
+    const expectedDescriptorPaths = new Set(groupedDescriptors.keys());
+    const allDescriptorPaths = new Set([
+        ...existingDescriptorFiles,
+        ...expectedDescriptorPaths
+    ]);
+    for (const relativePath of [...allDescriptorPaths].sort((a, b) => a.localeCompare(b))) {
+        const filePath = node_path_1.default.join(cwd, relativePath);
+        const uniqueSeeds = new Map((groupedDescriptors.get(relativePath) ?? []).map((item) => [item.id, item]));
+        const seeds = [...uniqueSeeds.values()].sort((a, b) => a.name.localeCompare(b.name));
+        const seedByIdentityEntries = [
+            ...seeds.map((seed) => [seed.id, seed]),
+            ...seeds.map((seed) => [`component:${seed.name}`, seed])
+        ];
+        const seedByIdentity = new Map(seedByIdentityEntries);
+        let existingDoc = {
+            schemaVersion: 1,
+            resources: []
+        };
+        const fileAlreadyExists = await (0, fs_1.fileExists)(filePath);
+        if (fileAlreadyExists) {
+            try {
+                const parsed = (0, yaml_1.parse)(await (0, fs_1.readText)(filePath));
+                if ((0, json_1.isObject)(parsed)) {
+                    existingDoc = {
+                        ...parsed
+                    };
+                }
+                else {
+                    throw new Error(`${relativePath}: descriptor must be a YAML object`);
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`Invalid descriptor\n\n${relativePath}\n\nYAML parse error.\n${message}\n\nFix the descriptor before running author again.`);
+            }
+        }
+        const existingResourcesRaw = Array.isArray(existingDoc.resources) ? existingDoc.resources : [];
+        const existingResources = existingResourcesRaw.filter((item) => (0, json_1.isObject)(item));
+        const nextResources = [];
+        const consumedIdentities = new Set();
+        for (const existingResource of existingResources) {
+            const identity = resourceIdentity(existingResource);
+            if (!identity) {
+                nextResources.push(existingResource);
+                continue;
+            }
+            const seed = seedByIdentity.get(identity);
+            if (seed) {
+                const updated = shouldRefreshAuto ? patchManagedResourceAuto(existingResource, seed) : existingResource;
+                nextResources.push(updated);
+                consumedIdentities.add(identity);
+                if (identity === `component:${seed.name}`) {
+                    consumedIdentities.add(seed.id);
+                }
+                continue;
+            }
+            if (isComponentResource(existingResource) && typeof existingResource.id === "string") {
+                orphanedResources.push(`${relativePath}#${existingResource.id}`);
+                if (shouldDeleteOrphans) {
+                    deletedOrphans.push(`${relativePath}#${existingResource.id}`);
+                    continue;
+                }
+            }
+            nextResources.push(existingResource);
+        }
+        for (const seed of seeds) {
+            if (consumedIdentities.has(seed.id) || consumedIdentities.has(`component:${seed.name}`)) {
+                continue;
+            }
+            nextResources.push(createManagedResource(seed));
+        }
+        if (!fileAlreadyExists) {
+            if (options.dryRun) {
+                plannedFiles.push(relativePath);
+            }
+            else {
+                const doc = {
+                    schemaVersion: 1,
+                    resources: nextResources
+                };
+                await (0, fs_1.writeText)(filePath, serializeDescriptorDocument(doc));
+                createdFiles.push(relativePath);
+            }
+            continue;
+        }
+        const nextDoc = {
+            ...existingDoc,
+            resources: nextResources
+        };
+        const before = serializeDescriptorDocument(existingDoc).trim();
+        const after = serializeDescriptorDocument(nextDoc).trim();
+        if (before === after) {
             existingFiles.push(relativePath);
             continue;
         }
         if (options.dryRun) {
             plannedFiles.push(relativePath);
-            continue;
-        }
-        if (await (0, fs_1.writeTextIfMissing)(filePath, AUTHORING_TEMPLATE)) {
-            createdFiles.push(relativePath);
         }
         else {
-            existingFiles.push(relativePath);
+            await (0, fs_1.writeText)(filePath, `${after}\n`);
+            updatedFiles.push(relativePath);
         }
     }
+    const pendingHumanResources = [...allDescriptorPaths]
+        .sort((a, b) => a.localeCompare(b))
+        .flatMap((relativePath) => {
+        const seeds = groupedDescriptors.get(relativePath) ?? [];
+        return seeds.map((seed) => `${relativePath}#${seed.id}`);
+    });
     return {
-        outputDir: node_path_1.default.relative(cwd, outputDir),
+        outputDir: ".",
         discoveredResources: components.length,
         createdFiles,
+        updatedFiles,
         existingFiles,
         plannedFiles,
+        orphanedResources,
+        deletedOrphans,
+        pendingHumanResources,
+        warnings,
         dryRun: Boolean(options.dryRun)
     };
 }