@handsupmin/gc-tree 0.8.6 → 0.8.8

package/dist/src/hook.js

@@ -42,11 +42,15 @@ function buildNoMatchContext({ gcBranch, currentRepo, cached, }) {
     return `[gc-tree] no match: gc-branch="${gcBranch}" repo="${currentRepo || 'unscoped'}"${cached ? ' cached=true' : ''}.`;
 }
 function buildMatchContext({ gcBranch, currentRepo, repoScopeStatus, matches, }) {
-    return [
+    const lines = [
         `[gc-tree] USE FIRST: ${Math.min(matches.length, 3)} docs gc-branch="${gcBranch}" repo="${currentRepo || 'unscoped'}" scope=${repoScopeStatus}.`,
         formatMatches(matches),
         `Rule: apply these docs before tools; if insufficient, open full doc: gctree resolve --id <id>`,
-    ].join('\n');
+    ];
+    if (repoScopeStatus === 'unmapped' && currentRepo) {
+        lines.push(`Note: repo "${currentRepo}" is unmapped. If it belongs here, offer to run: gctree set-repo-scope --branch ${gcBranch} --include`);
+    }
+    return lines.join('\n');
 }
 function buildSelfReviewAppend(promptCount) {
     return [
@@ -81,6 +85,7 @@ function nextCacheState(previous, { sessionId, gcBranch, currentRepo, repoScopeS
         branch_empty: changed ? false : previous.branch_empty,
         branch_excluded: changed ? false : previous.branch_excluded,
         no_match_signatures: changed ? [] : previous.no_match_signatures,
+        unmapped_shown_repos: previous?.unmapped_shown_repos ?? [],
         prompt_count: (previous?.prompt_count ?? 0) + 1,
         last_session_start_signature: previous?.last_session_start_signature,
         last_session_start_at: previous?.last_session_start_at,
@@ -119,6 +124,7 @@ export async function dispatchGcTreeHook({ event, home, payload, }) {
             branch_empty: previousCache?.branch_empty ?? false,
             branch_excluded: previousCache?.branch_excluded ?? false,
             no_match_signatures: previousCache?.no_match_signatures ?? [],
+            unmapped_shown_repos: previousCache?.unmapped_shown_repos ?? [],
             prompt_count: previousCache?.prompt_count ?? 0,
             last_session_start_signature: signature,
             last_session_start_at: now.toISOString(),
@@ -169,21 +175,42 @@ export async function dispatchGcTreeHook({ event, home, payload, }) {
         cache.branch_empty = true;
         additionalContext = buildEmptyBranchContext({ gcBranch, currentRepo, cached: wasCached });
     }
+    else if (repoScopeStatus === 'unmapped' && currentRepo && cache.unmapped_shown_repos.includes(currentRepo)) {
+        // Already showed context for this unmapped repo this session — skip silently.
+        cache.updated_at = now.toISOString();
+        await writeHookCache(home, cache);
+        return null;
+    }
     else {
-        const query = currentRepo ? `${currentRepo} ${prompt}` : prompt;
+        // For unmapped repos: use prompt only (no repo prefix) to avoid bias; apply higher score threshold.
+        const isUnmapped = repoScopeStatus === 'unmapped';
+        const query = !isUnmapped && currentRepo ? `${currentRepo} ${prompt}` : prompt;
         const signature = hashQuery(query);
-        if (cache.no_match_signatures.includes(signature)) {
+        if (!isUnmapped && cache.no_match_signatures.includes(signature)) {
             additionalContext = buildNoMatchContext({ gcBranch, currentRepo, cached: true });
         }
         else {
             const result = await resolveContext({ home, branch: gcBranch, query });
-            if (result.matches.length === 0) {
+            const effectiveMatches = result.matches;
+            if (effectiveMatches.length === 0) {
+                if (isUnmapped) {
+                    // Unmapped + no strong match: skip silently, no noise.
+                    cache.updated_at = now.toISOString();
+                    await writeHookCache(home, cache);
+                    return null;
+                }
                 cache.no_match_signatures = [...new Set([...cache.no_match_signatures, signature])];
                 additionalContext = buildNoMatchContext({ gcBranch, currentRepo, cached: false });
             }
             else {
-                cache.no_match_signatures = cache.no_match_signatures.filter((entry) => entry !== signature);
-                additionalContext = buildMatchContext({ gcBranch, currentRepo, repoScopeStatus, matches: result.matches });
+                if (!isUnmapped) {
+                    cache.no_match_signatures = cache.no_match_signatures.filter((entry) => entry !== signature);
+                }
+                else if (currentRepo) {
+                    // Mark this unmapped repo as shown so we don't repeat next prompt.
+                    cache.unmapped_shown_repos = [...new Set([...cache.unmapped_shown_repos, currentRepo])];
+                }
+                additionalContext = buildMatchContext({ gcBranch, currentRepo, repoScopeStatus, matches: effectiveMatches });
             }
         }
         if (cache.prompt_count > 0 && cache.prompt_count % SELF_REVIEW_INTERVAL === 0) {

package/dist/src/scaffold.js

@@ -8,8 +8,9 @@ function renderCodexAgentsSnippet() {
         '',
         '- Treat the active gctree branch as a **gc-branch** when you describe it to users.',
         '- gctree init installs SessionStart and UserPromptSubmit hooks that auto-check gc-tree before work.',
-        '- When you encounter an unfamiliar term, acronym, concept, or domain word, follow this scope-aware protocol **before** grepping or reading code files:',
-        '  1. Always run `gctree resolve --query "<term>"` first. If matched, use the result directly.',
+        '- Before starting ANY codebase task — new feature, schema change, bug fix, admin work, or any question about how something works — run `gctree resolve` first. Do not assume you know the domain from code alone. Field names, model names, repo names, and feature names are NOT self-explanatory; always verify workflows and cross-repo relationships via gc-tree before touching code.',
+        '- Follow this scope-aware protocol before any grep, file read, or code exploration:',
+        '  1. Always run `gctree resolve --query "<task or term>"` first. If matched, use the result directly.',
         '  2. Only if the current repo scope is **included** (not unmapped/excluded): if step 1 found nothing, try broader related queries to check if the concept exists in any doc.',
         '  3. If the concept exists in a doc but was not indexed → propose adding it as an Index Entry to that doc.',
         '  4. If it does not exist anywhere → decide whether a new doc is needed and propose it to the user.',
@@ -28,8 +29,8 @@ function renderCodexBootstrapPrompt() {
         '# gctree Bootstrap',
         '',
         '- Keep the active gc-branch explicit whenever global context matters.',
-        '- If you encounter an unfamiliar term, acronym, concept, domain word, or internal name, do **not** grep or read code first. Follow this exact order:',
-        '  1. Run `gctree resolve --query "<term>"`.',
+        '- Before any codebase task — feature, schema change, bug fix, admin work — do **not** grep or read code first. Follow this exact order:',
+        '  1. Run `gctree resolve --query "<task or term>"`.',
         '  2. If that misses, run broader related `gctree resolve` queries.',
         '  3. If the concept is documented but not indexed, propose adding it as an Index Entry to the right doc.',
         '  4. Only if gc-tree still does not answer it should you search code or repo docs.',
@@ -124,8 +125,9 @@ function renderClaudeSnippet() {
         '',
         '- Treat the active gctree branch as a **gc-branch** in user-facing language.',
         '- gctree init installs SessionStart and UserPromptSubmit hooks that auto-inject gc-tree context before every prompt.',
-        '- When you encounter an unfamiliar term, acronym, concept, or domain word, follow this scope-aware protocol **before** grepping or reading code files:',
-        '  1. Always run `gctree resolve --query "<term>"` first. If matched, use the result directly.',
+        '- Before starting ANY codebase task — new feature, schema change, bug fix, admin work, or any question about how something works — run `gctree resolve` first. Do not assume you know the domain from code alone. Field names, model names, repo names, and feature names are NOT self-explanatory; always verify workflows and cross-repo relationships via gc-tree before touching code.',
+        '- Follow this scope-aware protocol before any grep, file read, or code exploration:',
+        '  1. Always run `gctree resolve --query "<task or term>"` first. If matched, use the result directly.',
         '  2. Only if the current repo scope is **included** (not unmapped/excluded): if step 1 found nothing, try broader related queries to check if the concept exists in any doc.',
         '  3. If the concept exists in a doc but was not indexed → propose adding it as an Index Entry to that doc.',
         '  4. If it does not exist anywhere → decide whether a new doc is needed and propose it to the user.',

package/package.json

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