groundwork-method 0.0.1 → 0.11.0

package/src/generators/system-test-runner/schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SystemTestRunner",
+  "title": "System Test Runner",
+  "type": "object",
+  "properties": {
+    "projectPrefix": {
+      "type": "string",
+      "description": "The prefix for Docker container names (e.g. 'myapp')",
+      "default": "groundwork"
+    },
+    "surfaces": {
+      "type": "string",
+      "description": "JSON array of surface specs from the surface registry (.groundwork/surfaces.json): [{\"slug\": \"web-app\", \"medium\": \"playwright\", \"reach\": \"...\"}]. 'medium' is the registry's testMedium (playwright | subprocess-cli | protocol-client | flutter-integration | playwright-electron | others register without a runner fixture); 'reach' is an optional static base URL (playwright/protocol-client), launch command (subprocess-cli), or test-harness command (flutter-integration/playwright-electron) — omitted, URL mediums are discovered from docker-compose.yml by slug and harness mediums resolve to 'npx nx run <slug>:test-integration' / 'npx nx run <slug>:smoke' when services/<slug> exists. Generates the slug-keyed 'surfaces' fixture plus one runner fixture per surface. Supersedes interfaceMedium when both are given."
+    },
+    "interfaceMedium": {
+      "type": "string",
+      "description": "DEPRECATED single-surface alias for 'surfaces' — the project's interface medium, from docs/design-system.md's interface track. Used only when no surface registry exists; generates the legacy frontend_base_url fixture instead of the surfaces map",
+      "enum": ["graphical-ui", "cli", "agentic-protocol"],
+      "default": "graphical-ui"
+    }
+  },
+  "required": []
+}

package/src/generators/workspace-dev-cli/cli-src/build.mjs

@@ -0,0 +1,42 @@
+// Bundles the ./dev CLI source into a single zero-runtime-dependency file that the
+// workspace-dev-cli generator copies verbatim into generated projects.
+//
+// The output is intentionally written OUTSIDE the generator's `files/` directory so it
+// never passes through Nx's EJS templating (a bundle can contain `<%` in strings/regexes
+// that EJS would corrupt). generator.ts reads dist/dev-bundle.js and writes it raw.
+//
+// Run from the repo root: `npm run build:dev-cli`.
+
+import { build } from 'esbuild';
+import { fileURLToPath } from 'url';
+import * as path from 'path';
+import * as fs from 'fs';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+
+// Embed the package version so the deployed bundle knows its vintage (./dev --version,
+// doctor's framework-alignment check). NOTE: this makes the committed bundle
+// version-dependent — rebuild it after every `npm version` bump (the bundle-freshness
+// contract test fails the release gates if you forget).
+const PKG_VERSION = JSON.parse(
+  fs.readFileSync(path.join(here, '..', '..', '..', '..', 'package.json'), 'utf8'),
+).version;
+
+// Default writes the committed bundle. Tests set DEV_CLI_OUTFILE to a temp path to
+// build a fresh bundle without mutating the working tree, then diff it against the
+// committed one (the freshness contract) — sharing this one esbuild config.
+const outfile = process.env.DEV_CLI_OUTFILE || path.join(here, 'dist', 'dev-bundle.js');
+
+await build({
+  entryPoints: [path.join(here, 'src', 'index.ts')],
+  bundle: true,
+  platform: 'node',
+  target: 'node18',
+  format: 'cjs',
+  outfile,
+  legalComments: 'none',
+  logLevel: 'info',
+  define: { 'process.env.GW_DEV_CLI_VERSION': JSON.stringify(PKG_VERSION) },
+});
+
+console.log(`Built ${outfile}`);