0.15.0: a splash of colour b55e0d00545e

// How an operation of the op log reads: a friendlier label, its kind, and

// the codicon and colour the Operations view gives it (see style.ts).

export interface OperationLook {

  /** What happened, in words: a commit's subject, "Pushed to earth". */

  label: string;

  /** The kind, shown beside it: "commit", "push". */

  kind: string;

  icon: string;

  color: string;

}

/** The first line of a quoted `-m` message in an operation's command. */

function message(command: string): string | undefined {

  const m = /-m\s+"((?:[^"\\]|\\.)*)"/.exec(command);

  if (!m) return undefined;

  const text = m[1].replace(/\\n/g, "\n").replace(/\\"/g, '"').replace(/\\\\/g, "\\");

  return text.split("\n")[0].trim() || undefined;

}

/** How an operation of the op log looks, from its command. */

export function operationLook(command: string, snapshot: boolean): OperationLook {

  const cmd = command.replace(/^oxy\s+/, "").replace(/\s*\((?:snapshot|merged with a concurrent operation)\)\s*/g, " ").trim();

  const words = cmd.split(/\s+/);

  const [verb, sub] = words;

  const arg = (i: number) => (words[i] ?? "").replace(/^"|"$/g, "");

  if (snapshot) {

    return { label: `Snapshot for ${verb}`, kind: "snapshot", icon: "circle-small", color: "descriptionForeground" };

  }

  switch (verb) {

    case "commit":

      return { label: message(cmd) ?? "Committed", kind: "commit", icon: "git-commit", color: "oxygen.commit" };

    case "amend":

    case "split":

    case "squash":

    case "describe":

      return { label: message(cmd) ?? `${verb[0].toUpperCase()}${verb.slice(1)}ed`, kind: verb, icon: "edit", color: "oxygen.commit" };

    case "push":

      return { label: sub ? `Pushed to ${sub}` : "Pushed", kind: "push", icon: "cloud-upload", color: "oxygen.push" };

    case "pull":

      return { label: sub ? `Pulled from ${sub}` : "Pulled", kind: "pull", icon: "cloud-download", color: "oxygen.pull" };

    case "fetch":

      return { label: sub ? `Fetched ${sub}` : "Fetched", kind: "fetch", icon: "sync", color: "oxygen.pull" };

    case "clone":

    case "init":

      return { label: verb === "init" ? "Repository created" : "Cloned", kind: verb, icon: "repo-clone", color: "oxygen.pull" };

    case "merge":

      return { label: sub ? `Merged ${sub}` : "Merged", kind: "merge", icon: "git-merge", color: "oxygen.merge" };

    case "rebase":

    case "resolve":

      return { label: message(cmd) ?? `${verb[0].toUpperCase()}${verb.slice(1)}d`, kind: verb, icon: "git-pull-request", color: "oxygen.merge" };

    case "checkout":

      return { label: "Checked out", kind: "checkout", icon: "arrow-swap", color: "oxygen.switch" };

    case "bookmark":

    case "tag": {

      const name = arg(2);

      if (sub === "switch") return { label: `Switched to ${name}`, kind: "switch", icon: "arrow-swap", color: "oxygen.switch" };

      const done: Record<string, string> = { create: "created", set: "moved", delete: "deleted", move: "moved" };

      return { label: `${verb === "tag" ? "Tag" : "Bookmark"} ${name} ${done[sub] ?? sub}`.trim(), kind: verb, icon: verb === "tag" ? "tag" : "bookmark", color: "oxygen.bookmark" };

    }

    case "undo":

    case "discard":

    case "abandon":

    case "restore":

      return { label: `${verb[0].toUpperCase()}${verb.slice(1)}`, kind: verb, icon: "discard", color: "oxygen.undo" };

    case "seal":

    case "sign":

    case "policy":

      return { label: cmd, kind: verb, icon: "shield", color: "oxygen.key" };

    case "submodule":

      return { label: `Subrepos ${sub ?? ""}`.trim(), kind: "subrepo", icon: "repo", color: "oxygen.subrepo" };

    default:

      return { label: cmd, kind: verb ?? "", icon: "circle-outline", color: "descriptionForeground" };

  }

}

// A splash of colour: icons tinted with the Oxygen palette (the colours

// package.json contributes, so themes can override them).

import * as vscode from "vscode";

/** A codicon, tinted with a contributed or theme colour. */

export function icon(id: string, color?: string): vscode.ThemeIcon {

  return new vscode.ThemeIcon(id, color ? new vscode.ThemeColor(color) : undefined);

}

export { operationLook, type OperationLook } from "./looks";

import { test } from "node:test";

import assert from "node:assert/strict";

import { operationLook } from "../out/looks.mjs";

test("operations read as what happened, with a kind and a colour", () => {

  const commit = operationLook('oxy commit -m "Backlog: rebase into the working copy overnight\\n\\nrefs #42"', false);

  assert.deepEqual(commit, { label: "Backlog: rebase into the working copy overnight", kind: "commit", icon: "git-commit", color: "oxygen.commit" });

  assert.equal(operationLook("oxy push earth", false).label, "Pushed to earth");

  assert.equal(operationLook("oxy push earth", false).color, "oxygen.push");

  assert.equal(operationLook("oxy pull origin", false).label, "Pulled from origin");

  assert.equal(operationLook("oxy bookmark switch feature/16-hud", false).label, "Switched to feature/16-hud");

  assert.equal(operationLook("oxy bookmark create logo-25", false).label, "Bookmark logo-25 created");

  assert.equal(operationLook("oxy merge develop", false).icon, "git-merge");

  assert.equal(operationLook("oxy undo", false).color, "oxygen.undo");

  assert.equal(operationLook("oxy status (snapshot)", true).kind, "snapshot");

  assert.equal(operationLook('oxy commit -m "say \\"hi\\""', false).label, 'say "hi"');

  // Anything else keeps its command, without the leading oxy.

  assert.equal(operationLook("oxy gc", false).label, "gc");

});

## 0.15.0 (2026-09-30)

- **A splash of colour everywhere.** The Operations view reads as what happened: a commit shows its message, a push "Pushed to earth", a switch "Switched to feature/16-hud", each with its kind and time beside it and an icon in its own colour: green commits, blue pushes, teal pulls, violet merges, gold bookmarks, amber undos. The current operation wears the Oxygen accent, and the tooltip keeps the exact command.

- **Bisect and Trust in colour.** Passing and verified lines are green, bad and invalid red, keys and roots gold, the policy shield violet, warnings amber, with a few emoji flourishes.

- **The status bar** shows the bookmark with an icon, in the Oxygen accent when the working copy is clean and amber when it holds uncommitted work; ahead and behind counts are coloured for push and pull.

- New themeable colours: `oxygen.accent`, `oxygen.commit`, `oxygen.push`, `oxygen.pull`, `oxygen.merge`, `oxygen.bookmark`, `oxygen.switch`, `oxygen.undo`, `oxygen.good`, `oxygen.bad`, `oxygen.warning`, `oxygen.key` and `oxygen.subrepo`.

  "version": "0.15.0",

        "id": "oxygen.accent",

        "description": "The Oxygen accent: the current operation, repositories, the status bar.",

        "defaults": {

          "dark": "#35C7FF",

          "light": "#0A74B8",

          "highContrast": "#35C7FF",

          "highContrastLight": "#0A74B8"

        }

      },

      {

        "id": "oxygen.commit",

        "description": "Commits, amends and splits in the Operations view.",

        "defaults": {

          "dark": "#5FE3A1",

          "light": "#1A7850",

          "highContrast": "#5FE3A1",

          "highContrastLight": "#1A7850"

        }

      },

      {

        "id": "oxygen.push",

        "description": "Pushes.",

        "defaults": {

          "dark": "#3D7BFF",

          "light": "#2553C9",

          "highContrast": "#3D7BFF",

          "highContrastLight": "#2553C9"

        }

      },

      {

        "id": "oxygen.pull",

        "description": "Pulls, fetches and clones.",

        "defaults": {

          "dark": "#2BD9B3",

          "light": "#0E8A70",

          "highContrast": "#2BD9B3",

          "highContrastLight": "#0E8A70"

        }

      },

      {

        "id": "oxygen.merge",

        "description": "Merges, rebases and resolutions.",

        "defaults": {

          "dark": "#8E7CFF",

          "light": "#5B45D6",

          "highContrast": "#8E7CFF",

          "highContrastLight": "#5B45D6"

        }

      },

      {

        "id": "oxygen.bookmark",

        "description": "Bookmarks and tags.",

        "defaults": {

          "dark": "#FFD166",

          "light": "#A36A00",

          "highContrast": "#FFD166",

          "highContrastLight": "#A36A00"

        }

      },

      {

        "id": "oxygen.switch",

        "description": "Checkouts and bookmark switches.",

        "defaults": {

          "dark": "#56A8FF",

          "light": "#1F6FC2",

          "highContrast": "#56A8FF",

          "highContrastLight": "#1F6FC2"

        }

      },

      {

        "id": "oxygen.undo",

        "description": "Undo, discard and abandon.",

        "defaults": {

          "dark": "#FFB454",

          "light": "#B35900",

          "highContrast": "#FFB454",

          "highContrastLight": "#B35900"

        }

      },

      {

        "id": "oxygen.good",

        "description": "Good: passing, verified, signed.",

        "defaults": {

          "dark": "#5FE3A1",

          "light": "#1A7850",

          "highContrast": "#5FE3A1",

          "highContrastLight": "#1A7850"

        }

      },

      {

        "id": "oxygen.bad",

        "description": "Bad: failing, invalid, expired.",

        "defaults": {

          "dark": "#FF5E7A",

          "light": "#C62D47",

          "highContrast": "#FF5E7A",

          "highContrastLight": "#C62D47"

        }

      },

      {

        "id": "oxygen.warning",

        "description": "Warnings and dirty working copies.",

        "defaults": {

          "dark": "#FFB454",

          "light": "#B35900",

          "highContrast": "#FFB454",

          "highContrastLight": "#B35900"

        }

      },

      {

        "id": "oxygen.key",

        "description": "Keys and roots in the Trust view.",

        "defaults": {

          "dark": "#FFD166",

          "light": "#A36A00",

          "highContrast": "#FFD166",

          "highContrastLight": "#A36A00"

        }

      },

      {

        "id": "oxygen.subrepo",

        "description": "Subrepos.",

        "defaults": {

          "dark": "#1FB6D6",

          "light": "#0B7C93",

          "highContrast": "#1FB6D6",

          "highContrastLight": "#0B7C93"

        }

      },

      {

    "pretest": "esbuild src/oxy.ts --bundle --platform=node --format=esm --outfile=out/oxy.mjs && esbuild src/diffutil.ts --bundle --platform=node --format=esm --outfile=out/diffutil.mjs && esbuild src/markers.ts --bundle --platform=node --format=esm --outfile=out/markers.mjs && esbuild src/api.ts --bundle --platform=node --format=esm --outfile=out/api.mjs && esbuild src/commitbox.ts --bundle --platform=node --format=esm --outfile=out/commitbox.mjs && esbuild src/handoff.ts --bundle --platform=node --format=esm --outfile=out/handoff.mjs && esbuild src/paths.ts --bundle --platform=node --format=esm --outfile=out/paths.mjs && esbuild src/looks.ts --bundle --platform=node --format=esm --outfile=out/looks.mjs",

import { icon, operationLook } from "./style";

    const look = operationLook(op.command, op.snapshot);

    super(look.label, vscode.TreeItemCollapsibleState.None);

    this.description = `${op.current ? "● now · " : ""}${look.kind} · ${timeAgo(op.when_ms)}`;

    this.tooltip = new vscode.MarkdownString(

      `$(${look.icon}) **${look.label}**\n\n\`${op.command.replace(/`/g, "'")}\`\n\n${new Date(op.when_ms).toLocaleString()} · \`${op.id.slice(0, 12)}\``,

      true,

    );

    this.iconPath = icon(op.current ? "pass-filled" : look.icon, op.current ? "oxygen.accent" : look.color);

    this.iconPath = icon("repo", "oxygen.accent");

import { icon as tinted } from "./style";

  constructor(label: string, opts: { description?: string; icon?: string; color?: string; command?: vscode.Command; tooltip?: string; context?: string } = {}) {

      this.iconPath = tinted(opts.icon, opts.color ?? ICON_COLOR[opts.icon]);

/** The colour each icon of these views wears unless a line says otherwise. */

const ICON_COLOR: Record<string, string> = {

  pass: "oxygen.good",

  verified: "oxygen.good",

  error: "oxygen.bad",

  bug: "oxygen.bad",

  warning: "oxygen.warning",

  unlock: "oxygen.warning",

  question: "oxygen.warning",

  search: "oxygen.accent",

  beaker: "oxygen.merge",

  "run-all": "oxygen.push",

  "debug-step-over": "descriptionForeground",

  discard: "oxygen.undo",

  shield: "oxygen.merge",

  key: "oxygen.key",

  law: "oxygen.key",

  "list-tree": "oxygen.accent",

  "circle-slash": "oxygen.bad",

  "circle-outline": "descriptionForeground",

};

        item.iconPath = tinted("repo", "oxygen.accent");

      return [new Line("No bisect in progress", { icon: "search", description: "🔍 start one to find a regression", command: cmd("Start", "oxygen.bisectStart") })];

          new Line(`Found: ${status.culprit.slice(0, 12)}`, { icon: "bug", description: "🎯 the first change that makes the state bad", command: { title: "Show", command: "oxygen.showChange", arguments: [repo.root, status.culprit] } }),

      items.push(new Line("No trust policy: this repository is unverified", { icon: "unlock", description: "🔓 oxy policy init creates one", tooltip: "Without a policy every change and reference update is accepted." }));

    // The bookmark in the Oxygen accent when clean, amber with uncommitted

    // work, and on the error background with conflicts.

    const dirty = status.paths.length > 0;

    this.statusBar.text = `$(${status.conflicted ? "warning" : "bookmark"}) ${text}`;

    this.statusBar.color = status.conflicted ? undefined : new vscode.ThemeColor(dirty ? "oxygen.warning" : "oxygen.accent");

      this.syncBar.text = `$(cloud-upload) ${ahead} $(cloud-download) ${behind}`;

      this.syncBar.color = new vscode.ThemeColor(behind > 0 ? "oxygen.pull" : ahead > 0 ? "oxygen.push" : "oxygen.good");