@wp-typia/project-tools 0.23.0 → 0.24.0

package/dist/runtime/cli-doctor.js

@@ -1,6 +1,42 @@
-import { CLI_DIAGNOSTIC_CODES, createCliCommandError, formatDoctorCheckLine, formatDoctorSummaryLine, getDoctorFailureDetailLines, } from "./cli-diagnostics.js";
+import { CLI_DIAGNOSTIC_CODES, createCliCommandError, formatDoctorCheckLine, formatDoctorSummaryLine, } from "./cli-diagnostics.js";
 import { getEnvironmentDoctorChecks } from "./cli-doctor-environment.js";
 import { getWorkspaceDoctorChecks } from "./cli-doctor-workspace.js";
+const DEFAULT_DOCTOR_EXIT_POLICY = "strict";
+const defaultDoctorLinePrinter = (line) => {
+    process.stdout.write(`${line}\n`);
+};
+function renderDefaultDoctorCheckLine(check) {
+    defaultDoctorLinePrinter(formatDoctorCheckLine(check));
+}
+function renderDefaultDoctorSummaryLine(summaryLine) {
+    defaultDoctorLinePrinter(summaryLine);
+}
+function annotateDoctorChecks(checks, scope) {
+    return checks.map((check) => ({
+        ...check,
+        scope: check.scope ?? scope,
+    }));
+}
+function resolveDoctorExitPolicy(options) {
+    return options.exitPolicy ?? DEFAULT_DOCTOR_EXIT_POLICY;
+}
+function doesCheckContributeToExit(check, exitPolicy) {
+    if (check.status !== "fail") {
+        return false;
+    }
+    if (exitPolicy === "strict") {
+        return true;
+    }
+    return check.scope === "workspace";
+}
+function toFailureSummary(check, severity) {
+    return {
+        ...(check.code ? { code: check.code } : {}),
+        label: check.label,
+        scope: check.scope ?? "unknown",
+        severity,
+    };
+}
 /**
  * Collect all runtime doctor checks for the current environment.
  *
@@ -14,28 +50,74 @@ import { getWorkspaceDoctorChecks } from "./cli-doctor-workspace.js";
  */
 export async function getDoctorChecks(cwd) {
     return [
-        ...(await getEnvironmentDoctorChecks(cwd)),
-        ...(await getWorkspaceDoctorChecks(cwd)),
+        ...annotateDoctorChecks(await getEnvironmentDoctorChecks(cwd), "environment"),
+        ...annotateDoctorChecks(await getWorkspaceDoctorChecks(cwd), "workspace"),
     ];
 }
 /**
- * Run doctor checks, render each line, and fail when any check does not pass.
+ * Return failed rows that contribute to the process exit code for one policy.
+ */
+export function getDoctorExitFailureChecks(checks, options = {}) {
+    const exitPolicy = resolveDoctorExitPolicy(options);
+    return checks.filter((check) => doesCheckContributeToExit(check, exitPolicy));
+}
+/**
+ * Format only exit-contributing doctor failures for structured diagnostics.
+ */
+export function getDoctorExitFailureDetailLines(checks, options = {}) {
+    return getDoctorExitFailureChecks(checks, options).map((check) => `${check.label}: ${check.detail}`);
+}
+/**
+ * Build the stable JSON summary for one doctor run.
+ */
+export function createDoctorRunSummary(checks, options = {}) {
+    const exitPolicy = resolveDoctorExitPolicy(options);
+    const failedChecks = checks.filter((check) => check.status === "fail");
+    const exitFailureChecks = failedChecks.filter((check) => doesCheckContributeToExit(check, exitPolicy));
+    const advisoryFailureChecks = failedChecks.filter((check) => !doesCheckContributeToExit(check, exitPolicy));
+    const warnings = checks.filter((check) => check.status === "warn").length;
+    return {
+        advisoryFailureCount: advisoryFailureChecks.length,
+        advisoryFailures: advisoryFailureChecks.map((check) => toFailureSummary(check, "advisory")),
+        exitCode: exitFailureChecks.length > 0 ? 1 : 0,
+        exitFailureCount: exitFailureChecks.length,
+        exitFailures: exitFailureChecks.map((check) => toFailureSummary(check, "error")),
+        exitPolicy,
+        failed: failedChecks.length,
+        passed: checks.length - failedChecks.length - warnings,
+        total: checks.length,
+        warnings,
+    };
+}
+/**
+ * Run doctor checks, render each line, and fail when one or more failed checks
+ * contribute to the exit code under the active exit policy.
+ *
+ * The default `strict` policy treats every failed row as exit-contributing.
+ * The `workspace-only` policy only fails on workspace-scoped rows so
+ * environment/runtime failures remain advisory for CI gates that only care
+ * about generated workspace artifacts.
  *
  * @param cwd Working directory to validate.
- * @param options Optional renderer override for each emitted check row.
+ * @param options Optional renderer overrides and exit-policy selection.
+ * @param options.exitPolicy Policy deciding which failed checks contribute to the process exit code.
+ * @param options.renderLine Optional renderer for each check row. Defaults to the stdout line printer.
+ * @param options.renderSummaryLine Optional renderer for the summary row. Defaults to the stdout line printer unless a custom `renderLine` suppresses implicit summary output.
  * @returns The completed list of doctor checks.
- * @throws {Error} When one or more checks fail.
+ * @throws {Error} When one or more failed checks contribute to the exit code under the active policy.
  */
 export async function runDoctor(cwd, options = {}) {
-    const renderLine = options.renderLine ?? ((check) => console.log(formatDoctorCheckLine(check)));
+    const exitPolicy = resolveDoctorExitPolicy(options);
+    const renderLine = options.renderLine ?? renderDefaultDoctorCheckLine;
     const renderSummaryLine = options.renderSummaryLine ??
-        (options.renderLine ? () => undefined : (summaryLine) => console.log(summaryLine));
+        (options.renderLine ? () => undefined : renderDefaultDoctorSummaryLine);
     const checks = await getDoctorChecks(cwd);
     for (const check of checks) {
         renderLine(check);
     }
-    renderSummaryLine(formatDoctorSummaryLine(checks));
-    const failureDetailLines = getDoctorFailureDetailLines(checks);
+    const exitFailureChecks = getDoctorExitFailureChecks(checks, { exitPolicy });
+    renderSummaryLine(formatDoctorSummaryLine(checks, { exitFailureChecks }));
+    const failureDetailLines = getDoctorExitFailureDetailLines(checks, { exitPolicy });
     if (failureDetailLines.length > 0) {
         throw createCliCommandError({
             code: CLI_DIAGNOSTIC_CODES.DOCTOR_CHECK_FAILED,

package/dist/runtime/cli-help.js

@@ -11,6 +11,7 @@ import { TEMPLATE_IDS } from "./template-registry.js";
 export function formatHelpText() {
     return `Usage:
   wp-typia create <project-dir> [--template <basic|interactivity>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
+  wp-typia create <project-dir> [--template workspace] [--profile <plugin-qa>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
   wp-typia create <project-dir> [--template query-loop] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--query-post-type <post-type>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
   wp-typia create <project-dir> [--template <./path|github:owner/repo/path[#ref]>] [--variant <name>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
   wp-typia create <project-dir> [--template <npm-package>] [--variant <name>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
@@ -20,14 +21,16 @@ export function formatHelpText() {
   wp-typia init [project-dir] [--apply] [--package-manager <id>]
   wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>]
   wp-typia add block <name> [--template <basic|interactivity|persistence|compound>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>]
-  wp-typia add integration-env <name> [--wp-env] [--service <none|docker-compose>]
+  wp-typia add integration-env <name> [--wp-env] [--release-zip] [--service <none|docker-compose>]
+  wp-typia add core-variation <block-name> <name>
+  wp-typia add core-variation <name> --block <namespace/block>
   wp-typia add variation <name> --block <block-slug>
   wp-typia add style <name> --block <block-slug>
   wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug>
-  wp-typia add pattern <name>
-  wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>]
+  wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--tags <tag,...>] [--thumbnail-url <url>]
+  wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--from-post-meta|--post-meta <post-meta> [--meta-path <field>]]
   wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <method[,method...]>]
-  wp-typia add rest-resource <name> --manual [--namespace <vendor/v1>] [--method <GET|POST|PUT|PATCH|DELETE>] [--auth <public|authenticated|public-write-protected>] [--path <route-pattern>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>]
+  wp-typia add rest-resource <name> --manual [--namespace <vendor/v1>] [--method <GET|POST|PUT|PATCH|DELETE>] [--auth <public|authenticated|public-write-protected>] [--path <route-pattern>|--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>] [--secret-field <field>] [--secret-state-field|--secret-has-value-field <field>] [--secret-preserve-on-empty <true|false>]
   wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>] [--hide-from-rest]
   wp-typia add ability <name>
   wp-typia add ai-feature <name> [--namespace <vendor/v1>]
@@ -51,21 +54,23 @@ Notes:
   \`wp-typia <project-dir>\` remains a backward-compatible alias to \`create\` when \`<project-dir>\` is the only positional argument.
   \`wp-typia init\` previews the minimum retrofit sync surface by default; rerun with \`--apply\` to write package.json updates and generated helper scripts.
   Use \`--template workspace\` as shorthand for \`@wp-typia/create-workspace-template\`, the official empty workspace scaffold behind \`wp-typia add ...\`.
+  Use \`--profile plugin-qa\` with \`--template workspace\` when a plugin needs local wp-env smoke checks, \`.env.example\`, and release zip scripts from day one; omit it for the minimal workspace shell.
   Interactive add flows let you choose a template when \`--template\` is omitted; non-interactive runs default to \`basic\`.
   \`add admin-view\` scaffolds an opt-in DataViews-powered WordPress admin screen under \`src/admin-views/\`.
   Pass \`--source rest-resource:<slug>\` to reuse a list-capable REST resource.
   Pass \`--source core-data:postType/post\` or \`--source core-data:taxonomy/category\` to bind a WordPress-owned entity collection.
   Generated admin-view workspaces add \`@wp-typia/dataviews\` and the needed WordPress DataViews packages as opt-in dependencies.
   \`add integration-env\` generates an opt-in local smoke starter under \`scripts/integration-smoke/\`, updates \`.env.example\`, and can add \`@wordpress/env\` plus \`.wp-env.json\` when \`--wp-env\` is passed.
+  Pass \`--release-zip\` to add \`release:zip\`, \`release:zip:check\`, and \`qa:check\` scripts for plugin QA packaging.
   Pass \`--service docker-compose\` to include a placeholder local service stack that can be adapted to project-specific dependencies.
   \`query-loop\` is create-only. Use \`wp-typia create <project-dir> --template query-loop\`; \`wp-typia add block\` accepts only basic, interactivity, persistence, and compound families.
   \`add variation\` uses an existing workspace block from \`scripts/block-config.ts\`.
   \`add style\` registers a Block Styles option for an existing generated block.
   \`add transform\` adds a block-to-block transform into an existing generated block.
-  \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/\`.
-  \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare a bindable generated-block attribute.
+  \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/full/\` or \`src/patterns/sections/\`.
+  \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare a bindable generated-block attribute. Pass \`--from-post-meta\` or \`--post-meta\` to back the source from a typed post-meta contract and \`--meta-path\` to choose its default top-level field.
   \`add rest-resource\` scaffolds plugin-level TypeScript REST contracts under \`src/rest/\` and PHP route glue under \`inc/rest/\`.
-  \`add rest-resource --manual\` tracks an external REST route with typed schemas, OpenAPI, clients, and drift checks without generating PHP route/controller files.
+  \`add rest-resource --manual\` tracks an external/provider REST route with typed schemas, OpenAPI, clients, and drift checks without generating PHP route/controller files while still allowing route-owner metadata such as permission callbacks and controller classes. Settings contracts can add \`--secret-field\` plus \`--secret-preserve-on-empty\` to model write-only credentials and preserve blank submissions.
   \`add post-meta\` scaffolds typed post meta contracts under \`src/post-meta/\`, emits schema artifacts, and wires generated \`register_post_meta()\` helpers under \`inc/post-meta/\`.
   \`add ability\` scaffolds typed workflow abilities under \`src/abilities/\` and server registration under \`inc/abilities/\`.
   \`add ai-feature\` scaffolds server-owned AI feature endpoints under \`src/ai-features/\` and PHP route glue under \`inc/ai-features/\`.

package/dist/runtime/cli-init-package-json.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { CLI_DIAGNOSTIC_CODES, createCliDiagnosticCodeError, } from "./cli-diagnostics.js";
 import { getPackageManager, transformPackageManagerText, } from "./package-managers.js";
 import { getPackageVersions } from "./package-versions.js";
+import { readJsonFileSync } from "./json-utils.js";
 import { parseWorkspacePackageManagerId } from "./workspace-project.js";
 const BASE_RETROFIT_SCRIPTS = {
     sync: "tsx scripts/sync-project.ts",
@@ -22,9 +23,10 @@ export function readProjectPackageJson(projectDir) {
     if (!fs.existsSync(packageJsonPath)) {
         return null;
     }
-    const source = fs.readFileSync(packageJsonPath, "utf8");
     try {
-        return JSON.parse(source);
+        return readJsonFileSync(packageJsonPath, {
+            context: "project package manifest",
+        });
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);

package/dist/runtime/cli-prompt.d.ts

@@ -1,4 +1,5 @@
 type ValidateInput = (value: string) => boolean | string;
+export type PromptLinePrinter = (line: string) => void;
 interface PromptOption<T extends string> {
     hint?: string;
     label: string;
@@ -12,6 +13,15 @@ export interface ReadlinePrompt {
     select<T extends string>(message: string, options: PromptOption<T>[], defaultValue?: number): Promise<T>;
     text(message: string, defaultValue: string, validate?: ValidateInput): Promise<string>;
 }
+/**
+ * Output adapters used by prompt rendering and validation feedback.
+ */
+export interface ReadlinePromptOutput {
+    /** Render one informational prompt line. */
+    printLine?: PromptLinePrinter;
+    /** Render one validation or selection error line. */
+    errorLine?: PromptLinePrinter;
+}
 /**
  * Adapter interface for readline-style prompt interactions.
  *
@@ -33,14 +43,18 @@ export interface ReadlineQuestionAdapter {
 /**
  * Create the default readline-backed prompt implementation for the CLI.
  *
+ * @param output Optional line printers for prompt and validation output.
  * @returns A prompt adapter that reads from stdin and writes to stdout.
  */
-export declare function createReadlinePrompt(): ReadlinePrompt;
+export declare function createReadlinePrompt(output?: ReadlinePromptOutput): ReadlinePrompt;
 /**
  * Build a prompt adapter around a supplied readline-style question interface.
  *
  * This keeps the production CLI path unchanged while letting tests validate
  * retry behavior without stubbing global stdin/stdout.
+ *
+ * @param rl Readline-compatible question adapter.
+ * @param output Optional line printers for prompt and validation output.
  */
-export declare function createReadlinePromptWithInterface(rl: ReadlineQuestionAdapter): ReadlinePrompt;
+export declare function createReadlinePromptWithInterface(rl: ReadlineQuestionAdapter, output?: ReadlinePromptOutput): ReadlinePrompt;
 export {};

package/dist/runtime/cli-prompt.js

@@ -2,22 +2,27 @@ import readline from "node:readline";
 /**
  * Create the default readline-backed prompt implementation for the CLI.
  *
+ * @param output Optional line printers for prompt and validation output.
  * @returns A prompt adapter that reads from stdin and writes to stdout.
  */
-export function createReadlinePrompt() {
+export function createReadlinePrompt(output = {}) {
     const rl = readline.createInterface({
         input: process.stdin,
         output: process.stdout,
     });
-    return createReadlinePromptWithInterface(rl);
+    return createReadlinePromptWithInterface(rl, output);
 }
 /**
  * Build a prompt adapter around a supplied readline-style question interface.
  *
  * This keeps the production CLI path unchanged while letting tests validate
  * retry behavior without stubbing global stdin/stdout.
+ *
+ * @param rl Readline-compatible question adapter.
+ * @param output Optional line printers for prompt and validation output.
  */
-export function createReadlinePromptWithInterface(rl) {
+export function createReadlinePromptWithInterface(rl, output = {}) {
+    const { errorLine, printLine } = resolveReadlinePromptOutput(output);
     const askQuestion = (query) => new Promise((resolve) => {
         rl.question(query, resolve);
     });
@@ -28,7 +33,7 @@ export function createReadlinePromptWithInterface(rl) {
                 if (validate) {
                     const result = validate(value);
                     if (result !== true) {
-                        console.error(formatValidationError(message, result, defaultValue));
+                        errorLine(formatValidationError(message, result, defaultValue));
                         continue;
                     }
                 }
@@ -40,7 +45,7 @@ export function createReadlinePromptWithInterface(rl) {
                 throw new Error(`select() requires at least one option for prompt: ${message}`);
             }
             const resolvedDefaultIndex = getResolvedDefaultIndex(options, defaultValue);
-            renderSelectPrompt(message, options, resolvedDefaultIndex);
+            renderSelectPrompt(message, options, resolvedDefaultIndex, printLine);
             while (true) {
                 const answer = normalizePromptAnswer(await askQuestion(formatChoicePrompt(resolvedDefaultIndex)));
                 if (answer.length === 0) {
@@ -51,10 +56,10 @@ export function createReadlinePromptWithInterface(rl) {
                     return selection.value;
                 }
                 if (isPromptHelpToken(answer)) {
-                    renderSelectPrompt(message, options, resolvedDefaultIndex);
+                    renderSelectPrompt(message, options, resolvedDefaultIndex, printLine);
                     continue;
                 }
-                console.error(formatInvalidSelectionError(answer, options, resolvedDefaultIndex));
+                errorLine(formatInvalidSelectionError(answer, options, resolvedDefaultIndex));
             }
         },
         close() {
@@ -62,6 +67,18 @@ export function createReadlinePromptWithInterface(rl) {
         },
     };
 }
+function resolveReadlinePromptOutput({ errorLine, printLine, }) {
+    return {
+        errorLine: errorLine ?? writePromptErrorLine,
+        printLine: printLine ?? writePromptLine,
+    };
+}
+function writePromptLine(line) {
+    process.stdout.write(`${line}\n`);
+}
+function writePromptErrorLine(line) {
+    process.stderr.write(`${line}\n`);
+}
 function normalizePromptAnswer(value) {
     return String(value).trim();
 }
@@ -84,17 +101,17 @@ function formatValidationError(message, result, defaultValue) {
 function formatChoicePrompt(defaultIndex) {
     return `Choice [default: ${defaultIndex + 1}, ? for options]: `;
 }
-function renderSelectPrompt(message, options, defaultIndex) {
-    console.log(message);
-    console.log("  Enter a number, option label, or option value. Press Enter to keep the default, or type ? to list choices again.");
+function renderSelectPrompt(message, options, defaultIndex, printLine) {
+    printLine(message);
+    printLine("  Enter a number, option label, or option value. Press Enter to keep the default, or type ? to list choices again.");
     options.forEach((option, index) => {
         const defaultMarker = index === defaultIndex ? " (default)" : "";
         const valueHint = normalizePromptToken(option.label) === normalizePromptToken(option.value)
             ? ""
             : ` [${option.value}]`;
-        console.log(`  ${index + 1}. ${option.label}${valueHint}${defaultMarker}`);
+        printLine(`  ${index + 1}. ${option.label}${valueHint}${defaultMarker}`);
         if (option.hint) {
-            console.log(`     ${option.hint}`);
+            printLine(`     ${option.hint}`);
         }
     });
 }

package/dist/runtime/cli-scaffold.d.ts

@@ -41,6 +41,7 @@ interface RunScaffoldFlowOptions {
     onProgress?: ((event: ScaffoldProgressEvent) => void | Promise<void>) | undefined;
     packageManager?: string;
     phpPrefix?: string;
+    profile?: string;
     projectInput: string;
     promptText?: Parameters<typeof collectScaffoldAnswers>[0]["promptText"];
     queryPostType?: string;
@@ -83,7 +84,7 @@ export declare function getOptionalOnboarding({ availableScripts, packageManager
  * project.
  * @returns The scaffold result together with next-step guidance.
  */
-export declare function runScaffoldFlow({ projectInput, cwd, templateId, alternateRenderTargets, dataStorageMode, dryRun, externalLayerId, externalLayerSource, innerBlocksPreset, persistencePolicy, packageManager, namespace, textDomain, phpPrefix, queryPostType, yes, noInstall, onProgress, isInteractive, allowExistingDir, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, }: RunScaffoldFlowOptions): Promise<{
+export declare function runScaffoldFlow({ projectInput, cwd, templateId, alternateRenderTargets, dataStorageMode, dryRun, externalLayerId, externalLayerSource, innerBlocksPreset, persistencePolicy, packageManager, namespace, profile, textDomain, phpPrefix, queryPostType, yes, noInstall, onProgress, isInteractive, allowExistingDir, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, }: RunScaffoldFlowOptions): Promise<{
     dryRun: boolean;
     optionalOnboarding: OptionalOnboardingGuidance;
     plan: ScaffoldDryRunPlan | undefined;

package/dist/runtime/cli-scaffold.js

@@ -1,6 +1,6 @@
 import { promises as fsp } from "node:fs";
 import path from "node:path";
-import { collectScaffoldAnswers, DATA_STORAGE_MODES, PERSISTENCE_POLICIES, isDataStorageMode, isPersistencePolicy, resolvePackageManagerId, resolveTemplateId, scaffoldProject, } from "./scaffold.js";
+import { collectScaffoldAnswers, DATA_STORAGE_MODES, PERSISTENCE_POLICIES, isDataStorageMode, resolveCreateProfileId, isPersistencePolicy, resolvePackageManagerId, resolveTemplateId, scaffoldProject, } from "./scaffold.js";
 import { parseAlternateRenderTargets } from "./alternate-render-targets.js";
 import { parseCompoundInnerBlocksPreset } from "./compound-inner-blocks.js";
 import { isCompoundPersistenceEnabled } from "./scaffold-template-variable-groups.js";
@@ -10,6 +10,7 @@ import { createManagedTempRoot } from "./temp-roots.js";
 import { getOptionalOnboardingNote, getOptionalOnboardingShortNote, getOptionalOnboardingSteps, } from "./scaffold-onboarding.js";
 import { formatNonEmptyTargetDirectoryError } from "./scaffold-bootstrap.js";
 import { pathExists } from "./fs-async.js";
+import { readJsonFile } from "./json-utils.js";
 import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, isBuiltInTemplateId, } from "./template-registry.js";
 import { resolveOptionalInteractiveExternalLayerId, } from "./external-layer-selection.js";
 import { assertBuiltInTemplateVariantAllowed, resolveLocalCliPathOption, normalizeOptionalCliString, } from "./cli-validation.js";
@@ -40,7 +41,7 @@ async function assertDryRunTargetDirectoryReady(projectDir, allowExistingDir) {
         throw new Error(formatNonEmptyTargetDirectoryError(projectDir));
     }
 }
-async function buildScaffoldDryRunPlan({ allowExistingDir, alternateRenderTargets, answers, cwd, dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, installDependencies, noInstall, onProgress, packageManager, persistencePolicy, projectDir, templateId, variant, withMigrationUi, withTestPreset, withWpEnv, }) {
+async function buildScaffoldDryRunPlan({ allowExistingDir, alternateRenderTargets, answers, cwd, dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, installDependencies, noInstall, onProgress, packageManager, persistencePolicy, profile, projectDir, templateId, variant, withMigrationUi, withTestPreset, withWpEnv, }) {
     await assertDryRunTargetDirectoryReady(projectDir, allowExistingDir);
     const { path: tempRoot, cleanup } = await createManagedTempRoot("wp-typia-scaffold-plan-");
     const previewProjectDir = path.join(tempRoot, "preview-project");
@@ -59,6 +60,7 @@ async function buildScaffoldDryRunPlan({ allowExistingDir, alternateRenderTarget
             onProgress,
             packageManager,
             persistencePolicy,
+            profile,
             projectDir: previewProjectDir,
             templateId,
             variant,
@@ -272,7 +274,7 @@ export function getOptionalOnboarding({ availableScripts, packageManager, templa
  * project.
  * @returns The scaffold result together with next-step guidance.
  */
-export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templateId, alternateRenderTargets, dataStorageMode, dryRun = false, externalLayerId, externalLayerSource, innerBlocksPreset, persistencePolicy, packageManager, namespace, textDomain, phpPrefix, queryPostType, yes = false, noInstall = false, onProgress, isInteractive = false, allowExistingDir = false, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies = undefined, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, }) {
+export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templateId, alternateRenderTargets, dataStorageMode, dryRun = false, externalLayerId, externalLayerSource, innerBlocksPreset, persistencePolicy, packageManager, namespace, profile, textDomain, phpPrefix, queryPostType, yes = false, noInstall = false, onProgress, isInteractive = false, allowExistingDir = false, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies = undefined, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, }) {
     const normalizedExternalLayerId = normalizeOptionalCliString(externalLayerId);
     const normalizedExternalLayerSource = resolveLocalCliPathOption({
         cwd,
@@ -286,6 +288,7 @@ export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templ
         isInteractive,
         selectTemplate,
     });
+    const resolvedProfile = resolveCreateProfileId(profile);
     validateCreateFlagContract({
         alternateRenderTargets,
         dataStorageMode,
@@ -339,12 +342,14 @@ export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templ
             isInteractive,
             selectPackageManager,
         });
-        const resolvedWithWpEnv = await resolveOptionalBooleanFlag({
-            explicitValue: withWpEnv,
-            isInteractive,
-            select: selectWithWpEnv,
-            yes,
-        });
+        const resolvedWithWpEnv = resolvedProfile === "plugin-qa"
+            ? true
+            : await resolveOptionalBooleanFlag({
+                explicitValue: withWpEnv,
+                isInteractive,
+                select: selectWithWpEnv,
+                yes,
+            });
         const resolvedWithTestPreset = await resolveOptionalBooleanFlag({
             explicitValue: withTestPreset,
             isInteractive,
@@ -391,6 +396,7 @@ export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templ
                 onProgress,
                 packageManager: resolvedPackageManager,
                 persistencePolicy: resolvedPersistencePolicy,
+                profile: resolvedProfile,
                 projectDir,
                 templateId: resolvedTemplateId,
                 variant,
@@ -414,6 +420,7 @@ export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templ
                     onProgress,
                     packageManager: resolvedPackageManager,
                     persistencePolicy: resolvedPersistencePolicy,
+                    profile: resolvedProfile,
                     projectDir,
                     templateId: resolvedTemplateId,
                     variant,
@@ -425,7 +432,9 @@ export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templ
         let availableScripts;
         if (!dryRun) {
             try {
-                const parsedPackageJson = JSON.parse(await fsp.readFile(path.join(projectDir, "package.json"), "utf8"));
+                const parsedPackageJson = await readJsonFile(path.join(projectDir, "package.json"), {
+                    context: "generated package manifest",
+                });
                 const scripts = parsedPackageJson.scripts &&
                     typeof parsedPackageJson.scripts === "object" &&
                     !Array.isArray(parsedPackageJson.scripts)

package/dist/runtime/external-template-guards.js

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import { safeJsonParse } from "./json-utils.js";
 export const TEMPLATE_SOURCE_TIMEOUT_CODE = "template-source-timeout";
 export const TEMPLATE_SOURCE_TOO_LARGE_CODE = "template-source-too-large";
 const DEFAULT_EXTERNAL_TEMPLATE_TIMEOUT_MS = 20000;
@@ -120,12 +121,9 @@ async function readResponseBodyWithLimit(response, options) {
 }
 export async function readJsonResponseWithLimit(response, options) {
     const buffer = await readResponseBodyWithLimit(response, options);
-    try {
-        return JSON.parse(buffer.toString("utf8"));
-    }
-    catch (error) {
-        throw new Error(`Failed to parse ${options.label}: ${error instanceof Error ? error.message : String(error)}`);
-    }
+    return safeJsonParse(buffer.toString("utf8"), {
+        context: options.label,
+    });
 }
 export async function readBufferResponseWithLimit(response, options) {
     return readResponseBodyWithLimit(response, options);

package/dist/runtime/index.d.ts

@@ -7,7 +7,8 @@
  * and workspace-aware helpers such as `getWorkspaceBlockSelectOptions`,
  * `getWorkspaceBlockSelectOptionsAsync`,
  * `runAddBlockCommand`, `runAddBlockStyleCommand`,
- * `runAddBlockTransformCommand`, `runAddVariationCommand`,
+ * `runAddBlockTransformCommand`, `runAddCoreVariationCommand`,
+ * `runAddVariationCommand`,
  * `runAddPatternCommand`, `runAddBindingSourceCommand`,
  * `runAddEditorPluginCommand`,
  * `runAddAdminViewCommand`,
@@ -38,5 +39,7 @@ export { TEMPLATE_IDS, TEMPLATE_REGISTRY, getTemplateById, getTemplateSelectOpti
 export { EXTERNAL_TEMPLATE_CACHE_TTL_DAYS_ENV, pruneExternalTemplateCache, } from "./template-source-cache.js";
 export type { ExternalTemplateCachePruneOptions, ExternalTemplateCachePruneResult, } from "./template-source-cache.js";
 export { STALE_TEMP_ROOT_MAX_AGE_MS, WP_TYPIA_TEMP_ROOT_PREFIX, cleanupManagedTempRoot, cleanupStaleTempRoots, createManagedTempRoot, getTrackedTempRoots, } from "./temp-roots.js";
-export { createReadlinePrompt, createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatAddHelpText, formatDoctorCheckLine, formatDoctorSummaryLine, formatHelpText, formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getDoctorChecks, getDoctorFailureDetailLines, getFailingDoctorChecks, getNextSteps, getOptionalOnboarding, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, HOOKED_BLOCK_POSITION_IDS, EDITOR_PLUGIN_SLOT_IDS, isCliDiagnosticError, runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";
-export type { CliDiagnosticCode, CliDiagnosticCodeError, CliDiagnosticMessage, DoctorCheck, EditorPluginSlotId, HookedBlockPositionId, ReadlinePrompt, WorkspaceBlockSelectOption, } from "./cli-core.js";
+export { createReadlinePrompt, createDoctorRunSummary, createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatAddHelpText, formatDoctorCheckLine, formatDoctorSummaryLine, formatHelpText, formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, getDoctorFailureDetailLines, getFailingDoctorChecks, getNextSteps, getOptionalOnboarding, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, HOOKED_BLOCK_POSITION_IDS, EDITOR_PLUGIN_SLOT_IDS, isCliDiagnosticError, runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";
+export { extractPatternSectionRoleMatches, extractPatternSectionRolesFromAttributes, formatPatternCatalogDiagnostics, PATTERN_CATALOG_SCOPE_IDS, resolvePatternCatalogContentFile, validatePatternCatalog, } from "./pattern-catalog.js";
+export type { CliDiagnosticCode, CliDiagnosticCodeError, CliDiagnosticMessage, DoctorCheck, DoctorCheckScope, DoctorExitPolicy, DoctorFailureSummary, DoctorRunSummary, EditorPluginSlotId, HookedBlockPositionId, ReadlinePrompt, WorkspaceBlockSelectOption, } from "./cli-core.js";
+export type { PatternCatalogDiagnostic, PatternCatalogDiagnosticCode, PatternCatalogDiagnosticSeverity, PatternCatalogEntry, PatternCatalogScope, PatternCatalogSectionRoleConvention, PatternCatalogSectionRoleMatch, PatternCatalogValidationOptions, PatternCatalogValidationResult, } from "./pattern-catalog.js";

package/dist/runtime/index.js

@@ -7,7 +7,8 @@
  * and workspace-aware helpers such as `getWorkspaceBlockSelectOptions`,
  * `getWorkspaceBlockSelectOptionsAsync`,
  * `runAddBlockCommand`, `runAddBlockStyleCommand`,
- * `runAddBlockTransformCommand`, `runAddVariationCommand`,
+ * `runAddBlockTransformCommand`, `runAddCoreVariationCommand`,
+ * `runAddVariationCommand`,
  * `runAddPatternCommand`, `runAddBindingSourceCommand`,
  * `runAddEditorPluginCommand`,
  * `runAddAdminViewCommand`,
@@ -29,4 +30,5 @@ export { clearPackageVersionsCache, getPackageVersions, invalidatePackageVersion
 export { TEMPLATE_IDS, TEMPLATE_REGISTRY, getTemplateById, getTemplateSelectOptions, listTemplates, } from "./template-registry.js";
 export { EXTERNAL_TEMPLATE_CACHE_TTL_DAYS_ENV, pruneExternalTemplateCache, } from "./template-source-cache.js";
 export { STALE_TEMP_ROOT_MAX_AGE_MS, WP_TYPIA_TEMP_ROOT_PREFIX, cleanupManagedTempRoot, cleanupStaleTempRoots, createManagedTempRoot, getTrackedTempRoots, } from "./temp-roots.js";
-export { createReadlinePrompt, createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatAddHelpText, formatDoctorCheckLine, formatDoctorSummaryLine, formatHelpText, formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getDoctorChecks, getDoctorFailureDetailLines, getFailingDoctorChecks, getNextSteps, getOptionalOnboarding, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, HOOKED_BLOCK_POSITION_IDS, EDITOR_PLUGIN_SLOT_IDS, isCliDiagnosticError, runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";
+export { createReadlinePrompt, createDoctorRunSummary, createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatAddHelpText, formatDoctorCheckLine, formatDoctorSummaryLine, formatHelpText, formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, getDoctorFailureDetailLines, getFailingDoctorChecks, getNextSteps, getOptionalOnboarding, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, HOOKED_BLOCK_POSITION_IDS, EDITOR_PLUGIN_SLOT_IDS, isCliDiagnosticError, runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";
+export { extractPatternSectionRoleMatches, extractPatternSectionRolesFromAttributes, formatPatternCatalogDiagnostics, PATTERN_CATALOG_SCOPE_IDS, resolvePatternCatalogContentFile, validatePatternCatalog, } from "./pattern-catalog.js";

package/dist/runtime/json-utils.d.ts

@@ -1,7 +1,65 @@
 /**
- * Re-exports JSON cloning helpers from `@wp-typia/block-runtime`.
- * This adapter keeps the existing project-tools module path stable while the
- * runtime implementation now lives in block-runtime.
+ * JSON helpers shared by project-tools runtime modules.
+ *
+ * File-backed runtime JSON readers should use `safeJsonParse`,
+ * `readJsonFileSync`, or `readJsonFile` so malformed JSON reports the file path
+ * and operation context. Raw `JSON.parse` remains intentional for trusted
+ * in-memory clones, subprocess output, test fixtures, generated workspace
+ * script templates that embed their own path-aware parse handling,
+ * package-version manifest cache probes with colocated path-aware wrappers,
+ * and cache/discovery probes that immediately catch malformed documents to
+ * continue with fallback behavior.
+ *
+ * This module keeps `cloneJsonValue` local instead of re-exporting the
+ * block-runtime helper so Bunli CLI bundles that only need project-tools JSON
+ * readers do not need to resolve the block-runtime subpath at runtime.
+ *
  * @module
  */
-export * from "@wp-typia/block-runtime/json-utils";
+/**
+ * Create a deep clone of a JSON-serializable value.
+ *
+ * @remarks
+ * Values that are not JSON-serializable, such as functions, `undefined`,
+ * `BigInt`, class instances, and `Date` objects, are not preserved faithfully.
+ *
+ * @param value JSON-compatible data to clone.
+ * @returns A deep-cloned copy created with `JSON.parse(JSON.stringify(...))`.
+ */
+export declare function cloneJsonValue<T>(value: T): T;
+/**
+ * Optional metadata used to enrich JSON parse errors.
+ */
+export interface SafeJsonParseOptions {
+    /** Human-readable operation label included in parse failures. */
+    context?: string;
+    /** Source file path included in parse failures when available. */
+    filePath?: string;
+}
+/**
+ * Parse JSON and include operation/file context when decoding fails.
+ *
+ * @param source Raw JSON source text.
+ * @param options Optional file path and human-readable operation context.
+ * @returns Parsed JSON value cast to the caller-specified type.
+ * @throws {Error} When the source is malformed JSON.
+ */
+export declare function safeJsonParse<T = unknown>(source: string, options?: SafeJsonParseOptions): T;
+/**
+ * Read and parse a JSON file synchronously with path-aware parse errors.
+ *
+ * @param filePath JSON file path to read.
+ * @param options Optional parse context. `filePath` is always set from the
+ * reader argument.
+ * @returns Parsed JSON value cast to the caller-specified type.
+ */
+export declare function readJsonFileSync<T = unknown>(filePath: string, options?: Omit<SafeJsonParseOptions, "filePath">): T;
+/**
+ * Read and parse a JSON file asynchronously with path-aware parse errors.
+ *
+ * @param filePath JSON file path to read.
+ * @param options Optional parse context. `filePath` is always set from the
+ * reader argument.
+ * @returns Parsed JSON value cast to the caller-specified type.
+ */
+export declare function readJsonFile<T = unknown>(filePath: string, options?: Omit<SafeJsonParseOptions, "filePath">): Promise<T>;