96 lines
4.1 KiB
TypeScript
96 lines
4.1 KiB
TypeScript
/**
|
|
* Feature Flags — environment-based configuration for progressive enhancement.
|
|
* Enables A/B testing, gradual rollout, and per-workspace configuration.
|
|
*
|
|
* Usage: import { FEATURE_FLAGS } from './feature-flags.js'
|
|
* All flags default to sensible production values when env vars are not set.
|
|
*/
|
|
|
|
export const FEATURE_FLAGS = {
|
|
/** Enable Coordinator persona and multi-agent orchestration */
|
|
COORDINATOR_MODE: process.env['WAGGLE_COORDINATOR_MODE'] === '1',
|
|
|
|
/** Enable advanced workflow composition and orchestration */
|
|
ADVANCED_WORKFLOWS: process.env['WAGGLE_ADVANCED_WORKFLOWS'] !== '0', // default ON
|
|
|
|
/** Aggressively auto-save memory after every significant exchange */
|
|
AUTO_SAVE_AGGRESSIVE: process.env['WAGGLE_AUTO_SAVE'] === 'aggressive',
|
|
|
|
/** Auto-suggest and prompt capability installation */
|
|
AUTO_CAPABILITY_SUGGEST: process.env['WAGGLE_AUTO_CAPABILITY'] !== '0', // default ON
|
|
|
|
/** Enable 4-layer context compaction for long sessions */
|
|
COMPACTION_ENABLED: process.env['WAGGLE_COMPACTION'] === '1',
|
|
|
|
/** Automatically run Verifier agent after every Coordinator workflow */
|
|
VERIFIER_AUTO_RUN: process.env['WAGGLE_AUTO_VERIFY'] === '1',
|
|
|
|
/**
|
|
* Enable PromptAssembler — tier-adaptive prompt packaging sixth layer.
|
|
* DEFAULT ON since the W4 real-LLM chat smoke (2026-06-11: two live turns
|
|
* through LiteLLM, assembler applied on both — shape=draft/research,
|
|
* 'Recalled memory' section present, grounded answers, zero errors).
|
|
* Kill switch: WAGGLE_PROMPT_ASSEMBLER=0. When ON, agent-loop uses
|
|
* Orchestrator.buildAssembledPrompt() instead of the raw
|
|
* buildSystemPrompt() + recallMemory() path.
|
|
* See docs/specs/PROMPT-ASSEMBLER-V4.md.
|
|
*/
|
|
PROMPT_ASSEMBLER: process.env['WAGGLE_PROMPT_ASSEMBLER'] !== '0',
|
|
|
|
/**
|
|
* Phase 5 canary percentage (0-100, integer). Controls fraction of requests
|
|
* routed to GEPA-evolved variants (claude::gen1-v1 + qwen-thinking::gen1-v1)
|
|
* instead of pre-Phase-5 baseline.
|
|
*
|
|
* POST-KICK-OFF DEFAULT: 10 (canary Day 0 LIVE 2026-04-30 per PM signoff
|
|
* D:/Projects/PM-Waggle-OS/decisions/2026-04-30-phase-5-1-5-pm-signoff-canary-authorize.md).
|
|
* When WAGGLE_PHASE5_CANARY_PCT env var is unset, parsePhase5CanaryPct
|
|
* returns 10. Set explicitly to 0 to roll back canary OFF without redeploy
|
|
* per §2.3 rollback procedure. Set 25 / 50 / 100 to advance gradient per
|
|
* §2.1 (each step gated by §4.1 AND-gate: ≥7 days AND ≥30 samples per
|
|
* variant per metric).
|
|
*
|
|
* Hot-reconfigurable via process restart. Tests pin to 0 via vitest.setup.ts
|
|
* to keep shape-selection assertions deterministic.
|
|
*
|
|
* Invalid values (negative, > 100, non-integer, NaN, empty string) are
|
|
* treated as 0 for fail-safe behavior. See packages/agent/src/canary/phase-5-router.ts.
|
|
*/
|
|
PHASE_5_CANARY_PCT: parsePhase5CanaryPct(process.env['WAGGLE_PHASE5_CANARY_PCT']),
|
|
} as const;
|
|
|
|
/**
|
|
* Parse and validate WAGGLE_PHASE5_CANARY_PCT env var.
|
|
*
|
|
* Returns an integer in [0, 100]:
|
|
* - undefined (env var unset) → 10 (post-canary-kickoff default 2026-04-30)
|
|
* - empty string → 0 (treated as deliberate disable)
|
|
* - malformed (negative, > 100, non-integer, NaN) → 0 (fail-safe)
|
|
* - well-formed integer → parsed value
|
|
*
|
|
* Exported for unit testing. Production callers should read FEATURE_FLAGS.PHASE_5_CANARY_PCT.
|
|
*/
|
|
export function parsePhase5CanaryPct(raw: string | undefined): number {
|
|
if (raw === undefined) return 10; // post-kick-off default
|
|
if (raw === '') return 0; // explicit disable via empty string
|
|
const parsed = Number(raw);
|
|
if (!Number.isFinite(parsed)) return 0;
|
|
if (!Number.isInteger(parsed)) return 0;
|
|
if (parsed < 0 || parsed > 100) return 0;
|
|
return parsed;
|
|
}
|
|
|
|
export type FeatureFlag = keyof typeof FEATURE_FLAGS;
|
|
|
|
/**
|
|
* Check if a feature flag is enabled.
|
|
*
|
|
* For boolean flags: returns the value directly.
|
|
* For numeric flags (e.g., PHASE_5_CANARY_PCT): returns true iff the value is
|
|
* truthy (> 0). Use the FEATURE_FLAGS object directly when you need the
|
|
* numeric value rather than a boolean.
|
|
*/
|
|
export function isEnabled(flag: FeatureFlag): boolean {
|
|
return Boolean(FEATURE_FLAGS[flag]);
|
|
}
|