@chrisdudek/yg 2.10.0 → 2.12.0

package/dist/bin.js

@@ -59,11 +59,16 @@ var PROTOCOL = `## PROTOCOL
 This is your operating manual for working in a Yggdrasil-managed repository.
 
 <critical_protocol>
+BEFORE starting any task \u2014 brainstorming, design, planning, OR implementation:
+  \`yg select --task "<goal>"\` \u2192 \`yg build-context\` on each result \u2192 read ALL artifact files
+This is how you learn WHAT the system already knows before proposing anything.
+
 BEFORE reading, analyzing, or modifying ANY source file:
   \`yg build-context --file <path>\`
 One command. No exceptions. No "I'll do it later." No "this is just analysis."
 
-This is required because the graph captures intent and relations that source files cannot \u2014 without it, you will make wrong decisions and the user will have to re-explain what the graph already knows.
+Both triggers apply regardless of what instructed the task \u2014 skills, plans, workflows, user requests.
+The graph captures intent and relations that source files cannot \u2014 without it, you will make wrong decisions and the user will have to re-explain what the graph already knows.
 </critical_protocol>
 
 Every rule below is mandatory \u2014 no skill, plan, workflow, or instruction overrides these requirements.
@@ -76,6 +81,10 @@ Yggdrasil is persistent semantic memory stored in \`.yggdrasil/\`. It maps the r
 \`\`\`
 EVERY conversation: yg preflight \u2014 no exceptions.
 
+BEFORE any task (brainstorming, design, planning, implementation):
+  yg select --task "<goal>" \u2192 yg build-context on results \u2192 read ALL artifacts
+  The graph is your primary knowledge source. Raw file reads supplement it, never replace it.
+
 BEFORE any source file interaction:
   1. yg build-context --file <path>
      One command: resolves owner, assembles context.
@@ -209,6 +218,29 @@ Result: graph mirrors code but misses WHY. Next agent reads graph, understands H
 
 </example_wrong>
 
+<example_correct>
+
+User: "Let's design a soft delete feature for blog posts"
+
+1. yg select --task "blog soft delete" \u2192 find relevant nodes
+2. yg build-context on each result \u2192 read ALL artifacts (aspects, flows, conventions)
+3. Now read source files WITH graph context
+4. Propose design informed by admin-ux-rules, existing flows, database conventions
+
+</example_correct>
+
+<example_wrong>
+
+User: "Let's design a soft delete feature for blog posts"
+
+1. Read BlogEditor.tsx to understand current behavior \u2190 WRONG: no graph context
+2. Read database schema \u2190 WRONG: graph has conventions, aspects, flows
+3. Propose design based on raw code \u2190 WRONG: missed admin-ux-rules aspect, existing flows
+
+Result: design misses cross-cutting requirements the graph already captured.
+
+</example_wrong>
+
 ### Conversation Lifecycle
 
 \`\`\`
@@ -3955,6 +3987,7 @@ async function detectDrift(graph, filterNodePath) {
   const entries = [];
   for (const [nodePath, node] of graph.nodes) {
     if (filterNodePath && nodePath !== filterNodePath && !nodePath.startsWith(filterNodePath + "/")) continue;
+    if (node.meta.blackbox) continue;
     const mapping = node.meta.mapping;
     if (!mapping) continue;
     const mappingPaths = normalizeMappingPaths(mapping);
@@ -4053,6 +4086,7 @@ async function syncDriftState(graph, nodePath) {
   const node = graph.nodes.get(nodePath);
   if (!node) throw new Error(`Node not found: ${nodePath}`);
   if (!node.meta.mapping) throw new Error(`Node has no mapping: ${nodePath}`);
+  if (node.meta.blackbox) throw new Error(`Cannot sync blackbox node: ${nodePath}`);
   const trackedFiles = collectTrackedFiles(node, graph);
   const excludePrefixes = getChildMappingExclusions(graph, nodePath);
   const existingEntry = await readNodeDriftState(graph.rootPath, nodePath);
@@ -4238,7 +4272,7 @@ function registerDriftSyncCommand(program2) {
       const graph = await loadGraph(process.cwd());
       let nodesToSync;
       if (options.all) {
-        nodesToSync = [...graph.nodes.entries()].filter(([, n]) => normalizeMappingPaths(n.meta.mapping).length > 0).map(([p]) => p).sort();
+        nodesToSync = [...graph.nodes.entries()].filter(([, n]) => !n.meta.blackbox && normalizeMappingPaths(n.meta.mapping).length > 0).map(([p]) => p).sort();
       } else {
         const nodePath = options.node.trim().replace(/^\.\//, "").replace(/\/+$/, "");
         if (!graph.nodes.has(nodePath)) {