@dv.nghiem/flowdeck 0.3.6 → 0.3.7

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/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/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

package/docs/notifications.md

@@ -8,7 +8,7 @@ FlowDeck fires desktop notifications when commands that require your attention c
 
 When an interactive command finishes (one that either asks questions or produces output you need to approve), FlowDeck sends a desktop notification through the OS notification system. Notification urgency depends on the command:
 
-- **Critical-level (urgent):** `/fd-discuss`, `/fd-plan`, `/fd-review-code`, `/fd-deploy-check`, `/fd-new-project`  
+- **Critical-level (urgent):** `/fd-discuss`, `/fd-plan`, `/fd-verify`, `/fd-deploy-check`, `/fd-new-project`  
   These commands present questions or decisions that block further progress. The notification is sent at high urgency so it appears even in Do Not Disturb mode on some systems.
 
 - **Info-level:** `/fd-new-feature`, `/fd-fix-bug`, `/fd-write-docs`, `/fd-checkpoint`  
@@ -97,7 +97,7 @@ $toast = [Windows.UI.Notifications.ToastNotification]::new($template)
 |---------|-------|------|
 | `/fd-discuss` | `FlowDeck: /fd-discuss` | Your input is needed — please check OpenCode |
 | `/fd-plan` | `FlowDeck: /fd-plan` | Your input is needed — please check OpenCode |
-| `/fd-review-code` | `FlowDeck: /fd-review-code` | Your input is needed — please check OpenCode |
+| `/fd-verify` | `FlowDeck: /fd-verify` | Your input is needed — please check OpenCode |
 | `/fd-deploy-check` | `FlowDeck: /fd-deploy-check` | Your input is needed — please check OpenCode |
 | `/fd-new-project` | `FlowDeck: /fd-new-project` | Your input is needed — please check OpenCode |
 | `/fd-new-feature` | `FlowDeck: /fd-new-feature complete` | Review the output and choose your next step |

package/docs/quick-start.md

@@ -45,7 +45,7 @@ This creates the `.planning/` directory at your project root with the following
 .planning/
 ├── PROJECT.md       # Project context: name, goals, constraints, tech stack
 ├── STATE.md         # Current execution state, tracked by all agents
-├── ROADMAP.md       # Phase definitions and milestones
+├── ROADMAP.md       # Phase definitions and features
 └── config.json      # FlowDeck project configuration
 ```
 

package/docs/skills.md

@@ -335,7 +335,7 @@ Creates consistent releases with semantic versioning, changelog generation from
         Collect merged PRs since the last tag and generate the changelog entry.
 ```
 
-**When to use:** When a milestone is complete and ready to ship, or when a hotfix needs a patch release.
+**When to use:** When a release is ready to ship, or when a hotfix needs a patch release.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dv.nghiem/flowdeck",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "FlowDeck — structured planning and execution workflows for OpenCode",
   "type": "module",
   "main": "./dist/index.js",

package/src/commands/fd-new-project.md

@@ -71,7 +71,6 @@ Initialize FlowDeck planning structure for the current workspace.
 ```markdown
 ---
 flowdeck_state_version: 1.0
-milestone: v1.0
 last_updated: "<current timestamp>"
 progress:
   total_phases: 1

package/src/rules/common/agent-orchestration.md

@@ -79,6 +79,6 @@ discuss → plan → execute → review
 | discuss | `@discusser` | `/fd-discuss` |
 | plan | `@planner` → `@plan-checker` | `/fd-plan` |
 | execute | `@orchestrator` → `@backend-coder`, `@tester`, etc. | `/fd-new-feature` |
-| review | `@reviewer` + `@security-auditor` | `/fd-review-code` |
+| review | `@reviewer` + `@security-auditor` | `/fd-verify` |
 
 Do not skip phases. The orchestrator enforces phase gating automatically.

package/src/skills/design-tokens/SKILL.md

@@ -0,0 +1,250 @@
+---
+name: design-tokens
+description: Design token system with semantic color palettes, typography scales, spacing systems, and W3C DTCG compliant token definitions
+origin: Built for FlowDeck's design agent workflow
+tags:
+  - design
+  - tokens
+  - semantic
+  - w3c-dtcg
+  - color
+  - typography
+  - spacing
+---
+
+# Design Tokens Skill
+
+Design tokens are the single source of truth for visual design decisions. They enable consistent, themeable UI and bridge design tools with code.
+
+## Token Structure
+
+Tokens follow W3C Design Token Community Group (DTCG) format:
+
+```css
+/* Category/Role/Variant */
+--color-text-primary: oklch(68% 0.21 250);
+--color-surface: oklch(98% 0 0);
+--spacing-lg: 1.5rem; /* 24px */
+--radius-md: 0.5rem; /* 8px */
+```
+
+## Color Tokens
+
+### Semantic Color Palette (Light Mode)
+
+```css
+:root {
+  /* Text Colors */
+  --color-text-primary: oklch(18% 0 0);        /* #1a1a1a - Main text */
+  --color-text-secondary: oklch(45% 0 0);     /* #6b6b6b - Secondary text */
+  --color-text-tertiary: oklch(65% 0 0);      /* #a3a3a3 - Muted text */
+  --color-text-inverse: oklch(98% 0 0);        /* White text on dark */
+
+  /* Surface Colors */
+  --color-surface: oklch(98% 0 0);             /* #fafafa - Background */
+  --color-surface-elevated: oklch(100% 0 0);  /* #ffffff - Cards, modals */
+  --color-surface-overlay: oklch(0% 0 0 / 50%); /* #00000050 - Overlays */
+
+  /* Interactive Colors */
+  --color-interactive-primary: oklch(68% 0.21 250);  /* Blue - CTAs */
+  --color-interactive-hover: oklch(62% 0.22 250);     /* Darker blue */
+  --color-interactive-active: oklch(55% 0.24 250);   /* Even darker */
+  --color-interactive-disabled: oklch(85% 0 0);       /* Gray - Disabled */
+
+  /* Feedback Colors */
+  --color-success: oklch(72% 0.19 145);       /* Green */
+  --color-warning: oklch(85% 0.18 85);         /* Yellow/Orange */
+  --color-error: oklch(63% 0.24 25);          /* Red */
+  --color-info: oklch(68% 0.21 250);          /* Blue - same as primary */
+
+  /* Border Colors */
+  --color-border: oklch(90% 0 0);              /* Light gray border */
+  --color-border-strong: oklch(75% 0 0);      /* Stronger border */
+  --color-border-interactive: oklch(68% 0.21 250); /* Focus ring */
+}
+```
+
+### Dark Mode Tokens
+
+```css
+@media (prefers-color-scheme: dark) {
+  :root {
+    --color-text-primary: oklch(92% 0 0);
+    --color-text-secondary: oklch(70% 0 0);
+    --color-surface: oklch(15% 0 0);
+    --color-surface-elevated: oklch(22% 0 0);
+    --color-interactive-primary: oklch(75% 0.2 250);
+  }
+}
+```
+
+## Typography Tokens
+
+```css
+:root {
+  /* Font Families */
+  --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
+  --font-mono: 'JetBrains Mono', 'Fira Code', monospace;
+
+  /* Type Scale */
+  --text-xs: 0.75rem;     /* 12px - Captions */
+  --text-sm: 0.875rem;   /* 14px - Small text */
+  --text-base: 1rem;     /* 16px - Body */
+  --text-lg: 1.125rem;   /* 18px - Large body */
+  --text-xl: 1.25rem;    /* 20px - Subheadings */
+  --text-2xl: 1.5rem;    /* 24px - Section titles */
+  --text-3xl: 1.875rem;  /* 30px - Page titles */
+  --text-4xl: 2.25rem;   /* 36px - Hero */
+  --text-hero: clamp(3rem, 1rem + 7vw, 8rem); /* Responsive hero */
+
+  /* Line Heights */
+  --leading-tight: 1.1;
+  --leading-snug: 1.25;
+  --leading-normal: 1.5;
+  --leading-relaxed: 1.75;
+
+  /* Letter Spacing */
+  --tracking-tight: -0.02em;
+  --tracking-normal: 0;
+  --tracking-wide: 0.02em;
+
+  /* Font Weights */
+  --weight-regular: 400;
+  --weight-medium: 500;
+  --weight-semibold: 600;
+  --weight-bold: 700;
+}
+```
+
+## Spacing Tokens
+
+```css
+:root {
+  /* Base: 4px */
+  --space-1: 0.25rem;   /* 4px */
+  --space-2: 0.5rem;    /* 8px */
+  --space-3: 0.75rem;   /* 12px */
+  --space-4: 1rem;       /* 16px */
+  --space-5: 1.5rem;     /* 24px */
+  --space-6: 2rem;       /* 32px */
+  --space-8: 3rem;       /* 48px */
+  --space-10: 4rem;      /* 64px */
+  --space-12: 6rem;      /* 96px */
+  --space-section: clamp(4rem, 3rem + 5vw, 10rem); /* Responsive section spacing */
+}
+```
+
+## Shadow & Elevation Tokens
+
+```css
+:root {
+  /* Shadows */
+  --shadow-sm: 0 1px 2px oklch(0% 0 0 / 5%);
+  --shadow-md: 0 4px 6px -1px oklch(0% 0 0 / 10%), 0 2px 4px -2px oklch(0% 0 0 / 10%);
+  --shadow-lg: 0 10px 15px -3px oklch(0% 0 0 / 10%), 0 4px 6px -4px oklch(0% 0 0 / 10%);
+  --shadow-xl: 0 20px 25px -5px oklch(0% 0 0 / 10%), 0 8px 10px -6px oklch(0% 0 0 / 10%);
+  --shadow-glow: 0 0 20px oklch(68% 0.21 250 / 30%);
+
+  /* Elevation (for layering) */
+  --elevation-1: 0 1px 3px var(--shadow-sm);
+  --elevation-2: 0 4px 6px var(--shadow-md);
+  --elevation-3: 0 10px 15px var(--shadow-lg);
+}
+```
+
+## Border Radius Tokens
+
+```css
+:root {
+  --radius-sm: 0.25rem;   /* 4px - Small elements */
+  --radius-md: 0.5rem;    /* 8px - Buttons, inputs */
+  --radius-lg: 0.75rem;   /* 12px - Cards */
+  --radius-xl: 1rem;      /* 16px - Modals */
+  --radius-2xl: 1.5rem;  /* 24px - Large containers */
+  --radius-full: 9999px;  /* Pills, avatars */
+}
+```
+
+## Animation Tokens
+
+```css
+:root {
+  /* Durations */
+  --duration-fast: 150ms;
+  --duration-normal: 300ms;
+  --duration-slow: 500ms;
+
+  /* Easing */
+  --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);
+  --ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
+  --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
+}
+```
+
+## Token Naming Conventions
+
+Follow semantic naming — describe **purpose**, not value:
+
+```css
+/* WRONG - describes the value */
+--color-blue-600: #2563eb;
+--space-16: 4rem;
+
+/* CORRECT - describes the role */
+--color-interactive-primary: #2563eb;
+--space-section: 4rem;
+```
+
+## Token Categories
+
+| Category | Prefix | Example |
+|----------|--------|---------|
+| Color | `--color-` | `--color-text-primary` |
+| Typography | `--typography-` | `--typography-heading-1` |
+| Spacing | `--space-` | `--space-lg` |
+| Sizing | `--size-` | `--size-icon-md` |
+| Border | `--radius-` | `--radius-lg` |
+| Shadow | `--shadow-` | `--shadow-md` |
+| Motion | `--duration-`, `--ease-` | `--duration-fast` |
+
+## Exporting Tokens
+
+Tokens can be exported to multiple formats:
+
+```bash
+# Using Style Dictionary
+npx style-dictionary build
+
+# Generates:
+# - tokens.css (CSS custom properties)
+# - tokens.json (raw JSON)
+# - tokens.js (CommonJS module)
+# - tokens.d.ts (TypeScript definitions)
+```
+
+## Applying Tokens in Components
+
+```css
+/* Reference tokens, never hardcode */
+.component {
+  color: var(--color-text-primary);
+  background: var(--color-surface);
+  padding: var(--space-lg);
+  border-radius: var(--radius-md);
+  box-shadow: var(--shadow-md);
+  font-size: var(--text-base);
+  transition: all var(--duration-fast) var(--ease-out-expo);
+}
+```
+
+## Figma Integration
+
+When using Figma MCP, extract tokens from:
+
+1. **Color styles** → Map to `--color-*` tokens
+2. **Text styles** → Map to `--typography-*` tokens
+3. **Effect styles** → Map to `--shadow-*` tokens
+4. **Auto layout spacing** → Map to `--space-*` tokens
+5. **Component properties** → Map to semantic role tokens
+
+Tokens bridge the gap between design tools and code — they ensure that what designers specify in Figma translates directly to production code.

package/src/skills/git-release/SKILL.md

@@ -11,7 +11,7 @@ Creates releases with consistent versioning, accurate changelogs, and proper tag
 ## When to Activate
 
 Activate when:
-- A milestone is complete and ready to ship
+- A release is complete and ready to ship
 - You need to cut a release tag
 - You need to generate a CHANGELOG entry