@warpgogol/forge 0.3.1

package/dist/os/rfc/types.d.ts

@@ -0,0 +1,448 @@
+/***************************************************************
+ * <MODULE_CONTRACT>
+ * <purpose>
+ * Defines types and constants for managing RFC lifecycle,
+ * including statuses, kinds, and scopes, facilitating
+ * structured proposal submissions.
+ * </purpose>
+ *  *  * <non-goals>
+ * <item>Do not implement RFC processing or validation logic here.</item>
+ * <item>Do not handle user input or command execution related to RFCs.</item>
+ * <item>Do not manage the storage or retrieval of RFC documents.</item>
+ * </non-goals>
+ * </MODULE_CONTRACT>
+ *  * <CHANGE_SUMMARY>
+  <item>Tidied by compass.changesummary.tidy; see git history for prior entries.</item>
+  <item>RFC-0465: added specRef field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for PBP spec traceability.</item>
+  <item>RFC-0478: added versionBump field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for platform versioning enforcement.</item>
+  <item>RFC-0480: added breaksC field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for Layer C protection.</item>
+</CHANGE_SUMMARY>
+ ***************************************************************/
+import type { Diagnostic } from "../../src/types.ts";
+/**
+ * The lifecycle status of an RFC.
+ *
+ * Transitions:
+ *   draft → reviewing → accepted → implemented
+ *                    ↘ rejected
+ *   any → superseded (when a new RFC replaces this one)
+ *
+ * Only a person with role "architecture" may change status.
+ * Agents may only create RFCs in "draft" status.
+ *
+ * Derived decision mapping (not stored, computed when needed):
+ *   "pending"  ← draft | reviewing
+ *   "approved" ← accepted | implemented | superseded
+ *   "rejected" ← rejected
+ */
+export type RfcStatus = "draft" | "reviewing" | "accepted" | "implemented" | "rejected" | "superseded";
+export declare const RFC_STATUSES: readonly RfcStatus[];
+/**
+ * The nature of the change an RFC proposes.
+ *
+ * "architecture" — introduces or modifies an architectural invariant.
+ * "contract"     — adds or revises a page, component, semantic, brand, or quality contract.
+ * "command"      — adds, changes, or removes a site-kernel CLI command.
+ * "policy"       — establishes a governance, ownership, or agent-behavior rule.
+ * "deprecation"  — officially retires a rule, command, or document.
+ */
+export type RfcKind = "architecture" | "contract" | "command" | "policy" | "deprecation";
+export declare const RFC_KINDS: readonly RfcKind[];
+/**
+ * Whether the RFC affects a single app or the whole workspace.
+ *
+ * "workspace" — applies to all apps and/or shared packages.
+ * "app"       — applies to one specific app; may be promoted later.
+ */
+export type RfcScope = "app" | "workspace";
+export declare const RFC_SCOPES: readonly RfcScope[];
+/**
+ * Tracks which OS commands this RFC adds, changes, or removes.
+ * Used by rfc.validate to cross-check that proposed commands
+ * exist in the registry once status reaches "implemented".
+ */
+export interface RfcCommands {
+    /** Commands this RFC intends to add. */
+    proposed?: string[];
+    /** Commands added by this RFC (populated when implemented). */
+    added?: string[];
+    /** Commands modified by this RFC (populated when implemented). */
+    changed?: string[];
+    /** Commands removed by this RFC (populated when implemented). */
+    removed?: string[];
+}
+/**
+ * The canonical frontmatter shape for every RFC file.
+ *
+ * RFC files live in `docs/rfcs/` and are named `RFC-XXXX-kebab-title.md`.
+ * The frontmatter is the machine-readable contract;
+ * the markdown body is the human-readable explanation.
+ *
+ * Design note: `decision` and `agentPolicy` fields from earlier proposals
+ * are intentionally omitted. Decision is derived from status deterministically.
+ * Agent policy is defined globally in AGENTS.md, not per-RFC.
+ */
+export interface RfcFrontmatter {
+    /** Unique identifier. Format: RFC-XXXX (zero-padded to 4 digits). */
+    id: string;
+    /** Short imperative title. Sentence-case, no trailing period. */
+    title: string;
+    status: RfcStatus;
+    kind: RfcKind;
+    scope: RfcScope;
+    /** Primary owners. At least one required. Use handle strings, e.g. "architecture". */
+    owners: string[];
+    /** Optional additional reviewers. */
+    reviewers?: string[];
+    /** ISO 8601 date of creation. */
+    createdAt: string;
+    /** ISO 8601 date of last frontmatter update. */
+    updatedAt: string;
+    /** ISO 8601 date when the RFC was enhanced via fo-idea-enhance (audit findings integrated). */
+    enhancedAt?: string;
+    /** ISO 8601 date when status became "implemented". */
+    implementedAt?: string;
+    /** ISO 8601 date when status became "rejected" or "superseded". */
+    closedAt?: string;
+    /**
+     * IDs of RFCs this RFC supersedes.
+     * Those RFCs must set supersededBy to this RFC's id.
+     */
+    supersedes?: string[];
+    /**
+     * ID of the RFC that supersedes this one (if any).
+     * Set when this RFC is superseded.
+     */
+    supersededBy?: string;
+    /**
+     * IDs of RFCs this RFC amends — partially modifies without retiring.
+     * Weaker than `supersedes`: the amended RFC keeps its status.
+     * Those RFCs must list this RFC's id in `amendedBy`.
+     */
+    amends?: string[];
+    /**
+     * IDs of RFCs that amend this one (partial later modifications).
+     * Non-terminal: being amended does NOT change this RFC's status.
+     */
+    amendedBy?: string[];
+    /**
+     * Cross-references to Architecture DNA invariants, anti-patterns,
+     * spec documents, or other RFCs.
+     *
+     * Use identifiers like: "DNA-5", "AP-3", "RFC-0001",
+     * "PAGE-MANDATORY-ARTIFACTS", "COMPONENT-THREE-WAY-MIRROR"
+     */
+    related?: string[];
+    commands?: RfcCommands;
+    /** App directory names affected by this RFC. */
+    appsImpacted?: string[];
+    /** Package names affected by this RFC. */
+    packagesImpacted?: string[];
+    /**
+     * Observable signals that confirm this RFC is fully implemented
+     * and working as intended. Written as plain statements, not checklist items.
+     */
+    successSignals?: string[];
+    /**
+     * Explicit list of what this RFC does NOT cover.
+     * Prevents scope creep in implementation.
+     */
+    nonGoals?: string[];
+    /**
+     * RFC-0268: OPTIONAL machine-checkable acceptance probes. Executed by
+     * `rfc.acceptance.run`, never automatically inside `rfc.validate` (which
+     * must stay fast and side-effect free).
+     */
+    acceptance?: AcceptanceProbe[];
+    /**
+     * RFC-0331: DNA invariants this RFC satisfies. Each entry is a DNA-NN identifier.
+     * Required for RFCs created on or after RFC_METADATA_CUTOFF (V-24).
+     */
+    satisfies?: string[];
+    /**
+     * RFC-0396: Traceability to a vendored spec node.
+     * Format: "<spec-id>/<node-id>", e.g. "pbp-specification-package/RFC-PBP-000".
+     * Set by spec.materialize; optional for non-spec RFCs.
+     */
+    specRef?: string;
+    /**
+     * RFC-0478: Platform versioning enforcement. Declares the SemVer delta
+     * this RFC produces when implemented. Required for post-cutoff implemented
+     * RFCs (V-29). Values: "minor" (Breaks-B, requires migrator), "patch" (safe),
+     * "none" (prose-only), "major" (architectural, manually reserved).
+     */
+    versionBump?: "minor" | "patch" | "none" | "major";
+    /**
+     * RFC-0480: Declares that this RFC changes Layer C external surfaces
+     * (URL schema, JSON-LD types, sitemap shape). If true, the RFC must
+     * modify files in packages/ontology/src/external-surfaces/. Validated
+     * by V-30.
+     */
+    breaksC?: boolean;
+}
+/**
+ * Closed probe vocabulary (v1). `run` commands are restricted to the
+ * site-kernel CLI itself (string must start with "site-kernel ") — no
+ * arbitrary shell, keeping the probe surface auditable and platform-independent.
+ */
+export type AcceptanceProbe = {
+    probe: "run";
+    command: string;
+    expect: {
+        exitCode: number;
+    };
+} | {
+    probe: "file-exists";
+    path: string;
+} | {
+    probe: "file-contains";
+    path: string;
+    pattern: string;
+} | {
+    probe: "command-registered";
+    name: string;
+} | {
+    probe: "page";
+    path: string;
+    expectStatus?: number;
+    selector?: string;
+    textPattern?: string;
+    allowConsoleErrors?: boolean;
+};
+export interface ProbeResult {
+    probe: AcceptanceProbe;
+    ok: boolean;
+    /** Actual exit code / resolution info. */
+    detail: string;
+}
+export interface RfcAcceptanceRunResult {
+    command: "rfc.acceptance.run";
+    status: "pass" | "fail";
+    diagnostics: Diagnostic[];
+    results: Array<{
+        rfcId: string;
+        probeResults: ProbeResult[];
+    }>;
+}
+export interface VerificationEvidenceProbeRecord {
+    probe: AcceptanceProbe;
+    ok: boolean;
+    detail: string;
+    durationMs: number;
+}
+export interface VerificationEvidence {
+    rfcId: string;
+    title: string;
+    rfcStatus: RfcStatus;
+    emittedAt: string;
+    commit: string;
+    workingTreeDirty: boolean;
+    kernelVersion: string;
+    rfcFileHash: string;
+    acceptanceHash: string;
+    probes: VerificationEvidenceProbeRecord[];
+    overall: "pass" | "fail";
+    filesModified?: string[];
+}
+export interface RfcVerificationEmitResult {
+    command: "rfc.verification.emit";
+    status: "pass" | "fail";
+    emitted: Array<{
+        rfcId: string;
+        file: string;
+        overall: "pass" | "fail";
+    }>;
+    skipped: Array<{
+        rfcId: string;
+        reason: "no-probes";
+    }>;
+    diagnostics: Diagnostic[];
+}
+export interface RfcValidationViolation {
+    rfcId: string;
+    file: string;
+    rule: string;
+    message: string;
+    severity: "error" | "warning";
+}
+export interface RfcValidationResult {
+    command: "rfc.validate";
+    status: "pass" | "fail";
+    count: number;
+    violations: RfcValidationViolation[];
+}
+export interface RfcCommandLifecycleDiagnosticData {
+    rfcId: string;
+    command: string;
+    status: RfcStatus;
+    bucket: "proposed" | "added" | "changed" | "removed";
+}
+export interface RfcCommandLifecycleViolation {
+    rfcId: string;
+    file: string;
+    rule: "RFC-CMD-01" | "RFC-CMD-02" | "RFC-CMD-03" | "RFC-CMD-04" | "RFC-CMD-05";
+    message: string;
+    severity: "error" | "warning";
+    data: RfcCommandLifecycleDiagnosticData;
+}
+export interface RfcCommandLifecycleValidationResult {
+    command: "rfc.command-lifecycle.validate";
+    status: "pass" | "fail";
+    count: number;
+    violations: RfcCommandLifecycleViolation[];
+}
+/** Compact RFC summary for list output. */
+export interface RfcListEntry {
+    id: string;
+    title: string;
+    status: RfcStatus;
+    kind: RfcKind;
+    scope: RfcScope;
+    owners: string[];
+    createdAt: string;
+    updatedAt: string;
+    file: string;
+}
+export interface RfcListResult {
+    command: "rfc.list";
+    status: "ok";
+    count: number;
+    entries: RfcListEntry[];
+}
+export interface RfcCreateResult {
+    command: "rfc.create";
+    status: "ok";
+    file: string;
+    id: string;
+    satisfies?: string[];
+    /** RFC-0329: prior decisions consulted at creation time. */
+    consultedDecisions?: ConsultedDecision[];
+}
+export interface RfcNextIdResult {
+    command: "rfc.next-id";
+    nextId: string;
+    nextNumber: number;
+    maxExistingId: string;
+    scannedFiles: number;
+}
+export type DecisionLogEntryKind = "rejected-rfc" | "superseded-rfc" | "rejected-alternative";
+export interface DecisionLogEntry {
+    kind: DecisionLogEntryKind;
+    rfcId: string;
+    title: string;
+    status: RfcStatus;
+    closedAt?: string;
+    supersededBy?: string;
+    decisionSummary?: string;
+    alternativesText?: string;
+    file: string;
+}
+export interface DecisionLogResult {
+    command: "rfc.decision-log.generate";
+    status: "ok" | "drift";
+    count: number;
+    entries: DecisionLogEntry[];
+    written?: string[];
+}
+export interface ConsultedDecision {
+    rfcId: string;
+    kind: DecisionLogEntryKind;
+    title: string;
+    score: number;
+    file: string;
+}
+export interface RfcSupersedeProposeResult {
+    command: "rfc.supersede.propose";
+    status: "ok";
+    file: string;
+    id: string;
+    supersedesTarget: string;
+    invariants: string[];
+    consultedDecisions: ConsultedDecision[];
+}
+export interface RfcCheckViolation {
+    rfcId: string;
+    file: string;
+    kind: "missing-file" | "missing-feature-flag";
+    /** The artifact path or flag key that is missing. */
+    artifact: string;
+    message: string;
+}
+export interface RfcCheckResult {
+    command: "rfc.check";
+    status: "pass" | "fail";
+    checkedRfcs: number;
+    violations: RfcCheckViolation[];
+}
+/** One entry in the rfc.index.generate relationship index. */
+export interface RfcIndexEntry {
+    id: string;
+    title: string;
+    status: RfcStatus;
+    kind: RfcKind;
+    createdAt: string;
+    implementedAt: string;
+    closedAt: string;
+    supersedes: string[];
+    supersededBy: string;
+    amends: string[];
+    amendedBy: string[];
+    related: string[];
+    file: string;
+}
+export interface RfcIndexResult {
+    command: "rfc.index.generate";
+    status: "ok";
+    count: number;
+    entries: RfcIndexEntry[];
+    /** Path written, if --write was passed. */
+    written?: string;
+}
+export interface RfcGraphResult {
+    command: "rfc.graph";
+    status: "ok";
+    id: string;
+    supersedes: string[];
+    supersededBy: string;
+    amends: string[];
+    amendedBy: string[];
+    related: string[];
+}
+export interface RfcImplementStampData {
+    rfcId: string;
+    implementationCommit: string;
+    stampedAt: string;
+    criteriaChecked: number;
+    evidencePath?: string;
+}
+export type RfcImplementStampRule = "RFC-IMP-01" | "RFC-IMP-02" | "RFC-IMP-03" | "RFC-IMP-04" | "RFC-IMP-05" | "RFC-IMP-06";
+export interface RfcImplementStampViolation {
+    rule: RfcImplementStampRule;
+    message: string;
+}
+export interface RfcImplementStampResult {
+    command: "rfc.implement.stamp";
+    status: "pass" | "fail";
+    data?: RfcImplementStampData;
+    violations: RfcImplementStampViolation[];
+}
+export declare const RFC_DIR = "docs/rfcs";
+export declare const RFC_TEMPLATE_FILE = "os/rfc/rfc-0000-template.md";
+export declare const RFC_ID_PATTERN: RegExp;
+/** Required H2 sections for every RFC. */
+export declare const RFC_FULL_REQUIRED_SECTIONS: readonly ["Context", "Problem", "Decision", "Architectural fit", "Design", "Rollout", "Alternatives considered", "Risks", "Acceptance criteria", "Implementation notes for agents"];
+/** Every frontmatter key the RFC schema sanctions. V-20 warns on anything else. */
+export declare const RFC_KNOWN_KEYS: readonly string[];
+/**
+ * RFC-0330 / RFC-0331 / RFC-0335: shared cutoff date for new metadata rules.
+ * RFCs created on or after this date are subject to V-23 (evidence), V-24 (DNA-trace),
+ * and V-25 (reviewer identity). RFCs created before are exempt.
+ */
+export declare const RFC_METADATA_CUTOFF = "2026-07-07";
+/**
+ * RFC-0478: cutoff date for versionBump enforcement (V-29).
+ * RFCs created on or after this date with status "implemented" must declare
+ * a versionBump field. RFCs created before are exempt.
+ */
+export declare const RFC_VERSION_BUMP_CUTOFF = "2026-07-21";
+//# sourceMappingURL=types.d.ts.map

package/dist/os/rfc/types.d.ts.map

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

package/dist/os/rfc/types.js

@@ -0,0 +1,95 @@
+/***************************************************************
+ * <MODULE_CONTRACT>
+ * <purpose>
+ * Defines types and constants for managing RFC lifecycle,
+ * including statuses, kinds, and scopes, facilitating
+ * structured proposal submissions.
+ * </purpose>
+ *  *  * <non-goals>
+ * <item>Do not implement RFC processing or validation logic here.</item>
+ * <item>Do not handle user input or command execution related to RFCs.</item>
+ * <item>Do not manage the storage or retrieval of RFC documents.</item>
+ * </non-goals>
+ * </MODULE_CONTRACT>
+ *  * <CHANGE_SUMMARY>
+  <item>Tidied by compass.changesummary.tidy; see git history for prior entries.</item>
+  <item>RFC-0465: added specRef field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for PBP spec traceability.</item>
+  <item>RFC-0478: added versionBump field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for platform versioning enforcement.</item>
+  <item>RFC-0480: added breaksC field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for Layer C protection.</item>
+</CHANGE_SUMMARY>
+ ***************************************************************/
+export const RFC_STATUSES = [
+    "draft",
+    "reviewing",
+    "accepted",
+    "implemented",
+    "rejected",
+    "superseded",
+];
+export const RFC_KINDS = [
+    "architecture",
+    "contract",
+    "command",
+    "policy",
+    "deprecation",
+];
+export const RFC_SCOPES = ["app", "workspace"]; // ─── Frontmatter ─────────────────────────────────────────────────────────────
+export const RFC_DIR = "docs/rfcs";
+export const RFC_TEMPLATE_FILE = "os/rfc/rfc-0000-template.md";
+export const RFC_ID_PATTERN = /^RFC-\d{4}$/;
+/** Required H2 sections for every RFC. */
+export const RFC_FULL_REQUIRED_SECTIONS = [
+    "Context",
+    "Problem",
+    "Decision",
+    "Architectural fit",
+    "Design",
+    "Rollout",
+    "Alternatives considered",
+    "Risks",
+    "Acceptance criteria",
+    "Implementation notes for agents",
+];
+/** Every frontmatter key the RFC schema sanctions. V-20 warns on anything else. */
+export const RFC_KNOWN_KEYS = [
+    "id",
+    "title",
+    "status",
+    "kind",
+    "scope",
+    "owners",
+    "reviewers",
+    "createdAt",
+    "updatedAt",
+    "enhancedAt",
+    "implementedAt",
+    "closedAt",
+    "supersedes",
+    "supersededBy",
+    "amends",
+    "amendedBy",
+    "related",
+    "commands",
+    "appsImpacted",
+    "packagesImpacted",
+    "successSignals",
+    "nonGoals",
+    "acceptance",
+    "satisfies",
+    "specRef",
+    "versionBump",
+    "breaksC",
+];
+/**
+ * RFC-0330 / RFC-0331 / RFC-0335: shared cutoff date for new metadata rules.
+ * RFCs created on or after this date are subject to V-23 (evidence), V-24 (DNA-trace),
+ * and V-25 (reviewer identity). RFCs created before are exempt.
+ */
+export const RFC_METADATA_CUTOFF = "2026-07-07";
+/**
+ * RFC-0478: cutoff date for versionBump enforcement (V-29).
+ * RFCs created on or after this date with status "implemented" must declare
+ * a versionBump field. RFCs created before are exempt.
+ */
+export const RFC_VERSION_BUMP_CUTOFF = "2026-07-21";
+//# sourceMappingURL=types.js.map

package/dist/os/rfc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../os/rfc/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;iEAmBiE;AA4BjE,MAAM,CAAC,MAAM,YAAY,GAAyB;IAChD,OAAO;IACP,WAAW;IACX,UAAU;IACV,aAAa;IACb,UAAU;IACV,YAAY;CACJ,CAAC;AAaX,MAAM,CAAC,MAAM,SAAS,GAAuB;IAC3C,cAAc;IACd,UAAU;IACV,SAAS;IACT,QAAQ;IACR,aAAa;CACL,CAAC;AAUX,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,KAAK,EAAE,WAAW,CAAU,CAAC,CAAC,gFAAgF;AAmZ9J,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;AAE5C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,SAAS;IACT,SAAS;IACT,UAAU;IACV,mBAAmB;IACnB,QAAQ;IACR,SAAS;IACT,yBAAyB;IACzB,OAAO;IACP,qBAAqB;IACrB,iCAAiC;CACzB,CAAC;AAEX,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,QAAQ;IACR,WAAW;IACX,WAAW;IACX,WAAW;IACX,YAAY;IACZ,eAAe;IACf,UAAU;IACV,YAAY;IACZ,cAAc;IACd,QAAQ;IACR,WAAW;IACX,SAAS;IACT,UAAU;IACV,cAAc;IACd,kBAAkB;IAClB,gBAAgB;IAChB,UAAU;IACV,YAAY;IACZ,WAAW;IACX,SAAS;IACT,aAAa;IACb,SAAS;CACD,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC"}

package/dist/os/rfc/verification-evidence.d.ts

@@ -0,0 +1,8 @@
+import type { AcceptanceProbe, RfcStatus, VerificationEvidence, VerificationEvidenceProbeRecord, RfcVerificationEmitResult } from "./types.ts";
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../src/types.ts";
+export declare function buildEvidenceEnvelope(rfcId: string, title: string, rfcStatus: RfcStatus, rfcMarkdown: string, probes: AcceptanceProbe[], probeRecords: VerificationEvidenceProbeRecord[], gitContext: {
+    commit: string;
+    workingTreeDirty: boolean;
+}, kernelVersion: string, emittedAt: string): VerificationEvidence;
+export declare function runRfcVerificationEmit(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<RfcVerificationEmitResult>>;
+//# sourceMappingURL=verification-evidence.d.ts.map

package/dist/os/rfc/verification-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-evidence.d.ts","sourceRoot":"","sources":["../../../os/rfc/verification-evidence.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAgD5B,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EAAE,EACzB,YAAY,EAAE,+BAA+B,EAAE,EAC/C,UAAU,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,EACzD,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,oBAAoB,CAetB;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,CAAC,CA0HxD"}