@chrisdudek/yg 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/bin.js CHANGED
@@ -123,6 +123,7 @@ You have fundamentally broken Yggdrasil if you do any of the following:
123
123
  - \u274C You ran \`yg drift-sync\` before updating graph artifacts.
124
124
  - \u274C You ran \`yg drift-sync\` after a graph-only change without verifying source files.
125
125
  - \u274C You used Blackbox coverage for greenfield/new code.
126
+ - \u274C You answered a question about a mapped file/area without running \`yg build-context\` when the path was known.
126
127
 
127
128
  ---
128
129
 
@@ -137,7 +138,15 @@ Always execute these commands before doing anything else. *(Exception: If the us
137
138
  3. \`yg status\` -> Report graph health.
138
139
  4. \`yg validate\` -> If W008 stale-knowledge appears, update the knowledge artifacts to reflect current node state.
139
140
 
140
- ### B. Session Verification (Wrap-up)
141
+ ### B. Answering Questions (When a specific file or area is known)
142
+ When the user asks a question and you know (or can infer) which file or area of the codebase it concerns:
143
+ 1. Run \`yg owner --file <path>\` for the relevant file(s).
144
+ 2. **If owner FOUND:** Run \`yg build-context --node <node_path>\` and base your answer on that context. Do NOT answer from grep/search alone \u2014 the graph provides intent, constraints, and relations that yield better answers.
145
+ 3. **If owner NOT FOUND:** The file is outside the graph (e.g. third-party code, user's theme/plugin, unmapped area). You may answer from grep/search, but state that the answer is not graph-based.
146
+
147
+ This applies even when you are **not modifying files** \u2014 e.g. when providing code snippets to paste elsewhere, explaining behavior, or suggesting hooks. If the question touches mapped code, build-context first.
148
+
149
+ ### C. Session Verification (Wrap-up)
141
150
  Triggered by phrases like: "we're done", "wrap up", "that's enough", "done", "ok".
142
151
  **Note: The graph should ALREADY be up to date. If the graph requires massive updates at this stage, YOU HAVE FAILED.**
143
152
  1. If iterative journal mode was used: consolidate notes to the graph, then \`yg journal-archive\`.