@handsupmin/gc-tree 0.2.1 → 0.3.0

package/README.es.md

@@ -62,7 +62,7 @@ gctree init
 2. Instalar los archivos de integración en el repositorio actual
 3. Completar el onboarding guiado para el gc-branch `main`
 
-Después, tu herramienta de IA aprenderá a llamar a `gctree resolve` antes de planificar o implementar.
+Después, tu herramienta de IA instala integración real de hooks SessionStart/UserPromptSubmit: revisa gc-tree automáticamente antes de trabajar y cachea resultados vacíos/no-match durante la sesión.
 
 - **CLI:** `gctree`
 - **Requisito:** Node.js 20+

package/README.ja.md

@@ -62,7 +62,7 @@ gctree init
 2. 現在のリポジトリへの統合ファイルのインストール
 3. `main` gc-branch のガイド付きオンボーディング実行
 
-その後は、AI ツールが計画・実装の前に `gctree resolve` を呼ぶ流れを自然に覚えます。
+その後は、AI ツールに実際の SessionStart / UserPromptSubmit フック統合が入り、作業前に gc-tree を自動確認し、空結果や no-match をセッション中キャッシュします。
 
 - **CLI：** `gctree`
 - **動作条件：** Node.js 20+

package/README.ko.md

@@ -62,7 +62,7 @@ gctree init
 2. 현재 레포에 통합 파일 스캐폴딩
 3. `main` gc-branch 가이드형 온보딩 실행
 
-이후 AI 도구가 계획·구현 전에 `gctree resolve`를 호출하는 법을 자동으로 알게 됩니다.
+이후 AI 도구에 실제 SessionStart/UserPromptSubmit 훅 통합이 설치되어, 작업 전에 gc-tree를 자동 확인하고 세션 동안 빈 결과·no-match를 캐시합니다.
 
 - **CLI:** `gctree`
 - **요구 사항:** Node.js 20+

package/README.md

@@ -62,7 +62,7 @@ gctree init
 2. Scaffold the integration files into your current repo
 3. Run guided onboarding for the `main` gc-branch
 
-After that, your AI tool will know to call `gctree resolve` before planning or implementing.
+After that, your AI tool gets real SessionStart/UserPromptSubmit hook integration, so it auto-checks gc-tree before work and caches empty/no-match results for the session.
 
 - **CLI:** `gctree`
 - **Requires:** Node.js 20+

package/README.zh.md

@@ -49,7 +49,7 @@ gctree init
 2. 在当前仓库安装集成文件
 3. 为 `main` gc-branch 完成引导式 onboarding
 
-之后，AI 工具会自动学会在规划或实现前调用 `gctree resolve`。
+之后，AI 工具会安装真正的 SessionStart / UserPromptSubmit hook 集成：在开始工作前自动检查 gc-tree，并在整个会话内缓存空结果和 no-match。
 
 - **CLI：** `gctree`
 - **要求：** Node.js 20+

package/dist/src/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { readFile } from 'node:fs/promises';
 import { stdin } from 'node:process';
+import { dispatchGcTreeHook } from './hook.js';
 import { onboardBranch } from './onboard.js';
 import { buildProviderLaunchPlan, maybeLaunchProvider, promptLanguageSelection, promptLaunchProviderSelection, promptProviderSelection, } from './provider.js';
 import { DEFAULT_BRANCH, resolveHome } from './paths.js';
@@ -37,12 +38,20 @@ function usage() {
 Internal commands:
   gctree __apply-onboarding --input FILE [--home DIR] [--branch NAME]
   gctree __apply-update --input FILE [--home DIR] [--branch NAME]
+  gctree __hook --event <SessionStart|UserPromptSubmit> [--home DIR]
 `);
     process.exit(1);
 }
 async function readJsonFile(path) {
     return JSON.parse(await readFile(path, 'utf8'));
 }
+async function readStdinText() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
 function normalizeProvider(value) {
     if (!value)
         return undefined;
@@ -337,6 +346,22 @@ async function main() {
             console.log(JSON.stringify(result, null, 2));
             return;
         }
+        case '__hook': {
+            const event = readArg('--event');
+            if (event !== 'SessionStart' && event !== 'UserPromptSubmit')
+                usage();
+            const raw = await readStdinText();
+            const payload = raw.trim() ? JSON.parse(raw) : {};
+            const result = await dispatchGcTreeHook({
+                event,
+                home,
+                payload,
+            });
+            if (result) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            return;
+        }
         case 'scaffold': {
             const host = normalizeProviderMode(readArg('--host'));
             if (!host)

package/dist/src/hook.js

@@ -0,0 +1,209 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { dirname } from 'node:path';
+import { DEFAULT_BRANCH } from './paths.js';
+import { hookCachePath, } from './paths.js';
+import { branchScopeStatus, readBranchRepoMap, resolveBranchForRepo } from './repo-map.js';
+import { resolveContext } from './resolve.js';
+import { readHead, statusForBranch } from './store.js';
+function normalizeText(value) {
+    return value.trim().replace(/\s+/g, ' ');
+}
+function hashQuery(query) {
+    return createHash('sha1').update(normalizeText(query).toLowerCase()).digest('hex');
+}
+function limitMatches(matches, max = 3) {
+    return matches.slice(0, max);
+}
+function formatMatches(matches) {
+    return limitMatches(matches)
+        .map((match, index) => `${index + 1}. ${match.title}\n   Summary: ${match.summary}\n   Excerpt: ${match.excerpt}`)
+        .join('\n');
+}
+function buildSessionStartContext({ gcBranch, currentRepo, repoScopeStatus, }) {
+    return [
+        `gc-tree auto-resolve is active for this session.`,
+        `Active gc-branch: "${gcBranch}".`,
+        `Current repo: ${currentRepo || 'unscoped'}.`,
+        `Repo scope status: ${repoScopeStatus}.`,
+        `Before acting on new user prompts, use gc-tree hook context first. If the hook reports no reusable global context, avoid redundant resolve calls for the same session state unless the repo, gc-branch, or task changes materially.`,
+    ].join(' ');
+}
+function buildEmptyBranchContext({ gcBranch, currentRepo, cached, }) {
+    return [
+        `gc-tree auto-resolve ${cached ? 'used cached state' : 'checked the active gc-branch'} and found no reusable global context for this session because gc-branch "${gcBranch}" currently has 0 docs.`,
+        `Repo: ${currentRepo || 'unscoped'}.`,
+        `Treat this as "no reusable global context yet" until the gc-branch content changes or a different repo/gc-branch is active.`,
+    ].join(' ');
+}
+function buildExcludedContext({ gcBranch, currentRepo, cached, }) {
+    return [
+        `gc-tree auto-resolve ${cached ? 'used cached state' : 'checked the active gc-branch'} and found that repo "${currentRepo || 'unknown'}" is excluded from gc-branch "${gcBranch}".`,
+        `No reusable global context applies here unless the branch-repo mapping changes.`,
+    ].join(' ');
+}
+function buildNoMatchContext({ gcBranch, currentRepo, query, cached, }) {
+    return [
+        `gc-tree auto-resolve ${cached ? 'skipped a redundant lookup using cached no-match state' : 'checked the active gc-branch'} and found no reusable global context for this prompt in gc-branch "${gcBranch}".`,
+        `Repo: ${currentRepo || 'unscoped'}.`,
+        `Query: "${query}".`,
+        `Only re-run resolve if the repo, gc-branch, or task changes materially.`,
+    ].join(' ');
+}
+function buildMatchContext({ gcBranch, currentRepo, repoScopeStatus, query, matches, }) {
+    return [
+        `gc-tree auto-resolve checked gc-branch "${gcBranch}" for repo "${currentRepo || 'unscoped'}" (scope: ${repoScopeStatus}) before this prompt.`,
+        `Query: "${query}".`,
+        `Use these matching gc-tree summaries before planning or implementation:`,
+        formatMatches(matches),
+        `Read full docs only if the summaries are insufficient.`,
+    ].join('\n');
+}
+async function readHookCache(home, sessionId) {
+    try {
+        const raw = await readFile(hookCachePath(home, sessionId), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeHookCache(home, cache) {
+    const path = hookCachePath(home, cache.session_id);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(cache, null, 2)}\n`, 'utf8');
+}
+function nextCacheState(previous, { sessionId, gcBranch, currentRepo, repoScopeStatus, }) {
+    const changed = !previous ||
+        previous.gc_branch !== gcBranch ||
+        previous.current_repo !== currentRepo ||
+        previous.repo_scope_status !== repoScopeStatus;
+    return {
+        version: 1,
+        session_id: sessionId,
+        gc_branch: gcBranch,
+        current_repo: currentRepo,
+        repo_scope_status: repoScopeStatus,
+        branch_empty: changed ? false : previous.branch_empty,
+        branch_excluded: changed ? false : previous.branch_excluded,
+        no_match_signatures: changed ? [] : previous.no_match_signatures,
+        updated_at: new Date().toISOString(),
+    };
+}
+function readSessionId(payload) {
+    const raw = normalizeText(payload.session_id || '');
+    return raw || 'default-session';
+}
+export async function dispatchGcTreeHook({ event, home, payload, }) {
+    const cwd = payload.cwd || process.cwd();
+    const head = (await readHead(home)) || DEFAULT_BRANCH;
+    const resolved = await resolveBranchForRepo({ home, head, cwd });
+    const gcBranch = resolved.gc_branch;
+    const currentRepo = resolved.current_repo;
+    const mapping = await readBranchRepoMap(home);
+    const repoScopeStatus = branchScopeStatus(mapping, gcBranch, currentRepo);
+    const sessionId = readSessionId(payload);
+    if (event === 'SessionStart') {
+        return {
+            hookSpecificOutput: {
+                hookEventName: event,
+                additionalContext: buildSessionStartContext({
+                    gcBranch,
+                    currentRepo,
+                    repoScopeStatus,
+                }),
+            },
+        };
+    }
+    const prompt = normalizeText(payload.user_prompt || '');
+    if (!prompt)
+        return null;
+    const branchStatus = await statusForBranch(home, gcBranch);
+    const previousCache = await readHookCache(home, sessionId);
+    const cache = nextCacheState(previousCache, {
+        sessionId,
+        gcBranch,
+        currentRepo,
+        repoScopeStatus,
+    });
+    if (repoScopeStatus === 'excluded') {
+        cache.branch_excluded = true;
+        cache.updated_at = new Date().toISOString();
+        await writeHookCache(home, cache);
+        return {
+            hookSpecificOutput: {
+                hookEventName: event,
+                additionalContext: buildExcludedContext({
+                    gcBranch,
+                    currentRepo,
+                    cached: previousCache?.branch_excluded === true,
+                }),
+            },
+        };
+    }
+    if (branchStatus.doc_count === 0) {
+        const wasCached = cache.branch_empty;
+        cache.branch_empty = true;
+        cache.updated_at = new Date().toISOString();
+        await writeHookCache(home, cache);
+        return {
+            hookSpecificOutput: {
+                hookEventName: event,
+                additionalContext: buildEmptyBranchContext({
+                    gcBranch,
+                    currentRepo,
+                    cached: wasCached,
+                }),
+            },
+        };
+    }
+    const query = currentRepo ? `${currentRepo} ${prompt}` : prompt;
+    const signature = hashQuery(query);
+    if (cache.no_match_signatures.includes(signature)) {
+        cache.updated_at = new Date().toISOString();
+        await writeHookCache(home, cache);
+        return {
+            hookSpecificOutput: {
+                hookEventName: event,
+                additionalContext: buildNoMatchContext({
+                    gcBranch,
+                    currentRepo,
+                    query,
+                    cached: true,
+                }),
+            },
+        };
+    }
+    const result = await resolveContext({ home, branch: gcBranch, query });
+    if (result.matches.length === 0) {
+        cache.no_match_signatures = [...new Set([...cache.no_match_signatures, signature])];
+        cache.updated_at = new Date().toISOString();
+        await writeHookCache(home, cache);
+        return {
+            hookSpecificOutput: {
+                hookEventName: event,
+                additionalContext: buildNoMatchContext({
+                    gcBranch,
+                    currentRepo,
+                    query,
+                    cached: false,
+                }),
+            },
+        };
+    }
+    cache.no_match_signatures = cache.no_match_signatures.filter((entry) => entry !== signature);
+    cache.updated_at = new Date().toISOString();
+    await writeHookCache(home, cache);
+    return {
+        hookSpecificOutput: {
+            hookEventName: event,
+            additionalContext: buildMatchContext({
+                gcBranch,
+                currentRepo,
+                repoScopeStatus,
+                query,
+                matches: result.matches,
+            }),
+        },
+    };
+}

package/dist/src/paths.js

@@ -26,3 +26,9 @@ export function branchIndexPath(home, branch) {
 export function branchDocsDir(home, branch) {
     return join(branchDir(home, branch), 'docs');
 }
+export function hookCacheDir(home) {
+    return join(home, 'hook-cache');
+}
+export function hookCachePath(home, sessionId) {
+    return join(hookCacheDir(home), `${sessionId}.json`);
+}

package/dist/src/scaffold.js

@@ -6,8 +6,8 @@ function renderCodexAgentsSnippet() {
         '# gctree Codex integration snippet',
         '',
         '- Treat the active gctree branch as a **gc-branch** when you describe it to users.',
-        '- Before planning or implementation, run `gctree status` to confirm the active gc-branch if it is unclear.',
-        '- Use `gctree resolve --query "<task>"` when reusable global context may matter.',
+        '- gctree init installs SessionStart and UserPromptSubmit hooks that auto-check gc-tree before work.',
+        '- Use the hook-injected gc-tree context first. If hooks are unavailable or clearly stale, run `gctree status` and `gctree resolve --query "<task>"` yourself before planning or implementation.',
         '- Use `$gc-onboard` only for an empty gc-branch.',
         '- Use `$gc-update-global-context` when durable context in the active gc-branch should change.',
         '',
@@ -18,12 +18,39 @@ function renderCodexBootstrapPrompt() {
         '# gctree Bootstrap',
         '',
         '- Keep the active gc-branch explicit whenever global context matters.',
-        '- Resolve reusable global context before planning or implementation when it may change the answer.',
+        '- Trust auto-resolved gc-tree hook context first; if it is missing, resolve reusable global context before planning or implementation.',
         '- Read summaries first and only open full docs when needed.',
         '- Treat gctree docs as explicit source-of-truth markdown, not hidden memory.',
         '',
     ].join('\n');
 }
+function renderCodexHooksJson() {
+    return JSON.stringify({
+        hooks: {
+            SessionStart: [
+                {
+                    matcher: 'startup|resume',
+                    hooks: [
+                        {
+                            type: 'command',
+                            command: 'gctree __hook --event SessionStart',
+                        },
+                    ],
+                },
+            ],
+            UserPromptSubmit: [
+                {
+                    hooks: [
+                        {
+                            type: 'command',
+                            command: 'gctree __hook --event UserPromptSubmit',
+                        },
+                    ],
+                },
+            ],
+        },
+    }, null, 2);
+}
 function renderCodexResolveSkill() {
     return [
         '---',
@@ -80,8 +107,8 @@ function renderClaudeSnippet() {
         '# gctree Claude Code integration snippet',
         '',
         '- Treat the active gctree branch as a **gc-branch** in user-facing language.',
-        '- Run `gctree status` before relying on global context if the active gc-branch is unclear.',
-        '- Use `gctree resolve --query "<task>"` when reusable global context may matter.',
+        '- gctree init installs SessionStart and UserPromptSubmit hooks that auto-check gc-tree before work.',
+        '- Use the hook-injected gc-tree context first. If hooks are unavailable or clearly stale, run `gctree status` and `gctree resolve --query "<task>"` yourself before planning or implementation.',
         '- Use `/gc-onboard` only for an empty gc-branch.',
         '- Use `/gc-update-global-context` when durable context in the active gc-branch should change.',
         '',
@@ -91,12 +118,43 @@ function renderClaudeSessionStartHook() {
     return [
         '# gctree Claude Code SessionStart note',
         '',
-        '- At session start, confirm the active gc-branch with `gctree status` when reusable global context may matter.',
+        '- gctree init installs real SessionStart/UserPromptSubmit hooks via `.claude/hooks/hooks.json`.',
+        '- At session start, use the injected hook context to confirm the active gc-branch.',
         '- Refer to gctree branches as **gc-branches** in user-facing language.',
-        '- Resolve summaries before planning or implementation when branch-level context may change the answer.',
+        '- If hook context is missing or stale, resolve summaries before planning or implementation when branch-level context may change the answer.',
         '',
     ].join('\n');
 }
+function renderClaudeHooksJson() {
+    return JSON.stringify({
+        hooks: {
+            SessionStart: [
+                {
+                    matcher: '*',
+                    hooks: [
+                        {
+                            type: 'command',
+                            command: 'gctree __hook --event SessionStart',
+                            timeout: 10,
+                        },
+                    ],
+                },
+            ],
+            UserPromptSubmit: [
+                {
+                    matcher: '*',
+                    hooks: [
+                        {
+                            type: 'command',
+                            command: 'gctree __hook --event UserPromptSubmit',
+                            timeout: 10,
+                        },
+                    ],
+                },
+            ],
+        },
+    }, null, 2);
+}
 function renderClaudeResolveCommand() {
     return [
         '---',
@@ -150,6 +208,7 @@ function scaffoldFiles(host) {
     if (host === 'codex') {
         return [
             { path: 'AGENTS.md', content: renderCodexAgentsSnippet() },
+            { path: '.codex/hooks.json', content: renderCodexHooksJson() },
             { path: '.codex/prompts/gctree-bootstrap.md', content: renderCodexBootstrapPrompt() },
             { path: '.codex/skills/gc-resolve-context/SKILL.md', content: renderCodexResolveSkill() },
             { path: '.codex/skills/gc-onboard/SKILL.md', content: renderCodexOnboardSkill() },
@@ -158,6 +217,7 @@ function scaffoldFiles(host) {
     }
     return [
         { path: 'CLAUDE.md', content: renderClaudeSnippet() },
+        { path: '.claude/hooks/hooks.json', content: renderClaudeHooksJson() },
         { path: '.claude/hooks/gctree-session-start.md', content: renderClaudeSessionStartHook() },
         { path: '.claude/commands/gc-resolve-context.md', content: renderClaudeResolveCommand() },
         { path: '.claude/commands/gc-onboard.md', content: renderClaudeOnboardCommand() },

package/docs/usage.es.md

@@ -145,6 +145,7 @@ gctree scaffold --host both --target /path/to/repo
 
 ```
 AGENTS.md                                  ← fragmento de gctree añadido a las instrucciones del agente
+.codex/hooks.json                         ← hooks de auto-resolve para SessionStart/UserPromptSubmit
 .codex/prompts/gctree-bootstrap.md         ← contexto de arranque para las sesiones de Codex
 .codex/skills/gc-resolve-context/SKILL.md  ← skill de resolve
 .codex/skills/gc-onboard/SKILL.md          ← skill de onboarding
@@ -155,7 +156,8 @@ AGENTS.md                                  ← fragmento de gctree añadido a la
 
 ```
 CLAUDE.md                                        ← fragmento de gctree añadido
-.claude/hooks/gctree-session-start.md            ← hook de inicio de sesión
+.claude/hooks/hooks.json                         ← hooks de auto-resolve para SessionStart/UserPromptSubmit
+.claude/hooks/gctree-session-start.md            ← nota fallback de inicio de sesión
 .claude/commands/gc-resolve-context.md           ← comando slash de resolve
 .claude/commands/gc-onboard.md                   ← comando slash de onboard
 .claude/commands/gc-update-global-context.md     ← comando slash de actualización

package/docs/usage.ja.md

@@ -145,6 +145,7 @@ gctree scaffold --host both --target /path/to/repo
 
 ```
 AGENTS.md                                  ← gctree のスニペットがエージェント指示に追記される
+.codex/hooks.json                         ← SessionStart / UserPromptSubmit の自動 resolve フック
 .codex/prompts/gctree-bootstrap.md         ← Codex セッション向けのブートストラップコンテキスト
 .codex/skills/gc-resolve-context/SKILL.md  ← resolve スキル
 .codex/skills/gc-onboard/SKILL.md          ← オンボーディングスキル
@@ -155,7 +156,8 @@ AGENTS.md                                  ← gctree のスニペットがエ
 
 ```
 CLAUDE.md                                        ← gctree のスニペットが追記される
-.claude/hooks/gctree-session-start.md            ← セッション開始フック
+.claude/hooks/hooks.json                         ← SessionStart / UserPromptSubmit の自動 resolve フック
+.claude/hooks/gctree-session-start.md            ← セッション開始のフォールバックメモ
 .claude/commands/gc-resolve-context.md           ← resolve スラッシュコマンド
 .claude/commands/gc-onboard.md                   ← onboard スラッシュコマンド
 .claude/commands/gc-update-global-context.md     ← 更新スラッシュコマンド

package/docs/usage.ko.md

@@ -145,6 +145,7 @@ gctree scaffold --host both --target /path/to/repo
 
 ```
 AGENTS.md                                  ← 에이전트 지시사항에 gctree 스니펫 추가
+.codex/hooks.json                         ← SessionStart/UserPromptSubmit 자동 resolve 훅
 .codex/prompts/gctree-bootstrap.md         ← Codex 세션의 부트스트랩 컨텍스트
 .codex/skills/gc-resolve-context/SKILL.md  ← resolve 스킬
 .codex/skills/gc-onboard/SKILL.md          ← 온보딩 스킬
@@ -155,7 +156,8 @@ AGENTS.md                                  ← 에이전트 지시사항에 gctr
 
 ```
 CLAUDE.md                                        ← gctree 스니펫 추가
-.claude/hooks/gctree-session-start.md            ← 세션 시작 훅
+.claude/hooks/hooks.json                         ← SessionStart/UserPromptSubmit 자동 resolve 훅
+.claude/hooks/gctree-session-start.md            ← 세션 시작 fallback 메모
 .claude/commands/gc-resolve-context.md           ← resolve 슬래시 명령
 .claude/commands/gc-onboard.md                   ← onboard 슬래시 명령
 .claude/commands/gc-update-global-context.md     ← 업데이트 슬래시 명령

package/docs/usage.md

@@ -145,6 +145,7 @@ gctree scaffold --host both --target /path/to/repo
 
 ```
 AGENTS.md                                  ← gctree snippet appended to agent instructions
+.codex/hooks.json                         ← SessionStart/UserPromptSubmit auto-resolve hooks
 .codex/prompts/gctree-bootstrap.md         ← bootstrap context for Codex sessions
 .codex/skills/gc-resolve-context/SKILL.md  ← resolve skill
 .codex/skills/gc-onboard/SKILL.md          ← onboarding skill
@@ -155,7 +156,8 @@ AGENTS.md                                  ← gctree snippet appended to agent
 
 ```
 CLAUDE.md                                        ← gctree snippet appended
-.claude/hooks/gctree-session-start.md            ← session-start hook
+.claude/hooks/hooks.json                         ← SessionStart/UserPromptSubmit auto-resolve hooks
+.claude/hooks/gctree-session-start.md            ← session-start fallback note
 .claude/commands/gc-resolve-context.md           ← resolve slash command
 .claude/commands/gc-onboard.md                   ← onboard slash command
 .claude/commands/gc-update-global-context.md     ← update slash command

package/docs/usage.zh.md

@@ -145,6 +145,7 @@ gctree scaffold --host both --target /path/to/repo
 
 ```
 AGENTS.md                                  ← gctree 代码片段追加到 agent 指令中
+.codex/hooks.json                         ← SessionStart / UserPromptSubmit 自动 resolve hook
 .codex/prompts/gctree-bootstrap.md         ← Codex 会话的引导上下文
 .codex/skills/gc-resolve-context/SKILL.md  ← resolve 技能
 .codex/skills/gc-onboard/SKILL.md          ← onboarding 技能
@@ -155,7 +156,8 @@ AGENTS.md                                  ← gctree 代码片段追加到 agen
 
 ```
 CLAUDE.md                                        ← gctree 代码片段追加
-.claude/hooks/gctree-session-start.md            ← 会话启动钩子
+.claude/hooks/hooks.json                         ← SessionStart / UserPromptSubmit 自动 resolve hook
+.claude/hooks/gctree-session-start.md            ← 会话启动 fallback 说明
 .claude/commands/gc-resolve-context.md           ← resolve 斜杠命令
 .claude/commands/gc-onboard.md                   ← onboard 斜杠命令
 .claude/commands/gc-update-global-context.md     ← 更新斜杠命令

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@handsupmin/gc-tree",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Global Context Tree, a lightweight branch-aware global context orchestrator for AI coding tools",
   "type": "module",
   "private": false,