@matteeh/osq 0.1.0 → 0.2.0

package/dist/cli/watch.d.ts

@@ -1,9 +1,12 @@
-import { type LogLevel } from '../core/logger.js';
-export interface WatchCommandOptions {
-    once?: boolean;
-    verbose?: boolean;
-    quiet?: boolean;
-}
+import { type LogLevel } from '../core/foundation/logger.js';
+import type { WatchCommandOptions } from '../watcher/dev.js';
+export type { WatchCommandOptions };
 export declare function resolveLogLevel(options: WatchCommandOptions): LogLevel;
+/**
+ * Dev mode hands control to the supervisor, which runs the watcher as a `tsx`
+ * child and restarts it on source changes. The supervised worker carries
+ * `OSQ_DEV_WORKER=1` and must start the loop rather than recurse.
+ */
+export declare function shouldRunDevSupervisor(options: WatchCommandOptions, env?: NodeJS.ProcessEnv): boolean;
 export declare function watchCommand(options: WatchCommandOptions): Promise<void>;
 //# sourceMappingURL=watch.d.ts.map

package/dist/cli/watch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,mBAAmB,CAAC;AAIhE,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,QAAQ,CAItE;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9E"}
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,8BAA8B,CAAC;AAE3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,QAAQ,CAItE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAET;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa9E"}

package/dist/cli/watch.js

@@ -1,5 +1,5 @@
-import { loadConfig } from '../core/config.js';
-import { createLogger } from '../core/logger.js';
+import { loadConfig } from '../core/foundation/config.js';
+import { createLogger } from '../core/foundation/logger.js';
 import { getHarnessAdapter } from '../harness/index.js';
 import { startWatcher } from '../watcher/loop.js';
 export function resolveLogLevel(options) {
@@ -9,7 +9,20 @@ export function resolveLogLevel(options) {
         return 'verbose';
     return 'normal';
 }
+/**
+ * Dev mode hands control to the supervisor, which runs the watcher as a `tsx`
+ * child and restarts it on source changes. The supervised worker carries
+ * `OSQ_DEV_WORKER=1` and must start the loop rather than recurse.
+ */
+export function shouldRunDevSupervisor(options, env = process.env) {
+    return options.dev === true && env.OSQ_DEV_WORKER !== '1';
+}
 export async function watchCommand(options) {
+    if (shouldRunDevSupervisor(options)) {
+        const { runDevSupervisor } = await import('../watcher/dev.js');
+        await runDevSupervisor(options);
+        return;
+    }
     const cwd = process.cwd();
     const config = await loadConfig(cwd);
     const adapter = getHarnessAdapter(config.harness);

package/dist/cli/watch.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAiB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAClC,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACtC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;IAC9C,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAiB,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAClC,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACtC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAA4B,EAC5B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,OAAO,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,cAAc,KAAK,GAAG,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC/D,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;IAC9C,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;AAC3D,CAAC"}

package/dist/core/foundation/config-codex.d.ts

@@ -0,0 +1,22 @@
+import type { PlannerConfig } from './config.js';
+/**
+ * Optional Codex CLI execution settings. Every field is optional; omitting a
+ * field defers to Codex's own native configuration and defaults.
+ */
+export interface CodexConfig {
+    readonly bin?: string;
+    readonly model?: string;
+    readonly effort?: string;
+}
+/** Validate optional Codex settings, rejecting blank or non-string values. */
+export declare function validateCodexConfig(codex: unknown): CodexConfig;
+/**
+ * Validate the optional `planner` block. Supported harness names and
+ * harness-specific optional settings are derived from the canonical catalog;
+ * the model is always required. Unsupported settings fail with the selected
+ * harness and the offending setting named rather than being silently ignored.
+ */
+export declare function validatePlannerConfig(planner: unknown): PlannerConfig;
+export { resolveAdapterModel, resolveCodexBinary, resolveCodexEffort, resolveCodexModel, resolveHarnessEffort, resolveHarnessModel, resolvePlannerSelection, } from './harness-catalog.js';
+export type { PlannerSelection } from './harness-catalog.js';
+//# sourceMappingURL=config-codex.d.ts.map

package/dist/core/foundation/config-codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-codex.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-codex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAkB/D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CA6BrE;AAID,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/foundation/config-codex.js

@@ -0,0 +1,58 @@
+import { HARNESS_NAMES, findHarness } from './harness-catalog.js';
+const CODEX_STRING_FIELDS = ['bin', 'model', 'effort'];
+/** Validate optional Codex settings, rejecting blank or non-string values. */
+export function validateCodexConfig(codex) {
+    if (codex === undefined || codex === null) {
+        return {};
+    }
+    if (typeof codex !== 'object' || Array.isArray(codex)) {
+        throw new Error('codex configuration must be an object');
+    }
+    const record = codex;
+    const validated = {};
+    for (const field of CODEX_STRING_FIELDS) {
+        const value = record[field];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'string' || !value.trim()) {
+            throw new Error(`codex.${field} must be a non-empty string if provided`);
+        }
+        validated[field] = value.trim();
+    }
+    return validated;
+}
+/**
+ * Validate the optional `planner` block. Supported harness names and
+ * harness-specific optional settings are derived from the canonical catalog;
+ * the model is always required. Unsupported settings fail with the selected
+ * harness and the offending setting named rather than being silently ignored.
+ */
+export function validatePlannerConfig(planner) {
+    if (!planner || typeof planner !== 'object') {
+        throw new Error('planner configuration must be an object');
+    }
+    const p = planner;
+    if (typeof p.harness !== 'string' || !p.harness.trim()) {
+        throw new Error('planner.harness must be a non-empty string');
+    }
+    const entry = findHarness(p.harness);
+    if (!entry) {
+        throw new Error(`Unsupported planner harness: "${String(p.harness).trim()}". Must be one of: ${HARNESS_NAMES.join(', ')}`);
+    }
+    if (typeof p.model !== 'string' || !p.model.trim()) {
+        throw new Error('planner.model must be a non-empty string');
+    }
+    const model = p.model.trim();
+    if (p.agent !== undefined && (typeof p.agent !== 'string' || !p.agent.trim())) {
+        throw new Error('planner.agent must be a non-empty string if provided');
+    }
+    const agent = typeof p.agent === 'string' && p.agent.trim() ? p.agent.trim() : undefined;
+    if (agent && !entry.planner.agent) {
+        throw new Error(`planner.agent is unsupported for the ${entry.name} harness; remove it`);
+    }
+    return { harness: entry.name, model, ...(agent ? { agent } : {}) };
+}
+// Shared resolution lives in the canonical catalog; re-exported here so the
+// 032 public surface and its call sites keep working unchanged.
+export { resolveAdapterModel, resolveCodexBinary, resolveCodexEffort, resolveCodexModel, resolveHarnessEffort, resolveHarnessModel, resolvePlannerSelection, } from './harness-catalog.js';
+//# sourceMappingURL=config-codex.js.map

package/dist/core/foundation/config-codex.js.map

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

package/dist/core/foundation/config-doctor.d.ts

@@ -0,0 +1,14 @@
+import type { OsqConfig } from './config.js';
+/**
+ * Resolve the binary the doctor must probe for the active harness, using the
+ * catalog's executable resolution. Returns `null` for harnesses with no binary
+ * (the mock adapter). Uncatalogued names are echoed back so doctor can still
+ * report them as unavailable.
+ */
+export declare function harnessBinary(config: OsqConfig): string | null;
+/**
+ * Probe `<bin> --version`, returning the first trimmed output line. The default
+ * deadline matches the configured harness preflight value used elsewhere.
+ */
+export declare function probeVersion(bin: string, root: string, timeoutSeconds?: number): Promise<string>;
+//# sourceMappingURL=config-doctor.d.ts.map

package/dist/core/foundation/config-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-doctor.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-doctor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAK9D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAY5F"}

package/dist/core/foundation/config-doctor.js

@@ -0,0 +1,29 @@
+import { execFile } from 'node:child_process';
+import { findHarness, resolveHarnessExecutable } from './harness-catalog.js';
+/**
+ * Resolve the binary the doctor must probe for the active harness, using the
+ * catalog's executable resolution. Returns `null` for harnesses with no binary
+ * (the mock adapter). Uncatalogued names are echoed back so doctor can still
+ * report them as unavailable.
+ */
+export function harnessBinary(config) {
+    const name = typeof config.harness === 'string' ? config.harness.trim() : '';
+    if (name === '')
+        return null;
+    const entry = findHarness(name);
+    return entry ? resolveHarnessExecutable(entry.name, config) : name;
+}
+/**
+ * Probe `<bin> --version`, returning the first trimmed output line. The default
+ * deadline matches the configured harness preflight value used elsewhere.
+ */
+export function probeVersion(bin, root, timeoutSeconds = 10) {
+    return new Promise((resolve, reject) => {
+        execFile(bin, ['--version'], { cwd: root, timeout: timeoutSeconds * 1000 }, (err, out, errOut) => {
+            if (err)
+                return reject(err);
+            resolve((out || errOut).trim().split('\n')[0].trim());
+        });
+    });
+}
+//# sourceMappingURL=config-doctor.js.map

package/dist/core/foundation/config-doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-doctor.js","sourceRoot":"","sources":["../../../src/core/foundation/config-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,CAAC,CAAC,wBAAwB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,IAAY,EAAE,cAAc,GAAG,EAAE;IACzE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CACN,GAAG,EACH,CAAC,WAAW,CAAC,EACb,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,EAAE,EAC7C,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;YACnB,IAAI,GAAG;gBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/foundation/config-env.d.ts

@@ -0,0 +1,3 @@
+import { type OsqConfig, type OsqUserConfig } from './config.js';
+export declare function applyHarnessModelEnv(userConfig: OsqUserConfig, selectedHarness: string, envModel: string): Partial<OsqConfig>;
+//# sourceMappingURL=config-env.d.ts.map

package/dist/core/foundation/config-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-env.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjF,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,aAAa,EACzB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,CAAC,CAepB"}

package/dist/core/foundation/config-env.js

@@ -0,0 +1,22 @@
+import { DEFAULT_CONFIG } from './config.js';
+import { HARNESS_CATALOG } from './harness-catalog.js';
+// Apply OSQ_MODEL to catalogued harness sections that accept it; explicit
+// models still win and `defineConfig` owns default merging and validation.
+export function applyHarnessModelEnv(userConfig, selectedHarness, envModel) {
+    const selected = selectedHarness.trim().toLowerCase();
+    const overrides = {};
+    for (const entry of HARNESS_CATALOG) {
+        if (!entry.configKey)
+            continue;
+        if (!entry.envModelWhenUnselected && entry.name !== selected)
+            continue;
+        const sections = userConfig;
+        const section = sections[entry.configKey];
+        if (section?.model)
+            continue;
+        const defaults = DEFAULT_CONFIG[entry.configKey];
+        overrides[entry.configKey] = { ...(defaults ?? {}), ...(section ?? {}), model: envModel };
+    }
+    return overrides;
+}
+//# sourceMappingURL=config-env.js.map

package/dist/core/foundation/config-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-env.js","sourceRoot":"","sources":["../../../src/core/foundation/config-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAsC,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,0EAA0E;AAC1E,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB,CAClC,UAAyB,EACzB,eAAuB,EACvB,QAAgB;IAEhB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,SAAS;QAC/B,IAAI,CAAC,KAAK,CAAC,sBAAsB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvE,MAAM,QAAQ,GAAG,UAAuE,CAAC;QACzF,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,KAAK;YAAE,SAAS;QAC7B,MAAM,QAAQ,GAAI,cAAgE,CAChF,KAAK,CAAC,SAAS,CAChB,CAAC;QACF,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC5F,CAAC;IACD,OAAO,SAA+B,CAAC;AACzC,CAAC"}

package/dist/core/foundation/config-gates.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Task-boundary verification gates. `changeVerifyAfterTask` runs the change's
+ * proposal verify after each passing task verify; it defaults on so every
+ * completed task leaves the full change verifier green. `preSpawnVerify`
+ * controls whether a task's verify runs once before its first attempt.
+ * `autoRetries` bounds how many automatic retries the watcher may spend on a
+ * dead task before a human must intervene; zero disables them.
+ */
+export type PreSpawnVerifyMode = 'warn' | 'fail' | 'off';
+export interface GatesConfig {
+    readonly changeVerifyAfterTask: boolean;
+    readonly preSpawnVerify?: PreSpawnVerifyMode;
+    readonly autoRetries?: number;
+}
+export declare const DEFAULT_GATES_CONFIG: GatesConfig;
+/**
+ * Validate an optional `gates` block over the defaults. A partial block keeps
+ * each missing gate's default; a present value outside the gate's type is
+ * rejected.
+ */
+export declare function validateGatesConfig(gates: unknown): GatesConfig;
+//# sourceMappingURL=config-gates.d.ts.map

package/dist/core/foundation/config-gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-gates.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-gates.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,oBAAoB,EAAE,WAIlC,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAkC/D"}

package/dist/core/foundation/config-gates.js

@@ -0,0 +1,43 @@
+export const DEFAULT_GATES_CONFIG = {
+    changeVerifyAfterTask: true,
+    preSpawnVerify: 'warn',
+    autoRetries: 1,
+};
+const PRE_SPAWN_VERIFY_MODES = ['warn', 'fail', 'off'];
+/**
+ * Validate an optional `gates` block over the defaults. A partial block keeps
+ * each missing gate's default; a present value outside the gate's type is
+ * rejected.
+ */
+export function validateGatesConfig(gates) {
+    if (gates === undefined)
+        return DEFAULT_GATES_CONFIG;
+    if (typeof gates !== 'object' || gates === null || Array.isArray(gates)) {
+        throw new Error('gates configuration must be an object');
+    }
+    const record = gates;
+    const value = record.changeVerifyAfterTask === undefined
+        ? DEFAULT_GATES_CONFIG.changeVerifyAfterTask
+        : record.changeVerifyAfterTask;
+    if (typeof value !== 'boolean') {
+        throw new Error('gates.changeVerifyAfterTask must be a boolean');
+    }
+    const preSpawnRaw = record.preSpawnVerify === undefined
+        ? DEFAULT_GATES_CONFIG.preSpawnVerify
+        : record.preSpawnVerify;
+    if (!PRE_SPAWN_VERIFY_MODES.includes(preSpawnRaw)) {
+        throw new Error('gates.preSpawnVerify must be one of warn, fail, off');
+    }
+    const autoRetriesRaw = record.autoRetries === undefined ? DEFAULT_GATES_CONFIG.autoRetries : record.autoRetries;
+    if (typeof autoRetriesRaw !== 'number' ||
+        !Number.isInteger(autoRetriesRaw) ||
+        autoRetriesRaw < 0) {
+        throw new Error('gates.autoRetries must be a non-negative integer');
+    }
+    return {
+        changeVerifyAfterTask: value,
+        preSpawnVerify: preSpawnRaw,
+        autoRetries: autoRetriesRaw,
+    };
+}
+//# sourceMappingURL=config-gates.js.map

package/dist/core/foundation/config-gates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-gates.js","sourceRoot":"","sources":["../../../src/core/foundation/config-gates.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,qBAAqB,EAAE,IAAI;IAC3B,cAAc,EAAE,MAAM;IACtB,WAAW,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,sBAAsB,GAAkC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAEtF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,oBAAoB,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,KAAK,GACT,MAAM,CAAC,qBAAqB,KAAK,SAAS;QACxC,CAAC,CAAC,oBAAoB,CAAC,qBAAqB;QAC5C,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC;IACnC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,WAAW,GACf,MAAM,CAAC,cAAc,KAAK,SAAS;QACjC,CAAC,CAAC,oBAAoB,CAAC,cAAc;QACrC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;IAC5B,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,WAAiC,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,cAAc,GAClB,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;IAC3F,IACE,OAAO,cAAc,KAAK,QAAQ;QAClC,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC;QACjC,cAAc,GAAG,CAAC,EAClB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO;QACL,qBAAqB,EAAE,KAAK;QAC5B,cAAc,EAAE,WAAiC;QACjD,WAAW,EAAE,cAAc;KAC5B,CAAC;AACJ,CAAC"}

package/dist/core/foundation/config-pi.d.ts

@@ -0,0 +1,64 @@
+import type { OsqConfig } from './config.js';
+/**
+ * Optional Pi CLI execution settings. Every field is optional; omitting a field
+ * defers to Pi's own native configuration and defaults. Pi reads `AGENTS.md`
+ * itself, so osq writes no Pi files.
+ */
+export interface PiConfig {
+    readonly bin?: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly thinking?: string;
+}
+/** Validate optional Pi settings, rejecting blank or non-string values. */
+export declare function validatePiConfig(pi: unknown): PiConfig;
+/** Tested Pi release range. Pi ships often, so bumping this is a one-liner. */
+export declare const PI_TESTED_RANGE = ">=0.87.0 <0.88.0";
+/** Assessment of one `pi --version` line against the tested range. */
+export interface PiVersionAssessment {
+    readonly version: string;
+    readonly tested: boolean;
+    readonly warning?: string;
+}
+/** Assess the first line of `pi --version` without failing outside the range. */
+export declare function assessPiVersion(raw: string): PiVersionAssessment;
+/** Outcome of `pi auth check --provider <name> --json`. */
+export interface PiAuthResult {
+    readonly ok: boolean;
+    readonly status: string;
+    readonly provider: string;
+    readonly reason?: string;
+}
+/** Inputs a catalog entry's doctor `diagnose` hook receives after a probe. */
+export interface HarnessDiagnoseContext {
+    readonly config: OsqConfig;
+    readonly projectRoot: string;
+    readonly version: string;
+}
+/** One extra doctor check contributed by a catalog entry. */
+export interface HarnessDiagnosis {
+    readonly name: string;
+    readonly ok: boolean;
+    readonly warning?: boolean;
+    readonly message: string;
+}
+/** Resolve the Pi executable: explicit `pi.bin`, then `OSQ_PI_PATH`, then `pi`. */
+export declare function resolvePiBinary(config?: {
+    readonly pi?: {
+        readonly bin?: string;
+    };
+}): string;
+/** Pi thinking level as effort, or null when unset. */
+export declare function resolvePiEffort(config?: {
+    readonly pi?: {
+        readonly thinking?: string;
+    };
+}): string | null;
+/** Version warning plus provider credential check for `osq doctor`. */
+export declare function diagnosePi(context: HarnessDiagnoseContext): Promise<readonly HarnessDiagnosis[]>;
+/**
+ * Run `pi auth check --provider <name> --json`. Pi exits 0, 1, or 2 and always
+ * prints the status object, so a non-zero exit is data, not an error.
+ */
+export declare function runPiAuthCheck(bin: string, projectRoot: string, provider: string, timeoutSeconds?: number): Promise<PiAuthResult>;
+//# sourceMappingURL=config-pi.d.ts.map

package/dist/core/foundation/config-pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-pi.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-pi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,QAAQ,CAkBtD;AAED,+EAA+E;AAC/E,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAKlD,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAmBhE;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAM5F;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,GAAG,MAAM,GAAG,IAAI,CAEhB;AAED,uEAAuE;AACvE,wBAAsB,UAAU,CAC9B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CA4BtC;AAmBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,cAAc,SAAK,GAClB,OAAO,CAAC,YAAY,CAAC,CAoBvB"}

package/dist/core/foundation/config-pi.js

@@ -0,0 +1,131 @@
+import { execFile } from 'node:child_process';
+const PI_STRING_FIELDS = ['bin', 'provider', 'model', 'thinking'];
+/** Validate optional Pi settings, rejecting blank or non-string values. */
+export function validatePiConfig(pi) {
+    if (pi === undefined || pi === null) {
+        return {};
+    }
+    if (typeof pi !== 'object' || Array.isArray(pi)) {
+        throw new Error('pi configuration must be an object');
+    }
+    const record = pi;
+    const validated = {};
+    for (const field of PI_STRING_FIELDS) {
+        const value = record[field];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'string' || !value.trim()) {
+            throw new Error(`pi.${field} must be a non-empty string if provided`);
+        }
+        validated[field] = value.trim();
+    }
+    return validated;
+}
+/** Tested Pi release range. Pi ships often, so bumping this is a one-liner. */
+export const PI_TESTED_RANGE = '>=0.87.0 <0.88.0';
+const PI_TESTED_MIN = [0, 87, 0];
+const PI_TESTED_MAX = [0, 88, 0];
+function compareVersion(a, b) {
+    for (let i = 0; i < 3; i += 1) {
+        if (a[i] !== b[i])
+            return (a[i] ?? 0) - (b[i] ?? 0);
+    }
+    return 0;
+}
+/** Assess the first line of `pi --version` without failing outside the range. */
+export function assessPiVersion(raw) {
+    const version = raw.trim().split('\n')[0]?.trim() ?? '';
+    const match = /(\d+)\.(\d+)\.(\d+)/.exec(version);
+    if (!match) {
+        return {
+            version,
+            tested: false,
+            warning: `Pi version "${version}" is outside the tested range ${PI_TESTED_RANGE}`,
+        };
+    }
+    const current = [Number(match[1]), Number(match[2]), Number(match[3])];
+    const tested = compareVersion(current, PI_TESTED_MIN) >= 0 && compareVersion(current, PI_TESTED_MAX) < 0;
+    if (tested)
+        return { version, tested };
+    return {
+        version,
+        tested,
+        warning: `Pi ${version} is outside the tested range ${PI_TESTED_RANGE}`,
+    };
+}
+/** Resolve the Pi executable: explicit `pi.bin`, then `OSQ_PI_PATH`, then `pi`. */
+export function resolvePiBinary(config) {
+    const explicit = config?.pi?.bin?.trim();
+    if (explicit)
+        return explicit;
+    const fromEnv = process.env.OSQ_PI_PATH?.trim();
+    if (fromEnv)
+        return fromEnv;
+    return 'pi';
+}
+/** Pi thinking level as effort, or null when unset. */
+export function resolvePiEffort(config) {
+    return config?.pi?.thinking?.trim() || null;
+}
+/** Version warning plus provider credential check for `osq doctor`. */
+export async function diagnosePi(context) {
+    const assessment = assessPiVersion(context.version);
+    const version = {
+        name: 'harness-version',
+        ok: true,
+        ...(assessment.tested ? {} : { warning: true }),
+        message: assessment.tested
+            ? `Pi ${assessment.version} (tested ${PI_TESTED_RANGE})`
+            : (assessment.warning ?? `Pi ${assessment.version} is outside ${PI_TESTED_RANGE}`),
+    };
+    const provider = context.config.pi?.provider?.trim();
+    if (!provider)
+        return [version];
+    const auth = await runPiAuthCheck(resolvePiBinary(context.config), context.projectRoot, provider, context.config.timeouts?.harnessPreflightSeconds ?? 10);
+    const authCheck = auth.ok
+        ? { name: 'harness-auth', ok: true, message: `${auth.provider} credentials ready` }
+        : {
+            name: 'harness-auth',
+            ok: false,
+            message: `${auth.provider} credentials not ready: ${auth.reason ?? auth.status}`,
+        };
+    return [version, authCheck];
+}
+function parseJsonRecord(raw) {
+    if (!raw)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function stringField(record, key) {
+    const value = record?.[key];
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+/**
+ * Run `pi auth check --provider <name> --json`. Pi exits 0, 1, or 2 and always
+ * prints the status object, so a non-zero exit is data, not an error.
+ */
+export function runPiAuthCheck(bin, projectRoot, provider, timeoutSeconds = 10) {
+    return new Promise((resolve) => {
+        execFile(bin, ['auth', 'check', '--provider', provider, '--json'], { cwd: projectRoot, timeout: timeoutSeconds * 1000 }, (err, stdout) => {
+            const parsed = parseJsonRecord((stdout || '').trim());
+            const status = stringField(parsed, 'status') ?? (err ? 'error' : 'unknown');
+            const reason = stringField(parsed, 'reason') ?? (err ? String(err.message) : undefined);
+            const resolvedProvider = stringField(parsed, 'provider') ?? provider;
+            resolve({
+                ok: status === 'ready',
+                status,
+                provider: resolvedProvider,
+                ...(reason ? { reason } : {}),
+            });
+        });
+    });
+}
+//# sourceMappingURL=config-pi.js.map

package/dist/core/foundation/config-pi.js.map

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

package/dist/core/foundation/config-planning.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Planning measurement settings. `idleGapMinutes` bounds the gap between two
+ * owned turns that still counts as active planning; `prices` optionally maps a
+ * model id to USD per million tokens so a slice can be priced when no harness
+ * reported a cost. osq ships no price table of its own.
+ */
+export interface PlanningPrice {
+    readonly input: number;
+    readonly output: number;
+    readonly cacheRead: number;
+    readonly cacheWrite: number;
+}
+export interface PlanningConfig {
+    readonly idleGapMinutes: number;
+    readonly prices?: Readonly<Record<string, PlanningPrice>>;
+}
+export declare const DEFAULT_PLANNING_CONFIG: PlanningConfig;
+/**
+ * Validate an optional `planning` block over the defaults. A partial block
+ * keeps the default idle gap; a present `prices` map must hold complete,
+ * finite, non-negative price entries. Every rejection names the offending key.
+ */
+export declare function validatePlanningConfig(planning: unknown): PlanningConfig;
+//# sourceMappingURL=config-planning.d.ts.map

package/dist/core/foundation/config-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-planning.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-planning.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CAC3D;AAED,eAAO,MAAM,uBAAuB,EAAE,cAErC,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,CAmBxE"}

package/dist/core/foundation/config-planning.js

@@ -0,0 +1,60 @@
+export const DEFAULT_PLANNING_CONFIG = {
+    idleGapMinutes: 10,
+};
+const PRICE_KINDS = ['input', 'output', 'cacheRead', 'cacheWrite'];
+/**
+ * Validate an optional `planning` block over the defaults. A partial block
+ * keeps the default idle gap; a present `prices` map must hold complete,
+ * finite, non-negative price entries. Every rejection names the offending key.
+ */
+export function validatePlanningConfig(planning) {
+    if (planning === undefined)
+        return DEFAULT_PLANNING_CONFIG;
+    if (typeof planning !== 'object' || planning === null || Array.isArray(planning)) {
+        throw new Error('planning configuration must be an object with idleGapMinutes');
+    }
+    const record = planning;
+    const idleGapMinutes = record.idleGapMinutes === undefined
+        ? DEFAULT_PLANNING_CONFIG.idleGapMinutes
+        : record.idleGapMinutes;
+    if (typeof idleGapMinutes !== 'number' ||
+        !Number.isFinite(idleGapMinutes) ||
+        idleGapMinutes <= 0) {
+        throw new Error('planning.idleGapMinutes must be a positive finite number');
+    }
+    const prices = validatePlanningPrices(record.prices);
+    return prices === undefined ? { idleGapMinutes } : { idleGapMinutes, prices };
+}
+function validatePlanningPrices(prices) {
+    if (prices === undefined)
+        return undefined;
+    if (typeof prices !== 'object' || prices === null || Array.isArray(prices)) {
+        throw new Error('planning.prices must be an object mapping model ids to prices');
+    }
+    const result = {};
+    for (const [model, entry] of Object.entries(prices)) {
+        result[model] = validatePlanningPrice(model, entry);
+    }
+    return result;
+}
+function validatePlanningPrice(model, entry) {
+    if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) {
+        throw new Error(`planning.prices.${model} must be an object with input, output, cacheRead, cacheWrite`);
+    }
+    const record = entry;
+    const price = {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+    };
+    for (const kind of PRICE_KINDS) {
+        const value = record[kind];
+        if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+            throw new Error(`planning.prices.${model}.${kind} must be a finite non-negative number`);
+        }
+        price[kind] = value;
+    }
+    return price;
+}
+//# sourceMappingURL=config-planning.js.map

package/dist/core/foundation/config-planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-planning.js","sourceRoot":"","sources":["../../../src/core/foundation/config-planning.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,cAAc,EAAE,EAAE;CACnB,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAE5E;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,uBAAuB,CAAC;IAC3D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,MAAM,GAAG,QAAmC,CAAC;IACnD,MAAM,cAAc,GAClB,MAAM,CAAC,cAAc,KAAK,SAAS;QACjC,CAAC,CAAC,uBAAuB,CAAC,cAAc;QACxC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;IAC5B,IACE,OAAO,cAAc,KAAK,QAAQ;QAClC,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;QAChC,cAAc,IAAI,CAAC,EACnB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;AAChF,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAAe;IAEf,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,MAAM,GAAkC,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;QAC/E,MAAM,CAAC,KAAK,CAAC,GAAG,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa,EAAE,KAAc;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,mBAAmB,KAAK,8DAA8D,CACvF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,KAAK,GAAiD;QAC1D,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;KACd,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,IAAI,IAAI,uCAAuC,CAAC,CAAC;QAC3F,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}