@dv.nghiem/flowdeck 0.3.7 → 0.3.9

package/dist/hooks/command-ref-guard.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HOOK: Command Reference Guard
+ * Post-response hook that scans agent output for /fd-* slash command references
+ * and warns when an invalid (unregistered) command is found.
+ *
+ * This is a lightweight advisory guardrail — it emits a warning comment
+ * at the top of the response rather than blocking it, preserving usability
+ * while surfacing drift for developers to fix.
+ */
+/**
+ * Scan an agent response string and return a warning prefix if any invalid
+ * command references are detected. Returns null if response is clean.
+ */
+export declare function buildCommandRefWarning(response: string): string | null;
+/**
+ * Apply the command reference guardrail to an agent response.
+ * If invalid command references are found, prepend a warning block.
+ * If clean, return the response unchanged.
+ */
+export declare function applyCommandRefGuard(response: string): string;
+//# sourceMappingURL=command-ref-guard.d.ts.map

package/dist/hooks/command-ref-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-ref-guard.d.ts","sourceRoot":"","sources":["../../src/hooks/command-ref-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBtE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI7D"}

package/dist/hooks/compaction-hook.d.ts

@@ -6,7 +6,8 @@
  * Context includes:
  * 1. FlowDeck planning state (phase, status, pending steps)
  * 2. Recently edited files (from SessionFileTracker)
- * 3. Structured 8-section summary prompt
+ * 3. Historical session summaries from memory store
+ * 4. Structured 8-section summary prompt
  *
  * Inspired by oh-my-openagent's compaction-context-injector and
  * ECC's experimental.session.compacting handler.

package/dist/hooks/compaction-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAoDxD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC1B,OAAO,EAAE,kBAAkB,IAGzB,QAAQ;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,mBA8BjD"}
+{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAqDxD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC1B,OAAO,EAAE,kBAAkB,IAGzB,QAAQ;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,mBAsCjD"}

package/dist/hooks/session-start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkElC"}
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwElC"}

package/dist/index.js

@@ -2452,7 +2452,7 @@ async function guardRailsHook(ctx, input, _output) {
     if (!existsSync18(planningDirPath))
       return;
     if (!existsSync18(codebaseDirectory)) {
-      throw new Error(`[flowdeck] WARNING: .codebase/ not found. Run /map-codebase to map the codebase.`);
+      throw new Error(`[flowdeck] WARNING: .codebase/ not found. Run /fd-map-codebase to map the codebase.`);
     }
     const execMode = resolveExecutionMode(configPath, null);
     if (execMode === "review-only") {
@@ -2480,7 +2480,7 @@ async function guardRailsHook(ctx, input, _output) {
     for (const pattern of BUILD_DEPLOY_PATTERNS) {
       if (cmd.includes(pattern)) {
         if (!getPlanConfirmed(statePath2)) {
-          throw new Error(`[flowdeck] WARNING: Build/deploy command detected but plan is not confirmed. Run /plan first.`);
+          throw new Error(`[flowdeck] WARNING: Build/deploy command detected but plan is not confirmed. Run /fd-plan first.`);
         }
         break;
       }
@@ -2543,15 +2543,15 @@ function getPlanConfirmed(statePath2) {
 }
 function getWarningMessage(planningDir2) {
   if (!existsSync18(join18(planningDir2, STATE_FILE2))) {
-    return "No .planning/ found. Run /new-project first.";
+    return "No .planning/ found. Run /fd-new-project first.";
   }
-  return "Plan not confirmed. Run /plan and confirm to enable execution.";
+  return "Plan not confirmed. Run /fd-plan and confirm to enable execution.";
 }
 function getBlockMessage(planningDir2) {
   if (!existsSync18(join18(planningDir2, STATE_FILE2))) {
-    return "No .planning/ found. Run /new-project first.";
+    return "No .planning/ found. Run /fd-new-project first.";
   }
-  return "Plan not confirmed. Run /plan and confirm to enable execution.";
+  return "Plan not confirmed. Run /fd-plan and confirm to enable execution.";
 }
 
 // src/hooks/tool-guard.ts
@@ -2689,8 +2689,9 @@ async function sessionStartHook(ctx) {
     return {
       flowdeck_phase: null,
       flowdeck_status: "no_plan",
-      flowdeck_warning: "Run /new-project or /map-codebase to initialize.",
+      flowdeck_warning: "Run /fd-new-project or /fd-map-codebase to initialize.",
       flowdeck_has_codebase: existsSync20(codebaseDirectory),
+      flowdeck_session_context: getContextForDirectory(ctx.directory),
       ...workspaceRoot && config?.sub_repos ? {
         flowdeck_workspace_root: workspaceRoot,
         flowdeck_sub_repos: config.sub_repos,
@@ -2704,12 +2705,14 @@ async function sessionStartHook(ctx) {
     const content = readFileSync17(stateFilePath, "utf-8");
     const state = parseState(content);
     const currentPhase = state["current_phase"] || {};
+    const sessionContext = getContextForDirectory(ctx.directory);
     const result = {
       flowdeck_phase: currentPhase["phase"] ?? null,
       flowdeck_status: currentPhase["status"] ?? null,
       flowdeck_steps_pending: currentPhase["steps_pending"] ?? null,
       flowdeck_last_action: currentPhase["last_action"] ?? null,
-      flowdeck_has_codebase: existsSync20(codebaseDirectory)
+      flowdeck_has_codebase: existsSync20(codebaseDirectory),
+      flowdeck_session_context: sessionContext
     };
     if (workspaceRoot && config?.sub_repos && config.sub_repos.length > 0) {
       result.flowdeck_workspace_root = workspaceRoot;
@@ -2724,7 +2727,8 @@ async function sessionStartHook(ctx) {
       flowdeck_phase: null,
       flowdeck_status: "error",
       flowdeck_warning: "State file unreadable. Continuing without flowdeck context.",
-      flowdeck_has_codebase: existsSync20(codebaseDirectory)
+      flowdeck_has_codebase: existsSync20(codebaseDirectory),
+      flowdeck_session_context: getContextForDirectory(ctx.directory)
     };
     if (workspaceRoot && config?.sub_repos && config.sub_repos.length > 0) {
       result.flowdeck_workspace_root = workspaceRoot;
@@ -3366,6 +3370,12 @@ function createCompactionHook(ctx, tracker) {
         sections.push(`- … and ${edited.length - 20} more`);
       sections.push("");
     }
+    const sessionContext = getContextForDirectory(ctx.directory);
+    if (sessionContext) {
+      sections.push("## Previous Sessions Context");
+      sections.push(sessionContext);
+      sections.push("");
+    }
     output.context.push(sections.join(`
 `));
     output.prompt = STRUCTURED_SUMMARY_PROMPT.trim();
@@ -3568,6 +3578,15 @@ function createFlowDeckMcps() {
       oauth: false
     };
   }
+  if (!disabled.has("github")) {
+    mcps.github = {
+      type: "remote",
+      url: "https://api.githubcopilot.com/mcp/",
+      enabled: true,
+      ...process.env.GITHUB_TOKEN ? { headers: { Authorization: `Bearer ${process.env.GITHUB_TOKEN}` } } : {},
+      oauth: false
+    };
+  }
   return mcps;
 }
 
@@ -3605,16 +3624,16 @@ MUST execute at session start:
 3. Check which steps are marked complete
 4. Begin execution from the first incomplete step
 
-If STATE.md does not exist, tell the user: "No STATE.md found. Run \`/new-project\` to initialize."
+If STATE.md does not exist, tell the user: "No STATE.md found. Run \`/fd-new-project\` to initialize."
 
 ## Phase Gating
 
 Only orchestrate in the **execute** phase.
 
 If the project is in another phase:
-- **discuss** phase: "Run \`/discuss\` to complete requirements gathering first."
-- **plan** phase: "Run \`/plan\` to create the implementation plan first."
-- **review** phase: "Run \`/review-code\` to complete the review phase."
+- **discuss** phase: "Run \`/fd-discuss\` to complete requirements gathering first."
+- **plan** phase: "Run \`/fd-plan\` to create the implementation plan first."
+- **review** phase: "Run \`/fd-verify\` to complete the review phase."
 
 ## Step Execution
 
@@ -5539,7 +5558,7 @@ Discussion is complete when:
 - All decisions recorded in DISCUSS.md
 - No open questions remain
 
-Report: "Requirements gathering complete. N decisions recorded. Ready for /plan."`;
+Report: "Requirements gathering complete. N decisions recorded. Ready for /fd-plan."`;
 var createTaskSplitterAgent = (model, customPrompt, customAppendPrompt) => {
   const prompt = resolvePrompt(TASK_SPLITTER_PROMPT, customPrompt, customAppendPrompt);
   return {

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/mcp/index.d.ts

@@ -1,12 +1,13 @@
 /**
  * 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
+ * Disable individual MCPs with: FLOWDECK_DISABLE_MCP=context7,websearch,grep_app,github
  */
 type RemoteMcp = {
     type: "remote";

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;;;;;;;;;;GAUG;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,CAmD9D"}

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

@@ -0,0 +1,61 @@
+/**
+ * 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;
+/**
+ * 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.
+ */
+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;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/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/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":"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"}

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,92 @@
+/**
+ * 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;
+}
+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;AAG7D,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;CACpB;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,CA0ChF;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"}