qfai 1.8.2 → 1.8.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qfai",
-  "version": "1.8.2",
+  "version": "1.8.4",
   "description": "Quality-first AI-driven development toolkit (SDD × ATDD × TDD).",
   "license": "MIT",
   "repository": {
@@ -36,6 +36,7 @@
     "build": "tsup",
     "prepack": "npm run build",
     "lint": "eslint src",
+    "lint:shipping": "vitest run tests/scripts/lintShipping.test.ts",
     "check-types": "tsc --noEmit",
     "test": "vitest run",
     "test:core": "vitest run --project core",
@@ -43,7 +44,8 @@
     "test:integration": "vitest run --project integration",
     "test:e2e": "vitest run --project e2e",
     "test:cli": "vitest run --project cli",
-    "test:assets": "vitest run tests/assets"
+    "test:assets": "vitest run tests/assets",
+    "self-validate": "node dist/cli/index.mjs validate --profile tdd --fail-on error --root ../.."
   },
   "dependencies": {
     "@cucumber/gherkin": "^37.0.1",

package/assets/scripts/capture-screenshots.js

@@ -1,128 +0,0 @@
-#!/usr/bin/env node
-/**
- * capture-screenshots.js — Headless screenshot capture utility for qfai-prototyping.
- *
- * Usage:
- *   node capture-screenshots.js --url <url> --out <dir> [--width <px>] [--height <px>]
- *
- * Outputs:
- *   <dir>/screenshot-<ISOtimestamp>.png  — full-page screenshot
- *   <dir>/manifest.json                  — { url, capturedAt, files: [{path, timestamp}] }
- *
- * Exit codes:
- *   0 — success (at least one screenshot captured)
- *   1 — argument error (missing --url or --out)
- *   2 — capture error (unreachable URL or write failure)
- *
- * Input/output contract:
- *   Input : --url  (string, required) — the page URL to capture
- *           --out  (string, required) — directory to write screenshots; created if absent
- *           --width  (number, default 1280) — viewport width in px
- *           --height (number, default 800)  — viewport height in px
- *
- *   Output: each screenshot filename includes an ISO-8601-like timestamp suffix
- *           (e.g. screenshot-2026-04-18T130000123Z.png) so filenames are
- *           sortable and unique per run.
- *
- * spec-0012 TC-0012-0291 / AC-0012-0176
- */
-
-"use strict";
-
-import fs from "node:fs";
-import path from "node:path";
-import { execSync } from "node:child_process";
-
-function parseArgs(argv) {
-  const args = {};
-  for (let i = 0; i < argv.length; i++) {
-    if (argv[i] === "--url" && argv[i + 1]) {
-      args.url = argv[++i];
-    } else if (argv[i] === "--out" && argv[i + 1]) {
-      args.out = argv[++i];
-    } else if (argv[i] === "--width" && argv[i + 1]) {
-      args.width = parseInt(argv[++i], 10);
-    } else if (argv[i] === "--height" && argv[i + 1]) {
-      args.height = parseInt(argv[++i], 10);
-    }
-  }
-  return args;
-}
-
-function isoTimestamp() {
-  return new Date().toISOString().replace(/[:.]/g, "").replace("T", "T").slice(0, -1) + "Z";
-}
-
-function main() {
-  const args = parseArgs(process.argv.slice(2));
-
-  if (!args.url) {
-    console.error("Error: --url is required");
-    process.exit(1);
-  }
-  if (!args.out) {
-    console.error("Error: --out is required");
-    process.exit(1);
-  }
-
-  const outDir = path.resolve(args.out);
-  fs.mkdirSync(outDir, { recursive: true });
-
-  const timestamp = isoTimestamp();
-  const filename = `screenshot-${timestamp}.png`;
-  const screenshotPath = path.join(outDir, filename);
-
-  let captured = false;
-  let captureError = null;
-  try {
-    // Try puppeteer-based capture (available when installed). Any failure
-    // must surface as a capture error; writing fake PNG bytes would corrupt
-    // the evidence chain by making downstream steps think capture succeeded.
-    const puppeteerScript = `
-const puppeteer = require('puppeteer');
-(async () => {
-  const browser = await puppeteer.launch({ args: ['--no-sandbox'] });
-  const page = await browser.newPage();
-  await page.setViewport({ width: ${args.width || 1280}, height: ${args.height || 800} });
-  await page.goto(${JSON.stringify(args.url)}, { waitUntil: 'networkidle0', timeout: 30000 });
-  await page.screenshot({ path: ${JSON.stringify(screenshotPath)}, fullPage: true });
-  await browser.close();
-})();
-`;
-    const tmpScript = path.join(outDir, `_tmp_capture_${timestamp}.js`);
-    fs.writeFileSync(tmpScript, puppeteerScript, "utf-8");
-    try {
-      execSync(`node "${tmpScript}"`, { timeout: 60000, stdio: "pipe" });
-      captured = true;
-    } finally {
-      try {
-        fs.unlinkSync(tmpScript);
-      } catch {
-        /* ignore */
-      }
-    }
-  } catch (error) {
-    captureError = error;
-  }
-
-  if (!captured) {
-    const detail =
-      captureError && typeof captureError.message === "string"
-        ? captureError.message
-        : String(captureError || "unknown error");
-    console.error(`Error: capture failed (${detail})`);
-    process.exit(2);
-  }
-
-  const manifest = {
-    url: args.url,
-    capturedAt: new Date().toISOString(),
-    files: [{ path: screenshotPath, timestamp }],
-  };
-  fs.writeFileSync(path.join(outDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf-8");
-
-  console.log(screenshotPath);
-  process.exit(0);
-}
-
-main();