@handsupmin/gc-tree 0.4.5 → 0.5.1

package/dist/src/hook.js

@@ -56,7 +56,7 @@ function buildMatchContext({ gcBranch, currentRepo, repoScopeStatus, query, matc
         `Query: "${query}".`,
         `Use these matching gc-tree summaries before planning or implementation:`,
         formatMatches(matches),
-        `Read full docs only if the summaries are insufficient.`,
+        `Read full docs only if the summaries are insufficient. Each doc has a ## Summary section at the top — read that before the full body.`,
     ].join('\n');
 }
 async function readHookCache(home, sessionId) {

package/dist/src/markdown.js

@@ -27,6 +27,9 @@ export function renderDocMarkdown(doc) {
         ...(doc.tags && doc.tags.length > 0
             ? ['## Tags', '', ...doc.tags.map((tag) => `- ${tag}`), '']
             : []),
+        ...(doc.indexEntries && doc.indexEntries.length > 0
+            ? ['## Index Entries', '', ...doc.indexEntries.map((entry) => `- ${entry}`), '']
+            : []),
         '## Details',
         '',
         body || '(no details yet)',
@@ -124,6 +127,17 @@ export function parseIndexEntries(indexContent) {
         return [{ id: docIdFromPath(path), title: label, label, category, path }];
     });
 }
+export function extractIndexEntries(markdown) {
+    const match = String(markdown || '').match(/## Index Entries\s+([\s\S]*?)(?:\n## |$)/);
+    if (!match?.[1])
+        return [];
+    return match[1]
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith('- '))
+        .map((line) => line.slice(2).trim())
+        .filter(Boolean);
+}
 export function extractSummary(markdown) {
     const match = String(markdown || '').match(/## Summary\s+([\s\S]*?)(?:\n## |$)/);
     return match?.[1]?.trim() || '';

package/dist/src/onboarding-protocol.js

@@ -26,6 +26,9 @@ export function onboardingProtocolLines() {
         'Synthesize the interview into an encyclopedia-style context set with many small docs instead of a few broad docs.',
         'Prefer category directories such as `docs/role/`, `docs/repos/`, `docs/domain/`, `docs/workflows/`, `docs/conventions/`, and `docs/infra/` whenever that split fits the material.',
         'Prefer one concept, one repository, one workflow, or one convention per file when possible.',
+        'Treat `index.md` as concept-first: show the keywords a user or AI would search for, not just broad document titles.',
+        'Generate index entries automatically from primary concept names, aliases, repository nicknames, and workflow labels when those are clear.',
+        'Split glossary docs when a concept is likely to be searched directly, needs more than a short definition, or carries workflow/constraint details; keep only low-value leftover terms in a shared glossary.',
         'Keep each doc summary-first so the top section gives the gist before deeper details.',
         'Treat `index.md` as a human-readable dictionary-style table of contents grouped by category headings and `label -> path` entries.',
     ];

package/dist/src/resolve.js

@@ -44,7 +44,8 @@ function scoreText(text, query) {
 async function readBranchDocs(home, branch) {
     const indexRaw = await readFile(branchIndexPath(home, branch), 'utf8');
     const entries = parseIndexEntries(indexRaw);
-    return Promise.all(entries.map(async (entry) => {
+    const uniqueEntries = [...new Map(entries.map((entry) => [entry.path, entry])).values()];
+    return Promise.all(uniqueEntries.map(async (entry) => {
         const fullPath = join(branchDir(home, branch), entry.path);
         const raw = await readFile(fullPath, 'utf8');
         return {

package/dist/src/store.js

@@ -2,7 +2,7 @@ import { cp, mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { branchDir, branchDocsDir, branchIndexPath, branchMetaPath, branchesRoot, DEFAULT_BRANCH, headPath, INDEX_WARNING_CHARS, } from './paths.js';
-import { renderIndexMarkdown } from './markdown.js';
+import { extractIndexEntries, renderIndexMarkdown } from './markdown.js';
 async function listDocRelativePaths(dir, prefix = '') {
     const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
     const files = [];
@@ -115,10 +115,18 @@ export async function writeIndexFromDocs(home, branch) {
         const parts = file.replace(/\.md$/i, '').split('/').filter(Boolean);
         const category = parts.length > 1 ? parts[0] : 'general';
         const label = parts.length > 1 ? parts[parts.length - 1] : title;
-        return { title, label, category, path: `docs/${file}` };
+        const indexEntries = extractIndexEntries(raw);
+        const entryLabels = indexEntries.length > 0 ? indexEntries : [label];
+        return entryLabels.map((entryLabel) => ({
+            title,
+            label: entryLabel,
+            category,
+            path: `docs/${file}`,
+        }));
     }));
+    const flatDocs = docs.flat().sort((a, b) => a.label.localeCompare(b.label));
     const meta = await readBranchMeta(home, branch);
-    const index = renderIndexMarkdown({ branch, branchSummary: meta.summary, docs });
+    const index = renderIndexMarkdown({ branch, branchSummary: meta.summary, docs: flatDocs });
     await writeFile(branchIndexPath(home, branch), index, 'utf8');
     return { index_path: branchIndexPath(home, branch), doc_count: docs.length };
 }

package/package.json

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

package/skills/onboard/SKILL.md

@@ -35,6 +35,9 @@ Use this when a user wants to create global context for a product, company, or w
 - prefer an encyclopedia-style context set with many small docs instead of a few broad docs
 - prefer category directories like `docs/role/`, `docs/repos/`, `docs/domain/`, `docs/workflows/`, `docs/conventions/`, and `docs/infra/`
 - prefer one concept, one repository, one workflow, or one convention per file when possible
+- treat `index.md` as concept-first: surface the keywords a user or AI would search for, not just broad document titles
+- generate index entries automatically from primary concept names, aliases, repository nicknames, and workflow labels when those are clear
+- split glossary docs when a concept is likely to be searched directly, needs more than a short definition, or carries workflow/constraint details; keep only low-value leftover terms in a shared glossary
 - keep `index.md` as a human-readable dictionary-style TOC grouped by category headings and `label -> path` entries
 - use onboarding only for an empty gc-branch