@handsupmin/gc-tree 0.7.8 → 0.7.10

package/dist/src/cli.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 import { existsSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
 import { stdin, stderr, stdout } from 'node:process';
 import { readAsciiLogo, readAsciiTree } from './ascii.js';
+import { gctreeGlobalRoot } from './integration-files.js';
 import { dispatchGcTreeHook } from './hook.js';
 import { onboardBranch } from './onboard.js';
 import { buildProviderLaunchPlan, maybeLaunchProvider, promptLanguageSelection, promptLaunchProviderSelection, promptProviderSelection, } from './provider.js';
@@ -525,9 +527,10 @@ async function main() {
             if (!host)
                 usage();
             const explicitTarget = readArg('--target');
+            const isGlobal = !explicitTarget || Object.values({ codex: gctreeGlobalRoot('codex'), claude: gctreeGlobalRoot('claude-code') }).some((r) => resolve(explicitTarget) === resolve(r));
             const result = await ensureScaffold({
                 providerMode: host,
-                ...(explicitTarget ? { targetDir: explicitTarget, scope: 'local' } : { scope: 'global' }),
+                ...(isGlobal ? { scope: 'global' } : { targetDir: explicitTarget, scope: 'local' }),
                 force: hasFlag('--force'),
             });
             console.log(JSON.stringify(result, null, 2));

package/dist/src/hook.js

@@ -52,11 +52,11 @@ function buildNoMatchContext({ gcBranch, currentRepo, query, cached, }) {
 }
 function buildMatchContext({ gcBranch, currentRepo, repoScopeStatus, query, matches, }) {
     return [
-        `gc-tree auto-resolve checked gc-branch "${gcBranch}" for repo "${currentRepo || 'unscoped'}" (scope: ${repoScopeStatus}) before this prompt.`,
-        `Query: "${query}".`,
-        `Use these matching gc-tree summaries before planning or implementation:`,
+        `[gc-tree] PRE-TASK CONTEXT — read before any tool use or code exploration.`,
+        `gc-branch: "${gcBranch}" | repo: "${currentRepo || 'unscoped'}" (scope: ${repoScopeStatus}) | query: "${query}".`,
+        `Do NOT call Explore, grep, or read code files until you have read and internalized these summaries:`,
         formatMatches(matches),
-        `Read full docs only if the summaries are insufficient. Each doc has a ## Summary section at the top — read that before the full body.`,
+        `Read full docs (gctree resolve --id <id>) only if summaries are insufficient. Each doc has a ## Summary section — read that first.`,
     ].join('\n');
 }
 async function readHookCache(home, sessionId) {

package/dist/src/scaffold.js

@@ -108,8 +108,9 @@ function renderClaudeSnippet() {
         '# gctree Claude Code integration snippet',
         '',
         '- Treat the active gctree branch as a **gc-branch** in user-facing language.',
-        '- gctree init installs SessionStart and UserPromptSubmit hooks that auto-check gc-tree before work.',
-        '- Use the hook-injected gc-tree context first. If hooks are unavailable or clearly stale, run `gctree status` and `gctree resolve --query "<task>"` yourself before planning or implementation.',
+        '- gctree init installs SessionStart and UserPromptSubmit hooks that auto-inject gc-tree context before every prompt.',
+        '- When a UserPromptSubmit hook provides `[gc-tree] PRE-TASK CONTEXT`, treat it as mandatory pre-reading. Read and internalize the injected summaries **before** calling any tools (Explore, grep, Read, Bash). Do not explore code first.',
+        '- If hooks are unavailable or clearly stale, run `gctree status` and `gctree resolve --query "<task>"` yourself before planning or implementation.',
         '- Use `/gc-onboard` only for an empty gc-branch.',
         '- Use `/gc-update-global-context` when durable context in the active gc-branch should change.',
         '',
@@ -119,7 +120,7 @@ function renderClaudeSessionStartHook() {
     return [
         '# gctree Claude Code SessionStart note',
         '',
-        '- gctree init installs real SessionStart/UserPromptSubmit hooks via `.claude/hooks/hooks.json`.',
+        '- gctree init installs real SessionStart/UserPromptSubmit hooks via `.claude/settings.json`.',
         '- At session start, use the injected hook context to confirm the active gc-branch.',
         '- Refer to gctree branches as **gc-branches** in user-facing language.',
         '- If hook context is missing or stale, resolve summaries before planning or implementation when branch-level context may change the answer.',

package/package.json

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