agents-inc 0.154.0 → 0.155.0

package/dist/chunk-MO5FGLVS.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+import {
+  orderDomains
+} from "./chunk-F5T6TV4Z.js";
+import {
+  DEFAULT_SELECTION_OPTIONS,
+  isScopePairCompatible,
+  validateSelection
+} from "./chunk-WCAUUBHO.js";
+import {
+  AGENT_NAMES
+} from "./chunk-XAXJWXI4.js";
+import {
+  getCategoryDomain
+} from "./chunk-RWOYPOMR.js";
+import {
+  DEFAULT_PUBLIC_SOURCE_NAME
+} from "./chunk-IO5YBKHV.js";
+
+// src/cli/lib/seed/seed-to-wizard.ts
+var KNOWN_AGENTS = new Set(AGENT_NAMES);
+function sourceForSkill(skill) {
+  return skill?.availableSources?.find((s) => s.primary)?.name ?? DEFAULT_PUBLIC_SOURCE_NAME;
+}
+function addToDomainSelections(selections, domain, category, skillId) {
+  const categorySelections = selections[domain] ??= {};
+  const skillList = categorySelections[category] ??= [];
+  if (!skillList.includes(skillId)) skillList.push(skillId);
+}
+function addToAgentStack(stack, agent, category, assignment) {
+  const agentStack = stack[agent] ??= {};
+  const assignments = agentStack[category] ??= [];
+  assignments.push(assignment);
+}
+function toSkillAssignment(skillId, load) {
+  return { id: skillId, preloaded: load === "preloaded" };
+}
+function readAgentMap(agents) {
+  const known = /* @__PURE__ */ new Map();
+  const switchedOff = /* @__PURE__ */ new Set();
+  const unknown = [];
+  for (const [name, entry] of Object.entries(agents)) {
+    if (!KNOWN_AGENTS.has(name)) unknown.push(name);
+    else if (entry.on === false) switchedOff.add(name);
+    else known.set(name, entry);
+  }
+  return { known, switchedOff, unknown };
+}
+function seedAgentScope(entry) {
+  return entry?.scope ?? DEFAULT_SELECTION_OPTIONS.scope;
+}
+function agentScopeConfig(name, entry) {
+  return {
+    name,
+    scope: seedAgentScope(entry),
+    ...entry?.model !== void 0 && { model: entry.model },
+    ...entry?.effort !== void 0 && { effort: entry.effort }
+  };
+}
+function unwritableAssignmentsError(assignments) {
+  return [
+    "This configuration cannot be installed: a project-scoped skill never reaches a sub-agent that rests at global scope, so these assignments have nowhere to be written:",
+    ...assignments.map(({ skillId, agent }) => `  ${skillId} -> ${agent}`),
+    "Re-share it with each sub-agent above pinned to the project, or each skill above at global scope."
+  ].join("\n");
+}
+function seedToWizardResult(payload, matrix) {
+  const domainSelections = {};
+  const assignedStack = {};
+  const skills = [];
+  const skippedSkillIds = [];
+  const unwritable = [];
+  const agentNames = /* @__PURE__ */ new Set();
+  const agentMap = readAgentMap(payload.agents);
+  const skippedAgentNames = new Set(agentMap.unknown);
+  for (const [skillId, entry] of Object.entries(payload.skills)) {
+    const skill = matrix.skills[skillId];
+    const domain = skill?.category ? getCategoryDomain(skill.category) : void 0;
+    if (!skill?.category || !domain) {
+      skippedSkillIds.push(skillId);
+      continue;
+    }
+    const id = skillId;
+    const category = skill.category;
+    addToDomainSelections(domainSelections, domain, category, id);
+    skills.push({
+      id,
+      scope: entry.scope,
+      // "eject" is an origin in its own right; anything else names the marketplace it came from.
+      origin: entry.install === "eject" ? "eject" : sourceForSkill(skill)
+    });
+    for (const [agentName, load] of Object.entries(entry.assignments)) {
+      if (agentMap.switchedOff.has(agentName)) continue;
+      if (!KNOWN_AGENTS.has(agentName)) {
+        skippedAgentNames.add(agentName);
+        continue;
+      }
+      const agent = agentName;
+      if (!isScopePairCompatible(entry.scope, seedAgentScope(agentMap.known.get(agent)))) {
+        unwritable.push({ skillId: id, agent });
+        continue;
+      }
+      agentNames.add(agent);
+      addToAgentStack(assignedStack, agent, category, toSkillAssignment(id, load));
+    }
+  }
+  if (unwritable.length > 0) throw new Error(unwritableAssignmentsError(unwritable));
+  for (const [name, entry] of agentMap.known) {
+    if (entry.on === true) agentNames.add(name);
+  }
+  const selectedAgents = [...agentNames];
+  return {
+    result: {
+      skills,
+      selectedAgents,
+      agentConfigs: selectedAgents.map((name) => agentScopeConfig(name, agentMap.known.get(name))),
+      assignedStack,
+      selectedStackId: payload.stackId,
+      domainSelections,
+      selectedDomains: orderDomains(Object.keys(domainSelections)),
+      // Nothing was dropped from a *saved config* — the skipped ids came off the wire and are
+      // reported to the user directly, so there is no config removal to explain.
+      unresolvableSkillIds: [],
+      cancelled: false,
+      // Revalidated here rather than taken on trust from the app that built the payload. That app
+      // validated against ITS catalog; this one skips ids it does not know and carries its own
+      // relationship rules, so a configuration that was consistent where it was authored can
+      // arrive with a requirement genuinely unmet. Running the same validator the wizard runs
+      // makes that this catalog's verdict on what it can install — reported through the spine
+      // `init` already has, beside the skips that explain it — rather than a fault in what was
+      // shared.
+      validation: validateSelection(skills.map((skill) => skill.id))
+    },
+    skippedSkillIds,
+    skippedAgentNames: [...skippedAgentNames]
+  };
+}
+
+export {
+  seedToWizardResult
+};
+//# sourceMappingURL=chunk-MO5FGLVS.js.map

package/dist/chunk-MO5FGLVS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/lib/seed/seed-to-wizard.ts"],"sourcesContent":["import { DEFAULT_SELECTION_OPTIONS } from \"@workspace/matrix\";\n\nimport { AGENT_NAMES } from \"../../types/agents.js\";\nimport { DEFAULT_PUBLIC_SOURCE_NAME } from \"../../consts.js\";\nimport { isScopePairCompatible } from \"../configuration/config-generator.js\";\nimport { getCategoryDomain } from \"../matrix/matrix-provider.js\";\nimport { validateSelection } from \"../matrix/matrix-resolver.js\";\nimport { orderDomains } from \"../wizard/domain-order.js\";\n\nimport type { WizardResultV2 } from \"../../components/wizard/wizard.js\";\nimport type { AgentName } from \"../../types/agents.js\";\nimport type { AgentScopeConfig, SkillConfig, SkillScope } from \"../../types/config.js\";\nimport type {\n  Category,\n  Domain,\n  DomainSelections,\n  MergedSkillsMatrix,\n  ResolvedSkill,\n} from \"../../types/matrix.js\";\nimport type { SkillAssignment, SkillId } from \"../../types/skills.js\";\nimport type { StackAgentConfig } from \"../../types/stacks.js\";\nimport type { SeedAgent, SeedLoadState, SeedPayload } from \"@workspace/matrix/seed\";\n\nexport type SeedMapping = {\n  result: WizardResultV2;\n  /** Ids this matrix does not know. Reported, never fatal — see the decode policy. */\n  skippedSkillIds: string[];\n  skippedAgentNames: string[];\n};\n\nconst KNOWN_AGENTS = new Set<string>(AGENT_NAMES);\n\n/** A skill's primary source, or the default marketplace. Mirrors the wizard's own resolution. */\nfunction sourceForSkill(skill: ResolvedSkill | undefined): string {\n  return skill?.availableSources?.find((s) => s.primary)?.name ?? DEFAULT_PUBLIC_SOURCE_NAME;\n}\n\nfunction addToDomainSelections(\n  selections: DomainSelections,\n  domain: Domain,\n  category: Category,\n  skillId: SkillId,\n): void {\n  const categorySelections = (selections[domain] ??= {});\n  const skillList = (categorySelections[category] ??= []);\n  if (!skillList.includes(skillId)) skillList.push(skillId);\n}\n\n/**\n * The stack mirror of {@link addToDomainSelections}: one sub-agent's own category lists, appended\n * in payload order. A `(skill, sub-agent)` pair can only occur once — `skills` is keyed by id — so\n * there is nothing to de-duplicate here.\n */\nfunction addToAgentStack(\n  stack: Partial<Record<AgentName, StackAgentConfig>>,\n  agent: AgentName,\n  category: Category,\n  assignment: SkillAssignment,\n): void {\n  const agentStack = (stack[agent] ??= {});\n  const assignments = (agentStack[category] ??= []);\n  assignments.push(assignment);\n}\n\n/** A load state is per `(skill, sub-agent)`; `preloaded` is the stack's word for the same thing. */\nfunction toSkillAssignment(skillId: SkillId, load: SeedLoadState): SkillAssignment {\n  return { id: skillId, preloaded: load === \"preloaded\" };\n}\n\n/** The payload's `agents` map, split by what this catalog can do with each entry. */\ntype SeedAgentMap = {\n  /** Known agents the map has something to say about, keyed by name. */\n  known: Map<AgentName, SeedAgent>;\n  /** Names explicitly switched off — dropped, and their assignment rows ignored with them. */\n  switchedOff: Set<string>;\n  /** Names this catalog does not know. Reported, never fatal — same policy as unknown skill ids. */\n  unknown: string[];\n};\n\nfunction readAgentMap(agents: SeedPayload[\"agents\"]): SeedAgentMap {\n  const known = new Map<AgentName, SeedAgent>();\n  const switchedOff = new Set<string>();\n  const unknown: string[] = [];\n\n  for (const [name, entry] of Object.entries(agents)) {\n    if (!KNOWN_AGENTS.has(name)) unknown.push(name);\n    else if (entry.on === false) switchedOff.add(name);\n    else known.set(name as AgentName, entry);\n  }\n\n  return { known, switchedOff, unknown };\n}\n\n/**\n * Where a sub-agent's front-matter is written is the payload's to say, per agent and\n * independently of any skill's scope: an entry may pin its agent into the project, and one that\n * names no scope goes to the user's own ~/.claude — the shared selection default, spelled once in\n * the matrix so the editor and this decode cannot disagree about it.\n */\nfunction seedAgentScope(entry: SeedAgent | undefined): SkillScope {\n  return entry?.scope ?? DEFAULT_SELECTION_OPTIONS.scope;\n}\n\n/**\n * A sub-agent's own row. Model and effort ride along on the same terms as its scope — an absent\n * key means \"keep whatever the agent's metadata says\".\n */\nfunction agentScopeConfig(name: AgentName, entry: SeedAgent | undefined): AgentScopeConfig {\n  return {\n    name,\n    scope: seedAgentScope(entry),\n    ...(entry?.model !== undefined && { model: entry.model }),\n    ...(entry?.effort !== undefined && { effort: entry.effort }),\n  };\n}\n\n/** A `(skill, sub-agent)` assignment the config model has nowhere to write. */\ntype UnwritableAssignment = { skillId: SkillId; agent: AgentName };\n\n/**\n * Names every unwritable pair, not just the first: a sharer who fixes one only to be refused for\n * the next learns nothing the first message could not have told them. Both halves of each pair are\n * named because neither alone says what to change — the skill can move to global scope, or the\n * sub-agent can be pinned to the project, and only the sharer knows which they meant.\n */\nfunction unwritableAssignmentsError(assignments: UnwritableAssignment[]): string {\n  return [\n    \"This configuration cannot be installed: a project-scoped skill never reaches a sub-agent \" +\n      \"that rests at global scope, so these assignments have nowhere to be written:\",\n    ...assignments.map(({ skillId, agent }) => `  ${skillId} -> ${agent}`),\n    \"Re-share it with each sub-agent above pinned to the project, or each skill above at global scope.\",\n  ].join(\"\\n\");\n}\n\n/**\n * Turns a shared configuration into the shape the install pipeline already consumes, so\n * `init --from` reuses `writeProjectConfig` -> skill install -> `compileAgentsAllScopes`\n * unchanged rather than growing a second path that can drift from the wizard's.\n *\n * Unknown ids are skipped, never fatal. Payloads carry catalog slugs precisely so they survive\n * catalog churn: a config shared before a skill was renamed should still install everything else,\n * and failing the whole decode would make every rename retroactively break every shared id.\n *\n * A sub-agent reaches the roster two ways: named by a surviving skill's assignment, or switched on\n * in the `agents` map. The map is the only place a configuration can say anything about an agent\n * no skill mentions, which is what makes a bare (skill-less) agent shareable at all; it also\n * carries that agent's model and effort onto its `AgentScopeConfig`.\n *\n * The `assignments` map is per `(skill, sub-agent)` and carries a load state, so it decides three\n * things the wizard cannot express separately: which sub-agents are selected, which skills land in\n * each one's stack entry, and which of those preload. That is why the result carries an\n * `assignedStack` — the install pipeline's ownership rules broadcast every scope-compatible skill\n * to every selected agent, which would hand a bare sub-agent someone else's skills.\n *\n * An unwritable `(skill, sub-agent)` pair is the one thing here that IS fatal, and it is fatal for\n * the opposite reason to the skips: an unknown id is content this catalog does not have, while an\n * unwritable pair is content it has and cannot place. Because `assignedStack` replaces the derived\n * stack wholesale, no scope filter runs on these rows downstream — they reach the writers, which\n * put them in neither half of the split config and say nothing. Refusing at the decode is what\n * keeps a payload from installing as a quieter configuration than the one that was shared.\n */\nexport function seedToWizardResult(payload: SeedPayload, matrix: MergedSkillsMatrix): SeedMapping {\n  const domainSelections: DomainSelections = {};\n  const assignedStack: Partial<Record<AgentName, StackAgentConfig>> = {};\n  const skills: SkillConfig[] = [];\n  const skippedSkillIds: string[] = [];\n  const unwritable: UnwritableAssignment[] = [];\n  const agentNames = new Set<AgentName>();\n  const agentMap = readAgentMap(payload.agents);\n  const skippedAgentNames = new Set<string>(agentMap.unknown);\n\n  for (const [skillId, entry] of Object.entries(payload.skills)) {\n    const skill = matrix.skills[skillId as SkillId];\n    const domain = skill?.category ? getCategoryDomain(skill.category) : undefined;\n\n    if (!skill?.category || !domain) {\n      skippedSkillIds.push(skillId);\n      continue;\n    }\n\n    // Past the guard the matrix knows this id, and its category is a real one: the `local`\n    // pseudo-category has no domain, so it left with the skips.\n    const id = skillId as SkillId;\n    const category = skill.category as Category;\n\n    addToDomainSelections(domainSelections, domain, category, id);\n\n    skills.push({\n      id,\n      scope: entry.scope,\n      // \"eject\" is an origin in its own right; anything else names the marketplace it came from.\n      origin: entry.install === \"eject\" ? \"eject\" : sourceForSkill(skill),\n    });\n\n    // Only assignments on skills that survived — an agent should not be switched on by a skill\n    // this catalog cannot install.\n    for (const [agentName, load] of Object.entries(entry.assignments)) {\n      if (agentMap.switchedOff.has(agentName)) continue;\n      if (!KNOWN_AGENTS.has(agentName)) {\n        skippedAgentNames.add(agentName);\n        continue;\n      }\n\n      const agent = agentName as AgentName;\n      // Rows the decode was going to ignore anyway have already left, so what reaches here is a\n      // pair the payload really asked for — and the config model's one rule about pairs applies.\n      if (!isScopePairCompatible(entry.scope, seedAgentScope(agentMap.known.get(agent)))) {\n        unwritable.push({ skillId: id, agent });\n        continue;\n      }\n\n      agentNames.add(agent);\n      // The assignment is the curation: this sub-agent holds this skill, at this load state, and\n      // no sub-agent the payload did not name holds it at all.\n      addToAgentStack(assignedStack, agent, category, toSkillAssignment(id, load));\n    }\n  }\n\n  if (unwritable.length > 0) throw new Error(unwritableAssignmentsError(unwritable));\n\n  // Bare agents: switched on by the map alone, with no skill to carry them in.\n  for (const [name, entry] of agentMap.known) {\n    if (entry.on === true) agentNames.add(name);\n  }\n\n  const selectedAgents = [...agentNames];\n\n  return {\n    result: {\n      skills,\n      selectedAgents,\n      agentConfigs: selectedAgents.map((name) => agentScopeConfig(name, agentMap.known.get(name))),\n      assignedStack,\n      selectedStackId: payload.stackId,\n      domainSelections,\n      selectedDomains: orderDomains(Object.keys(domainSelections) as Domain[]),\n      // Nothing was dropped from a *saved config* — the skipped ids came off the wire and are\n      // reported to the user directly, so there is no config removal to explain.\n      unresolvableSkillIds: [],\n      cancelled: false,\n      // Revalidated here rather than taken on trust from the app that built the payload. That app\n      // validated against ITS catalog; this one skips ids it does not know and carries its own\n      // relationship rules, so a configuration that was consistent where it was authored can\n      // arrive with a requirement genuinely unmet. Running the same validator the wizard runs\n      // makes that this catalog's verdict on what it can install — reported through the spine\n      // `init` already has, beside the skips that explain it — rather than a fault in what was\n      // shared.\n      validation: validateSelection(skills.map((skill) => skill.id)),\n    },\n    skippedSkillIds,\n    skippedAgentNames: [...skippedAgentNames],\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-Q5FLW4JG.js → chunk-OKH64JZE.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   SCROLL_VIEWPORT
-} from "./chunk-R54KIGN2.js";
+} from "./chunk-IO5YBKHV.js";
 
 // src/cli/components/hooks/use-section-scroll.ts
 import { useCallback, useEffect, useRef, useState } from "react";
@@ -118,4 +118,4 @@ export {
   useSectionScroll,
   computeRowScrollTop
 };
-//# sourceMappingURL=chunk-Q5FLW4JG.js.map
+//# sourceMappingURL=chunk-OKH64JZE.js.map

package/dist/{chunk-WRRP47PY.js → chunk-PCC4LBKB.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   StackSelection
-} from "./chunk-2IMYK4WN.js";
+} from "./chunk-PNMM5HNX.js";
 
 // src/cli/components/wizard/step-stack.tsx
 import { Box } from "ink";
@@ -14,4 +14,4 @@ var StepStack = ({ onCancel }) => {
 export {
   StepStack
 };
-//# sourceMappingURL=chunk-WRRP47PY.js.map
+//# sourceMappingURL=chunk-PCC4LBKB.js.map

package/dist/chunk-PMUABBPG.js

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+import {
+  claimSlug,
+  computeFileHash,
+  injectForkedFromMetadata,
+  readLocalSkillMetadata,
+  resolveInstallPaths,
+  seedExternalSkillSchema,
+  seedPayloadSchema,
+  validateSkillPath,
+  writeMetadataYaml
+} from "./chunk-WCAUUBHO.js";
+import {
+  glob,
+  readFile,
+  readSkillMetadata,
+  writeFile
+} from "./chunk-XAXJWXI4.js";
+import {
+  getCategoryDomain
+} from "./chunk-RWOYPOMR.js";
+import {
+  typedEntries
+} from "./chunk-VASLW636.js";
+import {
+  GITHUB_SOURCE,
+  LOCAL_SKILLS_PATH,
+  STANDARD_FILES
+} from "./chunk-IO5YBKHV.js";
+
+// src/cli/lib/seed/external-skills.ts
+import path from "path";
+function pluginInstallError(ids) {
+  return [
+    "This configuration cannot be installed: these skills travel inside it, so no marketplace serves them and they cannot be installed as plugins:",
+    ...ids.map((id) => `  ${id}`),
+    "Re-share it with each skill above set to eject, which is the only way a carried skill installs."
+  ].join("\n");
+}
+function selectedExternals(payload) {
+  return typedEntries(payload.external ?? {}).flatMap(([id, skill]) => {
+    const entry = payload.skills[id];
+    return entry ? [{ id, skill, entry }] : [];
+  });
+}
+function askedForAsPlugin(externals) {
+  return externals.filter(({ entry }) => entry.install !== "eject").map(({ id }) => id);
+}
+function externalSlug(id) {
+  return id;
+}
+function skillAuthor(repo) {
+  const [owner = repo] = repo.split("/");
+  return `@${owner}`;
+}
+function repoRef(repo) {
+  return `${GITHUB_SOURCE.GITHUB_PREFIX}${repo}`;
+}
+function externalSkillDir(id, scope, projectDir) {
+  return path.join(resolveInstallPaths(projectDir, scope).skillsDir, id);
+}
+function externalCatalogueEntry(install) {
+  return {
+    id: install.id,
+    slug: externalSlug(install.id),
+    displayName: install.skill.displayName,
+    description: install.skill.description,
+    // Boundary cast held by the guard above it: the category was confirmed against the catalogue
+    // the payload names, and this one has just been shown to declare it too.
+    category: install.skill.categoryId,
+    author: skillAuthor(install.skill.repo),
+    path: `${LOCAL_SKILLS_PATH}/${install.id}/`,
+    conflictsWith: [],
+    requires: [],
+    alternatives: [],
+    discourages: [],
+    // Local and custom for the same reason: the bytes are on this machine and nowhere else, and
+    // the skill was authored outside the vocabulary this catalogue ships.
+    local: true,
+    custom: true,
+    localPath: install.skillDir
+  };
+}
+function seatExternalSkill({ id, skill, entry }, matrix, projectDir) {
+  const domain = getCategoryDomain(skill.categoryId);
+  if (domain === void 0) return [];
+  const install = {
+    id,
+    skill,
+    domain,
+    scope: entry.scope,
+    skillDir: externalSkillDir(id, entry.scope, projectDir)
+  };
+  matrix.skills[id] = externalCatalogueEntry(install);
+  claimSlug(matrix.slugMap, externalSlug(id), id);
+  return [install];
+}
+function registerExternalSkills(payload, matrix, projectDir) {
+  const externals = selectedExternals(payload);
+  const asPlugin = askedForAsPlugin(externals);
+  if (asPlugin.length > 0) throw new Error(pluginInstallError(asPlugin));
+  return externals.flatMap((external) => seatExternalSkill(external, matrix, projectDir));
+}
+async function writeExternalSkills(installs) {
+  for (const install of installs) {
+    await writeSkillTree(install);
+    await writeSkillManifest(install);
+    await registerSkillOnDisk(install);
+  }
+}
+async function writeSkillTree(install) {
+  for (const [relativePath, contents] of Object.entries(install.skill.files)) {
+    const filePath = path.join(install.skillDir, relativePath);
+    validateSkillPath(filePath, install.skillDir, relativePath);
+    await writeFile(filePath, contents);
+  }
+}
+var FRONTMATTER_BLOCK = /^---\r?\n([\s\S]*?)\r?\n---/;
+var NAME_FIELD = /^name:.*$/m;
+function withInstalledName(manifest, install) {
+  const named = `name: ${install.id}`;
+  const block = FRONTMATTER_BLOCK.exec(manifest);
+  if (!block) {
+    return `---
+${named}
+description: ${install.skill.description}
+---
+
+${manifest}`;
+  }
+  const [whole, fields = ""] = block;
+  const renamed = NAME_FIELD.test(fields) ? fields.replace(NAME_FIELD, named) : `${named}
+${fields}`;
+  return `---
+${renamed}
+---${manifest.slice(whole.length)}`;
+}
+async function writeSkillManifest(install) {
+  const manifestPath = path.join(install.skillDir, STANDARD_FILES.SKILL_MD);
+  await writeFile(manifestPath, withInstalledName(await readFile(manifestPath), install));
+}
+function externalSkillMetadata(install, shipped) {
+  return {
+    author: skillAuthor(install.skill.repo),
+    usageGuidance: `Use when working with ${install.skill.displayName}`,
+    ...shipped,
+    displayName: install.skill.displayName,
+    slug: install.id,
+    category: install.skill.categoryId,
+    domain: install.domain,
+    cliDescription: install.skill.description,
+    custom: true
+  };
+}
+async function registerSkillOnDisk(install) {
+  const metadataPath = path.join(install.skillDir, STANDARD_FILES.METADATA_YAML);
+  const shipped = await readLocalSkillMetadata(install.skillDir);
+  await writeMetadataYaml(metadataPath, externalSkillMetadata(install, shipped));
+  await injectForkedFromMetadata(
+    install.skillDir,
+    install.id,
+    await computeFileHash(path.join(install.skillDir, STANDARD_FILES.SKILL_MD)),
+    { source: repoRef(install.skill.repo), path: install.skill.path }
+  );
+}
+function unnameableRepoMessage(id) {
+  return `${id} travels inside a shared configuration, and this installation does not record the repository its content came from`;
+}
+function uncarryableContentMessage(id, reason) {
+  return `${id} travels inside a shared configuration, and ${reason}`;
+}
+function repoFromRef(ref) {
+  if (ref === void 0 || !ref.startsWith(GITHUB_SOURCE.GITHUB_PREFIX)) return void 0;
+  return ref.slice(GITHUB_SOURCE.GITHUB_PREFIX.length);
+}
+async function readSkillTree(skillDir) {
+  const files = await glob("**/*", skillDir, { dot: true });
+  const entries = await Promise.all(
+    files.map(async (file) => [file, await readFile(path.join(skillDir, file))])
+  );
+  return Object.fromEntries(entries);
+}
+async function readCarriedSkill({ id, skillDir, provenance }) {
+  if (provenance.path === void 0) return { carries: "nothing" };
+  const repo = repoFromRef(provenance.source);
+  if (repo === void 0) return { carries: "unshareable", line: unnameableRepoMessage(id) };
+  const described = await readSkillMetadata(path.join(skillDir, STANDARD_FILES.METADATA_YAML));
+  if (!described.usable) {
+    return { carries: "unshareable", line: uncarryableContentMessage(id, described.reason) };
+  }
+  const parsed = seedExternalSkillSchema.safeParse({
+    displayName: described.metadata.displayName,
+    description: described.metadata.cliDescription,
+    categoryId: described.metadata.category,
+    repo,
+    path: provenance.path,
+    files: await readSkillTree(skillDir)
+  });
+  if (!parsed.success) {
+    const reason = parsed.error.issues.map((issue) => issue.message).join("; ");
+    return { carries: "unshareable", line: uncarryableContentMessage(id, reason) };
+  }
+  return { carries: "content", id, skill: parsed.data };
+}
+async function readCarriedSkills(owned) {
+  const reads = await Promise.all(owned.map(readCarriedSkill));
+  return {
+    external: Object.fromEntries(
+      reads.flatMap((read) => read.carries === "content" ? [[read.id, read.skill]] : [])
+    ),
+    uncarryable: reads.flatMap((read) => read.carries === "unshareable" ? [read.line] : [])
+  };
+}
+
+// src/cli/lib/seed/fetch-seed.ts
+var SEED_API_URL = process.env.AGENTS_INC_API_URL ?? "https://api.agentsinc.sh";
+var SEED_USER_AGENT = "agents-inc-cli";
+async function fetchSeedConfig(id) {
+  const url = `${SEED_API_URL}/configs/${encodeURIComponent(id)}`;
+  let response;
+  try {
+    response = await fetch(url, {
+      headers: { accept: "application/json", "user-agent": SEED_USER_AGENT }
+    });
+  } catch {
+    return { ok: false, error: `Could not reach ${SEED_API_URL} \u2014 check your connection.` };
+  }
+  if (response.status === 404) {
+    return { ok: false, error: `No configuration found for id '${id}'.` };
+  }
+  if (!response.ok) {
+    return { ok: false, error: `Fetching configuration failed (HTTP ${response.status}).` };
+  }
+  let body;
+  try {
+    body = await response.json();
+  } catch {
+    return { ok: false, error: "The configuration store returned something that is not JSON." };
+  }
+  const parsed = seedPayloadSchema.safeParse(body);
+  if (!parsed.success) {
+    return {
+      ok: false,
+      error: `Configuration '${id}' is not in a format this version of the CLI can install. Shared ids are never migrated \u2014 re-share the configuration to mint a current one, or update the CLI if that id came from a newer version.`
+    };
+  }
+  return { ok: true, payload: parsed.data };
+}
+
+export {
+  registerExternalSkills,
+  writeExternalSkills,
+  readCarriedSkills,
+  SEED_API_URL,
+  SEED_USER_AGENT,
+  fetchSeedConfig
+};
+//# sourceMappingURL=chunk-PMUABBPG.js.map

package/dist/chunk-PMUABBPG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/lib/seed/external-skills.ts","../src/cli/lib/seed/fetch-seed.ts"],"sourcesContent":["import path from \"path\";\n\nimport { seedExternalSkillSchema } from \"@workspace/matrix/seed\";\n\nimport { GITHUB_SOURCE, LOCAL_SKILLS_PATH, STANDARD_FILES } from \"../../consts.js\";\nimport { resolveInstallPaths } from \"../installation/install-base-dir.js\";\nimport { readSkillMetadata } from \"../loading/loader.js\";\nimport { getCategoryDomain } from \"../matrix/matrix-provider.js\";\nimport { claimSlug } from \"../matrix/skill-resolution.js\";\nimport { validateSkillPath } from \"../skills/skill-copier.js\";\nimport {\n  injectForkedFromMetadata,\n  readLocalSkillMetadata,\n  writeMetadataYaml,\n} from \"../skills/skill-metadata.js\";\nimport { computeFileHash } from \"../versioning.js\";\nimport { glob, readFile, writeFile } from \"../../utils/fs.js\";\nimport { typedEntries } from \"../../utils/typed-object.js\";\n\nimport type { SkillScope } from \"../../types/config.js\";\nimport type { Domain, MergedSkillsMatrix, ResolvedSkill } from \"../../types/matrix.js\";\nimport type { CategoryPath, SkillId, SkillSlug } from \"../../types/skills.js\";\nimport type { ForkedFromMetadata, LocalSkillMetadata } from \"../skills/skill-metadata.js\";\nimport type {\n  SeedExternalSkill,\n  SeedPayload,\n  SeedSkill,\n  SeedSkillTree,\n} from \"@workspace/matrix/seed\";\n\n/**\n * One skill the payload carries rather than names, seated and ready to be written.\n *\n * `skillDir` and `domain` are resolved once, where the checks that make them safe already are:\n * the directory has to be the one the catalogue entry points at, because that is what tells the\n * copy step this skill is already where it belongs, and the domain is what the category guard has\n * just proved this catalogue declares.\n */\nexport type ExternalSkillInstall = {\n  id: SkillId;\n  scope: SkillScope;\n  skill: SeedExternalSkill;\n  domain: Domain;\n  skillDir: string;\n};\n\n/** One external entry with the skill row that selected it — what the payload says about it. */\ntype SelectedExternal = { id: SkillId; skill: SeedExternalSkill; entry: SeedSkill };\n\n/**\n * Names every carried skill a payload asks to install as a plugin, not just the first.\n *\n * There is nothing to install them FROM: the payload is the source, so no marketplace serves\n * these ids. Coercing them to eject would install something the payload did not ask for, under a\n * mode the sharer's own screen still shows as plugin — so the ids are named and the run stops.\n */\nfunction pluginInstallError(ids: SkillId[]): string {\n  return [\n    \"This configuration cannot be installed: these skills travel inside it, so no marketplace \" +\n      \"serves them and they cannot be installed as plugins:\",\n    ...ids.map((id) => `  ${id}`),\n    \"Re-share it with each skill above set to eject, which is the only way a carried skill installs.\",\n  ].join(\"\\n\");\n}\n\n/**\n * The external entries this selection actually names.\n *\n * Presence in `skills` is selection and `external` is only where the bytes are, so content nobody\n * picked installs nothing — seating it would put a skill in the catalogue no part of the\n * configuration asked for.\n */\nfunction selectedExternals(payload: SeedPayload): SelectedExternal[] {\n  return typedEntries<SkillId, SeedExternalSkill>(payload.external ?? {}).flatMap(([id, skill]) => {\n    const entry = payload.skills[id];\n    return entry ? [{ id, skill, entry }] : [];\n  });\n}\n\nfunction askedForAsPlugin(externals: SelectedExternal[]): SkillId[] {\n  return externals.filter(({ entry }) => entry.install !== \"eject\").map(({ id }) => id);\n}\n\n/**\n * Boundary cast: a carried skill's id is minted at intake and belongs to no generated union,\n * which is exactly what makes it external. It is its own slug too — a skill outside every\n * catalogue has no shorter name anything else would recognise, and the sending side says the same.\n */\nfunction externalSlug(id: SkillId): SkillSlug {\n  return id as SkillSlug;\n}\n\n/** The repository's owner as a handle, which is all the authorship a carried skill records. */\nfunction skillAuthor(repo: string): string {\n  const [owner = repo] = repo.split(\"/\");\n  return `@${owner}`;\n}\n\n/** The repository ref a carried skill's provenance records, in the form every other ref wears. */\nfunction repoRef(repo: string): string {\n  return `${GITHUB_SOURCE.GITHUB_PREFIX}${repo}`;\n}\n\n/** Where a carried skill's directory goes: under the skills directory of the scope it names. */\nfunction externalSkillDir(id: SkillId, scope: SkillScope, projectDir: string): string {\n  return path.join(resolveInstallPaths(projectDir, scope).skillsDir, id);\n}\n\n/**\n * The catalogue entry a carried skill becomes on arrival.\n *\n * It declares no relationships and is named by none, which is honest: nothing outside the\n * catalogue can say what this skill conflicts with, and nothing inside it knows the skill exists.\n */\nfunction externalCatalogueEntry(install: ExternalSkillInstall): ResolvedSkill {\n  return {\n    id: install.id,\n    slug: externalSlug(install.id),\n    displayName: install.skill.displayName,\n    description: install.skill.description,\n    // Boundary cast held by the guard above it: the category was confirmed against the catalogue\n    // the payload names, and this one has just been shown to declare it too.\n    category: install.skill.categoryId as CategoryPath,\n    author: skillAuthor(install.skill.repo),\n    path: `${LOCAL_SKILLS_PATH}/${install.id}/`,\n    conflictsWith: [],\n    requires: [],\n    alternatives: [],\n    discourages: [],\n    // Local and custom for the same reason: the bytes are on this machine and nowhere else, and\n    // the skill was authored outside the vocabulary this catalogue ships.\n    local: true,\n    custom: true,\n    localPath: install.skillDir,\n  };\n}\n\n/**\n * Seats one carried skill in the catalogue, or leaves it unseated.\n *\n * A skill is PLACED in the taxonomy and never extends it, so a category this catalogue has no\n * definition for belongs to no domain, renders in no tab and reaches no sub-agent. Left unseated,\n * the id falls to the decode's own skip, which reports it by name.\n */\nfunction seatExternalSkill(\n  { id, skill, entry }: SelectedExternal,\n  matrix: MergedSkillsMatrix,\n  projectDir: string,\n): ExternalSkillInstall[] {\n  const domain = getCategoryDomain(skill.categoryId);\n  if (domain === undefined) return [];\n\n  const install: ExternalSkillInstall = {\n    id,\n    skill,\n    domain,\n    scope: entry.scope,\n    skillDir: externalSkillDir(id, entry.scope, projectDir),\n  };\n\n  matrix.skills[id] = externalCatalogueEntry(install);\n  // Completes the map over the matrix: `getSkillBySlug` is an asserting lookup, so an entry the\n  // slug map does not carry throws for anything that addresses a skill by slug.\n  claimSlug(matrix.slugMap, externalSlug(id), id);\n\n  return [install];\n}\n\n/**\n * Seats the catalogue entries a payload carries, and says where each one's bytes go.\n *\n * Every other id in a payload is resolved against a catalogue the receiver already has, so one it\n * does not know is skipped and reported. A carried skill answers to no catalogue at all — which is\n * why its whole directory travels — so it has to BECOME a catalogue entry before the decode reads\n * the selection, or it is skipped like any other unknown id and the configuration installs\n * quietly smaller than it was shared.\n *\n * The entries are written into `matrix` in place, exactly as the local-skill merge writes the\n * skills it discovers on disk. That matrix is the object `initializeMatrix` seated, which is what\n * {@link getCategoryDomain} reads — every caller passes the loaded source's own.\n *\n * @throws {Error} If any carried skill asks to be installed as a plugin — see\n *   {@link pluginInstallError}.\n */\nexport function registerExternalSkills(\n  payload: SeedPayload,\n  matrix: MergedSkillsMatrix,\n  projectDir: string,\n): ExternalSkillInstall[] {\n  const externals = selectedExternals(payload);\n  const asPlugin = askedForAsPlugin(externals);\n\n  if (asPlugin.length > 0) throw new Error(pluginInstallError(asPlugin));\n\n  return externals.flatMap((external) => seatExternalSkill(external, matrix, projectDir));\n}\n\n/**\n * Writes each carried skill's directory where its own entry said, and registers it on disk.\n *\n * Three things have to be true afterwards, and each is a separate act: the files are there, the\n * skill answers to the id the configuration recorded, and a metadata.yaml describes it well\n * enough for the next `edit`, `compile` or `list` to find it again. The seat above lasts one run;\n * this is what makes the install survive.\n */\nexport async function writeExternalSkills(installs: ExternalSkillInstall[]): Promise<void> {\n  for (const install of installs) {\n    await writeSkillTree(install);\n    await writeSkillManifest(install);\n    await registerSkillOnDisk(install);\n  }\n}\n\n/**\n * The directory as the payload holds it, keys and all.\n *\n * The keys came off the wire, so a payload may ask for any path it likes — including one that\n * climbs out of the skill's own directory. They answer to the same guard a marketplace's own\n * paths do.\n */\nasync function writeSkillTree(install: ExternalSkillInstall): Promise<void> {\n  for (const [relativePath, contents] of Object.entries(install.skill.files)) {\n    const filePath = path.join(install.skillDir, relativePath);\n    validateSkillPath(filePath, install.skillDir, relativePath);\n    await writeFile(filePath, contents);\n  }\n}\n\n/** The frontmatter block at the head of a SKILL.md, and the `name` field inside it. */\nconst FRONTMATTER_BLOCK = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/;\nconst NAME_FIELD = /^name:.*$/m;\n\n/**\n * Names the skill by the id it installs under.\n *\n * Every loader reads a skill's id off this one field, and a compiled sub-agent references the id\n * the configuration recorded — the one minted at intake, which is also this directory's name. The\n * repository the skill came from knew about neither, so left as it was written the two never\n * meet: the sub-agent names a skill Claude Code knows as something else, and the next load\n * registers an id no configuration carries.\n *\n * Only the name. Everything else in the block is the author's and travels untouched.\n */\nfunction withInstalledName(manifest: string, install: ExternalSkillInstall): string {\n  const named = `name: ${install.id}`;\n  const block = FRONTMATTER_BLOCK.exec(manifest);\n\n  // A manifest with no frontmatter at all describes no skill to Claude Code either. The payload\n  // carries both fields one needs, so it is given one rather than installed unreadable.\n  if (!block) {\n    return `---\\n${named}\\ndescription: ${install.skill.description}\\n---\\n\\n${manifest}`;\n  }\n\n  const [whole, fields = \"\"] = block;\n  const renamed = NAME_FIELD.test(fields)\n    ? fields.replace(NAME_FIELD, named)\n    : `${named}\\n${fields}`;\n\n  // The block is anchored at the head of the file, so what follows it is the rest verbatim.\n  return `---\\n${renamed}\\n---${manifest.slice(whole.length)}`;\n}\n\nasync function writeSkillManifest(install: ExternalSkillInstall): Promise<void> {\n  const manifestPath = path.join(install.skillDir, STANDARD_FILES.SKILL_MD);\n  await writeFile(manifestPath, withInstalledName(await readFile(manifestPath), install));\n}\n\n/**\n * What the payload confirmed, over what the repository shipped, over what neither says.\n *\n * The order is the whole of it. The taxonomy is the placement the user chose against the\n * catalogue this configuration names, and the repository's own idea of where its skill belongs\n * answers to a taxonomy nobody here shares — so that is written over the file. Everything else\n * the repository wrote is kept, because its author knows more about their skill than a default\n * does.\n *\n * The defaults underneath exist because `doctor` validates every installed metadata.yaml, and a\n * file this command writes that that command reports as an error is the CLI disagreeing with\n * itself — in a file the user cannot fix, since the skill is somebody else's repository. Neither\n * is invented: the authorship is the repository's owner, and the usage line is the same words the\n * stack loader already writes for every skill reference it has nothing more specific for.\n */\nfunction externalSkillMetadata(\n  install: ExternalSkillInstall,\n  shipped: LocalSkillMetadata | null,\n): LocalSkillMetadata {\n  return {\n    author: skillAuthor(install.skill.repo),\n    usageGuidance: `Use when working with ${install.skill.displayName}`,\n    ...shipped,\n    displayName: install.skill.displayName,\n    slug: install.id,\n    category: install.skill.categoryId,\n    domain: install.domain,\n    cliDescription: install.skill.description,\n    custom: true,\n  };\n}\n\n/**\n * Registers the skill on disk, where the next command will look for it.\n *\n * `forkedFrom` is stamped through the one writer that stamps it, because it is the package's\n * single answer to \"did the CLI put this directory here?\" — `uninstall` reads it to decide what it\n * may delete, and the producer reads it to decide what the round trip owns. A carried skill IS the\n * round trip's; a skill the user wrote by hand is not, and carries nothing.\n *\n * The repository AND the directory inside it, because this is the only record of where these bytes\n * came from. Sharing this installation has to rebuild the entry the payload carried, and a\n * repository alone cannot say which of its directories travelled — see {@link readCarriedSkills}.\n */\nasync function registerSkillOnDisk(install: ExternalSkillInstall): Promise<void> {\n  const metadataPath = path.join(install.skillDir, STANDARD_FILES.METADATA_YAML);\n  const shipped = await readLocalSkillMetadata(install.skillDir);\n\n  await writeMetadataYaml(metadataPath, externalSkillMetadata(install, shipped));\n  await injectForkedFromMetadata(\n    install.skillDir,\n    install.id,\n    await computeFileHash(path.join(install.skillDir, STANDARD_FILES.SKILL_MD)),\n    { source: repoRef(install.skill.repo), path: install.skill.path },\n  );\n}\n\n/**\n * One installed skill directory the round trip owns, and what its install recorded about it.\n *\n * Read by the caller rather than here: whether a directory is the CLI's copy or the user's own\n * work is a question about ownership, which `installation-payload.ts` already asks of every entry\n * before anything else. This module answers only the next one — whether the bytes have to travel.\n */\nexport type OwnedSkillDir = { id: string; skillDir: string; provenance: ForkedFromMetadata };\n\n/**\n * What one installation carries rather than names.\n *\n * The same shape the mapper's other readings wear: what can travel, and the lines naming what\n * cannot. Both halves matter — a payload quietly missing content it could not read still mints an\n * id, and that id installs a configuration nobody chose.\n */\nexport type ContentReading = {\n  /** Skill id -> the entry a receiver seats it from. Keyed exactly as the wire keys `external`. */\n  external: Record<string, SeedExternalSkill>;\n  /** One line per skill whose content this installation cannot carry, for the refusal. */\n  uncarryable: string[];\n};\n\n/** What one owned directory turns out to carry: content, a reason it cannot, or nothing. */\ntype CarriedRead =\n  | { carries: \"content\"; id: string; skill: SeedExternalSkill }\n  | { carries: \"nothing\" }\n  | { carries: \"unshareable\"; line: string };\n\nfunction unnameableRepoMessage(id: string): string {\n  return `${id} travels inside a shared configuration, and this installation does not record the repository its content came from`;\n}\n\nfunction uncarryableContentMessage(id: string, reason: string): string {\n  return `${id} travels inside a shared configuration, and ${reason}`;\n}\n\n/**\n * The inverse of {@link repoRef}: the repository a ref names, or nothing when it names none this\n * contract can state.\n *\n * Provenance is written as a ref because that is the form every other source in a configuration\n * wears; the wire wants GitHub's own `owner/name`. Any other ref is a repository this contract has\n * no word for, which is a refusal rather than something to guess at.\n */\nfunction repoFromRef(ref: string | undefined): string | undefined {\n  if (ref === undefined || !ref.startsWith(GITHUB_SOURCE.GITHUB_PREFIX)) return undefined;\n  return ref.slice(GITHUB_SOURCE.GITHUB_PREFIX.length);\n}\n\n/** Every file under the skill, keyed by its path relative to it — dotfiles and nesting included. */\nasync function readSkillTree(skillDir: string): Promise<SeedSkillTree> {\n  const files = await glob(\"**/*\", skillDir, { dot: true });\n  const entries = await Promise.all(\n    files.map(async (file) => [file, await readFile(path.join(skillDir, file))] as const),\n  );\n  return Object.fromEntries(entries);\n}\n\n/**\n * Rebuilds the entry a carried skill arrived as, from the directory the install wrote.\n *\n * The bytes as they stand rather than as they arrived: the manifest was renamed to the id this\n * install recorded, and a user may have edited the skill since. Both are what is installed here,\n * and what is installed here is what a share carries.\n *\n * Validated against the contract's own schema rather than by rules restated here — that is what\n * makes the weight limit, the manifest requirement and every field's shape one definition rather\n * than two that can drift.\n */\nasync function readCarriedSkill({ id, skillDir, provenance }: OwnedSkillDir): Promise<CarriedRead> {\n  // The directory is what marks a skill as one no catalogue can resolve. Without it there is a\n  // catalogue behind this id, so the receiver installs it from there and the bytes stay home.\n  if (provenance.path === undefined) return { carries: \"nothing\" };\n\n  const repo = repoFromRef(provenance.source);\n  if (repo === undefined) return { carries: \"unshareable\", line: unnameableRepoMessage(id) };\n\n  const described = await readSkillMetadata(path.join(skillDir, STANDARD_FILES.METADATA_YAML));\n  if (!described.usable) {\n    return { carries: \"unshareable\", line: uncarryableContentMessage(id, described.reason) };\n  }\n\n  const parsed = seedExternalSkillSchema.safeParse({\n    displayName: described.metadata.displayName,\n    description: described.metadata.cliDescription,\n    categoryId: described.metadata.category,\n    repo,\n    path: provenance.path,\n    files: await readSkillTree(skillDir),\n  });\n  if (!parsed.success) {\n    const reason = parsed.error.issues.map((issue) => issue.message).join(\"; \");\n    return { carries: \"unshareable\", line: uncarryableContentMessage(id, reason) };\n  }\n\n  return { carries: \"content\", id, skill: parsed.data };\n}\n\n/**\n * What a set of owned skill directories carries, and what it cannot.\n *\n * The mirror of {@link registerExternalSkills}: that seats an entry a payload carried and writes\n * its bytes, this reads those bytes back into the entry a payload carries. Every other id in a\n * configuration is resolved by the receiver against a catalogue it already has, so its content has\n * nothing to add; an added skill answers to no catalogue in either direction, and a share that\n * named it without carrying it would mint an id that installs a configuration missing it.\n */\nexport async function readCarriedSkills(owned: OwnedSkillDir[]): Promise<ContentReading> {\n  const reads = await Promise.all(owned.map(readCarriedSkill));\n\n  return {\n    external: Object.fromEntries(\n      reads.flatMap((read) => (read.carries === \"content\" ? [[read.id, read.skill]] : [])),\n    ),\n    uncarryable: reads.flatMap((read) => (read.carries === \"unshareable\" ? [read.line] : [])),\n  };\n}\n","import { seedPayloadSchema, type SeedPayload } from \"@workspace/matrix/seed\";\n\n/** The config store behind agentsinc.sh. Overridable so tests never touch the network. */\nexport const SEED_API_URL = process.env.AGENTS_INC_API_URL ?? \"https://api.agentsinc.sh\";\n\n/**\n * Identifies this fetch as the CLI rather than a browser.\n *\n * `GET /configs/:id` is the only place either side can observe a config being *installed* rather\n * than merely built, and the worker can only separate that from someone opening a share link if\n * we say so. Without this the conversion signal does not exist.\n */\nexport const SEED_USER_AGENT = \"agents-inc-cli\";\n\nexport type FetchSeedResult = { ok: true; payload: SeedPayload } | { ok: false; error: string };\n\n/**\n * Fetches and validates a shared configuration.\n *\n * Every failure is a message rather than a throw: this runs before anything has been written, so\n * there is nothing to roll back and the caller's job is to explain rather than recover.\n */\nexport async function fetchSeedConfig(id: string): Promise<FetchSeedResult> {\n  const url = `${SEED_API_URL}/configs/${encodeURIComponent(id)}`;\n\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      headers: { accept: \"application/json\", \"user-agent\": SEED_USER_AGENT },\n    });\n  } catch {\n    return { ok: false, error: `Could not reach ${SEED_API_URL} — check your connection.` };\n  }\n\n  if (response.status === 404) {\n    return { ok: false, error: `No configuration found for id '${id}'.` };\n  }\n  if (!response.ok) {\n    return { ok: false, error: `Fetching configuration failed (HTTP ${response.status}).` };\n  }\n\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    return { ok: false, error: \"The configuration store returned something that is not JSON.\" };\n  }\n\n  const parsed = seedPayloadSchema.safeParse(body);\n  if (!parsed.success) {\n    // Names the remedy rather than a cause it cannot observe. The payload was validated by the\n    // store on the way IN, so a stored payload that no longer parses means the contract moved\n    // underneath it — and every way that happens lands in this one `safeParse`: an id minted\n    // before a version bump, an id minted after one, and a body that is simply broken. The CLI\n    // cannot tell them apart, and the one thing true of all three is that re-sharing fixes it,\n    // because the store content-addresses an id and a fresh share mints one under this version.\n    return {\n      ok: false,\n      error: `Configuration '${id}' is not in a format this version of the CLI can install. Shared ids are never migrated — re-share the configuration to mint a current one, or update the CLI if that id came from a newer version.`,\n    };\n  }\n\n  return { ok: true, payload: parsed.data };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-2IMYK4WN.js → chunk-PNMM5HNX.js}

@@ -7,20 +7,20 @@ import {
 } from "./chunk-XVAQG2CV.js";
 import {
   useRowScroll
-} from "./chunk-V3ENMW7G.js";
+} from "./chunk-WFRTHH3A.js";
 import {
   useWizardStore
-} from "./chunk-QQTYMW7N.js";
+} from "./chunk-F5T6TV4Z.js";
 import {
   matrix
-} from "./chunk-IPJOMAWC.js";
+} from "./chunk-RWOYPOMR.js";
 import {
   typedKeys
 } from "./chunk-VASLW636.js";
 import {
   CLI_COLORS,
   UI_SYMBOLS
-} from "./chunk-R54KIGN2.js";
+} from "./chunk-IO5YBKHV.js";
 
 // src/cli/components/wizard/stack-selection.tsx
 import { groupBy } from "remeda";
@@ -195,4 +195,4 @@ var StackSelection = ({ onCancel }) => {
 export {
   StackSelection
 };
-//# sourceMappingURL=chunk-2IMYK4WN.js.map
+//# sourceMappingURL=chunk-PNMM5HNX.js.map

package/dist/{chunk-AKQ5QISO.js → chunk-QWVXOCXO.js}

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import {
   getDomainDisplayName
-} from "./chunk-CHNA5RVS.js";
+} from "./chunk-5OKLCVM4.js";
 import {
   CheckboxGrid
-} from "./chunk-ONWEOS77.js";
+} from "./chunk-SY4X2LND.js";
 import {
   orderDomains,
   useWizardStore
-} from "./chunk-QQTYMW7N.js";
+} from "./chunk-F5T6TV4Z.js";
 import {
   DOMAIN_DESCRIPTIONS
-} from "./chunk-CBF4ZYV3.js";
+} from "./chunk-WCAUUBHO.js";
 import {
   matrix
-} from "./chunk-IPJOMAWC.js";
+} from "./chunk-RWOYPOMR.js";
 import {
   typedEntries
 } from "./chunk-VASLW636.js";
@@ -58,4 +58,4 @@ var DomainSelection = () => {
 export {
   DomainSelection
 };
-//# sourceMappingURL=chunk-AKQ5QISO.js.map
+//# sourceMappingURL=chunk-QWVXOCXO.js.map

package/dist/{chunk-IPJOMAWC.js → chunk-RWOYPOMR.js}

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  typedKeys,
   typedValues
 } from "./chunk-VASLW636.js";
 
@@ -9674,6 +9675,14 @@ function hasSkill(id) {
 function findStack(stackId) {
   return matrix.suggestedStacks.find((s) => s.id === stackId);
 }
+function byCategoryDeclarationOrder() {
+  const declarationRank = new Map(
+    typedKeys(matrix.categories).map((category, rank) => [category, rank])
+  );
+  const afterEveryDeclared = declarationRank.size;
+  const rankOf = (category) => declarationRank.get(category) ?? afterEveryDeclared;
+  return (a, b) => rankOf(a) - rankOf(b);
+}
 
 export {
   BUILT_IN_MATRIX,
@@ -9684,6 +9693,7 @@ export {
   allSkills,
   getCategoryDomain,
   hasSkill,
-  findStack
+  findStack,
+  byCategoryDeclarationOrder
 };
-//# sourceMappingURL=chunk-IPJOMAWC.js.map
+//# sourceMappingURL=chunk-RWOYPOMR.js.map