@wp-typia/project-tools 0.22.10 → 0.23.1

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

@@ -1,3 +1,7 @@
+/** Scope bucket used by doctor exit policies and JSON summaries. */
+export type DoctorCheckScope = "environment" | "workspace";
+/** Policy used to decide which failed checks should fail the process. */
+export type DoctorExitPolicy = "strict" | "workspace-only";
 /**
  * One doctor check rendered by the CLI diagnostics flow.
  */
@@ -8,13 +12,39 @@ export interface DoctorCheck {
     detail: string;
     /** Short label for the dependency, directory, or template check. */
     label: string;
+    /** Scope bucket used by machine-readable summaries and exit-code policies. */
+    scope?: DoctorCheckScope;
     /** Final pass/fail/warn status for this diagnostic row. */
     status: "pass" | "fail" | "warn";
 }
+/** One failed row classified against the active doctor exit policy. */
+export interface DoctorFailureSummary {
+    code?: string;
+    label: string;
+    scope: DoctorCheckScope | "unknown";
+    severity: "advisory" | "error";
+}
+/** Stable JSON summary for `wp-typia doctor --format json`. */
+export interface DoctorRunSummary {
+    advisoryFailureCount: number;
+    advisoryFailures: DoctorFailureSummary[];
+    exitCode: 0 | 1;
+    exitFailureCount: number;
+    exitFailures: DoctorFailureSummary[];
+    exitPolicy: DoctorExitPolicy;
+    failed: number;
+    passed: number;
+    total: number;
+    warnings: number;
+}
 interface RunDoctorOptions {
+    exitPolicy?: DoctorExitPolicy;
     renderLine?: (check: DoctorCheck) => void;
     renderSummaryLine?: (summaryLine: string) => void;
 }
+interface DoctorSummaryOptions {
+    exitPolicy?: DoctorExitPolicy;
+}
 /**
  * Collect all runtime doctor checks for the current environment.
  *
@@ -28,12 +58,31 @@ interface RunDoctorOptions {
  */
 export declare function getDoctorChecks(cwd: string): Promise<DoctorCheck[]>;
 /**
- * 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 declare function getDoctorExitFailureChecks(checks: readonly DoctorCheck[], options?: DoctorSummaryOptions): DoctorCheck[];
+/**
+ * Format only exit-contributing doctor failures for structured diagnostics.
+ */
+export declare function getDoctorExitFailureDetailLines(checks: readonly DoctorCheck[], options?: DoctorSummaryOptions): string[];
+/**
+ * Build the stable JSON summary for one doctor run.
+ */
+export declare function createDoctorRunSummary(checks: readonly DoctorCheck[], options?: DoctorSummaryOptions): DoctorRunSummary;
+/**
+ * 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.
  * @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 declare function runDoctor(cwd: string, options?: RunDoctorOptions): Promise<DoctorCheck[]>;
 export {};

package/dist/runtime/cli-doctor.js

@@ -1,6 +1,33 @@
-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";
+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,19 +41,62 @@ 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.
  * @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 exitPolicy = resolveDoctorExitPolicy(options);
     const renderLine = options.renderLine ?? ((check) => console.log(formatDoctorCheckLine(check)));
     const renderSummaryLine = options.renderSummaryLine ??
         (options.renderLine ? () => undefined : (summaryLine) => console.log(summaryLine));
@@ -34,8 +104,9 @@ export async function runDoctor(cwd, options = {}) {
     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,12 +21,15 @@ 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] [--release-zip] [--service <none|docker-compose>]
   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 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>|--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>]
   wp-typia add editor-plugin <name> [--slot <sidebar|document-setting-panel>]
@@ -48,11 +52,15 @@ 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.
@@ -60,6 +68,8 @@ Notes:
   \`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 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/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/\`.
   \`add editor-plugin\` scaffolds a document-level editor extension under \`src/editor-plugins/\`; legacy aliases \`PluginSidebar\` and \`PluginDocumentSettingPanel\` resolve to \`sidebar\` and \`document-setting-panel\`.

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-init-templates.js

@@ -182,6 +182,16 @@ function getSyncScriptEnv() {
 \treturn env;
 }
 
+function getOptionalNodeErrorCode( error: unknown ): string | undefined {
+\treturn typeof error === 'object' && error !== null && 'code' in error
+\t\t? String( ( error as { code: unknown } ).code )
+\t\t: undefined;
+}
+
+function isFileNotFoundError( error: unknown ): boolean {
+\treturn getOptionalNodeErrorCode( error ) === 'ENOENT';
+}
+
 function runSyncScript( scriptPath: string, options: SyncCliOptions ) {
 \tconst args = [ scriptPath ];
 \tif ( options.check ) {
@@ -196,7 +206,7 @@ function runSyncScript( scriptPath: string, options: SyncCliOptions ) {
 \t} );
 
 \tif ( result.error ) {
-\t\tif ( ( result.error as NodeJS.ErrnoException ).code === 'ENOENT' ) {
+\t\tif ( isFileNotFoundError( result.error ) ) {
 \t\t\tthrow new Error(
 \t\t\t\t'Unable to resolve \`tsx\` for project sync. Install project dependencies or rerun the command through your package manager.'
 \t\t\t);

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/contract-artifacts.d.ts

@@ -0,0 +1,14 @@
+interface SyncStandaloneContractArtifactsOptions {
+    projectDir: string;
+    schemaFile: string;
+    sourceTypeName: string;
+    typesFile: string;
+}
+/**
+ * Generate the JSON Schema artifact for a standalone TypeScript contract.
+ *
+ * @param options Workspace-relative type/schema paths plus the exported source
+ * type name.
+ */
+export declare function syncStandaloneContractArtifacts({ projectDir, schemaFile, sourceTypeName, typesFile, }: SyncStandaloneContractArtifactsOptions): Promise<void>;
+export {};

package/dist/runtime/contract-artifacts.js

@@ -0,0 +1,15 @@
+import { syncTypeSchemas, } from "@wp-typia/block-runtime/metadata-core";
+/**
+ * Generate the JSON Schema artifact for a standalone TypeScript contract.
+ *
+ * @param options Workspace-relative type/schema paths plus the exported source
+ * type name.
+ */
+export async function syncStandaloneContractArtifacts({ projectDir, schemaFile, sourceTypeName, typesFile, }) {
+    await syncTypeSchemas({
+        jsonSchemaFile: schemaFile,
+        projectRoot: projectDir,
+        sourceTypeName,
+        typesFile,
+    });
+}

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

@@ -38,5 +38,5 @@ 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, 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, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";
+export type { CliDiagnosticCode, CliDiagnosticCodeError, CliDiagnosticMessage, DoctorCheck, DoctorCheckScope, DoctorExitPolicy, DoctorFailureSummary, DoctorRunSummary, EditorPluginSlotId, HookedBlockPositionId, ReadlinePrompt, WorkspaceBlockSelectOption, } from "./cli-core.js";

package/dist/runtime/index.js

@@ -29,4 +29,4 @@ 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, 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, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";