@ankhorage/devtools 2.0.116 → 2.1.1

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/devtools
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v2.0.116](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v2.1.1](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
 
 Shared tooling, repository automation, and agent standards for Ankhorage TypeScript projects
 

package/dist/owner/synchronizeRenovateOwnerAsync.js

@@ -1,11 +1,10 @@
 import { spawn } from 'node:child_process';
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, resolve } from 'node:path';
-import { REPOSITORY_POLICY } from '@ankhorage/policy/repository';
+import { REPOSITORY_RULE_METADATA } from '@ankhorage/rules-repository';
 import { resolveApmReleaseCommandAsync } from '../features/apm-release-validation/adapters/outbound/resolveApmReleaseCommandAsync.js';
 import { resolveStructureReleaseCommandAsync } from '../features/structure-descriptor-generation/adapters/outbound/resolveStructureReleaseCommandAsync.js';
 import { applyBunRuntimePolicy } from '../policy/applyBunRuntimePolicy.js';
-import { DEVTOOLS_BUN_RUNTIME_POLICY } from '../policy/bunRuntimePolicy.js';
 import { readCurrentDoctorVersion } from '../tools/workflows/readCurrentDoctorVersion.js';
 import { renderRenovateWorkflowAsync } from '../tools/workflows/renderRenovateWorkflowAsync.js';
 import { renderWorkflowAsync, } from '../tools/workflows/renderWorkflowAsync.js';
@@ -61,9 +60,9 @@ async function createWorkflowPolicyAsync(targetDirectory) {
     return {
         apmReleaseCommand: await resolveApmReleaseCommandAsync(targetDirectory),
         structureReleaseCommand: await resolveStructureReleaseCommandAsync(targetDirectory),
-        bunVersion: DEVTOOLS_BUN_RUNTIME_POLICY.version,
+        bunVersion: REPOSITORY_RULE_METADATA.runtime.bun.version,
         doctorVersion: readCurrentDoctorVersion(),
-        nodeVersion: REPOSITORY_POLICY.runtime.node.setupVersion,
+        nodeVersion: REPOSITORY_RULE_METADATA.runtime.node.setupVersion,
     };
 }
 /*** Return owner-managed artifact paths whose current bytes differ from policy output. */

package/dist/policy/applyBunRuntimePolicy.d.ts

@@ -1,2 +1,2 @@
-/*** Apply the Devtools-owned Bun runtime policy to one package manifest. */
+/*** Apply the Rules-owned Bun runtime contract to one package manifest. */
 export declare function applyBunRuntimePolicy(manifest: Record<string, unknown>): Record<string, unknown>;

package/dist/policy/applyBunRuntimePolicy.js

@@ -1,17 +1,19 @@
-import { DEVTOOLS_BUN_RUNTIME_POLICY } from './bunRuntimePolicy.js';
-/*** Apply the Devtools-owned Bun runtime policy to one package manifest. */
+import { REPOSITORY_RULE_METADATA } from '@ankhorage/rules-repository';
+/*** Apply the Rules-owned Bun runtime contract to one package manifest. */
 export function applyBunRuntimePolicy(manifest) {
     const devDependencies = toRecord(manifest.devDependencies);
-    devDependencies['@types/bun'] = DEVTOOLS_BUN_RUNTIME_POLICY.typesRange;
+    devDependencies['@types/bun'] = REPOSITORY_RULE_METADATA.runtime.bun.typesRange;
     return {
         ...manifest,
-        packageManager: DEVTOOLS_BUN_RUNTIME_POLICY.packageManager,
+        packageManager: REPOSITORY_RULE_METADATA.runtime.bun.packageManager,
         devDependencies,
     };
 }
+/*** Narrow an unknown JSON-like value to a non-array record. */
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+/*** Copy a JSON-like value to a mutable record or return an empty record. */
 function toRecord(value) {
     return isRecord(value) ? { ...value } : {};
 }

package/dist/policy/renderBunPolicyDocumentation.d.ts

@@ -1,2 +1,2 @@
-/*** Render the managed Bun policy section while preserving the surrounding guide. */
+/*** Render the managed Bun Rules section while preserving the surrounding guide. */
 export declare function renderBunPolicyDocumentation(readme: string): string;

package/dist/policy/renderBunPolicyDocumentation.js

@@ -1,5 +1,5 @@
-import { DEVTOOLS_BUN_RUNTIME_POLICY } from './bunRuntimePolicy.js';
-/*** Render the managed Bun policy section while preserving the surrounding guide. */
+import { REPOSITORY_RULE_METADATA } from '@ankhorage/rules-repository';
+/*** Render the managed Bun Rules section while preserving the surrounding guide. */
 export function renderBunPolicyDocumentation(readme) {
     const startIndex = readme.indexOf(README_POLICY_START);
     const endIndex = readme.indexOf(README_POLICY_END);
@@ -15,10 +15,11 @@ export function renderBunPolicyDocumentation(readme) {
 }
 /*** Format canonical runtime and type-package versions for the guide. */
 function renderReadmePolicy() {
+    const { packageManager, typesRange, version } = REPOSITORY_RULE_METADATA.runtime.bun;
     return `\`\`\`text
-Bun runtime       ${DEVTOOLS_BUN_RUNTIME_POLICY.version}
-packageManager    ${DEVTOOLS_BUN_RUNTIME_POLICY.packageManager}
-@types/bun        ${DEVTOOLS_BUN_RUNTIME_POLICY.typesRange}
+Bun runtime       ${version}
+packageManager    ${packageManager}
+@types/bun        ${typesRange}
 \`\`\``;
 }
 const README_POLICY_END = '<!-- devtools-bun-policy:end -->';

package/dist/policy/resolvePkgvizAuditPolicyAsync.js

@@ -1,11 +1,11 @@
 import { stat } from 'node:fs/promises';
 import { join } from 'node:path';
-import { REPOSITORY_POLICY } from '@ankhorage/policy/repository';
+import { REPOSITORY_RULE_METADATA } from '@ankhorage/rules-repository';
 /*** Resolve the central PKGViz CI audit for repositories with analyzable source. */
 export async function resolvePkgvizAuditPolicyAsync(targetDirectory) {
     if (!(await hasSourceDirectoryAsync(targetDirectory)))
         return undefined;
-    const { artifactName, artifactPath, command } = REPOSITORY_POLICY.pkgvizAudit;
+    const { artifactName, artifactPath, command } = REPOSITORY_RULE_METADATA.pkgvizAudit;
     return { artifactName, artifactPath, command };
 }
 /*** Detect whether the managed repository has a source tree that PKGViz can inspect. */

package/dist/tools/package/index.js

@@ -20,9 +20,8 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { readFile, writeFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
-import { REPOSITORY_POLICY } from '@ankhorage/policy/repository';
+import { REPOSITORY_RULE_METADATA } from '@ankhorage/rules-repository';
 import { applyBunRuntimePolicy } from '../../policy/applyBunRuntimePolicy.js';
-import { DEVTOOLS_BUN_RUNTIME_POLICY } from '../../policy/bunRuntimePolicy.js';
 const PACKAGE_PATH = 'package.json';
 const DEVTOOLS_PACKAGE_NAME = '@ankhorage/devtools';
 const BUN_TYPES_PACKAGE_NAME = '@types/bun';
@@ -93,12 +92,12 @@ export function applyManagedPackageContract(manifest, devtoolsVersion, changeset
     delete scripts.knip;
     Object.assign(scripts, STANDARD_SCRIPTS);
     if (changesetsEnabled) {
-        Object.assign(scripts, REPOSITORY_POLICY.changesets.packageScripts);
+        Object.assign(scripts, REPOSITORY_RULE_METADATA.changesets.packageScripts);
     }
     const devDependencies = removeOwnedDependencies(toRecord(manifest.devDependencies));
     const dependencies = toRecord(manifest.dependencies);
-    delete dependencies[REPOSITORY_POLICY.changesets.packageName];
-    delete devDependencies[REPOSITORY_POLICY.changesets.packageName];
+    delete dependencies[REPOSITORY_RULE_METADATA.changesets.packageName];
+    delete devDependencies[REPOSITORY_RULE_METADATA.changesets.packageName];
     applyDevtoolsDependencyPlacement(dependencies, devDependencies, devtoolsVersion);
     return applyBunRuntimePolicy({
         ...manifest,
@@ -121,8 +120,8 @@ export function isManagedPackageContractCurrent(manifest, devtoolsVersion, chang
     const changesetsEnabled = isChangesetsEnabled(scripts, changesetsConfigExists);
     return (hasStandardScripts(scripts) &&
         DEVTOOLS_OWNED_DEV_DEPENDENCIES.every((name) => devDependencies[name] === undefined) &&
-        dependencies[REPOSITORY_POLICY.changesets.packageName] === undefined &&
-        devDependencies[REPOSITORY_POLICY.changesets.packageName] === undefined &&
+        dependencies[REPOSITORY_RULE_METADATA.changesets.packageName] === undefined &&
+        devDependencies[REPOSITORY_RULE_METADATA.changesets.packageName] === undefined &&
         hasCurrentChangesetsScripts(scripts, changesetsEnabled) &&
         hasCurrentDevtoolsDependencyPlacement(dependencies, devDependencies, devtoolsVersion));
 }
@@ -155,8 +154,8 @@ async function readPackageManifest(targetDirectory) {
 /*** Check the Bun package manager and Bun type dependency contract. */
 function hasCurrentBunRuntimePolicy(manifest) {
     const devDependencies = toRecord(manifest.devDependencies);
-    return (manifest.packageManager === DEVTOOLS_BUN_RUNTIME_POLICY.packageManager &&
-        devDependencies[BUN_TYPES_PACKAGE_NAME] === DEVTOOLS_BUN_RUNTIME_POLICY.typesRange);
+    return (manifest.packageManager === REPOSITORY_RULE_METADATA.runtime.bun.packageManager &&
+        devDependencies[BUN_TYPES_PACKAGE_NAME] === REPOSITORY_RULE_METADATA.runtime.bun.typesRange);
 }
 /*** Place Devtools in development dependencies for every consuming repository. */
 function applyDevtoolsDependencyPlacement(dependencies, devDependencies, devtoolsVersion) {
@@ -189,12 +188,12 @@ function hasStandardScripts(scripts) {
 /*** Check Changesets scripts when the repository participates in Changesets. */
 function hasCurrentChangesetsScripts(scripts, changesetsEnabled) {
     return (!changesetsEnabled ||
-        Object.entries(REPOSITORY_POLICY.changesets.packageScripts).every(([name, command]) => scripts[name] === command));
+        Object.entries(REPOSITORY_RULE_METADATA.changesets.packageScripts).every(([name, command]) => scripts[name] === command));
 }
 /*** Determine whether the repository participates in Changesets synchronization. */
 function isChangesetsEnabled(scripts, changesetsConfigExists) {
     return (changesetsConfigExists ||
-        Object.keys(REPOSITORY_POLICY.changesets.packageScripts).some((scriptName) => scripts[scriptName] !== undefined));
+        Object.keys(REPOSITORY_RULE_METADATA.changesets.packageScripts).some((scriptName) => scripts[scriptName] !== undefined));
 }
 /*** Serialize a package manifest using the repository formatting contract. */
 function serializePackageManifest(manifest) {

package/dist/tools/skills/assets/ankhorage-coding-rules/SKILL.md

@@ -53,7 +53,7 @@ exceptions or replaced by generic preferences from this skill.
   reason behind a decision. Do not narrate self-explanatory code or duplicate what names and types
   already express.
 - Paradox documentation metadata belongs only inside `/*** ... */` comments. The canonical tag
-  vocabulary is owned by `@ankhorage/policy`: `@readme`, `@usage`, `@config`, `@title`,
+  vocabulary is owned by `@ankhorage/rules-documentation`: `@readme`, `@usage`, `@config`, `@title`,
   `@see`, and `@security`. Unsupported tag-shaped lines are invalid; `@example` does not exist.
   Do not use JSDoc-only tags such as `@param` or `@returns` as Paradox metadata.
 - Paradox comments contain documentation prose and metadata only. Fenced or indented code blocks are

package/dist/tools/workflows/index.js

@@ -1,9 +1,8 @@
 import { access } from 'node:fs/promises';
 import { join } from 'node:path';
-import { REPOSITORY_POLICY } from '@ankhorage/policy/repository';
+import { REPOSITORY_RULE_METADATA } from '@ankhorage/rules-repository';
 import { resolveApmReleaseCommandAsync } from '../../features/apm-release-validation/adapters/outbound/resolveApmReleaseCommandAsync.js';
 import { resolveStructureReleaseCommandAsync } from '../../features/structure-descriptor-generation/adapters/outbound/resolveStructureReleaseCommandAsync.js';
-import { DEVTOOLS_BUN_RUNTIME_POLICY } from '../../policy/bunRuntimePolicy.js';
 import { resolvePkgvizAuditPolicyAsync } from '../../policy/resolvePkgvizAuditPolicyAsync.js';
 import { readCurrentDoctorVersion } from './readCurrentDoctorVersion.js';
 import { renderRenovateConfigAsync } from './renderRenovateConfigAsync.js';
@@ -39,9 +38,9 @@ function createWorkflowDefinition(relativePath, sourcePath) {
         render: async (targetDirectory) => await renderWorkflowAsync(sourceUrl, {
             apmReleaseCommand: await resolveApmReleaseCommandAsync(targetDirectory),
             structureReleaseCommand: await resolveStructureReleaseCommandAsync(targetDirectory),
-            bunVersion: DEVTOOLS_BUN_RUNTIME_POLICY.version,
+            bunVersion: REPOSITORY_RULE_METADATA.runtime.bun.version,
             doctorVersion: readCurrentDoctorVersion(),
-            nodeVersion: REPOSITORY_POLICY.runtime.node.setupVersion,
+            nodeVersion: REPOSITORY_RULE_METADATA.runtime.node.setupVersion,
             pkgvizAudit: await resolvePkgvizAuditPolicyAsync(targetDirectory),
         }),
     };
@@ -54,9 +53,9 @@ function createRenovateWorkflowDefinition() {
         render: async (targetDirectory) => await renderRenovateWorkflowAsync(sourceUrl, targetDirectory, {
             apmReleaseCommand: await resolveApmReleaseCommandAsync(targetDirectory),
             structureReleaseCommand: await resolveStructureReleaseCommandAsync(targetDirectory),
-            bunVersion: DEVTOOLS_BUN_RUNTIME_POLICY.version,
+            bunVersion: REPOSITORY_RULE_METADATA.runtime.bun.version,
             doctorVersion: readCurrentDoctorVersion(),
-            nodeVersion: REPOSITORY_POLICY.runtime.node.setupVersion,
+            nodeVersion: REPOSITORY_RULE_METADATA.runtime.node.setupVersion,
         }),
     };
 }

package/dist/tools/workflows/renderWorkflowAsync.js

@@ -1,14 +1,14 @@
 import { readFile } from 'node:fs/promises';
-import { REPOSITORY_POLICY } from '@ankhorage/policy/repository';
+import { REPOSITORY_RULE_METADATA } from '@ankhorage/rules-repository';
 /*** Renders one workflow template with the canonical runtime, Doctor, and Changesets policy. */
 export async function renderWorkflowAsync(sourceUrl, policy) {
     const template = await readFile(sourceUrl, 'utf8');
     const rendered = template
         .replaceAll(BUN_VERSION_TOKEN, policy.bunVersion)
         .replaceAll(PKGVIZ_AUDIT_STEPS_TOKEN, renderPkgvizAuditSteps(policy))
-        .replaceAll(CHANGESETS_PUBLISH_COMMAND_TOKEN, REPOSITORY_POLICY.changesets.workflowCommands.publish)
-        .replaceAll(CHANGESETS_STATUS_COMMAND_TOKEN, REPOSITORY_POLICY.changesets.workflowCommands.status)
-        .replaceAll(CHANGESETS_VERSION_COMMAND_TOKEN, REPOSITORY_POLICY.changesets.workflowCommands.version)
+        .replaceAll(CHANGESETS_PUBLISH_COMMAND_TOKEN, REPOSITORY_RULE_METADATA.changesets.workflowCommands.publish)
+        .replaceAll(CHANGESETS_STATUS_COMMAND_TOKEN, REPOSITORY_RULE_METADATA.changesets.workflowCommands.status)
+        .replaceAll(CHANGESETS_VERSION_COMMAND_TOKEN, REPOSITORY_RULE_METADATA.changesets.workflowCommands.version)
         .replaceAll(DOCTOR_VERSION_TOKEN, policy.doctorVersion)
         .replaceAll('__ANKH_APM_RELEASE_COMMAND__', policy.apmReleaseCommand ?? './node_modules/.bin/ankhorage-apm-release')
         .replaceAll('__ANKH_STRUCTURE_RELEASE_COMMAND__', policy.structureReleaseCommand ?? './node_modules/.bin/ankhorage-structure')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "2.0.116",
+  "version": "2.1.1",
   "description": "Shared tooling, repository automation, and agent standards for Ankhorage TypeScript projects",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",
@@ -122,7 +122,9 @@
   },
   "dependencies": {
     "@ankhorage/apm": "^0.8.13",
+    "@ankhorage/contracts": "^22.8.93",
     "@ankhorage/project-detector": "^0.3.3",
+    "@ankhorage/rules-repository": "^0.2.0",
     "@ankhorage/utility": "^0.5.5",
     "@changesets/cli": "^3.0.3",
     "@eslint/compat": "^2.1.1",
@@ -140,15 +142,13 @@
     "eslint-plugin-unused-imports": "^4.4.1",
     "knip": "^6.39.0",
     "prettier": "^3.9.9",
-    "typescript-eslint": "^8.71.0",
-    "@ankhorage/contracts": "^22.8.93",
     "typescript": "~6.0.3",
-    "@ankhorage/policy": "^0.6.0"
+    "typescript-eslint": "^8.71.0"
   },
   "devDependencies": {
-    "@ankhorage/paradox": "^0.2.25",
+    "@ankhorage/paradox": "^0.2.26",
     "@ankhorage/ankh": "^0.10.80",
-    "@ankhorage/doctor": "0.11.94",
+    "@ankhorage/doctor": "0.12.0",
     "@techstark/opencv-js": "^5.0.0-release.1",
     "@types/bun": "^1.4.2",
     "@types/node": "^26.6.4",

package/dist/policy/bunRuntimePolicy.d.ts

@@ -1,5 +0,0 @@
-export declare const DEVTOOLS_BUN_RUNTIME_POLICY: {
-    readonly packageManager: "bun@1.4.2";
-    readonly typesRange: "^1.4.2";
-    readonly version: "1.4.2";
-};

package/dist/policy/bunRuntimePolicy.js

@@ -1,5 +0,0 @@
-export const DEVTOOLS_BUN_RUNTIME_POLICY = {
-    packageManager: 'bun@1.4.2',
-    typesRange: '^1.4.2',
-    version: '1.4.2',
-};