@ankhorage/devtools 1.9.5 → 1.10.0

package/dist/tools/skills/managed.js

@@ -2,7 +2,7 @@ import { lstat, mkdir, readdir, readFile, rmdir, unlink, writeFile } from 'node:
 import { dirname, join, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { assertManagedSkillPath, createManifestContents, isNodeError, MANIFEST_PATH, readManagedSkillsManifest, resolveManagedPath, SKILLS_ROOT, } from './manifest.js';
-const CANONICAL_SKILL_NAMES = ['ankhorage-coding-rules', 'ankhorage-project-structure'];
+import { selectManagedSkillNames } from './selection.js';
 export async function inspectManagedSkills(targetDirectory, devtoolsVersion) {
     return (await createManagedSkillPlan(targetDirectory, devtoolsVersion)).statuses;
 }
@@ -56,9 +56,9 @@ async function assertNoSymlinkSegments(targetDirectory, relativePath) {
         }
     }
 }
-async function collectCanonicalSkillFiles() {
+async function collectCanonicalSkillFiles(skillNames) {
     const contentsByPath = new Map();
-    for (const skillName of CANONICAL_SKILL_NAMES) {
+    for (const skillName of skillNames) {
         const sourceDirectory = fileURLToPath(new URL(`./assets/${skillName}/`, import.meta.url));
         const files = await readDirectoryFiles(sourceDirectory);
         assertSkillName(skillName, files);
@@ -68,9 +68,9 @@ async function collectCanonicalSkillFiles() {
     }
     return contentsByPath;
 }
-async function collectObsoletePaths(targetDirectory, desiredPaths, previousManifest) {
+async function collectObsoletePaths(targetDirectory, desiredPaths, previousManifest, skillNames) {
     const obsoletePaths = new Set();
-    for (const skillName of CANONICAL_SKILL_NAMES) {
+    for (const skillName of skillNames) {
         const skillRoot = `${SKILLS_ROOT}/${skillName}`;
         for (const existingPath of await readTargetDirectoryFiles(targetDirectory, skillRoot)) {
             if (!desiredPaths.has(existingPath)) {
@@ -80,7 +80,7 @@ async function collectObsoletePaths(targetDirectory, desiredPaths, previousManif
     }
     if (previousManifest !== null) {
         for (const [skillName, entry] of Object.entries(previousManifest.skills)) {
-            if (CANONICAL_SKILL_NAMES.includes(skillName)) {
+            if (skillNames.includes(skillName)) {
                 continue;
             }
             for (const managedPath of Object.keys(entry.files)) {
@@ -94,14 +94,15 @@ async function collectObsoletePaths(targetDirectory, desiredPaths, previousManif
 }
 async function createManagedSkillPlan(targetDirectory, devtoolsVersion) {
     const previousManifest = await readManagedSkillsManifest(targetDirectory);
-    const contentsByPath = await collectCanonicalSkillFiles();
+    const skillNames = await selectManagedSkillNames(targetDirectory);
+    const contentsByPath = await collectCanonicalSkillFiles(skillNames);
     const desiredPaths = new Set(contentsByPath.keys());
-    const manifestContents = createManifestContents(contentsByPath, devtoolsVersion, CANONICAL_SKILL_NAMES);
+    const manifestContents = createManifestContents(contentsByPath, devtoolsVersion, skillNames);
     const statuses = [];
     for (const [relativePath, contents] of [...contentsByPath.entries()].sort()) {
         statuses.push(await inspectDesiredFile(targetDirectory, relativePath, contents));
     }
-    for (const relativePath of await collectObsoletePaths(targetDirectory, desiredPaths, previousManifest)) {
+    for (const relativePath of await collectObsoletePaths(targetDirectory, desiredPaths, previousManifest, skillNames)) {
         statuses.push({ relativePath, state: 'obsolete' });
     }
     statuses.push(await inspectDesiredFile(targetDirectory, MANIFEST_PATH, Buffer.from(manifestContents)));

package/dist/tools/skills/selection.d.ts

@@ -0,0 +1,7 @@
+export declare const BASELINE_SKILL_NAMES: readonly ["ankhorage-coding-rules", "ankhorage-project-structure"];
+export declare const PROFILE_SKILL_NAMES: readonly ["zora-designer"];
+export type ManagedSkillName = (typeof BASELINE_SKILL_NAMES)[number] | (typeof PROFILE_SKILL_NAMES)[number];
+/*** Select baseline and profile-specific managed skills from current repository traits. */
+export declare function selectManagedSkillNames(targetDirectory: string): Promise<readonly ManagedSkillName[]>;
+/*** Identify ZORA owners and generated-app authoring repositories without explicit skill lists. */
+export declare function isZoraDesignerContext(packageManifest: Readonly<Record<string, unknown>>): boolean;

package/dist/tools/skills/selection.js

@@ -0,0 +1,82 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+export const BASELINE_SKILL_NAMES = [
+    'ankhorage-coding-rules',
+    'ankhorage-project-structure',
+];
+export const PROFILE_SKILL_NAMES = ['zora-designer'];
+const ZORA_DESIGNER_OWNER_PACKAGES = new Set([
+    '@ankhorage/studio',
+    '@ankhorage/templates',
+    '@ankhorage/zora',
+]);
+const ZORA_DESIGNER_APP_DEPENDENCIES = new Set([
+    '@ankhorage/expo-runtime',
+    '@ankhorage/runtime',
+    '@ankhorage/studio',
+    '@ankhorage/templates',
+]);
+/*** Select baseline and profile-specific managed skills from current repository traits. */
+export async function selectManagedSkillNames(targetDirectory) {
+    const packageManifest = await readPackageManifest(targetDirectory);
+    return isZoraDesignerContext(packageManifest)
+        ? [...BASELINE_SKILL_NAMES, ...PROFILE_SKILL_NAMES]
+        : BASELINE_SKILL_NAMES;
+}
+/*** Identify ZORA owners and generated-app authoring repositories without explicit skill lists. */
+export function isZoraDesignerContext(packageManifest) {
+    const packageName = readNonEmptyString(packageManifest.name);
+    if (packageName !== null && ZORA_DESIGNER_OWNER_PACKAGES.has(packageName)) {
+        return true;
+    }
+    const dependencies = collectDependencyNames(packageManifest);
+    return (dependencies.has('@ankhorage/zora') &&
+        [...ZORA_DESIGNER_APP_DEPENDENCIES].some((dependency) => dependencies.has(dependency)));
+}
+/*** Read package metadata used for profile selection, treating a missing manifest as an empty one. */
+async function readPackageManifest(targetDirectory) {
+    try {
+        const contents = await readFile(resolve(targetDirectory, 'package.json'), 'utf8');
+        const parsed = JSON.parse(contents);
+        if (!isRecord(parsed)) {
+            throw new Error('package.json must contain a JSON object for managed-skill selection.');
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT') {
+            return {};
+        }
+        throw error;
+    }
+}
+/*** Combine all dependency sections that describe the repository's current package context. */
+function collectDependencyNames(packageManifest) {
+    const names = new Set();
+    const dependencySections = [
+        packageManifest.dependencies,
+        packageManifest.devDependencies,
+        packageManifest.optionalDependencies,
+        packageManifest.peerDependencies,
+    ];
+    for (const dependencies of dependencySections) {
+        if (isRecord(dependencies)) {
+            for (const dependency of Object.keys(dependencies)) {
+                names.add(dependency);
+            }
+        }
+    }
+    return names;
+}
+/*** Narrow filesystem errors that expose a Node error code. */
+function isNodeError(error) {
+    return error instanceof Error && 'code' in error;
+}
+/*** Narrow unknown package metadata to a record. */
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/*** Return a trimmed package name when one is declared. */
+function readNonEmptyString(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value.trim() : null;
+}

package/package.json

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