@loomwork/scaffold 0.0.0-stage → 0.1.1

package/dist/flowTemplates.js

@@ -0,0 +1,348 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FLOW_TEMPLATES = void 0;
+exports.isFlowTemplate = isFlowTemplate;
+exports.approvalFlowFile = approvalFlowFile;
+exports.approvalTestFile = approvalTestFile;
+exports.timerFlowFile = timerFlowFile;
+exports.timerTestFile = timerTestFile;
+exports.sagaFlowFile = sagaFlowFile;
+exports.sagaTestFile = sagaTestFile;
+exports.templateNotes = templateNotes;
+exports.templateFiles = templateFiles;
+const codegen_1 = require("./codegen");
+const emit_1 = require("./emit");
+// ── Non-agentic flow templates (`loom new flow <name> --template approval|timer|saga`) ──
+//
+// The echo flow is the default. These three are the plain-workflow on-ramp: a human gate, a
+// durable timer, and compensation. Each ships a sibling test that runs on a fresh scaffold
+// (`@loomwork/testing`'s time travel drives the timers; nothing sleeps for real).
+exports.FLOW_TEMPLATES = ["echo", "approval", "timer", "saga"];
+function isFlowTemplate(value) {
+    return exports.FLOW_TEMPLATES.includes(value);
+}
+// ── approval ──────────────────────────────────────────────────────────────────
+/** Suspend on a typed resume gate (`resumeSchemas`), with a 24h expiry. */
+function approvalFlowFile(name) {
+    const P = (0, codegen_1.pascalIdent)(name);
+    return [
+        'import { flow$, handler$, step$ } from "@loomwork/core";',
+        'import type { FlowRunner, RegisteredFlow } from "@loomwork/workflow-runtime";',
+        'import { z } from "zod";',
+        "",
+        "// The gate's contract. `resume()` parses the payload against `resumeSchemas` BEFORE it is",
+        "// appended, so a wrongly-shaped approval is refused instead of becoming a permanent fact.",
+        `const ${P}Decision = z.object({ approved: z.boolean(), approvedBy: z.string() });`,
+        "",
+        `const ${P}Apply = step$({`,
+        `  id: ${(0, emit_1.tsStringLiteral)(`${name}-apply`)},`,
+        `  name: "${P} apply",`,
+        "  inputSchema: z.object({ target: z.string() }),",
+        "  outputSchema: z.object({ applied: z.boolean() }),",
+        "  handler: handler$(async (_i: { target: string }) => ({ applied: true })),",
+        "});",
+        "",
+        `type ${P}Out = { status: "applied" | "rejected" | "expired"; approvedBy?: string };`,
+        "",
+        `const runner: FlowRunner<{ target: string }, ${P}Out> = async (ctx, input) => {`,
+        "  // Durable checkpoint: the execution parks in storage (it survives a restart) until someone",
+        "  // answers the gate or the timeout passes. A timeout resumes with a TIMER_FIRED payload",
+        "  // ({ wakeAt }), which is not a decision - so parse what came back.",
+        "  const answer = await ctx.suspend<unknown>({",
+        '    on: "ApprovalGranted",',
+        "    correlationKey: input.target,",
+        "    timeout: 24 * 60 * 60 * 1000, // 24h",
+        "  });",
+        `  const parsed = ${P}Decision.safeParse(answer);`,
+        '  if (!parsed.success) return { status: "expired" };',
+        "  const decision = parsed.data;",
+        '  if (!decision.approved) return { status: "rejected", approvedBy: decision.approvedBy };',
+        `  await ctx.run(${P}Apply, { target: input.target });`,
+        '  return { status: "applied", approvedBy: decision.approvedBy };',
+        "};",
+        "",
+        `export const ${P}Flow: RegisteredFlow = {`,
+        "  definition: flow$({",
+        `    id: ${(0, emit_1.tsStringLiteral)(name)},`,
+        `    name: "${P}",`,
+        '    version: "1.0.0",',
+        "    inputSchema: z.object({ target: z.string() }),",
+        '    outputSchema: z.object({ status: z.enum(["applied", "rejected", "expired"]), approvedBy: z.string().optional() }),',
+        `    steps: [${P}Apply],`,
+        `    resumeSchemas: { ApprovalGranted: ${P}Decision },`,
+        "  }),",
+        "  runner: runner as FlowRunner<unknown, unknown>,",
+        "};",
+        "",
+        "// WHO may approve is not decided here. In production wire `security.resumeAuthenticator`",
+        "// (and an `executionAuthorizer`) in defineConfig - see app/security.ts in a scaffolded app -",
+        "// so `resume()` only accepts a verified approver. The test below runs permissive on purpose.",
+        "",
+    ].join("\n");
+}
+function approvalTestFile(name) {
+    const P = (0, codegen_1.pascalIdent)(name);
+    return [
+        'import { advanceTime, createTestApp, resumeWith } from "@loomwork/testing";',
+        'import { describe, expect, it } from "vitest";',
+        `import { ${P}Flow } from "./flow";`,
+        "",
+        `describe(${(0, emit_1.tsStringLiteral)(name)}, () => {`,
+        '  it("applies once approved", async () => {',
+        `    const app = createTestApp({ flows: [${P}Flow] });`,
+        "    try {",
+        `      const handle = await app.runtime.start(${P}Flow, { target: "prod-db" });`,
+        "      await handle.waitForSuspend();",
+        "      const resumed = await resumeWith(app.runtime, handle.executionId, {",
+        '        eventType: "ApprovalGranted",',
+        '        payload: { approved: true, approvedBy: "ada" },',
+        "      });",
+        "      const state = await resumed.waitForCompletion();",
+        '      expect(state.variables._output).toEqual({ status: "applied", approvedBy: "ada" });',
+        "    } finally {",
+        "      await app.close();",
+        "    }",
+        "  });",
+        "",
+        '  it("expires after 24h with no answer (time travel, no real waiting)", async () => {',
+        `    const app = createTestApp({ clock: true, flows: [${P}Flow] });`,
+        "    try {",
+        `      const handle = await app.runtime.start(${P}Flow, { target: "prod-db" });`,
+        "      await handle.waitForSuspend();",
+        "      await advanceTime(app, 24 * 60 * 60 * 1000);",
+        "      const state = await app.runtime.loadState(handle.executionId);",
+        '      expect(state?.status).toBe("completed");',
+        '      expect(state?.variables._output).toEqual({ status: "expired" });',
+        "    } finally {",
+        "      await app.close();",
+        "    }",
+        "  });",
+        "});",
+        "",
+    ].join("\n");
+}
+// ── timer ─────────────────────────────────────────────────────────────────────
+/** A durable `ctx.sleep` between two steps. */
+function timerFlowFile(name) {
+    const P = (0, codegen_1.pascalIdent)(name);
+    return [
+        'import { flow$, handler$, step$ } from "@loomwork/core";',
+        'import type { FlowRunner, RegisteredFlow } from "@loomwork/workflow-runtime";',
+        'import { z } from "zod";',
+        "",
+        `const ${P}Remind = step$({`,
+        `  id: ${(0, emit_1.tsStringLiteral)(`${name}-remind`)},`,
+        `  name: "${P} remind",`,
+        "  inputSchema: z.object({ who: z.string() }),",
+        "  outputSchema: z.object({ reminded: z.string() }),",
+        "  handler: handler$(async (i: { who: string }) => ({ reminded: i.who })),",
+        "});",
+        "",
+        "const runner: FlowRunner<{ who: string }, { reminded: string }> = async (ctx, input) => {",
+        "  // A DURABLE sleep: the execution parks in storage and a TimerService wakes it. It survives a",
+        "  // restart and holds no process memory. For an absolute instant use `ctx.sleepUntil(epochMs)`.",
+        "  await ctx.sleep(24 * 60 * 60 * 1000); // 1 day",
+        `  return (await ctx.run(${P}Remind, { who: input.who })) as { reminded: string };`,
+        "};",
+        "",
+        `export const ${P}Flow: RegisteredFlow = {`,
+        "  definition: flow$({",
+        `    id: ${(0, emit_1.tsStringLiteral)(name)},`,
+        `    name: "${P}",`,
+        '    version: "1.0.0",',
+        "    inputSchema: z.object({ who: z.string() }),",
+        "    outputSchema: z.object({ reminded: z.string() }),",
+        `    steps: [${P}Remind],`,
+        "  }),",
+        "  runner: runner as FlowRunner<unknown, unknown>,",
+        "};",
+        "",
+        "// Timers only fire where a TimerService runs: in defineConfig pass",
+        "// `timers: { store: new InMemoryTimerStore() }` (or the Sqlite/Postgres store beside your",
+        "// event store). A scaffolded app does not wire one yet.",
+        "",
+    ].join("\n");
+}
+function timerTestFile(name) {
+    const P = (0, codegen_1.pascalIdent)(name);
+    return [
+        'import { advanceTime, createTestApp } from "@loomwork/testing";',
+        'import { describe, expect, it } from "vitest";',
+        `import { ${P}Flow } from "./flow";`,
+        "",
+        "const DAY = 24 * 60 * 60 * 1000;",
+        "",
+        `describe(${(0, emit_1.tsStringLiteral)(name)}, () => {`,
+        '  it("waits a day, then reminds (time travel, no real waiting)", async () => {',
+        "    // `clock: true` gives the app a controllable clock and a timer store; advanceTime moves the",
+        "    // clock and fires what became due through the real TimerService.",
+        `    const app = createTestApp({ clock: true, flows: [${P}Flow] });`,
+        "    try {",
+        `      const handle = await app.runtime.start(${P}Flow, { who: "ada" });`,
+        "      await handle.waitForSuspend();",
+        "",
+        "      await advanceTime(app, DAY - 1); // not due yet",
+        '      expect((await app.runtime.loadState(handle.executionId))?.status).toBe("suspended");',
+        "",
+        "      await advanceTime(app, 1); // due",
+        "      const state = await app.runtime.loadState(handle.executionId);",
+        '      expect(state?.status).toBe("completed");',
+        '      expect(state?.variables._output).toEqual({ reminded: "ada" });',
+        "    } finally {",
+        "      await app.close();",
+        "    }",
+        "  });",
+        "});",
+        "",
+    ].join("\n");
+}
+// ── saga ──────────────────────────────────────────────────────────────────────
+/** reserve -> charge -> ship with a compensator per forward step (`@loomwork/saga` `withSaga`). */
+function sagaFlowFile(name) {
+    const P = (0, codegen_1.pascalIdent)(name);
+    return [
+        'import { flow$, step$ } from "@loomwork/core";',
+        'import { withSaga } from "@loomwork/saga";',
+        'import type { FlowRunner, RegisteredFlow } from "@loomwork/workflow-runtime";',
+        'import { z } from "zod";',
+        "",
+        "// Saga steps are TOOL steps: each names a `toolId` whose effect you register on the app",
+        "// (`app.effectRuntime.register(toolId, new ToolEffect(...))`). A compensator runs under a",
+        "// derived step id, so it must resolve through its `toolId`, not through an inline `handler$`.",
+        `export const ${P}Tools = ["reserve", "unreserve", "charge", "refund", "ship"].map((t) => \`${(0, emit_1.templateLiteralText)(name)}-\${t}\`);`,
+        "",
+        "// Under `security.strict` (the scaffolded app) a flow may only run the tools it is granted:",
+        `// in app/security.ts add \`...${P}Grants\` to the \`GrantTable({ ... })\`, e.g.`,
+        `//   import { ${P}Grants } from "./flows/${(0, emit_1.commentText)(name)}/flow";`,
+        `//   export const authorizer = new GrantTable({ greet: ["greet-step"], ...${P}Grants });`,
+        `export const ${P}Grants = { ${(0, emit_1.tsStringLiteral)(name)}: ${P}Tools };`,
+        "",
+        "const empty = z.object({});",
+        "const stepOf = (tool: string) =>",
+        "  step$({",
+        `    id: \`${(0, emit_1.templateLiteralText)(name)}-\${tool}\`,`,
+        "    name: tool,",
+        `    toolId: \`${(0, emit_1.templateLiteralText)(name)}-\${tool}\`,`,
+        "    inputSchema: empty,",
+        "    outputSchema: empty,",
+        "  });",
+        "",
+        "// Forward steps and their compensators (undo what the forward step did).",
+        'const reserve = stepOf("reserve");',
+        'const unreserve = stepOf("unreserve");',
+        'const charge = stepOf("charge");',
+        'const refund = stepOf("refund");',
+        'const ship = stepOf("ship");',
+        "",
+        "const runner: FlowRunner<{ orderId: string }, { ok: boolean }> = (ctx) =>",
+        "  // On any failure inside the scope, the registered compensators run in REVERSE as ordinary",
+        "  // replay-safe steps. A suspension is not a failure: it never rolls back.",
+        "  withSaga(ctx, async (saga) => {",
+        "    await saga.run(reserve, {}, unreserve);",
+        "    await saga.run(charge, {}, refund);",
+        "    await ctx.run(ship, {}); // if the carrier fails, refund then unreserve run",
+        "    return { ok: true };",
+        "  });",
+        "",
+        `export const ${P}Flow: RegisteredFlow = {`,
+        "  definition: flow$({",
+        `    id: ${(0, emit_1.tsStringLiteral)(name)},`,
+        `    name: "${P}",`,
+        '    version: "1.0.0",',
+        "    inputSchema: z.object({ orderId: z.string() }),",
+        "    outputSchema: z.object({ ok: z.boolean() }),",
+        "    steps: [reserve, unreserve, charge, refund, ship],",
+        "  }),",
+        "  runner: runner as FlowRunner<unknown, unknown>,",
+        "};",
+        "",
+    ].join("\n");
+}
+function sagaTestFile(name) {
+    const P = (0, codegen_1.pascalIdent)(name);
+    return [
+        'import { ToolEffect } from "@loomwork/effect-runtime";',
+        'import { createTestApp } from "@loomwork/testing";',
+        'import { describe, expect, it } from "vitest";',
+        `import { ${P}Flow, ${P}Tools } from "./flow";`,
+        "",
+        "// Stand-ins for the real side effects: record each call, fail `ship` on demand.",
+        "function build(failShipping: boolean) {",
+        "  const ledger: string[] = [];",
+        `  const app = createTestApp({ flows: [${P}Flow] });`,
+        `  for (const toolId of ${P}Tools) {`,
+        `    const label = toolId.slice(${(0, emit_1.tsStringLiteral)(`${name}-`)}.length);`,
+        "    app.effectRuntime.register(",
+        "      toolId,",
+        "      new ToolEffect(async () => {",
+        '        if (label === "ship" && failShipping) throw new Error("carrier unavailable");',
+        "        ledger.push(label);",
+        "        return {};",
+        "      })",
+        "    );",
+        "  }",
+        "  return { app, ledger };",
+        "}",
+        "",
+        `describe(${(0, emit_1.tsStringLiteral)(name)}, () => {`,
+        '  it("keeps the work when every step succeeds", async () => {',
+        "    const { app, ledger } = build(false);",
+        "    try {",
+        `      const handle = await app.runtime.start(${P}Flow, { orderId: "o-1" });`,
+        "      const state = await handle.waitForCompletion();",
+        "      expect(state.variables._output).toEqual({ ok: true });",
+        '      expect(ledger).toEqual(["reserve", "charge", "ship"]);',
+        "    } finally {",
+        "      await app.close();",
+        "    }",
+        "  });",
+        "",
+        '  it("undoes the work in reverse when a later step fails", async () => {',
+        "    const { app, ledger } = build(true);",
+        "    try {",
+        `      const handle = await app.runtime.start(${P}Flow, { orderId: "o-1" });`,
+        "      await handle.waitForCompletion().catch(() => undefined); // the flow itself fails",
+        '      expect(ledger).toEqual(["reserve", "charge", "refund", "unreserve"]);',
+        "    } finally {",
+        "      await app.close();",
+        "    }",
+        "  });",
+        "});",
+        "",
+    ].join("\n");
+}
+/**
+ * What a developer must still do by hand after `loom new flow <name> --template <t>` - printed by
+ * the CLI, because the templates cannot edit the app's own config.
+ */
+function templateNotes(template, name) {
+    const P = (0, codegen_1.pascalIdent)(name);
+    switch (template) {
+        case "echo":
+            return [];
+        case "approval":
+            return [
+                "approval: wire `timers: { store }` in defineConfig so the 24h timeout can fire (the test provides one), and `security.resumeAuthenticator` to decide who may approve.",
+            ];
+        case "timer":
+            return [
+                "timer: wire `timers: { store }` in defineConfig so the sleep can wake (the test provides one).",
+            ];
+        case "saga":
+            return [
+                `saga: the steps are tool steps. Under \`security.strict\` add \`...${P}Grants\` (from ./flows/${(0, emit_1.commentText)(name)}/flow) to the GrantTable in app/security.ts, and register an effect per tool id in \`${P}Tools\` on app.effectRuntime (the test stubs them).`,
+            ];
+    }
+}
+/** The flow + test contents for a non-echo template. */
+function templateFiles(template, name) {
+    switch (template) {
+        case "approval":
+            return { flow: approvalFlowFile(name), test: approvalTestFile(name) };
+        case "timer":
+            return { flow: timerFlowFile(name), test: timerTestFile(name) };
+        case "saga":
+            return { flow: sagaFlowFile(name), test: sagaTestFile(name) };
+    }
+}
+//# sourceMappingURL=flowTemplates.js.map

package/dist/flowTemplates.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { pascal, pascalIdent, generateRegistration } from "./codegen";
+export { blockCommentText, commentText, hasUnsafeChars, markdownText, templateLiteralText, tsStringLiteral, } from "./emit";
+export { flowFile, flowTestFile, toolFile, agentFile, newFile, newFiles, appFiles, sentinelFile, importedPackages, THIRD_PARTY_SPECS, } from "./templates";
+export { CONSTRUCT_NAME, kebab, constructNameProblem, isValidPackageName, packageNameFrom, } from "./names";
+export { pluginFiles, pluginNextSteps, listSeams, SEAM_KEYS } from "./plugin";
+export { FLOW_TEMPLATES, isFlowTemplate, templateNotes, type FlowTemplate } from "./flowTemplates";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,eAAe,GAChB,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,KAAK,EACL,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templateNotes = exports.isFlowTemplate = exports.FLOW_TEMPLATES = exports.SEAM_KEYS = exports.listSeams = exports.pluginNextSteps = exports.pluginFiles = exports.packageNameFrom = exports.isValidPackageName = exports.constructNameProblem = exports.kebab = exports.CONSTRUCT_NAME = exports.THIRD_PARTY_SPECS = exports.importedPackages = exports.sentinelFile = exports.appFiles = exports.newFiles = exports.newFile = exports.agentFile = exports.toolFile = exports.flowTestFile = exports.flowFile = exports.tsStringLiteral = exports.templateLiteralText = exports.markdownText = exports.hasUnsafeChars = exports.commentText = exports.blockCommentText = exports.generateRegistration = exports.pascalIdent = exports.pascal = void 0;
+var codegen_1 = require("./codegen");
+Object.defineProperty(exports, "pascal", { enumerable: true, get: function () { return codegen_1.pascal; } });
+Object.defineProperty(exports, "pascalIdent", { enumerable: true, get: function () { return codegen_1.pascalIdent; } });
+Object.defineProperty(exports, "generateRegistration", { enumerable: true, get: function () { return codegen_1.generateRegistration; } });
+var emit_1 = require("./emit");
+Object.defineProperty(exports, "blockCommentText", { enumerable: true, get: function () { return emit_1.blockCommentText; } });
+Object.defineProperty(exports, "commentText", { enumerable: true, get: function () { return emit_1.commentText; } });
+Object.defineProperty(exports, "hasUnsafeChars", { enumerable: true, get: function () { return emit_1.hasUnsafeChars; } });
+Object.defineProperty(exports, "markdownText", { enumerable: true, get: function () { return emit_1.markdownText; } });
+Object.defineProperty(exports, "templateLiteralText", { enumerable: true, get: function () { return emit_1.templateLiteralText; } });
+Object.defineProperty(exports, "tsStringLiteral", { enumerable: true, get: function () { return emit_1.tsStringLiteral; } });
+var templates_1 = require("./templates");
+Object.defineProperty(exports, "flowFile", { enumerable: true, get: function () { return templates_1.flowFile; } });
+Object.defineProperty(exports, "flowTestFile", { enumerable: true, get: function () { return templates_1.flowTestFile; } });
+Object.defineProperty(exports, "toolFile", { enumerable: true, get: function () { return templates_1.toolFile; } });
+Object.defineProperty(exports, "agentFile", { enumerable: true, get: function () { return templates_1.agentFile; } });
+Object.defineProperty(exports, "newFile", { enumerable: true, get: function () { return templates_1.newFile; } });
+Object.defineProperty(exports, "newFiles", { enumerable: true, get: function () { return templates_1.newFiles; } });
+Object.defineProperty(exports, "appFiles", { enumerable: true, get: function () { return templates_1.appFiles; } });
+Object.defineProperty(exports, "sentinelFile", { enumerable: true, get: function () { return templates_1.sentinelFile; } });
+Object.defineProperty(exports, "importedPackages", { enumerable: true, get: function () { return templates_1.importedPackages; } });
+Object.defineProperty(exports, "THIRD_PARTY_SPECS", { enumerable: true, get: function () { return templates_1.THIRD_PARTY_SPECS; } });
+var names_1 = require("./names");
+Object.defineProperty(exports, "CONSTRUCT_NAME", { enumerable: true, get: function () { return names_1.CONSTRUCT_NAME; } });
+Object.defineProperty(exports, "kebab", { enumerable: true, get: function () { return names_1.kebab; } });
+Object.defineProperty(exports, "constructNameProblem", { enumerable: true, get: function () { return names_1.constructNameProblem; } });
+Object.defineProperty(exports, "isValidPackageName", { enumerable: true, get: function () { return names_1.isValidPackageName; } });
+Object.defineProperty(exports, "packageNameFrom", { enumerable: true, get: function () { return names_1.packageNameFrom; } });
+var plugin_1 = require("./plugin");
+Object.defineProperty(exports, "pluginFiles", { enumerable: true, get: function () { return plugin_1.pluginFiles; } });
+Object.defineProperty(exports, "pluginNextSteps", { enumerable: true, get: function () { return plugin_1.pluginNextSteps; } });
+Object.defineProperty(exports, "listSeams", { enumerable: true, get: function () { return plugin_1.listSeams; } });
+Object.defineProperty(exports, "SEAM_KEYS", { enumerable: true, get: function () { return plugin_1.SEAM_KEYS; } });
+var flowTemplates_1 = require("./flowTemplates");
+Object.defineProperty(exports, "FLOW_TEMPLATES", { enumerable: true, get: function () { return flowTemplates_1.FLOW_TEMPLATES; } });
+Object.defineProperty(exports, "isFlowTemplate", { enumerable: true, get: function () { return flowTemplates_1.isFlowTemplate; } });
+Object.defineProperty(exports, "templateNotes", { enumerable: true, get: function () { return flowTemplates_1.templateNotes; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAsE;AAA7D,iGAAA,MAAM,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAClD,+BAOgB;AANd,wGAAA,gBAAgB,OAAA;AAChB,mGAAA,WAAW,OAAA;AACX,sGAAA,cAAc,OAAA;AACd,oGAAA,YAAY,OAAA;AACZ,2GAAA,mBAAmB,OAAA;AACnB,uGAAA,eAAe,OAAA;AAEjB,yCAWqB;AAVnB,qGAAA,QAAQ,OAAA;AACR,yGAAA,YAAY,OAAA;AACZ,qGAAA,QAAQ,OAAA;AACR,sGAAA,SAAS,OAAA;AACT,oGAAA,OAAO,OAAA;AACP,qGAAA,QAAQ,OAAA;AACR,qGAAA,QAAQ,OAAA;AACR,yGAAA,YAAY,OAAA;AACZ,6GAAA,gBAAgB,OAAA;AAChB,8GAAA,iBAAiB,OAAA;AAEnB,iCAMiB;AALf,uGAAA,cAAc,OAAA;AACd,8FAAA,KAAK,OAAA;AACL,6GAAA,oBAAoB,OAAA;AACpB,2GAAA,kBAAkB,OAAA;AAClB,wGAAA,eAAe,OAAA;AAEjB,mCAA8E;AAArE,qGAAA,WAAW,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,mGAAA,SAAS,OAAA;AAC3D,iDAAmG;AAA1F,+GAAA,cAAc,OAAA;AAAE,+GAAA,cAAc,OAAA;AAAE,8GAAA,aAAa,OAAA"}

package/dist/names.d.ts

@@ -0,0 +1,16 @@
+/** Names a scaffold writes into a path or a `package.json` — validated before anything is created. */
+/** A construct name (`loom new <kind> <name>`): kebab-case, becomes a directory / file name. */
+export declare const CONSTRUCT_NAME: RegExp;
+/** Best-effort kebab-case form of an arbitrary string (`"Bad Name!"` → `"bad-name"`). */
+export declare function kebab(input: string): string;
+/**
+ * Why `name` is not an acceptable `loom new` name, or `undefined` when it is. A path
+ * separator or `..` is called out first: those escape the convention folder, which is a
+ * different mistake from a name that is merely not kebab-case.
+ */
+export declare function constructNameProblem(name: string): string | undefined;
+/** npm's rules for a package name, unscoped or `@scope/name` (lowercase, URL-safe, no leading `.`/`_`). */
+export declare function isValidPackageName(name: string): boolean;
+/** A valid npm name derived from a directory name, or `undefined` if nothing usable remains. */
+export declare function packageNameFrom(dirName: string): string | undefined;
+//# sourceMappingURL=names.d.ts.map

package/dist/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAAA,sGAAsG;AAEtG,gGAAgG;AAChG,eAAO,MAAM,cAAc,QAAsB,CAAC;AAElD,yFAAyF;AACzF,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQrE;AAED,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMxD;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGnE"}

package/dist/names.js

@@ -0,0 +1,45 @@
+"use strict";
+/** Names a scaffold writes into a path or a `package.json` — validated before anything is created. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONSTRUCT_NAME = void 0;
+exports.kebab = kebab;
+exports.constructNameProblem = constructNameProblem;
+exports.isValidPackageName = isValidPackageName;
+exports.packageNameFrom = packageNameFrom;
+/** A construct name (`loom new <kind> <name>`): kebab-case, becomes a directory / file name. */
+exports.CONSTRUCT_NAME = /^[a-z][a-z0-9-]*$/;
+/** Best-effort kebab-case form of an arbitrary string (`"Bad Name!"` → `"bad-name"`). */
+function kebab(input) {
+    return input
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * Why `name` is not an acceptable `loom new` name, or `undefined` when it is. A path
+ * separator or `..` is called out first: those escape the convention folder, which is a
+ * different mistake from a name that is merely not kebab-case.
+ */
+function constructNameProblem(name) {
+    if (/[\\/]/.test(name) || name === ".." || name === "." || /^[a-zA-Z]:/.test(name)) {
+        return `"${name}" is a path, not a name — a name may not contain path separators or "..", it would write outside the convention folder`;
+    }
+    if (exports.CONSTRUCT_NAME.test(name))
+        return undefined;
+    const k = kebab(name);
+    const hint = exports.CONSTRUCT_NAME.test(k) ? ` — did you mean "${k}"?` : "";
+    return `invalid name "${name}": use lowercase kebab-case matching ${exports.CONSTRUCT_NAME.source}${hint}`;
+}
+/** npm's rules for a package name, unscoped or `@scope/name` (lowercase, URL-safe, no leading `.`/`_`). */
+function isValidPackageName(name) {
+    return (name.length > 0 &&
+        name.length <= 214 &&
+        /^(@[a-z0-9][a-z0-9._~-]*\/)?[a-z0-9][a-z0-9._~-]*$/.test(name));
+}
+/** A valid npm name derived from a directory name, or `undefined` if nothing usable remains. */
+function packageNameFrom(dirName) {
+    const k = kebab(dirName);
+    return isValidPackageName(k) ? k : undefined;
+}
+//# sourceMappingURL=names.js.map

package/dist/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":";AAAA,sGAAsG;;;AAMtG,sBAMC;AAOD,oDAQC;AAGD,gDAMC;AAGD,0CAGC;AAxCD,gGAAgG;AACnF,QAAA,cAAc,GAAG,mBAAmB,CAAC;AAElD,yFAAyF;AACzF,SAAgB,KAAK,CAAC,KAAa;IACjC,OAAO,KAAK;SACT,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,IAAY;IAC/C,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnF,OAAO,IAAI,IAAI,wHAAwH,CAAC;IAC1I,CAAC;IACD,IAAI,sBAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,IAAI,GAAG,sBAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,OAAO,iBAAiB,IAAI,wCAAwC,sBAAc,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;AACrG,CAAC;AAED,2GAA2G;AAC3G,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,OAAO,CACL,IAAI,CAAC,MAAM,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,IAAI,GAAG;QAClB,oDAAoD,CAAC,IAAI,CAAC,IAAI,CAAC,CAChE,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,SAAgB,eAAe,CAAC,OAAe;IAC7C,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Join a plugin's name to a seam's noun WITHOUT repeating words: `cloudrun-sandbox` + `SandboxBackend`
+ * is `CloudrunSandboxBackend`, not `CloudrunSandboxSandboxBackend`. Words are compared as camel-case
+ * words, case-insensitively; the longest suffix of `base` that is a prefix of `noun` is shared, so
+ * `FooTimerStore` + `TimerStore` is `FooTimerStore` and a name sharing no words is plain concatenation.
+ */
+export declare function joinNoun(base: string, noun: string): string;
+export declare const SEAM_KEYS: string[];
+/** seam key → SPI interface name. Consumed by the seam/doc coverage fitness test. */
+export declare const SEAM_SPI: Record<string, string>;
+/** seam key → the line that wires it. Consumed by the wiring fitness test. */
+export declare const SEAM_WIRING: Record<string, string>;
+/** Human-readable seam list for `loom plugin seams`. */
+export declare function listSeams(): string;
+/**
+ * The Loom release this scaffold ships with, read from its own package.json (CommonJS output sits
+ * directly under `dist/`, so `..` is the package root from `dist/` and `src/`). A third-party plugin
+ * peers on `^<this>` of the published `@loomwork/*` packages.
+ */
+export declare function loomRelease(): string;
+/**
+ * Does this template's CODE use a node global?
+ *
+ * Comments are stripped first, and that is not a detail: two seams describe "the process" in
+ * their prose, and matching those would have added `@types/node` to packages whose code never
+ * touches it. A sweep that reads comments is measuring prose, not code.
+ */
+export declare function usesNodeGlobals(source: string): boolean;
+/**
+ * Scaffold a plugin package for `seam`, named `name`, in first- or third-party
+ * shape. Returns a map of relative path → file contents (pure — the CLI writes).
+ */
+export declare function pluginFiles(seamKey: string, name: string, opts: {
+    firstParty: boolean;
+}): Record<string, string>;
+/**
+ * The "next:" guidance `loom plugin new` prints, derived from what was generated so it cannot
+ * drift from it: whether the conformance test is live or commented out is read from the test file
+ * itself, and a third-party author is told which `@loomwork/*` packages need resolving.
+ */
+export declare function pluginNextSteps(files: Record<string, string>, opts: {
+    firstParty: boolean;
+    root: string;
+}): string[];
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB3D;AA6iDD,eAAO,MAAM,SAAS,UAAqB,CAAC;AAE5C,qFAAqF;AACrF,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAE3C,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAE9C,CAAC;AAEF,wDAAwD;AACxD,wBAAgB,SAAS,IAAI,MAAM,CAUlC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAsDD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGvD;AAgID;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBxB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,IAAI,EAAE;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C,MAAM,EAAE,CAiCV"}