@openturtle/cli 0.3.5 → 0.3.7

package/README.md

@@ -56,7 +56,7 @@ 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 worklogs record --summary "完成联调" --type progress --todo <todo-id>
 ot report draft --today
 ```
 
@@ -79,7 +79,7 @@ ot todos progress <todo-id> --message "完成接口联调，等待验收"
 ### 记录一条工作日志
 
 ```bash
-ot worklogs record --summary "完成 Qoder CLI 接入验证" --type progress
+ot worklogs record --summary "完成 Qoder CLI 接入验证" --type progress --todo <todo-id>
 ```
 
 ### 聚合搜索知识
@@ -446,7 +446,7 @@ ot meetings updates ignore <meeting-id> <update-id> --dry-run
 
 ```bash
 ot worklogs list --today
-ot worklogs record --summary "完成 Qoder CLI 接入验证" --type progress
+ot worklogs record --summary "完成 Qoder CLI 接入验证" --type progress --todo <todo-id>
 ot worklogs record --summary "Codex CLI 登录需要用户确认" --type blocker
 ot worklogs create --body-file worklog.json --dry-run
 ```
@@ -487,7 +487,7 @@ ot projects resolve "项目名"
 ot context get --project <project-id>
 ot meetings list --project <project-id>
 ot todos progress <todo-id> --message "..."
-ot worklogs record --summary "..." --type progress
+ot worklogs record --summary "..." --type progress --todo <todo-id>
 ot report draft --today
 ```
 

package/dist/commands/resources.js

@@ -21,7 +21,7 @@ export function createResourceCommands(client = new ApiClient()) {
             return client.patch(`/api/todos/${encodeURIComponent(todoId)}/status`, { status });
         },
         async updateTodoProgress(todoId, message) {
-            return client.patch(`/api/todos/${encodeURIComponent(todoId)}/progress-description`, {
+            return client.put(`/api/todos/${encodeURIComponent(todoId)}/progress-description`, {
                 progress_description: message,
             });
         },
@@ -31,6 +31,16 @@ export function createResourceCommands(client = new ApiClient()) {
         async showKnowledge(knowledgeId) {
             return client.get(`/api/memory/objects/${encodeURIComponent(knowledgeId)}`);
         },
+        async rememberKnowledge(options) {
+            return client.post('/api/memory/remember', {
+                what: options.what,
+                why: options.why ?? '',
+                how_to_apply: options.howToApply ?? '',
+                kind: options.kind ?? 'note',
+                scope: options.scope ?? 'org',
+                project_id: options.project,
+            });
+        },
         async searchKnowledge(keyword, options = {}) {
             return client.get('/api/memory/search', listQuery({
                 q: keyword,
@@ -49,14 +59,33 @@ export function createResourceCommands(client = new ApiClient()) {
         async listWorklogs(options) {
             return client.get('/api/work-logs', listQuery(options));
         },
-        async recordWorklog(summary, type = 'note') {
+        async recordWorklog(summary, type = 'note', references = {}) {
             return client.post('/api/work-logs', {
+                ...(references.project ? { project_id: references.project } : {}),
+                ...(references.goal ? { goal_id: references.goal } : {}),
+                ...(references.todo ? { todo_id: references.todo } : {}),
                 summary,
                 event_type: type,
                 source: 'manual',
                 metadata: { source_client: 'ot-cli' },
             });
         },
+        async listEvolutionReports(options) {
+            return client.get('/api/memory/evolution/reports', listQuery(options));
+        },
+        async triggerEvolution() {
+            // 找到「组织记忆自进化」内置 job 并手动触发一次(异步执行,立即返回)。
+            const res = await client.get('/api/system-config/scheduled-jobs', {
+                page: 1,
+                page_size: 100,
+            });
+            const jobs = res?.items ?? res ?? [];
+            const job = jobs.find((j) => j.handler === 'memory_org_evolution');
+            if (!job)
+                throw new Error('未找到「组织记忆自进化」定时任务(handler=memory_org_evolution)');
+            await client.post(`/api/system-config/scheduled-jobs/${job.id}/trigger`, {});
+            return { triggered: true, job: { id: job.id, name: job.name, cron: job.cron } };
+        },
     };
 }
 function knowledgeQuery(options) {

package/dist/core/api-client.js

@@ -42,6 +42,9 @@ export class ApiClient {
     patch(path, body) {
         return this.request('PATCH', path, body);
     }
+    put(path, body) {
+        return this.request('PUT', path, body);
+    }
     delete(path, body) {
         return this.request('DELETE', path, body);
     }

package/dist/index.js

@@ -250,6 +250,24 @@ knowledge
     .option('--json')
     .action(action(async (filePath, options) => print(await resources.readKnowledgeSource(filePath), options.json)));
 registerLocalKnowledgeCommands(knowledge, { print, fatal });
+program
+    .command('remember')
+    .description('随手记一条团队记忆（坑/决策/真相），进草稿待 AI 审核')
+    .requiredOption('--what <fact>', '一句话原子事实，如「溯源接口在测试环境会 404」')
+    .option('--why <reason>', '为什么值得记（根因/决策理由）')
+    .option('--how-to-apply <action>', '下次怎么用（避坑动作/决策依据）')
+    .option('--kind <kind>', 'note|decision|fact', 'note')
+    .option('--scope <scope>', 'org|project', 'org')
+    .option('--project <id>', '可选项目归属')
+    .option('--json')
+    .action(action(async (options) => print(await resources.rememberKnowledge({
+    what: options.what,
+    why: options.why,
+    howToApply: options.howToApply,
+    kind: options.kind,
+    scope: options.scope,
+    project: options.project,
+}), options.json)));
 const worklogs = program.command('worklogs');
 worklogs
     .command('list')
@@ -261,6 +279,9 @@ worklogs
     .command('record')
     .option('--summary <text>')
     .option('--type <type>', 'progress|blocker|decision|commit|note|meeting', 'note')
+    .option('--project <id>', 'optional project reference')
+    .option('--goal <id>', 'optional goal reference')
+    .option('--todo <id>', 'optional Todo reference')
     .option('--dry-run')
     .action(action(async (options) => {
     requireOption(options.summary, '--summary');
@@ -271,6 +292,9 @@ worklogs
                 method: 'POST',
                 path: '/api/work-logs',
                 body: {
+                    ...(options.project ? { project_id: options.project } : {}),
+                    ...(options.goal ? { goal_id: options.goal } : {}),
+                    ...(options.todo ? { todo_id: options.todo } : {}),
                     summary: options.summary,
                     event_type: options.type,
                     source: 'manual',
@@ -280,9 +304,26 @@ worklogs
         });
         return;
     }
-    print(await resources.recordWorklog(options.summary, options.type));
+    print(await resources.recordWorklog(options.summary, options.type, {
+        project: options.project,
+        goal: options.goal,
+        todo: options.todo,
+    }));
 }));
 registerCollaborationCommands(program, { goals, todos, knowledge, worklogs }, { print, fatal });
+const evolution = program.command('evolution').description('组织记忆自进化(演化报告与手动触发)');
+evolution
+    .command('reports')
+    .description('列出组织记忆自进化报告(按运行时间倒序)')
+    .option('--page <number>', 'page number', Number)
+    .option('--page-size <number>', 'items per page', Number)
+    .option('--json')
+    .action(action(async (options) => print(await resources.listEvolutionReports(options), options.json)));
+evolution
+    .command('run')
+    .description('手动触发一次组织记忆自进化(异步执行)')
+    .option('--json')
+    .action(action(async (options) => print(await resources.triggerEvolution(), options.json)));
 program
     .command('report [subcommand]')
     .description('daily report commands')

package/dist/local-knowledge/index.js

@@ -113,7 +113,13 @@ async function indexAsset(asset, existing, statements) {
             return;
         }
         const content = bytes.toString('utf8');
-        const chunks = textChunks(asset.entry ? `${asset.entry.title}\n\n${content}` : content);
+        const chunks = [];
+        // 表单标题作为元数据行(line 0)单独索引,不拼进正文——这样标题可搜,且正文 chunk
+        // 保持源文件行号(1-based),citation 能指回原文真实行。
+        const title = asset.entry?.title?.trim();
+        if (title)
+            chunks.push({ content: title, lineStart: 0, lineEnd: 0 });
+        chunks.push(...textChunks(content));
         chunks.forEach((chunk, index) => statements.insertChunk.run(asset.id, index, chunk.lineStart, chunk.lineEnd, chunk.content));
         setIndexStatus(statements, asset, 'indexed');
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openturtle/cli",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "OpenTurtle collaboration, knowledge, meeting, and agent CLI",
   "keywords": [
     "openturtle",

package/skill/openturtle-cli/SKILL.md

@@ -26,7 +26,8 @@ ot --json doctor
 2. 用 `ot roster list --project <id>` 解析成员；先匹配 canonical `display_name`，再参考 aliases 和项目角色，重名或无法唯一匹配时询问用户。
 3. 用 `ot context get --project <id> --query <term>` 获取项目上下文；复杂问题拆成少量明确查询词。
 4. 按对象读取：`ot work summary`、`ot goals list/show`、`ot todos list/show`、`ot knowledge list/show/search`、`ot knowledge local list/search/read`、`ot meetings list/show/transcript/minutes/participants`、`ot worklogs list`。
-5. 高层命令缺失时才使用只读逃生口 `ot request get /api/...`。
+5. 记录 Todo 执行进展时优先使用 `ot worklogs record --summary "..." --type progress --todo <todo-id>`，可同时传 `--project` / `--goal`，不要只把关联 ID 塞进 metadata。
+6. 高层命令缺失时才使用只读逃生口 `ot request get /api/...`。
 
 ## 写入规则