@slope-dev/slope 1.5.1

package/dist/core/escalation.d.ts

@@ -0,0 +1,52 @@
+import type { SlopeEvent, SprintConflict } from './types.js';
+import type { StandupReport } from './standup.js';
+/** Escalation trigger types */
+export type EscalationTrigger = 'blocker_timeout' | 'claim_conflict' | 'test_failure_cascade' | 'manual';
+/** Escalation severity */
+export type EscalationSeverity = 'warning' | 'critical';
+/** Escalation action to take */
+export type EscalationAction = 'log_event' | 'mark_blocked' | 'notify_standup';
+/** Configuration for escalation rules in .slope/config.json */
+export interface EscalationConfig {
+    /** Minutes before a blocked agent triggers escalation (default: 15) */
+    blocker_timeout?: number;
+    /** Whether claim conflicts auto-escalate (default: true) */
+    claim_conflict?: boolean;
+    /** Number of test failures across swarm before escalation (default: 10) */
+    test_failure_cascade?: number;
+    /** Actions to take on escalation */
+    actions?: EscalationAction[];
+}
+/** A detected escalation condition */
+export interface EscalationResult {
+    trigger: EscalationTrigger;
+    severity: EscalationSeverity;
+    description: string;
+    session_id?: string;
+    agent_role?: string;
+    actions: EscalationAction[];
+}
+/**
+ * Merge user config with defaults.
+ */
+export declare function resolveEscalationConfig(config?: EscalationConfig): Required<EscalationConfig>;
+/**
+ * Detect escalation conditions from swarm state.
+ *
+ * Checks three trigger types:
+ * 1. blocker_timeout — agent blocked for longer than configured threshold
+ * 2. claim_conflict — overlapping claims between agents
+ * 3. test_failure_cascade — excessive test failures across the swarm
+ */
+export declare function detectEscalation(opts: {
+    config?: EscalationConfig;
+    standups?: StandupReport[];
+    conflicts?: SprintConflict[];
+    events?: SlopeEvent[];
+    now?: number;
+}): EscalationResult[];
+/**
+ * Create an escalation event suitable for store.insertEvent().
+ */
+export declare function buildEscalationEvent(escalation: EscalationResult, sessionId: string, sprintNumber?: number): Omit<SlopeEvent, 'id' | 'timestamp'>;
+//# sourceMappingURL=escalation.d.ts.map

package/dist/core/escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../../src/core/escalation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAe,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,+BAA+B;AAC/B,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,QAAQ,CAAC;AAEzG,0BAA0B;AAC1B,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,CAAC;AAExD,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAE/E,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oCAAoC;IACpC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AASD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAQ7F;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,gBAAgB,EAAE,CA6DrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,CAAC,CAatC"}

package/dist/core/escalation.js

@@ -0,0 +1,105 @@
+// SLOPE — Escalation Rules
+// Detects conditions that warrant escalation in multi-agent sprints.
+const DEFAULT_CONFIG = {
+    blocker_timeout: 15,
+    claim_conflict: true,
+    test_failure_cascade: 10,
+    actions: ['log_event', 'notify_standup'],
+};
+/**
+ * Merge user config with defaults.
+ */
+export function resolveEscalationConfig(config) {
+    if (!config)
+        return { ...DEFAULT_CONFIG };
+    return {
+        blocker_timeout: config.blocker_timeout ?? DEFAULT_CONFIG.blocker_timeout,
+        claim_conflict: config.claim_conflict ?? DEFAULT_CONFIG.claim_conflict,
+        test_failure_cascade: config.test_failure_cascade ?? DEFAULT_CONFIG.test_failure_cascade,
+        actions: config.actions ?? DEFAULT_CONFIG.actions,
+    };
+}
+/**
+ * Detect escalation conditions from swarm state.
+ *
+ * Checks three trigger types:
+ * 1. blocker_timeout — agent blocked for longer than configured threshold
+ * 2. claim_conflict — overlapping claims between agents
+ * 3. test_failure_cascade — excessive test failures across the swarm
+ */
+export function detectEscalation(opts) {
+    const config = resolveEscalationConfig(opts.config);
+    const results = [];
+    const now = opts.now ?? Date.now();
+    // 1. Blocker timeout — agents blocked for too long
+    if (opts.standups) {
+        for (const standup of opts.standups) {
+            if (standup.status === 'blocked' && standup.blockers.length > 0) {
+                const standupTime = new Date(standup.timestamp).getTime();
+                const blockedMinutes = (now - standupTime) / 60000;
+                if (blockedMinutes >= config.blocker_timeout) {
+                    results.push({
+                        trigger: 'blocker_timeout',
+                        severity: blockedMinutes >= config.blocker_timeout * 2 ? 'critical' : 'warning',
+                        description: `Agent ${standup.sessionId} blocked for ${Math.round(blockedMinutes)}m (threshold: ${config.blocker_timeout}m): ${standup.blockers[0]}`,
+                        session_id: standup.sessionId,
+                        agent_role: standup.agent_role,
+                        actions: config.actions,
+                    });
+                }
+            }
+        }
+    }
+    // 2. Claim conflicts — overlapping scope between agents
+    if (config.claim_conflict && opts.conflicts) {
+        for (const conflict of opts.conflicts) {
+            if (conflict.severity === 'overlap') {
+                results.push({
+                    trigger: 'claim_conflict',
+                    severity: 'critical',
+                    description: conflict.reason,
+                    actions: config.actions,
+                });
+            }
+            else {
+                results.push({
+                    trigger: 'claim_conflict',
+                    severity: 'warning',
+                    description: conflict.reason,
+                    actions: config.actions,
+                });
+            }
+        }
+    }
+    // 3. Test failure cascade — too many failures across swarm
+    if (opts.events) {
+        const failureEvents = opts.events.filter(e => e.type === 'failure');
+        if (failureEvents.length >= config.test_failure_cascade) {
+            results.push({
+                trigger: 'test_failure_cascade',
+                severity: failureEvents.length >= config.test_failure_cascade * 2 ? 'critical' : 'warning',
+                description: `${failureEvents.length} failure events across swarm (threshold: ${config.test_failure_cascade})`,
+                actions: config.actions,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Create an escalation event suitable for store.insertEvent().
+ */
+export function buildEscalationEvent(escalation, sessionId, sprintNumber) {
+    return {
+        session_id: sessionId,
+        type: 'hazard',
+        data: {
+            escalation_trigger: escalation.trigger,
+            escalation_severity: escalation.severity,
+            description: escalation.description,
+            actions: escalation.actions,
+            ...(escalation.agent_role ? { agent_role: escalation.agent_role } : {}),
+        },
+        sprint_number: sprintNumber,
+    };
+}
+//# sourceMappingURL=escalation.js.map

package/dist/core/escalation.js.map

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

package/dist/core/flows.d.ts

@@ -0,0 +1,44 @@
+/** A single step in a user flow */
+export interface FlowStep {
+    name: string;
+    description: string;
+    file_paths: string[];
+    notes?: string;
+}
+/** A complete flow definition mapping a user workflow to code */
+export interface FlowDefinition {
+    id: string;
+    title: string;
+    description: string;
+    entry_point: string;
+    steps: FlowStep[];
+    files: string[];
+    tags: string[];
+    last_verified_sha: string;
+    last_verified_at: string;
+}
+/** Top-level flows file schema */
+export interface FlowsFile {
+    version: '1';
+    last_generated: string;
+    flows: FlowDefinition[];
+}
+/** Result of flow validation */
+export interface FlowValidationResult {
+    errors: string[];
+    warnings: string[];
+}
+/** Result of staleness check for a single flow */
+export interface FlowStalenessResult {
+    stale: boolean;
+    changedFiles: string[];
+}
+/** Parse and validate a flows JSON string */
+export declare function parseFlows(json: string): FlowsFile;
+/** Validate flows against the filesystem — check file paths resolve, detect issues */
+export declare function validateFlows(flows: FlowsFile, cwd: string): FlowValidationResult;
+/** Check if files in a flow have changed since last_verified_sha */
+export declare function checkFlowStaleness(flow: FlowDefinition, currentSha: string, cwd: string): FlowStalenessResult;
+/** Load and parse flows from a file path. Returns null if file doesn't exist. */
+export declare function loadFlows(flowsPath: string): FlowsFile | null;
+//# sourceMappingURL=flows.d.ts.map

package/dist/core/flows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/core/flows.ts"],"names":[],"mappings":"AAMA,mCAAmC;AACnC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,GAAG,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,gCAAgC;AAChC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAgClD;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAoDjF;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,mBAAmB,CA0BrB;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAU7D"}

package/dist/core/flows.js

@@ -0,0 +1,123 @@
+// Flow tracking — map user-facing workflows to code paths.
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+/** Parse and validate a flows JSON string */
+export function parseFlows(json) {
+    const raw = JSON.parse(json);
+    if (!raw || typeof raw !== 'object') {
+        throw new Error('flows.json must be an object');
+    }
+    if (raw.version !== '1') {
+        throw new Error(`Unsupported flows version: ${raw.version}`);
+    }
+    if (!Array.isArray(raw.flows)) {
+        throw new Error('flows.json must have a "flows" array');
+    }
+    for (const flow of raw.flows) {
+        if (!flow.id || typeof flow.id !== 'string') {
+            throw new Error('Each flow must have a string "id"');
+        }
+        if (!flow.title || typeof flow.title !== 'string') {
+            throw new Error(`Flow "${flow.id}": must have a string "title"`);
+        }
+        if (!Array.isArray(flow.steps)) {
+            throw new Error(`Flow "${flow.id}": must have a "steps" array`);
+        }
+        if (!Array.isArray(flow.files)) {
+            throw new Error(`Flow "${flow.id}": must have a "files" array`);
+        }
+        if (!Array.isArray(flow.tags)) {
+            throw new Error(`Flow "${flow.id}": must have a "tags" array`);
+        }
+    }
+    return raw;
+}
+/** Validate flows against the filesystem — check file paths resolve, detect issues */
+export function validateFlows(flows, cwd) {
+    const errors = [];
+    const warnings = [];
+    const seenIds = new Set();
+    for (const flow of flows.flows) {
+        // Duplicate ID check
+        if (seenIds.has(flow.id)) {
+            errors.push(`Duplicate flow ID: "${flow.id}"`);
+        }
+        seenIds.add(flow.id);
+        // Check top-level files exist
+        const missingFiles = [];
+        for (const filePath of flow.files) {
+            if (!resolveFileExists(filePath, cwd)) {
+                missingFiles.push(filePath);
+            }
+        }
+        if (missingFiles.length > 0) {
+            errors.push(`Flow "${flow.id}": ${missingFiles.length} file(s) not found: ${missingFiles.join(', ')}`);
+        }
+        // Check step file_paths exist
+        for (const step of flow.steps) {
+            for (const fp of step.file_paths) {
+                if (!resolveFileExists(fp, cwd)) {
+                    warnings.push(`Flow "${flow.id}" step "${step.name}": file not found: ${fp}`);
+                }
+            }
+        }
+        // Check for orphaned step paths not in files list
+        const filesSet = new Set(flow.files);
+        for (const step of flow.steps) {
+            for (const fp of step.file_paths) {
+                if (!filesSet.has(fp)) {
+                    warnings.push(`Flow "${flow.id}" step "${step.name}": "${fp}" not in top-level files list`);
+                }
+            }
+        }
+        // Empty checks
+        if (flow.steps.length === 0) {
+            warnings.push(`Flow "${flow.id}": has no steps`);
+        }
+        if (flow.files.length === 0) {
+            warnings.push(`Flow "${flow.id}": has no files`);
+        }
+    }
+    return { errors, warnings };
+}
+/** Check if files in a flow have changed since last_verified_sha */
+export function checkFlowStaleness(flow, currentSha, cwd) {
+    if (!flow.last_verified_sha || flow.last_verified_sha === currentSha) {
+        return { stale: false, changedFiles: [] };
+    }
+    try {
+        const output = execSync(`git diff --name-only ${flow.last_verified_sha}..${currentSha} 2>/dev/null`, { cwd, encoding: 'utf8', timeout: 10000 }).trim();
+        if (!output) {
+            return { stale: false, changedFiles: [] };
+        }
+        const changedInRepo = new Set(output.split('\n').filter(Boolean));
+        const changedFiles = flow.files.filter(f => changedInRepo.has(f));
+        return {
+            stale: changedFiles.length > 0,
+            changedFiles,
+        };
+    }
+    catch {
+        // git command failed — can't determine staleness, assume stale
+        return { stale: true, changedFiles: [] };
+    }
+}
+/** Load and parse flows from a file path. Returns null if file doesn't exist. */
+export function loadFlows(flowsPath) {
+    if (!existsSync(flowsPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(flowsPath, 'utf8');
+        return parseFlows(content);
+    }
+    catch {
+        return null;
+    }
+}
+// --- Helpers ---
+function resolveFileExists(filePath, cwd) {
+    return existsSync(join(cwd, filePath));
+}
+//# sourceMappingURL=flows.js.map

package/dist/core/flows.js.map

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

package/dist/core/formatter.d.ts

@@ -0,0 +1,23 @@
+import type { GolfScorecard, ClubRecommendation, TrainingRecommendation } from './types.js';
+import type { MetaphorDefinition } from './metaphor.js';
+/** Generic project stats — teams define their own metrics */
+export type ProjectStats = Record<string, number | Record<string, number>>;
+/** Optional deltas to show +N changes in the review */
+export type ProjectStatsDelta = Record<string, number | undefined>;
+export type ReviewMode = 'technical' | 'plain';
+/**
+ * Format a SLOPE scorecard into a markdown sprint review.
+ *
+ * If projectStats is provided, renders a project stats table.
+ * If omitted, skips the infrastructure section entirely.
+ */
+export declare function formatSprintReview(card: GolfScorecard & {
+    sprint?: number;
+}, projectStats?: ProjectStats, deltas?: ProjectStatsDelta, mode?: ReviewMode, metaphor?: MetaphorDefinition): string;
+export interface AdvisorReportInput {
+    clubRecommendation?: ClubRecommendation;
+    trainingPlan?: TrainingRecommendation[];
+    hazardWarnings?: string[];
+}
+export declare function formatAdvisorReport(input: AdvisorReportInput, metaphor?: MetaphorDefinition): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/core/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/core/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAKb,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAKxD,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3E,uDAAuD;AACvD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAqBnE,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;AAyC/C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACzC,YAAY,CAAC,EAAE,YAAY,EAC3B,MAAM,CAAC,EAAE,iBAAiB,EAC1B,IAAI,GAAE,UAAwB,EAC9B,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,MAAM,CA+JR;AAID,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CA4CpG"}