@handsupmin/gc-tree 0.4.4 → 0.5.0

package/README.es.md

@@ -2,6 +2,18 @@
 
 <div align="center">
 
+```text
+              __                          
+             /\ \__                       
+   __     ___\ \ ,_\  _ __    __     __   
+ /'_ `\  /'___\ \ \/ /\`'__\/'__`\ /'__`\ 
+/\ \L\ \/\ \__/\ \ \_\ \ \//\  __//\  __/ 
+\ \____ \ \____\\ \__\\ \_\\ \____\ \____\
+ \/___L\ \/____/ \/__/ \/_/ \/____/\/____/
+   /\____/                                
+   \_/__/                                 
+```
+
 <img src="./logo.png" alt="logo de gc-tree" width="260" />
 
 ### Contexto global, más allá del proyecto.

package/README.ja.md

@@ -2,6 +2,18 @@
 
 <div align="center">
 
+```text
+              __                          
+             /\ \__                       
+   __     ___\ \ ,_\  _ __    __     __   
+ /'_ `\  /'___\ \ \/ /\`'__\/'__`\ /'__`\ 
+/\ \L\ \/\ \__/\ \ \_\ \ \//\  __//\  __/ 
+\ \____ \ \____\\ \__\\ \_\\ \____\ \____\
+ \/___L\ \/____/ \/__/ \/_/ \/____/\/____/
+   /\____/                                
+   \_/__/                                 
+```
+
 <img src="./logo.png" alt="gc-tree logo" width="260" />
 
 ### プロジェクトの外まで届くグローバルコンテキスト。

package/README.ko.md

@@ -2,6 +2,18 @@
 
 <div align="center">
 
+```text
+              __                          
+             /\ \__                       
+   __     ___\ \ ,_\  _ __    __     __   
+ /'_ `\  /'___\ \ \/ /\`'__\/'__`\ /'__`\ 
+/\ \L\ \/\ \__/\ \ \_\ \ \//\  __//\  __/ 
+\ \____ \ \____\\ \__\\ \_\\ \____\ \____\
+ \/___L\ \/____/ \/__/ \/_/ \/____/\/____/
+   /\____/                                
+   \_/__/                                 
+```
+
 <img src="./logo.png" alt="gc-tree 로고" width="260" />
 
 ### 프로젝트 밖까지 이어지는 글로벌 컨텍스트.

package/README.md

@@ -2,6 +2,18 @@
 
 <div align="center">
 
+```text
+              __                          
+             /\ \__                       
+   __     ___\ \ ,_\  _ __    __     __   
+ /'_ `\  /'___\ \ \/ /\`'__\/'__`\ /'__`\ 
+/\ \L\ \/\ \__/\ \ \_\ \ \//\  __//\  __/ 
+\ \____ \ \____\\ \__\\ \_\\ \____\ \____\
+ \/___L\ \/____/ \/__/ \/_/ \/____/\/____/
+   /\____/                                
+   \_/__/                                 
+```
+
 <img src="./logo.png" alt="gc-tree logo" width="260" />
 
 ### Global context, beyond the project.

package/README.zh.md

@@ -2,6 +2,18 @@
 
 <div align="center">
 
+```text
+              __                          
+             /\ \__                       
+   __     ___\ \ ,_\  _ __    __     __   
+ /'_ `\  /'___\ \ \/ /\`'__\/'__`\ /'__`\ 
+/\ \L\ \/\ \__/\ \ \_\ \ \//\  __//\  __/ 
+\ \____ \ \____\\ \__\\ \_\\ \____\ \____\
+ \/___L\ \/____/ \/__/ \/_/ \/____/\/____/
+   /\____/                                
+   \_/__/                                 
+```
+
 <img src="./logo.png" alt="gc-tree logo" width="260" />
 
 ### 不止于项目内部的全局上下文。

package/ascii-logo.txt

@@ -0,0 +1,9 @@
+              __                          
+             /\ \__                       
+   __     ___\ \ ,_\  _ __    __     __   
+ /'_ `\  /'___\ \ \/ /\`'__\/'__`\ /'__`\ 
+/\ \L\ \/\ \__/\ \ \_\ \ \//\  __//\  __/ 
+\ \____ \ \____\\ \__\\ \_\\ \____\ \____\
+ \/___L\ \/____/ \/__/ \/_/ \/____/\/____/
+   /\____/                                
+   \_/__/

package/ascii-tree.txt

@@ -0,0 +1,44 @@
+                                                                                
+                                     QzczXO                                     
+                                    Yvczzvvz                                    
+                                   Juvw  cvc                                    
+                          JzXY      YvvXXuvc      zXXY                          
+                        CvvccvcU      zuvX      zvvcvvcY                        
+                        cvU  QvcO     \uu:      vX:  JvX                        
+                        Yvv0:zvc      \uu:      vvY ZcvC                        
+               XvvvvcU   UcvvvX   YX  \uu: 0vc   cvvccL   XvvvvcY               
+              Uvc: Ycvv    vvv   bcu  \uv: Ovc    vvU    Qvc   cvC              
+              UvcO Ocvv    cvvX  Ycu  \uuO Zvc   XvvJ    Zvca OvvC              
+               UvvvvvQ vuu  LcvvuUcu  \uuO ZvczvvvcO  cuY QvvvvvJ               
+      \zcccX     Quv   cvv     Ycvvu  \uuO XvvvcX     zvY   XvU     zzzzX       
+     zvucucvcL   Quv   cvv       Ycu  \uuzuvvz        zvU   XvU   cvvcucvcY     
+     cvU   zvc   JvvU  zvvvQ     acu  \uvvvY        JvvvY  CvvU   JvY   cvX     
+     UvvzczvvJ    0cvvcXOYvvvzJ  cvvYX\uvc       Yzvvvz YcvvvC    zvvzczvcJ     
+       LvvvU         XcvvzXXcvvcJ Uvvvvvvc     JcvvvXXzvvcXO        zvvuO       
+        Cvc            OXzzzzzXuvvz zUvvvc  OXvvuXXzzzzXO           OccO        
+ Yvvvvvz zvvuU  zvvvvvc          vvvd nvvc OvvvY         wvvvvvY OUvvvX 0vvvvvY 
+cvX  QvvzXYUcvvvvJ  CvvY         Mvva uvvc ZvvO         cvz: OzvvvvXUUXXvza Ycvz
+cvY  acvuuuuuuuvvC  UvvcX        Mcvh uvvc mvva       OXvvz   Xvuuuuuuuuvz   Xvz
+CcvvvvvY       zzvvvvvvvvvcL     zvvk nvvc Ovva     OvvvcYvvvvvcO       Uvvcvvz\
+         zzuvvXz         Yuvvcv  avvZ nvvv mvvY  zzvvuU         Jzuvvzz         
+        UvvYYUvv0obhhhhoh*hoXvvvzUvv0 nvvc ZvvJXvvvzhao##h##hhhQvvUJUcvU        
+        Uvz   Yvvvvvvvvvvvvvvvvvvvvv0 uvvv muvvvvvvvvvvvvvvvvvvvvY   cvY        
+        JcvcCcvcb              zXvvvvvvvvvvvvvvJO              bvvcLcvcC        
+          CzvzL                   YuvvvvvvvvvQ                   CXvYL          
+                                    Jcvvvvvm                                    
+                                    CvvvvvvZ                                    
+                                    zvvvvvvY                                    
+                                    cvvvvvvJ                                    
+                                    nuvvvvuc                                    
+                                    uuvvvvuc                                    
+                                    vvvvvvuu                                    
+                                    Jvvvvvvu                                    
+                                    zvvvvvvv                                    
+                                    JvvvvvvU                                    
+                                    vvvvvvvU                                    
+                                   Ovvvvvvvc                                    
+                                   JuvvvvvvuL                                   
+                                  zvvvvvvvvvvY                                  
+                              OXzvvvvzvvvzcvvvvzXO                              
+                          YYcvvvvvvXCzvvvvX:XvvvvvvcXQ                          
+                       YYYYYYYYUXO QUUUYUUYC: OcYUYUYYYYz                       

package/dist/src/ascii.js

@@ -0,0 +1,25 @@
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+async function readAsciiAsset(fileName) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(here, '..', fileName),
+        join(here, '..', '..', fileName),
+    ];
+    for (const candidate of candidates) {
+        try {
+            return await readFile(candidate, 'utf8');
+        }
+        catch {
+            continue;
+        }
+    }
+    throw new Error(`ascii asset not found: ${fileName}`);
+}
+export async function readAsciiLogo() {
+    return readAsciiAsset('ascii-logo.txt');
+}
+export async function readAsciiTree() {
+    return readAsciiAsset('ascii-tree.txt');
+}

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 { stdin, stderr, stdout } from 'node:process';
+import { readAsciiLogo, readAsciiTree } from './ascii.js';
 import { dispatchGcTreeHook } from './hook.js';
 import { onboardBranch } from './onboard.js';
 import { buildProviderLaunchPlan, maybeLaunchProvider, promptLanguageSelection, promptLaunchProviderSelection, promptProviderSelection, } from './provider.js';
@@ -20,8 +21,23 @@ function readArg(flag) {
 function hasFlag(flag) {
     return process.argv.includes(flag);
 }
+async function readPackageVersion() {
+    const candidates = ['../package.json', '../../package.json'];
+    for (const relative of candidates) {
+        try {
+            const raw = await readFile(new URL(relative, import.meta.url), 'utf8');
+            return JSON.parse(raw).version || '0.0.0';
+        }
+        catch {
+            continue;
+        }
+    }
+    return '0.0.0';
+}
 function usage() {
     console.error(`Usage:
+  gctree --version
+  gctree plant
   gctree init [--home DIR] [--provider <claude-code|codex|both>] [--language TEXT] [--target DIR] [--no-launch]
   gctree checkout <branch> [--home DIR]
   gctree checkout -b <branch> [--home DIR]
@@ -123,13 +139,28 @@ async function launchGuidedFlow({ provider, providerMode, preferredLanguage, tar
     return maybeLaunchProvider(plan);
 }
 async function main() {
+    if (hasFlag('--version') || hasFlag('-v')) {
+        stdout.write(`${await readPackageVersion()}\n`);
+        return;
+    }
     const rawCommand = process.argv[2];
     if (!rawCommand || rawCommand === '--help' || rawCommand === 'help')
         usage();
     const command = rawCommand === 'update-gc' || rawCommand === 'ugc' ? 'update-global-context' : rawCommand;
     const home = resolveHome(readArg('--home'));
     switch (command) {
+        case 'plant': {
+            const asciiTree = await readAsciiTree();
+            stdout.write(asciiTree);
+            if (!asciiTree.endsWith('\n'))
+                stdout.write('\n');
+            return;
+        }
         case 'init': {
+            const asciiLogo = await readAsciiLogo();
+            stderr.write(asciiLogo);
+            if (!asciiLogo.endsWith('\n'))
+                stderr.write('\n');
             const providerMode = await maybePromptProviderMode(readArg('--provider'));
             const provider = await resolveLaunchProvider(providerMode);
             const preferredLanguage = await maybePromptLanguage(readArg('--language'));

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.4",
+  "version": "0.5.0",
   "description": "Global Context Tree, a lightweight branch-aware global context orchestrator for AI coding tools",
   "type": "module",
   "private": false,
@@ -9,6 +9,8 @@
     "skills",
     "scaffolds",
     "docs",
+    "ascii-logo.txt",
+    "ascii-tree.txt",
     "README.md",
     "LICENSE"
   ],

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