@they-juanreina/compost-cli 0.1.0-rc.1

package/dist/lib/snap.js

@@ -0,0 +1,115 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CompostError } from '../errors.js';
+const FRAME_WIDTH = 640;
+const FRAME_HEIGHT = 360;
+/** Parse mm:ss, hh:mm:ss, or raw ms (integer) into milliseconds. */
+export function parseTimestamp(input) {
+    const raw = input.trim();
+    if (/^\d+$/.test(raw))
+        return Number(raw);
+    const parts = raw.split(':');
+    if (parts.length === 2 || parts.length === 3) {
+        const nums = parts.map((p) => {
+            if (!/^\d+(\.\d+)?$/.test(p))
+                throw new CompostError('INVALID_INPUT', `Bad time component "${p}"`);
+            return Number(p);
+        });
+        let seconds = 0;
+        if (nums.length === 3)
+            seconds = nums[0] * 3600 + nums[1] * 60 + nums[2];
+        else
+            seconds = nums[0] * 60 + nums[1];
+        return Math.round(seconds * 1000);
+    }
+    throw new CompostError('INVALID_INPUT', `Unrecognized timestamp "${input}" (use ms, mm:ss, or hh:mm:ss)`);
+}
+function padMs(ms) {
+    return String(ms).padStart(9, '0');
+}
+function findSource(sessionDir) {
+    if (!existsSync(sessionDir))
+        return null;
+    const match = readdirSync(sessionDir).find((f) => f.startsWith('source.'));
+    return match !== undefined ? join(sessionDir, match) : null;
+}
+function hasVideoStream(path, runner) {
+    try {
+        const out = runner('ffprobe', [
+            '-v',
+            'error',
+            '-select_streams',
+            'v:0',
+            '-show_entries',
+            'stream=codec_type',
+            '-of',
+            'csv=p=0',
+            path,
+        ]);
+        return out.trim().includes('video');
+    }
+    catch {
+        return false;
+    }
+}
+const defaultRunner = (cmd, args) => execFileSync(cmd, args, { encoding: 'utf8' });
+export function snap(seedPath, sessionId, at, opts = {}) {
+    const runner = opts.runner ?? defaultRunner;
+    const atMs = parseTimestamp(at);
+    const sessionDir = join(seedPath, 'sessions', sessionId);
+    const source = findSource(sessionDir);
+    if (source === null) {
+        throw new CompostError('FILE_NOT_FOUND', `No source media in ${sessionDir}`);
+    }
+    if (!hasVideoStream(source, runner)) {
+        throw new CompostError('INVALID_INPUT', `${source} has no video stream; cannot snap a frame`);
+    }
+    const rel = `sessions/${sessionId}/frames/${padMs(atMs)}.jpg`;
+    const absPath = join(seedPath, rel);
+    const frameId = `FR-${padMs(atMs)}`;
+    if (existsSync(absPath)) {
+        return { session_id: sessionId, frame_id: frameId, at_ms: atMs, path: rel, existed: true };
+    }
+    mkdirSync(join(sessionDir, 'frames'), { recursive: true });
+    runner('ffmpeg', [
+        '-y',
+        '-ss',
+        (atMs / 1000).toFixed(3),
+        '-i',
+        source,
+        '-frames:v',
+        '1',
+        '-vf',
+        `scale=${FRAME_WIDTH}:${FRAME_HEIGHT}`,
+        '-q:v',
+        '4',
+        absPath,
+    ]);
+    if (!existsSync(absPath)) {
+        throw new CompostError('IO_ERROR', `ffmpeg did not produce a frame at ${atMs}ms`);
+    }
+    indexFrame(sessionDir, { id: frameId, at_ms: atMs, path: rel, trigger: 'manual' });
+    return { session_id: sessionId, frame_id: frameId, at_ms: atMs, path: rel, existed: false };
+}
+/** Append a frame entry to transcript.json frames[] when present, otherwise to
+ * a frames.json sidecar that the transcriber merges on the next run. */
+function indexFrame(sessionDir, entry) {
+    const transcriptPath = join(sessionDir, 'transcript.json');
+    if (existsSync(transcriptPath)) {
+        const t = JSON.parse(readFileSync(transcriptPath, 'utf8'));
+        t.frames = t.frames ?? [];
+        if (!t.frames.some((f) => f.id === entry.id))
+            t.frames.push(entry);
+        writeFileSync(transcriptPath, `${JSON.stringify(t, null, 2)}\n`, 'utf8');
+        return;
+    }
+    const sidecar = join(sessionDir, 'frames.json');
+    const frames = existsSync(sidecar)
+        ? JSON.parse(readFileSync(sidecar, 'utf8'))
+        : [];
+    if (!frames.some((f) => f.id === entry.id))
+        frames.push(entry);
+    writeFileSync(sidecar, `${JSON.stringify(frames, null, 2)}\n`, 'utf8');
+}
+//# sourceMappingURL=snap.js.map

package/dist/lib/snap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snap.js","sourceRoot":"","sources":["../../src/lib/snap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAU3C,MAAM,WAAW,GAAG,GAAG,CAAA;AACvB,MAAM,YAAY,GAAG,GAAG,CAAA;AAExB,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IACxB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1B,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,uBAAuB,CAAC,GAAG,CAAC,CAAA;YACtE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;QAClB,CAAC,CAAC,CAAA;QACF,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,IAAI,CAAC,CAAC,CAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAE,CAAA;;YACtE,OAAO,GAAG,IAAI,CAAC,CAAC,CAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAE,CAAA;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACnC,CAAC;IACD,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,2BAA2B,KAAK,gCAAgC,CACjE,CAAA;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AACpC,CAAC;AAED,SAAS,UAAU,CAAC,UAAkB;IACpC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAA;IACxC,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;IAC1E,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC7D,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,MAAc;IAClD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,EAAE;YAC5B,IAAI;YACJ,OAAO;YACP,iBAAiB;YACjB,KAAK;YACL,eAAe;YACf,mBAAmB;YACnB,KAAK;YACL,SAAS;YACT,IAAI;SACL,CAAC,CAAA;QACF,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAID,MAAM,aAAa,GAAW,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;AAM1F,MAAM,UAAU,IAAI,CAClB,QAAgB,EAChB,SAAiB,EACjB,EAAU,EACV,OAAoB,EAAE;IAEtB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,aAAa,CAAA;IAC3C,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,CAAC,CAAA;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,sBAAsB,UAAU,EAAE,CAAC,CAAA;IAC9E,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,GAAG,MAAM,2CAA2C,CAAC,CAAA;IAC/F,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,SAAS,WAAW,KAAK,CAAC,IAAI,CAAC,MAAM,CAAA;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACnC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,CAAA;IAEnC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC5F,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1D,MAAM,CAAC,QAAQ,EAAE;QACf,IAAI;QACJ,KAAK;QACL,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACxB,IAAI;QACJ,MAAM;QACN,WAAW;QACX,GAAG;QACH,KAAK;QACL,SAAS,WAAW,IAAI,YAAY,EAAE;QACtC,MAAM;QACN,GAAG;QACH,OAAO;KACR,CAAC,CAAA;IACF,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,qCAAqC,IAAI,IAAI,CAAC,CAAA;IACnF,CAAC;IAED,UAAU,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;IAClF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;AAC7F,CAAC;AASD;wEACwE;AACxE,SAAS,UAAU,CAAC,UAAkB,EAAE,KAAiB;IACvD,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAA;IAC1D,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAA8B,CAAA;QACvF,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAA;QACzB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;YAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClE,aAAa,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACxE,OAAM;IACR,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;IAC/C,MAAM,MAAM,GAAiB,UAAU,CAAC,OAAO,CAAC;QAC9C,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAkB;QAC7D,CAAC,CAAC,EAAE,CAAA;IACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC9D,aAAa,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AACxE,CAAC"}

package/dist/lib/status.d.ts

@@ -0,0 +1,39 @@
+export interface SessionCounts {
+    total: number;
+    transcribed: number;
+    queued: number;
+    inbox: number;
+}
+export interface SeedCounts {
+    sessions: SessionCounts;
+    highlights: number;
+    codes: number;
+    themes: number;
+    frames: number;
+    insights: number;
+    legacy_assets: number;
+}
+export interface SeedStatus {
+    name: string;
+    path: string;
+    status: string | null;
+    owners: string[];
+    created_at: string | null;
+    counts: SeedCounts;
+    /** Non-canonical content found under the seed (e.g. legacy folders that
+     * survived migration). Empty when the seed is clean. */
+    warnings: string[];
+}
+export interface StatusSnapshot {
+    schema_version: '1.0';
+    generated_at: string;
+    root: string;
+    seeds: SeedStatus[];
+}
+export interface StatusOptions {
+    cwd?: string;
+    seed?: string;
+    now?: () => Date;
+}
+export declare function gatherStatus(opts?: StatusOptions): StatusSnapshot;
+//# sourceMappingURL=status.d.ts.map

package/dist/lib/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/lib/status.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,EAAE,UAAU,CAAA;IAClB;4DACwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,KAAK,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,aAAkB,GAAG,cAAc,CAgCrE"}

package/dist/lib/status.js

@@ -0,0 +1,174 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { CompostError } from '../errors.js';
+import { isCanonicalSession } from './canonicalSessions.js';
+export function gatherStatus(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const now = (opts.now ?? (() => new Date()))();
+    const root = resolve(cwd, 'Seeds');
+    if (!existsSync(root)) {
+        throw new CompostError('NOT_IN_SEED', `No Seeds/ directory at ${root}. Run \`compost init <name>\` first.`);
+    }
+    const seedNames = readdirSync(root).filter((entry) => {
+        if (entry.startsWith('.'))
+            return false;
+        return statSync(join(root, entry)).isDirectory();
+    });
+    const filtered = opts.seed !== undefined ? seedNames.filter((n) => n === opts.seed) : seedNames;
+    if (opts.seed !== undefined && filtered.length === 0) {
+        throw new CompostError('NOT_IN_SEED', `Seed "${opts.seed}" not found under ${root}`);
+    }
+    filtered.sort();
+    const seeds = filtered.map((name) => readSeed(name, join(root, name)));
+    return {
+        schema_version: '1.0',
+        generated_at: now.toISOString(),
+        root,
+        seeds,
+    };
+}
+function readSeed(name, path) {
+    const frontmatter = readFrontmatter(join(path, 'seed.md'));
+    const warnings = [];
+    return {
+        name,
+        path,
+        status: frontmatter.status ?? null,
+        owners: frontmatter.owners ?? [],
+        created_at: frontmatter.created_at ?? null,
+        counts: {
+            sessions: countSessions(join(path, 'sessions'), warnings),
+            highlights: countMarkdown(join(path, 'highlights')),
+            codes: countMarkdown(join(path, 'codebook')),
+            themes: countMarkdown(join(path, 'synthesis', 'themes')),
+            insights: countMarkdown(join(path, 'synthesis', 'insights')),
+            frames: countFrames(join(path, 'sessions')),
+            legacy_assets: countFiles(join(path, 'legacy')),
+        },
+        warnings,
+    };
+}
+function countSessions(sessionsDir, warnings) {
+    const counts = { total: 0, transcribed: 0, queued: 0, inbox: 0 };
+    if (!existsSync(sessionsDir))
+        return counts;
+    for (const entry of readdirSync(sessionsDir)) {
+        const abs = join(sessionsDir, entry);
+        if (!statSync(abs).isDirectory())
+            continue;
+        if (entry === '_inbox') {
+            counts.inbox = readdirSync(abs).filter((f) => !f.startsWith('.')).length;
+            continue;
+        }
+        if (!isCanonicalSession(abs, entry)) {
+            warnings.push(`sessions/${entry}: not a canonical session shape (skipped)`);
+            continue;
+        }
+        counts.total += 1;
+        if (existsSync(join(abs, 'transcript.json')))
+            counts.transcribed += 1;
+        else
+            counts.queued += 1;
+    }
+    return counts;
+}
+function countMarkdown(dir) {
+    if (!existsSync(dir))
+        return 0;
+    let total = 0;
+    for (const entry of readdirSync(dir)) {
+        if (entry.startsWith('.'))
+            continue;
+        const abs = join(dir, entry);
+        const s = statSync(abs);
+        if (s.isFile() && entry.endsWith('.md') && entry.toLowerCase() !== 'readme.md')
+            total += 1;
+        else if (s.isDirectory())
+            total += countMarkdown(abs);
+    }
+    return total;
+}
+function countFiles(dir) {
+    if (!existsSync(dir))
+        return 0;
+    let total = 0;
+    for (const entry of readdirSync(dir)) {
+        if (entry.startsWith('.'))
+            continue;
+        const abs = join(dir, entry);
+        const s = statSync(abs);
+        if (s.isFile())
+            total += 1;
+        else if (s.isDirectory())
+            total += countFiles(abs);
+    }
+    return total;
+}
+function countFrames(sessionsDir) {
+    if (!existsSync(sessionsDir))
+        return 0;
+    let total = 0;
+    for (const entry of readdirSync(sessionsDir)) {
+        if (entry === '_inbox')
+            continue;
+        const framesDir = join(sessionsDir, entry, 'frames');
+        if (!existsSync(framesDir))
+            continue;
+        total += readdirSync(framesDir).filter((f) => /\.(jpg|jpeg|png)$/i.test(f)).length;
+    }
+    return total;
+}
+function readFrontmatter(path) {
+    if (!existsSync(path))
+        return {};
+    const content = readFileSync(path, 'utf8');
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (match === null)
+        return {};
+    return parseSimpleYaml(match[1] ?? '');
+}
+function parseSimpleYaml(yaml) {
+    const out = {};
+    const lines = yaml.split('\n');
+    for (const line of lines) {
+        const m = line.match(/^([A-Za-z_][A-Za-z0-9_-]*):\s*(.*)$/);
+        if (m === null)
+            continue;
+        const key = m[1];
+        const value = (m[2] ?? '').trim();
+        if (key === undefined)
+            continue;
+        if (key === 'status' && value.length > 0) {
+            out.status = stripQuotes(value);
+        }
+        else if (key === 'created_at' && value.length > 0) {
+            out.created_at = stripQuotes(value);
+        }
+        else if (key === 'owners') {
+            out.owners = parseOwners(value);
+        }
+    }
+    return out;
+}
+function stripQuotes(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+function parseOwners(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0 || trimmed === '[]')
+        return [];
+    const inline = trimmed.match(/^\[(.*)\]$/);
+    const body = inline?.[1];
+    if (body !== undefined) {
+        return body
+            .split(',')
+            .map((part) => stripQuotes(part.trim()))
+            .filter((s) => s.length > 0);
+    }
+    // Flow-style only for v1 — block-style "- name" lists not yet supported.
+    return [];
+}
+//# sourceMappingURL=status.js.map

package/dist/lib/status.js.map

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

package/dist/lib/tagcode.d.ts

@@ -0,0 +1,26 @@
+export interface TermSuggestion {
+    term_id: string;
+    phrase: string;
+    count: number;
+}
+/** Extract candidate glossary terms: multiword phrases (2-3 tokens) that recur
+ * >= minCount times across utterances. Phrases are dropped when ANY token is
+ * a stopword (grammatical glue / filler) OR contains a digit (timestamp noise). */
+export declare function suggestTerms(utterances: Array<{
+    text: string;
+}>, opts?: {
+    minCount?: number;
+}): TermSuggestion[];
+export interface TagResult {
+    suggested: TermSuggestion[];
+    applied: boolean;
+}
+/** Suggest terms; with apply=true, write them to glossary/glossary.md and emit
+ * agent create events. */
+export declare function tagSeed(seedPath: string, utterances: Array<{
+    text: string;
+}>, opts?: {
+    apply?: boolean;
+    minCount?: number;
+}): TagResult;
+//# sourceMappingURL=tagcode.d.ts.map

package/dist/lib/tagcode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tagcode.d.ts","sourceRoot":"","sources":["../../src/lib/tagcode.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAsKD;;mFAEmF;AACnF,wBAAgB,YAAY,CAC1B,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACnC,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,cAAc,EAAE,CA0BlB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;0BAC0B;AAC1B,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACnC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,SAAS,CA8BX"}

package/dist/lib/tagcode.js

@@ -0,0 +1,231 @@
+import { appendFileSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { emitAgentCreate, openSeedEvents } from './events.js';
+// `compost tag` / `compost code` (#49): suggest (default) or --apply glossary
+// terms and codes. Term suggestion is a deterministic recurring-noun-phrase
+// extractor; code suggestion reuses the similarity scanner. Suggestions are
+// AI/agent [draft] events until applied/endorsed.
+const AGENT = 'tagger';
+const VERSION = '0.1.0';
+// Function words, modals, pronouns, common conversational fillers (EN + ES) —
+// any phrase touching one of these is dropped. Scoped to grammatical glue and
+// filler; content nouns/verbs/adjectives don't appear here, so legitimate noun
+// phrases ("manual override", "alerta automática") survive (#171). The pre-fix
+// list was 24 tokens and only dropped *all-stopword* phrases, so "you know"
+// (64), "and like" (40), "right like" (38) leaked into glossary suggestions.
+const STOPWORDS = new Set([
+    // EN — fillers, modals, pronouns, common helpers
+    'the',
+    'and',
+    'but',
+    'for',
+    'with',
+    'that',
+    'this',
+    'these',
+    'those',
+    'you',
+    'your',
+    'yours',
+    'his',
+    'her',
+    'hers',
+    'its',
+    'our',
+    'ours',
+    'they',
+    'their',
+    'them',
+    'theirs',
+    'mine',
+    'ours',
+    'are',
+    'was',
+    'were',
+    'been',
+    'being',
+    'have',
+    'has',
+    'had',
+    'having',
+    'will',
+    'would',
+    'could',
+    'should',
+    'can',
+    'may',
+    'might',
+    'must',
+    'into',
+    'onto',
+    'about',
+    'from',
+    'over',
+    'under',
+    'after',
+    'before',
+    'like',
+    'just',
+    'kind',
+    'sort',
+    'know',
+    'mean',
+    'think',
+    'say',
+    'said',
+    'got',
+    'get',
+    'going',
+    'gone',
+    'want',
+    'need',
+    'see',
+    'look',
+    'take',
+    'make',
+    'made',
+    'come',
+    'came',
+    'well',
+    'okay',
+    'right',
+    'yeah',
+    'really',
+    'actually',
+    'maybe',
+    // ES — equivalents
+    'una',
+    'unos',
+    'unas',
+    'los',
+    'las',
+    'del',
+    'por',
+    'con',
+    'sin',
+    'que',
+    'qué',
+    'para',
+    'pero',
+    'sino',
+    'como',
+    'más',
+    'muy',
+    'sus',
+    'les',
+    'nos',
+    'mis',
+    'tus',
+    'este',
+    'esta',
+    'estos',
+    'estas',
+    'eso',
+    'esa',
+    'esos',
+    'esas',
+    'ese',
+    'todo',
+    'todos',
+    'toda',
+    'todas',
+    'ser',
+    'estar',
+    'son',
+    'soy',
+    'eres',
+    'era',
+    'eran',
+    'fue',
+    'fueron',
+    'está',
+    'están',
+    'estaba',
+    'estaban',
+    'hay',
+    'había',
+    'hubo',
+    'haya',
+    'voy',
+    'vas',
+    'vamos',
+    'van',
+    'sea',
+    'sean',
+    'pues',
+    'bueno',
+    'vale',
+    'claro',
+    'entonces',
+    'así',
+    'bien',
+    'también',
+    'tampoco',
+    'cuando',
+    'donde',
+    'cómo',
+]);
+// Pre-fix, "hour minutes seconds1"(78) topped the list — utterance text leaked
+// raw `.srt`-style timecodes. Any candidate token containing a digit is
+// suppressed: that's never a content noun phrase.
+const TOKEN_HAS_DIGIT_RE = /\d/;
+/** Extract candidate glossary terms: multiword phrases (2-3 tokens) that recur
+ * >= minCount times across utterances. Phrases are dropped when ANY token is
+ * a stopword (grammatical glue / filler) OR contains a digit (timestamp noise). */
+export function suggestTerms(utterances, opts = {}) {
+    const minCount = opts.minCount ?? 2;
+    const counts = new Map();
+    for (const u of utterances) {
+        const tokens = u.text
+            .toLowerCase()
+            .replace(/[^\p{L}\p{N}\s]/gu, ' ')
+            .split(/\s+/)
+            .filter((t) => t.length > 2);
+        for (let n = 2; n <= 3; n++) {
+            for (let i = 0; i + n <= tokens.length; i++) {
+                const gram = tokens.slice(i, i + n);
+                // Drop the candidate when ANY token is a stopword or has a digit —
+                // pre-fix this was `every` (drop only when ALL tokens were stopwords),
+                // which let "you know" / "and like" through because of the non-stopword
+                // partner. Content noun phrases never contain function words or digits.
+                if (gram.some((t) => STOPWORDS.has(t) || TOKEN_HAS_DIGIT_RE.test(t)))
+                    continue;
+                const phrase = gram.join(' ');
+                counts.set(phrase, (counts.get(phrase) ?? 0) + 1);
+            }
+        }
+    }
+    return [...counts.entries()]
+        .filter(([, c]) => c >= minCount)
+        .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+        .map(([phrase, count]) => ({ term_id: `T-${phrase.replace(/\s+/g, '-')}`, phrase, count }));
+}
+/** Suggest terms; with apply=true, write them to glossary/glossary.md and emit
+ * agent create events. */
+export function tagSeed(seedPath, utterances, opts = {}) {
+    const suggested = suggestTerms(utterances, opts.minCount !== undefined ? { minCount: opts.minCount } : {});
+    if (opts.apply !== true)
+        return { suggested, applied: false };
+    const glossaryDir = join(seedPath, 'glossary');
+    mkdirSync(glossaryDir, { recursive: true });
+    const glossary = join(glossaryDir, 'glossary.md');
+    if (!existsSync(glossary))
+        writeFileSync(glossary, '# Glossary\n\n', 'utf8');
+    const events = openSeedEvents(seedPath);
+    try {
+        for (const t of suggested) {
+            appendFileSync(glossary, `- **${t.phrase}** (\`${t.term_id}\`) — _${t.count} mentions; define me_\n`, 'utf8');
+            emitAgentCreate(events, {
+                artifactKind: 'term',
+                initialState: { term_id: t.term_id, phrase: t.phrase, count: t.count, status: 'draft' },
+                agentName: AGENT,
+                agentVersion: VERSION,
+            });
+        }
+    }
+    finally {
+        events.close();
+    }
+    return { suggested, applied: true };
+}
+//# sourceMappingURL=tagcode.js.map

package/dist/lib/tagcode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tagcode.js","sourceRoot":"","sources":["../../src/lib/tagcode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE7D,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,kDAAkD;AAElD,MAAM,KAAK,GAAG,QAAQ,CAAA;AACtB,MAAM,OAAO,GAAG,OAAO,CAAA;AAQvB,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,6EAA6E;AAC7E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,iDAAiD;IACjD,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,KAAK;IACL,MAAM;IACN,OAAO;IACP,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,QAAQ;IACR,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,KAAK;IACL,QAAQ;IACR,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,KAAK;IACL,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,QAAQ;IACR,UAAU;IACV,OAAO;IACP,mBAAmB;IACnB,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,KAAK;IACL,OAAO;IACP,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,QAAQ;IACR,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IACT,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,OAAO;IACP,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,UAAU;IACV,KAAK;IACL,MAAM;IACN,SAAS;IACT,SAAS;IACT,QAAQ;IACR,OAAO;IACP,MAAM;CACP,CAAC,CAAA;AAEF,+EAA+E;AAC/E,wEAAwE;AACxE,kDAAkD;AAClD,MAAM,kBAAkB,GAAG,IAAI,CAAA;AAE/B;;mFAEmF;AACnF,MAAM,UAAU,YAAY,CAC1B,UAAmC,EACnC,OAA8B,EAAE;IAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI;aAClB,WAAW,EAAE;aACb,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC;aACjC,KAAK,CAAC,KAAK,CAAC;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;gBACnC,mEAAmE;gBACnE,uEAAuE;gBACvE,wEAAwE;gBACxE,wEAAwE;gBACxE,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAAE,SAAQ;gBAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,QAAQ,CAAC;SAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACvD,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;AAC/F,CAAC;AAOD;0BAC0B;AAC1B,MAAM,UAAU,OAAO,CACrB,QAAgB,EAChB,UAAmC,EACnC,OAA+C,EAAE;IAEjD,MAAM,SAAS,GAAG,YAAY,CAC5B,UAAU,EACV,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAC/D,CAAA;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;IAE7D,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IAC9C,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAA;IACjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,aAAa,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAA;IAC5E,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IACvC,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,cAAc,CACZ,QAAQ,EACR,OAAO,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,KAAK,yBAAyB,EAC3E,MAAM,CACP,CAAA;YACD,eAAe,CAAC,MAAM,EAAE;gBACtB,YAAY,EAAE,MAAM;gBACpB,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;gBACvF,SAAS,EAAE,KAAK;gBAChB,YAAY,EAAE,OAAO;aACtB,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAA;IAChB,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACrC,CAAC"}

package/dist/lib/templates.d.ts

@@ -0,0 +1,3 @@
+export declare function loadTemplate(name: string): string;
+export declare function render(template: string, vars: Record<string, string>): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/lib/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":"AAWA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAQ7E"}

package/dist/lib/templates.js

@@ -0,0 +1,21 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// From cli/src/lib/templates.ts the templates live at ../../templates.
+// From cli/dist/lib/templates.js the same relative path resolves to
+// cli/templates (templates/ is a sibling of both src/ and dist/).
+const TEMPLATES_ROOT = join(__dirname, '..', '..', 'templates');
+export function loadTemplate(name) {
+    return readFileSync(join(TEMPLATES_ROOT, name), 'utf8');
+}
+export function render(template, vars) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+        const value = vars[key];
+        if (value === undefined) {
+            throw new Error(`render: template references unknown variable "${key}"`);
+        }
+        return value;
+    });
+}
+//# sourceMappingURL=templates.js.map

package/dist/lib/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAEzD,uEAAuE;AACvE,oEAAoE;AACpE,kEAAkE;AAClE,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAA;AAE/D,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;AACzD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,QAAgB,EAAE,IAA4B;IACnE,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,iDAAiD,GAAG,GAAG,CAAC,CAAA;QAC1E,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;AACJ,CAAC"}