@ankhorage/devtools 1.18.0 → 1.18.1

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.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) ![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.1",
   "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": {