anantham-v2 2.0.0-alpha.1

package/dist/side-effects/side-effect-classifier.js

@@ -0,0 +1,71 @@
+import { SideEffectCategorySchema, } from "../domain/side-effect.js";
+/**
+ * Anantham V2 — Side Effect Classifier
+ * PRD Part 1 Section 83-90 & PRD Part 2 Section 241-248
+ */
+export class SideEffectClassifier {
+    static KNOWN_READ_ONLY_TOOLS = new Set([
+        "read_file",
+        "search_text",
+        "find_files",
+        "list_dir",
+        "file_stat",
+        "git_status",
+        "git_diff",
+        "git_log",
+        "worktree_list",
+        "read_artifact",
+        "retrieve_memory",
+    ]);
+    static KNOWN_IDEMPOTENT_WRITE_TOOLS = new Set([
+        "write_file",
+        "save_artifact",
+        "store_memory",
+    ]);
+    static KNOWN_REVERSIBLE_WRITE_TOOLS = new Set([
+        "worktree_add",
+    ]);
+    static KNOWN_NON_IDEMPOTENT_TOOLS = new Set([
+        "git_commit",
+        "run_command",
+        "delete_file",
+        "worktree_remove",
+    ]);
+    classify(toolName, args = {}, toolSpec) {
+        // 1. Check toolSpec explicit flag if available
+        if (toolSpec?.isIdempotent && !SideEffectClassifier.KNOWN_READ_ONLY_TOOLS.has(toolName)) {
+            return "idempotent_write";
+        }
+        // 2. Special handling for HTTP/network tools
+        if (toolName === "fetch_url") {
+            const method = String(args.method || "GET").toUpperCase();
+            if (method === "GET" || method === "HEAD" || method === "OPTIONS") {
+                return "read_only";
+            }
+            if (method === "PUT" || method === "DELETE") {
+                return "idempotent_write";
+            }
+            return "non_idempotent_write";
+        }
+        // 3. Known classifications
+        if (SideEffectClassifier.KNOWN_READ_ONLY_TOOLS.has(toolName)) {
+            return "read_only";
+        }
+        if (SideEffectClassifier.KNOWN_IDEMPOTENT_WRITE_TOOLS.has(toolName)) {
+            return "idempotent_write";
+        }
+        if (SideEffectClassifier.KNOWN_REVERSIBLE_WRITE_TOOLS.has(toolName)) {
+            return "reversible_write";
+        }
+        if (SideEffectClassifier.KNOWN_NON_IDEMPOTENT_TOOLS.has(toolName)) {
+            return "non_idempotent_write";
+        }
+        // 4. Default fallback: fail-safe to "unknown"
+        return "unknown";
+    }
+    isSafeToRetry(category) {
+        const validated = SideEffectCategorySchema.parse(category);
+        return validated === "read_only" || validated === "idempotent_write";
+    }
+}
+//# sourceMappingURL=side-effect-classifier.js.map

package/dist/side-effects/side-effect-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effect-classifier.js","sourceRoot":"","sources":["../../src/side-effects/side-effect-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAGlC;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACvB,MAAM,CAAU,qBAAqB,GAAG,IAAI,GAAG,CAAC;QACtD,WAAW;QACX,aAAa;QACb,YAAY;QACZ,UAAU;QACV,WAAW;QACX,YAAY;QACZ,UAAU;QACV,SAAS;QACT,eAAe;QACf,eAAe;QACf,iBAAiB;KAClB,CAAC,CAAC;IAEK,MAAM,CAAU,4BAA4B,GAAG,IAAI,GAAG,CAAC;QAC7D,YAAY;QACZ,eAAe;QACf,cAAc;KACf,CAAC,CAAC;IAEK,MAAM,CAAU,4BAA4B,GAAG,IAAI,GAAG,CAAC;QAC7D,cAAc;KACf,CAAC,CAAC;IAEK,MAAM,CAAU,0BAA0B,GAAG,IAAI,GAAG,CAAC;QAC3D,YAAY;QACZ,aAAa;QACb,aAAa;QACb,iBAAiB;KAClB,CAAC,CAAC;IAEI,QAAQ,CACb,QAAgB,EAChB,OAAgC,EAAE,EAClC,QAAmB;QAEnB,+CAA+C;QAC/C,IAAI,QAAQ,EAAE,YAAY,IAAI,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxF,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,6CAA6C;QAC7C,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1D,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAClE,OAAO,WAAW,CAAC;YACrB,CAAC;YACD,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC5C,OAAO,kBAAkB,CAAC;YAC5B,CAAC;YACD,OAAO,sBAAsB,CAAC;QAChC,CAAC;QAED,2BAA2B;QAC3B,IAAI,oBAAoB,CAAC,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,IAAI,oBAAoB,CAAC,4BAA4B,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpE,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,IAAI,oBAAoB,CAAC,4BAA4B,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpE,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,IAAI,oBAAoB,CAAC,0BAA0B,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,OAAO,sBAAsB,CAAC;QAChC,CAAC;QAED,8CAA8C;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,aAAa,CAAC,QAA4B;QAC/C,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3D,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,kBAAkB,CAAC;IACvE,CAAC"}

package/dist/side-effects/side-effect-journal.d.ts

@@ -0,0 +1,35 @@
+import { type SideEffectCategory, type OutcomeCertainty, type SideEffectJournalEntry } from "../domain/side-effect.js";
+import { type EventStore } from "../event-state/event-store.js";
+export interface RecordSideEffectOptions {
+    journalId?: string;
+    projectId: string;
+    sessionId?: string;
+    taskId?: string;
+    callId: string;
+    toolName: string;
+    category: SideEffectCategory;
+    outcomeCertainty: OutcomeCertainty;
+    idempotencyKey?: string;
+    args: Record<string, unknown>;
+    responseStatus?: string;
+    attemptNumber?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Anantham V2 — Authoritative External Side Effect Journal
+ * PRD Part 2 Section 241 & PRD Part 1 Section 85
+ */
+export declare class SideEffectJournal {
+    private readonly entries;
+    private readonly eventStore?;
+    constructor(options?: {
+        eventStore?: EventStore;
+    });
+    computeRequestHash(toolName: string, args: Record<string, unknown>): string;
+    computeIdempotencyKey(projectId: string, toolName: string, args: Record<string, unknown>, taskId?: string): string;
+    record(options: RecordSideEffectOptions): SideEffectJournalEntry;
+    getEntry(journalId: string): SideEffectJournalEntry | undefined;
+    getEntriesByProject(projectId: string): SideEffectJournalEntry[];
+    findByIdempotencyKey(key: string): SideEffectJournalEntry | undefined;
+}
+//# sourceMappingURL=side-effect-journal.d.ts.map

package/dist/side-effects/side-effect-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effect-journal.d.ts","sourceRoot":"","sources":["../../src/side-effects/side-effect-journal.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;gBAE7B,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,UAAU,CAAA;KAAO;IAI9C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAU3E,qBAAqB,CAC1B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,MAAM;IAKF,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB;IAuDhE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAI/D,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAIhE,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;CAG7E"}

package/dist/side-effects/side-effect-journal.js

@@ -0,0 +1,86 @@
+import crypto from "node:crypto";
+import { EventTypes } from "../domain/event.js";
+/**
+ * Anantham V2 — Authoritative External Side Effect Journal
+ * PRD Part 2 Section 241 & PRD Part 1 Section 85
+ */
+export class SideEffectJournal {
+    entries = new Map();
+    eventStore;
+    constructor(options = {}) {
+        this.eventStore = options.eventStore;
+    }
+    computeRequestHash(toolName, args) {
+        const sortedKeys = Object.keys(args).sort();
+        const sortedObj = {};
+        for (const key of sortedKeys) {
+            sortedObj[key] = args[key];
+        }
+        const serialized = JSON.stringify({ toolName, args: sortedObj });
+        return crypto.createHash("sha256").update(serialized).digest("hex");
+    }
+    computeIdempotencyKey(projectId, toolName, args, taskId) {
+        const hash = this.computeRequestHash(toolName, args);
+        return `${projectId}:${taskId || "default"}:${toolName}:${hash.slice(0, 16)}`;
+    }
+    record(options) {
+        const journalId = options.journalId || `jnl_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        const requestHash = this.computeRequestHash(options.toolName, options.args);
+        const now = new Date().toISOString();
+        const entry = {
+            journalId,
+            projectId: options.projectId,
+            sessionId: options.sessionId,
+            taskId: options.taskId,
+            callId: options.callId,
+            toolName: options.toolName,
+            category: options.category,
+            outcomeCertainty: options.outcomeCertainty,
+            idempotencyKey: options.idempotencyKey,
+            requestHash,
+            responseStatus: options.responseStatus,
+            attemptNumber: options.attemptNumber || 1,
+            executedAt: now,
+            metadata: options.metadata,
+        };
+        this.entries.set(journalId, entry);
+        if (this.eventStore) {
+            let eventType = EventTypes.SIDE_EFFECT_COMPLETED;
+            if (options.outcomeCertainty === "unknown") {
+                eventType = EventTypes.SIDE_EFFECT_UNKNOWN;
+            }
+            else if (options.outcomeCertainty === "known_failed") {
+                eventType = EventTypes.SIDE_EFFECT_FAILED;
+            }
+            this.eventStore.append({
+                id: `evt_se_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+                schemaVersion: 1,
+                projectId: options.projectId,
+                type: eventType,
+                actor: "system",
+                timestamp: now,
+                payload: {
+                    journalId,
+                    toolName: options.toolName,
+                    category: options.category,
+                    outcomeCertainty: options.outcomeCertainty,
+                    idempotencyKey: options.idempotencyKey,
+                    requestHash,
+                    responseStatus: options.responseStatus,
+                    attemptNumber: entry.attemptNumber,
+                },
+            });
+        }
+        return entry;
+    }
+    getEntry(journalId) {
+        return this.entries.get(journalId);
+    }
+    getEntriesByProject(projectId) {
+        return Array.from(this.entries.values()).filter((e) => e.projectId === projectId);
+    }
+    findByIdempotencyKey(key) {
+        return Array.from(this.entries.values()).find((e) => e.idempotencyKey === key);
+    }
+}
+//# sourceMappingURL=side-effect-journal.js.map

package/dist/side-effects/side-effect-journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effect-journal.js","sourceRoot":"","sources":["../../src/side-effects/side-effect-journal.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAOjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAkBhD;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,GAAG,IAAI,GAAG,EAAkC,CAAC;IACpD,UAAU,CAAc;IAEzC,YAAY,UAAuC,EAAE;QACnD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;IAEM,kBAAkB,CAAC,QAAgB,EAAE,IAA6B;QACvE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,SAAS,GAA4B,EAAE,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IAEM,qBAAqB,CAC1B,SAAiB,EACjB,QAAgB,EAChB,IAA6B,EAC7B,MAAe;QAEf,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,OAAO,GAAG,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC;IAEM,MAAM,CAAC,OAAgC;QAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACrG,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,MAAM,KAAK,GAA2B;YACpC,SAAS;YACT,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,WAAW;YACX,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,CAAC;YACzC,UAAU,EAAE,GAAG;YACf,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAEnC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,SAAS,GAAW,UAAU,CAAC,qBAAqB,CAAC;YACzD,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBAC3C,SAAS,GAAG,UAAU,CAAC,mBAAmB,CAAC;YAC7C,CAAC;iBAAM,IAAI,OAAO,CAAC,gBAAgB,KAAK,cAAc,EAAE,CAAC;gBACvD,SAAS,GAAG,UAAU,CAAC,kBAAkB,CAAC;YAC5C,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBACrB,EAAE,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBACpE,aAAa,EAAE,CAAC;gBAChB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,QAAQ;gBACf,SAAS,EAAE,GAAG;gBACd,OAAO,EAAE;oBACP,SAAS;oBACT,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;oBAC1C,cAAc,EAAE,OAAO,CAAC,cAAc;oBACtC,WAAW;oBACX,cAAc,EAAE,OAAO,CAAC,cAAc;oBACtC,aAAa,EAAE,KAAK,CAAC,aAAa;iBACnC;aACF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,QAAQ,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAEM,mBAAmB,CAAC,SAAiB;QAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;IACpF,CAAC;IAEM,oBAAoB,CAAC,GAAW;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,GAAG,CAAC,CAAC;IACjF,CAAC;CACF"}

package/dist/side-effects/worktree-divergence-detector.d.ts

@@ -0,0 +1,10 @@
+import { type WorktreeDivergenceRecord } from "../domain/side-effect.js";
+/**
+ * Anantham V2 — Worktree Divergence Detector
+ * Playbook Section 138 & PRD Part 2 Section 242
+ */
+export declare class WorktreeDivergenceDetector {
+    inspect(worktreePath: string): Promise<WorktreeDivergenceRecord>;
+    assertSafeOperation(record: WorktreeDivergenceRecord, operationName: string): void;
+}
+//# sourceMappingURL=worktree-divergence-detector.d.ts.map

package/dist/side-effects/worktree-divergence-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-divergence-detector.d.ts","sourceRoot":"","sources":["../../src/side-effects/worktree-divergence-detector.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAC9B,MAAM,0BAA0B,CAAC;AAIlC;;;GAGG;AACH,qBAAa,0BAA0B;IACxB,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAqDtE,mBAAmB,CAAC,MAAM,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;CAO1F"}

package/dist/side-effects/worktree-divergence-detector.js

@@ -0,0 +1,63 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+/**
+ * Anantham V2 — Worktree Divergence Detector
+ * Playbook Section 138 & PRD Part 2 Section 242
+ */
+export class WorktreeDivergenceDetector {
+    async inspect(worktreePath) {
+        const now = new Date().toISOString();
+        try {
+            // 1. Get branch and commit
+            const { stdout: branchOut } = await execAsync("git rev-parse --abbrev-ref HEAD", {
+                cwd: worktreePath,
+            });
+            const branch = branchOut.trim();
+            const { stdout: commitOut } = await execAsync("git rev-parse HEAD", {
+                cwd: worktreePath,
+            });
+            const headCommit = commitOut.trim();
+            // 2. Check for uncommitted changes
+            const { stdout: statusOut } = await execAsync("git status --porcelain", {
+                cwd: worktreePath,
+            });
+            const lines = statusOut.split("\n").map((l) => l.trim()).filter(Boolean);
+            const modifiedFiles = lines.map((l) => l.slice(3).trim());
+            const hasUncommittedChanges = modifiedFiles.length > 0;
+            const isDetached = branch === "HEAD";
+            let status = "clean";
+            if (isDetached) {
+                status = "detached";
+            }
+            else if (hasUncommittedChanges) {
+                status = "diverged";
+            }
+            return {
+                worktreePath,
+                branch,
+                headCommit,
+                hasUncommittedChanges,
+                modifiedFiles,
+                status,
+                detectedAt: now,
+            };
+        }
+        catch {
+            // Non-git directory or uninitialized
+            return {
+                worktreePath,
+                hasUncommittedChanges: false,
+                modifiedFiles: [],
+                status: "clean",
+                detectedAt: now,
+            };
+        }
+    }
+    assertSafeOperation(record, operationName) {
+        if (record.hasUncommittedChanges && (operationName.includes("reset") || operationName.includes("clean") || operationName.includes("checkout"))) {
+            throw new Error(`WORKTREE_DIVERGENCE_DETECTED: Worktree "${record.worktreePath}" contains ${record.modifiedFiles.length} uncommitted user modifications. Destructive operation "${operationName}" is prohibited.`);
+        }
+    }
+}
+//# sourceMappingURL=worktree-divergence-detector.js.map

package/dist/side-effects/worktree-divergence-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-divergence-detector.js","sourceRoot":"","sources":["../../src/side-effects/worktree-divergence-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAKtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAC9B,KAAK,CAAC,OAAO,CAAC,YAAoB;QACvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,IAAI,CAAC;YACH,2BAA2B;YAC3B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,SAAS,CAAC,iCAAiC,EAAE;gBAC/E,GAAG,EAAE,YAAY;aAClB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;YAEhC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,SAAS,CAAC,oBAAoB,EAAE;gBAClE,GAAG,EAAE,YAAY;aAClB,CAAC,CAAC;YACH,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;YAEpC,mCAAmC;YACnC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,SAAS,CAAC,wBAAwB,EAAE;gBACtE,GAAG,EAAE,YAAY;aAClB,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzE,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAE1D,MAAM,qBAAqB,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;YACvD,MAAM,UAAU,GAAG,MAAM,KAAK,MAAM,CAAC;YAErC,IAAI,MAAM,GAAiD,OAAO,CAAC;YACnE,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,GAAG,UAAU,CAAC;YACtB,CAAC;iBAAM,IAAI,qBAAqB,EAAE,CAAC;gBACjC,MAAM,GAAG,UAAU,CAAC;YACtB,CAAC;YAED,OAAO;gBACL,YAAY;gBACZ,MAAM;gBACN,UAAU;gBACV,qBAAqB;gBACrB,aAAa;gBACb,MAAM;gBACN,UAAU,EAAE,GAAG;aAChB,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;YACrC,OAAO;gBACL,YAAY;gBACZ,qBAAqB,EAAE,KAAK;gBAC5B,aAAa,EAAE,EAAE;gBACjB,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,GAAG;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,mBAAmB,CAAC,MAAgC,EAAE,aAAqB;QAChF,IAAI,MAAM,CAAC,qBAAqB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YAC/I,MAAM,IAAI,KAAK,CACb,2CAA2C,MAAM,CAAC,YAAY,cAAc,MAAM,CAAC,aAAa,CAAC,MAAM,2DAA2D,aAAa,kBAAkB,CAClM,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/skills/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Anantham V2 — Skills Subsystem
+ *
+ * Export all skill parsers, loaders, relevance matchers, dependency resolvers,
+ * compatibility checkers, registries, managers, test runners, and security guards.
+ */
+export * from "./skill-parser.js";
+export * from "./skill-compatibility.js";
+export * from "./skill-dependency.js";
+export * from "./skill-matcher.js";
+export * from "./skill-loader.js";
+export * from "./skill-test-runner.js";
+export * from "./skill-registry.js";
+export * from "./skill-manager.js";
+export * from "./skill-security.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,16 @@
+/**
+ * Anantham V2 — Skills Subsystem
+ *
+ * Export all skill parsers, loaders, relevance matchers, dependency resolvers,
+ * compatibility checkers, registries, managers, test runners, and security guards.
+ */
+export * from "./skill-parser.js";
+export * from "./skill-compatibility.js";
+export * from "./skill-dependency.js";
+export * from "./skill-matcher.js";
+export * from "./skill-loader.js";
+export * from "./skill-test-runner.js";
+export * from "./skill-registry.js";
+export * from "./skill-manager.js";
+export * from "./skill-security.js";
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/skills/skill-compatibility.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Anantham V2 — Skill Compatibility Checker
+ *
+ * Validates required model capabilities and runtime version constraints for skills.
+ */
+import { type SkillMetadata } from "../domain/skill.js";
+export interface SkillCompatibilityResult {
+    isCompatible: boolean;
+    reasons: string[];
+}
+export declare class SkillCompatibilityChecker {
+    private readonly currentRuntimeVersion;
+    constructor(options?: {
+        runtimeVersion?: string;
+    });
+    /**
+     * Evaluates if a skill is compatible with the given model capabilities and runtime.
+     */
+    checkCompatibility(metadata: SkillMetadata, availableModelCapabilities?: string[]): SkillCompatibilityResult;
+}
+//# sourceMappingURL=skill-compatibility.d.ts.map

package/dist/skills/skill-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-compatibility.d.ts","sourceRoot":"","sources":["../../src/skills/skill-compatibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAEnC,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE;IAIjD;;OAEG;IACI,kBAAkB,CACvB,QAAQ,EAAE,aAAa,EACvB,0BAA0B,GAAE,MAAM,EAAO,GACxC,wBAAwB;CA+B5B"}

package/dist/skills/skill-compatibility.js

@@ -0,0 +1,41 @@
+/**
+ * Anantham V2 — Skill Compatibility Checker
+ *
+ * Validates required model capabilities and runtime version constraints for skills.
+ */
+export class SkillCompatibilityChecker {
+    currentRuntimeVersion;
+    constructor(options) {
+        this.currentRuntimeVersion = options?.runtimeVersion || "2.0.0-alpha.1";
+    }
+    /**
+     * Evaluates if a skill is compatible with the given model capabilities and runtime.
+     */
+    checkCompatibility(metadata, availableModelCapabilities = []) {
+        const reasons = [];
+        // 1. Runtime Version Check
+        if (metadata.runtime) {
+            const minRuntimeMatch = metadata.runtime.match(/>=\s*(\d+)/);
+            if (minRuntimeMatch && minRuntimeMatch[1]) {
+                const minMajor = parseInt(minRuntimeMatch[1], 10);
+                const currentMajor = parseInt(this.currentRuntimeVersion.split(".")[0] || "2", 10);
+                if (currentMajor < minMajor) {
+                    reasons.push(`Incompatible Anantham runtime: Skill requires "${metadata.runtime}", current runtime is "${this.currentRuntimeVersion}".`);
+                }
+            }
+        }
+        // 2. Model Capabilities Check
+        if (metadata.capabilities && metadata.capabilities.length > 0) {
+            for (const cap of metadata.capabilities) {
+                if (!availableModelCapabilities.includes(cap)) {
+                    reasons.push(`Missing required model capability: "${cap}".`);
+                }
+            }
+        }
+        return {
+            isCompatible: reasons.length === 0,
+            reasons,
+        };
+    }
+}
+//# sourceMappingURL=skill-compatibility.js.map

package/dist/skills/skill-compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-compatibility.js","sourceRoot":"","sources":["../../src/skills/skill-compatibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,OAAO,yBAAyB;IACnB,qBAAqB,CAAS;IAE/C,YAAY,OAAqC;QAC/C,IAAI,CAAC,qBAAqB,GAAG,OAAO,EAAE,cAAc,IAAI,eAAe,CAAC;IAC1E,CAAC;IAED;;OAEG;IACI,kBAAkB,CACvB,QAAuB,EACvB,6BAAuC,EAAE;QAEzC,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,2BAA2B;QAC3B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC7D,IAAI,eAAe,IAAI,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClD,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;gBACnF,IAAI,YAAY,GAAG,QAAQ,EAAE,CAAC;oBAC5B,OAAO,CAAC,IAAI,CACV,kDAAkD,QAAQ,CAAC,OAAO,0BAA0B,IAAI,CAAC,qBAAqB,IAAI,CAC3H,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,IAAI,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;gBACxC,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC9C,OAAO,CAAC,IAAI,CAAC,uCAAuC,GAAG,IAAI,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;YAClC,OAAO;SACR,CAAC;IACJ,CAAC;CACF"}

package/dist/skills/skill-dependency.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Anantham V2 — Skill Dependency Resolver
+ *
+ * Validates required tools, MCP servers, and sub-skill dependencies (with cycle detection).
+ */
+import { type SkillMetadata } from "../domain/skill.js";
+import { type ToolRegistry } from "../tools/tool-registry.js";
+import { type MCPRegistry } from "../mcp/mcp-registry.js";
+export interface SkillDependencyResolutionResult {
+    isResolved: boolean;
+    missingTools: string[];
+    missingMCP: string[];
+    missingSkills: string[];
+    cyclicSkills: string[][];
+    errors: string[];
+}
+export declare class SkillDependencyResolver {
+    private readonly toolRegistry?;
+    private readonly mcpRegistry?;
+    constructor(options?: {
+        toolRegistry?: ToolRegistry;
+        mcpRegistry?: MCPRegistry;
+    });
+    /**
+     * Resolves all dependencies for a target skill given the available skills map.
+     */
+    resolveDependencies(skill: SkillMetadata, allSkills: Map<string, SkillMetadata>): SkillDependencyResolutionResult;
+}
+//# sourceMappingURL=skill-dependency.d.ts.map

package/dist/skills/skill-dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-dependency.d.ts","sourceRoot":"","sources":["../../src/skills/skill-dependency.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;gBAE/B,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,YAAY,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE;IAKhF;;OAEG;IACI,mBAAmB,CACxB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACpC,+BAA+B;CA6EnC"}

package/dist/skills/skill-dependency.js

@@ -0,0 +1,88 @@
+/**
+ * Anantham V2 — Skill Dependency Resolver
+ *
+ * Validates required tools, MCP servers, and sub-skill dependencies (with cycle detection).
+ */
+export class SkillDependencyResolver {
+    toolRegistry;
+    mcpRegistry;
+    constructor(options) {
+        this.toolRegistry = options?.toolRegistry;
+        this.mcpRegistry = options?.mcpRegistry;
+    }
+    /**
+     * Resolves all dependencies for a target skill given the available skills map.
+     */
+    resolveDependencies(skill, allSkills) {
+        const missingTools = [];
+        const missingMCP = [];
+        const missingSkills = [];
+        const cyclicSkills = [];
+        // 1. Validate required tools
+        if (this.toolRegistry && skill.tools && skill.tools.length > 0) {
+            for (const tool of skill.tools) {
+                if (!this.toolRegistry.has(tool)) {
+                    missingTools.push(tool);
+                }
+            }
+        }
+        // 2. Validate required MCP servers
+        if (this.mcpRegistry && skill.mcp && skill.mcp.length > 0) {
+            for (const mcpServer of skill.mcp) {
+                const client = this.mcpRegistry.getClient(mcpServer);
+                if (!client || client.getHealthStatus() === "disabled" || client.getHealthStatus() === "unhealthy") {
+                    missingMCP.push(mcpServer);
+                }
+            }
+        }
+        // 3. Validate sub-skills & detect cycles
+        const visited = new Map();
+        const dfs = (skillId, path) => {
+            if (visited.get(skillId) === "visiting") {
+                const cycleIndex = path.indexOf(skillId);
+                cyclicSkills.push([...path.slice(cycleIndex), skillId]);
+                return;
+            }
+            if (visited.get(skillId) === "visited")
+                return;
+            visited.set(skillId, "visiting");
+            const target = allSkills.get(skillId);
+            if (!target) {
+                if (!missingSkills.includes(skillId)) {
+                    missingSkills.push(skillId);
+                }
+            }
+            else {
+                for (const childSkill of target.skills || []) {
+                    dfs(childSkill, [...path, skillId]);
+                }
+            }
+            visited.set(skillId, "visited");
+        };
+        dfs(skill.id, []);
+        const errors = [];
+        if (missingTools.length > 0) {
+            errors.push(`Missing required tools: ${missingTools.join(", ")}.`);
+        }
+        if (missingMCP.length > 0) {
+            errors.push(`Missing or disconnected required MCP servers: ${missingMCP.join(", ")}.`);
+        }
+        if (missingSkills.length > 0) {
+            errors.push(`Missing required sub-skills: ${missingSkills.join(", ")}.`);
+        }
+        if (cyclicSkills.length > 0) {
+            for (const cycle of cyclicSkills) {
+                errors.push(`Cyclic skill dependency detected: ${cycle.join(" -> ")}.`);
+            }
+        }
+        return {
+            isResolved: errors.length === 0,
+            missingTools,
+            missingMCP,
+            missingSkills,
+            cyclicSkills,
+            errors,
+        };
+    }
+}
+//# sourceMappingURL=skill-dependency.js.map

package/dist/skills/skill-dependency.js.map

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

package/dist/skills/skill-loader.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Anantham V2 — Skill Progressive Loader
+ *
+ * Implements three-phase progressive disclosure: Metadata -> Relevance match -> Full procedure body.
+ */
+import { type SkillManifest } from "../domain/skill.js";
+import { SkillRelevanceMatcher, type SkillMatchCandidate } from "./skill-matcher.js";
+import { SkillCompatibilityChecker } from "./skill-compatibility.js";
+import { SkillDependencyResolver } from "./skill-dependency.js";
+export interface ProgressiveLoadOptions {
+    taskGoal: string;
+    availableCapabilities?: string[];
+    maxTokens?: number;
+    minRelevanceScore?: number;
+}
+export interface LoadedSkillContext {
+    skillId: string;
+    version: string;
+    name: string;
+    procedurePrompt: string;
+    tokenEstimate: number;
+}
+export declare class SkillProgressiveLoader {
+    private readonly matcher;
+    private readonly compatibilityChecker;
+    private readonly dependencyResolver;
+    private readonly bodyCache;
+    constructor(options?: {
+        matcher?: SkillRelevanceMatcher;
+        compatibilityChecker?: SkillCompatibilityChecker;
+        dependencyResolver?: SkillDependencyResolver;
+    });
+    /**
+     * Clears derived body cache (for cache safety on disable/reload).
+     */
+    invalidateCache(skillId?: string): void;
+    /**
+     * Evaluates task goal and progressively loads only relevant, compatible skills into context.
+     */
+    loadRelevantSkills(installedManifests: SkillManifest[], options: ProgressiveLoadOptions): {
+        matched: SkillMatchCandidate[];
+        loaded: LoadedSkillContext[];
+        skipped: Array<{
+            skillId: string;
+            reason: string;
+        }>;
+    };
+    private formatProcedurePrompt;
+}
+//# sourceMappingURL=skill-loader.d.ts.map

package/dist/skills/skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/skills/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA4B;IACjE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA0B;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;gBAE3C,OAAO,CAAC,EAAE;QACpB,OAAO,CAAC,EAAE,qBAAqB,CAAC;QAChC,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;QACjD,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;KAC9C;IAMD;;OAEG;IACI,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ9C;;OAEG;IACI,kBAAkB,CACvB,kBAAkB,EAAE,aAAa,EAAE,EACnC,OAAO,EAAE,sBAAsB,GAC9B;QACD,OAAO,EAAE,mBAAmB,EAAE,CAAC;QAC/B,MAAM,EAAE,kBAAkB,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrD;IAoED,OAAO,CAAC,qBAAqB;CA6B9B"}