@skill-map/cli 0.47.0 → 0.48.0

package/dist/cli.js

@@ -1,6 +1,6 @@
 // cli/entry.ts
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="926243f9-3707-54bc-9aa6-c68955118161")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a68e2b18-f1ae-5a4d-8cd7-72ddbf9688ab")}catch(e){}}();
 import { existsSync as existsSync33 } from "fs";
 import { Builtins, Cli as Cli2 } from "clipanion";
 
@@ -246,7 +246,7 @@ function bucketByKind(kind, instance, bag) {
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.47.0",
+  version: "0.48.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -299,9 +299,11 @@ var package_default = {
     "lint:fix": "eslint . --fix",
     "build-built-ins": "node ../scripts/generate-built-ins.js",
     "built-ins:check": "node ../scripts/generate-built-ins.js --check",
+    "view-catalog": "node ../scripts/generate-view-catalog.js",
+    "view-catalog:check": "node ../scripts/generate-view-catalog.js --check",
     prebuild: "pnpm build-built-ins",
     validate: "pnpm validate:compile && pnpm validate:test",
-    "validate:compile": "pnpm typecheck && pnpm lint && pnpm build && pnpm built-ins:check",
+    "validate:compile": "pnpm typecheck && pnpm lint && pnpm build && pnpm built-ins:check && pnpm view-catalog:check",
     "validate:test": "pnpm test:ci",
     pretest: "tsup",
     "pretest:coverage": "tsup",
@@ -1950,10 +1952,11 @@ var annotationStaleAnalyzer = {
       slot: "card.footer.right",
       icon: "pi-clock",
       emitWhenEmpty: true,
-      // First in the footer-right cluster: drift is the operator's
-      // entry point for "this node disagrees with its sidecar",
-      // followed by stability, then the severity counters.
-      priority: 10
+      // Sits right after the stability badge and before the severity
+      // counters: stability is the node's declared lifecycle state,
+      // drift is "this node disagrees with its sidecar", then the
+      // warn / error counts anchor the right edge.
+      priority: 20
     }
   },
   evaluate(ctx) {
@@ -2589,22 +2592,23 @@ var nodeStabilityAnalyzer = {
   description: "Reports a node's stability stage (`experimental`, `deprecated`) on the card.",
   mode: "deterministic",
   ui: {
-    // Second in the footer-right cluster, after the drift chip and
-    // before the severity counters. Stability is a state badge, not a
-    // count, so its priority sits between the two semantic zones.
+    // First in the footer-right cluster: stability is the node's
+    // declared lifecycle state, so it leads, followed by the drift
+    // chip and then the severity counters. It's a state badge, not a
+    // count, so it stays left of the numeric zone.
     experimental: {
       slot: "card.footer.right",
       icon: "fa-solid fa-flask",
       label: "experimental",
       emitWhenEmpty: false,
-      priority: 20
+      priority: 10
     },
     deprecated: {
       slot: "card.footer.right",
       icon: "pi-ban",
       label: "deprecated",
       emitWhenEmpty: false,
-      priority: 20
+      priority: 10
     }
   },
   evaluate(ctx) {
@@ -3009,7 +3013,7 @@ import { dirname as dirname2, resolve as resolve4 } from "path";
 import { createRequire as createRequire2 } from "module";
 import { Ajv2020 as Ajv20202 } from "ajv/dist/2020.js";
 
-// kernel/types/view-catalog.ts
+// kernel/types/view-catalog.generated.ts
 var ALL_SLOT_NAMES = [
   "card.title.right",
   "card.subtitle.left",
@@ -19999,6 +20003,12 @@ var PLUGINS_TEXTS = {
    */
   createInvalidId: "{{glyph}}  Plugin id must be kebab-case lowercase (got: {{id}}).\n   {{hint}}\n",
   createInvalidIdHint: "Use a-z, 0-9, and hyphens between segments (e.g. `my-plugin`, `kw-counter`).",
+  /**
+   * §3.1b two-line block. Rejected when the `<kind>` positional is not one
+   * of the closed extension-kind catalog; the hint lists the valid kinds.
+   */
+  createInvalidKind: "{{glyph}}  Unknown extension kind (got: {{kind}}).\n   {{hint}}\n",
+  createInvalidKindHint: "Use one of: {{kinds}}.",
   /**
    * §3.1b two-line block. Target directory exists and `--force` was not
    * passed; the hint surfaces the override flag.
@@ -20006,10 +20016,10 @@ var PLUGINS_TEXTS = {
   createRefuseOverwrite: "{{glyph}}  Refusing to overwrite {{targetDir}}.\n   {{hint}}\n",
   createRefuseOverwriteHint: "Pass --force to overwrite the existing directory.",
   /**
-   * Success block printed after scaffolding. Follows the no-em-dash rule
-   * across every line.
+   * Success block printed after scaffolding. Kind-agnostic (the main stub
+   * path is interpolated). Follows the no-em-dash rule across every line.
    */
-  createSuccess: "Created {{targetDir}}\nNext:\n  - Edit {{pluginId}}/extractors/{{pluginId}}-extractor/index.js (the extract() body)\n  - Run sm scan to see the contribution surface\n  - sm plugins slots list: browse other slots\n",
+  createSuccess: "Created {{targetDir}}\nNext:\n  - Edit {{mainFile}}\n  - Run sm plugins doctor to confirm it loads\n  - sm plugins slots list: browse slots and input-types\n",
   // --- slots list verb -------------------------------------------------
   /** Section header for the view-slots catalogue. */
   slotsListHeaderViewSlots: "  View slots ({{count}})\n",
@@ -21291,72 +21301,137 @@ function resolveBareToggle(id, catalogue) {
 
 // cli/commands/plugins/create.ts
 import { existsSync as existsSync25, mkdirSync as mkdirSync5, writeFileSync } from "fs";
-import { join as join18, resolve as resolve33 } from "path";
+import { dirname as dirname17, join as join18, resolve as resolve33 } from "path";
 import { Command as Command26, Option as Option25 } from "clipanion";
-var PluginsCreateCommand = class extends SmCommand {
-  static paths = [["plugins", "create"]];
-  static usage = Command26.Usage({
-    category: "Plugins",
-    description: "Scaffold a new plugin directory.",
-    details: "Emits plugin.json + extension stub + README. Pre-filled with one view contribution (slot `card.footer.left`) and one setting (`string-list`); edit to taste. Use `sm plugins slots list` to see other options."
-  });
-  pluginId = Option25.String({ required: true, name: "plugin-id" });
-  at = Option25.String("--at", { required: false });
-  force = Option25.Boolean("--force", false);
-  async run() {
-    const ansi = this.ansiFor("stderr");
-    const errGlyph = ansi.red("\u2715");
-    if (!/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(this.pluginId)) {
-      this.printer.error(
-        tx(PLUGINS_TEXTS.createInvalidId, {
-          glyph: errGlyph,
-          id: sanitizeForTerminal(this.pluginId),
-          hint: ansi.dim(PLUGINS_TEXTS.createInvalidIdHint)
-        })
-      );
-      return ExitCode.Error;
+
+// cli/commands/plugins/scaffold/action.ts
+function indexStub(extId) {
+  return `/**
+ * Generated by \`sm plugins create\`. Edit the invoke() body.
+ *
+ * Loader contract: default export object literal; \`kind\` (action) and id
+ * (\`${extId}\`) come from the folder layout (structure-as-truth), so
+ * neither is declared here. Every Action carries a sibling
+ * \`report.schema.json\`; a deterministic Action must NOT carry a
+ * \`prompt.md\` (that is the probabilistic surface).
+ *
+ * \`invoke(input, ctx)\` returns \`{ report, writes? }\`. The report must
+ * match this folder's \`report.schema.json\` (which extends the shared
+ * report-base: \`confidence\` + \`safety\`). \`writes\` is an optional
+ * array of side-effect descriptors the kernel materialises after the
+ * call returns (e.g. a sidecar write); keep \`invoke()\` itself pure.
+ *
+ * See: spec/plugin-author-guide.md, spec/schemas/extensions/action.schema.json
+ */
+export default {
+  version: '0.1.0',
+  description: 'Demo deterministic action; returns a fixed report.',
+  mode: 'deterministic',
+
+  invoke(input, ctx) {
+    return {
+      report: {
+        ok: true,
+        confidence: 1,
+        safety: { injectionDetected: false, contentQuality: 'unknown' },
+      },
+    };
+  },
+};
+`;
+}
+function reportSchema(pluginId, extId) {
+  const schema = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: `urn:skill-map:${pluginId}/${extId}/report`,
+    title: "DemoReport",
+    description: "Report returned by the demo action. Deterministic: confidence is fixed at 1 and no injection is detected.",
+    type: "object",
+    required: ["confidence", "safety"],
+    additionalProperties: false,
+    properties: {
+      ok: { type: "boolean" },
+      confidence: { type: "number", minimum: 0, maximum: 1 },
+      safety: {
+        type: "object",
+        required: ["injectionDetected", "contentQuality"],
+        additionalProperties: false,
+        properties: {
+          injectionDetected: { type: "boolean" },
+          contentQuality: {
+            type: "string",
+            enum: ["high", "medium", "low", "unknown"]
+          }
+        }
+      }
     }
-    const ctx = defaultRuntimeContext();
-    const baseDir = defaultProjectPluginsDir(ctx);
-    const targetDir = this.at ? resolve33(this.at) : join18(baseDir, this.pluginId);
-    if (existsSync25(targetDir) && !this.force) {
-      this.printer.error(
-        tx(PLUGINS_TEXTS.createRefuseOverwrite, {
-          glyph: errGlyph,
-          targetDir: sanitizeForTerminal(targetDir),
-          hint: ansi.dim(PLUGINS_TEXTS.createRefuseOverwriteHint)
-        })
-      );
-      return ExitCode.Error;
+  };
+  return JSON.stringify(schema, null, 2) + "\n";
+}
+var actionGenerator = {
+  folder: "actions",
+  files(pluginId) {
+    const ext = `${pluginId}-action`;
+    return [
+      { relPath: `actions/${ext}/index.js`, contents: indexStub(ext) },
+      { relPath: `actions/${ext}/report.schema.json`, contents: reportSchema(pluginId, ext) }
+    ];
+  }
+};
+
+// cli/commands/plugins/scaffold/analyzer.ts
+function stub(extId) {
+  return `/**
+ * Generated by \`sm plugins create\`. Edit the evaluate() body.
+ *
+ * Loader contract: default export object literal; \`kind\` (analyzer) and
+ * id (\`${extId}\`) come from the folder layout (structure-as-truth), so
+ * neither is declared here. Re-declaring them is \`invalid-manifest\`.
+ *
+ * \`evaluate(ctx)\` runs once per scan and returns \`Issue[]\`. The kernel
+ * stamps \`analyzerId\` from this extension's id and validates each issue
+ * (\`severity\` must be 'error' | 'warn' | 'info'; off-spec issues drop
+ * with an \`extension.error\` diagnostic). \`ctx.nodes\` / \`ctx.links\`
+ * are the scanned graph; \`ctx.accumulatedIssues\` is the live issue
+ * accumulator (read-only) for late-phase aggregate analyzers.
+ *
+ * See: spec/plugin-author-guide.md, spec/schemas/extensions/analyzer.schema.json
+ */
+export default {
+  version: '0.1.0',
+  description: 'Flags nodes that have no inbound or outbound links.',
+  mode: 'deterministic',
+
+  evaluate(ctx) {
+    const issues = [];
+    for (const node of ctx.nodes) {
+      if (node.linksInCount === 0 && node.linksOutCount === 0) {
+        issues.push({
+          severity: 'info',
+          nodeIds: [node.path],
+          message: 'Node has no links in or out (isolated).',
+        });
+      }
     }
-    const extractorName = `${this.pluginId}-extractor`;
-    mkdirSync5(join18(targetDir, "extractors", extractorName), { recursive: true });
-    const specVersion = installedSpecVersion();
-    const manifest = {
-      version: "0.1.0",
-      specCompat: `^${specVersion}`,
-      catalogCompat: "^1.0.0",
-      description: "Generated by `sm plugins create`. Edit to taste."
-    };
-    writeFileSync(
-      join18(targetDir, "plugin.json"),
-      JSON.stringify(manifest, null, 2) + "\n"
-    );
-    writeFileSync(
-      join18(targetDir, "extractors", extractorName, "index.js"),
-      scaffolderExtractorStub(extractorName)
-    );
-    writeFileSync(join18(targetDir, "README.md"), scaffolderReadme(this.pluginId));
-    this.printer.data(
-      tx(PLUGINS_TEXTS.createSuccess, {
-        targetDir: sanitizeForTerminal(targetDir),
-        pluginId: this.pluginId
-      })
-    );
-    return ExitCode.Ok;
+    return issues;
+  },
+};
+`;
+}
+var analyzerGenerator = {
+  folder: "analyzers",
+  files(pluginId) {
+    const ext = `${pluginId}-analyzer`;
+    return [{ relPath: `analyzers/${ext}/index.js`, contents: stub(ext) }];
   }
 };
-function scaffolderExtractorStub(extractorId) {
+
+// cli/commands/plugins/scaffold/defaults.ts
+var DEFAULT_SLOT = "card.footer.left";
+var DEFAULT_INPUT_TYPE = "string-list";
+
+// cli/commands/plugins/scaffold/extractor.ts
+function stub2(extId) {
   return `/**
  * Generated by \`sm plugins create\`. Edit the extract() body.
  *
@@ -21366,19 +21441,19 @@ function scaffolderExtractorStub(extractorId) {
  * a \`load-error\`.
  *
  * Folder convention: this file lives at
- * \`extractors/${extractorId}/index.js\`. The folder layout is the
- * source of truth (structure-as-truth): the loader derives \`kind\`
- * (\`extractor\`) from the parent folder and the id (\`${extractorId}\`)
- * from the leaf folder, and injects \`pluginId\` from the plugin, so none
- * of them are declared here. Re-declaring \`kind\` / \`id\` is rejected as
+ * \`extractors/${extId}/index.js\`. The folder layout is the source of
+ * truth (structure-as-truth): the loader derives \`kind\`
+ * (\`extractor\`) from the parent folder and the id (\`${extId}\`) from
+ * the leaf folder, and injects \`pluginId\` from the plugin, so none of
+ * them are declared here. Re-declaring \`kind\` / \`id\` is rejected as
  * \`invalid-manifest\`.
  *
  * Declared view contributions (\`ui\`):
- *   - 'count' \u2192 slot \`card.footer.left\` (renders as a chip
- *     in the left footer of the node card)
+ *   - 'count' \u2192 slot \`${DEFAULT_SLOT}\` (renders as a chip in the node
+ *     card footer)
  *
  * Declared settings (\`settings\`):
- *   - 'keywords' (string-list) \u2192 exposed as ctx.settings.keywords
+ *   - 'keywords' (${DEFAULT_INPUT_TYPE}) \u2192 exposed as ctx.settings.keywords
  *
  * See: spec/plugin-author-guide.md \xA7View contributions
  *      spec/view-slots.md
@@ -21390,7 +21465,7 @@ export default {
 
   settings: {
     keywords: {
-      type: 'string-list',
+      type: '${DEFAULT_INPUT_TYPE}',
       label: 'Keywords to track',
       description: 'Words counted across each scanned node body.',
       default: ['TODO', 'FIXME'],
@@ -21400,7 +21475,7 @@ export default {
 
   ui: {
     count: {
-      slot: 'card.footer.left',
+      slot: '${DEFAULT_SLOT}',
       icon: '\u{1F50D}',
       label: 'kw',
       emitWhenEmpty: false,
@@ -21421,26 +21496,284 @@ export default {
 };
 `;
 }
-function scaffolderReadme(pluginId) {
+var extractorGenerator = {
+  folder: "extractors",
+  files(pluginId) {
+    const ext = `${pluginId}-extractor`;
+    return [{ relPath: `extractors/${ext}/index.js`, contents: stub2(ext) }];
+  }
+};
+
+// cli/commands/plugins/scaffold/formatter.ts
+function stub3(extId) {
+  return `/**
+ * Generated by \`sm plugins create\`. Edit the format() body.
+ *
+ * Loader contract: default export object literal; \`kind\` (formatter) and
+ * id (\`${extId}\`) come from the folder layout (structure-as-truth). The
+ * format id used by \`sm graph --format ${extId}\` is the folder name; do
+ * NOT declare \`formatId\` (derived, re-declaring it is invalid-manifest).
+ *
+ * \`format(ctx)\` returns a string. \`ctx.scanResult\` is the full
+ * persisted scan (the canonical input); \`ctx.nodes\` / \`ctx.links\` /
+ * \`ctx.issues\` are the same data split out for convenience. Output has
+ * no trailing newline guarantee; the calling verb adds one if it needs.
+ *
+ * See: spec/plugin-author-guide.md, spec/schemas/extensions/formatter.schema.json
+ */
+export default {
+  version: '0.1.0',
+  description: 'Renders the scan as a one-line node/link/issue tally.',
+  contentType: 'text/plain',
+
+  format(ctx) {
+    const nodes = ctx.nodes || [];
+    const links = ctx.links || [];
+    const issues = ctx.issues || [];
+    return \`nodes=\${nodes.length} links=\${links.length} issues=\${issues.length}\`;
+  },
+};
+`;
+}
+var formatterGenerator = {
+  folder: "formatters",
+  files(pluginId) {
+    const ext = `${pluginId}-formatter`;
+    return [{ relPath: `formatters/${ext}/index.js`, contents: stub3(ext) }];
+  }
+};
+
+// cli/commands/plugins/scaffold/hook.ts
+function stub4(extId) {
+  return `/**
+ * Generated by \`sm plugins create\`. Edit the on() body.
+ *
+ * Loader contract: default export object literal; \`kind\` (hook) and id
+ * (\`${extId}\`) come from the folder layout (structure-as-truth). Hooks
+ * are deterministic-only: to run LLM work, enqueue a probabilistic Action
+ * via \`ctx.queue('<plugin>/<action>', payload)\` instead.
+ *
+ * \`triggers\` is the curated set this hook subscribes to (one of: boot,
+ * scan.started, scan.completed, extractor.completed, analyzer.completed,
+ * action.completed, job.spawning, job.completed, job.failed, shutdown).
+ * \`on(ctx)\` reads the event off \`ctx.event\` (\`ctx.event.data\` is the
+ * payload); the dispatcher catches errors so a throw never breaks the verb.
+ *
+ * See: spec/plugin-author-guide.md, spec/schemas/extensions/hook.schema.json
+ */
+export default {
+  version: '0.1.0',
+  description: 'Demo hook; reacts once on boot.',
+  triggers: ['boot'],
+
+  async on(ctx) {
+    const data = (ctx.event && ctx.event.data) || {};
+    // No-op demo. A real hook reacts here, e.g. inspect \`data\`, write a
+    // log line, or enqueue an action with ctx.queue(...).
+    void data;
+  },
+};
+`;
+}
+var hookGenerator = {
+  folder: "hooks",
+  files(pluginId) {
+    const ext = `${pluginId}-hook`;
+    return [{ relPath: `hooks/${ext}/index.js`, contents: stub4(ext) }];
+  }
+};
+
+// cli/commands/plugins/scaffold/provider.ts
+function titleCase(id) {
+  return id.split("-").map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join(" ");
+}
+function stub5(pluginId, extId) {
+  const label = titleCase(pluginId);
+  return `/**
+ * Generated by \`sm plugins create\`. Skeleton provider: edit classify()
+ * and add a kind under \`kinds/\` (see the TODO below).
+ *
+ * Loader contract: default export object literal; \`kind\` (provider) and
+ * id (\`${extId}\`) come from the folder layout (structure-as-truth). Do
+ * NOT declare a \`kinds\` map here, it is rejected as invalid-manifest;
+ * kinds are discovered from \`kinds/<kindName>/\` folders at the PLUGIN
+ * root.
+ *
+ * \`presentation\` (label + hex color) is required: the UI reads it for
+ * the lens dropdown, the topbar chip, and the per-node provider chip.
+ * \`read\` configures file discovery (defaults to \`.md\` +
+ * frontmatter-yaml when omitted). \`classify(path, frontmatter)\` returns
+ * the node kind for files this provider owns, or null to let the file
+ * fall through to the markdown fallback.
+ *
+ * TODO: this skeleton classifies nothing (returns null). To emit nodes:
+ *   1. Pick a kind name, e.g. 'note'.
+ *   2. Create \`kinds/note/schema.json\` (frontmatter JSON Schema,
+ *      allOf + $ref to frontmatter/base.schema.json).
+ *   3. Create \`kinds/note/kind.json\` ({ "ui": { "label": "...",
+ *      "color": "#......" } }).
+ *   4. Return 'note' from classify() for the files you own.
+ *
+ * See: spec/plugin-author-guide.md, spec/schemas/extensions/provider.schema.json
+ */
+export default {
+  version: '0.1.0',
+  description: 'Skeleton provider; classify() returns null until a kind is added.',
+
+  presentation: {
+    label: '${label}',
+    color: '#6b7280',
+  },
+
+  read: { extensions: ['.md'], parser: 'frontmatter-yaml' },
+
+  classify(path, frontmatter) {
+    // TODO: return a kind name (see header) for files this provider owns.
+    void path;
+    void frontmatter;
+    return null;
+  },
+};
+`;
+}
+var providerGenerator = {
+  folder: "providers",
+  files(pluginId) {
+    const ext = `${pluginId}-provider`;
+    return [{ relPath: `providers/${ext}/index.js`, contents: stub5(pluginId, ext) }];
+  }
+};
+
+// cli/commands/plugins/scaffold/readme.ts
+function scaffolderReadme(pluginId, kind, mainFileRel) {
   return `# ${pluginId}
 
-Generated by \`sm plugins create\`. Edit \`extractors/${pluginId}-extractor/index.js\` to taste.
+Generated by \`sm plugins create ${kind} ${pluginId}\`. Edit \`${mainFileRel}\` to taste.
 
 ## Verbs
 
 - \`sm plugins show ${pluginId}\`: manifest + load status
 - \`sm plugins doctor\`: full plugin diagnostic
-- \`sm scan\`: re-emit contributions
+- \`sm scan\`: re-emit contributions / re-run analysis
 
 ## Resources
 
-- \`spec/plugin-author-guide.md\` \xA7View contributions
-- \`spec/view-slots.md\`: the closed catalog of slots
-- \`spec/input-types.md\`: the closed catalog of input-types for settings
-- \`sm plugins slots list\`: browse the catalog from the CLI
+- \`spec/plugin-author-guide.md\`: authoring guide for every kind
+- \`spec/view-slots.md\`: the closed catalog of view slots
+- \`spec/input-types.md\`: the closed catalog of setting input-types
+- \`sm plugins slots list\`: browse the slot / input-type catalog from the CLI
 `;
 }
 
+// cli/commands/plugins/scaffold/index.ts
+var GENERATORS = {
+  provider: providerGenerator,
+  extractor: extractorGenerator,
+  analyzer: analyzerGenerator,
+  action: actionGenerator,
+  formatter: formatterGenerator,
+  hook: hookGenerator
+};
+function pluginManifest(specVersion) {
+  return {
+    version: "0.1.0",
+    specCompat: `^${specVersion}`,
+    catalogCompat: "^1.0.0",
+    description: "Generated by `sm plugins create`. Edit to taste."
+  };
+}
+function generateScaffold(kind, pluginId, specVersion) {
+  const extFiles = GENERATORS[kind].files(pluginId);
+  const main = extFiles[0];
+  if (!main) {
+    throw new Error(`scaffold generator for kind '${kind}' returned no files`);
+  }
+  return [
+    {
+      relPath: "plugin.json",
+      contents: JSON.stringify(pluginManifest(specVersion), null, 2) + "\n"
+    },
+    ...extFiles,
+    { relPath: "README.md", contents: scaffolderReadme(pluginId, kind, main.relPath) }
+  ];
+}
+
+// cli/commands/plugins/create.ts
+var PluginsCreateCommand = class extends SmCommand {
+  static paths = [["plugins", "create"]];
+  static usage = Command26.Usage({
+    category: "Plugins",
+    description: "Scaffold a new plugin directory.",
+    details: "Emits plugin.json + a per-kind extension stub + README. `<kind>` is one of: provider, extractor, analyzer, action, formatter, hook. The extractor stub ships one view contribution (slot `card.footer.left`) and one setting (`string-list`); edit to taste. Use `sm plugins slots list` to browse the slot / input-type catalog.",
+    examples: [
+      ["Scaffold an extractor", "$0 plugins create extractor kw-counter"],
+      ["Scaffold an analyzer", "$0 plugins create analyzer my-linter"],
+      ["Scaffold a provider", "$0 plugins create provider my-vendor"]
+    ]
+  });
+  // First positional: the extension kind (required). Declared before
+  // `pluginId` so clipanion assigns it the first positional slot.
+  kind = Option25.String({ required: true, name: "kind" });
+  pluginId = Option25.String({ required: true, name: "plugin-id" });
+  at = Option25.String("--at", { required: false });
+  force = Option25.Boolean("--force", false);
+  async run() {
+    const ansi = this.ansiFor("stderr");
+    const errGlyph = ansi.red("\u2715");
+    if (!EXTENSION_KINDS.includes(this.kind)) {
+      this.printer.error(
+        tx(PLUGINS_TEXTS.createInvalidKind, {
+          glyph: errGlyph,
+          kind: sanitizeForTerminal(this.kind),
+          hint: ansi.dim(
+            tx(PLUGINS_TEXTS.createInvalidKindHint, { kinds: EXTENSION_KINDS.join(", ") })
+          )
+        })
+      );
+      return ExitCode.Error;
+    }
+    if (!/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(this.pluginId)) {
+      this.printer.error(
+        tx(PLUGINS_TEXTS.createInvalidId, {
+          glyph: errGlyph,
+          id: sanitizeForTerminal(this.pluginId),
+          hint: ansi.dim(PLUGINS_TEXTS.createInvalidIdHint)
+        })
+      );
+      return ExitCode.Error;
+    }
+    const kind = this.kind;
+    const ctx = defaultRuntimeContext();
+    const baseDir = defaultProjectPluginsDir(ctx);
+    const targetDir = this.at ? resolve33(this.at) : join18(baseDir, this.pluginId);
+    if (existsSync25(targetDir) && !this.force) {
+      this.printer.error(
+        tx(PLUGINS_TEXTS.createRefuseOverwrite, {
+          glyph: errGlyph,
+          targetDir: sanitizeForTerminal(targetDir),
+          hint: ansi.dim(PLUGINS_TEXTS.createRefuseOverwriteHint)
+        })
+      );
+      return ExitCode.Error;
+    }
+    const specVersion = installedSpecVersion();
+    const files = generateScaffold(kind, this.pluginId, specVersion);
+    for (const file of files) {
+      const abs = join18(targetDir, file.relPath);
+      mkdirSync5(dirname17(abs), { recursive: true });
+      writeFileSync(abs, file.contents);
+    }
+    const mainFile = `${kind}s/${this.pluginId}-${kind}/index.js`;
+    this.printer.data(
+      tx(PLUGINS_TEXTS.createSuccess, {
+        targetDir: sanitizeForTerminal(targetDir),
+        mainFile
+      })
+    );
+    return ExitCode.Ok;
+  }
+};
+
 // cli/commands/plugins/slots.ts
 import { Command as Command27 } from "clipanion";
 
@@ -22078,7 +22411,7 @@ var SCAN_TEXTS = {
 import { Command as Command30, Option as Option28 } from "clipanion";
 
 // core/watcher/runtime.ts
-import { dirname as dirname17 } from "path";
+import { dirname as dirname18 } from "path";
 
 // core/runtime/fresh-resolver.ts
 async function buildFreshResolver(deps) {
@@ -22321,7 +22654,7 @@ function createWatcherRuntime(opts) {
         roots: [
           cwd,
           // parent of `.skillmapignore`
-          dirname17(settingsPath)
+          dirname18(settingsPath)
           // parent of `.skill-map/settings.json`
         ],
         cwd,
@@ -26699,7 +27032,7 @@ function validateNoUi(noUi, uiDist) {
 
 // server/paths.ts
 import { existsSync as existsSync30, statSync as statSync10 } from "fs";
-import { dirname as dirname18, isAbsolute as isAbsolute11, join as join20, resolve as resolve37 } from "path";
+import { dirname as dirname19, isAbsolute as isAbsolute11, join as join20, resolve as resolve37 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 var DEFAULT_UI_REL = join20("ui", "dist", "ui", "browser");
 var PACKAGE_UI_REL = "ui";
@@ -26724,7 +27057,7 @@ function isUiBundleDir(path) {
 function resolvePackageBundledUi() {
   let here;
   try {
-    here = dirname18(fileURLToPath6(import.meta.url));
+    here = dirname19(fileURLToPath6(import.meta.url));
   } catch {
     return null;
   }
@@ -26737,7 +27070,7 @@ function resolvePackageBundledUiFrom(here) {
     if (isUiBundleDir(candidate)) return candidate;
     const distHere = join20(current, "dist", PACKAGE_UI_REL);
     if (isUiBundleDir(distHere)) return distHere;
-    const parent = dirname18(current);
+    const parent = dirname19(current);
     if (parent === current) return null;
     current = parent;
   }
@@ -26748,7 +27081,7 @@ function walkUpForUi(startDir) {
   for (let i = 0; i < 64; i++) {
     const candidate = join20(current, DEFAULT_UI_REL);
     if (isUiBundleDir(candidate)) return candidate;
-    const parent = dirname18(current);
+    const parent = dirname19(current);
     if (parent === current) return null;
     current = parent;
   }
@@ -28587,7 +28920,7 @@ var STUB_COMMANDS = [
 
 // cli/commands/tutorial.ts
 import { cpSync as cpSync2, existsSync as existsSync32, mkdirSync as mkdirSync6, readdirSync as readdirSync10, rmSync as rmSync2, statSync as statSync11 } from "fs";
-import { dirname as dirname19, join as join21, resolve as resolve39 } from "path";
+import { dirname as dirname20, join as join21, resolve as resolve39 } from "path";
 import { createInterface as createInterface5 } from "readline";
 import { fileURLToPath as fileURLToPath7 } from "url";
 import { Command as Command37, Option as Option35 } from "clipanion";
@@ -28650,14 +28983,14 @@ var VARIANT_SPECS = {
   tutorial: {
     slug: "sm-tutorial",
     sourceDir: ".claude/skills/sm-tutorial",
-    triggerEn: "start the tutorial",
-    triggerEs: "arranquemos el tutorial"
+    triggerEn: "run the tutorial",
+    triggerEs: "ejecuta el tutorial"
   },
   master: {
     slug: "sm-master",
     sourceDir: ".claude/skills/sm-master",
-    triggerEn: "advanced tutorial",
-    triggerEs: "tutorial maestro"
+    triggerEn: "run the master tutorial",
+    triggerEs: "ejecuta el tutorial maestro"
   }
 };
 var TutorialCommand = class extends SmCommand {
@@ -28733,7 +29066,7 @@ var TutorialCommand = class extends SmCommand {
     }
     try {
       rmSync2(targetDir, { recursive: true, force: true });
-      mkdirSync6(dirname19(targetDir), { recursive: true });
+      mkdirSync6(dirname20(targetDir), { recursive: true });
       cpSync2(sourceDir, targetDir, { recursive: true });
     } catch (err) {
       this.printer.error(
@@ -28920,7 +29253,7 @@ function resolveSkillSourceDir(variant) {
   const cached = cachedSourceDirs.get(variant);
   if (cached !== void 0) return cached;
   const spec = VARIANT_SPECS[variant];
-  const here = dirname19(fileURLToPath7(import.meta.url));
+  const here = dirname20(fileURLToPath7(import.meta.url));
   const candidates = [
     // dev: src/cli/commands/ → repo-root .claude/skills/<slug>/
     resolve39(here, "../../..", spec.sourceDir),
@@ -29155,4 +29488,4 @@ function resolveBareDefault() {
   process.exit(ExitCode.Error);
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=926243f9-3707-54bc-9aa6-c68955118161
+//# debugId=a68e2b18-f1ae-5a4d-8cd7-72ddbf9688ab