wp-typia 0.24.11 → 0.24.13

package/dist/cli.js

@@ -21,7 +21,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "wp-typia",
-    version: "0.24.11",
+    version: "0.24.13",
     description: "Canonical CLI package for wp-typia scaffolding and project workflows",
     packageManager: "bun@1.3.11",
     type: "module",
@@ -77,7 +77,7 @@ var init_package = __esm(() => {
     dependencies: {
       "@gunshi/plugin-completion": "0.32.0",
       "@wp-typia/api-client": "^0.4.6",
-      "@wp-typia/project-tools": "0.24.9",
+      "@wp-typia/project-tools": "0.24.11",
       gunshi: "0.32.0",
       zod: "4.3.6"
     },
@@ -98,6 +98,104 @@ function formatAddKindUsagePlaceholder() {
 }
 var init_add_kind_ids = () => {};
 
+// src/ai-agent-detection.ts
+function detectAIAgents(env = process.env, agents = AI_AGENT_DEFINITIONS) {
+  const aiAgents = [];
+  const aiAgentEnvVars = [];
+  for (const agent of agents) {
+    if (!agent.detect(env)) {
+      continue;
+    }
+    aiAgents.push(agent.name);
+    aiAgentEnvVars.push(...agent.envVars.filter((envVar) => Boolean(env[envVar])));
+  }
+  return {
+    aiAgentEnvVars,
+    aiAgents,
+    isAIAgent: aiAgents.length > 0
+  };
+}
+var AI_AGENT_DEFINITIONS;
+var init_ai_agent_detection = __esm(() => {
+  AI_AGENT_DEFINITIONS = [
+    {
+      detect: (env) => Boolean(env.CLAUDECODE) || Boolean(env.CLAUDE_CODE),
+      envVars: ["CLAUDECODE", "CLAUDE_CODE"],
+      name: "claude"
+    },
+    {
+      detect: (env) => Boolean(env.CURSOR_AGENT),
+      envVars: ["CURSOR_AGENT"],
+      name: "cursor"
+    },
+    {
+      detect: (env) => Boolean(env.CODEX_CI) || Boolean(env.CODEX_THREAD_ID) || Boolean(env.CODEX_SANDBOX),
+      envVars: ["CODEX_CI", "CODEX_THREAD_ID", "CODEX_SANDBOX"],
+      name: "codex"
+    },
+    {
+      detect: (env) => Boolean(env.AMP_CURRENT_THREAD_ID) || env.AGENT === "amp",
+      envVars: ["AMP_CURRENT_THREAD_ID", "AGENT"],
+      name: "amp"
+    },
+    {
+      detect: (env) => Boolean(env.GEMINI_CLI),
+      envVars: ["GEMINI_CLI"],
+      name: "gemini"
+    },
+    {
+      detect: (env) => env.OPENCODE === "1",
+      envVars: ["OPENCODE"],
+      name: "opencode"
+    }
+  ];
+});
+
+// src/structured-output-notices.ts
+function getExplicitFormat(argv) {
+  for (let index = 0;index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) {
+      continue;
+    }
+    if (arg === "--") {
+      return;
+    }
+    if (arg === "--format") {
+      const next = argv[index + 1];
+      return next && !next.startsWith("-") ? next : undefined;
+    }
+    if (arg.startsWith("--format=")) {
+      return arg.slice("--format=".length) || undefined;
+    }
+  }
+  return;
+}
+function createAIAgentStructuredOutputNotice(detection) {
+  if (!detection.isAIAgent) {
+    return;
+  }
+  const agentLabel = detection.aiAgents.length > 0 ? detection.aiAgents.join(", ") : "AI agent";
+  const envLabel = detection.aiAgentEnvVars.length > 0 ? ` via ${detection.aiAgentEnvVars.join(", ")}` : "";
+  return `Detected ${agentLabel}${envLabel}; defaulting to --format json. Pass --format text for human-readable output.`;
+}
+function getStructuredOutputNoticesForArgv(argv) {
+  if (getExplicitFormat(argv) !== undefined) {
+    return [];
+  }
+  const notice = createAIAgentStructuredOutputNotice(detectAIAgents());
+  return notice ? [notice] : [];
+}
+function withStructuredOutputNotices(payload, notices) {
+  return notices && notices.length > 0 ? {
+    ...payload,
+    notices: [...notices]
+  } : payload;
+}
+var init_structured_output_notices = __esm(() => {
+  init_ai_agent_detection();
+});
+
 // src/print-block.ts
 function printBlock(printLine, lines) {
   for (const line of lines) {
@@ -2845,6 +2943,7 @@ async function dispatchPortableCliAdd({
   mergedFlags,
   positionals,
   printLine,
+  structuredNotices,
   warnLine
 }) {
   const kind = positionals[1];
@@ -2870,12 +2969,12 @@ async function dispatchPortableCliAdd({
         error
       });
     }
-    printLine(JSON.stringify(buildStructuredCompletionSuccessPayload("add", completion, {
+    printLine(JSON.stringify(withStructuredOutputNotices(buildStructuredCompletionSuccessPayload("add", completion, {
       dryRun: Boolean(mergedFlags["dry-run"]),
       kind,
       name,
       projectDir: extractCompletionProjectDir(completion) ?? cwd
-    }), null, 2));
+    }), structuredNotices), null, 2));
     return;
   }
   await executeAddCommand({
@@ -2892,6 +2991,7 @@ async function dispatchPortableCliAdd({
 var init_add2 = __esm(() => {
   init_runtime_bridge();
   init_runtime_bridge_output();
+  init_structured_output_notices();
 });
 
 // src/portable-cli/dispatchers/create.ts
@@ -2908,6 +3008,7 @@ async function dispatchPortableCliCreate({
   mergedFlags,
   positionals,
   printLine,
+  structuredNotices,
   warnLine
 }) {
   const projectDir = positionals[1];
@@ -2936,17 +3037,18 @@ async function dispatchPortableCliCreate({
     });
   }
   if (mergedFlags.format === "json") {
-    printLine(JSON.stringify(buildStructuredCompletionSuccessPayload("create", completion, {
+    printLine(JSON.stringify(withStructuredOutputNotices(buildStructuredCompletionSuccessPayload("create", completion, {
       dryRun: Boolean(mergedFlags["dry-run"]),
       projectDir: extractCompletionProjectDir(completion) ?? projectDir,
       template: typeof mergedFlags.template === "string" ? mergedFlags.template : undefined
-    }), null, 2));
+    }), structuredNotices), null, 2));
   }
 }
 var init_create2 = __esm(() => {
   init_runtime_bridge();
   init_runtime_bridge_output();
   init_cli_error_messages();
+  init_structured_output_notices();
 });
 
 // src/portable-cli/doctor.ts
@@ -2958,7 +3060,7 @@ import {
   CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES19,
   createCliCommandError as createCliCommandError8
 } from "@wp-typia/project-tools/cli-diagnostics";
-async function renderPortableCliDoctorJson(cwd, exitPolicy, wordpressVersionCheck, printLine) {
+async function renderPortableCliDoctorJson(cwd, exitPolicy, wordpressVersionCheck, printLine, structuredNotices) {
   const {
     createDoctorRunSummary,
     getDoctorChecks,
@@ -2966,10 +3068,7 @@ async function renderPortableCliDoctorJson(cwd, exitPolicy, wordpressVersionChec
   } = await import("@wp-typia/project-tools/cli-doctor");
   const checks = await getDoctorChecks(cwd, { wordpressVersionCheck });
   const summary = createDoctorRunSummary(checks, { exitPolicy });
-  printLine(JSON.stringify({
-    checks,
-    summary
-  }, null, 2));
+  printLine(JSON.stringify(withStructuredOutputNotices({ checks, summary }, structuredNotices), null, 2));
   if (summary.exitCode === 1) {
     throw createCliCommandError8({
       code: CLI_DIAGNOSTIC_CODES19.DOCTOR_CHECK_FAILED,
@@ -2982,18 +3081,20 @@ async function renderPortableCliDoctorJson(cwd, exitPolicy, wordpressVersionChec
 async function dispatchPortableCliDoctor({
   cwd,
   mergedFlags,
-  printLine
+  printLine,
+  structuredNotices
 }) {
   const exitPolicy = mergedFlags["workspace-only"] ? "workspace-only" : "strict";
   const wordpressVersionCheck = Boolean(mergedFlags["wp-version-check"]);
   if (mergedFlags.format === "json") {
-    await renderPortableCliDoctorJson(cwd, exitPolicy, wordpressVersionCheck, printLine);
+    await renderPortableCliDoctorJson(cwd, exitPolicy, wordpressVersionCheck, printLine, structuredNotices);
     return;
   }
   await executeDoctorCommand(cwd, { exitPolicy, wordpressVersionCheck });
 }
 var init_doctor = __esm(() => {
   init_runtime_bridge();
+  init_structured_output_notices();
 });
 
 // src/portable-cli/templates.ts
@@ -3009,11 +3110,11 @@ import {
   getTemplateById,
   listTemplates
 } from "@wp-typia/project-tools/cli-templates";
-function renderPortableCliTemplatesJson(printLine, flags, subcommand) {
+function renderPortableCliTemplatesJson(printLine, flags, subcommand, structuredNotices) {
   if (subcommand === "list") {
-    printLine(JSON.stringify({
+    printLine(JSON.stringify(withStructuredOutputNotices({
       templates: listTemplates()
-    }, null, 2));
+    }, structuredNotices), null, 2));
     return;
   }
   const templateId = flags.id;
@@ -3032,14 +3133,13 @@ function renderPortableCliTemplatesJson(printLine, flags, subcommand) {
       detailLines: [`Unknown template "${templateId}".`]
     });
   }
-  printLine(JSON.stringify({
-    template
-  }, null, 2));
+  printLine(JSON.stringify(withStructuredOutputNotices({ template }, structuredNotices), null, 2));
 }
 async function dispatchPortableCliTemplates({
   mergedFlags,
   positionals,
-  printLine
+  printLine,
+  structuredNotices
 }) {
   const subcommand = positionals[1];
   const templateId = typeof mergedFlags.id === "string" ? mergedFlags.id : positionals[2];
@@ -3057,7 +3157,7 @@ async function dispatchPortableCliTemplates({
     renderPortableCliTemplatesJson(printLine, {
       format: mergedFlags.format,
       id: templateId
-    }, resolvedSubcommand);
+    }, resolvedSubcommand, structuredNotices);
     return;
   }
   await executeTemplatesCommand({
@@ -3069,6 +3169,7 @@ async function dispatchPortableCliTemplates({
 }
 var init_templates = __esm(() => {
   init_runtime_bridge();
+  init_structured_output_notices();
 });
 
 // src/gunshi-cli.ts
@@ -3213,61 +3314,12 @@ import {
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/cli-diagnostic-output.ts
+init_ai_agent_detection();
 import {
   createCliCommandError as createCliCommandError2,
   serializeCliDiagnosticError
 } from "@wp-typia/project-tools/cli-diagnostics";
 
-// src/ai-agent-detection.ts
-var AI_AGENT_DEFINITIONS = [
-  {
-    detect: (env) => Boolean(env.CLAUDECODE) || Boolean(env.CLAUDE_CODE),
-    envVars: ["CLAUDECODE", "CLAUDE_CODE"],
-    name: "claude"
-  },
-  {
-    detect: (env) => Boolean(env.CURSOR_AGENT),
-    envVars: ["CURSOR_AGENT"],
-    name: "cursor"
-  },
-  {
-    detect: (env) => Boolean(env.CODEX_CI) || Boolean(env.CODEX_THREAD_ID) || Boolean(env.CODEX_SANDBOX),
-    envVars: ["CODEX_CI", "CODEX_THREAD_ID", "CODEX_SANDBOX"],
-    name: "codex"
-  },
-  {
-    detect: (env) => Boolean(env.AMP_CURRENT_THREAD_ID) || env.AGENT === "amp",
-    envVars: ["AMP_CURRENT_THREAD_ID", "AGENT"],
-    name: "amp"
-  },
-  {
-    detect: (env) => Boolean(env.GEMINI_CLI),
-    envVars: ["GEMINI_CLI"],
-    name: "gemini"
-  },
-  {
-    detect: (env) => env.OPENCODE === "1",
-    envVars: ["OPENCODE"],
-    name: "opencode"
-  }
-];
-function detectAIAgents(env = process.env, agents = AI_AGENT_DEFINITIONS) {
-  const aiAgents = [];
-  const aiAgentEnvVars = [];
-  for (const agent of agents) {
-    if (!agent.detect(env)) {
-      continue;
-    }
-    aiAgents.push(agent.name);
-    aiAgentEnvVars.push(...agent.envVars.filter((envVar) => Boolean(env[envVar])));
-  }
-  return {
-    aiAgentEnvVars,
-    aiAgents,
-    isAIAgent: aiAgents.length > 0
-  };
-}
-
 // bin/argv-walker.js
 function normalizeOptionSet(values) {
   return values instanceof Set ? values : new Set(values);
@@ -3320,6 +3372,12 @@ import {
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/command-options/add.ts
+var ADD_BLOCK_TEMPLATE_CHOICES = [
+  "basic",
+  "interactivity",
+  "persistence",
+  "compound"
+];
 var ADD_OPTION_METADATA = {
   "alternate-render-targets": {
     description: "Comma-separated alternate render targets for dynamic block scaffolds (email,mjml,plain-text).",
@@ -3497,7 +3555,9 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   template: {
-    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.",
+    choices: ADD_BLOCK_TEMPLATE_CHOICES,
+    defaultValue: "basic",
+    description: "Built-in block family for add block; interactive runs prompt when omitted.",
     short: "t",
     type: "string"
   },
@@ -3535,6 +3595,14 @@ var ADD_OPTION_METADATA = {
   }
 };
 // src/command-options/create.ts
+var CREATE_TEMPLATE_CHOICES = [
+  "basic",
+  "interactivity",
+  "persistence",
+  "compound",
+  "query-loop",
+  "workspace"
+];
 var CREATE_OPTION_METADATA = {
   "alternate-render-targets": {
     description: "Comma-separated alternate render targets for dynamic block scaffolds (email,mjml,plain-text).",
@@ -3592,7 +3660,9 @@ var CREATE_OPTION_METADATA = {
     type: "string"
   },
   template: {
-    description: "Template id or external template package.",
+    choices: CREATE_TEMPLATE_CHOICES,
+    defaultValue: "basic",
+    description: "Template id, external template package, local path, or GitHub locator.",
     short: "t",
     type: "string"
   },
@@ -3793,7 +3863,12 @@ function formatPortableCliOptionHelp(metadata) {
   return Object.entries(metadata).filter(([, option]) => !option.hidden).map(([name, option]) => {
     const valueLabel = option.type === "string" ? " <value>" : "";
     const short = option.short ? `, -${option.short}${valueLabel}` : "";
-    return `- --${name}${valueLabel}${short}: ${option.description}`;
+    const details = [
+      option.description,
+      option.choices && option.choices.length > 0 ? `Choices: ${option.choices.join(", ")}.` : undefined,
+      option.defaultValue !== undefined ? `Default: ${option.defaultValue}.` : undefined
+    ].filter((value) => Boolean(value));
+    return `- --${name}${valueLabel}${short}: ${details.join(" ")}`;
   });
 }
 function buildCommandOptionParser(...metadataMaps) {
@@ -4086,6 +4161,7 @@ function validateCliOutputFormatArgv(argv) {
 }
 
 // src/cli-diagnostic-output.ts
+init_structured_output_notices();
 function prefersStructuredCliArgv(argv) {
   let explicitFormat;
   for (let index = 0;index < argv.length; index += 1) {
@@ -4341,6 +4417,9 @@ function normalizeWpTypiaArgv(argv) {
   return normalizedArgv;
 }
 
+// src/portable-cli/errors.ts
+init_structured_output_notices();
+
 // src/portable-cli/help.ts
 init_package();
 init_add_kind_ids();
@@ -4494,10 +4573,10 @@ async function handlePortableCliEntrypointError(error, argv) {
       command: resolveCanonicalCommandContext(argv),
       error
     });
-    process.stderr.write(`${JSON.stringify({
+    process.stderr.write(`${JSON.stringify(withStructuredOutputNotices({
       ok: false,
       error: serializeCliDiagnosticError2(diagnostic)
-    }, null, 2)}
+    }, getStructuredOutputNoticesForArgv(argv)), null, 2)}
 `);
     process.exitCode = 1;
     return;
@@ -4515,6 +4594,7 @@ import {
   CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES21,
   createCliCommandError as createCliCommandError10
 } from "@wp-typia/project-tools/cli-diagnostics";
+init_ai_agent_detection();
 
 // src/completions.ts
 import {
@@ -5590,6 +5670,7 @@ function renderPortableCliVersion(printLine, options = {}) {
 }
 
 // src/node-cli.ts
+init_structured_output_notices();
 var PORTABLE_CLI_OPTION_PARSER = buildCommandOptionParser(ALL_COMMAND_OPTION_METADATA);
 var PORTABLE_CLI_BOOLEAN_OPTION_NAMES = ["help", "version"];
 var printLine = (line) => {
@@ -5687,14 +5768,15 @@ async function dispatchPortableCliSkills({
   cwd,
   mergedFlags,
   positionals,
-  printLine: printLine2
+  printLine: printLine2,
+  structuredNotices
 }) {
   const subcommand = positionals[1] ?? "list";
   const structured = mergedFlags.format === "json";
   if (subcommand === "list") {
     const result = listSkills();
     if (structured) {
-      printLine2(JSON.stringify(result, null, 2));
+      printLine2(JSON.stringify(withStructuredOutputNotices(result, structuredNotices), null, 2));
       return;
     }
     if (result.agents.length === 0) {
@@ -5715,7 +5797,7 @@ async function dispatchPortableCliSkills({
       global: mergedFlags.local ? false : true
     });
     if (structured) {
-      printLine2(JSON.stringify(result, null, 2));
+      printLine2(JSON.stringify(withStructuredOutputNotices(result, structuredNotices), null, 2));
       return;
     }
     if (!result.updated) {
@@ -5753,6 +5835,7 @@ var PORTABLE_CLI_COMMAND_DISPATCHERS = {
     mergedFlags,
     positionals,
     printLine: printLine2,
+    structuredNotices,
     warnLine: warnLine2
   }) => {
     const plan = await executeInitCommand({
@@ -5766,7 +5849,7 @@ var PORTABLE_CLI_COMMAND_DISPATCHERS = {
       warnLine: warnLine2
     });
     if (mergedFlags.format === "json") {
-      printLine2(JSON.stringify(buildStructuredInitSuccessPayload(plan), null, 2));
+      printLine2(JSON.stringify(withStructuredOutputNotices(buildStructuredInitSuccessPayload(plan), structuredNotices), null, 2));
     }
   },
   migrate: async ({
@@ -5787,6 +5870,7 @@ var PORTABLE_CLI_COMMAND_DISPATCHERS = {
     mergedFlags,
     positionals,
     printLine: printLine2,
+    structuredNotices,
     warnLine: warnLine2
   }) => {
     try {
@@ -5799,9 +5883,7 @@ var PORTABLE_CLI_COMMAND_DISPATCHERS = {
         target: syncTarget
       });
       if (mergedFlags.format === "json") {
-        printLine2(JSON.stringify({
-          sync
-        }, null, 2));
+        printLine2(JSON.stringify(withStructuredOutputNotices({ sync }, structuredNotices), null, 2));
         return;
       }
       if (sync.dryRun) {
@@ -5847,6 +5929,7 @@ async function runNodeCli(argv = process.argv.slice(2)) {
   const { argv: argvWithoutConfigOverride, configOverridePath } = extractWpTypiaConfigOverride(normalizedArgv);
   validateCliOutputFormatArgv(argvWithoutConfigOverride);
   const outputFormatArgv = normalizeCliOutputFormatArgv(argvWithoutConfigOverride);
+  const structuredNotices = getStructuredOutputNoticesForArgv(argvWithoutConfigOverride);
   const { argv: cliArgv, flags } = parseGlobalFlags(outputFormatArgv);
   const { flags: commandFlags, positionals } = parseArgv(cliArgv);
   const aiDetection = detectAIAgents();
@@ -5901,6 +5984,7 @@ async function runNodeCli(argv = process.argv.slice(2)) {
       mergedFlags,
       positionals,
       printLine,
+      structuredNotices,
       warnLine
     });
     return;
@@ -6009,4 +6093,4 @@ export {
   runGunshiCli
 };
 
-//# debugId=53AEBD2B29C6724A64756E2164756E21
+//# debugId=9C1AF3EFBE8B9E3464756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-typia",
-  "version": "0.24.11",
+  "version": "0.24.13",
   "description": "Canonical CLI package for wp-typia scaffolding and project workflows",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -56,7 +56,7 @@
   "dependencies": {
     "@gunshi/plugin-completion": "0.32.0",
     "@wp-typia/api-client": "^0.4.6",
-    "@wp-typia/project-tools": "0.24.9",
+    "@wp-typia/project-tools": "0.24.11",
     "gunshi": "0.32.0",
     "zod": "4.3.6"
   },