@lotics/cli 0.56.0 → 0.60.1

package/dist/starter_template.js

@@ -147,6 +147,41 @@ export function buildStarterTemplate(args) {
                 // fall to `unknown`. The explicit glob makes the dot-dir the non-wildcard
                 // base, which IS read. (GAP-38.)
                 include: ["src", ".lotics/**/*"],
+                // src/workflows/<alias>.ts bodies run on the server (workflow globals:
+                // trigger / runtime / tool calls). They ARE locally typecheckable —
+                // each is wrapped in the server's `__workflow` envelope and references
+                // its per-alias `.lotics/workflows/<alias>.globals.d.ts` — but under a
+                // DEDICATED config that mirrors the server's compile options (es2022
+                // lib, NO DOM). The main `npm run typecheck` excludes them so it stays
+                // green and DOM-lib-free for bodies; check a body with
+                // `tsc -p tsconfig.workflows.json`. The server is the single verifier
+                // on `lotics app workflow set`.
+                exclude: ["node_modules", "src/workflows"],
+            }, null, 2) + "\n",
+        },
+        {
+            // Dedicated config for the editable workflow bodies (GAP-59). Mirrors the
+            // SERVER's set-time typecheck options (strict, lib es2022 with NO DOM,
+            // target ES2022, skipLibCheck) so a local `tsc -p tsconfig.workflows.json`
+            // gives the same verdict the server would on `lotics app workflow set`.
+            // Each body file is a module (the CLI writes a bookkeeping `export {};`),
+            // so the per-file `__workflow` wrapper doesn't collide across bodies.
+            path: "tsconfig.workflows.json",
+            content: JSON.stringify({
+                compilerOptions: {
+                    target: "ES2022",
+                    lib: ["ES2022"],
+                    module: "ESNext",
+                    moduleResolution: "Bundler",
+                    strict: true,
+                    skipLibCheck: true,
+                    noEmit: true,
+                    types: [],
+                },
+                // The bodies + their per-alias ambient globals. `.lotics/workflows`
+                // uses the explicit `**/*` glob for the same dot-dir walk reason the
+                // main config does (TS's include walk skips bare dot-dirs).
+                include: ["src/workflows", ".lotics/workflows/**/*"],
                 exclude: ["node_modules"],
             }, null, 2) + "\n",
         },
@@ -483,6 +518,60 @@ const routes = [
 export default function App() {
   return <AppRouter routes={routes} />;
 }
+`,
+        },
+        {
+            // The home for editable workflow bodies. `lotics app pull` writes one
+            // `src/workflows/<alias>.ts` per bound workflow (faithful server source);
+            // edit it, then `lotics app workflow set <alias>` pushes it back through
+            // set_app_workflow (the server verifies). A new app has no bound workflows
+            // yet, so this is just the docked directory + the loop reference. It's a
+            // .md (not a .ts) so tsc's `include: ["src"]` never tries to compile it —
+            // a workflow body is a JS-subset expression over server globals
+            // (trigger / runtime / tool calls) that does NOT typecheck standalone.
+            path: "src/workflows/README.md",
+            content: `# Workflow bodies
+
+Editable JS-subset bodies of this app's workflows live here, one file per alias:
+\`src/workflows/<alias>.ts\`.
+
+## Loop
+
+\`\`\`bash
+lotics app workflow pull          # write/refresh every src/workflows/<alias>.ts from the server
+# edit src/workflows/<alias>.ts
+lotics app workflow set <alias>   # push it back through set_app_workflow (the server verifies)
+\`\`\`
+
+\`lotics app pull <app_id>\` also writes these files (alongside the rest of the project).
+
+## What a body is
+
+A workflow body is a **JS-subset expression** that runs server-side using workflow
+globals (\`trigger\`, \`runtime\`, tool calls) and ends with \`return({ data })\`. Each
+pulled file wraps the body in the server's \`__workflow\` envelope and references its
+per-alias ambient globals at \`.lotics/workflows/<alias>.globals.d.ts\`, so it **is**
+locally typecheckable — under the dedicated config that mirrors the server's compile
+options:
+
+\`\`\`bash
+tsc -p tsconfig.workflows.json   # same verdict the server gives on \`set\`
+\`\`\`
+
+The main \`npm run typecheck\` excludes \`src/workflows\` (it would apply the app's
+DOM lib, which the server doesn't), so the bodies have their own config. The
+verification that matters still runs on the **server** when you \`set\` — the same
+guarantee as authoring via \`set_app_workflow\` directly. Edit only the body BETWEEN
+the wrapper lines; the wrapper, the \`/// <reference>\`, and the \`export {};\` marker
+are CLI bookkeeping (stripped on \`set\`). Do not rename a file (the filename is the
+alias the binding is keyed by).
+
+## Authority
+
+\`lotics app deploy\` never authors workflows — it carries code, queries, and
+capabilities only. \`apps.workflows\` has exactly one author: \`set_app_workflow\`
+(which \`lotics app workflow set\` calls). The typed \`inputs\`/\`outputs\` schema for
+each alias lives in \`package.json#lotics.workflows.<alias>\`.
 `,
         },
         {

package/dist/starter_template.test.js

@@ -97,4 +97,15 @@ describe("buildStarterTemplate", () => {
         const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
         expect(config).toMatch(/include:\s*\[[\s\S]*"react-router-dom"/);
     });
+    test("ships a dedicated tsconfig.workflows.json mirroring the server's compile options (GAP-59)", () => {
+        const cfg = JSON.parse(fileNamed(buildStarterTemplate(baseArgs), "tsconfig.workflows.json"));
+        // Server-mirroring: es2022 lib with NO DOM, strict, skipLibCheck, target ES2022.
+        expect(cfg.compilerOptions.lib).toEqual(["ES2022"]);
+        expect(cfg.compilerOptions.strict).toBe(true);
+        expect(cfg.compilerOptions.skipLibCheck).toBe(true);
+        expect(cfg.compilerOptions.target).toBe("ES2022");
+        // It includes the bodies + their per-alias ambient globals.
+        expect(cfg.include).toContain("src/workflows");
+        expect(cfg.include).toContain(".lotics/workflows/**/*");
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.56.0",
+  "version": "0.60.1",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {
@@ -21,6 +21,7 @@
   },
   "devDependencies": {
     "@lotics/docx": "*",
+    "@lotics/shared": "*",
     "@lotics/xlsx": "*",
     "@types/node": "^22.15.21",
     "esbuild": "^0.28.1",