Clarify gather menu heading (#289)

* Clarify gather menu heading

* Orient agents before gather selection

Author: nahiyankhan

.changeset/clean-gather-menu-heading.md

@@ -0,0 +1,5 @@
+---
+"@design-intelligence/ghost": patch
+---
+
+Label gather output as a guidance menu instead of implying its guidance is preselected.

packages/ghost/src/commands/gather-command.ts

@@ -89,18 +89,19 @@ function formatMenuMarkdown(menu: GhostGatherResult): string {
   }
 
   const lines: string[] = [
-    "# Guidance for this task",
+    "# Guidance menu",
     "",
-    `Task: ${menu.ask}`,
+    "This is the complete, unfiltered menu. For the task below, check every `Applies when` condition and pull every applicable ID. The entries have not been selected or ranked.",
+    "",
+    "## Task",
+    "",
+    menu.ask,
     "",
-  ];
-
-  lines.push(
     "## Available guidance",
     "",
-    "Check every item below. Pull all applicable IDs together with `ghost pull <id> [<id>…]`. If no listed guidance applies, run bare `ghost pull` to receive the cover and uncovered-guidance policy. Skip clear non-matches; topic overlap alone is not enough. Do not limit the number.",
+    "Pull the applicable IDs together with `ghost pull <id> [<id>…]`. If no listed guidance applies, run bare `ghost pull` to receive the cover and uncovered-guidance policy. Skip clear non-matches; topic overlap alone is not enough. Do not limit the number.",
     "",
-  );
+  ];
 
   const groups = groupMenuByKind(menu.nodes, menu.kinds ?? []);
   for (const group of groups) {

packages/ghost/test/cli.test.ts

@@ -604,8 +604,13 @@ describe("ghost CLI", () => {
 
     const markdown = await runCli(["gather", "build", "a", "page"], dir);
     expect(markdown.code).toBe(0);
-    expect(markdown.stdout).toContain("# Guidance for this task");
-    expect(markdown.stdout).toContain("Task: build a page");
+    expect(markdown.stdout).toContain("# Guidance menu");
+    expect(markdown.stdout).toContain("This is the complete, unfiltered menu.");
+    expect(markdown.stdout).toContain("have not been selected or ranked");
+    expect(markdown.stdout).toContain("## Task\n\nbuild a page");
+    expect(markdown.stdout.indexOf("complete, unfiltered")).toBeLessThan(
+      markdown.stdout.indexOf("## Task"),
+    );
     expect(markdown.stdout).not.toContain(
       "Use a quiet, precise, content-first stance",
     );
@@ -1271,8 +1276,8 @@ describe("ghost CLI", () => {
     ).toBe(true);
 
     const gatherMarkdown = await runCli(["gather", "checkout", "hero"], dir);
-    expect(gatherMarkdown.stdout).toContain("# Guidance for this task");
-    expect(gatherMarkdown.stdout).toContain("Task: checkout hero");
+    expect(gatherMarkdown.stdout).toContain("# Guidance menu");
+    expect(gatherMarkdown.stdout).toContain("## Task\n\ncheckout hero");
     expect(gatherMarkdown.stdout).toContain("## Available guidance");
     expect(gatherMarkdown.stdout).not.toContain(menuPayload.contract.noAsk);
     expect(gatherMarkdown.stdout).toContain("### Other guidance");