fix: automatically parse documentation urls

Author: kevinwang5658

…ources)/javascript/fast-node-manager.mdx …resources/(resources)/javascript/fnm.mdxdocs/resources/(resources)/javascript/fast-node-manager.mdx renamed to docs/resources/(resources)/javascript/fnm.mdx docs/resources/(resources)/javascript/fast-node-manager.mdx renamed to docs/resources/(resources)/javascript/fnm.mdx

@@ -1,6 +1,6 @@
 {
   "name": "default",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Default plugin for Codify - provides 50+ declarative resources for managing development tools and system configuration across macOS and Linux",
   "main": "dist/index.js",
   "scripts": {

package.json

@@ -1,10 +1,33 @@
 import * as cp from 'node:child_process';
+import { readdirSync } from 'node:fs';
 import path from 'node:path';
 import * as url from 'node:url';
 import { createRequire } from 'node:module';
 import 'dotenv/config'
 import { createClient } from '@supabase/supabase-js';
 
+const DOCS_BASE_URL = 'https://codifycli.com';
+const DOCS_DIR = path.resolve(path.dirname(url.fileURLToPath(import.meta.url)), '..', 'docs', 'resources', '(resources)');
+
+function buildDocUrlMap(dir: string, urlPrefix: string, knownTypes?: Set<string>): Map<string, string> {
+  const map = new Map<string, string>();
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) {
+      buildDocUrlMap(path.join(dir, entry.name), `${urlPrefix}/${entry.name}`, knownTypes)
+        .forEach((v, k) => map.set(k, v));
+    } else if (entry.name.endsWith('.mdx')) {
+      const type = entry.name.replace(/\.mdx$/, '');
+      if (knownTypes && !knownTypes.has(type)) {
+        throw new Error(`Doc file "${entry.name}" does not match any known resource type. Check the filename.`);
+      }
+      map.set(type, `${DOCS_BASE_URL}${urlPrefix}/${type}`);
+    }
+  }
+  return map;
+}
+
+const docUrlMap = buildDocUrlMap(DOCS_DIR, '/docs/resources');
+
 const require = createRequire(import.meta.url);
 
 // This should run the build
@@ -89,6 +112,9 @@ async function uploadResources(prerelease: boolean) {
 
   const resources = CodifySchema.items.oneOf;
 
+  const knownTypes = new Set<string>(resources.map((r: any) => r.properties.type.const));
+  buildDocUrlMap(DOCS_DIR, '/docs/resources', knownTypes);
+
   for (const resource of resources) {
     const type = resource.properties.type.const;
     const metadata = metadataByType.get(type);
@@ -100,7 +126,7 @@ async function uploadResources(prerelease: boolean) {
       plugin_name: pluginName,
       prerelease,
       schema: JSON.stringify(resource),
-      documentation_url: resource.$comment,
+      documentation_url: docUrlMap.get(type) ?? null,
       allow_multiple: metadata?.allowMultiple ?? false,
       os: metadata?.operatingSystems ?? [],
       default_config: metadata?.defaultConfig ? JSON.stringify(metadata.defaultConfig) : null,

scripts/deploy.ts

@@ -21,7 +21,7 @@ export const schema = z.object({
       'The directory to install Android Studios into. Defaults to /Applications on macOS, /opt on Linux'
     )
     .optional(),
-}).meta({ $comment: 'https://codifycli.com/docs/resources/android-studio' })
+})
 
 export type AndroidStudioConfig = z.infer<typeof schema>;
 

src/resources/android/android-studio.ts

@@ -1,7 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema",
   "$id": "https://www.codifycli.com/apt.json",
-  "$comment": "https://codifycli.com/docs/resources/apt/",
   "title": "Apt resource",
   "description": "Manage apt packages on Debian-based systems.",
   "type": "object",

src/resources/apt/apt-schema.json

@@ -27,7 +27,7 @@ const schema = z.object({
     .string()
     .describe('The directory to run the install command')
     .optional(),
-}).meta({ $comment: 'https://codifycli.com/docs/resources/asdf/asdf-install' })
+})
   .describe('Install specific version of tools using asdf.');
 
 export type AsdfInstallConfig = z.infer<typeof schema>;

src/resources/asdf/asdf-install.ts

@@ -23,7 +23,7 @@ const schema = z
       .string()
       .describe('The gitUrl of the plugin')
       .optional()
-  }).meta({ $comment: 'https://codifycli.com/docs/resources/asdf/asdf-plugin' })
+  })
     .describe('Asdf plugin resource for installing asdf plugins.');
 export type AsdfPluginConfig = z.infer<typeof schema>;
 

src/resources/asdf/asdf-plugin.ts

@@ -13,7 +13,7 @@ const schema = z.object({
       'Asdf plugins to install. See: https://github.com/asdf-community for a full list'
     )
     .optional()
-}).meta({ $comment: 'https://codifycli.com/docs/resources/asdf/asdf' })
+})
   .describe('Asdf resource for installing asdf, a tool version manager');
 
 export type AsdfConfig = z.infer<typeof schema>

src/resources/asdf/asdf.ts

@@ -1,7 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema",
   "$id": "https://www.codifycli.com/aws-cli.json",
-  "$comment": "https://codifycli.com/docs/resources/aws-cli/",
   "title": "Aws-CLI resource",
   "type": "object",
   "description": "Installs aws-cli.",

src/resources/aws-cli/cli/aws-cli-schema.json

@@ -1,7 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema",
   "$id": "https://www.codifycli.com/aws-profile.json",
-  "$comment": "https://codifycli.com/docs/resources/aws-profile/",
   "title": "Aws-CLI configure resource",
   "type": "object",
   "description": "Configures AWS profiles.",