@openturtle/cli 0.3.3 → 0.3.4

package/README.md

@@ -53,7 +53,9 @@ ot projects list
 ot roster list
 ot context get --project <project-id>
 ot knowledge search "部署"
+ot knowledge local search "部署"
 ot meetings list --project <project-id>
+ot work summary --project <project-id>
 ot worklogs record --summary "完成联调" --type progress
 ot report draft --today
 ```
@@ -80,12 +82,19 @@ ot todos progress <todo-id> --message "完成接口联调，等待验收"
 ot worklogs record --summary "完成 Qoder CLI 接入验证" --type progress
 ```
 
-### 搜索知识
+### 聚合搜索知识
 
 ```bash
 ot knowledge search "日报"
 ```
 
+默认同时搜索云端知识和本地全文索引。只搜索本地：
+
+```bash
+ot knowledge search "日报" --local-only
+ot knowledge local search "日报"
+```
+
 ### 上传录音并处理会议
 
 ```bash
@@ -184,7 +193,6 @@ ot auth logout
 - CLI 项目状态只写 `.openturtle-cli/`
 - CLI 全局状态只写 `~/.openturtle/cli/`
 - 不要创建或写入项目 `.openturtle/`
-- 不要覆盖 Desktop 的 `openturtle-knowledge`
 - 不要覆盖 Desktop 的 `openturtle-automations`
 - 不要覆盖旧的 `openturtle-todo`
 
@@ -327,13 +335,13 @@ ot uninstall --target all
 
 ### 6. Target 安装矩阵
 
-| Target | 安装内容                          |
-| ------ | --------------------------------- |
-| Claude | Skill                             |
-| Codex  | Skill、`AGENTS.md` managed note   |
-| Cursor | Cursor Rule                       |
-| Qoder  | Skill                             |
-| Kiro   | Steering                          |
+| Target | 安装内容                        |
+| ------ | ------------------------------- |
+| Claude | Skill                           |
+| Codex  | Skill、`AGENTS.md` managed note |
+| Cursor | Cursor Rule                     |
+| Qoder  | Skill                           |
+| Kiro   | Steering                        |
 
 ### 7. CLI 接入模型
 
@@ -348,6 +356,9 @@ ot projects list --keyword "OpenTurtle"
 ot projects resolve "OpenTurtle"
 ot projects show <project-id> --members
 ot roster list
+ot roster list --project <project-id>
+ot work summary --project <project-id>
+ot digest get --project <project-id> --window this_week
 ot context get --project <project-id> --query "本周风险" --section risk
 ot context item meeting <meeting-id> --project <project-id>
 ```
@@ -381,6 +392,8 @@ ot todos review <todo-id> --body-file review-decision.json --dry-run
 ```bash
 ot knowledge list
 ot knowledge search "日报"
+ot knowledge search "日报" --cloud-only
+ot knowledge search "日报" --local-only
 ot knowledge show <knowledge-id>
 ot knowledge relations <knowledge-id>
 ot knowledge save --body-file knowledge.json --dry-run
@@ -397,9 +410,16 @@ ot knowledge attachment-download <knowledge-id> <attachment-id> --output ./desig
 ot knowledge sources --path docs
 ot knowledge sources --q "WPS"
 ot knowledge source docs/guide.md
+ot knowledge local list
+ot knowledge local search "部署规范"
+ot knowledge local read <asset-id>
+ot knowledge local import ./docs --dry-run
+ot knowledge local create --body-file local-note.json --dry-run
+ot knowledge local update <asset-id> --body-file local-note.json --dry-run
+ot knowledge local remove <asset-id> --dry-run
 ```
 
-知识对象是可复用的结论、规范、经验、决策沉淀和操作手册。来源文件是知识背后的原文、附件或仓库文档。
+`ot knowledge search` 返回 `{ query, cloud, local }` 聚合结果；`--cloud-only` 和 `--local-only` 可限定范围。知识对象是可复用的结论、规范、经验、决策沉淀和操作手册。来源文件是知识背后的原文、附件或仓库文档，本地知识索引可脱离 Desktop 使用。
 
 会议：
 
@@ -476,7 +496,6 @@ ot report draft --today
 ### 10. AI Agent 禁止事项
 
 - 不要写项目 `.openturtle/`
-- 不要覆盖 `openturtle-knowledge`
 - 不要覆盖 `openturtle-automations`
 - 不要覆盖旧 `openturtle-todo`
 - 不要删除用户已有 Agent 配置
@@ -536,6 +555,8 @@ npm pack --dry-run
 
 ### 13. npm 自动发布
 
+完整的校验、Trusted Publisher、人工兜底、npm 二次认证、远端 `master` 对齐和 Skill 刷新检查见 [RELEASE_RUNBOOK.md](./RELEASE_RUNBOOK.md)。
+
 `.github/workflows/cli-npm-release.yml` 会在 `master` 的 CLI 文件发生变化时运行测试和构建，
 然后以仓库版本为最低版本、基于 npm 已发布版本自动递增 patch，发布公开包 `@openturtle/cli`。
 

package/RELEASE_RUNBOOK.md

@@ -0,0 +1,193 @@
+# OpenTurtle CLI Release Runbook
+
+This runbook publishes `@openturtle/cli` to the public npm registry and verifies that the installed `ot` command and companion Agent guidance are usable outside the source repository.
+
+## Release Boundaries
+
+- Package: `@openturtle/cli`
+- Binary: `ot`
+- Registry: `https://registry.npmjs.org/`
+- Source: `packages/frontend/apps/cli`
+- Release branch: `master`
+- Workflow: `.github/workflows/cli-npm-release.yml`
+- Authentication: npm Trusted Publisher in CI; npm browser authentication for manual fallback
+
+The package is CLI + Skill/Rule/Steering only. It must not ship the removed OpenTurtle MCP server, Hook commands, Git Hook installer, or history watcher.
+
+## Prerequisites
+
+Run from the repository root unless a command says otherwise.
+
+```bash
+node --version
+pnpm --version
+npm --version
+git status --short
+npm view @openturtle/cli version --registry=https://registry.npmjs.org
+```
+
+Requirements:
+
+- Node.js satisfies `packages/frontend/apps/cli/package.json#engines`.
+- Dependencies are installed from the repository lockfile.
+- CLI changes are isolated from unrelated worktree changes.
+- The intended release commit is present on both GitLab and GitHub `master` before declaring source delivery complete.
+- npm Trusted Publisher points to `aka-danielZhang/openturtle-os` and `cli-npm-release.yml`.
+
+Never stage unrelated Desktop, backend, mobile, generated local state, or `.openturtle-cli/` files with a CLI release.
+
+## Required Validation
+
+```bash
+cd packages/frontend
+pnpm install --frozen-lockfile
+pnpm --filter @openturtle/cli test
+pnpm --filter @openturtle/cli build
+
+cd apps/cli
+npm pack --dry-run --json --registry=https://registry.npmjs.org
+```
+
+The tarball must contain `dist/index.js`, runtime modules, `README.md`, and `package.json`. It must not contain any of these removed runtime files:
+
+```text
+dist/mcp/server.js
+dist/commands/hook.js
+dist/installers/git.js
+dist/watchers/importers.js
+```
+
+The build script deletes `dist` before TypeScript compilation so removed source files cannot survive as stale package artifacts.
+
+## Normal Release: GitHub Actions
+
+The normal path is a push to GitHub `master` that changes the CLI package or root lockfile.
+
+1. Merge the validated CLI commit into `master` without including unrelated files.
+2. Push `master` to GitLab and GitHub.
+3. Confirm `.github/workflows/cli-npm-release.yml` starts on GitHub.
+4. Wait for test, build, version resolution, package inspection, and publish steps to complete.
+5. Verify the published package from npm, not only the workflow status.
+
+The workflow treats the repository package version as a floor. If npm already has that version or a newer one, `nextReleaseVersion()` increments the published patch version. The workflow does not require `NPM_TOKEN` or `NODE_AUTH_TOKEN`.
+
+Verification:
+
+```bash
+npm view @openturtle/cli version dist.tarball dist.shasum --json \
+  --registry=https://registry.npmjs.org
+```
+
+Do not declare completion while the workflow is queued, running, or blocked by GitHub billing. Use the manual fallback when CI cannot start and the release is required immediately.
+
+## Manual Fallback
+
+Use this only when Trusted Publisher CI is unavailable or when an explicitly requested release must happen before the `master` merge.
+
+1. Confirm npm login and the currently published version:
+
+```bash
+npm whoami --registry=https://registry.npmjs.org
+npm view @openturtle/cli version --registry=https://registry.npmjs.org
+```
+
+2. Set `packages/frontend/apps/cli/package.json` to an unused stable version.
+3. Run the required validation above.
+4. Publish from the package directory:
+
+```bash
+cd packages/frontend/apps/cli
+npm publish --access public --registry=https://registry.npmjs.org
+```
+
+5. Complete npm's browser authentication when prompted. A successful terminal result contains:
+
+```text
++ @openturtle/cli@<version>
+```
+
+6. Verify the exact published version and tarball metadata:
+
+```bash
+npm view @openturtle/cli@<version> version dist.tarball dist.shasum --json \
+  --registry=https://registry.npmjs.org
+```
+
+After a manual publish, still merge and push the exact source to both `master` branches. A later CI run may publish the next patch because the workflow always chooses an unused version.
+
+## Installed Package Smoke Test
+
+Test the public package from a temporary directory, not only from the repository:
+
+```bash
+release_tmp="$(mktemp -d)"
+cd "$release_tmp"
+pnpm dlx @openturtle/cli@<version> --help
+pnpm dlx @openturtle/cli@<version> --json doctor
+```
+
+For a global-install smoke test:
+
+```bash
+npm install --global @openturtle/cli@<version> \
+  --registry=https://registry.npmjs.org
+command -v ot
+ot --version
+ot --json doctor
+```
+
+`doctor` may report missing authentication, but it must return stable JSON rather than crash.
+
+## Skill Refresh Verification
+
+`ot install` records Agent installations in `~/.openturtle/cli/installations.json`. Both `ot update` and the startup auto-update worker reinstall the recorded Skill, Rule, or Steering after npm updates.
+
+Verify at least one installed target:
+
+```bash
+ot install --target codex --scope user
+ot update --check
+```
+
+After an actual version update, confirm the installed Skill contains the new direct CLI guidance:
+
+```bash
+rg -n "ot --json doctor|ot \.\.\. --json" ~/.codex/skills/openturtle-cli/SKILL.md
+```
+
+Installation and refresh must also remove only the legacy OpenTurtle-managed `ot-cli` MCP and `OPENTURTLE-CLI` Hook entries. User-owned MCP servers, Hooks, rules, and settings must remain intact.
+
+## Source Delivery Verification
+
+Before closing the release, compare the intended commit with both remotes:
+
+```bash
+git ls-remote --heads gitlab master
+git ls-remote --heads origin master
+git log -1 --oneline master
+```
+
+If the remotes differ, inspect ancestry and merge rather than force-pushing:
+
+```bash
+git merge-base --is-ancestor <gitlab-master> <release-commit>
+git merge-base --is-ancestor <github-master> <release-commit>
+```
+
+Report all of the following:
+
+- Published npm version and tarball shasum
+- Test/build/package inspection result
+- GitLab `master` commit
+- GitHub `master` commit
+- Workflow result or the reason manual fallback was used
+- Installed `ot --version` and Skill refresh result
+
+## Failure Recovery
+
+- `npm publish` reports an existing version: choose a new stable version; never reuse or overwrite an npm version.
+- Browser authentication expires: rerun `npm publish` and complete the newly generated npm authentication URL.
+- CI cannot start because of billing: use the manual fallback, then still merge the source to `master`.
+- Package contains removed files: ensure the build cleans `dist`, rebuild, and repeat `npm pack --dry-run --json`.
+- Skill is stale after update: inspect `~/.openturtle/cli/installations.json`, rerun `ot install --target <agent> --scope <scope>`, then verify the installed Skill/Rule/Steering.
+- One remote `master` is ahead: fetch both remotes, inspect commits, merge in a clean worktree, and push without force.

package/dist/commands/collaboration.js

@@ -29,17 +29,73 @@ export function createCollaborationCommands(client = new ApiClient()) {
                 candidates: exact ? [] : items,
             };
         },
-        async listRoster(teamId) {
+        async listRoster(teamId, projectId) {
             const team = teamId ? { id: teamId } : await client.get('/api/teams/me');
             const resolvedTeamId = String(team.id || teamId || '');
             if (!resolvedTeamId)
                 throw new Error('Current team response did not include an id');
-            const [members, profile, rosterProfile] = await Promise.all([
+            const [members, profile, rosterProfile, projectMembers] = await Promise.all([
                 client.get(`/api/teams/${encodeURIComponent(resolvedTeamId)}/members`, { page_size: 100 }),
                 client.get('/api/me/profile').catch(() => null),
                 client.get('/api/me/roster-profile').catch(() => null),
+                projectId
+                    ? client.get(`/api/projects/${encodeURIComponent(projectId)}/members`).catch(() => null)
+                    : Promise.resolve(null),
             ]);
-            return { team, profile, roster_profile: rosterProfile, members };
+            return { team, profile, roster_profile: rosterProfile, project_id: projectId || null, members, project_members: projectMembers };
+        },
+        async getWorkSummary(options) {
+            const limit = Number(options.limit) || 20;
+            const goalId = String(options.goal || '');
+            const projectId = String(options.project || '');
+            const todos = goalId
+                ? client.get(`/api/goals/${encodeURIComponent(goalId)}/todos`, {
+                    status: options.status,
+                    page: 1,
+                    page_size: limit,
+                })
+                : client.get('/api/todos', {
+                    scope: 'assigned',
+                    project_id: projectId || undefined,
+                    status: options.status,
+                    page: 1,
+                    page_size: limit,
+                });
+            const [digest, todoPage, notifications] = await Promise.all([
+                client.get('/api/goals/daily-digest/me'),
+                todos,
+                options.notifications === false
+                    ? Promise.resolve(null)
+                    : client.get('/api/notifications', { is_read: false, page: 1, page_size: limit }),
+            ]);
+            return {
+                project_id: projectId || null,
+                goal_id: goalId || null,
+                digest,
+                todos: todoPage,
+                notifications,
+            };
+        },
+        getProjectDigest: (projectId, window) => client.get('/api/digest', { project_id: projectId, window }),
+        async runOrgSyncSynthesis(options, dryRun = false) {
+            const scope = String(options.scope || 'active-project');
+            const projectId = String(options.project || '');
+            if (scope !== 'all' && !projectId)
+                throw new Error('--project is required unless --scope all is used');
+            const body = listQuery({
+                project_id: scope === 'all' ? undefined : projectId,
+                limit: options.limit,
+                updated_after: options.updatedAfter,
+            });
+            if (dryRun)
+                return dryRunRequest('POST', '/api/orgsync-synthesis/run', body);
+            const result = await client.post('/api/orgsync-synthesis/run', body);
+            return {
+                scope: scope === 'all' ? 'all' : 'active_project',
+                project_id: scope === 'all' ? null : projectId,
+                updated_after: options.updatedAfter || null,
+                result,
+            };
         },
         resolveContext: (body) => client.post('/api/project-context/resolve', body),
         getContextItem: (sourceType, sourceId, options) => client.get(`/api/project-context/items/${encodeURIComponent(sourceType)}/${encodeURIComponent(sourceId)}`, listQuery(options)),
@@ -127,7 +183,35 @@ export function registerCollaborationCommands(program, groups, callbacks) {
         .description('Current team roster')
         .command('list')
         .option('--team <id>')
-        .action(action(async (options) => print(await commands.listRoster(options.team))));
+        .option('--project <id>', 'include project roles and membership')
+        .action(action(async (options) => print(await commands.listRoster(options.team, options.project))));
+    program
+        .command('work')
+        .description('Current user action summary')
+        .command('summary')
+        .option('--project <id>')
+        .option('--goal <id>')
+        .option('--status <status>')
+        .option('--limit <number>', 'maximum todos and notifications', Number)
+        .option('--no-notifications')
+        .action(action(async (options) => print(await commands.getWorkSummary(options))));
+    program
+        .command('digest')
+        .description('Project execution digest')
+        .command('get')
+        .option('--project <id>')
+        .option('--window <window>', 'today|yesterday|this_week|last_week|this_month', 'today')
+        .action(action(async (options) => print(await commands.getProjectDigest(options.project, options.window))));
+    program
+        .command('orgsync')
+        .description('Generate reviewable organization knowledge candidates')
+        .command('synthesize')
+        .option('--scope <scope>', 'active-project|all', 'active-project')
+        .option('--project <id>')
+        .option('--limit <number>', 'maximum recent sessions', Number, 20)
+        .option('--updated-after <iso-time>')
+        .option('--dry-run')
+        .action(action(async (options) => print(await commands.runOrgSyncSynthesis(options, Boolean(options.dryRun)))));
     const context = program.command('context').description('Viewer-scoped project context');
     context
         .command('get')

package/dist/commands/local-knowledge.js

@@ -0,0 +1,129 @@
+import { readJsonBody } from '../core/input.js';
+import { createLocalKnowledgeEntry, getLocalKnowledgeAsset, importLocalKnowledgePaths, listLocalKnowledgeAssets, removeLocalKnowledgeAsset, updateLocalKnowledgeEntry, } from '../local-knowledge/library.js';
+import { readLocalKnowledgeIndexedContent, searchLocalKnowledgeIndex, } from '../local-knowledge/index.js';
+import { localKnowledgeStoreRoot } from '../local-knowledge/root.js';
+export function createLocalKnowledgeCommands(root = localKnowledgeStoreRoot()) {
+    return {
+        root,
+        list: () => listLocalKnowledgeAssets(root),
+        async search(query, limit = 20, matchMode = 'any') {
+            const assets = await listLocalKnowledgeAssets(root);
+            const hits = await searchLocalKnowledgeIndex(assets, query, Math.max(1, Math.min(limit, 100)), root, matchMode);
+            const byId = new Map(assets.map((asset) => [asset.id, asset]));
+            const items = hits.flatMap((hit) => {
+                const asset = byId.get(hit.assetId);
+                return asset ? [{ ...asset, matches: hit.matches }] : [];
+            });
+            return { root, items, count: items.length };
+        },
+        async read(assetId, truncate = 200_000) {
+            const asset = getLocalKnowledgeAsset(assetId, root);
+            if (!asset)
+                throw new Error('Local knowledge asset was not found');
+            const indexed = await readLocalKnowledgeIndexedContent(asset, Math.max(1, Math.min(truncate, 1_000_000)), root);
+            return {
+                ...asset,
+                text: indexed.content,
+                content_available: indexed.contentAvailable,
+                truncated: indexed.truncated,
+                index_status: indexed.indexStatus,
+            };
+        },
+        importPaths(paths, dryRun = false) {
+            if (dryRun)
+                return Promise.resolve(localDryRun(root, 'import', { paths }));
+            return importLocalKnowledgePaths(paths, root);
+        },
+        create(input, dryRun = false) {
+            if (dryRun)
+                return Promise.resolve(localDryRun(root, 'create', { input }));
+            return createLocalKnowledgeEntry(input, root);
+        },
+        update(assetId, input, dryRun = false) {
+            if (dryRun)
+                return Promise.resolve(localDryRun(root, 'update', { asset_id: assetId, input }));
+            return updateLocalKnowledgeEntry(assetId, input, root);
+        },
+        remove(assetId, dryRun = false) {
+            if (dryRun)
+                return Promise.resolve(localDryRun(root, 'remove', { asset_id: assetId }));
+            return removeLocalKnowledgeAsset(assetId, root);
+        },
+    };
+}
+export async function searchKnowledgeEverywhere(query, options, fetchCloud, root = localKnowledgeStoreRoot()) {
+    if (options.cloudOnly && options.localOnly)
+        throw new Error('Use --cloud-only or --local-only, not both');
+    const local = createLocalKnowledgeCommands(root);
+    const [cloudResult, localResult] = await Promise.all([
+        options.localOnly ? Promise.resolve(null) : fetchCloud(),
+        options.cloudOnly
+            ? Promise.resolve(null)
+            : local.search(query, Number(options.limit) || 20, normalizeMatchMode(options.match)),
+    ]);
+    return {
+        query,
+        cloud: cloudResult,
+        local: localResult,
+    };
+}
+export function registerLocalKnowledgeCommands(knowledge, callbacks) {
+    const commands = createLocalKnowledgeCommands();
+    const local = knowledge.command('local').description('Local indexed knowledge available without Desktop');
+    const action = (fn) => (...args) => {
+        Promise.resolve(fn(...args)).catch(callbacks.fatal);
+    };
+    local.command('list').action(action(async () => callbacks.print(await commands.list())));
+    local
+        .command('search <query>')
+        .option('--limit <number>', 'maximum results', Number, 20)
+        .option('--match <mode>', 'any|all|exact', 'any')
+        .action(action(async (query, options) => callbacks.print(await commands.search(query, options.limit, normalizeMatchMode(options.match)))));
+    local
+        .command('read <assetId>')
+        .option('--truncate <characters>', 'maximum extracted characters', Number, 200_000)
+        .action(action(async (assetId, options) => callbacks.print(await commands.read(assetId, options.truncate))));
+    local
+        .command('import <paths...>')
+        .option('--dry-run')
+        .action(action(async (paths, options) => callbacks.print(await commands.importPaths(paths, Boolean(options.dryRun)))));
+    local
+        .command('create')
+        .requiredOption('--body-file <path>', 'JSON body file, or - for stdin')
+        .option('--dry-run')
+        .action(action(async (options) => callbacks.print(await commands.create(asEntryInput(await readJsonBody(options.bodyFile)), Boolean(options.dryRun)))));
+    local
+        .command('update <assetId>')
+        .requiredOption('--body-file <path>', 'JSON body file, or - for stdin')
+        .option('--dry-run')
+        .action(action(async (assetId, options) => callbacks.print(await commands.update(assetId, asEntryInput(await readJsonBody(options.bodyFile)), Boolean(options.dryRun)))));
+    local
+        .command('remove <assetId>')
+        .option('--dry-run')
+        .action(action(async (assetId, options) => callbacks.print(await commands.remove(assetId, Boolean(options.dryRun)))));
+}
+function normalizeMatchMode(value) {
+    return value === 'all' || value === 'exact' ? value : 'any';
+}
+function asEntryInput(value) {
+    const kind = value.kind;
+    if (kind !== 'note' && kind !== 'decision' && kind !== 'fact' && kind !== 'meeting') {
+        throw new Error('Local knowledge kind must be note, decision, fact, or meeting');
+    }
+    return {
+        title: String(value.title || ''),
+        body: String(value.body || ''),
+        kind,
+        projectId: value.projectId == null ? undefined : String(value.projectId),
+        status: String(value.status || 'draft'),
+        attachments: Array.isArray(value.attachments)
+            ? value.attachments.map((item) => {
+                const attachment = item;
+                return { name: String(attachment.name || ''), path: String(attachment.path || '') };
+            })
+            : undefined,
+    };
+}
+function localDryRun(root, operation, input) {
+    return { dry_run: true, local_knowledge: { root, operation, ...input } };
+}

package/dist/core/auth.js

@@ -7,13 +7,15 @@ export function authPath(homeDir = os.homedir()) {
     return path.join(cliGlobalDir(homeDir), 'auth.json');
 }
 export function readAuth(homeDir = os.homedir()) {
-    const envToken = process.env.OPENTURTLE_TOKEN;
-    const envServer = process.env.OPENTURTLE_SERVER_URL || process.env.SERVER_URL;
+    const envToken = process.env.OPENTURTLE_API_TOKEN || process.env.OPENTURTLE_TOKEN;
+    const envServer = process.env.OPENTURTLE_API_BASE_URL || process.env.OPENTURTLE_SERVER_URL || process.env.SERVER_URL;
+    const envTeamId = process.env.OPENTURTLE_TEAM_ID;
     const config = readJsonFile(authPath(homeDir), {});
     return {
         ...config,
         ...(envServer ? { server: envServer } : {}),
         ...(envToken ? { token: envToken } : {}),
+        ...(envTeamId ? { teamId: envTeamId } : {}),
     };
 }
 export function writeAuth(config, homeDir = os.homedir()) {

package/dist/core/auto-update.js

@@ -40,6 +40,15 @@ export function npmUpdateArgs() {
     ];
 }
 export async function updateCli(currentVersion, options = {}, dependencies = {}) {
+    if ((dependencies.env || process.env).OPENTURTLE_CLI_DISTRIBUTION === 'desktop') {
+        return {
+            current: currentVersion,
+            latest: null,
+            available: false,
+            updated: false,
+            reason: 'desktop_managed',
+        };
+    }
     const latest = await fetchLatestVersion(dependencies.fetchImpl);
     if (!latest) {
         return { current: currentVersion, latest: null, available: false, updated: false, reason: 'not_published' };
@@ -71,7 +80,9 @@ export function scheduleAutomaticUpdate(currentVersion, dependencies = {}) {
     try {
         const env = dependencies.env || process.env;
         const argv = dependencies.argv || process.argv;
-        if (env.OPENTURTLE_DISABLE_AUTO_UPDATE === '1' || env.OPENTURTLE_AUTO_UPDATE_WORKER === '1')
+        if (env.OPENTURTLE_CLI_DISTRIBUTION === 'desktop' ||
+            env.OPENTURTLE_DISABLE_AUTO_UPDATE === '1' ||
+            env.OPENTURTLE_AUTO_UPDATE_WORKER === '1')
             return false;
         if (argv[2] === 'update' || !isManagedNpmInstall(dependencies.packageRoot))
             return false;

package/dist/index.js

@@ -2,6 +2,7 @@
 import fs from 'node:fs';
 import { Command } from 'commander';
 import { registerCollaborationCommands } from './commands/collaboration.js';
+import { registerLocalKnowledgeCommands, searchKnowledgeEverywhere } from './commands/local-knowledge.js';
 import { doctor, draftDailyReport, createResourceCommands } from './commands/resources.js';
 import { ApiClient, ApiError } from './core/api-client.js';
 import { scheduleAutomaticUpdate, updateCli } from './core/auto-update.js';
@@ -233,8 +234,11 @@ knowledge
     .option('--person <name-or-id>')
     .option('--scope <scope>', 'team|managed|participating|assigned', 'team')
     .option('--limit <number>', 'maximum results', Number)
+    .option('--match <mode>', 'local match mode: any|all|exact', 'any')
+    .option('--cloud-only')
+    .option('--local-only')
     .option('--json')
-    .action(action(async (keyword, options) => print(await resources.searchKnowledge(keyword, options), options.json)));
+    .action(action(async (keyword, options) => print(await searchKnowledgeEverywhere(keyword, options, () => resources.searchKnowledge(keyword, options)), options.json)));
 knowledge
     .command('sources')
     .option('--path <path>')
@@ -245,6 +249,7 @@ knowledge
     .command('source <path>')
     .option('--json')
     .action(action(async (filePath, options) => print(await resources.readKnowledgeSource(filePath), options.json)));
+registerLocalKnowledgeCommands(knowledge, { print, fatal });
 const worklogs = program.command('worklogs');
 worklogs
     .command('list')