@aspruyt/xfg 3.9.3 → 3.9.5

package/README.md

@@ -8,7 +8,9 @@
 [![docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://anthony-spruyt.github.io/xfg/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-A CLI tool for repository-as-code. Sync files and manage settings across GitHub, Azure DevOps, and GitLab.
+Manage files, settings, and repositories across GitHub, Azure DevOps, and GitLab — declaratively, from a single YAML config.
+
+Define your organization's standards once. xfg creates PRs to sync config files, applies repository settings and rulesets via API, and can even create, fork, or migrate repositories — all from one config file.
 
 **[Full Documentation](https://anthony-spruyt.github.io/xfg/)**
 
@@ -48,7 +50,7 @@ gh auth login
 # Sync files across repos
 xfg sync --config ./config.yaml
 
-# Apply repository settings
+# Apply repository settings and rulesets
 xfg settings --config ./config.yaml
 ```
 
@@ -56,7 +58,8 @@ xfg settings --config ./config.yaml
 
 ```yaml
 # sync-config.yaml
-id: my-org-config
+id: my-org-standards
+
 files:
   .prettierrc.json:
     content:
@@ -69,6 +72,7 @@ settings:
     allowSquashMerge: true
     deleteBranchOnMerge: true
     vulnerabilityAlerts: true
+    secretScanning: true
 
   rulesets:
     main-protection:
@@ -82,6 +86,10 @@ settings:
         - type: pull_request
           parameters:
             requiredApprovingReviewCount: 1
+        - type: required_status_checks
+          parameters:
+            requiredStatusChecks:
+              - context: "ci/build"
 
 repos:
   - git:
@@ -89,8 +97,8 @@ repos:
       - git@github.com:your-org/backend-api.git
 ```
 
-**Result:** PRs are created with `.prettierrc.json` files, and repos get standardized merge options, security settings, and branch protection rules.
+**Result:** PRs are created with `.prettierrc.json` files, and repos get standardized merge options, security settings, and branch protection rulesets.
 
 ## Documentation
 
-See **[anthony-spruyt.github.io/xfg](https://anthony-spruyt.github.io/xfg/)** for configuration reference, examples, platform setup, and troubleshooting.
+See **[anthony-spruyt.github.io/xfg](https://anthony-spruyt.github.io/xfg/)** for the full feature list, configuration reference, examples, platform setup, and troubleshooting.

package/dist/cli/program.js

@@ -27,7 +27,7 @@ function addSharedOptions(cmd) {
 // =============================================================================
 program
     .name("xfg")
-    .description("Sync files and manage settings across repositories")
+    .description("Manage files, settings, and repositories across GitHub, Azure DevOps, and GitLab")
     .version(packageJson.version);
 // Sync command (file synchronization)
 const syncCommand = new Command("sync")

package/dist/cli/settings-command.js

@@ -192,7 +192,7 @@ async function processRulesets(repos, config, options, processor, repoProcessor,
 /**
  * Process repo settings for all configured repositories.
  */
-async function processRepoSettings(repos, config, options, processorFactory, results, collector, lifecycleSkipped) {
+async function processRepoSettings(repos, config, options, processorFactory, results, collector, lifecycleSkipped, indexOffset) {
     if (repos.length === 0) {
         return;
     }
@@ -200,6 +200,7 @@ async function processRepoSettings(repos, config, options, processorFactory, res
     console.log(`\nProcessing repo settings for ${repos.length} repositories\n`);
     for (let i = 0; i < repos.length; i++) {
         const repoConfig = repos[i];
+        const current = indexOffset + i + 1;
         if (lifecycleSkipped.has(repoConfig.git)) {
             continue;
         }
@@ -210,7 +211,7 @@ async function processRepoSettings(repos, config, options, processorFactory, res
             });
         }
         catch (error) {
-            logger.error(i + 1, repoConfig.git, String(error));
+            logger.error(current, repoConfig.git, String(error));
             collector.appendError(repoConfig.git, error);
             continue;
         }
@@ -220,14 +221,14 @@ async function processRepoSettings(repos, config, options, processorFactory, res
                 dryRun: options.dryRun,
             });
             if (result.planOutput && result.planOutput.lines.length > 0) {
-                console.log(`\n  ${chalk.bold(repoName)}:`);
-                console.log("  Repo Settings:");
+                logger.info("");
+                logger.info(chalk.bold(`${repoName} - Repo Settings:`));
                 for (const line of result.planOutput.lines) {
-                    console.log(line);
+                    logger.info(line);
                 }
                 if (result.warnings && result.warnings.length > 0) {
                     for (const warning of result.warnings) {
-                        console.log(chalk.yellow(`  ⚠️  Warning: ${warning}`));
+                        logger.info(chalk.yellow(`Warning: ${warning}`));
                     }
                 }
             }
@@ -235,10 +236,10 @@ async function processRepoSettings(repos, config, options, processorFactory, res
                 // Silent skip
             }
             else if (result.success) {
-                console.log(chalk.green(`  ✓ ${repoName}: ${result.message}`));
+                logger.success(current, repoName, result.message);
             }
             else {
-                console.log(chalk.red(`  ✗ ${repoName}: ${result.message}`));
+                logger.error(current, repoName, result.message);
             }
             if (!result.skipped) {
                 const existing = results.find((r) => r.repoName === repoName);
@@ -259,7 +260,7 @@ async function processRepoSettings(repos, config, options, processorFactory, res
             }
         }
         catch (error) {
-            logger.error(i + 1, repoName, String(error));
+            logger.error(current, repoName, String(error));
             collector.appendError(repoName, error);
         }
     }
@@ -312,7 +313,7 @@ export async function runSettings(options, processorFactory = defaultRulesetProc
     const allRepos = [...reposWithRulesets, ...reposWithRepoSettings];
     const lifecycleSkipped = await runLifecycleChecks(allRepos, config, options, lm, results, collector, tokenManager);
     await processRulesets(reposWithRulesets, config, options, processor, repoProcessor, results, collector, lifecycleSkipped);
-    await processRepoSettings(reposWithRepoSettings, config, options, repoSettingsProcessorFactory, results, collector, lifecycleSkipped);
+    await processRepoSettings(reposWithRepoSettings, config, options, repoSettingsProcessorFactory, results, collector, lifecycleSkipped, reposWithRulesets.length);
     console.log("");
     const report = buildSettingsReport(collector.getAll());
     const lines = formatSettingsReportCLI(report);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aspruyt/xfg",
-  "version": "3.9.3",
-  "description": "CLI tool for repository-as-code: sync files and manage settings across GitHub, Azure DevOps, and GitLab",
+  "version": "3.9.5",
+  "description": "Manage files, settings, and repositories across GitHub, Azure DevOps, and GitLab — declaratively, from a single YAML config",
   "type": "module",
   "main": "dist/index.js",
   "bin": {