@capraconsulting/cals-cli 3.16.0 → 3.17.0

package/lib/cals-cli.mjs

@@ -19,7 +19,7 @@ import yaml from 'js-yaml';
 import AJV from 'ajv';
 import { execa } from 'execa';
 
-var version = "3.16.0";
+var version = "3.17.0";
 var engines = {
 	node: ">=22.14.0"
 };
@@ -135,6 +135,13 @@ class Reporter {
         clearLine(this.stdout);
         this.stdout.write(`${this.format.blue("info")} ${msg}\n`);
     }
+    /**
+     * Write a status message to stderr for feedback during long-running operations.
+     * Writing to stderr ensures it doesn't interfere with piped stdout.
+     */
+    status(msg) {
+        this.stderr.write(`${this.format.dim(msg)}\n`);
+    }
 }
 
 class CacheProvider {
@@ -507,11 +514,12 @@ function includesTopic(repo, topic) {
     return repo.repositoryTopics.edges.some((it) => it.node.topic.name === topic);
 }
 
-async function generateCloneCommands({ config, github, org, ...opt }) {
+async function generateCloneCommands({ config, github, reporter, org, ...opt }) {
     if (!opt.all && opt.group === undefined) {
         yargs(hideBin(process__default.argv)).showHelp();
         return;
     }
+    reporter.status(`Fetching repositories from ${org}...`);
     const repos = await github.getOrgRepoList({ org });
     const groups = getGroupedRepos(repos);
     for (const group of groups) {
@@ -576,6 +584,7 @@ const command$4 = {
             github: await createGitHubService({
                 cache: createCacheProvider(config, argv),
             }),
+            reporter: createReporter(),
             all: !!argv.all,
             includeArchived: !!argv["include-archived"],
             name: argv.name,
@@ -587,165 +596,6 @@ const command$4 = {
     },
 };
 
-const command$3 = {
-    command: "groups",
-    describe: "List available repository groups in a GitHub organization",
-    builder: (yargs) => yargs.options("org", {
-        alias: "o",
-        default: "capralifecycle",
-        requiresArg: true,
-        describe: "GitHub organization",
-        type: "string",
-    }),
-    handler: async (argv) => {
-        const config = createConfig();
-        const reporter = createReporter();
-        const github = await createGitHubService({
-            cache: createCacheProvider(config, argv),
-        });
-        const repos = await github.getOrgRepoList({ org: argv.org });
-        const groups = getGroupedRepos(repos);
-        for (const group of groups) {
-            reporter.log(group.name);
-        }
-    },
-};
-
-function getReposMissingGroup(repos) {
-    return repos.filter((it) => getGroup(it) === null);
-}
-function getOldRepos(repos, days) {
-    const ignoreAfter = new Date();
-    ignoreAfter.setDate(ignoreAfter.getDate() - days);
-    return repos
-        .filter((it) => !it.isArchived)
-        .filter((it) => new Date(it.updatedAt) < ignoreAfter)
-        .sort((a, b) => a.updatedAt.toString().localeCompare(b.updatedAt.toString()));
-}
-async function listRepos({ reporter, github, includeArchived, name = undefined, topic = undefined, compact, csv, org, }) {
-    let repos = await github.getOrgRepoList({ org });
-    if (!includeArchived) {
-        repos = repos.filter((it) => !it.isArchived);
-    }
-    if (name !== undefined) {
-        repos = repos.filter((it) => it.name.includes(name));
-    }
-    if (topic !== undefined) {
-        repos = repos.filter((it) => includesTopic(it, topic));
-    }
-    // All CSV output is done using direct stdout to avoid extra chars.
-    if (csv) {
-        process__default.stdout.write("reponame,group\n");
-    }
-    getGroupedRepos(repos).forEach((group) => {
-        if (!csv && compact) {
-            reporter.log(`${group.name}`);
-        }
-        else if (!csv) {
-            reporter.log("");
-            reporter.log(`======== ${group.name} ========`);
-        }
-        group.items.forEach((repo) => {
-            if (csv) {
-                // We assume we have no repos or group names with a comma in its name.
-                process__default.stdout.write(`${repo.name},${group.name}\n`);
-                return;
-            }
-            if (compact) {
-                reporter.log(`- ${repo.name}`);
-                return;
-            }
-            reporter.log(`${repo.name}`);
-            reporter.log(`- Created: ${repo.createdAt}`);
-            reporter.log(`- Updated: ${repo.updatedAt}`);
-            if (repo.repositoryTopics.edges.length === 0) {
-                reporter.log("- Topics: (none)");
-            }
-            else {
-                reporter.log("- Topics:");
-                repo.repositoryTopics.edges.forEach((edge) => {
-                    reporter.log(`  - ${edge.node.topic.name}`);
-                });
-            }
-        });
-    });
-    if (csv) {
-        return;
-    }
-    reporter.log("");
-    reporter.log(`Total number of repos: ${repos.length}`);
-    const missingGroup = getReposMissingGroup(repos);
-    if (missingGroup.length > 0) {
-        reporter.log("");
-        reporter.log("Repos missing group/customer topic:");
-        missingGroup.forEach((repo) => {
-            reporter.log(`- ${repo.name}`);
-        });
-        reporter.log("Useful search query: https://github.com/capralifecycle?q=topics%3A0");
-    }
-    const days = 180;
-    const oldRepos = getOldRepos(repos, days);
-    if (oldRepos.length > 0) {
-        reporter.log("");
-        reporter.log(`Repositories not updated for ${days} days:`);
-        oldRepos.forEach((repo) => {
-            reporter.log(`- ${repo.name} - ${repo.updatedAt}`);
-        });
-    }
-}
-const command$2 = {
-    command: "repos",
-    describe: "List repositories in a GitHub organization",
-    builder: (yargs) => yargs
-        .options("org", {
-        alias: "o",
-        default: "capralifecycle",
-        requiresArg: true,
-        describe: "GitHub organization",
-        type: "string",
-    })
-        .option("include-archived", {
-        alias: "a",
-        describe: "Include archived repos",
-        type: "boolean",
-    })
-        .options("compact", {
-        alias: "c",
-        describe: "Compact output list",
-        type: "boolean",
-    })
-        .options("csv", {
-        describe: "Output as a CSV list that can be used for automation",
-        type: "boolean",
-    })
-        .option("name", {
-        describe: "Filter to include the specified name",
-        type: "string",
-        requiresArg: true,
-    })
-        .option("topic", {
-        alias: "t",
-        describe: "Filter by specific topic",
-        type: "string",
-        requiresArg: true,
-    }),
-    handler: async (argv) => {
-        const config = createConfig();
-        await listRepos({
-            reporter: createReporter(),
-            github: await createGitHubService({
-                cache: createCacheProvider(config, argv),
-            }),
-            includeArchived: !!argv["include-archived"],
-            name: argv.name,
-            topic: argv.topic,
-            compact: !!argv.compact,
-            csv: !!argv.csv,
-            org: argv.org,
-        });
-    },
-};
-
 var type = "object";
 var properties = {
 	projects: {
@@ -904,6 +754,172 @@ function getRepos(definition) {
     }))));
 }
 
+const CALS_YAML$1 = ".cals.yaml";
+const command$3 = {
+    command: "groups",
+    describe: "List available project groups from the definition file",
+    builder: (yargs) => yargs,
+    handler: async () => {
+        const reporter = createReporter();
+        const manifestPath = await findUp(CALS_YAML$1);
+        if (manifestPath === undefined) {
+            reporter.error(`File ${CALS_YAML$1} not found`);
+            process__default.exitCode = 1;
+            return;
+        }
+        const manifest = yaml.load(fs.readFileSync(manifestPath, "utf-8"));
+        const definitionPath = path.resolve(path.dirname(manifestPath), manifest.resourcesDefinition.path);
+        if (!fs.existsSync(definitionPath)) {
+            reporter.error(`Definition file not found: ${definitionPath}`);
+            process__default.exitCode = 1;
+            return;
+        }
+        const definition = await new DefinitionFile(definitionPath).getDefinition();
+        const projectNames = definition.projects
+            .map((p) => p.name)
+            .sort((a, b) => a.localeCompare(b));
+        for (const name of projectNames) {
+            reporter.log(name);
+        }
+    },
+};
+
+function getReposMissingGroup(repos) {
+    return repos.filter((it) => getGroup(it) === null);
+}
+function getOldRepos(repos, days) {
+    const ignoreAfter = new Date();
+    ignoreAfter.setDate(ignoreAfter.getDate() - days);
+    return repos
+        .filter((it) => !it.isArchived)
+        .filter((it) => new Date(it.updatedAt) < ignoreAfter)
+        .sort((a, b) => a.updatedAt.toString().localeCompare(b.updatedAt.toString()));
+}
+async function listRepos({ reporter, github, includeArchived, name = undefined, topic = undefined, compact, csv, org, }) {
+    reporter.status(`Fetching repositories from ${org}...`);
+    let repos = await github.getOrgRepoList({ org });
+    if (!includeArchived) {
+        repos = repos.filter((it) => !it.isArchived);
+    }
+    if (name !== undefined) {
+        repos = repos.filter((it) => it.name.includes(name));
+    }
+    if (topic !== undefined) {
+        repos = repos.filter((it) => includesTopic(it, topic));
+    }
+    // All CSV output is done using direct stdout to avoid extra chars.
+    if (csv) {
+        process__default.stdout.write("reponame,group\n");
+    }
+    getGroupedRepos(repos).forEach((group) => {
+        if (!csv && compact) {
+            reporter.log(`${group.name}`);
+        }
+        else if (!csv) {
+            reporter.log("");
+            reporter.log(`======== ${group.name} ========`);
+        }
+        group.items.forEach((repo) => {
+            if (csv) {
+                // We assume we have no repos or group names with a comma in its name.
+                process__default.stdout.write(`${repo.name},${group.name}\n`);
+                return;
+            }
+            if (compact) {
+                reporter.log(`- ${repo.name}`);
+                return;
+            }
+            reporter.log(`${repo.name}`);
+            reporter.log(`- Created: ${repo.createdAt}`);
+            reporter.log(`- Updated: ${repo.updatedAt}`);
+            if (repo.repositoryTopics.edges.length === 0) {
+                reporter.log("- Topics: (none)");
+            }
+            else {
+                reporter.log("- Topics:");
+                repo.repositoryTopics.edges.forEach((edge) => {
+                    reporter.log(`  - ${edge.node.topic.name}`);
+                });
+            }
+        });
+    });
+    if (csv) {
+        return;
+    }
+    reporter.log("");
+    reporter.log(`Total number of repos: ${repos.length}`);
+    const missingGroup = getReposMissingGroup(repos);
+    if (missingGroup.length > 0) {
+        reporter.log("");
+        reporter.log("Repos missing group/customer topic:");
+        missingGroup.forEach((repo) => {
+            reporter.log(`- ${repo.name}`);
+        });
+        reporter.log("Useful search query: https://github.com/capralifecycle?q=topics%3A0");
+    }
+    const days = 180;
+    const oldRepos = getOldRepos(repos, days);
+    if (oldRepos.length > 0) {
+        reporter.log("");
+        reporter.log(`Repositories not updated for ${days} days:`);
+        oldRepos.forEach((repo) => {
+            reporter.log(`- ${repo.name} - ${repo.updatedAt}`);
+        });
+    }
+}
+const command$2 = {
+    command: "repos",
+    describe: "List repositories in a GitHub organization",
+    builder: (yargs) => yargs
+        .options("org", {
+        alias: "o",
+        default: "capralifecycle",
+        requiresArg: true,
+        describe: "GitHub organization",
+        type: "string",
+    })
+        .option("include-archived", {
+        alias: "a",
+        describe: "Include archived repos",
+        type: "boolean",
+    })
+        .options("compact", {
+        alias: "c",
+        describe: "Compact output list",
+        type: "boolean",
+    })
+        .options("csv", {
+        describe: "Output as a CSV list that can be used for automation",
+        type: "boolean",
+    })
+        .option("name", {
+        describe: "Filter to include the specified name",
+        type: "string",
+        requiresArg: true,
+    })
+        .option("topic", {
+        alias: "t",
+        describe: "Filter by specific topic",
+        type: "string",
+        requiresArg: true,
+    }),
+    handler: async (argv) => {
+        const config = createConfig();
+        await listRepos({
+            reporter: createReporter(),
+            github: await createGitHubService({
+                cache: createCacheProvider(config, argv),
+            }),
+            includeArchived: !!argv["include-archived"],
+            name: argv.name,
+            topic: argv.topic,
+            compact: !!argv.compact,
+            csv: !!argv.csv,
+            org: argv.org,
+        });
+    },
+};
+
 function wasUpdated(output) {
     return output.startsWith("Updating ");
 }
@@ -1204,6 +1220,7 @@ function getDefinitionRepo(rootdir, reposInOrg, cals) {
     };
 }
 async function getExpectedRepos(reporter, github, cals, rootdir) {
+    reporter.status(`Fetching repositories from ${cals.githubOrganization}...`);
     const githubRepos = await github.getOrgRepoList({
         org: cals.githubOrganization,
     });
@@ -1480,6 +1497,7 @@ const command = {
         const github = await createGitHubService({
             cache: createCacheProvider(config, argv),
         });
+        reporter.status(`Fetching repositories from ${argv.org}...`);
         const repos = await github.getOrgRepoList({ org: argv.org });
         const topics = new Set();
         for (const repo of repos) {
@@ -1520,7 +1538,7 @@ async function main() {
         process__default.exit(1);
     }
     await yargs(hideBin(process__default.argv))
-        .usage(`cals v${version} (build: ${"2026-01-30T15:32:36.955Z"})
+        .usage(`cals v${version} (build: ${"2026-02-02T15:16:09.276Z"})
 
 A CLI for managing GitHub repositories.
 

package/lib/cals-cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cals-cli.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"cals-cli.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/cli/reporter.d.ts

@@ -16,4 +16,9 @@ export declare class Reporter {
     log(msg: string): void;
     warn(msg: string): void;
     info(msg: string): void;
+    /**
+     * Write a status message to stderr for feedback during long-running operations.
+     * Writing to stderr ensures it doesn't interfere with piped stdout.
+     */
+    status(msg: string): void;
 }

package/lib/index.es.js

@@ -9,7 +9,7 @@ import { Octokit } from '@octokit/rest';
 import pLimit from 'p-limit';
 import keytar from 'keytar';
 
-var version = "3.16.0";
+var version = "3.17.0";
 
 function uniq(array) {
     return Array.from(new Set(array));

package/lib/index.js

@@ -9,7 +9,7 @@ import { Octokit } from '@octokit/rest';
 import pLimit from 'p-limit';
 import keytar from 'keytar';
 
-var version = "3.16.0";
+var version = "3.17.0";
 
 function uniq(array) {
     return Array.from(new Set(array));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capraconsulting/cals-cli",
-  "version": "3.16.0",
+  "version": "3.17.0",
   "description": "CLI for repeatable tasks in CALS",
   "type": "module",
   "license": "Apache-2.0",