@donkeylabs/cli 2.0.18 → 2.0.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donkeylabs/cli",
-  "version": "2.0.18",
+  "version": "2.0.20",
   "type": "module",
   "description": "CLI for @donkeylabs/server - project scaffolding and code generation",
   "main": "./src/index.ts",

package/src/commands/docs.ts

@@ -23,35 +23,30 @@ interface DocsCommandOptions {
 }
 
 /**
- * Find the docs directory from installed @donkeylabs/server
+ * Find the server package directory from installed @donkeylabs/server
  */
-function findDocsPath(): string | null {
-  // Try common locations
+function findServerPkgDir(): string | null {
   const possiblePaths = [
-    // node_modules (standard install)
-    join(process.cwd(), "node_modules", "@donkeylabs", "server", "docs"),
-    // bun's .bun cache
-    join(process.cwd(), "node_modules", ".bun", "@donkeylabs", "server", "docs"),
-    // Workspace/monorepo
-    join(process.cwd(), "..", "server", "docs"),
-    join(process.cwd(), "..", "..", "packages", "server", "docs"),
+    join(process.cwd(), "node_modules", "@donkeylabs", "server"),
+    join(process.cwd(), "node_modules", ".bun", "@donkeylabs", "server"),
+    join(process.cwd(), "..", "server"),
+    join(process.cwd(), "..", "..", "packages", "server"),
   ];
 
   for (const path of possiblePaths) {
-    if (existsSync(path) && statSync(path).isDirectory()) {
+    const docsDir = join(path, "docs");
+    if (existsSync(docsDir) && statSync(docsDir).isDirectory()) {
       return path;
     }
   }
 
-  // Try to resolve from require
   try {
     const serverPkgPath = require.resolve("@donkeylabs/server/package.json", {
       paths: [process.cwd()],
     });
     const serverDir = dirname(serverPkgPath);
-    const docsPath = join(serverDir, "docs");
-    if (existsSync(docsPath)) {
-      return docsPath;
+    if (existsSync(join(serverDir, "docs"))) {
+      return serverDir;
     }
   } catch {
     // Package not found
@@ -60,6 +55,30 @@ function findDocsPath(): string | null {
   return null;
 }
 
+/**
+ * Find the docs directory from installed @donkeylabs/server
+ */
+function findDocsPath(): string | null {
+  const serverDir = findServerPkgDir();
+  if (!serverDir) return null;
+  return join(serverDir, "docs");
+}
+
+/**
+ * Sync agents.md from the server package root to the project root
+ */
+function syncAgentsMd(): void {
+  const serverDir = findServerPkgDir();
+  if (!serverDir) return;
+
+  const agentsMdSrc = join(serverDir, "agents.md");
+  if (!existsSync(agentsMdSrc)) return;
+
+  const content = readFileSync(agentsMdSrc, "utf-8");
+  writeFileSync(join(process.cwd(), "agents.md"), content);
+  console.log(pc.green("✓ Synced agents.md"));
+}
+
 /**
  * Get list of available doc files
  */
@@ -201,6 +220,7 @@ export async function docsCommand(args: string[], options: DocsCommandOptions =
   console.log(pc.dim(`Target: ${outputDir}/\n`));
 
   const synced = syncAllDocs(docsPath, outputDir);
+  syncAgentsMd();
 
   console.log(pc.green(`\n✓ Synced ${synced} documentation files to ${outputDir}/`));
   console.log(pc.dim(`\nTip: Add ${outputDir}/ to your .gitignore if you don't want to commit docs.`));

package/src/commands/init-enhanced.ts

@@ -374,6 +374,7 @@ function createPackageJson(projectDir: string, options: InitOptions) {
       "prepare": "bun --bun svelte-kit sync && bun run gen:types || echo ''",
       "check": "bun --bun svelte-kit sync && bun --bun svelte-check --tsconfig ./tsconfig.json",
       "gen:types": "donkeylabs generate",
+      "update": "donkeylabs update",
       "cli": "donkeylabs",
       "test": "bun test",
       ...(options.deployment === "docker" && {
@@ -386,6 +387,7 @@ function createPackageJson(projectDir: string, options: InitOptions) {
       "build": "bun build src/server/index.ts --outdir=dist",
       "start": "bun run dist/index.js",
       "gen:types": "bunx donkeylabs generate",
+      "update": "bunx donkeylabs update",
       "test": "bun test",
       "lint": "bun --bun tsc --noEmit",
       ...(options.deployment === "docker" && {

package/src/commands/init.ts

@@ -167,7 +167,7 @@ export async function initCommand(args: string[]) {
   } else {
     console.log(pc.green("\n✓ Dependencies installed\n"));
 
-    // Copy CLAUDE.md and docs/ from @donkeylabs/server to project root
+    // Copy agents.md and docs/ from @donkeylabs/server to project root
     await copyDocsFromServer(targetDir);
   }
 
@@ -324,7 +324,7 @@ async function copyDirectory(src: string, dest: string): Promise<void> {
 }
 
 /**
- * Copy CLAUDE.md and docs/ from @donkeylabs/server to project root
+ * Copy agents.md and docs/ from @donkeylabs/server to project root
  * for AI-assisted development
  */
 async function copyDocsFromServer(targetDir: string): Promise<void> {
@@ -334,19 +334,19 @@ async function copyDocsFromServer(targetDir: string): Promise<void> {
     return; // Server package not installed
   }
 
-  // Copy CLAUDE.md
-  const claudeMdSrc = join(serverPkgPath, "CLAUDE.md");
-  if (existsSync(claudeMdSrc)) {
-    const claudeMdDest = join(targetDir, "CLAUDE.md");
-    await copyFile(claudeMdSrc, claudeMdDest);
-    console.log(pc.green("  Created:"), "CLAUDE.md (AI instructions)");
+  // Copy agents.md
+  const agentsMdSrc = join(serverPkgPath, "agents.md");
+  if (existsSync(agentsMdSrc)) {
+    const agentsMdDest = join(targetDir, "agents.md");
+    await copyFile(agentsMdSrc, agentsMdDest);
+    console.log(pc.green("  Created:"), "agents.md (AI instructions)");
   }
 
   // Copy docs/ directory
   const docsSrc = join(serverPkgPath, "docs");
   if (existsSync(docsSrc)) {
-    const docsDest = join(targetDir, "docs");
+    const docsDest = join(targetDir, "docs", "donkeylabs");
     await copyDirectory(docsSrc, docsDest);
-    console.log(pc.green("  Created:"), "docs/ (detailed documentation)");
+    console.log(pc.green("  Created:"), "docs/donkeylabs/ (detailed documentation)");
   }
 }

package/templates/starter/donkeylabs.config.ts

@@ -0,0 +1 @@
+export default {};

package/templates/starter/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "donkeylabs-starter",
+  "type": "module",
+  "dependencies": {
+    "@donkeylabs/server": "workspace:*"
+  }
+}

package/templates/starter/src/index.ts

@@ -0,0 +1,9 @@
+import { AppServer } from "@donkeylabs/server";
+
+const server = new AppServer({
+  db: undefined as any,
+});
+
+server.start().catch((err) => {
+  console.error("Failed to start server", err);
+});

package/templates/starter/src/routes/health/handlers/ping.ts

@@ -0,0 +1,35 @@
+import type { ServerContext } from "@donkeylabs/server";
+
+type AppContext = ServerContext;
+
+interface Handler<TInput = any, TOutput = any> {
+  handle(input: TInput): TOutput | Promise<TOutput>;
+}
+
+type PingInput = {
+  name: string;
+  cool: number;
+  echo?: string;
+};
+
+type PingOutput = {
+  status: "ok";
+  timestamp: string;
+  echo?: string;
+};
+
+export class PingHandler implements Handler {
+  ctx: AppContext;
+
+  constructor(ctx: AppContext) {
+    this.ctx = ctx;
+  }
+
+  async handle(input: PingInput): Promise<PingOutput> {
+    return {
+      status: "ok",
+      timestamp: new Date().toISOString(),
+      echo: input.echo,
+    };
+  }
+}

package/templates/sveltekit-app/src/server/routes/counter/handlers/decrement.ts

@@ -0,0 +1,19 @@
+import type { ServerContext } from "@donkeylabs/server";
+
+type AppContext = ServerContext;
+
+interface Handler<TInput = any, TOutput = any> {
+  handle(input: TInput): TOutput | Promise<TOutput>;
+}
+
+export class CounterDecrementHandler implements Handler {
+  ctx: AppContext;
+
+  constructor(ctx: AppContext) {
+    this.ctx = ctx;
+  }
+
+  async handle(): Promise<{ count: number }> {
+    return { count: -1 };
+  }
+}

package/templates/sveltekit-app/src/server/routes/counter/handlers/get.ts

@@ -0,0 +1,19 @@
+import type { ServerContext } from "@donkeylabs/server";
+
+type AppContext = ServerContext;
+
+interface Handler<TInput = any, TOutput = any> {
+  handle(input: TInput): TOutput | Promise<TOutput>;
+}
+
+export class CounterGetHandler implements Handler {
+  ctx: AppContext;
+
+  constructor(ctx: AppContext) {
+    this.ctx = ctx;
+  }
+
+  async handle(): Promise<{ count: number }> {
+    return { count: 0 };
+  }
+}

package/templates/sveltekit-app/src/server/routes/counter/handlers/increment.ts

@@ -0,0 +1,19 @@
+import type { ServerContext } from "@donkeylabs/server";
+
+type AppContext = ServerContext;
+
+interface Handler<TInput = any, TOutput = any> {
+  handle(input: TInput): TOutput | Promise<TOutput>;
+}
+
+export class CounterIncrementHandler implements Handler {
+  ctx: AppContext;
+
+  constructor(ctx: AppContext) {
+    this.ctx = ctx;
+  }
+
+  async handle(): Promise<{ count: number }> {
+    return { count: 1 };
+  }
+}

package/templates/sveltekit-app/src/server/routes/counter/index.ts

@@ -0,0 +1,11 @@
+import { createRouter } from "@donkeylabs/server";
+import { CounterGetHandler } from "./handlers/get";
+import { CounterIncrementHandler } from "./handlers/increment";
+import { CounterDecrementHandler } from "./handlers/decrement";
+
+export const counterRouter = createRouter("counter")
+  .route("counter.get").typed({ handle: CounterGetHandler })
+  .route("counter.increment").typed({ handle: CounterIncrementHandler })
+  .route("counter.decrement").typed({ handle: CounterDecrementHandler });
+
+export default counterRouter;