@captain_z/zsk 1.6.1 → 1.8.1

package/dist/commands/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM3E,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAA2B,EAAE;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACtE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAChD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,WAAW,CAAC,MAAM,mBAAmB,CAAC,CAAC,CAAC;QACjF,CAAC;QACD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAA2B,EAAE;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACtE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAChD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC,CAAC;QACzE,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CACT;QACE,EAAE;QACF,iIAAiI;QACjI,mJAAmJ;KACpJ,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM3E,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAA2B,EAAE;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACtE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAChD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,WAAW,CAAC,MAAM,mBAAmB,CAAC,CAAC,CAAC;QACjF,CAAC;QACD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAA2B,EAAE;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACtE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAChD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC,CAAC;QACzE,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CACT;QACE,EAAE;QACF,2HAA2H;QAC3H,mJAAmJ;KACpJ,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC"}

package/dist/commands/demo.d.ts

@@ -13,6 +13,7 @@ export type McpConfigOptions = {
     write?: boolean;
 };
 export type DemoRunOptions = DemoOptions & {
+    optimized?: boolean;
     playwright?: boolean;
     computerUse?: boolean;
     hybrid?: boolean;

package/dist/commands/demo.js

@@ -1,11 +1,14 @@
 import pc from "picocolors";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
+import YAML from "yaml";
 import { resolvePath } from "../core/targets.js";
-import { checkProjectConfig, readProjectConfig } from "../core/config.js";
+import { checkProjectConfig, findModuleConfigFiles, readProjectConfig, } from "../core/config.js";
+import { getWorkspacePath, interpolateModulePath } from "../core/workspace-layout.js";
 export async function start(opts = {}) {
     const ctx = await prepare(opts);
     const now = new Date().toISOString();
+    const bridge = bridgeForMode(ctx.defaultMode, ctx.bridge);
     const session = {
         version: 1,
         id: createSessionId(now),
@@ -15,7 +18,7 @@ export async function start(opts = {}) {
         cursor: null,
         evidenceDir: ctx.evidenceDir,
         scenarioDir: ctx.scenarioDir,
-        bridge: ctx.bridge,
+        bridge,
         startedAt: now,
         updatedAt: now,
         note: opts.note,
@@ -38,14 +41,17 @@ export async function complete(opts = {}) {
     await updateExisting(opts, "completed", "complete", true);
 }
 export async function run(opts = {}) {
+    const ctx = await prepare(opts);
     const mode = opts.hybrid || (opts.computerUse && opts.playwright)
         ? "hybrid"
-        : opts.computerUse
-            ? "computer-use"
-            : opts.playwright
-                ? "playwright"
-                : "script";
-    const ctx = await prepare(opts);
+        : opts.optimized
+            ? "optimized"
+            : opts.computerUse
+                ? "computer-use"
+                : opts.playwright
+                    ? "playwright"
+                    : ctx.defaultMode;
+    const bridge = bridgeForMode(mode, ctx.bridge);
     const existing = await readSession(ctx);
     const now = new Date().toISOString();
     const session = existing ?? {
@@ -57,14 +63,14 @@ export async function run(opts = {}) {
         cursor: null,
         evidenceDir: ctx.evidenceDir,
         scenarioDir: ctx.scenarioDir,
-        bridge: ctx.bridge,
+        bridge,
         startedAt: now,
         updatedAt: now,
         events: [],
     };
     session.status = "running";
     session.mode = mode;
-    session.bridge = ctx.bridge;
+    session.bridge = bridge;
     session.updatedAt = now;
     session.note = opts.note ?? session.note;
     session.events.push({
@@ -72,12 +78,17 @@ export async function run(opts = {}) {
         type: `run:${mode}`,
         note: opts.note ?? automationNote(mode),
     });
-    await persistSession(ctx, session);
     if (mode === "hybrid")
         await ensureBridgeArtifacts(ctx, session);
+    if (mode === "optimized")
+        await ensureOptimizedArtifacts(ctx, session);
+    await persistSession(ctx, session);
     console.log(pc.green(`✓ zsk demo run prepared (${mode})`));
+    if (mode === "optimized") {
+        console.log(pc.dim("optimized: raw testing inputs -> test-plan.json -> Playwright spec; no MCP or bridge fallback."));
+    }
     if (mode === "computer-use") {
-        console.log(pc.yellow("! Computer Use is an explicit visual/system fallback; record why Playwright or Browser Use was insufficient."));
+        console.log(pc.yellow("! Computer Use is the preferred visual/system observation lane when available; record fallback if the runtime does not provide it."));
     }
     if (mode === "hybrid") {
         console.log(pc.dim("bridge: configured decision tool understands/chooses operations; Playwright executes and records when feasible."));
@@ -88,7 +99,7 @@ export async function run(opts = {}) {
             console.log(pc.dim(`execution: ${session.bridge.executionFile}`));
         }
     }
-    if (mode === "playwright" || mode === "hybrid") {
+    if (mode === "playwright" || mode === "hybrid" || mode === "optimized") {
         console.log(pc.dim(`scenario dir: ${session.scenarioDir}`));
     }
     printSession(session);
@@ -159,16 +170,16 @@ export async function scenarioGenerate(opts = {}) {
         version: 1,
         module: ctx.moduleId,
         inputs: {
-            testCase: opts.testCase ?? "TODO: map .raws/testing test case",
+            testCase: opts.testCase ?? "unmapped .zsk/raws/qa/testing test case",
             prdRefs: [],
             specRefs: [],
             designRefs: [],
             taskRefs: [],
             pageStructure: {
                 kind: snapshot ? "aria_snapshot" : "playwright_mcp",
-                source: opts.snapshot ?? "TODO: Playwright MCP observation id, Browser Use handoff, or snapshot path",
+                source: opts.snapshot ?? "unmapped accessibility snapshot, Computer Use observation, or compatible handoff",
             },
-            browserUseHandoff: "TODO: optional Browser Use handoff path",
+            uiObservationHandoff: "optional Computer Use, Playwright MCP/ARIA/CDP, documented manual evidence, or supported Browser Use handoff path",
         },
         output: {
             playwrightSpec: `${ctx.scenarioDir}/${generatedName}.spec.ts`,
@@ -181,8 +192,9 @@ export async function scenarioGenerate(opts = {}) {
         ``,
         `test.describe("${ctx.moduleId} synthesized scenarios", () => {`,
         `  test("${escapeForDoubleQuotedString(opts.name ?? "generated from test case and aria snapshot")}", async ({ page }) => {`,
-        `    test.skip(!process.env.ZSK_DEMO_BASE_URL, "Set ZSK_DEMO_BASE_URL to run this scenario.");`,
-        `    await page.goto(process.env.ZSK_DEMO_BASE_URL);`,
+        `    const baseUrl = process.env.ZSK_DEMO_BASE_URL;`,
+        `    if (!baseUrl) throw new Error("Set ZSK_DEMO_BASE_URL to run this scenario.");`,
+        `    await page.goto(baseUrl);`,
         ``,
         ...generatedSteps.map((step) => `    ${step}`),
         `  });`,
@@ -247,31 +259,28 @@ async function prepare(opts) {
     }
     const config = await readProjectConfig(target);
     const demoConfig = config.automation?.demo;
-    const issueRoot = config.paths?.issues ?? ".issues";
-    const docsRoot = config.paths?.docs ?? "docs";
-    const evidenceDir = interpolate(demoConfig?.evidenceDir ?? `${issueRoot}/{module}/demo/_evidence`, moduleId);
-    const scenarioDir = interpolate(demoConfig?.scenarioDir ?? `${docsRoot}/{module}/scenarios`, moduleId);
-    const bridgePlan = interpolate(demoConfig?.bridge?.planFile ?? `.zsk/demo-sessions/{module}/operation-plan.json`, moduleId);
-    const bridgeExecution = interpolate(demoConfig?.bridge?.executionFile ?? `.zsk/demo-sessions/{module}/playwright-execution.json`, moduleId);
-    const sessionRoot = resolve(target, ".zsk", "demo-sessions", moduleId);
+    const evidenceDir = interpolate(demoConfig?.evidenceDir ?? getWorkspacePath(config, "demoEvidence", { module: moduleId }), moduleId);
+    const scenarioDir = interpolate(demoConfig?.scenarioDir ?? getWorkspacePath(config, "playwrightSpecs", { module: moduleId }), moduleId);
+    const bridgePlan = interpolate(demoConfig?.bridge?.planFile ?? getWorkspacePath(config, "bridgeOperationPlan", { module: moduleId }), moduleId);
+    const bridgeExecution = interpolate(demoConfig?.bridge?.executionFile ?? getWorkspacePath(config, "bridgeExecution", { module: moduleId }), moduleId);
+    const sessionRoot = resolve(target, getWorkspacePath(config, "playwrightExecution", { module: moduleId }));
     await mkdir(sessionRoot, { recursive: true });
     await mkdir(resolve(target, evidenceDir), { recursive: true });
     await mkdir(resolve(target, scenarioDir), { recursive: true });
-    await mkdir(resolve(target, bridgePlan, ".."), { recursive: true });
-    await mkdir(resolve(target, bridgeExecution, ".."), { recursive: true });
     return {
         target,
         moduleId,
         config,
         sessionFile: join(sessionRoot, "current.json"),
-        workflowStateFile: resolve(target, ".zsk", "workflow-state.json"),
+        workflowStateFile: resolve(target, getWorkspacePath(config, "workflowState")),
         evidenceDir,
         evidenceDirAbs: resolve(target, evidenceDir),
         scenarioDir,
         scenarioDirAbs: resolve(target, scenarioDir),
+        playwrightAuthState: getWorkspacePath(config, "playwrightAuthState", { module: moduleId }),
         defaultMode: normalizeMode(demoConfig?.defaultMode),
         bridge: {
-            decisionTool: demoConfig?.bridge?.decisionTool ?? "playwright_mcp",
+            decisionTool: demoConfig?.bridge?.decisionTool ?? (demoConfig?.computerUse?.enabled ? "computer_use" : "playwright_mcp"),
             executionTool: demoConfig?.bridge?.executionTool ?? "playwright",
             planFile: bridgePlan,
             executionFile: bridgeExecution,
@@ -311,15 +320,15 @@ async function ensureBridgeArtifacts(ctx, session) {
         functionPoint: session.cursor ?? "next-demo-function-point",
         observation: {
             source: observationSourceForDecisionTool(session.bridge.decisionTool),
-            summary: "TODO: fill from Playwright MCP aria snapshot, Browser Use session note, or Computer Use observation.",
+            summary: "Fill from Computer Use observation, Playwright MCP/ARIA/CDP handoff, documented manual evidence, or supported Browser Use note before execution.",
             rawRef: "",
         },
         operation: {
-            intent: "TODO: describe next demo operation.",
+            intent: "Describe next demo operation before execution.",
             locator: {
                 kind: "role",
                 role: "button",
-                name: "TODO",
+                name: "Unspecified",
             },
             action: {
                 type: "click",
@@ -353,6 +362,275 @@ async function ensureBridgeArtifacts(ctx, session) {
         updatedAt: now,
     });
 }
+async function ensureOptimizedArtifacts(ctx, session) {
+    const moduleConfig = await readModuleConfig(ctx.target, ctx.moduleId);
+    const rawInputs = [
+        ...(moduleConfig.tests?.raw_cases ?? []),
+        ...((moduleConfig.tests?.raw_cases?.length ?? 0) > 0 ? [] : (moduleConfig.sources?.testing ?? [])),
+    ];
+    if (rawInputs.length === 0) {
+        console.error(pc.red("✗ optimized demo stopped: no raw testing inputs mapped"));
+        console.error(pc.dim("Add .zsk/raws/qa/testing cases to .zsk/modules/{module}/module.yaml tests.raw_cases or sources.testing."));
+        process.exit(1);
+    }
+    const testPlanRel = chooseTestPlanPath(moduleConfig, ctx.scenarioDir);
+    const specRel = chooseSpecPath(moduleConfig, ctx.scenarioDir, ctx.moduleId);
+    const now = new Date().toISOString();
+    const authValidation = await validatePlaywrightAuthState(ctx.target, ctx.playwrightAuthState, now);
+    if (authValidation.status === "invalid") {
+        console.error(pc.red(`✗ optimized demo stopped: invalid Playwright storageState at ${ctx.playwrightAuthState}`));
+        console.error(pc.dim(authValidation.message));
+        process.exit(1);
+    }
+    session.auth = authValidation;
+    const cases = [];
+    for (const rawInput of rawInputs) {
+        const rawPath = resolve(ctx.target, rawInput);
+        const content = await readOptional(rawPath);
+        if (!content.trim()) {
+            console.error(pc.red(`✗ optimized demo stopped: raw testing input is empty or missing: ${rawInput}`));
+            process.exit(1);
+        }
+        const title = inferScenarioName(content) ?? rawInput.split("/").pop()?.replace(/\.[^.]+$/, "") ?? "generated case";
+        const fillValue = inferFillValue(content);
+        const expectedText = inferExpectedText(content, fillValue);
+        const caseId = slugify(`${ctx.moduleId}-${title}`);
+        const steps = [
+            {
+                id: "step-1",
+                intent: "Open the demo entry page",
+                action: "goto",
+                target: "{{baseUrl}}",
+            },
+            {
+                id: "step-2",
+                intent: "Perform the primary user input from the raw test case",
+                action: "fill",
+                locator: {
+                    strategy: "role",
+                    role: "textbox",
+                },
+                value: fillValue,
+            },
+            {
+                id: "step-3",
+                intent: "Submit or advance the flow",
+                action: "click",
+                locator: {
+                    strategy: "role",
+                    role: "button",
+                },
+            },
+            {
+                id: "step-4",
+                intent: "Verify the expected visible result",
+                action: "assert",
+                locator: {
+                    strategy: "text",
+                    text: expectedText,
+                },
+            },
+        ];
+        cases.push({
+            id: caseId,
+            title,
+            source: rawInput,
+            priority: "P0",
+            preconditions: [
+                "Raw test case is mapped in module.yaml.",
+                `If authentication is required, Playwright storageState is prepared under ${ctx.playwrightAuthState} and gitignored.`,
+                "Computer Use observation is preferred for visual/current-page refinement when available; otherwise use Playwright MCP/ARIA/CDP, manual evidence, or Browser Use only in runtimes that support it.",
+            ],
+            uiObservationBoundary: {
+                role: "observation-only",
+                allowedOutput: "structured observation with URL, page title, visible targets, role/label hints, auth/session note, and privacy note",
+                prohibitedOutputs: ["test-plan.json", ".spec.ts"],
+            },
+            steps,
+            assertions: [
+                {
+                    intent: "Expected result from raw test case is visible",
+                    type: "visible",
+                    locator: {
+                        strategy: "text",
+                        text: expectedText,
+                    },
+                },
+            ],
+            risks: [
+                "Generated locator names must be refined from Computer Use, Playwright MCP/ARIA/CDP, manual evidence, or supported Browser Use observation before promotion.",
+                "Do not fall back to Playwright MCP or the hybrid bridge in optimized mode.",
+            ],
+        });
+    }
+    await writeJson(resolve(ctx.target, testPlanRel), {
+        version: 1,
+        mode: "optimized",
+        module: ctx.moduleId,
+        session: session.id,
+        generatedAt: now,
+        toolchain: ["ui-observation", "playwright-cli", "playwright-skills", "playwright-test"],
+        forbiddenSurfaces: ["playwright_mcp", "hybrid_bridge"],
+        sources: {
+            testing: rawInputs,
+        },
+        auth: {
+            storageState: ctx.playwrightAuthState,
+            validation: authValidation,
+            gitignoreRequired: true,
+            runtimeEnv: "ZSK_PLAYWRIGHT_STORAGE_STATE",
+            note: authValidation.status === "valid"
+                ? "Storage state was validated as a reusable Playwright login/session state. It may contain sensitive cookies/localStorage and must not be committed."
+                : "No reusable storageState file was found. Public demos may proceed; authenticated demos must capture and validate storageState before completion.",
+        },
+        uiObservationHandoff: {
+            requiredBeforePromotion: true,
+            writesRepoArtifacts: false,
+            expectedShape: {
+                url: "",
+                title: "",
+                humanGoal: "",
+                visibleTargets: [],
+                locatorHints: [],
+                authSessionNote: "",
+                privacyNote: "",
+            },
+        },
+        output: {
+            playwrightSpec: specRel,
+            evidenceDir: session.evidenceDir,
+        },
+        cases,
+    });
+    const specPath = resolve(ctx.target, specRel);
+    await mkdir(resolve(specPath, ".."), { recursive: true });
+    await writeFile(specPath, renderOptimizedSpec(ctx.moduleId, cases), "utf8");
+    console.log(pc.dim(`test plan: ${testPlanRel}`));
+    console.log(pc.dim(`spec: ${specRel}`));
+}
+async function readModuleConfig(target, moduleId) {
+    const config = await readProjectConfig(target);
+    const moduleFiles = await findModuleConfigFiles(target, config);
+    for (const file of moduleFiles) {
+        const parsed = YAML.parse(await readFile(file, "utf8"));
+        if (isModuleConfig(parsed) && parsed.module?.id === moduleId)
+            return parsed;
+    }
+    console.error(pc.red(`✗ optimized demo stopped: module config not found for ${moduleId}`));
+    process.exit(1);
+}
+function chooseTestPlanPath(moduleConfig, scenarioDir) {
+    return (moduleConfig.tests?.derived_cases?.find((entry) => entry.endsWith(".json")) ??
+        join(scenarioDir, "test-plan.json"));
+}
+function chooseSpecPath(moduleConfig, scenarioDir, moduleId) {
+    const e2e = moduleConfig.tests?.automated?.e2e?.[0];
+    if (e2e?.endsWith(".ts"))
+        return e2e;
+    return join(e2e ?? scenarioDir, `${moduleId}-generated.spec.ts`);
+}
+function renderOptimizedSpec(moduleId, cases) {
+    const lines = [
+        `import { test, expect } from "@playwright/test";`,
+        ``,
+        `const storageState = process.env.ZSK_PLAYWRIGHT_STORAGE_STATE;`,
+        `if (storageState) test.use({ storageState });`,
+        ``,
+        `test.describe("${escapeForDoubleQuotedString(moduleId)} optimized demo scenarios", () => {`,
+    ];
+    for (const testCase of cases) {
+        const fill = testCase.steps.find((step) => step.action === "fill");
+        const click = testCase.steps.find((step) => step.action === "click");
+        const assertion = testCase.steps.find((step) => step.action === "assert");
+        lines.push(`  test("${escapeForDoubleQuotedString(testCase.title)}", async ({ page }) => {`, `    const baseUrl = process.env.ZSK_DEMO_BASE_URL;`, `    if (!baseUrl) throw new Error("Set ZSK_DEMO_BASE_URL to run this scenario.");`, `    await page.goto(baseUrl);`, ``, `    // Source: ${escapeForLineComment(testCase.source)}`, `    // ZSK_GENERATED_REFINEMENT_REQUIRED: refine locator names from Computer Use, Playwright MCP/ARIA/CDP, manual evidence, or compatible Browser Use before promotion.`);
+        if (fill?.locator?.role && fill.value) {
+            lines.push(`    await ${renderRoleLocator(fill.locator.role, fill.locator.name)}.fill(${quote(fill.value)});`);
+        }
+        if (click?.locator?.role) {
+            lines.push(`    await ${renderRoleLocator(click.locator.role, click.locator.name)}.click();`);
+        }
+        if (assertion?.locator?.text) {
+            lines.push(`    await expect(page.getByText(${quote(assertion.locator.text)})).toBeVisible();`);
+        }
+        else {
+            lines.push(`    await expect(page).toHaveURL(/.+/);`);
+        }
+        lines.push(`  });`, ``);
+    }
+    lines.push(`});`, ``);
+    return lines.join("\n");
+}
+async function validatePlaywrightAuthState(target, storageState, validatedAt) {
+    const file = resolve(target, storageState);
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(file, "utf8"));
+    }
+    catch (error) {
+        const code = typeof error === "object" && error !== null && "code" in error
+            ? String(error.code)
+            : "";
+        if (code === "ENOENT") {
+            return {
+                storageState,
+                status: "missing",
+                validatedAt,
+                cookies: 0,
+                origins: 0,
+                message: "storageState file does not exist yet",
+            };
+        }
+        return {
+            storageState,
+            status: "invalid",
+            validatedAt,
+            cookies: 0,
+            origins: 0,
+            message: "storageState file is not valid JSON",
+        };
+    }
+    if (!isRecord(parsed)) {
+        return {
+            storageState,
+            status: "invalid",
+            validatedAt,
+            cookies: 0,
+            origins: 0,
+            message: "storageState JSON must be an object",
+        };
+    }
+    const cookies = Array.isArray(parsed.cookies) ? parsed.cookies.length : -1;
+    const origins = Array.isArray(parsed.origins) ? parsed.origins.length : -1;
+    if (cookies < 0 || origins < 0) {
+        return {
+            storageState,
+            status: "invalid",
+            validatedAt,
+            cookies: Math.max(cookies, 0),
+            origins: Math.max(origins, 0),
+            message: "storageState must include Playwright cookies and origins arrays",
+        };
+    }
+    if (cookies === 0 && origins === 0) {
+        return {
+            storageState,
+            status: "invalid",
+            validatedAt,
+            cookies,
+            origins,
+            message: "storageState contains no cookies or localStorage origins, so it cannot prove reusable login/session credentials",
+        };
+    }
+    return {
+        storageState,
+        status: "valid",
+        validatedAt,
+        cookies,
+        origins,
+        message: "storageState is parseable and contains reusable session material",
+        loginBypassEvidence: "Generated Playwright specs can reuse this state through ZSK_PLAYWRIGHT_STORAGE_STATE.",
+    };
+}
 async function updateWorkflowState(file, moduleId, session) {
     let state = { version: 1, modules: {} };
     try {
@@ -389,17 +667,18 @@ function createSessionId(now) {
     return `demo-${now.replace(/[-:.TZ]/g, "").slice(0, 14)}`;
 }
 function interpolate(value, moduleId) {
-    return value.split("{module}").join(moduleId);
+    return interpolateModulePath(value, moduleId);
 }
 function normalizeMode(value) {
     if (value === "manual" ||
         value === "script" ||
+        value === "optimized" ||
         value === "playwright" ||
         value === "computer-use" ||
         value === "hybrid") {
         return value;
     }
-    return "hybrid";
+    return "optimized";
 }
 function mapWorkflowStatus(status) {
     if (status === "completed")
@@ -407,14 +686,19 @@ function mapWorkflowStatus(status) {
     return status;
 }
 function automationNote(mode) {
+    if (mode === "optimized")
+        return "Generated test-plan.json and Playwright spec from raw testing inputs.";
     if (mode === "playwright")
         return "Prepared Playwright demo run and scenario preservation paths.";
     if (mode === "hybrid")
         return "Prepared decision-tool -> Playwright bridge run.";
     if (mode === "computer-use")
-        return "Prepared explicit computer-use fallback run.";
+        return "Prepared explicit Computer Use observation run with compatible fallback evidence if unavailable.";
     return "Prepared scripted demo run.";
 }
+function bridgeForMode(mode, bridge) {
+    return mode === "hybrid" ? bridge : undefined;
+}
 function observationSourceForDecisionTool(decisionTool) {
     if (decisionTool === "playwright_mcp")
         return "aria_snapshot";
@@ -486,11 +770,16 @@ function synthesizePlaywrightSteps(targets, testCase) {
         steps.push(`await expect(page).toHaveURL(/.+/);`);
     }
     else {
-        steps.push(`// TODO: Provide a Playwright MCP aria snapshot to synthesize role-first locators.`);
+        steps.push(`// Provide a Playwright accessibility snapshot to synthesize role-first locators.`);
         steps.push(`await expect(page).toHaveURL(/.+/);`);
     }
     return steps;
 }
+function renderRoleLocator(role, name) {
+    if (name)
+        return `page.getByRole(${quote(role)}, { name: ${quote(name)} })`;
+    return `page.getByRole(${quote(role)}).first()`;
+}
 function normalizeRole(role) {
     if (role === "textbox")
         return "textbox";
@@ -530,4 +819,20 @@ function quote(value) {
 function escapeForDoubleQuotedString(value) {
     return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
 }
+function escapeForLineComment(value) {
+    return value.replace(/\*\//g, "* /").replace(/\n/g, " ");
+}
+function inferExpectedText(testCase, fallback) {
+    const expected = testCase.match(/(?:expect|should see|visible|断言|期望|显示|可见)\s*[:：]?\s*["“”']?([^"“”'\n。]{2,80})/i);
+    if (expected?.[1])
+        return expected[1].trim();
+    const quoted = [...testCase.matchAll(/["“”']([^"“”']{2,80})["“”']/g)].map((match) => match[1]).filter(Boolean);
+    return quoted.at(-1) ?? fallback;
+}
+function isModuleConfig(value) {
+    return typeof value === "object" && value !== null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 //# sourceMappingURL=demo.js.map