@dv.nghiem/flowdeck 0.3.8 → 0.4.0

package/dist/lib/completion-validator.d.ts

@@ -0,0 +1,51 @@
+import type { PlanningState } from "../tools/planning-state-lib";
+export interface CompletionReadiness {
+    valid: boolean;
+    /** Why it's ready (when valid) */
+    summary?: string;
+    /** Blocking reasons (when not valid) */
+    blockers: string[];
+}
+/**
+ * Validate whether a feature/workflow is in a finishable state.
+ *
+ * Rules:
+ * - STATE.md must exist (caller is responsible for passing state)
+ * - status must not be "planned" (nothing has started)
+ * - plan_confirmed must be true (plan must have been confirmed)
+ * - no active blockers
+ * - if design-first was required, it must be satisfied
+ * - status must be "verified" or "in_progress" (not already "complete")
+ */
+export declare function validateCompletionReadiness(state: PlanningState): CompletionReadiness;
+export interface CompletionMetadata {
+    /** Feature/phase number */
+    phase: number;
+    /** ISO timestamp of completion */
+    completedAt: string;
+    /** Who/what triggered completion */
+    completedBy: string;
+    /** Final status before done was called */
+    priorStatus: string;
+    /** Steps that were complete at time of closing */
+    stepsComplete: number[];
+    /** Whether /fd-verify had been run */
+    wasVerified: boolean;
+    /** Changed files summary from git diff */
+    changedFiles: string[];
+    /** Whether verify was explicitly skipped */
+    verifySkipped: boolean;
+    /** Whether codebase mapping was refreshed */
+    mappingRefreshed: boolean;
+    /** Freshness status of mapping after done */
+    mappingFreshnessStatus: "fresh" | "stale" | "skipped";
+}
+/**
+ * Build a human-readable DONE.md summary artifact for the current phase.
+ */
+export declare function buildCompletionSummary(meta: CompletionMetadata): string;
+/**
+ * Check whether the prior status indicates /fd-verify was run.
+ */
+export declare function wasVerified(status: string): boolean;
+//# sourceMappingURL=completion-validator.d.ts.map

package/dist/lib/completion-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-validator.d.ts","sourceRoot":"","sources":["../../src/lib/completion-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAEhE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAA;IACd,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,CAoDrF;AAED,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAA;IACpB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,4CAA4C;IAC5C,aAAa,EAAE,OAAO,CAAA;IACtB,6CAA6C;IAC7C,gBAAgB,EAAE,OAAO,CAAA;IACzB,6CAA6C;IAC7C,sBAAsB,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA;CACtD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAuCvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/lib/recommended-question.d.ts

@@ -0,0 +1,24 @@
+export interface RecommendedQuestion {
+    question: string;
+    recommendation: string;
+    rationale: string;
+    alternatives?: string[];
+    defaultIfNoResponse: string;
+}
+/**
+ * Render a RecommendedQuestion to a human-readable string format.
+ */
+export declare function formatRecommendedQuestion(q: RecommendedQuestion): string;
+/**
+ * Type guard — returns true only if the value is a valid RecommendedQuestion
+ * with all required fields present and non-empty.
+ *
+ * Also returns false for trivially bare question patterns.
+ */
+export declare function validateRecommendedQuestion(value: unknown): value is RecommendedQuestion;
+/**
+ * Parse a formatted RecommendedQuestion string back into an object.
+ * Returns null if the text does not contain the required fields.
+ */
+export declare function parseQuestionBlocks(text: string): RecommendedQuestion | null;
+//# sourceMappingURL=recommended-question.d.ts.map

package/dist/lib/recommended-question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommended-question.d.ts","sourceRoot":"","sources":["../../src/lib/recommended-question.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAOxE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAmCxF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAsC5E"}

package/dist/lib/research-gate.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Research Gate — shared research-first enforcement for FlowDeck commands.
+ *
+ * Enforces that major workflow stages (discuss, plan, execute, fix-bug)
+ * perform targeted research BEFORE asking human questions or producing plans.
+ *
+ * Research is scoped to the stage:
+ * - discuss: gather facts and open questions from repo evidence
+ * - plan: gather implementation constraints and design options
+ * - execute: verify actual code paths and impacted files
+ * - fix-bug: inspect bug path, reproduction, and known remedies
+ *
+ * Research results are persisted in shared state so later stages can reuse them.
+ * Freshness metadata determines whether existing research is sufficient or
+ * new research is needed.
+ */
+import { type PlanningState } from "../tools/planning-state-lib";
+export type ResearchScope = "discuss" | "plan" | "execute" | "fix-bug";
+/** Evidence collected during a research pass. */
+export interface ResearchEvidence {
+    /** Which scope this evidence is for. */
+    scope: ResearchScope;
+    /** When this evidence was collected. */
+    collectedAt: string;
+    /** Files that were read/inspected. */
+    filesExplored: string[];
+    /** Key findings from the research. */
+    findings: string[];
+    /** Whether MCP tools were used. */
+    mcpToolsUsed: string[];
+    /** Whether the research gate was satisfied (enough evidence gathered). */
+    gateSatisfied: boolean;
+    /** Whether additional exploration was skipped (fresh evidence existed). */
+    skippedExploration: boolean;
+    /** Summary version when this research was conducted. */
+    summaryVersion: number;
+}
+/** Diagnostics logged during research. */
+export interface ResearchDiagnostics {
+    /** Research scope. */
+    scope: ResearchScope;
+    /** Timestamp of research. */
+    timestamp: string;
+    /** Sources consulted. */
+    sourcesUsed: string[];
+    /** MCP tools invoked. */
+    mcpToolsInvoked: string[];
+    /** Evidence collected. */
+    evidenceCollected: string[];
+    /** Whether gate was satisfied. */
+    gateSatisfied: boolean;
+    /** Whether additional exploration was skipped. */
+    skippedExploration: boolean;
+}
+/**
+ * Check whether existing research in shared state is still fresh enough to reuse.
+ * Research is considered fresh if:
+ * 1. The summaryVersion matches the current state's summaryVersion
+ * 2. The state itself is fresh (within 5 minutes)
+ * 3. The research scope matches
+ */
+export declare function isResearchFresh(state: PlanningState, scope: ResearchScope): boolean;
+/**
+ * Persist research evidence to STATE.md so later stages can reuse it.
+ */
+export declare function persistResearchEvidence(dir: string, scope: ResearchScope, evidence: ResearchEvidence): void;
+/**
+ * Load persisted research evidence for a given scope.
+ */
+export declare function loadResearchEvidence(dir: string, scope: ResearchScope): ResearchEvidence | null;
+/**
+ * Build diagnostics log entry for a research pass.
+ */
+export declare function buildResearchDiagnostics(evidence: ResearchEvidence): ResearchDiagnostics;
+/**
+ * Log research diagnostics to console (for agent visibility).
+ */
+export declare function logResearchDiagnostics(diags: ResearchDiagnostics): void;
+/**
+ * Perform a research pass for a given scope, checking freshness first.
+ *
+ * Returns ResearchEvidence with gateSatisfied=true if enough evidence was gathered.
+ * If existing research is fresh, returns that and sets skippedExploration=true.
+ */
+export declare function runResearchGate(dir: string, scope: ResearchScope, options?: {
+    forceRefresh?: boolean;
+    customEvidence?: Partial<ResearchEvidence>;
+}): Promise<ResearchEvidence>;
+/**
+ * Check if a stage should proceed or block based on research gate.
+ * Returns an error message if the gate is not satisfied and the stage should block.
+ */
+export declare function researchGateStatus(evidence: ResearchEvidence): {
+    satisfied: boolean;
+    blocker?: string;
+};
+//# sourceMappingURL=research-gate.d.ts.map

package/dist/lib/research-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-gate.d.ts","sourceRoot":"","sources":["../../src/lib/research-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAA0F,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAGxJ,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;AAEtE,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,KAAK,EAAE,aAAa,CAAA;IACpB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,mCAAmC;IACnC,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,0EAA0E;IAC1E,aAAa,EAAE,OAAO,CAAA;IACtB,2EAA2E;IAC3E,kBAAkB,EAAE,OAAO,CAAA;IAC3B,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,KAAK,EAAE,aAAa,CAAA;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,yBAAyB;IACzB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,kCAAkC;IAClC,aAAa,EAAE,OAAO,CAAA;IACtB,kDAAkD;IAClD,kBAAkB,EAAE,OAAO,CAAA;CAC5B;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAInF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CA0B3G;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,IAAI,CAa/F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,mBAAmB,CAUxF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAUvE;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAC3C,GACA,OAAO,CAAC,gBAAgB,CAAC,CAyH3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAQvG"}

package/dist/lib/research-gate.test.d.ts

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

package/dist/lib/research-gate.test.d.ts.map

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

package/dist/mcp/index.d.ts

@@ -1,12 +1,16 @@
 /**
  * FlowDeck built-in MCP server configurations.
  *
- * Three free, read-only remote MCPs are enabled by default:
+ * Four free, read-only remote MCPs are enabled by default:
  *   - context7    https://mcp.context7.com/mcp  (library docs lookup)
  *   - websearch   https://mcp.exa.ai/mcp        (web search via Exa)
  *   - grep_app    https://mcp.grep.app           (code search)
+ *   - github      https://api.githubcopilot.com/mcp/  (GitHub code search)
  *
- * Disable individual MCPs with: FLOWDECK_DISABLE_MCP=context7,websearch,grep_app
+ * Local stdio MCPs (when installed):
+ *   - codegraph   codegraph serve --mcp          (code knowledge graph — symbol search, call graphs, impact analysis)
+ *
+ * Disable individual MCPs with: FLOWDECK_DISABLE_MCP=context7,websearch,grep_app,github,codegraph
  */
 type RemoteMcp = {
     type: "remote";
@@ -15,6 +19,13 @@ type RemoteMcp = {
     headers?: Record<string, string>;
     oauth?: false;
 };
-export declare function createFlowDeckMcps(): Record<string, RemoteMcp>;
+type LocalMcp = {
+    type: "local";
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    enabled: boolean;
+};
+export declare function createFlowDeckMcps(): Record<string, RemoteMcp | LocalMcp>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,QAAQ,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAOD,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAuC9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,QAAQ,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,KAAK,QAAQ,GAAG;IACd,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAOD,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC,CAgEzE"}

package/dist/services/codegraph.d.ts

@@ -0,0 +1,36 @@
+export interface CodegraphMeta {
+    installed: boolean;
+    indexed: boolean;
+    lastIndexedAt: string;
+    lastIndexedRevision: string;
+    lastIndexedBy: string;
+    freshnessStatus: "fresh" | "stale" | "unknown";
+    installLog: string;
+    indexLog: string;
+}
+export declare function isCodegraphInstalled(): boolean;
+export declare function isCodegraphIndexed(dir: string): boolean;
+export declare function readCodegraphMeta(dir: string): CodegraphMeta;
+export declare function writeCodegraphMeta(dir: string, meta: CodegraphMeta): void;
+export declare function isCodegraphFresh(dir: string, maxAgeMs?: number): boolean;
+export declare function getCurrentRevision(dir: string): string;
+export declare function getChangedFilesSince(dir: string, revision: string): string[];
+export declare function hasChangedSinceLastIndex(dir: string): boolean;
+export interface InstallResult {
+    success: boolean;
+    alreadyInstalled: boolean;
+    log: string;
+    error?: string;
+}
+export declare function installCodegraph(): InstallResult;
+export interface IndexResult {
+    success: boolean;
+    full: boolean;
+    log: string;
+    changedFiles: string[];
+    error?: string;
+}
+export declare function initCodegraphIndex(dir: string, agent: string): IndexResult;
+export declare function refreshCodegraphIndex(dir: string, agent: string): IndexResult;
+export declare function markCodegraphStale(dir: string): void;
+//# sourceMappingURL=codegraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codegraph.d.ts","sourceRoot":"","sources":["../../src/services/codegraph.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA;IAC9C,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAMD,wBAAgB,oBAAoB,IAAI,OAAO,CAW9C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CA6B5D;AAkDD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAgBzE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAmB,GAAG,OAAO,CAOlF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYtD;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAc5E;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,gBAAgB,EAAE,OAAO,CAAA;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAmChD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CA8E1E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CA+D7E;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGpD"}

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

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

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

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

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

@@ -43,6 +43,17 @@ export declare function auditTextForInvalidCommands(text: string): AuditResult;
  * a note that the command is unavailable. Leaves valid commands untouched.
  */
 export declare function rewriteInvalidCommandRefs(text: string): string;
+/**
+ * Combined full audit: checks both invalid /fd-* command references AND
+ * bare /word references missing the fd- prefix. Use this for file integrity tests.
+ */
+export interface FullAuditResult extends AuditResult {
+    /** Bare /word references that are missing the fd- prefix (e.g. /plan → /fd-plan) */
+    barePrefixErrors: string[];
+    /** True if any issue was found — either invalid /fd-* refs or bare prefix errors */
+    hasAnyIssue: boolean;
+}
+export declare function auditTextFull(text: string): FullAuditResult;
 /**
  * Return the full canonical command inventory for inspection/testing.
  */

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

@@ -1 +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"}
+{"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;AAYD;;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;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,oFAAoF;IACpF,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,oFAAoF;IACpF,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAQ3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAEvD"}

package/dist/services/preflight-explorer.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Preflight Explorer Service
+ *
+ * Performs autonomous codebase exploration before any clarifying question is
+ * emitted to the user. Both /fd-quick and /fd-discuss run this first.
+ *
+ * Contract:
+ *   1. exploreRepo(dir) → ExplorationResult   (what exists in the project)
+ *   2. canAnswerFromEvidence(question, result) → boolean  (suppress logic)
+ *   3. shouldSuppressQuestion(q, result, history) → SuppressResult
+ *   4. deriveTaskContext(task, result) → DerivedTaskContext (task-relative findings)
+ *
+ * This module reads the filesystem synchronously so it can be used in both
+ * synchronous test harnesses and async agent runtimes.
+ */
+export interface ExplorationResult {
+    /** Whether .planning/STATE.md was found */
+    hasStateMD: boolean;
+    /** Whether .planning/PROJECT.md was found */
+    hasProjectMD: boolean;
+    /** Whether AGENTS.md was found at repo root */
+    hasAgentsMD: boolean;
+    /** Whether .planning/phases/ has any prior phase directories */
+    hasPriorPhases: boolean;
+    /** Whether .planning/phases/ has any DISCUSS.md from prior sessions */
+    hasPriorDiscussions: boolean;
+    /** fd-* command names found on disk (from src/commands/*.md) */
+    availableCommands: string[];
+    /** Agent names registered in this FlowDeck installation */
+    availableAgents: string[];
+    /** Skill directory names found on disk (from src/skills/ subdirectories) */
+    availableSkills: string[];
+    /** Tech stack indicators inferred from package.json / go.mod / Cargo.toml etc. */
+    techStack: string[];
+    /** Config keys present in flowdeck.json if it exists */
+    configKeys: string[];
+    /** Rules / governance keys declared in flowdeck.json */
+    governanceEnabled: boolean;
+    /** Implementation pattern hints inferred from src/ directory layout */
+    implementationPatterns: string[];
+    /** Relative paths of files that seem relevant to the task keywords */
+    relevantFiles: string[];
+    /** Evidence items that can answer common scoping questions */
+    evidenceItems: EvidenceItem[];
+    /** ISO timestamp when exploration ran */
+    exploredAt: string;
+}
+export interface EvidenceItem {
+    /** The kind of question this evidence answers */
+    answersQuestion: EvidenceQuestionKind;
+    /** Human-readable evidence summary */
+    summary: string;
+    /** Source path (relative) */
+    source: string;
+}
+export type EvidenceQuestionKind = "what-tech-stack" | "is-project-initialized" | "what-is-current-phase" | "what-patterns-exist" | "is-ui-heavy" | "has-existing-tests" | "has-existing-docs" | "has-ci-cd" | "what-agents-available" | "what-commands-available" | "what-skills-available" | "has-prior-decisions" | "has-governance";
+export interface DerivedTaskContext {
+    /** Whether the task appears to touch frontend/UI code based on repo evidence */
+    likelyUITask: boolean;
+    /** Whether the task appears to touch API/backend based on repo evidence */
+    likelyBackendTask: boolean;
+    /** Whether CI/CD config exists (relevant for deploy tasks) */
+    hasCICD: boolean;
+    /** Whether existing tests exist in the project */
+    hasTests: boolean;
+    /** Whether existing documentation exists */
+    hasDocs: boolean;
+    /** Whether governance layer is active */
+    hasGovernance: boolean;
+    /** Relevant files for this specific task */
+    relevantFiles: string[];
+    /** Tech stack summary */
+    techStack: string[];
+}
+export interface SuppressResult {
+    /** Whether the question should be suppressed */
+    suppress: boolean;
+    /** Reason for suppression (if suppressed) */
+    reason?: string;
+    /** True when the question was answered by repo evidence (vs. session dedup) */
+    answeredByEvidence?: boolean;
+    /** The evidence that answers the question (if suppressed) */
+    evidence?: EvidenceItem[];
+}
+/**
+ * Explore the repository at `dir` and return structured findings.
+ * All filesystem reads are synchronous so this can be called in test harnesses.
+ *
+ * @param dir - Absolute path to repo root (or closest available directory)
+ */
+export declare function exploreRepo(dir: string): ExplorationResult;
+/**
+ * Narrow the exploration result to what is specifically relevant for a given task.
+ * Populates `relevantFiles` based on task keywords.
+ */
+export declare function deriveTaskContext(taskDescription: string, result: ExplorationResult, dir: string): DerivedTaskContext;
+/**
+ * Determine whether a candidate question should be suppressed because it can
+ * already be answered from repo evidence.
+ *
+ * A question is suppressed when:
+ *   1. The repo contains direct evidence that answers it, OR
+ *   2. It was already asked in the current session history, OR
+ *   3. It is a trivially answerable question given known project state
+ */
+export declare function shouldSuppressQuestion(question: string, result: ExplorationResult, sessionHistory: string[]): SuppressResult;
+/**
+ * Check if a specific question can be answered from the exploration result alone.
+ */
+export declare function canAnswerFromEvidence(question: string, result: ExplorationResult): boolean;
+/**
+ * Attempt to resolve a `clarificationNeeded` classification using exploration
+ * context. Returns an updated `clarificationNeeded` flag and an optional
+ * resolved task type hint.
+ *
+ * Called by quick-router after classifyTask when clarificationNeeded=true.
+ */
+export interface ExplorationRefinement {
+    /** Whether clarification is still required after applying exploration data */
+    clarificationStillNeeded: boolean;
+    /** Reason clarification is no longer needed (if resolved) */
+    resolvedReason?: string;
+    /**
+     * Evidence-based context to pass to @supervisor if clarification is still needed.
+     * This lets the supervisor ask a tighter question.
+     */
+    supervisorContext?: string;
+}
+export declare function refineClassification(clarificationPrompt: string, result: ExplorationResult, sessionHistory: string[]): ExplorationRefinement;
+//# sourceMappingURL=preflight-explorer.d.ts.map

package/dist/services/preflight-explorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-explorer.d.ts","sourceRoot":"","sources":["../../src/services/preflight-explorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAA;IACnB,6CAA6C;IAC7C,YAAY,EAAE,OAAO,CAAA;IACrB,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAA;IACpB,gEAAgE;IAChE,cAAc,EAAE,OAAO,CAAA;IACvB,uEAAuE;IACvE,mBAAmB,EAAE,OAAO,CAAA;IAC5B,gEAAgE;IAChE,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,2DAA2D;IAC3D,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,4EAA4E;IAC5E,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,kFAAkF;IAClF,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,wDAAwD;IACxD,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,wDAAwD;IACxD,iBAAiB,EAAE,OAAO,CAAA;IAC1B,uEAAuE;IACvE,sBAAsB,EAAE,MAAM,EAAE,CAAA;IAChC,sEAAsE;IACtE,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,8DAA8D;IAC9D,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,eAAe,EAAE,oBAAoB,CAAA;IACrC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,oBAAoB,GAC5B,iBAAiB,GACjB,wBAAwB,GACxB,uBAAuB,GACvB,qBAAqB,GACrB,aAAa,GACb,oBAAoB,GACpB,mBAAmB,GACnB,WAAW,GACX,uBAAuB,GACvB,yBAAyB,GACzB,uBAAuB,GACvB,qBAAqB,GACrB,gBAAgB,CAAA;AAEpB,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,YAAY,EAAE,OAAO,CAAA;IACrB,2EAA2E;IAC3E,iBAAiB,EAAE,OAAO,CAAA;IAC1B,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAA;IAChB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAA;IACjB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAA;IAChB,yCAAyC;IACzC,aAAa,EAAE,OAAO,CAAA;IACtB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,yBAAyB;IACzB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAA;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;CAC1B;AA2DD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAoE1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,MAAM,GACV,kBAAkB,CAoCpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB,EACzB,cAAc,EAAE,MAAM,EAAE,GACvB,cAAc,CA4BhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAIT;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,wBAAwB,EAAE,OAAO,CAAA;IACjC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,wBAAgB,oBAAoB,CAClC,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,iBAAiB,EACzB,cAAc,EAAE,MAAM,EAAE,GACvB,qBAAqB,CA8CvB"}

package/dist/services/preflight-explorer.test.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Preflight Explorer Tests
+ *
+ * Covers:
+ * - exploreRepo: discovers commands, agents, skills, tech stack from filesystem
+ * - canAnswerFromEvidence: correctly identifies suppressible questions
+ * - shouldSuppressQuestion: suppresses answered / duplicate questions
+ * - deriveTaskContext: narrows findings to task-relevant context
+ * - refineClassification: resolves ambiguous classification via evidence
+ * - createQuestionGuard: tracks asked questions and prevents duplicates
+ * - filterQuestions: returns only questions that pass the guard
+ * - needsSupervisorClarification: returns false when all questions are answered
+ * - classifyTaskWithContext: uses exploration to resolve ambiguity
+ * - createQuickRunState: persists exploration snapshot
+ * - /fd-quick performs codebase exploration before asking questions
+ * - /fd-discuss performs codebase exploration before asking questions
+ * - repo evidence prevents unnecessary human questions
+ * - supervisor-agent receives only genuine ambiguity
+ * - worker agents do not ask ad hoc questions
+ * - feature/bug/UI/docs tasks route correctly after preflight
+ * - exploration results are stored and reused
+ * - repeated question suppression works
+ */
+export {};
+//# sourceMappingURL=preflight-explorer.test.d.ts.map

package/dist/services/preflight-explorer.test.d.ts.map

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

package/dist/services/question-guard.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Question Guard Service
+ *
+ * Prevents redundant or unnecessary questions from being emitted to the user.
+ *
+ * Both /fd-quick and /fd-discuss use this guard before forwarding any
+ * clarifying question to @supervisor. Worker agents MUST NOT call ask_user
+ * directly — they check this guard first, and if the answer exists in repo
+ * evidence or session history, the question is dropped.
+ *
+ * Contract:
+ *   1. createQuestionGuard(history?)    → QuestionGuard instance
+ *   2. guard.check(question, evidence)  → CheckResult
+ *   3. guard.record(question)           → void
+ *   4. guard.getAsked()                 → string[]
+ *
+ * Only questions that pass the guard should be forwarded to @supervisor.
+ * @supervisor asks the human. Worker agents never ask the human directly.
+ */
+import type { ExplorationResult } from "./preflight-explorer";
+export interface CheckResult {
+    /** Whether the question should be allowed through to @supervisor */
+    allow: boolean;
+    /** Reason the question was blocked (when allow=false) */
+    blockReason?: string;
+    /** Whether the block was due to repo evidence answering it */
+    answeredByEvidence?: boolean;
+    /** Whether the block was due to a duplicate question */
+    duplicate?: boolean;
+    /** Field names missing from the question block (when allow=false due to missing recommendation) */
+    missingRecommendationFields?: string[];
+    /** Hint for how to rewrite a bare question into a recommended question */
+    rewriteHint?: string;
+}
+export interface QuestionGuard {
+    /**
+     * Check whether a question should be forwarded to @supervisor.
+     *
+     * Returns allow=true only when:
+     *   - The question has not been asked before in this session
+     *   - The question cannot be answered from repo evidence
+     *   - The question is not trivially implied by known state
+     */
+    check(question: string, exploration: ExplorationResult | null): CheckResult;
+    /**
+     * Record that a question was asked. Call this after forwarding to @supervisor
+     * so future identical questions are suppressed.
+     */
+    record(question: string): void;
+    /** Return all questions recorded in this guard instance. */
+    getAsked(): string[];
+    /** Reset the guard (for new session/run). */
+    reset(): void;
+}
+/**
+ * Create a QuestionGuard.
+ *
+ * @param initialHistory - Questions already asked in this session (for
+ *   persistence across restarts). Pass an empty array for new sessions.
+ */
+export declare function createQuestionGuard(initialHistory?: string[]): QuestionGuard;
+/**
+ * Convenience: check a list of candidate questions and return only those
+ * that should be forwarded to @supervisor. Records allowed questions.
+ */
+export declare function filterQuestions(candidates: string[], guard: QuestionGuard, exploration: ExplorationResult | null): string[];
+/**
+ * Determine whether supervisor clarification is warranted at all.
+ * Returns false when:
+ *   - No questions remain after evidence filtering
+ *   - All questions were answered by the exploration result
+ *
+ * Call this before invoking @supervisor to avoid empty escalations.
+ */
+export declare function needsSupervisorClarification(questions: string[], guard: QuestionGuard, exploration: ExplorationResult | null): boolean;
+/**
+ * Strict check for worker agents (coder, planner, tester, etc.).
+ *
+ * Worker agents MUST NOT ask the human directly. They must either:
+ *   a) use repo evidence (this returns { canProceed: true, evidence })
+ *   b) report missing data to orchestrator/supervisor
+ *
+ * This function decides which path to take.
+ */
+export interface WorkerAgentDecision {
+    /** True when the worker can proceed using evidence alone */
+    canProceed: boolean;
+    /** True when the worker must stop and report missing data upward */
+    mustEscalate: boolean;
+    /** Evidence that allows the worker to proceed (when canProceed=true) */
+    evidence?: string;
+    /** What data is missing (when mustEscalate=true) */
+    missingData?: string;
+}
+export declare function workerAgentDecision(requiredInfo: string, exploration: ExplorationResult): WorkerAgentDecision;
+//# sourceMappingURL=question-guard.d.ts.map

package/dist/services/question-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-guard.d.ts","sourceRoot":"","sources":["../../src/services/question-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAK7D,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAA;IACd,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,mGAAmG;IACnG,2BAA2B,CAAC,EAAE,MAAM,EAAE,CAAA;IACtC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,GAAG,IAAI,GAAG,WAAW,CAAA;IAC3E;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,4DAA4D;IAC5D,QAAQ,IAAI,MAAM,EAAE,CAAA;IACpB,6CAA6C;IAC7C,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,GAAE,MAAM,EAAO,GAAG,aAAa,CAuFhF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAAE,EACpB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,iBAAiB,GAAG,IAAI,GACpC,MAAM,EAAE,CASV;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,iBAAiB,GAAG,IAAI,GACpC,OAAO,CAGT;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,YAAY,EAAE,OAAO,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,iBAAiB,GAC7B,mBAAmB,CAmBrB"}

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

@@ -12,7 +12,14 @@
  *
  * 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
+ *
+ * Autonomy contract:
+ *   - classifyTaskWithContext() must be preferred over classifyTask() when a
+ *     preflight ExplorationResult is available.
+ *   - classificationNeeded is set to false whenever exploration evidence
+ *     supplies the missing context, eliminating the human question entirely.
  */
+import type { ExplorationResult } from "./preflight-explorer";
 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 {
@@ -110,9 +117,41 @@ export interface QuickRunState {
     updatedAt: string;
     /** Final run outcome */
     outcome: "running" | "complete" | "blocked" | "failed";
+    /**
+     * Preflight exploration snapshot — persisted so later stages can
+     * reuse it without re-running exploration or re-asking the user.
+     */
+    preflightExploration?: {
+        exploredAt: string;
+        techStack: string[];
+        availableCommands: string[];
+        availableSkills: string[];
+        implementationPatterns: string[];
+        evidenceCount: number;
+        /** Whether clarification was resolved via evidence (no human asked) */
+        clarificationResolvedByEvidence: boolean;
+        /** The resolved reason when evidence answered the question */
+        clarificationResolvedReason?: string;
+    };
+    /** Questions that were suppressed by the guard (not sent to human) */
+    suppressedQuestions: string[];
 }
 /**
  * Create a fresh QuickRunState record for a new /fd-quick run.
  */
-export declare function createQuickRunState(taskDescription: string, classification: ClassificationResult): QuickRunState;
+export declare function createQuickRunState(taskDescription: string, classification: ClassificationResult, exploration?: ExplorationResult): QuickRunState;
+/**
+ * Classify a task description, using repo exploration evidence to resolve
+ * ambiguity before falling back to supervisor clarification.
+ *
+ * Prefer this over `classifyTask` whenever a preflight ExplorationResult is
+ * available. It eliminates unnecessary human questions when the repo already
+ * contains the answer.
+ *
+ * @param description  - Free-text task from the user
+ * @param exploration  - ExplorationResult from exploreRepo()
+ * @param sessionHistory - Questions already asked in this session (for
+ *                         deduplication via the question guard)
+ */
+export declare function classifyTaskWithContext(description: string, exploration: ExplorationResult, sessionHistory?: string[]): ClassificationResult;
 //# sourceMappingURL=quick-router.d.ts.map