Files
waggle-os/packages/agent/src/feature-flags.ts
Oleg Maslov 0c3e2ead3b
Some checks failed
Installer Smoke / installer-smoke (push) Has been cancelled
moving
2026-09-02 10:10:29 +02:00

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]);
}