@jstn-sdk/rcs 0.1.0

package/dist/sidecar/__tests__/collector.test.js

@@ -0,0 +1,162 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, readdir, readFile, rm, writeFile, mkdir } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join, relative } from 'node:path';
+import { describe, it } from 'node:test';
+import { collectSidecarSnapshot, readTailText } from '../collector.js';
+async function writeJson(path, value) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(value, null, 2)}\n`);
+}
+async function snapshotFiles(root) {
+    const result = new Map();
+    async function visit(dir) {
+        for (const entry of await readdir(dir, { withFileTypes: true })) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await visit(path);
+            }
+            else if (entry.isFile()) {
+                result.set(relative(root, path), await readFile(path, 'utf-8'));
+            }
+        }
+    }
+    await visit(root);
+    return result;
+}
+async function withFixture(test) {
+    const cwd = await mkdtemp(join(tmpdir(), 'rcs-sidecar-'));
+    try {
+        const teamRoot = join(cwd, '.rcs', 'state', 'team', 'demo');
+        await mkdir(teamRoot, { recursive: true });
+        await test(cwd, teamRoot);
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+    }
+}
+describe('collectSidecarSnapshot', () => {
+    it('normalizes existing team state without migrating legacy config or mutating files', async () => {
+        await withFixture(async (cwd, teamRoot) => {
+            await writeJson(join(teamRoot, 'config.json'), {
+                name: 'demo',
+                task: 'ship sidecar',
+                worker_count: 2,
+                tmux_session: 'rcs-demo',
+                leader_pane_id: '%1',
+                hud_pane_id: '%2',
+                workers: [
+                    { name: 'worker-1', index: 1, role: 'executor', assigned_tasks: ['1'], pane_id: '%3' },
+                    { name: 'worker-2', index: 2, role: 'verifier', assigned_tasks: ['2'], pane_id: '%4' },
+                ],
+            });
+            await writeJson(join(teamRoot, 'tasks', 'task-1.json'), {
+                id: '1', subject: 'Implement collector', status: 'in_progress', owner: 'worker-1', version: 3,
+                claim: { owner: 'worker-1', token: 'secret-claim-token', leased_until: '2026-04-27T02:10:00.000Z' },
+            });
+            await writeJson(join(teamRoot, 'tasks', 'task-2.json'), {
+                id: '2', subject: 'Blocked verification', status: 'blocked', owner: 'worker-2', blocked_by: ['1'], version: 1,
+            });
+            await writeJson(join(teamRoot, 'tasks', 'task-3.json'), {
+                id: '3', subject: 'Failed smoke', status: 'failed', owner: 'worker-2', error: 'smoke failed', version: 1,
+            });
+            await writeJson(join(teamRoot, 'workers', 'worker-1', 'status.json'), {
+                state: 'working', current_task_id: '1', updated_at: '2026-04-27T02:00:00.000Z',
+            });
+            await writeJson(join(teamRoot, 'workers', 'worker-1', 'heartbeat.json'), {
+                pid: 123, alive: true, turn_count: 8, last_turn_at: '2026-04-27T02:00:01.000Z',
+            });
+            await writeJson(join(teamRoot, 'workers', 'worker-2', 'status.json'), {
+                state: 'blocked', reason: 'needs plan approval', current_task_id: '2', updated_at: '2026-04-27T02:00:02.000Z',
+            });
+            await writeJson(join(teamRoot, 'workers', 'worker-2', 'heartbeat.json'), {
+                pid: 456, alive: false, turn_count: 2, last_turn_at: '2026-04-27T01:59:00.000Z',
+            });
+            await writeJson(join(teamRoot, 'phase.json'), { current_phase: 'team-exec' });
+            await writeJson(join(teamRoot, 'monitor-snapshot.json'), {
+                workerTurnCountByName: { 'worker-1': 1 },
+                workerTaskIdByName: { 'worker-1': '1' },
+            });
+            await mkdir(join(teamRoot, 'events'), { recursive: true });
+            await writeFile(join(teamRoot, 'events', 'events.ndjson'), [
+                JSON.stringify({ event_id: 'e1', team: 'demo', type: 'worker_idle', worker: 'worker-2', reason: 'waiting', created_at: '2026-04-27T02:00:03.000Z' }),
+                JSON.stringify({ event_id: 'e2', team: 'demo', type: 'task_failed', worker: 'worker-2', task_id: '3', reason: 'smoke failed', created_at: '2026-04-27T02:00:04.000Z' }),
+            ].join('\n'));
+            await writeJson(join(teamRoot, 'mailbox', 'worker-1.json'), { messages: ['must remain unchanged'] });
+            const before = await snapshotFiles(teamRoot);
+            const snapshot = await collectSidecarSnapshot('demo', { cwd, now: new Date('2026-04-27T02:01:00.000Z') });
+            const after = await snapshotFiles(teamRoot);
+            assert.deepEqual(after, before, 'sidecar collector must be read-only over team state');
+            assert.ok(!after.has('manifest.v2.json'), 'legacy config must not be migrated into a v2 manifest');
+            assert.ok(snapshot);
+            assert.equal(snapshot.schema_version, 'rcs.sidecar/v1');
+            assert.ok(!JSON.stringify(snapshot).includes('secret-claim-token'), 'claim tokens must never be exposed in sidecar snapshots');
+            assert.deepEqual(snapshot.tasks.find((task) => task.id === '1')?.claim, { owner: 'worker-1', leased_until: '2026-04-27T02:10:00.000Z' });
+            assert.equal(snapshot.phase, 'team-exec');
+            assert.equal(snapshot.workers.length, 2);
+            assert.equal(snapshot.events[0]?.type, 'worker_state_changed');
+            assert.equal(snapshot.events[0]?.source_type, 'worker_idle');
+            assert.deepEqual(snapshot.panes.map((pane) => pane.pane_id), ['%1', '%2', '%3', '%4']);
+            assert.ok(snapshot.highlights.some((highlight) => highlight.kind === 'blocked-worker' && highlight.target === 'worker-2'));
+            assert.ok(snapshot.highlights.some((highlight) => highlight.kind === 'dead-worker' && highlight.target === 'worker-2'));
+            assert.ok(snapshot.highlights.some((highlight) => highlight.kind === 'non-reporting-worker' && highlight.target === 'worker-1'));
+            assert.ok(snapshot.highlights.some((highlight) => highlight.kind === 'blocked-task' && highlight.target === 'task-2'));
+            assert.ok(snapshot.highlights.some((highlight) => highlight.kind === 'failed-task' && highlight.target === 'task-3'));
+            assert.match(snapshot.topology.summary, /2 workers/);
+        });
+    });
+    it('rejects unsafe team names before reading state', async () => {
+        await assert.rejects(() => collectSidecarSnapshot('../demo', { cwd: '/tmp' }), /Invalid team name/);
+    });
+    it('skips unsafe worker names before resolving worker state paths', async () => {
+        await withFixture(async (cwd, teamRoot) => {
+            await writeJson(join(teamRoot, 'config.json'), {
+                name: 'demo',
+                task: 'ship sidecar',
+                tmux_session: 'rcs-demo',
+                workers: [
+                    { name: 'worker-1', index: 1, role: 'executor' },
+                    { name: '../escape', index: 2, role: 'executor' },
+                ],
+            });
+            await writeJson(join(teamRoot, 'workers', 'worker-1', 'status.json'), { state: 'idle' });
+            await writeJson(join(teamRoot, 'escape', 'status.json'), { state: 'working', current_task_id: 'escaped-status' });
+            const snapshot = await collectSidecarSnapshot('demo', { cwd, now: new Date('2026-04-27T02:01:00.000Z') });
+            assert.ok(snapshot);
+            assert.deepEqual(snapshot.workers.map((worker) => worker.name), ['worker-1']);
+            assert.ok(snapshot.source_warnings.some((warning) => warning.includes('skipped unsafe worker name: ../escape')));
+            assert.ok(!JSON.stringify(snapshot).includes('escaped-status'));
+        });
+    });
+    it('returns recent events from a bounded tail window', async () => {
+        await withFixture(async (cwd, teamRoot) => {
+            await writeJson(join(teamRoot, 'config.json'), {
+                name: 'demo',
+                task: 'ship sidecar',
+                tmux_session: 'rcs-demo',
+                workers: [{ name: 'worker-1', index: 1, role: 'executor' }],
+            });
+            await mkdir(join(teamRoot, 'events'), { recursive: true });
+            const eventPath = join(teamRoot, 'events', 'events.ndjson');
+            const lines = [
+                '{invalid-json',
+                ...Array.from({ length: 30 }, (_, index) => JSON.stringify({
+                    event_id: `e${index + 1}`,
+                    team: 'demo',
+                    type: 'worker_state_changed',
+                    worker: 'worker-1',
+                    state: 'idle',
+                    created_at: `2026-04-27T02:${String(index).padStart(2, '0')}:00.000Z`,
+                })),
+            ];
+            await writeFile(eventPath, `${lines.join('\n')}\n`);
+            const tail = await readTailText(eventPath, 80);
+            assert.ok(tail);
+            assert.ok(Buffer.byteLength(tail) <= 80);
+            const snapshot = await collectSidecarSnapshot('demo', { cwd, eventLimit: 3, now: new Date('2026-04-27T02:31:00.000Z') });
+            assert.ok(snapshot);
+            assert.deepEqual(snapshot.events.map((event) => event.event_id), ['e28', 'e29', 'e30']);
+        });
+    });
+});
+//# sourceMappingURL=collector.test.js.map

package/dist/sidecar/__tests__/collector.test.js.map

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

package/dist/sidecar/__tests__/render.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=render.test.d.ts.map

package/dist/sidecar/__tests__/render.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.test.d.ts","sourceRoot":"","sources":["../../../src/sidecar/__tests__/render.test.ts"],"names":[],"mappings":""}

package/dist/sidecar/__tests__/render.test.js

@@ -0,0 +1,67 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { renderSidecar } from '../render.js';
+const SNAPSHOT = {
+    schema_version: 'rcs.sidecar/v1',
+    generated_at: '2026-04-27T02:01:00.000Z',
+    team_name: 'demo',
+    team_task: 'ship sidecar',
+    phase: 'team-exec',
+    topology: {
+        summary: '2 workers · 1 working · 1 blocked · 1 in progress · 0 pending',
+        nodes: ['leader', 'worker-1', 'worker-2'],
+        edges: [{ from: 'leader', to: 'worker-1', label: 'task-1' }],
+    },
+    workers: [
+        {
+            name: 'worker-1', index: 1, role: 'executor', assigned_tasks: ['1'], pane_id: '%3',
+            status: { state: 'working', current_task_id: '1' }, heartbeat: { alive: true, turn_count: 8 }, alive: true,
+            current_task: { id: '1', subject: 'Implement collector', description: '', status: 'in_progress', owner: 'worker-1' },
+            turns_without_progress: 7,
+        },
+    ],
+    tasks: [{ id: '1', subject: 'Implement collector', description: '', status: 'in_progress', owner: 'worker-1' }],
+    events: [{ event_id: 'e1', team: 'demo', type: 'worker_state_changed', worker: 'worker-1', state: 'working', created_at: '2026-04-27T02:00:00.000Z' }],
+    panes: [{ target: 'worker-1', pane_id: '%3', role: 'worker' }],
+    highlights: [{ severity: 'warning', target: 'worker-1', kind: 'non-reporting-worker', message: 'worker-1 has 7 turns without task progress' }],
+    source_warnings: [],
+};
+describe('renderSidecar', () => {
+    it('renders stacked text panels with core visualization vocabulary', () => {
+        const output = renderSidecar(SNAPSHOT, { width: 88, color: false });
+        for (const label of ['RCS Sidecar · demo', 'Topology', 'Agents', 'Tasks', 'Highlights', 'Panes', 'Events']) {
+            assert.match(output, new RegExp(label));
+        }
+        assert.match(output, /worker-1 \[working\/alive\] executor task-1 %3 Δturns=7/);
+        assert.match(output, /task-1 \[in_progress\] @worker-1 Implement collector/);
+        assert.match(output, /worker-1 has 7 turns without task progress/);
+    });
+    it('does not leak raw ANSI fragments in default colored panel content', () => {
+        const output = renderSidecar({ ...SNAPSHOT, highlights: [], source_warnings: ['watch warning'] }, { width: 88 });
+        assert.match(output, /no blockers detected/);
+        assert.match(output, /watch warning/);
+        assert.doesNotMatch(output, /(?:^|[^\x1b])\[(?:32|33|0)m/);
+    });
+    it('sanitizes dynamic header and panel values before terminal rendering', () => {
+        const output = renderSidecar({
+            ...SNAPSHOT,
+            team_name: 'demo\u001b]0;owned\u0007\u001b[31m',
+            phase: 'team-exec\u001b[2J\u0001',
+            topology: { ...SNAPSHOT.topology, summary: 'safe\u001b[31m summary' },
+            tasks: [{ ...SNAPSHOT.tasks[0], subject: 'task\u001b]2;owned\u0007 subject' }],
+            events: [{ ...SNAPSHOT.events[0], reason: 'reason\u001b[2J' }],
+            highlights: [{ ...SNAPSHOT.highlights[0], message: 'highlight\u001b[31m message' }],
+        }, { width: 88, color: false });
+        assert.match(output, /RCS Sidecar · demo/);
+        assert.match(output, /phase=team-exec/);
+        assert.doesNotMatch(output, /\x1b\]/);
+        assert.doesNotMatch(output, /\x1b\[[0-?]*[ -/]*[@-~]/);
+        assert.doesNotMatch(output, /owned/);
+    });
+    it('honors height truncation for narrow right-side panes', () => {
+        const output = renderSidecar(SNAPSHOT, { width: 44, height: 5, color: false });
+        assert.ok(output.split('\n').length <= 5);
+        assert.match(output, /more lines/);
+    });
+});
+//# sourceMappingURL=render.test.js.map

package/dist/sidecar/__tests__/render.test.js.map

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

package/dist/sidecar/__tests__/tmux.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tmux.test.d.ts.map

package/dist/sidecar/__tests__/tmux.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.test.d.ts","sourceRoot":"","sources":["../../../src/sidecar/__tests__/tmux.test.ts"],"names":[],"mappings":""}

package/dist/sidecar/__tests__/tmux.test.js

@@ -0,0 +1,30 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { buildSidecarTmuxSplitArgs, buildSidecarWatchCommand, launchSidecarTmuxPane } from '../tmux.js';
+describe('sidecar tmux launcher', () => {
+    it('builds a detached horizontal right-side split running watch mode', () => {
+        const args = buildSidecarTmuxSplitArgs({ cwd: '/repo', teamName: 'demo-team', width: 52, sessionId: 'sess 1', rcsBin: '/repo/dist/cli/rcs.js' });
+        assert.deepEqual(args.slice(0, 6), ['split-window', '-h', '-d', '-l', '52', '-c']);
+        assert.equal(args[6], '/repo');
+        assert.equal(args[8], '-F');
+        assert.equal(args[9], '#{pane_id}');
+        assert.match(args[10], /RCS_SESSION_ID='sess 1'/);
+        assert.match(args[10], /node '\/repo\/dist\/cli\/rcs\.js' sidecar 'demo-team' --watch --width 52/);
+    });
+    it('uses a safe minimum sidecar width and parses the new pane id', () => {
+        const command = buildSidecarWatchCommand({ cwd: '/repo', teamName: 'demo', width: 10, rcsBin: '/repo/rcs.js' });
+        assert.match(command, /--width 48$/);
+        const paneId = launchSidecarTmuxPane({ cwd: '/repo', teamName: 'demo', width: 48, rcsBin: '/repo/rcs.js' }, (args) => {
+            assert.equal(args[0], 'split-window');
+            return '%42\n';
+        });
+        assert.equal(paneId, '%42');
+    });
+    it('returns null when tmux launch throws', () => {
+        const paneId = launchSidecarTmuxPane({ cwd: '/repo', teamName: 'demo', width: 48, rcsBin: '/repo/rcs.js' }, () => {
+            throw new Error('tmux unavailable');
+        });
+        assert.equal(paneId, null);
+    });
+});
+//# sourceMappingURL=tmux.test.js.map

package/dist/sidecar/__tests__/tmux.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.test.js","sourceRoot":"","sources":["../../../src/sidecar/__tests__/tmux.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExG,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,IAAI,GAAG,yBAAyB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACjJ,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,yBAAyB,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,0EAA0E,CAAC,CAAC;IACrG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,OAAO,GAAG,wBAAwB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QAChH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAErC,MAAM,MAAM,GAAG,qBAAqB,CAClC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EACrE,CAAC,IAAI,EAAE,EAAE;YACP,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;YACtC,OAAO,OAAO,CAAC;QACjB,CAAC,CACF,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,qBAAqB,CAClC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EACrE,GAAG,EAAE;YACH,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC,CACF,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/sidecar/__tests__/watch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=watch.test.d.ts.map

package/dist/sidecar/__tests__/watch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.test.d.ts","sourceRoot":"","sources":["../../../src/sidecar/__tests__/watch.test.ts"],"names":[],"mappings":""}

package/dist/sidecar/__tests__/watch.test.js

@@ -0,0 +1,42 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { runSidecarWatch } from '../index.js';
+function snapshot() {
+    return {
+        schema_version: 'rcs.sidecar/v1',
+        generated_at: '2026-04-27T02:01:00.000Z',
+        team_name: 'demo',
+        team_task: 'ship sidecar',
+        phase: null,
+        topology: { summary: '0 workers', nodes: ['leader'], edges: [] },
+        workers: [],
+        tasks: [],
+        events: [],
+        panes: [],
+        highlights: [],
+        source_warnings: [],
+    };
+}
+describe('runSidecarWatch', () => {
+    it('renders read-only frames and restores cursor when stopped', async () => {
+        const writes = [];
+        let sigintHandler;
+        let collectCalls = 0;
+        await runSidecarWatch('demo', { json: false, watch: true, tmux: false, intervalMs: 100 }, {}, {
+            collect: async () => { collectCalls += 1; return snapshot(); },
+            render: (frame, options) => `frame:${frame.team_name}:${options.width}:${options.height}`,
+            writeStdout: (text) => { writes.push(text); },
+            writeStderr: () => { },
+            registerSigint: (handler) => { sigintHandler = handler; },
+            stdoutColumns: () => 51,
+            stdoutRows: () => 22,
+            sleep: async () => { sigintHandler?.(); },
+        });
+        assert.equal(collectCalls, 1);
+        assert.ok(writes.some((chunk) => chunk.includes('\x1b[?25l')), 'watch hides cursor');
+        assert.ok(writes.some((chunk) => chunk.includes('\x1b[2J\x1b[H')), 'first render clears screen');
+        assert.ok(writes.some((chunk) => chunk.includes('frame:demo:51:22')), 'watch writes rendered sidecar frame');
+        assert.ok(writes.some((chunk) => chunk.includes('\x1b[?25h')), 'watch restores cursor');
+    });
+});
+//# sourceMappingURL=watch.test.js.map

package/dist/sidecar/__tests__/watch.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.test.js","sourceRoot":"","sources":["../../../src/sidecar/__tests__/watch.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,SAAS,QAAQ;IACf,OAAO;QACL,cAAc,EAAE,gBAAgB;QAChC,YAAY,EAAE,0BAA0B;QACxC,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,cAAc;QACzB,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QAChE,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;QACT,UAAU,EAAE,EAAE;QACd,eAAe,EAAE,EAAE;KACpB,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,aAAuC,CAAC;QAC5C,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,MAAM,eAAe,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE;YAC5F,OAAO,EAAE,KAAK,IAAI,EAAE,GAAG,YAAY,IAAI,CAAC,CAAC,CAAC,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC;YAC9D,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,SAAS,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE;YACzF,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7C,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;YACrB,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;YACzD,aAAa,EAAE,GAAG,EAAE,CAAC,EAAE;YACvB,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAG,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;SAC1C,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;QACrF,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC;QACjG,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,EAAE,qCAAqC,CAAC,CAAC;QAC7G,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/sidecar/collector.d.ts

@@ -0,0 +1,4 @@
+import type { CollectSidecarSnapshotOptions, SidecarSnapshot } from './types.js';
+export declare function readTailText(path: string, maxBytes?: number): Promise<string | null>;
+export declare function collectSidecarSnapshot(teamName: string, options?: CollectSidecarSnapshotOptions): Promise<SidecarSnapshot | null>;
+//# sourceMappingURL=collector.d.ts.map

package/dist/sidecar/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/sidecar/collector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,6BAA6B,EAI7B,eAAe,EAShB,MAAM,YAAY,CAAC;AAqOpB,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAiC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAepH;AAsGD,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAsCjC"}