@matteeh/osq 0.1.0

package/dist/harness/stream.js

@@ -0,0 +1,75 @@
+/**
+ * Shared harness stream helpers. Harness adapters translate an unbounded stdout
+ * stream of JSON lines into `events.jsonl`; the record coercion, string picking,
+ * timestamp resolution, and line buffering are identical across adapters and
+ * live here so each adapter only owns its event translation.
+ */
+/** Coerce an unknown JSON value into a plain object, or `undefined` for arrays and primitives. */
+export function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+/** Return the first candidate that is a non-empty string, skipping every other type. */
+export function firstNonEmptyString(...values) {
+    for (const value of values) {
+        if (typeof value === 'string' && value.length > 0) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve an event timestamp to ISO form. Harnesses report either a top-level
+ * `timestamp` or, for Antigravity step updates, a nested `step_update.timestamp`.
+ * Invalid or missing timestamps fall back to the current time so an event is
+ * never written without one.
+ */
+export function resolveEventTimestamp(eventObj) {
+    const stepUpdate = asRecord(eventObj.step_update);
+    const candidate = eventObj.timestamp ?? stepUpdate?.timestamp;
+    if (typeof candidate === 'number' || typeof candidate === 'string') {
+        const date = new Date(candidate);
+        if (!Number.isNaN(date.getTime())) {
+            return date.toISOString();
+        }
+    }
+    return new Date().toISOString();
+}
+/**
+ * Buffers arbitrarily chunked stdout and delivers complete, non-blank lines to
+ * an async handler one at a time in arrival order. A handler rejection is
+ * swallowed so a single malformed line can never abort the rest of the stream;
+ * `flush` drains whatever partial line remains and resolves after every queued
+ * handler has settled.
+ */
+export class EventStreamParser {
+    onLine;
+    buffer = '';
+    pending = Promise.resolve();
+    constructor(onLine) {
+        this.onLine = onLine;
+    }
+    feed(chunk) {
+        this.buffer += chunk;
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() ?? '';
+        for (const line of lines) {
+            this.enqueue(line);
+        }
+    }
+    async flush() {
+        if (this.buffer.trim()) {
+            this.enqueue(this.buffer);
+        }
+        this.buffer = '';
+        await this.pending;
+    }
+    enqueue(line) {
+        if (!line.trim()) {
+            return;
+        }
+        this.pending = this.pending.then(() => this.onLine(line).catch(() => { }));
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/harness/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/harness/stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kGAAkG;AAClG,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,mBAAmB,CAAC,GAAG,MAAiB;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAiC;IACrE,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,UAAU,EAAE,SAAS,CAAC;IAC9D,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IAIC;IAHrB,MAAM,GAAG,EAAE,CAAC;IACZ,OAAO,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEnD,YAA6B,MAAuC;QAAvC,WAAM,GAAN,MAAM,CAAiC;IAAG,CAAC;IAExE,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,MAAM,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAEO,OAAO,CAAC,IAAY;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/harness/types.d.ts

@@ -0,0 +1,53 @@
+import type { OsqConfig } from '../core/config.js';
+import type { Logger } from '../core/logger.js';
+export type HarnessEventType = 'started' | 'tokens' | 'tool' | 'text' | 'file_changed' | 'verify_ran' | 'result_written' | 'exited' | 'done' | 'dead';
+export interface ToolEventData {
+    tool: string;
+    summary: string;
+}
+export interface TextEventData {
+    readonly text: string;
+}
+export interface DoneEventData {
+    readonly task: string;
+}
+export interface DeadEventData {
+    readonly task: string;
+    readonly reason: string;
+}
+export interface HarnessEvent {
+    type: HarnessEventType;
+    timestamp: string;
+    data?: Record<string, unknown>;
+}
+export interface SpawnTaskOptions {
+    projectRoot: string;
+    specFolderPath: string;
+    taskNumber: string;
+    taskTitle: string;
+    verifyCommand: string;
+    scope: string[];
+    entry: string[];
+    skills: string[];
+    tier: 'coding' | 'smart';
+    timeoutSeconds?: number;
+    config?: OsqConfig;
+    logger?: Logger;
+    onSpawn?: (pid: number) => Promise<void> | void;
+}
+export interface SpawnResult {
+    exitCode: number;
+    error?: string;
+    timedOut?: boolean;
+    signal?: NodeJS.Signals | string | null;
+    pid?: number;
+    elapsedMs?: number;
+}
+export interface HarnessAdapter {
+    readonly name: string;
+    setup(projectRoot: string, config: OsqConfig): Promise<void>;
+    spawn(options: SpawnTaskOptions): Promise<SpawnResult>;
+    preflight?(projectRoot: string, config: OsqConfig): Promise<void>;
+}
+export declare function appendHarnessEvent(specFolderPath: string, taskNumber: string, event: HarnessEvent): Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/harness/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,GACN,cAAc,GACd,YAAY,GACZ,gBAAgB,GAChB,QAAQ,GACR,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACvD,SAAS,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/harness/types.js

@@ -0,0 +1,10 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export async function appendHarnessEvent(specFolderPath, taskNumber, event) {
+    const eventsDir = path.join(specFolderPath, '.run', 'events');
+    await fs.mkdir(eventsDir, { recursive: true });
+    const eventFilePath = path.join(eventsDir, `${taskNumber}.jsonl`);
+    const line = `${JSON.stringify(event)}\n`;
+    await fs.appendFile(eventFilePath, line, 'utf8');
+}
+//# sourceMappingURL=types.js.map

package/dist/harness/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAwE7B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,cAAsB,EACtB,UAAkB,EAClB,KAAmB;IAEnB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,UAAU,QAAQ,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;IAC1C,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { DEFAULT_CONFIG, defineConfig, loadConfig } from './core/config.js';
+export type { AgyConfig, LogConfig, OpencodeConfig, OsqConfig, OsqLimits, OsqPaths, OsqTimeouts, OsqUserConfig, } from './core/config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5E,YAAY,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { DEFAULT_CONFIG, defineConfig, loadConfig } from './core/config.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/watcher/archiver.d.ts

@@ -0,0 +1,5 @@
+import type { OsqConfig } from '../core/config.js';
+export declare function applyDelta(projectRoot: string, specFolderPath: string, config: OsqConfig): Promise<void>;
+export declare function archiveSpecFolder(projectRoot: string, specFolderPath: string, config: OsqConfig): Promise<string>;
+export declare function checkAndArchiveSpec(projectRoot: string, specFolderPath: string, config: OsqConfig): Promise<boolean>;
+//# sourceMappingURL=archiver.d.ts.map

package/dist/watcher/archiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archiver.d.ts","sourceRoot":"","sources":["../../src/watcher/archiver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/watcher/archiver.js

@@ -0,0 +1,66 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { parseSpecMd } from '../core/parser.js';
+import { deriveSpecState } from '../core/state.js';
+export async function applyDelta(projectRoot, specFolderPath, config) {
+    const specMdPath = path.join(specFolderPath, 'spec.md');
+    let specContent = '';
+    try {
+        specContent = await fs.readFile(specMdPath, 'utf8');
+    }
+    catch {
+        return;
+    }
+    const specData = parseSpecMd(specContent);
+    if (!specData.delta.trim() || specData.features.writes.length === 0) {
+        return;
+    }
+    const featuresDir = path.join(projectRoot, config.paths.features);
+    await fs.mkdir(featuresDir, { recursive: true });
+    for (const featureName of specData.features.writes) {
+        const featurePath = path.join(featuresDir, `${featureName}.md`);
+        let existing = '';
+        try {
+            existing = await fs.readFile(featurePath, 'utf8');
+        }
+        catch { }
+        let updatedContent = '';
+        if (!existing.trim()) {
+            const titleWords = featureName
+                .split('-')
+                .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+                .join(' ');
+            updatedContent = `# ${titleWords}\n\n${specData.delta}\n`;
+        }
+        else {
+            updatedContent = `${existing.trim()}\n\n## Delta from ${specData.title}\n\n${specData.delta}\n`;
+        }
+        await fs.writeFile(featurePath, updatedContent, 'utf8');
+    }
+}
+export async function archiveSpecFolder(projectRoot, specFolderPath, config) {
+    const archiveDir = path.join(projectRoot, config.paths.archive);
+    await fs.mkdir(archiveDir, { recursive: true });
+    const folderName = path.basename(specFolderPath);
+    let targetPath = path.join(archiveDir, folderName);
+    let counter = 1;
+    while (await fs
+        .stat(targetPath)
+        .then(() => true)
+        .catch(() => false)) {
+        targetPath = path.join(archiveDir, `${folderName}-${counter}`);
+        counter++;
+    }
+    await fs.rename(specFolderPath, targetPath);
+    return targetPath;
+}
+export async function checkAndArchiveSpec(projectRoot, specFolderPath, config) {
+    const specState = await deriveSpecState(projectRoot, specFolderPath);
+    if (specState.status !== 'done') {
+        return false;
+    }
+    await applyDelta(projectRoot, specFolderPath, config);
+    await archiveSpecFolder(projectRoot, specFolderPath, config);
+    return true;
+}
+//# sourceMappingURL=archiver.js.map

package/dist/watcher/archiver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archiver.js","sourceRoot":"","sources":["../../src/watcher/archiver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,cAAsB,EACtB,MAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACxD,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClE,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjD,KAAK,MAAM,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACnD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,WAAW,KAAK,CAAC,CAAC;QAChE,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QAEV,IAAI,cAAc,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YACrB,MAAM,UAAU,GAAG,WAAW;iBAC3B,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;iBAClD,IAAI,CAAC,GAAG,CAAC,CAAC;YACb,cAAc,GAAG,KAAK,UAAU,OAAO,QAAQ,CAAC,KAAK,IAAI,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,cAAc,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,qBAAqB,QAAQ,CAAC,KAAK,OAAO,QAAQ,CAAC,KAAK,IAAI,CAAC;QAClG,CAAC;QAED,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,cAAsB,EACtB,MAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACjD,IAAI,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAEnD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OACE,MAAM,EAAE;SACL,IAAI,CAAC,UAAU,CAAC;SAChB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EACrB,CAAC;QACD,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,UAAU,IAAI,OAAO,EAAE,CAAC,CAAC;QAC/D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,cAAsB,EACtB,MAAiB;IAEjB,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACrE,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,iBAAiB,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/watcher/loop.d.ts

@@ -0,0 +1,34 @@
+import type { OsqConfig } from '../core/config.js';
+import { type Logger } from '../core/logger.js';
+import type { HarnessAdapter } from '../harness/types.js';
+export interface WatcherSummary {
+    tasksRun: number;
+    specsArchived: number;
+}
+export interface StartWatcherOptions {
+    once?: boolean;
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+    logger?: Logger;
+}
+export interface ArchivedSpecSummary {
+    id: string;
+    folder: string;
+    archivedAt: number;
+}
+export declare function formatAgo(ms: number): string;
+/**
+ * Single idle status line: the watched spec directory, how many approved specs
+ * are still waiting, and when the last spec was archived. Pure so the exact
+ * shape is testable without a watcher.
+ */
+export declare function formatIdleStatus(specsDir: string, approvedWaiting: number, lastArchived?: ArchivedSpecSummary, now?: number): string;
+/**
+ * Most recently archived spec folder, derived from the archive directory's
+ * modification times so the idle status survives a watcher restart.
+ */
+export declare function findLatestArchivedSpec(projectRoot: string, config: OsqConfig): Promise<ArchivedSpecSummary | undefined>;
+export declare function runWatcherCycle(projectRoot: string, config: OsqConfig, adapter: HarnessAdapter, logger?: Logger): Promise<WatcherSummary>;
+export declare function runWatcherOnce(projectRoot: string, config: OsqConfig, adapter: HarnessAdapter, logger?: Logger): Promise<WatcherSummary>;
+export declare function startWatcher(projectRoot: string, config: OsqConfig, adapter: HarnessAdapter, options?: StartWatcherOptions): Promise<void>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/watcher/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/watcher/loop.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,mBAAmB,CAAC;AAG/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO1D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAS5C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,mBAAmB,EAClC,GAAG,GAAE,MAAmB,GACvB,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAyB1C;AAUD,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CAmFzB;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CAezB;AAED,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAuFf"}

package/dist/watcher/loop.js

@@ -0,0 +1,235 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { watch } from 'chokidar';
+import { reapStaleLocks } from '../core/lock.js';
+import { resolveSymbol } from '../core/logger.js';
+import { compareNumericPrefix, deriveSpecState } from '../core/state.js';
+import { preflightOpencode } from '../harness/opencode.js';
+import { checkAndArchiveSpec } from './archiver.js';
+import { runTask } from './runner.js';
+const SHOW_CURSOR = '\x1b[?25h';
+const EXIT_SIGINT = 130;
+export function formatAgo(ms) {
+    const seconds = Math.max(0, Math.floor(ms / 1000));
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
+}
+/**
+ * Single idle status line: the watched spec directory, how many approved specs
+ * are still waiting, and when the last spec was archived. Pure so the exact
+ * shape is testable without a watcher.
+ */
+export function formatIdleStatus(specsDir, approvedWaiting, lastArchived, now = Date.now()) {
+    const last = lastArchived
+        ? `last: ${lastArchived.id} archived ${formatAgo(now - lastArchived.archivedAt)}`
+        : 'last: none';
+    return `watching ${specsDir} · ${approvedWaiting} approved waiting · ${last}`;
+}
+/**
+ * Most recently archived spec folder, derived from the archive directory's
+ * modification times so the idle status survives a watcher restart.
+ */
+export async function findLatestArchivedSpec(projectRoot, config) {
+    const archiveDir = path.join(projectRoot, config.paths.archive);
+    let entries = [];
+    try {
+        entries = await fs.readdir(archiveDir, { withFileTypes: true });
+    }
+    catch {
+        return undefined;
+    }
+    let latest;
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const stat = await fs.stat(path.join(archiveDir, entry.name)).catch(() => null);
+        if (!stat)
+            continue;
+        const summary = {
+            id: entry.name.match(/^(\d+)/)?.[1] ?? entry.name,
+            folder: entry.name,
+            archivedAt: stat.mtimeMs,
+        };
+        if (!latest || summary.archivedAt > latest.archivedAt) {
+            latest = summary;
+        }
+    }
+    return latest;
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function logWatcherError(logger, useSymbols, err) {
+    logger?.error(`${resolveSymbol('✗', '[error]', useSymbols)} watcher error: ${errorMessage(err)}`);
+}
+export async function runWatcherCycle(projectRoot, config, adapter, logger) {
+    const useSymbols = logger?.symbols === true;
+    const tag = (symbol, word) => resolveSymbol(symbol, word, useSymbols);
+    const specsDir = path.join(projectRoot, config.paths.specs);
+    let entries = [];
+    try {
+        entries = await fs.readdir(specsDir);
+    }
+    catch {
+        logger?.status(formatIdleStatus(config.paths.specs, 0));
+        return { tasksRun: 0, specsArchived: 0 };
+    }
+    const specFolders = entries
+        .filter((e) => !e.startsWith('_') && e !== 'archive')
+        .sort(compareNumericPrefix);
+    let tasksRun = 0;
+    let specsArchived = 0;
+    let approvedWaiting = 0;
+    for (const folder of specFolders) {
+        const folderPath = path.join(specsDir, folder);
+        try {
+            const stat = await fs.stat(folderPath).catch(() => null);
+            if (!stat || !stat.isDirectory())
+                continue;
+            await reapStaleLocks(folderPath, config.timeouts.staleLockSeconds);
+            const specState = await deriveSpecState(projectRoot, folderPath);
+            if (specState.approvedHash &&
+                (specState.status === 'pending' ||
+                    specState.status === 'running' ||
+                    specState.status === 'blocked')) {
+                approvedWaiting++;
+            }
+            if (specState.status === 'pending' && specState.nextTask) {
+                const taskNumber = specState.nextTask.taskNumber;
+                logger?.info(`${tag('▶ spec', '[spec]')} ${specState.id} picked up (${folder})`);
+                const taskResult = await runTask(projectRoot, folderPath, taskNumber, config, adapter, logger);
+                tasksRun++;
+                if (taskResult.success) {
+                    const archived = await checkAndArchiveSpec(projectRoot, folderPath, config);
+                    if (archived) {
+                        specsArchived++;
+                        logger?.info(`${tag('✓ spec', '[archived]')} ${specState.id} archived (${folder})`);
+                    }
+                }
+                else {
+                    logger?.info(`${tag('■ spec', '[halted]')} ${specState.id} halted (task ${taskNumber} dead)`);
+                }
+            }
+            else if (specState.status === 'done') {
+                const archived = await checkAndArchiveSpec(projectRoot, folderPath, config);
+                if (archived) {
+                    specsArchived++;
+                    logger?.info(`${tag('✓ spec', '[archived]')} ${specState.id} archived (${folder})`);
+                }
+            }
+        }
+        catch (err) {
+            logWatcherError(logger, useSymbols, err);
+        }
+    }
+    if (tasksRun === 0) {
+        const lastArchived = await findLatestArchivedSpec(projectRoot, config).catch(() => undefined);
+        logger?.status(formatIdleStatus(config.paths.specs, approvedWaiting, lastArchived));
+    }
+    return { tasksRun, specsArchived };
+}
+export async function runWatcherOnce(projectRoot, config, adapter, logger) {
+    let totalTasksRun = 0;
+    let totalSpecsArchived = 0;
+    while (true) {
+        const cycle = await runWatcherCycle(projectRoot, config, adapter, logger);
+        totalTasksRun += cycle.tasksRun;
+        totalSpecsArchived += cycle.specsArchived;
+        if (cycle.tasksRun === 0) {
+            break;
+        }
+    }
+    return { tasksRun: totalTasksRun, specsArchived: totalSpecsArchived };
+}
+export async function startWatcher(projectRoot, config, adapter, options = {}) {
+    const logger = options.logger;
+    if (adapter.name === 'opencode' || config.harness === 'opencode') {
+        if (adapter.preflight) {
+            await adapter.preflight(projectRoot, config);
+        }
+        else {
+            await preflightOpencode(projectRoot, config);
+        }
+    }
+    if (options.once) {
+        await runWatcherOnce(projectRoot, config, adapter, logger);
+        return;
+    }
+    const useSymbols = logger?.symbols === true;
+    let interrupted = false;
+    let stopped = false;
+    let isRunningCycle = false;
+    let intervalId = null;
+    let watcher = null;
+    let onSigint = () => { };
+    const stop = () => {
+        if (stopped)
+            return;
+        stopped = true;
+        if (intervalId)
+            clearInterval(intervalId);
+        watcher?.close().catch(() => { });
+        process.removeListener('SIGINT', onSigint);
+    };
+    onSigint = () => {
+        if (interrupted) {
+            process.exit(EXIT_SIGINT);
+        }
+        interrupted = true;
+        logger?.clearStatus();
+        if (logger?.interactive) {
+            process.stderr.write(SHOW_CURSOR);
+        }
+        logger?.info('waiting for running task to exit (press Ctrl+C again to kill)');
+        if (!isRunningCycle) {
+            stop();
+        }
+    };
+    process.on('SIGINT', onSigint);
+    const cycleHandler = async () => {
+        if (interrupted || stopped || isRunningCycle)
+            return;
+        isRunningCycle = true;
+        try {
+            await runWatcherCycle(projectRoot, config, adapter, logger);
+        }
+        catch (err) {
+            logWatcherError(logger, useSymbols, err);
+        }
+        finally {
+            isRunningCycle = false;
+            if (interrupted)
+                stop();
+        }
+    };
+    if (options.signal) {
+        if (options.signal.aborted) {
+            stop();
+            return;
+        }
+        options.signal.addEventListener('abort', stop);
+    }
+    await cycleHandler();
+    if (interrupted || stopped)
+        return;
+    const specsDir = path.join(projectRoot, config.paths.specs);
+    watcher = watch(specsDir, {
+        ignoreInitial: true,
+        depth: 3,
+    });
+    watcher.on('all', () => {
+        cycleHandler().catch(() => { });
+    });
+    intervalId = setInterval(() => {
+        cycleHandler().catch(() => { });
+    }, options.pollIntervalMs || 1000);
+}
+//# sourceMappingURL=loop.js.map

package/dist/watcher/loop.js.map

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

package/dist/watcher/runner.d.ts

@@ -0,0 +1,70 @@
+import type { OsqConfig } from '../core/config.js';
+import { type Logger } from '../core/logger.js';
+import { type HarnessAdapter } from '../harness/types.js';
+export type RunTaskFailureReason = 'spec_conflict' | 'already_running' | 'no_result' | 'verify_red' | 'crashed' | 'timeout';
+export interface RunTaskResult {
+    success: boolean;
+    reason?: RunTaskFailureReason;
+    error?: string;
+}
+/**
+ * Single-line, human-readable summary of a task outcome. Kept pure so the exact
+ * shape can be tested without running the runner, and used directly beside every
+ * marker write (`done/<n>` or `dead/<n>.md`) so the log and the marker agree.
+ */
+export declare function formatTaskOutcomeSummary(taskNumber: string, success: boolean, reason?: RunTaskFailureReason, extra?: string): string;
+export declare function tickTaskCheckbox(specFolderPath: string, taskNumber: string): Promise<void>;
+export interface TaskHeartbeatStats {
+    elapsedSeconds: number;
+    eventCount: number;
+    totalTokens: number;
+    toolCount: number;
+    cost?: number;
+    lastToolSummary?: string;
+}
+/**
+ * Snapshot of task progress. Counters are maintained in memory and advanced
+ * with only the bytes appended since the previous poll; the event file may not
+ * exist yet, in which case counters are zero.
+ */
+export declare function computeTaskHeartbeatStats(specFolderPath: string, taskNumber: string, startTime: number): Promise<TaskHeartbeatStats>;
+/**
+ * Drop the in-memory counters for a finished task so the map does not grow
+ * across watcher cycles.
+ */
+export declare function clearTaskHeartbeatStats(specFolderPath: string, taskNumber: string): void;
+/**
+ * Single-line running status row. The logger owns the animated spinner and
+ * prepends `<frame> `, so this text is truncated to leave room for that prefix
+ * while fitting `terminalWidth` columns.
+ */
+export declare function formatTaskStatusRow(taskNumber: string, stats: TaskHeartbeatStats, terminalWidth?: number): string;
+/** Periodic heartbeat line shared by the 1s TTY row and the non-TTY log. */
+export declare function formatTaskHeartbeatLine(taskNumber: string, stats: TaskHeartbeatStats): string;
+/**
+ * Curated task-started line: a single info line carrying the task title
+ * truncated so the whole line fits the terminal width. The lifecycle details
+ * (pid, timeout) travel with it so the marker and the log line stay in sync.
+ */
+export declare function formatTaskStartedLine(taskNumber: string, title: string, pid: number | undefined, timeoutSeconds: number, symbols: boolean, terminalWidth?: number): string;
+/**
+ * Curated task-outcome line: verified or dead with the failure reason and the
+ * elapsed seconds since the task began.
+ */
+export declare function formatTaskOutcomeLine(taskNumber: string, success: boolean, reason: RunTaskFailureReason | undefined, elapsedSeconds: number, symbols: boolean): string;
+/**
+ * Return the last text message emitted on the agent's event stream, or null
+ * when the stream has no text at all. Synthesis reads exclusively from
+ * first-class `text` events carrying the completed assistant message; raw
+ * harness payload shapes are never inspected. The stream is the append-only
+ * `.run/events/<n>.jsonl` file, so this survives a watcher restart.
+ */
+export declare function extractFinalTextFromStream(specFolderPath: string, taskNumber: string): Promise<string | null>;
+/**
+ * Write a result file synthesized from the agent's final stream message. The
+ * frontmatter flags it as `synthesized: true` and a comment attributes it to
+ * the watcher so a reader never mistakes it for an agent-authored result.
+ */
+export declare function synthesizeResultFile(resultsDir: string, taskNumber: string, finalText: string): Promise<string>;
+export declare function runTask(projectRoot: string, specFolderPath: string, taskNumber: string, config: OsqConfig, adapter: HarnessAdapter, logger?: Logger): Promise<RunTaskResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/watcher/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/watcher/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,mBAAmB,CAAC;AAG/D,OAAO,EAGL,KAAK,cAAc,EAGpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,iBAAiB,GACjB,WAAW,GACX,YAAY,GACZ,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,oBAAoB,EAC7B,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAOR;AAED,wBAAsB,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAehG;AAmDD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAuBD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CA0E7B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAGxF;AAkBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,kBAAkB,EACzB,aAAa,GAAE,MAA0E,GACxF,MAAM,CAwBR;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAE7F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,EAChB,aAAa,GAAE,MAA0E,GACxF,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,GACf,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgCxB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAmYxB"}