dsh-better-display 0.3.7 → 0.3.9

package/lib/types/flags.d.ts

@@ -0,0 +1,7 @@
+/** Startup kill switch loaded from flags.json. This is not the reader glass setting. */
+export interface Flags {
+    readonly readerEnabled: boolean;
+}
+export declare const defaultFlags: Flags;
+export declare function loadFlags(source?: string | Flags): Flags;
+//# sourceMappingURL=flags.d.ts.map

package/lib/types/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/flags.ts"],"names":[],"mappings":"AAIA,wFAAwF;AACxF,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,eAAO,MAAM,YAAY,EAAE,KAA+B,CAAC;AAqB3D,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CASxD"}

package/lib/types/flags.js

@@ -0,0 +1,37 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export const defaultFlags = { readerEnabled: true };
+function locateFlags(start = dirname(fileURLToPath(import.meta.url))) {
+    let dir = start;
+    for (let depth = 0; depth < 6; depth += 1) {
+        const candidate = resolve(dir, 'flags.json');
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+    return undefined;
+}
+function normalize(value) {
+    const record = value !== null && typeof value === 'object' ? value : {};
+    return {
+        readerEnabled: typeof record.readerEnabled === 'boolean' ? record.readerEnabled : defaultFlags.readerEnabled,
+    };
+}
+export function loadFlags(source) {
+    if (source !== undefined && typeof source !== 'string')
+        return normalize(source);
+    try {
+        const path = typeof source === 'string' ? source : locateFlags();
+        if (path === undefined || !existsSync(path))
+            return { ...defaultFlags };
+        return normalize(JSON.parse(readFileSync(path, 'utf8')));
+    }
+    catch {
+        return { ...defaultFlags };
+    }
+}
+//# sourceMappingURL=flags.js.map

package/lib/types/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC,MAAM,CAAC,MAAM,YAAY,GAAU,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;AAE3D,SAAS,WAAW,CAAC,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClE,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC7C,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,SAAS,CAAC;QACrC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,MAAM,GAAG,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAoC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvG,OAAO;QACL,aAAa,EAAE,OAAO,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa;KAC7G,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAuB;IAC/C,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IACjF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACjE,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/lib/types/log.d.ts

@@ -0,0 +1,17 @@
+import type { IncomingMessage } from 'node:http';
+export declare const REDACTED = "[REDACTED]";
+export type LogFields = Record<string, unknown>;
+export interface Logger {
+    info(msg: string, fields?: LogFields): void;
+    warn(msg: string, fields?: LogFields): void;
+    error(msg: string, fields?: LogFields): void;
+}
+export interface LoggerOptions {
+    readonly write?: (line: string) => void;
+    readonly base?: LogFields;
+    readonly clock?: () => Date;
+}
+export declare function redact(value: unknown): unknown;
+export declare function createLogger(options?: LoggerOptions): Logger;
+export declare function requestIdOf(req: IncomingMessage): string;
+//# sourceMappingURL=log.d.ts.map

package/lib/types/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/log.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,eAAO,MAAM,QAAQ,eAAe,CAAC;AAiCrC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AA+BD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9C;AAwBD,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAwBhE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAKxD"}

package/lib/types/log.js

@@ -0,0 +1,122 @@
+import { randomUUID } from 'node:crypto';
+export const REDACTED = '[REDACTED]';
+const REQUEST_ID_HEADER = 'x-request-id';
+const REQUEST_ID_PATTERN = /^[A-Za-z0-9._:-]{1,200}$/;
+const SECRET_KEYS = new Set([
+    'authorization',
+    'proxyauthorization',
+    'cookie',
+    'setcookie',
+    'token',
+    'accesstoken',
+    'refreshtoken',
+    'idtoken',
+    'apikey',
+    'apisecret',
+    'secret',
+    'clientsecret',
+    'password',
+    'passwd',
+    'credential',
+    'credentials',
+    'signature',
+    'sig',
+    'jwt',
+    'bearer',
+    'privatekey',
+    'xapikey',
+    'xauthtoken',
+    'xaccesstoken',
+    'auth',
+]);
+function normalizeKey(key) {
+    return key.toLowerCase().replace(/[^a-z0-9]/g, '');
+}
+function isSecretKey(key) {
+    const normalized = normalizeKey(key);
+    if (SECRET_KEYS.has(normalized))
+        return true;
+    if (normalized === 'requestid' || normalized === 'xrequestid')
+        return false;
+    return /(?:^|[^a-z])(?:token|secret|password|api[-_]?key)$/i.test(key);
+}
+function redactString(value) {
+    const query = value.replace(/([?&#])([^&#=]+)=([^&#]*)/g, (match, sep, rawKey) => {
+        let key;
+        try {
+            key = decodeURIComponent(rawKey.replace(/\+/g, ' '));
+        }
+        catch {
+            key = rawKey;
+        }
+        return isSecretKey(key) ? `${sep}${rawKey}=${REDACTED}` : match;
+    });
+    return query
+        .replace(/\b(Bearer|Basic)\s+\S+/gi, `$1 ${REDACTED}`)
+        .replace(/\b((?:access[_-]?token|refresh[_-]?token|id[_-]?token|api[_-]?key|client[_-]?secret|password|passwd|authorization|token|secret))(\s*[:=]\s*)([^\s&]+)/gi, `$1$2${REDACTED}`);
+}
+export function redact(value) {
+    return redactValue(undefined, value, 0, new WeakSet());
+}
+function redactValue(key, value, depth, seen) {
+    if (key !== undefined && isSecretKey(key))
+        return REDACTED;
+    if (depth > 8)
+        return REDACTED;
+    if (typeof value === 'string')
+        return redactString(value);
+    if (typeof value === 'number' || typeof value === 'boolean' || value === null || value === undefined)
+        return value;
+    if (typeof value !== 'object')
+        return REDACTED;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (value instanceof Error) {
+        return redactValue(undefined, { name: value.name, message: value.message }, depth + 1, seen);
+    }
+    if (seen.has(value))
+        return REDACTED;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        return value.map(item => redactValue(undefined, item, depth + 1, seen));
+    }
+    const output = {};
+    for (const [childKey, childValue] of Object.entries(value)) {
+        output[childKey] = redactValue(childKey, childValue, depth + 1, seen);
+    }
+    return output;
+}
+export function createLogger(options = {}) {
+    const write = options.write ?? ((line) => {
+        console.log(line);
+    });
+    const clock = options.clock ?? (() => new Date());
+    const emit = (level, msg, fields) => {
+        const details = redact({ ...options.base, ...fields });
+        const record = {
+            ...(details !== null && typeof details === 'object' ? details : {}),
+            time: clock().toISOString(),
+            level,
+            msg: redactString(msg),
+        };
+        try {
+            write(JSON.stringify(record));
+        }
+        catch {
+            write(JSON.stringify({ time: record.time, level, msg: record.msg, error: 'log record was not serializable' }));
+        }
+    };
+    return {
+        info: (msg, fields) => emit('info', msg, fields),
+        warn: (msg, fields) => emit('warn', msg, fields),
+        error: (msg, fields) => emit('error', msg, fields),
+    };
+}
+export function requestIdOf(req) {
+    const raw = req.headers[REQUEST_ID_HEADER];
+    const value = Array.isArray(raw) ? raw[0] : raw;
+    if (typeof value === 'string' && REQUEST_ID_PATTERN.test(value))
+        return value;
+    return randomUUID();
+}
+//# sourceMappingURL=log.js.map

package/lib/types/log.js.map

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

package/lib/types/metrics.d.ts

@@ -0,0 +1,18 @@
+export declare const ROUTE_REVEAL = "/better-display/reveal";
+export declare const ROUTE_SKILL_STATUS = "/better-display/skill-status";
+export declare const ROUTE_METRICS = "/better-display/metrics";
+export declare const ROUTE_HITS: readonly ["/better-display/reveal", "/better-display/skill-status", "/better-display/metrics"];
+export interface RouteTiming {
+    count: number;
+    totalMs: number;
+    maxMs: number;
+}
+export declare function recordRouteHit(route: string): number;
+export declare function recordRouteDuration(route: string, elapsedMs: number): RouteTiming;
+export declare function metricsPayload(): {
+    counters: {
+        dsh_better_display_route_hits_total: Record<string, number>;
+    };
+    timingsMs: Record<string, RouteTiming>;
+};
+//# sourceMappingURL=metrics.d.ts.map

package/lib/types/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/metrics.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,2BAA2B,CAAC;AACrD,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AACjE,eAAO,MAAM,aAAa,4BAA4B,CAAC;AAEvD,eAAO,MAAM,UAAU,gGAA6D,CAAC;AAErF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAaD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAUjF;AAED,wBAAgB,cAAc,IAAI;IAChC,QAAQ,EAAE;QAAE,mCAAmC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC1E,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACxC,CAKA"}

package/lib/types/metrics.js

@@ -0,0 +1,35 @@
+export const ROUTE_REVEAL = '/better-display/reveal';
+export const ROUTE_SKILL_STATUS = '/better-display/skill-status';
+export const ROUTE_METRICS = '/better-display/metrics';
+export const ROUTE_HITS = [ROUTE_REVEAL, ROUTE_SKILL_STATUS, ROUTE_METRICS];
+const hits = new Map(ROUTE_HITS.map(route => [route, 0]));
+const timings = new Map(ROUTE_HITS.map(route => [route, { count: 0, totalMs: 0, maxMs: 0 }]));
+function snapshotHits() {
+    return Object.fromEntries(hits);
+}
+function snapshotTimings() {
+    return Object.fromEntries([...timings].map(([route, timing]) => [route, { ...timing }]));
+}
+export function recordRouteHit(route) {
+    const next = (hits.get(route) ?? 0) + 1;
+    hits.set(route, next);
+    return next;
+}
+export function recordRouteDuration(route, elapsedMs) {
+    const ms = Number.isFinite(elapsedMs) && elapsedMs > 0 ? Math.round(elapsedMs) : 0;
+    const current = timings.get(route) ?? { count: 0, totalMs: 0, maxMs: 0 };
+    const next = {
+        count: current.count + 1,
+        totalMs: current.totalMs + ms,
+        maxMs: Math.max(current.maxMs, ms),
+    };
+    timings.set(route, next);
+    return next;
+}
+export function metricsPayload() {
+    return {
+        counters: { dsh_better_display_route_hits_total: snapshotHits() },
+        timingsMs: snapshotTimings(),
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/lib/types/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,wBAAwB,CAAC;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AACjE,MAAM,CAAC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAEvD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,kBAAkB,EAAE,aAAa,CAAU,CAAC;AAQrF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAiB,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAsB,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEnH,SAAS,YAAY;IACnB,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,SAAiB;IAClE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACzE,MAAM,IAAI,GAAG;QACX,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,EAAE;QAC7B,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;KACnC,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc;IAI5B,OAAO;QACL,QAAQ,EAAE,EAAE,mCAAmC,EAAE,YAAY,EAAE,EAAE;QACjE,SAAS,EAAE,eAAe,EAAE;KAC7B,CAAC;AACJ,CAAC"}

package/lib/types/reveal.d.ts

@@ -0,0 +1,12 @@
+import { type SpawnOptions } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Context } from '@deepseek-ai/cordis';
+export declare function revealRoots(ctx: Context, sessionId: string | undefined): Promise<readonly string[]>;
+export declare function resolveRevealPath(path: string, roots: readonly string[], exists?: typeof existsSync): string;
+export declare function revealPath(path: string, platform?: NodeJS.Platform, spawnProcess?: (command: string, args: string[], options: SpawnOptions) => unknown): void;
+export declare function createRevealHandler({ roots, reveal }: {
+    roots: (sessionId: string | undefined) => Promise<readonly string[]>;
+    reveal?: (path: string) => void;
+}): (req: IncomingMessage, res: ServerResponse) => void;
+//# sourceMappingURL=reveal.d.ts.map

package/lib/types/reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reveal.d.ts","sourceRoot":"","sources":["../../src/reveal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAmBzG;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,oBAAa,GAAG,MAAM,CAarG;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,kBAAmB,EAC3B,YAAY,GAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,KAAK,OAAe,GACxF,IAAI,CASN;AAED,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,MAAmB,EAAE,EAAE;IAClE,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACrE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CA4BtD"}

package/lib/types/reveal.js

@@ -0,0 +1,147 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { posix, win32 } from 'node:path';
+import { isAbsoluteWorkspacePath } from './workspace-path.js';
+export async function revealRoots(ctx, sessionId) {
+    if (sessionId !== undefined) {
+        const sessions = ctx.get?.('sessions');
+        const cwd = sessions?.get(sessionId)?.header.cwd;
+        if (cwd)
+            return [cwd];
+        const query = ctx.get?.('sessionQuery');
+        if (query) {
+            const env_1 = { stack: [], error: void 0, hasError: false };
+            try {
+                const observation = __addDisposableResource(env_1, await query.observeSession(sessionId, { projectionMode: 'none' }), false);
+                if (observation.header.cwd)
+                    return [observation.header.cwd];
+            }
+            catch (e_1) {
+                env_1.error = e_1;
+                env_1.hasError = true;
+            }
+            finally {
+                __disposeResources(env_1);
+            }
+        }
+    }
+    const registry = ctx.get?.('workspaceRegistry');
+    return (registry?.list() ?? [])
+        .filter(workspace => sessionId === undefined || workspace.sessionIds.includes(sessionId))
+        .map(workspace => workspace.path);
+}
+export function resolveRevealPath(path, roots, exists = existsSync) {
+    if (isAbsoluteWorkspacePath(path))
+        return path;
+    // Drive-relative and root-relative Windows paths do not identify a workspace.
+    if (/^[A-Za-z]:|^\\/.test(path))
+        throw new Error('Path is not workspace-relative');
+    const matches = new Set();
+    for (const root of roots) {
+        if (!isAbsoluteWorkspacePath(root))
+            continue;
+        const paths = /^[A-Za-z]:[/\\]|^\\\\/.test(root) ? win32 : posix;
+        const candidate = paths.resolve(root, path);
+        if (exists(candidate))
+            matches.add(candidate);
+    }
+    if (matches.size !== 1)
+        throw new Error(matches.size === 0 ? 'Workspace path not found' : 'Workspace path is ambiguous');
+    return [...matches][0];
+}
+export function revealPath(path, platform = process.platform, spawnProcess = spawn) {
+    const options = { detached: true, stdio: 'ignore' };
+    if (platform === 'darwin') {
+        spawnProcess('open', ['-R', path], options);
+    }
+    else if (platform === 'win32') {
+        spawnProcess('explorer.exe', [`/select,"${path}"`], { ...options, windowsVerbatimArguments: true });
+    }
+    else {
+        spawnProcess('xdg-open', [path], options);
+    }
+}
+export function createRevealHandler({ roots, reveal = revealPath }) {
+    return (req, res) => {
+        if (req.method !== 'POST') {
+            res.statusCode = 405;
+            res.end();
+            return;
+        }
+        let body = '';
+        req.on('data', chunk => { body += chunk; });
+        req.on('end', async () => {
+            res.setHeader('Content-Type', 'application/json');
+            try {
+                const data = JSON.parse(body);
+                const path = typeof data === 'object' && data !== null && 'path' in data && typeof data.path === 'string'
+                    ? data.path.trim() : '';
+                if (!path)
+                    throw new Error('Empty path');
+                const sessionId = typeof data === 'object' && data !== null && 'sessionId' in data && typeof data.sessionId === 'string'
+                    ? data.sessionId : undefined;
+                const targetPath = resolveRevealPath(path, isAbsoluteWorkspacePath(path) ? [] : await roots(sessionId));
+                reveal(targetPath);
+                res.statusCode = 200;
+                res.end(JSON.stringify({ ok: true }));
+            }
+            catch (err) {
+                res.statusCode = 400;
+                res.end(JSON.stringify({ ok: false, error: String(err) }));
+            }
+        });
+    };
+}
+//# sourceMappingURL=reveal.js.map

package/lib/types/reveal.js.map

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

package/lib/types/workspace-path.d.ts

@@ -0,0 +1,3 @@
+/** Absolute paths accepted by both POSIX and Windows hosts. */
+export declare function isAbsoluteWorkspacePath(path: string): boolean;
+//# sourceMappingURL=workspace-path.d.ts.map

package/lib/types/workspace-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-path.d.ts","sourceRoot":"","sources":["../../src/workspace-path.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/lib/types/workspace-path.js

@@ -0,0 +1,5 @@
+/** Absolute paths accepted by both POSIX and Windows hosts. */
+export function isAbsoluteWorkspacePath(path) {
+    return /^(?:\/|[A-Za-z]:[/\\]|\\\\)/.test(path);
+}
+//# sourceMappingURL=workspace-path.js.map

package/lib/types/workspace-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-path.js","sourceRoot":"","sources":["../../src/workspace-path.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-better-display",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "A calmer reading view for DeepSeek Harness: native process details, live reasoning, and clean final answers.",
   "type": "module",
   "license": "MIT",
@@ -38,9 +38,21 @@
     "test:official": "node scripts/verify-official-bridge.mjs",
     "test:auto-fold": "node scripts/verify-auto-fold.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "node --import tsx/esm --test tests/*.test.ts",
+    "test": "vitest run",
     "link:harness": "node scripts/link-harness-dependencies.mjs",
-    "test:flowcell": "node scripts/verify-flowcell.mjs"
+    "test:flowcell": "node scripts/verify-flowcell.mjs",
+    "lint": "eslint src --max-warnings 0",
+    "format:check": "prettier --check .",
+    "deadcode": "knip",
+    "duplicates": "jscpd src",
+    "debt": "node scripts/check-todo-debt.mjs",
+    "changelog": "node scripts/changelog.mjs",
+    "check:agents": "node scripts/check-agents-md.mjs",
+    "check:bundle": "node scripts/check-bundle-size.mjs",
+    "security:audit": "node scripts/security-audit-report.mjs",
+    "check:flags": "node scripts/check-dead-flags.mjs",
+    "test:list": "vitest list",
+    "test:coverage": "vitest run --coverage"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.4",
@@ -70,7 +82,17 @@
     "tsdown": "^0.22.2",
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
-    "semver": "^7.7.2"
+    "semver": "^7.7.2",
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.13.0",
+    "typescript-eslint": "^8.72.0",
+    "prettier": "^3.9.10",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.6.0",
+    "knip": "^6.42.1",
+    "jscpd": "^5.4.1",
+    "@vitest/coverage-v8": "5.0.5",
+    "vitest": "5.0.5"
   },
   "dependencies": {
     "clsx": "^2.0.0",
@@ -128,5 +150,14 @@
     "reasoning",
     "streaming",
     "accessibility"
-  ]
+  ],
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{mjs,cjs,js,json,md,yml,yaml,css}": [
+      "prettier --write"
+    ]
+  }
 }

package/scripts/changelog.mjs

@@ -0,0 +1,20 @@
+import { execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const root = fileURLToPath(new URL('..', import.meta.url));
+const count = process.argv.includes('--self-test') ? '5' : '30';
+const log = execFileSync(
+  'git',
+  ['log', '--no-merges', '-n', count, '--date=short', '--pretty=format:%h %ad %s'],
+  { encoding: 'utf8', cwd: root },
+);
+
+console.log('# Notes from git log');
+console.log('');
+console.log('This prints history only. It does not rewrite CHANGELOG.md.');
+console.log('');
+if (!log.trim()) {
+  console.log('(no commits)');
+} else {
+  for (const line of log.split('\n')) console.log(`- ${line}`);
+}

package/scripts/check-agents-md.mjs

@@ -0,0 +1,67 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const BUILTINS = new Set([
+  'ci', 'install', 'uninstall', 'update', 'outdated', 'ping', 'config', 'cache',
+  'explore', 'exec', 'x', 'dlx', 'init', 'create', 'pack', 'publish', 'login',
+  'logout', 'whoami', 'view', 'search', 'access', 'audit', 'fund', 'explain',
+  'prefix', 'root', 'bin', 'ls', 'version', 'help', 'doctor', 'diff', 'pkg',
+  'sbom', 'rebuild', 'link', 'unlink', 'prune', 'dedupe', 'install-test',
+]);
+
+/** Script names referenced by fenced npm commands, or null when the command is a builtin. */
+export function npmScriptName(rest) {
+  if (rest.startsWith('run ')) {
+    const name = rest.slice(4).trim().split(/\s+/)[0];
+    return name && !name.startsWith('-') ? name : '';
+  }
+  const head = rest.split(/\s+/)[0];
+  if (head === 'test' || head === 'start') return head;
+  if (BUILTINS.has(head)) return null;
+  return '';
+}
+
+export function missingNpmScripts(markdown, scriptNames) {
+  const missing = new Set();
+  for (const match of markdown.matchAll(/```[^\n]*\n([\s\S]*?)```/g)) {
+    for (const rawLine of match[1].split('\n')) {
+      for (const piece of rawLine.split(/&&|\|\||;/)) {
+        let command = piece.trim().replace(/^(?:[A-Za-z_][A-Za-z0-9_]*=\S*\s+)+/, '');
+        if (command.startsWith('$ ')) command = command.slice(2).trim();
+        if (!command.startsWith('npm ') && command !== 'npm') continue;
+        const name = npmScriptName(command.slice(3).trim());
+        if (name === null) continue;
+        if (!name || !scriptNames.has(name)) missing.add(name || command);
+      }
+    }
+  }
+  return [...missing];
+}
+
+function selfTest() {
+  const scripts = new Set(['build', 'test', 'typecheck']);
+  const ok = missingNpmScripts('```sh\nnpm ci\nnpm run build\nnpm test\n```\n', scripts);
+  const bad = missingNpmScripts('```sh\nnpm run nope\n```\nSee `npm run nope` outside.\n', scripts);
+  const unfenced = missingNpmScripts('Run npm run nope in prose.\n', scripts);
+  if (ok.length !== 0 || bad.join() !== 'nope' || unfenced.length !== 0) {
+    console.error('check-agents-md self-test failed', { ok, bad, unfenced });
+    process.exit(1);
+  }
+  console.log('check-agents-md self-test passed');
+}
+
+if (process.argv.includes('--self-test')) selfTest();
+
+const root = resolve(import.meta.dirname, '..');
+const markdown = readFileSync(resolve(root, 'AGENTS.md'), 'utf8');
+if (!markdown.trim()) {
+  console.error('AGENTS.md is empty');
+  process.exit(1);
+}
+const pkg = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8'));
+const missing = missingNpmScripts(markdown, new Set(Object.keys(pkg.scripts ?? {})));
+if (missing.length > 0) {
+  console.error(`AGENTS.md fenced npm commands are not package.json scripts: ${missing.join(', ')}`);
+  process.exit(1);
+}
+console.log('AGENTS.md fenced npm commands match package.json scripts');