@handsupmin/gc-tree 0.7.0 → 0.7.1

package/dist/src/markdown.js

@@ -7,6 +7,29 @@ export function slugify(value) {
         .replace(/^-|-$/g, '');
     return normalized || 'doc';
 }
+function parseDocReference(value) {
+    const trimmed = String(value || '').trim().replace(/^\.?\//, '');
+    if (!trimmed)
+        return null;
+    const normalized = trimmed.replace(/\\/g, '/');
+    const docsMatch = normalized.match(/^docs\/([^/]+)\/([^/]+?)(?:\.md)?$/i);
+    if (docsMatch) {
+        const category = normalizeCategory(docsMatch[1]);
+        const slug = slugify(docsMatch[2]);
+        if (slug === 'index')
+            return null;
+        return { category, slug, label: docsMatch[2].replace(/\.md$/i, '').trim() };
+    }
+    const directMatch = normalized.match(/^(role|repos|domain|workflows|conventions|infra|verification)\/([^/]+?)(?:\.md)?$/i);
+    if (directMatch) {
+        const category = normalizeCategory(directMatch[1]);
+        const slug = slugify(directMatch[2]);
+        if (slug === 'index')
+            return null;
+        return { category, slug, label: directMatch[2].replace(/\.md$/i, '').trim() };
+    }
+    return null;
+}
 export function ensureSummary(summary) {
     const trimmed = String(summary || '').trim();
     if (!trimmed) {
@@ -158,6 +181,35 @@ export function extractIndexEntries(markdown) {
         .map((line) => line.slice(2).trim())
         .filter(Boolean);
 }
+export function normalizeIndexEntry(value, fallback) {
+    const reference = parseDocReference(value);
+    if (reference) {
+        return {
+            category: reference.category,
+            label: reference.label,
+        };
+    }
+    const trimmed = String(value || '').trim();
+    if (!trimmed)
+        return null;
+    if (/^docs\/index\.md$/i.test(trimmed) || /^index\.md$/i.test(trimmed))
+        return null;
+    return {
+        category: fallback.category,
+        label: trimmed,
+    };
+}
+export function inferDocPlacement(input) {
+    for (const candidate of [input.slug, input.indexLabel]) {
+        const reference = parseDocReference(candidate || '');
+        if (reference) {
+            return { category: reference.category, slug: reference.slug };
+        }
+    }
+    const explicitCategory = input.category ? slugify(input.category) : null;
+    const slug = slugify(input.slug || input.indexLabel || input.title);
+    return { category: explicitCategory, slug };
+}
 export function extractSummary(markdown) {
     const match = String(markdown || '').match(/## Summary\s+([\s\S]*?)(?:\n## |$)/);
     return match?.[1]?.trim() || '';

package/dist/src/onboard.js

@@ -1,13 +1,13 @@
 import { mkdir, rm, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
-import { renderDocMarkdown, slugify } from './markdown.js';
+import { inferDocPlacement, renderDocMarkdown } from './markdown.js';
 import { branchDocsDir, DEFAULT_BRANCH } from './paths.js';
 import { ensureBranchExists, updateBranchMeta, writeIndexFromDocs } from './store.js';
 function docRelativePath(doc) {
     if (doc.slug?.includes('/'))
         return `${doc.slug.replace(/\.md$/i, '')}.md`;
-    const fileBase = slugify(doc.slug || doc.indexLabel || doc.title);
-    const category = doc.category ? slugify(doc.category) : '';
+    const { category, slug } = inferDocPlacement(doc);
+    const fileBase = slug;
     return category ? `${category}/${fileBase}.md` : `${fileBase}.md`;
 }
 export async function onboardBranch({ home, input, branch, }) {

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, } from './paths.js';
-import { extractIndexEntries, renderIndexMarkdown } from './markdown.js';
+import { extractIndexEntries, inferDocPlacement, normalizeIndexEntry, renderIndexMarkdown } from './markdown.js';
 async function listDocRelativePaths(dir, prefix = '') {
     const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
     const files = [];
@@ -113,14 +113,19 @@ export async function writeIndexFromDocs(home, branch) {
         const raw = await readFile(join(docsDir, file), 'utf8');
         const title = raw.match(/^#\s+(.+)$/m)?.[1]?.trim() || file.replace(/\.md$/i, '').replace(/-/g, ' ');
         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;
-        const indexEntries = extractIndexEntries(raw);
-        const entryLabels = indexEntries.length > 0 ? indexEntries : [label];
-        return entryLabels.map((entryLabel) => ({
+        const fallbackCategory = parts.length > 1 ? parts[0] : 'general';
+        const fallbackLabel = parts.length > 1 ? parts[parts.length - 1] : title;
+        const inferred = inferDocPlacement({ title, indexLabel: title });
+        const docCategory = inferred.category || fallbackCategory;
+        const indexEntries = extractIndexEntries(raw)
+            .map((entry) => normalizeIndexEntry(entry, { category: docCategory, label: fallbackLabel }))
+            .filter((entry) => Boolean(entry));
+        const entryLabels = indexEntries.length > 0 ? indexEntries : [{ category: docCategory, label: fallbackLabel }];
+        const uniqueEntries = [...new Map(entryLabels.map((entry) => [`${entry.category}::${entry.label}`, entry])).values()];
+        return uniqueEntries.map((entry) => ({
             title,
-            label: entryLabel,
-            category,
+            label: entry.label,
+            category: entry.category,
             path: `docs/${file}`,
         }));
     }));

package/package.json

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