@aperant/framework 0.13.0-next.0 → 0.15.0

package/dist/cli/followups/schema.mjs

@@ -0,0 +1,251 @@
+/**
+ * @internal
+ * followups/schema.mjs — validate the per-task followups.json ledger (G45).
+ *
+ * Pure: takes a parsed JSON document, returns a normalized shape with
+ * structured `schema_errors[]`. Never throws, never touches the filesystem
+ * (mirrors the consistency-parser style).
+ *
+ * Row shape:
+ *   {
+ *     id: string,                                  // free id (e.g. oos-1, rev-rf-3, qa-2, or a voluntary id)
+ *     title: string,
+ *     class_proposed: 'in-pr' | 'new-task' | 'polish',   // a PROPOSAL — adjudication is authority (ID-03)
+ *     origin: 'plan' | 'discuss' | 'execute' | 'verify' | 'review' | 'ci',
+ *     files: string[],
+ *     outcome_refs: string[],                      // 'O<n>' ids validated elsewhere (derive.validateOutcomeRefs)
+ *     status: 'open' | 'fixed' | 'dispositioned',
+ *     adjudication?: {
+ *       verdict: 'load-bearing' | 'deferrable',
+ *       by: 'verify' | 'verify-proof',
+ *       outcome_ref?: string | null               // nullable — refactor-only specs have no outcomes (ID-01)
+ *     },
+ *     disposition?: {
+ *       kind: 'filed_task' | 'executed_commit' | 'parked_note' | 'dropped_by_user',
+ *       ref: string,
+ *       reason?: string                            // required for dropped_by_user (enforced at the CLI seam)
+ *     }
+ *   }
+ *
+ * Output:
+ *   { rows: ValidRow[], schema_errors: [{row_index, id?, field, message}] }
+ *
+ * A row that fails validation is reported in schema_errors and EXCLUDED from
+ * rows[] (so downstream gate logic never reasons over a malformed row).
+ */
+export const CLASS_PROPOSED = new Set(['in-pr', 'new-task', 'polish']);
+export const ORIGINS = new Set(['plan', 'discuss', 'execute', 'verify', 'review', 'ci']);
+export const STATUSES = new Set(['open', 'fixed', 'dispositioned']);
+export const VERDICTS = new Set(['load-bearing', 'deferrable']);
+export const ADJUDICATORS = new Set(['verify', 'verify-proof']);
+export const DISPOSITION_KINDS = new Set([
+    'filed_task',
+    'executed_commit',
+    'parked_note',
+    'dropped_by_user',
+]);
+/**
+ * @typedef {Object} FollowupAdjudication
+ * @property {'load-bearing'|'deferrable'} verdict
+ * @property {'verify'|'verify-proof'} by
+ * @property {string|null} [outcome_ref]
+ *
+ * @typedef {Object} FollowupDisposition
+ * @property {'filed_task'|'executed_commit'|'parked_note'|'dropped_by_user'} kind
+ * @property {string} ref
+ * @property {string} [reason]
+ *
+ * @typedef {Object} FollowupRow
+ * @property {string} id
+ * @property {string} title
+ * @property {'in-pr'|'new-task'|'polish'} class_proposed
+ * @property {'plan'|'discuss'|'execute'|'verify'|'review'|'ci'} origin
+ * @property {string[]} files
+ * @property {string[]} outcome_refs
+ * @property {'open'|'fixed'|'dispositioned'} status
+ * @property {FollowupAdjudication} [adjudication]
+ * @property {FollowupDisposition} [disposition]
+ *
+ * @typedef {Object} ParsedFollowups
+ * @property {FollowupRow[]} rows
+ * @property {Array<{row_index: number, id?: string, field: string, message: string}>} schema_errors
+ *
+ * The selector helpers below read only `status` / `adjudication` /
+ * `disposition`, so they accept a structural row shape (any caller-built row
+ * with those fields fits) and return the same element type they were given.
+ * @typedef {{status?: string, adjudication?: {verdict?: string}, disposition?: {kind?: string, ref?: string}}} SelectorRow
+ */
+/**
+ * @param {unknown} doc  — a parsed followups.json document. Accepts either
+ *   `{ rows: [...] }` or a bare `[...]` array of rows.
+ * @returns {ParsedFollowups}
+ */
+export function parseFollowups(doc) {
+    /** @type {Array<{row_index: number, id?: string, field: string, message: string}>} */
+    const schema_errors = [];
+    /** @type {Array<object>} */
+    const rows = [];
+    const rawRows = extractRows(doc);
+    if (rawRows === null) {
+        schema_errors.push({
+            row_index: -1,
+            field: 'rows',
+            message: 'followups.json must be an array of rows or an object with a `rows` array',
+        });
+        return { rows, schema_errors };
+    }
+    for (let i = 0; i < rawRows.length; i++) {
+        const r = rawRows[i];
+        const errsBefore = schema_errors.length;
+        if (!r || typeof r !== 'object' || Array.isArray(r)) {
+            schema_errors.push({ row_index: i, field: 'row', message: 'row must be an object' });
+            continue;
+        }
+        const id = typeof r.id === 'string' && r.id.trim().length > 0 ? r.id : undefined;
+        const push = (field, message) => schema_errors.push({ row_index: i, id, field, message });
+        if (!id)
+            push('id', 'missing or empty `id`');
+        if (typeof r.title !== 'string' || r.title.trim().length === 0)
+            push('title', 'missing or empty `title`');
+        if (!CLASS_PROPOSED.has(r.class_proposed))
+            push('class_proposed', `must be one of: ${[...CLASS_PROPOSED].join(', ')}`);
+        if (!ORIGINS.has(r.origin))
+            push('origin', `must be one of: ${[...ORIGINS].join(', ')}`);
+        if (!STATUSES.has(r.status))
+            push('status', `must be one of: ${[...STATUSES].join(', ')}`);
+        if (r.files !== undefined && !isStringArray(r.files))
+            push('files', 'must be a string array');
+        if (r.outcome_refs !== undefined && !isStringArray(r.outcome_refs))
+            push('outcome_refs', 'must be a string array of O<n> ids');
+        if (r.adjudication !== undefined) {
+            const a = r.adjudication;
+            if (!a || typeof a !== 'object' || Array.isArray(a)) {
+                push('adjudication', 'must be an object when present');
+            }
+            else {
+                if (!VERDICTS.has(a.verdict))
+                    push('adjudication.verdict', `must be one of: ${[...VERDICTS].join(', ')}`);
+                if (!ADJUDICATORS.has(a.by))
+                    push('adjudication.by', `must be one of: ${[...ADJUDICATORS].join(', ')}`);
+                if (a.outcome_ref !== undefined &&
+                    a.outcome_ref !== null &&
+                    typeof a.outcome_ref !== 'string')
+                    push('adjudication.outcome_ref', 'must be a string, null, or omitted');
+            }
+        }
+        if (r.disposition !== undefined) {
+            const d = r.disposition;
+            if (!d || typeof d !== 'object' || Array.isArray(d)) {
+                push('disposition', 'must be an object when present');
+            }
+            else {
+                if (!DISPOSITION_KINDS.has(d.kind))
+                    push('disposition.kind', `must be one of: ${[...DISPOSITION_KINDS].join(', ')}`);
+                if (typeof d.ref !== 'string' || d.ref.trim().length === 0)
+                    push('disposition.ref', 'missing or empty `ref`');
+            }
+        }
+        if (schema_errors.length === errsBefore) {
+            rows.push({
+                id,
+                title: r.title,
+                class_proposed: r.class_proposed,
+                origin: r.origin,
+                files: Array.isArray(r.files) ? r.files : [],
+                outcome_refs: Array.isArray(r.outcome_refs) ? r.outcome_refs : [],
+                status: r.status,
+                ...(r.adjudication !== undefined
+                    ? { adjudication: normalizeAdjudication(r.adjudication) }
+                    : {}),
+                ...(r.disposition !== undefined
+                    ? { disposition: normalizeDisposition(r.disposition) }
+                    : {}),
+            });
+        }
+    }
+    return { rows, schema_errors };
+}
+/**
+ * Rows that block `task close`: any `open` row, or any `dispositioned` row
+ * without a valid `disposition.kind` + `ref`. (A `fixed` row is settled.)
+ *
+ * @template {SelectorRow} T
+ * @param {{rows: T[]}} parsed
+ * @returns {T[]}
+ */
+export function listBlockingRowsForClose(parsed) {
+    const rows = parsed && Array.isArray(parsed.rows) ? parsed.rows : [];
+    return rows.filter((r) => {
+        if (r.status === 'open')
+            return true;
+        if (r.status === 'dispositioned') {
+            const d = r.disposition;
+            return (!d ||
+                !DISPOSITION_KINDS.has(d.kind) ||
+                typeof d.ref !== 'string' ||
+                d.ref.trim().length === 0);
+        }
+        return false;
+    });
+}
+/**
+ * Open rows that have no `adjudication` (ship-gate input).
+ *
+ * @template {SelectorRow} T
+ * @param {{rows: T[]}} parsed
+ * @returns {T[]}
+ */
+export function listUnadjudicatedOpen(parsed) {
+    const rows = parsed && Array.isArray(parsed.rows) ? parsed.rows : [];
+    return rows.filter((r) => r.status === 'open' && !r.adjudication);
+}
+/**
+ * Load-bearing rows that are not yet fixed (ship-gate input).
+ *
+ * @template {SelectorRow} T
+ * @param {{rows: T[]}} parsed
+ * @returns {T[]}
+ */
+export function listLoadBearingUnfixed(parsed) {
+    const rows = parsed && Array.isArray(parsed.rows) ? parsed.rows : [];
+    return rows.filter((r) => r.adjudication && r.adjudication.verdict === 'load-bearing' && r.status !== 'fixed');
+}
+/**
+ * Rows whose `status === 'dispositioned'` lack a valid disposition record.
+ *
+ * @template {SelectorRow} T
+ * @param {{rows: T[]}} parsed
+ * @returns {T[]}
+ */
+export function listUndispositioned(parsed) {
+    const rows = parsed && Array.isArray(parsed.rows) ? parsed.rows : [];
+    return rows.filter((r) => {
+        if (r.status !== 'dispositioned')
+            return false;
+        const d = r.disposition;
+        return (!d || !DISPOSITION_KINDS.has(d.kind) || typeof d.ref !== 'string' || d.ref.trim().length === 0);
+    });
+}
+function extractRows(doc) {
+    if (Array.isArray(doc))
+        return doc;
+    if (doc && typeof doc === 'object' && Array.isArray(doc.rows))
+        return doc.rows;
+    return null;
+}
+function isStringArray(v) {
+    return Array.isArray(v) && v.every((x) => typeof x === 'string');
+}
+function normalizeAdjudication(a) {
+    const out = { verdict: a.verdict, by: a.by };
+    if (a.outcome_ref !== undefined)
+        out.outcome_ref = a.outcome_ref;
+    return out;
+}
+function normalizeDisposition(d) {
+    const out = { kind: d.kind, ref: d.ref };
+    if (typeof d.reason === 'string')
+        out.reason = d.reason;
+    return out;
+}
+//# sourceMappingURL=schema.mjs.map

package/dist/cli/followups/schema.mjs.map

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

package/dist/cli/gate/context.d.mts

@@ -7,7 +7,7 @@
  */
 export function buildGateContext(projectRoot: any, taskId: any): {
     projectRoot: string;
-    sharedRoot: any;
+    sharedRoot: string;
     taskId: string;
     taskDir: string;
     taskRecord: any;

package/dist/cli/gate/gates/followups-adjudicated.d.mts

@@ -0,0 +1,69 @@
+export default gate;
+declare namespace gate {
+    let id: string;
+    let description: string;
+    let severity: string;
+    let skills: string[];
+    function applies_to_profile(ctx: any): boolean;
+    function check(ctx: any): Promise<{
+        status: string;
+        reason: string;
+        inputs: string[];
+        evidence?: undefined;
+    } | {
+        status: string;
+        reason: string;
+        evidence: {
+            out_of_scope_bullets: string[];
+            missing_expected?: undefined;
+            unadjudicated_open?: undefined;
+            load_bearing_unfixed?: undefined;
+        };
+        inputs: string[];
+    } | {
+        status: string;
+        reason: string;
+        evidence: {
+            missing_expected: {
+                id: string;
+                title: string;
+                origin: string;
+            }[];
+            out_of_scope_bullets?: undefined;
+            unadjudicated_open?: undefined;
+            load_bearing_unfixed?: undefined;
+        };
+        inputs: string[];
+    } | {
+        status: string;
+        reason: string;
+        evidence: {
+            unadjudicated_open: {
+                id: any;
+                title: any;
+                status: any;
+                verdict: any;
+            }[];
+            out_of_scope_bullets?: undefined;
+            missing_expected?: undefined;
+            load_bearing_unfixed?: undefined;
+        };
+        inputs: string[];
+    } | {
+        status: string;
+        reason: string;
+        evidence: {
+            load_bearing_unfixed: {
+                id: any;
+                title: any;
+                status: any;
+                verdict: any;
+            }[];
+            out_of_scope_bullets?: undefined;
+            missing_expected?: undefined;
+            unadjudicated_open?: undefined;
+        };
+        inputs: string[];
+    }>;
+}
+//# sourceMappingURL=followups-adjudicated.d.mts.map

package/dist/cli/gate/gates/followups-adjudicated.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"followups-adjudicated.d.mts","sourceRoot":"","sources":["../../../../src/cli/gate/gates/followups-adjudicated.mjs"],"names":[],"mappings":";;;;;;IAuDqB,+CAAwC;IAC5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiGC"}

package/dist/cli/gate/gates/followups-adjudicated.mjs

@@ -0,0 +1,141 @@
+/**
+ * @internal
+ * G45 followups-adjudicated — blocking gate for `apt:ship` (full-pipeline only).
+ *
+ * The deterministic part the deferring agent can't talk past: shipping is
+ * blocked until every open follow-up row carries an adjudication and every
+ * load-bearing row is fixed. The ledger derivation also forces adoption —
+ * a spec.md with `## Out of Scope` bullets but no followups.json fails.
+ *
+ * Fails when:
+ *   (a) spec.md has Out of Scope bullets but followups.json is absent
+ *       (adoption forcing function),
+ *   (b) the derived expected universe has rows missing from the ledger,
+ *   (c) any `status: 'open'` row lacks `adjudication`,
+ *   (d) any `verdict: 'load-bearing'` row has `status !== 'fixed'`.
+ *
+ * Skips when:
+ *   - spec.md is absent, OR
+ *   - there are no expected candidates AND no ledger.
+ *
+ * Fast Path Guarantee (ID-12): `applies_to_profile` gates this to
+ * full-pipeline (QUICK/DEBUG → lite → skip). The exemption is regression-
+ * locked by followups-quick-exempt.test.ts (ST7).
+ *
+ * Bypass: only the existing audited `--force --reason` (G42 Phase 1 pattern).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseOutOfScope } from '../../consistency/parse-spec.mjs';
+import { computeMissingExpected, deriveExpectedCandidates } from '../../followups/derive.mjs';
+import { listLoadBearingUnfixed, listUnadjudicatedOpen, parseFollowups, } from '../../followups/schema.mjs';
+import { readJsonIfExists } from '../../util/io.mjs';
+import { registerGate } from '../registry.mjs';
+function rowSummary(r) {
+    return {
+        id: r.id,
+        title: r.title ?? null,
+        status: r.status ?? null,
+        verdict: r.adjudication?.verdict ?? null,
+    };
+}
+const gate = {
+    id: 'followups-adjudicated',
+    description: 'followups.json covers every derived candidate, every open row is adjudicated, and every load-bearing row is fixed (skipped if spec.md absent or no candidates + no ledger)',
+    severity: 'blocking',
+    skills: ['ship'],
+    applies_to_profile: (ctx) => ctx.profile === 'full-pipeline',
+    async check(ctx) {
+        const specPath = join(ctx.taskDir, 'spec.md');
+        const followupsPath = join(ctx.taskDir, 'followups.json');
+        const reviewPath = join(ctx.taskDir, 'review.json');
+        const qaPath = join(ctx.taskDir, 'qa_signoff.json');
+        const inputs = [specPath, followupsPath, reviewPath, qaPath];
+        if (!existsSync(specPath)) {
+            return {
+                status: 'skip',
+                reason: 'spec.md not present — skipping followups-adjudicated',
+                inputs,
+            };
+        }
+        let specContent;
+        try {
+            specContent = readFileSync(specPath, 'utf-8');
+        }
+        catch (err) {
+            // existsSync passed but the read failed (TOCTOU race, permission
+            // error). Return a structured fail like the sibling gates
+            // (review-clean, verify-approved) rather than throwing out of the
+            // gate runner — important in the concurrent-worktree environment.
+            return {
+                status: 'fail',
+                reason: `spec.md could not be read: ${err.message}`,
+                inputs,
+            };
+        }
+        const oosBullets = parseOutOfScope(specContent);
+        const review = readJsonIfExists(reviewPath);
+        const qa = readJsonIfExists(qaPath);
+        const candidates = deriveExpectedCandidates({ specContent, review, qa });
+        const ledgerDoc = readJsonIfExists(followupsPath);
+        const ledgerPresent = ledgerDoc !== null;
+        // Skip when there is nothing to track and no ledger to validate.
+        if (candidates.length === 0 && !ledgerPresent) {
+            return {
+                status: 'skip',
+                reason: 'no expected follow-up candidates and no ledger — nothing to adjudicate',
+                inputs,
+            };
+        }
+        // (a) Out of Scope bullets exist but no ledger — adoption forcing function.
+        if (oosBullets.length > 0 && !ledgerPresent) {
+            return {
+                status: 'fail',
+                reason: `spec.md has ${oosBullets.length} Out of Scope bullet(s) but followups.json is absent — run \`apt-tools followups check\` and seed the ledger`,
+                evidence: { out_of_scope_bullets: oosBullets.map((b) => b.text) },
+                inputs,
+            };
+        }
+        const parsed = parseFollowups(ledgerDoc ?? { rows: [] });
+        // (b) Missing expected rows.
+        const missing = computeMissingExpected(candidates, parsed.rows);
+        if (missing.length > 0) {
+            return {
+                status: 'fail',
+                reason: `${missing.length} expected follow-up row(s) missing from followups.json`,
+                evidence: {
+                    missing_expected: missing.map((m) => ({ id: m.id, title: m.title, origin: m.origin })),
+                },
+                inputs,
+            };
+        }
+        // (c) Open rows lacking adjudication.
+        const unadjudicated = listUnadjudicatedOpen(parsed);
+        if (unadjudicated.length > 0) {
+            return {
+                status: 'fail',
+                reason: `${unadjudicated.length} open follow-up row(s) lack adjudication`,
+                evidence: { unadjudicated_open: unadjudicated.map(rowSummary) },
+                inputs,
+            };
+        }
+        // (d) Load-bearing rows not fixed.
+        const loadBearing = listLoadBearingUnfixed(parsed);
+        if (loadBearing.length > 0) {
+            return {
+                status: 'fail',
+                reason: `${loadBearing.length} load-bearing follow-up row(s) not fixed`,
+                evidence: { load_bearing_unfixed: loadBearing.map(rowSummary) },
+                inputs,
+            };
+        }
+        return {
+            status: 'pass',
+            reason: `followups.json adjudicated (${parsed.rows.length} row(s), ${candidates.length} expected candidate(s))`,
+            inputs,
+        };
+    },
+};
+registerGate(gate);
+export default gate;
+//# sourceMappingURL=followups-adjudicated.mjs.map

package/dist/cli/gate/gates/followups-adjudicated.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"followups-adjudicated.mjs","sourceRoot":"","sources":["../../../../src/cli/gate/gates/followups-adjudicated.mjs"],"names":[],"mappings":"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"}

package/dist/cli/gate/gates/index.mjs

@@ -15,6 +15,7 @@ import './plan-exists.mjs';
 import './all-subtasks-complete.mjs';
 import './verify-approved.mjs';
 import './review-clean.mjs';
+import './followups-adjudicated.mjs';
 import './gitignore-in-sync.mjs';
 import './consistency-check.mjs';
 import './tdd-iron-law.mjs';

package/dist/cli/gate/gates/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/cli/gate/gates/index.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,yBAAyB,CAAA;AAChC,OAAO,6BAA6B,CAAA;AACpC,OAAO,mBAAmB,CAAA;AAC1B,OAAO,6BAA6B,CAAA;AACpC,OAAO,uBAAuB,CAAA;AAC9B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,yBAAyB,CAAA;AAChC,OAAO,yBAAyB,CAAA;AAChC,OAAO,oBAAoB,CAAA;AAC3B,OAAO,2BAA2B,CAAA"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/cli/gate/gates/index.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,yBAAyB,CAAA;AAChC,OAAO,6BAA6B,CAAA;AACpC,OAAO,mBAAmB,CAAA;AAC1B,OAAO,6BAA6B,CAAA;AACpC,OAAO,uBAAuB,CAAA;AAC9B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,6BAA6B,CAAA;AACpC,OAAO,yBAAyB,CAAA;AAChC,OAAO,yBAAyB,CAAA;AAChC,OAAO,oBAAoB,CAAA;AAC3B,OAAO,2BAA2B,CAAA"}

package/dist/cli/git/materialize-env.d.mts

@@ -0,0 +1,39 @@
+/**
+ * Reject a rel_path that is absolute or escapes the worktree root BEFORE any
+ * write (the traversal guard, mirroring the core `assertPathContained` choke
+ * point). Returns the resolved absolute target, or null when unsafe.
+ *
+ * Exported so the security-sensitive guard can be unit-tested directly: the
+ * libSQL-backed `materializeProjectEnvCli` can only no-op in environments where
+ * `@libsql/client` is unresolvable (the framework test runner), so the pure
+ * guard is the testable load-bearing surface.
+ */
+export function resolveContainedTarget(worktreePath: any, relPath: any): string | null;
+/**
+ * Resolve the libSQL `projects.id` for a given project root path. The desktop /
+ * self-hosted app keys `project_env` rows by the project's stored id, NOT its
+ * path; the framework CLI only knows the path, so we match it against the
+ * `projects.path` column. Returns null when the project is unknown to libSQL
+ * (e.g. a fresh repo never opened in the app) — the caller treats that as
+ * "no env to materialize", never an error.
+ */
+export function resolveProjectIdFromPath(client: any, projectPath: any): Promise<string | null>;
+/**
+ * Materialize the project's stored env blobs verbatim into a worktree.
+ *
+ * @param worktreePath  absolute path of the target worktree
+ * @param projectPath   absolute path of the main project root (used to resolve
+ *                      the libSQL project id via `projects.path`)
+ * @param explicitProjectId optional override when the caller already knows the id
+ * @returns { materialized, rejected, errored } counts — never throws.
+ */
+export function materializeProjectEnvCli(worktreePath: any, projectPath: any, explicitProjectId: any): materialized;
+/**
+ * Detect drift for an already-materialized worktree (ID-07): compare each
+ * stored blob's fingerprint against the on-disk file. Returns per-file verdicts;
+ * `sync-env` simply re-runs `materializeProjectEnvCli` to overwrite.
+ *
+ * @returns { hasDrift, files: [{ relPath, status }] } — never throws.
+ */
+export function detectEnvDriftCli(worktreePath: any, projectPath: any, explicitProjectId: any): hasDrift;
+//# sourceMappingURL=materialize-env.d.mts.map

package/dist/cli/git/materialize-env.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-env.d.mts","sourceRoot":"","sources":["../../../src/cli/git/materialize-env.mjs"],"names":[],"mappings":"AAsCA;;;;;;;;;GASG;AACH,uFAMC;AAyBD;;;;;;;GAOG;AACH,gGAcC;AAoCD;;;;;;;;GAQG;AACH,uGAFc,YAAY,CA8BzB;AAED;;;;;;GAMG;AACH,gGAFc,QAAQ,CA8BrB"}