@vibe-commit/capture 0.1.0

package/dist/term.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Terminal primitives — the executable form of `DESIGN.md` §13.2–§13.5.
+ *
+ * §13.2 is explicit: "Every escape sequence in the product comes from here — no
+ * literal `\x1b[` anywhere else in any repo, so the palette has exactly one
+ * definition and `NO_COLOR` has exactly one switch." `test/term.test.ts` holds
+ * that line with a source scan; it is the only reason the rule survives contact
+ * with the fifteen tasks that build on this file.
+ *
+ * The governing constraint (§13): in a terminal we own only the foreground, and
+ * the user's theme decides what every colour name resolves to. Base-16 SGR only —
+ * no 24-bit, no 256-cube, and never a background fill.
+ */
+/** The six roles of §13.1. `text` is deliberately empty — see §13.2. */
+export declare const SGR: {
+    readonly reset: "\u001B[0m";
+    readonly text: "";
+    readonly muted: "\u001B[2m";
+    readonly accent: "\u001B[36m";
+    readonly ok: "\u001B[32m";
+    readonly warn: "\u001B[33m";
+    readonly bad: "\u001B[31m";
+    readonly strong: "\u001B[1m";
+};
+export type SgrRole = keyof typeof SGR;
+/** §13.2 — status glyphs degrade to WORDS, never to nothing. */
+export declare const GLYPH: {
+    readonly ok: {
+        readonly colour: "●";
+        readonly plain: "ok   ";
+    };
+    readonly warn: {
+        readonly colour: "●";
+        readonly plain: "warn ";
+    };
+    readonly bad: {
+        readonly colour: "●";
+        readonly plain: "error";
+    };
+};
+export type GlyphKind = keyof typeof GLYPH;
+/** §13.4 — hard wrap. Never `process.stdout.columns`. */
+export declare const WRAP_COLUMNS = 80;
+/** §13.5 — fixed key column for key/value output. */
+export declare const LABEL_GUTTER = 11;
+/**
+ * §13.3 detection order, resolved ONCE at process start and not negotiable:
+ *   1. NO_COLOR set to any value (including empty) — wins over everything
+ *   2. !isatty(1)
+ *   3. TERM=dumb
+ *   4. CI set
+ *   5. --no-color
+ *
+ * `--json` implies all of them; callers pass `json: true`.
+ */
+export interface ColourInputs {
+    readonly env: NodeJS.ProcessEnv;
+    readonly isTty: boolean;
+    readonly noColorFlag: boolean;
+    readonly json: boolean;
+}
+export declare function resolveColour(inputs: ColourInputs): boolean;
+/**
+ * Wrap one SGR role around text. A no-op when colour is off, which is what makes
+ * `NO_COLOR` a lossless degradation rather than a downgrade (§13.1): bold carries
+ * structure, colour carries status, and the indentation carries the rest.
+ */
+export declare function paint(enabled: boolean, role: SgrRole, text: string): string;
+/** §13.2 — the glyph, or the word it degrades to. */
+export declare function glyph(enabled: boolean, kind: GlyphKind): string;
+/**
+ * §13.4 hard wrap at 80 columns INCLUDING the indent, with continuation lines
+ * hung to `hangingIndent`.
+ *
+ * Operates on plain text only. Wrapping painted text would count escape bytes as
+ * columns, so every caller wraps first and paints after — the reason `paint` is a
+ * separate function rather than a parameter here.
+ *
+ * A single word longer than the available width (a URL, a path) is emitted on its
+ * own line rather than broken: breaking a URL makes it uncopyable, which costs
+ * more than the overflow.
+ */
+export declare function wrap(text: string, indent: number, hangingIndent?: number): string[];
+/**
+ * §13.4 — long paths truncate from the LEFT with a leading ellipsis, because the
+ * filename identifies and the directory does not.
+ */
+export declare function truncatePath(path: string, max: number): string;
+/** §13.5 — key/value output on the fixed label gutter. */
+export declare function labelled(indent: number, key: string, value: string): string;
+/**
+ * §13.6 — the one shape for every interactive failure: what, why, fix. Fix last,
+ * always, because the last thing on screen is what gets copied.
+ *
+ * Three prohibitions the CALLER owns, because they are properties of the copy
+ * rather than of the layout: never a stack trace unless `VIBECOMMIT_DEBUG` is
+ * set, never a bare HTTP status, and **never "you" as the subject of the `what`
+ * line** — the subject is the system or the state.
+ *
+ * The `what` line carries the status colour on the glyph and `strong` on the
+ * text: one colour, one weight, per §13.1.
+ */
+export interface ErrorBlock {
+    readonly kind: GlyphKind;
+    readonly what: string;
+    /** Up to three lines after wrapping (§13.6). Names the state, with the value. */
+    readonly why: readonly string[];
+    readonly fixLabel?: string;
+    /** Commands to type. `accent`, per §13.6 — the one place besides a URL. */
+    readonly fixes?: readonly string[];
+}
+export declare function renderErrorBlock(block: ErrorBlock, colour: boolean): string[];

package/dist/term.js

@@ -0,0 +1,134 @@
+/**
+ * Terminal primitives — the executable form of `DESIGN.md` §13.2–§13.5.
+ *
+ * §13.2 is explicit: "Every escape sequence in the product comes from here — no
+ * literal `\x1b[` anywhere else in any repo, so the palette has exactly one
+ * definition and `NO_COLOR` has exactly one switch." `test/term.test.ts` holds
+ * that line with a source scan; it is the only reason the rule survives contact
+ * with the fifteen tasks that build on this file.
+ *
+ * The governing constraint (§13): in a terminal we own only the foreground, and
+ * the user's theme decides what every colour name resolves to. Base-16 SGR only —
+ * no 24-bit, no 256-cube, and never a background fill.
+ */
+/** The six roles of §13.1. `text` is deliberately empty — see §13.2. */
+export const SGR = {
+    reset: "\x1b[0m",
+    text: "",
+    muted: "\x1b[2m",
+    accent: "\x1b[36m",
+    ok: "\x1b[32m",
+    warn: "\x1b[33m",
+    bad: "\x1b[31m",
+    strong: "\x1b[1m",
+};
+/** §13.2 — status glyphs degrade to WORDS, never to nothing. */
+export const GLYPH = {
+    ok: { colour: "●", plain: "ok   " },
+    warn: { colour: "●", plain: "warn " },
+    bad: { colour: "●", plain: "error" },
+};
+/** §13.4 — hard wrap. Never `process.stdout.columns`. */
+export const WRAP_COLUMNS = 80;
+/** §13.5 — fixed key column for key/value output. */
+export const LABEL_GUTTER = 11;
+export function resolveColour(inputs) {
+    if (inputs.json)
+        return false;
+    if (inputs.env.NO_COLOR !== undefined)
+        return false;
+    if (!inputs.isTty)
+        return false;
+    if (inputs.env.TERM === "dumb")
+        return false;
+    if (inputs.env.CI !== undefined)
+        return false;
+    if (inputs.noColorFlag)
+        return false;
+    return true;
+}
+/**
+ * Wrap one SGR role around text. A no-op when colour is off, which is what makes
+ * `NO_COLOR` a lossless degradation rather than a downgrade (§13.1): bold carries
+ * structure, colour carries status, and the indentation carries the rest.
+ */
+export function paint(enabled, role, text) {
+    const code = SGR[role];
+    if (!enabled || code === "")
+        return text;
+    return `${code}${text}${SGR.reset}`;
+}
+/** §13.2 — the glyph, or the word it degrades to. */
+export function glyph(enabled, kind) {
+    return enabled ? GLYPH[kind].colour : GLYPH[kind].plain;
+}
+/**
+ * §13.4 hard wrap at 80 columns INCLUDING the indent, with continuation lines
+ * hung to `hangingIndent`.
+ *
+ * Operates on plain text only. Wrapping painted text would count escape bytes as
+ * columns, so every caller wraps first and paints after — the reason `paint` is a
+ * separate function rather than a parameter here.
+ *
+ * A single word longer than the available width (a URL, a path) is emitted on its
+ * own line rather than broken: breaking a URL makes it uncopyable, which costs
+ * more than the overflow.
+ */
+export function wrap(text, indent, hangingIndent = indent) {
+    const words = text.split(/\s+/).filter((w) => w.length > 0);
+    if (words.length === 0)
+        return [];
+    const lines = [];
+    let current = " ".repeat(indent);
+    let currentIndent = indent;
+    let empty = true;
+    for (const word of words) {
+        const candidate = empty ? current + word : `${current} ${word}`;
+        if (!empty && candidate.length > WRAP_COLUMNS) {
+            lines.push(current);
+            currentIndent = hangingIndent;
+            current = " ".repeat(currentIndent) + word;
+        }
+        else {
+            current = candidate;
+        }
+        empty = false;
+    }
+    lines.push(current);
+    return lines;
+}
+/**
+ * §13.4 — long paths truncate from the LEFT with a leading ellipsis, because the
+ * filename identifies and the directory does not.
+ */
+export function truncatePath(path, max) {
+    if (path.length <= max)
+        return path;
+    return `…${path.slice(path.length - (max - 1))}`;
+}
+/** §13.5 — key/value output on the fixed label gutter. */
+export function labelled(indent, key, value) {
+    return `${" ".repeat(indent)}${key.padEnd(LABEL_GUTTER)}${value}`;
+}
+export function renderErrorBlock(block, colour) {
+    const out = [];
+    const marker = glyph(colour, block.kind);
+    for (const [i, line] of wrap(block.what, 2 + marker.length + 1, 4).entries()) {
+        out.push(i === 0
+            ? `  ${paint(colour, block.kind, marker)} ${paint(colour, "strong", line.trimStart())}`
+            : paint(colour, "strong", line));
+    }
+    for (const paragraph of block.why) {
+        for (const line of wrap(paragraph, 4))
+            out.push(paint(colour, "muted", line));
+    }
+    if (block.fixLabel !== undefined && block.fixes !== undefined && block.fixes.length > 0) {
+        out.push("");
+        for (const line of wrap(block.fixLabel, 4))
+            out.push(line);
+        for (const fix of block.fixes)
+            out.push(`      ${paint(colour, "accent", fix)}`);
+    }
+    return out;
+}
+//# sourceMappingURL=term.js.map

package/dist/term.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The client version that goes on the wire as `X-Client-Version` (CR-029).
+ *
+ * Deliberately a literal rather than an import of `package.json`: `rootDir` is
+ * `./src`, so importing the manifest would drag it into `dist/` and change the
+ * published tree shape. The cost of the literal is that it can drift from the
+ * manifest — which is precisely what `scripts/check-version-skew.mjs` exists to
+ * catch, and why CI runs it before publish.
+ *
+ * There is no version on the wire today and three separately-editable version
+ * fields on disk (D58 plan §ER5/§ER14). This constant plus the skew check is the
+ * whole fix: one source, asserted equal to the manifest and to the release tag.
+ */
+export declare const CLIENT_VERSION = "0.1.0";
+/** Header name for the wire contract. */
+export declare const CLIENT_VERSION_HEADER = "X-Client-Version";

package/dist/version.js

@@ -0,0 +1,17 @@
+/**
+ * The client version that goes on the wire as `X-Client-Version` (CR-029).
+ *
+ * Deliberately a literal rather than an import of `package.json`: `rootDir` is
+ * `./src`, so importing the manifest would drag it into `dist/` and change the
+ * published tree shape. The cost of the literal is that it can drift from the
+ * manifest — which is precisely what `scripts/check-version-skew.mjs` exists to
+ * catch, and why CI runs it before publish.
+ *
+ * There is no version on the wire today and three separately-editable version
+ * fields on disk (D58 plan §ER5/§ER14). This constant plus the skew check is the
+ * whole fix: one source, asserted equal to the manifest and to the release tag.
+ */
+export const CLIENT_VERSION = "0.1.0";
+/** Header name for the wire contract. */
+export const CLIENT_VERSION_HEADER = "X-Client-Version";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,yCAAyC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@vibe-commit/capture",
+  "version": "0.1.0",
+  "description": "VibeCommit capture client — records Claude Code sessions against the commits they produced.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "vibecommit": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.15.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vibe-Commit/vibecommit-capture.git"
+  },
+  "homepage": "https://github.com/Vibe-Commit/vibecommit-capture#readme",
+  "bugs": {
+    "url": "https://github.com/Vibe-Commit/vibecommit-capture/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "audit",
+    "provenance",
+    "git",
+    "cli"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json",
+    "pretest": "npm run build",
+    "test": "node --test --import tsx 'test/**/*.test.ts'",
+    "check:skew": "node scripts/check-version-skew.mjs",
+    "fixture:write": "node --import tsx scripts/write-wire-fixture.mts"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  }
+}