@ankhorage/devtools 1.5.1 → 1.6.0

package/dist/policy/bunRuntimePolicy.d.ts

@@ -1,11 +1,23 @@
 /**
- * Canonical Bun runtime policy for Ankhorage repositories.
+ * Canonical runtime/tooling policies for Ankhorage repositories.
  *
- * Import this from `@ankhorage/devtools/policy` when another package needs to inspect
- * the managed Bun version without defining an independent version authority.
+ * Import these from `@ankhorage/devtools/policy` when another package needs to inspect
+ * the managed Bun or Node baseline without defining an independent version authority.
  */
 export declare const bunRuntimePolicy: {
     readonly packageManager: "bun@1.3.14";
     readonly typesRange: "^1.3.14";
     readonly version: "1.3.14";
 };
+/**
+ * Canonical Node LTS baseline for Node-based Ankhorage tooling and CI execution.
+ *
+ * Bun remains the repository package manager/primary command runtime where configured;
+ * this policy makes Node-based tooling deterministic instead of inheriting the ambient
+ * Node version from a CI runner image.
+ */
+export declare const nodeRuntimePolicy: {
+    readonly engineRange: "24.x";
+    readonly major: 24;
+    readonly setupVersion: "24";
+};

package/dist/policy/bunRuntimePolicy.js

@@ -1,11 +1,23 @@
 /**
- * Canonical Bun runtime policy for Ankhorage repositories.
+ * Canonical runtime/tooling policies for Ankhorage repositories.
  *
- * Import this from `@ankhorage/devtools/policy` when another package needs to inspect
- * the managed Bun version without defining an independent version authority.
+ * Import these from `@ankhorage/devtools/policy` when another package needs to inspect
+ * the managed Bun or Node baseline without defining an independent version authority.
  */
 export const bunRuntimePolicy = {
     packageManager: 'bun@1.3.14',
     typesRange: '^1.3.14',
     version: '1.3.14',
 };
+/**
+ * Canonical Node LTS baseline for Node-based Ankhorage tooling and CI execution.
+ *
+ * Bun remains the repository package manager/primary command runtime where configured;
+ * this policy makes Node-based tooling deterministic instead of inheriting the ambient
+ * Node version from a CI runner image.
+ */
+export const nodeRuntimePolicy = {
+    engineRange: '24.x',
+    major: 24,
+    setupVersion: '24',
+};

package/dist/tools/eslint/index.js

@@ -7,10 +7,8 @@
  *
  * Every profile includes the shared TypeScript, import, unused-import, Prettier, security, and
  * quality rules. The common quality limits are 50 effective lines per function, 300 effective
- * lines per file, and modified cyclomatic complexity 15. Forward exports are forbidden outside
- * declared package entrypoints and explicit `index.*` barrels so implementation files export only
- * symbols they own. React adds React and Hooks correctness rules; React Native composes the React
- * profile and adds focused React Native rules.
+ * lines per file, and modified cyclomatic complexity 15. React adds React and Hooks correctness
+ * rules; React Native composes the React profile and adds focused React Native rules.
  *
  * Repository-specific behavior stays additive: `additionalIgnores`, `restrictedImports`, and
  * `overrides` extend the central policy instead of replacing it. Narrow local overrides remain the
@@ -32,8 +30,6 @@ import securityPlugin from 'eslint-plugin-security';
 import simpleImportSort from 'eslint-plugin-simple-import-sort';
 import unusedImports from 'eslint-plugin-unused-imports';
 import tseslint from 'typescript-eslint';
-import { createModuleOwnershipConfig } from './moduleOwnership.js';
-import { resolvePackageEntrypointFiles } from './packageEntrypoints.js';
 import { resolveEslintProfile } from './profile.js';
 export const defaultIgnores = [
     '**/ios/**',
@@ -56,8 +52,7 @@ export const defaultRestrictedImports = [
 export function createConfig(options) {
     const normalized = normalizeOptions(options);
     const profile = resolveEslintProfile(options);
-    const packageEntrypoints = resolvePackageEntrypointFiles(options);
-    return defineConfig({ ignores: [...defaultIgnores, ...normalized.additionalIgnores] }, { ...js.configs.recommended, files: normalized.files }, ...createTypeCheckedConfigs(normalized), createBaseConfig(normalized), createModuleOwnershipConfig(normalized.files, packageEntrypoints), ...createProfileConfigs(profile, normalized.files), ...normalized.overrides, ...(normalized.includePrettier ? [prettierConfig] : []));
+    return defineConfig({ ignores: [...defaultIgnores, ...normalized.additionalIgnores] }, { ...js.configs.recommended, files: normalized.files }, ...createTypeCheckedConfigs(normalized), createBaseConfig(normalized), ...createProfileConfigs(profile, normalized.files), ...normalized.overrides, ...(normalized.includePrettier ? [prettierConfig] : []));
 }
 function normalizeOptions(options) {
     return {

package/dist/tools/workflows/files/ci.yml

@@ -24,6 +24,11 @@ jobs:
         with:
           bun-version: '__ANKH_BUN_VERSION__'
 
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '__ANKH_NODE_VERSION__'
+
       - name: Install dependencies
         run: bun install --frozen-lockfile
 

package/dist/tools/workflows/files/release.yml

@@ -32,7 +32,7 @@ jobs:
       - name: Setup Node for npm publishing
         uses: actions/setup-node@v4
         with:
-          node-version: 24
+          node-version: '__ANKH_NODE_VERSION__'
           registry-url: https://registry.npmjs.org
 
       - name: Update npm

package/dist/tools/workflows/index.js

@@ -1,6 +1,7 @@
 import { readFile } from 'node:fs/promises';
-import { bunRuntimePolicy } from '../../policy/bunRuntimePolicy.js';
+import { bunRuntimePolicy, nodeRuntimePolicy } from '../../policy/bunRuntimePolicy.js';
 const BUN_VERSION_TOKEN = '__ANKH_BUN_VERSION__';
+const NODE_VERSION_TOKEN = '__ANKH_NODE_VERSION__';
 export const workflowManagedFiles = [
     createWorkflowDefinition('.github/workflows/ci.yml', './files/ci.yml'),
     createWorkflowDefinition('.github/workflows/release.yml', './files/release.yml'),
@@ -11,7 +12,9 @@ function createWorkflowDefinition(relativePath, sourcePath) {
         relativePath,
         render: async () => {
             const template = await readFile(sourceUrl, 'utf8');
-            return template.replaceAll(BUN_VERSION_TOKEN, bunRuntimePolicy.version);
+            return template
+                .replaceAll(BUN_VERSION_TOKEN, bunRuntimePolicy.version)
+                .replaceAll(NODE_VERSION_TOKEN, nodeRuntimePolicy.setupVersion);
         },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "description": "Shared development tools and repository standards for Ankhorage",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",

package/dist/tools/eslint/moduleOwnership.d.ts

@@ -1,2 +0,0 @@
-import type { FlatConfigItem } from './types.js';
-export declare function createModuleOwnershipConfig(files: string[], packageEntrypoints?: string[]): FlatConfigItem;

package/dist/tools/eslint/moduleOwnership.js

@@ -1,64 +0,0 @@
-import { basename, normalize } from 'node:path';
-const INDEX_BARREL_FILE = /^index\.(?:ts|tsx|js|jsx|mts|cts|mjs|cjs)$/u;
-function isForwardExport(context, node) {
-    const tokens = context.sourceCode.getTokens(node);
-    if (tokens.at(0)?.value !== 'export')
-        return false;
-    return tokens.some((token, index) => token.value === 'from' && tokens.at(index + 1)?.type === 'String');
-}
-function isAllowedForwardExportFile(context) {
-    const filename = normalize(context.filename);
-    if (INDEX_BARREL_FILE.test(basename(filename)))
-        return true;
-    return readAllowedFiles(context.options.at(0)).some((file) => normalize(file) === filename);
-}
-function readAllowedFiles(value) {
-    if (!isRecord(value))
-        return [];
-    const { allowedFiles } = value;
-    if (!Array.isArray(allowedFiles))
-        return [];
-    return allowedFiles.filter((file) => typeof file === 'string');
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-const noForwardExportsRule = {
-    meta: {
-        type: 'problem',
-        schema: [
-            {
-                type: 'object',
-                properties: {
-                    allowedFiles: { type: 'array', items: { type: 'string' } },
-                },
-                additionalProperties: false,
-            },
-        ],
-        messages: {
-            forwardExport: 'Forward exports are forbidden outside package entrypoints and index barrels. Import directly from the owning module.',
-        },
-    },
-    create(context) {
-        if (isAllowedForwardExportFile(context))
-            return {};
-        return {
-            'Program > *'(node) {
-                if (isForwardExport(context, node))
-                    context.report({ node, messageId: 'forwardExport' });
-            },
-        };
-    },
-};
-const moduleOwnershipPlugin = {
-    rules: { 'no-forward-exports': noForwardExportsRule },
-};
-export function createModuleOwnershipConfig(files, packageEntrypoints = []) {
-    return {
-        files,
-        plugins: { ankhorage: moduleOwnershipPlugin },
-        rules: {
-            'ankhorage/no-forward-exports': ['error', { allowedFiles: packageEntrypoints }],
-        },
-    };
-}

package/dist/tools/eslint/packageEntrypoints.d.ts

@@ -1,2 +0,0 @@
-import type { DevtoolsConfigOptions } from './types.js';
-export declare function resolvePackageEntrypointFiles(options: DevtoolsConfigOptions): string[];

package/dist/tools/eslint/packageEntrypoints.js

@@ -1,47 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { resolveProjectPackageJsonPath } from './packageJsonPath.js';
-const SOURCE_EXTENSIONS = ['ts', 'tsx', 'js', 'jsx', 'mts', 'cts', 'mjs', 'cjs'];
-const OUTPUT_EXTENSION = /(?:\.d)?\.(?:ts|tsx|js|jsx|mts|cts|mjs|cjs)$/u;
-export function resolvePackageEntrypointFiles(options) {
-    const packageJsonPath = resolveProjectPackageJsonPath(options);
-    if (packageJsonPath === null)
-        return [];
-    const packageJson = readPackageJson(packageJsonPath);
-    const targets = [
-        ...collectStringTargets(packageJson.main),
-        ...collectStringTargets(packageJson.types),
-        ...collectStringTargets(packageJson.exports),
-    ];
-    return [...new Set(targets.flatMap((target) => toSourceCandidates(target, packageJsonPath)))];
-}
-function readPackageJson(packageJsonPath) {
-    const parsed = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
-    if (!isRecord(parsed)) {
-        throw new Error(`Expected package.json to contain a JSON object: ${packageJsonPath}`);
-    }
-    return parsed;
-}
-function collectStringTargets(value) {
-    if (typeof value === 'string')
-        return [value];
-    if (Array.isArray(value))
-        return value.flatMap(collectStringTargets);
-    if (!isRecord(value))
-        return [];
-    return Object.values(value).flatMap(collectStringTargets);
-}
-function toSourceCandidates(target, packageJsonPath) {
-    const normalizedTarget = target.replace(/^\.\//u, '');
-    const sourceTarget = normalizedTarget.startsWith('dist/')
-        ? `src/${normalizedTarget.slice('dist/'.length)}`
-        : normalizedTarget;
-    if (!sourceTarget.startsWith('src/'))
-        return [];
-    const sourceBase = sourceTarget.replace(OUTPUT_EXTENSION, '');
-    const absoluteBase = resolve(dirname(packageJsonPath), sourceBase);
-    return SOURCE_EXTENSIONS.map((extension) => `${absoluteBase}.${extension}`);
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}