openwolf-enhanced 1.9.3

package/dist/src/designqc/designqc-capture.js

@@ -0,0 +1,278 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as http from "node:http";
+import { execSync, spawn } from "node:child_process";
+export function findChromePath(configPath) {
+    if (configPath && fs.existsSync(configPath))
+        return configPath;
+    if (process.platform === "win32") {
+        const candidates = [
+            path.join(process.env["PROGRAMFILES"] || "C:\\Program Files", "Google\\Chrome\\Application\\chrome.exe"),
+            path.join(process.env["PROGRAMFILES(X86)"] || "C:\\Program Files (x86)", "Google\\Chrome\\Application\\chrome.exe"),
+            path.join(process.env["LOCALAPPDATA"] || "", "Google\\Chrome\\Application\\chrome.exe"),
+            path.join(process.env["PROGRAMFILES(X86)"] || "C:\\Program Files (x86)", "Microsoft\\Edge\\Application\\msedge.exe"),
+            path.join(process.env["PROGRAMFILES"] || "C:\\Program Files", "Microsoft\\Edge\\Application\\msedge.exe"),
+        ];
+        for (const c of candidates) {
+            if (fs.existsSync(c))
+                return c;
+        }
+        try {
+            const r = execSync("where chrome", { encoding: "utf-8", stdio: ["pipe", "pipe", "ignore"] }).trim();
+            if (r)
+                return r.split("\n")[0].trim();
+        }
+        catch { }
+        try {
+            const r = execSync("where msedge", { encoding: "utf-8", stdio: ["pipe", "pipe", "ignore"] }).trim();
+            if (r)
+                return r.split("\n")[0].trim();
+        }
+        catch { }
+    }
+    else if (process.platform === "darwin") {
+        for (const c of [
+            "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+            "/Applications/Chromium.app/Contents/MacOS/Chromium",
+        ]) {
+            if (fs.existsSync(c))
+                return c;
+        }
+    }
+    else {
+        try {
+            return execSync("which google-chrome || which chromium || which chromium-browser", {
+                encoding: "utf-8", stdio: ["pipe", "pipe", "ignore"],
+            }).trim().split("\n")[0];
+        }
+        catch { }
+    }
+    throw new Error("Chrome/Edge not found. Install Chrome or set designqc.chrome_path in .wolf/config.json");
+}
+/**
+ * Capture a full page as sectioned viewport-height screenshots.
+ * Returns multiple screenshots — one per "fold" of the page.
+ * This gives Claude focused views of each section without one massive image.
+ */
+export async function captureRouteSectioned(page, url, viewport, outputDir, quality, maxWidth) {
+    const scale = maxWidth < viewport.width ? maxWidth / viewport.width : 1;
+    const captureWidth = Math.round(viewport.width * scale);
+    const captureHeight = Math.round(viewport.height * scale);
+    await page.setViewport({ width: captureWidth, height: captureHeight });
+    await page.goto(url, { waitUntil: "networkidle2", timeout: 30_000 });
+    await new Promise((r) => setTimeout(r, 1500));
+    // Get full page height
+    const fullHeight = await page.evaluate(() => document.documentElement.scrollHeight);
+    const route = new URL(url).pathname;
+    const safeName = route.replace(/\//g, "_").replace(/^_/, "") || "root";
+    const screenshots = [];
+    const sectionHeight = captureHeight;
+    const totalSections = Math.ceil(fullHeight / sectionHeight);
+    // Cap at 8 sections (~20K tokens) to avoid runaway costs
+    const maxSections = Math.min(totalSections, 8);
+    for (let i = 0; i < maxSections; i++) {
+        const y = i * sectionHeight;
+        // Scroll to position
+        await page.evaluate((scrollY) => window.scrollTo(0, scrollY), y);
+        await new Promise((r) => setTimeout(r, 500));
+        const screenshotBuffer = await page.screenshot({
+            fullPage: false,
+            type: "jpeg",
+            quality,
+        });
+        const sectionLabel = i === 0 ? "top" : i === maxSections - 1 ? "bottom" : `section${i + 1}`;
+        const fileName = `${safeName}_${viewport.name}_${sectionLabel}.jpg`;
+        const filePath = path.join(outputDir, fileName);
+        fs.writeFileSync(filePath, screenshotBuffer);
+        screenshots.push({ route, viewport, path: filePath });
+    }
+    return screenshots;
+}
+export function detectRoutes(projectRoot) {
+    const routes = ["/"];
+    const dirs = [
+        path.join(projectRoot, "pages"),
+        path.join(projectRoot, "app"),
+        path.join(projectRoot, "src", "pages"),
+        path.join(projectRoot, "src", "app"),
+    ].filter((d) => fs.existsSync(d));
+    for (const dir of dirs) {
+        try {
+            const files = fs.readdirSync(dir, { recursive: true });
+            for (const file of files) {
+                const f = String(file).replace(/\\/g, "/");
+                if (f.includes("api/") || f.includes("_") || f.includes("layout."))
+                    continue;
+                if (f.endsWith(".tsx") || f.endsWith(".jsx") || f.endsWith(".ts") || f.endsWith(".js")) {
+                    let route = "/" + f
+                        .replace(/\.(tsx|jsx|ts|js)$/, "")
+                        .replace(/\/index$/, "")
+                        .replace(/\/page$/, "");
+                    if (route === "/")
+                        continue;
+                    routes.push(route);
+                }
+            }
+        }
+        catch { }
+    }
+    return [...new Set(routes)].slice(0, 10);
+}
+export async function probePort(port) {
+    return new Promise((resolve) => {
+        const req = http.get(`http://localhost:${port}`, () => resolve(true));
+        req.on("error", () => resolve(false));
+        req.setTimeout(2000, () => { req.destroy(); resolve(false); });
+    });
+}
+/**
+ * Try to find a running dev server on common ports.
+ */
+/**
+ * Detect the project's deployed/production URL from common config files
+ * (package.json homepage, .env* URL vars, vercel.json aliases). Returns null if none —
+ * the caller then falls back to a local dev server (upstream #4, bug 4).
+ */
+export function detectDeployedUrl(projectRoot) {
+    // 1. package.json "homepage"
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(projectRoot, "package.json"), "utf-8"));
+        if (typeof pkg.homepage === "string" && pkg.homepage.startsWith("http"))
+            return pkg.homepage;
+    }
+    catch { /* ignore */ }
+    // 2. Common env files — a production URL variable
+    const envFiles = [".env.production", ".env.production.local", ".env.local", ".env"];
+    const urlVarNames = [
+        "NEXT_PUBLIC_SITE_URL", "NEXT_PUBLIC_URL", "NEXT_PUBLIC_APP_URL",
+        "NUXT_PUBLIC_SITE_URL", "VITE_APP_URL", "VITE_APP_BASE_URL",
+        "PUBLIC_URL", "APP_URL", "SITE_URL", "BASE_URL",
+    ];
+    for (const envFile of envFiles) {
+        try {
+            const content = fs.readFileSync(path.join(projectRoot, envFile), "utf-8");
+            for (const varName of urlVarNames) {
+                const match = content.match(new RegExp(`^${varName}=["']?([^"'\\s]+)["']?`, "m"));
+                if (match && match[1].startsWith("http"))
+                    return match[1].trim();
+            }
+        }
+        catch { /* ignore */ }
+    }
+    // 3. vercel.json alias(es)
+    try {
+        const vercelJson = JSON.parse(fs.readFileSync(path.join(projectRoot, "vercel.json"), "utf-8"));
+        const aliases = vercelJson.alias ?? vercelJson.aliases;
+        if (Array.isArray(aliases) && aliases.length > 0 && typeof aliases[0] === "string") {
+            const alias = aliases[0];
+            return alias.startsWith("http") ? alias : `https://${alias}`;
+        }
+    }
+    catch { /* ignore */ }
+    return null;
+}
+export async function detectDevServer() {
+    const commonPorts = [3000, 3001, 5173, 5174, 4321, 8080, 8000, 4200];
+    for (const port of commonPorts) {
+        if (await probePort(port)) {
+            return { url: `http://localhost:${port}`, port };
+        }
+    }
+    return null;
+}
+/**
+ * Detect the dev command from package.json.
+ * Returns { command, port } or null.
+ */
+export function detectDevCommand(projectRoot) {
+    const pkgPath = path.join(projectRoot, "package.json");
+    if (!fs.existsSync(pkgPath))
+        return null;
+    try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        const scripts = pkg.scripts || {};
+        // Priority order: dev, start, serve
+        for (const key of ["dev", "start", "serve"]) {
+            if (scripts[key]) {
+                // Try to detect port from the script
+                const portMatch = scripts[key].match(/-p\s+(\d+)|--port\s+(\d+)|PORT=(\d+)/);
+                let port = 3000;
+                if (portMatch) {
+                    port = parseInt(portMatch[1] || portMatch[2] || portMatch[3], 10);
+                }
+                else if (scripts[key].includes("vite")) {
+                    port = 5173;
+                }
+                else if (scripts[key].includes("next")) {
+                    port = 3000;
+                }
+                else if (scripts[key].includes("astro")) {
+                    port = 4321;
+                }
+                else if (scripts[key].includes("angular") || scripts[key].includes("ng serve")) {
+                    port = 4200;
+                }
+                // Determine package manager
+                let runner = "npm run";
+                if (fs.existsSync(path.join(projectRoot, "pnpm-lock.yaml")))
+                    runner = "pnpm";
+                else if (fs.existsSync(path.join(projectRoot, "yarn.lock")))
+                    runner = "yarn";
+                else if (fs.existsSync(path.join(projectRoot, "bun.lockb")))
+                    runner = "bun run";
+                return { command: `${runner} ${key}`, expectedPort: port };
+            }
+        }
+    }
+    catch { }
+    return null;
+}
+/**
+ * Start the dev server, wait for it to be ready, return the process handle.
+ * Caller is responsible for killing the process.
+ */
+export async function startDevServer(projectRoot) {
+    const devCmd = detectDevCommand(projectRoot);
+    if (!devCmd) {
+        console.error("  No dev script found in package.json (looked for: dev, start, serve)");
+        return null;
+    }
+    console.log(`  Starting dev server: ${devCmd.command}`);
+    const proc = spawn(devCmd.command, {
+        cwd: projectRoot,
+        shell: true,
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+    });
+    // Wait for server to be ready (poll port)
+    const port = devCmd.expectedPort;
+    const maxWait = 30_000;
+    const start = Date.now();
+    let ready = false;
+    while (Date.now() - start < maxWait) {
+        // Check if process died
+        if (proc.exitCode !== null) {
+            console.error(`  Dev server exited with code ${proc.exitCode}`);
+            return null;
+        }
+        if (await probePort(port)) {
+            ready = true;
+            break;
+        }
+        await new Promise((r) => setTimeout(r, 1000));
+    }
+    if (!ready) {
+        // Try nearby ports in case the detected port was wrong
+        for (const p of [3000, 3001, 5173, 5174, 4321, 8080]) {
+            if (p !== port && await probePort(p)) {
+                console.log(`  Server responded on port ${p} (expected ${port})`);
+                return { proc, url: `http://localhost:${p}`, port: p };
+            }
+        }
+        console.error(`  Dev server did not respond on port ${port} within ${maxWait / 1000}s`);
+        proc.kill();
+        return null;
+    }
+    return { proc, url: `http://localhost:${port}`, port };
+}
+//# sourceMappingURL=designqc-capture.js.map

package/dist/src/designqc/designqc-capture.js.map

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

package/dist/src/designqc/designqc-engine.js

@@ -0,0 +1,159 @@
+import * as path from "node:path";
+import * as fs from "node:fs";
+import { appendText, writeJSON } from "../utils/fs-safe.js";
+import { findChromePath, captureRouteSectioned, detectRoutes, detectDevServer, detectDeployedUrl, startDevServer, } from "./designqc-capture.js";
+import { DEFAULT_VIEWPORTS } from "./designqc-types.js";
+export class DesignQCEngine {
+    wolfDir;
+    projectRoot;
+    options;
+    constructor(wolfDir, projectRoot, options) {
+        this.wolfDir = wolfDir;
+        this.projectRoot = projectRoot;
+        this.options = options;
+    }
+    async capture() {
+        let baseUrl = this.options.devServerUrl;
+        let serverProc = null;
+        let weStartedServer = false;
+        try {
+            // 1. Find or start server — try a deployed URL first, then a local dev server (#4, bug 4)
+            if (!baseUrl) {
+                const deployedUrl = detectDeployedUrl(this.projectRoot);
+                if (deployedUrl) {
+                    baseUrl = deployedUrl;
+                    console.log(`  Detected deployed URL: ${baseUrl}`);
+                }
+                else {
+                    console.log("  Checking for running dev server...");
+                    const existing = await detectDevServer();
+                    if (existing) {
+                        baseUrl = existing.url;
+                        console.log(`  Found running server at ${baseUrl}`);
+                    }
+                    else {
+                        console.log("  No running server found. Starting dev server...");
+                        const started = await startDevServer(this.projectRoot);
+                        if (!started) {
+                            console.error("  Could not start dev server. Add a 'homepage' to package.json or use --url to specify the URL.");
+                            return { screenshots: [], captureDir: "", totalSizeKB: 0, estimatedTokens: 0 };
+                        }
+                        baseUrl = started.url;
+                        serverProc = started.proc;
+                        weStartedServer = true;
+                        console.log(`  Dev server ready at ${baseUrl}`);
+                    }
+                }
+            }
+            // 2. Detect routes
+            let routes = this.options.routes || [];
+            if (routes.length === 0) {
+                routes = detectRoutes(this.projectRoot);
+            }
+            console.log(`  Routes: ${routes.join(", ")}`);
+            // 3. Prepare output directory
+            const captureDir = path.join(this.wolfDir, "designqc-captures");
+            if (fs.existsSync(captureDir)) {
+                for (const f of fs.readdirSync(captureDir)) {
+                    fs.unlinkSync(path.join(captureDir, f));
+                }
+            }
+            else {
+                fs.mkdirSync(captureDir, { recursive: true });
+            }
+            // 4. Launch browser
+            console.log("  Launching browser...");
+            const chromePath = findChromePath(this.options.chromePath);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            let puppeteer;
+            try {
+                puppeteer = await import("puppeteer-core");
+            }
+            catch {
+                console.error("puppeteer-core is required for designqc. Install it with: pnpm add puppeteer-core");
+                return { screenshots: [], captureDir: "", totalSizeKB: 0, estimatedTokens: 0 };
+            }
+            const browser = await puppeteer.default.launch({
+                executablePath: chromePath,
+                headless: true,
+                args: ["--no-sandbox", "--disable-setuid-sandbox"],
+            });
+            const viewports = this.options.viewports || DEFAULT_VIEWPORTS;
+            const allScreenshots = [];
+            try {
+                const page = await browser.newPage();
+                for (const route of routes) {
+                    for (const viewport of viewports) {
+                        if (allScreenshots.length >= this.options.maxScreenshots)
+                            break;
+                        const url = `${baseUrl}${route}`;
+                        console.log(`  Capturing ${route} (${viewport.name}) — full page sections...`);
+                        try {
+                            const sections = await captureRouteSectioned(page, url, viewport, captureDir, this.options.quality, this.options.maxWidth);
+                            // Respect max screenshots limit
+                            const remaining = this.options.maxScreenshots - allScreenshots.length;
+                            allScreenshots.push(...sections.slice(0, remaining));
+                        }
+                        catch (err) {
+                            console.error(`  Failed to capture ${url}: ${err.message}`);
+                        }
+                    }
+                    if (allScreenshots.length >= this.options.maxScreenshots)
+                        break;
+                }
+                await page.close();
+            }
+            finally {
+                await browser.close();
+            }
+            // 5. Calculate sizes and token estimates
+            let totalSizeBytes = 0;
+            for (const s of allScreenshots) {
+                try {
+                    totalSizeBytes += fs.statSync(s.path).size;
+                }
+                catch { }
+            }
+            const totalSizeKB = Math.round(totalSizeBytes / 1024);
+            const estimatedTokens = allScreenshots.length * 2500;
+            // 6. Print results
+            console.log("");
+            console.log(`  Captured ${allScreenshots.length} screenshot(s) across ${routes.length} route(s)`);
+            console.log(`  Total size: ${totalSizeKB}KB`);
+            console.log(`  Estimated token cost: ~${estimatedTokens} tokens`);
+            console.log(`  Saved to: ${captureDir}`);
+            console.log("");
+            console.log("  Screenshots:");
+            for (const s of allScreenshots) {
+                const sizeKB = Math.round(fs.statSync(s.path).size / 1024);
+                console.log(`    ${path.basename(s.path)} (${sizeKB}KB)`);
+            }
+            console.log("");
+            console.log("  Ask Claude: \"Read the screenshots in .wolf/designqc-captures/ and evaluate the design\"");
+            // 7. Write the report so the dashboard's Design QC panel can show it (#4, bug 4).
+            writeJSON(path.join(this.wolfDir, "designqc-report.json"), {
+                captured_at: new Date().toISOString(),
+                captures: allScreenshots.map((s) => ({
+                    file: path.basename(s.path),
+                    viewport: s.viewport.name,
+                    route: s.route,
+                })),
+                total_size_kb: totalSizeKB,
+                estimated_tokens: estimatedTokens,
+            });
+            // 8. Log to memory
+            const now = new Date();
+            const timeStr = `${String(now.getHours()).padStart(2, "0")}:${String(now.getMinutes()).padStart(2, "0")}`;
+            appendText(path.join(this.wolfDir, "memory.md"), `| ${timeStr} | designqc: captured ${allScreenshots.length} screenshots (${totalSizeKB}KB, ~${estimatedTokens} tok) | ${routes.join(", ")} | ready for eval | ~0 |\n`);
+            return { screenshots: allScreenshots, captureDir, totalSizeKB, estimatedTokens };
+        }
+        finally {
+            // 8. Kill dev server if we started it
+            if (weStartedServer && serverProc) {
+                console.log("  Stopping dev server...");
+                serverProc.kill();
+            }
+        }
+    }
+}
+//# sourceMappingURL=designqc-engine.js.map

package/dist/src/designqc/designqc-engine.js.map

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

package/dist/src/designqc/designqc-types.js

@@ -0,0 +1,5 @@
+export const DEFAULT_VIEWPORTS = [
+    { name: "desktop", width: 1440, height: 900 },
+    { name: "mobile", width: 375, height: 812 },
+];
+//# sourceMappingURL=designqc-types.js.map

package/dist/src/designqc/designqc-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"designqc-types.js","sourceRoot":"","sources":["../../../src/designqc/designqc-types.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAC7C,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;CAC5C,CAAC"}

package/dist/src/hooks/post-read.js

@@ -0,0 +1,86 @@
+import * as path from "node:path";
+import { getWolfDir, ensureWolfDir, readJSON, writeJSON, readMarkdown, parseAnatomy, estimateTokens, readStdin, normalizePath, loadIgnore, isSecretFile } from "./shared.js";
+async function main() {
+    ensureWolfDir();
+    const wolfDir = getWolfDir();
+    const hooksDir = path.join(wolfDir, "hooks");
+    const sessionFile = path.join(hooksDir, "_session.json");
+    const raw = await readStdin();
+    let input;
+    try {
+        input = JSON.parse(raw);
+    }
+    catch {
+        process.exit(0);
+        return;
+    }
+    const filePath = input.tool_input?.file_path ?? input.tool_input?.path ?? "";
+    const content = input.tool_output?.content ?? "";
+    if (!filePath) {
+        process.exit(0);
+        return;
+    }
+    const normalizedFile = normalizePath(filePath);
+    // Skip tracking for .wolf/ internal files — consistent with pre-read
+    const projectDir = normalizePath(process.env.CLAUDE_PROJECT_DIR || process.cwd());
+    const relToProject = normalizedFile.startsWith(projectDir)
+        ? normalizedFile.slice(projectDir.length).replace(/^\//, "")
+        : "";
+    // Don't track reads of files outside the project root (upstream #56). relToProject is ""
+    // both when the path is outside projectDir and when it equals the root itself — neither
+    // is a trackable project file.
+    if (!relToProject) {
+        process.exit(0);
+        return;
+    }
+    if (relToProject.startsWith(".wolf/") || relToProject.startsWith(".wolf\\")) {
+        process.exit(0);
+        return;
+    }
+    // Skip anything matched by .gitignore / .wolfignore — don't track ignored reads.
+    if (loadIgnore(projectDir)(relToProject)) {
+        process.exit(0);
+        return;
+    }
+    // Never track secret-bearing files in the ledger (#54).
+    if (isSecretFile(normalizedFile)) {
+        process.exit(0);
+        return;
+    }
+    const ext = path.extname(filePath).toLowerCase();
+    const codeExts = new Set([".ts", ".js", ".tsx", ".jsx", ".py", ".rs", ".go", ".java", ".c", ".cpp", ".css", ".json", ".yaml", ".yml", ".dart"]);
+    const proseExts = new Set([".md", ".txt", ".rst"]);
+    const type = codeExts.has(ext) ? "code" : proseExts.has(ext) ? "prose" : "mixed";
+    let tokens = content ? estimateTokens(content, type) : 0;
+    // Fallback: if tool_output had no content, use anatomy token estimate
+    if (tokens === 0) {
+        const anatomyContent = readMarkdown(path.join(wolfDir, "anatomy.md"));
+        const sections = parseAnatomy(anatomyContent);
+        for (const [sectionKey, entries] of sections) {
+            for (const entry of entries) {
+                const entryRelPath = normalizePath(path.join(sectionKey, entry.file));
+                if (normalizedFile.endsWith(entryRelPath) || normalizedFile.endsWith("/" + entryRelPath)) {
+                    tokens = entry.tokens;
+                    break;
+                }
+            }
+            if (tokens > 0)
+                break;
+        }
+    }
+    const session = readJSON(sessionFile, { files_read: {} });
+    if (session.files_read[normalizedFile]) {
+        session.files_read[normalizedFile].tokens = tokens;
+    }
+    else {
+        session.files_read[normalizedFile] = {
+            count: 1,
+            tokens,
+            first_read: new Date().toISOString(),
+        };
+    }
+    writeJSON(sessionFile, session);
+    process.exit(0);
+}
+main().catch(() => process.exit(0));
+//# sourceMappingURL=post-read.js.map

package/dist/src/hooks/post-read.js.map

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