@ankhorage/devtools 1.21.1 → 1.21.3

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/devtools
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v1.21.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)
+![license: MIT](././paradox/badges/license.svg) ![npm: v1.21.3](././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
 

package/dist/tools/skills/assets/ankhorage-project-structure/SKILL.md

@@ -163,7 +163,13 @@ belong together in `ankhorage/navigator/src/constants/navigator.ts`.
 `utils/` is the only utility directory name. Do not create `shared/`, `helper/`, `helpers/`,
 `common/`, or equivalent catch-all folders. It is not a destination for every pure function or type.
 
-Apply **reuse before implementation** and **shared by default** before choosing a local owner. For
+Apply **reuse before implementation** and **shared by default** before choosing a local owner.
+
+Treat the **second equivalent generic implementation as the duplication threshold**. When the same
+general-purpose regex, parser pattern, formatter, validator, algorithm, or static policy appears in
+two places, stop copying it and resolve its canonical shared owner. For runtime-neutral reusable
+behavior or patterns, inspect and extend `@ankhorage/utility` first. Do not wait for a third copy,
+and do not create repo-local aliases around the shared implementation. For
 every function that could reasonably be reused across repositories, you MUST first inspect the
 published `@ankhorage/utility` public API and its owning topic. Reuse the existing export when its
 semantics match. If the function is missing and is generic without product, manifest, or framework

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

@@ -372,7 +372,8 @@ jobs:
             };
             if (
               !/^@ankhorage\/[a-z0-9][a-z0-9-]*$/.test(release.name ?? '') ||
-              !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(release.version ?? '') ||
+              typeof release.version !== 'string' ||
+              release.version.length === 0 ||
               !/^ankhorage\/[a-z0-9-]+$/.test(release.sourceRepository ?? '')
             ) {
               throw new Error(

package/dist/tools/workflows/files/renovate.json5

@@ -1,5 +1,7 @@
 /**
- * @readme
+ * Repository configuration
+ *
+ * Loads the canonical Ankhorage dependency-update policy from its default branch.
  */
 {
   $schema: 'https://docs.renovatebot.com/renovate-schema.json',

package/dist/tools/workflows/index.js

@@ -5,6 +5,7 @@ import { resolveStructureReleaseCommandAsync } from '../../features/structure-de
 import { bunRuntimePolicy, nodeRuntimePolicy } from '../../policy/bunRuntimePolicy.js';
 import { resolvePkgvizAuditPolicyAsync } from '../../policy/resolvePkgvizAuditPolicyAsync.js';
 import { readCurrentDoctorVersion } from './readCurrentDoctorVersion.js';
+import { renderRenovateConfigAsync } from './renderRenovateConfigAsync.js';
 import { renderRenovateWorkflowAsync } from './renderRenovateWorkflowAsync.js';
 import { renderWorkflowAsync } from './renderWorkflowAsync.js';
 export const workflowManagedFiles = [
@@ -26,8 +27,7 @@ export const workflowManagedFiles = [
     createRenovateWorkflowDefinition(),
     {
         relativePath: 'renovate.json5',
-        sourceUrl: new URL('./files/renovate.json5', import.meta.url),
-        mode: 'create-only',
+        render: renderRenovateConfigAsync,
     },
 ];
 /*** Create a managed workflow definition rendered from current shared runtime policies. */

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

@@ -0,0 +1,2 @@
+/*** Render Renovate config while preserving repository-owned rules and removing obsolete Paradox metadata. */
+export declare function renderRenovateConfigAsync(targetDirectory: string): Promise<string>;

package/dist/tools/workflows/renderRenovateConfigAsync.js

@@ -0,0 +1,35 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const TEMPLATE_URL = new URL('./files/renovate.json5', import.meta.url);
+const LEGACY_HEADER_PATTERN = /^\/\*\*\*([\s\S]*?)\*\/\n/u;
+/*** Render Renovate config while preserving repository-owned rules and removing obsolete Paradox metadata. */
+export async function renderRenovateConfigAsync(targetDirectory) {
+    const targetPath = join(targetDirectory, 'renovate.json5');
+    let current;
+    try {
+        current = await readFile(targetPath, 'utf8');
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return await readFile(TEMPLATE_URL, 'utf8');
+        }
+        throw error;
+    }
+    return migrateLegacyRenovateHeader(current);
+}
+/*** Convert the historical managed Paradox header to an ordinary comment without changing config data. */
+function migrateLegacyRenovateHeader(contents) {
+    const match = LEGACY_HEADER_PATTERN.exec(contents);
+    if (match === null)
+        return contents;
+    const [header, body = ''] = match;
+    if (!body.includes('Repository configuration'))
+        return contents;
+    if (!body.includes('@usage') && !body.includes('@readme'))
+        return contents;
+    const migratedBody = body
+        .split('\n')
+        .filter((line) => !/^\s*\*\s+@(usage|readme)\s*$/u.test(line))
+        .join('\n');
+    return `/**${migratedBody}*/\n${contents.slice(header.length)}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "1.21.1",
+  "version": "1.21.3",
   "description": "Shared tooling, repository automation, runtime policies, and agent standards for Ankhorage TypeScript projects",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",