@geraldmaron/construct 1.1.1 → 1.2.1

package/templates/demos/playwright/demo-recording.config.mjs

@@ -0,0 +1,47 @@
+/**
+ * templates/demos/playwright/demo-recording.config.mjs — Playwright config scaffold.
+ *
+ * Copied to .cx/demos/playwright.config.mjs on `construct demo init`. webServer
+ * command/url come from DEMO_WEB_SERVER_* env injected by recordPlaywrightDemo.
+ */
+
+import { defineConfig, devices } from '@playwright/test';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const DEMO_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const DEMO_OUTPUT = process.env.DEMO_OUTPUT_DIR || path.join(DEMO_ROOT, '.cx', 'demos');
+
+const webServerCommand = process.env.DEMO_WEB_SERVER_COMMAND;
+const webServerUrl = process.env.DEMO_WEB_SERVER_URL;
+
+export default defineConfig({
+  testDir: path.join(DEMO_ROOT, '.cx', 'demos', 'specs'),
+  timeout: 180_000,
+  fullyParallel: false,
+  workers: 1,
+  reporter: 'list',
+  use: {
+    baseURL: process.env.BASE_URL || webServerUrl || 'http://127.0.0.1:3456',
+    trace: 'off',
+    screenshot: 'off',
+    video: 'on',
+    viewport: { width: 1280, height: 720 },
+  },
+  projects: [
+    {
+      name: 'demo-recording',
+      use: { ...devices['Desktop Chrome'] },
+    },
+  ],
+  outputDir: DEMO_OUTPUT,
+  webServer: process.env.SKIP_WEBSERVER || process.env.CHECKLY || !webServerCommand
+    ? undefined
+    : {
+        command: webServerCommand,
+        url: webServerUrl || process.env.BASE_URL || 'http://127.0.0.1:3456',
+        reuseExistingServer: !process.env.CI,
+        timeout: Number(process.env.DEMO_WEB_SERVER_TIMEOUT || 120_000),
+        cwd: process.env.DEMO_WEB_SERVER_CWD || DEMO_ROOT,
+      },
+});

package/templates/demos/recordings/agentic-platforms-prd.json

@@ -0,0 +1,19 @@
+{
+  "name": "agentic-platforms-prd",
+  "title": "Publish guardrails — agentic platforms PRD",
+  "engine": "playwright",
+  "workspace": "apps/dashboard",
+  "spec": "apps/dashboard/e2e/demo/agentic-platforms-prd.spec.ts",
+  "baseUrl": "http://127.0.0.1:4242",
+  "project": "demo-recording",
+  "artifactReveal": {
+    "mode": "constructPreview",
+    "staticDir": ".",
+    "file": "prd-platform.pdf",
+    "scroll": true
+  },
+  "output": {
+    "format": "mp4",
+    "path": ".cx/demos/dashboard/agentic-platforms-prd.mp4"
+  }
+}

package/templates/demos/scripts/agentic-platforms-prd.json

@@ -0,0 +1,44 @@
+{
+  "name": "agentic-platforms-prd",
+  "title": "Publish guardrails — agentic platforms PRD",
+  "summary": "Prove Construct's path: workflow invoke returns a plan only, validate and publish fail on the thin stub, then pass on the golden fixture with styled PDF export.",
+  "systemOverlay": "Demo mode for publish guardrails. Run the exact construct CLI commands from each step using shell or construct_tool. Do not hand-author production PRD markdown in chat — the passing artifact is tests/fixtures/publish/golden-prd-platform.md. The stub is tests/fixtures/publish/agentic-platforms-stub.md.",
+  "tape": "agentic-platforms-prd",
+  "dashboardDemo": "agentic-platforms-prd",
+  "fallbackSurface": "tape",
+  "artifactReveal": {
+    "path": "prd-platform.pdf",
+    "scroll": true
+  },
+  "fixtures": {
+    "stub": "tests/fixtures/publish/agentic-platforms-stub.md",
+    "golden": "tests/fixtures/publish/golden-prd-platform.md"
+  },
+  "steps": [
+    {
+      "title": "Plan only — workflow invoke",
+      "prompt": "Run construct workflow invoke for prd-draft and show the specialist chain. This is plan-only — it does not draft the PRD.",
+      "command": "node bin/construct workflow invoke --json --workflow-type prd-draft --approval-mode proposal-only --text 'Enterprise agentic platform PRD'"
+    },
+    {
+      "title": "Release gate FAIL — thin stub",
+      "prompt": "Run artifact validate on the stub fixture with type prd-platform. It must fail (structure, visuals, citations).",
+      "command": "node bin/construct artifact validate tests/fixtures/publish/agentic-platforms-stub.md --type=prd-platform"
+    },
+    {
+      "title": "Publish FAIL — gate blocks distribution",
+      "prompt": "Run construct publish on the stub with --figures. Publish must exit 2 and block at the release gate.",
+      "command": "node bin/construct publish tests/fixtures/publish/agentic-platforms-stub.md --figures"
+    },
+    {
+      "title": "Golden fixture PASS — validate",
+      "prompt": "Run artifact validate on the golden prd-platform fixture. It must pass the release gate.",
+      "command": "node bin/construct artifact validate tests/fixtures/publish/golden-prd-platform.md --type=prd-platform"
+    },
+    {
+      "title": "Publish PASS — styled PDF",
+      "prompt": "Publish the golden fixture with --type=prd-platform --figures to .cx/publish/golden-prd-platform.pdf, then confirm the file exists.",
+      "command": "node bin/construct publish tests/fixtures/publish/golden-prd-platform.md --type=prd-platform --figures --output .cx/publish/golden-prd-platform.pdf"
+    }
+  ]
+}

package/templates/demos/specs/_helpers/scroll-artifact.ts

@@ -0,0 +1,89 @@
+/**
+ * templates/demos/specs/_helpers/scroll-artifact.ts — shared Act 2 scroll helpers.
+ *
+ * Used by Construct cockpit demos and copied into project .cx/demos/specs/ on init.
+ */
+
+import { type Page, expect } from '@playwright/test';
+import fs from 'node:fs';
+import path from 'node:path';
+
+type RevealArtifactOpts = {
+  file?: string;
+  basePath?: string;
+  artifactDir?: string;
+  mode?: string;
+  baseUrl?: string;
+};
+
+export async function scrollPdfViewer(page: Page) {
+  await page.waitForTimeout(1500);
+  const viewer = page.locator('embed[type="application/pdf"], #viewer, pdf-viewer');
+  if (await viewer.count()) {
+    await viewer.first().click({ timeout: 5000 }).catch(() => page.mouse.click(640, 360));
+  } else {
+    await page.mouse.click(640, 360);
+  }
+  await page.waitForTimeout(800);
+
+  for (let i = 0; i < 8; i += 1) {
+    await page.keyboard.press('PageDown');
+    await page.waitForTimeout(900);
+  }
+  await page.waitForTimeout(1500);
+}
+
+export async function scrollPage(page: Page, { steps = 10, delta = 500, pauseMs = 700 } = {}) {
+  await page.waitForTimeout(1000);
+  for (let i = 0; i < steps; i += 1) {
+    await page.mouse.wheel(0, delta);
+    await page.waitForTimeout(pauseMs);
+  }
+  await page.waitForTimeout(1000);
+}
+
+export async function revealArtifact(page: Page, {
+  file,
+  basePath = '/demo-preview',
+  artifactDir = process.env.CONSTRUCT_DEMO_ARTIFACT_DIR || '',
+  mode = process.env.DEMO_ARTIFACT_REVEAL_MODE || 'constructPreview',
+  baseUrl = process.env.BASE_URL || '',
+}: RevealArtifactOpts = {}) {
+  const artifactFile = file || process.env.DEMO_ARTIFACT_FILE || '';
+  const dir = artifactDir;
+  const artifactPath = dir && artifactFile ? path.join(dir, artifactFile) : '';
+  if (!artifactFile || !dir || !fs.existsSync(artifactPath)) {
+    return;
+  }
+
+  const encoded = encodeURIComponent(artifactFile);
+  const url = mode === 'sameOrigin' && baseUrl
+    ? `${baseUrl.replace(/\/$/, '')}/${encoded}`
+    : `${basePath}/${encoded}`;
+
+  await page.goto(url);
+  await page.waitForLoadState('domcontentloaded');
+
+  let usedPdf = true;
+  try {
+    await expect(page).toHaveURL(new RegExp(artifactFile.replace('.', '\\.')));
+    await scrollPdfViewer(page);
+  } catch {
+    usedPdf = false;
+    const htmlName = artifactFile.replace(/\.pdf$/i, '.html');
+    const htmlPath = path.join(dir, htmlName);
+    if (!fs.existsSync(htmlPath)) {
+      throw new Error(`PDF viewer scroll failed and HTML fallback missing: ${htmlPath}`);
+    }
+    const htmlUrl = mode === 'sameOrigin' && baseUrl
+      ? `${baseUrl.replace(/\/$/, '')}/${encodeURIComponent(htmlName)}`
+      : `${basePath}/${encodeURIComponent(htmlName)}`;
+    await page.goto(htmlUrl);
+    await page.waitForLoadState('domcontentloaded');
+    await scrollPage(page);
+  }
+
+  if (!usedPdf && process.env.CI) {
+    throw new Error('PDF viewer automation failed on CI; HTML fallback used — fix PDF scroll selectors');
+  }
+}

package/templates/demos/tapes/agentic-platforms-prd.tape

@@ -0,0 +1,49 @@
+Require node
+Require vhs
+# construct demo: publish guardrails via construct chat cockpit (violet theme)
+Output .cx/demos/agentic-platforms-prd.mp4
+Set FontSize 18
+Set Width 1200
+Set Height 720
+Set Theme {"name":"Construct Cockpit","background":"#0c1018","foreground":"#e8eaed","cursor":"#8b5cf6","cursorAccent":"#0c1018","selection":"#1e1b4b","black":"#0c1018","red":"#e06c75","green":"#98c379","yellow":"#e5c07b","blue":"#8b5cf6","magenta":"#c4b5fd","cyan":"#a78bfa","white":"#e8eaed","brightBlack":"#6b7280","brightRed":"#f87171","brightGreen":"#86efac","brightYellow":"#fbbf24","brightBlue":"#a78bfa","brightMagenta":"#ddd6fe","brightCyan":"#c4b5fd","brightWhite":"#ffffff"}
+Set TypingSpeed 42ms
+
+Type "node bin/construct chat --demo=agentic-platforms-prd --plain"
+Sleep 800ms
+Enter
+Sleep 3s
+
+Type "/demo steps"
+Sleep 400ms
+Enter
+Sleep 2s
+
+Type "/demo next"
+Sleep 400ms
+Enter
+Sleep 2s
+
+Type "/demo next"
+Sleep 400ms
+Enter
+Sleep 2s
+
+Type "/demo next"
+Sleep 400ms
+Enter
+Sleep 2s
+
+Type "/demo next"
+Sleep 400ms
+Enter
+Sleep 2s
+
+Type "/demo next"
+Sleep 400ms
+Enter
+Sleep 2s
+
+Type "/exit"
+Sleep 400ms
+Enter
+Sleep 1s

package/templates/demos/tapes/resource-guard-rails.tape

@@ -0,0 +1,49 @@
+Require node
+Require vhs
+# construct demo: resource guard rails — disk budget walkthrough
+Output .cx/demos/resource-guard-rails.mp4
+Set FontSize 18
+Set Width 1200
+Set Height 680
+Set Theme "Dracula"
+Set TypingSpeed 55ms
+
+Type "# 1) Show .cx/ usage vs cap in doctor"
+Sleep 400ms
+Enter
+Sleep 800ms
+
+Type "node bin/construct doctor 2>&1 | tail -25"
+Sleep 400ms
+Enter
+Sleep 3s
+
+Type "# 2) Preview retention prune (dry-run)"
+Sleep 400ms
+Enter
+Sleep 800ms
+
+Type "node bin/construct prune --dry-run"
+Sleep 400ms
+Enter
+Sleep 2s
+
+Type "# 3) Run resource budget functional test"
+Sleep 400ms
+Enter
+Sleep 800ms
+
+Type "node --test tests/functional/resource-write-guard.functional.test.mjs"
+Sleep 400ms
+Enter
+Sleep 3s
+
+Type "# 4) User-scope cleanup (logs + pressure)"
+Sleep 400ms
+Enter
+Sleep 800ms
+
+Type "node bin/construct cleanup --disk-only --dry-run"
+Sleep 400ms
+Enter
+Sleep 2s

package/templates/demos/vhs/construct-cockpit.json

@@ -0,0 +1,24 @@
+{
+  "name": "Construct Cockpit",
+  "background": "#0a0c10",
+  "foreground": "#e8eaed",
+  "cursor": "#ffffff",
+  "cursorAccent": "#0a0c10",
+  "selection": "#23272e",
+  "black": "#0a0c10",
+  "red": "#e06c75",
+  "green": "#98c379",
+  "yellow": "#e5c07b",
+  "blue": "#8a93a3",
+  "magenta": "#b8bec8",
+  "cyan": "#aab2bd",
+  "white": "#e8eaed",
+  "brightBlack": "#565c66",
+  "brightRed": "#f87171",
+  "brightGreen": "#86efac",
+  "brightYellow": "#fbbf24",
+  "brightBlue": "#cdd0d6",
+  "brightMagenta": "#e3e4e8",
+  "brightCyan": "#d6dae0",
+  "brightWhite": "#ffffff"
+}