@bradygaster/squad-sdk 0.8.0 → 0.8.2-1.4

package/dist/coordinator/index.js

@@ -11,7 +11,10 @@ export { SquadCoordinator, } from './coordinator.js';
 export { DirectResponseHandler, } from './direct-response.js';
 // --- M1-10 Fan-Out ---
 export { spawnParallel, aggregateSessionEvents, } from './fan-out.js';
-// --- Coordinator ---
+// --- M3-4 Response Tiers ---
+export { selectResponseTier, getTier, } from './response-tiers.js';
+import { trace, SpanStatusCode } from '../runtime/otel-api.js';
+const tracer = trace.getTracer('squad-sdk');
 export class Coordinator {
     client = null;
     eventBus = null;
@@ -19,36 +22,156 @@ export class Coordinator {
     hookPipeline = null;
     toolRegistry = null;
     config;
-    constructor(config) {
+    initialized = false;
+    unsubscribers = [];
+    constructor(config, deps) {
         this.config = config;
-        // TODO: PRD 5 — Accept injected dependencies (client, eventBus, agentManager, hooks, tools)
+        if (deps) {
+            this.client = deps.client ?? null;
+            this.eventBus = deps.eventBus ?? null;
+            this.agentManager = deps.agentManager ?? null;
+            this.hookPipeline = deps.hookPipeline ?? null;
+            this.toolRegistry = deps.toolRegistry ?? null;
+        }
     }
-    /** Initialize the coordinator: connect client, load team, register hooks */
+    /** Initialize the coordinator: wire up event subscriptions and mark ready */
     async initialize() {
-        // TODO: PRD 5 — Initialize SquadClient and connect
-        // TODO: PRD 5 — Load all agent charters via CharterCompiler
-        // TODO: PRD 5 — Register custom tools via ToolRegistry
-        // TODO: PRD 5 — Set up hook pipeline
-        // TODO: PRD 5 — Subscribe to EventBus for agent lifecycle events
-        // TODO: PRD 5 — Create coordinator's own session for routing logic
+        const span = tracer.startSpan('squad.coordinator.initialize');
+        try {
+            if (this.eventBus) {
+                this.unsubscribers.push(this.eventBus.subscribe('session:created', (event) => {
+                    const s = tracer.startSpan('squad.coordinator.session.created');
+                    s.setAttribute('session.id', event.sessionId ?? 'unknown');
+                    s.end();
+                }));
+                this.unsubscribers.push(this.eventBus.subscribe('session:error', (event) => {
+                    const s = tracer.startSpan('squad.coordinator.session.error');
+                    s.setAttribute('session.id', event.sessionId ?? 'unknown');
+                    s.end();
+                }));
+                this.unsubscribers.push(this.eventBus.subscribe('session:destroyed', (event) => {
+                    const s = tracer.startSpan('squad.coordinator.session.destroyed');
+                    s.setAttribute('session.id', event.sessionId ?? 'unknown');
+                    s.end();
+                }));
+            }
+            this.initialized = true;
+        }
+        catch (err) {
+            span.setStatus({ code: SpanStatusCode.ERROR, message: err instanceof Error ? err.message : String(err) });
+            span.recordException(err instanceof Error ? err : new Error(String(err)));
+            throw err;
+        }
+        finally {
+            span.end();
+        }
     }
     /** Route an incoming user message to the appropriate agent(s) */
     async route(message) {
-        // TODO: PRD 5 — Determine response tier (direct/lightweight/standard/full)
-        // TODO: PRD 5 — Select target agent(s) based on message content and team roster
-        // TODO: PRD 5 — Handle parallel fan-out for multi-agent tasks
-        throw new Error('Not implemented');
+        const span = tracer.startSpan('squad.coordinator.route');
+        span.setAttribute('message.length', message.length);
+        try {
+            const lower = message.toLowerCase().trim();
+            let decision;
+            // Direct response: status queries, factual questions
+            if (/^(status|help|what is|who is|how many|show|list)\b/.test(lower)) {
+                decision = {
+                    tier: 'direct',
+                    agents: [],
+                    parallel: false,
+                    rationale: `Direct response for informational query: "${message}"`,
+                };
+            }
+            else {
+                // Agent name mention — route to that specific agent
+                const agentMention = lower.match(/@(\w+)/);
+                if (agentMention) {
+                    decision = {
+                        tier: 'standard',
+                        agents: [agentMention[1]],
+                        parallel: false,
+                        rationale: `Routed to mentioned agent: ${agentMention[1]}`,
+                    };
+                }
+                else if (/\bteam\b/.test(lower)) {
+                    // Team-wide task — fan-out to all agents
+                    decision = {
+                        tier: 'full',
+                        agents: ['all'],
+                        parallel: true,
+                        rationale: 'Team-wide task detected — fan-out to all agents',
+                    };
+                }
+                else {
+                    // Default: route to lead agent (Keaton)
+                    decision = {
+                        tier: 'standard',
+                        agents: ['lead'],
+                        parallel: false,
+                        rationale: 'Default routing to lead agent (Keaton)',
+                    };
+                }
+            }
+            span.setAttribute('routing.tier', decision.tier);
+            span.setAttribute('target.agents', decision.agents.join(','));
+            span.setAttribute('routing.reason', decision.rationale);
+            return decision;
+        }
+        catch (err) {
+            span.setStatus({ code: SpanStatusCode.ERROR, message: err instanceof Error ? err.message : String(err) });
+            span.recordException(err instanceof Error ? err : new Error(String(err)));
+            throw err;
+        }
+        finally {
+            span.end();
+        }
     }
-    /** Execute a routing decision: spawn/resume agents and deliver work */
+    /** Execute a routing decision: emit routing event on EventBus */
     async execute(decision, message) {
-        // TODO: PRD 5 — Spawn or resume agent sessions per decision
-        // TODO: PRD 5 — Deliver message via sendAndWait()
-        // TODO: PRD 5 — Monitor progress via event subscriptions
+        const span = tracer.startSpan('squad.coordinator.execute');
+        span.setAttribute('routing.tier', decision.tier);
+        span.setAttribute('target.agents', decision.agents.join(','));
+        try {
+            if (this.eventBus) {
+                await this.eventBus.emit({
+                    type: 'coordinator:routing',
+                    payload: { decision, message },
+                    timestamp: new Date(),
+                });
+            }
+        }
+        catch (err) {
+            span.setStatus({ code: SpanStatusCode.ERROR, message: err instanceof Error ? err.message : String(err) });
+            span.recordException(err instanceof Error ? err : new Error(String(err)));
+            throw err;
+        }
+        finally {
+            span.end();
+        }
     }
-    /** Graceful shutdown */
+    /** Graceful shutdown: unsubscribe from events and release references */
     async shutdown() {
-        // TODO: PRD 5 — Destroy all agent sessions
-        // TODO: PRD 5 — Disconnect client
+        const span = tracer.startSpan('squad.coordinator.shutdown');
+        try {
+            for (const unsub of this.unsubscribers) {
+                unsub();
+            }
+            this.unsubscribers = [];
+            this.initialized = false;
+            this.client = null;
+            this.eventBus = null;
+            this.agentManager = null;
+            this.hookPipeline = null;
+            this.toolRegistry = null;
+        }
+        catch (err) {
+            span.setStatus({ code: SpanStatusCode.ERROR, message: err instanceof Error ? err.message : String(err) });
+            span.recordException(err instanceof Error ? err : new Error(String(err)));
+            throw err;
+        }
+        finally {
+            span.end();
+        }
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/coordinator/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordinator/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2BAA2B;AAC3B,OAAO,EACL,gBAAgB,GAKjB,MAAM,kBAAkB,CAAC;AAE1B,+BAA+B;AAC/B,OAAO,EACL,qBAAqB,GAItB,MAAM,sBAAsB,CAAC;AAE9B,wBAAwB;AACxB,OAAO,EACL,aAAa,EACb,sBAAsB,GAIvB,MAAM,cAAc,CAAC;AAkCtB,sBAAsB;AAEtB,MAAM,OAAO,WAAW;IACd,MAAM,GAAuB,IAAI,CAAC;IAClC,QAAQ,GAAoB,IAAI,CAAC;IACjC,YAAY,GAA+B,IAAI,CAAC;IAChD,YAAY,GAAwB,IAAI,CAAC;IACzC,YAAY,GAAwB,IAAI,CAAC;IACzC,MAAM,CAAoB;IAElC,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,4FAA4F;IAC9F,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,UAAU;QACd,mDAAmD;QACnD,4DAA4D;QAC5D,uDAAuD;QACvD,qCAAqC;QACrC,iEAAiE;QACjE,mEAAmE;IACrE,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,2EAA2E;QAC3E,gFAAgF;QAChF,8DAA8D;QAC9D,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,OAAO,CAAC,QAAyB,EAAE,OAAe;QACtD,4DAA4D;QAC5D,kDAAkD;QAClD,yDAAyD;IAC3D,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,QAAQ;QACZ,2CAA2C;QAC3C,kCAAkC;IACpC,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordinator/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,8 +3,9 @@
  * This module has ZERO side effects. Safe to import as a library.
  * CLI entry point lives in src/cli-entry.ts.
  */
-export declare const VERSION = "0.8.0";
-export { resolveSquad, resolveGlobalSquadPath, ensureSquadPath } from './resolution.js';
+export declare const VERSION: string;
+export { resolveSquad, resolveGlobalSquadPath, ensureSquadPath, loadDirConfig, isConsultMode } from './resolution.js';
+export type { SquadDirConfig, ResolvedSquadPaths } from './resolution.js';
 export * from './config/index.js';
 export * from './agents/onboarding.js';
 export * from './casting/index.js';
@@ -13,13 +14,25 @@ export { selectResponseTier, getTier } from './coordinator/response-tiers.js';
 export type { ResponseTier, TierName, TierContext, ModelTierSuggestion } from './coordinator/response-tiers.js';
 export { loadConfig, loadConfigSync } from './runtime/config.js';
 export type { ConfigLoadResult, ConfigValidationError } from './runtime/config.js';
+export { MODELS, TIMEOUTS, AGENT_ROLES } from './runtime/constants.js';
+export type { AgentRole } from './runtime/constants.js';
 export * from './runtime/streaming.js';
 export * from './runtime/cost-tracker.js';
 export * from './runtime/telemetry.js';
 export * from './runtime/offline.js';
 export * from './runtime/i18n.js';
 export * from './runtime/benchmarks.js';
+export * from './runtime/otel-init.js';
+export * from './runtime/otel-metrics.js';
+export { getMeter, getTracer } from './runtime/otel.js';
+export { safeTimestamp } from './utils/safe-timestamp.js';
+export { EventBus as RuntimeEventBus } from './runtime/event-bus.js';
 export * from './marketplace/index.js';
 export * from './build/index.js';
 export * from './sharing/index.js';
+export * from './upstream/index.js';
+export * from './remote/index.js';
+export * from './streams/index.js';
+export { defineTeam, defineAgent, defineRouting, defineCeremony, defineHooks, defineCasting, defineTelemetry, defineDefaults, defineSkill, defineSquad, BuilderValidationError, } from './builders/index.js';
+export type { AgentRef, ScheduleExpression, BuilderModelId, ModelPreference, DefaultsDefinition, TeamDefinition, AgentCapability, AgentDefinition, RoutingRule as BuilderRoutingRule, RoutingDefinition, CeremonyDefinition, HooksDefinition, CastingDefinition, TelemetryDefinition, SkillDefinition as BuilderSkillDefinition, SkillTool as BuilderSkillTool, SquadSDKConfig, } from './builders/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACxF,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACnF,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AAExC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACtH,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAErE,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,WAAW,EACX,WAAW,EACX,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,QAAQ,EACR,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,eAAe,EACf,WAAW,IAAI,kBAAkB,EACjC,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,IAAI,sBAAsB,EACzC,SAAS,IAAI,gBAAgB,EAC7B,cAAc,GACf,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -3,22 +3,36 @@
  * This module has ZERO side effects. Safe to import as a library.
  * CLI entry point lives in src/cli-entry.ts.
  */
-export const VERSION = '0.8.0';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+export const VERSION = pkg.version;
 // Export public API
-export { resolveSquad, resolveGlobalSquadPath, ensureSquadPath } from './resolution.js';
+export { resolveSquad, resolveGlobalSquadPath, ensureSquadPath, loadDirConfig, isConsultMode } from './resolution.js';
 export * from './config/index.js';
 export * from './agents/onboarding.js';
 export * from './casting/index.js';
 export * from './skills/index.js';
 export { selectResponseTier, getTier } from './coordinator/response-tiers.js';
 export { loadConfig, loadConfigSync } from './runtime/config.js';
+export { MODELS, TIMEOUTS, AGENT_ROLES } from './runtime/constants.js';
 export * from './runtime/streaming.js';
 export * from './runtime/cost-tracker.js';
 export * from './runtime/telemetry.js';
 export * from './runtime/offline.js';
 export * from './runtime/i18n.js';
 export * from './runtime/benchmarks.js';
+export * from './runtime/otel-init.js';
+export * from './runtime/otel-metrics.js';
+export { getMeter, getTracer } from './runtime/otel.js';
+export { safeTimestamp } from './utils/safe-timestamp.js';
+export { EventBus as RuntimeEventBus } from './runtime/event-bus.js';
 export * from './marketplace/index.js';
 export * from './build/index.js';
 export * from './sharing/index.js';
+export * from './upstream/index.js';
+export * from './remote/index.js';
+export * from './streams/index.js';
+// Builder functions (SDK-First Squad Mode)
+export { defineTeam, defineAgent, defineRouting, defineCeremony, defineHooks, defineCasting, defineTelemetry, defineDefaults, defineSkill, defineSquad, BuilderValidationError, } from './builders/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACxF,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEjE,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AAExC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC;AAE3C,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEtH,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAErE,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AAEnC,2CAA2C;AAC3C,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,WAAW,EACX,WAAW,EACX,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

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":"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"}