@nightowlsdev/cli 0.1.1 → 0.1.2

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,7 +35,7 @@ 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(/^\//, "")}`;
@@ -53,7 +53,7 @@ async function runDbInstall(deps) {
       skipped.push(m.version);
       continue;
     }
-    const file = `${migrationStamp(base, i)}_corale_${m.version}.sql`;
+    const file = `${migrationStamp(base, i)}_nightowls_${m.version}.sql`;
     await deps.fs.writeFile(`${dir}/${file}`, `${m.sql.trimStart()}
 `);
     written.push({ version: m.version, file });
@@ -93,7 +93,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
 
@@ -406,7 +406,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.1.2",
   "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.4.0",
+    "@nightowlsdev/storage-supabase": "1.0.0",
+    "@nightowlsdev/auth-supabase": "1.0.0",
+    "@nightowlsdev/auth-auth0": "1.0.0",
+    "@nightowlsdev/telemetry-otel": "1.0.0",
+    "@nightowlsdev/telemetry-langfuse": "1.0.0",
+    "@nightowlsdev/runner-nextjs": "1.0.0",
+    "@nightowlsdev/runner-background": "1.0.0",
+    "@nightowlsdev/mcp": "1.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-vercel-gateway": "0.1.0",
-    "@nightowlsdev/model-openrouter": "0.1.0"
+    "@nightowlsdev/model-openrouter": "0.1.0",
+    "@nightowlsdev/tsconfig": "0.0.0",
+    "@nightowlsdev/model-ollama": "0.1.0",
+    "@nightowlsdev/eslint-config": "0.0.0"
   },
   "scripts": {
     "build": "tsup",