@ankhorage/devtools 1.18.0 → 1.18.2

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/devtools
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v1.18.0](././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) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v1.18.2](././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) ![docs: paradox](././paradox/badges/docs.svg)
 
 Shared tooling, repository automation, runtime policies, and agent standards for Ankhorage TypeScript projects
 
@@ -479,6 +479,7 @@ bunx @ankhorage/devtools ankhorage-changeset
 bunx @ankhorage/devtools ankhorage-eslint
 bunx @ankhorage/devtools ankhorage-knip
 bunx @ankhorage/devtools ankhorage-prettier
+bunx @ankhorage/devtools ankhorage-structure
 ```
 
 ## Generated documentation

package/dist/cli/bin/structure.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/bin/structure.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { runStructureGenerationCommandAsync } from '../../features/structure-descriptor-generation/adapters/inbound/runStructureGenerationCommandAsync.js';
+const [operation, ...argv] = process.argv.slice(2);
+if (operation !== 'build' && operation !== 'check') {
+    console.error('Usage: ankhorage-structure <build|check> [directory]');
+    process.exitCode = 1;
+}
+else {
+    const result = await runStructureGenerationCommandAsync(operation, argv, {
+        cwd: process.cwd(),
+        writeStdout: (text) => process.stdout.write(text),
+        writeStderr: (text) => process.stderr.write(text),
+    });
+    process.exitCode = result.exitCode;
+}

package/dist/features/structure-descriptor-generation/adapters/outbound/resolveStructureReleaseCommandAsync.d.ts

@@ -0,0 +1,2 @@
+/*** Use Devtools' built structure CLI for self-release and the installed binary in consumers. */
+export declare function resolveStructureReleaseCommandAsync(targetDirectory: string): Promise<string>;

package/dist/features/structure-descriptor-generation/adapters/outbound/resolveStructureReleaseCommandAsync.js

@@ -0,0 +1,21 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+/*** Use Devtools' built structure CLI for self-release and the installed binary in consumers. */
+export async function resolveStructureReleaseCommandAsync(targetDirectory) {
+    try {
+        const packageJson = JSON.parse(await readFile(resolve(targetDirectory, 'package.json'), 'utf8'));
+        return isPackageNamed(packageJson, '@ankhorage/devtools') ? SELF_COMMAND : CONSUMER_COMMAND;
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return CONSUMER_COMMAND;
+        }
+        throw error;
+    }
+}
+/*** Narrow a package manifest by its canonical package name. */
+function isPackageNamed(value, expectedName) {
+    return (typeof value === 'object' && value !== null && 'name' in value && value.name === expectedName);
+}
+const SELF_COMMAND = 'node ./dist/cli/bin/structure.js';
+const CONSUMER_COMMAND = './node_modules/.bin/ankhorage-structure';

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

@@ -114,6 +114,9 @@ jobs:
           after_version="$(node -p "require('./package.json').version")"
 
           if [ "$before_version" != "$after_version" ]; then
+            if node -e "const p=require('./package.json'); process.exit(p.ankh?.structure === undefined ? 1 : 0)"; then
+              __ANKH_STRUCTURE_RELEASE_COMMAND__ build .
+            fi
             if node -e "const p=require('./package.json'); process.exit(p.scripts?.docs ? 0 : 1)"; then
               bun run docs
             else

package/dist/tools/workflows/index.js

@@ -1,6 +1,7 @@
 import { access } from 'node:fs/promises';
 import { join } from 'node:path';
 import { resolveApmReleaseCommandAsync } from '../../features/apm-release-validation/adapters/outbound/resolveApmReleaseCommandAsync.js';
+import { resolveStructureReleaseCommandAsync } from '../../features/structure-descriptor-generation/adapters/outbound/resolveStructureReleaseCommandAsync.js';
 import { bunRuntimePolicy, nodeRuntimePolicy } from '../../policy/bunRuntimePolicy.js';
 import { readCurrentDoctorVersion } from './readCurrentDoctorVersion.js';
 import { renderRenovateWorkflowAsync } from './renderRenovateWorkflowAsync.js';
@@ -35,6 +36,7 @@ function createWorkflowDefinition(relativePath, sourcePath) {
         relativePath,
         render: async (targetDirectory) => await renderWorkflowAsync(sourceUrl, {
             apmReleaseCommand: await resolveApmReleaseCommandAsync(targetDirectory),
+            structureReleaseCommand: await resolveStructureReleaseCommandAsync(targetDirectory),
             bunVersion: bunRuntimePolicy.version,
             doctorVersion: readCurrentDoctorVersion(),
             nodeVersion: nodeRuntimePolicy.setupVersion,
@@ -48,6 +50,7 @@ function createRenovateWorkflowDefinition() {
         relativePath: '.github/workflows/renovate.yml',
         render: async (targetDirectory) => await renderRenovateWorkflowAsync(sourceUrl, targetDirectory, {
             apmReleaseCommand: await resolveApmReleaseCommandAsync(targetDirectory),
+            structureReleaseCommand: await resolveStructureReleaseCommandAsync(targetDirectory),
             bunVersion: bunRuntimePolicy.version,
             doctorVersion: readCurrentDoctorVersion(),
             nodeVersion: nodeRuntimePolicy.setupVersion,

package/dist/tools/workflows/renderWorkflowAsync.d.ts

@@ -3,6 +3,7 @@ export interface WorkflowPolicy {
     readonly doctorVersion: string;
     readonly nodeVersion: string;
     readonly apmReleaseCommand?: string;
+    readonly structureReleaseCommand?: string;
 }
 /*** Renders one workflow template with the canonical runtime, Doctor, and Changesets policy. */
 export declare function renderWorkflowAsync(sourceUrl: URL, policy: WorkflowPolicy): Promise<string>;

package/dist/tools/workflows/renderWorkflowAsync.js

@@ -10,6 +10,7 @@ export async function renderWorkflowAsync(sourceUrl, policy) {
         .replaceAll(CHANGESETS_VERSION_COMMAND_TOKEN, changesetsPolicy.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')
         .replaceAll(NODE_VERSION_TOKEN, policy.nodeVersion);
 }
 const BUN_VERSION_TOKEN = '__ANKH_BUN_VERSION__';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "1.18.0",
+  "version": "1.18.2",
   "description": "Shared tooling, repository automation, runtime policies, and agent standards for Ankhorage TypeScript projects",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",
@@ -66,7 +66,8 @@
     "ankhorage-eslint": "./dist/cli/bin/eslint.js",
     "ankhorage-knip": "./dist/cli/bin/knip.js",
     "ankhorage-prettier": "./dist/cli/bin/prettier.js",
-    "ankhorage-apm-release": "./dist/cli/bin/apm-release.js"
+    "ankhorage-apm-release": "./dist/cli/bin/apm-release.js",
+    "ankhorage-structure": "./dist/cli/bin/structure.js"
   },
   "exports": {
     "./cli": {
@@ -143,20 +144,17 @@
     "knip": "^6.34.0",
     "prettier": "^3.9.6",
     "typescript-eslint": "^8.69.0",
-    "@ankhorage/contracts": "^22.1.1"
+    "@ankhorage/contracts": "^22.1.1",
+    "typescript": "~6.0.3"
   },
   "devDependencies": {
     "@ankhorage/paradox": "^0.1.26",
     "@ankhorage/ankh": "^0.8.11",
-    "@ankhorage/doctor": "0.10.14",
+    "@ankhorage/doctor": "0.10.26",
     "@techstark/opencv-js": "^5.0.0-release.1",
     "@types/bun": "^1.4.1",
     "@types/node": "^26.4.1",
-    "sharp": "^0.35.4",
-    "typescript": "~6.0.3"
+    "sharp": "^0.35.4"
   },
-  "packageManager": "bun@1.4.2",
-  "peerDependencies": {
-    "typescript": ">=5.9.3 <7"
-  }
+  "packageManager": "bun@1.4.2"
 }