wp-typia 0.20.2 → 0.20.4

package/dist-bunli/node-cli.js

@@ -3,7 +3,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.20.2",
+  version: "0.20.4",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -71,7 +71,7 @@ var package_default = {
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/project-tools": "0.19.3",
+    "@wp-typia/project-tools": "0.20.1",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -229,7 +229,7 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   namespace: {
-    description: "REST namespace for rest-resource workflows.",
+    description: "REST namespace for rest-resource and ai-feature workflows.",
     type: "string"
   },
   "persistence-policy": {
@@ -441,6 +441,8 @@ var ADD_KIND_IDS = [
   "pattern",
   "binding-source",
   "rest-resource",
+  "ability",
+  "ai-feature",
   "editor-plugin",
   "hooked-block"
 ];
@@ -505,6 +507,22 @@ var ADD_KIND_REGISTRY = {
       return true;
     })
   },
+  ability: {
+    completion: {
+      nextSteps: (values) => [
+        `Review src/abilities/${values.abilitySlug}/ and inc/abilities/${values.abilitySlug}.php.`,
+        "Run `wp-typia sync` or `npm run sync-abilities -- --check` and then your workspace build/dev command to verify the generated workflow ability."
+      ],
+      summaryLines: (values, projectDir) => [
+        `Ability: ${values.abilitySlug}`,
+        `Project directory: ${projectDir}`
+      ],
+      title: "Added workflow ability"
+    },
+    description: "Add a typed server/client workflow ability scaffold",
+    nameLabel: "Ability name",
+    visibleFieldNames: () => ["kind", "name"]
+  },
   "editor-plugin": {
     completion: {
       nextSteps: (values) => [
@@ -574,6 +592,23 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "REST resource name",
     visibleFieldNames: () => ["kind", "name", "namespace", "methods"]
   },
+  "ai-feature": {
+    completion: {
+      nextSteps: (values) => [
+        `Review src/ai-features/${values.aiFeatureSlug}/ and inc/ai-features/${values.aiFeatureSlug}.php.`,
+        "Run `wp-typia sync-rest` and `wp-typia sync ai` or your workspace build/dev command to verify the generated REST artifacts and AI schema."
+      ],
+      summaryLines: (values, projectDir) => [
+        `AI feature: ${values.aiFeatureSlug}`,
+        `Namespace: ${values.namespace}`,
+        `Project directory: ${projectDir}`
+      ],
+      title: "Added server-only AI feature"
+    },
+    description: "Add a server-owned WordPress AI feature endpoint",
+    nameLabel: "AI feature name",
+    visibleFieldNames: () => ["kind", "name", "namespace"]
+  },
   variation: {
     completion: {
       nextSteps: (values) => [
@@ -1090,16 +1125,19 @@ function buildAddDryRunPayload(options, markerOptions) {
   };
 }
 function buildSyncDryRunPayload(options, markerOptions) {
+  const targetSuffix = options.target === "ai" ? " ai" : "";
+  const targetSummary = options.target === "ai" ? "Sync target: AI artifacts only." : options.target === "default" ? "Sync target: generated project defaults." : undefined;
   return {
     optionalLines: options.plannedCommands.map((command) => command.displayCommand),
-    optionalNote: options.check ? "No sync scripts were executed because --dry-run was enabled. Re-run `wp-typia sync --check` to verify generated artifacts without rewriting them." : "No sync scripts were executed because --dry-run was enabled. Re-run without --dry-run to apply generated-file updates, or add --check to verify without rewriting.",
+    optionalNote: options.check ? `No sync scripts were executed because --dry-run was enabled. Re-run \`wp-typia sync${targetSuffix} --check\` to verify generated artifacts without rewriting them.` : `No sync scripts were executed because --dry-run was enabled. Re-run \`wp-typia sync${targetSuffix}\` without --dry-run to apply generated-file updates, or add --check to verify without rewriting.`,
     optionalTitle: `Planned sync commands (${options.plannedCommands.length}):`,
     summaryLines: [
       `Project directory: ${options.projectDir}`,
       `Package manager: ${options.packageManager}`,
+      ...targetSummary ? [targetSummary] : [],
       options.check ? "Execution mode: would run generated sync scripts in verification mode." : "Execution mode: would run generated sync scripts in apply mode."
     ],
-    title: formatOutputMarker("dryRun", "Dry run for wp-typia sync", markerOptions)
+    title: formatOutputMarker("dryRun", `Dry run for wp-typia sync${targetSuffix}`, markerOptions)
   };
 }
 function printBlock(lines, printLine) {
@@ -1134,9 +1172,22 @@ function isInteractiveTerminal({
 import { spawnSync } from "node:child_process";
 import fs4 from "node:fs";
 import path4 from "node:path";
-var SYNC_INSTALL_MARKERS = ["node_modules", ".pnp.cjs", ".pnp.loader.mjs"];
+var SYNC_INSTALL_MARKERS = [
+  "node_modules",
+  ".pnp.cjs",
+  ".pnp.loader.mjs"
+];
 var LOCAL_SYNC_TOOL_PATTERN = /(^|[\s;&|()])(?:tsx|wp-scripts)(?=($|[\s;&|()]))/u;
 var CAPTURED_SYNC_OUTPUT_MAX_BUFFER = 16 * 1024 * 1024;
+function resolveSyncExecutionTarget(subcommand) {
+  if (!subcommand) {
+    return "default";
+  }
+  if (subcommand === "ai") {
+    return "ai";
+  }
+  throw new Error(`Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
+}
 function formatRunScript(packageManagerId, scriptName, extraArgs = "") {
   const args = extraArgs.trim();
   if (packageManagerId === "bun") {
@@ -1197,13 +1248,26 @@ function resolveSyncProjectContext(cwd) {
   const packageJson = JSON.parse(fs4.readFileSync(packageJsonPath, "utf8"));
   const scripts = packageJson.scripts ?? {};
   const syncScripts = {
-    sync: typeof scripts.sync === "string" ? scripts.sync : undefined,
-    "sync-rest": typeof scripts["sync-rest"] === "string" ? scripts["sync-rest"] : undefined,
-    "sync-types": typeof scripts["sync-types"] === "string" ? scripts["sync-types"] : undefined
+    sync: typeof scripts.sync === "string" ? {
+      command: scripts.sync,
+      scriptName: "sync"
+    } : undefined,
+    "sync-ai": typeof scripts["sync-ai"] === "string" ? {
+      command: scripts["sync-ai"],
+      scriptName: "sync-ai"
+    } : typeof scripts["sync-wordpress-ai"] === "string" ? {
+      command: scripts["sync-wordpress-ai"],
+      scriptName: "sync-wordpress-ai"
+    } : undefined,
+    "sync-rest": typeof scripts["sync-rest"] === "string" ? {
+      command: scripts["sync-rest"],
+      scriptName: "sync-rest"
+    } : undefined,
+    "sync-types": typeof scripts["sync-types"] === "string" ? {
+      command: scripts["sync-types"],
+      scriptName: "sync-types"
+    } : undefined
   };
-  if (!syncScripts.sync && !syncScripts["sync-types"]) {
-    throw new Error(`Expected ${packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
-  }
   return {
     cwd,
     packageJsonPath,
@@ -1224,12 +1288,16 @@ function findInstalledDependencyMarkerDir(projectDir) {
     currentDir = parentDir;
   }
 }
-function scriptsLikelyNeedInstalledDependencies(project) {
-  const candidateScripts = project.scripts.sync ? [project.scripts.sync] : [project.scripts["sync-types"], project.scripts["sync-rest"]];
-  return candidateScripts.some((script) => typeof script === "string" && LOCAL_SYNC_TOOL_PATTERN.test(script));
+function scriptsLikelyNeedInstalledDependencies(project, target) {
+  const candidateScripts = target === "ai" ? [project.scripts["sync-ai"]] : project.scripts.sync ? [project.scripts.sync] : [
+    project.scripts["sync-types"],
+    project.scripts["sync-rest"],
+    project.scripts["sync-ai"]
+  ];
+  return candidateScripts.some((script) => script !== undefined && LOCAL_SYNC_TOOL_PATTERN.test(script.command));
 }
-function assertSyncDependenciesInstalled(project) {
-  if (!scriptsLikelyNeedInstalledDependencies(project)) {
+function assertSyncDependenciesInstalled(project, target) {
+  if (!scriptsLikelyNeedInstalledDependencies(project, target)) {
     return;
   }
   const markerDir = findInstalledDependencyMarkerDir(project.cwd);
@@ -1244,7 +1312,11 @@ function getPackageManagerRunInvocation(packageManager, scriptName, extraArgs) {
       return { args: ["run", scriptName, ...extraArgs], command: "bun" };
     case "npm":
       return {
-        args: ["run", scriptName, ...extraArgs.length > 0 ? ["--", ...extraArgs] : []],
+        args: [
+          "run",
+          scriptName,
+          ...extraArgs.length > 0 ? ["--", ...extraArgs] : []
+        ],
         command: "npm"
       };
     case "pnpm":
@@ -1258,23 +1330,38 @@ function createSyncPlannedCommand(project, scriptName, extraArgs) {
   if (!script) {
     return null;
   }
-  const invocation = getPackageManagerRunInvocation(project.packageManager, scriptName, extraArgs);
+  const invocation = getPackageManagerRunInvocation(project.packageManager, script.scriptName, extraArgs);
   return {
     args: invocation.args,
     command: invocation.command,
-    displayCommand: formatRunScript(project.packageManager, scriptName, extraArgs.join(" ")),
-    scriptName
+    displayCommand: formatRunScript(project.packageManager, script.scriptName, extraArgs.join(" ")),
+    scriptName: script.scriptName
   };
 }
-function buildSyncPlannedCommands(project, extraArgs) {
+function buildSyncPlannedCommands(project, extraArgs, target) {
+  if (target === "ai") {
+    const syncAiCommand2 = createSyncPlannedCommand(project, "sync-ai", extraArgs);
+    if (!syncAiCommand2) {
+      throw new Error(`Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
+    }
+    return [syncAiCommand2];
+  }
   if (project.scripts.sync) {
     return [createSyncPlannedCommand(project, "sync", extraArgs)];
   }
-  const plannedCommands = [createSyncPlannedCommand(project, "sync-types", extraArgs)];
+  const syncTypesCommand = createSyncPlannedCommand(project, "sync-types", extraArgs);
+  if (!syncTypesCommand) {
+    throw new Error(`Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
+  }
+  const plannedCommands = [syncTypesCommand];
   const syncRestCommand = createSyncPlannedCommand(project, "sync-rest", extraArgs);
   if (syncRestCommand) {
     plannedCommands.push(syncRestCommand);
   }
+  const syncAiCommand = createSyncPlannedCommand(project, "sync-ai", extraArgs);
+  if (syncAiCommand) {
+    plannedCommands.push(syncAiCommand);
+  }
   return plannedCommands;
 }
 function runProjectScript(project, plannedCommand, options) {
@@ -1303,23 +1390,25 @@ async function executeSyncCommand({
   captureOutput = false,
   check = false,
   cwd,
-  dryRun = false
+  dryRun = false,
+  target = "default"
 }) {
   const project = resolveSyncProjectContext(cwd);
   const extraArgs = check ? ["--check"] : [];
-  const plannedCommands = buildSyncPlannedCommands(project, extraArgs);
+  const plannedCommands = buildSyncPlannedCommands(project, extraArgs, target);
   const result = {
     check,
     dryRun,
     packageJsonPath: project.packageJsonPath,
     packageManager: project.packageManager,
     plannedCommands,
-    projectDir: project.cwd
+    projectDir: project.cwd,
+    target
   };
   if (dryRun) {
     return result;
   }
-  assertSyncDependenciesInstalled(project);
+  assertSyncDependenciesInstalled(project, target);
   result.executedCommands = plannedCommands.map((plannedCommand) => runProjectScript(project, plannedCommand, {
     captureOutput
   }));
@@ -1397,6 +1486,22 @@ function runRegisteredAddKind(context, plan) {
   });
 }
 var ADD_KIND_EXECUTION_REGISTRY = {
+  ability: async (context) => {
+    const name = requireAddKindName(context, "`wp-typia add ability` requires <name>. Usage: wp-typia add ability <name>.");
+    return runRegisteredAddKind(context, {
+      buildCompletion: (result) => buildAddCompletionPayload({
+        kind: "ability",
+        projectDir: result.projectDir,
+        values: {
+          abilitySlug: result.abilitySlug
+        }
+      }),
+      execute: (targetCwd) => context.addRuntime.runAddAbilityCommand({
+        abilityName: name,
+        cwd: targetCwd
+      })
+    });
+  },
   "binding-source": async (context) => {
     const name = requireAddKindName(context, "`wp-typia add binding-source` requires <name>. Usage: wp-typia add binding-source <name>.");
     return runRegisteredAddKind(context, {
@@ -1471,6 +1576,26 @@ var ADD_KIND_EXECUTION_REGISTRY = {
       })
     });
   },
+  "ai-feature": async (context) => {
+    const name = requireAddKindName(context, "`wp-typia add ai-feature` requires <name>. Usage: wp-typia add ai-feature <name> [--namespace <vendor/v1>].");
+    const namespace = readOptionalStringFlag(context.flags, "namespace");
+    return runRegisteredAddKind(context, {
+      buildCompletion: (result) => buildAddCompletionPayload({
+        kind: "ai-feature",
+        projectDir: result.projectDir,
+        values: {
+          aiFeatureSlug: result.aiFeatureSlug,
+          namespace: result.namespace
+        },
+        warnings: result.warnings
+      }),
+      execute: (targetCwd) => context.addRuntime.runAddAiFeatureCommand({
+        aiFeatureName: name,
+        cwd: targetCwd,
+        namespace
+      })
+    });
+  },
   "hooked-block": async (context) => {
     const name = requireAddKindName(context, "`wp-typia add hooked-block` requires <block-slug>. Usage: wp-typia add hooked-block <block-slug> --anchor <anchor-block-name> --position <before|after|firstChild|lastChild>.");
     const anchorBlockName = readOptionalStringFlag(context.flags, "anchor");
@@ -1957,7 +2082,8 @@ var WP_TYPIA_FUTURE_COMMAND_TREE = [
   },
   {
     description: "Run the common generated-project sync workflow.",
-    name: "sync"
+    name: "sync",
+    subcommands: ["ai"]
   },
   {
     description: "Extend an official wp-typia workspace.",
@@ -2256,6 +2382,8 @@ function renderAddHelp() {
     "",
     ...NODE_FALLBACK_RUNTIME_SUMMARY_LINES,
     "",
+    `Supported kinds: ${formatAddKindList()}`,
+    "",
     "Supported flags:",
     ...formatNodeFallbackOptionHelp(ADD_OPTION_METADATA)
   ]);
@@ -2272,7 +2400,7 @@ function renderMigrateHelp() {
 }
 function renderSyncHelp() {
   printBlock2([
-    "Usage: wp-typia sync",
+    "Usage: wp-typia sync [ai]",
     "",
     ...NODE_FALLBACK_RUNTIME_SUMMARY_LINES,
     "",
@@ -2516,11 +2644,13 @@ async function runNodeCli(argv = process.argv.slice(2)) {
   }
   if (command === "sync") {
     try {
+      const syncTarget = resolveSyncExecutionTarget(positionals[1]);
       const sync = await executeSyncCommand({
         captureOutput: mergedFlags.format === "json" && !Boolean(mergedFlags["dry-run"]),
         check: Boolean(mergedFlags.check),
         cwd: process.cwd(),
-        dryRun: Boolean(mergedFlags["dry-run"])
+        dryRun: Boolean(mergedFlags["dry-run"]),
+        target: syncTarget
       });
       if (mergedFlags.format === "json") {
         printLine(JSON.stringify({
@@ -2533,7 +2663,8 @@ async function runNodeCli(argv = process.argv.slice(2)) {
           check: sync.check,
           packageManager: sync.packageManager,
           plannedCommands: sync.plannedCommands,
-          projectDir: sync.projectDir
+          projectDir: sync.projectDir,
+          target: sync.target
         }));
       }
     } catch (error) {
@@ -2576,4 +2707,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=0ECCDE28BD4229FC64756E2164756E21
+//# debugId=2B2288BD839BD95964756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-typia",
-  "version": "0.20.2",
+  "version": "0.20.4",
   "description": "Canonical CLI package for wp-typia scaffolding and project workflows",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -68,7 +68,7 @@
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/project-tools": "0.19.3",
+    "@wp-typia/project-tools": "0.20.1",
     "better-result": "^2.7.0",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",