@ankhorage/paradox 0.1.12 → 0.1.14

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.1.14
+
+### Patch Changes
+
+- 63a2f91: Add execution handlers to the docs command surface.
+
+## 0.1.13
+
+### Patch Changes
+
+- df28363: Expose docs command surface metadata for Ankh discovery.
+
 ## 0.1.12
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/paradox
 
-![license: MIT](./paradox/badges/license.svg) ![npm: v0.1.12](./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: v0.1.14](./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)
 
 Deterministic documentation generator for TypeScript packages.
 

package/dist/docsSurface.d.ts

@@ -0,0 +1,26 @@
+declare const _default: {
+    id: string;
+    category: string;
+    version: string;
+    capabilities: string[];
+    commands: readonly [{
+        readonly path: readonly ["docs"];
+        readonly summary: "Generate package documentation.";
+        readonly capability: "docs.generate";
+    }, {
+        readonly path: readonly ["docs", "write"];
+        readonly summary: "Generate and write package documentation.";
+        readonly capability: "docs.generate";
+    }, {
+        readonly path: readonly ["docs", "check"];
+        readonly summary: "Check package documentation generation.";
+        readonly capability: "docs.check";
+    }];
+    handlers: {
+        path: readonly ["docs"] | readonly ["docs", "write"] | readonly ["docs", "check"];
+        handler(): {
+            exitCode: number;
+        };
+    }[];
+};
+export default _default;

package/dist/docsSurface.handlers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/docsSurface.handlers.test.js

@@ -0,0 +1,7 @@
+import { describe, expect, test } from 'bun:test';
+import surface from './docsSurface.js';
+describe('docs surface handlers', () => {
+    test('declares handlers for every command', () => {
+        expect(surface.handlers).toHaveLength(surface.commands.length);
+    });
+});

package/dist/docsSurface.js

@@ -0,0 +1,35 @@
+import { spawnSync } from 'node:child_process';
+const packageName = '@ankhorage/paradox';
+const packageVersion = '0.1.13';
+const commandList = [
+    {
+        path: ['docs'],
+        summary: 'Generate package documentation.',
+        capability: 'docs.generate',
+    },
+    {
+        path: ['docs', 'write'],
+        summary: 'Generate and write package documentation.',
+        capability: 'docs.generate',
+    },
+    {
+        path: ['docs', 'check'],
+        summary: 'Check package documentation generation.',
+        capability: 'docs.check',
+    },
+];
+const handlers = commandList.map((command) => ({
+    path: command.path,
+    handler() {
+        const result = spawnSync('paradox', [], { stdio: 'inherit' });
+        return { exitCode: result.status ?? 1 };
+    },
+}));
+export default {
+    id: packageName,
+    category: 'docs',
+    version: packageVersion,
+    capabilities: ['docs.generate', 'docs.check'],
+    commands: commandList,
+    handlers,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/paradox",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Deterministic documentation generator for TypeScript packages.",
   "license": "MIT",
   "publishConfig": {
@@ -42,13 +42,11 @@
     "paradox": "./dist/cli.js"
   },
   "ankh": {
-    "category": "paradox",
-    "provider": null,
+    "category": "docs",
+    "provider": "./dist/docsSurface.js",
     "capabilities": [
-      "paradox.package",
-      "paradox.config",
-      "paradox.model",
-      "paradox.tags"
+      "docs.generate",
+      "docs.check"
     ]
   },
   "scripts": {