teamai-cli 0.24.0-beta.4 → 0.24.0-beta.6

package/CHANGELOG.md

@@ -17,6 +17,7 @@ All notable changes to this project will be documented in this file. See [standa
 ### 📝 Documentation
 
 - Align the public usage guides, drop internal-only details, and cover the missing commands and configuration ([#442](https://github.com/Tencent/teamai-cli/pull/442)).
+- Document `teamai projects` in the bilingual READMEs as the lead distribution control, including learnings isolation ([#490](https://github.com/Tencent/teamai-cli/pull/490), for [#487](https://github.com/Tencent/teamai-cli/issues/487)).
 
 ## [0.23.0](https://github.com/Tencent/teamai-cli/compare/v0.22.0...v0.23.0) (2026-09-08)
 

package/README.md

@@ -103,10 +103,13 @@ Team-wide settings an admin configures once and delivers to every member on `tea
 
 | Capability | Command | What it does |
 |------------|---------|--------------|
+| **Projects** | `teamai projects` | Bind a working directory to one or more logical projects so it syncs that project's skills, knowledge, and isolated learnings. Orthogonal to roles. |
 | **Roles** | `teamai roles` | Define role → namespace mappings so each member syncs only the skills for their role. |
 | **Tags** | `teamai tags` | Tag skills / rules so members subscribe to just the tags they need. |
 | **Sources** | `teamai source` | Subscribe to additional skill repos — other teams' public repos, or shared/public repos within your own org; subscribed skills sync automatically on pull. |
 
+Learnings isolation: `learnings/` at the repo root is shared with everyone; `learnings/<project-id>/` is project-private. See the [usage guide](docs/usage-guide.md#multi-project-project-as-a-dimension-orthogonal-to-role).
+
 ## Team Execution
 
 > One Team. One Harness. Every Agent.
@@ -191,6 +194,7 @@ Matched: conflict | Missing: port
 teamai import --from-repo https://github.com/org/repo
 teamai import --from-org myorg              # batch import all repos
 teamai codebase --extract /path/to/repo     # local extract into teamwiki/
+teamai codebase --deep-enrich --project my-service --output /path/to/repo # generate deep knowledge docs
 teamai codebase --reconcile --output /path/to/repo # map product docs to code pages
 teamai codebase --lint --output /path/to/repo # check the locally extracted graph
 ```
@@ -236,7 +240,7 @@ Insight into how the team actually uses its AI tools, and a starting point for t
 | `teamai pull` | Pull team resources and inject into local AI tools |
 | `teamai push` | Push local resources to a branch and open a Merge Request |
 | `teamai packages [install] [target]` | Install declared npm packages and Claude plugins; with a target, also update `teamai.yaml`. Bare `teamai packages` installs everything; `teamai packages install <target>` adds one |
-| `teamai status` | Show local vs team repo diff |
+| `teamai status` | Show local vs team repo diff and resource counts, including namespaced skills and nested docs |
 | `teamai contribute` | Share session experience to team repo |
 | `teamai recall <query>` | Search the team knowledge base (BM25 + graph-boost) |
 | `teamai recall enable/disable/status` | Toggle or check recall state |
@@ -244,10 +248,12 @@ Insight into how the team actually uses its AI tools, and a starting point for t
 | `teamai recall maintenance` | Maintain knowledge base health: prune low-confidence learnings, writeback confidence scores, flag stale entries |
 | `teamai import` | Import knowledge (`--dir`, `--from-repo`, `--from-org`, `--from-repo-list`, `--from-mr`) |
 | `teamai codebase --extract [path]` | Extract code facts and build the local graph under `teamwiki/` |
+| `teamai codebase --deep-enrich` | Generate deep knowledge docs from extracted evidence |
 | `teamai codebase --reconcile` | Reconcile product documentation with extracted code knowledge |
 | `teamai codebase --lint` | Knowledge graph health check |
 | `teamai ci extract-mr --url <url>` | CI: extract knowledge from MR, post comments, write after merge |
 | `teamai members` | List team members |
+| `teamai projects` | Bind a working directory to one or more logical projects |
 | `teamai roles` | Manage team roles and namespaces |
 | `teamai tags` | Manage tag-based skill/rule filtering |
 | `teamai skill exclude add/remove/list` | Manage skills excluded from local sync ([usage guide](docs/usage-guide.md#excluding-skills-you-dont-need)) |

package/README.zh-CN.md

@@ -103,10 +103,13 @@ teamai init https://github.com/yourorg/yourrepo --scope user
 
 | 能力 | 命令 | 作用 |
 |------|------|------|
+| **项目（Projects）** | `teamai projects` | 将工作目录绑定到一个或多个逻辑项目，使其同步该项目的 skills、knowledge 以及隔离的 learnings。与角色正交。 |
 | **角色（Roles）** | `teamai roles` | 定义「角色 → 命名空间」映射，让每位成员只同步与自身角色匹配的 skills。 |
 | **标签（Tags）** | `teamai tags` | 给 skills / rules 打标签，成员只订阅自己需要的标签。 |
 | **订阅源（Sources）** | `teamai source` | 订阅额外的 skill 仓库——其他团队的公开仓库，或本团队内的公共/共享仓库；已订阅的 skills 会在 pull 时自动同步。 |
 
+learnings 隔离：仓库 `learnings/` 根目录对所有人共享；`learnings/<project-id>/` 为项目私有。详见[使用指南](docs/usage-guide.zh-CN.md#多项目project-作为与-role-正交的维度)。
+
 ## Team Execution
 
 > One Team. One Harness. Every Agent.
@@ -191,6 +194,7 @@ Matched: conflict | Missing: port
 teamai import --from-repo https://github.com/org/repo
 teamai import --from-org myorg              # 批量导入所有仓库
 teamai codebase --extract /path/to/repo     # 本地提取到 teamwiki/
+teamai codebase --deep-enrich --project my-service --output /path/to/repo # 从提取结果生成深度知识文档
 teamai codebase --reconcile --output /path/to/repo # 将产品文档映射到代码页面
 teamai codebase --lint --output /path/to/repo # 检查本地提取的图谱
 ```
@@ -236,7 +240,7 @@ teamai recall maintenance --update-quality       # 为过时 skills / docs 生
 | `teamai pull` | 拉取团队资源并注入到本地 AI 工具 |
 | `teamai push` | 推送本地资源到分支并创建合并请求 |
 | `teamai packages [install] [target]` | 安装团队 npm 包和 Claude 插件。裸 `teamai packages` 安装全部；`teamai packages install <target>` 添加单个并更新声明 |
-| `teamai status` | 显示本地与团队仓库的差异 |
+| `teamai status` | 显示本地与团队仓库的差异及资源数量，包含 namespace 下的技能和子目录中的文档 |
 | `teamai contribute` | 将 session 经验分享到团队仓库 |
 | `teamai recall <query>` | 搜索团队知识库（BM25 + 图谱增强） |
 | `teamai recall enable/disable/status` | 开关或查看 recall 状态 |
@@ -244,10 +248,12 @@ teamai recall maintenance --update-quality       # 为过时 skills / docs 生
 | `teamai recall maintenance` | 维护知识库健康：清理低置信度 learnings、回写置信度、标记过时条目 |
 | `teamai import` | 导入知识（`--dir`、`--from-repo`、`--from-org`、`--from-repo-list`、`--from-mr`） |
 | `teamai codebase --extract [path]` | 提取代码事实并在 `teamwiki/` 下构建本地图谱 |
+| `teamai codebase --deep-enrich` | 从已提取的 evidence 生成深度知识文档 |
 | `teamai codebase --reconcile` | 将产品文档与提取的代码知识进行对账 |
 | `teamai codebase --lint` | 知识图谱健康检查 |
 | `teamai ci extract-mr --url <url>` | CI：从 MR 提取知识、发评论、合并后写入 |
 | `teamai members` | 查看团队成员 |
+| `teamai projects` | 将工作目录绑定到一个或多个逻辑项目 |
 | `teamai roles` | 管理团队角色和命名空间 |
 | `teamai tags` | 管理基于标签的 skill/rule 过滤 |
 | `teamai skill exclude add/remove/list` | 管理不参与本地同步的 skills（[使用指南](docs/usage-guide.zh-CN.md#排除个人不需要的-skill)） |

package/dist/index.js

@@ -453,7 +453,6 @@ __export(types_exports, {
   CONTRIBUTE_LOW_QUALITY_BONUS: () => CONTRIBUTE_LOW_QUALITY_BONUS,
   CONTRIBUTE_LOW_QUALITY_THRESHOLD: () => CONTRIBUTE_LOW_QUALITY_THRESHOLD,
   CONTRIBUTE_REJECT_WEIGHT: () => CONTRIBUTE_REJECT_WEIGHT,
-  CONTRIBUTE_SESSIONS_DIR: () => CONTRIBUTE_SESSIONS_DIR,
   CONTRIBUTE_SKILL_BONUS: () => CONTRIBUTE_SKILL_BONUS,
   CONTRIBUTE_SMART_THRESHOLD: () => CONTRIBUTE_SMART_THRESHOLD,
   CONTRIBUTE_TOOLERROR_TIERS: () => CONTRIBUTE_TOOLERROR_TIERS,
@@ -464,15 +463,12 @@ __export(types_exports, {
   CultureTeamSchema: () => CultureTeamSchema,
   DASHBOARD_COMPACTION_THRESHOLD: () => DASHBOARD_COMPACTION_THRESHOLD,
   DASHBOARD_DEFAULT_PORT: () => DASHBOARD_DEFAULT_PORT,
-  DASHBOARD_EVENTS_DIR: () => DASHBOARD_EVENTS_DIR,
-  DASHBOARD_EVENTS_PATH: () => DASHBOARD_EVENTS_PATH,
   DASHBOARD_IDLE_TIMEOUT_MS: () => DASHBOARD_IDLE_TIMEOUT_MS,
   DASHBOARD_PID_CHECK_INTERVAL_MS: () => DASHBOARD_PID_CHECK_INTERVAL_MS,
   DASHBOARD_STALE_TIMEOUT_MS: () => DASHBOARD_STALE_TIMEOUT_MS,
   DASHBOARD_STOPPED_DISPLAY_MS: () => DASHBOARD_STOPPED_DISPLAY_MS,
   INTERVENTION_SCAN_MAX_BYTES: () => INTERVENTION_SCAN_MAX_BYTES,
   KNOWLEDGE_WORKTREE_DIRNAME: () => KNOWLEDGE_WORKTREE_DIRNAME,
-  LEARNINGS_LOCAL_DIR: () => LEARNINGS_LOCAL_DIR,
   LocalConfigSchema: () => LocalConfigSchema,
   MemberConfigSchema: () => MemberConfigSchema,
   PendingPushItemSchema: () => PendingPushItemSchema,
@@ -481,9 +477,7 @@ __export(types_exports, {
   REPORTS_LOCK_FILENAME: () => REPORTS_LOCK_FILENAME,
   REPORTS_WORKTREE_DIRNAME: () => REPORTS_WORKTREE_DIRNAME,
   RESOURCE_TYPES: () => RESOURCE_TYPES,
-  SEARCH_INDEX_PATH: () => SEARCH_INDEX_PATH,
   SEARCH_INDEX_VERSION: () => SEARCH_INDEX_VERSION,
-  SESSION_LOGS_LOCAL_DIR: () => SESSION_LOGS_LOCAL_DIR,
   SKILL_NAME_REGEX: () => SKILL_NAME_REGEX,
   SOURCE_PULL_TTL_MS: () => SOURCE_PULL_TTL_MS,
   SYNC_LOCK_FILENAME: () => SYNC_LOCK_FILENAME,
@@ -494,32 +488,23 @@ __export(types_exports, {
   TEAMAI_AGENT_HOOK_PREFIX: () => TEAMAI_AGENT_HOOK_PREFIX,
   TEAMAI_CLAUDEMD_END: () => TEAMAI_CLAUDEMD_END,
   TEAMAI_CLAUDEMD_START: () => TEAMAI_CLAUDEMD_START,
-  TEAMAI_CONFIG_PATH: () => TEAMAI_CONFIG_PATH,
   TEAMAI_CULTURE_END: () => TEAMAI_CULTURE_END,
   TEAMAI_CULTURE_START: () => TEAMAI_CULTURE_START,
   TEAMAI_CUSTOM_HOOK_PREFIX: () => TEAMAI_CUSTOM_HOOK_PREFIX,
   TEAMAI_ENV_END: () => TEAMAI_ENV_END,
   TEAMAI_ENV_START: () => TEAMAI_ENV_START,
-  TEAMAI_HOME: () => TEAMAI_HOME,
   TEAMAI_HOOK_DESCRIPTION_PREFIX: () => TEAMAI_HOOK_DESCRIPTION_PREFIX,
-  TEAMAI_KNOWN_SKILLS_PATH: () => TEAMAI_KNOWN_SKILLS_PATH,
-  TEAMAI_PUSHIGNORE_PATH: () => TEAMAI_PUSHIGNORE_PATH,
   TEAMAI_RECALL_RULES_END: () => TEAMAI_RECALL_RULES_END,
   TEAMAI_RECALL_RULES_START: () => TEAMAI_RECALL_RULES_START,
   TEAMAI_RULES_END: () => TEAMAI_RULES_END,
   TEAMAI_RULES_START: () => TEAMAI_RULES_START,
   TEAMAI_SOURCES_DIR: () => TEAMAI_SOURCES_DIR,
-  TEAMAI_STATE_PATH: () => TEAMAI_STATE_PATH,
-  TEAMAI_TOKEN_PATH: () => TEAMAI_TOKEN_PATH,
-  TEAMAI_UPDATE_LOCK_PATH: () => TEAMAI_UPDATE_LOCK_PATH,
-  TEAMAI_USAGE_PATH: () => TEAMAI_USAGE_PATH,
   TRANSCRIPT_INTERRUPT_PREFIX: () => TRANSCRIPT_INTERRUPT_PREFIX,
   TRANSCRIPT_REJECT_MARKERS: () => TRANSCRIPT_REJECT_MARKERS,
   TRANSCRIPT_SYSTEM_PREFIXES: () => TRANSCRIPT_SYSTEM_PREFIXES,
   TeamaiConfigSchema: () => TeamaiConfigSchema,
   ToolPathsSchema: () => ToolPathsSchema,
   UsageEventSchema: () => UsageEventSchema,
-  VOTES_LOCAL_DIR: () => VOTES_LOCAL_DIR,
   addTokenUsage: () => addTokenUsage,
   areTeamHooksDisabled: () => areTeamHooksDisabled,
   emptyTokenUsage: () => emptyTokenUsage,
@@ -533,8 +518,17 @@ __export(types_exports, {
   getPushignorePath: () => getPushignorePath,
   getRecallSharing: () => getRecallSharing,
   getReportsDir: () => getReportsDir,
+  getSessionLogsDir: () => getSessionLogsDir,
   getStatePath: () => getStatePath,
   getTeamaiHome: () => getTeamaiHome,
+  getTeamaiHomeDir: () => getTeamaiHomeDir,
+  getTokenPath: () => getTokenPath,
+  getUpdateLockPath: () => getUpdateLockPath,
+  getUserConfigPath: () => getUserConfigPath,
+  getUserLearningsDir: () => getUserLearningsDir,
+  getUserSearchIndexPath: () => getUserSearchIndexPath,
+  getUserStatePath: () => getUserStatePath,
+  getUserVotesDir: () => getUserVotesDir,
   isAgentDisabled: () => isAgentDisabled,
   isContributeHintEnabled: () => isContributeHintEnabled,
   isRecallEnabled: () => isRecallEnabled,
@@ -599,6 +593,24 @@ function managedMcpManifestPath(dataHome, workspaceRoot) {
 function legacyManagedMcpManifestPath(dataHome) {
   return path3.join(dataHome, "managed-mcp.json");
 }
+function getTeamaiHomeDir() {
+  return path3.join(getUserHome(), ".teamai");
+}
+function getUserConfigPath() {
+  return path3.join(getTeamaiHomeDir(), "config.yaml");
+}
+function getUserStatePath() {
+  return path3.join(getTeamaiHomeDir(), "state.json");
+}
+function getTokenPath() {
+  return path3.join(getTeamaiHomeDir(), "token");
+}
+function getUpdateLockPath() {
+  return path3.join(getTeamaiHomeDir(), ".update-lock");
+}
+function getSessionLogsDir() {
+  return path3.join(getTeamaiHomeDir(), "session-logs");
+}
 function emptyTokenUsage() {
   return { input: 0, output: 0, cacheRead: 0, cacheCreation: 0 };
 }
@@ -614,6 +626,15 @@ function addTokenUsage(a, b) {
     cacheCreation: (a?.cacheCreation ?? 0) + (b?.cacheCreation ?? 0)
   };
 }
+function getUserLearningsDir() {
+  return path3.join(getTeamaiHomeDir(), "learnings");
+}
+function getUserSearchIndexPath() {
+  return path3.join(getTeamaiHomeDir(), "search-index.json");
+}
+function getUserVotesDir() {
+  return path3.join(getTeamaiHomeDir(), "votes");
+}
 function resolveBaseDir(localConfig) {
   if (localConfig.scope === "project") {
     if (!localConfig.projectRoot) {
@@ -711,7 +732,7 @@ function getPushignorePath() {
 function areTeamHooksDisabled() {
   return process.env.TEAMAI_HOOKS_DISABLED === "1" || process.env.TEAMAI_HOOKS_DISABLED === "true";
 }
-var ToolPathsSchema, ScopeEnum, SharingConfigSchema, SourceConfigSchema, SOURCE_PULL_TTL_MS, TEAMAI_SOURCES_DIR, TeamaiConfigSchema, MemberConfigSchema, LocalConfigSchema, PendingPushItemSchema, PendingPushSchema, StateSchema, TEAMAI_HOME, TEAMAI_CONFIG_PATH, TEAMAI_STATE_PATH, TEAMAI_TOKEN_PATH, TEAMAI_UPDATE_LOCK_PATH, RESOURCE_TYPES, TEAMAI_RULES_START, TEAMAI_RULES_END, TEAMAI_HOOK_DESCRIPTION_PREFIX, TEAMAI_CUSTOM_HOOK_PREFIX, TEAMAI_AGENT_HOOK_PREFIX, TEAMAI_ENV_START, TEAMAI_ENV_END, TEAMAI_CULTURE_START, TEAMAI_CULTURE_END, TEAMAI_CLAUDEMD_START, TEAMAI_CLAUDEMD_END, TEAMAI_RECALL_RULES_START, TEAMAI_RECALL_RULES_END, SKILL_NAME_REGEX, TEAMAI_USAGE_PATH, TEAMAI_KNOWN_SKILLS_PATH, TEAMAI_PUSHIGNORE_PATH, SESSION_LOGS_LOCAL_DIR, UsageEventSchema, DASHBOARD_EVENTS_DIR, DASHBOARD_EVENTS_PATH, DASHBOARD_DEFAULT_PORT, DASHBOARD_IDLE_TIMEOUT_MS, DASHBOARD_STALE_TIMEOUT_MS, DASHBOARD_COMPACTION_THRESHOLD, DASHBOARD_STOPPED_DISPLAY_MS, DASHBOARD_PID_CHECK_INTERVAL_MS, CORRECTION_WINDOW_MS, CORRECTION_KEYWORDS, INTERVENTION_SCAN_MAX_BYTES, TRANSCRIPT_INTERRUPT_PREFIX, TRANSCRIPT_SYSTEM_PREFIXES, TRANSCRIPT_REJECT_MARKERS, CONTRIBUTE_BASE_THRESHOLD, CONTRIBUTE_SMART_THRESHOLD, CONTRIBUTE_INTERRUPT_WEIGHT, CONTRIBUTE_REJECT_WEIGHT, CONTRIBUTE_CORRECTION_WEIGHT, CONTRIBUTE_TOOLERROR_TIERS, CONTRIBUTE_SKILL_BONUS, CONTRIBUTE_DIVERSITY_BONUS_MAX, CONTRIBUTE_FASTPATH_TTL_MS, CONTRIBUTE_KNOWLEDGE_GAP_BONUS, CONTRIBUTE_LOW_QUALITY_BONUS, CONTRIBUTE_LOW_QUALITY_THRESHOLD, CONTRIBUTE_GIT_COMMIT_DOWNWEIGHT, CONTRIBUTE_SESSIONS_DIR, SEARCH_INDEX_VERSION, LEARNINGS_LOCAL_DIR, SEARCH_INDEX_PATH, VOTES_LOCAL_DIR, CultureCompanySchema, CultureTeamSchema, CultureFrontmatterSchema, REPORTS_BRANCH, REPORTS_WORKTREE_DIRNAME, KNOWLEDGE_WORKTREE_DIRNAME, REPORTS_LOCK_FILENAME, BOOTSTRAP_LOCK_FILENAME, SYNC_LOCK_FILENAME;
+var ToolPathsSchema, ScopeEnum, SharingConfigSchema, SourceConfigSchema, SOURCE_PULL_TTL_MS, TEAMAI_SOURCES_DIR, TeamaiConfigSchema, MemberConfigSchema, LocalConfigSchema, PendingPushItemSchema, PendingPushSchema, StateSchema, RESOURCE_TYPES, TEAMAI_RULES_START, TEAMAI_RULES_END, TEAMAI_HOOK_DESCRIPTION_PREFIX, TEAMAI_CUSTOM_HOOK_PREFIX, TEAMAI_AGENT_HOOK_PREFIX, TEAMAI_ENV_START, TEAMAI_ENV_END, TEAMAI_CULTURE_START, TEAMAI_CULTURE_END, TEAMAI_CLAUDEMD_START, TEAMAI_CLAUDEMD_END, TEAMAI_RECALL_RULES_START, TEAMAI_RECALL_RULES_END, SKILL_NAME_REGEX, UsageEventSchema, DASHBOARD_DEFAULT_PORT, DASHBOARD_IDLE_TIMEOUT_MS, DASHBOARD_STALE_TIMEOUT_MS, DASHBOARD_COMPACTION_THRESHOLD, DASHBOARD_STOPPED_DISPLAY_MS, DASHBOARD_PID_CHECK_INTERVAL_MS, CORRECTION_WINDOW_MS, CORRECTION_KEYWORDS, INTERVENTION_SCAN_MAX_BYTES, TRANSCRIPT_INTERRUPT_PREFIX, TRANSCRIPT_SYSTEM_PREFIXES, TRANSCRIPT_REJECT_MARKERS, CONTRIBUTE_BASE_THRESHOLD, CONTRIBUTE_SMART_THRESHOLD, CONTRIBUTE_INTERRUPT_WEIGHT, CONTRIBUTE_REJECT_WEIGHT, CONTRIBUTE_CORRECTION_WEIGHT, CONTRIBUTE_TOOLERROR_TIERS, CONTRIBUTE_SKILL_BONUS, CONTRIBUTE_DIVERSITY_BONUS_MAX, CONTRIBUTE_FASTPATH_TTL_MS, CONTRIBUTE_KNOWLEDGE_GAP_BONUS, CONTRIBUTE_LOW_QUALITY_BONUS, CONTRIBUTE_LOW_QUALITY_THRESHOLD, CONTRIBUTE_GIT_COMMIT_DOWNWEIGHT, SEARCH_INDEX_VERSION, CultureCompanySchema, CultureTeamSchema, CultureFrontmatterSchema, REPORTS_BRANCH, REPORTS_WORKTREE_DIRNAME, KNOWLEDGE_WORKTREE_DIRNAME, REPORTS_LOCK_FILENAME, BOOTSTRAP_LOCK_FILENAME, SYNC_LOCK_FILENAME;
 var init_types = __esm({
   "src/types.ts"() {
     "use strict";
@@ -879,7 +900,7 @@ var init_types = __esm({
         // .zcode/config.json (a different key), which the Claude writer cannot
         // emit — so no mcpProject. ZCode has no user-level rules dir convention.
         zcode: { skills: ".zcode/skills", agents: ".zcode/agents", settings: ".zcode/cli/config.json", mcp: ".agents/mcp.json" },
-        codebuddy: { skills: ".codebuddy/skills", rules: ".codebuddy/rules", settings: ".codebuddy/settings.json", claudemd: ".codebuddy/CODEBUDDY.md", agents: ".codebuddy/agents", mcp: ".codebuddy/mcp.json", mcpProject: ".codebuddy/mcp.json" },
+        codebuddy: { skills: ".codebuddy/skills", rules: ".codebuddy/rules", settings: ".codebuddy/settings.json", claudemd: ".codebuddy/CODEBUDDY.md", agents: ".codebuddy/agents", mcp: ".codebuddy/mcp.json", mcpProject: ".mcp.json" },
         openclaw: { skills: ".openclaw/skills", rules: ".openclaw/rules", claudemd: ".openclaw/workspace/AGENTS.md" },
         hermes: { skills: ".hermes/skills", claudemd: "AGENTS.md" },
         // DeepSeek Harness: skills synced to ~/.dsh/skills, which its skill-filesystem
@@ -1022,11 +1043,6 @@ var init_types = __esm({
       lastUpdateCheck: z.string().nullable().default(null),
       availableUpdate: z.string().nullable().default(null)
     });
-    TEAMAI_HOME = path3.join(getUserHome(), ".teamai");
-    TEAMAI_CONFIG_PATH = path3.join(TEAMAI_HOME, "config.yaml");
-    TEAMAI_STATE_PATH = path3.join(TEAMAI_HOME, "state.json");
-    TEAMAI_TOKEN_PATH = path3.join(TEAMAI_HOME, "token");
-    TEAMAI_UPDATE_LOCK_PATH = path3.join(TEAMAI_HOME, ".update-lock");
     RESOURCE_TYPES = ["skills", "rules", "docs", "env", "agents", "hooks", "mcp"];
     TEAMAI_RULES_START = "<!-- [teamai:rules:start] -->";
     TEAMAI_RULES_END = "<!-- [teamai:rules:end] -->";
@@ -1042,17 +1058,11 @@ var init_types = __esm({
     TEAMAI_RECALL_RULES_START = "<!-- [teamai:recall-rules:start] -->";
     TEAMAI_RECALL_RULES_END = "<!-- [teamai:recall-rules:end] -->";
     SKILL_NAME_REGEX = /^[a-zA-Z0-9_\-:.]{1,200}$/;
-    TEAMAI_USAGE_PATH = `${TEAMAI_HOME}/usage.jsonl`;
-    TEAMAI_KNOWN_SKILLS_PATH = `${TEAMAI_HOME}/known-skills.json`;
-    TEAMAI_PUSHIGNORE_PATH = `${TEAMAI_HOME}/pushignore`;
-    SESSION_LOGS_LOCAL_DIR = `${TEAMAI_HOME}/session-logs`;
     UsageEventSchema = z.object({
       skill: z.string().regex(SKILL_NAME_REGEX),
       timestamp: z.string(),
       tool: z.string()
     });
-    DASHBOARD_EVENTS_DIR = `${TEAMAI_HOME}/dashboard`;
-    DASHBOARD_EVENTS_PATH = `${DASHBOARD_EVENTS_DIR}/events.jsonl`;
     DASHBOARD_DEFAULT_PORT = 3721;
     DASHBOARD_IDLE_TIMEOUT_MS = 5 * 60 * 1e3;
     DASHBOARD_STALE_TIMEOUT_MS = 30 * 60 * 1e3;
@@ -1118,11 +1128,7 @@ var init_types = __esm({
     CONTRIBUTE_LOW_QUALITY_BONUS = 10;
     CONTRIBUTE_LOW_QUALITY_THRESHOLD = 5;
     CONTRIBUTE_GIT_COMMIT_DOWNWEIGHT = 0;
-    CONTRIBUTE_SESSIONS_DIR = `${TEAMAI_HOME}/sessions`;
     SEARCH_INDEX_VERSION = 6;
-    LEARNINGS_LOCAL_DIR = `${TEAMAI_HOME}/learnings`;
-    SEARCH_INDEX_PATH = `${TEAMAI_HOME}/search-index.json`;
-    VOTES_LOCAL_DIR = `${TEAMAI_HOME}/votes`;
     CultureCompanySchema = z.object({
       name: z.string(),
       mission: z.string().optional(),
@@ -3471,6 +3477,12 @@ import { execSync, spawnSync } from "child_process";
 import fs4 from "fs";
 import os2 from "os";
 import path15 from "path";
+function gfInstallDir() {
+  return path15.join(getTeamaiHomeDir(), "gf");
+}
+function gfBinPath() {
+  return path15.join(gfInstallDir(), "gf", "bin", "gf");
+}
 function shellQuote2(s) {
   return "'" + s.replace(/'/g, "'\\''") + "'";
 }
@@ -3500,11 +3512,11 @@ function gfExec(args, options) {
 }
 function getGfPath() {
   try {
-    const stat8 = execSync(`test -x "${GF_BIN_PATH}" && echo ok`, {
+    const stat8 = execSync(`test -x "${gfBinPath()}" && echo ok`, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     });
-    if (stat8.trim() === "ok") return GF_BIN_PATH;
+    if (stat8.trim() === "ok") return gfBinPath();
   } catch {
   }
   try {
@@ -3553,17 +3565,17 @@ async function ensureGfInstalled() {
   const url = getGfDownloadUrl();
   const spin = spinner("Installing gf CLI (\u5DE5\u8702\u547D\u4EE4\u884C\u5DE5\u5177)...").start();
   try {
-    await ensureDir(GF_INSTALL_DIR);
+    await ensureDir(gfInstallDir());
     execSync(
-      `curl -fsSL "${url}" | tar xz -C "${GF_INSTALL_DIR}"`,
+      `curl -fsSL "${url}" | tar xz -C "${gfInstallDir()}"`,
       { stdio: ["pipe", "pipe", "pipe"], timeout: 12e4 }
     );
-    execSync(`test -x "${GF_BIN_PATH}"`, { stdio: ["pipe", "pipe", "pipe"] });
-    spin.succeed(`gf CLI installed to ${GF_INSTALL_DIR}`);
+    execSync(`test -x "${gfBinPath()}"`, { stdio: ["pipe", "pipe", "pipe"] });
+    spin.succeed(`gf CLI installed to ${gfInstallDir()}`);
   } catch (e) {
     spin.fail(`Failed to install gf CLI: ${e.message}`);
     log.info(`You can install it manually from: ${url}`);
-    log.info(`Extract to: ${GF_INSTALL_DIR}`);
+    log.info(`Extract to: ${gfInstallDir()}`);
     throw e;
   }
 }
@@ -3706,7 +3718,7 @@ function gfMrCreate(opts) {
   }
   throw new Error(`gf mr create succeeded but returned unexpected output: ${output}`);
 }
-var GF_INSTALL_DIR, GF_BIN_PATH, GF_DOWNLOAD_BASE, AUTH_CWD, RepoNotFoundError2;
+var GF_DOWNLOAD_BASE, AUTH_CWD, RepoNotFoundError2;
 var init_gf_cli = __esm({
   "src/providers/tgit/gf-cli.ts"() {
     "use strict";
@@ -3714,8 +3726,6 @@ var init_gf_cli = __esm({
     init_logger();
     init_types();
     init_rest_auth();
-    GF_INSTALL_DIR = path15.join(TEAMAI_HOME, "gf");
-    GF_BIN_PATH = path15.join(GF_INSTALL_DIR, "gf", "bin", "gf");
     GF_DOWNLOAD_BASE = "http://mirrors.tencent.com/repository/generic/gongfeng-cli/files/channels/stable";
     AUTH_CWD = os2.tmpdir();
     RepoNotFoundError2 = class extends Error {
@@ -6494,6 +6504,13 @@ var init_roles = __esm({
 });
 
 // src/utils/path-safety.ts
+var path_safety_exports = {};
+__export(path_safety_exports, {
+  assertSafePath: () => assertSafePath,
+  assertSafeResourceName: () => assertSafeResourceName,
+  assertWithinRoot: () => assertWithinRoot,
+  defaultAllowedRoots: () => defaultAllowedRoots
+});
 import os5 from "os";
 import path19 from "path";
 import fs7 from "fs";
@@ -10385,8 +10402,26 @@ async function reconcileClaudeModels(models, manifest) {
   await writeModelJson(profilePath, { env: desired });
   const conflictKeys = /* @__PURE__ */ new Set([
     ...Object.keys(desired),
-    "ANTHROPIC_API_KEY"
+    "ANTHROPIC_API_KEY",
+    "ANTHROPIC_CUSTOM_HEADERS",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL"
   ]);
+  const isManagedValue = (key, value) => previousHashes[key] !== void 0 && entryHash(value) === previousHashes[key] || env[key] !== void 0 && entryHash(value) === entryHash(env[key]);
+  const userOwnsInShell = (key) => {
+    const value = process.env[key];
+    if (typeof value !== "string" || value.trim() === "") return false;
+    return !isManagedValue(key, value);
+  };
+  const shellConflicts = [...conflictKeys].filter(userOwnsInShell);
+  if (shellConflicts.length > 0) {
+    await appendErrorLog({
+      apply_model_config: "skipped claude gateway: user owns conflicting shell env",
+      conflicts: shellConflicts
+    });
+    return;
+  }
   const canManage = [...conflictKeys].every((key) => env[key] === void 0 || previousHashes[key] !== void 0 && entryHash(env[key]) === previousHashes[key]);
   if (!canManage) {
     manifest.claudeEnv = {};
@@ -10950,7 +10985,7 @@ async function initLocalAgentHttp(options) {
   await ensureDir(getLocalAgentHome());
   await saveLocalAgentConfig(config);
   if (options.token) {
-    await writeTokenFile(TEAMAI_TOKEN_PATH, options.token);
+    await writeTokenFile(getTokenPath(), options.token);
   }
   const teamConfig = createLocalAgentTeamConfig(endpoint);
   await injectHooksToAllTools(teamConfig.toolPaths, getUserHome(), options.filterAgents);
@@ -11939,6 +11974,10 @@ var init_skills = __esm({
             }
             dest = path28.join(wsDir, "skills", item.name);
           } else if (tool === "hermes") {
+            if (!await pathExists(getHermesHome())) {
+              log.debug(`Skipping skill sync for ${tool}: tool not installed`);
+              continue;
+            }
             dest = path28.join(getHermesHome(), "skills", item.name);
           } else {
             if (!await ResourceHandler.isToolInstalled(toolPath.skills, baseDir)) {
@@ -12386,10 +12425,7 @@ var init_docs = __esm({
       }
       async scanTeamForPull(_teamConfig, localConfig) {
         const docsDir = path31.join(localConfig.repo.localPath, "docs");
-        if (!await pathExists(docsDir)) return [];
-        const files = await listFiles(docsDir);
-        const realFiles = files.filter((f) => !f.startsWith("."));
-        if (realFiles.length === 0) return [];
+        if (await this.countDocFiles(docsDir) === 0) return [];
         return [{
           name: "docs",
           type: "docs",
@@ -12398,8 +12434,8 @@ var init_docs = __esm({
         }];
       }
       async countDocFiles(sourcePath) {
-        const files = await listFiles(sourcePath);
-        return files.filter((f) => !f.startsWith(".")).length;
+        const files = await listFilesRecursive(sourcePath);
+        return files.filter((f) => f.split("/").every((segment) => !segment.startsWith("."))).length;
       }
       async pushItem(_item, _teamConfig, _localConfig) {
       }
@@ -13768,7 +13804,7 @@ async function acquireReclaimSentinel(sentinel, owner) {
   return exclusiveCreate(sentinel, payload);
 }
 async function acquireLock(lockPath) {
-  const resolved = lockPath ?? expandHome(TEAMAI_UPDATE_LOCK_PATH);
+  const resolved = lockPath ?? expandHome(getUpdateLockPath());
   const owner = randomUUID2();
   const payload = JSON.stringify({
     pid: process.pid,
@@ -13807,7 +13843,7 @@ async function acquireLock(lockPath) {
   }
 }
 async function releaseLock(lockPath) {
-  const resolved = lockPath ?? expandHome(TEAMAI_UPDATE_LOCK_PATH);
+  const resolved = lockPath ?? expandHome(getUpdateLockPath());
   const ourOwner = heldLockOwners.get(resolved);
   if (!ourOwner) return;
   try {
@@ -15211,7 +15247,7 @@ async function initHttp(url, options) {
   if (scope === "project") {
     await saveLocalConfigForScope(localConfig, scope, projectRoot);
   } else {
-    await ensureDir(TEAMAI_HOME);
+    await ensureDir(getTeamaiHomeDir());
     await saveLocalConfig(localConfig);
   }
   log.success(`Local config saved to ${teamaiHome}/config.yaml`);
@@ -15950,9 +15986,9 @@ async function init(options) {
       log.debug("Generated .teamai/.gitignore for project scope");
     }
   } else {
-    await ensureDir(TEAMAI_HOME);
+    await ensureDir(getTeamaiHomeDir());
     await saveLocalConfig(localConfig);
-    log.success(`Local config saved to ${TEAMAI_HOME}/config.yaml`);
+    log.success(`Local config saved to ${getTeamaiHomeDir()}/config.yaml`);
   }
   try {
     const state = await loadStateForScope(localConfig);
@@ -17203,6 +17239,23 @@ function projectSlug(anchor) {
 function projectDataHome(anchor) {
   return path46.join(getUserHome(), ".teamai", "projects", projectSlug(anchor));
 }
+function projectsRootDir() {
+  return path46.join(getUserHome(), ".teamai", "projects");
+}
+async function writeAnchorFile(partitionDir, anchor) {
+  await fs17.promises.mkdir(partitionDir, { recursive: true });
+  await fs17.promises.writeFile(path46.join(partitionDir, "anchor"), `${anchor}
+`, "utf-8");
+}
+async function readAnchorFile(partitionDir) {
+  try {
+    const raw = await fs17.promises.readFile(path46.join(partitionDir, "anchor"), "utf-8");
+    const trimmed = raw.trim();
+    return trimmed || null;
+  } catch {
+    return null;
+  }
+}
 var caseInsensitiveCache;
 var init_partition = __esm({
   "src/utils/partition.ts"() {
@@ -17430,7 +17483,7 @@ async function loadTeamConfig(repoPath) {
   }
 }
 async function loadLocalConfig() {
-  const configPath = expandHome(TEAMAI_CONFIG_PATH);
+  const configPath = expandHome(getUserConfigPath());
   const content = await readFileSafe(configPath);
   if (!content) return null;
   try {
@@ -17447,15 +17500,15 @@ function serializeLocalConfig(config) {
   return YAML14.stringify(persisted);
 }
 async function saveLocalConfig(config) {
-  await writeFile(expandHome(TEAMAI_CONFIG_PATH), serializeLocalConfig(config));
+  await writeFile(expandHome(getUserConfigPath()), serializeLocalConfig(config));
 }
 async function loadState() {
-  const raw = await readJson(expandHome(TEAMAI_STATE_PATH));
+  const raw = await readJson(expandHome(getUserStatePath()));
   if (!raw) return StateSchema.parse({});
   return StateSchema.parse(raw);
 }
 async function saveState(state) {
-  await writeJson(expandHome(TEAMAI_STATE_PATH), state);
+  await writeJson(expandHome(getUserStatePath()), state);
 }
 async function requireInit() {
   const localConfig = await loadLocalConfig();
@@ -17488,8 +17541,19 @@ async function loadLocalConfigForScope(scope, projectRoot) {
   }
 }
 async function saveLocalConfigForScope(config, _scope, _projectRoot) {
-  const configPath = path48.join(getDataHome(config), "config.yaml");
+  const dataHome = getDataHome(config);
+  const configPath = path48.join(dataHome, "config.yaml");
   await writeFile(expandHome(configPath), serializeLocalConfig(config));
+  try {
+    if (config.scope === "project" && config.projectRoot) {
+      const partition = await resolveProjectDataHome(config.projectRoot);
+      if (path48.resolve(expandHome(dataHome)) === path48.resolve(partition)) {
+        const anchors = await resolveAnchors(config.projectRoot);
+        if (anchors) await writeAnchorFile(partition, anchors.projectAnchor);
+      }
+    }
+  } catch {
+  }
 }
 async function loadStateForScope(localConfig) {
   const statePath = getStatePath(localConfig);
@@ -18524,8 +18588,7 @@ async function runMigration(plan, opts = {}) {
     await rebaseConfigPaths(path51.join(staging, "config.yaml"), legacyDir, partitionDir);
     await remove(partitionDir);
     await fse10.rename(staging, partitionDir);
-    await writeFile(path51.join(partitionDir, "anchor"), `${anchor}
-`);
+    await writeAnchorFile(partitionDir, anchor);
     await releaseLock(lockPath);
     lockReleased = true;
     const backup = await retireLegacy(legacyDir);
@@ -18956,6 +19019,9 @@ async function mirrorLearnings(sourceDir, destinationDir, activeNamespaces) {
     }
   });
 }
+async function addLearningToCache(sourceFile, destinationDir, relativePath) {
+  await fse11.copy(sourceFile, path54.join(destinationDir, relativePath), { overwrite: true });
+}
 var init_learnings_mirror = __esm({
   "src/utils/learnings-mirror.ts"() {
     "use strict";
@@ -19180,8 +19246,8 @@ async function recallFeedback(opts) {
   const { autoDetectInit: autoDetectInit2 } = await Promise.resolve().then(() => (init_config(), config_exports));
   const { localConfig } = await autoDetectInit2();
   const { username } = localConfig;
-  const { VOTES_LOCAL_DIR: VOTES_LOCAL_DIR2 } = await Promise.resolve().then(() => (init_types(), types_exports));
-  const votePath = path55.join(VOTES_LOCAL_DIR2, `${username}.yaml`);
+  const { getUserVotesDir: getUserVotesDir2 } = await Promise.resolve().then(() => (init_types(), types_exports));
+  const votePath = path55.join(getUserVotesDir2(), `${username}.yaml`);
   if (opts.positive) {
     await incrementUpvoted(votePath, [opts.positive]);
     log.success(`Upvoted: ${opts.positive}`);
@@ -20579,8 +20645,8 @@ function computeDailyStatsDelta(current, reported) {
     const bucket = delta[date] ?? emptyDaily();
     if (!previous) {
       bucket.sessionsEnded += 1;
-      bucket.sessionsSucceeded += snapshot.succeeded;
     }
+    bucket.sessionsSucceeded += snapshot.succeeded - (previous?.succeeded ?? 0);
     bucket.promptTurns += positiveDelta(snapshot.prompts, previous?.prompts);
     bucket.durationMs += positiveDelta(snapshot.durationMs, previous?.durationMs);
     bucket.sessionsCorrected += positiveDelta(snapshot.corrected, previous?.corrected);
@@ -21539,7 +21605,12 @@ async function writeReportedDailySessions(data) {
 }
 function hasDailyDelta(delta) {
   return Object.values(delta).some(
-    (bucket) => bucket.sessionsEnded > 0 || bucket.sessionsSucceeded > 0 || bucket.promptTurns > 0 || bucket.durationMs > 0 || bucket.sessionsCorrected > 0 || bucket.pricedRequests > 0 || bucket.costMicros > 0 || bucket.cacheReadTokens > 0 || bucket.cacheEligibleInputTokens > 0
+    (bucket) => (
+      // sessionsSucceeded can be negative (a resumed session that later failed
+      // claws back an earlier increment), so it must not be checked with the
+      // same "> 0" as the other, purely monotonic counters (#473).
+      bucket.sessionsEnded > 0 || bucket.sessionsSucceeded !== 0 || bucket.promptTurns > 0 || bucket.durationMs > 0 || bucket.sessionsCorrected > 0 || bucket.pricedRequests > 0 || bucket.costMicros > 0 || bucket.cacheReadTokens > 0 || bucket.cacheEligibleInputTokens > 0
+    )
   );
 }
 function filterEventsByScope(events, opts) {
@@ -21640,9 +21711,9 @@ async function reportUsageToTeam(repoPath, username, options) {
       filesToPush.push(`stats/${username}.yaml`);
     }
     try {
-      if (await pathExists(VOTES_LOCAL_DIR)) {
+      if (await pathExists(getUserVotesDir())) {
         const { syncVotesToTeam: syncVotesToTeam2 } = await Promise.resolve().then(() => (init_votes(), votes_exports));
-        const synced = await syncVotesToTeam2(writeRoot, username, VOTES_LOCAL_DIR);
+        const synced = await syncVotesToTeam2(writeRoot, username, getUserVotesDir());
         if (synced) {
           filesToPush.push(`votes/${username}.yaml`);
         }
@@ -22413,13 +22484,13 @@ async function pullForScope(localConfig, options, policy = {}) {
       if (localConfig.scope === "user") {
         await mirrorLearnings(
           learningsRepoDir,
-          LEARNINGS_LOCAL_DIR,
+          getUserLearningsDir(),
           activeLearningsNamespaces
         );
         if (await pathExists(learningsRepoDir)) {
           learningsCount = await countLearnings(learningsRepoDir);
         }
-        effectiveLearningsDir = await pathExists(LEARNINGS_LOCAL_DIR) ? LEARNINGS_LOCAL_DIR : void 0;
+        effectiveLearningsDir = await pathExists(getUserLearningsDir()) ? getUserLearningsDir() : void 0;
       } else {
         effectiveLearningsDir = await pathExists(learningsRepoDir) ? learningsRepoDir : void 0;
         if (effectiveLearningsDir) {
@@ -23165,6 +23236,10 @@ __export(status_exports, {
 import path66 from "path";
 import YAML21 from "yaml";
 async function status(options) {
+  if (options.all) {
+    await statusAll();
+    return;
+  }
   const { localConfig, teamConfig } = await autoDetectInit();
   const scopeLabel = localConfig.scope;
   console.log("");
@@ -23196,13 +23271,10 @@ async function status(options) {
   log.info("Team resources:");
   const repoPath = localConfig.repo.localPath;
   const counts = {};
-  const skillsDirs = await listDirs(path66.join(repoPath, "skills"));
-  counts.skills = skillsDirs.length;
+  counts.skills = (await new SkillsHandler().scanTeamForPull(teamConfig, localConfig)).length;
   const rulesFiles = (await listFilesRecursive(path66.join(repoPath, "rules"))).filter((f) => f.endsWith(".md"));
   counts.rules = rulesFiles.length;
-  const docsExists = await pathExists(path66.join(repoPath, "docs"));
-  const docFiles = docsExists ? (await listFiles(path66.join(repoPath, "docs"))).filter((f) => !f.startsWith(".")) : [];
-  counts.docs = docFiles.length;
+  counts.docs = await new DocsHandler().countDocFiles(path66.join(repoPath, "docs"));
   const envYamlPath = path66.join(repoPath, "env", "env.yaml");
   let envCount = 0;
   if (await pathExists(envYamlPath)) {
@@ -23244,6 +23316,56 @@ async function status(options) {
   }
   console.log("");
 }
+async function statusAll() {
+  const root = projectsRootDir();
+  const slugs = await listDirs(root);
+  console.log("");
+  log.info(`Project data partitions (${root}):`);
+  if (slugs.length === 0) {
+    log.info("  (none \u2014 no project has been initialized or migrated on this machine)");
+    console.log("");
+    return;
+  }
+  let orphanCount = 0;
+  for (const slug of slugs.sort()) {
+    const partitionDir = path66.join(root, slug);
+    const anchor = await readAnchorFile(partitionDir);
+    let projectPath = anchor;
+    let scope;
+    let kind;
+    const cfgRaw = await readFileSafe(path66.join(partitionDir, "config.yaml"));
+    if (cfgRaw) {
+      try {
+        const parsed = LocalConfigSchema.parse(YAML21.parse(cfgRaw));
+        scope = parsed.scope;
+        kind = parsed.repo.kind;
+        if (!projectPath) projectPath = parsed.repo.businessRepoRoot ?? parsed.projectRoot ?? null;
+      } catch {
+      }
+    }
+    let state;
+    if (!anchor) {
+      state = projectPath ? "unknown \u2014 no anchor; cannot confirm orphan (partition may still be active)" : "unknown (no anchor / project path)";
+    } else if (!await pathExists(anchor)) {
+      state = "ORPHAN \u2014 project path is gone, safe to delete";
+      orphanCount++;
+    } else if (projectSlug(anchor) !== slug) {
+      state = "corrupt \u2014 dir name does not match anchor";
+    } else {
+      state = "active";
+    }
+    const kindLabel = kind ? ` ${kind}` : "";
+    log.info(`  ${slug}  [${state}]`);
+    log.info(`    project: ${projectPath ?? "(unresolved)"}${scope ? `  (${scope}${kindLabel})` : ""}`);
+  }
+  console.log("");
+  if (orphanCount > 0) {
+    log.warn(
+      `${orphanCount} orphan partition(s) found. teamai never deletes them automatically; remove one with:  rm -rf "${root}/<slug>"`
+    );
+    console.log("");
+  }
+}
 async function list(type, options) {
   const { localConfig, teamConfig } = await autoDetectInit();
   const repoPath = localConfig.repo.localPath;
@@ -23437,9 +23559,11 @@ var init_status = __esm({
     init_resources();
     init_fs();
     init_skills();
+    init_docs();
     init_known_agents();
     init_agent_skills();
     init_types();
+    init_partition();
     init_env();
     init_mcp();
     init_hooks();
@@ -25855,16 +25979,16 @@ async function saveSession(options) {
   }
   if (options.dryRun) {
     log.info(
-      `[dry-run] Would record session ${sessionId.slice(0, 8)} (${summary.toolTotal} tools, ${summary.interventionCount} interventions, valuable=${summary.valuable}) to ${SESSION_LOGS_LOCAL_DIR}/${monthKey(summary)}.md`
+      `[dry-run] Would record session ${sessionId.slice(0, 8)} (${summary.toolTotal} tools, ${summary.interventionCount} interventions, valuable=${summary.valuable}) to ${getSessionLogsDir()}/${monthKey(summary)}.md`
     );
   } else {
-    const written = await appendMonthlyLog(SESSION_LOGS_LOCAL_DIR, summary, { includePrompt: true });
+    const written = await appendMonthlyLog(getSessionLogsDir(), summary, { includePrompt: true });
     if (written) {
       log.info(`Recorded session to ${written}`);
     } else {
       log.info(`Session ${sessionId.slice(0, 8)} already recorded this month.`);
     }
-    await pruneMonthlyLogs(SESSION_LOGS_LOCAL_DIR, /* @__PURE__ */ new Date()).catch(() => []);
+    await pruneMonthlyLogs(getSessionLogsDir(), /* @__PURE__ */ new Date()).catch(() => []);
   }
   if (!options.push) return;
   if (!summary.valuable && !options.force) {
@@ -26860,46 +26984,78 @@ var ai_client_exports = {};
 __export(ai_client_exports, {
   callClaude: () => callClaude,
   callClaudeParallel: () => callClaudeParallel,
-  getAICliName: () => getAICliName
+  getAICliName: () => getAICliName,
+  pickWindowsCommand: () => pickWindowsCommand,
+  resolveCliPath: () => resolveCliPath
 });
-import { spawn as spawn2, execFileSync as execFileSync2 } from "child_process";
+import { execFileSync as execFileSync2 } from "child_process";
+import spawn2 from "cross-spawn";
 import { existsSync } from "fs";
+function pickWindowsCommand(whereOutput) {
+  const lines = whereOutput.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+  for (const ext of WIN_EXEC_EXTENSIONS) {
+    const hit = lines.find((line) => line.toLowerCase().endsWith(ext));
+    if (hit !== void 0) return hit;
+  }
+  return null;
+}
+function whereOnWindows(cmd) {
+  try {
+    const out = execFileSync2("where", [cmd], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      shell: false,
+      timeout: CLI_DETECT_TIMEOUT_MS
+    });
+    const p = pickWindowsCommand(out);
+    return p !== null && existsSync(p) ? p : null;
+  } catch {
+    return null;
+  }
+}
+function whichOnPosix(cmd) {
+  try {
+    const p = execFileSync2("bash", ["-lc", `command -v ${cmd}`], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      shell: false,
+      timeout: CLI_DETECT_TIMEOUT_MS
+    }).trim();
+    if (p && existsSync(p)) return p;
+  } catch {
+  }
+  try {
+    const p = execFileSync2("zsh", ["-lc", `command -v ${cmd}`], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      shell: false,
+      timeout: CLI_DETECT_TIMEOUT_MS
+    }).trim();
+    if (p && existsSync(p)) return p;
+  } catch {
+  }
+  try {
+    const p = execFileSync2("which", [cmd], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      shell: false,
+      timeout: CLI_DETECT_TIMEOUT_MS
+    }).trim();
+    if (p && existsSync(p)) return p;
+  } catch {
+  }
+  return null;
+}
+function resolveCliPath(cmd, platform = process.platform) {
+  return platform === "win32" ? whereOnWindows(cmd) : whichOnPosix(cmd);
+}
 function detectClaudeCli() {
-  const candidates = ALLOWED_CLI_CANDIDATES;
-  for (const cmd of candidates) {
-    try {
-      const p = execFileSync2("bash", ["-lc", `command -v ${cmd}`], {
-        encoding: "utf8",
-        stdio: ["ignore", "pipe", "ignore"],
-        shell: false,
-        timeout: CLI_DETECT_TIMEOUT_MS
-      }).trim();
-      if (p && existsSync(p)) return { cmd, absPath: p };
-    } catch {
-    }
-    try {
-      const p = execFileSync2("zsh", ["-lc", `command -v ${cmd}`], {
-        encoding: "utf8",
-        stdio: ["ignore", "pipe", "ignore"],
-        shell: false,
-        timeout: CLI_DETECT_TIMEOUT_MS
-      }).trim();
-      if (p && existsSync(p)) return { cmd, absPath: p };
-    } catch {
-    }
-    try {
-      const p = execFileSync2("which", [cmd], {
-        encoding: "utf8",
-        stdio: ["ignore", "pipe", "ignore"],
-        shell: false,
-        timeout: CLI_DETECT_TIMEOUT_MS
-      }).trim();
-      if (p && existsSync(p)) return { cmd, absPath: p };
-    } catch {
-    }
+  for (const cmd of ALLOWED_CLI_CANDIDATES) {
+    const absPath = resolveCliPath(cmd);
+    if (absPath !== null) return { cmd, absPath };
   }
   throw new Error(
-    "AI CLI \u4E0D\u53EF\u7528\uFF1A\u8BF7\u5B89\u88C5\u4EE5\u4E0B\u4EFB\u610F\u4E00\u4E2A CLI \u5DE5\u5177\uFF1Aclaude / claude-internal / codex / codex-internal / codebuddy / workbuddy / openclaw"
+    "AI CLI unavailable: install one of claude / claude-internal / codex / codex-internal / codebuddy / workbuddy / openclaw"
   );
 }
 function buildCliArgs(cmd, prompt) {
@@ -26925,8 +27081,8 @@ async function callClaude(prompt, opts) {
     }
     log.debug(`[ai-client] calling ${_cliInfo.cmd}, timeout=${Math.round(timeoutMs / 1e3)}s, prompt=${prompt.slice(0, 60).replace(/\n/g, " ")}...`);
     const child = spawn2(_cliInfo.absPath, buildCliArgs(_cliInfo.cmd, prompt), { stdio: ["ignore", "pipe", "pipe"] });
-    child.stdout.on("data", (chunk) => chunks.push(chunk));
-    child.stderr.on("data", (chunk) => errChunks.push(chunk));
+    child.stdout?.on("data", (chunk) => chunks.push(chunk));
+    child.stderr?.on("data", (chunk) => errChunks.push(chunk));
     const timer = setTimeout(() => {
       child.kill();
       const seconds = Math.round(timeoutMs / 1e3);
@@ -27007,7 +27163,7 @@ async function runWithConcurrency(tasks, concurrency) {
   await Promise.all(promises);
   return results;
 }
-var ALLOWED_CLI_CANDIDATES, CLI_DETECT_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, DEFAULT_CONCURRENCY, _cliInfo;
+var ALLOWED_CLI_CANDIDATES, CLI_DETECT_TIMEOUT_MS, WIN_EXEC_EXTENSIONS, DEFAULT_TIMEOUT_MS, DEFAULT_CONCURRENCY, _cliInfo;
 var init_ai_client = __esm({
   "src/utils/ai-client.ts"() {
     "use strict";
@@ -27024,6 +27180,7 @@ var init_ai_client = __esm({
       "openclaw"
     ];
     CLI_DETECT_TIMEOUT_MS = 5e3;
+    WIN_EXEC_EXTENSIONS = [".exe", ".cmd", ".bat"];
     DEFAULT_TIMEOUT_MS = 6e5;
     DEFAULT_CONCURRENCY = 3;
   }
@@ -28070,7 +28227,7 @@ async function resolveVizRoot(opts) {
     const reportsRoot = getReportsDir(config);
     const useProjectScope = config.scope === "project" && Boolean(config.projectRoot);
     const teamaiHome2 = useProjectScope ? getDataHome(config) : getTeamaiHome("user");
-    const learningsDir = useProjectScope ? path81.join(knowledgeRoot, "learnings") : LEARNINGS_LOCAL_DIR;
+    const learningsDir = useProjectScope ? path81.join(knowledgeRoot, "learnings") : getUserLearningsDir();
     const source = config.repo.kind === "self" ? { scope: "local", label: "Personal repo \xB7 your recalls only" } : { scope: "team", label: "Team repo \xB7 aggregated across the team" };
     return {
       root: knowledgeRoot,
@@ -28082,14 +28239,14 @@ async function resolveVizRoot(opts) {
       source
     };
   }
-  const teamaiHome = path81.dirname(VOTES_LOCAL_DIR);
+  const teamaiHome = getTeamaiHomeDir();
   return {
     root: teamaiHome,
     knowledgeRoot: teamaiHome,
-    votesDir: VOTES_LOCAL_DIR,
-    learningsDir: LEARNINGS_LOCAL_DIR,
+    votesDir: getUserVotesDir(),
+    learningsDir: getUserLearningsDir(),
     statsDir: path81.join(teamaiHome, "stats"),
-    indexPath: SEARCH_INDEX_PATH,
+    indexPath: getUserSearchIndexPath(),
     source: { scope: "local", label: "Local ~/.teamai \xB7 your recalls only" }
   };
 }
@@ -30048,8 +30205,8 @@ var init_hook_handlers = __esm({
           const { autoDetectInit: autoDetectInit2 } = await Promise.resolve().then(() => (init_config(), config_exports));
           const voteData = await parseTranscriptForVotes2(transcriptPath);
           const { localConfig } = await autoDetectInit2();
-          const { VOTES_LOCAL_DIR: VOTES_LOCAL_DIR2 } = await Promise.resolve().then(() => (init_types(), types_exports));
-          const votesDir = VOTES_LOCAL_DIR2;
+          const { getUserVotesDir: getUserVotesDir2 } = await Promise.resolve().then(() => (init_types(), types_exports));
+          const votesDir = getUserVotesDir2();
           const votePath = path90.join(votesDir, `${localConfig.username}.yaml`);
           const recalledSet = new Set(voteData.recalledDocIds);
           const verifiedDocIds = voteData.referencedDocIds.filter((id) => recalledSet.has(id));
@@ -30323,8 +30480,8 @@ async function rebuildIndexAfterContribute(localConfig) {
     localConfig.projects ?? []
   );
   if (localConfig.scope === "user") {
-    await mirrorLearnings(learningsRepoDir, LEARNINGS_LOCAL_DIR, activeLearningsNamespaces);
-    effectiveLearningsDir = await pathExists(LEARNINGS_LOCAL_DIR) ? LEARNINGS_LOCAL_DIR : void 0;
+    await mirrorLearnings(learningsRepoDir, getUserLearningsDir(), activeLearningsNamespaces);
+    effectiveLearningsDir = await pathExists(getUserLearningsDir()) ? getUserLearningsDir() : void 0;
   } else {
     effectiveLearningsDir = await pathExists(learningsRepoDir) ? learningsRepoDir : void 0;
   }
@@ -30454,12 +30611,11 @@ async function contributeSelf(localConfig, content, options) {
       await fs30.promises.writeFile(destAbs, content, "utf-8");
       try {
         const { pathExists: pathExists3 } = await Promise.resolve().then(() => (init_fs(), fs_exports));
-        const wtLearnings = path91.join(wtRepo, "learnings");
         const activeLearningsNamespaces = await resolveActiveLearningsNamespaces(
           localConfig.repo.localPath,
           localConfig.projects ?? []
         );
-        await mirrorLearnings(wtLearnings, LEARNINGS_LOCAL_DIR, activeLearningsNamespaces);
+        await addLearningToCache(destAbs, getUserLearningsDir(), relPath.slice("learnings/".length));
         const repoPath = localConfig.repo.localPath;
         const docsDir = path91.join(repoPath, "docs");
         const rulesDir = path91.join(repoPath, "rules");
@@ -30474,7 +30630,7 @@ async function contributeSelf(localConfig, content, options) {
         const teamaiHome = getDataHome(localConfig);
         const { buildIndex: buildIndex2 } = await Promise.resolve().then(() => (init_search_index(), search_index_exports));
         await buildIndex2({
-          learningsDir: await pathExists3(LEARNINGS_LOCAL_DIR) ? LEARNINGS_LOCAL_DIR : void 0,
+          learningsDir: await pathExists3(getUserLearningsDir()) ? getUserLearningsDir() : void 0,
           learningsNamespaces: activeLearningsNamespaces,
           docsDir: await pathExists3(docsDir) ? docsDir : void 0,
           rulesDir: await pathExists3(rulesDir) ? rulesDir : void 0,
@@ -36050,6 +36206,9 @@ var init_reconciler_v2_types = __esm({
 // src/wiki-engine/knowledge-reconciler.ts
 import { readFile as readFile9, readdir as readdir3, stat as stat5 } from "fs/promises";
 import path109 from "path";
+function isExpectedSelfLoop(edge) {
+  return edge.from === edge.to && edge.relation === "IMPLEMENTS" && !!edge.source && REPAIRABLE_CODE_EDGE_SOURCES.has(edge.source);
+}
 async function loadReconciliationBase(wikiRoot) {
   const graphPath = path109.join(wikiRoot, ".indices", "graph-index.json");
   const graph = await loadGraphIndex(wikiRoot);
@@ -36061,7 +36220,10 @@ async function loadReconciliationBase(wikiRoot) {
     graph.nodes,
     graph.edges.filter((edge) => edge.source !== BRIDGE_EDGE_SOURCE)
   );
-  if (validateGraph(base).issues.some((issue) => issue.code !== REPAIRABLE_VALIDATION_ISSUE_CODE)) {
+  const hasUnexpectedSelfLoop = base.edges.some((edge) => edge.from === edge.to && !isExpectedSelfLoop(edge));
+  if (hasUnexpectedSelfLoop || validateGraph(base).issues.some(
+    (issue) => issue.code !== REPAIRABLE_VALIDATION_ISSUE_CODE && issue.code !== SELF_LOOP_VALIDATION_ISSUE_CODE
+  )) {
     throw new Error(`Cannot reconcile invalid graph index at ${graphPath}`);
   }
   const nodeSlugs = new Set(base.nodes.map((node) => node.slug));
@@ -36082,7 +36244,7 @@ async function loadReconciliationBase(wikiRoot) {
     }
   }
   const repaired = mergeGraphs(base, createGraphIndex(endpointNodes));
-  if (!validateGraph(repaired).valid) {
+  if (validateGraph(repaired).issues.some((issue) => issue.code !== SELF_LOOP_VALIDATION_ISSUE_CODE)) {
     throw new Error(`Cannot reconcile invalid graph index at ${graphPath}`);
   }
   return repaired;
@@ -36406,7 +36568,7 @@ async function reconcileKnowledge(options) {
     stats
   };
 }
-var BRIDGE_EDGE_SOURCE, PRODUCT_PAGE_TYPE, CODE_PAGE_TYPE, PAGE_CONFIDENCE, PRODUCT_PAGE_DOMAIN, CODE_PAGE_DOMAIN, REPAIRABLE_CODE_EDGE_SOURCES, MISSING_PATH_ERROR_CODE, REPAIRABLE_VALIDATION_ISSUE_CODE;
+var BRIDGE_EDGE_SOURCE, PRODUCT_PAGE_TYPE, CODE_PAGE_TYPE, PAGE_CONFIDENCE, PRODUCT_PAGE_DOMAIN, CODE_PAGE_DOMAIN, REPAIRABLE_CODE_EDGE_SOURCES, MISSING_PATH_ERROR_CODE, REPAIRABLE_VALIDATION_ISSUE_CODE, SELF_LOOP_VALIDATION_ISSUE_CODE;
 var init_knowledge_reconciler = __esm({
   "src/wiki-engine/knowledge-reconciler.ts"() {
     "use strict";
@@ -36421,6 +36583,7 @@ var init_knowledge_reconciler = __esm({
     REPAIRABLE_CODE_EDGE_SOURCES = /* @__PURE__ */ new Set(["code-ast", "code-heuristic"]);
     MISSING_PATH_ERROR_CODE = "ENOENT";
     REPAIRABLE_VALIDATION_ISSUE_CODE = "edge.missing_node";
+    SELF_LOOP_VALIDATION_ISSUE_CODE = "edge.self_loop";
   }
 });
 
@@ -37782,7 +37945,7 @@ var deep_enrich_exports = {};
 __export(deep_enrich_exports, {
   deepEnrich: () => deepEnrich
 });
-import { readFile as readFile11, writeFile as writeFile11, readdir as readdir4, mkdir as mkdir8 } from "fs/promises";
+import { readFile as readFile11, writeFile as writeFile11, readdir as readdir4, mkdir as mkdir8, unlink as unlink2 } from "fs/promises";
 import path113 from "path";
 async function readFileSafe4(filePath) {
   try {
@@ -38239,6 +38402,10 @@ async function runPhaseAiGraph(opts, ctx, docsDir) {
   const g6 = buildG6Content(project, ctx.manifest);
   await writeFile11(path113.join(docsDir, "graph-g6-multihop.md"), g6, "utf-8");
   log.debug(`deep-enrich[${project}]: G6 multi-hop analysis written`);
+  const g5Path = path113.join(docsDir, "graph-g5-scenarios.md");
+  if (await pathExists(g5Path)) {
+    return { g5Generated: true, g6Generated: g6HasEdges };
+  }
   let g5Generated = false;
   if (ctx.moduleDocs.size < 2) {
     log.warn(`deep-enrich[${project}]: Insufficient modules (${ctx.moduleDocs.size} < 2), skipping G5`);
@@ -38317,6 +38484,47 @@ async function runPhaseIndexEnhance(opts, ctx, docsDir, graphFlags) {
   }
   log.debug(`deep-enrich[${project}]: Index incremental update complete`);
 }
+function architectureDocPath(docsDir) {
+  return path113.join(docsDir, "architecture.md");
+}
+async function existingComponentSlugs(docsDir, slugs) {
+  const found = [];
+  for (const slug of slugs) {
+    try {
+      assertSafeResourceName(slug);
+    } catch {
+      continue;
+    }
+    if (await pathExists(path113.join(docsDir, `${slug}.md`))) found.push(slug);
+  }
+  return found;
+}
+async function collectMissingAiDocs(docsDir, slugs) {
+  const existing = new Set(await existingComponentSlugs(docsDir, slugs));
+  return {
+    missingComponents: slugs.filter((slug) => !existing.has(slug)),
+    missingArchitecture: !await pathExists(architectureDocPath(docsDir))
+  };
+}
+async function removeIfExists(filePath) {
+  try {
+    await unlink2(filePath);
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err;
+  }
+}
+async function invalidateStaleAiDocs(docsDir, slugs) {
+  for (const slug of slugs) {
+    try {
+      assertSafeResourceName(slug);
+    } catch {
+      continue;
+    }
+    await removeIfExists(path113.join(docsDir, `${slug}.md`));
+  }
+  await removeIfExists(architectureDocPath(docsDir));
+  await removeIfExists(path113.join(docsDir, "graph-g5-scenarios.md"));
+}
 async function deepEnrich(opts) {
   const { project, evidenceDir } = opts;
   const docsDir = path113.join(evidenceDir, "docs");
@@ -38325,7 +38533,7 @@ async function deepEnrich(opts) {
   let components = ctx.manifest.components ?? [];
   if (components.length === 0) {
     log.warn(`deep-enrich[${project}]: No components in _manifest.json, aborting`);
-    return;
+    return { project, complete: false, missingComponents: [], missingArchitecture: true };
   }
   if (opts.maxModules && components.length > opts.maxModules) {
     log.info(`deep-enrich[${project}]: Limited to first ${opts.maxModules} components (${components.length} total)`);
@@ -38334,52 +38542,55 @@ async function deepEnrich(opts) {
   }
   const allSlugs = components.map((c) => c.slug);
   const progress = await loadProgress(evidenceDir, project, allSlugs);
-  if (progress.phase === "done") {
-    const manifestTime = ctx.manifest.generatedAt;
-    const progressStale = manifestTime && progress.startedAt < manifestTime;
-    let docsEmpty = true;
-    if (await pathExists(docsDir)) {
-      const entries = await readdir4(docsDir).catch(() => []);
-      docsEmpty = entries.filter((e) => e.endsWith(".md")).length === 0;
-    }
-    if (docsEmpty || progressStale) {
-      log.info(`deep-enrich[${project}]: stale progress detected (phase=done, docs_empty=${docsEmpty}, progress_stale=${Boolean(progressStale)}), resetting`);
-      progress.phase = "pending";
-      progress.componentsDone = [];
-      progress.componentsPending = [...allSlugs];
-      progress.startedAt = (/* @__PURE__ */ new Date()).toISOString();
-      await saveProgress(evidenceDir, progress);
-    }
+  const manifestTime = ctx.manifest.generatedAt;
+  if (manifestTime && progress.startedAt < manifestTime) {
+    log.info(
+      `deep-enrich[${project}]: stale progress detected (manifest newer than progress.startedAt), invalidating AI docs`
+    );
+    await invalidateStaleAiDocs(docsDir, allSlugs);
+    progress.phase = "pending";
+    progress.componentsDone = [];
+    progress.componentsPending = [...allSlugs];
+    progress.startedAt = (/* @__PURE__ */ new Date()).toISOString();
+    await saveProgress(evidenceDir, progress);
   }
-  if (progress.phase === "pending" || progress.phase === "components") {
+  const existing = await existingComponentSlugs(docsDir, allSlugs);
+  progress.componentsDone = existing;
+  progress.componentsPending = allSlugs.filter((slug) => !existing.includes(slug));
+  if (progress.componentsPending.length > 0) {
     progress.phase = "components";
     await saveProgress(evidenceDir, progress);
     await runPhaseComponents(opts, ctx, progress, docsDir);
   }
-  if (progress.phase === "components" || progress.phase === "architecture") {
+  if (!await pathExists(architectureDocPath(docsDir))) {
     progress.phase = "architecture";
     await saveProgress(evidenceDir, progress);
     await runPhaseArchitecture(opts, ctx, docsDir);
   }
-  if (progress.phase === "architecture" || progress.phase === "graph") {
-    progress.phase = "graph";
-    await saveProgress(evidenceDir, progress);
-    await runPhaseGraph(opts, ctx, docsDir);
-  }
-  let graphFlags = { g5Generated: false, g6Generated: true };
-  if (progress.phase === "graph" || progress.phase === "ai-graph") {
-    progress.phase = "ai-graph";
-    await saveProgress(evidenceDir, progress);
-    graphFlags = await runPhaseAiGraph(opts, ctx, docsDir);
-  }
-  if (progress.phase === "ai-graph" || progress.phase === "index-enhance") {
-    progress.phase = "index-enhance";
-    await saveProgress(evidenceDir, progress);
-    await runPhaseIndexEnhance(opts, ctx, docsDir, graphFlags);
-  }
-  progress.phase = "done";
+  progress.phase = "graph";
   await saveProgress(evidenceDir, progress);
-  log.success(`deep-enrich[${project}]: Deep knowledge generation complete`);
+  await runPhaseGraph(opts, ctx, docsDir);
+  progress.phase = "ai-graph";
+  await saveProgress(evidenceDir, progress);
+  const graphFlags = await runPhaseAiGraph(opts, ctx, docsDir);
+  progress.phase = "index-enhance";
+  await saveProgress(evidenceDir, progress);
+  await runPhaseIndexEnhance(opts, ctx, docsDir, graphFlags);
+  const missing = await collectMissingAiDocs(docsDir, allSlugs);
+  const complete = missing.missingComponents.length === 0 && !missing.missingArchitecture;
+  progress.componentsDone = allSlugs.filter((slug) => !missing.missingComponents.includes(slug));
+  progress.componentsPending = missing.missingComponents;
+  progress.phase = complete ? "done" : missing.missingComponents.length > 0 ? "components" : "architecture";
+  await saveProgress(evidenceDir, progress);
+  if (complete) {
+    log.success(`deep-enrich[${project}]: Deep knowledge generation complete`);
+  } else {
+    const missingComps = missing.missingComponents.join(", ") || "(none)";
+    log.warn(
+      `deep-enrich[${project}]: incomplete \u2014 missing component docs: ${missingComps}, architecture: ${missing.missingArchitecture}`
+    );
+  }
+  return { project, complete, ...missing };
 }
 var PROGRESS_PATH_SUBDIR, PROGRESS_FILENAME, VALID_PHASES;
 var init_deep_enrich = __esm({
@@ -40464,7 +40675,7 @@ async function codebaseCmd(opts) {
     await printCodebaseStatus(opts);
     return;
   }
-  if (!opts.lint && !opts.reconcile) {
+  if (!opts.lint && !opts.reconcile && !opts.deepEnrich) {
     console.log("teamai codebase \u2014 team codebase knowledge management");
     console.log("");
     console.log("Usage:");
@@ -40474,6 +40685,7 @@ async function codebaseCmd(opts) {
     console.log("  teamai codebase --lint --json           Output JSON report (for CI)");
     console.log("  teamai codebase --lint --severity high  Only report high-severity issues");
     console.log("  teamai codebase --reconcile             Reconcile product and code knowledge");
+    console.log("  teamai codebase --deep-enrich           Generate deep knowledge from extracted evidence");
     console.log("  teamai codebase --status                Show knowledge-base git baseline");
     return;
   }
@@ -40492,7 +40704,72 @@ async function codebaseCmd(opts) {
   }
   if (!await pathExists3(teamwikiDir)) {
     console.log("No teamwiki found. Run `teamai import` first.");
-    if (opts.reconcile) process.exitCode = 1;
+    if (opts.reconcile || opts.deepEnrich) process.exitCode = 1;
+    return;
+  }
+  if (opts.deepEnrich) {
+    const project = opts.project?.trim() ?? "";
+    if (!project) {
+      console.log("Deep enrichment requires --project <slug>.");
+      process.exitCode = 1;
+      return;
+    }
+    const { assertWithinRoot: assertWithinRoot2 } = await Promise.resolve().then(() => (init_path_safety(), path_safety_exports));
+    const codeRoot = path125.join(teamwikiDir, "evidence", "code");
+    const evidenceDir = path125.join(codeRoot, project);
+    try {
+      assertWithinRoot2(codeRoot, evidenceDir);
+    } catch (e) {
+      console.log(e.message);
+      process.exitCode = 1;
+      return;
+    }
+    if (!await pathExists3(evidenceDir)) {
+      console.log(`No extracted evidence found for project "${project}". Run \`teamai codebase --extract\` first.`);
+      process.exitCode = 1;
+      return;
+    }
+    let componentCount = 0;
+    try {
+      const manifest = JSON.parse(await readFile15(path125.join(evidenceDir, "_manifest.json"), "utf-8"));
+      componentCount = Array.isArray(manifest.components) ? manifest.components.length : 0;
+    } catch {
+      componentCount = 0;
+    }
+    if (componentCount === 0) {
+      console.log(`No components in evidence for project "${project}". Run \`teamai codebase --extract\` first.`);
+      process.exitCode = 1;
+      return;
+    }
+    if (opts.dryRun) {
+      if (opts.json) {
+        console.log(JSON.stringify({ project, evidenceDir, dryRun: true }, null, 2));
+      } else {
+        console.log(`Deep enrichment preview: project=${project} (no writes)`);
+      }
+      return;
+    }
+    const { deepEnrich: deepEnrich2 } = await Promise.resolve().then(() => (init_deep_enrich(), deep_enrich_exports));
+    const result = await deepEnrich2({ project, evidenceDir, wikiRoot: teamwikiDir });
+    if (opts.json) {
+      console.log(JSON.stringify({
+        project,
+        evidenceDir,
+        complete: result.complete,
+        missingComponents: result.missingComponents,
+        missingArchitecture: result.missingArchitecture
+      }, null, 2));
+    } else if (result.complete) {
+      console.log(`Deep enrichment complete: project=${project}`);
+    } else {
+      const parts = [];
+      if (result.missingComponents.length > 0) {
+        parts.push(`missing component docs: ${result.missingComponents.join(", ")}`);
+      }
+      if (result.missingArchitecture) parts.push("missing architecture.md");
+      console.log(`Deep enrichment incomplete: project=${project}, ${parts.join(", ")}`);
+    }
+    if (!result.complete) process.exitCode = 1;
     return;
   }
   if (opts.reconcile) {
@@ -41699,10 +41976,10 @@ program.command("pull").description("Pull team resources and inject into local A
   const { pull: pull2 } = await Promise.resolve().then(() => (init_pull(), pull_exports));
   await pull2({ ...globalOpts, ...cmdOpts });
 });
-program.command("status").description("Show local vs team repo diff").action(async () => {
+program.command("status").description("Show local vs team repo diff").option("--all", "List every project data partition under ~/.teamai/projects (flags stale/orphan ones)").action(async (cmdOpts) => {
   const globalOpts = program.opts();
   const { status: status2 } = await Promise.resolve().then(() => (init_status(), status_exports));
-  await status2(globalOpts);
+  await status2({ ...globalOpts, ...cmdOpts });
 });
 program.command("list [type]").description("List resources (skills|rules|docs|env|agents|hooks|mcp). For skills, --source local/all also scans installed AI agent skill directories.").option("--source <src>", "Where to look for skills: repo | local | all", "all").option("--agent <name>", "Filter local agents by id (only applies to skills)").option("--reveal", "Show env values in plaintext (default: masked)").action(async (type, cmdOpts) => {
   const globalOpts = program.opts();
@@ -42087,7 +42364,7 @@ program.command("mr-hint", { hidden: true }).description("Hint AI about recently
     await mrHint2();
   }
 });
-program.command("codebase").description("Inspect and maintain team-codebase outputs").option("--extract [path]", "Extract code knowledge and build graph from source").addOption(new Option("--incremental", "Only re-extract changed files (requires prior manifest)").hideHelp()).addOption(new Option("--project <name>", "Project slug for extract output (default: directory name)").hideHelp()).addOption(new Option("--max-files <n>", "Max source files to scan (default: 200)").hideHelp()).addOption(new Option("--upgrade-wiki", "Migrate docs/team-codebase/ to teamwiki/ graph format").hideHelp()).option("--lint", "Run global consistency lint over the teamwiki knowledge graph").option("--reconcile", "Reconcile product and code knowledge in teamwiki").addOption(new Option("--fix", "Deprecated: teamwiki lint has no autofix; runs lint in report-only mode").hideHelp()).option("--status", "Show knowledge-base git baseline (headSha / repoUrl / branch)").addOption(new Option("--severity <level>", "Minimum severity to report: high|medium|low|info").default("info").hideHelp()).option("--json", "Output report as JSON (suitable for CI)").addOption(new Option("--output <path>", "Custom teamwiki output root directory").hideHelp()).action(async (cmdOpts) => {
+program.command("codebase").description("Inspect and maintain team-codebase outputs").option("--extract [path]", "Extract code knowledge and build graph from source").addOption(new Option("--incremental", "Only re-extract changed files (requires prior manifest)").hideHelp()).addOption(new Option("--project <name>", "Project slug for --extract (defaults to directory name) and required for --deep-enrich").hideHelp()).addOption(new Option("--max-files <n>", "Max source files to scan (default: 200)").hideHelp()).addOption(new Option("--upgrade-wiki", "Migrate docs/team-codebase/ to teamwiki/ graph format").hideHelp()).option("--lint", "Run global consistency lint over the teamwiki knowledge graph").option("--reconcile", "Reconcile product and code knowledge in teamwiki").option("--deep-enrich", "Generate deep knowledge docs from extracted evidence").addOption(new Option("--fix", "Deprecated: teamwiki lint has no autofix; runs lint in report-only mode").hideHelp()).option("--status", "Show knowledge-base git baseline (headSha / repoUrl / branch)").addOption(new Option("--severity <level>", "Minimum severity to report: high|medium|low|info").default("info").hideHelp()).option("--json", "Output report as JSON (suitable for CI)").addOption(new Option("--output <path>", "Custom teamwiki output root directory").hideHelp()).action(async (cmdOpts) => {
   const globalOpts = program.opts();
   const { codebaseCmd: codebaseCmd2 } = await Promise.resolve().then(() => (init_codebase_cmd(), codebase_cmd_exports));
   await codebaseCmd2({ ...globalOpts, ...cmdOpts });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teamai-cli",
-  "version": "0.24.0-beta.4",
+  "version": "0.24.0-beta.6",
   "description": "TeamAI — Make Every Team AI Native (skill sync + shared knowledge base, powered by Git)",
   "type": "module",
   "bin": {

package/skills/team-wiki-codebase/README.md

@@ -23,6 +23,7 @@
 - 每次生成后有准确性统计，超标自动警告
 - AI 读知识库而非读源码，**约 1/50 的 token 消耗**获得全局架构认知
 - Phase 0 可用 `teamai codebase --extract` 生成可证据化的结构边（TS/JS/Python/Go AST + 多语言 heuristic）
+- 提取后可用 `teamai codebase --deep-enrich --project <slug> --output <repo>` 生成确定性图谱文档（G1/G2/G3）与深度知识；无需单独的 team-wiki CLI
 
 ---
 

package/skills/team-wiki-codebase/SKILL.md

@@ -889,6 +889,7 @@ _review/                                ← 过程文件（不入知识库）
 | 阶段 | 命令 / 路径 |
 |------|-------------|
 | Phase 0 结构基线 | `teamai codebase --extract <repo> --project <slug>`（writes `<repo>/teamwiki/`） |
+| Deep knowledge | Use `teamai codebase --deep-enrich --project <slug> --output <repo>` after extract has written `teamwiki/evidence/code/<slug>/`. `--output` is the repository root, not the `teamwiki/` directory. Prefix with `teamai --dry-run` to preview without writing. TeamAI does not ship a separate team-wiki CLI. No extra plugin is required. |
 | K3 后编译进 wiki | Skip. TeamAI does not ship a separate team-wiki CLI. Continue with this skill using `teamai` and the files under this skill directory. No extra plugin is required. |
 | 产品文档入图 | Skip. Same English note as above. |
 | 产品↔代码桥接 | Use `teamai codebase --reconcile --output <repo>` after product pages and extracted code pages are under `<repo>/teamwiki/`. Prefix with `teamai --dry-run` to preview without updating the graph. |