@dv.nghiem/flowdeck 0.3.6 → 0.3.8

package/dist/lib/impact-radar.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared Impact Radar utility.
  * Scans .codebase/ data stores for risk signals relevant to a change description.
- * Used by /discuss, /plan, /new-feature, and /fix-bug.
+ * Used by /fd-discuss, /fd-plan, /fd-new-feature, and /fd-fix-bug.
  */
 import type { FailureEntry } from "../tools/failure-replay";
 export interface ImpactRadarResult {
@@ -29,7 +29,7 @@ export declare function impactRadarSummaryLines(radar: ImpactRadarResult): strin
 /**
  * Look up prior failures from FAILURES.json that match by path prefix or keyword.
  * Returns full FailureEntry objects (including root_cause and fix_applied) sorted by recurrence desc.
- * Used by /fix-bug to surface lessons learned before the fix begins.
+ * Used by /fd-fix-bug to surface lessons learned before the fix begins.
  */
 export declare function lookupPriorFailures(dir: string, scope: string, bugText: string, limit?: number): FailureEntry[];
 //# sourceMappingURL=impact-radar.d.ts.map

package/dist/services/agent-contract-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-contract-registry.d.ts","sourceRoot":"","sources":["../../src/services/agent-contract-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,mDAAmD;IACnD,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,EAAE,CAAA;IAC9B,0CAA0C;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,EAAE,CAAA;IAC9B,qDAAqD;IACrD,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,oCAAoC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B;AA+SD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAE/D;AAED,wBAAgB,eAAe,IAAI,aAAa,EAAE,CAEjD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD"}
+{"version":3,"file":"agent-contract-registry.d.ts","sourceRoot":"","sources":["../../src/services/agent-contract-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,mDAAmD;IACnD,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,EAAE,CAAA;IAC9B,0CAA0C;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,EAAE,CAAA;IAC9B,qDAAqD;IACrD,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,oCAAoC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B;AA+UD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAE/D;AAED,wBAAgB,eAAe,IAAI,aAAa,EAAE,CAEjD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD"}

package/dist/services/command-validator.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Command reference validator.
+ * Source of truth: REGISTERED_COMMANDS from supervisor-binding.
+ * Used at startup, in tests, and by the response guardrail to prevent
+ * agents from suggesting slash commands that don't exist.
+ */
+export interface CommandValidationResult {
+    valid: boolean;
+    command: string;
+    reason?: string;
+}
+export interface AuditResult {
+    text: string;
+    references: string[];
+    invalid: CommandValidationResult[];
+    valid: CommandValidationResult[];
+    hasInvalid: boolean;
+}
+/**
+ * Returns true if the given slash command (with or without leading slash) is registered.
+ */
+export declare function isValidCommand(ref: string): boolean;
+/**
+ * Validate a single command reference string (e.g. "/fd-plan" or "fd-plan").
+ */
+export declare function validateCommandReference(ref: string): CommandValidationResult;
+/**
+ * Extract all /fd-* slash command references from a text string.
+ */
+export declare function extractCommandReferences(text: string): string[];
+/**
+ * Extract bare /word references that are missing the fd- prefix.
+ * Returns only those that would be valid if prefixed with fd-.
+ */
+export declare function extractBarePrefixErrors(text: string): string[];
+/**
+ * Audit a text string for invalid command references.
+ * Checks all /fd-* patterns against the registered command set.
+ */
+export declare function auditTextForInvalidCommands(text: string): AuditResult;
+/**
+ * Rewrite a text string by replacing invalid /fd-* command references with
+ * a note that the command is unavailable. Leaves valid commands untouched.
+ */
+export declare function rewriteInvalidCommandRefs(text: string): string;
+/**
+ * Return the full canonical command inventory for inspection/testing.
+ */
+export declare function getCommandInventory(): readonly string[];
+//# sourceMappingURL=command-validator.d.ts.map

package/dist/services/command-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-validator.d.ts","sourceRoot":"","sources":["../../src/services/command-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,EAAE,uBAAuB,EAAE,CAAA;IAClC,KAAK,EAAE,uBAAuB,EAAE,CAAA;IAChC,UAAU,EAAE,OAAO,CAAA;CACpB;AAQD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAmB7E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAY9D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAqBrE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAEvD"}

package/dist/services/command-validator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-validator.test.d.ts.map

package/dist/services/command-validator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-validator.test.d.ts","sourceRoot":"","sources":["../../src/services/command-validator.test.ts"],"names":[],"mappings":""}

package/dist/services/quick-router.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Quick Router Service
+ *
+ * Provides task classification and stage-sequence routing for the /fd-quick
+ * autonomous workflow launcher.
+ *
+ * This module is the single source of truth for:
+ *   - Classifying user task descriptions into task types
+ *   - Mapping task types to the correct existing stage sequence
+ *   - Computing the next stage given what has already completed
+ *   - Determining whether supervisor clarification is required before proceeding
+ *
+ * It does NOT create new workflows. It routes to the existing commands:
+ *   fd-discuss, fd-design, fd-plan, fd-execute, fd-fix-bug, fd-write-docs, fd-verify
+ */
+export type TaskType = "feature" | "ui-feature" | "bugfix" | "docs" | "simple" | "ambiguous";
+/** A single stage in a workflow sequence, mapping to an existing fd-* command. */
+export interface WorkflowStage {
+    /** Human-readable stage name */
+    name: string;
+    /** The registered fd-* command that implements this stage */
+    command: string;
+    /** Arguments to pass to the command (if any) */
+    args?: string;
+    /** Whether this stage requires human approval before proceeding */
+    requiresApproval: boolean;
+    /** Whether this stage can be skipped if prerequisites are absent and --override is set */
+    skippable: boolean;
+}
+export interface ClassificationResult {
+    taskType: TaskType;
+    /** 0.0–1.0 confidence in the classification */
+    confidence: number;
+    /** Which signal patterns triggered the classification */
+    signals: string[];
+    /** True when the task is explicitly UI/UX-heavy, requiring design-first */
+    requiresDesign: boolean;
+    /** True when TDD enforcement applies (always true except for docs-only) */
+    requiresTDD: boolean;
+    /** Ordered sequence of stages to execute */
+    stageSequence: WorkflowStage[];
+    /** True when the description is too vague to classify without asking a question */
+    clarificationNeeded: boolean;
+    /** The single clarifying question to ask via supervisor (when clarificationNeeded=true) */
+    clarificationPrompt?: string;
+}
+/**
+ * Classify a free-text task description into a TaskType with a confidence score.
+ *
+ * Signal matching is case-insensitive substring search. Multiple signal hits
+ * increase confidence. The highest-confidence match wins; ties break toward
+ * the more structured workflow type (feature > simple > ambiguous).
+ */
+export declare function classifyTask(description: string): ClassificationResult;
+/**
+ * Build the ordered WorkflowStage array for a given TaskType.
+ * Each stage maps 1:1 to an existing registered fd-* command.
+ */
+export declare function buildStageSequence(taskType: TaskType): WorkflowStage[];
+export interface StageProgress {
+    completedStageNames: string[];
+    blockedAtStage?: string;
+    blockedReason?: string;
+}
+export interface NextStageResult {
+    /** The stage to execute next, or null if all stages are complete */
+    stage: WorkflowStage | null;
+    /** True when all stages have been completed */
+    allComplete: boolean;
+    /** True when execution is blocked at a stage */
+    blocked: boolean;
+    blockedReason?: string;
+    /** Remaining stage names (not counting the returned stage) */
+    remaining: string[];
+}
+/**
+ * Given a stage sequence and the current progress, determine the next
+ * stage to execute.
+ *
+ * Returns null stage when all stages are complete.
+ */
+export declare function getNextStage(sequence: WorkflowStage[], progress: StageProgress): NextStageResult;
+/** The structure written to STATE.md under the `quick_run` key by /fd-quick. */
+export interface QuickRunState {
+    /** Original task description from $ARGUMENTS */
+    taskDescription: string;
+    /** Classification result */
+    taskType: TaskType;
+    confidence: number;
+    requiresDesign: boolean;
+    requiresTDD: boolean;
+    /** Ordered stage names for this run */
+    stageSequence: string[];
+    /** Stages that have been completed */
+    completedStages: string[];
+    /** Current stage being executed, if any */
+    currentStage: string | null;
+    /** Whether the run has been halted */
+    blocked: boolean;
+    blockedReason?: string;
+    /** Supervisor decisions keyed by stage name */
+    supervisorDecisions: Record<string, {
+        decision: string;
+        reasons: string[];
+        timestamp: string;
+    }>;
+    /** ISO timestamp when the run started */
+    startedAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Final run outcome */
+    outcome: "running" | "complete" | "blocked" | "failed";
+}
+/**
+ * Create a fresh QuickRunState record for a new /fd-quick run.
+ */
+export declare function createQuickRunState(taskDescription: string, classification: ClassificationResult): QuickRunState;
+//# sourceMappingURL=quick-router.d.ts.map

package/dist/services/quick-router.d.ts.map

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

package/dist/services/quick-router.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Quick Router Tests
+ *
+ * Covers:
+ * - classifyTask: correctly classifies feature, bugfix, ui-feature, docs, simple, ambiguous
+ * - buildStageSequence: returns correct ordered stages for each task type
+ * - getNextStage: returns correct next stage and handles completed / blocked states
+ * - createQuickRunState: initialises state correctly
+ * - /fd-quick routing contracts (supervisor integration points are tested as
+ *   integration-level expectations on the returned stage sequences)
+ */
+export {};
+//# sourceMappingURL=quick-router.test.d.ts.map

package/dist/services/quick-router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-router.test.d.ts","sourceRoot":"","sources":["../../src/services/quick-router.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/services/supervisor-binding.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Supervisor Binding Service
+ *
+ * Programmatic governance layer that reviews existing commands and agents
+ * before execution. It never invents new commands or workflows — it only
+ * operates on items already registered in the system.
+ *
+ * Architecture:
+ *   Orchestrator → [supervisor review] → proceed / block / escalate
+ *
+ * The supervisor is strictly read-only with respect to the registry:
+ *   - It inspects what already exists
+ *   - It validates policy compliance
+ *   - It returns a structured decision
+ *   - It NEVER creates or modifies commands or workflows
+ */
+/**
+ * The canonical set of registered FlowDeck commands.
+ * This list is derived from src/commands/*.md at build time and must NOT
+ * be modified by the supervisor under any circumstances.
+ */
+export declare const REGISTERED_COMMANDS: readonly string[];
+/**
+ * The canonical workflow phases derived from the orchestrator phase state
+ * machine. These are the only valid workflow stages in the system.
+ */
+export declare const WORKFLOW_PHASES: readonly string[];
+export type SupervisorDecisionKind = "approve" | "revise" | "block" | "escalate";
+export type SupervisorTargetType = "command" | "agent" | "workflow";
+export type SupervisorReviewPhase = "preflight" | "post-stage";
+export interface SupervisorDecision {
+    /** Final decision */
+    decision: SupervisorDecisionKind;
+    /** Type of the reviewed target */
+    targetType: SupervisorTargetType;
+    /** Name of the reviewed target (exact registered name) */
+    targetName: string;
+    /** Whether the target actually exists in the registry */
+    exists: boolean;
+    /** Human-readable reasons for the decision */
+    reasons: string[];
+    /** Required inputs or stages that are absent */
+    missingRequirements: string[];
+    /** Risk conditions detected */
+    riskFlags: string[];
+    /** Changes the caller must make before proceeding (for "revise") */
+    requiredChanges: string[];
+    /** Approval gate status */
+    approvalStatus: "approved" | "pending" | "denied" | "escalated";
+    /** 0–1 confidence in the decision */
+    confidenceScore: number;
+    /** Whether this was a preflight or post-stage review */
+    reviewPhase: SupervisorReviewPhase;
+    /** ISO timestamp */
+    timestamp: string;
+}
+export interface SupervisorContext {
+    /** Task description provided by the user or orchestrator */
+    taskDescription?: string;
+    /** Current workflow phase at the time of review */
+    currentPhase?: string;
+    /** Whether required inputs have been confirmed present */
+    prerequisitesMet?: boolean;
+    /** Specific missing inputs */
+    missingInputs?: string[];
+    /** Whether design approval is present (for UI-heavy tasks) */
+    designApprovalPresent?: boolean;
+    /** Whether a regression test exists (for bugfix commands) */
+    regressionTestPresent?: boolean;
+    /** Whether the target requires explicit human approval */
+    approvalRequired?: boolean;
+    /** Whether human approval was granted */
+    approvalGranted?: boolean;
+    /** Review phase: before or after execution */
+    reviewPhase?: SupervisorReviewPhase;
+    /** Run/session IDs for telemetry */
+    run_id?: string;
+    session_id?: string;
+}
+export interface ResolvedSupervisorConfig {
+    enabled: boolean;
+    mode: "advisory" | "strict";
+    /** Command/agent names to gate; empty array means gate all */
+    reviewedTargets: string[];
+    canBlock: boolean;
+    confidenceThreshold: number;
+    postExecutionReview: boolean;
+}
+export declare function resolveSupervisorConfig(directory: string): ResolvedSupervisorConfig;
+export declare function isRegisteredCommand(name: string): boolean;
+export declare function isRegisteredAgent(name: string): boolean;
+export declare function isRegisteredTarget(name: string): {
+    exists: boolean;
+    type: SupervisorTargetType;
+};
+/**
+ * Run a supervisor review on an existing command or agent before execution.
+ *
+ * Returns a structured SupervisorDecision. In "advisory" mode the caller may
+ * proceed even on a "block" decision (it should log the decision). In "strict"
+ * mode the caller must honour "block" and "escalate".
+ *
+ * The supervisor NEVER creates a new command or workflow. If the target does
+ * not exist, it returns decision="block" with exists=false and explains that
+ * the requested target is not registered.
+ */
+export declare function runSupervisorReview(directory: string, targetName: string, ctx?: SupervisorContext): SupervisorDecision;
+/**
+ * Shorthand: should execution proceed given a decision and the current config mode?
+ * In "advisory" mode, only "block" with a missing-existence check is hard-stopped.
+ * In "strict" mode, "block" and "escalate" both halt execution.
+ */
+export declare function shouldProceed(decision: SupervisorDecision, mode: "advisory" | "strict", canBlock: boolean): boolean;
+//# sourceMappingURL=supervisor-binding.d.ts.map

package/dist/services/supervisor-binding.d.ts.map

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

package/dist/services/supervisor.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Supervisor Binding Tests
+ *
+ * Covers:
+ * - Approves an existing valid command
+ * - Blocks an existing command with missing required stage
+ * - Blocks a workflow that violates policy
+ * - Does not invent new commands or workflows
+ * - Integrates with current orchestrator without breaking existing command routing
+ * - Only applied to already-registered commands/workflows
+ * - Missing command/workflow reported correctly
+ */
+export {};
+//# sourceMappingURL=supervisor.test.d.ts.map

package/dist/services/supervisor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.test.d.ts","sourceRoot":"","sources":["../../src/services/supervisor.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/services/telemetry.d.ts

@@ -1,4 +1,4 @@
-export type TelemetryEventType = "command.start" | "command.end" | "tool.call" | "tool.complete" | "agent.dispatch" | "agent.complete" | "approval.request" | "approval.resolve" | "run.complete" | "run.fail" | "policy.violation" | "patch.scored" | "contract.violation" | "agent.span.open" | "agent.span.close" | "budget.warning" | "budget.exhausted" | "deadlock.detected" | "scorecard.generated";
+export type TelemetryEventType = "command.start" | "command.end" | "tool.call" | "tool.complete" | "agent.dispatch" | "agent.complete" | "approval.request" | "approval.resolve" | "run.complete" | "run.fail" | "policy.violation" | "patch.scored" | "contract.violation" | "agent.span.open" | "agent.span.close" | "budget.warning" | "budget.exhausted" | "deadlock.detected" | "scorecard.generated" | "supervisor.review";
 export interface TelemetryEvent {
     id: string;
     ts: string;

package/dist/services/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/services/telemetry.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,aAAa,GACb,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,UAAU,GACV,kBAAkB,GAClB,cAAc,GAEd,oBAAoB,GACpB,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,CAAA;AAEzB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,kBAAkB,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,cAAc,GAAG,IAAI,CAa1G;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,cAAc,EAAE,CAUrE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAE1E;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,SAAM,GAAG,cAAc,EAAE,CAuBxE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE,CAI/E"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/services/telemetry.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,aAAa,GACb,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,UAAU,GACV,kBAAkB,GAClB,cAAc,GAEd,oBAAoB,GACpB,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GAErB,mBAAmB,CAAA;AAEvB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,kBAAkB,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,cAAc,GAAG,IAAI,CAa1G;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,cAAc,EAAE,CAUrE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAE1E;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,SAAM,GAAG,cAAc,EAAE,CAuBxE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE,CAI/E"}

package/dist/services/workflow-scorecard.d.ts

@@ -25,6 +25,12 @@ export interface ScorecardDimensions {
     handoffQuality: number;
     /** No agent contract violations */
     contractCompliance: number;
+    /**
+     * Supervisor review outcomes: proportion of reviews that resulted in "approve"
+     * or "revise" (recoverable), versus "block" or "escalate" (hard stops).
+     * Defaults to 1.0 when the supervisor is disabled or no reviews occurred.
+     */
+    supervisorCompliance: number;
 }
 export interface WorkflowScorecard {
     scorecard_id: string;
@@ -40,6 +46,10 @@ export interface WorkflowScorecard {
     human_interventions: number;
     overrides_used: number;
     deadlock_signals: number;
+    /** Total supervisor review events for this run */
+    supervisor_reviews: number;
+    /** Supervisor reviews that resulted in block or escalate */
+    supervisor_hard_stops: number;
     success_reason?: string;
     failure_reason?: string;
 }
@@ -55,6 +65,16 @@ export interface ScorecardInput {
     policy_violations?: number;
     human_interventions?: number;
     overrides_used?: number;
+    /**
+     * Total supervisor reviews that occurred.
+     * Computed automatically from telemetry when omitted.
+     */
+    supervisor_reviews?: number;
+    /**
+     * Number of reviews that resulted in "block" or "escalate".
+     * Computed automatically from telemetry when omitted.
+     */
+    supervisor_hard_stops?: number;
 }
 export declare function scorecardsPath(dir: string): string;
 /**

package/dist/services/workflow-scorecard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-scorecard.d.ts","sourceRoot":"","sources":["../../src/services/workflow-scorecard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAM3C,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,qBAAqB,EAAE,MAAM,CAAA;IAC7B,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAA;IACrB,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAA;IACvB,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,CAAA;IACxB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAA;IACtB,mCAAmC;IACnC,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;IAClE,UAAU,EAAE,mBAAmB,CAAA;IAC/B,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAeD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,QAAQ,EACf,KAAK,GAAE,cAAmB,GACzB,iBAAiB,CAiEnB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,iBAAiB,EAAE,CAS3E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAEvF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,iBAAiB,EAAE,CAIhG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhF"}
+{"version":3,"file":"workflow-scorecard.d.ts","sourceRoot":"","sources":["../../src/services/workflow-scorecard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAM3C,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,qBAAqB,EAAE,MAAM,CAAA;IAC7B,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAA;IACrB,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAA;IACvB,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,CAAA;IACxB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAA;IACtB,mCAAmC;IACnC,kBAAkB,EAAE,MAAM,CAAA;IAC1B;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;IAClE,UAAU,EAAE,mBAAmB,CAAA;IAC/B,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,kDAAkD;IAClD,kBAAkB,EAAE,MAAM,CAAA;IAC1B,4DAA4D;IAC5D,qBAAqB,EAAE,MAAM,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAgBD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,QAAQ,EACf,KAAK,GAAE,cAAmB,GACzB,iBAAiB,CAiFnB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,iBAAiB,EAAE,CAS3E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAEvF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,iBAAiB,EAAE,CAIhG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhF"}

package/docs/agents.md

@@ -527,7 +527,7 @@ The writer drafts technical documentation that developers will actually read. It
 **Best for:**
 - Writing a README.md from scratch for a new project or module
 - Drafting API reference documentation for newly implemented public functions
-- Creating a changelog entry after a release milestone
+- Creating a changelog entry after a release
 - Writing a code tour or architectural overview document
 
 **Example usage:**

package/docs/commands/fd-ask.md

@@ -46,6 +46,6 @@ Route a free-form task to the best specialized agent automatically.
 
 After `/fd-ask` completes, you can go deeper:
 
-1. **Full workflow** → `/fd-fix-bug`, `/fd-new-feature`, `/fd-review-code`
+1. **Full workflow** → `/fd-fix-bug`, `/fd-new-feature`, `/fd-verify`
 2. **Detailed planning** → `/fd-discuss`, `/fd-plan`
 3. **Another question** → `/fd-ask --task '...'`

package/docs/commands/fd-deploy-check.md

@@ -7,5 +7,5 @@ Run the FlowDeck deploy-check workflow before deploying to production.
 
 1. **Fix blocking issues** → `/fd-fix-bug [issue]`
 2. **Create deployment checkpoint** → `/fd-checkpoint`
-3. **Review code again** → `/fd-review-code`
+3. **Review code again** → `/fd-verify`
 4. **View project roadmap** → `/fd-roadmap`

package/docs/commands/fd-discuss.md

@@ -22,7 +22,7 @@ After discussion completes, choose your next step:
 
 1. **Create implementation plan** → `/fd-plan [phase-number]`
 2. **Continue discussion** → `/fd-discuss [phase-number]`
-3. **Review existing work** → `/fd-review-code`
+3. **Review existing work** → `/fd-verify`
 4. **Check project dashboard** → `/fd-dashboard`
 
 Type the number or the command to proceed.

package/docs/commands/fd-fix-bug.md

@@ -18,7 +18,7 @@ Systematically debug and fix a bug using FlowDeck's structured approach.
 
 ## What Next?
 
-1. **Run code review** → `/fd-review-code`
+1. **Run code review** → `/fd-verify`
 2. **Check for more bugs** → `/fd-fix-bug [next-issue]`
 3. **Update documentation** → `/fd-write-docs`
 4. **Deploy check** → `/fd-deploy-check`

package/docs/commands/fd-new-feature.md

@@ -19,7 +19,7 @@ Execute a new feature using FlowDeck's multi-agent workflow.
 
 ## What Next?
 
-1. **Review the code** → `/fd-review-code`
+1. **Review the code** → `/fd-verify`
 2. **Write documentation** → `/fd-write-docs`
 3. **Deploy check** → `/fd-deploy-check`
 4. **Start next feature** → `/fd-new-feature [description]`

package/docs/commands/fd-verify.md

@@ -0,0 +1,18 @@
+---
+description: Review code quality, security, and conventions — runs parallel @reviewer + @security-auditor agents
+argument-hint: "[file-pattern|dir|stage number]"
+---
+
+Run the FlowDeck code review workflow. Reviews can target:
+- **Specific files or directories** — `fd-verify src/services/`
+- **Git staged changes** — `fd-verify staged`
+- **Full project** — `fd-verify`
+
+## What Next?
+
+1. **Fix issues found** → `/fd-fix-bug [issue]`
+2. **Create deployment checkpoint** → `/fd-checkpoint`
+3. **Deploy to production** → `/fd-deploy-check`
+4. **View project dashboard** → `/fd-dashboard`
+
+Type the number or command to proceed.

package/docs/commands/fd-write-docs.md

@@ -5,6 +5,6 @@ Run the FlowDeck write-docs workflow to generate accurate project documentation.
 
 ## What Next?
 
-1. **Review documentation** → `/fd-review-code staged`
+1. **Review documentation** → `/fd-verify staged`
 2. **Deploy check** → `/fd-deploy-check`
 3. **Create checkpoint** → `/fd-checkpoint`

package/docs/commands.md

@@ -24,7 +24,7 @@ Commands are slash commands registered in OpenCode. Run them by typing `/command
 | `/fd-multi-repo` | `[list \| add <path> [name] \| remove <name> \| status]` | Multi-repo orchestration |
 | `/fd-translate-intent` | `[vague intent]` | Convert vague request into ranked implementation options |
 | `/fd-ask` | `[question]` | Route question to specialist agent (architect, security, etc.) |
-| `/fd-quick` | `[task description]` | Quick focused task with automatic agent selection |
+| `/fd-quick` | `[task description]` | Autonomous workflow launcher — classifies task, selects correct workflow, runs all stages end-to-end |
 | `/fd-doctor` | — | Check FlowDeck installation and environment health |
 
 ---
@@ -483,34 +483,54 @@ Comprehensive pre-change analysis: impact radar, blast radius, regression predic
 
 ## /fd-quick
 
-**Description:** Execute a focused task without the full workflow. Selects best specialist agent automatically.
+**Description:** Autonomous workflow launcher. Classifies the task, selects the correct existing FlowDeck workflow, and runs all stages end-to-end with minimal user input. Routes all clarifying questions through `@supervisor`.
 
 **Arguments:**
-- `[task description]` — what you need done
-
-**Agent Selection Matrix:**
-
-| Task Type | Agent |
-|-----------|-------|
-| Backend code | @backend-coder |
-| Frontend code | @frontend-coder |
-| DevOps/infra code | @devops |
-| Explore/understand | @code-explorer |
-| Review code | @reviewer |
-| Security review | @security-auditor |
-| Design/architecture | @architect |
-| Write tests | @tester |
-| Documentation | @doc-updater |
-| Research | @researcher |
-| Debug | @debug-specialist |
-| Performance | @performance-optimizer |
-| Build error | @build-error-resolver |
+- `[task description]` — what you need done (any phrasing — the command classifies it)
+
+**Task Classification:**
+
+| Classification | Trigger Signals | Stage Sequence |
+|----------------|-----------------|----------------|
+| `feature` | Substantive description, no specific signals | `discuss → plan → execute → verify` |
+| `ui-feature` | landing page, dashboard, admin panel, app screen, ux flow | `discuss → design → plan → execute → verify` |
+| `bugfix` | fix, bug, error, crash, regression, broken, exception | `discuss → fix-bug → verify` |
+| `docs` | docs, documentation, readme, api docs, write docs | `discuss → write-docs → verify` |
+| `simple` | rename, typo, minor, move file | `execute → verify` |
+| `ambiguous` | vague or too short | *supervisor asks one clarifying question* |
+
+**What it does:**
+1. Classifies the task from `$ARGUMENTS` using signal patterns
+2. Routes ambiguous tasks through `@supervisor` for a single focused clarifying question
+3. Presents the selected stage sequence to the user
+4. Executes each stage in order using the existing registered commands (`/fd-discuss`, `/fd-plan`, etc.)
+5. Gates each stage through `@supervisor` preflight review (approve / revise / block / escalate)
+6. Respects all workflow discipline: TDD gates, design-first gate for UI tasks, plan CONFIRM gate
+7. Pauses only when a supervisor gate requires user approval, or when blocked
+8. Records all routing decisions, stage transitions, and supervisor decisions in STATE.md
+9. On block: explains exactly what stopped execution and what is needed to resume
+
+**What it preserves:**
+- All existing commands (`/fd-discuss`, `/fd-plan`, `/fd-execute`, etc.) remain independently usable
+- TDD enforcement is never bypassed
+- Design-first gate for UI-heavy tasks is enforced
+- Plan CONFIRM gate is always presented to the user
+- Verify pipeline always runs at end
 
 **Example:**
 ```
-/fd-quick find where the session token is validated
-/fd-quick add rate limiting to the API
+/fd-quick add two-factor authentication to the login system
+/fd-quick fix the checkout crash when cart is empty
+/fd-quick build a new analytics dashboard for admin users
+/fd-quick write API documentation for the user service
+/fd-quick rename MAX_RETRIES constant to RETRY_LIMIT
+```
+
+**Resume after a block:**
+```
+/fd-quick <original task description>
 ```
+`/fd-quick` resumes from the last completed stage automatically.
 
 ---
 

package/docs/feature-integration-architecture.md

@@ -219,7 +219,7 @@ All existing commands continue to work unchanged. New capabilities are additive:
 
 - `fd-new-feature` — now uses model router instead of hardcoded models; emits telemetry
 - `fd-fix-bug` — emits run trace on entry, evaluates policies, proposes new policies from failures
-- `fd-review-code` — shows policy violations in output table
+- `fd-verify` — shows policy violations in output table
 - Dashboard — new operational sections appear only when data exists (no empty-state noise)
 - Approval hook — only triggers for write operations on sensitive file patterns; safe paths are unaffected
 - Telemetry — append-only, never read during hook execution, cannot slow down tool calls