specweave 2.1.0 → 2.2.1

package/dist/src/core/jev/config.js

@@ -0,0 +1,181 @@
+/**
+ * Jev (TypeSafe System One) — configuration
+ *
+ * Precedence: JEV_DEFAULTS <- `.specweave/config.json` "jev" section <- environment.
+ *
+ * Consent is explicit: `jev.enabled` must be true in the project config (written by
+ * `specweave jev setup` after a live ping). `SPECWEAVE_JEV=0` disables Jev for a single
+ * process, `SPECWEAVE_JEV=1` enables it ad hoc.
+ *
+ * Nothing here ever reads, prints or stores an API key VALUE — only env var NAMES.
+ *
+ * @module core/jev/config
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { resolveEffectiveRoot } from '../../utils/find-project-root.js';
+/** Built-in defaults. Jev is OFF until a project opts in. */
+export const JEV_DEFAULTS = {
+    enabled: false,
+    provider: 'openrouter',
+    model: 'jev-1.13',
+    timeoutMs: 4000,
+    thresholds: { route: 0.7, guardDeny: 0.85, guardWarn: 0.5 },
+    guards: { bash: false },
+    modelRouting: true,
+    browse: { allowDomains: [], maxSteps: 20 },
+};
+/** System One endpoint per provider. */
+export const JEV_PROVIDER_ENDPOINT = {
+    openrouter: 'https://openrouter.ai/api/v1/systemone',
+    typesafe: 'https://api.typesafe.ai/v1/systemone',
+};
+/** Default model id per provider (used when `model` is not set anywhere). */
+export const JEV_PROVIDER_MODEL = {
+    openrouter: 'jev-1.13',
+    typesafe: 'jev-latest',
+};
+/** Default API key environment variable NAME per provider. */
+export const JEV_PROVIDER_KEY_ENV = {
+    openrouter: 'OPENROUTER_API_KEY',
+    typesafe: 'TYPESAFE_API_KEY',
+};
+/** Provider-agnostic fallback key env var NAME. */
+export const JEV_FALLBACK_KEY_ENV = 'JEV_API_KEY';
+const PROVIDERS = ['openrouter', 'typesafe'];
+function isProvider(value) {
+    return typeof value === 'string' && PROVIDERS.includes(value);
+}
+function num(value, fallback) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+}
+/**
+ * A probability threshold from repo-tracked config, forced into [0, 1].
+ *
+ * `.specweave/config.json` is a file anyone with commit rights can edit, and the
+ * guard verdict is a `>=` comparison: `guardDeny: 5` would be unreachable (every
+ * command allowed) and `guardDeny: -1` would deny everything. Clamping keeps a
+ * typo or a hostile edit inside the range the comparisons were designed for.
+ */
+function clamp01(value, fallback) {
+    const n = num(value, fallback);
+    return Math.min(1, Math.max(0, n));
+}
+function bool(value, fallback) {
+    return typeof value === 'boolean' ? value : fallback;
+}
+function str(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function record(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+/**
+ * Read the raw `jev` section from `<projectRoot>/.specweave/config.json`.
+ * Never throws: a missing or malformed config yields `{}`.
+ */
+function readJevSection(projectRoot) {
+    try {
+        const configPath = path.join(projectRoot, '.specweave', 'config.json');
+        if (!fs.existsSync(configPath))
+            return {};
+        const raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        return record(record(raw).jev);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Clamped, ordered thresholds.
+ *
+ * `guardDeny` is raised to `guardWarn` when it is configured lower: deny is the
+ * stricter verdict, so a deny bar *below* the warn bar would make a command warn
+ * at a probability that already denied it — an ordering the verdict table has no
+ * meaning for. Raising deny (rather than lowering warn) keeps the stricter of the
+ * two intents.
+ */
+function thresholds(file) {
+    const route = clamp01(file.route, JEV_DEFAULTS.thresholds.route);
+    const guardWarn = clamp01(file.guardWarn, JEV_DEFAULTS.thresholds.guardWarn);
+    const guardDeny = Math.max(clamp01(file.guardDeny, JEV_DEFAULTS.thresholds.guardDeny), guardWarn);
+    return { route, guardDeny, guardWarn };
+}
+/**
+ * Load the effective Jev config.
+ *
+ * @param projectRoot - Project root to read `.specweave/config.json` from. Used AS GIVEN
+ *                      (no upward walk) so callers stay deterministic; omit it to resolve
+ *                      the effective (umbrella-aware) root automatically.
+ * @param env         - Environment to read overrides from (defaults to `process.env`).
+ */
+export function loadJevConfig(projectRoot, env = process.env) {
+    const root = projectRoot ?? resolveEffectiveRoot();
+    const file = readJevSection(root);
+    const fileThresholds = record(file.thresholds);
+    const fileGuards = record(file.guards);
+    const fileBrowse = record(file.browse);
+    // Provider: env wins, then file, then default.
+    const envProvider = str(env.SPECWEAVE_JEV_PROVIDER);
+    const provider = isProvider(envProvider)
+        ? envProvider
+        : isProvider(file.provider)
+            ? file.provider
+            : JEV_DEFAULTS.provider;
+    // Model: env wins, then file, then the provider's default model.
+    const model = str(env.SPECWEAVE_JEV_MODEL) ?? str(file.model) ?? JEV_PROVIDER_MODEL[provider];
+    // Enabled: SPECWEAVE_JEV=0 forces off, =1 forces on, otherwise the file decides.
+    let enabled = bool(file.enabled, JEV_DEFAULTS.enabled);
+    const flag = str(env.SPECWEAVE_JEV)?.toLowerCase();
+    if (flag === '0' || flag === 'false' || flag === 'off')
+        enabled = false;
+    else if (flag === '1' || flag === 'true' || flag === 'on')
+        enabled = true;
+    const allowDomains = Array.isArray(fileBrowse.allowDomains)
+        ? fileBrowse.allowDomains.filter((d) => typeof d === 'string')
+        : [...JEV_DEFAULTS.browse.allowDomains];
+    return {
+        enabled,
+        provider,
+        model,
+        apiKeyEnv: str(file.apiKeyEnv),
+        timeoutMs: num(file.timeoutMs, JEV_DEFAULTS.timeoutMs),
+        thresholds: thresholds(fileThresholds),
+        guards: { bash: bool(fileGuards.bash, JEV_DEFAULTS.guards.bash) },
+        modelRouting: bool(file.modelRouting, JEV_DEFAULTS.modelRouting),
+        browse: {
+            allowDomains,
+            maxSteps: num(fileBrowse.maxSteps, JEV_DEFAULTS.browse.maxSteps),
+        },
+    };
+}
+/** True when this project (and this process) may call Jev. */
+export function isJevEnabled(projectRoot, env = process.env) {
+    return loadJevConfig(projectRoot, env).enabled;
+}
+/**
+ * Resolve the API key.
+ *
+ * Order: `cfg.apiKeyEnv` -> the provider's default var -> `JEV_API_KEY`.
+ *
+ * @returns `{ key, source }` where `source` is the env var NAME (safe to print), or null.
+ */
+export function resolveApiKey(cfg, env = process.env) {
+    const candidates = [cfg.apiKeyEnv, JEV_PROVIDER_KEY_ENV[cfg.provider], JEV_FALLBACK_KEY_ENV];
+    for (const name of candidates) {
+        if (!name)
+            continue;
+        const value = env[name];
+        if (typeof value === 'string' && value.trim()) {
+            return { key: value.trim(), source: name };
+        }
+    }
+    return null;
+}
+/** Endpoint URL for a config's provider. */
+export function jevEndpoint(cfg) {
+    return JEV_PROVIDER_ENDPOINT[cfg.provider] ?? JEV_PROVIDER_ENDPOINT.openrouter;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/core/jev/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/core/jev/config.ts"],"names":[],"mappings":"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"}

package/dist/src/core/jev/decide.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Jev decisions — typed helpers callers can use without handling HTTP.
+ *
+ * Every helper is "fail soft": when Jev is unavailable (disabled, no key, timeout,
+ * rate limit, schema drift) the helper returns `{ available: false, reason }` instead of
+ * throwing, so the caller keeps its existing heuristic. Nothing here ever throws.
+ *
+ * Fan-out rule: independent questions about the same state go in ONE request.
+ *
+ * @module core/jev/decide
+ */
+import { type JevClient } from './client.js';
+import type { JevConfig } from './config.js';
+import { type CommandScope, type RequestKind, type TaskComplexity, type TestFailureKind } from './questions.js';
+/** Same three tiers as utils/model-selection; declared locally to avoid an import cycle. */
+export type ModelTier = 'haiku' | 'sonnet' | 'opus';
+export interface Unavailable {
+    available: false;
+    reason: string;
+}
+export interface RouteDecisionOk {
+    available: true;
+    skill: string | null;
+    skillConfidence: number;
+    skillProbabilities: Record<string, number>;
+    kind: RequestKind;
+    kindConfidence: number;
+    complexity: TaskComplexity;
+    complexityConfidence: number;
+    tier: ModelTier;
+    needsIncrement: number;
+    latencyMs: number;
+    cost?: number;
+}
+export type RouteDecision = RouteDecisionOk | Unavailable;
+export interface TaskDecisionOk {
+    available: true;
+    complexity: TaskComplexity;
+    confidence: number;
+    tier: ModelTier;
+    needsIncrement: number;
+    latencyMs: number;
+    cost?: number;
+}
+export type TaskDecision = TaskDecisionOk | Unavailable;
+export interface GuardDecisionOk {
+    available: true;
+    verdict: 'allow' | 'warn' | 'deny';
+    scope: CommandScope;
+    scopeConfidence: number;
+    destructive: number;
+    prefiltered: boolean;
+    probabilities: Record<string, number>;
+    reason: string;
+    latencyMs: number;
+    cost?: number;
+}
+export type GuardDecision = GuardDecisionOk | Unavailable;
+export type AcDecision = {
+    id: string;
+    available: true;
+    satisfied: boolean;
+    probability: number;
+} | {
+    id: string;
+    available: false;
+    reason: string;
+};
+export interface FailureDecisionOk {
+    available: true;
+    kind: TestFailureKind;
+    confidence: number;
+    probabilities: Record<string, number>;
+    latencyMs: number;
+}
+export type FailureDecision = FailureDecisionOk | Unavailable;
+export interface ScreenDecisionOk {
+    available: true;
+    injection: number;
+    flagged: boolean;
+    latencyMs: number;
+}
+export type ScreenDecision = ScreenDecisionOk | Unavailable;
+/** Hard cap on ACs judged in one fan-out request. */
+export declare const MAX_ACS_PER_REQUEST = 40;
+/**
+ * Complexity → model tier, with a confidence floor: an uncertain classification
+ * always escalates to opus rather than saving money on a task we misread.
+ */
+export declare function modelTierFor(complexity: TaskComplexity, confidence: number, threshold: number): ModelTier;
+/**
+ * Turn the two guard answers into a verdict (spec 0878, "Verdict" bullet).
+ *
+ * Deny needs high confidence; warn is deliberately generous.
+ *
+ * The scope-confidence deny arm exists because a near-certain local wipe scores its
+ * *scope* high but its *destructiveness* only moderately: `rm -rf ~/Projects` comes back
+ * scope=local_irreversible at 0.99 with destructive=0.81, below guardDeny (0.85). Gating
+ * on the scope confidence catches it without lowering guardDeny, which would loosen every
+ * remote verdict too.
+ *
+ * `destructive_remote` is in the warn arm so a low-confidence remote-destruction reading
+ * degrades to warn rather than falling through to allow.
+ */
+export declare function guardVerdict(scope: string, scopeConf: number, destructive: number, t: JevConfig['thresholds'], 
+/** p(local_irreversible) + p(destructive_remote): the two scopes that both mean "data is gone". */
+irreversibleMass?: number): 'allow' | 'warn' | 'deny';
+/**
+ * Cheap regex gate in front of the guard: plainly read-only commands skip Jev entirely.
+ * Conservative by construction — anything unrecognised returns 'check'.
+ */
+export declare function prefilterCommand(command: string): 'skip' | 'check';
+/**
+ * One fan-out request: which skill, what kind of request, how complex, increment needed.
+ */
+export declare function routePrompt(client: JevClient, prompt: string, ctx: {
+    skills: Array<{
+        name: string;
+        description: string;
+    }>;
+    activeIncrement?: string;
+}): Promise<RouteDecision>;
+/** How much reasoning one increment task needs → model tier. */
+export declare function classifyTask(client: JevClient, task: {
+    id: string;
+    title: string;
+    body: string;
+    acs: string[];
+    approach?: string;
+}): Promise<TaskDecision>;
+/** Scope + destructiveness of a shell command, behind the regex prefilter. */
+export declare function guardCommand(client: JevClient, cmd: {
+    command: string;
+    cwd?: string;
+    description?: string;
+}): Promise<GuardDecision>;
+/** One noul per acceptance criterion, all in one request (capped at 40). */
+export declare function judgeAcs(client: JevClient, acs: Array<{
+    id: string;
+    text: string;
+}>, evidence: {
+    diffSummary?: string;
+    testOutputTail?: string;
+    notes?: string;
+}): Promise<AcDecision[]>;
+/** Regression vs flake vs environment, from a failing test tail. */
+export declare function classifyFailure(client: JevClient, outputTail: string, ctx?: {
+    changedFiles?: string[];
+}): Promise<FailureDecision>;
+/** Does untrusted text (issue body, page text, email) address an agent? */
+export declare function screenText(client: JevClient, text: string, source?: string): Promise<ScreenDecision>;
+/**
+ * Probability that a test/build output is a clean pass.
+ * `available: false` means the caller must fall back to its own parser — `passed` is 0
+ * in that case so treating "unknown" as "not passed" stays the safe default.
+ */
+export declare function testOutputPassed(client: JevClient, output: string, kind: 'tests' | 'build'): Promise<{
+    passed: number;
+    available: boolean;
+    reason?: string;
+}>;
+//# sourceMappingURL=decide.d.ts.map

package/dist/src/core/jev/decide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../../../src/core/jev/decide.ts"],"names":[],"mappings":"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"}