@ldlework/workmark 1.4.1 → 1.5.0

package/dist/cli.js

@@ -69,6 +69,17 @@ function printCommandHelp(cmd) {
         console.log(`${flag.padEnd(20)} ${desc}${parts.length ? "  " + parts.join(", ") : ""}`);
     }
 }
+function toCommandMeta(cmd) {
+    return {
+        name: cmd.name,
+        label: cmd.label,
+        group: cmd.group,
+        description: cmd.description,
+        inputSchema: cmd.inputSchema,
+        positional: cmd.positional,
+        sourceFile: cmd.sourceFile ?? null,
+    };
+}
 // ---------------------------------------------------------------------------
 // Main
 // ---------------------------------------------------------------------------
@@ -76,6 +87,10 @@ async function main() {
     const [command, ...rest] = process.argv.slice(2);
     const workspace = await loadWorkspace();
     const commands = await loadCommands(workspace);
+    if (command === "--introspect") {
+        process.stdout.write(JSON.stringify(commands.map(toCommandMeta)) + "\n");
+        return;
+    }
     if (!command || command === "--help" || command === "-h") {
         printHelp(commands);
         return;

package/dist/lib/jiti-options.d.ts

@@ -2,6 +2,6 @@ import type { JitiOptions } from "jiti";
 /**
  * Build jiti options that let wm.ts / command files import from
  * `@ldlework/workmark/*` and from workmark's own dependencies (zod, etc.)
- * regardless of how the package is installed or linked.
+ * regardless of how the package is installed, linked, or baked into a host.
  */
 export declare function jitiOptions(opts?: Partial<JitiOptions>): JitiOptions;

package/dist/lib/jiti-options.js

@@ -1,24 +1,27 @@
-import { dirname, join } from "node:path";
+import { dirname, extname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-// Resolve the workmark package root from this file's location (src/lib/ or dist/lib/)
-const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
-const SRC_LIB = join(PKG_ROOT, "src", "lib");
+// Resolve sibling modules from this file's own location and extension, so the
+// aliases work whether we're running from src/ (.ts) or a shipped/baked dist/
+// (.js) — no dependency on src/ being present alongside the compiled output.
+const HERE = dirname(fileURLToPath(import.meta.url));
+const EXT = extname(fileURLToPath(import.meta.url));
+const lib = (name) => join(HERE, `${name}${EXT}`);
 /**
  * Build jiti options that let wm.ts / command files import from
  * `@ldlework/workmark/*` and from workmark's own dependencies (zod, etc.)
- * regardless of how the package is installed or linked.
+ * regardless of how the package is installed, linked, or baked into a host.
  */
 export function jitiOptions(opts) {
     return {
         interopDefault: true,
         moduleCache: false,
         alias: {
-            "@ldlework/workmark/types": join(SRC_LIB, "types.ts"),
-            "@ldlework/workmark/helpers": join(SRC_LIB, "helpers.ts"),
-            "@ldlework/workmark/define": join(SRC_LIB, "define.ts"),
-            "@ldlework/workmark/workspace": join(SRC_LIB, "workspace.ts"),
-            "@ldlework/workmark/project": join(SRC_LIB, "project.ts"),
-            "@ldlework/workmark": join(SRC_LIB, "load.ts"),
+            "@ldlework/workmark/types": lib("types"),
+            "@ldlework/workmark/helpers": lib("helpers"),
+            "@ldlework/workmark/define": lib("define"),
+            "@ldlework/workmark/workspace": lib("workspace"),
+            "@ldlework/workmark/project": lib("project"),
+            "@ldlework/workmark": lib("load"),
         },
         nativeModules: ["zod", "@modelcontextprotocol/sdk"],
         ...opts,

package/dist/lib/parse.js

@@ -138,8 +138,19 @@ function coerce(raw, schema) {
     }
     return out;
 }
+// --- 4. apply defaults ---------------------------------------------------
+function applyDefaults(out, schema) {
+    const props = schema.properties ?? {};
+    const result = { ...out };
+    for (const [key, prop] of Object.entries(props)) {
+        if (result[key] === undefined && prop && "default" in prop) {
+            result[key] = prop.default;
+        }
+    }
+    return result;
+}
 // --- orchestrator --------------------------------------------------------
 export function parseArgs(argv, positional, schema) {
     const s = schema;
-    return coerce(dispatch(tokenize(argv), positional, s), s);
+    return applyDefaults(coerce(dispatch(tokenize(argv), positional, s), s), s);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ldlework/workmark",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "type": "module",
   "main": "dist/lib/load.js",
   "bin": {

package/src/cli.ts

@@ -79,6 +79,33 @@ function printCommandHelp(cmd: ResolvedCommand): void {
   }
 }
 
+// ---------------------------------------------------------------------------
+// Introspection — machine-readable command metadata (consumed by the VS Code
+// extension, which spawns `wm --introspect` instead of importing the loader).
+// ---------------------------------------------------------------------------
+
+interface CommandMetaJson {
+  name: string;
+  label: string;
+  group: string;
+  description: string;
+  inputSchema: unknown;
+  positional: string[];
+  sourceFile: string | null;
+}
+
+function toCommandMeta(cmd: ResolvedCommand): CommandMetaJson {
+  return {
+    name: cmd.name,
+    label: cmd.label,
+    group: cmd.group,
+    description: cmd.description,
+    inputSchema: cmd.inputSchema,
+    positional: cmd.positional,
+    sourceFile: cmd.sourceFile ?? null,
+  };
+}
+
 // ---------------------------------------------------------------------------
 // Main
 // ---------------------------------------------------------------------------
@@ -89,6 +116,11 @@ async function main(): Promise<void> {
   const workspace = await loadWorkspace();
   const commands = await loadCommands(workspace);
 
+  if (command === "--introspect") {
+    process.stdout.write(JSON.stringify(commands.map(toCommandMeta)) + "\n");
+    return;
+  }
+
   if (!command || command === "--help" || command === "-h") {
     printHelp(commands);
     return;

package/src/lib/jiti-options.ts

@@ -1,27 +1,30 @@
-import { dirname, join } from "node:path";
+import { dirname, extname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import type { JitiOptions } from "jiti";
 
-// Resolve the workmark package root from this file's location (src/lib/ or dist/lib/)
-const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
-const SRC_LIB = join(PKG_ROOT, "src", "lib");
+// Resolve sibling modules from this file's own location and extension, so the
+// aliases work whether we're running from src/ (.ts) or a shipped/baked dist/
+// (.js) — no dependency on src/ being present alongside the compiled output.
+const HERE = dirname(fileURLToPath(import.meta.url));
+const EXT = extname(fileURLToPath(import.meta.url));
+const lib = (name: string) => join(HERE, `${name}${EXT}`);
 
 /**
  * Build jiti options that let wm.ts / command files import from
  * `@ldlework/workmark/*` and from workmark's own dependencies (zod, etc.)
- * regardless of how the package is installed or linked.
+ * regardless of how the package is installed, linked, or baked into a host.
  */
 export function jitiOptions(opts?: Partial<JitiOptions>): JitiOptions {
   return {
     interopDefault: true,
     moduleCache: false,
     alias: {
-      "@ldlework/workmark/types": join(SRC_LIB, "types.ts"),
-      "@ldlework/workmark/helpers": join(SRC_LIB, "helpers.ts"),
-      "@ldlework/workmark/define": join(SRC_LIB, "define.ts"),
-      "@ldlework/workmark/workspace": join(SRC_LIB, "workspace.ts"),
-      "@ldlework/workmark/project": join(SRC_LIB, "project.ts"),
-      "@ldlework/workmark": join(SRC_LIB, "load.ts"),
+      "@ldlework/workmark/types": lib("types"),
+      "@ldlework/workmark/helpers": lib("helpers"),
+      "@ldlework/workmark/define": lib("define"),
+      "@ldlework/workmark/workspace": lib("workspace"),
+      "@ldlework/workmark/project": lib("project"),
+      "@ldlework/workmark": lib("load"),
     },
     nativeModules: ["zod", "@modelcontextprotocol/sdk"],
     ...opts,

package/src/lib/parse.ts

@@ -18,6 +18,7 @@ type SchemaProp = {
   items?: { type?: string; enum?: unknown[] };
   enum?: unknown[];
   anyOf?: unknown[];
+  default?: unknown;
 };
 
 type SchemaObject = {
@@ -180,6 +181,22 @@ function coerce(
   return out;
 }
 
+// --- 4. apply defaults ---------------------------------------------------
+
+function applyDefaults(
+  out: Record<string, unknown>,
+  schema: SchemaObject,
+): Record<string, unknown> {
+  const props = schema.properties ?? {};
+  const result = { ...out };
+  for (const [key, prop] of Object.entries(props)) {
+    if (result[key] === undefined && prop && "default" in prop) {
+      result[key] = prop.default;
+    }
+  }
+  return result;
+}
+
 // --- orchestrator --------------------------------------------------------
 
 export function parseArgs(
@@ -188,5 +205,5 @@ export function parseArgs(
   schema: Record<string, unknown>,
 ): Record<string, unknown> {
   const s = schema as SchemaObject;
-  return coerce(dispatch(tokenize(argv), positional, s), s);
+  return applyDefaults(coerce(dispatch(tokenize(argv), positional, s), s), s);
 }