@agents-inc/cli 0.86.0 → 0.87.0

package/dist/chunk-XQK4S22C.js

@@ -1,202 +0,0 @@
-#!/usr/bin/env node
-import {
-  computeSkillFolderHash,
-  loadConfig
-} from "./chunk-TMTUTUEV.js";
-import {
-  ensureDir,
-  fileExists,
-  verbose,
-  writeFile
-} from "./chunk-NUU3U43A.js";
-import {
-  DEFAULT_VERSION,
-  KEBAB_CASE_PATTERN,
-  SKILL_CATEGORIES_PATH,
-  SKILL_RULES_PATH,
-  STANDARD_FILES
-} from "./chunk-6PGL2XMY.js";
-import {
-  init_esm_shims
-} from "./chunk-DHET7RCE.js";
-
-// src/cli/lib/operations/scaffold-skill.ts
-init_esm_shims();
-import path from "path";
-function validateSkillName(name) {
-  if (!name || name.trim() === "") {
-    return "Skill name is required";
-  }
-  if (!KEBAB_CASE_PATTERN.test(name)) {
-    return "Skill name must be kebab-case (lowercase letters, numbers, and hyphens, starting with a letter)";
-  }
-  return null;
-}
-function toTitleCase(kebabCase) {
-  return kebabCase.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-}
-function generateSkillMd(name) {
-  const titleName = toTitleCase(name);
-  return `---
-name: ${name}
-description: Brief description of this skill
----
-
-# ${titleName}
-
-> **Quick Guide:** Add a brief summary of what this skill teaches.
-
----
-
-<critical_requirements>
-
-## CRITICAL: Before Using This Skill
-
-**(Add critical requirements here)**
-
-</critical_requirements>
-
----
-
-**When to use:**
-
-- Add use cases here
-
-**Key patterns covered:**
-
-- Add patterns here
-
----
-
-<patterns>
-
-## Core Patterns
-
-### Pattern 1: Example Pattern
-
-Add your patterns here.
-
-</patterns>
-
----
-
-<critical_reminders>
-
-## CRITICAL REMINDERS
-
-**(Repeat critical requirements here)**
-
-</critical_reminders>
-`;
-}
-function generateMetadataYaml(name, author, category, contentHash, domain) {
-  const titleName = toTitleCase(name);
-  return `# yaml-language-server: $schema=https://raw.githubusercontent.com/agents-inc/cli/main/src/schemas/custom-metadata.schema.json
-custom: true
-domain: ${domain}
-category: ${category}
-author: "${author}"
-displayName: ${titleName}
-slug: ${name}
-cliDescription: Brief description
-usageGuidance: Use when <guidance>.
-contentHash: ${contentHash}
-`;
-}
-var DEFAULT_CATEGORY_ORDER = 99;
-var CATEGORIES_TS_COMMENT = "// Skill category definitions";
-var RULES_TS_COMMENT = "// Skill rules configuration";
-function formatTsExport(comment, data) {
-  const body = JSON.stringify(data, null, 2);
-  return `${comment}
-export default ${body};
-`;
-}
-function buildCategoryEntry(category, domain) {
-  const categoryPart = category.includes("-") ? category.slice(category.indexOf("-") + 1) : category;
-  const entry = {
-    id: category,
-    displayName: toTitleCase(categoryPart),
-    description: `Skills for ${toTitleCase(categoryPart)}`,
-    exclusive: true,
-    required: false,
-    order: DEFAULT_CATEGORY_ORDER,
-    custom: true
-  };
-  entry.domain = domain;
-  return entry;
-}
-function generateSkillCategoriesTs(category, domain) {
-  const entry = buildCategoryEntry(category, domain);
-  const data = {
-    version: DEFAULT_VERSION,
-    categories: {
-      [category]: entry
-    }
-  };
-  return formatTsExport(CATEGORIES_TS_COMMENT, data);
-}
-function generateSkillRulesTs() {
-  const data = {
-    version: DEFAULT_VERSION,
-    relationships: {
-      conflicts: [],
-      discourages: [],
-      recommends: [],
-      requires: [],
-      alternatives: []
-    }
-  };
-  return formatTsExport(RULES_TS_COMMENT, data);
-}
-async function scaffoldSkillFiles(options) {
-  const { name, author, category, domain, skillDir } = options;
-  const skillMdContent = generateSkillMd(name);
-  const skillMdPath = path.join(skillDir, STANDARD_FILES.SKILL_MD);
-  const metadataPath = path.join(skillDir, STANDARD_FILES.METADATA_YAML);
-  await writeFile(skillMdPath, skillMdContent);
-  const contentHash = await computeSkillFolderHash(skillDir);
-  const metadataContent = generateMetadataYaml(name, author, category, contentHash, domain);
-  await writeFile(metadataPath, metadataContent);
-  return { skillMdPath, metadataPath, contentHash };
-}
-async function updateSkillRegistryConfig(options) {
-  const { projectRoot, category, domain } = options;
-  const categoriesPath = path.join(projectRoot, SKILL_CATEGORIES_PATH);
-  const rulesPath = path.join(projectRoot, SKILL_RULES_PATH);
-  let categoriesCreated = false;
-  let categoriesUpdated = false;
-  let rulesCreated = false;
-  if (await fileExists(categoriesPath)) {
-    const parsed = await loadConfig(categoriesPath) ?? {};
-    const categories = parsed.categories ?? {};
-    if (!categories[category]) {
-      categories[category] = buildCategoryEntry(category, domain);
-      parsed.categories = categories;
-      await writeFile(categoriesPath, formatTsExport(CATEGORIES_TS_COMMENT, parsed));
-      verbose(`Added category '${category}' to ${SKILL_CATEGORIES_PATH}`);
-      categoriesUpdated = true;
-    }
-  } else {
-    await ensureDir(path.dirname(categoriesPath));
-    await writeFile(categoriesPath, generateSkillCategoriesTs(category, domain));
-    verbose(`Created ${SKILL_CATEGORIES_PATH}`);
-    categoriesCreated = true;
-  }
-  if (!await fileExists(rulesPath)) {
-    await ensureDir(path.dirname(rulesPath));
-    await writeFile(rulesPath, generateSkillRulesTs());
-    verbose(`Created ${SKILL_RULES_PATH}`);
-    rulesCreated = true;
-  }
-  return { categoriesCreated, categoriesUpdated, rulesCreated };
-}
-
-export {
-  validateSkillName,
-  generateSkillCategoriesTs,
-  generateSkillRulesTs,
-  scaffoldSkillFiles,
-  updateSkillRegistryConfig
-};
-//# sourceMappingURL=chunk-XQK4S22C.js.map

package/dist/chunk-XQK4S22C.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli/lib/operations/scaffold-skill.ts"],"sourcesContent":["import path from \"path\";\nimport { loadConfig } from \"../configuration/config-loader.js\";\nimport { computeSkillFolderHash } from \"../versioning.js\";\nimport { writeFile, fileExists, ensureDir } from \"../../utils/fs.js\";\nimport { verbose } from \"../../utils/logger.js\";\nimport {\n  DEFAULT_VERSION,\n  KEBAB_CASE_PATTERN,\n  SKILL_CATEGORIES_PATH,\n  SKILL_RULES_PATH,\n  STANDARD_FILES,\n} from \"../../consts.js\";\nimport type { CategoryPath } from \"../../types/index.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type ScaffoldSkillOptions = {\n  name: string;\n  author: string;\n  category: CategoryPath;\n  domain: string;\n  skillDir: string;\n};\n\nexport type ScaffoldSkillResult = {\n  skillMdPath: string;\n  metadataPath: string;\n  contentHash: string;\n};\n\nexport type RegistryUpdateOptions = {\n  projectRoot: string;\n  category: CategoryPath;\n  domain: string;\n};\n\nexport type RegistryUpdateResult = {\n  categoriesCreated: boolean;\n  categoriesUpdated: boolean;\n  rulesCreated: boolean;\n};\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\n/**\n * Validates that a skill name is non-empty and matches kebab-case format.\n *\n * @returns An error message string if invalid, or `null` if valid.\n */\nexport function validateSkillName(name: string): string | null {\n  if (!name || name.trim() === \"\") {\n    return \"Skill name is required\";\n  }\n\n  if (!KEBAB_CASE_PATTERN.test(name)) {\n    return \"Skill name must be kebab-case (lowercase letters, numbers, and hyphens, starting with a letter)\";\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Content generation\n// ---------------------------------------------------------------------------\n\nexport function toTitleCase(kebabCase: string): string {\n  return kebabCase\n    .split(\"-\")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n}\n\nexport function generateSkillMd(name: string): string {\n  const titleName = toTitleCase(name);\n\n  return `---\nname: ${name}\ndescription: Brief description of this skill\n---\n\n# ${titleName}\n\n> **Quick Guide:** Add a brief summary of what this skill teaches.\n\n---\n\n<critical_requirements>\n\n## CRITICAL: Before Using This Skill\n\n**(Add critical requirements here)**\n\n</critical_requirements>\n\n---\n\n**When to use:**\n\n- Add use cases here\n\n**Key patterns covered:**\n\n- Add patterns here\n\n---\n\n<patterns>\n\n## Core Patterns\n\n### Pattern 1: Example Pattern\n\nAdd your patterns here.\n\n</patterns>\n\n---\n\n<critical_reminders>\n\n## CRITICAL REMINDERS\n\n**(Repeat critical requirements here)**\n\n</critical_reminders>\n`;\n}\n\nexport function generateMetadataYaml(\n  name: string,\n  author: string,\n  category: CategoryPath,\n  contentHash: string,\n  domain: string,\n): string {\n  const titleName = toTitleCase(name);\n\n  return `# yaml-language-server: $schema=https://raw.githubusercontent.com/agents-inc/cli/main/src/schemas/custom-metadata.schema.json\ncustom: true\ndomain: ${domain}\ncategory: ${category}\nauthor: \"${author}\"\ndisplayName: ${titleName}\nslug: ${name}\ncliDescription: Brief description\nusageGuidance: Use when <guidance>.\ncontentHash: ${contentHash}\n`;\n}\n\nconst DEFAULT_CATEGORY_ORDER = 99;\n\nconst CATEGORIES_TS_COMMENT = \"// Skill category definitions\";\nconst RULES_TS_COMMENT = \"// Skill rules configuration\";\n\nfunction formatTsExport(comment: string, data: unknown): string {\n  const body = JSON.stringify(data, null, 2);\n  return `${comment}\\nexport default ${body};\\n`;\n}\n\nfunction buildCategoryEntry(category: CategoryPath, domain: string): Record<string, unknown> {\n  const categoryPart = category.includes(\"-\")\n    ? category.slice(category.indexOf(\"-\") + 1)\n    : category;\n  const entry: Record<string, unknown> = {\n    id: category,\n    displayName: toTitleCase(categoryPart),\n    description: `Skills for ${toTitleCase(categoryPart)}`,\n    exclusive: true,\n    required: false,\n    order: DEFAULT_CATEGORY_ORDER,\n    custom: true,\n  };\n  entry.domain = domain;\n  return entry;\n}\n\nexport function generateSkillCategoriesTs(category: CategoryPath, domain: string): string {\n  const entry = buildCategoryEntry(category, domain);\n  const data = {\n    version: DEFAULT_VERSION,\n    categories: {\n      [category]: entry,\n    },\n  };\n  return formatTsExport(CATEGORIES_TS_COMMENT, data);\n}\n\nexport function generateSkillRulesTs(): string {\n  const data = {\n    version: DEFAULT_VERSION,\n    relationships: {\n      conflicts: [],\n      discourages: [],\n      recommends: [],\n      requires: [],\n      alternatives: [],\n    },\n  };\n  return formatTsExport(RULES_TS_COMMENT, data);\n}\n\n// ---------------------------------------------------------------------------\n// Scaffold operation\n// ---------------------------------------------------------------------------\n\n/**\n * Writes SKILL.md and metadata.yaml files for a new skill scaffold.\n *\n * Generates SKILL.md first, computes the content hash from the written file,\n * then generates and writes metadata.yaml with the hash included.\n *\n * Does NOT check whether the directory exists or handle --force logic;\n * the calling command is responsible for that.\n */\nexport async function scaffoldSkillFiles(\n  options: ScaffoldSkillOptions,\n): Promise<ScaffoldSkillResult> {\n  const { name, author, category, domain, skillDir } = options;\n\n  const skillMdContent = generateSkillMd(name);\n  const skillMdPath = path.join(skillDir, STANDARD_FILES.SKILL_MD);\n  const metadataPath = path.join(skillDir, STANDARD_FILES.METADATA_YAML);\n\n  await writeFile(skillMdPath, skillMdContent);\n\n  const contentHash = await computeSkillFolderHash(skillDir);\n  const metadataContent = generateMetadataYaml(name, author, category, contentHash, domain);\n  await writeFile(metadataPath, metadataContent);\n\n  return { skillMdPath, metadataPath, contentHash };\n}\n\n// ---------------------------------------------------------------------------\n// Registry update operation\n// ---------------------------------------------------------------------------\n\n/**\n * Updates skill-categories.ts and skill-rules.ts registry files in a\n * marketplace project.\n *\n * - If skill-categories.ts exists, appends the new category (skips if already present).\n * - If skill-categories.ts does not exist, creates it with the new category.\n * - If skill-rules.ts does not exist, creates a default one.\n *\n * Returns what was created/updated so the command can log appropriately.\n */\nexport async function updateSkillRegistryConfig(\n  options: RegistryUpdateOptions,\n): Promise<RegistryUpdateResult> {\n  const { projectRoot, category, domain } = options;\n\n  const categoriesPath = path.join(projectRoot, SKILL_CATEGORIES_PATH);\n  const rulesPath = path.join(projectRoot, SKILL_RULES_PATH);\n\n  let categoriesCreated = false;\n  let categoriesUpdated = false;\n  let rulesCreated = false;\n\n  // Update skill-categories.ts\n  if (await fileExists(categoriesPath)) {\n    // Boundary cast: loadConfig returns unknown structure from TS file\n    const parsed = (await loadConfig<Record<string, unknown>>(categoriesPath)) ?? {};\n    const categories = (parsed.categories ?? {}) as Record<string, unknown>;\n    if (!categories[category]) {\n      categories[category] = buildCategoryEntry(category, domain);\n      parsed.categories = categories;\n      await writeFile(categoriesPath, formatTsExport(CATEGORIES_TS_COMMENT, parsed));\n      verbose(`Added category '${category}' to ${SKILL_CATEGORIES_PATH}`);\n      categoriesUpdated = true;\n    }\n  } else {\n    await ensureDir(path.dirname(categoriesPath));\n    await writeFile(categoriesPath, generateSkillCategoriesTs(category, domain));\n    verbose(`Created ${SKILL_CATEGORIES_PATH}`);\n    categoriesCreated = true;\n  }\n\n  // Create skill-rules.ts if it doesn't exist (no aliases to update -- slugs are in metadata.yaml)\n  if (!(await fileExists(rulesPath))) {\n    await ensureDir(path.dirname(rulesPath));\n    await writeFile(rulesPath, generateSkillRulesTs());\n    verbose(`Created ${SKILL_RULES_PATH}`);\n    rulesCreated = true;\n  }\n\n  return { categoriesCreated, categoriesUpdated, rulesCreated };\n}\n"],"mappings":"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","names":[]}