maestro-flow 0.3.9 → 0.3.11

package/dist/src/hooks/constants.d.ts

@@ -14,16 +14,102 @@ export declare const BRIDGE_PREFIX = "maestro-ctx-";
 export declare const NOTIFY_PREFIX = "maestro-notify-";
 /** Coordinator tracker bridge file prefix in os.tmpdir() */
 export declare const COORD_BRIDGE_PREFIX = "maestro-coord-";
+/** Spec keyword injection dedup bridge file prefix in os.tmpdir() */
+export declare const SPEC_KW_BRIDGE_PREFIX = "maestro-spec-kw-";
 /** Max ms to wait for stdin before exiting (Windows pipe safety) */
 export declare const STDIN_TIMEOUT_MS = 3000;
+/** Powerline right-arrow separator (E0B0 needs Powerline font, fallback to triangle) */
+export declare const PL_SEP: string;
+/** Select icon set based on config */
+export declare const ICONS: {
+    readonly model: "󰮩";
+    readonly milestone: "󰽎";
+    readonly phase: "";
+    readonly coord: "󰑌";
+    readonly task: "";
+    readonly team: "󰡉";
+    readonly dir: "";
+    readonly git: "";
+    readonly ctx: "󰐥";
+} | {
+    readonly model: "✎";
+    readonly milestone: "⚑";
+    readonly phase: "◆";
+    readonly coord: "⚙";
+    readonly task: "▸";
+    readonly team: "👥";
+    readonly dir: "■";
+    readonly git: "◆";
+    readonly ctx: "◔";
+};
+/** Git status icons */
+export declare const GIT_ICONS: {
+    readonly clean: "✓";
+    readonly dirty: "●";
+    readonly conflict: "⚠";
+    readonly ahead: "↑";
+    readonly behind: "↓";
+};
 /**
- * ASCII faces by severity level.
- *
- *   ^_^  — plenty of context (used < 50%)
- *   -_-  — getting used      (used 50–65%)
- *   O_O  — running low       (used 65–80%)
- *   X_X  — critical          (used >= 80%)
+ * RGB background colors — muted Notion-inspired palette.
+ * Each entry: [R, G, B]
  */
+export declare const SEGMENT_BG: {
+    readonly model: readonly [63, 75, 91];
+    readonly milestone: readonly [160, 82, 45];
+    readonly phase: readonly [180, 142, 46];
+    readonly coord: readonly [58, 126, 200];
+    readonly task: readonly [55, 55, 60];
+    readonly team: readonly [123, 94, 167];
+    readonly dir: readonly [45, 134, 89];
+    readonly ctxOk: readonly [45, 134, 89];
+    readonly ctxWarn: readonly [180, 142, 46];
+    readonly ctxAlert: readonly [200, 122, 42];
+    readonly ctxCrit: readonly [196, 64, 64];
+};
+export declare const SEGMENT_FG: {
+    readonly model: readonly [255, 255, 255];
+    readonly milestone: readonly [255, 255, 255];
+    readonly phase: readonly [30, 30, 30];
+    readonly coord: readonly [255, 255, 255];
+    readonly task: readonly [224, 224, 224];
+    readonly team: readonly [255, 255, 255];
+    readonly dir: readonly [255, 255, 255];
+    readonly ctxOk: readonly [255, 255, 255];
+    readonly ctxWarn: readonly [30, 30, 30];
+    readonly ctxAlert: readonly [255, 255, 255];
+    readonly ctxCrit: readonly [255, 255, 255];
+};
+export type CtxLevel = 'ok' | 'warn' | 'alert' | 'crit';
+export declare function getCtxLevel(usedPct: number): CtxLevel;
+export declare function ansiBg(rgb: readonly [number, number, number]): string;
+export declare function ansiFg(rgb: readonly [number, number, number]): string;
+export declare const ANSI_RESET = "\u001B[0m";
+export declare const ANSI_DIM = "\u001B[2m";
+export declare const ANSI_BOLD = "\u001B[1m";
+export declare const ANSI_CYAN = "\u001B[36m";
+export declare const ANSI_BLINK = "\u001B[5m";
+export type StatuslineStyle = 'powerline' | 'text';
+export declare function getStatuslineStyle(): StatuslineStyle;
+/**
+ * Text-mode segment colors — used as foreground on transparent background.
+ * Each color is the "accent" for that segment type.
+ */
+export declare const TEXT_COLORS: {
+    readonly model: readonly [86, 182, 194];
+    readonly milestone: readonly [224, 175, 104];
+    readonly phase: readonly [166, 209, 137];
+    readonly coord: readonly [137, 180, 250];
+    readonly task: readonly [205, 214, 244];
+    readonly team: readonly [203, 166, 247];
+    readonly dir: readonly [249, 226, 175];
+    readonly git: readonly [166, 227, 161];
+    readonly ctxOk: readonly [166, 227, 161];
+    readonly ctxWarn: readonly [249, 226, 175];
+    readonly ctxAlert: readonly [250, 179, 135];
+    readonly ctxCrit: readonly [243, 139, 168];
+    readonly separator: readonly [88, 91, 112];
+};
 export declare const FACES: {
     readonly happy: "^_^";
     readonly neutral: "-_-";
@@ -31,12 +117,6 @@ export declare const FACES: {
     readonly critical: "X_X";
 };
 export type FaceLevel = keyof typeof FACES;
-/** Map used% to face level */
 export declare function getFaceLevel(usedPct: number): FaceLevel;
-/** ANSI color codes by face level */
 export declare const FACE_COLORS: Record<FaceLevel, string>;
-export declare const ANSI_RESET = "\u001B[0m";
-export declare const ANSI_DIM = "\u001B[2m";
-export declare const ANSI_BOLD = "\u001B[1m";
-export declare const ANSI_CYAN = "\u001B[36m";
 //# sourceMappingURL=constants.d.ts.map

package/dist/src/hooks/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/constants.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,sDAAsD;AACtD,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,kDAAkD;AAClD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,wCAAwC;AACxC,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAE5C,uDAAuD;AACvD,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK;;;;;CAKR,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,KAAK,CAAC;AAE3C,8BAA8B;AAC9B,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAKvD;AAED,qCAAqC;AACrC,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAKjD,CAAC;AAEF,eAAO,MAAM,UAAU,cAAY,CAAC;AACpC,eAAO,MAAM,QAAQ,cAAY,CAAC;AAClC,eAAO,MAAM,SAAS,cAAY,CAAC;AACnC,eAAO,MAAM,SAAS,eAAa,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/constants.ts"],"names":[],"mappings":"AAqCA,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,sDAAsD;AACtD,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,kDAAkD;AAClD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,wCAAwC;AACxC,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAE5C,uDAAuD;AACvD,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAMrC,wFAAwF;AACxF,eAAO,MAAM,MAAM,QAA2C,CAAC;AA2B/D,sCAAsC;AACtC,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;CAAkD,CAAC;AAErE,uBAAuB;AACvB,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;CAYb,CAAC;AAOX,eAAO,MAAM,UAAU;;;;;;;;;;;;CAYb,CAAC;AAMX,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAExD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAKrD;AAMD,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAErE;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAErE;AAED,eAAO,MAAM,UAAU,cAAY,CAAC;AACpC,eAAO,MAAM,QAAQ,cAAY,CAAC;AAClC,eAAO,MAAM,SAAS,cAAY,CAAC;AACnC,eAAO,MAAM,SAAS,eAAa,CAAC;AACpC,eAAO,MAAM,UAAU,cAAY,CAAC;AAOpC,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnD,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;CAcd,CAAC;AAGX,eAAO,MAAM,KAAK;;;;;CAKR,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,KAAK,CAAC;AAE3C,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAKvD;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAKjD,CAAC"}

package/dist/src/hooks/constants.js

@@ -1,4 +1,33 @@
 // Shared constants for maestro hooks
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * Read statusline config from maestro config file.
+ * Falls back to env vars, then defaults.
+ */
+function readStatuslineConfig() {
+    // 1. Try maestro config file
+    try {
+        const configPath = join(process.env.MAESTRO_HOME || join(homedir(), '.maestro'), 'config.json');
+        if (existsSync(configPath)) {
+            const cfg = JSON.parse(readFileSync(configPath, 'utf8'));
+            if (cfg.statusline) {
+                return {
+                    style: cfg.statusline.style === 'powerline' ? 'powerline' : 'text',
+                    nerdFont: cfg.statusline.nerdFont === true,
+                };
+            }
+        }
+    }
+    catch { /* ignore */ }
+    // 2. Fall back to env vars
+    const envStyle = process.env.MAESTRO_STATUSLINE_STYLE?.toLowerCase();
+    const style = (envStyle === 'powerline' || envStyle === 'pl') ? 'powerline' : 'text';
+    const nerdFont = process.env.MAESTRO_NERD_FONT === '1';
+    return { style, nerdFont };
+}
+const _slConfig = readStatuslineConfig();
 /** Remaining context % at which WARNING is emitted */
 export const WARNING_THRESHOLD = 35;
 /** Remaining context % at which CRITICAL is emitted */
@@ -15,23 +44,134 @@ export const BRIDGE_PREFIX = 'maestro-ctx-';
 export const NOTIFY_PREFIX = 'maestro-notify-';
 /** Coordinator tracker bridge file prefix in os.tmpdir() */
 export const COORD_BRIDGE_PREFIX = 'maestro-coord-';
+/** Spec keyword injection dedup bridge file prefix in os.tmpdir() */
+export const SPEC_KW_BRIDGE_PREFIX = 'maestro-spec-kw-';
 /** Max ms to wait for stdin before exiting (Windows pipe safety) */
 export const STDIN_TIMEOUT_MS = 3000;
+// ---------------------------------------------------------------------------
+// Powerline statusline — Notion-inspired muted palette
+// ---------------------------------------------------------------------------
+/** Powerline right-arrow separator (E0B0 needs Powerline font, fallback to triangle) */
+export const PL_SEP = _slConfig.nerdFont ? '\uE0B0' : '\u25B6';
+/** Icon sets — Nerd Font (rich) vs Unicode (safe fallback) */
+const ICONS_NERD = {
+    model: '\u{F0BA9}', // 󰮩 nf-md-robot
+    milestone: '\u{F0F4E}', // 󰽎 nf-md-flag_checkered
+    phase: '\uF0E3', //  nf-oct-milestone
+    coord: '\u{F044C}', // 󰑌 nf-md-check_circle_outline
+    task: '\uEACB', //  nf-cod-terminal_cmd
+    team: '\u{F0849}', // 󰡉 nf-md-account_group
+    dir: '\uEA83', //  nf-cod-folder
+    git: '\uE725', //  nf-dev-git_branch
+    ctx: '\u{F0425}', // 󰐥 nf-md-gauge
+};
+const ICONS_UNICODE = {
+    model: '\u270E', // ✎ pencil
+    milestone: '\u2691', // ⚑ flag
+    phase: '\u25C6', // ◆ diamond
+    coord: '\u2699', // ⚙ gear
+    task: '\u25B8', // ▸ triangle
+    team: '\u{1F465}', // 👥 people
+    dir: '\u25A0', // ■ square
+    git: '\u25C6', // ◆ diamond (git branch)
+    ctx: '\u25D4', // ◔ circle with quarter
+};
+/** Select icon set based on config */
+export const ICONS = _slConfig.nerdFont ? ICONS_NERD : ICONS_UNICODE;
+/** Git status icons */
+export const GIT_ICONS = {
+    clean: '✓',
+    dirty: '●',
+    conflict: '⚠',
+    ahead: '↑',
+    behind: '↓',
+};
 /**
- * ASCII faces by severity level.
- *
- *   ^_^  — plenty of context (used < 50%)
- *   -_-  — getting used      (used 50–65%)
- *   O_O  — running low       (used 65–80%)
- *   X_X  — critical          (used >= 80%)
+ * RGB background colors — muted Notion-inspired palette.
+ * Each entry: [R, G, B]
  */
+export const SEGMENT_BG = {
+    model: [63, 75, 91], // slate
+    milestone: [160, 82, 45], // warm brown
+    phase: [180, 142, 46], // gold (muted)
+    coord: [58, 126, 200], // blue
+    task: [55, 55, 60], // charcoal
+    team: [123, 94, 167], // purple
+    dir: [45, 134, 89], // green
+    ctxOk: [45, 134, 89], // green  (0–49%)
+    ctxWarn: [180, 142, 46], // gold   (50–64%)
+    ctxAlert: [200, 122, 42], // orange (65–79%)
+    ctxCrit: [196, 64, 64], // red    (80%+)
+};
+/** Foreground color per segment: white or dark */
+const WHITE = [255, 255, 255];
+const DARK = [30, 30, 30];
+const LIGHT = [224, 224, 224];
+export const SEGMENT_FG = {
+    model: WHITE,
+    milestone: WHITE,
+    phase: DARK,
+    coord: WHITE,
+    task: LIGHT,
+    team: WHITE,
+    dir: WHITE,
+    ctxOk: WHITE,
+    ctxWarn: DARK,
+    ctxAlert: WHITE,
+    ctxCrit: WHITE,
+};
+export function getCtxLevel(usedPct) {
+    if (usedPct < 50)
+        return 'ok';
+    if (usedPct < 65)
+        return 'warn';
+    if (usedPct < 80)
+        return 'alert';
+    return 'crit';
+}
+// ---------------------------------------------------------------------------
+// ANSI helpers (true-color / 24-bit)
+// ---------------------------------------------------------------------------
+export function ansiBg(rgb) {
+    return `\x1b[48;2;${rgb[0]};${rgb[1]};${rgb[2]}m`;
+}
+export function ansiFg(rgb) {
+    return `\x1b[38;2;${rgb[0]};${rgb[1]};${rgb[2]}m`;
+}
+export const ANSI_RESET = '\x1b[0m';
+export const ANSI_DIM = '\x1b[2m';
+export const ANSI_BOLD = '\x1b[1m';
+export const ANSI_CYAN = '\x1b[36m';
+export const ANSI_BLINK = '\x1b[5m';
+export function getStatuslineStyle() {
+    return _slConfig.style;
+}
+/**
+ * Text-mode segment colors — used as foreground on transparent background.
+ * Each color is the "accent" for that segment type.
+ */
+export const TEXT_COLORS = {
+    model: [86, 182, 194], // cyan
+    milestone: [224, 175, 104], // warm gold
+    phase: [166, 209, 137], // soft green
+    coord: [137, 180, 250], // light blue
+    task: [205, 214, 244], // white-ish
+    team: [203, 166, 247], // lavender
+    dir: [249, 226, 175], // yellow
+    git: [166, 227, 161], // green
+    ctxOk: [166, 227, 161], // green
+    ctxWarn: [249, 226, 175], // yellow
+    ctxAlert: [250, 179, 135], // peach
+    ctxCrit: [243, 139, 168], // red/pink
+    separator: [88, 91, 112], // dim gray for |
+};
+// Legacy face exports (kept for context-monitor compatibility)
 export const FACES = {
     happy: '^_^',
     neutral: '-_-',
     alert: 'O_O',
     critical: 'X_X',
 };
-/** Map used% to face level */
 export function getFaceLevel(usedPct) {
     if (usedPct < 50)
         return 'happy';
@@ -41,15 +181,10 @@ export function getFaceLevel(usedPct) {
         return 'alert';
     return 'critical';
 }
-/** ANSI color codes by face level */
 export const FACE_COLORS = {
-    happy: '\x1b[32m', // green
-    neutral: '\x1b[33m', // yellow
-    alert: '\x1b[38;5;208m', // orange
-    critical: '\x1b[5;31m', // blinking red
+    happy: '\x1b[32m',
+    neutral: '\x1b[33m',
+    alert: '\x1b[38;5;208m',
+    critical: '\x1b[5;31m',
 };
-export const ANSI_RESET = '\x1b[0m';
-export const ANSI_DIM = '\x1b[2m';
-export const ANSI_BOLD = '\x1b[1m';
-export const ANSI_CYAN = '\x1b[36m';
 //# sourceMappingURL=constants.js.map

package/dist/src/hooks/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/constants.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,uDAAuD;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,kDAAkD;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,yDAAyD;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE/C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEpD,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAK,KAAK;IACf,OAAO,EAAG,KAAK;IACf,KAAK,EAAK,KAAK;IACf,QAAQ,EAAE,KAAK;CACP,CAAC;AAIX,8BAA8B;AAC9B,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IACjC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IACjC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,KAAK,EAAK,UAAU,EAAQ,QAAQ;IACpC,OAAO,EAAG,UAAU,EAAQ,SAAS;IACrC,KAAK,EAAK,gBAAgB,EAAE,SAAS;IACrC,QAAQ,EAAE,YAAY,EAAM,eAAe;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAS,CAAC;AAClC,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC;AACnC,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/constants.ts"],"names":[],"mappings":"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"}

package/dist/src/hooks/guards/index.d.ts

@@ -1,3 +1,5 @@
 export { WorkflowGuard } from './workflow-guard.js';
 export { PromptGuard } from './prompt-guard.js';
+export { evaluatePreflightGuard, loadPreflightConfig } from './preflight-guard.js';
+export { evaluateSpecValidator } from './spec-validator.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/hooks/guards/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/guards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/guards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/hooks/guards/index.js

@@ -1,3 +1,5 @@
 export { WorkflowGuard } from './workflow-guard.js';
 export { PromptGuard } from './prompt-guard.js';
+export { evaluatePreflightGuard, loadPreflightConfig } from './preflight-guard.js';
+export { evaluateSpecValidator } from './spec-validator.js';
 //# sourceMappingURL=index.js.map

package/dist/src/hooks/guards/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/hooks/guards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/hooks/guards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/hooks/guards/preflight-guard.d.ts

@@ -0,0 +1,29 @@
+export interface PreflightGuardResult {
+    /** True if the guard wants to block (only when mode = 'block'). */
+    blocked: boolean;
+    /** Warning lines (always populated when conflicts exist). */
+    warnings: string[];
+    /** Number of conflicting teammates. */
+    conflictCount: number;
+}
+export interface PreflightGuardConfig {
+    /** 'warn' = emit warnings, 'block' = reject the operation. Default: 'warn' */
+    mode: 'warn' | 'block';
+    /** Activity look-back window in minutes. Default: 30 */
+    windowMin: number;
+    /** Whether to run automatically. Default: true */
+    enabled: boolean;
+}
+/**
+ * Load preflight guard config from `.workflow/config.json` → `collab` section.
+ * Returns defaults on any error.
+ */
+export declare function loadPreflightConfig(projectRoot: string): PreflightGuardConfig;
+/**
+ * Evaluate whether the current phase has active teammates.
+ *
+ * Pure function — takes explicit dependencies for testability.
+ * Never throws.
+ */
+export declare function evaluatePreflightGuard(projectRoot: string, config?: Partial<PreflightGuardConfig>): PreflightGuardResult;
+//# sourceMappingURL=preflight-guard.d.ts.map

package/dist/src/hooks/guards/preflight-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-guard.d.ts","sourceRoot":"","sources":["../../../../src/hooks/guards/preflight-guard.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;CAClB;AAYD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAiB7E;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,oBAAoB,CA6BtB"}

package/dist/src/hooks/guards/preflight-guard.js

@@ -0,0 +1,95 @@
+// ---------------------------------------------------------------------------
+// PreflightGuard — Warns when teammates are active on the same phase
+//
+// Runs as a PreToolUse hook on write operations (Bash|Write|Edit|Agent).
+// Advisory by default (emits warning context), configurable to block.
+//
+// Namespace: reads `.workflow/collab/activity.jsonl` (never writes).
+// ---------------------------------------------------------------------------
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveSelf } from '../../tools/team-members.js';
+import { runPreflight } from '../preflight-core.js';
+// ---------------------------------------------------------------------------
+// Config loading
+// ---------------------------------------------------------------------------
+const DEFAULT_CONFIG = {
+    mode: 'warn',
+    windowMin: 30,
+    enabled: true,
+};
+/**
+ * Load preflight guard config from `.workflow/config.json` → `collab` section.
+ * Returns defaults on any error.
+ */
+export function loadPreflightConfig(projectRoot) {
+    try {
+        const configPath = join(projectRoot, '.workflow', 'config.json');
+        if (!existsSync(configPath))
+            return DEFAULT_CONFIG;
+        const raw = JSON.parse(readFileSync(configPath, 'utf-8'));
+        const collab = raw?.collab;
+        if (!collab)
+            return DEFAULT_CONFIG;
+        return {
+            mode: collab.preflight_mode === 'block' ? 'block' : 'warn',
+            windowMin: typeof collab.preflight_window_min === 'number'
+                ? collab.preflight_window_min
+                : DEFAULT_CONFIG.windowMin,
+            enabled: collab.auto_preflight !== false,
+        };
+    }
+    catch {
+        return DEFAULT_CONFIG;
+    }
+}
+// ---------------------------------------------------------------------------
+// Core evaluation
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate whether the current phase has active teammates.
+ *
+ * Pure function — takes explicit dependencies for testability.
+ * Never throws.
+ */
+export function evaluatePreflightGuard(projectRoot, config) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    if (!cfg.enabled) {
+        return { blocked: false, warnings: [], conflictCount: 0 };
+    }
+    const self = resolveSelf();
+    if (!self) {
+        return { blocked: false, warnings: [], conflictCount: 0 };
+    }
+    // Read current phase from state.json
+    const phase = readCurrentPhase(projectRoot);
+    if (phase === null) {
+        return { blocked: false, warnings: [], conflictCount: 0 };
+    }
+    const result = runPreflight(phase, { force: cfg.mode !== 'block' });
+    if (result.conflicts.length === 0) {
+        return { blocked: false, warnings: [], conflictCount: 0 };
+    }
+    return {
+        blocked: cfg.mode === 'block' && result.exitCode !== 0,
+        warnings: result.warnings,
+        conflictCount: result.conflicts.length,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function readCurrentPhase(projectRoot) {
+    try {
+        const statePath = join(projectRoot, '.workflow', 'state.json');
+        if (!existsSync(statePath))
+            return null;
+        const state = JSON.parse(readFileSync(statePath, 'utf-8'));
+        const phase = state?.current_phase;
+        return typeof phase === 'number' ? phase : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=preflight-guard.js.map

package/dist/src/hooks/guards/preflight-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-guard.js","sourceRoot":"","sources":["../../../../src/hooks/guards/preflight-guard.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,EAAE;AACF,qEAAqE;AACrE,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAwB,MAAM,sBAAsB,CAAC;AAwB1E,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,cAAc,GAAyB;IAC3C,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,IAAI;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,cAAc,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAO,cAAc,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;YAC1D,SAAS,EAAE,OAAO,MAAM,CAAC,oBAAoB,KAAK,QAAQ;gBACxD,CAAC,CAAC,MAAM,CAAC,oBAAoB;gBAC7B,CAAC,CAAC,cAAc,CAAC,SAAS;YAC5B,OAAO,EAAE,MAAM,CAAC,cAAc,KAAK,KAAK;SACzC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,MAAsC;IAEtC,MAAM,GAAG,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAE7C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,qCAAqC;IACrC,MAAM,KAAK,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IAEpE,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QACtD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;KACvC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,KAAK,EAAE,aAAa,CAAC;QACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/hooks/guards/spec-validator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Spec Validator Guard — PreToolUse: Write|Edit
+ *
+ * Validates that spec file entries use the <spec-entry> closed-tag format.
+ * Pure evaluation function — no I/O, follows workflow-guard.ts pattern.
+ *
+ * Only activates when the file path targets .workflow/specs/.
+ */
+export interface SpecValidatorResult {
+    valid: boolean;
+    mode: 'warn' | 'block';
+    errors: Array<{
+        line: number;
+        message: string;
+    }>;
+}
+/**
+ * Evaluate spec file content for format compliance.
+ *
+ * @param filePath  Absolute or relative file path being written
+ * @param content   The full file content after the write/edit
+ * @param mode      'warn' (advisory) or 'block' (reject write)
+ */
+export declare function evaluateSpecValidator(filePath: string, content: string, mode?: 'warn' | 'block'): SpecValidatorResult;
+//# sourceMappingURL=spec-validator.d.ts.map

package/dist/src/hooks/guards/spec-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-validator.d.ts","sourceRoot":"","sources":["../../../../src/hooks/guards/spec-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,GAAG,OAAgB,GAC9B,mBAAmB,CA2CrB"}

package/dist/src/hooks/guards/spec-validator.js

@@ -0,0 +1,66 @@
+/**
+ * Spec Validator Guard — PreToolUse: Write|Edit
+ *
+ * Validates that spec file entries use the <spec-entry> closed-tag format.
+ * Pure evaluation function — no I/O, follows workflow-guard.ts pattern.
+ *
+ * Only activates when the file path targets .workflow/specs/.
+ */
+import { parseSpecEntries, validateCategoryMatch } from '../../tools/spec-entry-parser.js';
+import { CATEGORY_MAP } from '../../tools/spec-loader.js';
+import { basename } from 'node:path';
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Evaluate spec file content for format compliance.
+ *
+ * @param filePath  Absolute or relative file path being written
+ * @param content   The full file content after the write/edit
+ * @param mode      'warn' (advisory) or 'block' (reject write)
+ */
+export function evaluateSpecValidator(filePath, content, mode = 'warn') {
+    // Only validate files in .workflow/specs/
+    if (!isSpecFile(filePath)) {
+        return { valid: true, mode, errors: [] };
+    }
+    const errors = [];
+    // Determine expected category from filename
+    const fileName = basename(filePath);
+    const expectedCategory = CATEGORY_MAP[fileName];
+    // Parse entries
+    const result = parseSpecEntries(content);
+    // Collect parser-level errors
+    errors.push(...result.errors);
+    // Validate category match per entry
+    if (expectedCategory) {
+        for (const entry of result.entries) {
+            const mismatch = validateCategoryMatch(entry, expectedCategory);
+            if (mismatch) {
+                errors.push({ line: entry.lineStart, message: mismatch });
+            }
+        }
+    }
+    // Check for unclosed tags
+    const openCount = (content.match(/<spec-entry\b/g) || []).length;
+    const closeCount = (content.match(/<\/spec-entry>/g) || []).length;
+    if (openCount !== closeCount) {
+        errors.push({
+            line: 1,
+            message: `Unbalanced tags: ${openCount} opening <spec-entry> vs ${closeCount} closing </spec-entry>`,
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        mode,
+        errors,
+    };
+}
+// ============================================================================
+// Internal
+// ============================================================================
+function isSpecFile(filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    return normalized.includes('.workflow/specs/') && normalized.endsWith('.md');
+}
+//# sourceMappingURL=spec-validator.js.map

package/dist/src/hooks/guards/spec-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-validator.js","sourceRoot":"","sources":["../../../../src/hooks/guards/spec-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAqB,qBAAqB,EAAoB,MAAM,kCAAkC,CAAC;AAChI,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAYrC,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,OAAe,EACf,OAAyB,MAAM;IAE/B,0CAA0C;IAC1C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAA6C,EAAE,CAAC;IAE5D,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,gBAAgB,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEhD,gBAAgB;IAChB,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEzC,8BAA8B;IAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAE9B,oCAAoC;IACpC,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;YAChE,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACjE,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACnE,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,oBAAoB,SAAS,4BAA4B,UAAU,wBAAwB;SACrG,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,SAAS,UAAU,CAAC,QAAgB;IAClC,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC"}

package/dist/src/hooks/index.d.ts

@@ -4,5 +4,6 @@ export { FACES, getFaceLevel, WARNING_THRESHOLD, CRITICAL_THRESHOLD } from './co
 export { SyncHook, AsyncSeriesHook, AsyncSeriesBailHook, AsyncSeriesWaterfallHook } from './hook-engine.js';
 export { WorkflowHookRegistry } from './workflow-hooks.js';
 export { HookManager } from './hook-manager.js';
+export { runPreflight, type PreflightResult, type PreflightDeps } from './preflight-core.js';
 export type { RunContext, NodeContext, CommandContext, CommandResultContext, ErrorContext, DecisionContext, } from './workflow-hooks.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC"}

package/dist/src/hooks/index.js

@@ -4,4 +4,5 @@ export { FACES, getFaceLevel, WARNING_THRESHOLD, CRITICAL_THRESHOLD } from './co
 export { SyncHook, AsyncSeriesHook, AsyncSeriesBailHook, AsyncSeriesWaterfallHook } from './hook-engine.js';
 export { WorkflowHookRegistry } from './workflow-hooks.js';
 export { HookManager } from './hook-manager.js';
+export { runPreflight } from './preflight-core.js';
 //# sourceMappingURL=index.js.map

package/dist/src/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAA4C,MAAM,qBAAqB,CAAC"}