@bradygaster/squad-sdk 0.9.0 → 0.9.2-insider.1

package/dist/state/io/index.js

@@ -0,0 +1,19 @@
+/**
+ * State I/O barrel — Markdown parsers and serializers for .squad/ domain files.
+ *
+ * Each module handles round-trip I/O for a single document type:
+ * parse(markdown) → typed object → serialize(object) → markdown.
+ *
+ * @module state/io
+ */
+// Charter I/O
+export { parseCharter, serializeCharter } from './charter-io.js';
+// History I/O
+export { parseHistory, serializeHistory, serializeHistoryAppend } from './history-io.js';
+// Decisions I/O
+export { parseDecisions, serializeDecision, serializeDecisions } from './decisions-io.js';
+// Routing I/O
+export { parseRouting, serializeRouting } from './routing-io.js';
+// Team I/O
+export { parseTeam, serializeTeam } from './team-io.js';
+//# sourceMappingURL=index.js.map

package/dist/state/io/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/state/io/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGjE,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGzF,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG1F,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGjE,WAAW;AACX,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/state/io/routing-io.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Routing Markdown I/O — parse and serialize routing.md files.
+ *
+ * Wraps the existing `parseRoutingRulesMarkdown()` from markdown-migration.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/routing-io
+ */
+import { type ParsedRoutingRule } from '../../config/markdown-migration.js';
+export type { ParsedRoutingRule };
+/** Result of parsing a routing.md file. */
+export interface ParsedRouting {
+    rules: ParsedRoutingRule[];
+    moduleOwnership: Map<string, string>;
+}
+/**
+ * Parse routing markdown into typed routing rules and module ownership.
+ * Delegates rule parsing to `parseRoutingRulesMarkdown()` and also
+ * extracts the optional `## Module Ownership` section.
+ */
+export declare function parseRouting(markdown: string): ParsedRouting;
+/**
+ * Serialize routing rules to a full routing.md file.
+ *
+ * Produces:
+ * ```
+ * # Routing Rules
+ *
+ * ## Routing Table
+ *
+ * | Work Type | Agent | Examples |
+ * |-----------|-------|----------|
+ * | feature-dev | Lead | New features |
+ * ```
+ */
+export declare function serializeRouting(rules: ParsedRoutingRule[]): string;
+//# sourceMappingURL=routing-io.d.ts.map

package/dist/state/io/routing-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-io.d.ts","sourceRoot":"","sources":["../../../src/state/io/routing-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAGvG,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAwDD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAI5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAkBnE"}

package/dist/state/io/routing-io.js

@@ -0,0 +1,99 @@
+/**
+ * Routing Markdown I/O — parse and serialize routing.md files.
+ *
+ * Wraps the existing `parseRoutingRulesMarkdown()` from markdown-migration.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/routing-io
+ */
+import { parseRoutingRulesMarkdown } from '../../config/markdown-migration.js';
+import { normalizeEol } from '../../utils/normalize-eol.js';
+/**
+ * Parse a `## Module Ownership` table into a Map<module, owner>.
+ *
+ * Expected format:
+ * ```markdown
+ * ## Module Ownership
+ *
+ * | Module | Owner |
+ * |--------|-------|
+ * | src/storage/ | EECOM |
+ * ```
+ */
+function parseModuleOwnership(markdown) {
+    const map = new Map();
+    const lines = normalizeEol(markdown).split('\n');
+    let inSection = false;
+    let headerPassed = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (/^##\s+module\s+ownership/i.test(trimmed)) {
+            inSection = true;
+            headerPassed = false;
+            continue;
+        }
+        // Another ## heading ends the section
+        if (inSection && /^##\s+/.test(trimmed) && !/module\s+ownership/i.test(trimmed)) {
+            break;
+        }
+        if (!inSection || !trimmed.startsWith('|'))
+            continue;
+        // Detect header row (contains "module" or "owner")
+        if (!headerPassed && /module|owner/i.test(trimmed)) {
+            headerPassed = true;
+            continue;
+        }
+        // Skip separator row
+        if (/^[|:\-\s]+$/.test(trimmed))
+            continue;
+        if (!headerPassed)
+            continue;
+        const cells = trimmed.split('|').map((c) => c.trim()).filter(Boolean);
+        if (cells.length >= 2 && cells[0] && cells[1]) {
+            map.set(cells[0], cells[1]);
+        }
+    }
+    return map;
+}
+/**
+ * Parse routing markdown into typed routing rules and module ownership.
+ * Delegates rule parsing to `parseRoutingRulesMarkdown()` and also
+ * extracts the optional `## Module Ownership` section.
+ */
+export function parseRouting(markdown) {
+    const { rules } = parseRoutingRulesMarkdown(markdown);
+    const moduleOwnership = parseModuleOwnership(markdown);
+    return { rules, moduleOwnership };
+}
+/**
+ * Serialize routing rules to a full routing.md file.
+ *
+ * Produces:
+ * ```
+ * # Routing Rules
+ *
+ * ## Routing Table
+ *
+ * | Work Type | Agent | Examples |
+ * |-----------|-------|----------|
+ * | feature-dev | Lead | New features |
+ * ```
+ */
+export function serializeRouting(rules) {
+    const lines = [
+        '# Routing Rules',
+        '',
+        '## Routing Table',
+        '',
+        '| Work Type | Agent | Examples |',
+        '|-----------|-------|----------|',
+    ];
+    for (const rule of rules) {
+        const agents = rule.agents.join(', ');
+        const examples = rule.examples ? rule.examples.join(', ') : '';
+        lines.push(`| ${rule.workType} | ${agents} | ${examples} |`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=routing-io.js.map

package/dist/state/io/routing-io.js.map

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

package/dist/state/io/team-io.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Team Markdown I/O — parse and serialize team.md files.
+ *
+ * Wraps the existing `parseTeamMarkdown()` from markdown-migration.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/team-io
+ */
+import { type ParsedAgent } from '../../config/markdown-migration.js';
+export type { ParsedAgent };
+/**
+ * Optional metadata for the team.md file header.
+ */
+export interface TeamMetadata {
+    /** Team name displayed in the title */
+    teamName?: string;
+    /** Tagline shown below the title */
+    tagline?: string;
+}
+/** Result of parsing a team.md file. */
+export interface ParsedTeam {
+    agents: ParsedAgent[];
+    projectContext: string;
+}
+/**
+ * Parse team markdown into typed agent entries and project context.
+ * Delegates agent parsing to `parseTeamMarkdown()` and also extracts
+ * the project context section above the members table.
+ */
+export declare function parseTeam(markdown: string): ParsedTeam;
+/**
+ * Serialize agents to a full team.md file.
+ *
+ * Produces the canonical table format:
+ * ```
+ * # Team Name
+ *
+ * ## Members
+ *
+ * | Name | Role | Charter | Status |
+ * |------|------|---------|--------|
+ * | Agent | Developer | `.squad/agents/agent/charter.md` | ✅ Active |
+ * ```
+ */
+export declare function serializeTeam(agents: ParsedAgent[], metadata?: TeamMetadata): string;
+//# sourceMappingURL=team-io.d.ts.map

package/dist/state/io/team-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-io.d.ts","sourceRoot":"","sources":["../../../src/state/io/team-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAGzF,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAiCD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAItD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM,CAyBpF"}

package/dist/state/io/team-io.js

@@ -0,0 +1,82 @@
+/**
+ * Team Markdown I/O — parse and serialize team.md files.
+ *
+ * Wraps the existing `parseTeamMarkdown()` from markdown-migration.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/team-io
+ */
+import { parseTeamMarkdown } from '../../config/markdown-migration.js';
+import { normalizeEol } from '../../utils/normalize-eol.js';
+/**
+ * Extract project context: everything between the `# Title` line and
+ * the `## Members` heading.  The title line itself is excluded.
+ */
+function extractProjectContext(markdown) {
+    const lines = normalizeEol(markdown).split('\n');
+    const contextLines = [];
+    let pastTitle = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip the title line
+        if (!pastTitle) {
+            if (/^#\s+/.test(trimmed)) {
+                pastTitle = true;
+            }
+            continue;
+        }
+        // Stop at ## Members or any ## heading that signals the table section
+        if (/^##\s+members/i.test(trimmed)) {
+            break;
+        }
+        contextLines.push(line);
+    }
+    return contextLines.join('\n').trim();
+}
+/**
+ * Parse team markdown into typed agent entries and project context.
+ * Delegates agent parsing to `parseTeamMarkdown()` and also extracts
+ * the project context section above the members table.
+ */
+export function parseTeam(markdown) {
+    const { agents } = parseTeamMarkdown(markdown);
+    const projectContext = extractProjectContext(markdown);
+    return { agents, projectContext };
+}
+/**
+ * Serialize agents to a full team.md file.
+ *
+ * Produces the canonical table format:
+ * ```
+ * # Team Name
+ *
+ * ## Members
+ *
+ * | Name | Role | Charter | Status |
+ * |------|------|---------|--------|
+ * | Agent | Developer | `.squad/agents/agent/charter.md` | ✅ Active |
+ * ```
+ */
+export function serializeTeam(agents, metadata) {
+    const teamName = metadata?.teamName ?? 'Team';
+    const lines = [`# ${teamName}`];
+    if (metadata?.tagline) {
+        lines.push('');
+        lines.push(`> ${metadata.tagline}`);
+    }
+    lines.push('');
+    lines.push('## Members');
+    lines.push('');
+    lines.push('| Name | Role | Charter | Status |');
+    lines.push('|------|------|---------|--------|');
+    for (const agent of agents) {
+        const name = agent.name;
+        const role = agent.role;
+        const charter = `.squad/agents/${agent.name}/charter.md`;
+        const status = agent.status ?? '✅ Active';
+        lines.push(`| ${name} | ${role} | \`${charter}\` | ${status} |`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=team-io.js.map

package/dist/state/io/team-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-io.js","sourceRoot":"","sources":["../../../src/state/io/team-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAoB,MAAM,oCAAoC,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAoB5D;;;GAGG;AACH,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,sBAAsB;QACtB,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;YACD,SAAS;QACX,CAAC;QAED,sEAAsE;QACtE,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,MAAM;QACR,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACvD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB,EAAE,QAAuB;IAC1E,MAAM,QAAQ,GAAG,QAAQ,EAAE,QAAQ,IAAI,MAAM,CAAC;IAC9C,MAAM,KAAK,GAAa,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAE1C,IAAI,QAAQ,EAAE,OAAO,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAEjD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,MAAM,OAAO,GAAG,iBAAiB,KAAK,CAAC,IAAI,aAAa,CAAC;QACzD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,IAAI,QAAQ,OAAO,QAAQ,MAAM,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/state/schema.d.ts

@@ -0,0 +1,24 @@
+/**
+ * State Module — Storage Layout Schema
+ *
+ * Maps collection names to their `.squad/` file paths.
+ * Single-entity collections use a static string; multi-entity
+ * collections use a function that derives the path from an entity id.
+ */
+import type { CollectionName } from './collection-map.js';
+/** Either a static path or a function deriving a path from an entity id. */
+export type CollectionPathResolver = string | ((id: string) => string);
+/**
+ * Canonical mapping from collection names to `.squad/` relative paths.
+ *
+ * Static paths point to a single file (e.g. `decisions.md`).
+ * Function paths resolve per-entity directories (e.g. `agents/<name>`).
+ */
+export declare const COLLECTION_PATHS: Record<CollectionName, CollectionPathResolver>;
+/**
+ * Resolve the storage path for a collection, optionally with an entity id.
+ *
+ * @throws {Error} if the collection requires an id but none was provided.
+ */
+export declare function resolveCollectionPath(collection: CollectionName, id?: string): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/state/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/state/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,4EAA4E;AAC5E,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAIvE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,sBAAsB,CAS3E,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CASrF"}

package/dist/state/schema.js

@@ -0,0 +1,41 @@
+/**
+ * State Module — Storage Layout Schema
+ *
+ * Maps collection names to their `.squad/` file paths.
+ * Single-entity collections use a static string; multi-entity
+ * collections use a function that derives the path from an entity id.
+ */
+// ── Collection → Path Mapping ──────────────────────────────────────────────
+/**
+ * Canonical mapping from collection names to `.squad/` relative paths.
+ *
+ * Static paths point to a single file (e.g. `decisions.md`).
+ * Function paths resolve per-entity directories (e.g. `agents/<name>`).
+ */
+export const COLLECTION_PATHS = {
+    agents: (id) => `.squad/agents/${id}`,
+    decisions: '.squad/decisions.md',
+    routing: '.squad/routing.md',
+    team: '.squad/team.md',
+    skills: (id) => `.squad/skills/${id}`,
+    templates: (id) => `.squad/templates/${id}`,
+    log: '.squad/log',
+    config: '.squad/config.json',
+};
+// ── Helpers ────────────────────────────────────────────────────────────────
+/**
+ * Resolve the storage path for a collection, optionally with an entity id.
+ *
+ * @throws {Error} if the collection requires an id but none was provided.
+ */
+export function resolveCollectionPath(collection, id) {
+    const resolver = COLLECTION_PATHS[collection];
+    if (typeof resolver === 'function') {
+        if (!id) {
+            throw new Error(`Collection "${collection}" requires an entity id to resolve its path`);
+        }
+        return resolver(id);
+    }
+    return resolver;
+}
+//# sourceMappingURL=schema.js.map

package/dist/state/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/state/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmD;IAC9E,MAAM,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,iBAAiB,EAAE,EAAE;IAC7C,SAAS,EAAE,qBAAqB;IAChC,OAAO,EAAE,mBAAmB;IAC5B,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,iBAAiB,EAAE,EAAE;IAC7C,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,oBAAoB,EAAE,EAAE;IACnD,GAAG,EAAE,YAAY;IACjB,MAAM,EAAE,oBAAoB;CAC7B,CAAC;AAEF,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAA0B,EAAE,EAAW;IAC3E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,eAAe,UAAU,6CAA6C,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/state/squad-state.d.ts

@@ -0,0 +1,42 @@
+/**
+ * State Module — SquadState Facade
+ *
+ * Top-level typed API for reading and writing `.squad/` state.
+ * Composes the collection facades (agents, decisions, routing, team)
+ * over a pluggable StorageProvider.
+ *
+ * @module state/squad-state
+ */
+import type { StorageProvider } from '../storage/storage-provider.js';
+import { AgentsCollection, ConfigCollection, DecisionsCollection, LogCollection, RoutingCollection, SkillsCollection, TeamCollection, TemplatesCollection } from './collections.js';
+export declare class SquadState {
+    private readonly storage;
+    private readonly _rootDir;
+    readonly agents: AgentsCollection;
+    readonly config: ConfigCollection;
+    readonly decisions: DecisionsCollection;
+    readonly routing: RoutingCollection;
+    readonly team: TeamCollection;
+    readonly skills: SkillsCollection;
+    readonly templates: TemplatesCollection;
+    readonly log: LogCollection;
+    private constructor();
+    /** The project root directory this SquadState is bound to. */
+    get root(): string;
+    /** The underlying StorageProvider used by this instance. */
+    get provider(): StorageProvider;
+    /**
+     * Factory method — validates that `rootDir/.squad/` exists before
+     * returning a new SquadState instance.
+     */
+    static create(storage: StorageProvider, rootDir: string): Promise<SquadState>;
+    /**
+     * Synchronous factory — creates SquadState without validating `.squad/`
+     * existence.  For internal SDK use where the caller already knows the
+     * root is initialized (e.g., modules operating on an existing project).
+     */
+    static fromStorage(storage: StorageProvider, rootDir: string): SquadState;
+    /** Check if a `.squad/` directory exists at the root. */
+    isInitialized(): Promise<boolean>;
+}
+//# sourceMappingURL=squad-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"squad-state.d.ts","sourceRoot":"","sources":["../../src/state/squad-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAG1B,qBAAa,UAAU;IAWnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAX3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAE5B,OAAO;IAcP,8DAA8D;IAC9D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,4DAA4D;IAC5D,IAAI,QAAQ,IAAI,eAAe,CAE9B;IAED;;;OAGG;WACU,MAAM,CACjB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC;IAStB;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GACd,UAAU;IAIb,yDAAyD;IACnD,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;CAGxC"}

package/dist/state/squad-state.js

@@ -0,0 +1,68 @@
+/**
+ * State Module — SquadState Facade
+ *
+ * Top-level typed API for reading and writing `.squad/` state.
+ * Composes the collection facades (agents, decisions, routing, team)
+ * over a pluggable StorageProvider.
+ *
+ * @module state/squad-state
+ */
+import { AgentsCollection, ConfigCollection, DecisionsCollection, LogCollection, RoutingCollection, SkillsCollection, TeamCollection, TemplatesCollection, } from './collections.js';
+import { NotFoundError } from './domain-types.js';
+export class SquadState {
+    storage;
+    _rootDir;
+    agents;
+    config;
+    decisions;
+    routing;
+    team;
+    skills;
+    templates;
+    log;
+    constructor(storage, _rootDir) {
+        this.storage = storage;
+        this._rootDir = _rootDir;
+        this.agents = new AgentsCollection(storage, _rootDir);
+        this.config = new ConfigCollection(storage, _rootDir);
+        this.decisions = new DecisionsCollection(storage, _rootDir);
+        this.routing = new RoutingCollection(storage, _rootDir);
+        this.team = new TeamCollection(storage, _rootDir);
+        this.skills = new SkillsCollection(storage, _rootDir);
+        this.templates = new TemplatesCollection(storage, _rootDir);
+        this.log = new LogCollection(storage, _rootDir);
+    }
+    /** The project root directory this SquadState is bound to. */
+    get root() {
+        return this._rootDir;
+    }
+    /** The underlying StorageProvider used by this instance. */
+    get provider() {
+        return this.storage;
+    }
+    /**
+     * Factory method — validates that `rootDir/.squad/` exists before
+     * returning a new SquadState instance.
+     */
+    static async create(storage, rootDir) {
+        const squadDir = `${rootDir}/.squad`;
+        const exists = await storage.exists(squadDir);
+        if (!exists) {
+            throw new NotFoundError('squad', rootDir);
+        }
+        return new SquadState(storage, rootDir);
+    }
+    /**
+     * Synchronous factory — creates SquadState without validating `.squad/`
+     * existence.  For internal SDK use where the caller already knows the
+     * root is initialized (e.g., modules operating on an existing project).
+     */
+    static fromStorage(storage, rootDir) {
+        return new SquadState(storage, rootDir);
+    }
+    /** Check if a `.squad/` directory exists at the root. */
+    async isInitialized() {
+        return this.storage.exists(`${this._rootDir}/.squad`);
+    }
+}
+//# sourceMappingURL=squad-state.js.map

package/dist/state/squad-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"squad-state.js","sourceRoot":"","sources":["../../src/state/squad-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,OAAO,UAAU;IAWF;IACA;IAXV,MAAM,CAAmB;IACzB,MAAM,CAAmB;IACzB,SAAS,CAAsB;IAC/B,OAAO,CAAoB;IAC3B,IAAI,CAAiB;IACrB,MAAM,CAAmB;IACzB,SAAS,CAAsB;IAC/B,GAAG,CAAgB;IAE5B,YACmB,OAAwB,EACxB,QAAgB;QADhB,YAAO,GAAP,OAAO,CAAiB;QACxB,aAAQ,GAAR,QAAQ,CAAQ;QAEjC,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,8DAA8D;IAC9D,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,4DAA4D;IAC5D,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,OAAwB,EACxB,OAAe;QAEf,MAAM,QAAQ,GAAG,GAAG,OAAO,SAAS,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAChB,OAAwB,EACxB,OAAe;QAEf,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,SAAS,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/storage/fs-storage-provider.d.ts

@@ -0,0 +1,60 @@
+import type { StorageProvider, StorageStats } from './storage-provider.js';
+/**
+ * FSStorageProvider — Node.js `fs` implementation of StorageProvider.
+ *
+ * - ENOENT reads return `undefined` (no throw).
+ * - Writes create parent directories recursively.
+ * - Appends create the file (and parent dirs) if missing.
+ * - delete is a no-op when the file does not exist.
+ * - list returns an empty array for a missing directory.
+ * - Optional `rootDir` confines all operations to a specific directory tree.
+ */
+export declare class FSStorageProvider implements StorageProvider {
+    private static readonly CASE_INSENSITIVE;
+    private readonly rootDir?;
+    constructor(rootDir?: string);
+    private pathStartsWith;
+    private pathEquals;
+    /**
+     * Validates that filePath resolves within rootDir and does not escape
+     * via path traversal or symlinks.
+     *
+     * ⚠️ TOCTOU: This is a user-space check. Between validation and the
+     * subsequent fs operation, a path component could theoretically be
+     * swapped for a symlink. This is an inherent limitation of user-space
+     * path validation on POSIX systems. For defense-in-depth, callers
+     * operating in hostile environments should use OS-level confinement
+     * (chroot, namespaces, or sandboxing) in addition to this check.
+     */
+    private assertSafePath;
+    private assertSafePathSync;
+    read(filePath: string): Promise<string | undefined>;
+    write(filePath: string, data: string): Promise<void>;
+    append(filePath: string, data: string): Promise<void>;
+    exists(filePath: string): Promise<boolean>;
+    list(dirPath: string): Promise<string[]>;
+    delete(filePath: string): Promise<void>;
+    readSync(filePath: string): string | undefined;
+    writeSync(filePath: string, data: string): void;
+    existsSync(filePath: string): boolean;
+    listSync(dirPath: string): string[];
+    deleteDir(dirPath: string): Promise<void>;
+    isDirectory(targetPath: string): Promise<boolean>;
+    mkdir(dirPath: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    copy(srcPath: string, destPath: string): Promise<void>;
+    stat(targetPath: string): Promise<StorageStats | undefined>;
+    isDirectorySync(targetPath: string): boolean;
+    mkdirSync(dirPath: string, options?: {
+        recursive?: boolean;
+    }): void;
+    statSync(targetPath: string): StorageStats | undefined;
+    appendSync(filePath: string, data: string): void;
+    deleteSync(filePath: string): void;
+    renameSync(oldPath: string, newPath: string): void;
+    copySync(srcPath: string, destPath: string): void;
+    deleteDirSync(dirPath: string): void;
+}
+//# sourceMappingURL=fs-storage-provider.d.ts.map

package/dist/storage/fs-storage-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-storage-provider.d.ts","sourceRoot":"","sources":["../../src/storage/fs-storage-provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG3E;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAiE;IACzG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;gBAEtB,OAAO,CAAC,EAAE,MAAM;IAI5B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,UAAU;IAOlB;;;;;;;;;;OAUG;YACW,cAAc;IAwC5B,OAAO,CAAC,kBAAkB;IAwCpB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAUnD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU1C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUxC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAU9C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAU/C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAU7B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAWjE,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAS5C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAUnE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAWtD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAUhD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUlC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAWlD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWjD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CASrC"}