@jterrats/open-orchestra 0.5.5 → 1.0.1

package/dist/qa-coverage.js

@@ -0,0 +1,189 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { loadWorkspace, readEvents } from "./workspace.js";
+const STYLE_PATTERNS = {
+    browser: /\b(browser|ui|web|site|page|screen|click|form|responsive|playwright|accessibility)\b/i,
+    cli: /\b(cli|command|terminal|stdout|stderr|flag|option|manifest)\b/i,
+    shell: /\b(shell|bash|sh|script|deploy|deployment|smoke)\b/i,
+    api: /\b(api|endpoint|http|request|response|contract|webhook|json schema)\b/i,
+};
+const STYLE_COMMAND_HINTS = {
+    browser: ["test:e2e", "test:playwright"],
+    cli: ["test:e2e:init", "test:cli"],
+    shell: ["test:shell", "test:smoke"],
+    api: ["test:api", "test:integration"],
+};
+export async function generateQaAutomationCoverage(taskId, root = process.cwd()) {
+    const workspace = await loadWorkspace(root);
+    const task = workspace.tasks.find((candidate) => candidate.id === taskId);
+    if (!task) {
+        throw new Error(`unknown task: ${taskId}`);
+    }
+    const events = (await readEvents(root)).filter((event) => event.taskId === taskId);
+    return assessQaAutomationCoverage(task, events, await loadQaAutomationScripts(root));
+}
+export async function loadQaAutomationScripts(root = process.cwd()) {
+    try {
+        const pkg = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
+        return new Set(Object.entries(pkg.scripts ?? {})
+            .filter(([, value]) => typeof value === "string")
+            .map(([name]) => name));
+    }
+    catch {
+        return new Set();
+    }
+}
+export function assessQaAutomationCoverage(task, events, scripts) {
+    const criteria = task.acceptanceCriteria && task.acceptanceCriteria.length > 0
+        ? task.acceptanceCriteria
+        : [];
+    const changedSurfaces = classifyChangedSurfaces(task);
+    const defaultStyle = styleFromSet(changedSurfaces);
+    const coverage = criteria.map((criterion, index) => assessCriterion(task, criterion, index, events, scripts, defaultStyle));
+    const commands = [
+        ...new Set(coverage.flatMap((item) => item.plannedCommands)),
+    ];
+    const pageObjects = [
+        ...new Set(coverage
+            .filter((item) => item.style === "browser")
+            .map(() => `${toPascalCase(task.id)}Page`)),
+    ];
+    const gaps = coverage
+        .filter((item) => item.status === "gap")
+        .map((item) => item.criterion);
+    return {
+        taskId: task.id,
+        style: styleFromSet(new Set(coverage.map((item) => item.style))),
+        changedSurfaces: [...changedSurfaces],
+        commands,
+        pageObjects,
+        criteria: coverage,
+        gaps,
+    };
+}
+function assessCriterion(task, criterion, index, events, scripts, defaultStyle) {
+    const style = classifyCriterion(criterion, defaultStyle);
+    const evidence = matchingEvidence(events, criterion);
+    const plannedCommands = commandsForStyle(style, scripts);
+    const status = criterionStatus(style, evidence, plannedCommands);
+    return {
+        index,
+        criterion,
+        style,
+        status,
+        evidence,
+        plannedCommands,
+        recommendation: recommendationForStyle(task, style, plannedCommands),
+    };
+}
+function criterionStatus(style, evidence, plannedCommands) {
+    if (evidence.length > 0)
+        return "covered";
+    if (style === "not_applicable")
+        return "skipped";
+    if (plannedCommands.length > 0)
+        return "planned";
+    return "gap";
+}
+function classifyCriterion(criterion, defaultStyle) {
+    const styles = stylesFromText(criterion);
+    if (styles.size > 0)
+        return styleFromSet(styles);
+    return defaultStyle;
+}
+function classifyChangedSurfaces(task) {
+    const styles = new Set();
+    for (const filePath of task.paths ?? []) {
+        const normalized = filePath.toLowerCase();
+        if (/^(site|src\/web|e2e\/)|playwright|\.jsx?$|\.tsx?$/.test(normalized)) {
+            styles.add("browser");
+        }
+        if (/^(bin\/|src\/cli|src\/commands|src\/.*commands)/.test(normalized)) {
+            styles.add("cli");
+        }
+        if (/\.sh$|scripts\/|deploy|workflow/.test(normalized)) {
+            styles.add("shell");
+        }
+        if (/api|server|webhook|openapi|schema/.test(normalized)) {
+            styles.add("api");
+        }
+    }
+    for (const style of stylesFromText([
+        task.title,
+        task.goal,
+        task.scope,
+        task.testStrategy,
+        ...(task.acceptanceCriteria ?? []),
+        ...(task.risks ?? []),
+    ].join(" "))) {
+        styles.add(style);
+    }
+    if (styles.size === 0)
+        styles.add("not_applicable");
+    return styles;
+}
+function stylesFromText(text) {
+    const styles = new Set();
+    for (const [style, pattern] of Object.entries(STYLE_PATTERNS)) {
+        if (pattern.test(text)) {
+            styles.add(style);
+        }
+    }
+    return styles;
+}
+function styleFromSet(styles) {
+    const concrete = [...styles].filter((style) => style !== "not_applicable");
+    if (concrete.length === 0)
+        return "not_applicable";
+    return concrete.length === 1 ? concrete[0] : "mixed";
+}
+function commandsForStyle(style, scripts) {
+    if (style === "mixed") {
+        return [
+            ...new Set(["browser", "cli", "shell", "api"].flatMap((item) => commandsForStyle(item, scripts))),
+        ];
+    }
+    if (style === "not_applicable")
+        return [];
+    return STYLE_COMMAND_HINTS[style]
+        .filter((script) => scripts.has(script))
+        .map((script) => `npm run ${script}`);
+}
+function matchingEvidence(events, criterion) {
+    const needle = criterion.toLowerCase();
+    return events
+        .filter((event) => event.type === "EVIDENCE_ADDED")
+        .filter((event) => {
+        const summary = event.summary.toLowerCase();
+        return (summary.includes(needle) ||
+            summary.includes("covers all acceptance criteria") ||
+            summary.includes("acceptance criteria"));
+    })
+        .map((event) => event.summary);
+}
+function recommendationForStyle(task, style, commands) {
+    if (style === "browser") {
+        return `Add Playwright coverage using ${toPascalCase(task.id)}Page with role and label locators, visible-state assertions, and screenshots for visual behavior.`;
+    }
+    if (style === "cli") {
+        return "Add executable CLI regression coverage that asserts exit code, stdout, stderr, generated files, workflow events, and final state.";
+    }
+    if (style === "shell") {
+        return "Add shell regression coverage with deterministic setup, strict error handling, and captured logs.";
+    }
+    if (style === "api") {
+        return "Add API regression coverage for request, response body, error shape, idempotency, permissions, and observable side effects.";
+    }
+    if (style === "mixed") {
+        return `Run the mixed automation plan: ${commands.join(", ") || "no executable commands configured"}.`;
+    }
+    return "No automation required from current task scope.";
+}
+function toPascalCase(value) {
+    return value
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+//# sourceMappingURL=qa-coverage.js.map

package/dist/qa-coverage.js.map

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

package/dist/qa-readiness.d.ts

@@ -0,0 +1,5 @@
+import type { DependencyStatus, Task } from "./types.js";
+export declare function requiresQaPlan(task: Task): boolean;
+export declare function hasExecutableQaPlan(task: Task): boolean;
+export declare function qaPlanReadinessBlocker(task: Task): DependencyStatus | undefined;
+export declare function assertQaPlanReadyForExecution(task: Task): void;

package/dist/qa-readiness.js

@@ -0,0 +1,26 @@
+const EXECUTION_STATUSES = new Set(["ready", "in_progress"]);
+export function requiresQaPlan(task) {
+    return Boolean(task.backlogItem && !task.mechanicalOverride?.rationale);
+}
+export function hasExecutableQaPlan(task) {
+    if (!requiresQaPlan(task))
+        return true;
+    if (task.qaGate?.plan?.trim())
+        return true;
+    return Boolean(task.qaGate?.executionStatus === "deferred" &&
+        task.qaGate.deferredRationale?.trim() &&
+        task.qaGate.deferredOwner?.trim());
+}
+export function qaPlanReadinessBlocker(task) {
+    return hasExecutableQaPlan(task)
+        ? undefined
+        : { id: "qaGate.plan", status: "blocked", isComplete: false };
+}
+export function assertQaPlanReadyForExecution(task) {
+    if (!EXECUTION_STATUSES.has(task.status))
+        return;
+    if (hasExecutableQaPlan(task))
+        return;
+    throw new Error(`task ${task.id} requires qaGate.plan before ${task.status}; use --qa-plan or set --qa-execution-status deferred with --qa-deferred-rationale and --qa-deferred-owner when QA is not applicable`);
+}
+//# sourceMappingURL=qa-readiness.js.map

package/dist/qa-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-readiness.js","sourceRoot":"","sources":["../src/qa-readiness.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAiB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;AAE7E,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAU;IAC5C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,OAAO,CACZ,IAAI,CAAC,MAAM,EAAE,eAAe,KAAK,UAAU;QAC3C,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,EAAE;QACrC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAU;IAEV,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAU;IACtD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO;IACjD,IAAI,mBAAmB,CAAC,IAAI,CAAC;QAAE,OAAO;IACtC,MAAM,IAAI,KAAK,CACb,QAAQ,IAAI,CAAC,EAAE,gCAAgC,IAAI,CAAC,MAAM,sIAAsI,CACjM,CAAC;AACJ,CAAC"}

package/dist/refresh-generated.d.ts

@@ -0,0 +1,32 @@
+import type { SkillRenderTarget } from "./types.js";
+export interface RefreshGeneratedOptions {
+    root?: string;
+    check?: boolean;
+    dryRun?: boolean;
+    force?: boolean;
+    targets?: SkillRenderTarget[];
+}
+export interface RefreshGeneratedItem {
+    kind: "runtime-bootstrap" | "phase-playbook";
+    path: string;
+    target?: string;
+    managedBlockId: string;
+    beforeStatus: "current" | "custom" | "drifted" | "missing" | "missing-block" | "stale";
+    afterStatus: "blocked" | "changed" | "unchanged" | "would-change";
+    status: "changed" | "unchanged" | "blocked";
+    reason: string;
+    plannedWrite: boolean;
+    recommendedCommand: string;
+}
+export interface RefreshGeneratedReport {
+    mode: "check" | "dry-run" | "apply";
+    force: boolean;
+    driftStatus: "blocked" | "changes" | "clean";
+    items: RefreshGeneratedItem[];
+    totals: {
+        changed: number;
+        unchanged: number;
+        blocked: number;
+    };
+}
+export declare function refreshGeneratedFiles({ root, check, dryRun, force, targets, }?: RefreshGeneratedOptions): Promise<RefreshGeneratedReport>;

package/dist/refresh-generated.js

@@ -0,0 +1,180 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { DEFAULT_PHASE_PLAYBOOKS, DEFAULT_PLAYBOOKS_DIR, } from "./phase-playbooks.js";
+import { exists, resolveWorkspaceWritePath } from "./fs-utils.js";
+import { listRuntimeAdapters } from "./runtime-adapters.js";
+import { renderRuntimeBootstrap, upsertRuntimeBootstrapBlock, } from "./runtime-bootstrap.js";
+export async function refreshGeneratedFiles({ root = process.cwd(), check = false, dryRun = false, force = false, targets, } = {}) {
+    const items = [
+        ...(await refreshRuntimeBootstrapFiles({
+            root,
+            check,
+            dryRun,
+            force,
+            targets: targets ?? [],
+        })),
+        ...(await refreshPhasePlaybooks({ root, check, dryRun, force })),
+    ];
+    return {
+        mode: check ? "check" : dryRun ? "dry-run" : "apply",
+        force,
+        driftStatus: driftStatus(items),
+        items,
+        totals: {
+            changed: items.filter((item) => item.status === "changed").length,
+            unchanged: items.filter((item) => item.status === "unchanged").length,
+            blocked: items.filter((item) => item.status === "blocked").length,
+        },
+    };
+}
+async function refreshRuntimeBootstrapFiles({ root, check, dryRun, force, targets, }) {
+    const candidates = await existingRuntimeBootstrapTargets(root, targets);
+    const items = [];
+    for (const candidate of candidates) {
+        const filePath = resolveWorkspaceWritePath(root, candidate.path);
+        const existing = await readFile(filePath, "utf8").catch(() => "");
+        const result = upsertRuntimeBootstrapBlock(existing, renderRuntimeBootstrap(candidate.target), { force });
+        if (result.drift && !force) {
+            items.push({
+                kind: "runtime-bootstrap",
+                path: candidate.path,
+                target: candidate.target,
+                managedBlockId: `runtime-bootstrap:${candidate.target}`,
+                beforeStatus: "drifted",
+                afterStatus: "blocked",
+                status: "blocked",
+                reason: "managed block drift detected; rerun with --force to replace it",
+                plannedWrite: false,
+                recommendedCommand: recommendedRefreshCommand({
+                    force: true,
+                    target: candidate.target,
+                }),
+            });
+            continue;
+        }
+        if (result.changed && !check && !dryRun) {
+            await ensureParent(filePath);
+            await writeFile(filePath, result.content, "utf8");
+        }
+        const beforeStatus = runtimeBeforeStatus(existing, result);
+        items.push({
+            kind: "runtime-bootstrap",
+            path: candidate.path,
+            target: candidate.target,
+            managedBlockId: `runtime-bootstrap:${candidate.target}`,
+            beforeStatus,
+            afterStatus: afterStatus(result.changed, check, dryRun),
+            status: result.changed ? "changed" : "unchanged",
+            reason: result.missing
+                ? "managed block missing"
+                : result.changed
+                    ? "managed block refreshed"
+                    : "managed block current",
+            plannedWrite: result.changed && !check,
+            recommendedCommand: result.changed
+                ? recommendedRefreshCommand({ force, target: candidate.target })
+                : "none",
+        });
+    }
+    return items;
+}
+async function existingRuntimeBootstrapTargets(root, targets) {
+    const defaults = new Set(["ORCHESTRA.md", "AGENTS.md"]);
+    const targetSet = new Set(targets);
+    const adapters = listRuntimeAdapters().filter((adapter) => targetSet.size === 0 || targetSet.has(adapter.target));
+    const candidates = adapters.flatMap((adapter) => adapter.defaultInstructionFiles.map((file) => ({
+        path: file,
+        target: adapter.target,
+    })));
+    const selected = [];
+    for (const candidate of candidates) {
+        const filePath = resolveWorkspaceWritePath(root, candidate.path);
+        if (defaults.has(candidate.path) || (await exists(filePath))) {
+            selected.push(candidate);
+        }
+    }
+    return selected;
+}
+async function refreshPhasePlaybooks({ root, check, dryRun, force, }) {
+    const items = [];
+    for (const [phase, content] of Object.entries(DEFAULT_PHASE_PLAYBOOKS)) {
+        const relativePath = `${DEFAULT_PLAYBOOKS_DIR}/${phase}.md`;
+        const filePath = resolveWorkspaceWritePath(root, relativePath);
+        const existing = await readFile(filePath, "utf8").catch(() => "");
+        const desired = `${content}\n`;
+        const missing = existing === "";
+        const changed = missing || (force && existing !== desired);
+        if (changed && !check && !dryRun) {
+            await ensureParent(filePath);
+            await writeFile(filePath, desired, "utf8");
+        }
+        items.push({
+            kind: "phase-playbook",
+            path: relativePath,
+            target: phase,
+            managedBlockId: `phase-playbook:${phase}`,
+            beforeStatus: missing
+                ? "missing"
+                : existing === desired
+                    ? "current"
+                    : "custom",
+            afterStatus: afterStatus(changed, check, dryRun),
+            status: changed ? "changed" : "unchanged",
+            reason: missing
+                ? "default playbook missing"
+                : changed
+                    ? "default playbook refreshed with --force"
+                    : force
+                        ? "default playbook current"
+                        : "existing playbook preserved",
+            plannedWrite: changed && !check,
+            recommendedCommand: changed
+                ? recommendedRefreshCommand({ force })
+                : missing
+                    ? recommendedRefreshCommand({ force: false })
+                    : "none",
+        });
+    }
+    return items;
+}
+function runtimeBeforeStatus(existing, result) {
+    if (existing === "") {
+        return "missing";
+    }
+    if (result.missing) {
+        return "missing-block";
+    }
+    if (result.drift) {
+        return "drifted";
+    }
+    return result.changed ? "stale" : "current";
+}
+function afterStatus(changed, check, dryRun) {
+    if (!changed) {
+        return "unchanged";
+    }
+    return check || dryRun ? "would-change" : "changed";
+}
+function driftStatus(items) {
+    if (items.some((item) => item.status === "blocked")) {
+        return "blocked";
+    }
+    if (items.some((item) => item.status === "changed")) {
+        return "changes";
+    }
+    return "clean";
+}
+function recommendedRefreshCommand({ force, target, }) {
+    return [
+        "orchestra refresh",
+        force ? "--force" : "",
+        target ? `--target ${target}` : "",
+    ]
+        .filter(Boolean)
+        .join(" ");
+}
+async function ensureParent(filePath) {
+    const { mkdir } = await import("node:fs/promises");
+    await mkdir(path.dirname(filePath), { recursive: true });
+}
+//# sourceMappingURL=refresh-generated.js.map

package/dist/refresh-generated.js.map

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

package/dist/release-candidate.d.ts

@@ -15,9 +15,17 @@ export interface CandidateReleasePlan {
     stories: ReleaseStoryReadiness[];
     approvedStories: ReleaseStoryReadiness[];
     changelog: string;
+    operations: ReleaseOperationsPlan;
     ready: boolean;
     missing: string[];
 }
+export interface ReleaseOperationsPlan {
+    semverImpact: "patch" | "minor" | "major";
+    rolloutChecklist: string[];
+    rollbackChecklist: string[];
+    postReleaseChecklist: string[];
+}
+export type ReleaseEvidenceKind = "smoke" | "rollback" | "post-release" | "release-notes";
 export declare function generateCandidateReleasePlan({ root, version, }?: {
     root?: string;
     version?: string | undefined;
@@ -37,7 +45,7 @@ export declare function recordReleaseTagApproval({ root, version, approver, appr
 }): Promise<EventEntry>;
 export declare function attachReleaseEvidence({ root, kind, summary, artifactPath, }: {
     root?: string;
-    kind: "smoke" | "rollback";
+    kind: ReleaseEvidenceKind;
     summary: string;
     artifactPath?: string | undefined;
 }): Promise<EventEntry>;

package/dist/release-candidate.js

@@ -11,6 +11,7 @@ export async function generateCandidateReleasePlan({ root = process.cwd(), versi
         stories,
         approvedStories,
         changelog: renderReleaseChangelog(version, approvedStories),
+        operations: buildReleaseOperationsPlan(approvedStories),
         ready: missing.length === 0,
         missing,
     };
@@ -150,12 +151,51 @@ function releasePlanMissingItems(stories, approvedStories) {
 }
 function renderReleaseChangelog(version, approvedStories) {
     const title = version ? "# Changelog " + version : "# Changelog";
-    const lines = [title, ""];
+    const lines = [title, "", "## Changes"];
     for (const story of approvedStories) {
         lines.push("- " + story.taskId + ": " + story.title);
     }
+    const breaking = approvedStories.filter((story) => isBreakingStory(story));
+    if (breaking.length > 0) {
+        lines.push("", "## Breaking Changes");
+        for (const story of breaking) {
+            lines.push("- " + story.taskId + ": " + story.title);
+        }
+    }
     return lines.join("\n");
 }
+function buildReleaseOperationsPlan(approvedStories) {
+    const semverImpact = approvedStories.some((story) => isBreakingStory(story))
+        ? "major"
+        : approvedStories.length > 0
+            ? "minor"
+            : "patch";
+    return {
+        semverImpact,
+        rolloutChecklist: [
+            "Confirm release candidate plan is reviewed.",
+            "Confirm release notes or changelog are attached.",
+            "Run release smoke validation in the target environment.",
+        ],
+        rollbackChecklist: [
+            "Confirm rollback evidence is attached.",
+            "Confirm owner and communication path for rollback decision.",
+            "Confirm forward-fix path for non-rollbackable changes.",
+        ],
+        postReleaseChecklist: [
+            "Attach post-release smoke evidence.",
+            "Monitor availability, errors, latency, and support channels.",
+            "Capture follow-up issues for accepted risks or known gaps.",
+        ],
+    };
+}
+function isBreakingStory(story) {
+    return /\b(breaking|major|incompatible|migration required)\b/i.test([
+        story.title,
+        story.backlogItem,
+        ...story.acceptanceCoverage.map((item) => item.criterion),
+    ].join(" "));
+}
 function renderCandidateReleasePlan(plan) {
     return [
         "# Candidate Release" + (plan.version ? " " + plan.version : ""),
@@ -163,10 +203,21 @@ function renderCandidateReleasePlan(plan) {
         "- Ready: " + plan.ready,
         "- Approved stories: " + plan.approvedStories.length,
         "- Missing: " + (plan.missing.join(", ") || "none"),
+        "- Semver impact: " + plan.operations.semverImpact,
         "",
         "## Stories",
         ...plan.stories.map(renderStoryLine),
         "",
+        "## Release Operations",
+        "### Rollout",
+        ...plan.operations.rolloutChecklist.map((item) => "- " + item),
+        "",
+        "### Rollback",
+        ...plan.operations.rollbackChecklist.map((item) => "- " + item),
+        "",
+        "### Post-release",
+        ...plan.operations.postReleaseChecklist.map((item) => "- " + item),
+        "",
         "## Changelog",
         plan.changelog,
         "",

package/dist/release-candidate.js.map

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