maestro-flow 0.3.10 → 0.3.11

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/keyword-spec-injector.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Keyword Spec Injector — UserPromptSubmit hook
+ *
+ * Scans user prompt for keywords, matches against <spec-entry> keyword attributes,
+ * injects matching entries as additionalContext. Session dedup prevents re-injection.
+ */
+export interface KeywordInjectionResult {
+    inject: boolean;
+    content?: string;
+    matchedKeywords?: string[];
+    matchedEntries?: number;
+}
+/**
+ * Evaluate whether to inject keyword-matched spec entries for a user prompt.
+ *
+ * @param prompt      The user's prompt text
+ * @param projectPath Working directory for spec file resolution
+ * @param sessionId   Session ID for dedup bridge
+ */
+export declare function evaluateKeywordInjection(prompt: string, projectPath: string, sessionId: string): KeywordInjectionResult;
+//# sourceMappingURL=keyword-spec-injector.d.ts.map

package/dist/src/hooks/keyword-spec-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-spec-injector.d.ts","sourceRoot":"","sources":["../../../src/hooks/keyword-spec-injector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA+BD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,sBAAsB,CAqCxB"}

package/dist/src/hooks/keyword-spec-injector.js

@@ -0,0 +1,96 @@
+/**
+ * Keyword Spec Injector — UserPromptSubmit hook
+ *
+ * Scans user prompt for keywords, matches against <spec-entry> keyword attributes,
+ * injects matching entries as additionalContext. Session dedup prevents re-injection.
+ */
+import { buildKeywordIndex, lookupKeywords } from '../tools/spec-keyword-index.js';
+import { markInjected, filterUnjected } from './spec-bridge.js';
+// ============================================================================
+// Config
+// ============================================================================
+const MIN_KEYWORD_LENGTH = 3;
+/** Common words to skip when tokenizing prompt */
+const STOP_WORDS = new Set([
+    'the', 'and', 'for', 'are', 'but', 'not', 'you', 'all', 'can', 'had',
+    'her', 'was', 'one', 'our', 'out', 'has', 'his', 'how', 'its', 'may',
+    'new', 'now', 'old', 'see', 'way', 'who', 'did', 'get', 'let', 'say',
+    'she', 'too', 'use', 'this', 'that', 'with', 'have', 'from', 'they',
+    'been', 'said', 'each', 'make', 'like', 'just', 'over', 'such', 'take',
+    'than', 'them', 'very', 'when', 'what', 'some', 'time', 'will', 'into',
+    'look', 'only', 'come', 'also', 'back', 'after', 'work', 'first', 'well',
+    'then', 'year', 'your', 'them', 'would', 'there', 'their', 'which',
+    'about', 'could', 'other', 'these', 'think', 'should', 'please',
+    // code-related common words to skip
+    'file', 'code', 'function', 'class', 'import', 'export', 'const', 'return',
+    'true', 'false', 'null', 'undefined', 'string', 'number', 'type', 'interface',
+]);
+/** Max entries to inject per prompt to avoid context bloat */
+const MAX_ENTRIES_PER_INJECTION = 5;
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Evaluate whether to inject keyword-matched spec entries for a user prompt.
+ *
+ * @param prompt      The user's prompt text
+ * @param projectPath Working directory for spec file resolution
+ * @param sessionId   Session ID for dedup bridge
+ */
+export function evaluateKeywordInjection(prompt, projectPath, sessionId) {
+    // 1. Tokenize prompt into candidate keywords
+    const promptKeywords = tokenizePrompt(prompt);
+    if (promptKeywords.length === 0)
+        return { inject: false };
+    // 2. Build keyword index from spec files
+    const index = buildKeywordIndex(projectPath);
+    if (index.size === 0)
+        return { inject: false };
+    // 3. Look up matching entries
+    const matchedAll = lookupKeywords(index, promptKeywords);
+    if (matchedAll.length === 0)
+        return { inject: false };
+    // 4. Filter out already-injected entries (session dedup)
+    const unjected = filterUnjected(sessionId, matchedAll);
+    if (unjected.length === 0)
+        return { inject: false };
+    // 5. Limit to avoid context bloat
+    const toInject = unjected.slice(0, MAX_ENTRIES_PER_INJECTION);
+    // 6. Build injection content
+    const content = formatInjectionContent(toInject);
+    // 7. Mark as injected
+    const injectedKeywords = [...new Set(toInject.flatMap(e => e.keywords))];
+    const injectedIds = toInject.map(e => e.id);
+    markInjected(sessionId, injectedKeywords, injectedIds);
+    // 8. Determine which prompt keywords actually matched
+    const matchedKws = promptKeywords.filter(kw => index.has(kw));
+    return {
+        inject: true,
+        content,
+        matchedKeywords: matchedKws,
+        matchedEntries: toInject.length,
+    };
+}
+// ============================================================================
+// Internal
+// ============================================================================
+/**
+ * Tokenize prompt into candidate keywords for index lookup.
+ * Lowercase, deduplicate, filter by length and stop words.
+ */
+function tokenizePrompt(prompt) {
+    const words = prompt
+        .toLowerCase()
+        .replace(/[^a-z0-9\u4e00-\u9fff_-]/g, ' ')
+        .split(/\s+/)
+        .filter(w => w.length >= MIN_KEYWORD_LENGTH && !STOP_WORDS.has(w));
+    return [...new Set(words)];
+}
+/**
+ * Format matched entries for injection as context.
+ */
+function formatInjectionContent(entries) {
+    const sections = entries.map(e => `--- ${e.file} (${e.category}) [${e.keywords.join(', ')}] ---\n\n${e.content}`);
+    return `<spec-keyword-match count="${entries.length}">\n\n${sections.join('\n\n---\n\n')}\n\n</spec-keyword-match>`;
+}
+//# sourceMappingURL=keyword-spec-injector.js.map

package/dist/src/hooks/keyword-spec-injector.js.map

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

package/dist/src/hooks/plugins/spec-injection-plugin.d.ts

@@ -9,8 +9,9 @@ import type { WorkflowHookRegistry } from '../workflow-hooks.js';
  */
 export declare class SpecInjectionPlugin implements MaestroPlugin {
     private readonly projectPath;
+    private readonly sessionId;
     readonly name = "specInjection";
-    constructor(projectPath?: string);
+    constructor(projectPath?: string, sessionId?: string);
     apply(registry: WorkflowHookRegistry): void;
 }
 //# sourceMappingURL=spec-injection-plugin.d.ts.map

package/dist/src/hooks/plugins/spec-injection-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-injection-plugin.d.ts","sourceRoot":"","sources":["../../../../src/hooks/plugins/spec-injection-plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAIjE;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IAG3C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAFxC,QAAQ,CAAC,IAAI,mBAAmB;gBAEH,WAAW,GAAE,MAAsB;IAEhE,KAAK,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;CAc5C"}
+{"version":3,"file":"spec-injection-plugin.d.ts","sourceRoot":"","sources":["../../../../src/hooks/plugins/spec-injection-plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAKjE;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IAIrD,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,QAAQ,CAAC,IAAI,mBAAmB;gBAGb,WAAW,GAAE,MAAsB,EACnC,SAAS,GAAE,MAAW;IAGzC,KAAK,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;CAuB5C"}

package/dist/src/hooks/plugins/spec-injection-plugin.js

@@ -3,6 +3,7 @@
 // ---------------------------------------------------------------------------
 import { loadSpecs } from '../../tools/spec-loader.js';
 import { resolveSelf } from '../../tools/team-members.js';
+import { evaluateKeywordInjection } from '../keyword-spec-injector.js';
 /**
  * In-process plugin for `maestro coordinate` — injects relevant specs
  * into the prompt via the `transformPrompt` waterfall hook.
@@ -12,20 +13,30 @@ import { resolveSelf } from '../../tools/team-members.js';
  */
 export class SpecInjectionPlugin {
     projectPath;
+    sessionId;
     name = 'specInjection';
-    constructor(projectPath = process.cwd()) {
+    constructor(projectPath = process.cwd(), sessionId = '') {
         this.projectPath = projectPath;
+        this.sessionId = sessionId;
     }
     apply(registry) {
         registry.transformPrompt.tap(this.name, (prompt) => {
-            // Infer category from prompt content heuristics
+            const parts = [prompt];
+            // Category-based injection
             const category = inferCategory(prompt);
-            // Best-effort uid resolution for personal spec layer
             const uid = resolveUidSafe();
-            const result = loadSpecs(this.projectPath, category, uid);
-            if (!result.content)
-                return prompt;
-            return `${prompt}\n\n---\n\n${result.content}`;
+            const catResult = loadSpecs(this.projectPath, category, uid);
+            if (catResult.content) {
+                parts.push(catResult.content);
+            }
+            // Keyword-based injection (with session dedup)
+            if (this.sessionId) {
+                const kwResult = evaluateKeywordInjection(prompt, this.projectPath, this.sessionId);
+                if (kwResult.inject && kwResult.content) {
+                    parts.push(kwResult.content);
+                }
+            }
+            return parts.length > 1 ? parts.join('\n\n---\n\n') : prompt;
         });
     }
 }
@@ -55,10 +66,8 @@ function inferCategory(prompt) {
         return 'test';
     if (/\b(debug|diagnose|fix|error|bug)\b/.test(lower))
         return 'debug';
-    if (/\b(plan|design|architect|decompose)\b/.test(lower))
-        return 'planning';
-    if (/\b(explore|discover|search|analyze)\b/.test(lower))
-        return 'exploration';
-    return 'execution'; // Default for implementation work
+    if (/\b(plan|design|architect|decompose|explore|discover|search|analyze)\b/.test(lower))
+        return 'arch';
+    return 'coding'; // Default for implementation work
 }
 //# sourceMappingURL=spec-injection-plugin.js.map

package/dist/src/hooks/plugins/spec-injection-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec-injection-plugin.js","sourceRoot":"","sources":["../../../../src/hooks/plugins/spec-injection-plugin.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAI9E,OAAO,EAAE,SAAS,EAAqB,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IAGD;IAFpB,IAAI,GAAG,eAAe,CAAC;IAEhC,YAA6B,cAAsB,OAAO,CAAC,GAAG,EAAE;QAAnC,gBAAW,GAAX,WAAW,CAAwB;IAAG,CAAC;IAEpE,KAAK,CAAC,QAA8B;QAClC,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAc,EAAE,EAAE;YACzD,gDAAgD;YAChD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YAEvC,qDAAqD;YACrD,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YAE1D,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,MAAM,CAAC;YAEnC,OAAO,GAAG,MAAM,cAAc,MAAM,CAAC,OAAO,EAAE,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,OAAO,IAAI,EAAE,GAAG,IAAI,SAAS,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACpE,IAAI,iCAAiC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACjE,IAAI,oCAAoC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACrE,IAAI,uCAAuC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAC3E,IAAI,uCAAuC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAC9E,OAAO,WAAW,CAAC,CAAC,kCAAkC;AACxD,CAAC"}
+{"version":3,"file":"spec-injection-plugin.js","sourceRoot":"","sources":["../../../../src/hooks/plugins/spec-injection-plugin.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAI9E,OAAO,EAAE,SAAS,EAAqB,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IAIX;IACA;IAJV,IAAI,GAAG,eAAe,CAAC;IAEhC,YACmB,cAAsB,OAAO,CAAC,GAAG,EAAE,EACnC,YAAoB,EAAE;QADtB,gBAAW,GAAX,WAAW,CAAwB;QACnC,cAAS,GAAT,SAAS,CAAa;IACtC,CAAC;IAEJ,KAAK,CAAC,QAA8B;QAClC,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAc,EAAE,EAAE;YACzD,MAAM,KAAK,GAAa,CAAC,MAAM,CAAC,CAAC;YAEjC,2BAA2B;YAC3B,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC7D,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;YAED,+CAA+C;YAC/C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,QAAQ,GAAG,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBACpF,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACxC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,OAAO,IAAI,EAAE,GAAG,IAAI,SAAS,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACpE,IAAI,iCAAiC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACjE,IAAI,oCAAoC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACrE,IAAI,uEAAuE,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACvG,OAAO,QAAQ,CAAC,CAAC,kCAAkC;AACrD,CAAC"}

package/dist/src/hooks/spec-bridge.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Spec Keyword Bridge — Session-based dedup for keyword-triggered spec injection.
+ *
+ * Tracks which keywords and entries have already been injected in the current session
+ * to prevent duplicate injection when the same keyword appears in multiple prompts.
+ *
+ * Bridge file: {tmpdir}/maestro-spec-kw-{sessionId}.json
+ */
+export interface SpecKeywordBridge {
+    session_id: string;
+    injected_keywords: string[];
+    injected_entries: string[];
+    updated_at: number;
+}
+/**
+ * Read the spec keyword bridge file for a session.
+ * Returns null if the file does not exist or is unreadable.
+ */
+export declare function readSpecBridge(sessionId: string): SpecKeywordBridge | null;
+/**
+ * Mark keywords and entry IDs as injected for this session.
+ * Merges with existing bridge data (additive, never removes).
+ */
+export declare function markInjected(sessionId: string, keywords: string[], entryIds: string[]): void;
+/**
+ * Check if a keyword has already been injected this session.
+ */
+export declare function isKeywordInjected(sessionId: string, keyword: string): boolean;
+/**
+ * Check if an entry has already been injected this session.
+ */
+export declare function isEntryInjected(sessionId: string, entryId: string): boolean;
+/**
+ * Filter entries to only those not yet injected in this session.
+ * An entry is considered "already injected" if its ID is in the bridge.
+ */
+export declare function filterUnjected<T extends {
+    id: string;
+}>(sessionId: string, entries: T[]): T[];
+//# sourceMappingURL=spec-bridge.d.ts.map

package/dist/src/hooks/spec-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-bridge.d.ts","sourceRoot":"","sources":["../../../src/hooks/spec-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAU1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,EAAE,GACjB,IAAI,CA0BN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAI7E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAI3E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACrD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,EAAE,GACX,CAAC,EAAE,CAML"}

package/dist/src/hooks/spec-bridge.js

@@ -0,0 +1,97 @@
+/**
+ * Spec Keyword Bridge — Session-based dedup for keyword-triggered spec injection.
+ *
+ * Tracks which keywords and entries have already been injected in the current session
+ * to prevent duplicate injection when the same keyword appears in multiple prompts.
+ *
+ * Bridge file: {tmpdir}/maestro-spec-kw-{sessionId}.json
+ */
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { SPEC_KW_BRIDGE_PREFIX } from './constants.js';
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Read the spec keyword bridge file for a session.
+ * Returns null if the file does not exist or is unreadable.
+ */
+export function readSpecBridge(sessionId) {
+    const path = bridgePath(sessionId);
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = readFileSync(path, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Mark keywords and entry IDs as injected for this session.
+ * Merges with existing bridge data (additive, never removes).
+ */
+export function markInjected(sessionId, keywords, entryIds) {
+    const existing = readSpecBridge(sessionId) ?? {
+        session_id: sessionId,
+        injected_keywords: [],
+        injected_entries: [],
+        updated_at: 0,
+    };
+    const kwSet = new Set(existing.injected_keywords);
+    for (const kw of keywords)
+        kwSet.add(kw.toLowerCase());
+    const entrySet = new Set(existing.injected_entries);
+    for (const id of entryIds)
+        entrySet.add(id);
+    const updated = {
+        session_id: sessionId,
+        injected_keywords: [...kwSet],
+        injected_entries: [...entrySet],
+        updated_at: Math.floor(Date.now() / 1000),
+    };
+    try {
+        writeFileSync(bridgePath(sessionId), JSON.stringify(updated), 'utf-8');
+    }
+    catch {
+        // Best-effort — don't fail the hook if bridge write fails
+    }
+}
+/**
+ * Check if a keyword has already been injected this session.
+ */
+export function isKeywordInjected(sessionId, keyword) {
+    const bridge = readSpecBridge(sessionId);
+    if (!bridge)
+        return false;
+    return bridge.injected_keywords.includes(keyword.toLowerCase());
+}
+/**
+ * Check if an entry has already been injected this session.
+ */
+export function isEntryInjected(sessionId, entryId) {
+    const bridge = readSpecBridge(sessionId);
+    if (!bridge)
+        return false;
+    return bridge.injected_entries.includes(entryId);
+}
+/**
+ * Filter entries to only those not yet injected in this session.
+ * An entry is considered "already injected" if its ID is in the bridge.
+ */
+export function filterUnjected(sessionId, entries) {
+    const bridge = readSpecBridge(sessionId);
+    if (!bridge)
+        return entries;
+    const injectedSet = new Set(bridge.injected_entries);
+    return entries.filter(e => !injectedSet.has(e.id));
+}
+// ============================================================================
+// Internal
+// ============================================================================
+function bridgePath(sessionId) {
+    return join(tmpdir(), `${SPEC_KW_BRIDGE_PREFIX}${sessionId}.json`);
+}
+//# sourceMappingURL=spec-bridge.js.map

package/dist/src/hooks/spec-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-bridge.js","sourceRoot":"","sources":["../../../src/hooks/spec-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAavD,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,QAAkB,EAClB,QAAkB;IAElB,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI;QAC5C,UAAU,EAAE,SAAS;QACrB,iBAAiB,EAAE,EAAE;QACrB,gBAAgB,EAAE,EAAE;QACpB,UAAU,EAAE,CAAC;KACd,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAClD,KAAK,MAAM,EAAE,IAAI,QAAQ;QAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IACpD,KAAK,MAAM,EAAE,IAAI,QAAQ;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAsB;QACjC,UAAU,EAAE,SAAS;QACrB,iBAAiB,EAAE,CAAC,GAAG,KAAK,CAAC;QAC7B,gBAAgB,EAAE,CAAC,GAAG,QAAQ,CAAC;QAC/B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;KAC1C,CAAC;IAEF,IAAI,CAAC;QACH,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,OAAe;IAClE,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,OAAO,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,OAAe;IAChE,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,OAAO,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,OAAY;IAEZ,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,SAAS,UAAU,CAAC,SAAiB;IACnC,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,qBAAqB,GAAG,SAAS,OAAO,CAAC,CAAC;AACrE,CAAC"}

package/dist/src/hooks/spec-injector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-injector.d.ts","sourceRoot":"","sources":["../../../src/hooks/spec-injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAM7D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,GAAG,CAAC,EAAE,MAAM,GACX,mBAAmB,CA0CrB"}
+{"version":3,"file":"spec-injector.d.ts","sourceRoot":"","sources":["../../../src/hooks/spec-injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAIvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAM7D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA+BD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,GAAG,CAAC,EAAE,MAAM,GACX,mBAAmB,CAmDrB"}

package/dist/src/hooks/spec-injector.js

@@ -15,23 +15,21 @@ import { resolveSelf } from '../tools/team-members.js';
 // Default agent-type → spec-category mapping
 // ---------------------------------------------------------------------------
 const DEFAULT_AGENT_SPEC_MAP = {
-    // Execution agents → execution specs
-    'code-developer': { categories: ['execution'], extras: [] },
-    'tdd-developer': { categories: ['execution', 'test'], extras: [] },
-    'workflow-executor': { categories: ['execution'], extras: [] },
-    'universal-executor': { categories: ['execution'], extras: [] },
-    'test-fix-agent': { categories: ['execution', 'test'], extras: [] },
-    // Planning agents → planning specs
-    'cli-lite-planning-agent': { categories: ['planning'], extras: [] },
-    'action-planning-agent': { categories: ['planning'], extras: [] },
-    'workflow-planner': { categories: ['planning'], extras: [] },
+    // Execution agents → coding specs
+    'code-developer': { categories: ['coding'], extras: [] },
+    'tdd-developer': { categories: ['coding', 'test'], extras: [] },
+    'workflow-executor': { categories: ['coding'], extras: [] },
+    'universal-executor': { categories: ['coding'], extras: [] },
+    'test-fix-agent': { categories: ['coding', 'test'], extras: [] },
+    // Planning agents → arch specs
+    'cli-lite-planning-agent': { categories: ['arch'], extras: [] },
+    'action-planning-agent': { categories: ['arch'], extras: [] },
+    'workflow-planner': { categories: ['arch'], extras: [] },
     // Review agents → review specs
     'workflow-reviewer': { categories: ['review'], extras: [] },
     // Debug agents → debug specs
     'debug-explore-agent': { categories: ['debug'], extras: [] },
     'workflow-debugger': { categories: ['debug'], extras: [] },
-    // Explore agents → exploration (lightweight)
-    'Explore': { categories: ['exploration'], extras: [] },
 };
 // ---------------------------------------------------------------------------
 // Public API
@@ -65,6 +63,14 @@ export function evaluateSpecInjection(agentType, projectPath, sessionId, config,
             totalCount += result.totalLoaded;
         }
     }
+    if (sections.length === 0 && !sessionId)
+        return { inject: false };
+    // Keyword-based injection from agent prompt (if sessionId available)
+    if (sessionId && projectPath) {
+        // Extract prompt from the original function context — the caller should pass it
+        // For now, keyword injection from agent prompts is handled at the hook runner level
+        // via evaluateKeywordInjection(), not here. This keeps the two concerns separate.
+    }
     if (sections.length === 0)
         return { inject: false };
     const rawContent = sections.join('\n\n---\n\n');

package/dist/src/hooks/spec-injector.js.map

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

package/dist/src/team/phase-orchestrator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Phase Orchestrator - Structured team phase management.
+ *
+ * Manages phase transitions with guard evaluation, fix retry counting,
+ * state broadcast via team-msg, and transition persistence.
+ */
+import { TeamPhase, type PhaseGateConfig, type PhaseStatus } from './phase-types.js';
+export interface TransitionResult {
+    success: boolean;
+    from: TeamPhase;
+    to: TeamPhase;
+    /** Non-empty when success=false, explains why the transition was rejected */
+    reason?: string;
+    /** Gate evaluation reasons (populated even on success if gates were soft-blocked and forced) */
+    gateReasons: string[];
+}
+export declare class PhaseOrchestrator {
+    private readonly sessionId;
+    private _currentPhase;
+    private _fixAttempts;
+    private readonly _history;
+    constructor(sessionId: string);
+    /** Current phase of the team workflow */
+    get currentPhase(): TeamPhase;
+    /** Number of fix attempts in the current fix loop */
+    get fixAttempts(): number;
+    /**
+     * Attempt to transition to `targetPhase`.
+     *
+     * Steps:
+     * 1. Validate the transition exists in TRANSITIONS map
+     * 2. Check fix retry limit for fix->review transitions
+     * 3. Evaluate phase-gate guard (if gateConfig provided)
+     * 4. Apply the transition, update counters, record history
+     * 5. Broadcast state_update via team-msg opLog
+     * 6. Persist transition to transitions.jsonl
+     */
+    transitionTo(targetPhase: TeamPhase, options?: {
+        trigger?: string;
+        force?: boolean;
+        gateConfig?: PhaseGateConfig;
+        /** Callback to broadcast via team-msg (decoupled from direct import) */
+        broadcast?: (sessionId: string, phase: TeamPhase, fixAttempts: number) => void;
+    }): TransitionResult;
+    getPhaseStatus(): PhaseStatus;
+    private applyTransition;
+    /**
+     * Append transition record to .workflow/.team/{session}/transitions.jsonl
+     */
+    private persistTransition;
+}
+//# sourceMappingURL=phase-orchestrator.d.ts.map

package/dist/src/team/phase-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/team/phase-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EACL,SAAS,EAET,KAAK,eAAe,EACpB,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAC;AAa1B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,SAAS,CAAC;IACd,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;gBAEvC,SAAS,EAAE,MAAM;IAO7B,yCAAyC;IACzC,IAAI,YAAY,IAAI,SAAS,CAE5B;IAED,qDAAqD;IACrD,IAAI,WAAW,IAAI,MAAM,CAExB;IAMD;;;;;;;;;;OAUG;IACH,YAAY,CACV,WAAW,EAAE,SAAS,EACtB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,eAAe,CAAC;QAC7B,wEAAwE;QACxE,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;KAChF,GACA,gBAAgB;IA8DnB,cAAc,IAAI,WAAW;IAc7B,OAAO,CAAC,eAAe;IAwCvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAa1B"}