@lark-sh/cli 0.1.0 → 0.1.1

package/dist/index.js

@@ -265,9 +265,12 @@ ${authUrl}
 
 // src/commands/auth.ts
 function registerAuthCommands(program2) {
-  program2.command("login").description(
-    "Log in to Lark via your browser.\n\nOpens the Lark dashboard where you authorize the CLI.\nYour session is saved to ~/.lark/config.json.\n\nExample:\n  $ lark login"
-  ).action(async () => {
+  program2.command("login").description("Log in to Lark via your browser").addHelpText("after", `
+Opens the Lark dashboard where you authorize the CLI.
+Your session is saved to ~/.lark/config.json.
+
+Example:
+  $ lark login`).action(async () => {
     try {
       const { name, email } = await login();
       console.log(`Logged in as ${name} (${email})`);
@@ -275,9 +278,9 @@ function registerAuthCommands(program2) {
       handleError(err, false);
     }
   });
-  program2.command("logout").description(
-    "Log out and clear the stored session.\n\nExample:\n  $ lark logout"
-  ).action(async () => {
+  program2.command("logout").description("Log out and clear the stored session").addHelpText("after", `
+Example:
+  $ lark logout`).action(async () => {
     const json = program2.opts().json;
     try {
       const session = getSession();
@@ -297,9 +300,10 @@ function registerAuthCommands(program2) {
       handleError(err, json);
     }
   });
-  program2.command("whoami").description(
-    "Show the currently logged-in user.\n\nExamples:\n  $ lark whoami\n  $ lark whoami --json"
-  ).action(async () => {
+  program2.command("whoami").description("Show the currently logged-in user").addHelpText("after", `
+Examples:
+  $ lark whoami
+  $ lark whoami --json`).action(async () => {
     const json = program2.opts().json;
     try {
       const user = await admin.getMe();
@@ -316,12 +320,14 @@ function registerAuthCommands(program2) {
 
 // src/commands/config.ts
 function registerConfigCommands(program2) {
-  const config = program2.command("config").description(
-    "Manage CLI configuration.\n\nSettings are stored in ~/.lark/config.json."
-  );
-  config.command("set-project <id>").description(
-    "Set the default project for all commands.\n\nOnce set, you can omit --project from other commands.\nThe project ID is verified before saving.\n\nExamples:\n  $ lark config set-project my-app\n  $ lark config set-project cli-test"
-  ).action(async (id) => {
+  const config = program2.command("config").description("Manage CLI configuration");
+  config.command("set-project <id>").description("Set the default project for all commands").addHelpText("after", `
+Once set, you can omit --project from other commands.
+The project ID is verified before saving.
+
+Examples:
+  $ lark config set-project my-app
+  $ lark config set-project cli-test`).action(async (id) => {
     const json = program2.opts().json;
     try {
       const project = await admin.getProject(id);
@@ -335,9 +341,9 @@ function registerConfigCommands(program2) {
       handleError(err, json);
     }
   });
-  config.command("show").description(
-    "Show current CLI configuration.\n\nExample:\n  $ lark config show"
-  ).action(() => {
+  config.command("show").description("Show current configuration").addHelpText("after", `
+Example:
+  $ lark config show`).action(() => {
     const json = program2.opts().json;
     const defaultProject = getDefaultProject();
     if (json) {
@@ -400,12 +406,18 @@ function formatTime(ts) {
 
 // src/commands/projects.ts
 function registerProjectCommands(program2) {
-  const projects = program2.command("projects").description(
-    'Manage Lark projects.\n\nA project is the top-level container for databases, rules, and settings.\nEach project gets a unique ID (DNS-compatible slug) and a secret key.\n\nExamples:\n  $ lark projects list\n  $ lark projects create "My App"\n  $ lark projects show my-app'
-  );
-  projects.command("list").description(
-    "List all your projects.\n\nExamples:\n  $ lark projects list\n  $ lark projects list --json"
-  ).action(async () => {
+  const projects = program2.command("projects").description("Manage Lark projects").addHelpText("after", `
+A project is the top-level container for databases, rules, and settings.
+Each project gets a unique ID (DNS-compatible slug) and a secret key.
+
+Examples:
+  $ lark projects list
+  $ lark projects create "My App"
+  $ lark projects show my-app`);
+  projects.command("list").description("List all your projects").addHelpText("after", `
+Examples:
+  $ lark projects list
+  $ lark projects list --json`).action(async () => {
     const json = program2.opts().json;
     try {
       const { projects: list } = await admin.getProjects();
@@ -425,9 +437,13 @@ function registerProjectCommands(program2) {
       handleError(err, json);
     }
   });
-  projects.command("create <name>").description(
-    'Create a new project.\n\nThe name is used to generate a DNS-compatible project ID.\nFor example, "My App" becomes "my-app".\n\nExamples:\n  $ lark projects create "My App"\n  $ lark projects create "Game Server" --json'
-  ).action(async (name) => {
+  projects.command("create <name>").description("Create a new project").addHelpText("after", `
+The name is used to generate a DNS-compatible project ID.
+For example, "My App" becomes "my-app".
+
+Examples:
+  $ lark projects create "My App"
+  $ lark projects create "Game Server" --json`).action(async (name) => {
     const json = program2.opts().json;
     try {
       const project = await admin.createProject(name);
@@ -440,9 +456,14 @@ function registerProjectCommands(program2) {
       handleError(err, json);
     }
   });
-  projects.command("show [id]").description(
-    "Show project details including secret key and settings.\n\nUses the default project if no ID is given.\n\nExamples:\n  $ lark projects show\n  $ lark projects show my-app\n  $ lark projects show --json"
-  ).action(async (id) => {
+  projects.command("show [id]").description("Show project details").addHelpText("after", `
+Shows the project's settings, secret key, and database counts.
+Uses the default project if no ID is given.
+
+Examples:
+  $ lark projects show
+  $ lark projects show my-app
+  $ lark projects show --json`).action(async (id) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(id || program2.opts().project);
@@ -466,9 +487,14 @@ function registerProjectCommands(program2) {
       handleError(err, json);
     }
   });
-  projects.command("update [id]").description(
-    'Update project settings.\n\nPass one or more flags to change settings.\nUses the default project if no ID is given.\n\nExamples:\n  $ lark projects update --name "New Name"\n  $ lark projects update my-app --ephemeral false\n  $ lark projects update --auto-create true --ephemeral true'
-  ).option("--name <name>", "Project name").option("--ephemeral <bool>", "Enable/disable ephemeral mode (true/false)").option("--auto-create <bool>", "Enable/disable auto-create databases (true/false)").option("--firebase-compat <bool>", "Enable/disable Firebase compatibility (true/false)").option("--firebase-project-id <id>", "Firebase project ID").action(async (id, opts) => {
+  projects.command("update [id]").description("Update project settings").option("--name <name>", "Project name").option("--ephemeral <bool>", "Enable/disable ephemeral mode (true/false)").option("--auto-create <bool>", "Enable/disable auto-create databases (true/false)").option("--firebase-compat <bool>", "Enable/disable Firebase compatibility (true/false)").option("--firebase-project-id <id>", "Firebase project ID").addHelpText("after", `
+Pass one or more flags to change settings.
+Uses the default project if no ID is given.
+
+Examples:
+  $ lark projects update --name "New Name"
+  $ lark projects update my-app --ephemeral false
+  $ lark projects update --auto-create true --ephemeral true`).action(async (id, opts) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(id || program2.opts().project);
@@ -496,9 +522,12 @@ function registerProjectCommands(program2) {
       handleError(err, json);
     }
   });
-  projects.command("delete [id]").description(
-    "Delete a project and all its databases.\n\nThis is irreversible. You must pass --confirm with the project ID.\n\nExamples:\n  $ lark projects delete my-app --confirm my-app\n  $ lark projects delete --confirm cli-test"
-  ).option("--confirm <id>", "Confirm deletion by passing the project ID").action(async (id, opts) => {
+  projects.command("delete [id]").description("Delete a project and all its databases").option("--confirm <id>", "Confirm deletion by passing the project ID").addHelpText("after", `
+This is irreversible. You must pass --confirm with the project ID.
+
+Examples:
+  $ lark projects delete my-app --confirm my-app
+  $ lark projects delete --confirm cli-test`).action(async (id, opts) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(id || program2.opts().project);
@@ -520,9 +549,13 @@ function registerProjectCommands(program2) {
       handleError(err, json);
     }
   });
-  projects.command("regenerate-secret [id]").description(
-    "Regenerate the project secret key.\n\nThe old key is immediately invalidated. Any clients using it\nwill need to be updated.\n\nExamples:\n  $ lark projects regenerate-secret\n  $ lark projects regenerate-secret my-app"
-  ).action(async (id) => {
+  projects.command("regenerate-secret [id]").description("Regenerate the project secret key").addHelpText("after", `
+The old key is immediately invalidated. Any clients using it
+will need to be updated.
+
+Examples:
+  $ lark projects regenerate-secret
+  $ lark projects regenerate-secret my-app`).action(async (id) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(id || program2.opts().project);
@@ -540,12 +573,22 @@ function registerProjectCommands(program2) {
 
 // src/commands/databases.ts
 function registerDatabaseCommands(program2) {
-  const databases = program2.command("databases").alias("db").description(
-    'Manage databases within a project.\n\nDatabases hold your real-time data. Use "lark data" commands\nto read and write data within a database.\n\nShorthand: "lark db" works the same as "lark databases".\n\nExamples:\n  $ lark databases list\n  $ lark db create my-database\n  $ lark db list --search "user"'
-  );
-  databases.command("list").description(
-    'List databases in the current project.\n\nExamples:\n  $ lark databases list\n  $ lark databases list --search "chat"\n  $ lark databases list --limit 10 --offset 20\n  $ lark --project my-app databases list'
-  ).option("--search <query>", "Filter databases by ID").option("--limit <n>", "Max results to return", "50").option("--offset <n>", "Number of results to skip", "0").action(async (opts) => {
+  const databases = program2.command("databases").alias("db").description("Manage databases within a project").addHelpText("after", `
+Databases hold your real-time data. Use "lark data" commands
+to read and write data within a database.
+
+Shorthand: "lark db" works the same as "lark databases".
+
+Examples:
+  $ lark databases list
+  $ lark db create my-database
+  $ lark db list --search "user"`);
+  databases.command("list").description("List databases in the current project").option("--search <query>", "Filter databases by ID").option("--limit <n>", "Max results to return", "50").option("--offset <n>", "Number of results to skip", "0").addHelpText("after", `
+Examples:
+  $ lark databases list
+  $ lark databases list --search "chat"
+  $ lark databases list --limit 10 --offset 20
+  $ lark --project my-app databases list`).action(async (opts) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -575,9 +618,13 @@ function registerDatabaseCommands(program2) {
       handleError(err, json);
     }
   });
-  databases.command("create <id>").description(
-    "Create a new database.\n\nThe ID must be a valid identifier (lowercase, hyphens allowed).\n\nExamples:\n  $ lark databases create users\n  $ lark databases create game-state\n  $ lark db create chat-rooms --json"
-  ).action(async (id) => {
+  databases.command("create <id>").description("Create a new database").addHelpText("after", `
+The ID must be a valid identifier (lowercase, hyphens allowed).
+
+Examples:
+  $ lark databases create users
+  $ lark databases create game-state
+  $ lark db create chat-rooms --json`).action(async (id) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -591,9 +638,12 @@ function registerDatabaseCommands(program2) {
       handleError(err, json);
     }
   });
-  databases.command("delete <id>").description(
-    "Delete a database and all its data.\n\nThis is irreversible.\n\nExamples:\n  $ lark databases delete old-data\n  $ lark db delete test-db"
-  ).action(async (id) => {
+  databases.command("delete <id>").description("Delete a database and all its data").addHelpText("after", `
+This is irreversible.
+
+Examples:
+  $ lark databases delete old-data
+  $ lark db delete test-db`).action(async (id) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -651,20 +701,26 @@ async function dataRequest(projectId, method, database, path2, body) {
 
 // src/commands/data.ts
 function registerDataCommands(program2) {
-  const data = program2.command("data").description(
-    `Read and write data in your databases.
-
+  const data = program2.command("data").description("Read and write data in your databases").addHelpText("after", `
 Data is organized as a JSON tree. Use paths like "/" for the
 root, "/users/alice" for nested data, etc.
 
 Examples:
   $ lark data get mydb /
   $ lark data set mydb /users/alice '{"name": "Alice"}'
-  $ lark data watch mydb /messages`
-  );
-  data.command("get <database> <path>").description(
-    'Get data at a path.\n\nReturns the JSON value at the given path. Use "/" to get\nthe entire database.\n\nArguments:\n  database  Database ID (e.g. "users")\n  path      Path in the database (e.g. "/", "/users/alice")\n\nExamples:\n  $ lark data get mydb /\n  $ lark data get mydb /users/alice\n  $ lark data get mydb /settings/theme --json'
-  ).action(async (database, path2) => {
+  $ lark data watch mydb /messages`);
+  data.command("get <database> <path>").description("Get data at a path").addHelpText("after", `
+Returns the JSON value at the given path. Use "/" to get
+the entire database.
+
+Arguments:
+  database  Database ID (e.g. "users")
+  path      Path in the database (e.g. "/", "/users/alice")
+
+Examples:
+  $ lark data get mydb /
+  $ lark data get mydb /users/alice
+  $ lark data get mydb /settings/theme --json`).action(async (database, path2) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -674,9 +730,7 @@ Examples:
       handleError(err, json);
     }
   });
-  data.command("set <database> <path> <value>").description(
-    `Set (overwrite) data at a path.
-
+  data.command("set <database> <path> <value>").description("Set (overwrite) data at a path").addHelpText("after", `
 Replaces whatever exists at the path with the given JSON value.
 Use "-" as the value to read JSON from stdin.
 
@@ -688,8 +742,7 @@ Arguments:
 Examples:
   $ lark data set mydb / '{"key": "value"}'
   $ lark data set mydb /users/alice '{"name": "Alice", "score": 100}'
-  $ cat data.json | lark data set mydb /path -`
-  ).action(async (database, path2, value) => {
+  $ cat data.json | lark data set mydb /path -`).action(async (database, path2, value) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -705,9 +758,7 @@ Examples:
       handleError(err, json);
     }
   });
-  data.command("update <database> <path> <value>").description(
-    `Update (merge) data at a path.
-
+  data.command("update <database> <path> <value>").description("Update (merge) data at a path").addHelpText("after", `
 Merges the given JSON into the existing data. Only the specified
 keys are changed; other keys are preserved. Use "-" to read
 from stdin.
@@ -720,8 +771,7 @@ Arguments:
 Examples:
   $ lark data update mydb /users/alice '{"score": 150}'
   $ lark data update mydb /config '{"theme": "dark"}'
-  $ echo '{"online": true}' | lark data update mydb /users/alice -`
-  ).action(async (database, path2, value) => {
+  $ echo '{"online": true}' | lark data update mydb /users/alice -`).action(async (database, path2, value) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -737,9 +787,7 @@ Examples:
       handleError(err, json);
     }
   });
-  data.command("push <database> <path> <value>").description(
-    `Push data to a list, generating a unique key.
-
+  data.command("push <database> <path> <value>").description("Push data to a list with an auto-generated key").addHelpText("after", `
 Appends the value under an auto-generated key (like a list push).
 Returns the generated key name. Use "-" to read from stdin.
 
@@ -750,8 +798,7 @@ Arguments:
 
 Examples:
   $ lark data push chat /messages '{"from": "Alice", "text": "Hello"}'
-  $ echo '{"event": "login"}' | lark data push mydb /logs -`
-  ).action(async (database, path2, value) => {
+  $ echo '{"event": "login"}' | lark data push mydb /logs -`).action(async (database, path2, value) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -767,9 +814,16 @@ Examples:
       handleError(err, json);
     }
   });
-  data.command("delete <database> <path>").description(
-    'Delete data at a path.\n\nRemoves the value at the path. Parent nodes that become empty\nmay also be removed.\n\nArguments:\n  database  Database ID (e.g. "users")\n  path      Path to delete (e.g. "/users/alice")\n\nExamples:\n  $ lark data delete mydb /users/alice\n  $ lark data delete mydb /temp'
-  ).action(async (database, path2) => {
+  data.command("delete <database> <path>").description("Delete data at a path").addHelpText("after", `
+Removes the value at the given path.
+
+Arguments:
+  database  Database ID (e.g. "users")
+  path      Path to delete (e.g. "/users/alice")
+
+Examples:
+  $ lark data delete mydb /users/alice
+  $ lark data delete mydb /temp`).action(async (database, path2) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -783,9 +837,18 @@ Examples:
       handleError(err, json);
     }
   });
-  data.command("export <database> [path]").description(
-    'Export database data as JSON.\n\nPrints the data as formatted JSON. Use -o to write to a file\ninstead of stdout. Path defaults to "/" (entire database).\n\nArguments:\n  database  Database ID (e.g. "users")\n  path      Path to export (default: "/")\n\nExamples:\n  $ lark data export mydb\n  $ lark data export mydb /users -o users.json\n  $ lark data export mydb / -o backup.json'
-  ).option("-o, --output <file>", "Write to file instead of stdout").action(async (database, path2, opts) => {
+  data.command("export <database> [path]").description("Export database data as JSON").option("-o, --output <file>", "Write to file instead of stdout").addHelpText("after", `
+Prints the data as formatted JSON. Use -o to write to a file
+instead of stdout. Path defaults to "/" (entire database).
+
+Arguments:
+  database  Database ID (e.g. "users")
+  path      Path to export (default: "/")
+
+Examples:
+  $ lark data export mydb
+  $ lark data export mydb /users -o users.json
+  $ lark data export mydb / -o backup.json`).action(async (database, path2, opts) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -803,9 +866,17 @@ Examples:
       handleError(err, json);
     }
   });
-  data.command("import <database> [path]").description(
-    'Import data from a JSON file.\n\nOverwrites data at the given path with the contents of the file.\nPath defaults to "/" (entire database).\n\nArguments:\n  database  Database ID (e.g. "users")\n  path      Path to import into (default: "/")\n\nExamples:\n  $ lark data import mydb -f backup.json\n  $ lark data import mydb /users -f users.json'
-  ).requiredOption("-f, --file <file>", "JSON file to import").action(async (database, path2, opts) => {
+  data.command("import <database> [path]").description("Import data from a JSON file").requiredOption("-f, --file <file>", "JSON file to import").addHelpText("after", `
+Overwrites data at the given path with the contents of the file.
+Path defaults to "/" (entire database).
+
+Arguments:
+  database  Database ID (e.g. "users")
+  path      Path to import into (default: "/")
+
+Examples:
+  $ lark data import mydb -f backup.json
+  $ lark data import mydb /users -f users.json`).action(async (database, path2, opts) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -821,9 +892,20 @@ Examples:
       handleError(err, json);
     }
   });
-  data.command("watch <database> <path>").description(
-    'Watch for real-time changes via SSE streaming.\n\nStreams live updates as they happen. Each change is printed\nas a line with the event type and data. Press Ctrl+C to stop.\n\nWith --json, outputs one JSON object per line (NDJSON).\n\nArguments:\n  database  Database ID (e.g. "chat")\n  path      Path to watch (e.g. "/messages")\n\nExamples:\n  $ lark data watch mydb /\n  $ lark data watch chat /messages\n  $ lark data watch mydb /users --json'
-  ).action(async (database, path2) => {
+  data.command("watch <database> <path>").description("Watch for real-time changes (SSE stream)").addHelpText("after", `
+Streams live updates as they happen. Each change is printed
+as a line with the event type and data. Press Ctrl+C to stop.
+
+With --json, outputs one JSON object per line (NDJSON).
+
+Arguments:
+  database  Database ID (e.g. "chat")
+  path      Path to watch (e.g. "/messages")
+
+Examples:
+  $ lark data watch mydb /
+  $ lark data watch chat /messages
+  $ lark data watch mydb /users --json`).action(async (database, path2) => {
     const jsonMode = program2.opts().json;
     try {
       const projectId = resolveProject(program2.opts().project);
@@ -882,9 +964,17 @@ Examples:
 
 // src/commands/dashboard.ts
 function registerDashboardCommands(program2) {
-  program2.command("dashboard [id]").description(
-    "Show project dashboard with metrics and recent events.\n\nDisplays CCU, bandwidth, operations, and latency for the\ngiven time range (defaults to last 24 hours).\n\nUses the default project if no ID is given.\n\nExamples:\n  $ lark dashboard\n  $ lark dashboard my-app\n  $ lark dashboard --start 2026-02-01 --end 2026-02-15\n  $ lark dashboard --json"
-  ).option("--start <date>", 'Start date (ISO format, e.g. "2026-02-01")').option("--end <date>", 'End date (ISO format, e.g. "2026-02-15")').action(async (id, opts) => {
+  program2.command("dashboard [id]").description("Show project dashboard with metrics").option("--start <date>", 'Start date (ISO format, e.g. "2026-02-01")').option("--end <date>", 'End date (ISO format, e.g. "2026-02-15")').addHelpText("after", `
+Displays CCU, bandwidth, operations, and latency for the
+given time range (defaults to last 24 hours).
+
+Uses the default project if no ID is given.
+
+Examples:
+  $ lark dashboard
+  $ lark dashboard my-app
+  $ lark dashboard --start 2026-02-01 --end 2026-02-15
+  $ lark dashboard --json`).action(async (id, opts) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(id || program2.opts().project);
@@ -937,9 +1027,14 @@ function registerDashboardCommands(program2) {
       handleError(err, json);
     }
   });
-  program2.command("events [id]").description(
-    "Show project events (database connections, errors, etc.).\n\nUses the default project if no ID is given.\n\nExamples:\n  $ lark events\n  $ lark events my-app --limit 50\n  $ lark events --json"
-  ).option("--limit <n>", "Max results to return", "25").option("--offset <n>", "Number of results to skip", "0").action(async (id, opts) => {
+  program2.command("events [id]").description("Show project events").option("--limit <n>", "Max results to return", "25").option("--offset <n>", "Number of results to skip", "0").addHelpText("after", `
+Shows database events like connections, errors, etc.
+Uses the default project if no ID is given.
+
+Examples:
+  $ lark events
+  $ lark events my-app --limit 50
+  $ lark events --json`).action(async (id, opts) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(id || program2.opts().project);
@@ -968,9 +1063,14 @@ function registerDashboardCommands(program2) {
       handleError(err, json);
     }
   });
-  program2.command("billing [id]").description(
-    "Show project billing info for a given month.\n\nDefaults to the current billing period.\n\nExamples:\n  $ lark billing\n  $ lark billing my-app\n  $ lark billing --period 2026-01\n  $ lark billing --json"
-  ).option("--period <month>", 'Billing period in YYYY-MM format (e.g. "2026-01")').action(async (id, opts) => {
+  program2.command("billing [id]").description("Show project billing info").option("--period <month>", 'Billing period in YYYY-MM format (e.g. "2026-01")').addHelpText("after", `
+Defaults to the current billing period.
+
+Examples:
+  $ lark billing
+  $ lark billing my-app
+  $ lark billing --period 2026-01
+  $ lark billing --json`).action(async (id, opts) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(id || program2.opts().project);
@@ -994,12 +1094,22 @@ function registerDashboardCommands(program2) {
 // src/commands/rules.ts
 import fs3 from "fs";
 function registerRulesCommands(program2) {
-  const rules = program2.command("rules").description(
-    "Manage project security rules.\n\nRules control read/write access to your database paths.\nThey use JSON5 format and follow Firebase-style syntax.\n\nExamples:\n  $ lark rules get\n  $ lark rules set -f rules.json"
-  );
-  rules.command("get [id]").description(
-    "Get the current security rules.\n\nPrints the raw rules JSON. Use --json to get a structured\nresponse with both the raw string and parsed object.\n\nExamples:\n  $ lark rules get\n  $ lark rules get my-app\n  $ lark rules get --json\n  $ lark rules get > rules-backup.json"
-  ).action(async (id) => {
+  const rules = program2.command("rules").description("Manage project security rules").addHelpText("after", `
+Rules control read/write access to your database paths.
+They use JSON5 format and follow Firebase-style syntax.
+
+Examples:
+  $ lark rules get
+  $ lark rules set -f rules.json`);
+  rules.command("get [id]").description("Get the current security rules").addHelpText("after", `
+Prints the raw rules JSON. Use --json to get a structured
+response with both the raw string and parsed object.
+
+Examples:
+  $ lark rules get
+  $ lark rules get my-app
+  $ lark rules get --json
+  $ lark rules get > rules-backup.json`).action(async (id) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(id || program2.opts().project);
@@ -1017,9 +1127,7 @@ function registerRulesCommands(program2) {
       handleError(err, json);
     }
   });
-  rules.command("set [id]").description(
-    `Set security rules from a file or stdin.
-
+  rules.command("set [id]").description("Set security rules from a file or stdin").option("-f, --file <file>", "Rules file (JSON5 format)").addHelpText("after", `
 Accepts JSON5 format. Use -f to read from a file,
 or pipe rules via stdin.
 
@@ -1027,8 +1135,7 @@ Examples:
   $ lark rules set -f rules.json
   $ lark rules set my-app -f rules.json5
   $ cat rules.json | lark rules set
-  $ echo '{"rules": {".read": true}}' | lark rules set`
-  ).option("-f, --file <file>", "Rules file (JSON5 format)").action(async (id, opts) => {
+  $ echo '{"rules": {".read": true}}' | lark rules set`).action(async (id, opts) => {
     const json = program2.opts().json;
     try {
       const projectId = resolveProject(id || program2.opts().project);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-sh/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI tool for Lark.sh — manage projects, databases, and data from the terminal",
   "type": "module",
   "license": "MIT",
@@ -10,7 +10,13 @@
     "directory": "cli"
   },
   "homepage": "https://lark.sh",
-  "keywords": ["lark", "larksh", "realtime", "database", "cli"],
+  "keywords": [
+    "lark",
+    "larksh",
+    "realtime",
+    "database",
+    "cli"
+  ],
   "bin": {
     "lark": "./dist/index.js"
   },