@microsoft/teamsfx-core 3.1.0 → 3.1.2-alpha.31d08fb48a.0

package/build/core/createFrontDoorAdapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFrontDoorAdapters.d.ts","sourceRoot":"","sources":["../../src/core/createFrontDoorAdapters.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,EACL,mBAAmB,EAEnB,OAAO,EACP,MAAM,EACN,MAAM,EACN,eAAe,EAGhB,MAAM,wBAAwB,CAAC;AAYhC,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EACjC,MAAM,yCAAyC,CAAC;AAMjD,OAAO,EACL,OAAO,EACP,WAAW,EAIZ,MAAM,OAAO,CAAC;AAqDf;;;;GAIG;AACH,eAAO,MAAM,cAAc;;CAE1B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACtC,eAAe,CAAC,EAAE,wBAAwB,GACzC,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CA2E/C;AAmCD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAyDrC"}

package/build/core/createFrontDoorAdapters.js

@@ -0,0 +1,244 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaffoldV4Deps = void 0;
+exports.scaffoldV4 = scaffoldV4;
+exports.collectCreateFloor = collectCreateFloor;
+const tslib_1 = require("tslib");
+/**
+ * The composition-root impl of the flag-on `createProjectFrontDoor` seams
+ * (`dispatch-create-by-engine` `CreateFrontDoorDeps`). These live outside the
+ * pure orchestrator so it stays injectable and I/O-free: `FxCore` wires these
+ * real handlers, the orchestrator's tests wire fakes.
+ *
+ * - `scaffoldV4`     — the `engine: "v4"` hand-off: build a v3 `GeneratorContext`
+ *                      over the create floor and render the authored declarative
+ *                      package through the v4 distribution channel.
+ */
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const fs = tslib_1.__importStar(require("fs-extra"));
+const jsonschema = tslib_1.__importStar(require("jsonschema"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const telemetry_1 = require("../common/telemetry");
+const globalVars_1 = require("../common/globalVars");
+const coordinator_1 = require("../component/coordinator");
+const generator_1 = require("../component/generator/generator");
+const utils_1 = require("../component/generator/utils");
+const templateNames_1 = require("../component/generator/templates/templateNames");
+const v4TemplateBridge_1 = require("../component/generator/v4TemplateBridge");
+const telemetry_2 = require("../component/telemetry");
+const ManifestUtils_1 = require("../component/driver/teamsApp/utils/ManifestUtils");
+const pathUtils_1 = require("../component/utils/pathUtils");
+const common_1 = require("../error/common");
+const question_1 = require("../question");
+const v4_1 = require("../v4");
+const runtimeRegistry_1 = require("../v4/runtime/runtimeRegistry");
+/** The package namespace the create front door opens v4 packages under. */
+const CREATE_KIND = "create";
+/** The language a single-language (language-neutral) v4 package scaffolds under. */
+const COMMON_LANGUAGE = "common";
+/**
+ * v4 template id → its v3 `TemplateNames` equivalent, used **only** as the
+ * `generate-template` telemetry key so existing OKR queries keep joining with
+ * command-level `create-project` (DCE-19/-21). It is not a dispatch input.
+ */
+const LEGACY_TELEMETRY_TEMPLATE_ID = {
+    "basic-custom-engine-agent": templateNames_1.TemplateNames.BasicCustomEngineAgent,
+    "weather-agent": templateNames_1.TemplateNames.WeatherAgent,
+    "graph-connector": templateNames_1.TemplateNames.GraphConnector,
+    "custom-copilot-basic": templateNames_1.TemplateNames.CustomCopilotBasic,
+    "custom-copilot-rag-customize": templateNames_1.TemplateNames.CustomCopilotRagCustomize,
+    "custom-copilot-rag-azure-ai-search": templateNames_1.TemplateNames.CustomCopilotRagAzureAISearch,
+    "custom-copilot-rag-custom-api": templateNames_1.TemplateNames.CustomCopilotRagCustomApi,
+    "teams-collaborator-agent": templateNames_1.TemplateNames.TeamsCollaboratorAgent,
+    "non-sso-tab": templateNames_1.TemplateNames.Tab,
+    "default-message-extension": templateNames_1.TemplateNames.DefaultMessageExtension,
+    "default-bot": templateNames_1.TemplateNames.DefaultBot,
+    "office-addin-wxpo-taskpane": templateNames_1.TemplateNames.WXPTaskpane,
+    "office-addin-excel-cfshortcut": templateNames_1.TemplateNames.ExcelCFShortcut,
+    "office-addin-excel-customfunctions": templateNames_1.TemplateNames.ExcelCustomFunctions,
+    "office-addin-sso-naa": templateNames_1.TemplateNames.OfficeAddinSsoNaa,
+    "declarative-agent-meta-os-upgrade-project": "declarative-agent-meta-os-upgrade-project",
+    "office-addin-config": templateNames_1.TemplateNames.OfficeAddinCommon,
+    "da/no-action": templateNames_1.TemplateNames.DeclarativeAgentBasic,
+    "da/graph-connector": templateNames_1.TemplateNames.DeclarativeAgentWithGraphConnector,
+    "da/typespec": templateNames_1.TemplateNames.DeclarativeAgentWithTypeSpec,
+    "da/skill": templateNames_1.TemplateNames.DeclarativeAgentWithSkill,
+    "da/api-plugin-from-scratch": templateNames_1.TemplateNames.DeclarativeAgentWithActionFromScratch,
+    "da/api-plugin-from-scratch-bearer": templateNames_1.TemplateNames.DeclarativeAgentWithActionFromScratchBearer,
+    "da/api-plugin-from-scratch-oauth": templateNames_1.TemplateNames.DeclarativeAgentWithActionFromScratchOAuth,
+    "da/api-plugin-from-existing-api": templateNames_1.TemplateNames.DeclarativeAgentWithActionFromExistingApiSpec,
+    "da/mcp-server-static": templateNames_1.TemplateNames.DeclarativeAgentWithActionFromMCP,
+    "da/mcp-server": templateNames_1.TemplateNames.DeclarativeAgentWithActionFromMCP,
+};
+function scaffoldTelemetryProps(target, language) {
+    const templateId = LEGACY_TELEMETRY_TEMPLATE_ID[target.templateId] ?? target.templateId;
+    return {
+        [telemetry_1.TelemetryProperty.Component]: telemetry_1.Component.core,
+        [telemetry_1.TelemetryProperty.TemplateName]: `${templateId}-${(0, utils_1.convertToLangKey)(language)}`,
+        env: process.env.TEAMSFX_ENV || "",
+    };
+}
+/**
+ * The one module function `scaffoldV4` hands the located package to, behind the
+ * repo's `*Deps` seam so a test can stub the channel render without I/O (the v4
+ * named export is otherwise a read-only binding).
+ */
+exports.scaffoldV4Deps = {
+    scaffoldDeclarativeFromV4Channel: v4TemplateBridge_1.scaffoldDeclarativeFromV4Channel,
+};
+/**
+ * The `engine: "v4"` hand-off. The orchestrator has already collected the
+ * package's own answers (Q2, via `runCreateInputs`); this validates the create
+ * floor (`folder` / `app-name`), then renders the located `create/<templateId>`
+ * declarative package onto disk via the v4 distribution channel.
+ *
+ * Mirrors the legacy customized-generator validation, tracking-id and manifest
+ * short-name-trim tail so a v4 scaffold yields the same `CreateProjectResult`
+ * shape as every other create path.
+ */
+async function scaffoldV4(inputs, target, answers, flagReader, resolvedPackage) {
+    const folderInput = inputs[question_1.QuestionNames.Folder];
+    if (!folderInput) {
+        return (0, teamsfx_api_1.err)(new common_1.MissingRequiredInputError(question_1.QuestionNames.Folder));
+    }
+    const folder = path_1.default.resolve(folderInput);
+    const appName = inputs[question_1.QuestionNames.AppName];
+    if (appName === undefined) {
+        return (0, teamsfx_api_1.err)(new common_1.MissingRequiredInputError(question_1.QuestionNames.AppName));
+    }
+    const validateResult = jsonschema.validate(appName, { pattern: question_1.AppNamePattern });
+    if (validateResult.errors && validateResult.errors.length > 0) {
+        return (0, teamsfx_api_1.err)(new common_1.InputValidationError(question_1.QuestionNames.AppName, validateResult.errors[0].message));
+    }
+    const projectPath = path_1.default.join(folder, appName);
+    // The language axis is the downstream `collect-inputs` Q0 answer (ADR-0014
+    // Amendment 2 / ADR-0016 decision 5); a single-language (`["common"]`) template
+    // never asks it, so an absent answer falls back to the language-neutral floor.
+    const languageAnswer = answers["language"];
+    const language = typeof languageAnswer === "string" ? languageAnswer : COMMON_LANGUAGE;
+    const telemetryProps = scaffoldTelemetryProps(target, language);
+    const generatorContext = {
+        name: appName,
+        language,
+        platform: inputs.platform,
+        destination: projectPath,
+        logProvider: globalVars_1.TOOLS.logProvider,
+        onActionError: generator_1.templateDefaultOnActionError,
+    };
+    const locator = { kind: CREATE_KIND, templateId: target.templateId };
+    const callerFloor = { appName, language };
+    try {
+        const source = await exports.scaffoldV4Deps.scaffoldDeclarativeFromV4Channel(generatorContext, locator, answers, callerFloor, telemetryProps, flagReader, resolvedPackage, (0, runtimeRegistry_1.createStepRegistry)((0, v4_1.createGeneralSensitivityLabelService)(globalVars_1.TOOLS.tokenProvider.m365TokenProvider)));
+        if (source.warning) {
+            globalVars_1.TOOLS.logProvider.warning(source.warning);
+        }
+    }
+    catch (e) {
+        const fxError = (0, common_1.assembleError)(e);
+        (0, telemetry_2.sendErrorEvent)(telemetry_1.TelemetryEvent.GenerateTemplate, fxError, telemetryProps);
+        return (0, teamsfx_api_1.err)(fxError);
+    }
+    (0, telemetry_2.sendSuccessEvent)(telemetry_1.TelemetryEvent.GenerateTemplate, telemetryProps);
+    const result = { projectPath };
+    // The scaffolding summary and the surfaces' post-create notifications read these; dropping
+    // them here is what would make a placeholder-bearing m365agents.yml fail silently later.
+    if (generatorContext.warnings?.length) {
+        result.warnings = generatorContext.warnings;
+    }
+    const ymlPath = pathUtils_1.pathUtils.getYmlFilePath(projectPath, "dev");
+    if (ymlPath && (await fs.pathExists(ymlPath))) {
+        const ensureRes = await coordinator_1.coordinator.ensureTrackingId(projectPath, inputs.projectId);
+        if (ensureRes.isErr()) {
+            return (0, teamsfx_api_1.err)(ensureRes.error);
+        }
+        result.projectId = ensureRes.value;
+    }
+    const trimRes = await ManifestUtils_1.manifestUtils.trimManifestShortName(projectPath);
+    if (trimRes.isErr()) {
+        return (0, teamsfx_api_1.err)(trimRes.error);
+    }
+    return (0, teamsfx_api_1.ok)(result);
+}
+function getStringValidationFunc(validation) {
+    if (validation === undefined || !("validFunc" in validation)) {
+        return undefined;
+    }
+    return validation.validFunc;
+}
+async function resolveStringValue(value, inputs) {
+    return typeof value === "function" ? await value(inputs) : value;
+}
+async function validateAppNameInput(inputs, appName) {
+    const validation = (0, question_1.appNameQuestion)().validation;
+    const validFunc = getStringValidationFunc(validation);
+    if (validFunc !== undefined) {
+        const validationMessage = await validFunc(appName, inputs);
+        if (validationMessage !== undefined) {
+            return (0, teamsfx_api_1.err)(new common_1.InputValidationError(question_1.QuestionNames.AppName, validationMessage, "createFrontDoor"));
+        }
+    }
+    return (0, teamsfx_api_1.ok)(undefined);
+}
+/**
+ * The `engine: "v4"` create-floor collection. The front door owns Q1/Q2, so the
+ * remaining surface floor is collected directly here instead of routing through
+ * any legacy question-tree traversal.
+ */
+async function collectCreateFloor(inputs, ui) {
+    const folder = (0, question_1.folderQuestion)();
+    const appName = (0, question_1.appNameQuestion)();
+    if (inputs[question_1.QuestionNames.Folder] === undefined) {
+        const defaultFolder = await resolveStringValue(folder.default, inputs);
+        if (inputs.nonInteractive) {
+            if (defaultFolder !== undefined) {
+                inputs[question_1.QuestionNames.Folder] = defaultFolder;
+            }
+        }
+        else {
+            const folderResult = await ui.selectFolder({
+                name: folder.name,
+                title: (await resolveStringValue(folder.title, inputs)) ?? "",
+                placeholder: await resolveStringValue(folder.placeholder, inputs),
+                prompt: await resolveStringValue(folder.prompt, inputs),
+                default: defaultFolder,
+                validation: getStringValidationFunc(folder.validation),
+            });
+            if (folderResult.isErr()) {
+                return (0, teamsfx_api_1.err)(folderResult.error);
+            }
+            if (typeof folderResult.value.result === "string") {
+                inputs[question_1.QuestionNames.Folder] = folderResult.value.result;
+            }
+        }
+    }
+    const existingAppName = inputs[question_1.QuestionNames.AppName];
+    if (typeof existingAppName === "string") {
+        return validateAppNameInput(inputs, existingAppName);
+    }
+    const defaultAppName = await resolveStringValue(appName.default, inputs);
+    if (inputs.nonInteractive) {
+        if (defaultAppName === undefined) {
+            return (0, teamsfx_api_1.err)(new common_1.MissingRequiredInputError(question_1.QuestionNames.AppName, "createFrontDoor"));
+        }
+        inputs[question_1.QuestionNames.AppName] = defaultAppName;
+        return validateAppNameInput(inputs, defaultAppName);
+    }
+    const appNameResult = await ui.inputText({
+        name: appName.name,
+        title: (await resolveStringValue(appName.title, inputs)) ?? "",
+        placeholder: await resolveStringValue(appName.placeholder, inputs),
+        prompt: await resolveStringValue(appName.prompt, inputs),
+        default: defaultAppName,
+        validation: getStringValidationFunc(appName.validation),
+    });
+    if (appNameResult.isErr()) {
+        return (0, teamsfx_api_1.err)(appNameResult.error);
+    }
+    if (typeof appNameResult.value.result === "string") {
+        inputs[question_1.QuestionNames.AppName] = appNameResult.value.result;
+    }
+    return (0, teamsfx_api_1.ok)(undefined);
+}
+//# sourceMappingURL=createFrontDoorAdapters.js.map

package/build/core/createFrontDoorAdapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFrontDoorAdapters.js","sourceRoot":"","sources":["../../src/core/createFrontDoorAdapters.ts"],"names":[],"mappings":"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"}

package/build/core/createProjectFrontDoor.d.ts

@@ -0,0 +1,49 @@
+import { CreateProjectResult, FxError, Inputs, UserInteraction } from "@microsoft/teamsfx-api";
+import { Result } from "neverthrow";
+import { Answers, BuildTarget, TemplateArtifactKind, TemplateArtifactSnapshot, resolveCreateTargetByTemplateId, runCreateInputsWalk, runCreateSelector } from "../v4";
+import type { ResolvedV4ChannelPackage } from "../component/generator/v4TemplateBridge";
+/**
+ * The create front door's injected seams. `createV3` is required for the
+ * flag-off pass-through, and injecting it (rather than importing `FxCore`) keeps
+ * this seam free of an import cycle. `scaffoldV4`, `runInputs`, and the legacy
+ * `collectCreateFloor` seam are the flag-on hand-offs the
+ * composition root (`FxCore`) supplies. The remaining members default to the real
+ * wiring, so a production caller passes only the four handlers.
+ */
+export interface CreateFrontDoorDeps {
+    /** The flag-off pass-through: the unmodified `FxCore.createProject`. */
+    createV3: (inputs: Inputs) => Promise<Result<CreateProjectResult, FxError>>;
+    /** The engine=v4 hand-off: build the scaffold context + run the authored declarative package. */
+    scaffoldV4: (inputs: Inputs, target: BuildTarget, answers: Answers, flagReader: (name: string) => boolean, resolvedPackage?: ResolvedV4ChannelPackage) => Promise<Result<CreateProjectResult, FxError>>;
+    /** Legacy create-floor seam retained for existing composition wiring; v4 now appends floor questions inside `runInputs`. */
+    collectCreateFloor: (inputs: Inputs, ui: UserInteraction) => Promise<Result<undefined, FxError>>;
+    /** The feature-flag reader (default: `featureFlagManager`-backed, so VS Code-settings flags apply). */
+    flagReader?: (name: string) => boolean;
+    /** The bundled-floor channel-zip reader (default: the shipped `templates.zip`; injectable for tests, INV-6). */
+    readFloorBytes?: () => Buffer;
+    /** Per-invocation staged artifact snapshot. When supplied, Q1/Q2/full staging read from this snapshot. */
+    artifactSnapshot?: TemplateArtifactSnapshot;
+    /** Resolves a per-invocation staged artifact snapshot after the v4 flag is known to be on. */
+    resolveArtifactSnapshot?: (requiredKind: TemplateArtifactKind) => Promise<Result<TemplateArtifactSnapshot, FxError>>;
+    /** Membership test supplied with selector-only artifacts. */
+    v4Registry?: (templateId: string) => boolean;
+    /** The host surface (default: `TOOLS.ui`). */
+    ui?: UserInteraction;
+    /** The Q1 selector walk (default: the real `runCreateSelector`). */
+    runSelector?: typeof runCreateSelector;
+    /** Resolve a target directly from a preset `template-name`, bypassing Q1 (default: the real `resolveCreateTargetByTemplateId`). */
+    resolveByTemplateId?: typeof resolveCreateTargetByTemplateId;
+    /** The Q2 inputs walk (default: the real `runCreateInputsWalk`, returning a resumable outcome). */
+    runInputs?: typeof runCreateInputsWalk;
+}
+/**
+ * Run the create front door for `inputs`, dispatching the resolved engine.
+ *
+ * @param inputs the create inputs (carries `platform`; mutated in place by the
+ *               v4 floor collection before the hand-off to `scaffoldV4`)
+ * @param deps   the injected seams (see `CreateFrontDoorDeps`)
+ * @returns the created project (drop-in for `FxCore.createProject`), or a
+ *          `UserError` / `SystemError` (a surface cancellation or a route break)
+ */
+export declare function createProjectFrontDoor(inputs: Inputs, deps: CreateFrontDoorDeps): Promise<Result<CreateProjectResult, FxError>>;
+//# sourceMappingURL=createProjectFrontDoor.d.ts.map

package/build/core/createProjectFrontDoor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProjectFrontDoor.d.ts","sourceRoot":"","sources":["../../src/core/createProjectFrontDoor.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,mBAAmB,EACnB,OAAO,EACP,MAAM,EAGN,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,MAAM,EAAW,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,OAAO,EACP,WAAW,EAGX,oBAAoB,EACpB,wBAAwB,EAGxB,+BAA+B,EAC/B,mBAAmB,EACnB,iBAAiB,EAElB,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AA0CxF;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5E,iGAAiG;IACjG,UAAU,EAAE,CACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACrC,eAAe,CAAC,EAAE,wBAAwB,KACvC,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,4HAA4H;IAC5H,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IACjG,uGAAuG;IACvG,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,gHAAgH;IAChH,cAAc,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,0GAA0G;IAC1G,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,8FAA8F;IAC9F,uBAAuB,CAAC,EAAE,CACxB,YAAY,EAAE,oBAAoB,KAC/B,OAAO,CAAC,MAAM,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,6DAA6D;IAC7D,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,8CAA8C;IAC9C,EAAE,CAAC,EAAE,eAAe,CAAC;IACrB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACvC,mIAAmI;IACnI,mBAAmB,CAAC,EAAE,OAAO,+BAA+B,CAAC;IAC7D,mGAAmG;IACnG,SAAS,CAAC,EAAE,OAAO,mBAAmB,CAAC;CACxC;AAsGD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAmL/C"}

package/build/core/createProjectFrontDoor.js

@@ -0,0 +1,316 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProjectFrontDoor = createProjectFrontDoor;
+const tslib_1 = require("tslib");
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const neverthrow_1 = require("neverthrow");
+const v4_1 = require("../v4");
+const featureFlags_1 = require("../common/featureFlags");
+const globalVars_1 = require("../common/globalVars");
+const questionNames_1 = require("../question/questionNames");
+/**
+ * Operation `dispatch-create-by-engine` — the create front door.
+ *
+ * Spec: docs/03-specs/operations/scaffolding/dispatch-create-by-engine.md
+ * Decision: docs/02-architecture/adr/ADR-0014-dispatcher-buildtarget-resolution.md
+ *
+ * The single entry the create surfaces call in place of `FxCore.createProject`.
+ * Behind `TEAMSFX_V4_ENABLED`, the v4 create selector is the live Q1 front door
+ * and the resolved `BuildTarget` is dispatched by its `engine` (INV-3):
+ *   - `v4`             → run the template's own Q2 (`runCreateInputs`) over the
+ *                        same floor, with the create floor appended to the same
+ *                        walk, then `scaffoldV4` the authored package;
+ *   - `surface-action` → return the action's surface signal (no scaffold).
+ * `{ v4, surface-action }` is the whole closed engine set (ADR-0014 Amendment 5):
+ * no selector engine hands off to v3.
+ * Flag off is a pure pass-through to the unmodified `createV3` (INV-1): the
+ * selector is never walked, so v3 behavior is byte-identical.
+ *
+ * This orchestrator is a seam outside the v4 world (INV-4): it touches the v3
+ * `Inputs` and calls `createV3`, which v4 may not. Every effectful step is an
+ * injected dependency, so the dispatch is verifiable without I/O; the floor read
+ * is injectable too (INV-6).
+ */
+const SOURCE = "Scaffold";
+/** The only shipped create `surface-action`: open GitHub Copilot Chat (the v3 `startWithGithubCopilot` shape). */
+const OPEN_GITHUB_COPILOT_CHAT = "open-github-copilot-chat";
+const NON_V4_INPUT_KEYS = new Set([
+    "capabilities",
+    "folder",
+    "isM365",
+    "nonInteractive",
+    "platform",
+    "projectId",
+    "runtime",
+    questionNames_1.QuestionNames.TemplateName,
+]);
+/** The default `featureFlagManager`-backed reader (a flag is on per its env var / VS Code setting). */
+function defaultFlagReader(name) {
+    return (0, featureFlags_1.readBooleanFeatureFlag)(name);
+}
+/** Read the shipped bundled-floor channel zip (the default `readFloorBytes`). */
+function readBundledFloorBytes() {
+    return fs_extra_1.default.readFileSync(path_1.default.join((0, v4_1.bundledFloorDir)(), "templates.zip"));
+}
+function readSnapshotBytes(snapshot, kind) {
+    return snapshot.bytes(kind);
+}
+function isV4NeutralInput(key, value) {
+    return (!NON_V4_INPUT_KEYS.has(key) &&
+        !key.includes("-") &&
+        (typeof value === "string" ||
+            (Array.isArray(value) && value.every((item) => typeof item === "string"))));
+}
+function neutralAnswersFromInputs(inputs) {
+    const answers = {};
+    for (const [key, value] of Object.entries(inputs)) {
+        if (isV4NeutralInput(key, value)) {
+            answers[key] = value;
+        }
+    }
+    const officeAddinFolder = inputs[questionNames_1.QuestionNames.OfficeAddinFolder];
+    if (typeof officeAddinFolder === "string" && answers.officeAddinFolder === undefined) {
+        answers.officeAddinFolder = officeAddinFolder;
+    }
+    const officeAddinManifest = inputs[questionNames_1.QuestionNames.OfficeAddinManifest];
+    if (typeof officeAddinManifest === "string" && answers.officeAddinManifest === undefined) {
+        answers.officeAddinManifest = officeAddinManifest;
+    }
+    return answers;
+}
+function selectorPrefillFromInputs(inputs) {
+    const answers = {};
+    for (const [key, value] of Object.entries(neutralAnswersFromInputs(inputs))) {
+        if (typeof value === "string") {
+            answers[key] = value;
+        }
+    }
+    return answers;
+}
+function applyV4CreateFloorAnswers(inputs, answers) {
+    const folder = answers[questionNames_1.QuestionNames.Folder];
+    if (typeof folder === "string") {
+        inputs[questionNames_1.QuestionNames.Folder] = folder;
+    }
+    const appName = answers[questionNames_1.QuestionNames.AppName];
+    if (typeof appName === "string") {
+        inputs[questionNames_1.QuestionNames.AppName] = appName;
+    }
+}
+/** Map the host `Platform` onto the selector's `surface` axis (drives option `condition`s). */
+function surfaceOf(platform) {
+    switch (platform) {
+        case teamsfx_api_1.Platform.CLI:
+        case teamsfx_api_1.Platform.CLI_HELP:
+            return "cli";
+        case teamsfx_api_1.Platform.VS:
+            return "vs";
+        default:
+            return "vscode";
+    }
+}
+/** Dispatch a resolved `surface-action` target onto its surface signal (no scaffold). */
+function dispatchSurfaceAction(target) {
+    if (target.templateId === OPEN_GITHUB_COPILOT_CHAT) {
+        return (0, neverthrow_1.ok)({ projectPath: "", shouldInvokeTeamsAgent: true });
+    }
+    return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+        source: SOURCE,
+        name: "UnsupportedCreateAction",
+        message: `The create front door does not handle the '${target.templateId}' surface action.`,
+    }));
+}
+function unexpectedPresetBack(target) {
+    return new teamsfx_api_1.SystemError({
+        source: SOURCE,
+        name: "UnexpectedCreateBack",
+        message: `The preset-template create path for '${target.templateId}' is not backable, but Q2 signalled back.`,
+    });
+}
+/**
+ * Run the create front door for `inputs`, dispatching the resolved engine.
+ *
+ * @param inputs the create inputs (carries `platform`; mutated in place by the
+ *               v4 floor collection before the hand-off to `scaffoldV4`)
+ * @param deps   the injected seams (see `CreateFrontDoorDeps`)
+ * @returns the created project (drop-in for `FxCore.createProject`), or a
+ *          `UserError` / `SystemError` (a surface cancellation or a route break)
+ */
+async function createProjectFrontDoor(inputs, deps) {
+    const flagReader = deps.flagReader ?? defaultFlagReader;
+    // INV-1: flag off ⇒ a pure pass-through to the unmodified v3 createProject.
+    if (!flagReader(featureFlags_1.FeatureFlags.V4Enabled.name)) {
+        return deps.createV3(inputs);
+    }
+    const ui = deps.ui ?? globalVars_1.TOOLS.ui;
+    const surface = surfaceOf(inputs.platform);
+    let snapshot = deps.artifactSnapshot;
+    let floorBytes;
+    const interactive = !inputs.nonInteractive;
+    // Dispatch one resolved BuildTarget by its engine (INV-3). Returns a scaffolded
+    // result, or `{ kind: "back" }` when a backable Q2 was exited at its first prompt
+    // (the caller re-enters Q1). `snapshot` / `floorBytes` are read lazily and shared.
+    async function dispatchByEngine(target, baseStep, backable) {
+        switch (target.engine) {
+            case "surface-action": {
+                const action = dispatchSurfaceAction(target);
+                return action.isErr() ? (0, neverthrow_1.err)(action.error) : (0, neverthrow_1.ok)({ kind: "result", result: action.value });
+            }
+            case "v4": {
+                const runInputs = deps.runInputs ?? v4_1.runCreateInputsWalk;
+                const locator = { kind: "create", templateId: target.templateId };
+                // Q2 + common floor, over the same floor, continuing Q1's step numbering.
+                const entryParams = {
+                    ...(target.answers ?? {}),
+                    ...neutralAnswersFromInputs(inputs),
+                };
+                let inputBytes;
+                if (snapshot === undefined) {
+                    inputBytes = floorBytes ?? (deps.readFloorBytes ?? readBundledFloorBytes)();
+                }
+                else {
+                    const metadataBytes = await readSnapshotBytes(snapshot, "metadata");
+                    if (metadataBytes.isErr()) {
+                        return (0, neverthrow_1.err)(metadataBytes.error);
+                    }
+                    inputBytes = metadataBytes.value;
+                }
+                const outcome = await runInputs(inputBytes, locator, entryParams, ui, {
+                    flagReader,
+                    surface,
+                    inputs,
+                    baseStep,
+                    backable,
+                });
+                if (outcome.isErr()) {
+                    return (0, neverthrow_1.err)(outcome.error);
+                }
+                if (outcome.value.kind === "back") {
+                    return (0, neverthrow_1.ok)({ kind: "back" });
+                }
+                const answers = outcome.value.answers;
+                applyV4CreateFloorAnswers(inputs, answers);
+                // The scaffold contract is a plain BuildTarget; do not leak Q1 walk metadata.
+                const scaffoldTarget = {
+                    templateId: target.templateId,
+                    engine: target.engine,
+                    answers: target.answers,
+                };
+                if (snapshot !== undefined) {
+                    const fullBytes = await readSnapshotBytes(snapshot, "templates");
+                    if (fullBytes.isErr()) {
+                        return (0, neverthrow_1.err)(fullBytes.error);
+                    }
+                    const scaffolded = await deps.scaffoldV4(inputs, scaffoldTarget, answers, flagReader, {
+                        source: (0, v4_1.templateSourceFromArtifactSnapshot)(snapshot),
+                        bytes: fullBytes.value,
+                    });
+                    return scaffolded.isErr()
+                        ? (0, neverthrow_1.err)(scaffolded.error)
+                        : (0, neverthrow_1.ok)({ kind: "result", result: scaffolded.value });
+                }
+                const scaffolded = await deps.scaffoldV4(inputs, scaffoldTarget, answers, flagReader);
+                return scaffolded.isErr()
+                    ? (0, neverthrow_1.err)(scaffolded.error)
+                    : (0, neverthrow_1.ok)({ kind: "result", result: scaffolded.value });
+            }
+        }
+    }
+    // A surface that already resolved the leaf template — the CLI in non-interactive
+    // mode presets `template-name` from its `-c` capability — pins the BuildTarget by
+    // id: the Q1 selector is a *router*, so re-walking it would re-prompt. Resolve the
+    // engine from the template's route and dispatch once (no cross-phase back; INV-8).
+    const presetTemplateId = inputs[questionNames_1.QuestionNames.TemplateName];
+    if (presetTemplateId) {
+        if (snapshot === undefined && deps.resolveArtifactSnapshot !== undefined) {
+            const resolved = await deps.resolveArtifactSnapshot("templates");
+            if (resolved.isErr()) {
+                return (0, neverthrow_1.err)(resolved.error);
+            }
+            snapshot = resolved.value;
+        }
+        if (snapshot === undefined) {
+            floorBytes = (deps.readFloorBytes ?? readBundledFloorBytes)();
+        }
+        else {
+            const fullBytes = await readSnapshotBytes(snapshot, "templates");
+            if (fullBytes.isErr()) {
+                return (0, neverthrow_1.err)(fullBytes.error);
+            }
+            floorBytes = fullBytes.value;
+        }
+        const resolveByTemplateId = deps.resolveByTemplateId ?? v4_1.resolveCreateTargetByTemplateId;
+        const target = resolveByTemplateId(floorBytes, presetTemplateId);
+        if (target.isErr()) {
+            return (0, neverthrow_1.err)(target.error);
+        }
+        const dispatched = await dispatchByEngine(target.value, 0, false);
+        if (dispatched.isErr()) {
+            return (0, neverthrow_1.err)(dispatched.error);
+        }
+        // The preset path is not backable (baseStep 0, backable false), so `done` is the live branch.
+        return dispatched.value.kind === "back"
+            ? (0, neverthrow_1.err)(unexpectedPresetBack(target.value))
+            : (0, neverthrow_1.ok)(dispatched.value.result);
+    }
+    // Otherwise walk Q1 (INV-2). The selector bytes are stable across the cross-phase
+    // back re-entry loop, so resolve them once; each iteration re-walks Q1 (retaining
+    // its history for `resume`) and dispatches, re-entering Q1 on a Q2-first back so
+    // Q1 and Q2 form one continuous back-navigable wizard (INV-10). The loop is scoped
+    // below the preset check, so a prior iteration's `template-name` never short-circuits Q1.
+    if (snapshot === undefined && deps.resolveArtifactSnapshot !== undefined) {
+        const resolved = await deps.resolveArtifactSnapshot("create-selector");
+        if (resolved.isErr()) {
+            return (0, neverthrow_1.err)(resolved.error);
+        }
+        snapshot = resolved.value;
+    }
+    let selectorBytes;
+    if (snapshot === undefined) {
+        floorBytes = (deps.readFloorBytes ?? readBundledFloorBytes)();
+        selectorBytes = floorBytes;
+    }
+    else {
+        const selector = await readSnapshotBytes(snapshot, "create-selector");
+        if (selector.isErr()) {
+            return (0, neverthrow_1.err)(selector.error);
+        }
+        selectorBytes = selector.value;
+    }
+    const runSelector = deps.runSelector ?? v4_1.runCreateSelector;
+    let resumeHistory = undefined;
+    for (;;) {
+        const selectorDeps = {
+            flagReader,
+            interactive,
+            prefilled: selectorPrefillFromInputs(inputs),
+            resume: resumeHistory === undefined ? undefined : { history: resumeHistory },
+        };
+        const target = snapshot === undefined
+            ? await runSelector(selectorBytes, ui, surface, selectorDeps)
+            : await runSelector(selectorBytes, ui, surface, {
+                ...selectorDeps,
+                selectorBytesKind: "json",
+                v4Registry: deps.v4Registry,
+            });
+        if (target.isErr()) {
+            return (0, neverthrow_1.err)(target.error);
+        }
+        // Q2 continues Q1's step numbering (baseStep = promptCount) and is backable: a
+        // back at its first prompt re-enters Q1 with the retained history (INV-10).
+        const dispatched = await dispatchByEngine(target.value, target.value.promptCount, true);
+        if (dispatched.isErr()) {
+            return (0, neverthrow_1.err)(dispatched.error);
+        }
+        if (dispatched.value.kind === "back") {
+            resumeHistory = target.value.history;
+            continue;
+        }
+        return (0, neverthrow_1.ok)(dispatched.value.result);
+    }
+}
+//# sourceMappingURL=createProjectFrontDoor.js.map