LLeMbas CLI 1.0.0

The first public release of LLeMbas CLI: a terminal coding agent and project manager for any LLM
API, with permission modes, git snapshots, memory and skills, knowledge bases, MCP, voice, and a
link to a LLeMbas instance whose web UI can work its sessions too. Signed Linux binaries for x64
and arm64.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tests/release.test.ts

@@ -0,0 +1,120 @@
+import { describe, expect, test } from "bun:test"
+import { mkdirSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs"
+import { tmpdir } from "node:os"
+import { join } from "node:path"
+import { doRelease, findVersion, nextVersion, planRelease, releaseChangelog, type ReleasePlan } from "../src/git/release.ts"
+import { git } from "../src/git/run.ts"
+
+const repo = (files: Record<string, string>) => {
+  const d = mkdtempSync(join(tmpdir(), "ph-rel-"))
+  for (const [f, t] of Object.entries(files)) {
+    mkdirSync(join(d, f, ".."), { recursive: true })
+    writeFileSync(join(d, f), t)
+  }
+  git(d, ["init", "-q", "-b", "main"])
+  git(d, ["config", "user.email", "t@example.com"])
+  git(d, ["config", "user.name", "T"])
+  git(d, ["config", "commit.gpgsign", "false"])
+  git(d, ["config", "tag.gpgsign", "false"])
+  git(d, ["add", "-A"])
+  git(d, ["commit", "-q", "-m", "init"])
+  return d
+}
+
+const CL = `# Changelog
+
+## [Unreleased]
+
+### Added
+- A thing.
+
+## [0.1.0] — 2026-01-01
+
+### Added
+- The start.
+
+[Unreleased]: https://git.example/p/compare/v0.1.0...HEAD
+[0.1.0]: https://git.example/p/releases/tag/v0.1.0
+`
+
+describe("release", () => {
+  test("the version is found where each kind of project keeps it, and replaced only there", () => {
+    const py = repo({ "pyproject.toml": '[build-system]\nrequires = ["x"]\n\n[project]\nname = "p"\nversion = "1.2.3"\n\n[tool.x]\nversion = "9"\n' })
+    const v = findVersion(py)!
+    expect([v.file, v.version]).toEqual(["pyproject.toml", "1.2.3"])
+    expect(v.with("1.3.0")).toContain('[project]\nname = "p"\nversion = "1.3.0"')
+    expect(v.with("1.3.0")).toContain('version = "9"')
+    const cargo = repo({ "Cargo.toml": '[package]\nname = "c"\nversion = "0.4.1"\n\n[dependencies]\nserde = { version = "1" }\n' })
+    expect(findVersion(cargo)!.with("0.5.0")).toBe('[package]\nname = "c"\nversion = "0.5.0"\n\n[dependencies]\nserde = { version = "1" }\n')
+    const init = repo({ "src/lembas/__init__.py": '"""x"""\n__version__ = "1.9.0"\n' })
+    expect(findVersion(init)!).toMatchObject({ file: "src/lembas/__init__.py", version: "1.9.0" })
+    expect(findVersion(repo({ VERSION: "2.0.0\n" }))!.version).toBe("2.0.0")
+    // single quotes in TOML; package.json's own version, not a nested one; the lockfile moves too
+    expect(findVersion(repo({ "Cargo.toml": "[package]\nname = 'c'\nversion = '0.2.0'\n" }))!.with("0.3.0")).toContain("version = '0.3.0'")
+    const js = repo({ "package.json": '{\n    "name": "x",\n    "config": { "version": "9.9.9" },\n    "version": "1.0.0"\n}\n', "package-lock.json": '{\n  "name": "x",\n  "version": "1.0.0",\n  "packages": { "": { "version": "1.0.0" } }\n}\n' })
+    const jv = findVersion(js)!
+    expect(jv.version).toBe("1.0.0")
+    expect(JSON.parse(jv.with("1.1.0"))).toEqual({ name: "x", config: { version: "9.9.9" }, version: "1.1.0" })
+    expect(jv.with("1.1.0")).toStartWith('{\n    "name"')
+    expect(JSON.parse(jv.also![0]!.with("1.1.0"))).toMatchObject({ version: "1.1.0", packages: { "": { version: "1.1.0" } } })
+    expect(findVersion(repo({ "a.txt": "" }))).toBeUndefined()
+  })
+
+  test("next versions", () => {
+    expect(nextVersion("0.7.0", "")).toBe("0.7.1")
+    expect(nextVersion("0.7.3", "minor")).toBe("0.8.0")
+    expect(nextVersion("0.7.3", "major")).toBe("1.0.0")
+    expect(nextVersion("1.2.0-beta.3", "patch")).toBe("1.2.0")
+    expect(nextVersion("0.7.0", "0.9.0")).toBe("0.9.0")
+    expect(nextVersion("0.7.0", "v0.9.0")).toBe("0.9.0")
+    expect(() => nextVersion("0.7.0", "huge")).toThrow("not patch, minor, major")
+  })
+
+  test("the Unreleased entries move under the new version; Unreleased stays, empty; link references follow", () => {
+    const r = releaseChangelog(CL, "0.2.0", "2026-10-01")!
+    expect(r.notes).toBe("### Added\n- A thing.")
+    expect(r.text).toContain("## [Unreleased]\n\n## [0.2.0] — 2026-10-01\n\n### Added\n- A thing.\n\n## [0.1.0]")
+    expect(r.text).toContain("[Unreleased]: https://git.example/p/compare/v0.2.0...HEAD\n[0.2.0]: https://git.example/p/compare/v0.1.0...v0.2.0")
+    expect(releaseChangelog("# C\n\n## [Unreleased]\n\n## [0.1.0]\n- x\n", "0.2.0", "d")).toBeUndefined()
+    const pre = releaseChangelog("## [Unreleased]\n- y\n\n[Unreleased]: https://g/p/compare/v1.0.0-beta.1...HEAD\n", "1.0.0", "d")!
+    expect(pre.text).toContain("[1.0.0]: https://g/p/compare/v1.0.0-beta.1...v1.0.0")
+  })
+
+  test("plan and do: a clean tree is required; one commit with both files, an annotated tag carrying the notes; nothing pushed", () => {
+    const d = repo({ "package.json": '{\n  "name": "@x/demo",\n  "version": "0.1.0"\n}\n', "CHANGELOG.md": CL })
+    git(d, ["tag", "-a", "v0.1.0", "-m", "0.1.0"])
+    writeFileSync(join(d, "package.json"), '{\n  "name": "@x/demo",\n  "version": "0.1.0" \n}\n')
+    expect(planRelease(d, "minor")).toMatchObject({ blocked: expect.stringContaining("uncommitted changes") })
+    git(d, ["checkout", "--", "package.json"])
+    const p = planRelease(d, "minor") as ReleasePlan
+    expect([p.from, p.to, p.tag, p.name, p.sign]).toEqual(["0.1.0", "0.2.0", "v0.2.0", "demo", false])
+    const r = doRelease(p)
+    expect(r.ok).toBe(true)
+    expect(r.lines.at(-1)).toContain("nothing pushed")
+    expect(readFileSync(join(d, "package.json"), "utf8")).toContain('"version": "0.2.0"')
+    expect(git(d, ["show", "--stat", "--format=%s", "HEAD"]).out).toMatch(/^Release 0\.2\.0\n[\s\S]*CHANGELOG\.md[\s\S]*package\.json/)
+    expect(git(d, ["tag", "-l", "--format=%(contents)", "v0.2.0"]).out).toBe("demo 0.2.0\n\n### Added\n- A thing.")
+    expect(git(d, ["cat-file", "-t", "v0.2.0"]).out).toBe("tag")
+    expect(planRelease(d, "0.2.0")).toMatchObject({ blocked: "the tag v0.2.0 already exists" })
+  })
+
+  test("a tag that failed last time is finished, not skipped; a plan gone stale does nothing", () => {
+    const d = repo({ "package.json": '{ "name": "demo", "version": "0.1.0" }\n', "CHANGELOG.md": CL })
+    const p = planRelease(d, "minor") as ReleasePlan
+    // the tag fails (as with a locked key): the commit is there, the tag is not
+    git(d, ["tag", "v0.2.0", "HEAD"])
+    expect(doRelease(p).ok).toBe(false)
+    git(d, ["tag", "-d", "v0.2.0"])
+    expect(git(d, ["log", "-1", "--format=%s"]).out).toBe("Release 0.2.0")
+    const again = planRelease(d, "") as ReleasePlan
+    expect([again.tagOnly, again.to, again.tag]).toEqual([true, "0.2.0", "v0.2.0"])
+    expect(doRelease(again).ok).toBe(true)
+    expect(git(d, ["tag", "-l", "--format=%(contents)", "v0.2.0"]).out).toBe("demo 0.2.0\n\n### Added\n- A thing.")
+    // stale: the tree changed after the plan
+    const q = planRelease(d, "patch") as ReleasePlan
+    writeFileSync(join(d, "CHANGELOG.md"), "changed\n")
+    const stale = doRelease(q)
+    expect(stale.ok).toBe(false)
+    expect(stale.lines[0]).toContain("changed since the plan")
+  })
+})