npm - @teamix-evo/registry - Versions diffs - 0.1.0 → 0.3.0 - Mend

@teamix-evo/registry 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -10,7 +10,18 @@ declare const UpdateStrategySchema: z.ZodEnum<["frozen", "regenerable", "managed
 /**
  * Resource type discriminator.
  */
-declare const ResourceTypeSchema: z.ZodEnum<["doc", "tokens", "ai-rules", "config"]>;
+declare const ResourceTypeSchema: z.ZodEnum<["doc", "tokens", "ai-rules", "config", "skill"]>;
+/**
+ * Supported AI IDE identifiers for skill resources.
+ * Qoder and Claude Code share the same SKILL.md format; differ only by install path.
+ */
+declare const SkillIdeSchema: z.ZodEnum<["qoder", "claude"]>;
+/**
+ * Skill installation scope.
+ * - project: install under project root (.qoder/skills/, .claude/skills/)
+ * - global:  install under user home (~/.qoder/skills/, ~/.claude/skills/)
+ */
+declare const SkillScopeSchema: z.ZodEnum<["project", "global"]>;
 /**
  * A single resource entry within a variant manifest.
  */
@@ -18,10 +29,13 @@ declare const ResourceSchema: z.ZodObject<{
     /** Unique identifier for the resource within the manifest */
     id: z.ZodString;
     /** Resource type */
-    type: z.ZodEnum<["doc", "tokens", "ai-rules", "config"]>;
+    type: z.ZodEnum<["doc", "tokens", "ai-rules", "config", "skill"]>;
     /** Source path (relative to variant root), typically a template */
     source: z.ZodString;
-    /** Target path (relative to project root) where the resource is installed */
+    /**
+     * Target path (relative to project root) where the resource is installed.
+     * For type="skill" this is ignored: the path is computed from skill name + ide + scope.
+     */
     target: z.ZodString;
     /** How the resource is updated */
     updateStrategy: z.ZodEnum<["frozen", "regenerable", "managed"]>;
@@ -31,24 +45,32 @@ declare const ResourceSchema: z.ZodObject<{
     managedRegions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** Whether to recursively process directory contents */
     recursive: z.ZodOptional<z.ZodBoolean>;
+    /** Supported IDEs (only meaningful when type="skill"; defaults to all when omitted) */
+    ides: z.ZodOptional<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
+    /** Default install scope (only meaningful when type="skill"; user can override at install time) */
+    scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    type: "doc" | "tokens" | "ai-rules" | "config";
+    type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
     source: string;
     target: string;
     updateStrategy: "frozen" | "regenerable" | "managed";
     template?: boolean | undefined;
     managedRegions?: string[] | undefined;
     recursive?: boolean | undefined;
+    ides?: ("qoder" | "claude")[] | undefined;
+    scope?: "project" | "global" | undefined;
 }, {
     id: string;
-    type: "doc" | "tokens" | "ai-rules" | "config";
+    type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
     source: string;
     target: string;
     updateStrategy: "frozen" | "regenerable" | "managed";
     template?: boolean | undefined;
     managedRegions?: string[] | undefined;
     recursive?: boolean | undefined;
+    ides?: ("qoder" | "claude")[] | undefined;
+    scope?: "project" | "global" | undefined;
 }>;
 /**
  * Variant manifest schema — describes a variant package and its resources.
@@ -68,11 +90,11 @@ declare const VariantManifestSchema: z.ZodObject<{
     version: z.ZodString;
     /** Engine compatibility */
     engines: z.ZodObject<{
-        "teamix-evo": z.ZodString;
+        'teamix-evo': z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        "teamix-evo": string;
+        'teamix-evo': string;
     }, {
-        "teamix-evo": string;
+        'teamix-evo': string;
     }>;
     /** Supported IDE identifiers */
     ide: z.ZodArray<z.ZodString, "many">;
@@ -81,10 +103,13 @@ declare const VariantManifestSchema: z.ZodObject<{
         /** Unique identifier for the resource within the manifest */
         id: z.ZodString;
         /** Resource type */
-        type: z.ZodEnum<["doc", "tokens", "ai-rules", "config"]>;
+        type: z.ZodEnum<["doc", "tokens", "ai-rules", "config", "skill"]>;
         /** Source path (relative to variant root), typically a template */
         source: z.ZodString;
-        /** Target path (relative to project root) where the resource is installed */
+        /**
+         * Target path (relative to project root) where the resource is installed.
+         * For type="skill" this is ignored: the path is computed from skill name + ide + scope.
+         */
         target: z.ZodString;
         /** How the resource is updated */
         updateStrategy: z.ZodEnum<["frozen", "regenerable", "managed"]>;
@@ -94,24 +119,32 @@ declare const VariantManifestSchema: z.ZodObject<{
         managedRegions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         /** Whether to recursively process directory contents */
         recursive: z.ZodOptional<z.ZodBoolean>;
+        /** Supported IDEs (only meaningful when type="skill"; defaults to all when omitted) */
+        ides: z.ZodOptional<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
+        /** Default install scope (only meaningful when type="skill"; user can override at install time) */
+        scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
     }, "strip", z.ZodTypeAny, {
         id: string;
-        type: "doc" | "tokens" | "ai-rules" | "config";
+        type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
         source: string;
         target: string;
         updateStrategy: "frozen" | "regenerable" | "managed";
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         recursive?: boolean | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
     }, {
         id: string;
-        type: "doc" | "tokens" | "ai-rules" | "config";
+        type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
         source: string;
         target: string;
         updateStrategy: "frozen" | "regenerable" | "managed";
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         recursive?: boolean | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     schemaVersion: 1;
@@ -121,18 +154,20 @@ declare const VariantManifestSchema: z.ZodObject<{
     description: string;
     version: string;
     engines: {
-        "teamix-evo": string;
+        'teamix-evo': string;
     };
     ide: string[];
     resources: {
         id: string;
-        type: "doc" | "tokens" | "ai-rules" | "config";
+        type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
         source: string;
         target: string;
         updateStrategy: "frozen" | "regenerable" | "managed";
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         recursive?: boolean | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
     }[];
     $schema?: string | undefined;
 }, {
@@ -143,36 +178,1382 @@ declare const VariantManifestSchema: z.ZodObject<{
     description: string;
     version: string;
     engines: {
-        "teamix-evo": string;
+        'teamix-evo': string;
     };
     ide: string[];
     resources: {
         id: string;
-        type: "doc" | "tokens" | "ai-rules" | "config";
+        type: "doc" | "tokens" | "ai-rules" | "config" | "skill";
         source: string;
         target: string;
         updateStrategy: "frozen" | "regenerable" | "managed";
         template?: boolean | undefined;
         managedRegions?: string[] | undefined;
         recursive?: boolean | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
+    }[];
+    $schema?: string | undefined;
+}>;
+/**
+ * A single skill entry within a skills package manifest.
+ */
+declare const SkillEntrySchema: z.ZodObject<{
+    /** Skill identifier (matches name/folder) */
+    id: z.ZodString;
+    /** Skill name — must match the directory name and frontmatter `name` */
+    name: z.ZodString;
+    /** One-line description for skill discovery */
+    description: z.ZodString;
+    /** Semver version */
+    version: z.ZodString;
+    /** Source path relative to package root — file or directory */
+    source: z.ZodString;
+    /** Supported IDEs (defaults to both when omitted) */
+    ides: z.ZodDefault<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
+    /** Update strategy (defaults to managed) */
+    updateStrategy: z.ZodDefault<z.ZodEnum<["frozen", "regenerable", "managed"]>>;
+    /** Managed region IDs to maintain on update */
+    managedRegions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Whether the source is a Handlebars template */
+    template: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Variant identifier when this skill is bound to a specific design variant
+     * (e.g. `"opentrek"`, `"uni-manager"`). Optional — neutral skills (manage,
+     * coding-conventions, baseline design-rules) leave it unset.
+     *
+     * When present, the CLI installs this skill ONLY if the consumer's
+     * `.teamix-evo/design/pack.lock.json` records the same variant. MUST equal
+     * the variant directory name in `@teamix-evo/design/variants/<name>/`.
+     *
+     * Mirrors `UiEntrySchema.variant` semantics in @teamix-evo/biz-ui &
+     * @teamix-evo/templates per ADR 0014.
+     */
+    variant: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    source: string;
+    updateStrategy: "frozen" | "regenerable" | "managed";
+    ides: ("qoder" | "claude")[];
+    description: string;
+    version: string;
+    name: string;
+    template?: boolean | undefined;
+    managedRegions?: string[] | undefined;
+    variant?: string | undefined;
+}, {
+    id: string;
+    source: string;
+    description: string;
+    version: string;
+    name: string;
+    updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+    template?: boolean | undefined;
+    managedRegions?: string[] | undefined;
+    ides?: ("qoder" | "claude")[] | undefined;
+    variant?: string | undefined;
+}>;
+/**
+ * Skills package manifest schema — top-level manifest of `@teamix-evo/skills`.
+ * Skills are stored flat in the manifest. Variant binding is expressed via
+ * the optional `variant` field on each entry (see SkillEntrySchema).
+ */
+declare const SkillsPackageManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    /** Always "skills" for this package */
+    package: z.ZodLiteral<"skills">;
+    /** Semver version of the skills package */
+    version: z.ZodString;
+    /** Engine compatibility */
+    engines: z.ZodObject<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        'teamix-evo': string;
+    }>;
+    /** Flat list of skills shipped by this package */
+    skills: z.ZodArray<z.ZodObject<{
+        /** Skill identifier (matches name/folder) */
+        id: z.ZodString;
+        /** Skill name — must match the directory name and frontmatter `name` */
+        name: z.ZodString;
+        /** One-line description for skill discovery */
+        description: z.ZodString;
+        /** Semver version */
+        version: z.ZodString;
+        /** Source path relative to package root — file or directory */
+        source: z.ZodString;
+        /** Supported IDEs (defaults to both when omitted) */
+        ides: z.ZodDefault<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
+        /** Update strategy (defaults to managed) */
+        updateStrategy: z.ZodDefault<z.ZodEnum<["frozen", "regenerable", "managed"]>>;
+        /** Managed region IDs to maintain on update */
+        managedRegions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Whether the source is a Handlebars template */
+        template: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * Variant identifier when this skill is bound to a specific design variant
+         * (e.g. `"opentrek"`, `"uni-manager"`). Optional — neutral skills (manage,
+         * coding-conventions, baseline design-rules) leave it unset.
+         *
+         * When present, the CLI installs this skill ONLY if the consumer's
+         * `.teamix-evo/design/pack.lock.json` records the same variant. MUST equal
+         * the variant directory name in `@teamix-evo/design/variants/<name>/`.
+         *
+         * Mirrors `UiEntrySchema.variant` semantics in @teamix-evo/biz-ui &
+         * @teamix-evo/templates per ADR 0014.
+         */
+        variant: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        source: string;
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        ides: ("qoder" | "claude")[];
+        description: string;
+        version: string;
+        name: string;
+        template?: boolean | undefined;
+        managedRegions?: string[] | undefined;
+        variant?: string | undefined;
+    }, {
+        id: string;
+        source: string;
+        description: string;
+        version: string;
+        name: string;
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        managedRegions?: string[] | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+        variant?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    package: "skills";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    skills: {
+        id: string;
+        source: string;
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        ides: ("qoder" | "claude")[];
+        description: string;
+        version: string;
+        name: string;
+        template?: boolean | undefined;
+        managedRegions?: string[] | undefined;
+        variant?: string | undefined;
+    }[];
+    $schema?: string | undefined;
+}, {
+    schemaVersion: 1;
+    package: "skills";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    skills: {
+        id: string;
+        source: string;
+        description: string;
+        version: string;
+        name: string;
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        managedRegions?: string[] | undefined;
+        ides?: ("qoder" | "claude")[] | undefined;
+        variant?: string | undefined;
+    }[];
+    $schema?: string | undefined;
+}>;
+/**
+ * UI entry types.
+ * - component: a React component (e.g. button.tsx)
+ * - hook: a React hook (e.g. use-controllable.ts)
+ * - util: a utility function (e.g. cn.ts)
+ * - block: a higher-level composition shipped by ui or biz-ui (FilterBar,
+ *   EmptyState, OrgPicker, ApprovalCard). Per [ADR 0014](../../../../docs/adr/0014-ui-biz-ui-templates-tier.md),
+ *   ui ships generic blocks, biz-ui ships variant-bound business blocks.
+ * - template: a page-level composition shipped by `@teamix-evo/templates`
+ *   (DashboardLayout, ListDetailPage, ...). Per ADR 0014, templates are
+ *   variant-aware (mirror biz-ui).
+ */
+declare const UiEntryTypeSchema: z.ZodEnum<["component", "hook", "util", "block", "template"]>;
+/**
+ * Alias keys used to resolve where an entry file lands in the user's project.
+ * Each key maps to a path configured in `config.json` `packages.ui.aliases`.
+ *
+ * - `components`: src/components/ui/ (ui & biz-ui blocks default here)
+ * - `business`: src/components/business/ (biz-ui only — see ADR 0014)
+ * - `templates`: src/templates/ or src/pages/ (templates package — ADR 0014)
+ */
+declare const UiAliasSchema: z.ZodEnum<["components", "hooks", "utils", "lib", "business", "templates"]>;
+/**
+ * A single file shipped by a UI entry.
+ * Multiple files form one logical entry (rare, but supported).
+ */
+declare const UiEntryFileSchema: z.ZodObject<{
+    /** Source path relative to the ui package root (e.g. "src/components/button/button.tsx") */
+    source: z.ZodString;
+    /** Which alias this file resolves under in the consumer project */
+    targetAlias: z.ZodEnum<["components", "hooks", "utils", "lib", "business", "templates"]>;
+    /** Filename written under the alias directory (e.g. "button.tsx") */
+    targetName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+    targetName: string;
+}, {
+    source: string;
+    targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+    targetName: string;
+}>;
+/**
+ * A single UI entry (component / hook / util / block).
+ */
+declare const UiEntrySchema: z.ZodObject<{
+    /** Unique entry identifier within the ui package (e.g. "button") */
+    id: z.ZodString;
+    /** Display name (e.g. "Button") */
+    name: z.ZodString;
+    /** Entry type */
+    type: z.ZodEnum<["component", "hook", "util", "block", "template"]>;
+    /** One-line description for entry discovery and AI guidance */
+    description: z.ZodString;
+    /** Files this entry ships (typically 1) */
+    files: z.ZodArray<z.ZodObject<{
+        /** Source path relative to the ui package root (e.g. "src/components/button/button.tsx") */
+        source: z.ZodString;
+        /** Which alias this file resolves under in the consumer project */
+        targetAlias: z.ZodEnum<["components", "hooks", "utils", "lib", "business", "templates"]>;
+        /** Filename written under the alias directory (e.g. "button.tsx") */
+        targetName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+        targetName: string;
+    }, {
+        source: string;
+        targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+        targetName: string;
+    }>, "many">;
+    /**
+     * Optional path to an AI-readable meta document (frontmatter + Markdown).
+     * When set, CLI install drops it at `.teamix-evo/design/components/<id>.meta.md`
+     * for design's ai-rules to consume.
+     */
+    meta: z.ZodOptional<z.ZodString>;
+    /** Other UI entries this one depends on (e.g. "button" depends on "cn") */
+    registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** npm dependencies required by this entry (name → semver range) */
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /**
+     * How CLI handles this entry on `ui upgrade`.
+     * Defaults to `frozen` — user-owned source code, untouched after first install.
+     * Upgrade is handled by AI + skill flow (no CLI rewrite). See PLAN §10.9.
+     */
+    updateStrategy: z.ZodDefault<z.ZodEnum<["frozen", "regenerable", "managed"]>>;
+    /**
+     * Whether the source file should be passed through Handlebars before write.
+     * Most entries don't need templating (use import-rewrite transformer instead).
+     */
+    template: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Maturity / lifecycle status of this entry. Defaults to `stable`.
+     * See {@link UiEntryStatusSchema} for semantics.
+     */
+    status: z.ZodDefault<z.ZodEnum<["stable", "experimental", "deprecated"]>>;
+    /**
+     * Free-text rationale shown to consumers when `status` is `deprecated`.
+     * Should explain why the entry is going away and what replaces it.
+     */
+    deprecatedReason: z.ZodOptional<z.ZodString>;
+    /**
+     * If this entry is `deprecated`, the id of the entry that supersedes it.
+     * Consumers (and AI) should migrate to `replacedBy` rather than this entry.
+     */
+    replacedBy: z.ZodOptional<z.ZodString>;
+    /**
+     * Variant identifier when this entry is shipped from a variant-aware
+     * package (`@teamix-evo/biz-ui` or `@teamix-evo/templates` per ADR 0014).
+     * Optional — entries from `@teamix-evo/ui` (variant-agnostic) leave it unset.
+     * MUST equal the variant directory name when present.
+     */
+    variant: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: "template" | "component" | "hook" | "util" | "block";
+    updateStrategy: "frozen" | "regenerable" | "managed";
+    status: "stable" | "experimental" | "deprecated";
+    description: string;
+    name: string;
+    files: {
+        source: string;
+        targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+        targetName: string;
+    }[];
+    template?: boolean | undefined;
+    variant?: string | undefined;
+    meta?: string | undefined;
+    registryDependencies?: string[] | undefined;
+    dependencies?: Record<string, string> | undefined;
+    deprecatedReason?: string | undefined;
+    replacedBy?: string | undefined;
+}, {
+    id: string;
+    type: "template" | "component" | "hook" | "util" | "block";
+    description: string;
+    name: string;
+    files: {
+        source: string;
+        targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+        targetName: string;
+    }[];
+    updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+    template?: boolean | undefined;
+    status?: "stable" | "experimental" | "deprecated" | undefined;
+    variant?: string | undefined;
+    meta?: string | undefined;
+    registryDependencies?: string[] | undefined;
+    dependencies?: Record<string, string> | undefined;
+    deprecatedReason?: string | undefined;
+    replacedBy?: string | undefined;
+}>;
+/**
+ * UI package manifest schema — top-level manifest of `@teamix-evo/ui`.
+ * Like skills, UI is flat (no variants); brand differences are absorbed by
+ * design tokens at the `var(--primary)` layer.
+ */
+declare const UiPackageManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    /** Always "ui" for this package */
+    package: z.ZodLiteral<"ui">;
+    /** Semver version of the ui package */
+    version: z.ZodString;
+    /** Engine compatibility */
+    engines: z.ZodObject<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        'teamix-evo': string;
+    }>;
+    /** Flat list of entries shipped by this package */
+    entries: z.ZodArray<z.ZodObject<{
+        /** Unique entry identifier within the ui package (e.g. "button") */
+        id: z.ZodString;
+        /** Display name (e.g. "Button") */
+        name: z.ZodString;
+        /** Entry type */
+        type: z.ZodEnum<["component", "hook", "util", "block", "template"]>;
+        /** One-line description for entry discovery and AI guidance */
+        description: z.ZodString;
+        /** Files this entry ships (typically 1) */
+        files: z.ZodArray<z.ZodObject<{
+            /** Source path relative to the ui package root (e.g. "src/components/button/button.tsx") */
+            source: z.ZodString;
+            /** Which alias this file resolves under in the consumer project */
+            targetAlias: z.ZodEnum<["components", "hooks", "utils", "lib", "business", "templates"]>;
+            /** Filename written under the alias directory (e.g. "button.tsx") */
+            targetName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }, {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }>, "many">;
+        /**
+         * Optional path to an AI-readable meta document (frontmatter + Markdown).
+         * When set, CLI install drops it at `.teamix-evo/design/components/<id>.meta.md`
+         * for design's ai-rules to consume.
+         */
+        meta: z.ZodOptional<z.ZodString>;
+        /** Other UI entries this one depends on (e.g. "button" depends on "cn") */
+        registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** npm dependencies required by this entry (name → semver range) */
+        dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /**
+         * How CLI handles this entry on `ui upgrade`.
+         * Defaults to `frozen` — user-owned source code, untouched after first install.
+         * Upgrade is handled by AI + skill flow (no CLI rewrite). See PLAN §10.9.
+         */
+        updateStrategy: z.ZodDefault<z.ZodEnum<["frozen", "regenerable", "managed"]>>;
+        /**
+         * Whether the source file should be passed through Handlebars before write.
+         * Most entries don't need templating (use import-rewrite transformer instead).
+         */
+        template: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * Maturity / lifecycle status of this entry. Defaults to `stable`.
+         * See {@link UiEntryStatusSchema} for semantics.
+         */
+        status: z.ZodDefault<z.ZodEnum<["stable", "experimental", "deprecated"]>>;
+        /**
+         * Free-text rationale shown to consumers when `status` is `deprecated`.
+         * Should explain why the entry is going away and what replaces it.
+         */
+        deprecatedReason: z.ZodOptional<z.ZodString>;
+        /**
+         * If this entry is `deprecated`, the id of the entry that supersedes it.
+         * Consumers (and AI) should migrate to `replacedBy` rather than this entry.
+         */
+        replacedBy: z.ZodOptional<z.ZodString>;
+        /**
+         * Variant identifier when this entry is shipped from a variant-aware
+         * package (`@teamix-evo/biz-ui` or `@teamix-evo/templates` per ADR 0014).
+         * Optional — entries from `@teamix-evo/ui` (variant-agnostic) leave it unset.
+         * MUST equal the variant directory name when present.
+         */
+        variant: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        status: "stable" | "experimental" | "deprecated";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        template?: boolean | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }, {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        status?: "stable" | "experimental" | "deprecated" | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        status: "stable" | "experimental" | "deprecated";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        template?: boolean | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }[];
+    schemaVersion: 1;
+    package: "ui";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    $schema?: string | undefined;
+}, {
+    entries: {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        status?: "stable" | "experimental" | "deprecated" | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
     }[];
+    schemaVersion: 1;
+    package: "ui";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
     $schema?: string | undefined;
 }>;
+/**
+ * Design Pack manifest schema.
+ *
+ * Per [ADR 0010](../../../../docs/adr/0010-design-default-and-variants.md) the
+ * design system is structured as one **default** baseline + N **variants**:
+ *
+ *   packages/design/
+ *     ├── default/                <- B-end neutral baseline (always present)
+ *     │   ├── pack.json           <- this schema (no `extends`)
+ *     │   └── ... (philosophy/, foundations/, patterns/, scenarios/)
+ *     ├── variants/
+ *     │   ├── _template/          <- minimal scaffold for new variants
+ *     │   │   └── pack.json       <- this schema, extends: "default"
+ *     │   ├── opentrek/
+ *     │   │   ├── pack.json       <- this schema, extends: "default"
+ *     │   │   └── ... (only files differing from default)
+ *     │   └── uni-manager/
+ *     │       └── pack.json
+ *     └── manifest.json           <- top-level catalog (lists default + variants)
+ *
+ * The `pack.json` carries **only the protocol identity** of one pack; file
+ * lists are NOT declared here — the loader walks the filesystem under the
+ * pack root and lets file-level override merge happen at install time.
+ *
+ * Rationale: variant authors who add a new file (e.g. a new Markdown pattern)
+ * shouldn't have to register it in `pack.json`. The filesystem is the single
+ * source of truth (P2). See ADR 0010 §7 for the schema-simplification
+ * rationale.
+ */
+/**
+ * Soft cross-package links advertised by a design pack.
+ *
+ * When a consumer installs design `<variant>`, the CLI MAY check that the
+ * matching biz-ui / templates variant exists in the workspace / npm and
+ * prompt the user to install it too. The link is **soft** — packs may exist
+ * without their biz-ui or templates counterparts, especially in early
+ * development.
+ *
+ * Format: `<package-spec>#<variant-name>`, e.g. `@teamix-evo/biz-ui#opentrek`.
+ *
+ * Linked field for `templates` added per [ADR 0014 2026-05-18 amendment](../../../../docs/adr/0014-ui-biz-ui-templates-tier.md)
+ * (templates became variant-aware mirroring biz-ui).
+ */
+declare const DesignPackLinkedSchema: z.ZodObject<{
+    'biz-ui': z.ZodOptional<z.ZodString>;
+    templates: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    templates?: string | undefined;
+    'biz-ui'?: string | undefined;
+}, {
+    templates?: string | undefined;
+    'biz-ui'?: string | undefined;
+}>;
+/**
+ * Design pack manifest schema.
+ *
+ * Describes ONE pack (either the default baseline or one variant). Files are
+ * not declared — the loader walks the pack root.
+ */
+declare const DesignPackManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    /**
+     * Pack identifier.
+     * - `"default"` for the built-in baseline (only valid name when `extends` is absent)
+     * - lowercase kebab-case for variants (`opentrek`, `uni-manager`, `acme-erp`, `_template`)
+     */
+    name: z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodLiteral<"_template">]>, z.ZodLiteral<"default">]>;
+    /** Human-readable display name (e.g. "OpenTrek" for variant id "opentrek"). */
+    displayName: z.ZodString;
+    /** Semver. */
+    version: z.ZodString;
+    /**
+     * Parent pack name. Required for variants, must be omitted for `default`.
+     * Currently only `"default"` is a valid parent.
+     */
+    extends: z.ZodOptional<z.ZodString>;
+    /** Optional one-liner; useful for `design list-variants` output. */
+    description: z.ZodOptional<z.ZodString>;
+    /** Soft cross-package links (biz-ui / templates with same variant name). */
+    linked: z.ZodOptional<z.ZodObject<{
+        'biz-ui': z.ZodOptional<z.ZodString>;
+        templates: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    }, {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    displayName: string;
+    version: string;
+    name: string;
+    $schema?: string | undefined;
+    description?: string | undefined;
+    extends?: string | undefined;
+    linked?: {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    } | undefined;
+}, {
+    schemaVersion: 1;
+    displayName: string;
+    version: string;
+    name: string;
+    $schema?: string | undefined;
+    description?: string | undefined;
+    extends?: string | undefined;
+    linked?: {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    } | undefined;
+}>;
+type DesignPackManifest = z.infer<typeof DesignPackManifestSchema>;
+type DesignPackLinked = z.infer<typeof DesignPackLinkedSchema>;
+/**
+ * Top-level catalog of all packs in `@teamix-evo/design`.
+ *
+ * Lives at `packages/design/manifest.json`. Lists the default baseline + all
+ * variants the package ships. The catalog is regenerable via
+ * `pnpm --filter @teamix-evo/design validate` — variant directories are the
+ * source of truth.
+ */
+declare const DesignPackageManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    /** Always `"design"` for this package. */
+    package: z.ZodLiteral<"design">;
+    /** Semver of the entire design package. */
+    version: z.ZodString;
+    /** Engine compatibility. */
+    engines: z.ZodObject<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        'teamix-evo': string;
+    }>;
+    /** The default baseline pack — always present. */
+    default: z.ZodObject<{
+        $schema: z.ZodOptional<z.ZodString>;
+        schemaVersion: z.ZodLiteral<1>;
+        /**
+         * Pack identifier.
+         * - `"default"` for the built-in baseline (only valid name when `extends` is absent)
+         * - lowercase kebab-case for variants (`opentrek`, `uni-manager`, `acme-erp`, `_template`)
+         */
+        name: z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodLiteral<"_template">]>, z.ZodLiteral<"default">]>;
+        /** Human-readable display name (e.g. "OpenTrek" for variant id "opentrek"). */
+        displayName: z.ZodString;
+        /** Semver. */
+        version: z.ZodString;
+        /**
+         * Parent pack name. Required for variants, must be omitted for `default`.
+         * Currently only `"default"` is a valid parent.
+         */
+        extends: z.ZodOptional<z.ZodString>;
+        /** Optional one-liner; useful for `design list-variants` output. */
+        description: z.ZodOptional<z.ZodString>;
+        /** Soft cross-package links (biz-ui / templates with same variant name). */
+        linked: z.ZodOptional<z.ZodObject<{
+            'biz-ui': z.ZodOptional<z.ZodString>;
+            templates: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        }, {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        schemaVersion: 1;
+        displayName: string;
+        version: string;
+        name: string;
+        $schema?: string | undefined;
+        description?: string | undefined;
+        extends?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    }, {
+        schemaVersion: 1;
+        displayName: string;
+        version: string;
+        name: string;
+        $schema?: string | undefined;
+        description?: string | undefined;
+        extends?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    }>;
+    /** All shipped variants (excluding `_template/`). */
+    variants: z.ZodArray<z.ZodObject<{
+        $schema: z.ZodOptional<z.ZodString>;
+        schemaVersion: z.ZodLiteral<1>;
+        /**
+         * Pack identifier.
+         * - `"default"` for the built-in baseline (only valid name when `extends` is absent)
+         * - lowercase kebab-case for variants (`opentrek`, `uni-manager`, `acme-erp`, `_template`)
+         */
+        name: z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodLiteral<"_template">]>, z.ZodLiteral<"default">]>;
+        /** Human-readable display name (e.g. "OpenTrek" for variant id "opentrek"). */
+        displayName: z.ZodString;
+        /** Semver. */
+        version: z.ZodString;
+        /**
+         * Parent pack name. Required for variants, must be omitted for `default`.
+         * Currently only `"default"` is a valid parent.
+         */
+        extends: z.ZodOptional<z.ZodString>;
+        /** Optional one-liner; useful for `design list-variants` output. */
+        description: z.ZodOptional<z.ZodString>;
+        /** Soft cross-package links (biz-ui / templates with same variant name). */
+        linked: z.ZodOptional<z.ZodObject<{
+            'biz-ui': z.ZodOptional<z.ZodString>;
+            templates: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        }, {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        schemaVersion: 1;
+        displayName: string;
+        version: string;
+        name: string;
+        $schema?: string | undefined;
+        description?: string | undefined;
+        extends?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    }, {
+        schemaVersion: 1;
+        displayName: string;
+        version: string;
+        name: string;
+        $schema?: string | undefined;
+        description?: string | undefined;
+        extends?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    package: "design";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    default: {
+        schemaVersion: 1;
+        displayName: string;
+        version: string;
+        name: string;
+        $schema?: string | undefined;
+        description?: string | undefined;
+        extends?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    };
+    variants: {
+        schemaVersion: 1;
+        displayName: string;
+        version: string;
+        name: string;
+        $schema?: string | undefined;
+        description?: string | undefined;
+        extends?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    }[];
+    $schema?: string | undefined;
+}, {
+    schemaVersion: 1;
+    package: "design";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    default: {
+        schemaVersion: 1;
+        displayName: string;
+        version: string;
+        name: string;
+        $schema?: string | undefined;
+        description?: string | undefined;
+        extends?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    };
+    variants: {
+        schemaVersion: 1;
+        displayName: string;
+        version: string;
+        name: string;
+        $schema?: string | undefined;
+        description?: string | undefined;
+        extends?: string | undefined;
+        linked?: {
+            templates?: string | undefined;
+            'biz-ui'?: string | undefined;
+        } | undefined;
+    }[];
+    $schema?: string | undefined;
+}>;
+type DesignPackageManifest = z.infer<typeof DesignPackageManifestSchema>;
+/**
+ * Consumer-side lock file written to
+ * `.teamix-evo/design/pack.lock.json` after `design init`.
+ *
+ * Records which default + variant version was installed so future
+ * `design upgrade` / `doctor` / AI tooling can reason about install state
+ * without re-walking the source.
+ */
+declare const DesignPackLockSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    default: z.ZodObject<{
+        version: z.ZodString;
+        from: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        version: string;
+        from: string;
+    }, {
+        version: string;
+        from: string;
+    }>;
+    variant: z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        version: z.ZodString;
+        from: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        version: string;
+        name: string;
+        from: string;
+    }, {
+        displayName: string;
+        version: string;
+        name: string;
+        from: string;
+    }>;
+    linked: z.ZodOptional<z.ZodObject<{
+        'biz-ui': z.ZodOptional<z.ZodString>;
+        templates: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    }, {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    }>>;
+    installedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    variant: {
+        displayName: string;
+        version: string;
+        name: string;
+        from: string;
+    };
+    default: {
+        version: string;
+        from: string;
+    };
+    installedAt: string;
+    $schema?: string | undefined;
+    linked?: {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    } | undefined;
+}, {
+    schemaVersion: 1;
+    variant: {
+        displayName: string;
+        version: string;
+        name: string;
+        from: string;
+    };
+    default: {
+        version: string;
+        from: string;
+    };
+    installedAt: string;
+    $schema?: string | undefined;
+    linked?: {
+        templates?: string | undefined;
+        'biz-ui'?: string | undefined;
+    } | undefined;
+}>;
+type DesignPackLock = z.infer<typeof DesignPackLockSchema>;
+/**
+ * Schemas for variant-aware UI packages — `@teamix-evo/biz-ui` and
+ * `@teamix-evo/templates`.
+ *
+ * Per [ADR 0014](../../../../docs/adr/0014-ui-biz-ui-templates-tier.md), these
+ * two packages mirror `@teamix-evo/design`'s variant model: each ships a
+ * top-level catalog (variants list) plus a per-variant manifest (entry list).
+ *
+ *   packages/biz-ui/
+ *   ├── manifest.json                        <- VariantUiPackageCatalogSchema
+ *   └── variants/<name>/
+ *       └── manifest.json                    <- VariantUiPackageManifestSchema
+ *
+ * The per-variant manifest is **structurally similar to `UiPackageManifest`**
+ * (flat entries list) but adds a `variant` field — the variant name that all
+ * entries in this manifest belong to. Each entry's `variant` field MUST match
+ * (cross-checked at validation).
+ */
+/**
+ * Discriminator for which variant-aware package this manifest belongs to.
+ */
+declare const VariantUiPackageNameSchema: z.ZodEnum<["biz-ui", "templates"]>;
+/**
+ * Per-variant manifest — lives at `packages/<pkg>/variants/<name>/manifest.json`.
+ *
+ * Lists the entries this variant ships. Entries reuse `UiEntrySchema` (they
+ * are technically the same shape as ui entries — only difference is they
+ * declare a `variant` field tying them to a brand).
+ */
+declare const VariantUiPackageManifestSchema: z.ZodEffects<z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    /** Discriminator. */
+    package: z.ZodEnum<["biz-ui", "templates"]>;
+    /**
+     * Variant identifier — lowercase kebab-case, MUST match the parent
+     * directory name (e.g. `opentrek` for `variants/opentrek/manifest.json`).
+     * `_template` is also accepted for the variant scaffold.
+     */
+    variant: z.ZodUnion<[z.ZodString, z.ZodLiteral<"_template">]>;
+    /** Semver of this variant. */
+    version: z.ZodString;
+    /** Engine compatibility. */
+    engines: z.ZodObject<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        'teamix-evo': string;
+    }>;
+    /** Flat list of entries shipped by this variant. */
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodEnum<["component", "hook", "util", "block", "template"]>;
+        description: z.ZodString;
+        files: z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            targetAlias: z.ZodEnum<["components", "hooks", "utils", "lib", "business", "templates"]>;
+            targetName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }, {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }>, "many">;
+        meta: z.ZodOptional<z.ZodString>;
+        registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        updateStrategy: z.ZodDefault<z.ZodEnum<["frozen", "regenerable", "managed"]>>;
+        template: z.ZodOptional<z.ZodBoolean>;
+        status: z.ZodDefault<z.ZodEnum<["stable", "experimental", "deprecated"]>>;
+        deprecatedReason: z.ZodOptional<z.ZodString>;
+        replacedBy: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        status: "stable" | "experimental" | "deprecated";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        template?: boolean | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }, {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        status?: "stable" | "experimental" | "deprecated" | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        status: "stable" | "experimental" | "deprecated";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        template?: boolean | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }[];
+    schemaVersion: 1;
+    package: "templates" | "biz-ui";
+    variant: string;
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    $schema?: string | undefined;
+}, {
+    entries: {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        status?: "stable" | "experimental" | "deprecated" | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }[];
+    schemaVersion: 1;
+    package: "templates" | "biz-ui";
+    variant: string;
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    $schema?: string | undefined;
+}>, {
+    entries: {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        updateStrategy: "frozen" | "regenerable" | "managed";
+        status: "stable" | "experimental" | "deprecated";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        template?: boolean | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }[];
+    schemaVersion: 1;
+    package: "templates" | "biz-ui";
+    variant: string;
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    $schema?: string | undefined;
+}, {
+    entries: {
+        id: string;
+        type: "template" | "component" | "hook" | "util" | "block";
+        description: string;
+        name: string;
+        files: {
+            source: string;
+            targetAlias: "components" | "hooks" | "utils" | "lib" | "business" | "templates";
+            targetName: string;
+        }[];
+        updateStrategy?: "frozen" | "regenerable" | "managed" | undefined;
+        template?: boolean | undefined;
+        status?: "stable" | "experimental" | "deprecated" | undefined;
+        variant?: string | undefined;
+        meta?: string | undefined;
+        registryDependencies?: string[] | undefined;
+        dependencies?: Record<string, string> | undefined;
+        deprecatedReason?: string | undefined;
+        replacedBy?: string | undefined;
+    }[];
+    schemaVersion: 1;
+    package: "templates" | "biz-ui";
+    variant: string;
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    $schema?: string | undefined;
+}>;
+type VariantUiPackageManifest = z.infer<typeof VariantUiPackageManifestSchema>;
+type VariantUiPackageName = z.infer<typeof VariantUiPackageNameSchema>;
+/**
+ * Top-level catalog summarizing the package's variants. Lives at
+ * `packages/<pkg>/manifest.json`. Used by `<pkg> list-variants` and
+ * cross-package variant-name sync checks.
+ */
+declare const VariantUiPackageCatalogSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    package: z.ZodEnum<["biz-ui", "templates"]>;
+    /** Semver of the entire package. */
+    version: z.ZodString;
+    engines: z.ZodObject<{
+        'teamix-evo': z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        'teamix-evo': string;
+    }, {
+        'teamix-evo': string;
+    }>;
+    /** Variants this package ships (excluding `_template`). */
+    variants: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        version: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        version: string;
+        name: string;
+        description?: string | undefined;
+    }, {
+        displayName: string;
+        version: string;
+        name: string;
+        description?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    package: "templates" | "biz-ui";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    variants: {
+        displayName: string;
+        version: string;
+        name: string;
+        description?: string | undefined;
+    }[];
+    $schema?: string | undefined;
+}, {
+    schemaVersion: 1;
+    package: "templates" | "biz-ui";
+    version: string;
+    engines: {
+        'teamix-evo': string;
+    };
+    variants: {
+        displayName: string;
+        version: string;
+        name: string;
+        description?: string | undefined;
+    }[];
+    $schema?: string | undefined;
+}>;
+type VariantUiPackageCatalog = z.infer<typeof VariantUiPackageCatalogSchema>;
+/**
+ * Tailwind CSS major version that the project consumes.
+ *
+ * Only `'v4'` is accepted. v3 was retired in v0.7 — the dual-track output
+ * (`tokens.generated.css`) added maintenance cost without active demand.
+ * The schema keeps the field optional so existing config.json files
+ * (which may carry `tailwind: 'v4'`) continue to validate; any non-v4 value
+ * — including legacy `'v3'` — is rejected so users get a clear error.
+ */
+declare const TailwindVersionSchema: z.ZodLiteral<"v4">;
+/**
+ * Aliases for ui entry write-back paths in the consumer project.
+ * Keys mirror shadcn `components.json` aliases for familiarity, extended for
+ * biz-ui (business) and templates per [ADR 0014](../../../../docs/adr/0014-ui-biz-ui-templates-tier.md).
+ */
+declare const UiAliasesSchema: z.ZodObject<{
+    components: z.ZodString;
+    hooks: z.ZodString;
+    utils: z.ZodString;
+    lib: z.ZodString;
+    /** Biz-ui components (variant-bound). Defaults to `src/components/business/`. */
+    business: z.ZodDefault<z.ZodString>;
+    /** Page templates (variant-bound). Defaults to `src/templates/`. */
+    templates: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    components: string;
+    hooks: string;
+    utils: string;
+    lib: string;
+    business: string;
+    templates: string;
+}, {
+    components: string;
+    hooks: string;
+    utils: string;
+    lib: string;
+    business?: string | undefined;
+    templates?: string | undefined;
+}>;
 /**
  * Package entry within a project config.
+ *
+ * Some fields only apply to specific packages:
+ * - `tailwind` — design only
+ * - `ides` / `scope` — skills only
+ * - `aliases` / `iconLibrary` / `tsx` / `rsc` — ui only
+ *
+ * All package-specific fields are optional at the schema level so a single
+ * `PackageEntrySchema` can describe every package family.
  */
 declare const PackageEntrySchema: z.ZodObject<{
-    /** Variant identifier (e.g. "opentrek") */
+    /** Variant identifier (e.g. "opentrek"; use "_flat" for skills/ui) */
     variant: z.ZodString;
     /** Semver version string */
     version: z.ZodString;
+    /** Tailwind CSS version this project uses (only meaningful for design package). */
+    tailwind: z.ZodOptional<z.ZodLiteral<"v4">>;
+    /** IDEs this package was installed for (only meaningful for skills package). */
+    ides: z.ZodOptional<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
+    /** Install scope (only meaningful for skills package). */
+    scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
+    /** Path aliases for ui entry installation (only meaningful for ui package). */
+    aliases: z.ZodOptional<z.ZodObject<{
+        components: z.ZodString;
+        hooks: z.ZodString;
+        utils: z.ZodString;
+        lib: z.ZodString;
+        /** Biz-ui components (variant-bound). Defaults to `src/components/business/`. */
+        business: z.ZodDefault<z.ZodString>;
+        /** Page templates (variant-bound). Defaults to `src/templates/`. */
+        templates: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        components: string;
+        hooks: string;
+        utils: string;
+        lib: string;
+        business: string;
+        templates: string;
+    }, {
+        components: string;
+        hooks: string;
+        utils: string;
+        lib: string;
+        business?: string | undefined;
+        templates?: string | undefined;
+    }>>;
+    /**
+     * Default icon library declared by the project (only meaningful for ui).
+     * Declarative only — does NOT trigger code rewrites; ui entries hardcode imports.
+     */
+    iconLibrary: z.ZodOptional<z.ZodString>;
+    /** Whether the project uses TSX (true) or JSX (false). ui-specific. */
+    tsx: z.ZodOptional<z.ZodBoolean>;
+    /** Whether to emit React Server Components markers (`"use client"`). ui-specific. */
+    rsc: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     variant: string;
     version: string;
+    ides?: ("qoder" | "claude")[] | undefined;
+    scope?: "project" | "global" | undefined;
+    tailwind?: "v4" | undefined;
+    aliases?: {
+        components: string;
+        hooks: string;
+        utils: string;
+        lib: string;
+        business: string;
+        templates: string;
+    } | undefined;
+    iconLibrary?: string | undefined;
+    tsx?: boolean | undefined;
+    rsc?: boolean | undefined;
 }, {
     variant: string;
     version: string;
+    ides?: ("qoder" | "claude")[] | undefined;
+    scope?: "project" | "global" | undefined;
+    tailwind?: "v4" | undefined;
+    aliases?: {
+        components: string;
+        hooks: string;
+        utils: string;
+        lib: string;
+        business?: string | undefined;
+        templates?: string | undefined;
+    } | undefined;
+    iconLibrary?: string | undefined;
+    tsx?: boolean | undefined;
+    rsc?: boolean | undefined;
 }>;
 /**
  * Project configuration schema — teamix-evo config.json at project root.
@@ -184,16 +1565,84 @@ declare const ProjectConfigSchema: z.ZodObject<{
     ide: z.ZodString;
     /** Installed packages keyed by package name */
     packages: z.ZodRecord<z.ZodString, z.ZodObject<{
-        /** Variant identifier (e.g. "opentrek") */
+        /** Variant identifier (e.g. "opentrek"; use "_flat" for skills/ui) */
         variant: z.ZodString;
         /** Semver version string */
         version: z.ZodString;
+        /** Tailwind CSS version this project uses (only meaningful for design package). */
+        tailwind: z.ZodOptional<z.ZodLiteral<"v4">>;
+        /** IDEs this package was installed for (only meaningful for skills package). */
+        ides: z.ZodOptional<z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">>;
+        /** Install scope (only meaningful for skills package). */
+        scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
+        /** Path aliases for ui entry installation (only meaningful for ui package). */
+        aliases: z.ZodOptional<z.ZodObject<{
+            components: z.ZodString;
+            hooks: z.ZodString;
+            utils: z.ZodString;
+            lib: z.ZodString;
+            /** Biz-ui components (variant-bound). Defaults to `src/components/business/`. */
+            business: z.ZodDefault<z.ZodString>;
+            /** Page templates (variant-bound). Defaults to `src/templates/`. */
+            templates: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+            business: string;
+            templates: string;
+        }, {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+            business?: string | undefined;
+            templates?: string | undefined;
+        }>>;
+        /**
+         * Default icon library declared by the project (only meaningful for ui).
+         * Declarative only — does NOT trigger code rewrites; ui entries hardcode imports.
+         */
+        iconLibrary: z.ZodOptional<z.ZodString>;
+        /** Whether the project uses TSX (true) or JSX (false). ui-specific. */
+        tsx: z.ZodOptional<z.ZodBoolean>;
+        /** Whether to emit React Server Components markers (`"use client"`). ui-specific. */
+        rsc: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         variant: string;
         version: string;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
+        tailwind?: "v4" | undefined;
+        aliases?: {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+            business: string;
+            templates: string;
+        } | undefined;
+        iconLibrary?: string | undefined;
+        tsx?: boolean | undefined;
+        rsc?: boolean | undefined;
     }, {
         variant: string;
         version: string;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
+        tailwind?: "v4" | undefined;
+        aliases?: {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+            business?: string | undefined;
+            templates?: string | undefined;
+        } | undefined;
+        iconLibrary?: string | undefined;
+        tsx?: boolean | undefined;
+        rsc?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     schemaVersion: 1;
@@ -201,6 +1650,20 @@ declare const ProjectConfigSchema: z.ZodObject<{
     packages: Record<string, {
         variant: string;
         version: string;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
+        tailwind?: "v4" | undefined;
+        aliases?: {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+            business: string;
+            templates: string;
+        } | undefined;
+        iconLibrary?: string | undefined;
+        tsx?: boolean | undefined;
+        rsc?: boolean | undefined;
     }>;
     $schema?: string | undefined;
 }, {
@@ -209,32 +1672,58 @@ declare const ProjectConfigSchema: z.ZodObject<{
     packages: Record<string, {
         variant: string;
         version: string;
+        ides?: ("qoder" | "claude")[] | undefined;
+        scope?: "project" | "global" | undefined;
+        tailwind?: "v4" | undefined;
+        aliases?: {
+            components: string;
+            hooks: string;
+            utils: string;
+            lib: string;
+            business?: string | undefined;
+            templates?: string | undefined;
+        } | undefined;
+        iconLibrary?: string | undefined;
+        tsx?: boolean | undefined;
+        rsc?: boolean | undefined;
     }>;
     $schema?: string | undefined;
 }>;
 /**
  * An installed resource entry — tracks individual resource installation state.
+ *
+ * For type="skill" resources, the same logical skill may produce multiple installed
+ * entries (one per ide × scope combination); the optional `ide`/`scope` fields
+ * disambiguate them.
  */
 declare const InstalledResourceSchema: z.ZodObject<{
     /** Resource identifier matching the variant manifest */
     id: z.ZodString;
-    /** Target path where the resource was installed */
+    /** Target path where the resource was installed (absolute or project-relative) */
     target: z.ZodString;
     /** Content hash for change detection (e.g. "sha256:...") */
     hash: z.ZodString;
     /** Update strategy that was applied */
     strategy: z.ZodEnum<["frozen", "regenerable", "managed"]>;
+    /** IDE this resource was installed for (skill resources only) */
+    ide: z.ZodOptional<z.ZodEnum<["qoder", "claude"]>>;
+    /** Install scope (skill resources only) */
+    scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     target: string;
     hash: string;
     strategy: "frozen" | "regenerable" | "managed";
+    scope?: "project" | "global" | undefined;
+    ide?: "qoder" | "claude" | undefined;
 }, {
     id: string;
     target: string;
     hash: string;
     strategy: "frozen" | "regenerable" | "managed";
+    scope?: "project" | "global" | undefined;
+    ide?: "qoder" | "claude" | undefined;
 }>;
 /**
  * An installed package entry — tracks a single package installation.
@@ -242,7 +1731,7 @@ declare const InstalledResourceSchema: z.ZodObject<{
 declare const InstalledPackageSchema: z.ZodObject<{
     /** Full package name (e.g. "@teamix-evo/design") */
     package: z.ZodString;
-    /** Variant identifier */
+    /** Variant identifier (use "_flat" for non-variant packages such as skills) */
     variant: z.ZodString;
     /** Installed version */
     version: z.ZodString;
@@ -252,22 +1741,30 @@ declare const InstalledPackageSchema: z.ZodObject<{
     resources: z.ZodArray<z.ZodObject<{
         /** Resource identifier matching the variant manifest */
         id: z.ZodString;
-        /** Target path where the resource was installed */
+        /** Target path where the resource was installed (absolute or project-relative) */
         target: z.ZodString;
         /** Content hash for change detection (e.g. "sha256:...") */
         hash: z.ZodString;
         /** Update strategy that was applied */
         strategy: z.ZodEnum<["frozen", "regenerable", "managed"]>;
+        /** IDE this resource was installed for (skill resources only) */
+        ide: z.ZodOptional<z.ZodEnum<["qoder", "claude"]>>;
+        /** Install scope (skill resources only) */
+        scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         target: string;
         hash: string;
         strategy: "frozen" | "regenerable" | "managed";
+        scope?: "project" | "global" | undefined;
+        ide?: "qoder" | "claude" | undefined;
     }, {
         id: string;
         target: string;
         hash: string;
         strategy: "frozen" | "regenerable" | "managed";
+        scope?: "project" | "global" | undefined;
+        ide?: "qoder" | "claude" | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     package: string;
@@ -278,6 +1775,8 @@ declare const InstalledPackageSchema: z.ZodObject<{
         target: string;
         hash: string;
         strategy: "frozen" | "regenerable" | "managed";
+        scope?: "project" | "global" | undefined;
+        ide?: "qoder" | "claude" | undefined;
     }[];
     installedAt: string;
 }, {
@@ -289,6 +1788,8 @@ declare const InstalledPackageSchema: z.ZodObject<{
         target: string;
         hash: string;
         strategy: "frozen" | "regenerable" | "managed";
+        scope?: "project" | "global" | undefined;
+        ide?: "qoder" | "claude" | undefined;
     }[];
     installedAt: string;
 }>;
@@ -302,7 +1803,7 @@ declare const InstalledManifestSchema: z.ZodObject<{
     installed: z.ZodArray<z.ZodObject<{
         /** Full package name (e.g. "@teamix-evo/design") */
         package: z.ZodString;
-        /** Variant identifier */
+        /** Variant identifier (use "_flat" for non-variant packages such as skills) */
         variant: z.ZodString;
         /** Installed version */
         version: z.ZodString;
@@ -312,22 +1813,30 @@ declare const InstalledManifestSchema: z.ZodObject<{
         resources: z.ZodArray<z.ZodObject<{
             /** Resource identifier matching the variant manifest */
             id: z.ZodString;
-            /** Target path where the resource was installed */
+            /** Target path where the resource was installed (absolute or project-relative) */
             target: z.ZodString;
             /** Content hash for change detection (e.g. "sha256:...") */
             hash: z.ZodString;
             /** Update strategy that was applied */
             strategy: z.ZodEnum<["frozen", "regenerable", "managed"]>;
+            /** IDE this resource was installed for (skill resources only) */
+            ide: z.ZodOptional<z.ZodEnum<["qoder", "claude"]>>;
+            /** Install scope (skill resources only) */
+            scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
         }, "strip", z.ZodTypeAny, {
             id: string;
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }, {
             id: string;
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         package: string;
@@ -338,6 +1847,8 @@ declare const InstalledManifestSchema: z.ZodObject<{
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }[];
         installedAt: string;
     }, {
@@ -349,6 +1860,8 @@ declare const InstalledManifestSchema: z.ZodObject<{
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }[];
         installedAt: string;
     }>, "many">;
@@ -363,6 +1876,8 @@ declare const InstalledManifestSchema: z.ZodObject<{
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }[];
         installedAt: string;
     }[];
@@ -377,21 +1892,146 @@ declare const InstalledManifestSchema: z.ZodObject<{
             target: string;
             hash: string;
             strategy: "frozen" | "regenerable" | "managed";
+            scope?: "project" | "global" | undefined;
+            ide?: "qoder" | "claude" | undefined;
         }[];
         installedAt: string;
     }[];
 }>;
+/**
+ * Skills source-mirror lock file schema.
+ *
+ * Per [ADR 0013](../../../../docs/adr/0013-skills-source-mirror.md), the source
+ * lives at `.teamix-evo/skills/<id>/`, and IDE paths (`.qoder/skills/<id>/`,
+ * `.claude/skills/<id>/`) are regenerable mirrors. This lock file at
+ * `.teamix-evo/skills/manifest.lock.json` is the authoritative ledger of:
+ *
+ *   1. which skills are installed,
+ *   2. which version each was installed from,
+ *   3. which IDE mirror paths were produced (so `remove` / `sync` know where to act).
+ *
+ * v0.6 supports `qoder` + `claude` mirrors. `.cursor/rules/<id>.mdc` is v0.7
+ * (per ADR 0013 §Implementation note); the schema does NOT pre-allocate
+ * cursor-specific fields — they will be added with the v0.7 ADR.
+ */
+declare const SkillsLockEntrySchema: z.ZodObject<{
+    /** Semver version installed from upstream */
+    version: z.ZodString;
+    /** Upstream package name (typically `@teamix-evo/skills`) */
+    from: z.ZodString;
+    /** ISO 8601 install / last-sync timestamp */
+    installedAt: z.ZodString;
+    /** Install scope at time of mirror */
+    scope: z.ZodEnum<["project", "global"]>;
+    /**
+     * IDEs this skill was mirrored to. Each ide ↔ a mirror path under
+     * `<projectRoot>/.<ide>/skills/<id>/` (project) or `~/.<ide>/skills/<id>/`
+     * (global). The path itself is reconstructed from `scope` + adapter; we
+     * record the ide identifier rather than the full path to keep the lock
+     * portable across machines.
+     */
+    mirroredTo: z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    scope: "project" | "global";
+    version: string;
+    from: string;
+    installedAt: string;
+    mirroredTo: ("qoder" | "claude")[];
+}, {
+    scope: "project" | "global";
+    version: string;
+    from: string;
+    installedAt: string;
+    mirroredTo: ("qoder" | "claude")[];
+}>;
+declare const SkillsLockSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    /** Map of skill id → lock entry */
+    skills: z.ZodRecord<z.ZodString, z.ZodObject<{
+        /** Semver version installed from upstream */
+        version: z.ZodString;
+        /** Upstream package name (typically `@teamix-evo/skills`) */
+        from: z.ZodString;
+        /** ISO 8601 install / last-sync timestamp */
+        installedAt: z.ZodString;
+        /** Install scope at time of mirror */
+        scope: z.ZodEnum<["project", "global"]>;
+        /**
+         * IDEs this skill was mirrored to. Each ide ↔ a mirror path under
+         * `<projectRoot>/.<ide>/skills/<id>/` (project) or `~/.<ide>/skills/<id>/`
+         * (global). The path itself is reconstructed from `scope` + adapter; we
+         * record the ide identifier rather than the full path to keep the lock
+         * portable across machines.
+         */
+        mirroredTo: z.ZodArray<z.ZodEnum<["qoder", "claude"]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        scope: "project" | "global";
+        version: string;
+        from: string;
+        installedAt: string;
+        mirroredTo: ("qoder" | "claude")[];
+    }, {
+        scope: "project" | "global";
+        version: string;
+        from: string;
+        installedAt: string;
+        mirroredTo: ("qoder" | "claude")[];
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    skills: Record<string, {
+        scope: "project" | "global";
+        version: string;
+        from: string;
+        installedAt: string;
+        mirroredTo: ("qoder" | "claude")[];
+    }>;
+}, {
+    schemaVersion: 1;
+    skills: Record<string, {
+        scope: "project" | "global";
+        version: string;
+        from: string;
+        installedAt: string;
+        mirroredTo: ("qoder" | "claude")[];
+    }>;
+}>;
+type SkillsLockEntry = z.infer<typeof SkillsLockEntrySchema>;
+type SkillsLock = z.infer<typeof SkillsLockSchema>;
 /** Resource update strategy */
 type UpdateStrategy = z.infer<typeof UpdateStrategySchema>;
 /** Resource type discriminator */
 type ResourceType = z.infer<typeof ResourceTypeSchema>;
+/** AI IDE identifier supported by skills (qoder | claude) */
+type SkillIde = z.infer<typeof SkillIdeSchema>;
+/** Skill installation scope (project | global) */
+type SkillScope = z.infer<typeof SkillScopeSchema>;
+/** UI entry type discriminator */
+type UiEntryType = z.infer<typeof UiEntryTypeSchema>;
+/** UI write-back alias key (components | hooks | utils | lib) */
+type UiAlias = z.infer<typeof UiAliasSchema>;
 /** A single resource entry within a variant manifest */
 type Resource = z.infer<typeof ResourceSchema>;
 /** Variant manifest describing a package variant and its resources */
 type VariantManifest = z.infer<typeof VariantManifestSchema>;
+/** A single skill entry in a skills package manifest */
+type SkillEntry = z.infer<typeof SkillEntrySchema>;
+/** Skills package manifest (top-level manifest of @teamix-evo/skills) */
+type SkillsPackageManifest = z.infer<typeof SkillsPackageManifestSchema>;
+/** A single file shipped by a UI entry */
+type UiEntryFile = z.infer<typeof UiEntryFileSchema>;
+/** A single UI entry (component / hook / util / block) */
+type UiEntry = z.infer<typeof UiEntrySchema>;
+/** UI package manifest (top-level manifest of @teamix-evo/ui) */
+type UiPackageManifest = z.infer<typeof UiPackageManifestSchema>;
+/** Path aliases for UI entry installation in the consumer project */
+type UiAliases = z.infer<typeof UiAliasesSchema>;
 /** A package entry in the project config */
 type PackageEntry = z.infer<typeof PackageEntrySchema>;
+/** Tailwind CSS major version (always `"v4"` since v0.7). */
+type TailwindVersion = z.infer<typeof TailwindVersionSchema>;
 /** Project configuration (config.json) */
 type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
 /** An installed resource tracking entry */
@@ -431,6 +2071,82 @@ type Result<T> = {
  * @throws Error if the file cannot be read or the manifest is invalid
  */
 declare function loadVariantManifest(packageDir: string): Promise<VariantManifest>;
+/**
+ * Load and validate the top-level manifest of a skills package.
+ *
+ * Reads `manifest.json` from the given directory and validates it against
+ * the SkillsPackageManifest schema (flat list of skills, no variants).
+ *
+ * @param packageDir - Absolute or relative path to the skills package directory
+ * @returns The validated SkillsPackageManifest
+ * @throws Error if the file cannot be read or the manifest is invalid
+ */
+declare function loadSkillsPackageManifest(packageDir: string): Promise<SkillsPackageManifest>;
+/**
+ * Load and validate the top-level manifest of a UI package.
+ *
+ * Reads `manifest.json` from the given directory and validates it against
+ * the UiPackageManifest schema (flat list of entries, no variants).
+ * Also performs registryDependencies graph validation (existence + no cycles).
+ *
+ * @param packageDir - Absolute or relative path to the ui package directory
+ * @returns The validated UiPackageManifest
+ * @throws Error if the file cannot be read, the manifest is invalid, or the dep graph is broken
+ */
+declare function loadUiPackageManifest(packageDir: string): Promise<UiPackageManifest>;
+/**
+ * Read & validate a single pack's `pack.json`.
+ * Errors are wrapped with the file path for easy diagnosis (P8).
+ */
+declare function loadDesignPack(packDir: string): Promise<DesignPackManifest>;
+/**
+ * Read & validate the top-level `packages/design/manifest.json` catalog.
+ */
+declare function loadDesignPackageManifest(packageDir: string): Promise<DesignPackageManifest>;
+/**
+ * Walk all files under a pack root and return their paths **relative to
+ * `packDir`**, excluding pack metadata files (`pack.json`).
+ *
+ * Returns a sorted list (deterministic for tests + diff-friendly).
+ */
+declare function walkPackTree(packDir: string): Promise<string[]>;
+/**
+ * Result of merging default + variant: each entry is a file the CLI should
+ * install, paired with which on-disk file to read.
+ */
+interface MergedFileEntry {
+    /** Path relative to the pack root (e.g. `philosophy/principles.md`). */
+    relPath: string;
+    /** Absolute filesystem path the CLI should read. */
+    sourcePath: string;
+    /** Which pack provided this file (for diagnostics + UI listing). */
+    origin: 'default' | 'variant';
+}
+interface MergeResult {
+    files: MergedFileEntry[];
+    /** Files where variant overrode default. Useful for diagnostics. */
+    overrides: string[];
+    /** Files only in variant (no default counterpart). */
+    variantAdds: string[];
+    /** Files only in default (variant didn't override). */
+    defaultPassThrough: string[];
+}
+/**
+ * File-level merge per ADR 0010 §4.
+ *
+ * For each file path P:
+ *   - If `<variantDir>/P` exists: use the variant's file (override).
+ *   - Else: use the default's file (pass-through).
+ * Plus: every file in variant tree NOT present in default tree is appended
+ * (variant-add).
+ *
+ * No content parsing happens here — files are read as-is by the caller.
+ */
+declare function mergeDefaultAndVariant(defaultDir: string, variantDir: string): Promise<MergeResult>;
+declare function loadVariantUiPackageCatalog(packageDir: string): Promise<VariantUiPackageCatalog>;
+declare function loadVariantUiPackageManifest(variantDir: string): Promise<VariantUiPackageManifest>;
 /**
  * Validate unknown data against the VariantManifest schema.
@@ -445,6 +2161,40 @@ declare function validateConfig(data: unknown): Result<ProjectConfig>;
  * Validate unknown data against the InstalledManifest schema.
  */
 declare function validateInstalled(data: unknown): Result<InstalledManifest>;
+/**
+ * Validate unknown data against the SkillsLock schema (skills source-mirror lock).
+ * Stored at `.teamix-evo/skills/manifest.lock.json` per ADR 0013.
+ */
+declare function validateSkillsLock(data: unknown): Result<SkillsLock>;
+/**
+ * Validate unknown data against the SkillsPackageManifest schema.
+ */
+declare function validateSkillsPackage(data: unknown): Result<SkillsPackageManifest>;
+/**
+ * Validate unknown data against the UiPackageManifest schema, then verify the
+ * registryDependencies graph: every reference resolves and there are no cycles.
+ */
+declare function validateUiPackage(data: unknown): Result<UiPackageManifest>;
+/**
+ * Validate the registryDependencies graph among ui entries.
+ * Returns a list of issue strings (empty when the graph is sound).
+ *
+ * Issues detected:
+ * - Duplicate entry id
+ * - Reference to an unknown entry id
+ * - Cyclic dependency
+ */
+declare function validateUiDependencyGraph(entries: UiEntry[]): string[];
+/**
+ * Topologically sort a subset of ui entries so that dependencies come before
+ * dependents. Used by `ui add` to determine install order.
+ *
+ * @param entries  full list of entries (the package manifest's `entries`)
+ * @param requested ids the user explicitly asked to install
+ * @returns ordered list of entry ids (includes transitive deps, dedup'd)
+ * @throws Error if a requested id or transitive dep is missing or graph has cycles
+ */
+declare function resolveUiEntryOrder(entries: UiEntry[], requested: string[]): string[];
 /**
  * Parse all managed regions from document content.
@@ -502,4 +2252,4 @@ interface UpdateActionOptions {
  */
 declare function getUpdateAction(strategy: UpdateStrategy, options: UpdateActionOptions): UpdateAction;
-export { type InstalledManifest, InstalledManifestSchema, type InstalledPackage, InstalledPackageSchema, type InstalledResource, InstalledResourceSchema, type ManagedRegion, type PackageEntry, PackageEntrySchema, type ProjectConfig, ProjectConfigSchema, type Resource, ResourceSchema, type ResourceType, ResourceTypeSchema, type Result, type UpdateAction, type UpdateActionOptions, type UpdateStrategy, UpdateStrategySchema, type VariantManifest, VariantManifestSchema, getUpdateAction, hasManagedRegion, loadVariantManifest, parseManagedRegions, replaceManagedRegion, shouldUpdate, validateConfig, validateInstalled, validateManifest };
+export { type DesignPackLinked, DesignPackLinkedSchema, type DesignPackLock, DesignPackLockSchema, type DesignPackManifest, DesignPackManifestSchema, type DesignPackageManifest, DesignPackageManifestSchema, type InstalledManifest, InstalledManifestSchema, type InstalledPackage, InstalledPackageSchema, type InstalledResource, InstalledResourceSchema, type ManagedRegion, type MergeResult, type MergedFileEntry, type PackageEntry, PackageEntrySchema, type ProjectConfig, ProjectConfigSchema, type Resource, ResourceSchema, type ResourceType, ResourceTypeSchema, type Result, type SkillEntry, SkillEntrySchema, type SkillIde, SkillIdeSchema, type SkillScope, SkillScopeSchema, type SkillsLock, type SkillsLockEntry, SkillsLockEntrySchema, SkillsLockSchema, type SkillsPackageManifest, SkillsPackageManifestSchema, type TailwindVersion, TailwindVersionSchema, type UiAlias, UiAliasSchema, type UiAliases, UiAliasesSchema, type UiEntry, type UiEntryFile, UiEntryFileSchema, UiEntrySchema, type UiEntryType, UiEntryTypeSchema, type UiPackageManifest, UiPackageManifestSchema, type UpdateAction, type UpdateActionOptions, type UpdateStrategy, UpdateStrategySchema, type VariantManifest, VariantManifestSchema, type VariantUiPackageCatalog, VariantUiPackageCatalogSchema, type VariantUiPackageManifest, VariantUiPackageManifestSchema, type VariantUiPackageName, VariantUiPackageNameSchema, getUpdateAction, hasManagedRegion, loadDesignPack, loadDesignPackageManifest, loadSkillsPackageManifest, loadUiPackageManifest, loadVariantManifest, loadVariantUiPackageCatalog, loadVariantUiPackageManifest, mergeDefaultAndVariant, parseManagedRegions, replaceManagedRegion, resolveUiEntryOrder, shouldUpdate, validateConfig, validateInstalled, validateManifest, validateSkillsLock, validateSkillsPackage, validateUiDependencyGraph, validateUiPackage, walkPackTree };