actions-up 1.4.2 → 1.6.0

package/dist/cli/index.js

@@ -11,11 +11,11 @@ import pc from "picocolors";
 import cac from "cac";
 function run() {
 	let l = cac("actions-up");
-	l.help().version(version).option("--dry-run", "Preview changes without applying them").option("--exclude <regex>", "Exclude actions by regex (repeatable)").option("--yes, -y", "Skip all confirmations").command("", "Update GitHub Actions").action(async (s) => {
+	l.help().version(version).option("--dir <directory>", "Custom directory name (default: .github)").option("--dry-run", "Preview changes without applying them").option("--exclude <regex>", "Exclude actions by regex (repeatable)").option("--min-age <days>", "Minimum age in days for updates (default: 0)", { default: 0 }).option("--yes, -y", "Skip all confirmations").command("", "Update GitHub Actions").action(async (s) => {
 		console.info(pc.cyan("\n🚀 Actions Up!\n"));
 		let c = createSpinner("Scanning GitHub Actions...").start();
 		try {
-			let l = await scanGitHubActions(process.cwd()), u = l.actions.length, d = l.workflows.size, f = l.compositeActions.size;
+			let l = await scanGitHubActions(process.cwd(), s.dir), u = l.actions.length, d = l.workflows.size, f = l.compositeActions.size;
 			if (c.success(`Found ${pc.yellow(u)} actions in ${pc.yellow(d)} workflows and ${pc.yellow(f)} composite actions`), u === 0) {
 				console.info(pc.green("\n✨ No GitHub Actions found in this repository"));
 				return;
@@ -39,12 +39,14 @@ function run() {
 			await Promise.all(g.map(async (e) => {
 				await shouldIgnore(e.action.file, e.action.line) || _.push(e);
 			}));
-			let v = _.filter((e) => e.hasUpdate), y = v.filter((e) => e.isBreaking);
+			let v = _.filter((e) => e.hasUpdate), y = s.minAge * 24 * 60 * 60 * 1e3, b = Date.now();
+			v = v.filter((e) => e.publishedAt ? b - e.publishedAt.getTime() >= y : !0);
+			let x = v.filter((e) => e.isBreaking);
 			if (v.length === 0) {
 				c.success("All actions are up to date!"), console.info(pc.green("\n✨ Everything is already at the latest version!\n"));
 				return;
 			}
-			if (c.success(`Found ${pc.yellow(v.length)} updates available${y.length > 0 ? ` (${pc.redBright(y.length)} breaking)` : ""}`), s.dryRun) {
+			if (c.success(`Found ${pc.yellow(v.length)} updates available${x.length > 0 ? ` (${pc.redBright(x.length)} breaking)` : ""}`), s.dryRun) {
 				console.info(pc.yellow("\n📋 Dry Run - No changes will be made\n"));
 				for (let e of v) console.info(`${pc.cyan(e.action.file ?? "unknown")}:\n${e.action.name}: ${pc.redBright(e.currentVersion)} → ${pc.green(e.latestVersion)} ${e.latestSha ? pc.gray(`(${e.latestSha.slice(0, 7)})`) : ""}\n`);
 				console.info(pc.gray(`\n${v.length} actions would be updated\n`));
@@ -58,7 +60,7 @@ function run() {
 				}
 				console.info(pc.yellow(`\n🔄 Updating ${e.length} actions...\n`)), await applyUpdates(e), console.info(pc.green("\n✓ Updates applied successfully!"));
 			} else {
-				let o = await promptUpdateSelection(_);
+				let o = await promptUpdateSelection(_, { showAge: s.minAge > 0 });
 				if (!o || o.length === 0) {
 					console.info(pc.gray("\nNo updates applied"));
 					return;

package/dist/core/api/check-updates.js

@@ -1,187 +1,206 @@
 import { createGitHubClient } from "./create-github-client.js";
 import semver from "semver";
-async function checkUpdates(r, a) {
-	let c = createGitHubClient(a), l = r.filter((e) => e.type === "external");
+async function checkUpdates(n, i) {
+	let c = createGitHubClient(i), l = n.filter((e) => e.type === "external" || e.type === "reusable-workflow");
 	if (l.length === 0) return [];
 	let u = /* @__PURE__ */ new Map();
 	for (let e of l) {
-		let n = u.get(e.name) ?? [];
-		n.push(e), u.set(e.name, n);
+		let t = u.get(e.name) ?? [];
+		t.push(e), u.set(e.name, t);
 	}
 	let d = {
 		rateLimitError: null,
 		rateLimitHit: !1
-	}, f = await [...u.keys()].reduce((e, r) => e.then(async (e) => {
+	}, f = await [...u.keys()].reduce((e, n) => e.then(async (e) => {
 		if (d.rateLimitHit) return [...e, {
+			publishedAt: null,
 			version: null,
-			actionName: r,
+			actionName: n,
 			sha: null
 		}];
-		let i = r.split("/");
-		if (i.length < 2) return [...e, {
+		let r = n.split("/");
+		if (r.length < 2) return [...e, {
+			publishedAt: null,
 			version: null,
-			actionName: r,
+			actionName: n,
 			sha: null
 		}];
-		let [a, l] = i;
-		if (!a || !l) return [...e, {
+		let [i, l] = r;
+		if (!i || !l) return [...e, {
+			publishedAt: null,
 			version: null,
-			actionName: r,
+			actionName: n,
 			sha: null
 		}];
 		try {
-			let i = u.get(r)[0]?.version;
-			if (i && !isSha(i) && !isSemverLike(i) && await c.getRefType(a, l, i) === "branch") return [...e, {
+			let r = u.get(n)[0]?.version;
+			if (r && !isSha(r) && !isSemverLike(r) && await c.getRefType(i, l, r) === "branch") return [...e, {
+				publishedAt: null,
 				version: null,
-				actionName: r,
+				actionName: n,
 				sha: null
 			}];
-			let d = await c.getLatestRelease(a, l);
+			let d = await c.getLatestRelease(i, l);
 			if (!d) {
-				let e = await c.getAllReleases(a, l, 1);
+				let e = await c.getAllReleases(i, l, 1);
 				d = e.find((e) => !e.isPrerelease) ?? e[0] ?? null;
 			}
 			if (d) {
-				let { version: i, sha: o } = d, u = !1;
+				let { publishedAt: r, version: o, sha: u } = d, f = !1;
 				{
-					let e = normalizeVersion(i), r = !!(i && i.trim() !== ""), a = r && /^v?\d+$/u.test(i.trim()), o = semver.valid(e);
-					u = !r || a || !o;
+					let e = normalizeVersion(o), n = !!(o && o.trim() !== ""), r = n && /^v?\d+$/u.test(o.trim()), i = semver.valid(e);
+					f = !n || r || !i;
 				}
-				if (u) {
-					let o = await c.getAllTags(a, l, 30);
-					if (o.length > 0) {
-						let u = o.filter((e) => isSemverLike(e.tag)).map((e) => ({
+				if (f) {
+					let r = await c.getAllTags(i, l, 30);
+					if (r.length > 0) {
+						let u = r.filter((e) => isSemverLike(e.tag)).map((e) => ({
 							v: semver.valid(normalizeVersion(e.tag)),
 							raw: e
 						}));
 						if (u.length > 0) {
-							u.sort((e, r) => {
-								let i = semver.rcompare(e.v, r.v);
-								if (i !== 0) return i;
-								let a = /\d+\.\d+/u.test(e.raw.tag) ? 1 : 0;
-								return (/\d+\.\d+/u.test(r.raw.tag) ? 1 : 0) - a;
+							u.sort((e, n) => {
+								let r = semver.rcompare(e.v, n.v);
+								if (r !== 0) return r;
+								let i = /\d+\.\d+/u.test(e.raw.tag) ? 1 : 0;
+								return (/\d+\.\d+/u.test(n.raw.tag) ? 1 : 0) - i;
 							});
-							let o = u[0].raw, s = semver.valid(normalizeVersion(i) ?? void 0);
-							if (!s || semver.gt(u[0].v, s) || semver.eq(u[0].v, s) && /\d+\.\d+/u.test(o.tag)) {
-								let n = o.tag, i = o.sha?.length ? o.sha : null;
-								if (!i && n) try {
-									i = await c.getTagSha(a, l, n);
+							let r = u[0].raw, s = semver.valid(normalizeVersion(o) ?? void 0);
+							if (!s || semver.gt(u[0].v, s) || semver.eq(u[0].v, s) && /\d+\.\d+/u.test(r.tag)) {
+								let t = r.tag, a = r.sha?.length ? r.sha : null;
+								if (!a && t) try {
+									a = await c.getTagSha(i, l, t);
 								} catch {}
 								return [...e, {
-									version: n,
-									sha: i,
-									actionName: r
+									version: t,
+									publishedAt: null,
+									sha: a,
+									actionName: n
 								}];
 							}
 						}
 					}
 				}
-				if (!o && i) try {
-					o = await c.getTagSha(a, l, i);
+				if (!u && o) try {
+					u = await c.getTagSha(i, l, o);
 				} catch {}
 				return [...e, {
-					actionName: r,
-					version: i,
-					sha: o
+					publishedAt: r,
+					actionName: n,
+					version: o,
+					sha: u
 				}];
 			}
-			let f = await c.getAllTags(a, l, 30);
+			let f = await c.getAllTags(i, l, 30);
 			if (f.length > 0) {
-				let i = f.filter((e) => isSemverLike(e.tag)).map((e) => ({
+				let r = f.filter((e) => isSemverLike(e.tag)).map((e) => ({
 					v: semver.valid(normalizeVersion(e.tag)),
 					raw: e
 				})), o;
-				i.length > 0 ? (i.sort((e, r) => {
-					let i = semver.rcompare(e.v, r.v);
-					if (i !== 0) return i;
-					let a = /\d+\.\d+/u.test(e.raw.tag) ? 1 : 0;
-					return (/\d+\.\d+/u.test(r.raw.tag) ? 1 : 0) - a;
-				}), o = i[0].raw) : o = f[0];
+				r.length > 0 ? (r.sort((e, n) => {
+					let r = semver.rcompare(e.v, n.v);
+					if (r !== 0) return r;
+					let i = /\d+\.\d+/u.test(e.raw.tag) ? 1 : 0;
+					return (/\d+\.\d+/u.test(n.raw.tag) ? 1 : 0) - i;
+				}), o = r[0].raw) : o = f[0];
 				let u = o.tag, d = o.sha?.length ? o.sha : null;
 				if (!d && u) try {
-					d = await c.getTagSha(a, l, u);
+					d = await c.getTagSha(i, l, u);
 				} catch {}
 				return [...e, {
-					actionName: r,
+					publishedAt: null,
+					actionName: n,
 					version: u,
 					sha: d
 				}];
 			}
 			return [...e, {
+				publishedAt: null,
 				version: null,
-				actionName: r,
+				actionName: n,
 				sha: null
 			}];
-		} catch (n) {
-			return n instanceof Error && n.name === "GitHubRateLimitError" ? (d.rateLimitHit = !0, d.rateLimitError = n, [...e, {
+		} catch (t) {
+			return t instanceof Error && t.name === "GitHubRateLimitError" ? (d.rateLimitHit = !0, d.rateLimitError = t, [...e, {
+				publishedAt: null,
 				version: null,
-				actionName: r,
+				actionName: n,
 				sha: null
-			}]) : (console.warn(`Failed to check ${r}:`, n), [...e, {
+			}]) : (console.warn(`Failed to check ${n}:`, t), [...e, {
+				publishedAt: null,
 				version: null,
-				actionName: r,
+				actionName: n,
 				sha: null
 			}]);
 		}
 	}), Promise.resolve([]));
 	if (d.rateLimitError) {
-		let e = !!(a ?? process.env.GITHUB_TOKEN), n = `${d.rateLimitError.message || "GitHub API rate limit exceeded."}\n${e ? "Wait for reset or reduce request rate." : "Please set GITHUB_TOKEN environment variable to increase the limit.\nSee: https://github.com/azat-io/actions-up?tab=readme-ov-file#using-github-token-for-higher-rate-limits"}`, r = Error(n);
-		throw r.name = "GitHubRateLimitError", r;
+		let e = !!(i ?? process.env.GITHUB_TOKEN), t = `${d.rateLimitError.message || "GitHub API rate limit exceeded."}\n${e ? "Wait for reset or reduce request rate." : "Please set GITHUB_TOKEN environment variable to increase the limit.\nSee: https://github.com/azat-io/actions-up?tab=readme-ov-file#using-github-token-for-higher-rate-limits"}`, n = Error(t);
+		throw n.name = "GitHubRateLimitError", n;
 	}
 	let p = /* @__PURE__ */ new Map();
 	for (let e of f) p.set(e.actionName, {
+		publishedAt: e.publishedAt,
 		version: e.version,
 		sha: e.sha
 	});
 	let m = [];
 	for (let e of l) {
-		let n = p.get(e.name);
-		n ? m.push(createUpdate(e, n.version, n.sha)) : m.push(createUpdate(e, null, null));
+		let t = p.get(e.name);
+		t ? m.push(createUpdate(e, {
+			publishedAt: t.publishedAt,
+			version: t.version,
+			sha: t.sha
+		})) : m.push(createUpdate(e, {
+			publishedAt: null,
+			version: null,
+			sha: null
+		}));
 	}
 	return m;
 }
-function createUpdate(e, r, i) {
-	let s = normalizeVersion(e.version ?? ""), c = r ? normalizeVersion(r) : null, l = !1, u = !1;
-	if (s && isSha(s)) i ? l = !compareSha(s, i) : c && (l = !0);
-	else if (s && c) {
-		let r = semver.valid(s), a = semver.valid(c);
-		if (r && a) {
-			if (l = semver.lt(r, a), l) {
-				let e = semver.major(r);
-				u = semver.major(a) > e;
+function createUpdate(e, n) {
+	let { version: r, sha: s, publishedAt: c } = n, l = normalizeVersion(e.version ?? ""), u = r ? normalizeVersion(r) : null, d = !1, f = !1;
+	if (l && isSha(l)) s ? d = !compareSha(l, s) : u && (d = !0);
+	else if (l && u) {
+		let n = semver.valid(l), r = semver.valid(u);
+		if (n && r) {
+			if (d = semver.lt(n, r), d) {
+				let e = semver.major(n);
+				f = semver.major(r) > e;
 			}
-			!l && semver.eq(r, a) && !isSha(e.version) && i && (l = !0, u = !1);
-		} else s !== c && (l = !0);
+			!d && semver.eq(n, r) && !isSha(e.version) && s && (d = !0, f = !1);
+		} else l !== u && (d = !0);
 	}
 	return {
 		currentVersion: e.version ?? "unknown",
 		latestVersion: r,
-		isBreaking: u,
-		latestSha: i,
-		hasUpdate: l,
+		publishedAt: c,
+		isBreaking: f,
+		latestSha: s,
+		hasUpdate: d,
 		action: e
 	};
 }
-function compareSha(e, n) {
-	if (!e || !n) return !1;
-	let r = e.replace(/^v/u, ""), i = n.replace(/^v/u, ""), a = Math.min(r.length, i.length);
-	return a < 7 ? !1 : r.slice(0, Math.max(0, a)).toLowerCase() === i.slice(0, Math.max(0, a)).toLowerCase();
+function compareSha(e, t) {
+	let n = e.replace(/^v/u, ""), r = t.replace(/^v/u, ""), i = Math.min(n.length, r.length);
+	return i < 7 ? !1 : n.slice(0, Math.max(0, i)).toLowerCase() === r.slice(0, Math.max(0, i)).toLowerCase();
 }
 function normalizeVersion(e) {
 	if (!e) return null;
-	let r = e.replace(/^v/u, "");
-	if (/^[0-9a-f]{7,40}$/iu.test(r)) return e;
-	let i = semver.coerce(r);
-	return i ? i.version : e;
+	let n = e.replace(/^v/u, "");
+	if (/^[0-9a-f]{7,40}$/iu.test(n)) return e;
+	let r = semver.coerce(n);
+	return r ? r.version : e;
 }
 function isSha(e) {
 	if (!e) return !1;
-	let n = e.replace(/^v/u, "");
-	return /^[0-9a-f]{7,40}$/iu.test(n);
+	let t = e.replace(/^v/u, "");
+	return /^[0-9a-f]{7,40}$/iu.test(t);
 }
 function isSemverLike(e) {
 	if (!e) return !1;
-	let n = e.trim();
-	return /^v?\d+(?:\.\d+){0,2}$/u.test(n);
+	let t = e.trim();
+	return /^v?\d+(?:\.\d+){0,2}$/u.test(t);
 }
 export { checkUpdates };

package/dist/core/ast/scanners/scan-composite-action-ast.js

@@ -11,6 +11,10 @@ function scanCompositeActionAst(a, o, s) {
 	let u = c.runs;
 	if (!u || !isCompositeActionRuns(u) || !u.steps || !Array.isArray(u.steps)) return [];
 	let d = findMapPair(l.value, "steps");
-	return d?.value ? extractUsesFromSteps(d.value, s, o) : [];
+	return d?.value ? extractUsesFromSteps({
+		stepsNode: d.value,
+		filePath: s,
+		content: o
+	}) : [];
 }
 export { scanCompositeActionAst };

package/dist/core/ast/scanners/scan-workflow-ast.d.ts

@@ -4,7 +4,8 @@ import { GitHubAction } from '../../../types/github-action';
  * Scans a parsed workflow YAML document for action references.
  *
  * Navigates AST structure `jobs -> <job> -> steps` and extracts `uses` entries
- * with corresponding line numbers.
+ * with corresponding line numbers. Also scans for job-level `uses` fields that
+ * indicate Reusable Workflows.
  *
  * @param document - Parsed YAML document of a workflow file.
  * @param content - Original file content.

package/dist/core/ast/scanners/scan-workflow-ast.js

@@ -1,19 +1,32 @@
 import { isWorkflowStructure } from "../../schema/workflow/is-workflow-structure.js";
+import { parseActionReference } from "../../parsing/parse-action-reference.js";
+import { getLineNumberForKey } from "../utils/get-line-number.js";
 import { isYAMLMap } from "../guards/is-yaml-map.js";
+import { isScalar } from "../guards/is-scalar.js";
 import { isNode } from "../guards/is-node.js";
 import { isPair } from "../guards/is-pair.js";
 import { extractUsesFromSteps } from "../utils/extract-uses-from-steps.js";
 import { findMapPair } from "../utils/find-map-pair.js";
-function scanWorkflowAst(o, s, c) {
-	if (!isWorkflowStructure(o.toJSON()) || !o.contents || !isYAMLMap(o.contents)) return [];
-	let l = findMapPair(o.contents, "jobs");
-	if (!l?.value || !isYAMLMap(l.value)) return [];
-	let u = [];
-	for (let e of l.value.items) {
+function scanWorkflowAst(l, u, d) {
+	if (!isWorkflowStructure(l.toJSON()) || !l.contents || !isYAMLMap(l.contents)) return [];
+	let f = findMapPair(l.contents, "jobs");
+	if (!f?.value || !isYAMLMap(f.value)) return [];
+	let p = [];
+	for (let e of f.value.items) {
 		if (!isPair(e) || !e.value || !isNode(e.value) || !isYAMLMap(e.value)) continue;
-		let o = findMapPair(e.value, "steps");
-		o?.value && u.push(...extractUsesFromSteps(o.value, c, s));
+		let l = isScalar(e.key) ? String(e.key.value) : void 0, f = findMapPair(e.value, "uses");
+		if (f?.value && f.key && isScalar(f.value)) {
+			let e = parseActionReference(String(f.value.value), d, getLineNumberForKey(u, f.key));
+			e && (l && (e.job = l), p.push(e));
+		}
+		let m = findMapPair(e.value, "steps");
+		m?.value && p.push(...extractUsesFromSteps({
+			stepsNode: m.value,
+			filePath: d,
+			content: u,
+			jobName: l
+		}));
 	}
-	return u;
+	return p;
 }
 export { scanWorkflowAst };

package/dist/core/ast/update/apply-updates.js

@@ -27,7 +27,7 @@ async function applyUpdates(n) {
 				console.error(`Invalid SHA format: ${e.latestSha}`);
 				continue;
 			}
-			let a = r ? String.raw`(?=[^\S\r\n]|$|#)` : "", o = RegExp(`(^\\s*-?\\s*uses:\\s*)(['"]?)(${n})@${r}\\2${a}([^\\S\\r\\n]*#[^\\r\\n]*)?`, "gm"), s = `$1$2$3@${e.latestSha}$2 # ${e.latestVersion}`;
+			let a = r ? String.raw`(?=[^\S\r\n]|$|#)` : "", o = new RegExp(String.raw`(^\s*-?\s*uses:\s*)(['"]?)(${n})@${r}\2${a}([^\S\r\n]*#[^\r\n]*)?`, "gm"), s = `$1$2$3@${e.latestSha}$2 # ${e.latestVersion}`;
 			i = i.replace(o, s);
 		}
 		await writeFile(n, i, "utf8");

package/dist/core/ast/utils/extract-uses-from-steps.d.ts

@@ -1,13 +1,22 @@
 import { GitHubAction } from '../../../types/github-action';
+interface ExtractUsesOptions {
+    /** YAML sequence node containing workflow/action steps. */
+    stepsNode: unknown;
+    /** Path of the file being scanned (for metadata). */
+    filePath: string;
+    /** Name of the job containing these steps (for workflows). */
+    jobName?: string;
+    /** Original YAML file content (for line number calculation). */
+    content: string;
+}
 /**
  * Extracts GitHub Action references from a steps YAML sequence.
  *
  * Uses the AST to locate the 'uses' key for precise line numbers and the JSON
  * representation to validate the presence and type of the 'uses' field.
  *
- * @param stepsNode - YAML sequence node containing workflow/action steps.
- * @param filePath - Path of the file being scanned (for metadata).
- * @param content - Original YAML file content (for line number calculation).
+ * @param options - Options for extraction.
  * @returns List of discovered GitHub actions.
  */
-export declare function extractUsesFromSteps(stepsNode: unknown, filePath: string, content: string): GitHubAction[];
+export declare function extractUsesFromSteps(options: ExtractUsesOptions): GitHubAction[];
+export {};

package/dist/core/ast/utils/extract-uses-from-steps.js

@@ -5,18 +5,19 @@ import { isYAMLMap } from "../guards/is-yaml-map.js";
 import { isScalar } from "../guards/is-scalar.js";
 import { isNode } from "../guards/is-node.js";
 import { isPair } from "../guards/is-pair.js";
-function extractUsesFromSteps(s, c, l) {
-	if (!isYAMLSequence(s)) return [];
-	let u = [];
-	for (let o of s.items) {
+function extractUsesFromSteps(s) {
+	let { stepsNode: c, filePath: l, content: u, jobName: d } = s;
+	if (!isYAMLSequence(c)) return [];
+	let f = [];
+	for (let o of c.items) {
 		if (!isYAMLMap(o) || !isNode(o)) continue;
 		let s = o.toJSON();
 		if (typeof s != "object" || !s || Array.isArray(s)) continue;
-		let d = s;
-		if (typeof d.uses != "string") continue;
-		let f = o.items.find((e) => isPair(e) && isScalar(e.key) && e.key.value === "uses"), p = f?.key ? getLineNumberForKey(l, f.key) : 0, m = parseActionReference(d.uses, c, p);
-		m && u.push(m);
+		let c = s;
+		if (typeof c.uses != "string") continue;
+		let p = o.items.find((e) => isPair(e) && isScalar(e.key) && e.key.value === "uses"), m = p?.key ? getLineNumberForKey(u, p.key) : 0, h = parseActionReference(c.uses, l, m);
+		h && (d && (h.job = d), f.push(h));
 	}
-	return u;
+	return f;
 }
 export { extractUsesFromSteps };

package/dist/core/interactive/prompt-update-selection.d.ts

@@ -1,2 +1,7 @@
 import { ActionUpdate } from '../../types/action-update';
-export declare function promptUpdateSelection(updates: ActionUpdate[]): Promise<ActionUpdate[] | null>;
+interface PromptUpdateSelectionOptions {
+    /** Whether to show the Age column. */
+    showAge?: boolean;
+}
+export declare function promptUpdateSelection(updates: ActionUpdate[], options?: PromptUpdateSelectionOptions): Promise<ActionUpdate[] | null>;
+export {};

package/dist/core/interactive/prompt-update-selection.js

@@ -7,99 +7,118 @@ import pc from "picocolors";
 import { readFile } from "node:fs/promises";
 import enquirer from "enquirer";
 import path from "node:path";
-var MIN_ACTION_WIDTH = 56, MIN_CURRENT_WIDTH = 16;
-async function promptUpdateSelection(o) {
-	if (o.length === 0) return null;
-	let c = o.filter((e) => e.hasUpdate);
-	if (c.length === 0) return console.info(pc.green("✓ All actions are up to date!")), null;
-	let p = /* @__PURE__ */ new Map();
-	for (let [e, a] of c.entries()) {
-		let o = a.action.file ?? "unknown file", s = path.relative(path.join(process.cwd(), GITHUB_DIRECTORY), o);
-		s === "" && (s = o);
-		let c = p.get(s) ?? [];
-		c.push({
-			update: a,
+var MIN_ACTION_WIDTH = 40, MIN_JOB_WIDTH = 4, MIN_CURRENT_WIDTH = 16, MAX_VERSION_WIDTH = 7;
+async function promptUpdateSelection(l, g = {}) {
+	let { showAge: y = !1 } = g;
+	if (l.length === 0) return null;
+	let b = l.filter((e) => e.hasUpdate);
+	if (b.length === 0) return console.info(pc.green("✓ All actions are up to date!")), null;
+	let x = /* @__PURE__ */ new Map();
+	for (let [e, o] of b.entries()) {
+		let s = o.action.file ?? "unknown file", c = path.relative(path.join(process.cwd(), GITHUB_DIRECTORY), s);
+		c === "" && (c = s);
+		let l = x.get(c) ?? [];
+		l.push({
+			update: o,
 			index: e
-		}), p.set(s, c);
+		}), x.set(c, l);
 	}
-	let g = await Promise.all(c.map(async (e) => {
-		let i = formatVersionOrSha(e.currentVersion), a = e.currentVersion ?? void 0;
+	let S = await Promise.all(b.map(async (e) => {
+		let a = formatVersionOrSha(e.currentVersion), o = e.currentVersion ?? void 0, s = null, c = null;
 		if (!e.currentVersion || !isSha(e.currentVersion)) return {
-			effectiveForDiff: a,
-			display: i
+			versionForPadding: s,
+			effectiveForDiff: o,
+			shortSha: c,
+			display: a
 		};
-		let o = await tryReadInlineVersionComment(e.action.file, e.action.line);
-		if (o) {
-			let c = e.currentVersion.slice(0, 7);
-			i = `${formatVersionOrSha(o)} ${pc.gray(`(${c})`)}`, a = o;
-		}
-		return {
-			effectiveForDiff: a,
-			display: i
+		let l = await tryReadInlineVersionComment(e.action.file, e.action.line);
+		return l && (c = e.currentVersion.slice(0, 7), s = formatVersionOrSha(l), a = s, o = l), {
+			versionForPadding: s,
+			effectiveForDiff: o,
+			shortSha: c,
+			display: a
 		};
-	})), _ = [], v = stripAnsi("Action").length, y = stripAnsi("Current").length;
-	for (let [e, i] of c.entries()) {
-		let o = i.action.name, s = g[e].display;
-		v = Math.max(v, o.length), y = Math.max(y, stripAnsi(s).length);
+	})), C = [], w = stripAnsi("Action").length, T = stripAnsi("Current").length, E = stripAnsi("Job").length, D = 0, O = !1;
+	for (let [a, s] of b.entries()) {
+		let c = s.action.name, l = S[a].display, u = s.action.job ?? "–";
+		if (w = Math.max(w, c.length), T = Math.max(T, stripAnsi(l).length), E = Math.max(E, u.length), s.latestVersion) {
+			let c = formatVersion(s.latestVersion, S[a]?.effectiveForDiff ?? s.currentVersion);
+			D = Math.max(D, stripAnsi(c).length);
+		}
+		let d = S[a]?.versionForPadding;
+		d && (D = Math.max(D, stripAnsi(d).length)), s.publishedAt && (O = !0);
 	}
-	let b = Math.max(v, MIN_ACTION_WIDTH), x = Math.max(y, MIN_CURRENT_WIDTH), S = [...p.keys()].toSorted();
-	for (let [i, a] of S.entries()) {
-		let o = p.get(a);
-		if (!o) {
-			console.warn(`Unexpected missing group for file: ${a}`);
+	let k = Math.max(w, MIN_ACTION_WIDTH), A = Math.max(T, MIN_CURRENT_WIDTH), j = Math.max(E, MIN_JOB_WIDTH), M = Math.min(D, MAX_VERSION_WIDTH), N = M + 1 + 9, P = y && O ? 6 : 0, F = [...x.keys()].toSorted();
+	for (let [a, o] of F.entries()) {
+		let l = x.get(o);
+		if (!l) {
+			console.warn(`Unexpected missing group for file: ${o}`);
 			continue;
 		}
-		let c = [], l = o;
-		c.push({
+		let u = [], d = l;
+		u.push({
 			current: "Current",
 			action: "Action",
 			target: "Target",
-			arrow: "❯"
+			arrow: "❯",
+			job: "Job",
+			age: "Age"
 		});
-		for (let { update: i, index: a } of l) {
-			let o = !!i.latestSha, l = g[a].display, u = g[a]?.effectiveForDiff ?? i.currentVersion, d = formatVersion(i.latestVersion, u), f = i.action.name;
-			if (i.latestSha) {
-				let e = i.latestSha.slice(0, 7);
-				d = `${d} ${pc.gray(`(${e})`)}`;
+		for (let { update: a, index: o } of d) {
+			let l = !!a.latestSha, d = S[o], f = d.display;
+			d.versionForPadding && d.shortSha && (f = `${padString(d.versionForPadding, M + 1)}${pc.gray(`(${d.shortSha})`)}`);
+			let p = d.effectiveForDiff ?? a.currentVersion, m = formatVersion(a.latestVersion, p), h = a.action.name;
+			if (a.latestSha) {
+				let e = a.latestSha.slice(0, 7);
+				m = `${padString(m, M + 1)}${pc.gray(`(${e})`)}`;
 			}
-			o || (d = pc.gray(d), l = pc.gray(l), f = pc.gray(f)), c.push({
-				action: f,
-				target: d,
+			l || (m = pc.gray(m), f = pc.gray(f), h = pc.gray(h));
+			let g = a.action.job ?? "–", _ = formatAge(a.publishedAt);
+			u.push({
+				job: l ? g : pc.gray(g),
+				age: l ? _ : pc.gray(_),
+				action: h,
+				target: m,
 				arrow: "❯",
-				current: l
+				current: f
 			});
 		}
-		let u = Math.max(b, MIN_ACTION_WIDTH), m = Math.max(x, MIN_CURRENT_WIDTH), h = [];
-		for (let [e, i] of c.entries()) {
-			let a = e === 0, o = formatTableRow(i, u, m);
-			if (a) h.push({
-				message: pc.gray(` ○ ${o}`),
+		let h = Math.max(k, MIN_ACTION_WIDTH), g = Math.max(A, MIN_CURRENT_WIDTH), _ = Math.max(j, MIN_JOB_WIDTH), v = [];
+		for (let [e, a] of u.entries()) {
+			let o = e === 0, s = formatTableRow({
+				targetWidth: N,
+				currentWidth: g,
+				actionWidth: h,
+				ageWidth: P,
+				jobWidth: _,
+				row: a
+			});
+			if (o) v.push({
+				message: pc.gray(` ○ ${s}`),
 				role: "separator",
 				indent: "",
 				name: ""
 			});
 			else {
-				let i = l[e - 1];
-				if (!i) continue;
-				let { update: a, index: s } = i, c = !!a.latestSha, u = c && !a.isBreaking;
-				h.push({
-					message: o,
-					value: String(s),
-					name: String(s),
+				let { update: a, index: o } = d[e - 1], c = !!a.latestSha, l = c && !a.isBreaking;
+				v.push({
+					message: s,
+					value: String(o),
+					name: String(o),
 					disabled: !c,
 					indent: "",
-					enabled: u
+					enabled: l
 				});
 			}
 		}
-		_.push({
-			message: pc.gray(a),
-			value: `label|${a}`,
-			choices: h,
-			name: `label|${a}`,
+		C.push({
+			message: pc.gray(o),
+			value: `label|${o}`,
+			choices: v,
+			name: `label|${o}`,
 			isGroupLabel: !0,
 			enabled: !1
-		}), i < S.length - 1 && _.push({
+		}), a < F.length - 1 && C.push({
 			role: "separator",
 			message: " ",
 			name: ""
@@ -107,12 +126,12 @@ async function promptUpdateSelection(o) {
 	}
 	try {
 		let e = {
-			indicator(e, i) {
-				if (i.isGroupLabel) {
-					let e = (i.choices ?? []).filter((e) => !("role" in e)), a = e.length, o = e.filter((e) => !!e.enabled).length === a ? "●" : "○";
-					return ` ${pc.gray(o)}`;
+			indicator(e, a) {
+				if (a.isGroupLabel) {
+					let e = (a.choices ?? []).filter((e) => !("role" in e)), o = e.length, s = e.filter((e) => !!e.enabled).length === o ? "●" : "○";
+					return ` ${pc.gray(s)}`;
 				}
-				return `   ${i.enabled ? "●" : "○"}`;
+				return `   ${a.enabled ? "●" : "○"}`;
 			},
 			message: `Choose which actions to update (Press ${pc.cyan("<space>")} to select, ${pc.cyan("<a>")} to toggle all, ${pc.cyan("<i>")} to invert selection)`,
 			styles: {
@@ -133,47 +152,53 @@ async function promptUpdateSelection(o) {
 			type: "multiselect",
 			name: "selected",
 			pointer: "❯",
-			choices: _
-		}, { selected: i } = await enquirer.prompt(e), a = /* @__PURE__ */ new Set();
-		for (let e of i) {
+			choices: C
+		}, { selected: a } = await enquirer.prompt(e), o = /* @__PURE__ */ new Set();
+		for (let e of a) {
 			if (e.startsWith("label|")) {
-				let i = e.slice(6), o = p.get(i) ?? [];
-				for (let { update: e, index: i } of o) e.latestSha && a.add(i);
+				let a = e.slice(6), s = x.get(a) ?? [];
+				for (let { update: e, index: a } of s) e.latestSha && o.add(a);
 				continue;
 			}
-			let i = Number.parseInt(e, 10);
-			Number.isFinite(i) && a.add(i);
+			let a = Number.parseInt(e, 10);
+			Number.isFinite(a) && o.add(a);
 		}
-		let o = [];
-		for (let [e, i] of c.entries()) a.has(e) && i.latestSha && o.push(i);
-		return o.length === 0 ? (console.info(pc.yellow("\nNo actions selected")), null) : o;
+		let s = [];
+		for (let [e, a] of b.entries()) o.has(e) && a.latestSha && s.push(a);
+		return s.length === 0 ? (console.info(pc.yellow("\nNo actions selected")), null) : s;
 	} catch (e) {
 		if (e instanceof Error && (e.message.includes("cancelled") || e.message.includes("ESC") || e.name === "ExitPromptError")) return logSelectionCancelled(), null;
 		throw console.error(pc.red("Unexpected error during selection:"), e), e;
 	}
 }
-async function tryReadInlineVersionComment(e, i) {
+async function tryReadInlineVersionComment(e, a) {
 	try {
-		if (!e || !i || i <= 0) return null;
-		let a = (await readFile(e, "utf8")).split("\n"), o = i - 1;
-		if (o < 0 || o >= a.length) return null;
-		let s = a[o].match(/#\s*(?<version>[Vv]?\d+(?:\.\d+){0,2}(?:[+-][\w\-.]+)?)/u);
-		if (s?.groups?.version) return s.groups.version;
+		if (!e || !a || a <= 0) return null;
+		let o = (await readFile(e, "utf8")).split("\n"), s = a - 1;
+		if (s < 0 || s >= o.length) return null;
+		let c = o[s].match(/#\s*(?<version>[Vv]?\d+(?:\.\d+){0,2}(?:[+-][\w\-.]+)?)/u);
+		if (c?.groups?.version) return c.groups.version;
 	} catch {}
 	return null;
 }
-function formatTableRow(e, i, a) {
-	return [
-		padString(e.action, i),
-		padString(e.current, a),
-		e.arrow,
-		e.target
-	].join("  ").replace(/\s+$/u, "");
+function formatAge(e) {
+	if (!e) return "";
+	let a = Date.now() - e.getTime(), o = Math.floor(a / (1e3 * 60 * 60)), s = Math.floor(o / 24), c = Math.floor(s / 7), l = s % 7;
+	return c >= 1 ? l > 0 ? `${c}w ${l}d` : `${c}w` : s >= 1 ? `${s}d` : `${o}h`;
+}
+function formatTableRow(e) {
+	let { currentWidth: a, actionWidth: o, targetWidth: c, jobWidth: l, ageWidth: u, row: d } = e, f = [
+		padString(d.action, o),
+		padString(d.job, l),
+		padString(d.current, a),
+		d.arrow,
+		padString(d.target, c)
+	];
+	return u > 0 && f.push(d.age), f.join("  ").replace(/\s+$/u, "");
 }
 function isSha(e) {
-	if (!e) return !1;
-	let i = e.replace(/^v/u, "");
-	return /^[0-9a-f]{7,40}$/iu.test(i);
+	let a = e.replace(/^v/u, "");
+	return /^[0-9a-f]{7,40}$/iu.test(a);
 }
 function formatVersionOrSha(e) {
 	return e ? isSha(e) ? e.slice(0, 7) : e.replace(/^v/u, "") : pc.gray("unknown");

package/dist/core/parsing/parse-action-reference.js

@@ -24,7 +24,7 @@ function parseActionReference(e, t, n) {
 	if (!s || !c) return null;
 	for (let e of o.slice(2)) if (!e) return null;
 	return {
-		type: "external",
+		type: o.length > 2 && (i.endsWith(".yml") || i.endsWith(".yaml")) ? "reusable-workflow" : "external",
 		name: i,
 		version: a,
 		file: t,

package/dist/core/scan-github-actions.d.ts

@@ -8,10 +8,12 @@ import { ScanResult } from '../types/scan-result';
  *
  * @param rootPath - The root path of the repository to scan. Defaults to
  *   current working directory.
+ * @param ciDirectory - The CI directory name (e.g., '.github' or '.gitea').
+ *   Defaults to '.github'.
  * @returns A promise that resolves to a ScanResult containing:
  *
  *   - Workflows: Map of workflow file paths to their referenced actions
  *   - CompositeActions: Map of composite action names to their directory paths
  *   - Actions: Flat array of all discovered GitHub Actions.
  */
-export declare function scanGitHubActions(rootPath?: string): Promise<ScanResult>;
+export declare function scanGitHubActions(rootPath?: string, ciDirectory?: string): Promise<ScanResult>;

package/dist/core/scan-github-actions.js

@@ -4,96 +4,85 @@ import { scanActionFile } from "./scan-action-file.js";
 import { isYamlFile } from "./fs/is-yaml-file.js";
 import { readFile, readdir, stat } from "node:fs/promises";
 import { isAbsolute, join, relative, resolve } from "node:path";
-async function scanGitHubActions(d = process.cwd()) {
-	let m = {
+async function scanGitHubActions(d = process.cwd(), m = GITHUB_DIRECTORY) {
+	let h = {
 		compositeActions: /* @__PURE__ */ new Map(),
 		workflows: /* @__PURE__ */ new Map(),
 		actions: []
-	}, h = resolve(d);
-	function g(e, o) {
+	}, g = resolve(d);
+	function _(e, o) {
 		let s = relative(e, o);
 		return s !== "" && !s.startsWith("..") && !isAbsolute(s);
 	}
-	let _ = join(h, GITHUB_DIRECTORY);
-	if (!g(h, _)) throw Error("Invalid path: detected path traversal attempt");
-	function v(e) {
+	let v = join(g, m);
+	if (!_(g, v)) throw Error("Invalid path: detected path traversal attempt");
+	function y(e) {
 		return e.includes("..") || e.includes("/") || e.includes("\\") ? (console.warn(`Skipping invalid name: ${e}`), !1) : !0;
 	}
-	let y = join(_, WORKFLOWS_DIRECTORY);
-	if (!g(h, y)) return m;
+	let b = join(v, WORKFLOWS_DIRECTORY);
 	try {
-		if ((await stat(y)).isDirectory()) {
-			let e = (await readdir(y)).filter((e) => v(e) ? isYamlFile(e) : !1).map(async (e) => {
-				let l = join(y, e);
-				if (!g(y, l)) return console.warn(`Skipping file outside workflows directory: ${e}`), {
-					success: !1,
-					actions: [],
-					path: ""
-				};
+		if ((await stat(b)).isDirectory()) {
+			let e = (await readdir(b)).filter((e) => y(e) ? isYamlFile(e) : !1).map(async (e) => {
+				let o = join(b, e);
 				try {
-					let u = await scanWorkflowFile(l);
+					let l = await scanWorkflowFile(o);
 					return {
-						path: `${GITHUB_DIRECTORY}/${WORKFLOWS_DIRECTORY}/${e}`,
+						path: `${m}/${WORKFLOWS_DIRECTORY}/${e}`,
 						success: !0,
-						actions: u
+						actions: l
 					};
 				} catch {
 					return {
-						path: `${GITHUB_DIRECTORY}/${WORKFLOWS_DIRECTORY}/${e}`,
+						path: `${m}/${WORKFLOWS_DIRECTORY}/${e}`,
 						success: !1,
 						actions: []
 					};
 				}
-			}), l = await Promise.all(e);
-			for (let e of l) e.success && e.path && (e.actions.length > 0 ? (m.workflows.set(e.path, e.actions), m.actions.push(...e.actions)) : m.workflows.set(e.path, []));
+			}), o = await Promise.all(e);
+			for (let e of o) e.success && e.path && (e.actions.length > 0 ? (h.workflows.set(e.path, e.actions), h.actions.push(...e.actions)) : h.workflows.set(e.path, []));
 		}
 	} catch {}
-	let b = join(_, ACTIONS_DIRECTORY);
-	if (!g(h, b)) return m;
+	let x = join(v, ACTIONS_DIRECTORY);
 	try {
-		if ((await stat(b)).isDirectory()) {
-			let s = (await readdir(b)).map(async (s) => {
-				if (!v(s)) return null;
-				let c = join(b, s);
-				if (!g(b, c)) return console.warn(`Skipping subdirectory outside actions path: ${s}`), null;
+		if ((await stat(x)).isDirectory()) {
+			let o = (await readdir(x)).map(async (o) => {
+				if (!y(o)) return null;
+				let s = join(x, o);
 				try {
-					if (!(await stat(c)).isDirectory()) return null;
-					let u = join(c, "action.yml");
-					if (!g(c, u)) return null;
-					let d = [];
+					if (!(await stat(s)).isDirectory()) return null;
+					let c = join(s, "action.yml"), u = [];
 					try {
-						d = await scanActionFile(u);
+						u = await scanActionFile(c);
 					} catch {
 						try {
-							if (u = join(c, "action.yaml"), !g(c, u)) return null;
-							d = await scanActionFile(u);
+							c = join(s, "action.yaml"), u = await scanActionFile(c);
 						} catch {
 							return null;
 						}
 					}
 					return {
-						path: `${GITHUB_DIRECTORY}/${ACTIONS_DIRECTORY}/${s}`,
-						name: s,
-						actions: d
+						path: `${m}/${ACTIONS_DIRECTORY}/${o}`,
+						name: o,
+						actions: u
 					};
 				} catch {
 					return null;
 				}
-			}), c = await Promise.all(s);
-			for (let e of c) e && (m.compositeActions.set(e.name, e.path), m.actions.push(...e.actions));
+			}), s = await Promise.all(o);
+			for (let e of s) e && (h.compositeActions.set(e.name, e.path), h.actions.push(...e.actions));
 		}
 	} catch {}
 	try {
-		let e = await getCurrentRepoSlug(h);
+		let e = await getCurrentRepoSlug(g);
 		if (e) {
 			if (process.env.ACTIONS_UP_TEST_THROW === "1") throw Error("test");
 			let o = /* @__PURE__ */ new Set(), s = [];
-			for (let c of m.actions) {
+			for (let c of h.actions) {
 				if (c.type !== "external") continue;
 				let l = c.name.split("/");
 				if (l.length < 3 || `${l[0]}/${l[1]}` !== e) continue;
-				let u = join(h, ...l.slice(2));
-				g(h, u) && (o.has(u) || (o.add(u), s.push(u)));
+				let u = join(g, ...l.slice(2));
+				_(g, u) && (o.has(u) || (o.add(u), s.push(u)));
 			}
 			async function c() {
 				if (s.length === 0) return;
@@ -107,14 +96,14 @@ async function scanGitHubActions(d = process.cwd()) {
 							d = u;
 						}
 						let f = await scanActionFile(d);
-						f.length > 0 && m.actions.push(...f);
+						f.length > 0 && h.actions.push(...f);
 						let p = [];
 						for (let s of f) {
 							if (s.type !== "external") continue;
 							let c = s.name.split("/");
 							if (c.length < 3 || `${c[0]}/${c[1]}` !== e) continue;
-							let l = join(h, ...c.slice(2));
-							g(h, l) && (o.has(l) || (o.add(l), p.push(l)));
+							let l = join(g, ...c.slice(2));
+							_(g, l) && (o.has(l) || (o.add(l), p.push(l)));
 						}
 						return p;
 					} catch {
@@ -127,7 +116,7 @@ async function scanGitHubActions(d = process.cwd()) {
 			await c();
 		}
 	} catch {}
-	return m;
+	return h;
 }
 async function getCurrentRepoSlug(e) {
 	let o = process.env.GITHUB_REPOSITORY;

package/dist/package.js

@@ -1,2 +1,2 @@
-const version = "1.4.2";
+const version = "1.6.0";
 export { version };

package/dist/types/action-update.d.ts

@@ -10,6 +10,9 @@ export interface ActionUpdate {
   /** SHA hash of the latest version. */
   latestSha: string | null
 
+  /** Publication date of the latest version (null if unknown). */
+  publishedAt: Date | null
+
   /** The original action from scanning. */
   action: GitHubAction
 

package/dist/types/github-action.d.ts

@@ -1,7 +1,7 @@
 /** Represents a GitHub Action used in workflows or composite actions. */
 export interface GitHubAction {
   /** Type of the GitHub Action. */
-  type: 'composite' | 'external' | 'docker' | 'local'
+  type: 'reusable-workflow' | 'composite' | 'external' | 'docker' | 'local'
 
   /** Version or tag of the action (e.g., 'v1', 'main', commit SHA). */
   version?: string | null
@@ -15,6 +15,9 @@ export interface GitHubAction {
   /** Original `uses` string from workflow, if available. */
   uses?: string
 
+  /** Name of the job where this action is used (for workflows). */
+  job?: string
+
   /** Full name of the action (e.g., 'actions/checkout'). */
   name: string
 

package/dist/types/workflow-job.d.ts

@@ -1,6 +1,12 @@
 import { WorkflowStep } from './workflow-step';
 /** Represents a job in a GitHub Actions workflow. */
 export interface WorkflowJob {
+  /** Secrets passed to the reusable workflow ('inherit' or specific secrets). */
+  secrets?: Record<string, unknown> | 'inherit'
+
+  /** Input parameters passed to the reusable workflow. */
+  with?: Record<string, unknown>
+
   /** Runner environment(s) to execute this job on (e.g., 'ubuntu-latest'). */
   'runs-on'?: string[] | string
 
@@ -13,6 +19,9 @@ export interface WorkflowJob {
   /** Allow additional properties for job configuration. */
   [key: string]: unknown
 
+  /** Reusable workflow reference (mutually exclusive with 'steps'). */
+  uses?: string
+
   /** Conditional expression to determine if the job should run. */
   if?: string
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "actions-up",
-  "version": "1.4.2",
+  "version": "1.6.0",
   "description": "Interactive CLI tool to update GitHub Actions to latest versions with SHA pinning",
   "keywords": [
     "github-actions",

package/readme.md

@@ -19,6 +19,7 @@ Interactively upgrade and pin actions to exact commit SHAs for secure, reproduci
 ## Features
 
 - **Auto-discovery**: Scans all workflows (`.github/workflows/*.yml`) and composite actions (`.github/actions/*/action.yml`)
+- **Reusable Workflows**: Detects and updates reusable workflow calls at the job level
 - **SHA pinning**: Updates actions to use commit SHA instead of tags for better security
 - **Batch Updates**: Update multiple actions at once
 - **Interactive Selection**: Choose which actions to update
@@ -122,6 +123,14 @@ Check for updates without making any changes:
 npx actions-up --dry-run
 ```
 
+### Custom Directory
+
+By default, Actions Up scans the `.github` directory. You can specify a different directory (e.g., for Gitea):
+
+```bash
+npx actions-up --dir .gitea
+```
+
 ## GitHub Actions Integration
 
 ### Automated PR Checks
@@ -371,6 +380,8 @@ jobs:
 
 ## Example
 
+### Regular Actions
+
 ```yaml
 # Before
 - uses: actions/checkout@v3
@@ -381,6 +392,26 @@ jobs:
 - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
 ```
 
+### Reusable Workflows
+
+Actions Up also detects and updates reusable workflow calls:
+
+```yaml
+# Before
+jobs:
+  call-workflow:
+    uses: org/repo/.github/workflows/ci.yml@v1.0.0
+    with:
+      config: production
+
+# After running actions-up
+jobs:
+  call-workflow:
+    uses: org/repo/.github/workflows/ci.yml@a1b2c3d4e5f6 # v2.0.0
+    with:
+      config: production
+```
+
 ## Advanced Usage
 
 ### Using GitHub Token for Higher Rate Limits
@@ -431,6 +462,17 @@ npx actions-up --exclude ".*/internal-.*" --exclude "/^acme\/.+$/i"
 npx actions-up --exclude "my-org/.*, .*/internal-.*"
 ```
 
+#### Filtering by Release Age
+
+By default, Actions Up shows all available updates. You can filter out recently released updates to avoid updating to versions that haven't been battle-tested yet:
+
+```bash
+# Only show updates released at least 7 days ago
+npx actions-up --min-age 7
+```
+
+When `--min-age` is set, an "Age" column appears showing how long ago each release was published (e.g., `3d`, `1w 2d`).
+
 #### Ignore Comments
 
 You can skip specific actions or files using YAML comments. Ignored items are hidden in dry-run and interactive modes and are not updated with `--yes`.