@oasissys/bitbucket-cli 0.1.1

package/dist/src/toon.js

@@ -0,0 +1,148 @@
+/**
+ * Minimal TOON (Token-Oriented Object Notation) encoder.
+ *
+ * TOON is the stdout format for AXI CLIs — ~40% fewer tokens than JSON while
+ * staying readable by agents. See https://toonformat.dev/reference/spec.html.
+ *
+ * Keep all internal logic on plain JS objects; call `encode()` only at the
+ * output boundary. This encoder covers the shapes an AXI CLI actually emits:
+ *
+ *   - objects            key: value
+ *   - nested objects     key:\n  child: value
+ *   - tabular arrays      key[N]{f1,f2}:\n  a,b\n  c,d
+ *   - primitive arrays    key[N]: a,b,c
+ *   - empty arrays        key[0]:
+ *
+ * Two-space indentation, no tabs, no trailing newline (§12).
+ */
+const INDENT = "  ";
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isScalar(v) {
+    return v === null || v === undefined || ["string", "number", "boolean"].includes(typeof v);
+}
+// §7.2 — a string MUST be quoted when it would otherwise be ambiguous with a
+// structural token, a literal (true/false/null), or a number. We also quote on
+// the comma delimiter so the same formatter is safe inside tabular rows.
+const NUMERIC_LIKE = /^-?\d+(?:\.\d+)?(?:e[+-]?\d+)?$/i;
+const NEEDS_QUOTE = /[:"\\[\]{},]/;
+function hasControlChar(s) {
+    for (let i = 0; i < s.length; i++) {
+        if (s.charCodeAt(i) <= 0x1f)
+            return true;
+    }
+    return false;
+}
+function quoteString(s) {
+    const needs = s.length === 0 ||
+        s !== s.trim() ||
+        s === "true" ||
+        s === "false" ||
+        s === "null" ||
+        NUMERIC_LIKE.test(s) ||
+        NEEDS_QUOTE.test(s) ||
+        hasControlChar(s);
+    if (!needs)
+        return s;
+    const escaped = s
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+    return `"${escaped}"`;
+}
+function formatScalar(v) {
+    if (v === null || v === undefined)
+        return "null";
+    if (typeof v === "boolean")
+        return v ? "true" : "false";
+    if (typeof v === "number") {
+        if (!Number.isFinite(v))
+            return "null";
+        return Object.is(v, -0) ? "0" : String(v);
+    }
+    if (typeof v === "string")
+        return quoteString(v);
+    // Non-scalar leaked into a scalar slot — stringify defensively rather than throw.
+    return quoteString(JSON.stringify(v));
+}
+function tableFields(arr) {
+    // Tabular form is only valid when every row is a flat object (scalar values)
+    // sharing the first row's key set. Otherwise fall back to a list.
+    const fields = Object.keys(arr[0]);
+    if (fields.length === 0)
+        return null;
+    for (const row of arr) {
+        const keys = Object.keys(row);
+        if (keys.length !== fields.length || !fields.every(f => f in row))
+            return null;
+        if (!fields.every(f => isScalar(row[f])))
+            return null;
+    }
+    return fields;
+}
+function emitArray(key, arr, depth, lines) {
+    const pad = INDENT.repeat(depth);
+    if (arr.length === 0) {
+        lines.push(`${pad}${key}[0]:`);
+        return;
+    }
+    if (arr.every(isScalar)) {
+        lines.push(`${pad}${key}[${arr.length}]: ${arr.map(formatScalar).join(",")}`);
+        return;
+    }
+    if (arr.every(isPlainObject)) {
+        const rows = arr;
+        const fields = tableFields(rows);
+        if (fields) {
+            lines.push(`${pad}${key}[${arr.length}]{${fields.join(",")}}:`);
+            for (const row of rows) {
+                lines.push(`${INDENT.repeat(depth + 1)}${fields.map(f => formatScalar(row[f])).join(",")}`);
+            }
+            return;
+        }
+        // Non-uniform / nested objects → list of blocks.
+        lines.push(`${pad}${key}[${arr.length}]:`);
+        for (const row of rows) {
+            lines.push(`${INDENT.repeat(depth + 1)}-`);
+            emitObject(row, depth + 2, lines);
+        }
+        return;
+    }
+    // Mixed array — stringify each element as a scalar.
+    lines.push(`${pad}${key}[${arr.length}]: ${arr.map(formatScalar).join(",")}`);
+}
+function emitObject(obj, depth, lines) {
+    const pad = INDENT.repeat(depth);
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            emitArray(key, value, depth, lines);
+        }
+        else if (isPlainObject(value)) {
+            lines.push(`${pad}${key}:`);
+            emitObject(value, depth + 1, lines);
+        }
+        else {
+            lines.push(`${pad}${key}: ${formatScalar(value)}`);
+        }
+    }
+}
+/** Encode a JS value to a TOON document (no trailing newline). */
+export function encode(value) {
+    const lines = [];
+    if (Array.isArray(value)) {
+        // Root array: emit with an empty key so the header is a bare `[N]{...}:`.
+        emitArray("", value, 0, lines);
+        return lines.join("\n");
+    }
+    if (isPlainObject(value)) {
+        emitObject(value, 0, lines);
+        return lines.join("\n");
+    }
+    return formatScalar(value);
+}
+//# sourceMappingURL=toon.js.map

package/dist/src/toon.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,58 @@
+export interface CleanRepository {
+    slug: string;
+    name: string;
+    project: {
+        key: string;
+        name: string;
+    };
+    cloneUrl?: string;
+    state: string;
+    forkable: boolean;
+}
+export interface CleanBranch {
+    id: string;
+    displayId: string;
+    latestCommit: string;
+    isDefault: boolean;
+}
+export interface CleanPullRequest {
+    id: number;
+    title: string;
+    description: string;
+    state: string;
+    author: string;
+    fromBranch: string;
+    toBranch: string;
+    reviewers: CleanReviewer[];
+    version: number;
+    createdDate: string;
+    updatedDate: string;
+    link?: string;
+}
+export interface CleanReviewer {
+    user: string;
+    slug: string;
+    approved: boolean;
+    status: string;
+}
+export interface CleanPrComment {
+    id: number;
+    text: string;
+    author: string;
+    createdDate: string;
+    updatedDate: string;
+}
+export interface CleanActivity {
+    id: number;
+    action: string;
+    createdDate: string;
+    user: string;
+    comment?: string;
+}
+export interface CleanCommit {
+    id: string;
+    displayId: string;
+    message: string;
+    author: string;
+    authorTimestamp: string;
+}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@oasissys/bitbucket-cli",
+  "version": "0.1.1",
+  "packageManager": "pnpm@11.9.0",
+  "description": "oasis-bitbucket — AXI CLI for the Oasis Bitbucket Server: repos, branches, and pull requests with token-efficient TOON output",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oasissys/bitbucket-cli.git"
+  },
+  "keywords": [
+    "bitbucket",
+    "cli",
+    "agent",
+    "axi",
+    "toon",
+    "oasis"
+  ],
+  "bin": {
+    "oasis-bitbucket": "./dist/bin/oasis-bitbucket.js"
+  },
+  "files": [
+    "dist",
+    "skills/bitbucket-cli",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:skill": "tsx scripts/build-skill.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint .",
+    "dev": "tsx bin/oasis-bitbucket.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.0.0",
+    "eslint": "^10.1.0",
+    "globals": "^17.4.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/bitbucket-cli/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: bitbucket-cli
+description: Browse Oasis Bitbucket (git server) and manage pull requests from the shell — list repos/branches/PRs, read a PR's details and reviewers, review its diff, create a PR, add comments, and merge. Use when the user asks about Bitbucket repos, branches, pull requests, PR reviews, diffs, or wants to open/comment on/merge a PR on the Oasis git server.
+---
+
+# oasis-bitbucket
+
+Shell CLI for the Oasis Bitbucket Server (git + pull requests). Auth: `oasis-bitbucket auth --user <u> --password <p>`.
+Invoke as `oasis-bitbucket` (on PATH after a global install; no install: `npx -y @oasissys/bitbucket-cli`). TOON output; exit 0/1/2; every command has `--help`.
+
+## Repo references
+
+Repos are addressed as `PROJECT/repo` (project key + repository slug), e.g.
+`OAS_PLS/oasis-common`. `PROJECT` alone addresses a project.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `oasis-bitbucket (no args)` | live view: your open pull requests (author or reviewer) |
+| `oasis-bitbucket repos <PROJECT> [--fields <l>]` | list repositories in a project |
+| `oasis-bitbucket branches <PROJECT/repo>` | list branches (marks the default) |
+| `oasis-bitbucket prs <PROJECT/repo> [--state <s>] [--fields <l>]` | list pull requests (default OPEN) |
+| `oasis-bitbucket pr <PROJECT/repo> <id>` | PR details, reviewers, and version (needed to merge) |
+| `oasis-bitbucket diff <PROJECT/repo> <id> [--context <n>] [--full]` | unified diff — first 400 lines by default |
+| `oasis-bitbucket create-pr <PROJECT/repo> --title <t> --from <b> --to <b> [--reviewer <s>]...` | open a PR (source branch must be pushed) |
+| `oasis-bitbucket comment <PROJECT/repo> <id> --text <m> [--file <p> --line <n>]` | add a general or inline PR comment |
+| `oasis-bitbucket merge <PROJECT/repo> <id> [--version <n>]` | merge an open PR (version auto-resolved if omitted) |
+| `oasis-bitbucket auth [--user <u> --password <p>]` | configure credentials (no flags = status; --clear = sign out) |
+
+## Examples
+
+```sh
+# Review workflow for a PR
+oasis-bitbucket pr   OAS_PLS/oasis-common 681
+oasis-bitbucket diff OAS_PLS/oasis-common 681
+oasis-bitbucket comment OAS_PLS/oasis-common 681 --text "LGTM"
+
+# Open a PR
+oasis-bitbucket create-pr OAS_PLS/oasis-common --title "Fix X" --from feature/x --to master --reviewer alsaheb
+
+# Merge (version fetched automatically)
+oasis-bitbucket merge OAS_PLS/oasis-common 681
+```
+
+## Notes
+- `merge` is destructive; version auto-resolves if omitted; already-merged is a no-op.
+- `reviews` = approval count (e.g. `2/3 approved`). Diffs truncated to 400 lines (`--full`).
+- Lists default to a minimal schema; `--fields` adds columns.