@skill-map/cli 0.11.1 → 0.12.0

package/README.md

@@ -1,6 +1,6 @@
 # skill-map
 
-Map, inspect, and manage collections of interrelated Markdown files — skills, agents, commands, hooks, and notes that compose AI-agent ecosystems (Claude Code, Codex, Gemini, Copilot, Obsidian vaults, docs sites).
+Map, inspect, and manage collections of interrelated Markdown files — skills, agents, commands, hooks, and notes that compose AI-agent ecosystems (Claude Code, Codex, Gemini, Copilot, docs sites).
 
 **Status**: pre-1.0, active development. Steps 0a–9 are complete (spec, kernel, plugin loader, full CLI surface, plugin author UX). Step 14 (Full Web UI) is in progress with sub-steps 14.1–14.4 closed (Hono BFF + REST + WebSocket broadcaster + reactive UI); 14.5–14.7 (polish + bundle budgets + responsive scope) still pending. The full deterministic scan, check, history, orphans, plugin authoring, and `sm serve` are live; the optional LLM layer (Phase B / `v0.8.0`) lands after Step 14 closes. See [`ROADMAP.md`](../ROADMAP.md) for the canonical completeness marker and full execution plan. Releases follow the standard changeset flow.
 

package/dist/cli.js

@@ -1,4 +1,5 @@
 // cli/entry.ts
+import { existsSync as existsSync19 } from "fs";
 import { Builtins, Cli as Cli2 } from "clipanion";
 
 // kernel/adapters/silent-logger.ts
@@ -28,6 +29,30 @@ function configureLogger(impl) {
   active = impl;
 }
 
+// kernel/util/tx.ts
+var TOKEN_RE = /\{\{\s*([A-Za-z][A-Za-z0-9_]*)\s*\}\}/g;
+function tx(template, vars = {}) {
+  return template.replace(TOKEN_RE, (_match, name) => {
+    if (!Object.prototype.hasOwnProperty.call(vars, name)) {
+      throw new Error(
+        `tx: missing variable "${name}" for template "${template.slice(0, 80)}${template.length > 80 ? "\u2026" : ""}"`
+      );
+    }
+    const value = vars[name];
+    if (value === null || value === void 0) {
+      throw new Error(
+        `tx: variable "${name}" is null/undefined for template "${template.slice(0, 80)}${template.length > 80 ? "\u2026" : ""}"`
+      );
+    }
+    return String(value);
+  });
+}
+
+// cli/i18n/entry.texts.ts
+var ENTRY_TEXTS = {
+  bareNoProject: 'No skill-map project found in {{cwd}}.\nRun "sm init" to bootstrap one, or "sm --help" to see all commands.\n'
+};
+
 // kernel/ports/logger.ts
 var LOG_LEVELS = [
   "trace",
@@ -65,25 +90,6 @@ function sanitizeForTerminal(text) {
   return text.replace(ANSI_ESCAPE_RE, "").replace(C0_CONTROL_RE, "");
 }
 
-// kernel/util/tx.ts
-var TOKEN_RE = /\{\{\s*([A-Za-z][A-Za-z0-9_]*)\s*\}\}/g;
-function tx(template, vars = {}) {
-  return template.replace(TOKEN_RE, (_match, name) => {
-    if (!Object.prototype.hasOwnProperty.call(vars, name)) {
-      throw new Error(
-        `tx: missing variable "${name}" for template "${template.slice(0, 80)}${template.length > 80 ? "\u2026" : ""}"`
-      );
-    }
-    const value = vars[name];
-    if (value === null || value === void 0) {
-      throw new Error(
-        `tx: variable "${name}" is null/undefined for template "${template.slice(0, 80)}${template.length > 80 ? "\u2026" : ""}"`
-      );
-    }
-    return String(value);
-  });
-}
-
 // cli/i18n/logger.texts.ts
 var LOGGER_TEXTS = {
   invalidLevel: 'invalid log level "{{value}}" (expected one of: {{allowed}})\n'
@@ -179,6 +185,91 @@ function extractLogLevelFlag(argv) {
 }
 var LOGGER_ENV_VAR = ENV_VAR;
 
+// cli/util/db-path.ts
+import { existsSync } from "fs";
+import { join, resolve } from "path";
+
+// cli/i18n/util.texts.ts
+var UTIL_TEXTS = {
+  // db-path.ts
+  dbNotFound: "DB not found at {{path}}; run `sm scan` first.\n",
+  // elapsed.ts
+  doneIn: "done in {{elapsed}}\n",
+  // confirm.ts (default-no prompt suffix)
+  confirmPromptSuffix: " [y/N] ",
+  /**
+   * Regex source matching affirmative answers in `confirm()`. Compiled
+   * with the `i` flag in the helper. Pre-i18n today the pattern is
+   * English-only; when a non-English locale lands the catalog grows
+   * alternations (e.g. `^(y(es)?|s(í|i)?)$`).
+   */
+  confirmYesPatternSource: "^y(es)?$"
+};
+
+// cli/util/db-path.ts
+var SKILL_MAP_DIR = ".skill-map";
+var DB_FILENAME = "skill-map.db";
+var JOBS_DIRNAME = "jobs";
+var PLUGINS_DIRNAME = "plugins";
+var SETTINGS_FILENAME = "settings.json";
+var LOCAL_SETTINGS_FILENAME = "settings.local.json";
+var IGNORE_FILENAME = ".skill-mapignore";
+var DEFAULT_DB_REL = `${SKILL_MAP_DIR}/${DB_FILENAME}`;
+var GITIGNORE_ENTRIES = [
+  `${SKILL_MAP_DIR}/${LOCAL_SETTINGS_FILENAME}`,
+  `${SKILL_MAP_DIR}/${DB_FILENAME}`
+];
+function resolveDbPath(options) {
+  if (options.db) return resolve(options.db);
+  if (options.global) return join(options.homedir, DEFAULT_DB_REL);
+  return resolve(options.cwd, DEFAULT_DB_REL);
+}
+function defaultProjectDbPath(ctx) {
+  return resolve(ctx.cwd, DEFAULT_DB_REL);
+}
+function defaultProjectJobsDir(ctx) {
+  return resolve(ctx.cwd, SKILL_MAP_DIR, JOBS_DIRNAME);
+}
+function defaultProjectPluginsDir(ctx) {
+  return resolve(ctx.cwd, SKILL_MAP_DIR, PLUGINS_DIRNAME);
+}
+function defaultUserPluginsDir(ctx) {
+  return join(ctx.homedir, SKILL_MAP_DIR, PLUGINS_DIRNAME);
+}
+function defaultDbPath(scopeRoot) {
+  return join(scopeRoot, SKILL_MAP_DIR, DB_FILENAME);
+}
+function defaultSettingsPath(scopeRoot) {
+  return join(scopeRoot, SKILL_MAP_DIR, SETTINGS_FILENAME);
+}
+function defaultLocalSettingsPath(scopeRoot) {
+  return join(scopeRoot, SKILL_MAP_DIR, LOCAL_SETTINGS_FILENAME);
+}
+function defaultIgnoreFilePath(scopeRoot) {
+  return join(scopeRoot, IGNORE_FILENAME);
+}
+function assertDbExists(path, stderr) {
+  if (path === ":memory:" || existsSync(path)) return true;
+  stderr.write(tx(UTIL_TEXTS.dbNotFound, { path }));
+  return false;
+}
+
+// cli/util/exit-codes.ts
+var ExitCode = {
+  Ok: 0,
+  Issues: 1,
+  Error: 2,
+  Duplicate: 3,
+  NonceMismatch: 4,
+  NotFound: 5
+};
+
+// cli/util/runtime-context.ts
+import { homedir } from "os";
+function defaultRuntimeContext() {
+  return { cwd: process.cwd(), homedir: homedir() };
+}
+
 // cli/commands/check.ts
 import { Command as Command2, Option as Option2 } from "clipanion";
 
@@ -271,91 +362,6 @@ var CHECK_TEXTS = {
   probStubAdvisoryAsync: "sm check --include-prob --async: probabilistic Rule dispatch requires the job subsystem (Step 10). Stub: skipped {{count}} probabilistic rule(s) \u2014 {{ruleIds}}. The --async flag is reserved for future encoding (returns job ids without waiting once jobs land); today it is a no-op. Deterministic rules ran as usual.\n"
 };
 
-// cli/util/db-path.ts
-import { existsSync } from "fs";
-import { join, resolve } from "path";
-
-// cli/i18n/util.texts.ts
-var UTIL_TEXTS = {
-  // db-path.ts
-  dbNotFound: "DB not found at {{path}}; run `sm scan` first.\n",
-  // elapsed.ts
-  doneIn: "done in {{elapsed}}\n",
-  // confirm.ts (default-no prompt suffix)
-  confirmPromptSuffix: " [y/N] ",
-  /**
-   * Regex source matching affirmative answers in `confirm()`. Compiled
-   * with the `i` flag in the helper. Pre-i18n today the pattern is
-   * English-only; when a non-English locale lands the catalog grows
-   * alternations (e.g. `^(y(es)?|s(í|i)?)$`).
-   */
-  confirmYesPatternSource: "^y(es)?$"
-};
-
-// cli/util/db-path.ts
-var SKILL_MAP_DIR = ".skill-map";
-var DB_FILENAME = "skill-map.db";
-var JOBS_DIRNAME = "jobs";
-var PLUGINS_DIRNAME = "plugins";
-var SETTINGS_FILENAME = "settings.json";
-var LOCAL_SETTINGS_FILENAME = "settings.local.json";
-var IGNORE_FILENAME = ".skill-mapignore";
-var DEFAULT_DB_REL = `${SKILL_MAP_DIR}/${DB_FILENAME}`;
-var GITIGNORE_ENTRIES = [
-  `${SKILL_MAP_DIR}/${LOCAL_SETTINGS_FILENAME}`,
-  `${SKILL_MAP_DIR}/${DB_FILENAME}`
-];
-function resolveDbPath(options) {
-  if (options.db) return resolve(options.db);
-  if (options.global) return join(options.homedir, DEFAULT_DB_REL);
-  return resolve(options.cwd, DEFAULT_DB_REL);
-}
-function defaultProjectDbPath(ctx) {
-  return resolve(ctx.cwd, DEFAULT_DB_REL);
-}
-function defaultProjectJobsDir(ctx) {
-  return resolve(ctx.cwd, SKILL_MAP_DIR, JOBS_DIRNAME);
-}
-function defaultProjectPluginsDir(ctx) {
-  return resolve(ctx.cwd, SKILL_MAP_DIR, PLUGINS_DIRNAME);
-}
-function defaultUserPluginsDir(ctx) {
-  return join(ctx.homedir, SKILL_MAP_DIR, PLUGINS_DIRNAME);
-}
-function defaultDbPath(scopeRoot) {
-  return join(scopeRoot, SKILL_MAP_DIR, DB_FILENAME);
-}
-function defaultSettingsPath(scopeRoot) {
-  return join(scopeRoot, SKILL_MAP_DIR, SETTINGS_FILENAME);
-}
-function defaultLocalSettingsPath(scopeRoot) {
-  return join(scopeRoot, SKILL_MAP_DIR, LOCAL_SETTINGS_FILENAME);
-}
-function defaultIgnoreFilePath(scopeRoot) {
-  return join(scopeRoot, IGNORE_FILENAME);
-}
-function assertDbExists(path, stderr) {
-  if (path === ":memory:" || existsSync(path)) return true;
-  stderr.write(tx(UTIL_TEXTS.dbNotFound, { path }));
-  return false;
-}
-
-// cli/util/runtime-context.ts
-import { homedir } from "os";
-function defaultRuntimeContext() {
-  return { cwd: process.cwd(), homedir: homedir() };
-}
-
-// cli/util/exit-codes.ts
-var ExitCode = {
-  Ok: 0,
-  Issues: 1,
-  Error: 2,
-  Duplicate: 3,
-  NonceMismatch: 4,
-  NotFound: 5
-};
-
 // cli/util/plugin-runtime.ts
 import { resolve as resolve8 } from "path";
 
@@ -7028,7 +7034,7 @@ import { Command as Command8, Option as Option8 } from "clipanion";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.11.1",
+  version: "0.12.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -7540,7 +7546,7 @@ function renderCompactOverview(verbs) {
   return lines.join("\n") + "\n";
 }
 var RootHelpCommand = class extends Command8 {
-  static paths = [["-h"], ["--help"], Command8.Default];
+  static paths = [["-h"], ["--help"]];
   async execute() {
     const rawDefs = this.cli.definitions();
     const verbs = rawDefs.filter((d) => !isBuiltin(d)).map(normalizeDefinition).sort(byPath);
@@ -14064,11 +14070,20 @@ var logLevel = resolveLogLevel({
   errStream: process.stderr
 });
 configureLogger(new Logger({ level: logLevel, stream: process.stderr }));
-var routedArgs = routeHelpArgs(args, cli);
+var bareArgs = args.length === 0 ? resolveBareDefault() : null;
+var routedArgs = routeHelpArgs(bareArgs ?? args, cli);
 var exitCode = await cli.run(routedArgs, {
   stdin: process.stdin,
   stdout: process.stdout,
   stderr: process.stderr
 });
 process.exit(exitCode);
+function resolveBareDefault() {
+  const ctx = defaultRuntimeContext();
+  if (existsSync19(defaultProjectDbPath(ctx))) {
+    return ["serve"];
+  }
+  process.stderr.write(tx(ENTRY_TEXTS.bareNoProject, { cwd: ctx.cwd }));
+  process.exit(ExitCode.Error);
+}
 //# sourceMappingURL=cli.js.map