@exellix/ai-skills 6.5.4 → 6.8.0

package/dist/catalox/ai-sub-skills-catalog.js

@@ -0,0 +1,72 @@
+/** Catalox `catalogId` for sub-skill override rows. */
+export const AI_SUB_SKILLS_CATALOG_ID = "ai-sub-skills";
+/** Descriptor version written by provision / migration scripts. */
+export const AI_SUB_SKILLS_DESCRIPTOR_VERSION = "1";
+export function buildAiSubSkillsCatalogDescriptor() {
+    return {
+        catalogId: AI_SUB_SKILLS_CATALOG_ID,
+        label: "AI Sub-Skills",
+        description: "Sub-skill override rows for @exellix/ai-skills (parent skill + data.overrides).",
+        itemLabel: "Sub-skill",
+        sourceMode: "native",
+        status: "active",
+        visibility: "visible",
+        defaultSort: { field: "subSkillKey", direction: "asc" },
+        capabilities: {
+            canList: true,
+            canGet: true,
+            canCreate: true,
+            canEdit: true,
+            canDelete: true,
+            canImport: true,
+            canExport: true,
+            canValidate: true,
+            canViewReferences: true,
+        },
+        queryableFields: [
+            {
+                key: "subSkillKey",
+                label: "Sub-skill key",
+                type: "string",
+                path: "subSkillKey",
+                indexed: true,
+                filterable: true,
+                sortable: true,
+                listVisible: true,
+                detailVisible: true,
+                required: true,
+            },
+            {
+                key: "parentSkillKey",
+                label: "Parent skill key",
+                type: "string",
+                path: "parentSkillKey",
+                indexed: true,
+                filterable: true,
+                sortable: true,
+                listVisible: true,
+                detailVisible: true,
+                required: true,
+            },
+            {
+                key: "overrides",
+                label: "Overrides",
+                type: "object",
+                path: "overrides",
+                indexed: false,
+                filterable: false,
+                sortable: false,
+                listVisible: false,
+                detailVisible: true,
+                required: true,
+            },
+        ],
+        identity: {
+            itemIdStrategy: "natural",
+            itemIdField: "subSkillKey",
+            titleField: "overrides.title",
+            statusField: "status",
+        },
+    };
+}
+//# sourceMappingURL=ai-sub-skills-catalog.js.map

package/dist/catalox/ai-sub-skills-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sub-skills-catalog.js","sourceRoot":"","sources":["../../src/catalox/ai-sub-skills-catalog.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAwB,CAAC;AAEjE,mEAAmE;AACnE,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAY,CAAC;AAE7D,MAAM,UAAU,iCAAiC;IAC7C,OAAO;QACH,SAAS,EAAE,wBAAwB;QACnC,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,iFAAiF;QAC9F,SAAS,EAAE,WAAW;QACtB,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE;QACvD,YAAY,EAAE;YACV,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI;YACjB,iBAAiB,EAAE,IAAI;SAC1B;QACD,eAAe,EAAE;YACb;gBACI,GAAG,EAAE,aAAa;gBAClB,KAAK,EAAE,eAAe;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,IAAI;gBACjB,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACjB;YACD;gBACI,GAAG,EAAE,gBAAgB;gBACrB,KAAK,EAAE,kBAAkB;gBACzB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,IAAI;gBACjB,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACjB;YACD;gBACI,GAAG,EAAE,WAAW;gBAChB,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,KAAK;gBAClB,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACjB;SACJ;QACD,QAAQ,EAAE;YACN,cAAc,EAAE,SAAS;YACzB,WAAW,EAAE,aAAa;YAC1B,UAAU,EAAE,iBAAiB;YAC7B,WAAW,EAAE,QAAQ;SACxB;KACJ,CAAC;AACN,CAAC"}

package/dist/catalox/catalog-guards.d.ts

@@ -0,0 +1,14 @@
+/** Flat optimixer keys rejected on normalized catalog rows (use `data.optimixer` instead). */
+export declare const DEPRECATED_FLAT_OPTIMIXER_DATA_KEYS: readonly ["optimixerReasoningEffort", "optimixerOutputIntentMode", "optimixerExpectedVisibleTokens", "optimixerOutputToInputRatio", "optimixerAcceptableRisk", "optimixerTaskType", "optimixerOutputMode", "optimixerSchemaComplexity"];
+export type CatalogGuardIssue = {
+    scope: string;
+    severity: "error" | "warn";
+    message: string;
+};
+/** Guard against forbidden model fields and deprecated row shapes on normalized catalogs. */
+export declare function validateNormalizedCatalogDataGuards(scope: string, data: Record<string, unknown>): CatalogGuardIssue[];
+export declare function collectCatalogGuardIssues(rows: Array<{
+    scope: string;
+    data: Record<string, unknown>;
+}>): CatalogGuardIssue[];
+//# sourceMappingURL=catalog-guards.d.ts.map

package/dist/catalox/catalog-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-guards.d.ts","sourceRoot":"","sources":["../../src/catalox/catalog-guards.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,eAAO,MAAM,mCAAmC,yOAStC,CAAC;AASX,MAAM,MAAM,iBAAiB,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAwBF,6FAA6F;AAC7F,wBAAgB,mCAAmC,CAC/C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,iBAAiB,EAAE,CA4CrB;AAED,wBAAgB,yBAAyB,CACrC,IAAI,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAC9D,iBAAiB,EAAE,CAMrB"}

package/dist/catalox/catalog-guards.js

@@ -0,0 +1,86 @@
+/** Flat optimixer keys rejected on normalized catalog rows (use `data.optimixer` instead). */
+export const DEPRECATED_FLAT_OPTIMIXER_DATA_KEYS = [
+    "optimixerReasoningEffort",
+    "optimixerOutputIntentMode",
+    "optimixerExpectedVisibleTokens",
+    "optimixerOutputToInputRatio",
+    "optimixerAcceptableRisk",
+    "optimixerTaskType",
+    "optimixerOutputMode",
+    "optimixerSchemaComplexity",
+];
+const FORBIDDEN_MODEL_DATA_KEYS = ["model", "modelId", "mainModel", "defaultModel", "skillModel"];
+const DEPRECATED_BASE_DATA_KEYS = ["skillKey", "status", "isLocal", "parentSkillKey"];
+const CONCRETE_MODEL_PATTERN = /^(?:openrouter\/)?(?:google|anthropic|openai|x-ai|meta-llama|mistralai|deepseek|cohere)\/[\w.-]+$/i;
+function asString(v) {
+    return typeof v === "string" ? v.trim() : "";
+}
+function checkModelValue(scope, field, value, issues) {
+    if (value === undefined || value === null)
+        return;
+    const s = asString(value);
+    if (!s)
+        return;
+    issues.push({
+        scope,
+        severity: "error",
+        message: `Forbidden catalog model field ${field}=${s} (use ai-profiles at invoke time).`,
+    });
+    if (CONCRETE_MODEL_PATTERN.test(s) || s.includes("/")) {
+        issues.push({
+            scope,
+            severity: "error",
+            message: `Concrete wire model slug in catalog ${field}: ${s}`,
+        });
+    }
+}
+/** Guard against forbidden model fields and deprecated row shapes on normalized catalogs. */
+export function validateNormalizedCatalogDataGuards(scope, data) {
+    const issues = [];
+    for (const key of FORBIDDEN_MODEL_DATA_KEYS) {
+        checkModelValue(scope, `data.${key}`, data[key], issues);
+    }
+    for (const key of DEPRECATED_BASE_DATA_KEYS) {
+        if (data[key] !== undefined) {
+            issues.push({
+                scope,
+                severity: "warn",
+                message: `Deprecated catalog data field data.${key} — remove from normalized row.`,
+            });
+        }
+    }
+    for (const key of DEPRECATED_FLAT_OPTIMIXER_DATA_KEYS) {
+        if (data[key] !== undefined) {
+            issues.push({
+                scope,
+                severity: "warn",
+                message: `Deprecated flat optimixer field data.${key} — use data.optimixer.`,
+            });
+        }
+    }
+    const overrides = data.overrides;
+    if (overrides != null && typeof overrides === "object" && !Array.isArray(overrides)) {
+        const ov = overrides;
+        for (const key of FORBIDDEN_MODEL_DATA_KEYS) {
+            checkModelValue(scope, `data.overrides.${key}`, ov[key], issues);
+        }
+        for (const key of DEPRECATED_FLAT_OPTIMIXER_DATA_KEYS) {
+            if (ov[key] !== undefined) {
+                issues.push({
+                    scope,
+                    severity: "warn",
+                    message: `Deprecated flat optimixer in overrides: ${key}`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+export function collectCatalogGuardIssues(rows) {
+    const out = [];
+    for (const row of rows) {
+        out.push(...validateNormalizedCatalogDataGuards(row.scope, row.data));
+    }
+    return out;
+}
+//# sourceMappingURL=catalog-guards.js.map

package/dist/catalox/catalog-guards.js.map

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

package/dist/catalox/catalog-native-store.d.ts

@@ -0,0 +1,21 @@
+import type { NativeCatalogItemRecord } from "@x12i/catalox";
+import type { Firestore } from "firebase-admin/firestore";
+import type { NativeItemStore } from "@x12i/catalox/firebase";
+import { storageDocIdForNativeRecord } from "@x12i/catalox/firebase";
+export type CatalogNativeStore = {
+    /** Full document replace (no Firestore merge — required to drop deprecated fields). */
+    replace(catalogId: string, record: NativeCatalogItemRecord): Promise<void>;
+    delete(catalogId: string, storageDocId: string): Promise<void>;
+    get(catalogId: string, storageDocId: string): Promise<NativeCatalogItemRecord | null>;
+    findByLogicalItemId(catalogId: string, itemId: string): Promise<NativeCatalogItemRecord[]>;
+};
+/** Test hook — replaces Firestore-backed store in unit tests. */
+export declare function setCatalogNativeStoreForTests(store: CatalogNativeStore | null): void;
+export declare function createInMemoryCatalogNativeStore(initial?: Record<string, NativeCatalogItemRecord[]>): CatalogNativeStore;
+export declare function createCatalogNativeStore(firestore: Firestore, nativeStore: NativeItemStore): CatalogNativeStore;
+export declare function getNativeCatalogRecord(catalogId: string, itemId: string): Promise<NativeCatalogItemRecord | null>;
+export declare function replaceNativeCatalogRecord(catalogId: string, record: NativeCatalogItemRecord): Promise<void>;
+export declare function replaceNativeCatalogRecords(catalogId: string, records: NativeCatalogItemRecord[]): Promise<void>;
+export declare function deleteNativeCatalogRecordByItemId(catalogId: string, itemId: string, existing?: NativeCatalogItemRecord | null): Promise<void>;
+export { storageDocIdForNativeRecord };
+//# sourceMappingURL=catalog-native-store.d.ts.map

package/dist/catalox/catalog-native-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-native-store.d.ts","sourceRoot":"","sources":["../../src/catalox/catalog-native-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAGH,2BAA2B,EAC9B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,kBAAkB,GAAG;IAC7B,uFAAuF;IACvF,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;IACtF,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CAC9F,CAAC;AAIF,iEAAiE;AACjE,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAEpF;AAED,wBAAgB,gCAAgC,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAM,GAAG,kBAAkB,CA0B5H;AAWD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,GAAG,kBAAkB,CAiB/G;AAmBD,wBAAsB,sBAAsB,CACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAIzC;AAED,wBAAsB,0BAA0B,CAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,2BAA2B,CAC7C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,uBAAuB,EAAE,GACnC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,iCAAiC,CACnD,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,uBAAuB,GAAG,IAAI,GAC1C,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/catalox/catalog-native-store.js

@@ -0,0 +1,101 @@
+import { flatNativeItemsCollectionRef, resolveNativeItemsLayout, storageDocIdForNativeRecord, } from "@x12i/catalox/firebase";
+let testStoreOverride = null;
+/** Test hook — replaces Firestore-backed store in unit tests. */
+export function setCatalogNativeStoreForTests(store) {
+    testStoreOverride = store;
+}
+export function createInMemoryCatalogNativeStore(initial = {}) {
+    const byCatalog = new Map();
+    for (const [catalogId, rows] of Object.entries(initial)) {
+        byCatalog.set(catalogId, new Map(rows.map((r) => [String(r.itemId), { ...r, catalogId }])));
+    }
+    const ensure = (catalogId) => {
+        if (!byCatalog.has(catalogId))
+            byCatalog.set(catalogId, new Map());
+        return byCatalog.get(catalogId);
+    };
+    return {
+        async replace(catalogId, record) {
+            ensure(catalogId).set(String(record.itemId), { ...record, catalogId });
+        },
+        async delete(_catalogId, storageDocId) {
+            for (const m of byCatalog.values()) {
+                m.delete(storageDocId);
+            }
+        },
+        async get(catalogId, storageDocId) {
+            return ensure(catalogId).get(storageDocId) ?? null;
+        },
+        async findByLogicalItemId(catalogId, itemId) {
+            const row = ensure(catalogId).get(itemId);
+            return row ? [row] : [];
+        },
+    };
+}
+async function collectionForCatalog(firestore, catalogId) {
+    const layout = await resolveNativeItemsLayout(firestore, catalogId);
+    if (layout === "legacy") {
+        const { legacyNativeItemsCollectionRef } = await import("@x12i/catalox/firebase");
+        return legacyNativeItemsCollectionRef(firestore, catalogId);
+    }
+    return flatNativeItemsCollectionRef(firestore, catalogId);
+}
+export function createCatalogNativeStore(firestore, nativeStore) {
+    return {
+        async replace(catalogId, record) {
+            const col = await collectionForCatalog(firestore, catalogId);
+            const docId = storageDocIdForNativeRecord(record);
+            await col.doc(docId).set(record);
+        },
+        async delete(catalogId, storageDocId) {
+            await nativeStore.delete(catalogId, storageDocId);
+        },
+        async get(catalogId, storageDocId) {
+            return nativeStore.get(catalogId, storageDocId);
+        },
+        async findByLogicalItemId(catalogId, itemId) {
+            return nativeStore.findByLogicalItemId(catalogId, itemId);
+        },
+    };
+}
+let cachedStore = null;
+async function resolveCatalogNativeStore() {
+    if (testStoreOverride)
+        return testStoreOverride;
+    if (cachedStore)
+        return cachedStore;
+    const { getFirestore } = await import("firebase-admin/firestore");
+    const { getApp } = await import("firebase-admin/app");
+    const { FirestoreStore, NativeItemStore } = await import("@x12i/catalox/firebase");
+    const { initFirebaseAdminFromEnv } = await import("./init-firebase-and-catalox.js");
+    initFirebaseAdminFromEnv();
+    const dbId = process.env.FIRESTORE_DATABASE_ID?.trim();
+    const firestore = dbId ? getFirestore(dbId) : getFirestore();
+    const fsStore = new FirestoreStore({ firestore, app: getApp() });
+    cachedStore = createCatalogNativeStore(firestore, new NativeItemStore(fsStore));
+    return cachedStore;
+}
+export async function getNativeCatalogRecord(catalogId, itemId) {
+    const store = await resolveCatalogNativeStore();
+    const rows = await store.findByLogicalItemId(catalogId, itemId);
+    return rows[0] ?? null;
+}
+export async function replaceNativeCatalogRecord(catalogId, record) {
+    const store = await resolveCatalogNativeStore();
+    await store.replace(catalogId, record);
+}
+export async function replaceNativeCatalogRecords(catalogId, records) {
+    for (const record of records) {
+        await replaceNativeCatalogRecord(catalogId, record);
+    }
+}
+export async function deleteNativeCatalogRecordByItemId(catalogId, itemId, existing) {
+    const store = await resolveCatalogNativeStore();
+    const rec = existing ?? (await getNativeCatalogRecord(catalogId, itemId));
+    if (!rec)
+        return;
+    const docId = storageDocIdForNativeRecord(rec);
+    await store.delete(catalogId, docId);
+}
+export { storageDocIdForNativeRecord };
+//# sourceMappingURL=catalog-native-store.js.map

package/dist/catalox/catalog-native-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-native-store.js","sourceRoot":"","sources":["../../src/catalox/catalog-native-store.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,4BAA4B,EAC5B,wBAAwB,EACxB,2BAA2B,GAC9B,MAAM,wBAAwB,CAAC;AAUhC,IAAI,iBAAiB,GAA8B,IAAI,CAAC;AAExD,iEAAiE;AACjE,MAAM,UAAU,6BAA6B,CAAC,KAAgC;IAC1E,iBAAiB,GAAG,KAAK,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,UAAqD,EAAE;IACpG,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgD,CAAC;IAC1E,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,SAAiB,EAAE,EAAE;QACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACnE,OAAO,SAAS,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;IACrC,CAAC,CAAC;IACF,OAAO;QACH,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM;YAC3B,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY;YACjC,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;gBACjC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,YAAY;YAC7B,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM;YACvC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1C,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5B,CAAC;KACJ,CAAC;AACN,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,SAAoB,EAAE,SAAiB;IACvE,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACpE,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,EAAE,8BAA8B,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAClF,OAAO,8BAA8B,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,4BAA4B,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,SAAoB,EAAE,WAA4B;IACvF,OAAO;QACH,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM;YAC3B,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC7D,MAAM,KAAK,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY;YAChC,MAAM,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,YAAY;YAC7B,OAAO,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM;YACvC,OAAO,WAAW,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC9D,CAAC;KACJ,CAAC;AACN,CAAC;AAED,IAAI,WAAW,GAA8B,IAAI,CAAC;AAElD,KAAK,UAAU,yBAAyB;IACpC,IAAI,iBAAiB;QAAE,OAAO,iBAAiB,CAAC;IAChD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAClE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACtD,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACnF,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;IACpF,wBAAwB,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACjE,WAAW,GAAG,wBAAwB,CAAC,SAAS,EAAE,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAChF,OAAO,WAAW,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CACxC,SAAiB,EACjB,MAAc;IAEd,MAAM,KAAK,GAAG,MAAM,yBAAyB,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC5C,SAAiB,EACjB,MAA+B;IAE/B,MAAM,KAAK,GAAG,MAAM,yBAAyB,EAAE,CAAC;IAChD,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC7C,SAAiB,EACjB,OAAkC;IAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,0BAA0B,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACnD,SAAiB,EACjB,MAAc,EACd,QAAyC;IAEzC,MAAM,KAAK,GAAG,MAAM,yBAAyB,EAAE,CAAC;IAChD,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAC,MAAM,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,KAAK,GAAG,2BAA2B,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/catalox/catalog-normalization.d.ts

@@ -0,0 +1,70 @@
+import type { NativeCatalogItemRecord } from "@x12i/catalox";
+import type { SkillOptimixerCatalogSpec } from "./skill-optimixer-catalog.js";
+import type { SkillCatalogStatus } from "./skill-templates.js";
+/** Fields compared when computing sub-skill overrides against a parent row. */
+export declare const SUB_SKILL_OVERRIDE_FIELDS: readonly ["title", "description", "instructionsText", "promptText", "auditInstructionsText", "auditPromptText", "optimixer"];
+export type SubSkillOverrideField = (typeof SUB_SKILL_OVERRIDE_FIELDS)[number];
+export type SubSkillOverrides = Partial<Record<Exclude<SubSkillOverrideField, "optimixer">, string> & {
+    optimixer?: SkillOptimixerCatalogSpec;
+}>;
+export type ResolvedBaseSkillData = {
+    skillKey: string;
+    status: SkillCatalogStatus;
+    title: string;
+    description: string;
+    instructionsText?: string;
+    promptText?: string;
+    auditInstructionsText?: string;
+    auditPromptText?: string;
+    optimixer: SkillOptimixerCatalogSpec;
+};
+export type ResolvedSubSkillData = {
+    subSkillKey: string;
+    parentSkillKey: string;
+    status: SkillCatalogStatus;
+    overrides: SubSkillOverrides;
+};
+export type ResolvedRuntimeSkillData = ResolvedBaseSkillData & {
+    parentSkillKey?: string;
+    subSkillKey?: string;
+};
+/** Read `indexed.skillKey`, falling back to `itemId` when list API omits indexed fields. */
+export declare function readIndexedSkillKey(record: NativeCatalogItemRecord): string;
+/** Read `indexed.subSkillKey`, falling back to `itemId` when list API omits indexed fields. */
+export declare function readIndexedSubSkillKey(record: NativeCatalogItemRecord): string;
+export declare function readIndexedParentSkillKey(record: NativeCatalogItemRecord): string;
+/** Whether an ai-skills base row matches normalized invariants. */
+export declare function isNormalizedAiSkillsBaseRecord(record: NativeCatalogItemRecord): boolean;
+/** Whether an ai-sub-skills row matches normalized invariants. */
+export declare function isNormalizedAiSubSkillsRecord(record: NativeCatalogItemRecord): boolean;
+/** Resolve a normalized ai-skills base row into runtime skill data. */
+export declare function resolveBaseSkillFromRecord(record: NativeCatalogItemRecord, skillKeyForErrors: string): ResolvedBaseSkillData;
+/** Resolve a normalized ai-sub-skills row into runtime sub-skill data. */
+export declare function resolveSubSkillFromRecord(record: NativeCatalogItemRecord): ResolvedSubSkillData;
+export declare function mergeSubSkillWithParent(parent: ResolvedBaseSkillData, sub: ResolvedSubSkillData): ResolvedRuntimeSkillData;
+/** Build overrides by diffing child runtime fields against a resolved parent row. */
+export declare function computeSubSkillOverrides(parent: ResolvedBaseSkillData, child: ResolvedRuntimeSkillData): SubSkillOverrides;
+/** Build normalized ai-skills base write payload from runtime fields. */
+export declare function buildAiSkillsBaseWriteRecord(input: {
+    itemId: string;
+    catalogId: string;
+    status: SkillCatalogStatus;
+    title: string;
+    description: string;
+    instructionsText: string;
+    promptText: string;
+    auditInstructionsText?: string;
+    auditPromptText?: string;
+    optimixer: SkillOptimixerCatalogSpec;
+    existing?: NativeCatalogItemRecord | null;
+}): NativeCatalogItemRecord;
+/** Build normalized ai-sub-skills write payload. */
+export declare function buildAiSubSkillsWriteRecord(input: {
+    itemId: string;
+    catalogId: string;
+    parentSkillKey: string;
+    status: SkillCatalogStatus;
+    overrides: SubSkillOverrides;
+    existing?: NativeCatalogItemRecord | null;
+}): NativeCatalogItemRecord;
+//# sourceMappingURL=catalog-normalization.d.ts.map

package/dist/catalox/catalog-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-normalization.d.ts","sourceRoot":"","sources":["../../src/catalox/catalog-normalization.ts"],"names":[],"mappings":"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"}