@handsupmin/gc-tree 0.7.12 → 0.7.14

package/dist/src/hook.js

@@ -6,6 +6,7 @@ import { hookCachePath, } from './paths.js';
 import { branchScopeStatus, readBranchRepoMap, resolveBranchForRepo } from './repo-map.js';
 import { resolveContext } from './resolve.js';
 import { readHead, statusForBranch } from './store.js';
+const SELF_REVIEW_INTERVAL = 5;
 function normalizeText(value) {
     return value.trim().replace(/\s+/g, ' ');
 }
@@ -59,6 +60,15 @@ function buildMatchContext({ gcBranch, currentRepo, repoScopeStatus, query, matc
         `Read full docs (gctree resolve --id <id>) only if summaries are insufficient. Each doc has a ## Summary section — read that first.`,
     ].join('\n');
 }
+function buildSelfReviewAppend(promptCount) {
+    return [
+        `\n[gc-tree] CONTEXT SELF-REVIEW (every ${SELF_REVIEW_INTERVAL} prompts — this is prompt #${promptCount}):`,
+        `At the END of your response to this task, review the current gc-tree global context and compare it against what you have observed or changed in this session.`,
+        `If any docs need updating (new conventions discovered, corrected info, new repos or workflows, outdated content), propose the specific changes to the user and ask whether to apply them.`,
+        `Use \`/gc-update-global-context\` (Claude Code) or \`gctree update-global-context\` (CLI) to apply.`,
+        `If nothing meaningful changed, skip silently — do not mention this review to the user.`,
+    ].join('\n');
+}
 async function readHookCache(home, sessionId) {
     try {
         const raw = await readFile(hookCachePath(home, sessionId), 'utf8');
@@ -87,6 +97,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,
+        prompt_count: (previous?.prompt_count ?? 0) + 1,
         updated_at: new Date().toISOString(),
     };
 }
@@ -126,84 +137,43 @@ export async function dispatchGcTreeHook({ event, home, payload, }) {
         currentRepo,
         repoScopeStatus,
     });
+    let additionalContext;
     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,
-                }),
-            },
-        };
+        additionalContext = buildExcludedContext({
+            gcBranch,
+            currentRepo,
+            cached: previousCache?.branch_excluded === true,
+        });
     }
-    if (branchStatus.doc_count === 0) {
+    else 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,
-                }),
-            },
-        };
+        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,
-                }),
-            },
-        };
+    else {
+        const query = currentRepo ? `${currentRepo} ${prompt}` : prompt;
+        const signature = hashQuery(query);
+        if (cache.no_match_signatures.includes(signature)) {
+            additionalContext = buildNoMatchContext({ gcBranch, currentRepo, query, cached: true });
+        }
+        else {
+            const result = await resolveContext({ home, branch: gcBranch, query });
+            if (result.matches.length === 0) {
+                cache.no_match_signatures = [...new Set([...cache.no_match_signatures, signature])];
+                additionalContext = buildNoMatchContext({ gcBranch, currentRepo, query, cached: false });
+            }
+            else {
+                cache.no_match_signatures = cache.no_match_signatures.filter((entry) => entry !== signature);
+                additionalContext = buildMatchContext({ gcBranch, currentRepo, repoScopeStatus, query, matches: result.matches });
+            }
+        }
+        if (cache.prompt_count > 0 && cache.prompt_count % SELF_REVIEW_INTERVAL === 0) {
+            additionalContext += buildSelfReviewAppend(cache.prompt_count);
+            cache.prompt_count = 0;
+        }
     }
-    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,
-            }),
-        },
-    };
+    return { hookSpecificOutput: { hookEventName: event, additionalContext } };
 }

package/dist/src/markdown.js

@@ -71,9 +71,22 @@ export function ensureSummary(summary) {
     }
     return trimmed;
 }
+function normalizeBody(raw, title) {
+    let s = raw.trim();
+    // Strip leading "# <title>" line (already rendered at top level)
+    const titleLine = `# ${title.trim()}`;
+    if (s.startsWith(titleLine))
+        s = s.slice(titleLine.length).trimStart();
+    // Strip leading "## Summary" block (already rendered at top level)
+    if (s.startsWith('## Summary')) {
+        const next = s.match(/\n(?=## )/);
+        s = next ? s.slice(next.index).trimStart() : '';
+    }
+    return s;
+}
 export function renderDocMarkdown(doc) {
     const summary = ensureSummary(doc.summary);
-    const body = String(doc.body || '').trim();
+    const body = normalizeBody(String(doc.body || ''), doc.title);
     const normalizedIndexEntries = [...new Set([
             ...(doc.indexLabel?.trim() ? [doc.indexLabel.trim()] : []),
             ...(doc.indexEntries || []).map((entry) => String(entry || '').trim()).filter(Boolean),

package/package.json

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