@ir-kit/k6-toolkit 0.1.0

package/dist/scaffold/cli-handler.js

@@ -0,0 +1,204 @@
+import { existsSync, mkdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, relative, resolve } from "node:path";
+import { intro, log, outro } from "@clack/prompts";
+import { loadSpec } from "@ir-kit/openapi-tools";
+import { parseSpec } from "@ir-kit/openapi-tools/parse";
+import { scaffoldScenario, } from "./scenario.js";
+import { readSpecOperations } from "./spec-tags.js";
+import { confirmOverwrite, runScenarioWizard } from "./wizard.js";
+const HELP = `
+k6-ts scaffold — generate scenario files from your OpenAPI spec.
+
+USAGE
+  k6-ts scaffold                            # interactive wizard
+  k6-ts scaffold list-ops [--json]          # discover ops (grouped by tag)
+  k6-ts scaffold [flags…]                   # flag-driven, single scenario
+  k6-ts scaffold --tags <a,b,c> [flags…]    # batch — one scenario per tag
+
+REQUIRED (flag mode)
+  --name <slug>                Scenario name (used for filename + step label)
+  --ops <a,b,c>                Comma-separated operation IDs
+
+OPTIONAL
+  --spec <path-or-url>         OpenAPI spec. Default: ./openapi.yaml
+  --client-import <path>       Import path for the generated client.
+                               Default: ./src/gen/index.js
+  --chain sequential|batch     Default: sequential
+  --pace smoke|load|stress|spike|soak     Default: smoke
+  --duration <duration>        Default: 30s (or 1h for soak)
+  --auth none|bearer|basic|apiKey|session|digest|ntlm    Default: none
+  --output <file>              Where to write (single scenario)
+  --output-dir <dir>           Where to write (batch mode)
+  --force                      Overwrite without prompting
+  --help                       Show this help
+
+BATCH MODE (--tags)
+  Generates one scenario file per tag, named after the tag. Each picks all
+  operations carrying that tag with sensible defaults (smoke, sequential).
+`.trim();
+function parseArgs(argv) {
+    if (argv[0] === "list-ops") {
+        return {
+            kind: "list-ops",
+            spec: pickFlag(argv, "--spec") ?? "./openapi.yaml",
+            json: argv.includes("--json"),
+        };
+    }
+    return {
+        kind: "flags",
+        name: pickFlag(argv, "--name"),
+        ops: pickFlag(argv, "--ops"),
+        tags: pickFlag(argv, "--tags"),
+        spec: pickFlag(argv, "--spec") ?? "./openapi.yaml",
+        clientImport: pickFlag(argv, "--client-import") ?? "./src/gen/index.js",
+        chain: pickFlag(argv, "--chain") ?? "sequential",
+        pace: pickFlag(argv, "--pace") ?? "smoke",
+        duration: pickFlag(argv, "--duration"),
+        auth: pickFlag(argv, "--auth") ?? "none",
+        output: pickFlag(argv, "--output"),
+        outputDir: pickFlag(argv, "--output-dir"),
+        force: argv.includes("--force"),
+        showHelp: argv.includes("--help") || argv.includes("-h"),
+    };
+}
+function pickFlag(argv, name) {
+    const i = argv.indexOf(name);
+    if (i === -1)
+        return undefined;
+    return argv[i + 1];
+}
+export async function runScaffoldCommand(argv) {
+    const parsed = parseArgs(argv);
+    if (parsed.kind === "flags" && parsed.showHelp) {
+        console.log(HELP);
+        return;
+    }
+    // list-ops subcommand — no I/O beyond stdout
+    if (parsed.kind === "list-ops") {
+        await listOps(parsed);
+        return;
+    }
+    const spec = await loadAndIndexSpec(parsed.spec);
+    // Batch mode: --tags <a,b,c>
+    if (parsed.tags) {
+        await scaffoldByTags(spec, parsed);
+        return;
+    }
+    // Flag mode (non-interactive): --name + --ops required
+    if (parsed.name && parsed.ops) {
+        await scaffoldFromFlags(spec, parsed);
+        return;
+    }
+    // Interactive — no name/ops/tags
+    await scaffoldInteractive(spec, parsed);
+}
+async function loadAndIndexSpec(specPath) {
+    const bundled = await loadSpec({ input: specPath, normalize: true });
+    const ir = parseSpec(bundled);
+    return readSpecOperations(ir.paths);
+}
+async function listOps(parsed) {
+    const spec = await loadAndIndexSpec(parsed.spec);
+    if (parsed.json) {
+        const byTag = {};
+        for (const [tag, ops] of spec.byTag) {
+            byTag[tag] = ops.map((o) => o.id);
+        }
+        console.log(JSON.stringify({ byTag, total: spec.all.length }, null, 2));
+        return;
+    }
+    for (const [tag, ops] of spec.byTag) {
+        console.log(`\n${tag}  (${ops.length} ops)`);
+        for (const op of ops) {
+            console.log(`  ${op.method.toUpperCase().padEnd(6)} ${op.path}  ·  ${op.id}`);
+        }
+    }
+    console.log(`\n${spec.all.length} total ops`);
+}
+async function scaffoldFromFlags(spec, parsed) {
+    const opIds = parsed
+        .ops.split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const ops = opIds
+        .map((id) => spec.byId.get(id))
+        .filter((o) => Boolean(o));
+    if (ops.length !== opIds.length) {
+        const missing = opIds.filter((id) => !spec.byId.has(id));
+        console.error(`k6-ts scaffold: unknown operationId(s): ${missing.join(", ")}`);
+        process.exit(2);
+    }
+    const slug = parsed.name.trim().replace(/[^a-zA-Z0-9-]+/g, "-");
+    const output = parsed.output ?? `${parsed.outputDir ?? "./loadtests"}/${slug}.ts`;
+    const scaffold = {
+        clientImportPath: parsed.clientImport,
+        pace: parsed.pace,
+        duration: parsed.duration,
+        ops,
+        chain: parsed.chain,
+        auth: { auth: parsed.auth },
+    };
+    await writeScenario(output, scaffold, parsed.force);
+    console.log(`Wrote ${relative(process.cwd(), output)}`);
+}
+async function scaffoldByTags(spec, parsed) {
+    const tags = parsed
+        .tags.split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const outputDir = parsed.outputDir ?? "./loadtests";
+    const force = parsed.force;
+    for (const tag of tags) {
+        const ops = spec.byTag.get(tag);
+        if (!ops || ops.length === 0) {
+            console.error(`k6-ts scaffold: no operations under tag "${tag}"`);
+            continue;
+        }
+        const slug = tag.replace(/[^a-zA-Z0-9-]+/g, "-");
+        const output = `${outputDir}/${slug}.ts`;
+        await writeScenario(output, {
+            clientImportPath: parsed.clientImport,
+            pace: parsed.pace,
+            duration: parsed.duration,
+            ops,
+            chain: parsed.chain,
+            auth: { auth: parsed.auth },
+        }, force);
+        console.log(`Wrote ${relative(process.cwd(), output)}  (${ops.length} ops)`);
+    }
+}
+async function scaffoldInteractive(spec, parsed) {
+    intro("k6-ts scaffold");
+    const result = await runScenarioWizard(spec, {
+        clientImportPath: parsed.clientImport,
+        outputDir: parsed.outputDir ?? "./loadtests",
+    });
+    if (!result)
+        return;
+    await writeScenario(result.outputPath, result.scaffold, parsed.force);
+    outro([
+        `Wrote ${relative(process.cwd(), result.outputPath)}`,
+        `Run it: k6-ts run ${relative(process.cwd(), result.outputPath)}`,
+    ].join("\n"));
+}
+async function writeScenario(output, scaffold, force) {
+    const absolute = resolve(output);
+    if (existsSync(absolute) && !force) {
+        const ok = await confirmOverwrite(relative(process.cwd(), absolute));
+        if (!ok) {
+            log.warn(`Skipped ${relative(process.cwd(), absolute)}`);
+            return;
+        }
+    }
+    const content = scaffoldScenario(scaffold);
+    mkdirSync(dirname(absolute), { recursive: true });
+    writeFileSync(absolute, content, "utf8");
+    ensureFile(absolute);
+}
+function ensureFile(absolute) {
+    const s = statSync(absolute);
+    if (!s.isFile())
+        throw new Error(`expected a file at ${absolute}`);
+}
+export { HELP as SCAFFOLD_HELP };
+//# sourceMappingURL=cli-handler.js.map

package/dist/scaffold/cli-handler.js.map

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

package/dist/scaffold/scenario.d.ts

@@ -0,0 +1,34 @@
+import type { WalkedOperation } from "@ir-kit/k6-gen";
+import { type AuthFlavor, type AuthScaffoldOpts } from "../loadtest-scaffold.js";
+import { type ChainMode } from "./chains.js";
+export type PacePreset = "smoke" | "load" | "stress" | "spike" | "soak";
+export interface ScaffoldScenarioOpts {
+    /** Relative import path for the generated client (`./src/gen/index.js`). */
+    clientImportPath: string;
+    /** Pace preset selector. */
+    pace: PacePreset;
+    /** Duration string passed to the pace preset. Default `"30s"`. */
+    duration?: string;
+    /** Operations to compose into a flow. Empty → placeholder `flow().step("health", ...)`. */
+    ops: ReadonlyArray<WalkedOperation>;
+    /** How to compose the ops. */
+    chain: ChainMode;
+    /** Pass/fail thresholds. */
+    budgets?: {
+        p95?: string;
+        p99?: string;
+        errors?: string;
+        /** Per-operation budgets keyed by operationId. */
+        ops?: Record<string, {
+            p95?: string;
+            p99?: string;
+            errors?: string;
+        }>;
+    };
+    /** Auth recipe. Omit / "none" → no auth. */
+    auth?: AuthScaffoldOpts;
+}
+/** Render a complete standalone scenario `.ts` file as a string. */
+export declare function scaffoldScenario(opts: ScaffoldScenarioOpts): string;
+export type { AuthFlavor };
+//# sourceMappingURL=scenario.d.ts.map

package/dist/scaffold/scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../src/scaffold/scenario.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EAGtB,MAAM,yBAAyB,CAAC;AAQjC,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAIlE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,GAAG,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACpC,8BAA8B;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,4BAA4B;IAC5B,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kDAAkD;QAClD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACvE,CAAC;IACF,4CAA4C;IAC5C,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAkBnE;AAgFD,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/scaffold/scenario.js

@@ -0,0 +1,67 @@
+import ts from "typescript";
+import { namespaceImport } from "../ast-imports.js";
+import { authVarDecl, k6FrameworkImport, } from "../loadtest-scaffold.js";
+import { printStatements } from "../print.js";
+import { defaultExportProp, objLit, reExportConst, varConst, } from "./ast-helpers.js";
+import { buildFlowExpression } from "./chains.js";
+const f = ts.factory;
+/** Render a complete standalone scenario `.ts` file as a string. */
+export function scaffoldScenario(opts) {
+    const symbols = ["defineLoadTest", "flow", opts.pace];
+    if (opts.chain === "batch" && opts.ops.length > 1)
+        symbols.push("batch");
+    if (opts.auth && opts.auth.auth !== "none")
+        symbols.push("useAuth");
+    const stmts = [
+        k6FrameworkImport(symbols),
+        namespaceImport("api", opts.clientImportPath),
+    ];
+    const hasAuth = opts.auth && opts.auth.auth !== "none";
+    if (hasAuth)
+        stmts.push(authVarDecl(opts.auth));
+    stmts.push(loadtestDecl(opts, hasAuth ?? false));
+    stmts.push(reExportConst("options", "lt", "options"));
+    stmts.push(defaultExportProp("lt", "default"));
+    return printStatements(stmts);
+}
+function loadtestDecl(opts, hasAuth) {
+    const props = [];
+    if (hasAuth) {
+        props.push(f.createPropertyAssignment("use", f.createArrayLiteralExpression([f.createIdentifier("auth")])));
+    }
+    props.push(scenarioEntry(opts.pace, opts.duration ?? "30s"));
+    props.push(budgetsEntry(opts.budgets));
+    props.push(f.createPropertyAssignment("flow", buildFlowExpression(opts.ops, opts.chain)));
+    return varConst("lt", f.createCallExpression(f.createIdentifier("defineLoadTest"), undefined, [
+        f.createObjectLiteralExpression(props, true),
+    ]));
+}
+function scenarioEntry(pace, duration) {
+    return f.createPropertyAssignment("scenario", f.createCallExpression(f.createIdentifier(pace), undefined, [
+        objLit({ duration: f.createStringLiteral(duration) }),
+    ]));
+}
+function budgetsEntry(budgets) {
+    const top = {
+        p95: f.createStringLiteral(budgets?.p95 ?? "500ms"),
+        errors: f.createStringLiteral(budgets?.errors ?? "1%"),
+    };
+    if (budgets?.p99)
+        top.p99 = f.createStringLiteral(budgets.p99);
+    const opsEntries = Object.entries(budgets?.ops ?? {});
+    if (opsEntries.length > 0) {
+        top.ops = f.createObjectLiteralExpression(opsEntries.map(([opId, b]) => f.createPropertyAssignment(opId, opBudgetObj(b))), true);
+    }
+    return f.createPropertyAssignment("budgets", objLit(top, true));
+}
+function opBudgetObj(b) {
+    const props = {};
+    if (b.p95)
+        props.p95 = f.createStringLiteral(b.p95);
+    if (b.p99)
+        props.p99 = f.createStringLiteral(b.p99);
+    if (b.errors)
+        props.errors = f.createStringLiteral(b.errors);
+    return objLit(props);
+}
+//# sourceMappingURL=scenario.js.map

package/dist/scaffold/scenario.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.js","sourceRoot":"","sources":["../../src/scaffold/scenario.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAGL,WAAW,EACX,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,aAAa,EACb,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAkB,MAAM,aAAa,CAAC;AAElE,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;AA2BrB,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,IAA0B;IACzD,MAAM,OAAO,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzE,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEpE,MAAM,KAAK,GAAmB;QAC5B,iBAAiB,CAAC,OAAO,CAAC;QAC1B,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC;KAC9C,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;IACvD,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAK,CAAC,CAAC,CAAC;IAEjD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAE/C,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,YAAY,CACnB,IAA0B,EAC1B,OAAgB;IAEhB,MAAM,KAAK,GAA4B,EAAE,CAAC;IAE1C,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CACR,CAAC,CAAC,wBAAwB,CACxB,KAAK,EACL,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAC7D,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CACR,CAAC,CAAC,wBAAwB,CACxB,MAAM,EACN,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAC1C,CACF,CAAC;IAEF,OAAO,QAAQ,CACb,IAAI,EACJ,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE;QACtE,CAAC,CAAC,6BAA6B,CAAC,KAAK,EAAE,IAAI,CAAC;KAC7C,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,IAAgB,EAChB,QAAgB;IAEhB,OAAO,CAAC,CAAC,wBAAwB,CAC/B,UAAU,EACV,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE;QAC1D,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;KACtD,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,OAAwC;IAExC,MAAM,GAAG,GAAkC;QACzC,GAAG,EAAE,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC;QACnD,MAAM,EAAE,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC;KACvD,CAAC;IACF,IAAI,OAAO,EAAE,GAAG;QAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAE/D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,6BAA6B,CACvC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAC3B,CAAC,CAAC,wBAAwB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CACjD,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,CAAC,wBAAwB,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,WAAW,CAAC,CAIpB;IACC,MAAM,KAAK,GAAkC,EAAE,CAAC;IAChD,IAAI,CAAC,CAAC,GAAG;QAAE,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,CAAC,GAAG;QAAE,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,CAAC,MAAM;QAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/scaffold/spec-tags.d.ts

@@ -0,0 +1,15 @@
+import { type WalkedOperation } from "@ir-kit/k6-gen";
+import type { IR } from "@ir-kit/openapi-tools";
+/** Tag-bucketed view of a spec's operations — `"_untagged"` collects ops with no tag. */
+export interface SpecOperations {
+    /** Tag name → ops; ops are also referenced by `byId`. */
+    byTag: ReadonlyMap<string, ReadonlyArray<WalkedOperation>>;
+    /** Operation ID → op. Flat lookup for the wizard / flag mode. */
+    byId: ReadonlyMap<string, WalkedOperation>;
+    /** Every op in spec order. */
+    all: ReadonlyArray<WalkedOperation>;
+}
+declare const UNTAGGED = "_untagged";
+export declare function readSpecOperations(paths: IR.PathsObject | undefined): SpecOperations;
+export { UNTAGGED };
+//# sourceMappingURL=spec-tags.d.ts.map

package/dist/scaffold/spec-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-tags.d.ts","sourceRoot":"","sources":["../../src/scaffold/spec-tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAEhD,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC;IAC3D,iEAAiE;IACjE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3C,8BAA8B;IAC9B,GAAG,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CACrC;AAED,QAAA,MAAM,QAAQ,cAAc,CAAC;AAE7B,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,EAAE,CAAC,WAAW,GAAG,SAAS,GAChC,cAAc,CAoBhB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/scaffold/spec-tags.js

@@ -0,0 +1,23 @@
+import { walkOperations } from "@ir-kit/k6-gen";
+const UNTAGGED = "_untagged";
+export function readSpecOperations(paths) {
+    const byTag = new Map();
+    const byId = new Map();
+    const all = [];
+    for (const op of walkOperations(paths)) {
+        all.push(op);
+        byId.set(op.id, op);
+        const tags = op.tags.length > 0 ? op.tags : [UNTAGGED];
+        for (const tag of tags) {
+            let bucket = byTag.get(tag);
+            if (!bucket) {
+                bucket = [];
+                byTag.set(tag, bucket);
+            }
+            bucket.push(op);
+        }
+    }
+    return { byTag, byId, all };
+}
+export { UNTAGGED };
+//# sourceMappingURL=spec-tags.js.map

package/dist/scaffold/spec-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-tags.js","sourceRoot":"","sources":["../../src/scaffold/spec-tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAatE,MAAM,QAAQ,GAAG,WAAW,CAAC;AAE7B,MAAM,UAAU,kBAAkB,CAChC,KAAiC;IAEjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA6B,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAA2B,CAAC;IAChD,MAAM,GAAG,GAAsB,EAAE,CAAC;IAElC,KAAK,MAAM,EAAE,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACpB,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,EAAE,CAAC;gBACZ,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACzB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/scaffold/wizard.d.ts

@@ -0,0 +1,25 @@
+import type { ScaffoldScenarioOpts } from "./scenario.js";
+import { type SpecOperations } from "./spec-tags.js";
+/**
+ * Wizard answers — a fully-resolved scaffold config ready for `scaffoldScenario`
+ * plus the filesystem target (output path).
+ */
+export interface WizardResult {
+    outputPath: string;
+    scaffold: ScaffoldScenarioOpts;
+}
+/**
+ * Prompt the user through scenario authoring. Returns `null` if cancelled.
+ * Reuses `SpecOperations` for op discovery so the same source-of-truth feeds
+ * the CLI's `list-ops` subcommand.
+ */
+export declare function runScenarioWizard(spec: SpecOperations, defaults: {
+    clientImportPath: string;
+    outputDir: string;
+}): Promise<WizardResult | null>;
+/**
+ * Confirm-overwrite prompt — shared by wizard and flag-mode CLI so a single
+ * UX rules them both. Returns `true` to proceed.
+ */
+export declare function confirmOverwrite(path: string): Promise<boolean>;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/scaffold/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/scaffold/wizard.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAc,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,KAAK,cAAc,EAAY,MAAM,gBAAgB,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAQD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE;IACR,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkI9B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE"}

package/dist/scaffold/wizard.js

@@ -0,0 +1,156 @@
+import { cancel, confirm, isCancel, multiselect, select, text, } from "@clack/prompts";
+import { UNTAGGED } from "./spec-tags.js";
+/** Bail-out helper. */
+function bail() {
+    cancel("Aborted.");
+    return null;
+}
+/**
+ * Prompt the user through scenario authoring. Returns `null` if cancelled.
+ * Reuses `SpecOperations` for op discovery so the same source-of-truth feeds
+ * the CLI's `list-ops` subcommand.
+ */
+export async function runScenarioWizard(spec, defaults) {
+    const tagOptions = Array.from(spec.byTag.entries()).map(([tag, ops]) => ({
+        value: tag,
+        label: `${tag === UNTAGGED ? "(untagged)" : tag}  —  ${ops.length} op${ops.length === 1 ? "" : "s"}`,
+    }));
+    tagOptions.push({ value: "__manual__", label: "Pick ops manually" });
+    const tagPick = await select({
+        message: "Which group should this scenario cover?",
+        options: tagOptions,
+    });
+    if (isCancel(tagPick))
+        return bail();
+    let ops;
+    if (tagPick === "__manual__") {
+        const opOptions = spec.all.map((op) => ({
+            value: op.id,
+            label: `${op.method.toUpperCase()} ${op.path}  ·  ${op.id}`,
+        }));
+        const picked = (await multiselect({
+            message: "Which ops? (space toggles, enter confirms)",
+            options: opOptions,
+            required: true,
+        }));
+        if (isCancel(picked))
+            return bail();
+        ops = picked
+            .map((id) => spec.byId.get(id))
+            .filter((o) => o !== undefined);
+    }
+    else {
+        const tagOps = spec.byTag.get(tagPick) ?? [];
+        const opOptions = tagOps.map((op) => ({
+            value: op.id,
+            label: `${op.method.toUpperCase()} ${op.path}  ·  ${op.id}`,
+        }));
+        const picked = (await multiselect({
+            message: `Ops from "${tagPick}" — keep them all or narrow?`,
+            options: opOptions,
+            initialValues: tagOps.map((o) => o.id),
+            required: true,
+        }));
+        if (isCancel(picked))
+            return bail();
+        ops = picked
+            .map((id) => spec.byId.get(id))
+            .filter((o) => o !== undefined);
+    }
+    const defaultName = tagPick === "__manual__" ? "scenario" : `${tagPick}-flow`;
+    const name = (await text({
+        message: "Scenario name?",
+        initialValue: defaultName,
+        validate: (v) => (v && v.trim().length ? undefined : "Required"),
+    }));
+    if (isCancel(name))
+        return bail();
+    const chain = (await select({
+        message: "How should they compose?",
+        options: [
+            {
+                value: "sequential",
+                label: "Sequential — chain step outputs (CRUD-style)",
+            },
+            {
+                value: "batch",
+                label: "Parallel fan-out — flow().batch() with async ops",
+            },
+        ],
+        initialValue: "sequential",
+    }));
+    if (isCancel(chain))
+        return bail();
+    const pace = (await select({
+        message: "Pace preset?",
+        options: [
+            { value: "smoke", label: "smoke   1 VU × 30s — CI sanity" },
+            { value: "load", label: "load    ramp to target VUs — steady state" },
+            {
+                value: "stress",
+                label: "stress  climb to ceiling — find breaking point",
+            },
+            { value: "spike", label: "spike   baseline → peak → recover" },
+            { value: "soak", label: "soak    long-haul — leak detection" },
+        ],
+        initialValue: "smoke",
+    }));
+    if (isCancel(pace))
+        return bail();
+    const duration = (await text({
+        message: "Duration?",
+        initialValue: pace === "soak" ? "1h" : "30s",
+    }));
+    if (isCancel(duration))
+        return bail();
+    const auth = (await select({
+        message: "Auth?",
+        options: [
+            { value: "none", label: "None" },
+            { value: "bearer", label: "Bearer (API_TOKEN env)" },
+            { value: "basic", label: "Basic (API_USER / API_PASS env)" },
+            { value: "apiKey", label: "API key header (X-API-Key / API_KEY env)" },
+            { value: "session", label: "Session cookie (fill signIn yourself)" },
+            { value: "digest", label: "HTTP Digest (API_USER / API_PASS env)" },
+            { value: "ntlm", label: "NTLM (API_USER / API_PASS env)" },
+        ],
+        initialValue: "none",
+    }));
+    if (isCancel(auth))
+        return bail();
+    const slug = String(name)
+        .trim()
+        .replace(/[^a-zA-Z0-9-]+/g, "-");
+    const outputPath = (await text({
+        message: "Output path?",
+        initialValue: `${defaults.outputDir}/${slug}.ts`,
+    }));
+    if (isCancel(outputPath))
+        return bail();
+    const authOpts = { auth: auth };
+    return {
+        outputPath: outputPath,
+        scaffold: {
+            clientImportPath: defaults.clientImportPath,
+            pace: pace,
+            duration: duration,
+            ops,
+            chain: chain,
+            auth: authOpts,
+        },
+    };
+}
+/**
+ * Confirm-overwrite prompt — shared by wizard and flag-mode CLI so a single
+ * UX rules them both. Returns `true` to proceed.
+ */
+export async function confirmOverwrite(path) {
+    const ok = await confirm({
+        message: `${path} already exists — overwrite?`,
+        initialValue: false,
+    });
+    if (isCancel(ok))
+        return false;
+    return Boolean(ok);
+}
+//# sourceMappingURL=wizard.js.map

package/dist/scaffold/wizard.js.map

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

package/dist/snapshot.d.ts

@@ -0,0 +1,6 @@
+import type { OperationMap } from "./operation-map.js";
+export declare const SNAPSHOT_FILENAME = ".k6-spec-snapshot.json";
+export declare function loadSnapshotOps(path: string): Promise<OperationMap | null>;
+/** Persist the current op map for the next sync to diff against. */
+export declare function writeSnapshotOps(path: string, ops: OperationMap): Promise<void>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,iBAAiB,2BAA2B,CAAC;AAO1D,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA0B9B;AAED,oEAAoE;AACpE,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/snapshot.js

@@ -0,0 +1,35 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+export const SNAPSHOT_FILENAME = ".k6-spec-snapshot.json";
+export async function loadSnapshotOps(path) {
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw new Error(`Failed to read snapshot at ${path}: ${err.message}`);
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Malformed snapshot at ${path}: ${err.message}. Delete the file to regenerate.`);
+    }
+    if (data?.v !== 1 || !data.operations) {
+        throw new Error(`Unrecognized snapshot schema at ${path} (expected v=1). Delete the file to regenerate.`);
+    }
+    return new Map(Object.entries(data.operations));
+}
+/** Persist the current op map for the next sync to diff against. */
+export async function writeSnapshotOps(path, ops) {
+    await mkdir(dirname(path), { recursive: true });
+    const payload = {
+        v: 1,
+        operations: Object.fromEntries(ops),
+    };
+    await writeFile(path, JSON.stringify(payload, null, 2));
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAO1D,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY;IAEZ,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE,CAChE,CAAC;IACJ,CAAC;IAED,IAAI,IAAmB,CAAC;IACxB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,KAAM,GAAa,CAAC,OAAO,kCAAkC,CAC3F,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,iDAAiD,CACzF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,GAAiB;IAEjB,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,OAAO,GAAkB;QAC7B,CAAC,EAAE,CAAC;QACJ,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC;KACpC,CAAC;IACF,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC"}