moluoxixi-ai-rules 0.2.4 → 0.2.5

package/dist/roles/matt/constants/skills.d.ts

@@ -1,5 +1,4 @@
 import type { VendorRepo } from '../../../scripts/lib/vendors.js';
 export declare const extendsRoles: string[];
 export declare const hosts = "all";
-export declare const capabilities: readonly ["engineering", "productivity"];
-export declare const vendors: VendorRepo[];
+export declare const roleVendor: VendorRepo;

package/dist/roles/matt/constants/skills.js

@@ -1,11 +1,7 @@
-import { composeCapabilities } from '../../../capabilities/index.js';
 export const extendsRoles = [];
 export const hosts = 'all';
-export const capabilities = [
-    'engineering',
-    'productivity',
-];
-const roleVendor = {
+// 角色能力（capabilities）与 role_vendor_position 声明在 roles/matt/role.yaml 中，由 loadVendorManifest 组合成 vendors。
+export const roleVendor = {
     name: 'matt-role',
     source: 'https://github.com/moluoxixi/AIRules.git',
     projections: [
@@ -15,7 +11,3 @@ const roleVendor = {
         },
     ],
 };
-export const vendors = composeCapabilities(capabilities, {
-    roleVendor,
-    roleVendorPosition: 'after',
-});

package/dist/roles/moluoxixi/constants/skills.d.ts

@@ -2,5 +2,4 @@ import type { RolePackageConfig, VendorRepo } from '../../../scripts/lib/vendors
 export declare const extendsRoles: string[];
 export declare const hosts = "all";
 export declare const packages: RolePackageConfig[];
-export declare const capabilities: readonly ["common", "coding", "productivity", "frontend"];
-export declare const vendors: VendorRepo[];
+export declare const roleVendor: VendorRepo;

package/dist/roles/moluoxixi/constants/skills.js

@@ -1,4 +1,3 @@
-import { composeCapabilities } from '../../../capabilities/index.js';
 export const extendsRoles = [];
 export const hosts = 'all';
 export const packages = [
@@ -15,13 +14,8 @@ export const packages = [
         },
     },
 ];
-export const capabilities = [
-    'common',
-    'coding',
-    'productivity',
-    'frontend',
-];
-const roleVendor = {
+// 角色能力（capabilities）声明在 roles/moluoxixi/role.yaml 中，由 loadVendorManifest 组合成 vendors。
+export const roleVendor = {
     name: 'moluoxixi',
     source: 'https://github.com/moluoxixi/AIRules.git',
     projections: [
@@ -31,4 +25,3 @@ const roleVendor = {
         },
     ],
 };
-export const vendors = composeCapabilities(capabilities, { roleVendor });

package/dist/roles/trellis/constants/skills.d.ts

@@ -1,5 +1,4 @@
 import type { VendorRepo } from '../../../scripts/lib/vendors.js';
 export declare const extendsRoles: string[];
 export declare const hosts = "all";
-export declare const capabilities: readonly ["common", "coding", "productivity", "frontend"];
-export declare const vendors: VendorRepo[];
+export declare const roleVendor: VendorRepo;

package/dist/roles/trellis/constants/skills.js

@@ -1,13 +1,7 @@
-import { composeCapabilities } from '../../../capabilities/index.js';
 export const extendsRoles = [];
 export const hosts = 'all';
-export const capabilities = [
-    'common',
-    'coding',
-    'productivity',
-    'frontend',
-];
-const roleVendor = {
+// 角色能力（capabilities）声明在 roles/trellis/role.yaml 中，由 loadVendorManifest 组合成 vendors。
+export const roleVendor = {
     name: 'trellis',
     source: 'https://github.com/moluoxixi/AIRules.git',
     setup: [
@@ -23,4 +17,3 @@ const roleVendor = {
         },
     ],
 };
-export const vendors = composeCapabilities(capabilities, { roleVendor });

package/dist/scripts/lib/vendors.js

@@ -1,5 +1,8 @@
+import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL, URL } from 'node:url';
+import { parseDocument } from 'yaml';
+import { CAPABILITY_NAMES, composeCapabilities } from '../../capabilities/index.js';
 import { HOST_IDS } from '../../constants/hosts.js';
 import { flattenedSkillName, flattenedVendorSkillTarget } from './skill-projection.js';
 const vendorNamePattern = /^[A-Za-z0-9][\w-]*$/u;
@@ -204,9 +207,12 @@ export function walkVendorTree(node, namespaceParts, vendors) {
 export async function loadVendorManifest(manifestPath) {
     const manifestUrl = pathToFileURL(path.resolve(manifestPath)).href;
     const module = await import(manifestUrl);
-    const vendorTree = module.vendors ?? module.default?.vendors ?? module.default;
+    const roleVendor = module.roleVendor ?? module.default?.roleVendor;
+    const vendorTree = roleVendor === undefined
+        ? module.vendors ?? module.default?.vendors ?? module.default
+        : composeRoleVendorTree(manifestPath, roleVendor);
     if (!vendorTree || typeof vendorTree !== 'object') {
-        throw new Error(`Vendor manifest "${manifestPath}" must export a "vendors" object`);
+        throw new Error(`Vendor manifest "${manifestPath}" must export a "vendors" object or a "roleVendor" definition`);
     }
     const vendors = {};
     walkVendorTree(vendorTree, [], vendors);
@@ -219,6 +225,76 @@ export async function loadVendorManifest(manifestPath) {
         vendors,
     };
 }
+/**
+ * 定位清单对应的 role.yaml 角色契约。
+ * 源码与 checkout 布局下契约位于清单的角色根目录；
+ * dist 布局（dist/roles/<role>/constants/skills.js）下回退到包根的 roles/<role>/role.yaml。
+ */
+function resolveRoleContractPath(manifestPath) {
+    const resolvedManifest = path.resolve(manifestPath);
+    const roleRoot = path.dirname(path.dirname(resolvedManifest));
+    const sourceContract = path.join(roleRoot, 'role.yaml');
+    if (fs.existsSync(sourceContract))
+        return sourceContract;
+    const rolesDir = path.dirname(roleRoot);
+    const distRoot = path.dirname(rolesDir);
+    if (path.basename(rolesDir) === 'roles' && path.basename(distRoot) === 'dist') {
+        const packagedContract = path.join(path.dirname(distRoot), 'roles', path.basename(roleRoot), 'role.yaml');
+        if (fs.existsSync(packagedContract))
+            return packagedContract;
+    }
+    throw new Error(`Vendor manifest "${manifestPath}" exports "roleVendor" but its role.yaml contract is missing: ${sourceContract}`);
+}
+function loadRoleCapabilityContract(manifestPath) {
+    const contractPath = resolveRoleContractPath(manifestPath);
+    const document = parseDocument(fs.readFileSync(contractPath, 'utf8'), {
+        merge: false,
+        prettyErrors: true,
+        strict: true,
+        uniqueKeys: true,
+    });
+    if (document.errors.length > 0) {
+        throw new Error(`Role contract "${contractPath}" is invalid: ${document.errors.map(error => error.message).join('; ')}`);
+    }
+    const contract = document.toJS({ maxAliasCount: 0 });
+    if (!contract || typeof contract !== 'object' || Array.isArray(contract)) {
+        throw new Error(`Role contract "${contractPath}" must be a YAML mapping`);
+    }
+    const { capabilities, role_vendor_position: roleVendorPosition } = contract;
+    if (!Array.isArray(capabilities) || capabilities.length === 0) {
+        throw new Error(`Role contract "${contractPath}" must declare a non-empty "capabilities" list`);
+    }
+    const seen = new Set();
+    for (const capability of capabilities) {
+        if (typeof capability !== 'string' || !CAPABILITY_NAMES.includes(capability)) {
+            throw new Error(`Role contract "${contractPath}" references unknown capability "${String(capability)}"`);
+        }
+        if (seen.has(capability)) {
+            throw new Error(`Role contract "${contractPath}" declares duplicate capability "${capability}"`);
+        }
+        seen.add(capability);
+    }
+    if (roleVendorPosition !== undefined && roleVendorPosition !== 'before' && roleVendorPosition !== 'after') {
+        throw new Error(`Role contract "${contractPath}" field "role_vendor_position" must be "before" or "after"`);
+    }
+    return {
+        capabilities: capabilities,
+        ...(roleVendorPosition === undefined ? {} : { roleVendorPosition }),
+    };
+}
+/**
+ * 依据 role.yaml 声明的 capabilities，把清单导出的 roleVendor 组合成完整 vendors 列表。
+ */
+function composeRoleVendorTree(manifestPath, roleVendor) {
+    if (!isVendorEntry(roleVendor)) {
+        throw new Error(`Vendor manifest "${manifestPath}" export "roleVendor" must be a vendor definition with name and source`);
+    }
+    const contract = loadRoleCapabilityContract(manifestPath);
+    return composeCapabilities(contract.capabilities, {
+        roleVendor: roleVendor,
+        ...(contract.roleVendorPosition === undefined ? {} : { roleVendorPosition: contract.roleVendorPosition }),
+    });
+}
 function normalizeRolePackages(value, manifestPath) {
     if (value === undefined)
         return [];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "moluoxixi-ai-rules",
   "type": "module",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Remote AI role asset distribution for supported hosts.",
   "license": "MIT",
   "repository": "https://github.com/moluoxixi/AIRules",
@@ -23,7 +23,6 @@
     "README.md",
     "bin",
     "dist",
-    "docs",
     "roles/*/constants/**",
     "roles/*/role.yaml"
   ],

package/roles/matt/constants/skills.ts

@@ -1,17 +1,11 @@
-import type { CapabilityName } from '../../../capabilities/index.js'
 import type { VendorRepo } from '../../../scripts/lib/vendors.js'
-import { composeCapabilities } from '../../../capabilities/index.js'
 
 export const extendsRoles: string[] = []
 
 export const hosts = 'all'
 
-export const capabilities = [
-  'engineering',
-  'productivity',
-] as const satisfies readonly CapabilityName[]
-
-const roleVendor: VendorRepo = {
+// 角色能力（capabilities）与 role_vendor_position 声明在 roles/matt/role.yaml 中，由 loadVendorManifest 组合成 vendors。
+export const roleVendor: VendorRepo = {
   name: 'matt-role',
   source: 'https://github.com/moluoxixi/AIRules.git',
   projections: [
@@ -21,8 +15,3 @@ const roleVendor: VendorRepo = {
     },
   ],
 }
-
-export const vendors: VendorRepo[] = composeCapabilities(capabilities, {
-  roleVendor,
-  roleVendorPosition: 'after',
-})

package/roles/matt/role.yaml

@@ -6,6 +6,10 @@ canonical_root: roles/matt
 description: Installs Matt Pocock's engineering and productivity skills through AIRules.
 assets:
   skills: skills
+capabilities:
+  - engineering
+  - productivity
+role_vendor_position: after
 distribution:
   bootstrap_manifest: constants/skills.ts
   full_role_path_required: true

package/roles/moluoxixi/constants/skills.ts

@@ -1,6 +1,4 @@
-import type { CapabilityName } from '../../../capabilities/index.js'
 import type { RolePackageConfig, VendorRepo } from '../../../scripts/lib/vendors.js'
-import { composeCapabilities } from '../../../capabilities/index.js'
 
 export const extendsRoles: string[] = []
 
@@ -21,14 +19,8 @@ export const packages: RolePackageConfig[] = [
   },
 ]
 
-export const capabilities = [
-  'common',
-  'coding',
-  'productivity',
-  'frontend',
-] as const satisfies readonly CapabilityName[]
-
-const roleVendor: VendorRepo = {
+// 角色能力（capabilities）声明在 roles/moluoxixi/role.yaml 中，由 loadVendorManifest 组合成 vendors。
+export const roleVendor: VendorRepo = {
   name: 'moluoxixi',
   source: 'https://github.com/moluoxixi/AIRules.git',
   projections: [
@@ -38,5 +30,3 @@ const roleVendor: VendorRepo = {
     },
   ],
 }
-
-export const vendors: VendorRepo[] = composeCapabilities(capabilities, { roleVendor })

package/roles/moluoxixi/role.yaml

@@ -8,6 +8,11 @@ assets:
   skills: skills
   mcp: mcp
   packages: packages
+capabilities:
+  - common
+  - coding
+  - productivity
+  - frontend
 distribution:
   bootstrap_manifest: constants/skills.ts
   full_role_path_required: true

package/roles/trellis/constants/skills.ts

@@ -1,19 +1,11 @@
-import type { CapabilityName } from '../../../capabilities/index.js'
 import type { VendorRepo } from '../../../scripts/lib/vendors.js'
-import { composeCapabilities } from '../../../capabilities/index.js'
 
 export const extendsRoles: string[] = []
 
 export const hosts = 'all'
 
-export const capabilities = [
-  'common',
-  'coding',
-  'productivity',
-  'frontend',
-] as const satisfies readonly CapabilityName[]
-
-const roleVendor: VendorRepo = {
+// 角色能力（capabilities）声明在 roles/trellis/role.yaml 中，由 loadVendorManifest 组合成 vendors。
+export const roleVendor: VendorRepo = {
   name: 'trellis',
   source: 'https://github.com/moluoxixi/AIRules.git',
   setup: [
@@ -29,5 +21,3 @@ const roleVendor: VendorRepo = {
     },
   ],
 }
-
-export const vendors: VendorRepo[] = composeCapabilities(capabilities, { roleVendor })

package/roles/trellis/role.yaml

@@ -7,6 +7,11 @@ description: Installs Trellis, shared coding and frontend capabilities, native p
 assets:
   skills: skills
   mcp: mcp
+capabilities:
+  - common
+  - coding
+  - productivity
+  - frontend
 distribution:
   bootstrap_manifest: constants/skills.ts
   full_role_path_required: true