hippo-memory 0.36.0 → 0.37.0

package/dist/src/physics.js

@@ -0,0 +1,361 @@
+/**
+ * Memory-as-Physics engine for Hippo.
+ *
+ * Pure math module: forces, Velocity Verlet integration, physics-based scoring,
+ * and cluster amplification. No I/O — all state is passed in and returned.
+ *
+ * Memories are particles on the unit hypersphere in embedding space (384-dim).
+ * Forces act on them: query gravity (retrieval), inter-memory attraction,
+ * conflict repulsion, and drag (consolidation). Nearby high-scoring memories
+ * amplify each other via constructive interference.
+ */
+// ---------------------------------------------------------------------------
+// Vector math (hot path — kept inline for performance)
+// ---------------------------------------------------------------------------
+export function vecDot(a, b) {
+    let sum = 0;
+    for (let i = 0; i < a.length; i++)
+        sum += a[i] * b[i];
+    return sum;
+}
+export function vecNorm(v) {
+    return Math.sqrt(vecDot(v, v));
+}
+export function vecScale(v, s) {
+    const out = new Array(v.length);
+    for (let i = 0; i < v.length; i++)
+        out[i] = v[i] * s;
+    return out;
+}
+export function vecAdd(a, b) {
+    const out = new Array(a.length);
+    for (let i = 0; i < a.length; i++)
+        out[i] = a[i] + b[i];
+    return out;
+}
+export function vecSub(a, b) {
+    const out = new Array(a.length);
+    for (let i = 0; i < a.length; i++)
+        out[i] = a[i] - b[i];
+    return out;
+}
+export function vecZero(dim) {
+    return new Array(dim).fill(0);
+}
+/** Normalize to unit length. Returns zero vector if magnitude < epsilon. */
+export function vecNormalize(v) {
+    const mag = vecNorm(v);
+    if (mag < 1e-10)
+        return vecZero(v.length);
+    return vecScale(v, 1 / mag);
+}
+/** Clamp vector magnitude to maxMag. */
+export function vecClampMagnitude(v, maxMag) {
+    const mag = vecNorm(v);
+    if (mag <= maxMag)
+        return v;
+    return vecScale(v, maxMag / mag);
+}
+/** Cosine similarity between two vectors. */
+function cosine(a, b) {
+    if (a.length === 0 || b.length === 0 || a.length !== b.length)
+        return 0;
+    const dot = vecDot(a, b);
+    const na = vecNorm(a);
+    const nb = vecNorm(b);
+    if (na < 1e-10 || nb < 1e-10)
+        return 0;
+    return Math.min(1, Math.max(-1, dot / (na * nb)));
+}
+// ---------------------------------------------------------------------------
+// Property derivation from memory attributes
+// ---------------------------------------------------------------------------
+const CHARGE_MAP = {
+    neutral: 0,
+    positive: 0.3,
+    negative: -0.5,
+    critical: -1.0,
+};
+export function computeMass(strength, retrievalCount) {
+    return Math.max(0.01, strength * (1 + 0.1 * Math.log2(retrievalCount + 1)));
+}
+export function computeCharge(valence) {
+    return CHARGE_MAP[valence] ?? 0;
+}
+export function computeTemperature(ageDays, temperatureDecay) {
+    return 1 / (ageDays * temperatureDecay + 1);
+}
+// ---------------------------------------------------------------------------
+// Force computations
+// ---------------------------------------------------------------------------
+/**
+ * F1: Query gravity (retrieval-time, virtual — does not update position).
+ * Returns scalar force magnitude for ranking.
+ *
+ * F_query(i) = G_Q * mass(i) * max(0, cosine(pos_i, query))^2
+ */
+export function queryGravityMagnitude(particle, queryEmbedding, G_query) {
+    const cos = cosine(particle.position, queryEmbedding);
+    return G_query * particle.mass * Math.pow(Math.max(0, cos), 2);
+}
+/**
+ * Momentum bonus: how aligned is the particle's velocity with the query direction?
+ * Returns a value in [0, 1].
+ */
+export function velocityAlignmentBonus(particle, queryEmbedding) {
+    if (particle.velocity.length === 0 || particle.velocity.length !== queryEmbedding.length)
+        return 0;
+    const velMag = vecNorm(particle.velocity);
+    const qNorm = vecNorm(queryEmbedding);
+    if (velMag < 1e-10 || qNorm < 1e-10)
+        return 0;
+    const alignment = vecDot(particle.velocity, queryEmbedding) / (velMag * qNorm);
+    return Math.max(0, alignment);
+}
+/**
+ * F2: Inter-memory attraction force vector (consolidation-time).
+ * Attractive force from particle j on particle i.
+ *
+ * F_attract(i,j) = G_M * m_i * m_j * max(0, cosine(i,j))^3 * direction(j→i in embedding space)
+ *
+ * Direction is computed as the component of (pos_j - pos_i) that lies tangent to the
+ * unit sphere at pos_i (since we normalize positions back to the sphere after integration).
+ */
+export function attractionForce(pi, pj, G_memory) {
+    const cos = cosine(pi.position, pj.position);
+    if (cos <= 0)
+        return vecZero(pi.position.length);
+    const magnitude = G_memory * pi.mass * pj.mass * Math.pow(cos, 3);
+    // Direction: from i toward j (tangent projection handled by normalization after integration)
+    const direction = vecNormalize(vecSub(pj.position, pi.position));
+    return vecScale(direction, magnitude);
+}
+/**
+ * F3: Conflict repulsion force vector (consolidation-time).
+ * Repulsive force pushing i away from j.
+ *
+ * F_repel(i,j) = K_R * m_i * m_j / max(0.01, cosine_distance(i,j))^2
+ * where cosine_distance = 1 - cosine_similarity
+ */
+export function repulsionForce(pi, pj, K_repulsion) {
+    const cos = cosine(pi.position, pj.position);
+    const dist = Math.max(0.01, 1 - cos);
+    const magnitude = K_repulsion * pi.mass * pj.mass / (dist * dist);
+    // Direction: away from j
+    const direction = vecNormalize(vecSub(pi.position, pj.position));
+    return vecScale(direction, magnitude);
+}
+/**
+ * F4: Drag force vector (consolidation-time).
+ * F_drag(i) = -drag * velocity(i) / max(1, effective_half_life(i))
+ *
+ * effectiveHalfLife should be passed in from the memory's current half_life_days.
+ */
+export function dragForce(particle, drag, effectiveHalfLife) {
+    const damping = drag / Math.max(1, effectiveHalfLife);
+    return vecScale(particle.velocity, -damping);
+}
+/**
+ * Compute net force on particle i from all other particles + drag.
+ */
+function computeNetForce(i, particles, ctx) {
+    const pi = particles[i];
+    const dim = pi.position.length;
+    let net = vecZero(dim);
+    const conflicts = ctx.conflictPairs.get(pi.memoryId);
+    for (let j = 0; j < particles.length; j++) {
+        if (i === j)
+            continue;
+        const pj = particles[j];
+        // Attraction (all pairs)
+        const fa = attractionForce(pi, pj, ctx.config.G_memory);
+        net = vecAdd(net, fa);
+        // Repulsion (conflict pairs only)
+        if (conflicts?.has(pj.memoryId)) {
+            const fr = repulsionForce(pi, pj, ctx.config.K_repulsion);
+            net = vecAdd(net, fr);
+        }
+    }
+    // Drag
+    const fd = dragForce(pi, ctx.config.drag, ctx.halfLives.get(pi.memoryId) ?? 7);
+    net = vecAdd(net, fd);
+    return net;
+}
+/**
+ * Run one Velocity Verlet integration step for all particles.
+ * Mutates particles in place for performance.
+ */
+function verletStep(particles, accelerations, ctx) {
+    const dt = ctx.config.dt;
+    const maxVel = ctx.config.max_velocity;
+    for (let i = 0; i < particles.length; i++) {
+        const p = particles[i];
+        // Position update: pos += vel*dt + 0.5*accel*dt^2
+        const velDt = vecScale(p.velocity, dt);
+        const accelDt2 = vecScale(accelerations[i], 0.5 * dt * dt);
+        p.position = vecAdd(vecAdd(p.position, velDt), accelDt2);
+    }
+    // Compute new accelerations
+    const newAccelerations = [];
+    for (let i = 0; i < particles.length; i++) {
+        const force = computeNetForce(i, particles, ctx);
+        newAccelerations.push(vecScale(force, 1 / Math.max(0.01, particles[i].mass)));
+    }
+    // Velocity update: vel += 0.5*(accel_old + accel_new)*dt
+    for (let i = 0; i < particles.length; i++) {
+        const p = particles[i];
+        const avgAccel = vecScale(vecAdd(accelerations[i], newAccelerations[i]), 0.5);
+        p.velocity = vecAdd(p.velocity, vecScale(avgAccel, dt));
+        // Stability: clamp velocity and normalize position to unit sphere
+        p.velocity = vecClampMagnitude(p.velocity, maxVel);
+        p.position = vecNormalize(p.position);
+    }
+    // Update accelerations for next step
+    for (let i = 0; i < accelerations.length; i++) {
+        accelerations[i] = newAccelerations[i];
+    }
+}
+/**
+ * Run the full physics simulation for one sleep cycle.
+ * Mutates particles in place. Returns simulation statistics.
+ */
+export function simulate(particles, ctx) {
+    if (particles.length === 0) {
+        return {
+            particleCount: 0,
+            avgVelocityMagnitude: 0,
+            maxVelocityMagnitude: 0,
+            energy: { kinetic: 0, potential: 0, total: 0 },
+            substepsRun: 0,
+        };
+    }
+    // Initial accelerations
+    const accelerations = particles.map((_, i) => {
+        const force = computeNetForce(i, particles, ctx);
+        return vecScale(force, 1 / Math.max(0.01, particles[i].mass));
+    });
+    // Run substeps
+    for (let step = 0; step < ctx.config.substeps; step++) {
+        verletStep(particles, accelerations, ctx);
+    }
+    // Update timestamps
+    const now = new Date().toISOString();
+    for (const p of particles) {
+        p.lastSimulation = now;
+    }
+    // Compute stats
+    let sumVelMag = 0;
+    let maxVelMag = 0;
+    for (const p of particles) {
+        const mag = vecNorm(p.velocity);
+        sumVelMag += mag;
+        if (mag > maxVelMag)
+            maxVelMag = mag;
+    }
+    const energy = computeSystemEnergy(particles, ctx.config.G_memory);
+    return {
+        particleCount: particles.length,
+        avgVelocityMagnitude: sumVelMag / particles.length,
+        maxVelocityMagnitude: maxVelMag,
+        energy,
+        substepsRun: ctx.config.substeps,
+    };
+}
+// ---------------------------------------------------------------------------
+// System energy (health monitoring)
+// ---------------------------------------------------------------------------
+export function computeSystemEnergy(particles, G_memory) {
+    let kinetic = 0;
+    let potential = 0;
+    for (const p of particles) {
+        const velMag = vecNorm(p.velocity);
+        kinetic += 0.5 * p.mass * velMag * velMag;
+    }
+    for (let i = 0; i < particles.length; i++) {
+        for (let j = i + 1; j < particles.length; j++) {
+            const cos = cosine(particles[i].position, particles[j].position);
+            potential -= G_memory * particles[i].mass * particles[j].mass * Math.max(0, cos);
+        }
+    }
+    return { kinetic, potential, total: kinetic + potential };
+}
+// ---------------------------------------------------------------------------
+// Physics-based scoring (retrieval-time)
+// ---------------------------------------------------------------------------
+/**
+ * Score all particles against a query embedding using physics-based ranking.
+ * Does NOT modify particle positions (virtual force computation).
+ */
+export function physicsScore(particles, queryEmbedding, config) {
+    if (particles.length === 0 || queryEmbedding.length === 0)
+        return [];
+    // Pass 1: compute base scores
+    const results = particles.map((p) => {
+        const gravity = queryGravityMagnitude(p, queryEmbedding, config.G_query);
+        const momentum = config.momentum_weight * velocityAlignmentBonus(p, queryEmbedding);
+        return {
+            memoryId: p.memoryId,
+            baseScore: gravity + momentum,
+            clusterAmplification: 1.0,
+            finalScore: gravity + momentum,
+        };
+    });
+    // Sort by base score for top-K selection
+    results.sort((a, b) => b.baseScore - a.baseScore);
+    // Pass 2: cluster amplification on top K
+    applyClusterAmplification(results, particles, config);
+    // Re-sort by final score
+    results.sort((a, b) => b.finalScore - a.finalScore);
+    return results;
+}
+/**
+ * Cluster amplification: nearby high-scoring memories reinforce each other.
+ * Mutates results in place.
+ */
+function applyClusterAmplification(results, particles, config) {
+    const topK = Math.min(config.cluster_top_k, results.length);
+    if (topK < 2)
+        return;
+    // Build a quick lookup from memoryId to particle
+    const particleMap = new Map();
+    for (const p of particles)
+        particleMap.set(p.memoryId, p);
+    const top = results.slice(0, topK);
+    for (let i = 0; i < top.length; i++) {
+        const pi = particleMap.get(top[i].memoryId);
+        if (!pi)
+            continue;
+        let clusterSignal = 0;
+        for (let j = 0; j < top.length; j++) {
+            if (i === j)
+                continue;
+            const pj = particleMap.get(top[j].memoryId);
+            if (!pj)
+                continue;
+            const proximity = cosine(pi.position, pj.position);
+            if (proximity > config.cluster_threshold) {
+                clusterSignal += top[j].baseScore * proximity;
+            }
+        }
+        const amplification = 1 + Math.tanh(clusterSignal * config.interference_gain);
+        top[i].clusterAmplification = amplification;
+        top[i].finalScore = top[i].baseScore * amplification;
+    }
+}
+// ---------------------------------------------------------------------------
+// Outcome feedback (micro-nudge)
+// ---------------------------------------------------------------------------
+/**
+ * Nudge a particle's position toward (good outcome) or away from (bad outcome)
+ * the query embedding. Respects temperature: new memories respond more.
+ * Mutates particle in place.
+ */
+export function applyOutcomeFeedback(particle, queryEmbedding, good, feedbackAlpha) {
+    if (particle.position.length === 0 || particle.position.length !== queryEmbedding.length)
+        return;
+    const sign = good ? 1 : -1;
+    const direction = vecSub(queryEmbedding, particle.position);
+    const nudge = vecScale(direction, sign * feedbackAlpha * particle.temperature);
+    particle.position = vecNormalize(vecAdd(particle.position, nudge));
+}
+//# sourceMappingURL=physics.js.map

package/dist/src/physics.js.map

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

package/dist/src/postinstall.js

@@ -0,0 +1,68 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { ensureCodexWrapperInstalled } from './hooks.js';
+function main() {
+    if (process.env.HIPPO_SKIP_POSTINSTALL === '1')
+        return;
+    try {
+        ensureCodexWrapperInstalled();
+    }
+    catch {
+        // Never fail package install because auto-integration could not be applied.
+    }
+    try {
+        printClaudeCodeNudge();
+    }
+    catch {
+        // Never fail package install because the install hint could not be printed.
+    }
+}
+/**
+ * Read-only nudge: if Claude Code is detected on the machine and the Hippo
+ * UserPromptSubmit hook is NOT yet installed, print a short message pointing
+ * the user at `hippo init`. No config writes. Silent otherwise.
+ *
+ * We avoid aggressively auto-patching ~/.claude/settings.json from a package
+ * postinstall — that's surprising, breaks the principle of least authority,
+ * and trips security scanners. A one-line visible prompt is the friendly
+ * middle ground.
+ */
+function printClaudeCodeNudge() {
+    const home = os.homedir();
+    const claudeDir = path.join(home, '.claude');
+    if (!fs.existsSync(claudeDir))
+        return; // Claude Code not installed — silent
+    const settingsPath = path.join(claudeDir, 'settings.json');
+    if (fs.existsSync(settingsPath)) {
+        try {
+            const raw = fs.readFileSync(settingsPath, 'utf8');
+            if (raw.includes('hippo context --pinned-only'))
+                return; // already installed
+        }
+        catch {
+            // Fall through: on read failure, still show the nudge — a broken
+            // settings.json is a bigger problem for the user to see.
+        }
+    }
+    // Use stderr so the banner doesn't get piped into scripts reading package
+    // output on stdout.
+    const line = (s) => process.stderr.write(s + '\n');
+    line('');
+    line('hippo-memory installed. Claude Code detected on this machine.');
+    line('');
+    line('To wire Hippo into Claude Code (session hooks + mid-session pinned');
+    line('rule re-injection), run ONE of these in your project directory:');
+    line('');
+    line('    hippo init                  # initialize + install hooks for this project');
+    line('    hippo hook install claude-code   # hooks only, no local store');
+    line('');
+    line('Or machine-wide pinned memories:');
+    line('');
+    line('    hippo init --global');
+    line('');
+    line('To skip this message on future installs: export HIPPO_SKIP_POSTINSTALL=1');
+    line('');
+}
+main();
+//# sourceMappingURL=postinstall.js.map

package/dist/src/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../../src/postinstall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEzD,SAAS,IAAI;IACX,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,GAAG;QAAE,OAAO;IAEvD,IAAI,CAAC;QACH,2BAA2B,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;IAC9E,CAAC;IAED,IAAI,CAAC;QACH,oBAAoB,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;IAC9E,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,oBAAoB;IAC3B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,CAAC,qCAAqC;IAE5E,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,GAAG,CAAC,QAAQ,CAAC,6BAA6B,CAAC;gBAAE,OAAO,CAAC,oBAAoB;QAC/E,CAAC;QAAC,MAAM,CAAC;YACP,iEAAiE;YACjE,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,oBAAoB;IACpB,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACtE,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,oEAAoE,CAAC,CAAC;IAC3E,IAAI,CAAC,iEAAiE,CAAC,CAAC;IACxE,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,+EAA+E,CAAC,CAAC;IACtF,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAC1E,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,kCAAkC,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,0EAA0E,CAAC,CAAC;IACjF,IAAI,CAAC,EAAE,CAAC,CAAC;AACX,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/src/raw-archive.js

@@ -0,0 +1,72 @@
+import { isFtsAvailable } from './db.js';
+import { appendAuditEvent } from './audit.js';
+// JSON.stringify cannot serialize BigInt by default. node:sqlite returns INTEGER
+// columns as bigint when the value exceeds Number.MAX_SAFE_INTEGER. Coerce to
+// string so the audit payload is always serializable.
+function bigintSafeReplacer(_key, value) {
+    return typeof value === 'bigint' ? value.toString() : value;
+}
+/**
+ * The only legitimate path to remove a `kind='raw'` row from `memories`.
+ *
+ * Snapshots the full row into `raw_archive`, flips `kind` to `'archived'` so the
+ * append-only trigger lets the delete through, then deletes the row. All in one
+ * SAVEPOINT so it can be nested inside an outer transaction (e.g. batchWriteAndDelete).
+ *
+ * Throws if the row does not exist or is not `kind='raw'`.
+ */
+export function archiveRawMemory(db, id, opts) {
+    const row = db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id);
+    if (!row)
+        throw new Error(`memory not found: ${id}`);
+    if (row.kind !== 'raw') {
+        throw new Error(`memory ${id} is not raw (kind=${String(row.kind)})`);
+    }
+    // SAVEPOINT (not BEGIN) so this works whether or not we're already inside a
+    // transaction. SQLite refuses BEGIN within a transaction; SAVEPOINT nests safely.
+    db.exec('SAVEPOINT archive_raw');
+    try {
+        db.prepare(`INSERT INTO raw_archive (memory_id, archived_at, reason, archived_by, payload_json) VALUES (?, ?, ?, ?, ?)`).run(id, new Date().toISOString(), opts.reason, opts.who, JSON.stringify(row, bigintSafeReplacer));
+        // Flip kind to 'archived' so the BEFORE DELETE trigger no longer fires, then delete.
+        db.prepare(`UPDATE memories SET kind = 'archived' WHERE id = ?`).run(id);
+        db.prepare(`DELETE FROM memories WHERE id = ?`).run(id);
+        // FTS5 is a virtual table — no FK CASCADE applies. Purge the FTS row so the
+        // archived content is not searchable after archive. Without this the original
+        // raw text remains in memories_fts until the next DB-open backfill, defeating
+        // GDPR right-to-be-forgotten.
+        if (isFtsAvailable(db)) {
+            try {
+                db.prepare(`DELETE FROM memories_fts WHERE id = ?`).run(id);
+            }
+            catch {
+                // Best effort only. The DELETE on memories already succeeded; FTS will
+                // self-heal on next DB open via backfillFtsIndex.
+            }
+        }
+        // A5 audit: emit archive_raw event inside the SAVEPOINT so the audit row is
+        // committed atomically with the row deletion. Use the row's own tenant_id
+        // (fetched above as part of SELECT *), not the env. Archives must be
+        // attributed to the tenant that owns the row, not whatever HIPPO_TENANT
+        // happens to be set to in the calling shell.
+        try {
+            appendAuditEvent(db, {
+                tenantId: String(row.tenant_id ?? 'default'),
+                actor: opts.who || 'cli',
+                op: 'archive_raw',
+                targetId: id,
+                metadata: { reason: opts.reason },
+            });
+        }
+        catch {
+            // Audit must not crash the archive. Failures here mean the audit table
+            // is unwritable; the archive itself has already succeeded.
+        }
+        db.exec('RELEASE SAVEPOINT archive_raw');
+    }
+    catch (e) {
+        db.exec('ROLLBACK TO SAVEPOINT archive_raw');
+        db.exec('RELEASE SAVEPOINT archive_raw');
+        throw e;
+    }
+}
+//# sourceMappingURL=raw-archive.js.map

package/dist/src/raw-archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-archive.js","sourceRoot":"","sources":["../../src/raw-archive.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAO9C,iFAAiF;AACjF,8EAA8E;AAC9E,sDAAsD;AACtD,SAAS,kBAAkB,CAAC,IAAY,EAAE,KAAc;IACtD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAoB,EAAE,EAAU,EAAE,IAAiB;IAClF,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,GAAG,CAAC,EAAE,CAEvD,CAAC;IACd,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACrD,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,qBAAqB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,CAAC;IAED,4EAA4E;IAC5E,kFAAkF;IAClF,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,EAAE,CAAC,OAAO,CACR,4GAA4G,CAC7G,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACpG,qFAAqF;QACrF,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzE,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxD,4EAA4E;QAC5E,8EAA8E;QAC9E,8EAA8E;QAC9E,8BAA8B;QAC9B,IAAI,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9D,CAAC;YAAC,MAAM,CAAC;gBACP,uEAAuE;gBACvE,kDAAkD;YACpD,CAAC;QACH,CAAC;QACD,4EAA4E;QAC5E,0EAA0E;QAC1E,qEAAqE;QACrE,wEAAwE;QACxE,6CAA6C;QAC7C,IAAI,CAAC;YACH,gBAAgB,CAAC,EAAE,EAAE;gBACnB,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC;gBAC5C,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK;gBACxB,EAAE,EAAE,aAAa;gBACjB,QAAQ,EAAE,EAAE;gBACZ,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;aAClC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,2DAA2D;QAC7D,CAAC;QACD,EAAE,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,EAAE,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAC7C,EAAE,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QACzC,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}