@doriandev/devcc 0.1.2

package/dist/devcc/deps/parse.js

@@ -0,0 +1,158 @@
+/** Managers whose `outdated` command can emit machine-readable output. */
+export const JSON_CAPABLE_MANAGERS = ["pnpm", "npm", "yarn"];
+export function supportsOutdatedJson(manager) {
+    return JSON_CAPABLE_MANAGERS.includes(manager);
+}
+/** The argv that produces JSON `outdated` output for each manager. */
+export function outdatedArgs(manager) {
+    switch (manager) {
+        case "pnpm":
+            return ["outdated", "--format", "json"];
+        case "npm":
+            return ["outdated", "--json", "--long"];
+        case "yarn":
+            return ["outdated", "--json"];
+        case "bun":
+            return ["outdated"];
+    }
+}
+/** Strip range operators and build metadata: `^1.2.3-beta.1` -> `[1, 2, 3]`. */
+export function parseVersion(version) {
+    const match = /(\d+)\.(\d+)\.(\d+)/u.exec(version.trim());
+    if (!match)
+        return null;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+/**
+ * Classify the gap between two versions. `unknown` when either side is not a
+ * plain semver triple (git refs, `latest`, workspace protocols).
+ */
+export function severityBetween(current, latest) {
+    const from = parseVersion(current);
+    const to = parseVersion(latest);
+    if (!from || !to)
+        return "unknown";
+    if (to[0] !== from[0])
+        return "major";
+    if (to[1] !== from[1])
+        return "minor";
+    if (to[2] !== from[2])
+        return "patch";
+    return "unknown";
+}
+function normaliseKind(value) {
+    switch (typeof value === "string" ? value.toLowerCase() : "") {
+        case "devdependencies":
+        case "dev":
+            return "devDependencies";
+        case "peerdependencies":
+        case "peer":
+            return "peerDependencies";
+        case "optionaldependencies":
+        case "optional":
+            return "optionalDependencies";
+        default:
+            return "dependencies";
+    }
+}
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function asString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function buildEntry(name, current, wanted, latest, kind, deprecated) {
+    return {
+        name,
+        current,
+        wanted,
+        latest,
+        kind,
+        severity: severityBetween(current, latest),
+        onlyLatest: current === wanted && wanted !== latest,
+        deprecated,
+    };
+}
+/**
+ * pnpm (`--format json`) and npm (`--json`) both emit an object keyed by package
+ * name; only the field names around it differ slightly.
+ */
+export function parseNpmStyleOutdated(json) {
+    const root = asRecord(json);
+    if (!root)
+        return [];
+    const packages = [];
+    for (const [name, raw] of Object.entries(root)) {
+        // npm --json can produce an array when a package is present at several paths.
+        const entry = asRecord(Array.isArray(raw) ? raw[0] : raw);
+        if (!entry)
+            continue;
+        const current = asString(entry.current);
+        const latest = asString(entry.latest);
+        if (!latest)
+            continue;
+        packages.push(buildEntry(name, current ?? "-", asString(entry.wanted) ?? current ?? "-", latest, normaliseKind(entry.dependencyType ?? entry.type), entry.isDeprecated === true));
+    }
+    return packages;
+}
+/** yarn classic emits newline-delimited JSON with a `table` payload. */
+export function parseYarnOutdated(output) {
+    for (const line of output.split("\n")) {
+        if (line.trim() === "")
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const record = asRecord(parsed);
+        if (record?.type !== "table")
+            continue;
+        const body = asRecord(record.data)?.body;
+        if (!Array.isArray(body))
+            continue;
+        return body
+            .filter((row) => Array.isArray(row))
+            .map((row) => {
+            const [name, current, wanted, latest, kind] = row.map((cell) => typeof cell === "string" ? cell : "");
+            return buildEntry(name ?? "", current ?? "-", wanted ?? "-", latest ?? "-", normaliseKind(kind));
+        })
+            .filter((entry) => entry.name !== "");
+    }
+    return [];
+}
+/** Dispatch to the right parser for the manager that produced `output`. */
+export function parseOutdated(manager, output) {
+    const trimmed = output.trim();
+    if (trimmed === "")
+        return [];
+    if (manager === "yarn")
+        return parseYarnOutdated(trimmed);
+    try {
+        return parseNpmStyleOutdated(JSON.parse(trimmed));
+    }
+    catch {
+        return [];
+    }
+}
+const SEVERITY_ORDER = { major: 0, minor: 1, patch: 2, unknown: 3 };
+/** Most-significant updates first, then alphabetically. */
+export function sortOutdated(packages) {
+    return [...packages].sort((a, b) => {
+        const bySeverity = SEVERITY_ORDER[a.severity] - SEVERITY_ORDER[b.severity];
+        return bySeverity !== 0 ? bySeverity : a.name.localeCompare(b.name);
+    });
+}
+export function summariseOutdated(packages) {
+    return {
+        total: packages.length,
+        major: packages.filter((entry) => entry.severity === "major").length,
+        minor: packages.filter((entry) => entry.severity === "minor").length,
+        patch: packages.filter((entry) => entry.severity === "patch").length,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/devcc/deps/parse.js.map

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

package/dist/devcc/git/GitService.d.ts

@@ -0,0 +1,60 @@
+import { TypedEmitter } from "../core/events.js";
+import { DevccError } from "../utils/errors.js";
+import type { ScopedLogger } from "../utils/logger.js";
+import { type GitCommit, type GitStatus } from "./parse.js";
+export interface GitSnapshot {
+    available: boolean;
+    isRepository: boolean;
+    status: GitStatus;
+    commits: GitCommit[];
+    version: string | null;
+    lastRefreshedAt: Date | null;
+    /** Set when the last refresh failed; the previous snapshot is kept. */
+    error: string | null;
+}
+export declare const EMPTY_GIT_SNAPSHOT: GitSnapshot;
+export type GitServiceEvents = {
+    "git:changed": [GitSnapshot];
+    "git:error": [DevccError];
+};
+export interface GitServiceOptions {
+    rootDir: string;
+    logger: ScopedLogger;
+    commitLimit?: number;
+    timeoutMs?: number;
+}
+/**
+ * Thin wrapper around the `git` executable.
+ *
+ * We call git directly rather than adding a git abstraction library: the six
+ * commands the dashboard needs are stable plumbing, and porcelain v2 output is
+ * far easier to keep honest than a dependency's changing object model.
+ */
+export declare class GitService extends TypedEmitter<GitServiceEvents> {
+    private readonly options;
+    private snapshot;
+    private refreshing;
+    private readonly commitLimit;
+    private readonly timeoutMs;
+    constructor(options: GitServiceOptions);
+    getSnapshot(): GitSnapshot;
+    /** Refresh branch/status/commits. Concurrent calls share one run. */
+    refresh(): Promise<GitSnapshot>;
+    private doRefresh;
+    /** `git fetch` is deliberately manual: it touches the network. */
+    fetch(): Promise<void>;
+    pull(): Promise<void>;
+    push(): Promise<void>;
+    stage(paths: readonly string[]): Promise<void>;
+    stageAll(): Promise<void>;
+    unstage(paths: readonly string[]): Promise<void>;
+    /** Destructive: throws away worktree changes. Callers must confirm first. */
+    discard(paths: readonly string[]): Promise<void>;
+    commit(message: string): Promise<void>;
+    /** Read-only diff for the inspect panel. */
+    diff(path: string, staged: boolean): Promise<string>;
+    private mutate;
+    private git;
+    private publish;
+}
+//# sourceMappingURL=GitService.d.ts.map

package/dist/devcc/git/GitService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitService.d.ts","sourceRoot":"","sources":["../../../src/devcc/git/GitService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,OAAO,CAAA;IACrB,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,eAAe,EAAE,IAAI,GAAG,IAAI,CAAA;IAC5B,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,eAAO,MAAM,kBAAkB,EAAE,WAQhC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,EAAE,CAAC,WAAW,CAAC,CAAA;IAC5B,WAAW,EAAE,CAAC,UAAU,CAAC,CAAA;CAC1B,CAAA;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,YAAY,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,YAAY,CAAC,gBAAgB,CAAC;IAMhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEL,OAAO,EAAE,iBAAiB;IAMvD,WAAW,IAAI,WAAW;IAI1B,qEAAqE;IAC/D,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;YAQvB,SAAS;IA6CvB,kEAAkE;IAC5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,6EAA6E;IACvE,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5C,4CAA4C;IACtC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;YAQ5C,MAAM;IAiBpB,OAAO,CAAC,GAAG;IASX,OAAO,CAAC,OAAO;CAKhB"}

package/dist/devcc/git/GitService.js

@@ -0,0 +1,160 @@
+import { TypedEmitter } from "../core/events.js";
+import { DevccError } from "../utils/errors.js";
+import { exec } from "../utils/exec.js";
+import { EMPTY_GIT_STATUS, LOG_FORMAT, parseCommits, parsePorcelainV2, } from "./parse.js";
+export const EMPTY_GIT_SNAPSHOT = {
+    available: false,
+    isRepository: false,
+    status: EMPTY_GIT_STATUS,
+    commits: [],
+    version: null,
+    lastRefreshedAt: null,
+    error: null,
+};
+/**
+ * Thin wrapper around the `git` executable.
+ *
+ * We call git directly rather than adding a git abstraction library: the six
+ * commands the dashboard needs are stable plumbing, and porcelain v2 output is
+ * far easier to keep honest than a dependency's changing object model.
+ */
+export class GitService extends TypedEmitter {
+    options;
+    snapshot = { ...EMPTY_GIT_SNAPSHOT };
+    refreshing = null;
+    commitLimit;
+    timeoutMs;
+    constructor(options) {
+        super();
+        this.options = options;
+        this.commitLimit = options.commitLimit ?? 8;
+        this.timeoutMs = options.timeoutMs ?? 5_000;
+    }
+    getSnapshot() {
+        return this.snapshot;
+    }
+    /** Refresh branch/status/commits. Concurrent calls share one run. */
+    async refresh() {
+        if (this.refreshing)
+            return this.refreshing;
+        this.refreshing = this.doRefresh().finally(() => {
+            this.refreshing = null;
+        });
+        return this.refreshing;
+    }
+    async doRefresh() {
+        const [versionResult, statusResult, logResult] = await Promise.all([
+            this.git(["--version"]),
+            this.git(["status", "--porcelain=v2", "--branch", "--untracked-files=all"]),
+            this.git(["log", `--max-count=${this.commitLimit}`, `--pretty=format:${LOG_FORMAT}`]),
+        ]);
+        const available = versionResult.spawnError === undefined;
+        if (!available) {
+            return this.publish({
+                ...EMPTY_GIT_SNAPSHOT,
+                available: false,
+                lastRefreshedAt: new Date(),
+                error: "git executable not found",
+            });
+        }
+        const version = versionResult.ok ? versionResult.stdout.trim().replace(/^git version /u, "") : null;
+        if (!statusResult.ok) {
+            const notARepo = /not a git repository/iu.test(statusResult.stderr);
+            return this.publish({
+                ...this.snapshot,
+                available: true,
+                isRepository: false,
+                status: EMPTY_GIT_STATUS,
+                commits: [],
+                version,
+                lastRefreshedAt: new Date(),
+                error: notARepo ? null : statusResult.stderr.trim() || "git status failed",
+            });
+        }
+        return this.publish({
+            available: true,
+            isRepository: true,
+            status: parsePorcelainV2(statusResult.stdout),
+            // A fresh repository with no commits fails `git log`; an empty list is correct there.
+            commits: logResult.ok ? parseCommits(logResult.stdout) : [],
+            version,
+            lastRefreshedAt: new Date(),
+            error: null,
+        });
+    }
+    /** `git fetch` is deliberately manual: it touches the network. */
+    async fetch() {
+        await this.mutate(["fetch", "--prune"], "git fetch", 30_000);
+    }
+    async pull() {
+        await this.mutate(["pull", "--ff-only"], "git pull", 60_000);
+    }
+    async push() {
+        await this.mutate(["push"], "git push", 60_000);
+    }
+    async stage(paths) {
+        if (paths.length === 0)
+            return;
+        await this.mutate(["add", "--", ...paths], "git add");
+    }
+    async stageAll() {
+        await this.mutate(["add", "--all"], "git add --all");
+    }
+    async unstage(paths) {
+        if (paths.length === 0)
+            return;
+        await this.mutate(["restore", "--staged", "--", ...paths], "git restore --staged");
+    }
+    /** Destructive: throws away worktree changes. Callers must confirm first. */
+    async discard(paths) {
+        if (paths.length === 0)
+            return;
+        await this.mutate(["restore", "--worktree", "--", ...paths], "git restore");
+    }
+    async commit(message) {
+        const trimmed = message.trim();
+        if (trimmed === "") {
+            throw new DevccError({ scope: "git", message: "Commit message is empty" });
+        }
+        await this.mutate(["commit", "--message", trimmed], "git commit");
+    }
+    /** Read-only diff for the inspect panel. */
+    async diff(path, staged) {
+        const args = ["--no-pager", "diff", "--no-color"];
+        if (staged)
+            args.push("--staged");
+        args.push("--", path);
+        const result = await this.git(args, 10_000);
+        return result.ok ? result.stdout : result.stderr;
+    }
+    async mutate(args, label, timeoutMs) {
+        const result = await this.git(args, timeoutMs);
+        if (!result.ok) {
+            const detail = [result.stdout, result.stderr].filter(Boolean).join("\n").trim();
+            this.options.logger.warn(`${label} failed`, { code: result.code, detail });
+            const error = new DevccError({
+                scope: "git",
+                message: `${label} failed`,
+                detail: detail || (result.timedOut ? "timed out" : undefined),
+            });
+            this.emit("git:error", error);
+            throw error;
+        }
+        this.options.logger.info(`${label} ok`);
+        await this.refresh();
+    }
+    git(args, timeoutMs) {
+        return exec("git", args, {
+            cwd: this.options.rootDir,
+            timeoutMs: timeoutMs ?? this.timeoutMs,
+            // Never let git open an editor or a credential prompt under the TUI.
+            env: { ...process.env, GIT_TERMINAL_PROMPT: "0", GIT_OPTIONAL_LOCKS: "0", GIT_EDITOR: "true" },
+        });
+    }
+    publish(snapshot) {
+        this.snapshot = snapshot;
+        this.emit("git:changed", snapshot);
+        return snapshot;
+    }
+}
+//# sourceMappingURL=GitService.js.map

package/dist/devcc/git/GitService.js.map

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

package/dist/devcc/git/parse.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Pure parsers for git plumbing output.
+ *
+ * Kept separate from `GitService` so they can be unit tested without a repo,
+ * and so the shape of the data the UI consumes is defined in one place.
+ */
+export type GitFileState = "staged" | "modified" | "untracked" | "conflicted";
+export interface GitFile {
+    path: string;
+    state: GitFileState;
+    /** Two-letter porcelain code, e.g. `M.`, `.M`, `A.`, `??`. */
+    code: string;
+    /** Original path for renames. */
+    origPath?: string;
+}
+export interface GitStatus {
+    branch: string | null;
+    upstream: string | null;
+    ahead: number;
+    behind: number;
+    /** Short commit hash of HEAD, when known. */
+    head: string | null;
+    files: GitFile[];
+    clean: boolean;
+}
+export interface GitCommit {
+    hash: string;
+    shortHash: string;
+    author: string;
+    relativeDate: string;
+    subject: string;
+}
+export declare const EMPTY_GIT_STATUS: GitStatus;
+/**
+ * Parse `git status --porcelain=v2 --branch --untracked-files=all`.
+ *
+ * Format reference: `man git-status`, "Porcelain Format Version 2".
+ */
+export declare function parsePorcelainV2(output: string): GitStatus;
+/** ASCII unit separator (0x1F), used as the field separator in our git log format. */
+export declare const LOG_SEPARATOR: string;
+/** Format string matching {@link parseCommits}. */
+export declare const LOG_FORMAT: string;
+/** Parse `git log --pretty=format:<LOG_FORMAT>`. */
+export declare function parseCommits(output: string): GitCommit[];
+export interface GitCounts {
+    staged: number;
+    modified: number;
+    untracked: number;
+    conflicted: number;
+}
+export declare function countByState(files: readonly GitFile[]): GitCounts;
+/** Short summary such as `3 staged / 2 modified / 1 untracked`, or `clean`. */
+export declare function summariseStatus(status: GitStatus): string;
+/** `ahead 2, behind 1`, or `up to date` / `no upstream`. */
+export declare function summariseTracking(status: GitStatus): string;
+//# sourceMappingURL=parse.d.ts.map

package/dist/devcc/git/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/devcc/git/parse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,CAAA;AAE7E,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,YAAY,CAAA;IACnB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,eAAO,MAAM,gBAAgB,EAAE,SAQ9B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAiE1D;AA4BD,sFAAsF;AACtF,eAAO,MAAM,aAAa,QAA0B,CAAA;AAEpD,mDAAmD;AACnD,eAAO,MAAM,UAAU,QAAuD,CAAA;AAE9E,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAexD;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAIjE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CASzD;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAO3D"}

package/dist/devcc/git/parse.js

@@ -0,0 +1,174 @@
+/**
+ * Pure parsers for git plumbing output.
+ *
+ * Kept separate from `GitService` so they can be unit tested without a repo,
+ * and so the shape of the data the UI consumes is defined in one place.
+ */
+export const EMPTY_GIT_STATUS = {
+    branch: null,
+    upstream: null,
+    ahead: 0,
+    behind: 0,
+    head: null,
+    files: [],
+    clean: true,
+};
+/**
+ * Parse `git status --porcelain=v2 --branch --untracked-files=all`.
+ *
+ * Format reference: `man git-status`, "Porcelain Format Version 2".
+ */
+export function parsePorcelainV2(output) {
+    const status = { ...EMPTY_GIT_STATUS, files: [] };
+    for (const rawLine of output.split("\n")) {
+        const line = rawLine.replace(/\r$/u, "");
+        if (line.length === 0)
+            continue;
+        if (line.startsWith("# branch.head ")) {
+            const value = line.slice("# branch.head ".length).trim();
+            status.branch = value === "(detached)" ? null : value;
+            continue;
+        }
+        if (line.startsWith("# branch.oid ")) {
+            const value = line.slice("# branch.oid ".length).trim();
+            status.head = value === "(initial)" ? null : value.slice(0, 7);
+            continue;
+        }
+        if (line.startsWith("# branch.upstream ")) {
+            status.upstream = line.slice("# branch.upstream ".length).trim();
+            continue;
+        }
+        if (line.startsWith("# branch.ab ")) {
+            for (const part of line.slice("# branch.ab ".length).trim().split(" ")) {
+                const value = Number.parseInt(part.slice(1), 10);
+                if (Number.isNaN(value))
+                    continue;
+                if (part.startsWith("+"))
+                    status.ahead = value;
+                else if (part.startsWith("-"))
+                    status.behind = value;
+            }
+            continue;
+        }
+        if (line.startsWith("# "))
+            continue;
+        const kind = line[0];
+        if (kind === "1") {
+            // 1 <XY> <sub> <mH> <mI> <mW> <hH> <hI> <path>
+            const fields = splitFields(line, 8);
+            const code = fields[1] ?? "..";
+            const path = fields[8] ?? "";
+            if (path)
+                status.files.push({ path, code, state: stateFromCode(code) });
+            continue;
+        }
+        if (kind === "2") {
+            // 2 <XY> <sub> <mH> <mI> <mW> <hH> <hI> <X><score> <path><TAB><origPath>
+            const fields = splitFields(line, 9);
+            const code = fields[1] ?? "..";
+            const rest = fields[9] ?? "";
+            const [path = "", origPath] = rest.split("\t");
+            if (path)
+                status.files.push({ path, code, state: stateFromCode(code), origPath });
+            continue;
+        }
+        if (kind === "u") {
+            const fields = splitFields(line, 10);
+            const path = fields[10] ?? "";
+            if (path)
+                status.files.push({ path, code: fields[1] ?? "UU", state: "conflicted" });
+            continue;
+        }
+        if (kind === "?") {
+            const path = line.slice(2);
+            if (path)
+                status.files.push({ path, code: "??", state: "untracked" });
+            continue;
+        }
+    }
+    status.clean = status.files.length === 0;
+    return status;
+}
+/**
+ * Porcelain v2 codes are `XY` where X is the staged change and Y the worktree
+ * change; `.` means "unchanged".
+ */
+function stateFromCode(code) {
+    const staged = code[0] ?? ".";
+    return staged !== "." && staged !== "?" ? "staged" : "modified";
+}
+/** Split a porcelain line into `count` space-separated fields plus the remainder. */
+function splitFields(line, count) {
+    const fields = [];
+    let index = 0;
+    for (let i = 0; i < count; i += 1) {
+        const next = line.indexOf(" ", index);
+        if (next === -1) {
+            fields.push(line.slice(index));
+            return fields;
+        }
+        fields.push(line.slice(index, next));
+        index = next + 1;
+    }
+    fields.push(line.slice(index));
+    return fields;
+}
+/** ASCII unit separator (0x1F), used as the field separator in our git log format. */
+export const LOG_SEPARATOR = String.fromCharCode(31);
+/** Format string matching {@link parseCommits}. */
+export const LOG_FORMAT = ["%H", "%h", "%an", "%ar", "%s"].join(LOG_SEPARATOR);
+/** Parse `git log --pretty=format:<LOG_FORMAT>`. */
+export function parseCommits(output) {
+    const commits = [];
+    for (const line of output.split("\n")) {
+        if (line.trim() === "")
+            continue;
+        const [hash, shortHash, author, relativeDate, ...subject] = line.split(LOG_SEPARATOR);
+        if (!hash || !shortHash)
+            continue;
+        commits.push({
+            hash,
+            shortHash,
+            author: author ?? "",
+            relativeDate: relativeDate ?? "",
+            subject: subject.join(LOG_SEPARATOR),
+        });
+    }
+    return commits;
+}
+export function countByState(files) {
+    const counts = { staged: 0, modified: 0, untracked: 0, conflicted: 0 };
+    for (const file of files)
+        counts[file.state] += 1;
+    return counts;
+}
+/** Short summary such as `3 staged / 2 modified / 1 untracked`, or `clean`. */
+export function summariseStatus(status) {
+    if (status.clean)
+        return "clean";
+    const counts = countByState(status.files);
+    const parts = [];
+    if (counts.staged)
+        parts.push(`${counts.staged} staged`);
+    if (counts.modified)
+        parts.push(`${counts.modified} modified`);
+    if (counts.untracked)
+        parts.push(`${counts.untracked} untracked`);
+    if (counts.conflicted)
+        parts.push(`${counts.conflicted} conflicted`);
+    return parts.join(" / ");
+}
+/** `ahead 2, behind 1`, or `up to date` / `no upstream`. */
+export function summariseTracking(status) {
+    if (!status.upstream)
+        return "no upstream";
+    if (status.ahead === 0 && status.behind === 0)
+        return "up to date";
+    const parts = [];
+    if (status.ahead)
+        parts.push(`ahead ${status.ahead}`);
+    if (status.behind)
+        parts.push(`behind ${status.behind}`);
+    return parts.join(", ");
+}
+//# sourceMappingURL=parse.js.map

package/dist/devcc/git/parse.js.map

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