@xylabs/toolchain 7.10.1 → 7.10.2

package/dist/index.d.ts

@@ -536,12 +536,31 @@ interface ReadmeConfig {
      */
     logoUrl?: string;
 }
+/**
+ * Configuration for packman lint (package manager config linting).
+ */
+interface PackmanConfig {
+    /**
+     * Minimum age in minutes that a package must be published before pnpm will install it.
+     * Only applies when pnpm is the detected package manager.
+     * @default 4320 (3 days)
+     */
+    minimumReleaseAge?: number;
+    /**
+     * Package patterns to exclude from the minimumReleaseAge requirement.
+     * These packages can be installed immediately upon release.
+     * Supports exact names and scoped wildcards (e.g. '@myorg/*').
+     * @default ["'@xylabs/*'", "'@xyo-network/*'"]
+     */
+    minimumReleaseAgeExclude?: string[];
+}
 /**
  * Command-specific configuration that cascades from root to package.
  * Settings here override the legacy top-level equivalents.
  */
 interface CommandsConfig {
     deplint?: DeplintConfig;
+    packman?: PackmanConfig;
     publint?: boolean | PublintConfig;
 }
 interface XyConfigBase {
@@ -686,7 +705,7 @@ interface PackmanLintParams {
     fix?: boolean;
     verbose?: boolean;
 }
-declare function packmanLint({ fix, verbose }?: PackmanLintParams): number;
+declare function packmanLint({ fix, verbose }?: PackmanLintParams): Promise<number>;
 
 type Direction = 'pnpm-to-yarn' | 'yarn-to-pnpm';
 declare function rewriteScript(script: string, direction: Direction): string;
@@ -1101,4 +1120,4 @@ declare const xyParseOptions: () => Argv;
 
 declare const xyYarnCommands: (args: Argv) => Argv<{}>;
 
-export { ALL_PUBLINT_CHECKS, type BuildParams, CROSS_PLATFORM_NEWLINE, type CleanPackageParams, type CleanParams, type CommandsConfig, type CompileConfig, type CompileParams, type ConvertParams, type CopyAssetsParams, type CycleEdge, type CycleParams, DEFAULT_README_BODY, DEFAULT_README_TEMPLATE, type DeclaredDep, type DepLintOptions, type DepType, type DeplintAppliedFix, type DeplintConfig, type DeplintDiagnostic, type DeplintFix, type DeplintPackageConfig, DeplintPackageEditor, type DeplintRefType, type DeplintReporter, type DeplintRule, type DeplintRunOptions, type DeplintRunResult, type DeplintSection, type DeplintSeverity, type DeplintSummary, type DeplintWorkspaceContext, type DeployLevel, DuplicateDetector, type DynamicShareConfig, type EntryMode, type GenDocsPackageParams, type GenDocsParams, INIT_CWD, LEGACY_COMMANDS_PREFIX, type LintInitParams, type LintNextParams, type LintPackageParams, type LintParams, type LintResult, type LiveShareConfig, type OrphanParams, PUBLISH_ONLY_CHECKS, type PackageCompileTscConfig, type PackageCompileTsupConfig, type PackageCopyAssetsParams, type PackageJsonEx, type PackageManager, type PackageManagerName, type PackagePublintParams, type PackmanCleanParams, type PackmanLintParams, type PathConfig, PnpmPackageManager, type PublintCheckName, type PublintConfig, type PublintPackageParams, type PublintParams, type ReadFileSyncOptions, type ReadmeConfig, type ReadmeGenParams, type ReadmeInitParams, type ReadmeLintParams, type RebuildParams, type RecompilePackageParams, type RecompileParams, type RegistryInfo, type RelintPackageParams, type RelintParams, type RepoInitParams, type ResolvedDep, type ResolvedPublintOptions, type RetestParams, type ScriptStep, type SelectedUpdate, type SettingsLevel, type TemplateFile, type TestParams, type UpdoOptions, type VersionChoice, WINDOWS_NEWLINE_REGEX, type Workspace, type WorkspaceForeachOptions, XYLABS_COMMANDS_PREFIX, XYLABS_RULES_PREFIX, XYLABS_SKILLS_PREFIX, type XyConfig, type XyConfigBase, type XyConfigLegacy, type XyTscConfig, type XyTsupConfig, YarnPackageManager, analyze, applyDeplintFixes, applyLogoConfig, applyPackageManager, applyUpdates, build, buildWorkspaceContext, checkInternalDepVersions, checkInternalPeerVersions, checkResult, checkVersionConsistency, checkWorkspaceProtocol, claudeCheck, claudeClean, claudeCommandTemplates, claudeCommands, claudeMdLocalTemplate, claudeMdProjectTemplate, claudeMdRuleTemplates, claudeRules, claudeSettings, claudeSkillTemplates, claudeSkills, clean, cleanAll, cleanDocs, cleanESLint, cleanPackage, collectWorkspaceDeps, compile, compileAll, compilePackage, convert, copyAssets, createBuildConfig, cycle, cycleAll, cyclePackage, dead, defaultBuildConfig, defaultReadFileSyncOptions, deleteGlob, deplint, deplintRules, deploy, deprecationMigrate, detectCurrentPM, detectDuplicateDependencies, detectPackageManager, detectReact, detectReactInMonorepo, detectWorkspaceCycles, dupdeps, eject, empty, fetchAllRegistryInfo, fetchRegistryInfo, fillTemplate, findWorkspacePackagePaths, fix, fixInternalDepVersions, fixInternalPeerVersions, fixVersionConsistency, fixWorkspaceProtocol, genDocs, genDocsAll, genDocsPackage, generateIgnoreFiles, generateReadmeFiles, getDeplintReporter, getPackageManager, gitignore, gitignoreGen, gitignoreTemplate, gitlint, gitlintFix, humanDeplintReporter, installOutputCapture, interactiveSelect, isYarnVersionOrGreater, jsonDeplintReporter, knip, latestVersions, license, lint, lintAllPackages, lintInit, lintNext, lintPackage, lintlint, listRepoTemplates, loadConfig, loadPackageConfig, loadPublintOptions, loadRepoTemplateFiles, loadWorkspaceCommandConfig, logMonorepoVersion, multiLineToJSONArray, notEmpty, npmignoreGen, orphanClean, orphanList, outputStorage, packageClean, packageCleanOutputs, packageCleanTypescript, packageCompile, packageCompileTsc, packageCompileTsup, packageCopyAssets, packageCycle, packageGenDocs, packageLint, packageLintMonorepo, packageName, packagePublint, packageRecompile, packmanClean, packmanLint, parsedPackageJSON, printWorkspaceCycles, processEx, publint, publintAll, publintSingle, publish, test$1 as reactTest, readLines, readNonEmptyLines, readmeGen, readmeInit, readmeLint, rebuild, recompile, recompileAll, recompilePackage, registerPackageManager, reinstall, relint, relintAllPackages, relintPackage, renderTable, repoInit, resolveTemplatePath, resolveVersions, retest, rewriteScript, rewriteScriptsInPackageJson, runDeplint, runInstall, runStepAsync, runSteps, runStepsAsync, runUpdo, runWithConcurrency, runXy, runXyWithWarning, safeExit, safeExitAsync, scaffoldTemplate, sitemap, sonar, start, statics, syncInternalPeerVersions, test, tryReadFileSync, tryRunLocalScript, tsupOptions, union, up, updateYarnPlugins, updateYarnVersion, updo, withErrnoException, withError, writeLines, xy, xyBase, xyBuildCommands, xyCommonCommands, xyDeployCommands, xyInstallCommands, xyLintCommands, xyParseOptions, xyReactCommands, xyYarnCommands, yarn3Only, yarnWorkspace, yarnWorkspaces };
+export { ALL_PUBLINT_CHECKS, type BuildParams, CROSS_PLATFORM_NEWLINE, type CleanPackageParams, type CleanParams, type CommandsConfig, type CompileConfig, type CompileParams, type ConvertParams, type CopyAssetsParams, type CycleEdge, type CycleParams, DEFAULT_README_BODY, DEFAULT_README_TEMPLATE, type DeclaredDep, type DepLintOptions, type DepType, type DeplintAppliedFix, type DeplintConfig, type DeplintDiagnostic, type DeplintFix, type DeplintPackageConfig, DeplintPackageEditor, type DeplintRefType, type DeplintReporter, type DeplintRule, type DeplintRunOptions, type DeplintRunResult, type DeplintSection, type DeplintSeverity, type DeplintSummary, type DeplintWorkspaceContext, type DeployLevel, DuplicateDetector, type DynamicShareConfig, type EntryMode, type GenDocsPackageParams, type GenDocsParams, INIT_CWD, LEGACY_COMMANDS_PREFIX, type LintInitParams, type LintNextParams, type LintPackageParams, type LintParams, type LintResult, type LiveShareConfig, type OrphanParams, PUBLISH_ONLY_CHECKS, type PackageCompileTscConfig, type PackageCompileTsupConfig, type PackageCopyAssetsParams, type PackageJsonEx, type PackageManager, type PackageManagerName, type PackagePublintParams, type PackmanCleanParams, type PackmanConfig, type PackmanLintParams, type PathConfig, PnpmPackageManager, type PublintCheckName, type PublintConfig, type PublintPackageParams, type PublintParams, type ReadFileSyncOptions, type ReadmeConfig, type ReadmeGenParams, type ReadmeInitParams, type ReadmeLintParams, type RebuildParams, type RecompilePackageParams, type RecompileParams, type RegistryInfo, type RelintPackageParams, type RelintParams, type RepoInitParams, type ResolvedDep, type ResolvedPublintOptions, type RetestParams, type ScriptStep, type SelectedUpdate, type SettingsLevel, type TemplateFile, type TestParams, type UpdoOptions, type VersionChoice, WINDOWS_NEWLINE_REGEX, type Workspace, type WorkspaceForeachOptions, XYLABS_COMMANDS_PREFIX, XYLABS_RULES_PREFIX, XYLABS_SKILLS_PREFIX, type XyConfig, type XyConfigBase, type XyConfigLegacy, type XyTscConfig, type XyTsupConfig, YarnPackageManager, analyze, applyDeplintFixes, applyLogoConfig, applyPackageManager, applyUpdates, build, buildWorkspaceContext, checkInternalDepVersions, checkInternalPeerVersions, checkResult, checkVersionConsistency, checkWorkspaceProtocol, claudeCheck, claudeClean, claudeCommandTemplates, claudeCommands, claudeMdLocalTemplate, claudeMdProjectTemplate, claudeMdRuleTemplates, claudeRules, claudeSettings, claudeSkillTemplates, claudeSkills, clean, cleanAll, cleanDocs, cleanESLint, cleanPackage, collectWorkspaceDeps, compile, compileAll, compilePackage, convert, copyAssets, createBuildConfig, cycle, cycleAll, cyclePackage, dead, defaultBuildConfig, defaultReadFileSyncOptions, deleteGlob, deplint, deplintRules, deploy, deprecationMigrate, detectCurrentPM, detectDuplicateDependencies, detectPackageManager, detectReact, detectReactInMonorepo, detectWorkspaceCycles, dupdeps, eject, empty, fetchAllRegistryInfo, fetchRegistryInfo, fillTemplate, findWorkspacePackagePaths, fix, fixInternalDepVersions, fixInternalPeerVersions, fixVersionConsistency, fixWorkspaceProtocol, genDocs, genDocsAll, genDocsPackage, generateIgnoreFiles, generateReadmeFiles, getDeplintReporter, getPackageManager, gitignore, gitignoreGen, gitignoreTemplate, gitlint, gitlintFix, humanDeplintReporter, installOutputCapture, interactiveSelect, isYarnVersionOrGreater, jsonDeplintReporter, knip, latestVersions, license, lint, lintAllPackages, lintInit, lintNext, lintPackage, lintlint, listRepoTemplates, loadConfig, loadPackageConfig, loadPublintOptions, loadRepoTemplateFiles, loadWorkspaceCommandConfig, logMonorepoVersion, multiLineToJSONArray, notEmpty, npmignoreGen, orphanClean, orphanList, outputStorage, packageClean, packageCleanOutputs, packageCleanTypescript, packageCompile, packageCompileTsc, packageCompileTsup, packageCopyAssets, packageCycle, packageGenDocs, packageLint, packageLintMonorepo, packageName, packagePublint, packageRecompile, packmanClean, packmanLint, parsedPackageJSON, printWorkspaceCycles, processEx, publint, publintAll, publintSingle, publish, test$1 as reactTest, readLines, readNonEmptyLines, readmeGen, readmeInit, readmeLint, rebuild, recompile, recompileAll, recompilePackage, registerPackageManager, reinstall, relint, relintAllPackages, relintPackage, renderTable, repoInit, resolveTemplatePath, resolveVersions, retest, rewriteScript, rewriteScriptsInPackageJson, runDeplint, runInstall, runStepAsync, runSteps, runStepsAsync, runUpdo, runWithConcurrency, runXy, runXyWithWarning, safeExit, safeExitAsync, scaffoldTemplate, sitemap, sonar, start, statics, syncInternalPeerVersions, test, tryReadFileSync, tryRunLocalScript, tsupOptions, union, up, updateYarnPlugins, updateYarnVersion, updo, withErrnoException, withError, writeLines, xy, xyBase, xyBuildCommands, xyCommonCommands, xyDeployCommands, xyInstallCommands, xyLintCommands, xyParseOptions, xyReactCommands, xyYarnCommands, yarn3Only, yarnWorkspace, yarnWorkspaces };

package/dist/index.mjs

@@ -7222,7 +7222,7 @@ function packageLintMonorepo(fix2 = false) {
     fix: () => fixInternalDepVersions(cwd6, workspaces),
     label: "Internal deps/devDeps use correct version ranges"
   };
-  const checks2 = [
+  const checks = [
     {
       check: () => checkRootPrivate(pkg),
       fix: fixRootPrivate,
@@ -7274,7 +7274,7 @@ function packageLintMonorepo(fix2 = false) {
       label: "Internal peerDeps use semver ranges (not workspace: protocol)"
     }
   ];
-  const { errors, fixed } = runChecks(checks2, cwd6, pkg, fix2);
+  const { errors, fixed } = runChecks(checks, cwd6, pkg, fix2);
   logSummary(errors, fixed);
   if (fix2 && fixed > 0) {
     runInstall();
@@ -7897,6 +7897,41 @@ import {
 } from "fs";
 import PATH26 from "path";
 import chalk67 from "chalk";
+var DEFAULT_MINIMUM_RELEASE_AGE = 4320;
+var DEFAULT_RELEASE_AGE_EXCLUDES = ["'@xylabs/*'", "'@xyo-network/*'"];
+function resolvePackmanConfig(cfg) {
+  return {
+    minimumReleaseAge: cfg?.minimumReleaseAge ?? DEFAULT_MINIMUM_RELEASE_AGE,
+    minimumReleaseAgeExclude: cfg?.minimumReleaseAgeExclude ?? DEFAULT_RELEASE_AGE_EXCLUDES
+  };
+}
+function readPnpmWorkspaceYaml(cwd6) {
+  const wsPath = PATH26.join(cwd6, "pnpm-workspace.yaml");
+  if (!existsSync23(wsPath)) return void 0;
+  return readFileSync30(wsPath, "utf8");
+}
+function writePnpmWorkspaceYaml(cwd6, content) {
+  writeFileSync17(PATH26.join(cwd6, "pnpm-workspace.yaml"), content, "utf8");
+}
+function parseYamlListSection(content, sectionName) {
+  const items = [];
+  let inSection = false;
+  for (const line of content.split("\n")) {
+    if (new RegExp(String.raw`^${sectionName}\s*:`).test(line)) {
+      inSection = true;
+      continue;
+    }
+    if (inSection) {
+      const match = /^\s+-\s+(.+)$/.exec(line);
+      if (match) {
+        items.push(match[1].trim());
+      } else if (line.trim() && !/^\s/.test(line)) {
+        break;
+      }
+    }
+  }
+  return items;
+}
 function checkEnableScripts(cwd6, verbose, silent) {
   const yarnrcPath = PATH26.join(cwd6, ".yarnrc.yml");
   if (!existsSync23(yarnrcPath)) {
@@ -7904,8 +7939,7 @@ function checkEnableScripts(cwd6, verbose, silent) {
     return true;
   }
   const content = readFileSync30(yarnrcPath, "utf8");
-  const lines = content.split("\n");
-  for (const line of lines) {
+  for (const line of content.split("\n")) {
     const trimmed = line.trim();
     if (/^enableScripts\s*:/.test(trimmed)) {
       const value = trimmed.replace(/^enableScripts\s*:\s*/, "").trim();
@@ -7920,12 +7954,9 @@ function checkEnableScripts(cwd6, verbose, silent) {
   if (!silent) console.log(chalk67.red("  enableScripts is not set in .yarnrc.yml (expected false)"));
   return false;
 }
-function fixEnableScripts(cwd6, verbose) {
+function fixEnableScripts(cwd6) {
   const yarnrcPath = PATH26.join(cwd6, ".yarnrc.yml");
-  if (!existsSync23(yarnrcPath)) {
-    if (verbose) console.log(chalk67.gray("  No .yarnrc.yml found, skipping enableScripts fix"));
-    return true;
-  }
+  if (!existsSync23(yarnrcPath)) return true;
   const content = readFileSync30(yarnrcPath, "utf8");
   const lines = content.split("\n");
   let found = false;
@@ -7959,28 +7990,129 @@ function fixEnableScripts(cwd6, verbose) {
   console.log(chalk67.green("  Fixed: enableScripts set to false"));
   return true;
 }
-var checks = [
-  {
-    name: "enableScripts should be false in .yarnrc.yml",
-    check: checkEnableScripts,
-    fix: fixEnableScripts
+function checkMinimumReleaseAge(cwd6, config2, verbose, silent) {
+  if (detectPackageManager() !== "pnpm") return true;
+  const content = readPnpmWorkspaceYaml(cwd6);
+  if (!content) {
+    if (!silent) console.log(chalk67.red("  No pnpm-workspace.yaml found"));
+    return false;
   }
-];
-function packmanLint({ fix: fix2, verbose } = {}) {
+  const { minimumReleaseAge } = config2;
+  for (const line of content.split("\n")) {
+    const match = /^minimumReleaseAge\s*:\s*(\d+)/.exec(line.trim());
+    if (match) {
+      const value = Number.parseInt(match[1], 10);
+      if (value >= minimumReleaseAge) {
+        if (verbose) console.log(chalk67.green(`  minimumReleaseAge is ${value} (>= ${minimumReleaseAge})`));
+        return true;
+      }
+      if (!silent) console.log(chalk67.red(`  minimumReleaseAge is ${value} (expected >= ${minimumReleaseAge})`));
+      return false;
+    }
+  }
+  if (!silent) console.log(chalk67.red(`  minimumReleaseAge is not set in pnpm-workspace.yaml (expected >= ${minimumReleaseAge})`));
+  return false;
+}
+function fixMinimumReleaseAge(cwd6, config2) {
+  if (detectPackageManager() !== "pnpm") return true;
+  const content = readPnpmWorkspaceYaml(cwd6);
+  if (!content) return false;
+  const { minimumReleaseAge } = config2;
+  const lines = content.split("\n");
+  let found = false;
+  const newLines = lines.map((line) => {
+    if (/^minimumReleaseAge\s*:/.test(line)) {
+      found = true;
+      return `minimumReleaseAge: ${minimumReleaseAge}`;
+    }
+    return line;
+  });
+  if (!found) {
+    const lastLine = newLines.at(-1);
+    if (lastLine === "") {
+      newLines.splice(-1, 0, `minimumReleaseAge: ${minimumReleaseAge}`);
+    } else {
+      newLines.push(`minimumReleaseAge: ${minimumReleaseAge}`);
+    }
+  }
+  writePnpmWorkspaceYaml(cwd6, newLines.join("\n"));
+  console.log(chalk67.green(`  Fixed: minimumReleaseAge set to ${minimumReleaseAge}`));
+  return true;
+}
+function checkMinimumReleaseAgeExclude(cwd6, config2, verbose, silent) {
+  if (detectPackageManager() !== "pnpm") return true;
+  const content = readPnpmWorkspaceYaml(cwd6);
+  if (!content) {
+    if (!silent) console.log(chalk67.red("  No pnpm-workspace.yaml found"));
+    return false;
+  }
+  const excludes = parseYamlListSection(content, "minimumReleaseAgeExclude");
+  const missing = config2.minimumReleaseAgeExclude.filter((scope) => !excludes.includes(scope));
+  if (missing.length === 0) {
+    if (verbose) console.log(chalk67.green("  minimumReleaseAgeExclude includes all required scopes"));
+    return true;
+  }
+  if (!silent) console.log(chalk67.red(`  minimumReleaseAgeExclude is missing: ${missing.join(", ")}`));
+  return false;
+}
+function fixMinimumReleaseAgeExclude(cwd6, config2) {
+  if (detectPackageManager() !== "pnpm") return true;
+  const content = readPnpmWorkspaceYaml(cwd6);
+  if (!content) return false;
+  const existingExcludes = parseYamlListSection(content, "minimumReleaseAgeExclude");
+  const toAdd = config2.minimumReleaseAgeExclude.filter((scope) => !existingExcludes.includes(scope));
+  if (toAdd.length === 0) return true;
+  const lines = content.split("\n");
+  const sectionIndex = lines.findIndex((line) => /^minimumReleaseAgeExclude\s*:/.test(line));
+  if (sectionIndex === -1) {
+    const newSection = ["minimumReleaseAgeExclude:", ...config2.minimumReleaseAgeExclude.map((s) => `  - ${s}`)];
+    const lastLine = lines.at(-1);
+    if (lastLine === "") {
+      lines.splice(-1, 0, ...newSection);
+    } else {
+      lines.push(...newSection);
+    }
+  } else {
+    let insertAt = sectionIndex + 1;
+    while (insertAt < lines.length && /^\s+-/.test(lines[insertAt])) {
+      insertAt++;
+    }
+    for (const scope of toAdd) {
+      lines.splice(insertAt, 0, `  - ${scope}`);
+      insertAt++;
+    }
+  }
+  writePnpmWorkspaceYaml(cwd6, lines.join("\n"));
+  console.log(chalk67.green(`  Fixed: added ${toAdd.join(", ")} to minimumReleaseAgeExclude`));
+  return true;
+}
+async function packmanLint({ fix: fix2, verbose } = {}) {
   const cwd6 = process.cwd();
+  const rootConfig = await loadConfig();
+  const packmanConfig = resolvePackmanConfig(rootConfig.commands ? rootConfig.commands.packman : void 0);
   let failures = 0;
-  for (const check of checks) {
-    if (verbose) console.log(chalk67.gray(`Checking: ${check.name}`));
-    const passed = check.check(cwd6, verbose, fix2);
-    if (!passed) {
-      if (fix2) {
-        const fixed = check.fix(cwd6, verbose);
-        if (!fixed) {
-          failures++;
-        }
-      } else {
-        failures++;
-      }
+  const enableScriptsPassed = checkEnableScripts(cwd6, verbose, fix2);
+  if (!enableScriptsPassed) {
+    if (fix2) {
+      if (!fixEnableScripts(cwd6)) failures++;
+    } else {
+      failures++;
+    }
+  }
+  const agePassed = checkMinimumReleaseAge(cwd6, packmanConfig, verbose, fix2);
+  if (!agePassed) {
+    if (fix2) {
+      if (!fixMinimumReleaseAge(cwd6, packmanConfig)) failures++;
+    } else {
+      failures++;
+    }
+  }
+  const excludePassed = checkMinimumReleaseAgeExclude(cwd6, packmanConfig, verbose, fix2);
+  if (!excludePassed) {
+    if (fix2) {
+      if (!fixMinimumReleaseAgeExclude(cwd6, packmanConfig)) failures++;
+    } else {
+      failures++;
     }
   }
   if (failures > 0) {
@@ -8264,14 +8396,14 @@ function lintPackages(cwd6) {
 function readmeLint({ config: config2, verbose }) {
   const cwd6 = INIT_CWD();
   console.log(chalk69.green("Readme Lint"));
-  const checks2 = [
+  const checks = [
     lintTemplate(cwd6),
     lintLogoConfig(cwd6, config2),
     lintPackages(cwd6)
   ];
   let errorCount = 0;
   let warningCount = 0;
-  for (const { errors, warnings } of checks2) {
+  for (const { errors, warnings } of checks) {
     for (const error of errors) {
       console.log(chalk69.red(`  \u2717 ${error}`));
       errorCount++;
@@ -9104,8 +9236,8 @@ var lintCommand = {
       type: "boolean"
     });
   },
-  handler: (argv) => {
-    process.exitCode = packmanLint({
+  handler: async (argv) => {
+    process.exitCode = await packmanLint({
       fix: !!argv.fix,
       verbose: !!argv.verbose
     });