@paths.design/caws-cli 10.2.0 → 11.1.0

package/dist/store/waivers-store.d.ts

@@ -0,0 +1,25 @@
+import { type Diagnostic, type Result, type Waiver } from '@paths.design/caws-kernel';
+export interface WaiversLoadResult {
+    readonly waivers: readonly Waiver[];
+    readonly diagnostics: readonly Diagnostic[];
+}
+export declare function loadWaivers(cawsDir: string): WaiversLoadResult;
+/**
+ * Write a waiver atomically to `.caws/waivers/<id>.yaml`. Refuses
+ * to overwrite an existing file (use markRevoked to update status).
+ */
+export declare function writeWaiver(cawsDir: string, waiver: Waiver, opts?: {
+    allowOverwrite?: boolean;
+}): Result<true>;
+/**
+ * Mark an existing waiver as revoked. Reads the existing file, builds a
+ * new in-memory waiver with status='revoked' and a revocation record,
+ * writes it back atomically. Refuses if the waiver is already revoked
+ * (caller decides whether to revisit revocation reason).
+ */
+export declare function markRevoked(cawsDir: string, id: string, args: {
+    now: Date;
+    revoked_by?: string;
+    reason?: string;
+}): Result<Waiver>;
+//# sourceMappingURL=waivers-store.d.ts.map

package/dist/store/waivers-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waivers-store.d.ts","sourceRoot":"","sources":["../../src/store/waivers-store.ts"],"names":[],"mappings":"AAiBA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,MAAM,EACX,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AAOnC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAcD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAiG9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,MAAM,CAAC,IAAI,CAAC,CA0Bd;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,MAAM,CAAC,MAAM,CAAC,CA0ChB"}

package/dist/store/waivers-store.js

@@ -0,0 +1,232 @@
+"use strict";
+// Waivers store.
+//
+// Loads every `*.yaml` / `*.yml` file directly under `.caws/waivers/`,
+// hands each source to the kernel's `validateWaiver`, and collects the
+// results.
+//
+// Discipline (mirrors specs-store):
+//   - Missing `.caws/waivers/` → `{ waivers: [], diagnostics: [] }`.
+//   - Non-YAML files → soft `non_yaml_skipped` diagnostic.
+//   - Invalid waiver file → diagnostic, valid waivers still load.
+//   - Duplicate waiver id → diagnostic; first occurrence wins.
+//   - Filename should equal `<id>.yaml`; mismatch → diagnostic (info).
+//   - Writes are atomic via writeFileAtomic.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadWaivers = loadWaivers;
+exports.writeWaiver = writeWaiver;
+exports.markRevoked = markRevoked;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const caws_kernel_1 = require("@paths.design/caws-kernel");
+const atomic_write_1 = require("./atomic-write");
+const repo_root_1 = require("./repo-root");
+const rules_1 = require("./rules");
+const yaml_store_1 = require("./yaml-store");
+function isYamlPath(name) {
+    return name.endsWith('.yaml') || name.endsWith('.yml');
+}
+function waiversDirPath(cawsDir) {
+    return path.join(cawsDir, 'waivers');
+}
+function waiverFilePath(cawsDir, id) {
+    return path.join(waiversDirPath(cawsDir), `${id}.yaml`);
+}
+function loadWaivers(cawsDir) {
+    const waiversDir = waiversDirPath(cawsDir);
+    if (!fs.existsSync(waiversDir)) {
+        return { waivers: [], diagnostics: [] };
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(waiversDir, { withFileTypes: true });
+    }
+    catch (e) {
+        const cause = e;
+        return {
+            waivers: [],
+            diagnostics: [
+                (0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_IO_FAILED, `Failed to read ${waiversDir}: ${cause.message ?? 'unknown error'}.`, cause.code !== undefined
+                    ? { subject: waiversDir, data: { code: cause.code } }
+                    : { subject: waiversDir }),
+            ],
+        };
+    }
+    const validWaivers = [];
+    const diagnostics = [];
+    const seenIds = new Map(); // id → first-seen file path
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const fullPath = path.join(waiversDir, entry.name);
+        if (!isYamlPath(entry.name)) {
+            diagnostics.push((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_NON_YAML_SKIPPED, `Skipping non-YAML file in .caws/waivers/: ${entry.name}.`, { subject: fullPath }));
+            continue;
+        }
+        const source = (0, yaml_store_1.readYamlFile)(fullPath);
+        if (!(0, caws_kernel_1.isOk)(source)) {
+            diagnostics.push(...source.errors);
+            continue;
+        }
+        const result = (0, caws_kernel_1.validateWaiver)(source.value);
+        if (!(0, caws_kernel_1.isOk)(result)) {
+            // Annotate with the file we were reading so doctor can repair.
+            for (const e of result.errors) {
+                diagnostics.push({ ...e, subject: e.subject ?? fullPath });
+            }
+            continue;
+        }
+        const waiver = result.value;
+        const prev = seenIds.get(waiver.id);
+        if (prev !== undefined) {
+            diagnostics.push((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_DUPLICATE_ID, `Duplicate waiver id ${waiver.id}: first seen in ${prev}, second in ${fullPath}.`, {
+                subject: fullPath,
+                data: { waiver_id: waiver.id, first_seen: prev, duplicate: fullPath },
+            }));
+            continue;
+        }
+        seenIds.set(waiver.id, fullPath);
+        // Filename should equal `<id>.yaml`. This isn't an error (the kernel
+        // doesn't care about filenames), but it's a hygiene info diagnostic
+        // so doctor can spot drift.
+        const expectedName = `${waiver.id}.yaml`;
+        if (entry.name !== expectedName) {
+            diagnostics.push({
+                ...(0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_FILENAME_MISMATCH, `Waiver file ${entry.name} does not match id ${waiver.id} (expected ${expectedName}).`, { subject: fullPath, data: { id: waiver.id, expected: expectedName } }),
+                severity: 'info',
+            });
+        }
+        validWaivers.push(waiver);
+    }
+    return { waivers: validWaivers, diagnostics };
+}
+/**
+ * Write a waiver atomically to `.caws/waivers/<id>.yaml`. Refuses
+ * to overwrite an existing file (use markRevoked to update status).
+ */
+function writeWaiver(cawsDir, waiver, opts = {}) {
+    const waiversDir = waiversDirPath(cawsDir);
+    try {
+        fs.mkdirSync(waiversDir, { recursive: true });
+    }
+    catch (e) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WRITE_IO_FAILED, `Failed to create ${waiversDir}: ${e.message}.`, { subject: waiversDir }));
+    }
+    const filePath = waiverFilePath(cawsDir, waiver.id);
+    if (!opts.allowOverwrite && fs.existsSync(filePath)) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_ALREADY_EXISTS, `Waiver ${waiver.id} already exists at ${filePath}.`, { subject: filePath, data: { id: waiver.id } }));
+    }
+    return (0, atomic_write_1.writeFileAtomic)(filePath, serializeWaiver(waiver));
+}
+/**
+ * Mark an existing waiver as revoked. Reads the existing file, builds a
+ * new in-memory waiver with status='revoked' and a revocation record,
+ * writes it back atomically. Refuses if the waiver is already revoked
+ * (caller decides whether to revisit revocation reason).
+ */
+function markRevoked(cawsDir, id, args) {
+    const filePath = waiverFilePath(cawsDir, id);
+    if (!fs.existsSync(filePath)) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_NOT_FOUND, `Waiver ${id} not found at ${filePath}.`, { subject: filePath, data: { id } }));
+    }
+    const source = (0, yaml_store_1.readYamlFile)(filePath);
+    if (!(0, caws_kernel_1.isOk)(source))
+        return source;
+    const validated = (0, caws_kernel_1.validateWaiver)(source.value);
+    if (!(0, caws_kernel_1.isOk)(validated))
+        return validated;
+    const existing = validated.value;
+    if (existing.status === 'revoked') {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_ALREADY_EXISTS, `Waiver ${id} is already revoked.`, { subject: filePath, data: { id } }));
+    }
+    const revoked = {
+        ...existing,
+        status: 'revoked',
+        revocation: {
+            revoked_at: args.now.toISOString(),
+            ...(args.revoked_by !== undefined ? { revoked_by: args.revoked_by } : {}),
+            ...(args.reason !== undefined ? { reason: args.reason } : {}),
+        },
+    };
+    const write = (0, atomic_write_1.writeFileAtomic)(filePath, serializeWaiver(revoked));
+    if (!(0, caws_kernel_1.isOk)(write))
+        return write;
+    return (0, caws_kernel_1.ok)(revoked);
+}
+/**
+ * Serialize a waiver to YAML. Deterministic field order so the file is
+ * stable on disk. Built by hand to avoid YAML alias churn (the existing
+ * specs use a similar controlled-serialization approach).
+ */
+function serializeWaiver(w) {
+    const lines = [];
+    lines.push(`id: ${w.id}`);
+    lines.push(`title: ${yamlQuote(w.title)}`);
+    lines.push(`status: ${w.status}`);
+    lines.push('gates:');
+    for (const g of w.gates)
+        lines.push(`  - ${g}`);
+    lines.push(`reason: ${yamlQuote(w.reason)}`);
+    lines.push(`approved_by: ${yamlQuote(w.approved_by)}`);
+    lines.push(`created_at: ${yamlQuote(w.created_at)}`);
+    lines.push(`expires_at: ${yamlQuote(w.expires_at)}`);
+    if (w.scope !== undefined) {
+        lines.push('scope:');
+        if (w.scope.spec_id !== undefined)
+            lines.push(`  spec_id: ${w.scope.spec_id}`);
+    }
+    if (w.constraints !== undefined) {
+        lines.push('constraints:');
+        if (w.constraints.max_uses !== undefined)
+            lines.push(`  max_uses: ${w.constraints.max_uses}`);
+    }
+    if (w.revocation !== undefined) {
+        lines.push('revocation:');
+        lines.push(`  revoked_at: ${yamlQuote(w.revocation.revoked_at)}`);
+        if (w.revocation.revoked_by !== undefined)
+            lines.push(`  revoked_by: ${yamlQuote(w.revocation.revoked_by)}`);
+        if (w.revocation.reason !== undefined)
+            lines.push(`  reason: ${yamlQuote(w.revocation.reason)}`);
+    }
+    return lines.join('\n') + '\n';
+}
+function yamlQuote(value) {
+    // Conservative: always single-quote strings, doubling internal single quotes.
+    // This avoids the YAML "is this an integer/date/bool?" ambiguity entirely.
+    return `'${value.replace(/'/g, "''")}'`;
+}
+//# sourceMappingURL=waivers-store.js.map

package/dist/store/waivers-store.js.map

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

package/dist/store/worktrees-store.d.ts

@@ -0,0 +1,3 @@
+import { type Result, type WorktreeRegistry } from '@paths.design/caws-kernel';
+export declare function loadWorktrees(cawsDir: string): Result<WorktreeRegistry>;
+//# sourceMappingURL=worktrees-store.d.ts.map

package/dist/store/worktrees-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktrees-store.d.ts","sourceRoot":"","sources":["../../src/store/worktrees-store.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAKnC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAoBvE"}

package/dist/store/worktrees-store.js

@@ -0,0 +1,62 @@
+"use strict";
+// Worktrees registry loader.
+//
+// Reads `.caws/worktrees.json`. Missing file → empty registry. Malformed
+// JSON or non-object payload → Err. Shape validation is shallow; the
+// kernel's worktree module reasons about the structured shape.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadWorktrees = loadWorktrees;
+const path = __importStar(require("path"));
+const caws_kernel_1 = require("@paths.design/caws-kernel");
+const json_store_1 = require("./json-store");
+const repo_root_1 = require("./repo-root");
+const rules_1 = require("./rules");
+function loadWorktrees(cawsDir) {
+    const filePath = path.join(cawsDir, 'worktrees.json');
+    const r = (0, json_store_1.readJsonFile)(filePath);
+    if (!(0, caws_kernel_1.isOk)(r)) {
+        if (r.errors.some((e) => e.rule === rules_1.STORE_RULES.READ_MISSING_FILE)) {
+            return (0, caws_kernel_1.ok)({});
+        }
+        return (0, caws_kernel_1.err)(r.errors);
+    }
+    const value = r.value;
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.REGISTRY_NOT_OBJECT, `worktrees.json is not a JSON object.`, { subject: filePath }));
+    }
+    return (0, caws_kernel_1.ok)(value);
+}
+//# sourceMappingURL=worktrees-store.js.map

package/dist/store/worktrees-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktrees-store.js","sourceRoot":"","sources":["../../src/store/worktrees-store.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AACrE,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAc/D,sCAoBC;AAhCD,2CAA6B;AAC7B,2DAMmC;AACnC,6CAA4C;AAC5C,2CAA8C;AAC9C,mCAAsC;AAEtC,SAAgB,aAAa,CAAC,OAAe;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,IAAA,yBAAY,EAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,IAAA,kBAAI,EAAC,CAAC,CAAC,EAAE,CAAC;QACb,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAW,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACnE,OAAO,IAAA,gBAAE,EAAC,EAAE,CAAC,CAAC;QAChB,CAAC;QACD,OAAO,IAAA,iBAAG,EAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,IAAA,iBAAG,EACR,IAAA,2BAAe,EACb,mBAAW,CAAC,mBAAmB,EAC/B,sCAAsC,EACtC,EAAE,OAAO,EAAE,QAAQ,EAAE,CACtB,CACF,CAAC;IACJ,CAAC;IACD,OAAO,IAAA,gBAAE,EAAC,KAAyB,CAAC,CAAC;AACvC,CAAC"}

package/dist/store/worktrees-writer.d.ts

@@ -0,0 +1,77 @@
+import { type EventBody, type Result, type SessionIdentity, type Diagnostic } from '@paths.design/caws-kernel';
+import { loadSpecs } from './specs-store';
+export interface CreateWorktreeInput {
+    readonly name: string;
+    readonly specId: string;
+    /** Optional: base branch for the new worktree. Defaults to repo HEAD's
+     *  current branch. */
+    readonly baseBranch?: string;
+    /** Optional: new branch name for the worktree. Defaults to the
+     *  worktree name. */
+    readonly branch?: string;
+    readonly session: SessionIdentity;
+    readonly actor: EventBody['actor'];
+    readonly now?: () => Date;
+}
+export interface BindWorktreeInput {
+    readonly name: string;
+    readonly specId: string;
+    readonly session: SessionIdentity;
+    readonly actor: EventBody['actor'];
+    readonly now?: () => Date;
+}
+export interface DestroyWorktreeInput {
+    readonly name: string;
+    readonly session: SessionIdentity;
+    readonly actor: EventBody['actor'];
+    readonly now?: () => Date;
+    /** Allow destruction even when the branch is not merged into base.
+     *  Default false. There is intentionally NO --force; this is the
+     *  one explicit override and it does not bypass ownership. */
+    readonly abandonUnmerged?: boolean;
+}
+export interface MergeWorktreeInput {
+    readonly name: string;
+    readonly session: SessionIdentity;
+    readonly actor: EventBody['actor'];
+    readonly now?: () => Date;
+    /** When true, perform validation only; no git operations, no file
+     *  writes, no event appends. */
+    readonly dryRun?: boolean;
+    /** Optional commit message for the merge commit. Defaults to a
+     *  conventional "merge(worktree): <name>" form. */
+    readonly message?: string;
+}
+export type WorktreeWriterOutcome = {
+    readonly kind: 'success';
+    readonly name: string;
+    readonly action: 'created' | 'bound' | 'destroyed' | 'merged';
+    readonly data?: Record<string, unknown>;
+} | {
+    readonly kind: 'dry_run';
+    readonly name: string;
+    readonly canProceed: boolean;
+    readonly findings: readonly string[];
+} | {
+    readonly kind: 'partial_failure_recovered';
+    readonly cause: readonly Diagnostic[];
+};
+export declare function createWorktree(cawsDir: string, input: CreateWorktreeInput): Result<WorktreeWriterOutcome>;
+export declare function bindWorktreeRepair(cawsDir: string, input: BindWorktreeInput): Result<WorktreeWriterOutcome>;
+export declare function destroyWorktree(cawsDir: string, input: DestroyWorktreeInput): Result<WorktreeWriterOutcome>;
+export declare function mergeWorktree(cawsDir: string, input: MergeWorktreeInput): Result<WorktreeWriterOutcome>;
+export interface WorktreeListEntry {
+    readonly name: string;
+    readonly path: string;
+    readonly branch: string;
+    readonly baseBranch: string;
+    readonly specId: string | null;
+    readonly owner: SessionIdentity | null;
+    readonly status: 'active' | 'unknown';
+}
+export interface WorktreeListResult {
+    readonly entries: readonly WorktreeListEntry[];
+}
+export declare function listWorktreesPretty(cawsDir: string): Result<WorktreeListResult>;
+export { loadSpecs };
+//# sourceMappingURL=worktrees-writer.d.ts.map

package/dist/store/worktrees-writer.d.ts.map

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