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

package/dist/state/domain-types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * State Module — Canonical Domain Types
+ *
+ * Phase 2 of StorageProvider PRD (#481).
+ * Types that already exist elsewhere are re-exported here as the
+ * canonical import point for the state layer.  New domain types are
+ * defined inline.
+ */
+export type { AgentStatus } from '../agents/lifecycle.js';
+export type { HistorySection } from '../agents/history-shadow.js';
+export type { ModelTier, WorkType, RoutingRule } from '../runtime/config.js';
+export type { SkillDefinition } from '../skills/skill-loader.js';
+export type { StorageProvider } from '../storage/storage-provider.js';
+import type { HistorySection } from '../agents/history-shadow.js';
+import type { ModelTier } from '../runtime/config.js';
+import type { StorageProvider } from '../storage/storage-provider.js';
+/** Full agent entity persisted under `.squad/agents/<name>/`. */
+export interface Agent {
+    readonly name: string;
+    readonly role: string;
+    readonly emoji?: string;
+    readonly status: string;
+    readonly charterPath: string;
+    readonly modelPreference?: ModelTier;
+    readonly modelFallback?: string;
+    readonly skills: readonly string[];
+    readonly aliases: readonly string[];
+    readonly autoAssign: boolean;
+}
+/** Structured decision entry parsed from `decisions.md`. */
+export interface Decision {
+    readonly date: string;
+    readonly title: string;
+    readonly author: string;
+    readonly body: string;
+    readonly configRelevant: boolean;
+}
+/** Timestamped history entry within an agent's `history.md`. */
+export interface HistoryEntry {
+    readonly section: HistorySection;
+    readonly content: string;
+    readonly timestamp: string;
+}
+/** Parsed `team.md` structure. */
+export interface TeamConfig {
+    readonly projectContext: string;
+    readonly members: readonly TeamMember[];
+}
+/** A single row from the team.md members table. */
+export interface TeamMember {
+    readonly name: string;
+    readonly role: string;
+    readonly emoji?: string;
+    readonly status?: string;
+}
+/** Parsed `routing.md` structure. */
+export interface RoutingConfig {
+    readonly rules: readonly RoutingConfigRule[];
+    readonly moduleOwnership: ReadonlyMap<string, string>;
+    readonly principles: readonly string[];
+}
+/** A single routing rule within RoutingConfig. */
+export interface RoutingConfigRule {
+    readonly workType: string;
+    readonly agents: readonly string[];
+    readonly examples: readonly string[];
+}
+/** Template file content from `.squad/templates/`. */
+export type Template = {
+    readonly id: string;
+    readonly name: string;
+    readonly content: string;
+};
+/** Log entry for orchestration / session logging. */
+export interface LogEntry {
+    readonly timestamp: string;
+    readonly level: 'info' | 'warn' | 'error' | 'debug';
+    readonly message: string;
+    readonly agent?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Options for SquadState initialization. */
+export interface SquadStateConfig {
+    readonly provider: StorageProvider;
+    readonly rootDir: string;
+    readonly cacheEnabled?: boolean;
+    readonly cacheTtlMs?: number;
+}
+/**
+ * Discriminant for state-layer storage errors.
+ * Distinct from the low-level `StorageError` in `storage/storage-error.ts`
+ * which wraps Node.js `ErrnoException`.
+ */
+export type StateErrorKind = 'not-found' | 'parse-error' | 'write-conflict' | 'provider-error';
+/**
+ * Base error class for the state layer.
+ *
+ * Named `StateError` (not `StorageError`) to avoid collision with the
+ * low-level FS error wrapper in `storage/storage-error.ts`.  Uses a
+ * `kind` discriminant so callers can switch on error type.
+ */
+export declare class StateError extends Error {
+    readonly kind: StateErrorKind;
+    constructor(kind: StateErrorKind, message: string, options?: ErrorOptions);
+}
+/** Thrown when a requested entity or path does not exist. */
+export declare class NotFoundError extends StateError {
+    constructor(collection: string, id?: string, options?: ErrorOptions);
+}
+/** Thrown when file content cannot be parsed into the expected type. */
+export declare class ParseError extends StateError {
+    constructor(collection: string, detail: string, options?: ErrorOptions);
+}
+/** Thrown on concurrent write conflicts (future optimistic locking). */
+export declare class WriteConflictError extends StateError {
+    constructor(collection: string, id?: string, options?: ErrorOptions);
+}
+/** Thrown when the underlying StorageProvider operation fails. */
+export declare class ProviderError extends StateError {
+    constructor(operation: string, detail: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=domain-types.d.ts.map

package/dist/state/domain-types.d.ts.map

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

package/dist/state/domain-types.js

@@ -0,0 +1,54 @@
+/**
+ * State Module — Canonical Domain Types
+ *
+ * Phase 2 of StorageProvider PRD (#481).
+ * Types that already exist elsewhere are re-exported here as the
+ * canonical import point for the state layer.  New domain types are
+ * defined inline.
+ */
+/**
+ * Base error class for the state layer.
+ *
+ * Named `StateError` (not `StorageError`) to avoid collision with the
+ * low-level FS error wrapper in `storage/storage-error.ts`.  Uses a
+ * `kind` discriminant so callers can switch on error type.
+ */
+export class StateError extends Error {
+    kind;
+    constructor(kind, message, options) {
+        super(message, options);
+        this.name = 'StateError';
+        this.kind = kind;
+    }
+}
+/** Thrown when a requested entity or path does not exist. */
+export class NotFoundError extends StateError {
+    constructor(collection, id, options) {
+        const target = id ? `${collection}/${id}` : collection;
+        super('not-found', `Not found: ${target}`, options);
+        this.name = 'NotFoundError';
+    }
+}
+/** Thrown when file content cannot be parsed into the expected type. */
+export class ParseError extends StateError {
+    constructor(collection, detail, options) {
+        super('parse-error', `Parse error in ${collection}: ${detail}`, options);
+        this.name = 'ParseError';
+    }
+}
+/** Thrown on concurrent write conflicts (future optimistic locking). */
+export class WriteConflictError extends StateError {
+    constructor(collection, id, options) {
+        const target = id ? `${collection}/${id}` : collection;
+        super('write-conflict', `Write conflict: ${target}`, options);
+        this.name = 'WriteConflictError';
+    }
+}
+/** Thrown when the underlying StorageProvider operation fails. */
+export class ProviderError extends StateError {
+    constructor(operation, detail, options) {
+        super('provider-error', `Provider ${operation} failed: ${detail}`, options);
+        this.name = 'ProviderError';
+    }
+}
+//# sourceMappingURL=domain-types.js.map

package/dist/state/domain-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-types.js","sourceRoot":"","sources":["../../src/state/domain-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsGH;;;;;;GAMG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IAE9B,YAAY,IAAoB,EAAE,OAAe,EAAE,OAAsB;QACvE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,UAAkB,EAAE,EAAW,EAAE,OAAsB;QACjE,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QACvD,KAAK,CAAC,WAAW,EAAE,cAAc,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,OAAO,UAAW,SAAQ,UAAU;IACxC,YAAY,UAAkB,EAAE,MAAc,EAAE,OAAsB;QACpE,KAAK,CAAC,aAAa,EAAE,kBAAkB,UAAU,KAAK,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,UAAkB,EAAE,EAAW,EAAE,OAAsB;QACjE,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QACvD,KAAK,CAAC,gBAAgB,EAAE,mBAAmB,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,SAAiB,EAAE,MAAc,EAAE,OAAsB;QACnE,KAAK,CAAC,gBAAgB,EAAE,YAAY,SAAS,YAAY,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/state/handles.d.ts

@@ -0,0 +1,16 @@
+/**
+ * State Module — Agent Handle Implementation
+ *
+ * Concrete implementation of the `AgentHandle` interface from collection-map.ts.
+ * Wires up to StorageProvider + IO layer for reading/writing agent state.
+ *
+ * @module state/handles
+ */
+import type { StorageProvider } from '../storage/storage-provider.js';
+import type { AgentHandle } from './collection-map.js';
+/**
+ * Create a concrete AgentHandle bound to a specific agent, storage provider,
+ * and root directory.
+ */
+export declare function createAgentHandle(name: string, storage: StorageProvider, rootDir: string): AgentHandle;
+//# sourceMappingURL=handles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handles.d.ts","sourceRoot":"","sources":["../../src/state/handles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAsEvD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GACd,WAAW,CA0Gb"}

package/dist/state/handles.js

@@ -0,0 +1,161 @@
+/**
+ * State Module — Agent Handle Implementation
+ *
+ * Concrete implementation of the `AgentHandle` interface from collection-map.ts.
+ * Wires up to StorageProvider + IO layer for reading/writing agent state.
+ *
+ * @module state/handles
+ */
+import { parseHistory, serializeHistoryAppend } from './io/history-io.js';
+import { parseTeam, serializeTeam } from './io/team-io.js';
+import { NotFoundError, ParseError } from './domain-types.js';
+import { resolveCollectionPath } from './schema.js';
+// ── History Section Mapping ────────────────────────────────────────────────
+const SECTION_KEYS = [
+    { section: 'Context', key: 'context' },
+    { section: 'Learnings', key: 'learnings' },
+    { section: 'Decisions', key: 'decisions' },
+    { section: 'Patterns', key: 'patterns' },
+    { section: 'Issues', key: 'issues' },
+    { section: 'References', key: 'references' },
+];
+/**
+ * Convert a ParsedHistory into an array of HistoryEntry objects.
+ *
+ * Splits each section's content by `### date/title` sub-headers into
+ * individual entries with extracted timestamps.
+ */
+function parsedHistoryToEntries(parsed, filterSection) {
+    const entries = [];
+    const sections = filterSection
+        ? SECTION_KEYS.filter((s) => s.section === filterSection)
+        : SECTION_KEYS;
+    for (const { section, key } of sections) {
+        const content = parsed[key];
+        if (!content)
+            continue;
+        const subHeaderRegex = /^###\s+(.+)$/gm;
+        const subHeaders = [];
+        let m;
+        while ((m = subHeaderRegex.exec(content)) !== null) {
+            subHeaders.push({
+                title: m[1],
+                start: m.index,
+                contentStart: m.index + m[0].length,
+            });
+        }
+        if (subHeaders.length === 0) {
+            entries.push({ section, content: content.trim(), timestamp: '' });
+        }
+        else {
+            for (let i = 0; i < subHeaders.length; i++) {
+                const hdr = subHeaders[i];
+                const nextHdr = subHeaders[i + 1];
+                const start = hdr.contentStart;
+                const end = nextHdr ? nextHdr.start : content.length;
+                const entryContent = content.substring(start, end).trim();
+                const dateMatch = hdr.title.match(/(\d{4}-\d{2}-\d{2})/);
+                const timestamp = dateMatch?.[1] ?? '';
+                entries.push({ section, content: entryContent, timestamp });
+            }
+        }
+    }
+    return entries;
+}
+// ── Factory ────────────────────────────────────────────────────────────────
+/**
+ * Create a concrete AgentHandle bound to a specific agent, storage provider,
+ * and root directory.
+ */
+export function createAgentHandle(name, storage, rootDir) {
+    const agentDir = `${rootDir}/.squad/agents/${name}`;
+    const charterPath = `${agentDir}/charter.md`;
+    const historyPath = `${agentDir}/history.md`;
+    const teamPath = `${rootDir}/${resolveCollectionPath('team')}`;
+    const handle = {
+        name,
+        async charter() {
+            const content = await storage.read(charterPath);
+            if (content === undefined) {
+                throw new NotFoundError('agents', name);
+            }
+            return content;
+        },
+        history(section) {
+            return (async () => {
+                const content = await storage.read(historyPath);
+                if (content === undefined) {
+                    return [];
+                }
+                let parsed;
+                try {
+                    parsed = parseHistory(content);
+                }
+                catch (err) {
+                    throw new ParseError('history', err instanceof Error ? err.message : String(err), { cause: err });
+                }
+                return parsedHistoryToEntries(parsed, section);
+            })();
+        },
+        async appendHistory(section, entry) {
+            const content = await storage.read(historyPath);
+            const fragment = serializeHistoryAppend(section, entry.content, entry.timestamp || undefined);
+            if (content === undefined) {
+                const newContent = `# ${name}\n\n## ${section}\n\n${fragment}`;
+                await storage.write(historyPath, newContent);
+                return;
+            }
+            const sectionRegex = new RegExp(`^## ${section}\\s*$`, 'm');
+            const sectionMatch = sectionRegex.exec(content);
+            if (sectionMatch) {
+                // Find next ## header after this section to determine insertion point
+                const afterHeader = sectionMatch.index + sectionMatch[0].length;
+                const rest = content.substring(afterHeader);
+                const nextSectionMatch = /^## /m.exec(rest.length > 1 ? rest.substring(1) : '');
+                const insertPos = nextSectionMatch
+                    ? afterHeader + 1 + nextSectionMatch.index
+                    : content.length;
+                const before = content.substring(0, insertPos).trimEnd();
+                const after = content.substring(insertPos);
+                const newContent = before + '\n\n' + fragment + (after.trim() ? '\n' + after.trimStart() : '');
+                await storage.write(historyPath, newContent.trimEnd() + '\n');
+            }
+            else {
+                // Section doesn't exist yet — append at end
+                const newContent = content.trimEnd() + `\n\n## ${section}\n\n${fragment}`;
+                await storage.write(historyPath, newContent.trimEnd() + '\n');
+            }
+        },
+        async update(updates) {
+            const teamContent = await storage.read(teamPath);
+            if (teamContent === undefined) {
+                throw new NotFoundError('team');
+            }
+            let agents;
+            try {
+                agents = parseTeam(teamContent).agents;
+            }
+            catch (err) {
+                throw new ParseError('team', err instanceof Error ? err.message : String(err), { cause: err });
+            }
+            const lowerName = name.toLowerCase();
+            const idx = agents.findIndex((a) => a.name.toLowerCase() === lowerName);
+            if (idx === -1) {
+                throw new NotFoundError('agents', name);
+            }
+            const current = agents[idx];
+            const updated = {
+                name: updates.name ?? current.name,
+                role: updates.role ?? current.role,
+                skills: updates.skills ? [...updates.skills] : current.skills,
+                model: updates.modelPreference ?? current.model,
+                status: updates.status !== undefined ? String(updates.status) : current.status,
+            };
+            agents[idx] = updated;
+            const serialized = serializeTeam(agents);
+            await storage.write(teamPath, serialized);
+        },
+    };
+    return handle;
+}
+//# sourceMappingURL=handles.js.map

package/dist/state/handles.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * State Module — Barrel Export
+ *
+ * Phase 2 of StorageProvider PRD (#481).
+ * Typed facade layer over `.squad/` file-based state.
+ */
+export type { Agent, Decision, HistoryEntry, HistorySection, LogEntry, ModelTier, RoutingConfig, RoutingConfigRule, RoutingRule, SkillDefinition, SquadStateConfig, StateErrorKind, StorageProvider, TeamConfig, TeamMember, Template, WorkType, } from './domain-types.js';
+export type { AgentStatus } from './domain-types.js';
+export { StateError, NotFoundError, ParseError, WriteConflictError, ProviderError, } from './domain-types.js';
+export type { CollectionEntityMap, CollectionName, AgentHandle, } from './collection-map.js';
+export type { CollectionPathResolver } from './schema.js';
+export { COLLECTION_PATHS, resolveCollectionPath } from './schema.js';
+export { createAgentHandle } from './handles.js';
+export { AgentsCollection, ConfigCollection, DecisionsCollection, LogCollection, RoutingCollection, SkillsCollection, TeamCollection, TemplatesCollection, } from './collections.js';
+export type { ConfigFileData } from './collections.js';
+export { SquadState } from './squad-state.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,15 @@
+/**
+ * State Module — Barrel Export
+ *
+ * Phase 2 of StorageProvider PRD (#481).
+ * Typed facade layer over `.squad/` file-based state.
+ */
+export { StateError, NotFoundError, ParseError, WriteConflictError, ProviderError, } from './domain-types.js';
+export { COLLECTION_PATHS, resolveCollectionPath } from './schema.js';
+// Agent handle factory
+export { createAgentHandle } from './handles.js';
+// Collection facades
+export { AgentsCollection, ConfigCollection, DecisionsCollection, LogCollection, RoutingCollection, SkillsCollection, TeamCollection, TemplatesCollection, } from './collections.js';
+// SquadState facade
+export { SquadState } from './squad-state.js';
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEtE,uBAAuB;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAI1B,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * Charter Markdown I/O — parse and serialize charter.md files.
+ *
+ * Wraps the existing `parseCharterMarkdown()` from charter-compiler.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/charter-io
+ */
+import { type ParsedCharter } from '../../agents/charter-compiler.js';
+export type { ParsedCharter };
+/**
+ * Parse charter markdown into a typed structure.
+ * Delegates to the existing `parseCharterMarkdown()`.
+ */
+export declare function parseCharter(markdown: string): ParsedCharter;
+/**
+ * Serialize a ParsedCharter back to markdown.
+ *
+ * Produces the canonical charter.md format:
+ * ```
+ * # {Name} — {Role}
+ * > {style quote}
+ * ## Identity
+ * ...
+ * ```
+ */
+export declare function serializeCharter(charter: ParsedCharter): string;
+//# sourceMappingURL=charter-io.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"charter-io.d.ts","sourceRoot":"","sources":["../../../src/state/io/charter-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAE5F,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAE5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAyE/D"}

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

@@ -0,0 +1,94 @@
+/**
+ * Charter Markdown I/O — parse and serialize charter.md files.
+ *
+ * Wraps the existing `parseCharterMarkdown()` from charter-compiler.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/charter-io
+ */
+import { parseCharterMarkdown } from '../../agents/charter-compiler.js';
+/**
+ * Parse charter markdown into a typed structure.
+ * Delegates to the existing `parseCharterMarkdown()`.
+ */
+export function parseCharter(markdown) {
+    return parseCharterMarkdown(markdown);
+}
+/**
+ * Serialize a ParsedCharter back to markdown.
+ *
+ * Produces the canonical charter.md format:
+ * ```
+ * # {Name} — {Role}
+ * > {style quote}
+ * ## Identity
+ * ...
+ * ```
+ */
+export function serializeCharter(charter) {
+    const lines = [];
+    // Title line
+    const name = charter.identity.name ?? 'Agent';
+    const role = charter.identity.role ?? 'Developer';
+    lines.push(`# ${name} — ${role}`);
+    lines.push('');
+    // Style quote
+    if (charter.identity.style) {
+        lines.push(`> ${charter.identity.style}`);
+        lines.push('');
+    }
+    // Identity section
+    lines.push('## Identity');
+    lines.push('');
+    if (charter.identity.name) {
+        lines.push(`- **Name:** ${charter.identity.name}`);
+    }
+    if (charter.identity.role) {
+        lines.push(`- **Role:** ${charter.identity.role}`);
+    }
+    if (charter.identity.expertise && charter.identity.expertise.length > 0) {
+        lines.push(`- **Expertise:** ${charter.identity.expertise.join(', ')}`);
+    }
+    if (charter.identity.style) {
+        lines.push(`- **Style:** ${charter.identity.style}`);
+    }
+    lines.push('');
+    // What I Own section
+    if (charter.ownership !== undefined) {
+        lines.push('## What I Own');
+        lines.push('');
+        lines.push(charter.ownership);
+        lines.push('');
+    }
+    // Boundaries section
+    if (charter.boundaries !== undefined) {
+        lines.push('## Boundaries');
+        lines.push('');
+        lines.push(charter.boundaries);
+        lines.push('');
+    }
+    // Model section
+    if (charter.modelPreference || charter.modelRationale || charter.modelFallback) {
+        lines.push('## Model');
+        lines.push('');
+        if (charter.modelPreference) {
+            lines.push(`**Preferred:** ${charter.modelPreference}`);
+        }
+        if (charter.modelRationale) {
+            lines.push(`**Rationale:** ${charter.modelRationale}`);
+        }
+        if (charter.modelFallback) {
+            lines.push(`**Fallback:** ${charter.modelFallback}`);
+        }
+        lines.push('');
+    }
+    // Collaboration section
+    if (charter.collaboration !== undefined) {
+        lines.push('## Collaboration');
+        lines.push('');
+        lines.push(charter.collaboration);
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+//# sourceMappingURL=charter-io.js.map

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * Decisions Markdown I/O — parse and serialize decisions.md files.
+ *
+ * Wraps the existing `parseDecisionsMarkdown()` from markdown-migration.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/decisions-io
+ */
+import { type ParsedDecision } from '../../config/markdown-migration.js';
+export type { ParsedDecision };
+/**
+ * Parse decisions markdown into typed decision entries.
+ * Delegates to the existing `parseDecisionsMarkdown()`.
+ */
+export declare function parseDecisions(markdown: string): ParsedDecision[];
+/**
+ * Serialize a single decision entry to markdown.
+ *
+ * Format:
+ * ```
+ * ### YYYY-MM-DD: Title
+ * **By:** author
+ * body content
+ * ```
+ */
+export declare function serializeDecision(decision: ParsedDecision): string;
+/**
+ * Serialize an array of decisions to a full decisions.md file.
+ *
+ * Produces:
+ * ```
+ * # Decisions
+ *
+ * ### 2026-01-15: First Decision
+ * ...
+ *
+ * ### 2026-02-01: Second Decision
+ * ...
+ * ```
+ */
+export declare function serializeDecisions(decisions: ParsedDecision[]): string;
+//# sourceMappingURL=decisions-io.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decisions-io.d.ts","sourceRoot":"","sources":["../../../src/state/io/decisions-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEjG,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAGjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAmBlE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CAMtE"}