@slicenfer/project-memory-runtime-core 0.3.0

package/dist/types.d.ts

@@ -0,0 +1,294 @@
+export type EventType = "user_message" | "agent_message" | "file_edit" | "command_result" | "test_result" | "build_result" | "lint_result" | "benchmark_result" | "deploy_result" | "git_commit" | "git_revert" | "pr_opened" | "pr_merged" | "pr_closed" | "issue_link" | "issue_closed" | "issue_reopened" | "human_edit_after_agent" | "manual_override" | "session_start" | "session_end" | "user_confirmation";
+export declare const STABLE_OUTCOME_TYPES: readonly ["test_pass", "test_fail", "build_pass", "build_fail", "commit_kept", "commit_reverted", "issue_closed", "issue_reopened", "human_kept", "human_corrected", "manual_override"];
+export type OutcomeType = (typeof STABLE_OUTCOME_TYPES)[number];
+export declare const POSITIVE_OUTCOME_TYPES: readonly ["test_pass", "build_pass", "commit_kept", "issue_closed", "human_kept"];
+export declare const NEGATIVE_OUTCOME_TYPES: readonly ["test_fail", "build_fail", "commit_reverted", "issue_reopened", "human_corrected", "manual_override"];
+export declare const SESSION_CHECKPOINT_STATUSES: readonly ["active", "stale"];
+export type SessionCheckpointStatus = (typeof SESSION_CHECKPOINT_STATUSES)[number];
+export declare const SESSION_CHECKPOINT_SOURCES: readonly ["precompact", "session_end", "postcompact", "stop_failure"];
+export type SessionCheckpointSource = (typeof SESSION_CHECKPOINT_SOURCES)[number];
+export interface EventScope {
+    repo?: string;
+    branch?: string;
+    cwd?: string;
+    files?: string[];
+}
+export type EventSourceKind = "user" | "agent" | "system" | "operator" | "imported";
+export type EventTrustLevel = "low" | "medium" | "high";
+export type EventCapturePath = "fixture.user_confirmation" | "fixture.user_message" | "claude_code.hook.user_confirmation" | "claude_code.hook.user_message" | "import.transcript" | "system.tool_observation" | "operator.manual";
+export interface NormalizedEvent {
+    id: string;
+    ts: string;
+    project_id: string;
+    agent_id: string;
+    agent_version: string;
+    event_type: EventType;
+    content: string;
+    session_id?: string;
+    workspace_id?: string;
+    repo_id?: string;
+    parent_event_id?: string;
+    causation_id?: string;
+    capture_path?: EventCapturePath;
+    source_kind?: EventSourceKind;
+    trust_level?: EventTrustLevel;
+    scope?: EventScope;
+    metadata?: Record<string, unknown>;
+}
+export type ClaimType = "fact" | "decision" | "thread";
+export type ClaimCardinality = "singleton" | "set";
+export type VerificationStatus = "unverified" | "inferred" | "user_confirmed" | "system_verified" | "outcome_verified" | "disputed";
+export type ClaimStatus = "active" | "stale" | "superseded" | "archived";
+export type ThreadStatus = "open" | "resolved" | "blocked";
+export interface ClaimScope {
+    repo?: string;
+    branch?: string;
+    cwd_prefix?: string;
+    files?: string[];
+}
+export interface ResolutionRuleIssueClosed {
+    type: "issue_closed";
+    issue_id: string;
+}
+export interface ResolutionRulePrMerged {
+    type: "pr_merged";
+    pr_id: string;
+}
+export interface ResolutionRuleBranchDeleted {
+    type: "branch_deleted";
+    branch: string;
+}
+export interface ResolutionRuleCommitContains {
+    type: "commit_contains";
+    pattern: string;
+}
+export interface ResolutionRuleTestPass {
+    type: "test_pass";
+    test_name: string;
+}
+export type ResolutionRule = ResolutionRuleIssueClosed | ResolutionRulePrMerged | ResolutionRuleBranchDeleted | ResolutionRuleCommitContains | ResolutionRuleTestPass;
+export interface Claim {
+    id: string;
+    created_at: string;
+    project_id: string;
+    type: ClaimType;
+    assertion_kind: "fact" | "hypothesis" | "instruction" | "preference" | "todo" | "outcome";
+    canonical_key: string;
+    cardinality: ClaimCardinality;
+    content: string;
+    source_event_ids: string[];
+    confidence: number;
+    importance: number;
+    outcome_score: number;
+    verification_status: VerificationStatus;
+    verification_method?: string;
+    status: ClaimStatus;
+    pinned?: boolean;
+    valid_from?: string;
+    valid_to?: string;
+    supersedes?: string[];
+    last_verified_at?: string;
+    last_activated_at?: string;
+    scope?: ClaimScope;
+    thread_status?: ThreadStatus;
+    resolved_at?: string;
+    resolution_rules?: ResolutionRule[];
+}
+export interface Outcome {
+    id: string;
+    ts: string;
+    project_id: string;
+    related_event_ids: string[];
+    related_claim_ids?: string[];
+    outcome_type: OutcomeType;
+    strength: number;
+    notes?: string;
+}
+export interface ClaimTransition {
+    id: string;
+    ts: string;
+    project_id: string;
+    claim_id: string;
+    from_status?: ClaimStatus;
+    to_status: ClaimStatus;
+    reason: string;
+    trigger_type: string;
+    trigger_ref?: string;
+    actor: string;
+}
+export type SuppressionReason = "project_mismatch" | "scope_mismatch" | "verification_guard" | "superseded" | "archived" | "expired" | "low_rank" | "token_budget";
+export interface ActivationLog {
+    id: string;
+    ts: string;
+    project_id: string;
+    claim_id: string;
+    eligibility_result: "passed" | "filtered";
+    suppression_reason?: SuppressionReason;
+    rank_score?: number;
+    packing_decision?: "included" | "dropped";
+    activation_reasons?: string[];
+}
+export interface OutcomeSummary {
+    positive_count: number;
+    negative_count: number;
+    outcome_types: OutcomeType[];
+    last_outcome_at?: string;
+}
+export interface SessionCheckpoint {
+    id: string;
+    created_at: string;
+    project_id: string;
+    session_id: string;
+    workspace_id?: string;
+    branch?: string;
+    repo_head?: string;
+    status: SessionCheckpointStatus;
+    source: SessionCheckpointSource;
+    summary: string;
+    current_goal?: string;
+    next_action?: string;
+    blocking_reason?: string;
+    hot_claim_ids: string[];
+    hot_files: string[];
+    evidence_refs: string[];
+    packet_hash: string;
+    hot_file_digests?: Record<string, string>;
+    stale_reason?: string;
+}
+export interface RecallCheckpoint {
+    id: string;
+    created_at: string;
+    project_id: string;
+    session_id: string;
+    workspace_id?: string;
+    branch?: string;
+    repo_head?: string;
+    status: SessionCheckpointStatus;
+    source: SessionCheckpointSource;
+    summary: string;
+    current_goal?: string;
+    next_action?: string;
+    blocking_reason?: string;
+    hot_claim_ids: string[];
+    hot_files: string[];
+    evidence_refs: string[];
+    stale_reason?: string;
+}
+export interface RecallClaim extends Claim {
+    recall_rank: number;
+    activation_reasons: string[];
+    evidence_refs: string[];
+    outcome_summary?: OutcomeSummary;
+}
+export interface RecallPacket {
+    project_id: string;
+    generated_at: string;
+    agent_id: string;
+    brief: string;
+    checkpoint?: RecallCheckpoint;
+    active_claims: RecallClaim[];
+    open_threads: RecallClaim[];
+    recent_evidence_refs: string[];
+    warnings?: string[];
+}
+export interface SessionBriefInput {
+    project_id: string;
+    session_id?: string;
+    workspace_id?: string;
+    agent_id: string;
+    scope?: ClaimScope;
+    debug?: boolean;
+    cwd?: string;
+}
+export interface ProjectSnapshotInput {
+    project_id: string;
+    agent_id: string;
+    scope?: ClaimScope;
+    debug?: boolean;
+    workspace_id?: string;
+    cwd?: string;
+}
+export interface SearchClaimsInput {
+    project_id: string;
+    query: string;
+    scope?: ClaimScope;
+    debug?: boolean;
+    limit?: number;
+}
+export interface RuntimeConfig {
+    dataDir?: string;
+    dbPath?: string;
+    allowed_capture_paths?: EventCapturePath[];
+}
+export interface RuntimePaths {
+    dataDir: string;
+    dbPath: string;
+}
+export interface RuntimeStats {
+    events: number;
+    claims: number;
+    outcomes: number;
+    transitions: number;
+    activationLogs: number;
+    checkpoints: number;
+    migrationsApplied: number;
+}
+export interface RuntimeAdminApi {
+    insertClaimRecord(claim: Claim): void;
+    insertOutcomeRecord(outcome: Outcome): void;
+    insertSessionCheckpointRecord(checkpoint: SessionCheckpoint): void;
+}
+export interface VerifyClaimInput {
+    claim_id: string;
+    status: "system_verified" | "user_confirmed" | "disputed";
+    method: string;
+    ts?: string;
+    actor?: string;
+}
+export interface MarkClaimStaleInput {
+    claim_id: string;
+    reason: string;
+    ts?: string;
+    actor?: string;
+}
+export interface OutcomeTimelineEntry {
+    ts: string;
+    event_type: string;
+    description: string;
+    score_before?: number;
+    score_after?: number;
+}
+export interface ExplainClaimResult {
+    claim: Claim;
+    transitions: ClaimTransition[];
+    activation_logs: ActivationLog[];
+    related_outcomes: Outcome[];
+    outcome_timeline: OutcomeTimelineEntry[];
+}
+export interface RecordSessionCheckpointInput {
+    project_id: string;
+    session_id: string;
+    workspace_id?: string;
+    agent_id: string;
+    scope?: ClaimScope;
+    cwd?: string;
+    source: SessionCheckpointSource;
+    summary_hint?: string;
+    blocking_hint?: string;
+}
+export interface GetLatestCheckpointInput {
+    project_id: string;
+    workspace_id?: string;
+    status?: SessionCheckpointStatus;
+}
+export interface VerifyCheckpointForSessionStartInput {
+    project_id: string;
+    workspace_id?: string;
+    branch?: string;
+    cwd?: string;
+}
+export interface VerifyCheckpointForSessionStartResult {
+    checkpoint?: RecallCheckpoint;
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,36 @@
+export const STABLE_OUTCOME_TYPES = [
+    "test_pass",
+    "test_fail",
+    "build_pass",
+    "build_fail",
+    "commit_kept",
+    "commit_reverted",
+    "issue_closed",
+    "issue_reopened",
+    "human_kept",
+    "human_corrected",
+    "manual_override",
+];
+export const POSITIVE_OUTCOME_TYPES = [
+    "test_pass",
+    "build_pass",
+    "commit_kept",
+    "issue_closed",
+    "human_kept",
+];
+export const NEGATIVE_OUTCOME_TYPES = [
+    "test_fail",
+    "build_fail",
+    "commit_reverted",
+    "issue_reopened",
+    "human_corrected",
+    "manual_override",
+];
+export const SESSION_CHECKPOINT_STATUSES = ["active", "stale"];
+export const SESSION_CHECKPOINT_SOURCES = [
+    "precompact",
+    "session_end",
+    "postcompact",
+    "stop_failure",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW;IACX,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,iBAAiB;IACjB,cAAc;IACd,gBAAgB;IAChB,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;CACT,CAAC;AAIX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW;IACX,YAAY;IACZ,aAAa;IACb,cAAc;IACd,YAAY;CAC6B,CAAC;AAE5C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW;IACX,YAAY;IACZ,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;CACwB,CAAC;AAE5C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAU,CAAC;AAGxE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,YAAY;IACZ,aAAa;IACb,aAAa;IACb,cAAc;CACN,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,16 @@
+import { type OutcomeType } from "./types.js";
+/** Returns the current timestamp in ISO 8601 format. */
+export declare function nowIso(): string;
+/** Clamps a number between min and max bounds. */
+export declare function clamp(value: number, min: number, max: number): number;
+/** Calculates the non-negative number of days between two ISO timestamps. */
+export declare function daysBetween(fromIso: string, toIso: string): number;
+/** Safely converts an unknown value to a trimmed string, or undefined if empty/non-string. */
+export declare function asString(value: unknown): string | undefined;
+/** Generates a deterministic 24-char hex ID from input parts via SHA-256. */
+export declare function hashId(...parts: string[]): string;
+/** Canonical set of positive outcome types. Single source of truth. */
+export declare const POSITIVE_OUTCOME_TYPES: ReadonlySet<OutcomeType>;
+/** Canonical set of negative outcome types. Single source of truth. */
+export declare const NEGATIVE_OUTCOME_TYPES: ReadonlySet<OutcomeType>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAEpB,wDAAwD;AACxD,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,kDAAkD;AAClD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE3D;AAED,6EAA6E;AAC7E,wBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAIjD;AAED,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,WAAW,CAE1D,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,WAAW,CAE1D,CAAC"}

package/dist/utils.js

@@ -0,0 +1,36 @@
+import { createHash } from "node:crypto";
+import { NEGATIVE_OUTCOME_TYPES as NEGATIVE_OUTCOME_TYPE_VALUES, POSITIVE_OUTCOME_TYPES as POSITIVE_OUTCOME_TYPE_VALUES, } from "./types.js";
+/** Returns the current timestamp in ISO 8601 format. */
+export function nowIso() {
+    return new Date().toISOString();
+}
+/** Clamps a number between min and max bounds. */
+export function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+/** Calculates the non-negative number of days between two ISO timestamps. */
+export function daysBetween(fromIso, toIso) {
+    const from = new Date(fromIso).getTime();
+    const to = new Date(toIso).getTime();
+    return Math.max(0, (to - from) / (1000 * 60 * 60 * 24));
+}
+/** Safely converts an unknown value to a trimmed string, or undefined if empty/non-string. */
+export function asString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+/** Generates a deterministic 24-char hex ID from input parts via SHA-256. */
+export function hashId(...parts) {
+    const hash = createHash("sha256");
+    for (const part of parts)
+        hash.update(part);
+    return hash.digest("hex").slice(0, 24);
+}
+/** Canonical set of positive outcome types. Single source of truth. */
+export const POSITIVE_OUTCOME_TYPES = new Set([
+    ...POSITIVE_OUTCOME_TYPE_VALUES,
+]);
+/** Canonical set of negative outcome types. Single source of truth. */
+export const NEGATIVE_OUTCOME_TYPES = new Set([
+    ...NEGATIVE_OUTCOME_TYPE_VALUES,
+]);
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,sBAAsB,IAAI,4BAA4B,EACtD,sBAAsB,IAAI,4BAA4B,GAEvD,MAAM,YAAY,CAAC;AAEpB,wDAAwD;AACxD,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,KAAa;IACxD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IACzC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IACrC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACzF,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,MAAM,CAAC,GAAG,KAAe;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAA6B,IAAI,GAAG,CAAc;IACnF,GAAG,4BAA4B;CAChC,CAAC,CAAC;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAA6B,IAAI,GAAG,CAAc;IACnF,GAAG,4BAA4B;CAChC,CAAC,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,24 @@
+import type { Claim, EventCapturePath, ClaimStatus, EventType, NormalizedEvent, Outcome, OutcomeType, ResolutionRule, SessionCheckpoint, SessionCheckpointStatus, VerificationStatus } from "./types.js";
+export declare const DEFAULT_ALLOWED_CAPTURE_PATHS: EventCapturePath[];
+export declare class RuntimeInvariantError extends Error {
+    constructor(message: string);
+}
+export declare function assertEventType(eventType: string): asserts eventType is EventType;
+export declare function assertCapturePath(capturePath: string): asserts capturePath is EventCapturePath;
+export declare function assertVerificationStatus(status: string): asserts status is VerificationStatus;
+export declare function assertOutcomeType(outcomeType: string): asserts outcomeType is OutcomeType;
+export declare function assertClaimTransitionAllowed(fromStatus: ClaimStatus, toStatus: ClaimStatus, reason: string): void;
+export declare function validateClaimRecord(claim: Claim): void;
+export declare function validateOutcomeRecord(outcome: Outcome): void;
+export declare function assertSessionCheckpointStatus(status: string): asserts status is SessionCheckpointStatus;
+export declare function validateSessionCheckpointRecord(checkpoint: SessionCheckpoint): void;
+export declare function validateEventRecord(event: NormalizedEvent): void;
+export declare function assertCapturePathAllowed(capturePath: EventCapturePath, allowedCapturePaths: ReadonlySet<EventCapturePath>): void;
+export declare function deriveEventProvenance(event: NormalizedEvent): NormalizedEvent;
+export declare function hasTrustedUserConfirmationCapturePath(event: NormalizedEvent): boolean;
+export declare function hasTrustedUserMessageCapturePath(event: NormalizedEvent): boolean;
+export declare function hasTrustedNegativeLifecycleCapturePath(event: NormalizedEvent): boolean;
+export declare function isExplicitVerificationStatus(status: VerificationStatus): boolean;
+export declare function familyHintAllowedForEvent(family: "current_strategy" | "blocker" | "rejected_strategy" | "open_question", event: NormalizedEvent): boolean;
+export declare function resolutionRuleSummary(rule: ResolutionRule): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,gBAAgB,EAChB,WAAW,EACX,SAAS,EAGT,eAAe,EACf,OAAO,EACP,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AA+IpB,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAM3D,CAAC;AAEF,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAyBD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,IAAI,SAAS,CAEjF;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,IAAI,gBAAgB,CAEzC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,IAAI,kBAAkB,CAMtC;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAEzF;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,WAAW,EACvB,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,MAAM,GACb,IAAI,CAON;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAiCtD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAM5D;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,IAAI,uBAAuB,CAM3C;AAED,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAkCnF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CA8BhE;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,gBAAgB,EAC7B,mBAAmB,EAAE,WAAW,CAAC,gBAAgB,CAAC,GACjD,IAAI,CAMN;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAS7E;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAOrF;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAOhF;AAED,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAQtF;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAET;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EACF,kBAAkB,GAClB,SAAS,GACT,mBAAmB,GACnB,eAAe,EACnB,KAAK,EAAE,eAAe,GACrB,OAAO,CAMT;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAalE"}