Centralize repository workflows and VS Code configuration

eslint.config.mjs

@@ -1,4 +1,4 @@
-import { createConfig } from './dist/eslint.js';
+import { createConfig } from './dist/tools/eslint/index.js';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 

knip.config.ts

@@ -1,4 +1,4 @@
-import { createKnipConfig } from './src/knip.js';
+import { createKnipConfig } from './src/tools/knip/index.js';
 
 export default createKnipConfig({
   ignoreFiles: [

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/devtools",
   "version": "1.1.2",
-  "description": "Shared Lint and Format Configuration for Ankhorage",
+  "description": "Shared development tooling and repository standards for Ankhorage",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",
   "bugs": {
@@ -21,39 +21,44 @@
     "capabilities": [
       "devtools.lint",
       "devtools.format",
-      "devtools.knip"
+      "devtools.knip",
+      "devtools.sync",
+      "devtools.status",
+      "devtools.workflows.sync",
+      "devtools.workflows.status",
+      "devtools.vscode.sync",
+      "devtools.vscode.status"
     ]
   },
   "keywords": [
     "typescript",
     "eslint",
     "prettier",
     "knip",
-    "linting",
-    "formatting",
-    "static-analysis",
+    "github-actions",
+    "vscode",
     "developer-tools"
   ],
   "bin": {
-    "ankhorage-eslint": "./dist/eslint-cli.js",
-    "ankhorage-knip": "./dist/knip-cli.js",
-    "ankhorage-prettier": "./dist/prettier-cli.js"
+    "ankhorage-eslint": "./dist/tools/eslint/cli.js",
+    "ankhorage-knip": "./dist/tools/knip/cli.js",
+    "ankhorage-prettier": "./dist/tools/prettier/cli.js"
   },
   "exports": {
     "./cli": {
       "types": "./dist/cli/index.d.ts",
       "import": "./dist/cli/index.js"
     },
     "./eslint": {
-      "types": "./dist/eslint.d.ts",
-      "import": "./dist/eslint.js"
+      "types": "./dist/tools/eslint/index.d.ts",
+      "import": "./dist/tools/eslint/index.js"
     },
     "./knip": {
-      "types": "./dist/knip.d.ts",
-      "import": "./dist/knip.js"
+      "types": "./dist/tools/knip/index.d.ts",
+      "import": "./dist/tools/knip/index.js"
     },
     "./prettier": {
-      "require": "./dist/prettier.cjs"
+      "require": "./dist/tools/prettier/index.cjs"
     }
   },
   "files": [
@@ -63,7 +68,7 @@
     "examples"
   ],
   "scripts": {
-    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc && cp src/prettier.cjs dist/prettier.cjs",
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc && mkdir -p dist/tools/workflows dist/tools/vscode dist/tools/prettier && cp -R src/tools/workflows/files dist/tools/workflows/files && cp -R src/tools/vscode/files dist/tools/vscode/files && cp src/tools/prettier/index.cjs dist/tools/prettier/index.cjs",
     "typecheck": "bun x tsc --noEmit -p tsconfig.test.json",
     "doctor": "ankhorage-doctor validate .",
     "knip": "knip",

src/ankh.provider.test.ts

@@ -4,7 +4,7 @@ import provider from './cli/index.js';
 import { getDevtoolsCommands } from './internal/devtoolsCommands.js';
 
 describe('devtools package provider', () => {
-  it('exposes only the shipped devtools commands and capabilities', () => {
+  it('exposes the canonical devtools command surface', () => {
     const commands = getDevtoolsCommands();
 
     expect(provider.id).toBe('@ankhorage/devtools');
@@ -21,6 +21,12 @@ describe('devtools package provider', () => {
       'lint',
       'format',
       'knip',
+      'sync',
+      'status',
+      'workflows sync',
+      'workflows status',
+      'vscode sync',
+      'vscode status',
     ]);
   });
 

src/cli/index.ts

@@ -4,6 +4,7 @@ import type { AnkhRuntimeCommandProvider } from '@ankhorage/ankh';
 
 import { getDevtoolsCommands } from '../internal/devtoolsCommands.js';
 import { runDevtoolsCommand } from '../internal/runDevtoolsCommand.js';
+import { runManagedDevtoolsCommand } from '../internal/runManagedDevtoolsCommand.js';
 
 const packageVersion = readPackageVersion();
 const commands = getDevtoolsCommands();
@@ -21,7 +22,10 @@ const provider = {
   handlers: commands.map((command) => ({
     path: [...command.path],
     handler: async (request) => {
-      const result = await runDevtoolsCommand(command, request.argv);
+      const result =
+        command.kind === 'binary'
+          ? await runDevtoolsCommand(command, request.argv, { cwd: request.context.cwd })
+          : await runManagedDevtoolsCommand(command, request.argv, request.context);
       return { exitCode: result.exitCode };
     },
   })),

src/eslint.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'bun:test';
 
-import { createConfig, defaultRestrictedImports } from './eslint.js';
+import { createConfig, defaultRestrictedImports } from './tools/eslint/index.js';
 
 describe('createConfig sanity check', () => {
   const baseOptions = {

src/internal/devtoolsCommands.test.ts

@@ -7,37 +7,33 @@ import {
 } from './devtoolsCommands.js';
 
 describe('devtools command table', () => {
-  it('defines the exact provider-backed command surface', () => {
-    const commands = getDevtoolsCommands();
-
-    expect(commands).toEqual([
-      {
-        path: ['lint'],
-        capability: 'devtools.lint',
-        summary: 'Run the shared ESLint toolchain.',
-        packageName: 'eslint',
-        binName: 'eslint',
-      },
-      {
-        path: ['format'],
-        capability: 'devtools.format',
-        summary: 'Run the shared Prettier toolchain.',
-        packageName: 'prettier',
-        binName: 'prettier',
-      },
-      {
-        path: ['knip'],
-        capability: 'devtools.knip',
-        summary: 'Run the shared Knip toolchain.',
-        packageName: 'knip',
-        binName: 'knip',
-      },
+  it('defines the canonical provider-backed command paths', () => {
+    expect(getDevtoolsCommands().map((command) => command.path.join(' '))).toEqual([
+      'lint',
+      'format',
+      'knip',
+      'sync',
+      'status',
+      'workflows sync',
+      'workflows status',
+      'vscode sync',
+      'vscode status',
     ]);
   });
 
-  it('returns commands by path and rejects unknown commands', () => {
+  it('returns binary commands by tool name', () => {
     expect(getDevtoolsCommand('lint').path).toEqual(['lint']);
-    expect(findDevtoolsCommandByPath(['format'])?.capability).toBe('devtools.format');
+    expect(getDevtoolsCommand('format').binName).toBe('prettier');
+    expect(getDevtoolsCommand('knip').packageName).toBe('knip');
+  });
+
+  it('resolves nested managed commands and rejects unknown paths', () => {
+    expect(findDevtoolsCommandByPath(['workflows', 'sync'])?.capability).toBe(
+      'devtools.workflows.sync',
+    );
+    expect(findDevtoolsCommandByPath(['vscode', 'status'])?.capability).toBe(
+      'devtools.vscode.status',
+    );
     expect(findDevtoolsCommandByPath(['unknown'])).toBeNull();
     expect(findDevtoolsCommandByPath(['lint', 'extra'])).toBeNull();
   });

src/internal/devtoolsCommands.ts

@@ -1,35 +1,107 @@
 export type DevtoolsToolName = 'format' | 'knip' | 'lint';
+export type ManagedConcern = 'all' | 'vscode' | 'workflows';
 
-export interface DevtoolsCommandDefinition {
-  path: readonly [DevtoolsToolName];
-  capability: 'devtools.format' | 'devtools.knip' | 'devtools.lint';
-  summary: string;
-  packageName: 'eslint' | 'knip' | 'prettier';
-  binName: 'eslint' | 'knip' | 'prettier';
+export interface BinaryDevtoolsCommandDefinition {
+  readonly kind: 'binary';
+  readonly path: readonly [DevtoolsToolName];
+  readonly capability: 'devtools.format' | 'devtools.knip' | 'devtools.lint';
+  readonly summary: string;
+  readonly packageName: 'eslint' | 'knip' | 'prettier';
+  readonly binName: 'eslint' | 'knip' | 'prettier';
 }
 
+export interface ManagedDevtoolsCommandDefinition {
+  readonly kind: 'managed-files';
+  readonly path: readonly ['sync' | 'status'] | readonly ['workflows' | 'vscode', 'sync' | 'status'];
+  readonly capability:
+    | 'devtools.sync'
+    | 'devtools.status'
+    | 'devtools.workflows.sync'
+    | 'devtools.workflows.status'
+    | 'devtools.vscode.sync'
+    | 'devtools.vscode.status';
+  readonly summary: string;
+  readonly concern: ManagedConcern;
+  readonly mode: 'sync' | 'status';
+}
+
+export type DevtoolsCommandDefinition =
+  | BinaryDevtoolsCommandDefinition
+  | ManagedDevtoolsCommandDefinition;
+
 const DEVTOOLS_COMMANDS = [
   {
+    kind: 'binary',
     path: ['lint'],
     capability: 'devtools.lint',
     summary: 'Run the shared ESLint toolchain.',
     packageName: 'eslint',
     binName: 'eslint',
   },
   {
+    kind: 'binary',
     path: ['format'],
     capability: 'devtools.format',
     summary: 'Run the shared Prettier toolchain.',
     packageName: 'prettier',
     binName: 'prettier',
   },
   {
+    kind: 'binary',
     path: ['knip'],
     capability: 'devtools.knip',
     summary: 'Run the shared Knip toolchain.',
     packageName: 'knip',
     binName: 'knip',
   },
+  {
+    kind: 'managed-files',
+    path: ['sync'],
+    capability: 'devtools.sync',
+    summary: 'Synchronize all managed repository development files.',
+    concern: 'all',
+    mode: 'sync',
+  },
+  {
+    kind: 'managed-files',
+    path: ['status'],
+    capability: 'devtools.status',
+    summary: 'Report drift in all managed repository development files.',
+    concern: 'all',
+    mode: 'status',
+  },
+  {
+    kind: 'managed-files',
+    path: ['workflows', 'sync'],
+    capability: 'devtools.workflows.sync',
+    summary: 'Synchronize managed GitHub Actions workflows.',
+    concern: 'workflows',
+    mode: 'sync',
+  },
+  {
+    kind: 'managed-files',
+    path: ['workflows', 'status'],
+    capability: 'devtools.workflows.status',
+    summary: 'Report drift in managed GitHub Actions workflows.',
+    concern: 'workflows',
+    mode: 'status',
+  },
+  {
+    kind: 'managed-files',
+    path: ['vscode', 'sync'],
+    capability: 'devtools.vscode.sync',
+    summary: 'Synchronize managed VS Code workspace files.',
+    concern: 'vscode',
+    mode: 'sync',
+  },
+  {
+    kind: 'managed-files',
+    path: ['vscode', 'status'],
+    capability: 'devtools.vscode.status',
+    summary: 'Report drift in managed VS Code workspace files.',
+    concern: 'vscode',
+    mode: 'status',
+  },
 ] as const satisfies readonly DevtoolsCommandDefinition[];
 
 export function getDevtoolsCommands(): readonly DevtoolsCommandDefinition[] {
@@ -39,15 +111,20 @@ export function getDevtoolsCommands(): readonly DevtoolsCommandDefinition[] {
 export function findDevtoolsCommandByPath(
   path: readonly string[],
 ): DevtoolsCommandDefinition | null {
-  if (path.length !== 1) {
-    return null;
-  }
-
-  return DEVTOOLS_COMMANDS.find((command) => command.path[0] === path[0]) ?? null;
+  return (
+    DEVTOOLS_COMMANDS.find(
+      (command) =>
+        command.path.length === path.length &&
+        command.path.every((segment, index) => segment === path[index]),
+    ) ?? null
+  );
 }
 
-export function getDevtoolsCommand(toolName: DevtoolsToolName): DevtoolsCommandDefinition {
-  const command = DEVTOOLS_COMMANDS.find((candidate) => candidate.path[0] === toolName);
+export function getDevtoolsCommand(toolName: DevtoolsToolName): BinaryDevtoolsCommandDefinition {
+  const command = DEVTOOLS_COMMANDS.find(
+    (candidate): candidate is BinaryDevtoolsCommandDefinition =>
+      candidate.kind === 'binary' && candidate.path[0] === toolName,
+  );
 
   if (command === undefined) {
     throw new Error(`Unknown devtools command: ${toolName}`);