ai-native-lab 0.1.0 → 0.1.1

package/README.md

@@ -1,4 +1,4 @@
-# ai-native-lab · `aln`
+# ai-native-lab · `ailab`
 
 [AI Native Lab](https://ai-native-lab.mixdao.world) 的命令行工具，给人和 Agent 用：读、搜、发布内容，管理标签、图片、会员。
 
@@ -9,26 +9,26 @@
 ## 安装
 
 ```bash
-npm i -g ai-native-lab     # 命令名是 aln，需要 Node.js 20+
-aln login                  # 打开浏览器确认授权；自建服务：aln login https://your-host
-aln whoami
+npm i -g ai-native-lab     # 命令名是 ailab，需要 Node.js 20+
+ailab login                  # 打开浏览器确认授权；自建服务：ailab login https://your-host
+ailab whoami
 ```
 
 Agent / CI 里直接用 Token（在网站「我的账户 → API Token」生成）：
 
 ```bash
-ALN_TOKEN=aln_xxx ALN_API_URL=https://ai-native-lab.mixdao.world aln ls --json
+AILAB_TOKEN=aln_xxx AILAB_API_URL=https://ai-native-lab.mixdao.world ailab ls --json
 ```
 
 ## 阅读
 
 ```bash
-aln tags                           # 标签组和标签
-aln ls --tag agentic-coding        # 组内「或」、组间「且」
-aln search 公司大脑
-aln read <slug>                    # Markdown；HTML 内容输出抽出的文字，--html 输出源码
-aln bookmark <slug>
-aln redeem ALN-XXXX-XXXX-XXXX      # 兑换会员
+ailab tags                           # 标签组和标签
+ailab ls --tag agentic-coding        # 组内「或」、组间「且」
+ailab search 公司大脑
+ailab read <slug>                    # Markdown；HTML 内容输出抽出的文字，--html 输出源码
+ailab bookmark <slug>
+ailab redeem ALN-XXXX-XXXX-XXXX      # 兑换会员
 ```
 
 会员内容权限不够时只输出摘要，退出码 `4`。
@@ -51,40 +51,40 @@ cover: ./img/cover.jpg    # 本地图片会自动上传
 ```
 
 ```bash
-aln push post.md --dry-run
-aln push post.md --publish
-aln pull my-post -o post.md        # 改完再 push，--if-match <version> 防止覆盖别人的修改
+ailab push post.md --dry-run
+ailab push post.md --publish
+ailab pull my-post -o post.md        # 改完再 push，--if-match <version> 防止覆盖别人的修改
 ```
 
-HTML 页面（单个 `.html`、`.zip`，或一个目录：根目录 `index.html` + 相对路径的资源，元数据放 `aln.json`）：
+HTML 页面（单个 `.html`、`.zip`，或一个目录：根目录 `index.html` + 相对路径的资源，元数据放 `ailab.json`）：
 
 ```bash
-aln push ./site/ --slug my-report --title 报告 --access member --publish
-aln pull my-report -o ./site/      # 解压并写 aln.json，改完：aln push ./site/ --if-match <version>
+ailab push ./site/ --slug my-report --title 报告 --access member --publish
+ailab pull my-report -o ./site/      # 解压并写 ailab.json，改完：ailab push ./site/ --if-match <version>
 ```
 
 图片和标签：
 
 ```bash
-aln image upload a.png b.jpg       # 输出可直接粘贴的 Markdown
-aln tag create company-brain --name 公司大脑 --group topic
+ailab image upload a.png b.jpg       # 输出可直接粘贴的 Markdown
+ailab tag create company-brain --name 公司大脑 --group topic
 ```
 
 ## 管理（管理员）
 
 ```bash
-aln users --expiring 7
-aln member grant someone@example.com --days 365
-aln role someone@example.com editor
-aln code create --days 365 --count 10
-aln image purge --dry-run
-aln audit --action membership.
+ailab users --expiring 7
+ailab member grant someone@example.com --days 365
+ailab role someone@example.com editor
+ailab code create --days 365 --count 10
+ailab image purge --dry-run
+ailab audit --action membership.
 ```
 
 ## 给 Claude Code 用
 
 ```bash
-aln skill --install                # 写入 ~/.claude/skills/ai-native-lab/SKILL.md
+ailab skill --install                # 写入 ~/.claude/skills/ai-native-lab/SKILL.md
 ```
 
-完整命令：`aln --help`、`aln <命令> --help`。
+完整命令：`ailab --help`、`ailab <命令> --help`。

package/SKILL.md

@@ -1,54 +1,54 @@
 ---
 name: ai-native-lab
-description: Read, search and publish content on the AI Native Lab platform with the `aln` CLI. Use when the user asks to look up, quote, summarize, write, update or publish AI Native Lab content, manage its tags, or manage members / redeem codes.
+description: Read, search and publish content on the AI Native Lab platform with the `ailab` CLI. Use when the user asks to look up, quote, summarize, write, update or publish AI Native Lab content, manage its tags, or manage members / redeem codes.
 ---
 
-# AI Native Lab CLI (`aln`)
+# AI Native Lab CLI (`ailab`)
 
 Always pass `--json` and parse stdout (one JSON object). Errors are `{"error":{"code","message"}}` on stdout with a non-zero exit code.
 
-Exit codes: 0 ok · 1 error · 2 usage · 3 auth (run `aln login` or set `ALN_TOKEN`) · 4 forbidden / locked · 5 conflict (re-fetch, then retry).
+Exit codes: 0 ok · 1 error · 2 usage · 3 auth (run `ailab login` or set `AILAB_TOKEN`) · 4 forbidden / locked · 5 conflict (re-fetch, then retry).
 
 ## Auth
 
-- `aln whoami --json` → `role` is one of guest / user / member / editor / admin, plus `permissions` and `membership.expiresAt`.
-- Not logged in: ask the user to run `aln login <url>` (it opens a browser), or use `ALN_TOKEN=aln_… ALN_API_URL=https://…`.
+- `ailab whoami --json` → `role` is one of guest / user / member / editor / admin, plus `permissions` and `membership.expiresAt`.
+- Not logged in: ask the user to run `ailab login <url>` (it opens a browser), or use `AILAB_TOKEN=aln_… AILAB_API_URL=https://…`.
 
 ## Read
 
-1. `aln tags --json` to learn the tag slugs.
-2. `aln ls --tag <a,b> --json` (OR within a tag group, AND across groups), or `aln search <text> --json` (full text, best matches first; the body only counts for content the reader can open, so locked items match on title / summary only).
-3. `aln read <slug>` prints Markdown. `locked: true` (exit 4) means the reader's role can't open the full text; only the summary is available. Don't try to work around it.
+1. `ailab tags --json` to learn the tag slugs.
+2. `ailab ls --tag <a,b> --json` (OR within a tag group, AND across groups), or `ailab search <text> --json` (full text, best matches first; the body only counts for content the reader can open, so locked items match on title / summary only).
+3. `ailab read <slug>` prints Markdown. `locked: true` (exit 4) means the reader's role can't open the full text; only the summary is available. Don't try to work around it.
 
 ## Follow tags
 
-- `aln follow <tag>` subscribes the user to a weekly email digest (Mondays) of new content in that tag; `aln follow <tag> --remove` unsubscribes; `aln follow --json` lists current follows. Only do this when the user asks.
+- `ailab follow <tag>` subscribes the user to a weekly email digest (Mondays) of new content in that tag; `ailab follow <tag> --remove` unsubscribes; `ailab follow --json` lists current follows. Only do this when the user asks.
 
 ## Write (editor or admin)
 
-- Edit existing: `aln pull <slug> -o post.md` → edit the file → `aln push post.md --if-match <version from frontmatter>`.
+- Edit existing: `ailab pull <slug> -o post.md` → edit the file → `ailab push post.md --if-match <version from frontmatter>`.
 - New content: write Markdown with frontmatter (`slug`, `title`, `summary`, `access`, `tags`), then
-  `aln push post.md --dry-run --json` → `aln push post.md --json` (saves a draft) → `aln publish <slug>` when the user approves.
-- Unknown tags fail with `unknown_tag`; create them with `aln tag create <slug> --name <name> --group <key>`, or pass `--auto-tags <group>`.
+  `ailab push post.md --dry-run --json` → `ailab push post.md --json` (saves a draft) → `ailab publish <slug>` when the user approves.
+- Unknown tags fail with `unknown_tag`; create them with `ailab tag create <slug> --name <name> --group <key>`, or pass `--auto-tags <group>`.
 - `access`: `public` (everyone), `registered` (signed-in users), `member` (members only). Always write a useful `summary`: it's all that locked readers see.
-- Publishing is visible to everyone and logged; confirm with the user before `--publish` / `aln publish`.
+- Publishing is visible to everyone and logged; confirm with the user before `--publish` / `ailab publish`.
 
 ## Admin
 
-- `aln users --expiring 7 --json`, `aln member grant <email> --days 365`, `aln member revoke <email>`, `aln role <email> editor`.
-- `aln code create --days 365 --count 10` prints codes once; store them safely.
-- `aln audit --action membership. --json`.
+- `ailab users --expiring 7 --json`, `ailab member grant <email> --days 365`, `ailab member revoke <email>`, `ailab role <email> editor`.
+- `ailab code create --days 365 --count 10` prints codes once; store them safely.
+- `ailab audit --action membership. --json`.
 
 ## Images
 
-- Reference local images in Markdown with relative paths (`![说明](./img/chart.png)`, also `cover: ./img/cover.jpg`); `aln push` uploads them, compresses them to WebP (long edge ≤ 2000px) and rewrites the links. `--dry-run` does not upload.
-- Or upload first: `aln image upload a.png b.jpg --json` → paste the returned `url`.
-- `aln image ls --unused`; admins: `aln image purge --dry-run` then `aln image purge`, `aln image rm <id> [--force]`.
+- Reference local images in Markdown with relative paths (`![说明](./img/chart.png)`, also `cover: ./img/cover.jpg`); `ailab push` uploads them, compresses them to WebP (long edge ≤ 2000px) and rewrites the links. `--dry-run` does not upload.
+- Or upload first: `ailab image upload a.png b.jpg --json` → paste the returned `url`.
+- `ailab image ls --unused`; admins: `ailab image purge --dry-run` then `ailab image purge`, `ailab image rm <id> [--force]`.
 
 ## HTML pages
 
 - Content is either Markdown or an HTML page (`format` in `--json` output). HTML pages open full-page at `pageUrl` (`/p/<slug>/`) in a sandbox: scripts run, but `localStorage`, cookies and the platform API are unavailable to the page.
-- Publish a page: `aln push page.html`, `aln push site.zip`, or `aln push ./site/` (a folder with `index.html` at the top plus relative css / js / images). Metadata comes from flags (`--slug --title --summary --access --tags`) or `aln.json` in the folder (`{"slug","title","summary","access","status","tags","cover"}`). Title falls back to `<title>`.
-- Edit: `aln pull <slug> -o ./site/` (writes the files and `aln.json` with `version`) → edit → `aln push ./site/ --if-match <version>`.
-- `aln read <slug>` prints the page's extracted text; `aln read <slug> --html` prints the entry HTML.
+- Publish a page: `ailab push page.html`, `ailab push site.zip`, or `ailab push ./site/` (a folder with `index.html` at the top plus relative css / js / images). Metadata comes from flags (`--slug --title --summary --access --tags`) or `ailab.json` in the folder (`{"slug","title","summary","access","status","tags","cover"}`). Title falls back to `<title>`.
+- Edit: `ailab pull <slug> -o ./site/` (writes the files and `ailab.json` with `version`) → edit → `ailab push ./site/ --if-match <version>`.
+- `ailab read <slug>` prints the page's extracted text; `ailab read <slug> --html` prints the entry HTML.
 - Pushing Markdown to an HTML slug fails with `html_content` (exit 5) — that's intentional; don't convert formats unless the user asks.

package/dist/cli.js

@@ -30,7 +30,7 @@ var PAGE_LIMITS = { maxUploadBytes: 50 * 1024 * 1024, maxTotalBytes: 200 * 1024
 // package.json
 var package_default = {
   name: "ai-native-lab",
-  version: "0.1.0",
+  version: "0.1.1",
   description: "AI Native Lab CLI for people and agents: read, search and publish content. Non-interactive, --json output, stable exit codes.",
   keywords: [
     "ai-native-lab",
@@ -52,7 +52,7 @@ var package_default = {
   },
   type: "module",
   bin: {
-    aln: "dist/cli.js"
+    ailab: "dist/cli.js"
   },
   files: [
     "dist",
@@ -96,7 +96,7 @@ var CliError = class extends Error {
 var exitFor = (status, code2) => status === 401 || code2 === "pending_approval" || code2 === "banned" || code2 === "expired_token" || code2 === "access_denied" ? EXIT.auth : status === 403 ? EXIT.forbidden : status === 409 || status === 412 ? EXIT.conflict : status === 400 ? EXIT.usage : EXIT.error;
 function createClient(apiUrl, token) {
   async function call(method, p, body, headers = {}) {
-    const h = { "user-agent": `aln-cli/${package_default.version}`, ...headers };
+    const h = { "user-agent": `ailab-cli/${package_default.version}`, ...headers };
     if (token) h.authorization = `Bearer ${token}`;
     if (body !== void 0) h["content-type"] = "application/json";
     let res;
@@ -119,7 +119,7 @@ function createClient(apiUrl, token) {
     return json;
   }
   async function download(p) {
-    const h = { "user-agent": `aln-cli/${package_default.version}` };
+    const h = { "user-agent": `ailab-cli/${package_default.version}` };
     if (token) h.authorization = `Bearer ${token}`;
     let res;
     try {
@@ -135,7 +135,7 @@ function createClient(apiUrl, token) {
     return new Uint8Array(await res.arrayBuffer());
   }
   async function upload(p, form, method = "POST", extraHeaders = {}) {
-    const h = { "user-agent": `aln-cli/${package_default.version}`, ...extraHeaders };
+    const h = { "user-agent": `ailab-cli/${package_default.version}`, ...extraHeaders };
     if (token) h.authorization = `Bearer ${token}`;
     let res;
     try {
@@ -196,10 +196,10 @@ async function saveConfig(c) {
 var clearConfig = () => rm(FILE, { force: true });
 async function resolveAuth(flags) {
   const c = await loadConfig();
-  const explicit = flags.apiUrl ?? process.env.ALN_API_URL;
+  const explicit = flags.apiUrl ?? process.env.AILAB_API_URL;
   const apiUrl = normalizeUrl(explicit ?? c.url ?? DEFAULT_API_URL);
   const same = !explicit || c.url && normalizeUrl(c.url) === apiUrl;
-  return { apiUrl, token: flags.token ?? process.env.ALN_TOKEN ?? (same ? c.token : void 0) };
+  return { apiUrl, token: flags.token ?? process.env.AILAB_TOKEN ?? (same ? c.token : void 0) };
 }
 
 // src/images.ts
@@ -268,7 +268,7 @@ ${d.body.replace(/^\n+/, "")}`;
 import { mkdir as mkdir2, readdir, readFile as readFile3, stat, writeFile as writeFile2 } from "fs/promises";
 import path3 from "path";
 import { unzipSync, zipSync } from "fflate";
-var META_FILE = "aln.json";
+var META_FILE = "ailab.json";
 var IGNORE = /* @__PURE__ */ new Set([".git", "node_modules", ".DS_Store", "Thumbs.db", META_FILE]);
 async function zipDir(dir) {
   const files = {};
@@ -315,7 +315,7 @@ async function extractTo(dir, zip, meta) {
 }
 
 // src/cli.ts
-var program = new Command().name("aln").description("AI Native Lab: read, search and publish content from the terminal or an agent").version(package_default.version).addOption(new Option("--json", "print one JSON object to stdout (also ALN_JSON=1)").default(process.env.ALN_JSON === "1")).option("--api-url <url>", "server URL, overrides the saved one (env ALN_API_URL)").option("--token <token>", "API token, overrides the saved one (env ALN_TOKEN)").showHelpAfterError().addHelpText(
+var program = new Command().name("ailab").description("AI Native Lab: read, search and publish content from the terminal or an agent").version(package_default.version).addOption(new Option("--json", "print one JSON object to stdout (also AILAB_JSON=1)").default(process.env.AILAB_JSON === "1")).option("--api-url <url>", "server URL, overrides the saved one (env AILAB_API_URL)").option("--token <token>", "API token, overrides the saved one (env AILAB_TOKEN)").showHelpAfterError().addHelpText(
   "after",
   `
 Recommended workflow:
@@ -326,7 +326,7 @@ Recommended workflow:
   Write (editor)   pull <slug> -o post.md \u2192 edit \u2192 push post.md --publish
   New content      push post.md --slug <slug> --tags a,b [--auto-tags topic] --dry-run, then without --dry-run
   Images           ![\u8BF4\u660E](./img/a.png) in Markdown is uploaded by push automatically; or: image upload a.png
-  HTML pages       push page.html | push site.zip | push ./site/  (folder: index.html + assets, metadata in aln.json)
+  HTML pages       push page.html | push site.zip | push ./site/  (folder: index.html + assets, metadata in ailab.json)
                    pull <slug> -o ./site/ \u2192 edit \u2192 push ./site/ --if-match <version>
   Members (admin)  users --expiring 7 \u2192 member grant <email> --days 365
 
@@ -343,11 +343,11 @@ Markdown files carry metadata in YAML frontmatter:
 Exit codes: 0 ok \xB7 1 error \xB7 2 usage \xB7 3 auth \xB7 4 forbidden \xB7 5 conflict (version mismatch / exists)
 
 Examples:
-  $ aln login                                      # default server; or: aln login https://your-host
-  $ aln ls --tag agentic-coding --json
-  $ aln read company-brain > company-brain.md
-  $ cat note.md | aln push - --slug quick-note --publish
-  $ ALN_TOKEN=aln_xxx ALN_API_URL=https://lab.example.com aln ls --json`
+  $ ailab login                                      # default server; or: ailab login https://your-host
+  $ ailab ls --tag agentic-coding --json
+  $ ailab read company-brain > company-brain.md
+  $ cat note.md | ailab push - --slug quick-note --publish
+  $ AILAB_TOKEN=aln_xxx AILAB_API_URL=https://lab.example.com ailab ls --json`
 );
 var g = () => program.opts();
 function out(human, data) {
@@ -364,7 +364,7 @@ async function client() {
 }
 async function needToken() {
   const { apiUrl, token } = await resolveAuth(g());
-  if (!token) throw new CliError("unauthorized", "Not logged in. Run `aln login <url>` or set ALN_TOKEN", EXIT.auth);
+  if (!token) throw new CliError("unauthorized", "Not logged in. Run `ailab login <url>` or set AILAB_TOKEN", EXIT.auth);
   return createClient(apiUrl, token);
 }
 var readInput = async (file) => {
@@ -387,9 +387,9 @@ function openBrowser(url) {
 }
 program.command("login [url]").description("log in through the browser (device code); the token is saved to ~/.config/ai-native-lab").option("--no-browser", "don't open the browser, just print the link").action(async (url, opts) => {
   const saved = await loadConfig();
-  const apiUrl = normalizeUrl(url ?? g().apiUrl ?? process.env.ALN_API_URL ?? saved.url ?? DEFAULT_API_URL);
+  const apiUrl = normalizeUrl(url ?? g().apiUrl ?? process.env.AILAB_API_URL ?? saved.url ?? DEFAULT_API_URL);
   const c = createClient(apiUrl);
-  const start = await c.deviceStart(`aln on ${hostname()}`.slice(0, 80));
+  const start = await c.deviceStart(`ailab on ${hostname()}`.slice(0, 80));
   note(`Open ${start.verificationUrlComplete}
 and confirm the code ${start.userCode}. Waiting\u2026`);
   if (opts.browser) openBrowser(start.verificationUrlComplete);
@@ -417,7 +417,7 @@ program.command("whoami").description("who you are, your role and membership exp
   out(me.user ? `${me.user.email} \xB7 ${me.role}${m}
 permissions: ${me.permissions.join(", ")}` : "guest (not logged in)", me);
 });
-program.command("ls").description("list content (newest first)").option("--tag <slugs>", "comma separated tag slugs; OR within a tag group, AND across groups").option("--access <level>", "public | registered | member").option("--status <status>", "published (default) | draft | archived | all  (editors only for non-published)").option("-q, --query <text>", "full-text search (same as `aln search`)").option("--bookmarked", "only content you bookmarked").option("--limit <n>", "page size, max 100", "20").option("--offset <n>", "skip n items", "0").action(async (o) => {
+program.command("ls").description("list content (newest first)").option("--tag <slugs>", "comma separated tag slugs; OR within a tag group, AND across groups").option("--access <level>", "public | registered | member").option("--status <status>", "published (default) | draft | archived | all  (editors only for non-published)").option("-q, --query <text>", "full-text search (same as `ailab search`)").option("--bookmarked", "only content you bookmarked").option("--limit <n>", "page size, max 100", "20").option("--offset <n>", "skip n items", "0").action(async (o) => {
   const res = await (await client()).list({ tag: o.tag, access: o.access, status: o.status, q: o.query, bookmarked: o.bookmarked, limit: o.limit, offset: o.offset });
   const more = res.nextOffset != null ? `
 \u2026 more: --offset ${res.nextOffset}` : "";
@@ -461,7 +461,7 @@ program.command("follow [tag]").description("follow a tag (weekly email digest o
   if (!slug) {
     if (o.remove) throw new CliError("bad_request", "Pass the tag to unfollow", EXIT.usage);
     const res2 = await c.call("GET", "/me/follows");
-    return out(res2.follows.map((t) => `${pad(t.slug, 28)} ${t.name}${t.archived ? " (archived)" : ""}`).join("\n") || "Not following any tags. Try `aln tags`, then `aln follow <tag>`", res2);
+    return out(res2.follows.map((t) => `${pad(t.slug, 28)} ${t.name}${t.archived ? " (archived)" : ""}`).join("\n") || "Not following any tags. Try `ailab tags`, then `ailab follow <tag>`", res2);
   }
   const res = await c.call(o.remove ? "DELETE" : "PUT", `/tags/${encodeURIComponent(slug)}/follow`);
   out(o.remove ? `Unfollowed ${slug}` : `Following ${slug} \xB7 weekly digest every Monday`, res);
@@ -543,7 +543,7 @@ program.command("push <file>").description("create or update content from a Mark
   if (res.dryRun) return out(`dry run: would ${res.action} ${slug}`, res);
   out(`${res.created ? "Created" : "Updated"} ${slug} \xB7 ${res.content.status} \xB7 v${res.content.version}`, { ...res, images });
 });
-program.command("pull <slug>").description("download content to edit and push back: Markdown with frontmatter, or for HTML pages a folder (with aln.json) / .zip").option("-o, --out <file>", "write to a file instead of stdout; HTML pages: a folder, or a path ending in .zip").action(async (slug, o) => {
+program.command("pull <slug>").description("download content to edit and push back: Markdown with frontmatter, or for HTML pages a folder (with ailab.json) / .zip").option("-o, --out <file>", "write to a file instead of stdout; HTML pages: a folder, or a path ending in .zip").action(async (slug, o) => {
   const c = await needToken();
   const item = await c.get(slug);
   if (item.locked || item.body == null) throw new CliError("locked", "You can't read the full text of this content", EXIT.forbidden);
@@ -564,7 +564,7 @@ program.command("pull <slug>").description("download content to edit and push ba
       cover: item.cover,
       version: item.version
     });
-    return out(`Wrote ${n} files to ${o.out}/ (v${item.version}); edit, then: aln push ${o.out} --if-match ${item.version}`, { ok: true, dir: o.out, files: n, version: item.version });
+    return out(`Wrote ${n} files to ${o.out}/ (v${item.version}); edit, then: ailab push ${o.out} --if-match ${item.version}`, { ok: true, dir: o.out, files: n, version: item.version });
   }
   const md = formatDoc({ ...item, tags: item.tags.map((t) => t.slug), body: item.body });
   if (!o.out) return void process.stdout.write(md.endsWith("\n") ? md : `${md}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-native-lab",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "AI Native Lab CLI for people and agents: read, search and publish content. Non-interactive, --json output, stable exit codes.",
   "keywords": [
     "ai-native-lab",
@@ -22,7 +22,7 @@
   },
   "type": "module",
   "bin": {
-    "aln": "dist/cli.js"
+    "ailab": "dist/cli.js"
   },
   "files": [
     "dist",