@doriandev/devcc 0.1.2

package/dist/devcc/utils/format.js

@@ -0,0 +1,85 @@
+/** Formatting helpers shared by the views. Pure functions, easy to test. */
+export function formatBytes(bytes, fractionDigits = 1) {
+    if (!Number.isFinite(bytes) || bytes < 0)
+        return "-";
+    const units = ["B", "KB", "MB", "GB", "TB", "PB"];
+    let value = bytes;
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    const digits = unit === 0 ? 0 : fractionDigits;
+    return `${value.toFixed(digits)} ${units[unit]}`;
+}
+/** Bytes rendered in GB without a unit suffix, for `7.2 / 36 GB` style pairs. */
+export function toGigabytes(bytes, fractionDigits = 1) {
+    return (bytes / 1024 ** 3).toFixed(fractionDigits);
+}
+export function formatPercent(ratio, fractionDigits = 0) {
+    if (!Number.isFinite(ratio))
+        return "-";
+    return `${(ratio * 100).toFixed(fractionDigits)}%`;
+}
+/** Compact duration: `4s`, `2m 10s`, `1h 04m`, `3d 02h`. */
+export function formatDuration(ms) {
+    if (!Number.isFinite(ms) || ms < 0)
+        return "-";
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ${String(seconds % 60).padStart(2, "0")}s`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ${String(minutes % 60).padStart(2, "0")}m`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ${String(hours % 24).padStart(2, "0")}h`;
+}
+export function formatClock(date) {
+    return `${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+}
+export function formatTimestamp(date) {
+    return (`${String(date.getHours()).padStart(2, "0")}:` +
+        `${String(date.getMinutes()).padStart(2, "0")}:` +
+        `${String(date.getSeconds()).padStart(2, "0")}.` +
+        `${String(date.getMilliseconds()).padStart(3, "0")}`);
+}
+/** Pad or truncate to an exact display width. */
+export function fit(text, width) {
+    if (width <= 0)
+        return "";
+    if (text.length === width)
+        return text;
+    if (text.length < width)
+        return text.padEnd(width, " ");
+    if (width === 1)
+        return "…";
+    return `${text.slice(0, width - 1)}…`;
+}
+export function truncate(text, maxLength) {
+    if (maxLength <= 0)
+        return "";
+    if (text.length <= maxLength)
+        return text;
+    if (maxLength === 1)
+        return "…";
+    return `${text.slice(0, maxLength - 1)}…`;
+}
+/** Single-line preview of a possibly multi-line string. */
+export function singleLine(text, maxLength = 120) {
+    return truncate(text.replace(/\s+/gu, " ").trim(), maxLength);
+}
+/** A small horizontal meter, e.g. `████░░░░░░`. */
+export function meter(ratio, width = 10, filledChar = "█", emptyChar = "░") {
+    if (width <= 0)
+        return "";
+    const clamped = Math.max(0, Math.min(1, Number.isFinite(ratio) ? ratio : 0));
+    const filled = Math.round(clamped * width);
+    return filledChar.repeat(filled) + emptyChar.repeat(width - filled);
+}
+export function pluralise(count, singular, plural = `${singular}s`) {
+    return `${count} ${count === 1 ? singular : plural}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/devcc/utils/format.js.map

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

package/dist/devcc/utils/fuzzy.d.ts

@@ -0,0 +1,12 @@
+export interface FuzzyMatch<T> {
+    item: T;
+    score: number;
+    /** Indices of matched characters in the haystack, for highlighting. */
+    positions: number[];
+}
+/**
+ * Thin wrapper over the `fzf` package so the command palette and the script
+ * list share one ranking implementation (and one place to tune it).
+ */
+export declare function fuzzyFilter<T>(items: readonly T[], query: string, selector: (item: T) => string, limit?: number): FuzzyMatch<T>[];
+//# sourceMappingURL=fuzzy.d.ts.map

package/dist/devcc/utils/fuzzy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy.d.ts","sourceRoot":"","sources":["../../../src/devcc/utils/fuzzy.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAA;IACP,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAcD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC7B,KAAK,SAAK,GACT,UAAU,CAAC,CAAC,CAAC,EAAE,CAajB"}

package/dist/devcc/utils/fuzzy.js

@@ -0,0 +1,20 @@
+import { Fzf } from "fzf";
+const TypedFzf = Fzf;
+/**
+ * Thin wrapper over the `fzf` package so the command palette and the script
+ * list share one ranking implementation (and one place to tune it).
+ */
+export function fuzzyFilter(items, query, selector, limit = 50) {
+    if (items.length === 0)
+        return [];
+    if (query.trim() === "") {
+        return items.slice(0, limit).map((item) => ({ item, score: 0, positions: [] }));
+    }
+    const finder = new TypedFzf(items, { selector, limit });
+    return finder.find(query).map((entry) => ({
+        item: entry.item,
+        score: entry.score,
+        positions: [...entry.positions].sort((a, b) => a - b),
+    }));
+}
+//# sourceMappingURL=fuzzy.js.map

package/dist/devcc/utils/fuzzy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy.js","sourceRoot":"","sources":["../../../src/devcc/utils/fuzzy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAsB,MAAM,KAAK,CAAA;AAmB7C,MAAM,QAAQ,GAAG,GAAgC,CAAA;AAEjD;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,KAAmB,EACnB,KAAa,EACb,QAA6B,EAC7B,KAAK,GAAG,EAAE;IAEV,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEjC,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;IACjF,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAI,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;KACtD,CAAC,CAAC,CAAA;AACL,CAAC"}

package/dist/devcc/utils/logger.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Internal diagnostics logger.
+ *
+ * Writes to `.devcc/devcc.log` inside the project. Never writes to stdout/stderr
+ * while the TUI owns the terminal - that would corrupt the rendered frame.
+ */
+export declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error", "silent"];
+export type LogLevel = (typeof LOG_LEVELS)[number];
+export declare function isLogLevel(value: string): value is LogLevel;
+export interface LoggerOptions {
+    level?: LogLevel;
+    filePath?: string | null;
+    /** Extra sink, used by tests and by the in-app diagnostics panel. */
+    sink?: (line: string, level: LogLevel) => void;
+}
+export declare class Logger {
+    private level;
+    private filePath;
+    private sink;
+    private failed;
+    constructor(options?: LoggerOptions);
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+    getFilePath(): string | null;
+    child(namespace: string): ScopedLogger;
+    enabled(level: LogLevel): boolean;
+    log(level: LogLevel, namespace: string, message: string, data?: unknown): void;
+}
+export declare class ScopedLogger {
+    private readonly logger;
+    private readonly namespace;
+    constructor(logger: Logger, namespace: string);
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, data?: unknown): void;
+    child(namespace: string): ScopedLogger;
+}
+export declare function defaultLogFilePath(rootDir: string): string;
+export declare function createLogger(rootDir: string, level?: LogLevel): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/devcc/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/devcc/utils/logger.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,eAAO,MAAM,UAAU,uDAAwD,CAAA;AAC/E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAUlD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,qEAAqE;IACrE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;CAC/C;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,IAAI,CAAuD;IACnE,OAAO,CAAC,MAAM,CAAQ;gBAEV,OAAO,GAAE,aAAkB;IAMvC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,QAAQ,IAAI,QAAQ;IAIpB,WAAW,IAAI,MAAM,GAAG,IAAI;IAI5B,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAItC,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAIjC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;CAkB/E;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM;IAGpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;CAGvC;AAsBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAItE"}

package/dist/devcc/utils/logger.js

@@ -0,0 +1,117 @@
+import { appendFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * Internal diagnostics logger.
+ *
+ * Writes to `.devcc/devcc.log` inside the project. Never writes to stdout/stderr
+ * while the TUI owns the terminal - that would corrupt the rendered frame.
+ */
+export const LOG_LEVELS = ["debug", "info", "warn", "error", "silent"];
+const LEVEL_WEIGHT = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+    silent: 100,
+};
+export function isLogLevel(value) {
+    return LOG_LEVELS.includes(value);
+}
+export class Logger {
+    level;
+    filePath;
+    sink;
+    failed = false;
+    constructor(options = {}) {
+        this.level = options.level ?? "info";
+        this.filePath = options.filePath ?? null;
+        this.sink = options.sink;
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    getLevel() {
+        return this.level;
+    }
+    getFilePath() {
+        return this.filePath;
+    }
+    child(namespace) {
+        return new ScopedLogger(this, namespace);
+    }
+    enabled(level) {
+        return LEVEL_WEIGHT[level] >= LEVEL_WEIGHT[this.level];
+    }
+    log(level, namespace, message, data) {
+        if (!this.enabled(level) || level === "silent")
+            return;
+        const stamp = new Date().toISOString();
+        const suffix = data === undefined ? "" : ` ${safeSerialise(data)}`;
+        const line = `${stamp} ${level.toUpperCase().padEnd(5)} [${namespace}] ${message}${suffix}`;
+        this.sink?.(line, level);
+        if (!this.filePath || this.failed)
+            return;
+        try {
+            ensureLogDirectory(dirname(this.filePath));
+            appendFileSync(this.filePath, `${line}\n`, "utf8");
+        }
+        catch {
+            // Never let logging take the app down; disable the file sink instead.
+            this.failed = true;
+        }
+    }
+}
+export class ScopedLogger {
+    logger;
+    namespace;
+    constructor(logger, namespace) {
+        this.logger = logger;
+        this.namespace = namespace;
+    }
+    debug(message, data) {
+        this.logger.log("debug", this.namespace, message, data);
+    }
+    info(message, data) {
+        this.logger.log("info", this.namespace, message, data);
+    }
+    warn(message, data) {
+        this.logger.log("warn", this.namespace, message, data);
+    }
+    error(message, data) {
+        this.logger.log("error", this.namespace, message, data);
+    }
+    child(namespace) {
+        return this.logger.child(`${this.namespace}:${namespace}`);
+    }
+}
+/**
+ * Create `.devcc/` and self-ignore it, so devcc's own diagnostics never show up
+ * as untracked changes in the user's repository.
+ */
+function ensureLogDirectory(directory) {
+    mkdirSync(directory, { recursive: true });
+    const ignorePath = join(directory, ".gitignore");
+    if (!existsSync(ignorePath))
+        writeFileSync(ignorePath, "*\n", "utf8");
+}
+function safeSerialise(data) {
+    if (data instanceof Error)
+        return `${data.name}: ${data.message}`;
+    if (typeof data === "string")
+        return data;
+    try {
+        return JSON.stringify(data);
+    }
+    catch {
+        return String(data);
+    }
+}
+export function defaultLogFilePath(rootDir) {
+    return join(rootDir, ".devcc", "devcc.log");
+}
+export function createLogger(rootDir, level) {
+    const envLevel = process.env.DEVCC_LOG_LEVEL;
+    const resolved = level ?? (envLevel && isLogLevel(envLevel) ? envLevel : "info");
+    return new Logger({ level: resolved, filePath: defaultLogFilePath(rootDir) });
+}
+//# sourceMappingURL=logger.js.map

package/dist/devcc/utils/logger.js.map

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

package/dist/devcc/utils/packageManager.d.ts

@@ -0,0 +1,39 @@
+export declare const PACKAGE_MANAGERS: readonly ["pnpm", "yarn", "npm", "bun"];
+export type PackageManager = (typeof PACKAGE_MANAGERS)[number];
+export interface PackageManagerDetection {
+    manager: PackageManager;
+    /** How the decision was made - surfaced in the Settings view. */
+    source: "packageManager-field" | "lockfile" | "user-agent" | "default";
+    /** The lockfile that decided it, when applicable. */
+    evidence?: string;
+}
+/**
+ * Parse the `packageManager` field of a package.json (corepack format,
+ * e.g. `pnpm@10.26.2+sha512...`).
+ */
+export declare function parsePackageManagerField(value: unknown): PackageManager | null;
+/** Parse the `npm_config_user_agent` env var, e.g. `pnpm/10.26.2 npm/? node/v24`. */
+export declare function parseUserAgent(userAgent: string | undefined): PackageManager | null;
+export interface DetectPackageManagerInput {
+    rootDir: string;
+    packageJson?: Record<string, unknown> | null;
+    userAgent?: string | undefined;
+    /** Injected for tests. */
+    fileExists?: (path: string) => boolean;
+}
+/**
+ * Detect the package manager, preferring explicit declarations over guesses:
+ * `packageManager` field -> lockfile -> the manager that launched us -> npm.
+ */
+export declare function detectPackageManager(input: DetectPackageManagerInput): PackageManagerDetection;
+/** The argv needed to run a package.json script with the given manager. */
+export declare function runScriptArgs(manager: PackageManager, script: string): string[];
+/** Read and parse package.json, returning `null` when absent or invalid. */
+export declare function readPackageJson(rootDir: string): Record<string, unknown> | null;
+export interface PackageScript {
+    name: string;
+    command: string;
+}
+/** Extract `scripts` from a parsed package.json as a stable, sorted-by-declaration list. */
+export declare function readScripts(packageJson: Record<string, unknown> | null): PackageScript[];
+//# sourceMappingURL=packageManager.d.ts.map

package/dist/devcc/utils/packageManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageManager.d.ts","sourceRoot":"","sources":["../../../src/devcc/utils/packageManager.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,yCAA0C,CAAA;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,cAAc,CAAA;IACvB,iEAAiE;IACjE,MAAM,EAAE,sBAAsB,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAA;IACtE,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAeD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAI9E;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAInF;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,0BAA0B;IAC1B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CACvC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,uBAAuB,CAgB9F;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAU/E;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAS/E;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,aAAa,EAAE,CAMxF"}

package/dist/devcc/utils/packageManager.js

@@ -0,0 +1,85 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+export const PACKAGE_MANAGERS = ["pnpm", "yarn", "npm", "bun"];
+const LOCKFILES = [
+    { file: "pnpm-lock.yaml", manager: "pnpm" },
+    { file: "bun.lock", manager: "bun" },
+    { file: "bun.lockb", manager: "bun" },
+    { file: "yarn.lock", manager: "yarn" },
+    { file: "package-lock.json", manager: "npm" },
+    { file: "npm-shrinkwrap.json", manager: "npm" },
+];
+function isPackageManager(value) {
+    return PACKAGE_MANAGERS.includes(value);
+}
+/**
+ * Parse the `packageManager` field of a package.json (corepack format,
+ * e.g. `pnpm@10.26.2+sha512...`).
+ */
+export function parsePackageManagerField(value) {
+    if (typeof value !== "string")
+        return null;
+    const name = value.split("@")[0]?.trim().toLowerCase();
+    return name && isPackageManager(name) ? name : null;
+}
+/** Parse the `npm_config_user_agent` env var, e.g. `pnpm/10.26.2 npm/? node/v24`. */
+export function parseUserAgent(userAgent) {
+    if (!userAgent)
+        return null;
+    const name = userAgent.split("/")[0]?.trim().toLowerCase();
+    return name && isPackageManager(name) ? name : null;
+}
+/**
+ * Detect the package manager, preferring explicit declarations over guesses:
+ * `packageManager` field -> lockfile -> the manager that launched us -> npm.
+ */
+export function detectPackageManager(input) {
+    const fileExists = input.fileExists ?? existsSync;
+    const declared = parsePackageManagerField(input.packageJson?.packageManager);
+    if (declared)
+        return { manager: declared, source: "packageManager-field" };
+    for (const { file, manager } of LOCKFILES) {
+        if (fileExists(join(input.rootDir, file))) {
+            return { manager, source: "lockfile", evidence: file };
+        }
+    }
+    const fromAgent = parseUserAgent(input.userAgent);
+    if (fromAgent)
+        return { manager: fromAgent, source: "user-agent" };
+    return { manager: "npm", source: "default" };
+}
+/** The argv needed to run a package.json script with the given manager. */
+export function runScriptArgs(manager, script) {
+    switch (manager) {
+        case "npm":
+            return ["run", script];
+        case "yarn":
+            return [script];
+        case "pnpm":
+        case "bun":
+            return ["run", script];
+    }
+}
+/** Read and parse package.json, returning `null` when absent or invalid. */
+export function readPackageJson(rootDir) {
+    const path = join(rootDir, "package.json");
+    try {
+        if (!existsSync(path))
+            return null;
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        return typeof parsed === "object" && parsed !== null ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Extract `scripts` from a parsed package.json as a stable, sorted-by-declaration list. */
+export function readScripts(packageJson) {
+    const scripts = packageJson?.scripts;
+    if (typeof scripts !== "object" || scripts === null)
+        return [];
+    return Object.entries(scripts)
+        .filter((entry) => typeof entry[1] === "string")
+        .map(([name, command]) => ({ name, command }));
+}
+//# sourceMappingURL=packageManager.js.map

package/dist/devcc/utils/packageManager.js.map

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

package/dist/devcc/utils/paths.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Walk upwards from `startDir` looking for a project root marker.
+ * Falls back to `startDir` so the app always has somewhere to run.
+ */
+export declare function findProjectRoot(startDir?: string): string;
+/** Directory holding devcc's own runtime artefacts (logs, future state). */
+export declare function devccDir(rootDir: string): string;
+/** Replace the home directory with `~` for compact display. */
+export declare function tildify(path: string, home?: string): string;
+/** Truncate a path from the left so the most specific segments stay visible. */
+export declare function truncatePath(path: string, maxLength: number): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/devcc/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/devcc/utils/paths.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAWxE;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAyB,GAAG,MAAM,CAG3E;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIpE"}

package/dist/devcc/utils/paths.js

@@ -0,0 +1,39 @@
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+const PROJECT_MARKERS = ["package.json", ".git", "pnpm-workspace.yaml", "deno.json", "Cargo.toml"];
+/**
+ * Walk upwards from `startDir` looking for a project root marker.
+ * Falls back to `startDir` so the app always has somewhere to run.
+ */
+export function findProjectRoot(startDir = process.cwd()) {
+    let current = resolve(startDir);
+    for (;;) {
+        for (const marker of PROJECT_MARKERS) {
+            if (existsSync(join(current, marker)))
+                return current;
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return resolve(startDir);
+        current = parent;
+    }
+}
+/** Directory holding devcc's own runtime artefacts (logs, future state). */
+export function devccDir(rootDir) {
+    return join(rootDir, ".devcc");
+}
+/** Replace the home directory with `~` for compact display. */
+export function tildify(path, home = process.env.HOME ?? "") {
+    if (home && path.startsWith(home))
+        return `~${path.slice(home.length)}`;
+    return path;
+}
+/** Truncate a path from the left so the most specific segments stay visible. */
+export function truncatePath(path, maxLength) {
+    if (path.length <= maxLength)
+        return path;
+    if (maxLength <= 1)
+        return path.slice(-maxLength);
+    return `…${path.slice(-(maxLength - 1))}`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/devcc/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/devcc/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAElD,MAAM,eAAe,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,qBAAqB,EAAE,WAAW,EAAE,YAAY,CAAU,CAAA;AAE3G;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC9D,IAAI,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE/B,SAAS,CAAC;QACR,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;YACrC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAAE,OAAO,OAAO,CAAA;QACvD,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;QAC/B,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAA;QAChD,OAAO,GAAG,MAAM,CAAA;IAClB,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;AAChC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;IACjE,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAA;IACvE,OAAO,IAAI,CAAA;AACb,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,SAAiB;IAC1D,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAA;IACzC,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAA;IACjD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;AAC3C,CAAC"}

package/dist/devcc/views/DependenciesView.d.ts

@@ -0,0 +1,34 @@
+import type { KeyEvent } from "@opentui/core";
+import type { KeyHint } from "../components/Footer.js";
+import { type AppState, type ViewId } from "../core/state.js";
+import { View, type ViewDeps } from "./View.js";
+/**
+ * Rows rendered above the package list (summary + spacer).
+ *
+ * Fixed so the view and the palette command agree on what
+ * `ui.selection.dependencies` points at.
+ */
+export declare const DEPENDENCY_HEADER_ROWS = 2;
+/** Map a selection index to an index into the package list. */
+export declare function selectedPackageIndex(selection: number): number;
+/**
+ * Outdated dependencies, grouped by how big the jump is.
+ *
+ * This is the only panel that never refreshes on a timer: it queries the
+ * registry over the network, so it runs when you ask it to (`r`) and not before.
+ */
+export declare class DependenciesView extends View {
+    readonly id: ViewId;
+    readonly title = "Dependencies";
+    private readonly list;
+    private packages;
+    constructor(deps: ViewDeps);
+    update(state: AppState): void;
+    handleKey(key: KeyEvent, state: AppState): boolean;
+    hints(): KeyHint[];
+    onActivate(state: AppState): void;
+    private firstPackageRow;
+    private summaryRow;
+    private updateSelected;
+}
+//# sourceMappingURL=DependenciesView.d.ts.map

package/dist/devcc/views/DependenciesView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependenciesView.d.ts","sourceRoot":"","sources":["../../../src/devcc/views/DependenciesView.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAGtD,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAI3E,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAA;AAEvC,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,IAAI;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAiB;IACpC,QAAQ,CAAC,KAAK,kBAAiB;IAE/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAwB;gBAE5B,IAAI,EAAE,QAAQ;IAM1B,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IA6DpB,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO;IA6BlD,KAAK,IAAI,OAAO,EAAE;IASlB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAO1C,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,UAAU;YAiBJ,cAAc;CAK7B"}