maestro-flow 0.1.4 → 0.2.0

package/dist/src/hooks/skill-context.js

@@ -0,0 +1,300 @@
+/**
+ * Skill Context Hook — UserPromptSubmit
+ *
+ * When a user invokes a workflow skill (e.g., `/maestro-execute 2`),
+ * injects current workflow state, phase artifact tree, and prior
+ * phase outcomes into the session context.
+ *
+ * Uses `additionalContext` (not `updatedInput`) to avoid interfering
+ * with skill expansion.
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveWorkspace } from './workspace.js';
+import { readCoordBridge, buildNextStepHint } from './coordinator-tracker.js';
+// ---------------------------------------------------------------------------
+// Skill invocation patterns
+// ---------------------------------------------------------------------------
+const SKILL_PATTERNS = [
+    { pattern: /\/maestro-execute\s+(\d+)/, skill: 'maestro-execute' },
+    { pattern: /\/maestro-plan\s+(\d+)/, skill: 'maestro-plan' },
+    { pattern: /\/maestro-verify\s+(\d+)/, skill: 'maestro-verify' },
+    { pattern: /\/maestro-analyze\s+(\d+)/, skill: 'maestro-analyze' },
+    { pattern: /\/maestro-phase-transition(?:\s+(\d+))?/, skill: 'maestro-phase-transition' },
+    { pattern: /\/quality-review\s+(\d+)/, skill: 'quality-review' },
+    { pattern: /\/quality-test\s+(\d+)/, skill: 'quality-test' },
+    { pattern: /\/maestro(?:\s|$)/, skill: 'maestro' },
+    { pattern: /\/maestro-coordinate(?:\s|$)/, skill: 'maestro-coordinate' },
+    { pattern: /\/maestro-link-coordinate(?:\s|$)/, skill: 'maestro-link-coordinate' },
+];
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a user prompt for workflow skill invocation.
+ * Returns null if no skill pattern is matched.
+ */
+export function parseSkillInvocation(prompt) {
+    for (const { pattern, skill } of SKILL_PATTERNS) {
+        const match = prompt.match(pattern);
+        if (match) {
+            const phaseNum = match[1] ? parseInt(match[1], 10) : undefined;
+            return { skill, phaseNum, raw: match[0] };
+        }
+    }
+    return null;
+}
+/**
+ * Evaluate skill context and return workflow state + artifact tree.
+ * Returns null if no skill invocation detected or no workflow exists.
+ */
+export function evaluateSkillContext(data) {
+    const prompt = data.user_prompt ?? '';
+    if (!prompt)
+        return null;
+    const skill = parseSkillInvocation(prompt);
+    if (!skill)
+        return null;
+    const cwd = resolveWorkspace(data);
+    if (!cwd)
+        return null;
+    const statePath = join(cwd, '.workflow', 'state.json');
+    if (!existsSync(statePath))
+        return null;
+    let state;
+    try {
+        state = JSON.parse(readFileSync(statePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+    const sections = [];
+    // Section 0: Coordinator session context (for /maestro, /maestro-coordinate, /maestro-link-coordinate)
+    const COORDINATOR_SKILLS = ['maestro', 'maestro-coordinate', 'maestro-link-coordinate'];
+    if (COORDINATOR_SKILLS.includes(skill.skill) && data.session_id) {
+        const coordBridge = readCoordBridge(data.session_id);
+        if (coordBridge) {
+            const hint = buildNextStepHint(coordBridge);
+            if (hint)
+                sections.push(hint);
+        }
+    }
+    // Section 1: Workflow state summary
+    const stateSection = buildStateSection(state, skill);
+    if (stateSection)
+        sections.push(stateSection);
+    // Section 2: Phase artifact tree
+    const phaseNum = skill.phaseNum ?? state.current_phase;
+    if (phaseNum) {
+        const treeSection = buildArtifactTree(cwd, phaseNum);
+        if (treeSection)
+            sections.push(treeSection);
+    }
+    // Section 3: Prior phase outcomes
+    const outcomesSection = buildOutcomesSection(cwd, state, phaseNum);
+    if (outcomesSection)
+        sections.push(outcomesSection);
+    if (sections.length === 0)
+        return null;
+    return {
+        hookSpecificOutput: {
+            hookEventName: 'UserPromptSubmit',
+            additionalContext: sections.join('\n\n'),
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Section builders
+// ---------------------------------------------------------------------------
+function buildStateSection(state, skill) {
+    const parts = [`## Workflow Context for ${skill.skill}`];
+    if (state.current_milestone)
+        parts.push(`Milestone: ${state.current_milestone}`);
+    if (state.current_phase !== undefined) {
+        const summary = state.phases_summary;
+        const progress = summary ? `${summary.completed}/${summary.total} completed` : '';
+        parts.push(`Phase: ${state.current_phase} ${progress ? `(${progress})` : ''}`);
+    }
+    if (state.status)
+        parts.push(`Status: ${state.status}`);
+    const decisions = state.accumulated_context?.key_decisions;
+    if (decisions && decisions.length > 0) {
+        parts.push(`Key decisions: ${decisions.length}`);
+    }
+    const deferred = state.accumulated_context?.deferred;
+    if (deferred && deferred.length > 0) {
+        parts.push(`Deferred items: ${deferred.length}`);
+    }
+    const history = state.transition_history;
+    if (history && history.length > 0) {
+        const last = history[history.length - 1];
+        parts.push(`Last transition: ${last.type} ${last.milestone} (${last.transitioned_at})`);
+    }
+    return parts.length > 1 ? parts.join(' | ') : null;
+}
+function buildArtifactTree(cwd, phaseNum) {
+    const phasesDir = join(cwd, '.workflow', 'phases');
+    if (!existsSync(phasesDir))
+        return null;
+    // Find phase directory by number prefix
+    let phaseDir = null;
+    let phaseDirName = '';
+    try {
+        const dirs = readdirSync(phasesDir);
+        const prefix = String(phaseNum).padStart(2, '0');
+        for (const d of dirs) {
+            if (d.startsWith(`${prefix}-`)) {
+                phaseDir = join(phasesDir, d);
+                phaseDirName = d;
+                break;
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    if (!phaseDir || !existsSync(phaseDir))
+        return null;
+    const lines = [`## Phase ${phaseNum} Artifacts (.workflow/phases/${phaseDirName}/)`];
+    // List top-level files
+    try {
+        const entries = readdirSync(phaseDir);
+        const files = entries.filter(e => !e.startsWith('.') && e !== '.task' && e !== '.summaries' && e !== '.process');
+        if (files.length > 0) {
+            lines.push(files.join(' | '));
+        }
+        // List .task/ directory with status annotations
+        const taskDir = join(phaseDir, '.task');
+        if (existsSync(taskDir)) {
+            const taskSection = buildTaskListing(taskDir);
+            if (taskSection)
+                lines.push(taskSection);
+        }
+        // List .summaries/ if it exists
+        const summariesDir = join(phaseDir, '.summaries');
+        if (existsSync(summariesDir)) {
+            const summaryFiles = readdirSync(summariesDir).filter(f => f.endsWith('.md'));
+            if (summaryFiles.length > 0) {
+                lines.push(`.summaries/ (${summaryFiles.length} files)`);
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return lines.join('\n');
+}
+function buildTaskListing(taskDir) {
+    try {
+        const taskFiles = readdirSync(taskDir)
+            .filter(f => f.startsWith('TASK-') && f.endsWith('.json'))
+            .slice(0, 20); // Cap at 20
+        if (taskFiles.length === 0)
+            return null;
+        let completed = 0;
+        let pending = 0;
+        let inProgress = 0;
+        const taskStatuses = [];
+        for (const f of taskFiles) {
+            const taskId = f.replace('.json', '');
+            try {
+                // Read only enough to get status
+                const content = readFileSync(join(taskDir, f), 'utf8');
+                const task = JSON.parse(content);
+                const status = task.status ?? 'pending';
+                if (status === 'completed') {
+                    completed++;
+                    taskStatuses.push(`${taskId} ✓`);
+                }
+                else if (status === 'in_progress') {
+                    inProgress++;
+                    taskStatuses.push(`${taskId} →`);
+                }
+                else {
+                    pending++;
+                    taskStatuses.push(`${taskId} …`);
+                }
+            }
+            catch {
+                pending++;
+                taskStatuses.push(`${taskId} ?`);
+            }
+        }
+        const summary = `.task/ (${taskFiles.length} tasks: ${completed} completed${inProgress ? `, ${inProgress} in_progress` : ''}${pending ? `, ${pending} pending` : ''})`;
+        return `${summary}\n  ${taskStatuses.join(' | ')}`;
+    }
+    catch {
+        return null;
+    }
+}
+function buildOutcomesSection(cwd, state, targetPhase) {
+    const parts = [];
+    // Deferred items (high severity, top 5)
+    const deferred = state.accumulated_context?.deferred;
+    if (deferred && deferred.length > 0) {
+        const highItems = deferred
+            .filter(d => typeof d === 'object' && (d.severity === 'high' || d.severity === 'critical'))
+            .slice(0, 5);
+        if (highItems.length > 0) {
+            const lines = highItems.map(d => {
+                if (typeof d === 'object') {
+                    return `- [${d.severity}] ${d.description}${d.fix_direction ? ` → ${d.fix_direction}` : ''}`;
+                }
+                return `- ${d}`;
+            });
+            parts.push(`## Deferred Items (${deferred.length} total, showing high/critical)\n${lines.join('\n')}`);
+        }
+    }
+    // Prior completed phase learnings + verification gaps
+    if (targetPhase && targetPhase > 1) {
+        const priorIndex = loadPhaseIndex(cwd, targetPhase - 1);
+        if (priorIndex) {
+            // Verification gaps
+            const gaps = priorIndex.verification?.gaps;
+            if (gaps && gaps.length > 0) {
+                const gapLines = gaps.slice(0, 3).map(g => `- ${g.description ?? 'Unknown gap'}`);
+                parts.push(`## Verification Gaps (Phase ${targetPhase - 1})\n${gapLines.join('\n')}`);
+            }
+            // Learnings
+            const learnings = priorIndex.learnings;
+            if (learnings) {
+                const items = [];
+                if (learnings.patterns) {
+                    items.push(...learnings.patterns.slice(0, 3).map(p => `- [pattern] ${p.content ?? p}`));
+                }
+                if (learnings.pitfalls) {
+                    items.push(...learnings.pitfalls.slice(0, 2).map(p => `- [pitfall] ${p.content ?? p}`));
+                }
+                if (items.length > 0) {
+                    parts.push(`## Prior Phase Learnings (Phase ${targetPhase - 1})\n${items.join('\n')}`);
+                }
+            }
+        }
+    }
+    return parts.length > 0 ? parts.join('\n\n') : null;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function loadPhaseIndex(cwd, phaseNum) {
+    const phasesDir = join(cwd, '.workflow', 'phases');
+    if (!existsSync(phasesDir))
+        return null;
+    try {
+        const dirs = readdirSync(phasesDir);
+        const prefix = String(phaseNum).padStart(2, '0');
+        for (const d of dirs) {
+            if (d.startsWith(`${prefix}-`)) {
+                const indexPath = join(phasesDir, d, 'index.json');
+                if (existsSync(indexPath)) {
+                    return JSON.parse(readFileSync(indexPath, 'utf8'));
+                }
+            }
+        }
+    }
+    catch {
+        // Silently fail
+    }
+    return null;
+}
+//# sourceMappingURL=skill-context.js.map

package/dist/src/hooks/skill-context.js.map

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

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

@@ -0,0 +1,34 @@
+/**
+ * Spec Injector — PreToolUse:Agent Hook
+ *
+ * Automatically injects project specs into subagent context based on
+ * agent type → spec category mapping. Uses context-budget to reduce
+ * payload when context usage is high.
+ *
+ * Design: Uses `additionalContext` (advisory) rather than rewriting
+ * the prompt — safer and non-destructive.
+ */
+import { type SpecCategory } from '../tools/spec-loader.js';
+import type { SpecInjectionConfig } from '../types/index.js';
+export interface SpecInjectionRule {
+    categories: SpecCategory[];
+    /** Additional file paths relative to project root */
+    extras: string[];
+}
+export interface SpecInjectionResult {
+    inject: boolean;
+    content?: string;
+    categories?: string[];
+    specCount?: number;
+    budgetAction?: string;
+}
+/**
+ * Evaluate whether to inject specs for a given agent type.
+ *
+ * @param agentType   The subagent_type from PreToolUse tool_input
+ * @param projectPath Working directory (for spec file resolution)
+ * @param sessionId   Session ID (for context budget bridge metrics)
+ * @param config      Optional user config overrides
+ */
+export declare function evaluateSpecInjection(agentType: string, projectPath: string, sessionId?: string, config?: SpecInjectionConfig): SpecInjectionResult;
+//# sourceMappingURL=spec-injector.d.ts.map

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

@@ -0,0 +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;AAEvE,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;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,mBAAmB,GAC3B,mBAAmB,CAuCrB"}

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

@@ -0,0 +1,95 @@
+/**
+ * Spec Injector — PreToolUse:Agent Hook
+ *
+ * Automatically injects project specs into subagent context based on
+ * agent type → spec category mapping. Uses context-budget to reduce
+ * payload when context usage is high.
+ *
+ * Design: Uses `additionalContext` (advisory) rather than rewriting
+ * the prompt — safer and non-destructive.
+ */
+import { loadSpecs } from '../tools/spec-loader.js';
+import { evaluateContextBudget } from './context-budget.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: [] },
+    // 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
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate whether to inject specs for a given agent type.
+ *
+ * @param agentType   The subagent_type from PreToolUse tool_input
+ * @param projectPath Working directory (for spec file resolution)
+ * @param sessionId   Session ID (for context budget bridge metrics)
+ * @param config      Optional user config overrides
+ */
+export function evaluateSpecInjection(agentType, projectPath, sessionId, config) {
+    // Merge user config mapping with defaults
+    const mapping = buildMapping(config);
+    const rule = mapping[agentType];
+    if (!rule)
+        return { inject: false };
+    // Load specs for each category
+    const sections = [];
+    const allCategories = [];
+    let totalCount = 0;
+    for (const category of rule.categories) {
+        const result = loadSpecs(projectPath, category);
+        if (result.content) {
+            sections.push(result.content);
+            allCategories.push(category);
+            totalCount += result.totalLoaded;
+        }
+    }
+    if (sections.length === 0)
+        return { inject: false };
+    const rawContent = sections.join('\n\n---\n\n');
+    // Apply context budget
+    const budget = evaluateContextBudget(rawContent, sessionId);
+    if (budget.action === 'skip') {
+        return { inject: false, budgetAction: 'skip' };
+    }
+    return {
+        inject: true,
+        content: budget.content,
+        categories: allCategories,
+        specCount: totalCount,
+        budgetAction: budget.action,
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal
+// ---------------------------------------------------------------------------
+function buildMapping(config) {
+    if (!config?.mapping)
+        return DEFAULT_AGENT_SPEC_MAP;
+    const merged = { ...DEFAULT_AGENT_SPEC_MAP };
+    for (const [agent, rule] of Object.entries(config.mapping)) {
+        merged[agent] = {
+            categories: rule.categories,
+            extras: rule.extras ?? [],
+        };
+    }
+    return merged;
+}
+//# sourceMappingURL=spec-injector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-injector.js","sourceRoot":"","sources":["../../../src/hooks/spec-injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAqB,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAqB5D,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,MAAM,sBAAsB,GAAsC;IAChE,qCAAqC;IACrC,gBAAgB,EAAO,EAAE,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAChE,eAAe,EAAQ,EAAE,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IACxE,mBAAmB,EAAI,EAAE,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAChE,oBAAoB,EAAG,EAAE,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAChE,gBAAgB,EAAO,EAAE,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAExE,mCAAmC;IACnC,yBAAyB,EAAE,EAAE,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IACnE,uBAAuB,EAAI,EAAE,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IACnE,kBAAkB,EAAS,EAAE,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAEnE,+BAA+B;IAC/B,mBAAmB,EAAI,EAAE,UAAU,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAE7D,6BAA6B;IAC7B,qBAAqB,EAAE,EAAE,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAC5D,mBAAmB,EAAI,EAAE,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAE5D,6CAA6C;IAC7C,SAAS,EAAc,EAAE,UAAU,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;CACnE,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,WAAmB,EACnB,SAAkB,EAClB,MAA4B;IAE5B,0CAA0C;IAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAEpC,+BAA+B;IAC/B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,QAAwB,CAAC,CAAC;QAChE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7B,UAAU,IAAI,MAAM,CAAC,WAAW,CAAC;QACnC,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAEpD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAEhD,uBAAuB;IACvB,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAE5D,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IACjD,CAAC;IAED,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,aAAa;QACzB,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,MAAM,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,SAAS,YAAY,CAAC,MAA4B;IAChD,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAO,sBAAsB,CAAC;IAEpD,MAAM,MAAM,GAAG,EAAE,GAAG,sBAAsB,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,GAAG;YACd,UAAU,EAAE,IAAI,CAAC,UAA4B;YAC7C,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;SAC1B,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Maestro Statusline Hook
+ *
+ * Displays: model | phase | task | directory | ASCII-face context bar
+ * Writes bridge file for context-monitor hook consumption.
+ *
+ * Input (stdin JSON from Claude Code):
+ *   { model, workspace, session_id, context_window }
+ *
+ * Output (stdout): formatted statusline string
+ */
+interface StatuslineInput {
+    model?: {
+        display_name?: string;
+    };
+    workspace?: {
+        current_dir?: string;
+    };
+    session_id?: string;
+    context_window?: {
+        remaining_percentage?: number;
+    };
+}
+/**
+ * Build the teammate activity segment. Returns empty string if:
+ *   - Team mode not enabled (no self record)
+ *   - No recent teammate activity in the last 30 minutes (excluding self)
+ *   - Any error (never throws)
+ *
+ * Result is cached per-session for 10 seconds via a JSON file in os.tmpdir().
+ */
+export declare function buildTeamSegment(session: string): string;
+/**
+ * Build coordinator progress segment from bridge file.
+ * Returns e.g. "[3/6]verify" or "[P]review" (paused) or empty string.
+ */
+export declare function buildCoordinatorSegment(session: string): string;
+/** Main statusline handler — processes input and returns formatted string */
+export declare function formatStatusline(data: StatuslineInput): string;
+/** Entry point — reads stdin JSON, writes formatted statusline to stdout */
+export declare function runStatusline(): void;
+export {};
+//# sourceMappingURL=statusline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"statusline.d.ts","sourceRoot":"","sources":["../../../src/hooks/statusline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,SAAS,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAoKD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoExD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB/D;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAmC9D;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,IAAI,IAAI,CAepC"}