@nightowlsdev/cli 0.1.1 → 0.2.0

package/README.md

@@ -22,6 +22,7 @@ npx @nightowlsdev/cli init
 | `owl <plugin> <cmd>` | Run a plugin's own subcommand (e.g. `owl storage-supabase info`, `owl runner-nextjs routes`). `owl <plugin> --help` lists a plugin's commands; `owl <plugin> <cmd> --help` shows a command's flags. |
 | `owl db install` | (Re-)install Night Owls' migrations into the host's classic `supabase/migrations/` as timestamped `.sql` files, so they run with the app's own via `supabase db push`. Useful after upgrading an adapter. Idempotent. Flag: `--out <dir>` (default `supabase/migrations`). |
 | `owl db types` | Generate TypeScript types for the `nightowls` schema (`supabase gen types typescript --schema nightowls`). |
+| `owl mcp` | Start the Night Owls MCP server on stdio (exposes `nightowls_*` tools to external coding agents such as Claude Code or Cursor). |
 
 ## Adapters and what `owl install` wires
 
@@ -45,6 +46,7 @@ provider wires `modelFactory` and `models.allow` is env-driven from it).
 | `model-openrouter` | model | any model via OpenRouter. env `OPENROUTER_API_KEY`, `MODEL_ID`; config `modelFactory = openrouterModels()`. Command: `info`. |
 | `model-anthropic` | model | Anthropic Claude models (native `@ai-sdk/anthropic`). env `ANTHROPIC_API_KEY`, `MODEL_ID`; config `modelFactory = anthropicModels()`. Command: `info`. |
 | `model-openai` | model | OpenAI models (native `@ai-sdk/openai`). env `OPENAI_API_KEY`, `MODEL_ID`; config `modelFactory = openaiModels()`. Command: `info`. |
+| `model-ollama` | model | Models via Ollama (OpenAI-compatible endpoint). Local needs **no API key**; Ollama Cloud uses one. env `OLLAMA_BASE_URL` (default `http://localhost:11434/v1`), `OLLAMA_API_KEY` (Cloud only), `MODEL_ID` (e.g. `llama3.1`); config `modelFactory = ollamaModels()`. Command: `info`. |
 
 Telemetry composing is verified at the gate: the generated `nightowls.config.ts` with storage + runner + auth
 + a model provider (`modelFactory = anthropicModels()`) + **both** telemetry exporters **parses and
@@ -104,7 +106,7 @@ An adapter plugs into the CLI by exporting a `nightOwlsPlugin` plain object that
 export interface NightOwlsPlugin {
   name: string;            // short name, e.g. "storage-supabase"
   version: string;
-  kind?: "storage" | "runner" | "auth" | "telemetry" | "ui" | "connector";
+  kind?: "storage" | "runner" | "auth" | "telemetry" | "ui" | "connector" | "model";
   pkg: string;             // npm name, e.g. "@nightowlsdev/storage-supabase"
   description?: string;    // one-line summary shown by `owl plugins` + `owl <plugin> --help`
   migrations?: { version: string; name: string; sql: string }[]; // installed into supabase/migrations/
@@ -113,7 +115,7 @@ export interface NightOwlsPlugin {
   config?: {                                                       // inserted at the `// nightowls:<marker>` line
     import: string;
     snippet: string;
-    marker: "storage" | "auth" | "runner" | "telemetry" | "connector";
+    marker: "storage" | "auth" | "runner" | "telemetry" | "connector" | "model";
   };
   // Runs after the declarative wiring on init/install (idempotent; print-only — never applies DDL).
   init?: (ctx: { cwd: string; log: (msg: string) => void }) => void | Promise<void>;
@@ -148,7 +150,22 @@ into your `supabase/migrations/` (via `owl install` / `owl db install`); your ho
 There is one migration system — the host's — and Night Owls never runs DDL itself. See
 `docs/spec/2026-06-03-owl-schema-and-cli.md`.
 
-## Roadmap
+## `owl mcp`
 
-The agentic CLI layer (`owl doctor`, `owl mcp`, deep ts-morph config edits) is future work. Today the
-config insertion is marker-based — the `// nightowls:<marker>` comment lines are stable insertion points.
+Run the Night Owls MCP server on stdio. This exposes `nightowls_*` tools to external coding agents
+(Claude Code, Cursor, or any MCP client) so they can query the local Night Owls environment without
+running CLI subcommands manually.
+
+```bash
+owl mcp
+```
+
+The server starts on stdio (JSON-RPC frames on stdout; human-readable diagnostics on stderr). Currently
+exposes one tool:
+
+| Tool | Description |
+| --- | --- |
+| `nightowls_doctor` | Read-only diagnostics: confirms the bootstrap store is reachable, reports Node version and cwd. `readOnlyHint: true`. |
+
+Engine-wall §1 / Option B is enforced here: `owl mcp` uses the raw `@modelcontextprotocol/sdk` and
+`@nightowlsdev/storage-local`'s factory — **zero `@mastra/*` imports** enter the CLI binary.

package/dist/cli.js

@@ -35,16 +35,17 @@ function migrationStamp(base, i) {
   const p = (n) => String(n).padStart(2, "0");
   return `${d.getUTCFullYear()}${p(d.getUTCMonth() + 1)}${p(d.getUTCDate())}${p(d.getUTCHours())}${p(d.getUTCMinutes())}${p(d.getUTCSeconds())}`;
 }
-var INSTALLED_FILE = /_corale_(.+)\.sql$/;
+var INSTALLED_FILE = /_nightowls_(.+)\.sql$/;
 async function runDbInstall(deps) {
   const migrations = collectMigrations(deps.plugins);
   const dir = `${deps.root.replace(/\/$/, "")}/${deps.out.replace(/^\//, "")}`;
-  await deps.fs.mkdir(dir, { recursive: true }).catch(() => void 0);
+  if (!deps.dryRun) await deps.fs.mkdir(dir, { recursive: true }).catch(() => void 0);
   const existing = await deps.fs.readdir(dir).catch(() => []);
   const installed = new Set(
     existing.map((f) => INSTALLED_FILE.exec(f)?.[1]).filter((v) => Boolean(v))
   );
   const base = deps.now();
+  const stamp = deps.stamp ?? ((_v, i2, b) => migrationStamp(b, i2));
   const written = [];
   const skipped = [];
   let i = 0;
@@ -53,13 +54,13 @@ async function runDbInstall(deps) {
       skipped.push(m.version);
       continue;
     }
-    const file = `${migrationStamp(base, i)}_corale_${m.version}.sql`;
-    await deps.fs.writeFile(`${dir}/${file}`, `${m.sql.trimStart()}
+    const file = `${stamp(m.version, i, base)}_nightowls_${m.version}.sql`;
+    if (!deps.dryRun) await deps.fs.writeFile(`${dir}/${file}`, `${m.sql.trimStart()}
 `);
     written.push({ version: m.version, file });
     i += 1;
   }
-  return { written, skipped };
+  return { written, skipped, dryRun: Boolean(deps.dryRun) };
 }
 
 // src/templates.ts
@@ -93,7 +94,7 @@ let telemetry: Extract<NonNullable<Parameters<typeof defineSwarm>[0]["telemetry"
 // snippet can reassign it; the placeholder throws until a real provider is wired. \`models.allow\` is
 // env-driven (\`MODEL_ID\`), so the scaffold is runnable once a model plugin + MODEL_ID are set.
 let modelFactory: Parameters<typeof defineSwarm>[0]["modelFactory"] = () => {
-  throw new Error("Install a model provider: owl install model-anthropic (or model-openai / model-vercel-gateway / model-openrouter).");
+  throw new Error("Install a model provider: owl install model-anthropic (or model-openai / model-vercel-gateway / model-openrouter / model-ollama).");
 };
 // nightowls:model
 
@@ -386,19 +387,22 @@ db.command("types").description("Generate TypeScript types for the nightowls sch
   const out = await runDbTypes({ exec });
   process.stdout.write(out);
 });
-db.command("install").description("Install Night Owls' migrations into your supabase/migrations/ (timestamped, idempotent) \u2014 apply them with `supabase db push`.").option("--out <dir>", "target migrations dir (relative to cwd)", "supabase/migrations").action(async (opts) => {
+db.command("install").description("Install Night Owls' migrations into your supabase/migrations/ (timestamped, idempotent) \u2014 apply them with `supabase db push`.").option("--out <dir>", "target migrations dir (relative to cwd)", "supabase/migrations").option("--dry-run", "preview the migration set without writing any files", false).action(async (opts) => {
   const cwd = process.cwd();
   const plugins = await discoverPlugins(nodeDiscoverDeps(cwd));
-  const { written, skipped } = await runDbInstall({
+  const { written, skipped, dryRun } = await runDbInstall({
     plugins,
     root: cwd,
     out: opts.out,
     fs: await nodeFs(),
-    now: () => /* @__PURE__ */ new Date()
+    now: () => /* @__PURE__ */ new Date(),
+    dryRun: opts.dryRun
   });
-  for (const w of written) console.log(`wrote ${opts.out}/${w.file}`);
+  const verb = dryRun ? "would write" : "wrote";
+  for (const w of written) console.log(`${verb} ${opts.out}/${w.file}`);
   for (const version of skipped) console.log(`skipped ${version} (already installed)`);
   if (!written.length) console.log("Nothing to install \u2014 all nightowls migrations already present.");
+  else if (dryRun) console.log(`Dry run \u2014 ${written.length} migration(s) would be written to ${opts.out}/. Re-run without --dry-run to apply.`);
 });
 program.command("plugins").description("List installed Night Owls plugins and the commands they expose.").action(async () => {
   const cwd = process.cwd();
@@ -406,7 +410,7 @@ program.command("plugins").description("List installed Night Owls plugins and th
   runPluginsList(plugins, console.log);
 });
 program.command("mcp").description("Run the Night Owls MCP server on stdio (exposes nightowls_* tools to external agents).").action(async () => {
-  const { runMcpServer } = await import("./mcp-3ZFDXVDT.js");
+  const { runMcpServer } = await import("./mcp-AX7MPTKC.js");
   await runMcpServer();
 });
 async function main() {

package/dist/{mcp-3ZFDXVDT.js → mcp-AX7MPTKC.js}

@@ -30,7 +30,7 @@ async function runMcpServer() {
   const server = buildMcpServer();
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("[nightowls] mcp server ready on stdio (nightowls_doctor)");
+  console.error("[@nightowlsdev/cli] mcp server ready on stdio (nightowls_doctor)");
 }
 export {
   buildMcpServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nightowlsdev/cli",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "license": "MIT",
   "bin": {
@@ -36,21 +36,22 @@
     "tsup": "8.5.1",
     "typescript": "6.0.3",
     "vitest": "^3.2.0",
-    "@nightowlsdev/storage-supabase": "0.3.0",
-    "@nightowlsdev/core": "0.3.0",
-    "@nightowlsdev/telemetry-otel": "0.1.1",
-    "@nightowlsdev/telemetry-langfuse": "0.1.1",
-    "@nightowlsdev/runner-nextjs": "0.2.0",
-    "@nightowlsdev/runner-background": "0.2.0",
+    "@nightowlsdev/core": "0.5.0",
+    "@nightowlsdev/auth-supabase": "2.0.0",
+    "@nightowlsdev/storage-supabase": "2.0.0",
+    "@nightowlsdev/auth-auth0": "2.0.0",
+    "@nightowlsdev/telemetry-otel": "2.0.0",
+    "@nightowlsdev/runner-background": "2.0.0",
+    "@nightowlsdev/runner-nextjs": "2.0.0",
+    "@nightowlsdev/mcp": "2.0.0",
+    "@nightowlsdev/telemetry-langfuse": "2.0.0",
     "@nightowlsdev/model-anthropic": "0.1.0",
-    "@nightowlsdev/auth-supabase": "0.1.1",
-    "@nightowlsdev/auth-auth0": "0.1.1",
-    "@nightowlsdev/eslint-config": "0.0.0",
-    "@nightowlsdev/mcp": "0.1.1",
-    "@nightowlsdev/tsconfig": "0.0.0",
-    "@nightowlsdev/model-openai": "0.1.0",
+    "@nightowlsdev/model-openai": "0.2.0",
+    "@nightowlsdev/model-openrouter": "0.2.0",
     "@nightowlsdev/model-vercel-gateway": "0.1.0",
-    "@nightowlsdev/model-openrouter": "0.1.0"
+    "@nightowlsdev/tsconfig": "0.0.0",
+    "@nightowlsdev/eslint-config": "0.0.0",
+    "@nightowlsdev/model-ollama": "0.1.0"
   },
   "scripts": {
     "build": "tsup",