@cubis/foundry 0.3.67 → 0.3.69

package/mcp/src/vault/scanner.ts

@@ -18,7 +18,7 @@ export async function scanVaultRoots(
   roots: string[],
   basePath: string,
 ): Promise<SkillPointer[]> {
-  const skills: SkillPointer[] = [];
+  const skillsById = new Map<string, SkillPointer>();
 
   for (const rootRel of roots) {
     const rootAbs = path.resolve(basePath, rootRel);
@@ -46,7 +46,9 @@ export async function scanVaultRoots(
         continue;
       }
 
-      const wrapperKind = await detectWrapperKind(entry, skillFile);
+      const rawPreview = await readFrontmatterPreview(skillFile);
+      const frontmatter = rawPreview ? parseFrontmatter(rawPreview) : null;
+      const wrapperKind = detectWrapperKind(entry, frontmatter);
       if (wrapperKind) {
         logger.debug(
           `Skipping wrapper skill ${entry} (${wrapperKind}) at ${skillFile}`,
@@ -54,17 +56,28 @@ export async function scanVaultRoots(
         continue;
       }
 
-      // Derive category from the skill's frontmatter or default to "general"
-      // At scan time we only store the path; category is derived from directory structure
-      skills.push({
+      const skillPointer: SkillPointer = {
         id: entry,
         category: deriveCategory(entry),
         path: skillFile,
         fileBytes: skillStat.size,
-      });
+      };
+      registerSkillPointer(skillsById, skillPointer);
+
+      for (const aliasId of extractMetadataAliases(frontmatter)) {
+        if (aliasId === entry) continue;
+        registerSkillPointer(skillsById, {
+          id: aliasId,
+          canonicalId: entry,
+          category: skillPointer.category,
+          path: skillFile,
+          fileBytes: skillStat.size,
+        });
+      }
     }
   }
 
+  const skills = [...skillsById.values()].sort((a, b) => a.id.localeCompare(b.id));
   logger.info(`Vault scan complete: ${skills.length} skills discovered`);
   return skills;
 }
@@ -108,6 +121,13 @@ function parseFrontmatter(rawPreview: string): string | null {
   return match?.[1] ?? null;
 }
 
+function parseInlineList(raw: string): string[] {
+  return String(raw || "")
+    .split(",")
+    .map((item) => item.trim().replace(/^['"]|['"]$/g, ""))
+    .filter(Boolean);
+}
+
 function extractMetadataWrapper(frontmatter: string): string | null {
   const lines = frontmatter.split(/\r?\n/);
   let inMetadata = false;
@@ -138,16 +158,96 @@ function extractMetadataWrapper(frontmatter: string): string | null {
   return null;
 }
 
-async function detectWrapperKind(
+function extractMetadataAliases(frontmatter: string | null): string[] {
+  if (!frontmatter) return [];
+  const lines = frontmatter.split(/\r?\n/);
+  let inMetadata = false;
+  const aliases: string[] = [];
+
+  for (let i = 0; i < lines.length; i += 1) {
+    const line = lines[i];
+    if (!inMetadata) {
+      if (/^\s*metadata\s*:\s*$/.test(line)) {
+        inMetadata = true;
+      }
+      continue;
+    }
+
+    if (!line.trim()) continue;
+    if (!/^\s+/.test(line)) break;
+
+    const inlineMatch = line.match(/^\s+aliases\s*:\s*(.+)\s*$/);
+    if (!inlineMatch) continue;
+
+    const rest = inlineMatch[1].trim();
+    if (rest.startsWith("[") && rest.endsWith("]")) {
+      aliases.push(...parseInlineList(rest.slice(1, -1)));
+      break;
+    }
+
+    if (rest) {
+      aliases.push(...parseInlineList(rest));
+      break;
+    }
+
+    for (let j = i + 1; j < lines.length; j += 1) {
+      const next = lines[j];
+      if (!next.trim()) continue;
+      if (/^\s+[A-Za-z0-9_-]+\s*:/.test(next)) {
+        i = j - 1;
+        break;
+      }
+
+      const bullet = next.match(/^\s+-\s*(.+)$/);
+      if (bullet) {
+        aliases.push(bullet[1].trim().replace(/^['"]|['"]$/g, ""));
+      }
+
+      if (j === lines.length - 1) {
+        i = j;
+      }
+    }
+  }
+
+  return [...new Set(aliases.filter(Boolean))];
+}
+
+function registerSkillPointer(
+  skillsById: Map<string, SkillPointer>,
+  pointer: SkillPointer,
+) {
+  const key = pointer.id.toLowerCase();
+  if (!skillsById.has(key)) {
+    skillsById.set(key, pointer);
+    return;
+  }
+
+  const existing = skillsById.get(key);
+  if (!existing) {
+    skillsById.set(key, pointer);
+    return;
+  }
+
+  // Prefer concrete canonical skills over synthetic aliases on collisions.
+  if (existing.canonicalId && !pointer.canonicalId) {
+    skillsById.set(key, pointer);
+    return;
+  }
+
+  if (existing.path !== pointer.path || existing.canonicalId !== pointer.canonicalId) {
+    logger.warn(
+      `Duplicate skill id '${pointer.id}' discovered; keeping first registration at ${existing.path}`,
+    );
+  }
+}
+
+function detectWrapperKind(
   skillId: string,
-  skillFile: string,
-): Promise<"workflow" | "agent" | null> {
+  frontmatter: string | null,
+): "workflow" | "agent" | null {
   const byId = extractWrapperKindFromId(skillId);
   if (byId) return byId;
 
-  const rawPreview = await readFrontmatterPreview(skillFile);
-  if (!rawPreview) return null;
-  const frontmatter = parseFrontmatter(rawPreview);
   if (!frontmatter) return null;
 
   const byMetadata = extractMetadataWrapper(frontmatter);

package/mcp/src/vault/types.ts

@@ -5,6 +5,8 @@
 export interface SkillPointer {
   /** Skill identifier (directory name). */
   id: string;
+  /** Canonical skill identifier when this pointer is a compatibility alias. */
+  canonicalId?: string;
   /** Category derived from parent directory or frontmatter. */
   category: string;
   /** Absolute path to the SKILL.md file. */
@@ -13,6 +15,10 @@ export interface SkillPointer {
   fileBytes: number;
   /** Short description extracted from frontmatter (truncated). */
   description?: string;
+  /** Structured keywords from the generated manifest. */
+  keywords?: string[];
+  /** Structured triggers from the generated manifest. */
+  triggers?: string[];
 }
 
 export interface VaultManifest {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cubis/foundry",
-  "version": "0.3.67",
+  "version": "0.3.69",
   "description": "Cubis Foundry CLI for workflow-first AI agent environments",
   "type": "module",
   "bin": {
@@ -29,31 +29,38 @@
   "scripts": {
     "start": "npm run build:cli && node bin/cubis.js",
     "check": "npm run build:cli && node bin/cubis.js --help",
-    "test:attributes": "node scripts/validate-platform-attributes.mjs && node scripts/validate-shared-routing.mjs && node scripts/validate-skill-packaging.mjs && node scripts/validate-runtime-wiring.mjs && node scripts/generate-skills-index.mjs --check",
-    "test:attributes:strict": "node scripts/validate-platform-attributes.mjs --strict && node scripts/validate-shared-routing.mjs && node scripts/validate-skill-packaging.mjs && node scripts/validate-runtime-wiring.mjs && node scripts/generate-skills-index.mjs --check",
+    "test:attributes": "node scripts/validate-platform-attributes.mjs && node scripts/validate-shared-routing.mjs && node scripts/validate-skill-packaging.mjs && node scripts/validate-runtime-wiring.mjs && node scripts/generate-skills-index.mjs --check && node scripts/generate-skill-catalog.mjs --check",
+    "test:attributes:strict": "node scripts/validate-platform-attributes.mjs --strict && node scripts/validate-shared-routing.mjs && node scripts/validate-skill-packaging.mjs && node scripts/validate-runtime-wiring.mjs && node scripts/generate-skills-index.mjs --check && node scripts/generate-skill-catalog.mjs --check",
     "test:tech-md": "node scripts/test-tech-md-scanner.mjs",
     "test:smoke": "npm run build:cli && node scripts/run-bash-script.mjs scripts/smoke-workflows.sh",
     "test:init:tty": "npm run build:cli && node scripts/run-init-tty-test.mjs bin/cubis.js",
     "test:mcp:docker": "node scripts/run-bash-script.mjs scripts/test-mcp-docker.sh",
     "test:all": "npm run test:attributes && npm run test:smoke",
     "test:all:strict": "npm run test:attributes:strict && npm run test:smoke",
+    "test:ci": "npm run check:generated-assets && npm run test:all",
     "generate:platform-assets": "node scripts/generate-platform-assets.mjs",
     "sync:skill-mirrors": "node scripts/sync-skill-mirrors.mjs",
     "generate:skills-index": "node scripts/generate-skills-index.mjs",
+    "generate:skill-catalog": "node scripts/generate-skill-catalog.mjs",
+    "generate:public-skill-research": "node scripts/generate-public-skill-research.mjs",
+    "check:platform-assets": "node scripts/generate-platform-assets.mjs --check",
+    "check:skill-mirrors": "node scripts/sync-skill-mirrors.mjs --check",
     "check:skills-index": "node scripts/generate-skills-index.mjs --check",
+    "check:skill-catalog": "node scripts/generate-skill-catalog.mjs --check",
+    "check:generated-assets": "npm run check:platform-assets && npm run check:skill-mirrors && npm run validate:mcp-manifest && npm run check:mcp-rules:all",
     "generate:mcp-manifest": "node scripts/generate-mcp-manifest.mjs",
     "generate:mcp-rules-block": "node scripts/generate-mcp-rules-block.mjs",
     "inject:mcp-rules:codex": "node scripts/generate-mcp-rules-block.mjs --inject workflows/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md",
     "inject:mcp-rules:antigravity": "node scripts/generate-mcp-rules-block.mjs --inject workflows/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md",
-    "inject:mcp-rules:copilot-agents": "node scripts/generate-mcp-rules-block.mjs --inject workflows/workflows/agent-environment-setup/platforms/copilot/rules/AGENTS.md",
     "inject:mcp-rules:copilot": "node scripts/generate-mcp-rules-block.mjs --inject workflows/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md",
-    "inject:mcp-rules:all": "npm run inject:mcp-rules:codex && npm run inject:mcp-rules:antigravity && npm run inject:mcp-rules:copilot-agents && npm run inject:mcp-rules:copilot",
+    "inject:mcp-rules:claude": "node scripts/generate-mcp-rules-block.mjs --inject workflows/workflows/agent-environment-setup/platforms/claude/rules/CLAUDE.md",
+    "inject:mcp-rules:all": "npm run inject:mcp-rules:codex && npm run inject:mcp-rules:antigravity && npm run inject:mcp-rules:copilot && npm run inject:mcp-rules:claude",
     "check:mcp-rules:codex": "node scripts/generate-mcp-rules-block.mjs --check workflows/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md",
     "check:mcp-rules:antigravity": "node scripts/generate-mcp-rules-block.mjs --check workflows/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md",
-    "check:mcp-rules:copilot-agents": "node scripts/generate-mcp-rules-block.mjs --check workflows/workflows/agent-environment-setup/platforms/copilot/rules/AGENTS.md",
     "check:mcp-rules:copilot": "node scripts/generate-mcp-rules-block.mjs --check workflows/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md",
-    "check:mcp-rules:all": "npm run check:mcp-rules:codex && npm run check:mcp-rules:antigravity && npm run check:mcp-rules:copilot-agents && npm run check:mcp-rules:copilot",
-    "generate:all": "npm run generate:skills-index && npm run generate:mcp-manifest && npm run inject:mcp-rules:all",
+    "check:mcp-rules:claude": "node scripts/generate-mcp-rules-block.mjs --check workflows/workflows/agent-environment-setup/platforms/claude/rules/CLAUDE.md",
+    "check:mcp-rules:all": "npm run check:mcp-rules:codex && npm run check:mcp-rules:antigravity && npm run check:mcp-rules:copilot && npm run check:mcp-rules:claude",
+    "generate:all": "npm run generate:platform-assets && npm run sync:skill-mirrors && npm run generate:skills-index && npm run generate:skill-catalog && npm run generate:mcp-manifest && npm run inject:mcp-rules:all",
     "validate:mcp-skills": "node scripts/validate-mcp-skills.mjs",
     "validate:mcp-skills:strict": "node scripts/validate-mcp-skills.mjs --strict",
     "validate:mcp-manifest": "node scripts/generate-mcp-manifest.mjs --check",
@@ -63,7 +70,7 @@
     "generate:powers:sync": "node \"workflows/scripts/generate-powers.mjs\" --sync-skills --force",
     "build:cli": "tsc -p tsconfig.cli.json",
     "clean:cli": "rm -rf dist/cli",
-    "prepack": "npm run build:cli && npm run check:skills-index"
+    "prepack": "npm run build:cli && npm run check:skills-index && npm run check:skill-catalog"
   },
   "engines": {
     "node": ">=18.17"

package/src/cli/commands/register.ts

@@ -52,7 +52,7 @@ export function registerCommands(deps: CliRegistrationDeps) {
     .option("--bundle <bundleId>", "workflow bundle id")
     .option(
       "--platforms <items>",
-      "comma-separated platforms: codex,antigravity,copilot",
+      "comma-separated platforms: codex,antigravity,copilot,claude",
     )
     .option(
       "--skill-profile <profile>",
@@ -60,9 +60,12 @@ export function registerCommands(deps: CliRegistrationDeps) {
     )
     .option(
       "--skills-scope <scope>",
-      "scope for skills install: global|project",
+      "deprecated for init: installs are workspace-only",
+    )
+    .option(
+      "--mcp-scope <scope>",
+      "deprecated for init: MCP config installs in workspace scope",
     )
-    .option("--mcp-scope <scope>", "scope for MCP config: global|project")
     .option(
       "--mcps <items>",
       "comma-separated MCP selections: cubis-foundry,postman,stitch",