agentera 3.0.0-dev.2 → 3.0.0-dev.21

package/dist/cli/commands/state/decisions.js

@@ -0,0 +1,421 @@
+/**
+ * `state decisions` query (decisions.yaml + archive) plus the
+ * decision context enrichment utilities consumed by prime.
+ *
+ * The contract for decision context: never infer satisfaction from
+ * downstream references, commits, or compacted history. Only
+ * `state == user_confirmed_satisfied` with explicit
+ * `user_confirmation` metadata is reported as user-confirmed
+ * satisfied; everything else carries a `review_needed` flag and
+ * a `caveats` array.
+ */
+import { emitStateStructured, extractEntries, loadArtifact, missingSchemaError, sourceMetadata, stringFieldNames, structuredState, } from "../../stateQuery.js";
+import { artifactPath } from "../../appContext.js";
+import { out, err } from "./shared.js";
+import { hydrateDecisionRecords, } from "../../../state/decisionOverlay.js";
+const DECISION_CONTEXT_FIELDS = [
+    "number",
+    "date",
+    "question",
+    "context",
+    "alternatives",
+    "choice",
+    "reasoning",
+    "confidence",
+    "feeds_into",
+    "satisfaction",
+];
+const PRIORITY_FIELDS = [
+    "number", "name", "title", "date", "timestamp", "status",
+    "phase", "choice", "grade", "type", "label", "trajectory", "confidence",
+];
+const DECISION_ARCHIVE_RE = /Decision\s+(?<number>\d+)(?:\s+\((?<date>\d{4}-\d{2}-\d{2})\))?:\s*(?<summary>.*)/;
+export function displayFields(fields, limit = 6) {
+    const ordered = PRIORITY_FIELDS.filter((p) => p in fields);
+    for (const fn of Object.keys(fields)) {
+        if (!ordered.includes(fn))
+            ordered.push(fn);
+    }
+    return ordered.slice(0, limit);
+}
+function isEmptyValue(v) {
+    // cast: v is a field value from a parsed decisions.yaml entry (IO boundary)
+    return (v === null ||
+        v === undefined ||
+        v === "" ||
+        (Array.isArray(v) && v.length === 0) ||
+        (typeof v === "object" && !Array.isArray(v) && Object.keys(v).length === 0));
+}
+function decisionArchiveEntry(entry) {
+    // cast: entry comes from the parsed decisions archive array (YAML IO boundary)
+    const archiveEntry = entry && typeof entry === "object" && !Array.isArray(entry) ? { ...entry } : { summary: String(entry) };
+    archiveEntry.compacted = true;
+    const summary = String(archiveEntry.summary ?? "");
+    const match = DECISION_ARCHIVE_RE.exec(summary);
+    if (match && match.groups) {
+        if (!("number" in archiveEntry))
+            archiveEntry.number = parseInt(match.groups.number, 10);
+        if (match.groups.date && !("date" in archiveEntry))
+            archiveEntry.date = match.groups.date;
+    }
+    return archiveEntry;
+}
+export function extractDecisionEntries(data) {
+    if (!data || typeof data !== "object" || Array.isArray(data))
+        return extractEntries(data);
+    // cast: data is the parsed decisions artifact from loadArtifact (YAML IO boundary)
+    const d = data;
+    const decisions = d.decisions ?? [];
+    const archive = d.archive ?? [];
+    const entries = Array.isArray(decisions)
+        ? decisions.filter((e) => Boolean(e && typeof e === "object" && !Array.isArray(e)))
+        : [];
+    if (Array.isArray(archive)) {
+        for (const entry of archive)
+            entries.push(decisionArchiveEntry(entry));
+    }
+    return entries;
+}
+export function hydrateDecisionEntries(entries, projectRoot = process.cwd()) {
+    return hydrateDecisionRecords(entries, projectRoot);
+}
+function filterDecisionsByTopic(entries, topic, fields) {
+    const t = topic.toLowerCase();
+    const fnames = [...stringFieldNames(fields), "summary", "outcome"];
+    return entries.filter((entry) => fnames.some((f) => String(entry[f] ?? "").toLowerCase().includes(t)));
+}
+function decisionFieldMissing(entry, field) {
+    return isEmptyValue(entry[field]);
+}
+function decisionDownstreamReferences(entry) {
+    const value = entry.feeds_into;
+    if (value === null || value === undefined || value === "")
+        return null;
+    let refs;
+    if (Array.isArray(value)) {
+        refs = value.map((item) => String(item).trim()).filter((s) => s);
+    }
+    else {
+        refs = String(value)
+            .split(",")
+            .map((part) => part.trim())
+            .filter((s) => s);
+    }
+    if (refs.length === 0)
+        return null;
+    return refs.map((ref) => ({ source_field: "feeds_into", reference: ref }));
+}
+export function decisionSatisfactionContext(entry) {
+    const satisfaction = entry.satisfaction;
+    if (!satisfaction || typeof satisfaction !== "object" || Array.isArray(satisfaction)) {
+        return {
+            state: null,
+            evidence: null,
+            user_confirmation: null,
+            review_needed: true,
+            source: "missing_legacy_state",
+            caveats: ["Missing legacy satisfaction state is not treated as satisfied."],
+        };
+    }
+    // cast: satisfaction is read from a parsed decisions.yaml entry (IO boundary)
+    const sat = satisfaction;
+    const state = sat.state;
+    const evidence = sat.evidence ?? null;
+    const userConfirmation = sat.user_confirmation ?? null;
+    const explicitReviewNeeded = sat.review_needed === true;
+    let caveats = [];
+    let reviewNeeded = true;
+    let source = "decision.satisfaction";
+    if (state === null || state === undefined || state === "") {
+        source = "missing_legacy_state";
+        caveats.push("Missing legacy satisfaction state is not treated as satisfied.");
+    }
+    else if (state === "user_confirmed_satisfied") {
+        // cast: user_confirmation is read from a parsed decisions.yaml entry (IO boundary)
+        const confirmation = userConfirmation && typeof userConfirmation === "object" && !Array.isArray(userConfirmation)
+            ? userConfirmation
+            : {};
+        reviewNeeded =
+            !isNonEmptyText(confirmation.confirmed_by) || !isNonEmptyText(confirmation.confirmed_at);
+        if (reviewNeeded)
+            caveats.push("User-confirmed satisfaction is missing explicit user confirmation metadata.");
+    }
+    else if (state === "provisionally_satisfied") {
+        if (!isNonEmptyText(evidence))
+            caveats.push("Provisional satisfaction is missing concrete evidence.");
+        caveats.push("Provisional satisfaction still requires user confirmation.");
+    }
+    else if (state === "open") {
+        caveats.push("Satisfaction state is open and requires review.");
+    }
+    else {
+        caveats.push("Satisfaction state is missing or unrecognized and requires review.");
+    }
+    if (explicitReviewNeeded) {
+        reviewNeeded = true;
+        caveats.push("Decision satisfaction is explicitly marked review_needed.");
+    }
+    const originalCaveats = sat.caveats;
+    if (Array.isArray(originalCaveats))
+        caveats = [...originalCaveats.map((c) => String(c)), ...caveats];
+    else if (typeof originalCaveats === "string")
+        caveats = [originalCaveats, ...caveats];
+    const enriched = { ...sat };
+    if (!("evidence" in enriched))
+        enriched.evidence = evidence;
+    if (!("user_confirmation" in enriched))
+        enriched.user_confirmation = userConfirmation;
+    enriched.review_needed = reviewNeeded;
+    enriched.source = source;
+    enriched.caveats = caveats;
+    return enriched;
+}
+function isNonEmptyText(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+export function decisionContextEntry(entry, options = {}) {
+    const enriched = { ...entry };
+    const inferOutcome = options.inferOutcome !== false;
+    if (inferOutcome &&
+        (enriched.outcome === null || enriched.outcome === undefined || enriched.outcome === "") &&
+        enriched.choice !== null && enriched.choice !== undefined && enriched.choice !== "") {
+        enriched.outcome = enriched.choice;
+    }
+    const compacted = Boolean(enriched.compacted) ||
+        ("summary" in enriched &&
+            ["question", "reasoning", "confidence"].some((field) => decisionFieldMissing(enriched, field)));
+    const missingFields = DECISION_CONTEXT_FIELDS.filter((field) => decisionFieldMissing(enriched, field));
+    if ((inferOutcome && decisionFieldMissing(enriched, "choice") && decisionFieldMissing(enriched, "outcome")) ||
+        (!inferOutcome && decisionFieldMissing(enriched, "outcome"))) {
+        missingFields.push("outcome");
+    }
+    const downstreamReferences = decisionDownstreamReferences(enriched);
+    const caveats = [];
+    if (compacted)
+        caveats.push("Decision entry is compacted; full decision context is not available in this CLI result.");
+    if (missingFields.length > 0)
+        caveats.push("Decision entry is missing one or more full-detail context fields.");
+    if (downstreamReferences === null) {
+        caveats.push("No explicit downstream consequence references were present; none were inferred.");
+    }
+    const satisfaction = decisionSatisfactionContext(enriched);
+    if (satisfaction.review_needed) {
+        caveats.push("Decision satisfaction requires user review; missing legacy state is not treated as satisfied.");
+    }
+    enriched.satisfaction = satisfaction;
+    enriched.downstream_consequence_references = downstreamReferences;
+    enriched.context_complete =
+        !compacted && missingFields.length === 0 && downstreamReferences !== null && !satisfaction.review_needed;
+    enriched.missing_fields = missingFields;
+    enriched.compacted = compacted;
+    enriched.caveats = caveats;
+    return enriched;
+}
+export function decisionSourceContract(source, entries, filters) {
+    const sourceExists = Boolean(source.exists);
+    const activeFilters = Object.fromEntries(Object.entries(filters).filter(([, v]) => v !== null && v !== undefined));
+    const filteredNoMatch = sourceExists && Object.keys(activeFilters).length > 0 && entries.length === 0;
+    const compactedEntries = entries.filter((e) => e.compacted).length;
+    const entriesWithMissingFields = entries.filter((e) => Array.isArray(e.missing_fields) && e.missing_fields.length > 0).length;
+    const entriesWithoutDownstream = entries.filter((e) => e.downstream_consequence_references === null).length;
+    const entriesRequiringSatisfactionReview = entries.filter((e) => e.satisfaction && typeof e.satisfaction === "object" && !Array.isArray(e.satisfaction) && e.satisfaction.review_needed).length;
+    const userConfirmedSatisfied = entries.filter((e) => e.satisfaction &&
+        typeof e.satisfaction === "object" &&
+        !Array.isArray(e.satisfaction) &&
+        e.satisfaction.state === "user_confirmed_satisfied" &&
+        !e.satisfaction.review_needed).length;
+    const completeForReturned = sourceExists && entries.every((e) => e.context_complete === true);
+    const completeForNormalDeliberation = sourceExists;
+    const caveats = [
+        "Downstream consequence references are derived only from explicit structured feeds_into values; no references are inferred.",
+        "Compacted archive decisions are not expanded by this command and are not complete full-detail decision context.",
+    ];
+    if (!sourceExists)
+        caveats.push("Decision artifact is missing or unavailable; no decision context is available from this command result.");
+    if (filteredNoMatch)
+        caveats.push("Filtered result is empty; no returned decisions match the filter, but the decision artifact was available.");
+    if (entriesWithMissingFields)
+        caveats.push("One or more returned decisions are missing full-detail context fields.");
+    if (entriesWithoutDownstream)
+        caveats.push("One or more returned decisions lack explicit downstream consequence references.");
+    if (entriesRequiringSatisfactionReview)
+        caveats.push("One or more returned decisions require satisfaction review; satisfaction is never inferred from downstream references.");
+    return {
+        artifact: "decisions",
+        canonical_artifact_label: "decisions",
+        path: source.path,
+        complete_for_returned_decisions: completeForReturned,
+        complete_for_decision_context: completeForReturned,
+        complete_for_returned_full_detail: completeForReturned,
+        complete_for_normal_deliberation_context: completeForNormalDeliberation,
+        completeness: {
+            returned_decisions: entries.length,
+            context_complete: completeForReturned,
+            returned_full_detail_complete: completeForReturned,
+            normal_deliberation_context: completeForNormalDeliberation,
+            filtered_no_match: filteredNoMatch,
+            source_exists: sourceExists,
+            compacted_entries: compactedEntries,
+            entries_with_missing_fields: entriesWithMissingFields,
+            entries_without_downstream_references: entriesWithoutDownstream,
+            entries_requiring_satisfaction_review: entriesRequiringSatisfactionReview,
+            user_confirmed_satisfied_entries: userConfirmedSatisfied,
+        },
+        included_fields: [
+            ...DECISION_CONTEXT_FIELDS,
+            "outcome",
+            "downstream_consequence_references",
+            "context_complete",
+            "missing_fields",
+            "compacted",
+            "caveats",
+        ],
+        satisfaction_context: {
+            owner: "decision entry",
+            state_field: "satisfaction.state",
+            evidence_field: "satisfaction.evidence",
+            confirmation_field: "satisfaction.user_confirmation",
+            review_needed_field: "satisfaction.review_needed",
+            confirmation_policy: "Only satisfaction.state=user_confirmed_satisfied with explicit user_confirmation metadata is reported as user-confirmed satisfied.",
+            non_inference_policy: "Do not infer satisfaction from feeds_into, commits, downstream files, generated references, or compacted history.",
+        },
+        normal_deliberation_context: {
+            use_complete_for_normal_deliberation_context: true,
+            legacy_full_detail_signal: "complete_for_decision_context",
+            guidance: "For normal deliberation, use returned entries plus missing_fields, compacted, caveats, " +
+                "and satisfaction review state. Do not use the legacy full-detail completeness flag " +
+                "as a reason to reread the raw decision artifact.",
+        },
+        decision_context_truth_table: {
+            full_detail_entries: {
+                full_detail_complete: true,
+                normal_deliberation_context_complete: true,
+                raw_artifact_read_required: false,
+            },
+            compacted_archive_entries: {
+                full_detail_complete: false,
+                normal_deliberation_context_complete: true,
+                raw_artifact_read_required: false,
+                carry_forward: ["missing_fields", "compacted", "caveats"],
+            },
+            entries_with_missing_full_detail_fields: {
+                full_detail_complete: false,
+                normal_deliberation_context_complete: true,
+                raw_artifact_read_required: false,
+                carry_forward: ["missing_fields", "caveats"],
+            },
+            satisfaction_review_needed: {
+                full_detail_complete: false,
+                normal_deliberation_context_complete: true,
+                raw_artifact_read_required: false,
+                carry_forward: ["satisfaction.review_needed", "caveats"],
+            },
+            filtered_no_match: {
+                full_detail_complete: true,
+                normal_deliberation_context_complete: true,
+                raw_artifact_read_required: false,
+                meaning: "The artifact exists, but no returned decisions matched the filter.",
+            },
+            missing_or_unavailable_artifact: {
+                full_detail_complete: false,
+                normal_deliberation_context_complete: false,
+                raw_artifact_read_required: false,
+                meaning: "No decision state is available from the CLI result; use CLI fallback or diagnostics before raw artifact repair.",
+            },
+        },
+        missing_full_detail_boundary: {
+            applies_when: "returned decisions have missing_fields or context_complete=false",
+            normal_behavior: "Use present structured fields only and preserve missing_fields/caveats downstream.",
+            raw_artifact_read_required: false,
+            do_not: "Do not infer absent reasoning, alternatives, confidence, feeds_into, outcome, or downstream references.",
+        },
+        missing_artifact_boundary: {
+            applies_when: "source.exists=false",
+            normal_behavior: "Treat decision context as unavailable from this result; do not infer historical decisions.",
+            raw_artifact_read_required: false,
+            diagnostic_boundary: "Raw artifact access is reserved for explicit artifact repair/corruption or CLI-defect investigation.",
+        },
+        filtered_result_boundary: {
+            applies_when: "filters are present and entries=[] while source.exists=true",
+            normal_behavior: "Treat the result as no matching returned decisions, not as missing decision state.",
+            raw_artifact_read_required: false,
+        },
+        satisfaction_review_boundary: {
+            applies_when: "one or more entries have satisfaction.review_needed=true",
+            normal_behavior: "Carry satisfaction review pressure forward; only user confirmation can make a decision user-confirmed satisfied.",
+            raw_artifact_read_required: false,
+            do_not: "Do not infer satisfaction from downstream references, commits, generated files, or compacted history.",
+        },
+        compacted_history_boundary: {
+            applies_when: "returned entries have compacted=true",
+            normal_behavior: "Use the compact summary and retained fields; preserve compacted/missing_fields/caveats downstream.",
+            raw_artifact_read_required: false,
+            do_not: "Do not expand archive decisions or reconstruct missing context from git history.",
+        },
+        raw_artifact_access_boundary: {
+            normal_deliberation: "skip raw `.agentera/decisions.yaml` reads when complete_for_normal_deliberation_context=true",
+            allowed_raw_artifact_uses: [
+                "Discuss-owned decision writes or repairs",
+                "artifact corruption diagnostics",
+                "CLI defect investigation",
+            ],
+        },
+        raw_artifact_reads_required: false,
+        raw_artifact_read_policy: "Use `agentera state decisions list --limit 20 --format json` for bounded normal deliberation discovery; " +
+            "use `agentera state decisions get --number N --format json` for exact detail, and key normal use off " +
+            "complete_for_normal_deliberation_context. " +
+            "Do not read `.agentera/decisions.yaml` unless investigating artifact corruption or CLI defects; " +
+            "historical compacted gaps are exposed through missing_fields and caveats.",
+        caveats,
+        fallback_behavior: {
+            normal: "Use this command's entries and source_contract; no raw decision artifact read is required for returned full-detail or compacted decision entries.",
+            filtered_result: "The same per-decision guarantees apply after filters; an empty filtered result means no matching returned decisions.",
+            missing_or_incomplete: "If a required field is missing, treat only the present structured fields as authoritative and do not infer absent context.",
+            satisfaction: "Use only each entry's satisfaction object for satisfaction state. Missing, open, provisional, or unconfirmed satisfaction requires review and must not be reported as user-confirmed satisfied.",
+            compacted_history: "Compacted archive decisions are included with explicit missing_fields and caveats; treat absent historical context as unavailable during normal deliberation.",
+        },
+        fallback_policy: "If the decision artifact is missing or CLI state appears defective, use CLI fallback/diagnostic paths before raw artifact repair; do not raw-read merely because returned decisions are compacted or incomplete.",
+        filters: activeFilters,
+    };
+}
+export function queryDecisions(args, schemas, io) {
+    const o = out(io);
+    const e = err(io);
+    const info = schemas.decisions;
+    if (!info) {
+        e(missingSchemaError("decisions") + "\n");
+        return 1;
+    }
+    const p = artifactPath(info, "decisions");
+    const data = loadArtifact(p);
+    let entries = hydrateDecisionEntries(extractDecisionEntries(data));
+    const topic = args.topic ?? null;
+    if (topic)
+        entries = filterDecisionsByTopic(entries, topic, info.fields);
+    const format = args.format ?? "text";
+    if (format !== "text") {
+        const enriched = entries.map((entry) => decisionContextEntry(entry));
+        const source = sourceMetadata("decisions", p);
+        const filters = { topic };
+        return emitStateStructured("decisions", structuredState("decisions", enriched, source, {
+            filters,
+            sourceContract: decisionSourceContract(source, enriched, filters),
+        }), format, args.fields, o, e);
+    }
+    if (entries.length === 0)
+        return 0;
+    const disp = displayFields(info.fields);
+    for (const entry of entries) {
+        const parts = [];
+        for (const fn of disp) {
+            const v = entry[fn];
+            if (v !== null && v !== undefined && v !== "" && !Array.isArray(v) && typeof v !== "object") {
+                parts.push(`${fn}=${v}`);
+            }
+        }
+        if (parts.length > 0)
+            o(parts.join(" | ") + "\n");
+    }
+    return 0;
+}
+//# sourceMappingURL=decisions.js.map

package/dist/cli/commands/state/decisions.js.map

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

package/dist/cli/commands/state/docs.js

@@ -0,0 +1,97 @@
+/**
+ * `state docs` query (DOCS.md / docs.yaml).
+ *
+ * Returns the docs index (document, path, last_updated, status) and
+ * a source_contract that asserts
+ * `capability_startup_complete` so prime can skip raw
+ * `.agentera/docs.yaml` reads.
+ */
+import { asList, emitStateStructured, filterByFieldValue, formatEntry, loadArtifact, missingSchemaError, printStatusCounts, sourceMetadata, statusCounts, structuredState, truncate, } from "../../stateQuery.js";
+import { artifactPath, discoverSchemasDir } from "../../appContext.js";
+import fs from "node:fs";
+import { registryArtifactPath } from "../../orientation.js";
+import { capabilityStartupComplete } from "../../startupCompletenessContract.js";
+import { out, err } from "./shared.js";
+export function queryDocs(args, schemas, io) {
+    const o = out(io);
+    const e = err(io);
+    const profilePath = registryArtifactPath("profile", discoverSchemasDir());
+    const profileStatus = fs.existsSync(profilePath) ? "loaded" : "not found";
+    const info = schemas.docs;
+    if (!info) {
+        e(missingSchemaError("docs") + "\n");
+        return 1;
+    }
+    const p = artifactPath(info, "docs");
+    const data = loadArtifact(p);
+    const format = args.format ?? "text";
+    const isDict = data !== null && typeof data === "object" && !Array.isArray(data);
+    if (!isDict) {
+        if (format !== "text") {
+            return emitStateStructured("docs", structuredState("docs", [], sourceMetadata("docs", p), {
+                filters: { topic: args.topic ?? null, status: args.status ?? null },
+            }), format, args.fields, o, e);
+        }
+        return 0;
+    }
+    const d = data;
+    const legacyEntries = asList(d.entries);
+    if (legacyEntries.length > 0) {
+        let entries = legacyEntries;
+        const statusFilter = args.status ?? null;
+        if (statusFilter)
+            entries = filterByFieldValue(entries, "status", statusFilter);
+        if (format !== "text") {
+            return emitStateStructured("docs", structuredState("docs", entries, sourceMetadata("docs", p), { filters: { status: statusFilter } }), format, args.fields, o, e);
+        }
+        for (const entry of entries) {
+            const line = formatEntry(entry, ["last_audit", "document", "path", "status"]);
+            if (line)
+                o(line + "\n");
+        }
+        return 0;
+    }
+    const mapping = asList(d.mapping);
+    let index = asList(d.index);
+    const coverage = d.coverage && typeof d.coverage === "object" && !Array.isArray(d.coverage) ? d.coverage : {};
+    const conventions = d.conventions && typeof d.conventions === "object" && !Array.isArray(d.conventions) ? d.conventions : {};
+    const topic = args.topic ?? null;
+    if (topic) {
+        const t = topic.toLowerCase();
+        index = index.filter((entry) => String(entry.document ?? "").toLowerCase().includes(t) ||
+            String(entry.path ?? "").toLowerCase().includes(t) ||
+            String(entry.status ?? "").toLowerCase().includes(t));
+    }
+    const statusFilter = args.status ?? null;
+    if (statusFilter)
+        index = filterByFieldValue(index, "status", statusFilter);
+    if (format !== "text") {
+        return emitStateStructured("docs", structuredState("docs", index, sourceMetadata("docs", p), {
+            filters: { topic, status: statusFilter },
+            summary: {
+                last_audit: d.last_audit,
+                conventions,
+                mapping,
+                mapping_entries: mapping.length,
+                coverage,
+                source_contract: {
+                    capability_startup_complete: capabilityStartupComplete({ profileStatus }),
+                    raw_artifact_reads_required: false,
+                },
+            },
+        }), format, args.fields, o, e);
+    }
+    o(`Docs: last_audit=${d.last_audit ?? "-"}\n`);
+    o(`Mapping: entries=${mapping.length}\n`);
+    if (Object.keys(coverage).length > 0) {
+        o("Coverage: " + Object.entries(coverage).map(([k, v]) => `${k}=${truncate(v)}`).join(" | ") + "\n");
+    }
+    printStatusCounts("Docs status", statusCounts(index), o);
+    for (const entry of index.slice(0, 10)) {
+        const line = formatEntry(entry, ["document", "path", "last_updated", "status"]);
+        if (line)
+            o(line + "\n");
+    }
+    return 0;
+}
+//# sourceMappingURL=docs.js.map

package/dist/cli/commands/state/docs.js.map

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