@pyric/cli 0.1.0-alpha.9

package/dist/discover/merge.js

@@ -0,0 +1,394 @@
+/**
+ * Pure-data schema merge / inference for `firestore_discover_paths`.
+ *
+ * Validation-grade implementation promoted to production with the following
+ * additions:
+ *
+ *   1. Enum-candidate tracking on string/integer/double scalar fields
+ *      (Phase 3.2 lock — drives <select> codegen and discriminated unions).
+ *   2. Per-field example value (Phase 3.2 lock — drives form placeholders,
+ *      fixtures, README payloads).
+ *   3. `null` is never a peer entry in `types[]`; only `nullable` carries the
+ *      annotation (Phase 2.1 lock — suppresses redundant `type_expanded`
+ *      events for null observations).
+ *   4. SchemaChange enum aligned with the Phase 5 frozen list (`field_added`
+ *      replaces `new_key`; `array_grew` and `presence_dropped` removed —
+ *      array element growth surfaces as `type_expanded` with `'[]'` path
+ *      segment; presence shifts surface as `presence_changed`).
+ *
+ * Pure functions only — no Firestore SDK imports. Wire-format conversion
+ * lives in `wire.ts`; this module operates on already-typed observations.
+ */
+// ─── Constants ────────────────────────────────────────────────────────────
+/** Default enum-candidate distinct-value cap (Phase 3.2 lock). */
+export const DEFAULT_ENUM_THRESHOLD = 10;
+// ─── Empty schema ─────────────────────────────────────────────────────────
+export function emptySchema() {
+    return { fields: {}, samplesSeen: 0 };
+}
+// ─── Type key (for dedup; NaN-safe by construction) ───────────────────────
+/**
+ * Stable key for FieldType used in dedup. NaN/±Infinity all collapse to
+ * `s:double` so no special handling needed (Phase 1.2 lock).
+ */
+export function fieldTypeKey(t) {
+    switch (t.kind) {
+        case 'scalar':
+            return `s:${t.type}`;
+        case 'reference':
+            return `r:${t.targetCollection}`;
+        case 'vector':
+            return `v:${t.dimension}`;
+        case 'array': {
+            const inner = t.elementTypes.map(fieldTypeKey).sort().join('|');
+            return `a:[${inner}]`;
+        }
+        case 'map': {
+            const keys = Object.keys(t.fields).sort().join(',');
+            return `m:{${keys}}`;
+        }
+    }
+}
+function dedupTypes(types) {
+    const seen = new Map();
+    for (const t of types)
+        seen.set(fieldTypeKey(t), t);
+    return Array.from(seen.values());
+}
+// ─── Enum candidate helpers ───────────────────────────────────────────────
+/** True if a scalar field type is enum-eligible (string/int/double only). */
+function isEnumEligibleScalar(t) {
+    if (t.kind !== 'scalar')
+        return false;
+    return t.type === 'string' || t.type === 'integer' || t.type === 'double';
+}
+/**
+ * Merge a single field observation into an existing descriptor.
+ * `observation === 'absent'` means the field was missing from the doc.
+ * `newTotal` is the doc count after this observation.
+ */
+export function mergeDescriptorWithObservation(prev, observation, newTotal, path) {
+    if (observation === 'absent') {
+        // Field absent — bump total only. presence_changed is NOT emitted on
+        // every absence (would be noisy); callers fold presence into a separate
+        // sweep at finalization if needed.
+        return { merged: { ...prev, presenceTotal: newTotal }, changes: [] };
+    }
+    const { type: obs, isNull, example, enumSample } = observation;
+    const changes = [];
+    // Null observation: bump nullable + presenceSeen. Do NOT add `null` to
+    // types[] (Phase 2.1 lock). Emit `became_nullable` once, on the transition.
+    if (isNull) {
+        const becameNullable = !prev.nullable;
+        return {
+            merged: {
+                ...prev,
+                presenceSeen: prev.presenceSeen + 1,
+                presenceTotal: newTotal,
+                nullable: true,
+            },
+            changes: becameNullable ? [{ kind: 'became_nullable', path }] : [],
+        };
+    }
+    // Type union management (non-null observation).
+    //
+    // Container collapse rule: array and map kinds are SINGLETONS in the
+    // descriptor's types[] union — at most one array entry, at most one map
+    // entry. Element-type / field growth across observations merges into the
+    // existing container entry rather than creating a parallel union member.
+    // This is the Phase 5 lock: dropping `array_grew` in favor of
+    // `type_expanded` at `[..., '[]']` presumes arrays collapse this way.
+    // Vectors are NOT singletons — distinct dimensions stay distinct per
+    // Phase 1.2 vector-drift lock.
+    let mergedTypes = prev.types;
+    if (obs.kind === 'array') {
+        const existingIdx = prev.types.findIndex((t) => t.kind === 'array');
+        if (existingIdx !== -1) {
+            const existing = prev.types[existingIdx];
+            if (existing.kind === 'array') {
+                const result = mergeArrays(existing, obs, path);
+                const next = [...prev.types];
+                next[existingIdx] = result.merged;
+                mergedTypes = next;
+                changes.push(...result.changes);
+            }
+        }
+        else {
+            mergedTypes = [...prev.types, obs];
+            changes.push({ kind: 'type_expanded', path, addedType: obs });
+        }
+    }
+    else if (obs.kind === 'map') {
+        const existingIdx = prev.types.findIndex((t) => t.kind === 'map');
+        if (existingIdx !== -1) {
+            const existing = prev.types[existingIdx];
+            if (existing.kind === 'map') {
+                const result = mergeMaps(existing, obs, path);
+                const next = [...prev.types];
+                next[existingIdx] = result.merged;
+                mergedTypes = next;
+                changes.push(...result.changes);
+            }
+        }
+        else {
+            mergedTypes = [...prev.types, obs];
+            changes.push({ kind: 'type_expanded', path, addedType: obs });
+        }
+    }
+    else {
+        // Scalar / reference / vector union management. Vectors stay distinct
+        // per dimension (different keys for different dims) — that's the lock.
+        const obsKey = fieldTypeKey(obs);
+        const prevKeys = new Set(prev.types.map(fieldTypeKey));
+        if (!prevKeys.has(obsKey)) {
+            mergedTypes = dedupTypes([...prev.types, obs]);
+            if (obs.kind === 'vector' && prev.types.some((t) => t.kind === 'vector')) {
+                changes.push({
+                    kind: 'vector_dim_drift',
+                    path,
+                    addedDimension: obs.dimension,
+                });
+            }
+            else {
+                changes.push({ kind: 'type_expanded', path, addedType: obs });
+            }
+        }
+    }
+    // Enum candidate update. Drop if the type union widened past enum
+    // eligibility (more than one type, or non-eligible type added).
+    let enumCandidate = prev.enumCandidate;
+    const stillEnumEligible = mergedTypes.length === 1 && isEnumEligibleScalar(mergedTypes[0]);
+    if (!stillEnumEligible && enumCandidate) {
+        changes.push({ kind: 'enum_dropped', path, reason: 'type_widened' });
+        enumCandidate = undefined;
+    }
+    else if (stillEnumEligible && enumSample !== undefined) {
+        const result = updateEnumCandidate(enumCandidate, enumSample, path);
+        enumCandidate = result.next;
+        changes.push(...result.changes);
+    }
+    // Example: capture on first non-null observation. Don't overwrite once set
+    // (deterministic for codegen).
+    const nextExample = prev.example === undefined && example !== undefined ? example : prev.example;
+    return {
+        merged: {
+            types: mergedTypes,
+            presenceSeen: prev.presenceSeen + 1,
+            presenceTotal: newTotal,
+            nullable: prev.nullable,
+            enumCandidate,
+            example: nextExample,
+            reservedReason: prev.reservedReason,
+        },
+        changes,
+    };
+}
+// ─── Enum candidate state machine ─────────────────────────────────────────
+/**
+ * Progress an enum candidate by one observation. State transitions:
+ *
+ *   undefined     + new sample → tracking (1 value, no event)
+ *   tracking(1)   + same       → tracking (no event)
+ *   tracking(1)   + new        → tracking (2 values), emit `enum_added`
+ *   tracking(N>1) + new (N+1<=threshold) → tracking, emit `enum_widened`
+ *   tracking(N=threshold) + new → undefined, emit `enum_dropped(over_threshold)`
+ */
+function updateEnumCandidate(prev, sample, path) {
+    if (prev === undefined) {
+        // First sighting — start tracking silently. Single value isn't an enum yet.
+        return {
+            next: { qualifies: false, values: [sample], threshold: DEFAULT_ENUM_THRESHOLD },
+            changes: [],
+        };
+    }
+    if (prev.values.includes(sample)) {
+        return { next: prev, changes: [] };
+    }
+    // New value — does it fit?
+    if (prev.values.length >= prev.threshold) {
+        return {
+            next: undefined,
+            changes: [{ kind: 'enum_dropped', path, reason: 'over_threshold' }],
+        };
+    }
+    const nextValues = [...prev.values, sample];
+    const wasFirstAdd = prev.values.length === 1;
+    // Mark qualifies once we have 2+ distinct values (still under threshold).
+    const next = { qualifies: true, values: nextValues, threshold: prev.threshold };
+    if (wasFirstAdd) {
+        return {
+            next,
+            changes: [{ kind: 'enum_added', path, values: nextValues }],
+        };
+    }
+    return {
+        next,
+        changes: [{ kind: 'enum_widened', path, addedValue: sample }],
+    };
+}
+// ─── Container-type recursive merges ──────────────────────────────────────
+function mergeArrays(prev, obs, path) {
+    // Empty array no-op merge (Phase 1.2 lock).
+    if (obs.elementTypes.length === 0)
+        return { merged: prev, changes: [] };
+    if (prev.elementTypes.length === 0) {
+        return { merged: { kind: 'array', elementTypes: obs.elementTypes }, changes: [] };
+    }
+    const prevKeys = new Set(prev.elementTypes.map(fieldTypeKey));
+    const changes = [];
+    const merged = [...prev.elementTypes];
+    const elementPath = [...path, '[]'];
+    for (const et of obs.elementTypes) {
+        if (!prevKeys.has(fieldTypeKey(et))) {
+            merged.push(et);
+            // Array element-type expansion surfaces as `type_expanded` at the
+            // `[]` path segment per Phase 5 SchemaChange enum.
+            changes.push({ kind: 'type_expanded', path: elementPath, addedType: et });
+        }
+    }
+    return { merged: { kind: 'array', elementTypes: dedupTypes(merged) }, changes };
+}
+function mergeMaps(prev, obs, path) {
+    // Empty map no-op merge (Phase 1.2 lock).
+    if (Object.keys(obs.fields).length === 0)
+        return { merged: prev, changes: [] };
+    if (Object.keys(prev.fields).length === 0) {
+        return { merged: { kind: 'map', fields: { ...obs.fields } }, changes: [] };
+    }
+    const changes = [];
+    const fields = { ...prev.fields };
+    for (const [k, obsDesc] of Object.entries(obs.fields)) {
+        const prevDesc = fields[k];
+        if (!prevDesc) {
+            fields[k] = obsDesc;
+            changes.push({ kind: 'field_added', path: [...path, k], type: obsDesc.types[0] });
+            continue;
+        }
+        // Recurse on the single observed type.
+        const obsType = obsDesc.types[0];
+        const isNull = obsDesc.nullable && obsDesc.types.length === 0;
+        const subResult = mergeDescriptorWithObservation(prevDesc, {
+            type: obsType ?? { kind: 'scalar', type: 'null' },
+            isNull,
+            example: obsDesc.example,
+            enumSample: extractEnumSample(obsType, obsDesc.example),
+        }, prevDesc.presenceTotal + 1, [...path, k]);
+        fields[k] = subResult.merged;
+        changes.push(...subResult.changes);
+    }
+    return { merged: { kind: 'map', fields }, changes };
+}
+/** Best-effort extraction of an enum sample from a nested-map observation. */
+function extractEnumSample(type, example) {
+    if (!type || !isEnumEligibleScalar(type))
+        return undefined;
+    if (typeof example === 'string' || typeof example === 'number')
+        return example;
+    return undefined;
+}
+// ─── Top-level mergeDoc ───────────────────────────────────────────────────
+/**
+ * Merge a single document's typed field observations into a collection-level
+ * schema. Returns the next schema and the changes emitted.
+ *
+ * The wire layer (`wire.ts`) is responsible for converting Firestore wire
+ * values into the `Record<string, FieldObservation>` shape expected here.
+ */
+export function mergeDoc(prev, doc) {
+    const newTotal = prev.samplesSeen + 1;
+    const allKeys = new Set([...Object.keys(prev.fields), ...Object.keys(doc)]);
+    const fields = {};
+    const changes = [];
+    for (const k of allKeys) {
+        const prevDesc = prev.fields[k];
+        const obs = doc[k];
+        if (!prevDesc && obs) {
+            // First time seeing this key.
+            const isNull = obs.isNull;
+            const enumEligible = !isNull && isEnumEligibleScalar(obs.type);
+            const enumCandidate = enumEligible && obs.enumSample !== undefined
+                ? {
+                    qualifies: false,
+                    values: [obs.enumSample],
+                    threshold: DEFAULT_ENUM_THRESHOLD,
+                }
+                : undefined;
+            fields[k] = {
+                types: isNull ? [] : [obs.type],
+                presenceSeen: 1,
+                presenceTotal: newTotal,
+                nullable: isNull,
+                enumCandidate,
+                example: obs.example,
+            };
+            if (!isNull) {
+                changes.push({ kind: 'field_added', path: [k], type: obs.type });
+            }
+            else {
+                // Null-only first observation: emit field_added with null kind so
+                // agents see the field surfaced; nullable annotation handles the
+                // rest. No became_nullable on first observation — there's no prior
+                // non-null state to flip from.
+                changes.push({
+                    kind: 'field_added',
+                    path: [k],
+                    type: { kind: 'scalar', type: 'null' },
+                });
+            }
+            continue;
+        }
+        if (prevDesc && !obs) {
+            const result = mergeDescriptorWithObservation(prevDesc, 'absent', newTotal, [k]);
+            fields[k] = result.merged;
+            changes.push(...result.changes);
+            continue;
+        }
+        if (prevDesc && obs) {
+            const result = mergeDescriptorWithObservation(prevDesc, obs, newTotal, [k]);
+            fields[k] = result.merged;
+            changes.push(...result.changes);
+        }
+    }
+    return { next: { fields, samplesSeen: newTotal }, changes };
+}
+/**
+ * Stream-driven convergence runner. Used by the production crawler's
+ * sampling loop and by Phase 2.x tests that replay corpus snapshots.
+ *
+ * `stopOnStable` is the optimistic early-exit signal (Phase 2.1 lock — must
+ * be paired with a `maxSamples` hard cap in the crawler, not here).
+ */
+export function runConvergence(docs, stopOnStable) {
+    let schema = emptySchema();
+    let consecutiveStable = 0;
+    let declaredAt = null;
+    let totalChanges = 0;
+    const missedChangesAfterDeclared = [];
+    let i = 0;
+    for (const doc of docs) {
+        const { next, changes } = mergeDoc(schema, doc);
+        schema = next;
+        totalChanges += changes.length;
+        if (changes.length === 0) {
+            consecutiveStable++;
+            if (declaredAt === null && consecutiveStable >= stopOnStable) {
+                declaredAt = i;
+            }
+        }
+        else {
+            consecutiveStable = 0;
+            if (declaredAt !== null) {
+                missedChangesAfterDeclared.push(...changes);
+            }
+        }
+        i++;
+    }
+    return {
+        declaredAt,
+        totalDocs: i,
+        totalChanges,
+        finalSchema: schema,
+        missedChangesAfterDeclared,
+    };
+}
+//# sourceMappingURL=merge.js.map

package/dist/discover/merge.js.map

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

package/dist/discover/session.d.ts

@@ -0,0 +1,116 @@
+export declare const DEFAULT_MAX_SESSIONS = 8;
+export declare const DEFAULT_MAX_SESSION_BYTES: number;
+export declare const DEFAULT_TTL_MS: number;
+export type SessionErrorCode = 'SESSION_EXPIRED' | 'SESSION_EVICTED' | 'SESSION_PAYLOAD_TOO_LARGE' | 'SESSION_MALFORMED_TOKEN';
+export interface SessionError {
+    code: SessionErrorCode;
+    message: string;
+    recoveryHint: string;
+}
+/**
+ * A live session record. `state` is opaque to the store — Item 4.2 will
+ * instantiate `SessionStore` with the concrete crawler-state type.
+ */
+export interface SessionRecord<TState> {
+    /** Raw ULID — internal id; not the token surfaced to agents. */
+    readonly id: string;
+    /** Opaque continuation handle: `disc_<base64url-ulid>`. */
+    readonly token: string;
+    readonly createdAt: number;
+    /** Last get/update; drives both LRU eviction and TTL. */
+    lastAccessedAt: number;
+    /** Caller-reported payload size for byte-cap enforcement. */
+    bytes: number;
+    state: TState;
+}
+export interface SessionStoreOptions {
+    maxSessions?: number;
+    maxSessionBytes?: number;
+    ttlMs?: number;
+    /** Test seam — defaults to `Date.now`. */
+    now?: () => number;
+    /** Test seam — defaults to `crypto.randomBytes`. */
+    randomBytes?: (n: number) => Uint8Array;
+    evictionLogSize?: number;
+}
+/** Discriminated-union result so callers don't have to try/catch. */
+export type SessionResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: SessionError;
+};
+/**
+ * Encode a 16-byte ULID into a `disc_<base64url>` token. Internal — used
+ * by `SessionStore.create`.
+ */
+export declare function encodeToken(ulidBytes: Uint8Array): string;
+/**
+ * Decode a `disc_<base64url>` token. Returns `null` on any malformation
+ * — caller maps null to `SESSION_MALFORMED_TOKEN`.
+ */
+export declare function decodeToken(token: string): {
+    id: string;
+} | null;
+/**
+ * In-process LRU session store with TTL sweep and per-session byte cap.
+ *
+ * Eviction policy:
+ *   1. On every `create`/`get`/`update`, sweep TTL-expired sessions first.
+ *      Their tokens land in the eviction log as `SESSION_EXPIRED`.
+ *   2. If `create` would exceed `maxSessions`, evict the LRU
+ *      (oldest-by-`lastAccessedAt`). Its token lands in the eviction log
+ *      as `SESSION_EVICTED` so the displaced agent gets a meaningful
+ *      error on its next call.
+ *   3. `update` rejects with `SESSION_PAYLOAD_TOO_LARGE` if the new
+ *      `bytes` exceeds `maxSessionBytes` (per-session cap, not aggregate).
+ *
+ * The eviction log is a bounded ring buffer; once it overflows, evicted
+ * tokens degrade silently to `SESSION_EXPIRED` (still actionable — the
+ * recoveryHint is the same: re-issue without continuation).
+ */
+export declare class SessionStore<TState> {
+    private readonly maxSessions;
+    private readonly maxSessionBytes;
+    private readonly ttlMs;
+    private readonly evictionLogSize;
+    private readonly now;
+    private readonly rand;
+    private readonly sessions;
+    /** id → eviction reason. Bounded — see `recordEviction`. */
+    private readonly evictionLog;
+    constructor(opts?: SessionStoreOptions);
+    /** Live session count. */
+    get size(): number;
+    /**
+     * Create a new session. Always succeeds unless `bytes` exceeds the
+     * per-session byte cap. On cap-hit, evicts the LRU session — the
+     * displaced token will report `SESSION_EVICTED` on its next access.
+     */
+    create(state: TState, bytes: number): SessionResult<SessionRecord<TState>>;
+    /**
+     * Look up a session by token. Touches `lastAccessedAt` on success so
+     * subsequent reads keep the session warm. On expired/malformed/evicted
+     * tokens returns the appropriate structured error.
+     */
+    get(token: string): SessionResult<SessionRecord<TState>>;
+    /**
+     * Replace the state of an existing session. Same lookup/error model
+     * as `get`, plus per-session-bytes enforcement on the new payload.
+     */
+    update(token: string, state: TState, bytes: number): SessionResult<SessionRecord<TState>>;
+    /** Best-effort delete; returns true if a session was removed. */
+    delete(token: string): boolean;
+    /**
+     * Drop sessions whose `lastAccessedAt + ttlMs` is in the past.
+     * Returns the number of sessions evicted. Public for tests +
+     * future scheduled-sweep usage; `create`/`get`/`update` all call it
+     * lazily so callers don't normally need to.
+     */
+    sweepExpired(now?: number): number;
+    private evictLru;
+    private recordEviction;
+    private lookupEvicted;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/discover/session.d.ts.map

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