haiku-method 2.3.0 → 3.1.0

package/lib/capture-playwright-worker.js

@@ -7,127 +7,133 @@
 // Usage:
 //   node capture-playwright-worker.js '{"url":"http://localhost:3000","routes":"/,/about",...}'
 
-const { chromium } = require("playwright");
-const path = require("path");
-const fs = require("fs");
+const { chromium } = require("playwright")
+const path = require("path")
+const fs = require("fs")
 
 const BREAKPOINT_NAMES = {
-  375: "mobile",
-  768: "tablet",
-  1280: "desktop",
-};
+	375: "mobile",
+	768: "tablet",
+	1280: "desktop",
+}
 
 function breakpointName(width) {
-  return BREAKPOINT_NAMES[width] || String(width);
+	return BREAKPOINT_NAMES[width] || String(width)
 }
 
 function viewName(route) {
-  if (route === "/") return "home";
-  // Strip leading slash, replace remaining slashes with dashes
-  return route.replace(/^\//, "").replace(/\//g, "-");
+	if (route === "/") return "home"
+	// Strip leading slash, replace remaining slashes with dashes
+	return route.replace(/^\//, "").replace(/\//g, "-")
 }
 
 async function main() {
-  const rawArgs = process.argv[2];
-  if (!rawArgs) {
-    console.error("ai-dlc: capture-playwright-worker: no arguments provided");
-    process.exit(1);
-  }
-
-  let args;
-  try {
-    args = JSON.parse(rawArgs);
-  } catch (e) {
-    console.error(
-      "ai-dlc: capture-playwright-worker: invalid JSON arguments:",
-      e.message
-    );
-    process.exit(1);
-  }
-
-  const {
-    url,
-    static: staticPath,
-    routes: routesStr,
-    outputDir,
-    breakpoints: breakpointsStr,
-    prefix,
-    waitFor,
-  } = args;
-
-  // In static mode (single file), routes are irrelevant — always capture one view per breakpoint.
-  // Iterating multiple routes against a static file produces duplicate screenshots with misleading names.
-  const allRoutes = routesStr.split(",").map((r) => r.trim());
-  const routes = staticPath && !fs.statSync(staticPath).isDirectory() ? ["/"] : allRoutes;
-  const breakpoints = breakpointsStr.split(",").map((b) => parseInt(b.trim(), 10));
-  const screenshots = [];
-
-  let browser;
-  try {
-    browser = await chromium.launch({ headless: true });
-
-    for (const bp of breakpoints) {
-      const context = await browser.newContext({
-        viewport: { width: bp, height: 900 },
-      });
-      const page = await context.newPage();
-
-      for (const route of routes) {
-        let targetUrl;
-        if (staticPath) {
-          targetUrl = `file://${staticPath}`;
-        } else {
-          // Join base URL with route, avoiding double slashes
-          const base = url.replace(/\/$/, "");
-          targetUrl = route === "/" ? base : `${base}${route}`;
-        }
-
-        await page.goto(targetUrl, { waitUntil: "networkidle" });
-
-        if (waitFor) {
-          await page.waitForSelector(waitFor, { timeout: 10000 });
-        }
-
-        const bpName = breakpointName(bp);
-        const view = viewName(route);
-        const filename = prefix
-          ? `${prefix}${bpName}-${view}.png`
-          : `${bpName}-${view}.png`;
-        const filepath = path.join(outputDir, filename);
-
-        await page.screenshot({ path: filepath, fullPage: true });
-
-        screenshots.push({
-          breakpoint: bp,
-          view: view,
-          path: filename,
-        });
-
-        console.log(`  captured: ${filename} (${bp}px)`);
-      }
-
-      await context.close();
-    }
-
-    // Write manifest
-    const manifest = {
-      provider: "playwright",
-      captured_at: new Date().toISOString(),
-      breakpoints: breakpoints,
-      screenshots: screenshots,
-    };
-
-    const manifestPath = path.join(outputDir, "manifest.json");
-    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
-    console.log(`  manifest: ${manifestPath}`);
-  } catch (err) {
-    console.error("ai-dlc: capture-playwright-worker: capture failed:", err.message);
-    process.exit(1);
-  } finally {
-    if (browser) {
-      await browser.close();
-    }
-  }
+	const rawArgs = process.argv[2]
+	if (!rawArgs) {
+		console.error("ai-dlc: capture-playwright-worker: no arguments provided")
+		process.exit(1)
+	}
+
+	let args
+	try {
+		args = JSON.parse(rawArgs)
+	} catch (e) {
+		console.error(
+			"ai-dlc: capture-playwright-worker: invalid JSON arguments:",
+			e.message,
+		)
+		process.exit(1)
+	}
+
+	const {
+		url,
+		static: staticPath,
+		routes: routesStr,
+		outputDir,
+		breakpoints: breakpointsStr,
+		prefix,
+		waitFor,
+	} = args
+
+	// In static mode (single file), routes are irrelevant — always capture one view per breakpoint.
+	// Iterating multiple routes against a static file produces duplicate screenshots with misleading names.
+	const allRoutes = routesStr.split(",").map((r) => r.trim())
+	const routes =
+		staticPath && !fs.statSync(staticPath).isDirectory() ? ["/"] : allRoutes
+	const breakpoints = breakpointsStr
+		.split(",")
+		.map((b) => parseInt(b.trim(), 10))
+	const screenshots = []
+
+	let browser
+	try {
+		browser = await chromium.launch({ headless: true })
+
+		for (const bp of breakpoints) {
+			const context = await browser.newContext({
+				viewport: { width: bp, height: 900 },
+			})
+			const page = await context.newPage()
+
+			for (const route of routes) {
+				let targetUrl
+				if (staticPath) {
+					targetUrl = `file://${staticPath}`
+				} else {
+					// Join base URL with route, avoiding double slashes
+					const base = url.replace(/\/$/, "")
+					targetUrl = route === "/" ? base : `${base}${route}`
+				}
+
+				await page.goto(targetUrl, { waitUntil: "networkidle" })
+
+				if (waitFor) {
+					await page.waitForSelector(waitFor, { timeout: 10000 })
+				}
+
+				const bpName = breakpointName(bp)
+				const view = viewName(route)
+				const filename = prefix
+					? `${prefix}${bpName}-${view}.png`
+					: `${bpName}-${view}.png`
+				const filepath = path.join(outputDir, filename)
+
+				await page.screenshot({ path: filepath, fullPage: true })
+
+				screenshots.push({
+					breakpoint: bp,
+					view: view,
+					path: filename,
+				})
+
+				console.log(`  captured: ${filename} (${bp}px)`)
+			}
+
+			await context.close()
+		}
+
+		// Write manifest
+		const manifest = {
+			provider: "playwright",
+			captured_at: new Date().toISOString(),
+			breakpoints: breakpoints,
+			screenshots: screenshots,
+		}
+
+		const manifestPath = path.join(outputDir, "manifest.json")
+		fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n")
+		console.log(`  manifest: ${manifestPath}`)
+	} catch (err) {
+		console.error(
+			"ai-dlc: capture-playwright-worker: capture failed:",
+			err.message,
+		)
+		process.exit(1)
+	} finally {
+		if (browser) {
+			await browser.close()
+		}
+	}
 }
 
-main();
+main()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "haiku-method",
-  "version": "2.3.0",
+  "version": "3.1.0",
   "description": "H·AI·K·U methodology — universal lifecycle orchestration with hat-based workflows, completion criteria, and automatic context preservation.",
   "homepage": "https://haikumethod.ai",
   "repository": {

package/schemas/providers/hubspot.schema.json

@@ -15,14 +15,16 @@
 			"additionalProperties": {
 				"type": "string"
 			},
-			"examples": [{
-				"appointmentscheduled": "research",
-				"qualifiedtobuy": "qualification",
-				"presentationscheduled": "proposal",
-				"decisionmakerboughtin": "negotiation",
-				"closedwon": "close",
-				"closedlost": "close"
-			}]
+			"examples": [
+				{
+					"appointmentscheduled": "research",
+					"qualifiedtobuy": "qualification",
+					"presentationscheduled": "proposal",
+					"decisionmakerboughtin": "negotiation",
+					"closedwon": "close",
+					"closedlost": "close"
+				}
+			]
 		},
 		"sync_activities": {
 			"type": "boolean",

package/schemas/providers/jira.schema.json

@@ -29,7 +29,9 @@
 				"type": "array",
 				"items": { "type": "string" }
 			},
-			"examples": [{ "backend": ["Elixir"], "frontend": ["React", "TypeScript"] }]
+			"examples": [
+				{ "backend": ["Elixir"], "frontend": ["React", "TypeScript"] }
+			]
 		},
 		"story_points": {
 			"type": "string",

package/schemas/providers/openpencil.schema.json

@@ -11,7 +11,16 @@
 		},
 		"default_export_target": {
 			"type": "string",
-			"enum": ["react", "vue", "svelte", "html", "flutter", "swiftui", "compose", "react-native"],
+			"enum": [
+				"react",
+				"vue",
+				"svelte",
+				"html",
+				"flutter",
+				"swiftui",
+				"compose",
+				"react-native"
+			],
 			"default": "react",
 			"description": "Default framework target for code export"
 		},

package/schemas/providers/salesforce.schema.json

@@ -19,14 +19,16 @@
 			"additionalProperties": {
 				"type": "string"
 			},
-			"examples": [{
-				"Prospecting": "research",
-				"Qualification": "qualification",
-				"Proposal/Price Quote": "proposal",
-				"Negotiation/Review": "negotiation",
-				"Closed Won": "close",
-				"Closed Lost": "close"
-			}]
+			"examples": [
+				{
+					"Prospecting": "research",
+					"Qualification": "qualification",
+					"Proposal/Price Quote": "proposal",
+					"Negotiation/Review": "negotiation",
+					"Closed Won": "close",
+					"Closed Lost": "close"
+				}
+			]
 		},
 		"sync_activities": {
 			"type": "boolean",

package/schemas/providers/stack-alerting.schema.json

@@ -7,7 +7,13 @@
 	"properties": {
 		"provider": {
 			"type": "string",
-			"enum": ["pagerduty", "opsgenie", "datadog", "prometheus-alertmanager", "none"],
+			"enum": [
+				"pagerduty",
+				"opsgenie",
+				"datadog",
+				"prometheus-alertmanager",
+				"none"
+			],
 			"description": "Alerting/on-call provider"
 		},
 		"routing": {

package/schemas/providers/stack-monitoring.schema.json

@@ -7,7 +7,14 @@
 	"properties": {
 		"provider": {
 			"type": "string",
-			"enum": ["prometheus", "datadog", "cloudwatch", "newrelic", "otel", "none"],
+			"enum": [
+				"prometheus",
+				"datadog",
+				"cloudwatch",
+				"newrelic",
+				"otel",
+				"none"
+			],
 			"description": "Monitoring provider"
 		},
 		"dashboards": {

package/schemas/settings.schema.json

@@ -192,15 +192,27 @@
 			"allOf": [
 				{
 					"if": { "properties": { "type": { "const": "notion" } } },
-					"then": { "properties": { "config": { "$ref": "providers/notion.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/notion.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "confluence" } } },
-					"then": { "properties": { "config": { "$ref": "providers/confluence.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/confluence.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "google-docs" } } },
-					"then": { "properties": { "config": { "$ref": "providers/google-docs.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/google-docs.schema.json" }
+						}
+					}
 				}
 			]
 		},
@@ -227,19 +239,33 @@
 			"allOf": [
 				{
 					"if": { "properties": { "type": { "const": "jira" } } },
-					"then": { "properties": { "config": { "$ref": "providers/jira.schema.json" } } }
+					"then": {
+						"properties": { "config": { "$ref": "providers/jira.schema.json" } }
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "linear" } } },
-					"then": { "properties": { "config": { "$ref": "providers/linear.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/linear.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "github-issues" } } },
-					"then": { "properties": { "config": { "$ref": "providers/github-issues.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/github-issues.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "gitlab-issues" } } },
-					"then": { "properties": { "config": { "$ref": "providers/gitlab-issues.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/gitlab-issues.schema.json" }
+						}
+					}
 				}
 			]
 		},
@@ -249,7 +275,15 @@
 			"properties": {
 				"type": {
 					"type": "string",
-					"enum": ["canva", "openpencil", "pencil", "penpot", "excalidraw", "figma", "auto"],
+					"enum": [
+						"canva",
+						"openpencil",
+						"pencil",
+						"penpot",
+						"excalidraw",
+						"figma",
+						"auto"
+					],
 					"description": "Design provider type"
 				},
 				"config": {
@@ -266,27 +300,51 @@
 			"allOf": [
 				{
 					"if": { "properties": { "type": { "const": "canva" } } },
-					"then": { "properties": { "config": { "$ref": "providers/canva.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/canva.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "openpencil" } } },
-					"then": { "properties": { "config": { "$ref": "providers/openpencil.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/openpencil.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "pencil" } } },
-					"then": { "properties": { "config": { "$ref": "providers/pencil.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/pencil.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "penpot" } } },
-					"then": { "properties": { "config": { "$ref": "providers/penpot.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/penpot.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "excalidraw" } } },
-					"then": { "properties": { "config": { "$ref": "providers/excalidraw.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/excalidraw.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "figma" } } },
-					"then": { "properties": { "config": { "$ref": "providers/figma.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/figma.schema.json" }
+						}
+					}
 				}
 			]
 		},
@@ -313,15 +371,27 @@
 			"allOf": [
 				{
 					"if": { "properties": { "type": { "const": "slack" } } },
-					"then": { "properties": { "config": { "$ref": "providers/slack.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/slack.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "teams" } } },
-					"then": { "properties": { "config": { "$ref": "providers/teams.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/teams.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "discord" } } },
-					"then": { "properties": { "config": { "$ref": "providers/discord.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/discord.schema.json" }
+						}
+					}
 				}
 			]
 		},
@@ -348,11 +418,19 @@
 			"allOf": [
 				{
 					"if": { "properties": { "type": { "const": "salesforce" } } },
-					"then": { "properties": { "config": { "$ref": "providers/salesforce.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/salesforce.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "hubspot" } } },
-					"then": { "properties": { "config": { "$ref": "providers/hubspot.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/hubspot.schema.json" }
+						}
+					}
 				}
 			]
 		},
@@ -379,15 +457,27 @@
 			"allOf": [
 				{
 					"if": { "properties": { "type": { "const": "notion" } } },
-					"then": { "properties": { "config": { "$ref": "providers/notion.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/notion.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "confluence" } } },
-					"then": { "properties": { "config": { "$ref": "providers/confluence.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/confluence.schema.json" }
+						}
+					}
 				},
 				{
 					"if": { "properties": { "type": { "const": "google-docs" } } },
-					"then": { "properties": { "config": { "$ref": "providers/google-docs.schema.json" } } }
+					"then": {
+						"properties": {
+							"config": { "$ref": "providers/google-docs.schema.json" }
+						}
+					}
 				}
 			]
 		},

package/skills/migrate/SKILL.md

@@ -7,6 +7,23 @@ description: Migrate legacy AI-DLC intents to H·AI·K·U format
 
 Convert legacy `.ai-dlc/` intents to `.haiku/` format.
 
-1. Scan `.ai-dlc/` for intents. If a specific slug is given, migrate that one. Otherwise list and ask.
-2. Run `haiku migrate <slug>` to perform the migration.
-3. After migration, suggest `/haiku:pickup <slug>` to continue execution.
+**Never apply a migration without showing a dry-run first.** Bare `haiku migrate` is rejected by the binary, but the rule still holds when you pass `--all` or a specific slug: dry-run, get the user's OK, then apply.
+
+## Steps
+
+1. List candidates: `ls .ai-dlc/`. If the user named a slug, use that. Otherwise show the list and ask which one(s).
+2. **Dry-run**: `haiku migrate <slug>` (dry-run is the default). Show the user the output — what would be written, where, how many files.
+3. **Get explicit approval** from the user before applying. Don't infer consent from prior context.
+4. **Apply**: `haiku migrate <slug> --apply`. One slug at a time unless the user explicitly approved `--all`.
+5. After migration, suggest `/haiku:pickup <slug>` to continue execution.
+
+## Flags
+
+- `--apply` — actually write. Default is dry-run.
+- `--all` — migrate every intent in `.ai-dlc/`. Pair with `--apply` to commit.
+- `--force` — re-migrate intents that already exist under `.haiku/`. Use sparingly.
+- `--allow-dirty` — skip the git-clean precheck. Don't pass this without user approval; a dirty tree means the migration output gets tangled with unrelated in-progress work.
+
+## Why these rules exist
+
+Bare `haiku migrate --apply` rewrites every intent in `.ai-dlc/` at once. In a monorepo, one such commit shows up in every open MR. The dry-run-then-confirm flow exists so this can't happen by accident.