@cat-factory/kernel 0.328.0 → 0.329.0

package/dist/domain/monorepo-adoption.logic.d.ts

@@ -0,0 +1,87 @@
+import { type AdoptionArea, type AdoptionChoice, type AdoptionDecision, type AdoptionPlan, type AdoptionSource, type AdoptionSurvey, type ResolvedAdoption } from '@cat-factory/contracts';
+/** Cap on how many decisions one plan may carry, so a runaway reply can't produce a wall of them. */
+export declare const MAX_ADOPTION_DECISIONS = 24;
+/**
+ * One convention area, in the words the review UI and the agent brief both use.
+ *
+ * The `default` is unreachable while the type is honoured, which is the point: adding a member
+ * fails the build here, and a member RETIRED after a plan was stored still renders honestly
+ * instead of splicing `undefined` into the sentence a human is deciding from.
+ */
+export declare function describeAdoptionArea(area: AdoptionArea): string;
+/** One side of the decision, as an instruction an agent can act on without further inference. */
+export declare function describeAdoptionSource(source: AdoptionSource): string;
+/** Whether a stored string is an area THIS build defines, narrowed from the schema's own options. */
+export declare function isAdoptionArea(value: unknown): value is AdoptionArea;
+/** Whether a stored string is a choice THIS build defines, narrowed from the schema's own options. */
+export declare function isAdoptionSource(value: unknown): value is AdoptionSource;
+/** What {@link parseAdoptionDecisions} produced, plus what it refused to carry through. */
+export interface ParsedAdoptionDecisions {
+    decisions: AdoptionDecision[];
+    /** One line per dropped recommendation, naming it and why. Rendered to the reviewer. */
+    dropped: string[];
+}
+/**
+ * Read a model's raw reply into the stored decision list, keeping only what it can support.
+ *
+ * The model is asked for `{ decisions: [...] }`; anything else is not a plan. Each decision has
+ * to survive three checks, and each one is a way the review would otherwise mislead:
+ *
+ *  - a duplicate or missing `id` makes the human's answer unaddressable, so the line is dropped;
+ *  - an area or recommendation outside the CURRENT vocabulary cannot be rendered or acted on;
+ *  - evidence that names no path the survey actually read means the claim about the monorepo
+ *    has nothing behind it. The line is dropped rather than shown unmarked, because a reviewer
+ *    reads an unmarked line as something the platform checked.
+ *
+ * Every drop is REPORTED, never silent: a plan that lost half its lines to invention looks
+ * exactly like a monorepo with few conventions, and those need opposite reactions.
+ */
+export declare function parseAdoptionDecisions(raw: unknown, survey: AdoptionSurvey): ParsedAdoptionDecisions;
+/**
+ * Settle a human review against the plan it answers, or throw the refusal naming what is wrong.
+ *
+ * Refuses rather than repairs, on both sides of the mismatch. An UNANSWERED decision cannot be
+ * defaulted to the recommendation without erasing the difference between agreeing with it and
+ * never having read it, which is the single fact this whole step exists to record. An answer
+ * naming a decision the plan does not have means the reviewer was looking at a different plan
+ * (a stale tab, a re-run survey), and applying the rest of it would build under a review that
+ * was never given for this proposal.
+ */
+export declare function resolveAdoptionReview(plan: AdoptionPlan, choices: readonly AdoptionChoice[], context: {
+    reviewedByUserId: string | null;
+    reviewedAt: number;
+    notes?: string | undefined;
+}): ResolvedAdoption;
+/**
+ * Render the settled review as the adoption section of the apply phase's brief.
+ *
+ * Every decision is stated as a SIDE plus the reviewer's own words where they left any, and the
+ * overrides are called out: an agent told only "use the monorepo's test runner" cannot tell a
+ * default it may reason around from a human who deliberately overruled the recommendation, and
+ * the second is not negotiable. The list is exhaustive on purpose: an area the reviewer settled
+ * and the brief omits is an area the agent decides again, unreviewed.
+ *
+ * The holes are VERBATIM here. {@link renderAdoptionPrSection} is the rendering for the pull
+ * request; do not send this one to a host.
+ */
+export declare function renderAdoptionBrief(resolved: ResolvedAdoption, directory: string): string;
+/**
+ * Render the settled review for the PULL REQUEST the apply phase opens.
+ *
+ * The same list, addressed to the human reviewing the change rather than to the agent making it:
+ * what a reviewer of a bootstrap PR is being asked is whether the service fits the monorepo, and
+ * what settles that is which side each area came from and who chose it, which the diff cannot
+ * show. Every hole crosses {@link HOST_SINK}, because both the titles (model-authored) and the
+ * notes (reviewer-authored) are untrusted text landing on a parsed surface. The caller scrubs
+ * secrets at compose time, before any of this is capped.
+ */
+export declare function renderAdoptionPrSection(resolved: ResolvedAdoption, directory: string): string;
+/**
+ * The default branch name for a monorepo bootstrap's pull request.
+ *
+ * Derived from the run's own id rather than the service name so two bootstraps of similarly
+ * named services can never collide on one branch, and stable per run so a retry of the SAME run
+ * resumes its branch instead of opening a second pull request against the monorepo.
+ */
+export declare function monorepoBootstrapBranch(jobId: string): string;
+//# sourceMappingURL=monorepo-adoption.logic.d.ts.map

package/dist/domain/monorepo-adoption.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo-adoption.logic.d.ts","sourceRoot":"","sources":["../../src/domain/monorepo-adoption.logic.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAEtB,MAAM,wBAAwB,CAAA;AAsB/B,qGAAqG;AACrG,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAcxC;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA6B/D;AAOD,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAarE;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAIpE;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAIxE;AAED,2FAA2F;AAC3F,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,gBAAgB,EAAE,CAAA;IAC7B,wFAAwF;IACxF,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAmBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,cAAc,GACrB,uBAAuB,CAiEzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC3F,gBAAgB,CA+ClB;AA8DD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAe7F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/domain/monorepo-adoption.logic.js

@@ -0,0 +1,323 @@
+import { adoptionAreaSchema, adoptionSourceSchema, MAX_ADOPTION_DROP_LINES, } from '@cat-factory/contracts';
+import * as hostMarkdown from '../shared/host-markdown.logic.js';
+import { ValidationError } from './errors.js';
+// ---------------------------------------------------------------------------
+// The rules over a monorepo bootstrap's adoption plan: reading a model's proposal into the
+// stored shape, settling a human review against it, and rendering the settled result as the
+// brief the apply phase's agent works from.
+//
+// Pure (no repository, no model, no clock beyond what is passed), because every one of these
+// is a place the flow can silently become useless, and the failure modes are only visible when
+// they can be driven directly:
+//
+//   - a recommendation whose EVIDENCE names nothing the survey read is the model asserting a
+//     monorepo convention it invented, and it is the one claim a reviewer cannot check by eye;
+//   - a review that leaves a decision unanswered must be REFUSED, not defaulted onto the
+//     recommendation, because "I agree" and "I did not look" are exactly what this step exists
+//     to tell apart;
+//   - a settled decision must reach the agent's brief in words that name a SIDE, since
+//     "adopt from the monorepo" and "keep the template's" are the whole deliverable.
+// ---------------------------------------------------------------------------
+/** Cap on how many decisions one plan may carry, so a runaway reply can't produce a wall of them. */
+export const MAX_ADOPTION_DECISIONS = 24;
+/**
+ * A stored area this build no longer defines, named as the retired value it is.
+ *
+ * Deliberately NOT mapped onto a current member: nothing here knows which one was meant, and a
+ * plan is PERSISTED, so a run parked before a vocabulary change is read back by exactly the
+ * surface whose job is to tell a human what they are approving. Guessing would put a wrong
+ * label on a decision that changes what gets built.
+ */
+function describeRetiredArea(area) {
+    return `'${String(area)}' (an area this deployment no longer defines; re-run the survey)`;
+}
+/**
+ * One convention area, in the words the review UI and the agent brief both use.
+ *
+ * The `default` is unreachable while the type is honoured, which is the point: adding a member
+ * fails the build here, and a member RETIRED after a plan was stored still renders honestly
+ * instead of splicing `undefined` into the sentence a human is deciding from.
+ */
+export function describeAdoptionArea(area) {
+    switch (area) {
+        case 'build-tooling':
+            return 'build tooling';
+        case 'dependencies':
+            return 'dependency versions and package management';
+        case 'lint-format':
+            return 'linting and formatting';
+        case 'typecheck':
+            return 'type checking';
+        case 'testing':
+            return 'test runner and test layout';
+        case 'ci':
+            return 'CI pipelines';
+        case 'containerization':
+            return 'containerization and image build';
+        case 'runtime-config':
+            return 'runtime configuration and secrets';
+        case 'observability':
+            return 'logging, metrics and tracing';
+        case 'source-layout':
+            return 'source layout and module structure';
+        case 'docs':
+            return 'documentation';
+        case 'other':
+            return 'other conventions';
+        default:
+            return describeRetiredArea(area);
+    }
+}
+/** A stored side this build no longer defines. Same rule, same reason, as {@link describeRetiredArea}. */
+function describeRetiredSource(source) {
+    return `'${String(source)}' (a choice this deployment no longer defines; re-run the survey)`;
+}
+/** One side of the decision, as an instruction an agent can act on without further inference. */
+export function describeAdoptionSource(source) {
+    switch (source) {
+        case 'monorepo':
+            return "adopt the monorepo's existing convention and drop the template's";
+        case 'template':
+            return "keep the reference template's version as-is";
+        case 'both':
+            return "compose the two: build on the monorepo's shared setup and layer the template's addition on top";
+        case 'neither':
+            return 'take neither: leave this out of the new service entirely';
+        default:
+            return describeRetiredSource(source);
+    }
+}
+/** Whether a stored string is an area THIS build defines, narrowed from the schema's own options. */
+export function isAdoptionArea(value) {
+    return (typeof value === 'string' && adoptionAreaSchema.options.includes(value));
+}
+/** Whether a stored string is a choice THIS build defines, narrowed from the schema's own options. */
+export function isAdoptionSource(value) {
+    return (typeof value === 'string' && adoptionSourceSchema.options.includes(value));
+}
+/** Every path the survey managed to read, in the prefixed form a decision's evidence uses. */
+function surveyedPaths(survey) {
+    return new Set([
+        ...survey.monorepoPaths.map((path) => `monorepo:${path}`),
+        ...survey.templatePaths.map((path) => `template:${path}`),
+    ]);
+}
+function asString(value, max) {
+    return typeof value === 'string' ? value.trim().slice(0, max) : '';
+}
+function asNullableString(value, max) {
+    const text = asString(value, max);
+    return text.length > 0 ? text : null;
+}
+/**
+ * Read a model's raw reply into the stored decision list, keeping only what it can support.
+ *
+ * The model is asked for `{ decisions: [...] }`; anything else is not a plan. Each decision has
+ * to survive three checks, and each one is a way the review would otherwise mislead:
+ *
+ *  - a duplicate or missing `id` makes the human's answer unaddressable, so the line is dropped;
+ *  - an area or recommendation outside the CURRENT vocabulary cannot be rendered or acted on;
+ *  - evidence that names no path the survey actually read means the claim about the monorepo
+ *    has nothing behind it. The line is dropped rather than shown unmarked, because a reviewer
+ *    reads an unmarked line as something the platform checked.
+ *
+ * Every drop is REPORTED, never silent: a plan that lost half its lines to invention looks
+ * exactly like a monorepo with few conventions, and those need opposite reactions.
+ */
+export function parseAdoptionDecisions(raw, survey) {
+    const dropped = [];
+    let unreported = 0;
+    /** Record a drop, or count it once the report is full (contracts' `MAX_ADOPTION_DROP_LINES`). */
+    const drop = (line) => {
+        if (dropped.length < MAX_ADOPTION_DROP_LINES)
+            dropped.push(line);
+        else
+            unreported += 1;
+    };
+    const container = raw;
+    const list = Array.isArray(container?.decisions) ? container.decisions : null;
+    if (!list)
+        return { decisions: [], dropped: ['the reply carried no `decisions` array'] };
+    const known = surveyedPaths(survey);
+    const decisions = [];
+    const seen = new Set();
+    for (const entry of list) {
+        if (decisions.length >= MAX_ADOPTION_DECISIONS) {
+            drop(`the reply proposed more than ${MAX_ADOPTION_DECISIONS} decisions; the rest were not read`);
+            break;
+        }
+        const item = entry;
+        if (!item || typeof item !== 'object')
+            continue;
+        const id = asString(item.id, 80);
+        const title = asString(item.title, 200);
+        if (!id || !title) {
+            drop(`a proposed decision had no id or title (${id || title || 'unnamed'})`);
+            continue;
+        }
+        if (seen.has(id)) {
+            drop(`'${id}' was proposed twice; only the first was kept`);
+            continue;
+        }
+        if (!isAdoptionArea(item.area)) {
+            drop(`'${title}' named an area this deployment does not define`);
+            continue;
+        }
+        if (!isAdoptionSource(item.recommended)) {
+            drop(`'${title}' recommended a choice this deployment does not define`);
+            continue;
+        }
+        const evidence = Array.isArray(item.evidence)
+            ? item.evidence.filter((path) => typeof path === 'string' && known.has(path))
+            : [];
+        if (evidence.length === 0) {
+            drop(`'${title}' cited no file the survey actually read, so it was not carried through`);
+            continue;
+        }
+        seen.add(id);
+        decisions.push({
+            id,
+            area: item.area,
+            title,
+            monorepoPractice: asNullableString(item.monorepoPractice, 600),
+            templatePractice: asNullableString(item.templatePractice, 600),
+            recommended: item.recommended,
+            rationale: asString(item.rationale, 600),
+            evidence,
+        });
+    }
+    if (unreported > 0) {
+        dropped.push(`and ${unreported} further proposals were dropped for the same kinds of reason`);
+    }
+    return { decisions, dropped };
+}
+/**
+ * Settle a human review against the plan it answers, or throw the refusal naming what is wrong.
+ *
+ * Refuses rather than repairs, on both sides of the mismatch. An UNANSWERED decision cannot be
+ * defaulted to the recommendation without erasing the difference between agreeing with it and
+ * never having read it, which is the single fact this whole step exists to record. An answer
+ * naming a decision the plan does not have means the reviewer was looking at a different plan
+ * (a stale tab, a re-run survey), and applying the rest of it would build under a review that
+ * was never given for this proposal.
+ */
+export function resolveAdoptionReview(plan, choices, context) {
+    // Deliberately NOT gated on `plan.status === 'ready'`. An `unavailable` plan carries no
+    // decisions, so settling it answers nothing, but it is still the human's decision to make, and
+    // refusing it strands the run: the review is the ONLY exit from the park, and a retry re-enters
+    // the same phase. A deployment with no adoption model would then be unable to bootstrap into a
+    // monorepo at all, which is the opposite of the "they just make it unaided" this flow promises.
+    // The two checks below are what keep that safe: nothing to answer means nothing may be
+    // answered, so a review aimed at a plan that has since been re-surveyed is still refused whole.
+    const byId = new Map(choices.map((choice) => [choice.id, choice]));
+    const unknown = choices.filter((choice) => !plan.decisions.some((d) => d.id === choice.id));
+    if (unknown.length > 0) {
+        throw new ValidationError(`The review answers decisions this plan does not contain: ${unknown
+            .map((choice) => `'${choice.id}'`)
+            .join(', ')}. Reload the plan and review it again.`, { reason: 'adoption_choice_unknown', ids: unknown.map((choice) => choice.id) });
+    }
+    const missing = plan.decisions.filter((decision) => !byId.has(decision.id));
+    if (missing.length > 0) {
+        throw new ValidationError(`Every adoption decision must be answered; ${missing.length} ${missing.length === 1 ? 'is' : 'are'} still open: ${missing.map((decision) => `'${decision.title}'`).join(', ')}.`, { reason: 'adoption_review_incomplete', ids: missing.map((decision) => decision.id) });
+    }
+    const decisions = plan.decisions.map((decision) => {
+        // Total by construction: `missing` above already refused any decision with no answer.
+        const choice = byId.get(decision.id);
+        return {
+            id: decision.id,
+            area: decision.area,
+            title: decision.title,
+            choice: choice.choice,
+            overrodeRecommendation: choice.choice !== decision.recommended,
+            note: choice.note?.trim() ? choice.note.trim() : null,
+        };
+    });
+    const notes = context.notes?.trim();
+    return {
+        decisions,
+        notes: notes ? notes : null,
+        reviewedByUserId: context.reviewedByUserId,
+        reviewedAt: context.reviewedAt,
+    };
+}
+/** The prompt sink: verbatim, because the reader is a model and the text is its instruction. */
+const AGENT_SINK = { inline: (value) => value, prose: (value) => value };
+/** The host sink: every auto-link trigger neutralised, every hole capped and fence-balanced. */
+const HOST_SINK = {
+    inline: (value) => hostMarkdown.inline(value),
+    prose: (value) => hostMarkdown.prose(value),
+};
+/** The shared body of both renderings; only the holes differ (see {@link AdoptionTextSink}). */
+function renderAdoptionDecisions(resolved, sink, lead) {
+    const lines = [
+        `## Adoption decisions (settled by a human reviewer; follow them exactly)`,
+        '',
+        lead,
+        '',
+    ];
+    if (resolved.decisions.length === 0) {
+        lines.push('_The reviewer settled no areas: follow the surrounding monorepo wherever it has an ' +
+            'established convention, and the template only where it does not._', '');
+    }
+    for (const decision of resolved.decisions) {
+        const override = decision.overrodeRecommendation ? ' (reviewer overrode the suggestion)' : '';
+        lines.push(`- **${sink.inline(decision.title)}** (${describeAdoptionArea(decision.area)}): ` +
+            `${describeAdoptionSource(decision.choice)}${override}.` +
+            (decision.note ? `\n  Reviewer's note: ${sink.inline(decision.note)}` : ''));
+    }
+    if (resolved.notes) {
+        lines.push('', '### Reviewer notes for the service as a whole', '', sink.prose(resolved.notes));
+    }
+    return lines.join('\n');
+}
+/**
+ * Render the settled review as the adoption section of the apply phase's brief.
+ *
+ * Every decision is stated as a SIDE plus the reviewer's own words where they left any, and the
+ * overrides are called out: an agent told only "use the monorepo's test runner" cannot tell a
+ * default it may reason around from a human who deliberately overruled the recommendation, and
+ * the second is not negotiable. The list is exhaustive on purpose: an area the reviewer settled
+ * and the brief omits is an area the agent decides again, unreviewed.
+ *
+ * The holes are VERBATIM here. {@link renderAdoptionPrSection} is the rendering for the pull
+ * request; do not send this one to a host.
+ */
+export function renderAdoptionBrief(resolved, directory) {
+    return renderAdoptionDecisions(resolved, AGENT_SINK, `The new service lives at \`${directory}\`. For each area below, a reviewer has decided ` +
+        `whether it follows the surrounding monorepo or the reference template. These are ` +
+        `decisions, not suggestions: do not substitute your own judgement for one of them, and ` +
+        `if a decision turns out to be impossible as stated, do the closest thing that honours it ` +
+        `and say so in the pull request description rather than quietly picking the other side.`);
+}
+/**
+ * Render the settled review for the PULL REQUEST the apply phase opens.
+ *
+ * The same list, addressed to the human reviewing the change rather than to the agent making it:
+ * what a reviewer of a bootstrap PR is being asked is whether the service fits the monorepo, and
+ * what settles that is which side each area came from and who chose it, which the diff cannot
+ * show. Every hole crosses {@link HOST_SINK}, because both the titles (model-authored) and the
+ * notes (reviewer-authored) are untrusted text landing on a parsed surface. The caller scrubs
+ * secrets at compose time, before any of this is capped.
+ */
+export function renderAdoptionPrSection(resolved, directory) {
+    const overrides = resolved.decisions.filter((decision) => decision.overrodeRecommendation).length;
+    const stance = resolved.decisions.length === 0
+        ? 'with no suggestion to review: the platform could not produce one'
+        : overrides > 0
+            ? `${overrides} of which overrode the platform's suggestion`
+            : "all of which accepted the platform's suggestion";
+    return renderAdoptionDecisions(resolved, HOST_SINK, `This service was bootstrapped into \`${hostMarkdown.inline(directory)}\` under decisions ` +
+        `settled by a human before any code was written, ${stance}. Each line below names the ` +
+        `area, the side the new service follows for it, and anything the reviewer added.`);
+}
+/**
+ * The default branch name for a monorepo bootstrap's pull request.
+ *
+ * Derived from the run's own id rather than the service name so two bootstraps of similarly
+ * named services can never collide on one branch, and stable per run so a retry of the SAME run
+ * resumes its branch instead of opening a second pull request against the monorepo.
+ */
+export function monorepoBootstrapBranch(jobId) {
+    return `cat-factory/bootstrap-${jobId}`;
+}
+//# sourceMappingURL=monorepo-adoption.logic.js.map

package/dist/domain/monorepo-adoption.logic.js.map

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

package/dist/domain/pr-report.d.ts

@@ -1,7 +1,31 @@
-/** Opens the engine-managed region of a PR body. Never change this — it is the identity. */
+/** Opens the engine-managed region of a PR body. Never change this: it is the identity. */
 export declare const PR_REPORT_MARKER_START = "<!-- cat-factory:verification-report:start -->";
 /** Closes the engine-managed region of a PR body. */
 export declare const PR_REPORT_MARKER_END = "<!-- cat-factory:verification-report:end -->";
+/**
+ * One engine-managed region's identity: the comment pair that delimits it.
+ *
+ * A region is identified by its markers alone, so a body may carry several independent ones and
+ * each writer replaces only its own. That is what lets the monorepo bootstrap keep its settled
+ * adoption decisions on the pull request without owning the description: the agent writes the
+ * narrative, the engine owns one marked block inside it, and neither overwrites the other.
+ */
+export interface ManagedSectionMarkers {
+    start: string;
+    end: string;
+}
+/** The verification report's markers, as a pair (the default for the helpers below). */
+export declare const PR_REPORT_MARKERS: ManagedSectionMarkers;
+/**
+ * The monorepo bootstrap's adoption-decision region.
+ *
+ * Distinct markers rather than a second use of the report's, because the two are written by
+ * different flows at different times and a shared identity would mean whichever ran last erased
+ * the other. A bootstrap opens no run whose steps settle, so it never publishes a verification
+ * report; a task run on the same repository later can, and its report must not land on top of
+ * the decisions this service was created under.
+ */
+export declare const PR_ADOPTION_MARKERS: ManagedSectionMarkers;
 /**
  * Splice `section` into `body` as the engine-managed region.
  *
@@ -16,10 +40,10 @@ export declare const PR_REPORT_MARKER_END = "<!-- cat-factory:verification-repor
  * Returns the new body. The caller compares it against what it read and skips the remote write
  * when nothing changed.
  */
-export declare function spliceManagedSection(body: string | null | undefined, section: string): string;
+export declare function spliceManagedSection(body: string | null | undefined, section: string, markers?: ManagedSectionMarkers): string;
 /**
  * The engine-managed region's current contents, or null when the body carries none. Used by
  * tests and by any consumer that wants to read a report back off a PR without re-composing it.
  */
-export declare function readManagedSection(body: string | null | undefined): string | null;
+export declare function readManagedSection(body: string | null | undefined, markers?: ManagedSectionMarkers): string | null;
 //# sourceMappingURL=pr-report.d.ts.map

package/dist/domain/pr-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr-report.d.ts","sourceRoot":"","sources":["../../src/domain/pr-report.ts"],"names":[],"mappings":"AAcA,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB,mDAAmD,CAAA;AACtF,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,iDAAiD,CAAA;AAElF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAY7F;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAMjF"}
+{"version":3,"file":"pr-report.d.ts","sourceRoot":"","sources":["../../src/domain/pr-report.ts"],"names":[],"mappings":"AAcA,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,mDAAmD,CAAA;AACtF,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,iDAAiD,CAAA;AAElF;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,EAAE,qBAG/B,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,qBAGjC,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,qBAAyC,GACjD,MAAM,CAYR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,OAAO,GAAE,qBAAyC,GACjD,MAAM,GAAG,IAAI,CAMf"}

package/dist/domain/pr-report.js

@@ -11,10 +11,28 @@
 // Pure string logic, so it lives in kernel and is shared by the orchestration composer and
 // the `@cat-factory/server` publisher without either depending on the other.
 // ---------------------------------------------------------------------------
-/** Opens the engine-managed region of a PR body. Never change this — it is the identity. */
+/** Opens the engine-managed region of a PR body. Never change this: it is the identity. */
 export const PR_REPORT_MARKER_START = '<!-- cat-factory:verification-report:start -->';
 /** Closes the engine-managed region of a PR body. */
 export const PR_REPORT_MARKER_END = '<!-- cat-factory:verification-report:end -->';
+/** The verification report's markers, as a pair (the default for the helpers below). */
+export const PR_REPORT_MARKERS = {
+    start: PR_REPORT_MARKER_START,
+    end: PR_REPORT_MARKER_END,
+};
+/**
+ * The monorepo bootstrap's adoption-decision region.
+ *
+ * Distinct markers rather than a second use of the report's, because the two are written by
+ * different flows at different times and a shared identity would mean whichever ran last erased
+ * the other. A bootstrap opens no run whose steps settle, so it never publishes a verification
+ * report; a task run on the same repository later can, and its report must not land on top of
+ * the decisions this service was created under.
+ */
+export const PR_ADOPTION_MARKERS = {
+    start: '<!-- cat-factory:adoption-decisions:start -->',
+    end: '<!-- cat-factory:adoption-decisions:end -->',
+};
 /**
  * Splice `section` into `body` as the engine-managed region.
  *
@@ -29,14 +47,14 @@ export const PR_REPORT_MARKER_END = '<!-- cat-factory:verification-report:end --
  * Returns the new body. The caller compares it against what it read and skips the remote write
  * when nothing changed.
  */
-export function spliceManagedSection(body, section) {
+export function spliceManagedSection(body, section, markers = PR_REPORT_MARKERS) {
     const existing = body ?? '';
-    const wrapped = `${PR_REPORT_MARKER_START}\n${section.trim()}\n${PR_REPORT_MARKER_END}`;
-    const start = existing.indexOf(PR_REPORT_MARKER_START);
-    const end = existing.indexOf(PR_REPORT_MARKER_END);
+    const wrapped = `${markers.start}\n${section.trim()}\n${markers.end}`;
+    const start = existing.indexOf(markers.start);
+    const end = existing.indexOf(markers.end);
     if (start !== -1 && end > start) {
         const before = existing.slice(0, start);
-        const after = existing.slice(end + PR_REPORT_MARKER_END.length);
+        const after = existing.slice(end + markers.end.length);
         return `${before}${wrapped}${after}`;
     }
     const prefix = existing.trim();
@@ -46,12 +64,12 @@ export function spliceManagedSection(body, section) {
  * The engine-managed region's current contents, or null when the body carries none. Used by
  * tests and by any consumer that wants to read a report back off a PR without re-composing it.
  */
-export function readManagedSection(body) {
+export function readManagedSection(body, markers = PR_REPORT_MARKERS) {
     const existing = body ?? '';
-    const start = existing.indexOf(PR_REPORT_MARKER_START);
-    const end = existing.indexOf(PR_REPORT_MARKER_END);
+    const start = existing.indexOf(markers.start);
+    const end = existing.indexOf(markers.end);
     if (start === -1 || end <= start)
         return null;
-    return existing.slice(start + PR_REPORT_MARKER_START.length, end).trim();
+    return existing.slice(start + markers.start.length, end).trim();
 }
 //# sourceMappingURL=pr-report.js.map

package/dist/domain/pr-report.js.map

@@ -1 +1 @@
-{"version":3,"file":"pr-report.js","sourceRoot":"","sources":["../../src/domain/pr-report.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gEAAgE;AAChE,EAAE;AACF,yFAAyF;AACzF,wFAAwF;AACxF,sFAAsF;AACtF,kFAAkF;AAClF,4FAA4F;AAC5F,iBAAiB;AACjB,EAAE;AACF,2FAA2F;AAC3F,6EAA6E;AAC7E,8EAA8E;AAE9E,4FAA4F;AAC5F,MAAM,CAAC,MAAM,sBAAsB,GAAG,gDAAgD,CAAA;AACtF,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,8CAA8C,CAAA;AAElF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAA+B,EAAE,OAAe;IACnF,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAA;IAC3B,MAAM,OAAO,GAAG,GAAG,sBAAsB,KAAK,OAAO,CAAC,IAAI,EAAE,KAAK,oBAAoB,EAAE,CAAA;IACvF,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAClD,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAA;QAC/D,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,EAAE,CAAA;IACtC,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC9B,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAA;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA+B;IAChE,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAClD,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,IAAI,CAAA;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,sBAAsB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;AAC1E,CAAC"}
+{"version":3,"file":"pr-report.js","sourceRoot":"","sources":["../../src/domain/pr-report.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gEAAgE;AAChE,EAAE;AACF,yFAAyF;AACzF,wFAAwF;AACxF,sFAAsF;AACtF,kFAAkF;AAClF,4FAA4F;AAC5F,iBAAiB;AACjB,EAAE;AACF,2FAA2F;AAC3F,6EAA6E;AAC7E,8EAA8E;AAE9E,2FAA2F;AAC3F,MAAM,CAAC,MAAM,sBAAsB,GAAG,gDAAgD,CAAA;AACtF,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,8CAA8C,CAAA;AAelF,wFAAwF;AACxF,MAAM,CAAC,MAAM,iBAAiB,GAA0B;IACtD,KAAK,EAAE,sBAAsB;IAC7B,GAAG,EAAE,oBAAoB;CAC1B,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA0B;IACxD,KAAK,EAAE,+CAA+C;IACtD,GAAG,EAAE,6CAA6C;CACnD,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAA+B,EAC/B,OAAe,EACf,OAAO,GAA0B,iBAAiB;IAElD,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAA;IAC3B,MAAM,OAAO,GAAG,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC,GAAG,EAAE,CAAA;IACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACzC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACtD,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,EAAE,CAAA;IACtC,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC9B,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAA;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAA+B,EAC/B,OAAO,GAA0B,iBAAiB;IAElD,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACzC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,IAAI,CAAA;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;AACjE,CAAC"}

package/dist/domain/service-registration.d.ts

@@ -23,9 +23,17 @@ export interface ServiceRegistrationDeps {
  * Shared by every site that creates a top-level frame (board drops, repo import, seeded demo
  * boards, repo bootstrap) so they all produce a consistent, shareable service.
  */
-export declare function registerServiceForFrame(deps: ServiceRegistrationDeps, workspaceId: string, frame: Pick<Block, 'id' | 'position' | 'size'>, repo?: {
-    installationId: number;
-    githubId: number;
+export declare function registerServiceForFrame(deps: ServiceRegistrationDeps, workspaceId: string, frame: Pick<Block, 'id' | 'position' | 'size'>, 
+/**
+ * What the frame is pinned to. The two repo ids and the `directory` are INDEPENDENTLY
+ * optional: a monorepo bootstrap knows the subdirectory its service will occupy from the
+ * moment it is pre-flighted, but must not claim a repo binding until the run has actually
+ * written code there: a service bound to a repo whose directory is still empty dispatches
+ * tasks into nothing.
+ */
+repo?: {
+    installationId?: number | null;
+    githubId?: number | null;
     directory?: string | null;
 }): Promise<string | undefined>;
 //# sourceMappingURL=service-registration.d.ts.map

package/dist/domain/service-registration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-registration.d.ts","sourceRoot":"","sources":["../../src/domain/service-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAW,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,mBAAmB,CAAA;AAE1B;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;IACnD,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,EAAE,KAAK,CAAA;CACb;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,uBAAuB,EAC7B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,CAAC,EAC9C,IAAI,CAAC,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC7E,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuB7B"}
+{"version":3,"file":"service-registration.d.ts","sourceRoot":"","sources":["../../src/domain/service-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAW,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,mBAAmB,CAAA;AAE1B;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;IACnD,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,EAAE,KAAK,CAAA;CACb;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,uBAAuB,EAC7B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,CAAC;AAC9C;;;;;;GAMG;AACH,IAAI,CAAC,EAAE;IACL,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,GACA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuB7B"}

package/dist/domain/service-registration.js

@@ -9,7 +9,15 @@
  * Shared by every site that creates a top-level frame (board drops, repo import, seeded demo
  * boards, repo bootstrap) so they all produce a consistent, shareable service.
  */
-export async function registerServiceForFrame(deps, workspaceId, frame, repo) {
+export async function registerServiceForFrame(deps, workspaceId, frame, 
+/**
+ * What the frame is pinned to. The two repo ids and the `directory` are INDEPENDENTLY
+ * optional: a monorepo bootstrap knows the subdirectory its service will occupy from the
+ * moment it is pre-flighted, but must not claim a repo binding until the run has actually
+ * written code there: a service bound to a repo whose directory is still empty dispatches
+ * tasks into nothing.
+ */
+repo) {
     const { serviceRepository, workspaceMountRepository } = deps;
     if (!serviceRepository || !workspaceMountRepository)
         return undefined;

package/dist/domain/service-registration.js.map

@@ -1 +1 @@
-{"version":3,"file":"service-registration.js","sourceRoot":"","sources":["../../src/domain/service-registration.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAA6B,EAC7B,WAAmB,EACnB,KAA8C,EAC9C,IAA8E;IAE9E,MAAM,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,GAAG,IAAI,CAAA;IAC5D,IAAI,CAAC,iBAAiB,IAAI,CAAC,wBAAwB;QAAE,OAAO,SAAS,CAAA;IACrE,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,IAAI,CAAA;IACjF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;IAC5B,MAAM,OAAO,GAAY;QACvB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;QAChC,SAAS;QACT,YAAY,EAAE,KAAK,CAAC,EAAE;QACtB,cAAc,EAAE,IAAI,EAAE,cAAc,IAAI,IAAI;QAC5C,YAAY,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI;QACpC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI;QAClC,SAAS,EAAE,GAAG;KACf,CAAA;IACD,MAAM,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACvC,MAAM,wBAAwB,CAAC,MAAM,CAAC;QACpC,WAAW;QACX,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;QACxB,SAAS,EAAE,GAAG;KACf,CAAC,CAAA;IACF,OAAO,OAAO,CAAC,EAAE,CAAA;AACnB,CAAC"}
+{"version":3,"file":"service-registration.js","sourceRoot":"","sources":["../../src/domain/service-registration.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAA6B,EAC7B,WAAmB,EACnB,KAA8C;AAC9C;;;;;;GAMG;AACH,IAIC;IAED,MAAM,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,GAAG,IAAI,CAAA;IAC5D,IAAI,CAAC,iBAAiB,IAAI,CAAC,wBAAwB;QAAE,OAAO,SAAS,CAAA;IACrE,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,IAAI,CAAA;IACjF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;IAC5B,MAAM,OAAO,GAAY;QACvB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;QAChC,SAAS;QACT,YAAY,EAAE,KAAK,CAAC,EAAE;QACtB,cAAc,EAAE,IAAI,EAAE,cAAc,IAAI,IAAI;QAC5C,YAAY,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI;QACpC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI;QAClC,SAAS,EAAE,GAAG;KACf,CAAA;IACD,MAAM,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACvC,MAAM,wBAAwB,CAAC,MAAM,CAAC;QACpC,WAAW;QACX,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;QACxB,SAAS,EAAE,GAAG;KACf,CAAC,CAAA;IACF,OAAO,OAAO,CAAC,EAAE,CAAA;AACnB,CAAC"}