argsbarg 5.1.5 → 5.1.6

package/CHANGELOG.md

@@ -7,12 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.1.6] - 2026-07-05
+
+
 ## [5.1.5] - 2026-07-05
 
 ### Changed
 
-- **`just install-local`** — back up release `Formula/{key}.rb`, write dev formula for `brew install`, then restore the release formula (`scripts/with-dev-formula.ts`).
-- **`just ensure-release-formula`** — normalize release formula layout; restore from install-local backup or fail with `git restore` hint if a dev `file://` formula is left on disk.
+- **`just install-local`** — back up release `Formula/{key}.rb`, write dev formula for `brew install`, then restore (`scripts/with-dev-formula.ts`; dropped `gen-dev-formula.ts` / `dev-formula.ts`).
 
 ## [5.1.4] - 2026-07-04
 
@@ -617,7 +619,8 @@ const cli = { ... } satisfies CliProgram;  // or : CliProgram
 - Migrate schemas: rename every `children` property to **`commands`**; move positional definitions to **`CliPositional`** objects on `positionals` and strip `positional` / `argMin` / `argMax` from flag definitions under `options` (flags only carry `name`, `description`, `kind`, and optional `shortName`).
 - Imports: use `CliPositional` where needed; replace `CliOptionDef` with `CliOption` or `CliPositional` as appropriate.
 
-[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v5.1.5...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v5.1.6...HEAD
+[5.1.6]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.1.6
 [5.1.5]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.1.5
 [5.1.4]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.1.4
 [5.1.3]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.1.3

package/README.md

@@ -264,7 +264,7 @@ To refresh the Cursor rule in an existing consumer: `bun scripts/merge-cli-progr
 | Command layout | `src/commands/<name>/command.ts`; registration in `src/program.ts` |
 | MCP doc topics | `docs.topics` auto-exposed as `<key>://docs/<topic>` resources when docs + MCP enabled |
 | Package import | `from "argsbarg"` (not relative to argsbarg `src/`) |
-| Homebrew distribution | `scripts/formula-shared.ts`, `scripts/gen-dev-formula.ts`, `Formula/`, `justfile` |
+| Homebrew distribution | `scripts/formula-shared.ts`, `scripts/with-dev-formula.ts`, `Formula/`, `justfile` |
 | Dev tooling | Biome (`just format` / `just lint`), TypeScript, colocated tests |
 | Cursor rules | `.cursor/rules/cli-program.mdc`, `.cursor/rules/code.mdc` |
 

package/docs/configure.md

@@ -27,7 +27,7 @@ brew uninstall <tap>/<key>
 
 ```bash
 just build
-just install-local    # same formula as production; gen-dev-formula uses file:// URL (`just install` is an alias)
+just install-local    # same formula as production; temporary file:// URL during brew install (`just install` is an alias)
 ```
 
 Dev flow matches release: formula `install` copies the binary and generates completions; `post_install` runs `<key> configure --sync --yes` for skills/MCP. Use `just reinstall-local` to swap the binary into Cellar during tight edit cycles (skips completions and `post_install`). Use `just sync-artifacts` to refresh agent artifacts without touching the binary.

package/examples/full-example/justfile

@@ -49,12 +49,8 @@ install: install-local
 sync-artifacts:
     just run configure --sync --yes
 
-# Normalize release formula (fix leftover dev formula or stale layout)
-ensure-release-formula:
-    bun scripts/ensure-release-formula.ts
-
 # Dev install: build, dev formula (restored after brew), symlink tap, brew install
-install-local: build ensure-release-formula
+install-local: build
     @brew untap {{tap}} 2>/dev/null || true
     mkdir -p {{tap_parent}}
     ln -sfn '{{justfile_directory()}}' {{tap_path}}

package/examples/full-example/scripts/with-dev-formula.ts

@@ -1,8 +1,47 @@
 #!/usr/bin/env bun
+
 /** Back up release formula, write dev formula, run a command, then restore. Usage: bun scripts/with-dev-formula.ts -- brew install … */
 
 import { spawnSync } from "node:child_process";
-import { backupReleaseFormula, releaseFormulaPath, restoreReleaseFormula, writeDevFormula } from "./dev-formula.ts";
+import { createHash } from "node:crypto";
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createIdentity } from "./create-identity.ts";
+import { renderDevFormula } from "./formula-shared.ts";
+
+const { key } = createIdentity;
+const root = join(import.meta.dir, "..");
+const stagingDir = join(root, "Formula", ".staging");
+const stagingPath = join(stagingDir, key);
+const formulaPath = join(root, "Formula", `${key}.rb`);
+const backupPath = join(stagingDir, `${key}.rb.bak`);
+
+function backupReleaseFormula(): void {
+  if (!existsSync(formulaPath)) {
+    return;
+  }
+  mkdirSync(stagingDir, { recursive: true });
+  copyFileSync(formulaPath, backupPath);
+}
+
+function restoreReleaseFormula(): void {
+  if (!existsSync(backupPath)) {
+    return;
+  }
+  copyFileSync(backupPath, formulaPath);
+  unlinkSync(backupPath);
+}
+
+function writeDevFormula(): void {
+  const distPath = join(root, "dist", key);
+  mkdirSync(stagingDir, { recursive: true });
+  copyFileSync(distPath, stagingPath);
+  chmodSync(stagingPath, 0o755);
+
+  const sha256 = createHash("sha256").update(readFileSync(stagingPath)).digest("hex");
+  const version = JSON.parse(readFileSync(join(root, "package.json"), "utf8")).version as string;
+  writeFileSync(formulaPath, renderDevFormula(stagingPath, version, sha256), "utf8");
+}
 
 const sep = process.argv.indexOf("--");
 if (sep === -1 || sep === process.argv.length - 1) {
@@ -31,5 +70,5 @@ try {
 }
 
 if (process.exitCode === 0) {
-  console.log(`Restored ${releaseFormulaPath()}`);
+  console.log(`Restored ${formulaPath}`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argsbarg",
-  "version": "5.1.5",
+  "version": "5.1.6",
   "type": "module",
   "engines": {
     "bun": ">=1.3"

package/examples/full-example/scripts/dev-formula.ts

@@ -1,54 +0,0 @@
-/** Backup, write, and restore the release formula for local dev Homebrew installs. */
-
-import { createHash } from "node:crypto";
-import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { createIdentity } from "./create-identity.ts";
-import { renderDevFormula } from "./formula-shared.ts";
-
-const { key } = createIdentity;
-const root = join(import.meta.dir, "..");
-const stagingDir = join(root, "Formula", ".staging");
-const stagingPath = join(stagingDir, key);
-const formulaPath = join(root, "Formula", `${key}.rb`);
-const backupPath = join(stagingDir, `${key}.rb.bak`);
-
-/** Path to the committed release formula (`Formula/full-example.rb`). */
-export function releaseFormulaPath(): string {
-  return formulaPath;
-}
-
-/** Gitignored backup path used during `install-local`. */
-export function releaseFormulaBackupPath(): string {
-  return backupPath;
-}
-
-/** Copy the release formula to `.staging` before overwriting with the dev formula. */
-export function backupReleaseFormula(): void {
-  if (!existsSync(formulaPath)) {
-    return;
-  }
-  mkdirSync(stagingDir, { recursive: true });
-  copyFileSync(formulaPath, backupPath);
-}
-
-/** Restore the release formula from backup; no-op when no backup exists. */
-export function restoreReleaseFormula(): void {
-  if (!existsSync(backupPath)) {
-    return;
-  }
-  copyFileSync(backupPath, formulaPath);
-  unlinkSync(backupPath);
-}
-
-/** Stage `dist/full-example` and overwrite `Formula/full-example.rb` with a local `file://` dev formula. */
-export function writeDevFormula(): void {
-  const distPath = join(root, "dist", key);
-  mkdirSync(stagingDir, { recursive: true });
-  copyFileSync(distPath, stagingPath);
-  chmodSync(stagingPath, 0o755);
-
-  const sha256 = createHash("sha256").update(readFileSync(stagingPath)).digest("hex");
-  const version = JSON.parse(readFileSync(join(root, "package.json"), "utf8")).version as string;
-  writeFileSync(formulaPath, renderDevFormula(stagingPath, version, sha256), "utf8");
-}

package/examples/full-example/scripts/ensure-release-formula.ts

@@ -1,41 +0,0 @@
-#!/usr/bin/env bun
-/** Normalize `Formula/full-example.rb` to the release layout; recover from a leftover dev formula. */
-
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import {
-  releaseFormulaPath,
-  restoreReleaseFormula,
-  releaseFormulaBackupPath,
-} from "./dev-formula.ts";
-import { renderReleaseFormula } from "./formula-shared.ts";
-
-const formulaPath = releaseFormulaPath();
-const backupPath = releaseFormulaBackupPath();
-
-if (existsSync(backupPath)) {
-  restoreReleaseFormula();
-  console.log(`Restored release formula from ${backupPath}`);
-}
-
-let content = readFileSync(formulaPath, "utf8");
-if (content.includes("file://")) {
-  process.stderr.write(
-    `Dev formula still present at ${formulaPath}. Run: git restore ${formulaPath}\n`,
-  );
-  process.exit(1);
-}
-
-const version = content.match(/^\s*version\s+"([^"]+)"/m)?.[1];
-const sha256 = content.match(/^\s*sha256\s+"([^"]+)"/m)?.[1];
-if (!version || !sha256) {
-  process.stderr.write(`Could not parse version/sha256 from ${formulaPath}\n`);
-  process.exit(1);
-}
-
-const normalized = renderReleaseFormula(version, sha256);
-if (content !== normalized) {
-  writeFileSync(formulaPath, normalized, "utf8");
-  console.log(`Normalized ${formulaPath} (v${version})`);
-} else {
-  console.log(`Release formula OK: ${formulaPath} (v${version})`);
-}

package/examples/full-example/scripts/gen-dev-formula.ts

@@ -1,7 +0,0 @@
-#!/usr/bin/env bun
-/** Generate Formula/full-example.rb for local dev install (file:// URL). Prefer `with-dev-formula.ts` via `just install-local`. */
-
-import { releaseFormulaPath, writeDevFormula } from "./dev-formula.ts";
-
-writeDevFormula();
-console.log(`Wrote ${releaseFormulaPath()}`);