feat(contribute-check): Phase 2 知识库空白感知 + git commit 降权

.gitignore

@@ -33,5 +33,7 @@ docs/superpowers/
 docs/designs/auto-update.md
 docs/designs/ci-pipeline.md
 docs/designs/knowledge-feed.md
+docs/codebase.md
+docs/llm-wiki.md
 roadmap_jael.md
 validation/

agents/teamai-recall.md

@@ -22,10 +22,14 @@ upstream API"). Treat this as your query.
 
 ### Step 1 — Read the codebase manifest (optional but preferred)
 
-If `~/.teamai/docs/codebase.md` exists, read it first. It lists the team's
-repositories and their purposes. Extract a one-sentence repo-list summary
-to prepend to your final output. If the file does not exist, **silently
-skip** this step — never error out.
+If `~/.teamai/docs/codebase.md` OR `docs/team-codebase/index.md` (in the
+current project) exists, read it first. It lists the team's repositories
+and their purposes. Extract a one-sentence repo-list summary to prepend to
+your final output. If neither file exists, **silently skip** this step —
+never error out.
+
+> Note: `teamai recall` already indexes team-codebase documents
+> (repos/*.md), so Step 3 will return codebase knowledge matches directly.
 
 ### Step 2 — Extract keywords from the task description
 

src/__tests__/auto-recall-quality.test.ts

@@ -0,0 +1,132 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { readRecallQuality } from '../auto-recall.js';
+
+function makeTmpDir(): string {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'teamai-recall-quality-test-'));
+}
+
+describe('readRecallQuality', () => {
+    let tmpDir: string;
+    const originalHome = process.env.HOME;
+
+    beforeEach(() => {
+        tmpDir = makeTmpDir();
+        process.env.HOME = tmpDir;
+    });
+
+    afterEach(() => {
+        process.env.HOME = originalHome;
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+
+    it('returns null when no cache exists', () => {
+        const result = readRecallQuality('nonexistent-session');
+        expect(result).toBeNull();
+    });
+
+    it('returns null when cache has zero hit and miss counts', () => {
+        const sessionId = 'zero-counts-session';
+        const sessionsDir = path.join(tmpDir, '.teamai', 'sessions');
+        fs.mkdirSync(sessionsDir, { recursive: true });
+        fs.writeFileSync(
+            path.join(sessionsDir, `${sessionId}-recall-cache.json`),
+            JSON.stringify({
+                queries: [],
+                count: 0,
+                updatedAt: new Date().toISOString(),
+                topScore: 0,
+                hitCount: 0,
+                missCount: 0,
+            }),
+            'utf-8',
+        );
+
+        const result = readRecallQuality(sessionId);
+        expect(result).toBeNull();
+    });
+
+    it('returns quality data when hitCount > 0', () => {
+        const sessionId = 'hit-session';
+        const sessionsDir = path.join(tmpDir, '.teamai', 'sessions');
+        fs.mkdirSync(sessionsDir, { recursive: true });
+        fs.writeFileSync(
+            path.join(sessionsDir, `${sessionId}-recall-cache.json`),
+            JSON.stringify({
+                queries: ['test'],
+                count: 1,
+                updatedAt: new Date().toISOString(),
+                topScore: 12.5,
+                hitCount: 2,
+                missCount: 1,
+            }),
+            'utf-8',
+        );
+
+        const result = readRecallQuality(sessionId);
+        expect(result).toEqual({ topScore: 12.5, hitCount: 2, missCount: 1 });
+    });
+
+    it('returns quality data when missCount > 0 and hitCount is 0', () => {
+        const sessionId = 'miss-only-session';
+        const sessionsDir = path.join(tmpDir, '.teamai', 'sessions');
+        fs.mkdirSync(sessionsDir, { recursive: true });
+        fs.writeFileSync(
+            path.join(sessionsDir, `${sessionId}-recall-cache.json`),
+            JSON.stringify({
+                queries: ['q1'],
+                count: 1,
+                updatedAt: new Date().toISOString(),
+                topScore: 0,
+                hitCount: 0,
+                missCount: 3,
+            }),
+            'utf-8',
+        );
+
+        const result = readRecallQuality(sessionId);
+        expect(result).toEqual({ topScore: 0, hitCount: 0, missCount: 3 });
+    });
+
+    it('handles legacy cache format (missing quality fields) gracefully', () => {
+        const sessionId = 'legacy-session';
+        const sessionsDir = path.join(tmpDir, '.teamai', 'sessions');
+        fs.mkdirSync(sessionsDir, { recursive: true });
+        fs.writeFileSync(
+            path.join(sessionsDir, `${sessionId}-recall-cache.json`),
+            JSON.stringify({
+                queries: ['old'],
+                count: 2,
+                updatedAt: new Date().toISOString(),
+            }),
+            'utf-8',
+        );
+
+        const result = readRecallQuality(sessionId);
+        expect(result).toBeNull();
+    });
+
+    it('returns null for expired cache (TTL exceeded)', () => {
+        const sessionId = 'expired-session';
+        const sessionsDir = path.join(tmpDir, '.teamai', 'sessions');
+        fs.mkdirSync(sessionsDir, { recursive: true });
+        const expiredAt = new Date(Date.now() - 25 * 60 * 60 * 1000).toISOString();
+        fs.writeFileSync(
+            path.join(sessionsDir, `${sessionId}-recall-cache.json`),
+            JSON.stringify({
+                queries: ['q1'],
+                count: 1,
+                updatedAt: expiredAt,
+                topScore: 8.0,
+                hitCount: 1,
+                missCount: 0,
+            }),
+            'utf-8',
+        );
+
+        const result = readRecallQuality(sessionId);
+        expect(result).toBeNull();
+    });
+});

src/__tests__/builtin-rules.test.ts

@@ -25,11 +25,9 @@ describe('builtin-rules', () => {
     });
 
     describe('deployBuiltinRules', () => {
-        it('should clean up legacy teamai-recall.md files', async () => {
-            // Arrange: create tool rules directories with legacy rule
+        it('should deploy teamai-recall.md rule to tool rules directory', async () => {
             const claudeRulesDir = path.join(tmpDir, '.claude', 'rules');
             fs.mkdirSync(claudeRulesDir, { recursive: true });
-            fs.writeFileSync(path.join(claudeRulesDir, 'teamai-recall.md'), 'old recall rule', 'utf-8');
 
             const teamConfig = {
                 toolPaths: {
@@ -42,12 +40,14 @@ describe('builtin-rules', () => {
                 },
             } as any;
 
-            // Act
             const { deployBuiltinRules } = await import('../builtin-rules.js');
             await deployBuiltinRules(teamConfig);
 
-            // Assert: legacy file is removed
-            expect(fs.existsSync(path.join(claudeRulesDir, 'teamai-recall.md'))).toBe(false);
+            const deployed = path.join(claudeRulesDir, 'teamai-recall.md');
+            expect(fs.existsSync(deployed)).toBe(true);
+            const content = fs.readFileSync(deployed, 'utf-8');
+            expect(content).toContain('Team Knowledge Recall');
+            expect(content).toContain('teamai recall');
         });
 
         it('should skip tool directories that do not exist (tool not installed)', async () => {
@@ -103,9 +103,9 @@ describe('builtin-rules', () => {
     });
 
     describe('BUILTIN_RULE_NAMES', () => {
-        it('should be empty (no built-in rules deployed after recall rule removal)', async () => {
+        it('should contain teamai-recall', async () => {
             const { BUILTIN_RULE_NAMES } = await import('../builtin-rules.js');
-            expect(BUILTIN_RULE_NAMES.size).toBe(0);
+            expect(BUILTIN_RULE_NAMES.has('teamai-recall')).toBe(true);
         });
     });
 });

src/__tests__/codebase-lint.test.ts

@@ -77,7 +77,7 @@ async function scaffold(opts: ScaffoldOptions): Promise<void> {
         const fm = {
             title: 'Codebase 概览',
             lastUpdated: isoAgo(1),
-            source: path.join(os.homedir(), '.teamai', 'cache', 'repos', 'placeholder'),
+            source: opts.cwd,
             generator: 'teamai-cli',
             schemaVersion: 1,
             ...(opts.repoFrontmatter ?? {}),