@lumoai/cli 1.3.0 → 1.5.0

package/assets/skill.md

@@ -1,6 +1,6 @@
 ---
 name: lumo
-description: 'Use the Lumo CLI to load task context, manage session bindings, inspect projects and milestones, and create/update/list/show/comment on tasks from the terminal. Activate when: user mentions a Lumo task identifier (LUM-42, LUM-12, etc.), asks to load task background or context, wants to bind, check, or detach a Claude Code session''s task binding, is about to start development work on a specific task, wants to create a new task, list their tasks, view a task, comment on a task, list projects, list milestones, attach a task to a milestone, or update a task''s status/title/description/priority/assignee/milestone. Triggers on: "LUM-", "task context", "load context", "session start", "session attach", "session status", "session detach", "bind session", "unbind session", "which task", "what task am I on", "work on LUM", "create task", "new task", "add task", "file a task", "log a task", "list tasks", "my tasks", "show task", "view task", "comment on task", "leave a comment", "list projects", "what projects", "update task", "change task status", "rename task", "reassign task", "mark task as done", "milestone", "里程碑", "list milestones", "set milestone", "挂到 milestone", "attach milestone", "unbind milestone", "create milestone", "new milestone", "update milestone", "change milestone status", "delete milestone", "show milestone", "view milestone", "tasks in milestone", "milestone tasks", "新建里程碑", "更新里程碑", "删除里程碑", "查看里程碑", "auth login", "log in", "login", "auth logout", "log out", "logout", "sign out", "switch account", "switch identity", "whoami", "who am I", "current identity", "current user", "current workspace", "登录", "登出", "切换账号", "当前身份", "create doc", "new doc", "new document", "write doc", "写文档", "新建文档", "update doc", "edit doc", "修改文档", "更新文档", "list docs", "my docs", "我的文档", "show doc", "view doc", "查看文档", "delete doc", "删除文档", "bind doc", "attach doc to task", "把文档关联到任务", "文档绑定到任务", "unbind doc", "解绑文档", "personal doc", "workspace doc", "个人文档", "workspace 文档", "doc scope", "tag", "add tag", "remove tag", "标签", "添加标签", "移除标签", "doc tag", "task tag", "share doc", "doc share", "share document", "分享文档", "文档分享", "unshare doc", "remove share", "取消分享", "share list", "list doc shares", "who has access", "viewer", "editor", "manager", "shared with", "doc tree", "doc move", "move doc", "reparent doc", "文档树", "移动文档", "sprint", "start sprint", "close sprint", "add to sprint", "active sprints", "冲刺", "迭代", "开始冲刺", "关闭冲刺", "create sprint", "new sprint", "list sprints", "show sprint", "update sprint", "delete sprint", "sprint summary", "sprint retro", "把任务挂到冲刺", "冲刺里有什么", "lumo update", "update cli", "upgrade lumo", "update lumo", "upgrade cli", "升级 lumo", "更新 cli", "new lumo version", "是否有新版本", "lumo setup", "install lumo skill", "install lumo hooks", "wire up lumo", "set up lumo", "onboard lumo", "npx @lumoai/cli", "安装 lumo", "配置 lumo", "lumo 初始化", "task artifact", "artifact add", "artifact list", "artifact show", "artifact rm", "artifact delete", "remove artifact", "delete artifact", "spec artifact", "record spec", "attach spec", "attach plan", "记录 spec", "挂 spec", "查看 artifact", "删除 artifact", figma, attach figma, figma link, 关联 figma, 设计稿, figma design.'
+description: 'Use the Lumo CLI to load task context, manage session bindings, inspect projects and milestones, and create/update/list/show/comment on tasks from the terminal. Activate when: user mentions a Lumo task identifier (LUM-42, LUM-12, etc.), asks to load task background or context, wants to bind, check, or detach a Claude Code session''s task binding, is about to start development work on a specific task, wants to create a new task, list their tasks, view a task, comment on a task, list projects, list milestones, attach a task to a milestone, or update a task''s status/title/description/priority/assignee/milestone. Triggers on: "LUM-", "task context", "load context", "session start", "session attach", "session status", "session detach", "bind session", "unbind session", "which task", "what task am I on", "work on LUM", "create task", "new task", "add task", "file a task", "log a task", "list tasks", "my tasks", "show task", "view task", "comment on task", "leave a comment", "list projects", "what projects", "update task", "change task status", "rename task", "reassign task", "mark task as done", "milestone", "里程碑", "list milestones", "set milestone", "挂到 milestone", "attach milestone", "unbind milestone", "create milestone", "new milestone", "update milestone", "change milestone status", "delete milestone", "show milestone", "view milestone", "tasks in milestone", "milestone tasks", "新建里程碑", "更新里程碑", "删除里程碑", "查看里程碑", "auth login", "log in", "login", "auth logout", "log out", "logout", "sign out", "switch account", "switch identity", "whoami", "who am I", "current identity", "current user", "current workspace", "登录", "登出", "切换账号", "当前身份", "create doc", "new doc", "new document", "write doc", "写文档", "新建文档", "update doc", "edit doc", "修改文档", "更新文档", "list docs", "my docs", "我的文档", "show doc", "view doc", "查看文档", "delete doc", "删除文档", "bind doc", "attach doc to task", "把文档关联到任务", "文档绑定到任务", "unbind doc", "解绑文档", "personal doc", "workspace doc", "个人文档", "workspace 文档", "doc scope", "tag", "add tag", "remove tag", "标签", "添加标签", "移除标签", "doc tag", "task tag", "share doc", "doc share", "share document", "分享文档", "文档分享", "unshare doc", "remove share", "取消分享", "share list", "list doc shares", "who has access", "viewer", "editor", "manager", "shared with", "doc tree", "doc move", "move doc", "reparent doc", "文档树", "移动文档", "sprint", "start sprint", "close sprint", "add to sprint", "active sprints", "冲刺", "迭代", "开始冲刺", "关闭冲刺", "create sprint", "new sprint", "list sprints", "show sprint", "update sprint", "delete sprint", "sprint summary", "sprint retro", "把任务挂到冲刺", "冲刺里有什么", "lumo update", "update cli", "upgrade lumo", "update lumo", "upgrade cli", "升级 lumo", "更新 cli", "new lumo version", "是否有新版本", "lumo setup", "install lumo skill", "install lumo hooks", "wire up lumo", "set up lumo", "onboard lumo", "npx @lumoai/cli", "安装 lumo", "配置 lumo", "lumo 初始化", "task artifact", "artifact add", "artifact list", "artifact show", "artifact rm", "artifact delete", "artifact update", "update artifact", "edit artifact", "change artifact kind", "change artifact source", "remove artifact", "delete artifact", "spec artifact", "record spec", "attach spec", "attach plan", "记录 spec", "挂 spec", "查看 artifact", "编辑 artifact", "修改 artifact", "删除 artifact", figma, attach figma, figma link, 关联 figma, 设计稿, figma design, "memory", "记忆", "remember", "record a memory", "记一条", "promote memory", "promote to project", "沉淀", "task memory", "project memory", "lumo memory".'
 ---
 
 ## Prerequisites
@@ -299,20 +299,35 @@ The CLI does not support @-mention chip syntax. If the user wants to ping someon
 
 Record Claude Code spec-engineering products (spec / plan / design …) on a task. The artifacts show up in the task detail "规格" (definition) layer and are injected into `lumo task context`.
 
-#### `lumo task artifact add <task> --kind <kind> --title <title> --file <path> [--source <source>]`
+#### `lumo task artifact add <task> --kind <kind> --title <title> --file <path> --source <source> --agent <agent>`
 
-Attaches an artifact to a task. `--kind`, `--title`, `--source` are stored verbatim — **`kind` is opaque** (no enumeration; `spec` / `plan` / `requirements` / anything is accepted). `--file` supplies the body (file contents). `--source` defaults to `claude-code`. Each call appends to the end of the task's artifact list — call once per artifact (e.g. Superpowers: one `spec`, one `plan`). The `<task>` (e.g. `LUM-42`) is resolved server-side.
+Attaches an artifact to a task. `--kind`, `--title`, `--source` are stored verbatim — **`kind` is opaque** (no enumeration; `spec` / `plan` / `requirements` / anything is accepted). `--source` is **required** and names the spec-generation framework that produced the artifact, written as its **formal name** (`Superpowers` / `Spec Kit` / `BMad` / `OpenSpec` / `GSD` / …) — it is also opaque (no enumeration), but there is **no default**, so you must pass it. Quote names that contain spaces (`--source "Spec Kit"`). `--file` supplies the body (file contents). Each call appends to the end of the task's artifact list — call once per artifact (e.g. Superpowers: one `spec`, one `plan`). The `<task>` (e.g. `LUM-42`) is resolved server-side.
+
+`--agent` is **required** and names the coding tool that produced the artifact (enum). Valid values: `claude-code | codex | cursor | gemini-cli | github-copilot | windsurf` (case-insensitive; `gemini` and `copilot` are accepted aliases).
 
 ```bash
-lumo task artifact add LUM-42 --kind spec --title "Spec" --file docs/spec.md --source superpowers
-lumo task artifact add LUM-42 --kind plan --title "Implementation plan" --file docs/plan.md --source superpowers
+lumo task artifact add LUM-42 --kind spec --title "Spec" --file docs/spec.md --source Superpowers --agent claude-code
+lumo task artifact add LUM-42 --kind plan --title "Implementation plan" --file docs/plan.md --source "Spec Kit" --agent claude-code
 ```
 
 Output: `Added [spec] "Spec" to LUM-42`
 
+#### `lumo task artifact update <task> <artifact-id> [--kind <kind>] [--title <title>] [--source <source>] [--agent <agent>]`
+
+Patches an existing artifact's metadata in place. Editable fields are **`kind`, `title`, `source`, and `agent`** — **content is immutable** (to change the body, `rm` the artifact and `add` it again). At least one flag is required; passing none errors before any network call. Empty values (`--kind ""`) are rejected. The `<artifact-id>` is the cuid in column 1 of `artifact list`. `--agent` accepts the same valid values and aliases as `artifact add`: `claude-code | codex | cursor | gemini-cli | github-copilot | windsurf` (case-insensitive; `gemini` and `copilot` are accepted aliases).
+
+```bash
+lumo task artifact update LUM-42 cma_xxx --kind plan              # re-classify spec → plan
+lumo task artifact update LUM-42 cma_xxx --source "Spec Kit"      # fix the framework label
+lumo task artifact update LUM-42 cma_xxx --title "Final spec" --source OpenSpec
+lumo task artifact update LUM-42 cma_xxx --agent cursor           # fix the agent label
+```
+
+Output: `Updated [plan] "Final spec" (OpenSpec) on LUM-42`. A 404 (task or artifact missing in this workspace) prints the server message and exits 1.
+
 #### `lumo task artifact list <task>`
 
-Lists artifacts on the task in order: `<id>  <kind>  <source>  <title>`. Prints `No artifacts on <task>` when there are none.
+Lists artifacts on the task in order: `<id>  <kind>  <agent>  <source>  <title>`. Prints `No artifacts on <task>` when there are none.
 
 ```bash
 lumo task artifact list LUM-42
@@ -320,7 +335,7 @@ lumo task artifact list LUM-42
 
 #### `lumo task artifact show <task> <artifact-id>`
 
-Prints one artifact's key:value header (id, kind, title, source, order, task) followed by the full content body. The `<artifact-id>` is the cuid in column 1 of `artifact list`.
+Prints one artifact's key:value header (id, kind, title, agent, source, order, task) followed by the full content body. The `<artifact-id>` is the cuid in column 1 of `artifact list`.
 
 ```bash
 lumo task artifact show LUM-42 cma_xxx
@@ -334,7 +349,7 @@ Deletes an artifact from a task. Irreversible — `--yes` is required and there
 lumo task artifact rm LUM-42 cma_xxx --yes
 ```
 
-When to suggest: after running a spec/plan workflow in Claude Code, offer to record the product(s) with `task artifact add` (one call per artifact). Use `task artifact list` to see what's already recorded, `task artifact show` to inspect a single artifact's content, and `task artifact rm` to drop one that's wrong or stale.
+When to suggest: after running a spec/plan workflow in Claude Code, offer to record the product(s) with `task artifact add` (one call per artifact) — always pass `--source` with the framework you used. Use `task artifact list` to see what's already recorded, `task artifact show` to inspect a single artifact's content, `task artifact update` to fix a wrong kind/title/source without re-uploading, and `task artifact rm` to drop one that's wrong or stale.
 
 ### Task ↔ Figma Designs
 
@@ -874,6 +889,70 @@ lumo sprint remove 3 LUM-48
 
 When to suggest: user says "remove LUM-48 from the sprint", "take this task out of sprint 3", "move task to backlog".
 
+## Memory management
+
+Record and curate the long-term Memory that Claude reads on future sessions.
+Memories are scoped **TASK** (useful only for one task) or **PROJECT** (useful
+across the whole project). Automated extraction (layer1) and promotion (layer2,
+on task→done) already run; these commands are the manual override.
+
+### Commands
+
+```bash
+# List
+lumo task memory list [LUM-N] [--category trap|decision|convention|procedural] [-n N]
+lumo project memory list [<project>] [--category ...] [-n N]
+
+# Add (per-category fields; <task>/<project> default to the session-bound task)
+lumo task memory add [LUM-N] --category trap --trigger "..." --outcome "..." [--workaround "..."]
+lumo task memory add [LUM-N] --category decision --what "..." --why "..." [--alternatives "..."] [--implications "..."]
+lumo task memory add [LUM-N] --category convention --rule "..." --applies "..."
+lumo task memory add [LUM-N] --category procedural --workflow "..." --trigger "..." [--step "..." --step "..."]
+lumo project memory add [<project>] --category ...   # same flags; records at PROJECT scope
+
+# Single-memory ops (memoryId from `... memory list` column 1)
+lumo memory promote <memoryId>     # TASK → PROJECT
+lumo memory rm <memoryId> --yes    # hard delete
+```
+
+When the session is bound (`lumo session attach <LUM-N>`), omit the identifier:
+`lumo task memory add --category trap --trigger ... --outcome ...` records onto
+the bound task; `lumo project memory add ...` records onto its project.
+
+### When to record a memory (worthiness)
+
+Record only knowledge that is **invisible in the codebase** — the _why_ behind a
+choice, a gotcha that only surfaces at runtime, a rule that lives in people's
+heads, a non-obvious failure cause, a non-trivial workflow. **Skip** routine work
+(reading files, plain edits, normal git, successful builds) and anything a
+developer could learn from the source, git log, or docs. When unsure, don't.
+
+### Which category
+
+- `trap` — a pitfall. Describe the PROBLEM ONLY (`--trigger`, `--outcome`); put any fix in a separate `procedural`.
+- `decision` — an engineering decision (`--what` + `--why`, optional `--alternatives`/`--implications`).
+- `convention` — a team rule (`--rule` + `--applies` = where it applies).
+- `procedural` — a reusable workflow (`--workflow` + `--trigger` + `--step`…).
+
+### TASK vs PROJECT (at add time)
+
+Default to **TASK** (`lumo task memory add`). Record directly to **PROJECT**
+(`lumo project memory add`) only when it helps _any_ task in the project: a
+toolchain/environment trap, a team-wide convention, a cross-task decision. When
+unsure → TASK.
+
+### When to promote (TASK → PROJECT)
+
+`lumo memory promote <id>` only when the lesson **recurs across 2+ different
+tasks**, would help a _different_ task, and no equivalent PROJECT memory exists.
+A wrong promotion is costly (every agent sees it forever) — prefer leaving it at TASK.
+
+### When to reach for this
+
+After a non-trivial debugging session, a pitfall you hit, or establishing a
+convention → consider `lumo task memory add`. When you notice a lesson recurring
+across multiple tasks → consider `lumo memory promote`.
+
 ## Session Management
 
 ### `lumo session attach <identifier>` — bind the current session to a task

package/dist/cli/src/commands/memory-project-add.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryProjectAdd = memoryProjectAdd;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const memory_content_1 = require("../lib/memory-content");
+const resolve_1 = require("../lib/resolve");
+const resolve_bound_task_1 = require("../lib/resolve-bound-task");
+const resolve_project_1 = require("../lib/resolve-project");
+async function memoryProjectAdd(refArg, options) {
+    if (!options.category) {
+        console.error('Error: --category <trap|decision|convention|procedural> is required.');
+        return 1;
+    }
+    const built = (0, memory_content_1.buildMemoryContent)(options.category, options);
+    if (!built.ok) {
+        console.error(`Error: ${built.error}`);
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    let projectId;
+    let echoSuffix = '';
+    if (refArg) {
+        projectId = await (0, resolve_1.resolveProjectId)(base, creds.token, refArg);
+    }
+    else {
+        const bound = await (0, resolve_bound_task_1.resolveBoundTaskIdentifier)(apiUrl, creds.token);
+        if (!bound) {
+            console.error('Error: no <project-ref> given and no task bound to this session.\nPass a project, or run `lumo session attach <LUM-N>`.');
+            return 1;
+        }
+        const r = await (0, resolve_project_1.resolveBoundProjectId)(apiUrl, creds.token, bound);
+        if (!r.ok) {
+            console.error(`Error: ${r.error}`);
+            return 1;
+        }
+        projectId = r.id;
+        echoSuffix = ` (project of bound task ${bound})`;
+    }
+    let res;
+    try {
+        res = await fetch(`${base}/api/projects/${encodeURIComponent(projectId)}/memories`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${creds.token}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ category: built.category, content: built.content }),
+        });
+    }
+    catch (err) {
+        console.error(`Error: could not reach Lumo API at ${apiUrl} (${err instanceof Error ? err.message : String(err)})`);
+        return 1;
+    }
+    if (res.status !== 201) {
+        let m = null;
+        try {
+            const b = (await res.json());
+            if (typeof b.error === 'string')
+                m = b.error;
+        }
+        catch { /* */ }
+        console.error(m ? `Error: ${m}` : `Error: memory add failed (HTTP ${res.status})`);
+        return 1;
+    }
+    process.stdout.write(`Added ${built.category} PROJECT memory${echoSuffix}\n`);
+}

package/dist/cli/src/commands/memory-project-list.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryProjectList = memoryProjectList;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const memory_content_1 = require("../lib/memory-content");
+const resolve_1 = require("../lib/resolve");
+const resolve_bound_task_1 = require("../lib/resolve-bound-task");
+const resolve_project_1 = require("../lib/resolve-project");
+async function memoryProjectList(refArg, options) {
+    const limit = options.limit !== undefined ? parseInt(options.limit, 10) : undefined;
+    if (limit !== undefined && (Number.isNaN(limit) || limit < 1)) {
+        console.error(`Error: invalid --limit "${options.limit}" (expected a positive integer)`);
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    let projectId;
+    if (refArg) {
+        projectId = await (0, resolve_1.resolveProjectId)(base, creds.token, refArg);
+    }
+    else {
+        const bound = await (0, resolve_bound_task_1.resolveBoundTaskIdentifier)(apiUrl, creds.token);
+        if (!bound) {
+            console.error('Error: no <project-ref> given and no task bound to this session.\nPass a project, or run `lumo session attach <LUM-N>`.');
+            return 1;
+        }
+        const r = await (0, resolve_project_1.resolveBoundProjectId)(apiUrl, creds.token, bound);
+        if (!r.ok) {
+            console.error(`Error: ${r.error}`);
+            return 1;
+        }
+        projectId = r.id;
+    }
+    let res;
+    try {
+        res = await fetch(`${base}/api/projects/${encodeURIComponent(projectId)}/memories`, { headers: { Authorization: `Bearer ${creds.token}` } });
+    }
+    catch (err) {
+        console.error(`Error: could not reach Lumo API at ${apiUrl} (${err instanceof Error ? err.message : String(err)})`);
+        return 1;
+    }
+    if (!res.ok) {
+        console.error(`Error: memory list failed (HTTP ${res.status})`);
+        return 1;
+    }
+    let rows = (await res.json()).memories;
+    if (options.category)
+        rows = rows.filter(m => m.category.toLowerCase() === options.category.toLowerCase());
+    if (limit !== undefined)
+        rows = rows.slice(0, limit);
+    process.stdout.write((0, memory_content_1.formatMemoryList)(rows) + '\n');
+}

package/dist/cli/src/commands/memory-promote.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryPromote = memoryPromote;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+async function memoryPromote(memoryId) {
+    if (!memoryId) {
+        console.error('Error: missing <memoryId>. Usage: lumo memory promote <memoryId>');
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    let res;
+    try {
+        res = await fetch(`${base}/api/memories/${encodeURIComponent(memoryId)}`, {
+            method: 'PATCH',
+            headers: { Authorization: `Bearer ${creds.token}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ scope: 'PROJECT' }),
+        });
+    }
+    catch (err) {
+        console.error(`Error: could not reach Lumo API at ${apiUrl} (${err instanceof Error ? err.message : String(err)})`);
+        return 1;
+    }
+    if (res.status === 404) {
+        console.error(`Error: memory ${memoryId} not found`);
+        return 1;
+    }
+    if (res.status === 409) {
+        console.error('Error: this memory is already project-scoped.');
+        return 1;
+    }
+    if (res.status !== 200) {
+        let m = null;
+        try {
+            const b = (await res.json());
+            if (typeof b.error === 'string')
+                m = b.error;
+        }
+        catch { /* */ }
+        console.error(m ? `Error: ${m}` : `Error: promote failed (HTTP ${res.status})`);
+        return 1;
+    }
+    process.stdout.write(`Promoted ${memoryId} to PROJECT — every agent on this project now sees it.\n` +
+        'Promote only lessons that recur across 2+ tasks.\n');
+}

package/dist/cli/src/commands/memory-rm.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryRm = memoryRm;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+async function memoryRm(memoryId, options) {
+    if (!memoryId) {
+        console.error('Error: missing <memoryId>. Usage: lumo memory rm <memoryId> --yes');
+        return 1;
+    }
+    if (!options.yes) {
+        console.error('Error: refusing to delete without --yes. Re-run with --yes to confirm.');
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    let res;
+    try {
+        res = await fetch(`${base}/api/memories/${encodeURIComponent(memoryId)}`, {
+            method: 'DELETE',
+            headers: { Authorization: `Bearer ${creds.token}` },
+        });
+    }
+    catch (err) {
+        console.error(`Error: could not reach Lumo API at ${apiUrl} (${err instanceof Error ? err.message : String(err)})`);
+        return 1;
+    }
+    if (res.status === 404) {
+        console.error(`Error: memory ${memoryId} not found`);
+        return 1;
+    }
+    if (res.status !== 204) {
+        console.error(`Error: delete failed (HTTP ${res.status})`);
+        return 1;
+    }
+    process.stdout.write(`Deleted memory ${memoryId}\n`);
+}

package/dist/cli/src/commands/memory-task-add.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryTaskAdd = memoryTaskAdd;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const memory_content_1 = require("../lib/memory-content");
+const resolve_bound_task_1 = require("../lib/resolve-bound-task");
+async function memoryTaskAdd(identifierArg, options) {
+    if (!options.category) {
+        console.error('Error: --category <trap|decision|convention|procedural> is required.');
+        return 1;
+    }
+    const built = (0, memory_content_1.buildMemoryContent)(options.category, options);
+    if (!built.ok) {
+        console.error(`Error: ${built.error}`);
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    // Resolve the target: explicit arg > session-bound task.
+    const identifier = identifierArg ?? (await (0, resolve_bound_task_1.resolveBoundTaskIdentifier)(apiUrl, creds.token));
+    if (!identifier) {
+        console.error('Error: no <LUM-N> given and no task bound to this session.\n' +
+            'Pass it explicitly or run `lumo session attach <LUM-N>`.');
+        return 1;
+    }
+    // LUM-N → task id.
+    let taskId;
+    try {
+        const r = await fetch(`${base}/api/tasks/resolve/${encodeURIComponent(identifier)}`, {
+            headers: { Authorization: `Bearer ${creds.token}` },
+        });
+        if (r.status === 401) {
+            console.error('Error: API key invalid or revoked. Run `lumo auth login`.');
+            return 1;
+        }
+        if (r.status === 404) {
+            console.error(`Error: task ${identifier} not found in workspace ${creds.workspaceSlug}`);
+            return 1;
+        }
+        if (!r.ok) {
+            console.error(`Error: resolve failed (HTTP ${r.status})`);
+            return 1;
+        }
+        taskId = (await r.json()).id;
+    }
+    catch (err) {
+        console.error(`Error: could not reach Lumo API at ${apiUrl} (${err instanceof Error ? err.message : String(err)})`);
+        return 1;
+    }
+    // POST the memory.
+    let res;
+    try {
+        res = await fetch(`${base}/api/tasks/${encodeURIComponent(taskId)}/memories`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${creds.token}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ category: built.category, content: built.content }),
+        });
+    }
+    catch (err) {
+        console.error(`Error: could not reach Lumo API at ${apiUrl} (${err instanceof Error ? err.message : String(err)})`);
+        return 1;
+    }
+    if (res.status !== 201) {
+        let m = null;
+        try {
+            const b = (await res.json());
+            if (typeof b.error === 'string')
+                m = b.error;
+        }
+        catch { /* */ }
+        console.error(m ? `Error: ${m}` : `Error: memory add failed (HTTP ${res.status})`);
+        return 1;
+    }
+    process.stdout.write(`Added ${built.category} memory to ${identifier}` +
+        `${identifierArg ? '' : ' (from bound session)'}\n` +
+        'Tip: only useful for this task? If it generalizes, use `lumo project memory add` or `lumo memory promote` later.\n');
+}

package/dist/cli/src/commands/memory-task-list.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryTaskList = memoryTaskList;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const memory_content_1 = require("../lib/memory-content");
+const resolve_bound_task_1 = require("../lib/resolve-bound-task");
+async function memoryTaskList(identifierArg, options) {
+    const limit = options.limit !== undefined ? parseInt(options.limit, 10) : undefined;
+    if (limit !== undefined && (Number.isNaN(limit) || limit < 1)) {
+        console.error(`Error: invalid --limit "${options.limit}" (expected a positive integer)`);
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    const identifier = identifierArg ?? (await (0, resolve_bound_task_1.resolveBoundTaskIdentifier)(apiUrl, creds.token));
+    if (!identifier) {
+        console.error('Error: no <LUM-N> given and no task bound to this session.\nPass it explicitly or run `lumo session attach <LUM-N>`.');
+        return 1;
+    }
+    let taskId;
+    try {
+        const r = await fetch(`${base}/api/tasks/resolve/${encodeURIComponent(identifier)}`, { headers: { Authorization: `Bearer ${creds.token}` } });
+        if (r.status === 404) {
+            console.error(`Error: task ${identifier} not found in workspace ${creds.workspaceSlug}`);
+            return 1;
+        }
+        if (!r.ok) {
+            console.error(`Error: resolve failed (HTTP ${r.status})`);
+            return 1;
+        }
+        taskId = (await r.json()).id;
+    }
+    catch (err) {
+        console.error(`Error: could not reach Lumo API at ${apiUrl} (${err instanceof Error ? err.message : String(err)})`);
+        return 1;
+    }
+    let res;
+    try {
+        res = await fetch(`${base}/api/tasks/${encodeURIComponent(taskId)}/memories`, { headers: { Authorization: `Bearer ${creds.token}` } });
+    }
+    catch (err) {
+        console.error(`Error: could not reach Lumo API at ${apiUrl} (${err instanceof Error ? err.message : String(err)})`);
+        return 1;
+    }
+    if (!res.ok) {
+        console.error(`Error: memory list failed (HTTP ${res.status})`);
+        return 1;
+    }
+    let rows = (await res.json()).memories;
+    if (options.category)
+        rows = rows.filter(m => m.category.toLowerCase() === options.category.toLowerCase());
+    if (limit !== undefined)
+        rows = rows.slice(0, limit);
+    process.stdout.write((0, memory_content_1.formatMemoryList)(rows) + '\n');
+}

package/dist/cli/src/commands/task-artifact-add.js

@@ -4,13 +4,15 @@ exports.taskArtifactAdd = taskArtifactAdd;
 const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const doc_input_1 = require("../lib/doc-input");
+const agent_1 = require("../lib/agent");
 async function taskArtifactAdd(identifier, options) {
     if (!identifier) {
-        console.error('Error: missing <task>. Usage: lumo task artifact add <LUM-42> --kind spec --title "Spec" --file spec.md');
+        console.error('Error: missing <task>. Usage: lumo task artifact add <LUM-42> --kind spec --title "Spec" --file spec.md --source Superpowers');
         return 1;
     }
     const kind = options.kind?.trim();
     const title = options.title?.trim();
+    const source = options.source?.trim();
     if (!kind) {
         console.error('Error: --kind is required and cannot be empty.');
         return 1;
@@ -19,6 +21,20 @@ async function taskArtifactAdd(identifier, options) {
         console.error('Error: --title is required and cannot be empty.');
         return 1;
     }
+    if (!source) {
+        console.error('Error: --source is required (the spec-gen framework, formal name e.g. Superpowers, "Spec Kit", BMad, OpenSpec, GSD).');
+        return 1;
+    }
+    const agentRaw = options.agent?.trim();
+    if (!agentRaw) {
+        console.error(`Error: --agent is required. Valid values: ${agent_1.VALID_AGENT_TOKENS.join(', ')}.`);
+        return 1;
+    }
+    const agent = (0, agent_1.normalizeAgent)(agentRaw);
+    if (!agent) {
+        console.error(`Error: invalid --agent "${agentRaw}". Valid values: ${agent_1.VALID_AGENT_TOKENS.join(', ')}.`);
+        return 1;
+    }
     if (!options.file) {
         console.error('Error: --file <path> is required.');
         return 1;
@@ -43,9 +59,13 @@ async function taskArtifactAdd(identifier, options) {
     const envUrl = process.env.LUMO_API_URL?.trim();
     const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
     const base = (0, api_1.trimTrailingSlash)(apiUrl);
-    const payload = { kind, title, content };
-    if (options.source?.trim())
-        payload.source = options.source.trim();
+    const payload = {
+        kind,
+        title,
+        content,
+        source,
+        agent,
+    };
     let res;
     try {
         res = await fetch(`${base}/api/tasks/${encodeURIComponent(identifier)}/artifacts`, {

package/dist/cli/src/commands/task-artifact-list.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.taskArtifactList = taskArtifactList;
 const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
+const agent_1 = require("../lib/agent");
 async function taskArtifactList(identifier) {
     if (!identifier) {
         console.error('Error: missing <task>. Usage: lumo task artifact list <LUM-42>');
@@ -43,6 +44,7 @@ async function taskArtifactList(identifier) {
         return;
     }
     for (const a of artifacts) {
-        process.stdout.write(`${a.id}  ${a.kind.padEnd(10)}  ${a.source.padEnd(12)}  ${a.title}\n`);
+        const agentLabel = agent_1.AGENT_LABELS[a.agent] ?? a.agent;
+        process.stdout.write(`${a.id}  ${a.kind.padEnd(10)}  ${agentLabel.padEnd(15)}  ${a.source.padEnd(12)}  ${a.title}\n`);
     }
 }

package/dist/cli/src/commands/task-artifact-show.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.taskArtifactShow = taskArtifactShow;
 const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
+const agent_1 = require("../lib/agent");
 async function taskArtifactShow(identifier, artifactId) {
     if (!identifier) {
         console.error('Error: missing <task>. Usage: lumo task artifact show <LUM-42> <artifact-id>');
@@ -55,6 +56,7 @@ async function taskArtifactShow(identifier, artifactId) {
     process.stdout.write(`kind:   ${artifact.kind}\n`);
     process.stdout.write(`title:  ${artifact.title}\n`);
     process.stdout.write(`source: ${artifact.source}\n`);
+    process.stdout.write(`agent:  ${agent_1.AGENT_LABELS[artifact.agent] ?? artifact.agent}\n`);
     process.stdout.write(`order:  ${artifact.order}\n`);
     process.stdout.write(`task:   ${identifier}\n`);
     process.stdout.write(`\n${artifact.content}\n`);

package/dist/cli/src/commands/task-artifact-update.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskArtifactUpdate = taskArtifactUpdate;
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const agent_1 = require("../lib/agent");
+async function taskArtifactUpdate(identifier, artifactId, options) {
+    if (!identifier) {
+        console.error('Error: missing <task>. Usage: lumo task artifact update <LUM-42> <artifact-id> --kind plan');
+        return 1;
+    }
+    if (!artifactId) {
+        console.error('Error: missing <artifact-id>. Usage: lumo task artifact update <LUM-42> <artifact-id> --kind plan');
+        return 1;
+    }
+    const payload = {};
+    const kind = options.kind?.trim();
+    const title = options.title?.trim();
+    const source = options.source?.trim();
+    if (options.kind !== undefined) {
+        if (!kind) {
+            console.error('Error: --kind cannot be empty.');
+            return 1;
+        }
+        payload.kind = kind;
+    }
+    if (options.title !== undefined) {
+        if (!title) {
+            console.error('Error: --title cannot be empty.');
+            return 1;
+        }
+        payload.title = title;
+    }
+    if (options.source !== undefined) {
+        if (!source) {
+            console.error('Error: --source cannot be empty.');
+            return 1;
+        }
+        payload.source = source;
+    }
+    if (options.agent !== undefined) {
+        const agent = (0, agent_1.normalizeAgent)(options.agent);
+        if (!agent) {
+            console.error(`Error: invalid --agent "${options.agent}". Valid values: ${agent_1.VALID_AGENT_TOKENS.join(', ')}.`);
+            return 1;
+        }
+        payload.agent = agent;
+    }
+    if (Object.keys(payload).length === 0) {
+        console.error('Error: provide at least one of --kind, --title, --source, or --agent to update.');
+        return 1;
+    }
+    const creds = (0, config_1.readCredentials)();
+    if (!creds) {
+        console.error('Error: not logged in. Run `lumo auth login` first.');
+        return 1;
+    }
+    const envUrl = process.env.LUMO_API_URL?.trim();
+    const apiUrl = envUrl && envUrl.length > 0 ? envUrl : creds.apiUrl;
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    let res;
+    try {
+        res = await fetch(`${base}/api/tasks/${encodeURIComponent(identifier)}/artifacts/${encodeURIComponent(artifactId)}`, {
+            method: 'PATCH',
+            headers: {
+                Authorization: `Bearer ${creds.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(payload),
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`Error: could not reach Lumo API at ${apiUrl} (${msg})`);
+        return 1;
+    }
+    if (res.status === 401) {
+        console.error('Error: API key invalid or revoked. Run `lumo auth login`.');
+        return 1;
+    }
+    if (res.status === 404) {
+        let serverMsg = `task ${identifier} or artifact ${artifactId} not found in workspace ${creds.workspaceSlug}`;
+        try {
+            const errBody = (await res.json());
+            if (typeof errBody.error === 'string')
+                serverMsg = errBody.error;
+        }
+        catch {
+            /* not JSON */
+        }
+        console.error(`Error: ${serverMsg}`);
+        return 1;
+    }
+    if (res.status !== 200) {
+        let serverMsg = null;
+        try {
+            const errBody = (await res.json());
+            if (typeof errBody.error === 'string')
+                serverMsg = errBody.error;
+        }
+        catch {
+            /* not JSON */
+        }
+        console.error(serverMsg
+            ? `Error: ${serverMsg}`
+            : `Error: artifact update failed (HTTP ${res.status})`);
+        return 1;
+    }
+    const data = (await res.json());
+    process.stdout.write(`Updated [${data.artifact.kind}] "${data.artifact.title}" (${data.artifact.source}) on ${identifier}\n`);
+}

package/dist/cli/src/index.js

@@ -55,10 +55,17 @@ const task_figma_add_1 = require("./commands/task-figma-add");
 const task_figma_list_1 = require("./commands/task-figma-list");
 const task_figma_rm_1 = require("./commands/task-figma-rm");
 const task_figma_refresh_1 = require("./commands/task-figma-refresh");
+const memory_task_list_1 = require("./commands/memory-task-list");
+const memory_task_add_1 = require("./commands/memory-task-add");
+const memory_project_list_1 = require("./commands/memory-project-list");
+const memory_project_add_1 = require("./commands/memory-project-add");
+const memory_promote_1 = require("./commands/memory-promote");
+const memory_rm_1 = require("./commands/memory-rm");
 const task_artifact_add_1 = require("./commands/task-artifact-add");
 const task_artifact_list_1 = require("./commands/task-artifact-list");
 const task_artifact_show_1 = require("./commands/task-artifact-show");
 const task_artifact_rm_1 = require("./commands/task-artifact-rm");
+const task_artifact_update_1 = require("./commands/task-artifact-update");
 const project_list_1 = require("./commands/project-list");
 const milestone_list_1 = require("./commands/milestone-list");
 const milestone_create_1 = require("./commands/milestone-create");
@@ -236,6 +243,33 @@ taskFigma
     .command('refresh <task>')
     .description('Re-fetch Figma metadata + thumbnail for every link on this task. Per-link failures isolated.')
     .action(wrap((taskId) => (0, task_figma_refresh_1.taskFigmaRefresh)({ identifier: taskId })));
+const taskMemory = task
+    .command('memory')
+    .description('View and record memories scoped to a task');
+taskMemory
+    .command('list [task]')
+    .description("List a task's memories. <task> defaults to the session-bound task.")
+    .option('--category <cat>', 'Filter by trap|decision|convention|procedural')
+    .option('-n, --limit <count>', 'Cap output to the first N rows')
+    .action(wrap((taskArg, opts) => (0, memory_task_list_1.memoryTaskList)(taskArg, opts)));
+taskMemory
+    .command('add [task]')
+    .description('Record a memory on a task (<task> defaults to the bound session). ' +
+    'Record only knowledge invisible in the codebase (the why, a runtime gotcha, a non-obvious failure, a non-trivial workflow); skip routine work. ' +
+    'Pick --category then its fields.')
+    .requiredOption('--category <cat>', 'trap | decision | convention | procedural')
+    .option('--trigger <text>', 'trap/procedural: the situation that triggers it')
+    .option('--outcome <text>', 'trap: what goes wrong')
+    .option('--workaround <text>', 'trap: optional fix')
+    .option('--what <text>', 'decision: the decision')
+    .option('--why <text>', 'decision: rationale')
+    .option('--alternatives <text>', 'decision: optional alternatives considered')
+    .option('--implications <text>', 'decision: optional implications')
+    .option('--rule <text>', 'convention: the rule')
+    .option('--applies <text>', 'convention: where the rule applies')
+    .option('--workflow <text>', 'procedural: the workflow name')
+    .option('--step <text>', 'procedural: a step (repeatable)', collect, [])
+    .action(wrap((taskArg, opts) => (0, memory_task_add_1.memoryTaskAdd)(taskArg, opts)));
 const taskArtifact = task
     .command('artifact')
     .description('Record spec-engineering artifacts (spec / plan / design …) on a task');
@@ -245,8 +279,17 @@ taskArtifact
     .requiredOption('--kind <kind>', 'Artifact kind, e.g. spec | plan | design (opaque)')
     .requiredOption('--title <title>', 'Artifact title')
     .requiredOption('--file <path>', 'File whose contents become the artifact body')
-    .option('--source <source>', 'Producer label (default: claude-code)')
+    .requiredOption('--source <source>', 'Spec-gen framework, formal name e.g. Superpowers | "Spec Kit" | BMad | OpenSpec | GSD (opaque; quote names with spaces)')
+    .requiredOption('--agent <agent>', 'Coding tool that produced the artifact: claude-code | codex | cursor | gemini-cli | github-copilot | windsurf')
     .action(wrap((taskId, options) => (0, task_artifact_add_1.taskArtifactAdd)(taskId, options)));
+taskArtifact
+    .command('update <task> <artifact-id>')
+    .description('Update an artifact’s kind / title / source (not content). Provide at least one flag.')
+    .option('--kind <kind>', 'New artifact kind (opaque)')
+    .option('--title <title>', 'New artifact title')
+    .option('--source <source>', 'New spec-gen framework, formal name e.g. Superpowers | "Spec Kit" | BMad | OpenSpec | GSD (quote names with spaces)')
+    .option('--agent <agent>', 'New coding tool: claude-code | codex | cursor | gemini-cli | github-copilot | windsurf')
+    .action(wrap((taskId, artifactId, options) => (0, task_artifact_update_1.taskArtifactUpdate)(taskId, artifactId, options)));
 taskArtifact
     .command('list <task>')
     .description('List artifacts attached to a task, in order')
@@ -267,6 +310,43 @@ projectCmd
     .command('list')
     .description('List projects in the current workspace. Slug column matches `task create --project <ref>`.')
     .action(wrap(() => (0, project_list_1.projectList)()));
+const projectMemory = projectCmd
+    .command('memory')
+    .description('View and record PROJECT-scope memories');
+projectMemory
+    .command('list [project]')
+    .description("List a project's PROJECT-scope memories. <project> defaults to the bound task's project.")
+    .option('--category <cat>', 'Filter by trap|decision|convention|procedural')
+    .option('-n, --limit <count>', 'Cap output to the first N rows')
+    .action(wrap((p, opts) => (0, memory_project_list_1.memoryProjectList)(p, opts)));
+projectMemory
+    .command('add [project]')
+    .description("Record a PROJECT-scope memory. Use PROJECT scope only when the lesson helps any task in the project. <project> defaults to the bound task's project.")
+    .requiredOption('--category <cat>', 'trap | decision | convention | procedural')
+    .option('--trigger <text>', 'trap/procedural trigger')
+    .option('--outcome <text>', 'trap outcome')
+    .option('--workaround <text>', 'trap optional workaround')
+    .option('--what <text>', 'decision')
+    .option('--why <text>', 'decision rationale')
+    .option('--alternatives <text>', 'decision optional alternatives')
+    .option('--implications <text>', 'decision optional implications')
+    .option('--rule <text>', 'convention rule')
+    .option('--applies <text>', 'convention: where it applies')
+    .option('--workflow <text>', 'procedural workflow')
+    .option('--step <text>', 'procedural step (repeatable)', collect, [])
+    .action(wrap((p, opts) => (0, memory_project_add_1.memoryProjectAdd)(p, opts)));
+const memoryCmd = program
+    .command('memory')
+    .description('Operate on a single memory by id (see `lumo task memory` / `lumo project memory` to list/add)');
+memoryCmd
+    .command('promote <memoryId>')
+    .description('Promote a TASK memory to PROJECT scope. Only when the lesson recurs across 2+ tasks.')
+    .action(wrap((id) => (0, memory_promote_1.memoryPromote)(id)));
+memoryCmd
+    .command('rm <memoryId>')
+    .description('Delete a memory (hard delete). Requires --yes.')
+    .option('--yes', 'Confirm deletion')
+    .action(wrap((id, opts) => (0, memory_rm_1.memoryRm)(id, opts)));
 const milestoneCmd = program
     .command('milestone')
     .description('Inspect milestones from the terminal');

package/dist/cli/src/lib/agent.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * CLI-local agent enum support. The CLI talks to the API over HTTP only and
+ * does not depend on @prisma/client, so the enum values + accepted tokens are
+ * mirrored here. Keep in sync with prisma `enum TaskArtifactAgent`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_AGENT_TOKENS = exports.AGENT_LABELS = void 0;
+exports.normalizeAgent = normalizeAgent;
+/** enum value → display label (matches lib/i18n en.json taskArtifact.agent.*) */
+exports.AGENT_LABELS = {
+    CLAUDE_CODE: 'Claude Code',
+    CODEX: 'Codex',
+    CURSOR: 'Cursor',
+    GEMINI_CLI: 'Gemini CLI',
+    GITHUB_COPILOT: 'GitHub Copilot',
+    WINDSURF: 'Windsurf',
+};
+/** accepted CLI token (normalized) → enum value */
+const TOKEN_TO_ENUM = {
+    'claude-code': 'CLAUDE_CODE',
+    codex: 'CODEX',
+    cursor: 'CURSOR',
+    'gemini-cli': 'GEMINI_CLI',
+    gemini: 'GEMINI_CLI',
+    'github-copilot': 'GITHUB_COPILOT',
+    copilot: 'GITHUB_COPILOT',
+    windsurf: 'WINDSURF',
+};
+/** Canonical tokens shown in error/usage hints (aliases omitted). */
+exports.VALID_AGENT_TOKENS = [
+    'claude-code',
+    'codex',
+    'cursor',
+    'gemini-cli',
+    'github-copilot',
+    'windsurf',
+];
+/**
+ * Normalize a user-supplied agent string to its enum value, or null if
+ * unknown. Case-insensitive; spaces and underscores are treated as hyphens.
+ */
+function normalizeAgent(input) {
+    const key = input
+        .trim()
+        .toLowerCase()
+        .replace(/[\s_]+/g, '-');
+    return TOKEN_TO_ENUM[key] ?? null;
+}

package/dist/cli/src/lib/memory-content.js

@@ -0,0 +1,87 @@
+"use strict";
+// Category/field metadata + builders for the `lumo memory` commands.
+// Mirrors the four content shapes validated server-side by parseMemoryContent.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMemoryContent = buildMemoryContent;
+exports.formatMemoryList = formatMemoryList;
+const trimmed = (v) => (v ?? '').trim();
+/**
+ * Validate the per-category flags and assemble { category, content }. Required
+ * fields must be non-empty; optional string fields are dropped when blank;
+ * `--applies` maps to convention `content.scope`; repeated `--step` becomes a
+ * trimmed, empty-filtered `steps` array (omitted when empty).
+ */
+function buildMemoryContent(category, flags) {
+    const cat = category?.toLowerCase();
+    switch (cat) {
+        case 'trap': {
+            const trigger = trimmed(flags.trigger);
+            const outcome = trimmed(flags.outcome);
+            const workaround = trimmed(flags.workaround);
+            if (!trigger)
+                return { ok: false, error: '--trigger is required for category trap.' };
+            if (!outcome)
+                return { ok: false, error: '--outcome is required for category trap.' };
+            return { ok: true, category: 'TRAP', content: { trigger, outcome, ...(workaround ? { workaround } : {}) } };
+        }
+        case 'decision': {
+            const what = trimmed(flags.what);
+            const why = trimmed(flags.why);
+            const alternatives = trimmed(flags.alternatives);
+            const implications = trimmed(flags.implications);
+            if (!what)
+                return { ok: false, error: '--what is required for category decision.' };
+            if (!why)
+                return { ok: false, error: '--why is required for category decision.' };
+            return {
+                ok: true,
+                category: 'DECISION',
+                content: { what, why, ...(alternatives ? { alternatives } : {}), ...(implications ? { implications } : {}) },
+            };
+        }
+        case 'convention': {
+            const rule = trimmed(flags.rule);
+            const applies = trimmed(flags.applies);
+            if (!rule)
+                return { ok: false, error: '--rule is required for category convention.' };
+            if (!applies)
+                return { ok: false, error: '--applies is required for category convention (where the rule applies).' };
+            return { ok: true, category: 'CONVENTION', content: { rule, scope: applies } };
+        }
+        case 'procedural': {
+            const workflow = trimmed(flags.workflow);
+            const trigger = trimmed(flags.trigger);
+            const steps = (flags.step ?? []).map(s => s.trim()).filter(Boolean);
+            if (!workflow)
+                return { ok: false, error: '--workflow is required for category procedural.' };
+            if (!trigger)
+                return { ok: false, error: '--trigger is required for category procedural.' };
+            return { ok: true, category: 'PROCEDURAL', content: { workflow, trigger, ...(steps.length ? { steps } : {}) } };
+        }
+        default:
+            return { ok: false, error: `Unknown --category "${category}". Use trap | decision | convention | procedural.` };
+    }
+}
+function headline(category, content) {
+    const c = (content ?? {});
+    const key = category === 'TRAP' ? 'trigger'
+        : category === 'DECISION' ? 'what'
+            : category === 'CONVENTION' ? 'rule'
+                : 'workflow';
+    const v = c[key];
+    return typeof v === 'string' && v.length > 0 ? v : '(unparseable)';
+}
+/** Fixed-width rows: id  SCOPE  CATEGORY  headline  source(auto|manual). */
+function formatMemoryList(rows) {
+    if (rows.length === 0)
+        return 'No memories.';
+    const idW = Math.max(...rows.map(r => r.id.length));
+    const scopeW = Math.max(...rows.map(r => r.scope.length));
+    const catW = Math.max(...rows.map(r => r.category.length));
+    return rows
+        .map(r => {
+        const src = r.createdByMemberId ? 'manual' : 'auto';
+        return `${r.id.padEnd(idW)}  ${r.scope.padEnd(scopeW)}  ${r.category.padEnd(catW)}  ${headline(r.category, r.content)}  ${src}`;
+    })
+        .join('\n');
+}

package/dist/cli/src/lib/resolve-bound-task.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBoundTaskIdentifier = resolveBoundTaskIdentifier;
+const api_1 = require("./api");
+/**
+ * The task identifier (LUM-N) the current Claude Code session is bound to, or
+ * null when there is no session env, no server-side session row, or no binding.
+ * Used by the memory commands to default their target to the bound task.
+ */
+async function resolveBoundTaskIdentifier(apiUrl, token) {
+    const sessionId = process.env.CLAUDE_CODE_SESSION_ID;
+    if (!sessionId)
+        return null;
+    const url = `${(0, api_1.trimTrailingSlash)(apiUrl)}/api/sessions/${encodeURIComponent(sessionId)}`;
+    let res;
+    try {
+        res = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+    }
+    catch {
+        return null;
+    }
+    if (!res.ok)
+        return null;
+    try {
+        const data = (await res.json());
+        return data.taskIdentifier ?? null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/cli/src/lib/resolve-project.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBoundProjectId = resolveBoundProjectId;
+const api_1 = require("./api");
+/** Resolve the project id of the task bound to this session (via its identifier). */
+async function resolveBoundProjectId(apiUrl, token, boundIdentifier) {
+    const base = (0, api_1.trimTrailingSlash)(apiUrl);
+    let res;
+    try {
+        res = await fetch(`${base}/api/tasks/by-identifier/${encodeURIComponent(boundIdentifier)}`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+    }
+    catch (err) {
+        return { ok: false, error: `could not reach Lumo API (${err instanceof Error ? err.message : String(err)})` };
+    }
+    if (!res.ok)
+        return { ok: false, error: `could not resolve bound task ${boundIdentifier} (HTTP ${res.status})` };
+    const { task } = (await res.json());
+    const id = task.project?.id;
+    if (!id)
+        return { ok: false, error: `bound task ${boundIdentifier} has no resolvable project` };
+    return { ok: true, id };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumoai/cli",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Lumo CLI — manage tasks and sessions from the terminal",
   "license": "MIT",
   "author": "cli@uselumo.ai",