wp-typia 0.24.6 → 0.24.8

package/dist/cli.js

@@ -21,7 +21,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "wp-typia",
-    version: "0.24.6",
+    version: "0.24.8",
     description: "Canonical CLI package for wp-typia scaffolding and project workflows",
     packageManager: "bun@1.3.11",
     type: "module",
@@ -1256,7 +1256,7 @@ function buildPatternCatalogDryRunSummaryLines(result, options) {
     ...normalizationNotes.map((note) => `  ${note}`)
   ];
 }
-var PATTERN_MISSING_NAME_MESSAGE = "`wp-typia add pattern` requires <name>. Usage: wp-typia add pattern <name>.", patternAddKindEntry;
+var PATTERN_MISSING_NAME_MESSAGE = "`wp-typia add pattern` requires <name>. Usage: wp-typia add pattern <name>.", LEGACY_TAG_FLAG_WARNING = "--tag is deprecated; use repeatable --tags instead.", patternAddKindEntry;
 var init_pattern = __esm(() => {
   init_add_kind_registry_shared();
   init_cli_string_flags();
@@ -1287,6 +1287,9 @@ var init_pattern = __esm(() => {
       const catalogTitle = rawCatalogTitle;
       const tags = normalizePatternTagFlags(context.flags.tags, context.flags.tag);
       const thumbnailUrl = rawThumbnailUrl;
+      if (context.flags.tag !== undefined && context.flags.format !== "json") {
+        context.warnLine(LEGACY_TAG_FLAG_WARNING);
+      }
       return {
         execute: (cwd) => context.addRuntime.runAddPatternCommand({
           catalogTitle,
@@ -1708,6 +1711,17 @@ function buildAddKindCompletionDetails(kind, options) {
 function supportsAddKindDryRun(kind) {
   return ADD_KIND_REGISTRY[kind].supportsDryRun;
 }
+function getAddKindOptions() {
+  return ADD_KIND_IDS2.map((kind) => ({
+    description: ADD_KIND_REGISTRY[kind].description,
+    name: kind,
+    value: kind
+  }));
+}
+function getAddNameLabel(kind) {
+  const resolvedKind = isAddKindId(kind) ? kind : "block";
+  return ADD_KIND_REGISTRY[resolvedKind].nameLabel;
+}
 var ADD_KIND_REGISTRY;
 var init_add_kind_registry = __esm(() => {
   init_add_kind_ids();
@@ -2233,9 +2247,6 @@ var init_runtime_bridge_sync = __esm(() => {
 function formatMissingAddKindDetailLine() {
   return `\`wp-typia add\` requires <kind>. Usage: wp-typia add ${formatAddKindUsagePlaceholder()} ...`;
 }
-function buildMissingAddKindDetailLines() {
-  return [formatMissingAddKindDetailLine()];
-}
 function shouldPrintMissingAddKindHelp(options) {
   if (typeof options.emitOutput === "boolean") {
     return options.emitOutput;
@@ -2484,6 +2495,24 @@ async function executePlannedAddKind(kind, executionContext, context) {
   const plan = await getAddKindExecutionPlan(kind, executionContext);
   return executePreparedAddKind(kind, context, plan);
 }
+function contextAllowsInteractivePrompts(flags) {
+  return flags.format !== "json";
+}
+function shouldPromptForRequiredAddField(flags, fieldName) {
+  const value = flags[fieldName];
+  return value === undefined || value === null || typeof value === "string" && value.trim().length === 0;
+}
+async function promptForRequiredAddFields(options) {
+  const requiredFields = REQUIRED_FIELD_PROMPTS_BY_ADD_KIND[options.kind] ?? [];
+  for (const fieldName of requiredFields) {
+    if (!shouldPromptForRequiredAddField(options.flags, fieldName)) {
+      continue;
+    }
+    const label = REQUIRED_FIELD_PROMPT_LABELS[fieldName];
+    const fieldPrompt = await options.getOrCreatePrompt();
+    options.flags[fieldName] = await fieldPrompt.text(label, "", (value) => value.trim().length > 0 ? true : `${label} is required.`);
+  }
+}
 async function executeAddCommand({
   cwd,
   emitOutput = true,
@@ -2497,40 +2526,65 @@ async function executeAddCommand({
   warnLine = console.warn
 }) {
   let activePrompt;
-  const dryRun = Boolean(flags["dry-run"]);
+  const resolvedFlags = { ...flags };
+  const dryRun = Boolean(resolvedFlags["dry-run"]);
   try {
     const addRuntime = await loadCliAddRuntime();
     const isInteractiveSession = interactive ?? isInteractiveTerminal();
-    if (!kind) {
+    const getOrCreatePrompt = async () => {
+      if (activePrompt) {
+        return activePrompt;
+      }
+      const { createReadlinePrompt } = await loadCliPromptRuntime();
+      activePrompt = prompt ?? createReadlinePrompt();
+      return activePrompt;
+    };
+    let resolvedKind = kind;
+    let resolvedName = name;
+    let promptedForKind = false;
+    if (!resolvedKind && isInteractiveSession && contextAllowsInteractivePrompts(resolvedFlags)) {
+      const kindPrompt = await getOrCreatePrompt();
+      resolvedKind = await kindPrompt.select("Select what to add", getAddKindOptions().map((option) => ({
+        hint: option.description,
+        label: option.name,
+        value: option.value
+      })), 1);
+      promptedForKind = true;
+    }
+    if (!resolvedKind) {
       if (shouldPrintMissingAddKindHelp({ emitOutput })) {
         printLine(addRuntime.formatAddHelpText());
       }
       throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES16.MISSING_ARGUMENT, formatMissingAddKindDetailLine());
     }
-    if (!isAddKindId(kind)) {
-      throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES16.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
+    if (!isAddKindId(resolvedKind)) {
+      throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES16.INVALID_COMMAND, `Unknown add kind "${resolvedKind}". Expected one of: ${formatAddKindList()}.`);
+    }
+    if (!resolvedName && promptedForKind) {
+      const namePrompt = await getOrCreatePrompt();
+      resolvedName = await namePrompt.text(getAddNameLabel(resolvedKind), "", (value) => value.trim().length > 0 ? true : `${getAddNameLabel(resolvedKind)} is required.`);
+    }
+    if (promptedForKind) {
+      await promptForRequiredAddFields({
+        flags: resolvedFlags,
+        getOrCreatePrompt,
+        kind: resolvedKind
+      });
     }
-    if (dryRun && !supportsAddKindDryRun(kind)) {
-      throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES16.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
+    if (dryRun && !supportsAddKindDryRun(resolvedKind)) {
+      throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES16.INVALID_ARGUMENT, `\`wp-typia add ${resolvedKind}\` does not support \`--dry-run\` yet.`);
     }
     const executionContext = {
       addRuntime,
       cwd,
-      flags,
-      getOrCreatePrompt: async () => {
-        if (activePrompt) {
-          return activePrompt;
-        }
-        const { createReadlinePrompt } = await loadCliPromptRuntime();
-        activePrompt = prompt ?? createReadlinePrompt();
-        return activePrompt;
-      },
+      flags: resolvedFlags,
+      getOrCreatePrompt,
       isInteractiveSession,
-      name,
+      name: resolvedName,
       positionalArgs,
       warnLine
     };
-    return await executePlannedAddKind(kind, executionContext, {
+    return await executePlannedAddKind(resolvedKind, executionContext, {
       cwd,
       dryRun,
       emitOutput,
@@ -2547,13 +2601,29 @@ async function executeAddCommand({
     }
   }
 }
-var loadCliAddRuntime = () => import("@wp-typia/project-tools/cli-add"), loadCliPromptRuntime = () => import("@wp-typia/project-tools/cli-prompt");
+var loadCliAddRuntime = () => import("@wp-typia/project-tools/cli-add"), loadCliPromptRuntime = () => import("@wp-typia/project-tools/cli-prompt"), REQUIRED_FIELD_PROMPTS_BY_ADD_KIND, REQUIRED_FIELD_PROMPT_LABELS;
 var init_runtime_bridge_add = __esm(() => {
   init_add_kind_registry();
   init_cli_error_messages();
   init_runtime_bridge_add_dry_run();
   init_runtime_bridge_output();
   init_runtime_bridge_shared();
+  REQUIRED_FIELD_PROMPTS_BY_ADD_KIND = {
+    "core-variation": ["block"],
+    "hooked-block": ["anchor", "position"],
+    "post-meta": ["post-type"],
+    style: ["block"],
+    transform: ["from", "to"],
+    variation: ["block"]
+  };
+  REQUIRED_FIELD_PROMPT_LABELS = {
+    anchor: "Anchor block",
+    block: "Target block",
+    from: "Source block",
+    position: "Hook position",
+    "post-type": "Post type",
+    to: "Target block"
+  };
 });
 
 // src/runtime-bridge-create.ts
@@ -2750,10 +2820,7 @@ var exports_add = {};
 __export(exports_add, {
   dispatchPortableCliAdd: () => dispatchPortableCliAdd
 });
-import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES18,
-  createCliCommandError as createCliCommandError6
-} from "@wp-typia/project-tools/cli-diagnostics";
+import { createCliCommandError as createCliCommandError6 } from "@wp-typia/project-tools/cli-diagnostics";
 function resolvePortableCliAddName(positionals) {
   if (positionals[1] === "core-variation" && positionals[3]) {
     return positionals[3];
@@ -2767,17 +2834,6 @@ async function dispatchPortableCliAdd({
   printLine,
   warnLine
 }) {
-  if (!positionals[1]) {
-    if (shouldPrintMissingAddKindHelp({ format: mergedFlags.format })) {
-      const { formatAddHelpText } = await import("@wp-typia/project-tools/cli-add");
-      printLine(formatAddHelpText());
-    }
-    throw createCliCommandError6({
-      code: CLI_DIAGNOSTIC_CODES18.MISSING_ARGUMENT,
-      command: "add",
-      detailLines: buildMissingAddKindDetailLines()
-    });
-  }
   const kind = positionals[1];
   const name = resolvePortableCliAddName(positionals);
   const positionalArgs = positionals.slice(1);
@@ -2821,7 +2877,6 @@ async function dispatchPortableCliAdd({
   });
 }
 var init_add2 = __esm(() => {
-  init_cli_error_messages();
   init_runtime_bridge();
   init_runtime_bridge_output();
 });
@@ -2832,7 +2887,7 @@ __export(exports_create, {
   dispatchPortableCliCreate: () => dispatchPortableCliCreate
 });
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES19,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES18,
   createCliCommandError as createCliCommandError7
 } from "@wp-typia/project-tools/cli-diagnostics";
 async function dispatchPortableCliCreate({
@@ -2845,7 +2900,7 @@ async function dispatchPortableCliCreate({
   const projectDir = positionals[1];
   if (!projectDir) {
     throw createCliCommandError7({
-      code: CLI_DIAGNOSTIC_CODES19.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES18.MISSING_ARGUMENT,
       command: "create",
       detailLines: buildMissingCreateProjectDirDetailLines()
     });
@@ -2887,7 +2942,7 @@ __export(exports_doctor, {
   dispatchPortableCliDoctor: () => dispatchPortableCliDoctor
 });
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES20,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES19,
   createCliCommandError as createCliCommandError8
 } from "@wp-typia/project-tools/cli-diagnostics";
 async function renderPortableCliDoctorJson(cwd, exitPolicy, printLine) {
@@ -2904,7 +2959,7 @@ async function renderPortableCliDoctorJson(cwd, exitPolicy, printLine) {
   }, null, 2));
   if (summary.exitCode === 1) {
     throw createCliCommandError8({
-      code: CLI_DIAGNOSTIC_CODES20.DOCTOR_CHECK_FAILED,
+      code: CLI_DIAGNOSTIC_CODES19.DOCTOR_CHECK_FAILED,
       command: "doctor",
       detailLines: getDoctorExitFailureDetailLines(checks, { exitPolicy }),
       summary: "One or more doctor checks failed."
@@ -2933,7 +2988,7 @@ __export(exports_templates, {
   dispatchPortableCliTemplates: () => dispatchPortableCliTemplates
 });
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES21,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES20,
   createCliCommandError as createCliCommandError9
 } from "@wp-typia/project-tools/cli-diagnostics";
 import {
@@ -2950,7 +3005,7 @@ function renderPortableCliTemplatesJson(printLine, flags, subcommand) {
   const templateId = flags.id;
   if (!templateId) {
     throw createCliCommandError9({
-      code: CLI_DIAGNOSTIC_CODES21.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES20.MISSING_ARGUMENT,
       command: "templates",
       detailLines: ["`wp-typia templates inspect` requires <template-id>."]
     });
@@ -2958,7 +3013,7 @@ function renderPortableCliTemplatesJson(printLine, flags, subcommand) {
   const template = getTemplateById(templateId);
   if (!template) {
     throw createCliCommandError9({
-      code: CLI_DIAGNOSTIC_CODES21.INVALID_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES20.INVALID_ARGUMENT,
       command: "templates",
       detailLines: [`Unknown template "${templateId}".`]
     });
@@ -2977,7 +3032,7 @@ async function dispatchPortableCliTemplates({
   const resolvedSubcommand = subcommand ?? (templateId ? "inspect" : "list");
   if (resolvedSubcommand !== "list" && resolvedSubcommand !== "inspect") {
     throw createCliCommandError9({
-      code: CLI_DIAGNOSTIC_CODES21.INVALID_COMMAND,
+      code: CLI_DIAGNOSTIC_CODES20.INVALID_COMMAND,
       command: "templates",
       detailLines: [
         `Unknown templates subcommand "${resolvedSubcommand}". Expected list or inspect.`
@@ -3428,7 +3483,7 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   template: {
-    description: "Optional built-in block family for the new block; interactive flows let you choose it when omitted and non-interactive runs default to basic.",
+    description: "Built-in block family for add block; one of basic, interactivity, persistence, or compound. Defaults to basic in non-interactive runs; interactive runs prompt when omitted.",
     short: "t",
     type: "string"
   },
@@ -3713,8 +3768,9 @@ function collectOptionNamesByType(metadata, type) {
 }
 function formatPortableCliOptionHelp(metadata) {
   return Object.entries(metadata).filter(([, option]) => !option.hidden).map(([name, option]) => {
-    const short = option.short ? `, -${option.short}` : "";
-    return `- --${name}${short}: ${option.description}`;
+    const valueLabel = option.type === "string" ? " <value>" : "";
+    const short = option.short ? `, -${option.short}${valueLabel}` : "";
+    return `- --${name}${valueLabel}${short}: ${option.description}`;
   });
 }
 function buildCommandOptionParser(...metadataMaps) {
@@ -3756,6 +3812,9 @@ function createMissingOptionValueError(optionLabel) {
 function createUnknownOptionError(optionLabel) {
   return createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `Unknown option \`${optionLabel}\`.`);
 }
+function createValueShortFlagClusterError(clusterLabel, optionLabel) {
+  return createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `Short flag cluster \`${clusterLabel}\` contains value-taking short flag \`${optionLabel}\`; spell value flags separately.`);
+}
 function walkArgvOptions(argv, options) {
   const flags = {};
   const nextArgv = [];
@@ -3773,6 +3832,23 @@ function walkArgvOptions(argv, options) {
       nextArgv.push(...argv.slice(index + (options.strict ? 1 : 0)));
       break;
     }
+    if (arg.length > 2 && arg.startsWith("-") && !arg.startsWith("--")) {
+      if (!options.strict) {
+        nextArgv.push(arg);
+        continue;
+      }
+      for (const shortName of arg.slice(1)) {
+        const shortFlag = options.parser.shortFlagMap.get(shortName);
+        if (!shortFlag) {
+          throw createUnknownOptionError(`-${shortName}`);
+        }
+        if (shortFlag.type !== "boolean") {
+          throw createValueShortFlagClusterError(arg, `-${shortName}`);
+        }
+        flags[shortFlag.name] = true;
+      }
+      continue;
+    }
     if (arg.length === 2 && arg.startsWith("-")) {
       const shortFlag = options.parser.shortFlagMap.get(arg.slice(1));
       if (!shortFlag || !options.strict && !optionNames.has(shortFlag.name)) {
@@ -4276,6 +4352,15 @@ function renderNoCommandHelp(printLine) {
   printBlock(printLine, [PORTABLE_CLI_NO_COMMAND_REASON_LINE, ""]);
   renderGeneralHelp(printLine);
 }
+function renderUnknownHelpTarget(printLine, target) {
+  const suggestion = suggestTopLevelCommandTypo(target);
+  printBlock(printLine, [
+    `Unknown help target "${target}".`,
+    ...suggestion ? [`Did you mean "${suggestion}"? Run wp-typia ${suggestion} --help.`] : [],
+    `Supported commands: ${WP_TYPIA_PORTABLE_CLI_TOP_LEVEL_COMMAND_NAMES.join(", ")}.`,
+    "Run wp-typia --help for general usage."
+  ]);
+}
 function renderPortableCliCommandHelp(printLine, config) {
   printBlock(printLine, [
     config.heading,
@@ -4324,7 +4409,8 @@ var PORTABLE_CLI_COMMAND_HELP_CONFIG = {
   },
   skills: {
     bodyLines: [
-      "List detected coding agents or generate a compact wp-typia SKILL.md from command metadata."
+      "List detected coding agents or generate a compact wp-typia SKILL.md from command metadata.",
+      "Use --local to install project-local skills; generated universal skills under .agents/skills/wp-typia/ are added to .gitignore."
     ],
     heading: "Usage: wp-typia skills <list|sync>",
     optionMetadata: SKILLS_OPTION_METADATA
@@ -4403,7 +4489,7 @@ async function handlePortableCliEntrypointError(error, argv) {
 
 // src/node-cli.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES22,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES21,
   createCliCommandError as createCliCommandError10
 } from "@wp-typia/project-tools/cli-diagnostics";
 
@@ -5089,6 +5175,7 @@ var defaultSkillRuntime = {
   homeDir: () => os2.homedir()
 };
 var GENERATED_SKILL_MARKER = ".wp-typia-skill.json";
+var LOCAL_SKILL_GITIGNORE_ENTRY = ".agents/skills/wp-typia/";
 var SKILL_FILE = "SKILL.md";
 function configHome(home) {
   return process.env.XDG_CONFIG_HOME || path7.join(home, ".config");
@@ -5365,6 +5452,41 @@ function resolveParent(dir) {
     }
   }
 }
+function detectLineEnding(content) {
+  return content.includes(`\r
+`) ? `\r
+` : `
+`;
+}
+async function ensureLocalSkillsGitignore(cwd) {
+  const gitignorePath = path7.join(cwd, ".gitignore");
+  const entries = [LOCAL_SKILL_GITIGNORE_ENTRY];
+  let content = "";
+  let exists = true;
+  try {
+    content = await fsp.readFile(gitignorePath, "utf8");
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      throw error;
+    }
+    exists = false;
+  }
+  const lines = content.split(/\r?\n/u).map((line) => line.trim());
+  const missingEntries = entries.filter((entry) => !lines.includes(entry));
+  if (missingEntries.length === 0) {
+    return { entries, path: gitignorePath, updated: false };
+  }
+  const lineEnding = exists ? detectLineEnding(content) : `
+`;
+  let nextContent = content;
+  if (nextContent.length > 0 && !nextContent.endsWith(`
+`)) {
+    nextContent += lineEnding;
+  }
+  nextContent += missingEntries.map((entry) => `${entry}${lineEnding}`).join("");
+  await fsp.writeFile(gitignorePath, nextContent, "utf8");
+  return { entries, path: gitignorePath, updated: true };
+}
 async function syncSkills(options = {}) {
   const runtime = options.runtime ?? defaultSkillRuntime;
   const cwd = options.cwd ?? process.cwd();
@@ -5379,8 +5501,14 @@ async function syncSkills(options = {}) {
   const hash = createHash("sha256").update(content).digest("hex").slice(0, 16);
   const cacheKey = stalenessCacheKey(skillName, isGlobal, cwd, canonicalBase);
   const previousState = readState(cacheKey, runtime);
+  const gitignore = isGlobal ? undefined : await ensureLocalSkillsGitignore(cwd);
   if (!options.force && previousState?.hash === hash && previousState.agentKey === agentKey && skillTargetsAreCurrent(canonicalDir, agentDirs, content)) {
-    return { agents: [], paths: [], updated: false };
+    return {
+      agents: [],
+      gitignore,
+      paths: [],
+      updated: Boolean(gitignore?.updated)
+    };
   }
   await fsp.mkdir(canonicalDir, { recursive: true });
   await fsp.writeFile(path7.join(canonicalDir, SKILL_FILE), content, "utf8");
@@ -5415,6 +5543,7 @@ async function syncSkills(options = {}) {
   writeState(cacheKey, { agentKey, hash }, runtime);
   return {
     agents: installs,
+    gitignore,
     paths: [canonicalDir],
     updated: true
   };
@@ -5570,15 +5699,20 @@ async function dispatchPortableCliSkills({
       printLine2("Skills are up to date.");
       return;
     }
-    printLine2(`Synced skills to ${result.paths.length} location(s).`);
+    if (result.paths.length > 0) {
+      printLine2(`Synced skills to ${result.paths.length} location(s).`);
+    }
     for (const install of result.agents) {
       const reason = install.reason ? ` (${install.reason})` : "";
       printLine2(`  ${install.agent}: ${install.mode} -> ${install.path}${reason}`);
     }
+    if (result.gitignore?.updated) {
+      printLine2(`Updated .gitignore for generated local skills: ${result.gitignore.entries.join(", ")}`);
+    }
     return;
   }
   throw createCliCommandError10({
-    code: CLI_DIAGNOSTIC_CODES22.INVALID_COMMAND,
+    code: CLI_DIAGNOSTIC_CODES21.INVALID_COMMAND,
     command: "skills",
     detailLines: [
       `Unknown skills subcommand "${subcommand}". Expected list or sync.`
@@ -5724,7 +5858,7 @@ async function runNodeCli(argv = process.argv.slice(2)) {
       renderGeneralHelp(printLine);
       return;
     }
-    renderGeneralHelp(printLine);
+    renderUnknownHelpTarget(printLine, helpTarget);
     return;
   }
   if (versionRequested) {
@@ -5852,4 +5986,4 @@ export {
   runGunshiCli
 };
 
-//# debugId=4EF870F32E20097664756E2164756E21
+//# debugId=C5F9F3777C8262A064756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-typia",
-  "version": "0.24.6",
+  "version": "0.24.8",
   "description": "Canonical CLI package for wp-typia scaffolding and project workflows",
   "packageManager": "bun@1.3.11",
   "type": "module",