@bradygaster/squad-sdk 0.8.5 → 0.8.16

package/dist/multi-squad.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Multi-squad resolution, configuration, and migration.
+ *
+ * Supports multiple personal squads via a global config directory:
+ *   - Windows: %APPDATA%/squad/
+ *   - macOS:   ~/Library/Application Support/squad/
+ *   - Linux:   $XDG_CONFIG_HOME/squad/ (default ~/.config/squad/)
+ *
+ * Each squad is registered in squads.json and has its own directory
+ * under squads/{name}/ in the global config root.
+ *
+ * Resolution chain for resolveSquadPath():
+ *   explicit name → SQUAD_NAME env var → active in squads.json → "default" → legacy fallback
+ *
+ * @module multi-squad
+ */
+/** A single squad entry in squads.json. */
+export interface SquadEntry {
+    /** Human-readable squad name (kebab-case recommended). */
+    name: string;
+    /** Absolute path to the squad's .squad/ state directory. */
+    path: string;
+    /** ISO-8601 timestamp when this squad was created. */
+    created_at: string;
+}
+/** Schema for the global squads.json config file. */
+export interface MultiSquadConfig {
+    /** All registered squads. */
+    squads: SquadEntry[];
+    /** Name of the currently active squad. */
+    active: string;
+}
+/** Information returned by listSquads(). */
+export interface SquadInfo {
+    name: string;
+    path: string;
+    active: boolean;
+}
+/**
+ * Returns the platform-appropriate global config directory for squads.
+ * Delegates to resolveGlobalSquadPath() which handles Windows/macOS/Linux.
+ */
+export declare function getSquadRoot(): string;
+/**
+ * Resolve the filesystem path for a named squad's state directory.
+ *
+ * Resolution chain:
+ *  1. Explicit `name` parameter
+ *  2. SQUAD_NAME environment variable
+ *  3. `active` field in squads.json
+ *  4. "default"
+ *  5. Legacy ~/.squad fallback (if no squads.json exists)
+ *
+ * Triggers auto-migration on first call if a legacy layout is detected.
+ */
+export declare function resolveSquadPath(name?: string): string;
+/**
+ * List all registered squads with their active status.
+ */
+export declare function listSquads(): SquadInfo[];
+/**
+ * Create a new squad directory and register it in squads.json.
+ * Returns the absolute path to the new squad's state directory.
+ *
+ * @throws If a squad with the given name already exists.
+ */
+export declare function createSquad(name: string): string;
+/**
+ * Delete a squad by name. Removes its directory and unregisters it.
+ *
+ * @throws If the squad is the currently active one, or if it doesn't exist.
+ */
+export declare function deleteSquad(name: string): void;
+/**
+ * Set the active squad in squads.json.
+ *
+ * @throws If the named squad is not registered.
+ */
+export declare function switchSquad(name: string): void;
+/**
+ * Detect legacy ~/.squad layout and register it as "default" in squads.json.
+ *
+ * Migration is **non-destructive**: files are NOT moved. The existing path
+ * is simply registered in squads.json so the new resolution chain finds it.
+ *
+ * @returns `true` if migration was performed, `false` if not needed.
+ */
+export declare function migrateIfNeeded(): boolean;
+//# sourceMappingURL=multi-squad.d.ts.map

package/dist/multi-squad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-squad.d.ts","sourceRoot":"","sources":["../src/multi-squad.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AA8DD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBtD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,SAAS,EAAE,CAUxC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBhD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAwB9C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAc9C;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAoCzC"}

package/dist/multi-squad.js

@@ -0,0 +1,233 @@
+/**
+ * Multi-squad resolution, configuration, and migration.
+ *
+ * Supports multiple personal squads via a global config directory:
+ *   - Windows: %APPDATA%/squad/
+ *   - macOS:   ~/Library/Application Support/squad/
+ *   - Linux:   $XDG_CONFIG_HOME/squad/ (default ~/.config/squad/)
+ *
+ * Each squad is registered in squads.json and has its own directory
+ * under squads/{name}/ in the global config root.
+ *
+ * Resolution chain for resolveSquadPath():
+ *   explicit name → SQUAD_NAME env var → active in squads.json → "default" → legacy fallback
+ *
+ * @module multi-squad
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { resolveGlobalSquadPath } from './resolution.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const SQUADS_JSON = 'squads.json';
+const SQUADS_DIR = 'squads';
+const DEFAULT_SQUAD = 'default';
+const LEGACY_DIR = '.squad';
+// ============================================================================
+// Internal helpers
+// ============================================================================
+/** Path to squads.json inside the global config root. */
+function squadsJsonPath() {
+    return path.join(resolveGlobalSquadPath(), SQUADS_JSON);
+}
+/** Read and parse squads.json, returning null if missing or malformed. */
+function loadSquadsConfig() {
+    const configPath = squadsJsonPath();
+    if (!fs.existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed !== null &&
+            typeof parsed === 'object' &&
+            'squads' in parsed &&
+            Array.isArray(parsed.squads) &&
+            'active' in parsed &&
+            typeof parsed.active === 'string') {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Write squads.json atomically. */
+function saveSquadsConfig(config) {
+    const configPath = squadsJsonPath();
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+/** Validate a squad name: non-empty, no slashes, no dots-only. */
+function validateName(name) {
+    if (!name || /[/\\]/.test(name) || /^\.+$/.test(name)) {
+        throw new Error(`Invalid squad name: "${name}". Names must be non-empty and cannot contain slashes.`);
+    }
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Returns the platform-appropriate global config directory for squads.
+ * Delegates to resolveGlobalSquadPath() which handles Windows/macOS/Linux.
+ */
+export function getSquadRoot() {
+    return resolveGlobalSquadPath();
+}
+/**
+ * Resolve the filesystem path for a named squad's state directory.
+ *
+ * Resolution chain:
+ *  1. Explicit `name` parameter
+ *  2. SQUAD_NAME environment variable
+ *  3. `active` field in squads.json
+ *  4. "default"
+ *  5. Legacy ~/.squad fallback (if no squads.json exists)
+ *
+ * Triggers auto-migration on first call if a legacy layout is detected.
+ */
+export function resolveSquadPath(name) {
+    // Auto-migrate legacy layout if needed
+    migrateIfNeeded();
+    const resolved = name ??
+        process.env['SQUAD_NAME'] ??
+        loadSquadsConfig()?.active ??
+        DEFAULT_SQUAD;
+    const config = loadSquadsConfig();
+    // Look up registered path
+    if (config) {
+        const entry = config.squads.find((s) => s.name === resolved);
+        if (entry) {
+            return entry.path;
+        }
+    }
+    // Fallback: derive path inside global config dir
+    const root = getSquadRoot();
+    return path.join(root, SQUADS_DIR, resolved);
+}
+/**
+ * List all registered squads with their active status.
+ */
+export function listSquads() {
+    const config = loadSquadsConfig();
+    if (!config) {
+        return [];
+    }
+    return config.squads.map((s) => ({
+        name: s.name,
+        path: s.path,
+        active: s.name === config.active,
+    }));
+}
+/**
+ * Create a new squad directory and register it in squads.json.
+ * Returns the absolute path to the new squad's state directory.
+ *
+ * @throws If a squad with the given name already exists.
+ */
+export function createSquad(name) {
+    validateName(name);
+    // Ensure squads.json exists (migrate or bootstrap)
+    migrateIfNeeded();
+    let config = loadSquadsConfig();
+    if (!config) {
+        config = { squads: [], active: DEFAULT_SQUAD };
+    }
+    if (config.squads.some((s) => s.name === name)) {
+        throw new Error(`Squad "${name}" already exists.`);
+    }
+    const squadDir = path.join(getSquadRoot(), SQUADS_DIR, name);
+    fs.mkdirSync(squadDir, { recursive: true });
+    config.squads.push({
+        name,
+        path: squadDir,
+        created_at: new Date().toISOString(),
+    });
+    saveSquadsConfig(config);
+    return squadDir;
+}
+/**
+ * Delete a squad by name. Removes its directory and unregisters it.
+ *
+ * @throws If the squad is the currently active one, or if it doesn't exist.
+ */
+export function deleteSquad(name) {
+    validateName(name);
+    const config = loadSquadsConfig();
+    if (!config) {
+        throw new Error(`Squad "${name}" not found.`);
+    }
+    if (config.active === name) {
+        throw new Error(`Cannot delete the active squad "${name}". Switch to another squad first.`);
+    }
+    const idx = config.squads.findIndex((s) => s.name === name);
+    if (idx === -1) {
+        throw new Error(`Squad "${name}" not found.`);
+    }
+    const entry = config.squads[idx];
+    if (entry && fs.existsSync(entry.path)) {
+        fs.rmSync(entry.path, { recursive: true, force: true });
+    }
+    config.squads.splice(idx, 1);
+    saveSquadsConfig(config);
+}
+/**
+ * Set the active squad in squads.json.
+ *
+ * @throws If the named squad is not registered.
+ */
+export function switchSquad(name) {
+    validateName(name);
+    const config = loadSquadsConfig();
+    if (!config) {
+        throw new Error(`No squads configured. Cannot switch to "${name}".`);
+    }
+    if (!config.squads.some((s) => s.name === name)) {
+        throw new Error(`Squad "${name}" not found. Register it first with createSquad().`);
+    }
+    config.active = name;
+    saveSquadsConfig(config);
+}
+/**
+ * Detect legacy ~/.squad layout and register it as "default" in squads.json.
+ *
+ * Migration is **non-destructive**: files are NOT moved. The existing path
+ * is simply registered in squads.json so the new resolution chain finds it.
+ *
+ * @returns `true` if migration was performed, `false` if not needed.
+ */
+export function migrateIfNeeded() {
+    const root = getSquadRoot();
+    const configPath = path.join(root, SQUADS_JSON);
+    // If squads.json already exists, no migration needed
+    if (fs.existsSync(configPath)) {
+        return false;
+    }
+    // Check for legacy ~/.squad directory
+    const home = process.env['HOME'] ?? process.env['USERPROFILE'] ?? '';
+    const legacyDir = path.join(home, LEGACY_DIR);
+    if (!home || !fs.existsSync(legacyDir) || !fs.statSync(legacyDir).isDirectory()) {
+        // No legacy layout — bootstrap empty config
+        const config = {
+            squads: [],
+            active: DEFAULT_SQUAD,
+        };
+        saveSquadsConfig(config);
+        return false;
+    }
+    // Legacy layout detected — register it as "default" without moving files
+    const config = {
+        squads: [
+            {
+                name: DEFAULT_SQUAD,
+                path: legacyDir,
+                created_at: new Date().toISOString(),
+            },
+        ],
+        active: DEFAULT_SQUAD,
+    };
+    saveSquadsConfig(config);
+    return true;
+}
+//# sourceMappingURL=multi-squad.js.map

package/dist/multi-squad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-squad.js","sourceRoot":"","sources":["../src/multi-squad.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AA+BzD,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,WAAW,GAAG,aAAa,CAAC;AAClC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAC5B,MAAM,aAAa,GAAG,SAAS,CAAC;AAChC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAE5B,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,yDAAyD;AACzD,SAAS,cAAc;IACrB,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,WAAW,CAAC,CAAC;AAC1D,CAAC;AAED,0EAA0E;AAC1E,SAAS,gBAAgB;IACvB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IACE,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,KAAK,QAAQ;YAC1B,QAAQ,IAAI,MAAM;YAClB,KAAK,CAAC,OAAO,CAAE,MAAkC,CAAC,MAAM,CAAC;YACzD,QAAQ,IAAI,MAAM;YAClB,OAAQ,MAAkC,CAAC,MAAM,KAAK,QAAQ,EAC9D,CAAC;YACD,OAAO,MAA0B,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,oCAAoC;AACpC,SAAS,gBAAgB,CAAC,MAAwB;IAChD,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,kEAAkE;AAClE,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,wDAAwD,CAAC,CAAC;IACxG,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,sBAAsB,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,uCAAuC;IACvC,eAAe,EAAE,CAAC;IAElB,MAAM,QAAQ,GACZ,IAAI;QACJ,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACzB,gBAAgB,EAAE,EAAE,MAAM;QAC1B,aAAa,CAAC;IAEhB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAElC,0BAA0B;IAC1B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC7D,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;KACjC,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,YAAY,CAAC,IAAI,CAAC,CAAC;IAEnB,mDAAmD;IACnD,eAAe,EAAE,CAAC;IAClB,IAAI,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IAC7D,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACjB,IAAI;QACJ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC,CAAC;IACH,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,YAAY,CAAC,IAAI,CAAC,CAAC;IAEnB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,cAAc,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,mCAAmC,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC5D,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,cAAc,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,YAAY,CAAC,IAAI,CAAC,CAAC;IAEnB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2CAA2C,IAAI,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,oDAAoD,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAEhD,qDAAqD;IACrD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sCAAsC;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE9C,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAChF,4CAA4C;QAC5C,MAAM,MAAM,GAAqB;YAC/B,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,aAAa;SACtB,CAAC;QACF,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yEAAyE;IACzE,MAAM,MAAM,GAAqB;QAC/B,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC;SACF;QACD,MAAM,EAAE,aAAa;KACtB,CAAC;IACF,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/ralph/triage.d.ts

@@ -0,0 +1,48 @@
+/** Parsed routing rule from routing.md */
+export interface RoutingRule {
+    workType: string;
+    agentName: string;
+    keywords: string[];
+}
+/** Parsed module ownership rule from routing.md */
+export interface ModuleOwnership {
+    modulePath: string;
+    primary: string;
+    secondary: string | null;
+}
+/** Team member from team.md roster */
+export interface TeamMember {
+    name: string;
+    role: string;
+    label: string;
+}
+/** Triage decision result */
+export interface TriageDecision {
+    agent: TeamMember;
+    reason: string;
+    source: 'module-ownership' | 'routing-rule' | 'role-keyword' | 'lead-fallback';
+    confidence: 'high' | 'medium' | 'low';
+}
+/** Issue data for triage */
+export interface TriageIssue {
+    number: number;
+    title: string;
+    body?: string;
+    labels: string[];
+}
+/** Parse routing rules from routing.md content */
+export declare function parseRoutingRules(routingMd: string): RoutingRule[];
+/** Parse module ownership from routing.md content */
+export declare function parseModuleOwnership(routingMd: string): ModuleOwnership[];
+/** Parse team roster from team.md content */
+export declare function parseRoster(teamMd: string): TeamMember[];
+/**
+ * Triage an issue using routing rules, module ownership, and roster.
+ * Priority order:
+ * 1. Module path match — issue mentions a file path matching module ownership
+ * 2. Work type keyword — issue content matches routing rule keywords
+ * 3. Role keyword — fallback to generic role-based matching (frontend/backend/test)
+ * 4. Lead fallback — assign to Lead/Architect if no match
+ */
+export declare function triageIssue(issue: TriageIssue, rules: RoutingRule[], modules: ModuleOwnership[], roster: TeamMember[]): TriageDecision | null;
+//# sourceMappingURL=triage.d.ts.map

package/dist/ralph/triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../src/ralph/triage.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,kBAAkB,GAAG,cAAc,GAAG,cAAc,GAAG,eAAe,CAAC;IAC/E,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAOD,kDAAkD;AAClD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAwBlE;AAED,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE,CAsBzE;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CA4BxD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,EAAE,eAAe,EAAE,EAC1B,MAAM,EAAE,UAAU,EAAE,GACnB,cAAc,GAAG,IAAI,CA6DvB"}