camstack 1.2.177 → 1.2.179

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   FFMPEG_PATH_ENV,
   runDiscover
-} from "./chunk-QGJT47FV.js";
+} from "./chunk-MRRNUEHP.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -10,7 +10,7 @@ import { createRequire } from "module";
 import { fileURLToPath } from "url";
 import { dirname, resolve as resolve5 } from "path";
 import * as os5 from "os";
-import { parseArgs as parseArgs7 } from "util";
+import { parseArgs as parseArgs8 } from "util";
 
 // src/commands/serve.ts
 import { parseArgs } from "util";
@@ -39,7 +39,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-5VFRFS7P.js");
+  await import("./launcher-ER4ORH3G.js");
 }
 
 // src/commands/agent.ts
@@ -72,7 +72,7 @@ async function runAgent(args) {
     allowPositionals: false
   });
   if (typeof values.hub !== "string" || values.hub.length === 0) {
-    throw new Error("--hub is required (e.g. --hub 192.168.x.x)");
+    throw new Error("--hub is required (e.g. --hub 192.168.10.10)");
   }
   if (typeof values.token !== "string" || values.token.length === 0) {
     throw new Error("--token is required");
@@ -84,7 +84,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-5VFRFS7P.js");
+  await import("./launcher-ER4ORH3G.js");
 }
 
 // src/commands/setup.ts
@@ -1134,7 +1134,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-VSURSRZZ.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-TGPXHMVK.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);
@@ -1844,6 +1844,340 @@ async function runWatch(args) {
   }
 }
 
+// src/commands/develop.ts
+import { parseArgs as parseArgs7 } from "util";
+import {
+  extendAddon,
+  findExample,
+  findWorkspaceRoot,
+  getCapability,
+  listAddonPackages,
+  listCapabilities,
+  listExamples,
+  listSkills,
+  readSkill,
+  requireWorkspaceRoot,
+  scaffoldAddon,
+  scaffoldCapStub,
+  validateAddon,
+  whoProvides
+} from "@camstack/develop";
+var HELP = `Usage: camstack develop <subcommand> [options]
+
+Catalogue:
+  list-addons [--json]              List workspace packages with camstack.addons[]
+  list-caps [--json]                List *.cap.ts capability names
+  who-provides <cap> [--json]       Which addons declare a capability
+  find-example <query> [--json]     Ranked core-package examples
+  examples [--json]                 Full curated example catalogue
+
+Scaffold / extend:
+  scaffold addon <name> [options]   New packages/addon-<name>/
+    --display-name <str>
+    --description <str>
+    --kind empty|provider|notifier|osd|post-analysis
+    --directory <dir>               Default: packages
+    --dry-run
+  scaffold cap <name> [options]     Stub packages/types/.../<name>.cap.ts
+    --scope system|device
+    --mode singleton|collection
+    --dry-run
+  extend <addon> --entry <id>       New manifest entry in an existing package
+    --display-name <str>
+    --description <str>
+    --dry-run
+
+Validate:
+  validate [addon|--all] [--json]   Manifest + vite entries (+ known caps)
+
+Skills:
+  skills [--json]                   Paths to the portable skill pack
+  skill <id>                        Print one skill markdown file
+
+Also: nx g @camstack/nx-plugin:addon <name> (Nx path to the same idea).
+`;
+function printJson(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
+function wantJson(args) {
+  return args.includes("--json");
+}
+function withoutJson(args) {
+  return args.filter((a) => a !== "--json");
+}
+function developHelp() {
+  return HELP;
+}
+async function runDevelop(args) {
+  if (args.length === 0 || args[0] === "-h" || args[0] === "--help") {
+    console.log(HELP);
+    return;
+  }
+  const sub = args[0] ?? "";
+  const rest = args.slice(1);
+  switch (sub) {
+    case "list-addons":
+      return cmdListAddons(rest);
+    case "list-caps":
+      return cmdListCaps(rest);
+    case "who-provides":
+      return cmdWhoProvides(rest);
+    case "find-example":
+      return cmdFindExample(rest);
+    case "examples":
+      return cmdExamples(rest);
+    case "scaffold":
+      return cmdScaffold(rest);
+    case "extend":
+      return cmdExtend(rest);
+    case "validate":
+      return cmdValidate(rest);
+    case "skills":
+      return cmdSkills(rest);
+    case "skill":
+      return cmdSkill(rest);
+    default:
+      throw new Error(`Unknown develop subcommand: ${sub}
+
+${HELP}`);
+  }
+}
+function cmdListAddons(args) {
+  const root = requireWorkspaceRoot();
+  const pkgs = listAddonPackages(root);
+  if (wantJson(args)) {
+    printJson(pkgs);
+    return;
+  }
+  for (const pkg of pkgs) {
+    const ids = pkg.addons.map((a) => a.id).join(", ");
+    console.log(`${pkg.packageName}	${pkg.relativeDir}	[${ids}]`);
+  }
+  console.log(`
+${pkgs.length} package(s)`);
+}
+function cmdListCaps(args) {
+  const root = requireWorkspaceRoot();
+  const caps = listCapabilities(root);
+  if (wantJson(args)) {
+    printJson(caps);
+    return;
+  }
+  for (const cap of caps) {
+    const meta = [cap.scope, cap.mode].filter(Boolean).join("/");
+    console.log(`${cap.name}	${meta}	${cap.relativeFile}`);
+  }
+  console.log(`
+${caps.length} capability(ies)`);
+}
+function cmdWhoProvides(args) {
+  const json = wantJson(args);
+  const cleaned = withoutJson(args);
+  const cap = cleaned[0];
+  if (!cap) throw new Error("Usage: camstack develop who-provides <cap>");
+  const root = requireWorkspaceRoot();
+  const hits = whoProvides(root, cap);
+  if (json) {
+    printJson(hits);
+    return;
+  }
+  if (hits.length === 0) {
+    console.log(`No addon declares capability \`${cap}\`.`);
+    return;
+  }
+  for (const hit of hits) {
+    console.log(`${hit.package.packageName}	${hit.addon.id}	${hit.package.relativeDir}`);
+  }
+}
+function cmdFindExample(args) {
+  const json = wantJson(args);
+  const cleaned = withoutJson(args);
+  const query = cleaned.join(" ").trim();
+  if (!query) throw new Error("Usage: camstack develop find-example <query>");
+  const root = findWorkspaceRoot() ?? process.cwd();
+  const hits = findExample(root, query);
+  if (json) {
+    printJson(hits);
+    return;
+  }
+  if (hits.length === 0) {
+    console.log("No examples matched.");
+    return;
+  }
+  for (const hit of hits.slice(0, 10)) {
+    console.log(
+      `[${hit.score}] ${hit.example.id}	${hit.example.packageDir}
+     ${hit.example.demonstrates}
+     (${hit.rationale})`
+    );
+  }
+}
+function cmdExamples(args) {
+  const examples = listExamples();
+  if (wantJson(args)) {
+    printJson(examples);
+    return;
+  }
+  for (const ex of examples) {
+    console.log(`${ex.id}	${ex.kind}	${ex.packageDir}
+  ${ex.demonstrates}`);
+  }
+}
+function cmdScaffold(args) {
+  const kind = args[0];
+  if (kind === "addon") return cmdScaffoldAddon(args.slice(1));
+  if (kind === "cap" || kind === "capability") return cmdScaffoldCap(args.slice(1));
+  throw new Error("Usage: camstack develop scaffold addon|cap <name> [options]");
+}
+function cmdScaffoldAddon(args) {
+  const { values, positionals } = parseArgs7({
+    args: [...args],
+    options: {
+      "display-name": { type: "string" },
+      description: { type: "string" },
+      kind: { type: "string" },
+      directory: { type: "string" },
+      "dry-run": { type: "boolean" }
+    },
+    allowPositionals: true,
+    strict: true
+  });
+  const name = positionals[0];
+  if (!name) throw new Error("Usage: camstack develop scaffold addon <name>");
+  const kindRaw = typeof values.kind === "string" ? values.kind : "empty";
+  const allowed = /* @__PURE__ */ new Set(["empty", "provider", "notifier", "osd", "post-analysis"]);
+  if (!allowed.has(kindRaw)) {
+    throw new Error(`--kind must be one of: ${[...allowed].join(", ")}`);
+  }
+  const root = requireWorkspaceRoot();
+  const result = scaffoldAddon({
+    workspaceRoot: root,
+    name,
+    ...typeof values["display-name"] === "string" ? { displayName: values["display-name"] } : {},
+    ...typeof values.description === "string" ? { description: values.description } : {},
+    kind: kindRaw,
+    ...typeof values.directory === "string" ? { directory: values.directory } : {},
+    dryRun: values["dry-run"] === true
+  });
+  console.log(
+    values["dry-run"] === true ? `[dry-run] would create ${result.relativeDir}` : `Created ${result.relativeDir}`
+  );
+  for (const f of result.filesWritten) console.log(`  + ${f}`);
+  console.log("\nNext:");
+  for (const step of result.nextSteps) console.log(`  - ${step}`);
+}
+function cmdScaffoldCap(args) {
+  const { values, positionals } = parseArgs7({
+    args: [...args],
+    options: {
+      scope: { type: "string" },
+      mode: { type: "string" },
+      "dry-run": { type: "boolean" }
+    },
+    allowPositionals: true,
+    strict: true
+  });
+  const name = positionals[0];
+  if (!name) throw new Error("Usage: camstack develop scaffold cap <name>");
+  const scope = typeof values.scope === "string" ? values.scope : "system";
+  const mode = typeof values.mode === "string" ? values.mode : "singleton";
+  if (scope !== "system" && scope !== "device") {
+    throw new Error("--scope must be system or device");
+  }
+  if (mode !== "singleton" && mode !== "collection") {
+    throw new Error("--mode must be singleton or collection");
+  }
+  const root = requireWorkspaceRoot();
+  const result = scaffoldCapStub({
+    workspaceRoot: root,
+    name,
+    scope,
+    mode,
+    dryRun: values["dry-run"] === true
+  });
+  console.log(
+    values["dry-run"] === true ? `[dry-run] would write ${result.relativePath}` : `Wrote ${result.relativePath} (${result.exportName})`
+  );
+  console.log("\nNext:");
+  for (const step of result.nextSteps) console.log(`  - ${step}`);
+}
+function cmdExtend(args) {
+  const { values, positionals } = parseArgs7({
+    args: [...args],
+    options: {
+      entry: { type: "string" },
+      "display-name": { type: "string" },
+      description: { type: "string" },
+      "dry-run": { type: "boolean" }
+    },
+    allowPositionals: true,
+    strict: true
+  });
+  const addon = positionals[0];
+  const entry = typeof values.entry === "string" ? values.entry : void 0;
+  if (!addon || !entry) {
+    throw new Error("Usage: camstack develop extend <addon> --entry <id>");
+  }
+  const root = requireWorkspaceRoot();
+  const result = extendAddon({
+    workspaceRoot: root,
+    addon,
+    entryId: entry,
+    ...typeof values["display-name"] === "string" ? { displayName: values["display-name"] } : {},
+    ...typeof values.description === "string" ? { description: values.description } : {},
+    dryRun: values["dry-run"] === true
+  });
+  console.log(
+    values["dry-run"] === true ? `[dry-run] would extend ${result.packageDir} with ${result.entryId}` : `Extended ${result.packageDir} with entry ${result.entryId}`
+  );
+  for (const f of result.filesWritten) console.log(`  ~ ${f}`);
+  console.log("\nNext:");
+  for (const step of result.nextSteps) console.log(`  - ${step}`);
+}
+function cmdValidate(args) {
+  const json = wantJson(args);
+  const cleaned = withoutJson(args);
+  const query = cleaned[0];
+  const root = requireWorkspaceRoot();
+  const result = validateAddon(root, query);
+  if (json) {
+    printJson(result);
+  } else {
+    if (result.findings.length === 0) {
+      console.log("\u2714 no findings");
+    } else {
+      for (const f of result.findings) {
+        const mark = f.level === "error" ? "\u2718" : f.level === "warn" ? "!" : "\xB7";
+        console.log(`${mark} [${f.code}] ${f.message}`);
+      }
+    }
+    console.log(result.ok ? "\n\u2714 validate ok" : "\n\u2718 validate failed");
+  }
+  if (!result.ok) process.exitCode = 1;
+}
+function cmdSkills(args) {
+  const skills = listSkills();
+  if (wantJson(args)) {
+    printJson(skills);
+    return;
+  }
+  console.log("Portable skill pack (@camstack/develop/skills):\n");
+  for (const s of skills) {
+    console.log(`${s.id}	${s.title}
+  ${s.absolutePath}`);
+  }
+}
+function cmdSkill(args) {
+  const id = args[0];
+  if (!id) throw new Error("Usage: camstack develop skill <id>");
+  const skill = readSkill(id);
+  if (!skill) {
+    const known = listSkills().map((s) => s.id).join(", ");
+    throw new Error(`Unknown skill: ${id}. Known: ${known}`);
+  }
+  console.log(skill.content);
+}
+
 // src/cli.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var require2 = createRequire(import.meta.url);
@@ -2078,6 +2412,13 @@ function buildCommands() {
         "a push are coalesced into the next cycle."
       ].join("\n")
     },
+    {
+      name: "develop",
+      aliases: ["addon"],
+      summary: "Authoring tools \u2014 catalogue, scaffold, validate, find-example, skills (same ops as MCP)",
+      run: runDevelop,
+      help: developHelp
+    },
     {
       name: "update",
       aliases: ["upgrade"],
@@ -2111,7 +2452,7 @@ function buildCommands() {
 }
 function parseSubcommandArgs(args, options, allowPositionals) {
   if (args.some((a) => HELP_FLAGS.has(a))) return null;
-  const parsed = parseArgs7({
+  const parsed = parseArgs8({
     args: [...args],
     options,
     allowPositionals,

package/dist/{discover-VSURSRZZ.js → discover-TGPXHMVK.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-QGJT47FV.js";
+} from "./chunk-MRRNUEHP.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,