@tallyrelease/cli 0.1.0-beta.6 → 0.1.1-beta.1

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+## 0.1.0 (2026-10-15)
+
+
+### Features
+
+* bootstrap tallyrelease with build selection (v0.1) ([#1](https://github.com/abinnovision/tally-release/issues/1)) ([4efde72](https://github.com/abinnovision/tally-release/commit/4efde72e32091df3c84a2b497272a3a0efdac659))
+* **cli:** align human-readable output and add a local build base ([#8](https://github.com/abinnovision/tally-release/issues/8)) ([96cb5f0](https://github.com/abinnovision/tally-release/commit/96cb5f010f3090806da4317a50c23ba17884c5c5))
+* **cli:** publish the tallyrelease.yaml JSON schema ([#9](https://github.com/abinnovision/tally-release/issues/9)) ([c5b5c94](https://github.com/abinnovision/tally-release/commit/c5b5c946315fdcab2a486cfc2eeef5dd47b6a8f8))
+* **cli:** render the unit graph as mermaid ([#7](https://github.com/abinnovision/tally-release/issues/7)) ([297413a](https://github.com/abinnovision/tally-release/commit/297413a06534b803c5e98e3ee84cb8921bdebdd6))
+* make units build-only unless opted into release ([#6](https://github.com/abinnovision/tally-release/issues/6)) ([4b01768](https://github.com/abinnovision/tally-release/commit/4b0176809d38504eec22e35168f57ca17840ef13))
+
+
+### Bug Fixes
+
+* **cli:** clearer errors and package docs for the 0.1.0 release ([#11](https://github.com/abinnovision/tally-release/issues/11)) ([85fc7ed](https://github.com/abinnovision/tally-release/commit/85fc7ed70693bae01c9b90319d808f72f5eef6f6))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @tallyrelease/core bumped to 0.1.0

package/README.md

@@ -27,13 +27,21 @@ units:
 
 Units are build-only unless opted in with `release: true` (per unit) or `defaults.release: true`.
 
+Tags label units so CI can split the build set by kind:
+
+```yaml
+units:
+  apps/web: { tags: [docker] }
+  packages/api: { release: true, tags: [npm] }
+```
+
 ## Commands
 
 Global flags: `--cwd <dir>` (repository root), `--config <file>` (default `tallyrelease.yaml`), `--token <token>` (forge token, default `GITHUB_TOKEN`), `--verbose`.
 
 - `tallyrelease check` validates config, plugins, units and graph.
 - `tallyrelease graph [--format text|json|mermaid] [--json]` prints units and edges.
-- `tallyrelease affected [--base <ref>] [--format text|json|tsv] [--json] [--out <file>] [--github-output]` computes the build set. `--out` writes the affected document as JSON, `--github-output` appends outputs to `$GITHUB_OUTPUT`.
+- `tallyrelease affected [--base <ref>] [--format text|json|tsv] [--json] [--out <file>] [--github-output] [--tag <tag>]` computes the build set. `--out` writes the affected document as JSON, `--github-output` appends outputs to `$GITHUB_OUTPUT`. `--tag` (repeatable) keeps units with any of the given tags.
 
 Exit codes: `0` ok, `1` error, `2` usage. For scripts use `--format tsv` or `--json`; the text layout may change between versions.
 
@@ -57,6 +65,33 @@ steps:
 
 The job needs `actions: read` for the base lookup.
 
+The `affected` output is a JSON array of `{id, path, plugin, reason, released, tags}` and works as a matrix:
+
+```yaml
+jobs:
+  affected:
+    runs-on: ubuntu-latest
+    outputs:
+      docker: ${{ steps.docker.outputs.affected }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - id: docker
+        run: npx @tallyrelease/cli affected --tag docker --github-output
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+  image:
+    needs: affected
+    if: needs.affected.outputs.docker != '[]'
+    strategy:
+      matrix:
+        unit: ${{ fromJSON(needs.affected.outputs.docker) }}
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "build ${{ matrix.unit.id }} from ${{ matrix.unit.path }}"
+```
+
 ## Editor support
 
 `tallyrelease.yaml` has a JSON schema for completion and validation in editors using the YAML language server. Add one of these modelines as the first line.

package/dist/affected-schema.d.ts

@@ -31,6 +31,8 @@ export declare const affectedDocSchema: z.ZodObject<{
             all: "all";
         }>;
         via: z.ZodArray<z.ZodString>;
+        released: z.ZodBoolean;
+        tags: z.ZodArray<z.ZodString>;
     }, z.core.$strict>>;
     unattributed: z.ZodArray<z.ZodString>;
     warnings: z.ZodArray<z.ZodObject<{

package/dist/affected-schema.js

@@ -27,6 +27,8 @@ export const affectedDocSchema = z.strictObject({
         plugin: z.string(),
         reason,
         via: z.array(z.string()),
+        released: z.boolean(),
+        tags: z.array(z.string()),
     })),
     unattributed: z.array(z.string()),
     warnings: z.array(z.strictObject({

package/dist/affected.schema.json

@@ -85,6 +85,15 @@
 						"items": {
 							"type": "string"
 						}
+					},
+					"released": {
+						"type": "boolean"
+					},
+					"tags": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						}
 					}
 				},
 				"required": [
@@ -92,7 +101,9 @@
 					"path",
 					"plugin",
 					"reason",
-					"via"
+					"via",
+					"released",
+					"tags"
 				],
 				"additionalProperties": false
 			}

package/dist/ci/outputs.js

@@ -5,7 +5,7 @@ const multiline = (key, value) => {
 };
 /** `$GITHUB_OUTPUT` entries of `affected`; units are ordered by id. */
 export const affectedGithubOutput = (doc) => [
-    `affected=${JSON.stringify(doc.units.map(({ id, path, reason }) => ({ id, path, reason })))}\n`,
+    `affected=${JSON.stringify(doc.units.map(({ id, path, plugin, reason, released, tags }) => ({ id, path, plugin, reason, released, tags })))}\n`,
     multiline("affected-paths", doc.units.map((u) => u.path).join("\n")),
     `all=${String(doc.build.all)}\n`,
     `base=${doc.build.base ?? ""}\n`,

package/dist/commands/affected.d.ts

@@ -5,6 +5,8 @@ export interface AffectedFlags {
     json?: boolean;
     out?: string;
     githubOutput?: boolean;
+    /** Keeps units with at least one of these tags. */
+    tag?: string[];
 }
 /** Computes the build set and writes the requested outputs. */
 export declare const affected: (session: Session, flags: AffectedFlags) => Promise<void>;

package/dist/commands/affected.js

@@ -32,8 +32,15 @@ const baseLabel = (base) => {
     }
 };
 const tsv = (doc) => [
-    "id\tpath\treason\tvia",
-    ...doc.units.map((u) => [u.id, u.path, u.reason, u.via.join(",")].join("\t")),
+    "id\tpath\treason\tvia\treleased\ttags",
+    ...doc.units.map((u) => [
+        u.id,
+        u.path,
+        u.reason,
+        u.via.join(","),
+        String(u.released),
+        u.tags.join(","),
+    ].join("\t")),
 ]
     .map((line) => `${line}\n`)
     .join("");
@@ -60,9 +67,19 @@ export const affected = async (session, flags) => {
         base: base.base,
         baseSource: base.source,
     });
+    const tags = new Set(flags.tag ?? []);
+    const known = new Set(workspace.units.flatMap((u) => u.tags));
+    const unknownTags = [...tags]
+        .filter((t) => !known.has(t))
+        .map((t) => ({
+        code: "W_TAG_UNKNOWN",
+        message: `no unit has tag "${t}"`,
+    }));
+    const selected = (u) => tags.size === 0 || u.tags.some((t) => tags.has(t));
     const doc = {
         ...computed,
-        warnings: [...computed.warnings, ...base.warnings],
+        units: computed.units.filter(selected),
+        warnings: [...computed.warnings, ...base.warnings, ...unknownTags],
     };
     session.warn(doc.warnings);
     const json = `${JSON.stringify(doc, null, 2)}\n`;
@@ -86,12 +103,11 @@ export const affected = async (session, flags) => {
         return;
     }
     const paint = painter(session.stdout);
-    const released = new Set(workspace.units.filter((u) => u.version !== "none").map((u) => u.id));
     const rows = alignColumns(doc.units.map((u) => [
         u.id,
         u.path,
         u.via.length > 0 ? `via ${u.via.join(", ")}` : "",
-        released.has(u.id) ? "released" : "",
+        u.released ? "released" : "",
     ]), { indent: 2, styles: [undefined, "dim", "dim", "cyan"] }, paint);
     const sha = doc.build.base?.slice(0, 7) ?? "none";
     const lines = [
@@ -115,7 +131,7 @@ export const affected = async (session, flags) => {
         ? `, ${count(doc.unattributed.length, "file")} outside any unit`
         : "";
     lines.push(doc.units.length > 0
-        ? `${String(doc.units.length)} of ${count(workspace.units.length, "unit")} affected${outside}`
+        ? `${String(doc.units.length)} of ${count(workspace.units.filter(selected).length, "unit")} affected${outside}`
         : `no units affected${outside}`);
     session.stdout.write(`${lines.join("\n")}\n`);
 };

package/dist/commands/graph.js

@@ -12,6 +12,7 @@ export const graph = async (session, flags) => {
         path: u.root,
         plugin: u.plugin,
         version: u.version,
+        tags: [...u.tags],
     }));
     const edges = workspace.graph.edges.map((e) => ({
         from: e.from,
@@ -33,13 +34,15 @@ export const graph = async (session, flags) => {
         return;
     }
     const paint = painter(session.stdout);
+    const tagged = units.some((u) => u.tags.length > 0);
     const table = [
-        ["UNIT", "PATH", "PLUGIN", "RELEASE"],
+        ["UNIT", "PATH", "PLUGIN", "RELEASE", ...(tagged ? ["TAGS"] : [])],
         ...units.map((u) => [
             u.id,
             u.path,
             u.plugin,
             u.version === "none" ? "-" : u.version,
+            ...(tagged ? [u.tags.join(",")] : []),
         ]),
     ];
     // Header is aligned unstyled so column styles do not apply to it.

package/dist/config/schema.d.ts

@@ -28,6 +28,7 @@ export declare const configSchema: z.ZodObject<{
             patch: "patch";
             rebuild: "rebuild";
         }>>;
+        tags: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>>;
     deps: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
         from: z.ZodString;
@@ -70,6 +71,7 @@ export declare const configJsonSchema: () => {
                 patch: "patch";
                 rebuild: "rebuild";
             }>>;
+            tags: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>>;
         deps: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
             from: z.ZodString;

package/dist/config/schema.js

@@ -41,6 +41,12 @@ const unitOverlay = z.strictObject({
         .exactOptional(),
     tagFormat: tagFormat.exactOptional(),
     propagate: propagate.exactOptional(),
+    tags: z
+        .array(z.string().regex(/^[A-Za-z0-9._-]+$/))
+        .meta({
+        description: "Labels for filtering with affected --tag (letters, digits, dot, underscore, dash), for example docker or npm.",
+    })
+        .exactOptional(),
 });
 /** Schema of `tallyrelease.yaml`. */
 export const configSchema = z.strictObject({

package/dist/main.js

@@ -55,6 +55,7 @@ export const main = async (argv, deps) => {
     ]))
         .option("--out <file>", "write the affected document to a file")
         .option("--github-output", "append outputs to $GITHUB_OUTPUT")
+        .option("--tag <tag>", "keep units with this tag (repeatable)", (tag, prior) => [...(prior ?? []), tag])
         .action(async (flags, cmd) => {
         if (flags.json && flags.format !== undefined) {
             cmd.error("--json and --format cannot be combined", { exitCode: 2 });

package/dist/tallyrelease.schema.json

@@ -106,6 +106,14 @@
 							"rebuild"
 						],
 						"description": "Policy for this unit when a dependency is released: patch (at least a patch bump), rebuild (rebuild only) or auto (patch if the edge is pinned, else rebuild)."
+					},
+					"tags": {
+						"type": "array",
+						"items": {
+							"type": "string",
+							"pattern": "^[A-Za-z0-9._-]+$"
+						},
+						"description": "Labels for filtering with affected --tag (letters, digits, dot, underscore, dash), for example docker or npm."
 					}
 				},
 				"additionalProperties": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyrelease/cli",
-  "version": "0.1.0-beta.6",
+  "version": "0.1.1-beta.1",
   "description": "Command line interface of tallyrelease",
   "repository": {
     "type": "git",
@@ -48,7 +48,7 @@
   "prettier": "@abinnovision/prettier-config",
   "dependencies": {
     "@octokit/rest": "^22.0.1",
-    "@tallyrelease/core": "^0.1.0-beta.4",
+    "@tallyrelease/core": "^0.1.1-beta.1",
     "commander": "^15.0.0",
     "tinyglobby": "^0.2.17",
     "yaml": "^2.9.1",
@@ -58,14 +58,14 @@
     "@abinnovision/eslint-config-base": "^3.4.2",
     "@abinnovision/prettier-config": "^2.2.0",
     "@internal/tsconfig": "0.0.0",
-    "@types/node": "^24.0.0",
-    "@vitest/coverage-v8": "^5.0.3",
+    "@types/node": "^24.19.2",
+    "@vitest/coverage-v8": "^5.0.4",
     "ajv": "^8.20.0",
     "eslint": "^10.12.0",
-    "prettier": "^3.9.9",
+    "prettier": "^3.9.10",
     "typescript": "^6.0.3",
     "vite": "^8.3.4",
-    "vitest": "^5.0.3"
+    "vitest": "^5.0.4"
   },
   "engines": {
     "node": ">=24"