goalbuddy 0.3.6 → 0.3.8

package/goalbuddy/scripts/render-task-prompt.mjs

@@ -2,7 +2,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { basename, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { parseGoalStateText } from "../extend/local-goal-board/scripts/lib/goal-board.mjs";
+import { parseGoalStateText } from "../surfaces/local-goal-board/scripts/lib/goal-board.mjs";
 
 const ROLE_DEFAULTS = {
   scout: { agent: "goal_scout", reasoning: "low", sandbox: "read-only" },
@@ -45,6 +45,7 @@ export function renderTaskPrompt(options) {
         fork_context_allowed: role !== "worker",
         board_path: board.path,
         child_board_paths: childBoardPaths(board),
+        goal_oracle: board.goal.oracle || null,
         slice_policy: board.document.rules?.slice_policy || null,
         warnings,
       },
@@ -141,6 +142,12 @@ function promptWarnings(board, task) {
   const warnings = [];
   const role = normalizeRole(task.type);
   if (task.id !== board.activeTask) warnings.push(`Task ${task.id} is not the active task on this board.`);
+  if (isWeakProof(board.goal.oracle?.signal)) {
+    warnings.push("goal.oracle.signal is missing or placeholder-like; keep the goal pressured by a concrete completion oracle.");
+  }
+  if (isWeakProof(board.goal.oracle?.final_proof)) {
+    warnings.push("goal.oracle.final_proof is missing or placeholder-like; do not mark the goal complete without receipt-backed proof.");
+  }
   if (role === "worker") {
     if (stringList(task.allowed_files).length === 0) warnings.push(`Worker task ${task.id} has no allowed_files.`);
     if (stringList(task.verify).length === 0) warnings.push(`Worker task ${task.id} has no verify commands.`);
@@ -211,6 +218,17 @@ function isTrue(value) {
   return value === true || String(value).toLowerCase() === "true";
 }
 
+function isWeakProof(value) {
+  if (value === null || value === undefined) return true;
+  const normalized = String(value).trim().toLowerCase();
+  return normalized === ""
+    || normalized === "unknown"
+    || normalized === "tbd"
+    || normalized === "todo"
+    || normalized === "none"
+    || /^<.*>$/.test(normalized);
+}
+
 function stringList(value) {
   return Array.isArray(value) ? value.filter((item) => item !== null && item !== undefined).map(String) : [];
 }
@@ -219,29 +237,43 @@ function receiptSchema(role) {
   if (role === "worker") {
     return {
       result: "done | blocked",
+      task_id: "<T###>",
+      board_path: "<path to state.yaml>",
       changed_files: [],
-      commands: [{ cmd: "<command>", status: "pass | fail | not_run" }],
-      summary: "<=120 words",
+      commands: [],
+      summary: "<=120 words>",
       remaining_blockers: [],
+      verification_attempts: 1,
+      stopped_because: null,
     };
   }
   if (role === "judge") {
     return {
       result: "done | blocked",
+      task_id: "<T###>",
+      board_path: "<path to state.yaml>",
       decision: "approved | rejected | approve_subgoal | reject_subgoal | not_complete | complete",
       full_outcome_complete: false,
+      rationale: "<=120 words>",
       evidence: [],
+      subgoal_contract: null,
+      parallel_safety: null,
       blocked_tasks: [],
+      missing_evidence: [],
       required_board_updates: [],
     };
   }
   return {
     result: "done | blocked",
-    summary: "<=120 words",
+    task_id: "<T###>",
+    board_path: "<path to state.yaml>",
+    summary: "<=120 words>",
     evidence: [],
     facts: [],
     contradictions: [],
     ambiguity_requiring_judge: [],
+    commands: [],
+    note_needed: false,
   };
 }
 
@@ -261,6 +293,9 @@ function formatPrompt(payload) {
     lines.push("- child_board_paths:");
     for (const path of payload.metadata.child_board_paths) lines.push(`  - ${path}`);
   }
+  if (payload.metadata.goal_oracle) {
+    lines.push(`- goal_oracle: ${JSON.stringify(payload.metadata.goal_oracle)}`);
+  }
   if (payload.metadata.slice_policy) {
     lines.push(`- slice_policy: ${JSON.stringify(payload.metadata.slice_policy)}`);
   }

package/{plugins/goalbuddy/skills/goalbuddy/extend → goalbuddy/surfaces}/local-goal-board/README.md

@@ -2,7 +2,7 @@
 
 Generate a small local GoalBuddy board for a goal directory and watch it update live while agents work.
 
-The extension keeps `state.yaml` authoritative. It writes static web app files into the goal directory and serves them from a local-only Node server. The browser subscribes to Server-Sent Events, so cards update as `state.yaml`, `notes/`, or linked depth-1 sub-goal state changes without a manual reload.
+The surface keeps `state.yaml` authoritative. It writes static web app files into the goal directory and serves them from a local-only Node server. The browser subscribes to Server-Sent Events, so cards update as `state.yaml`, `notes/`, or linked depth-1 sub-goal state changes without a manual reload.
 
 ## Use When
 
@@ -14,11 +14,10 @@ The extension keeps `state.yaml` authoritative. It writes static web app files i
 ## Generate And Serve
 
 ```bash
-node extend/local-goal-board/scripts/local-goal-board.mjs \
-  --goal docs/goals/<slug>
+npx goalbuddy board docs/goals/<slug>
 ```
 
-The generated app includes the bundled `assets/goalbuddy-mark.png`, so the board keeps the GoalBuddy mark after the extension is installed or copied elsewhere.
+The generated app includes the bundled `assets/goalbuddy-mark.png`, so the board keeps the GoalBuddy mark anywhere the package is installed.
 
 The command writes:
 
@@ -34,8 +33,7 @@ Then it starts or reuses the shared local board hub at `http://goalbuddy.localho
 ## Check Without A Long-Running Server
 
 ```bash
-node extend/local-goal-board/scripts/local-goal-board.mjs \
-  --goal docs/goals/<slug> \
+npx goalbuddy board docs/goals/<slug> \
   --once \
   --json
 ```
@@ -63,9 +61,9 @@ Clicking a card opens a detail modal with the task objective, status, assignee,
 ## Verification
 
 ```bash
-node --test extend/local-goal-board/test/*.test.mjs
-node extend/local-goal-board/scripts/local-goal-board.mjs \
-  --goal extend/local-goal-board/examples/sample-goal \
+node --test goalbuddy/surfaces/local-goal-board/test/*.test.mjs
+node goalbuddy/surfaces/local-goal-board/scripts/local-goal-board.mjs \
+  --goal goalbuddy/surfaces/local-goal-board/examples/sample-goal \
   --once \
   --json
 ```

package/goalbuddy/{extend → surfaces}/local-goal-board/examples/sample-goal/state.yaml

@@ -1,8 +1,8 @@
 version: 2
 
 goal:
-  title: "Local Kanban Board Extension"
-  slug: "local-kanban-board-extension"
+  title: "Local Goal Board Surface"
+  slug: "local-goal-board-surface"
   kind: specific
   tranche: "Demonstrate local GoalBuddy board rendering."
   status: active
@@ -30,7 +30,7 @@ tasks:
     type: worker
     assignee: Worker
     status: blocked
-    objective: "Catalog and document the local board extension."
+    objective: "Catalog and document the local board surface."
     receipt:
       result: blocked
       summary: "T003 is blocked during the progressive board motion demo."
@@ -78,7 +78,7 @@ tasks:
     type: scout
     assignee: Scout
     status: done
-    objective: "List the extension launch paths."
+    objective: "List the board launch paths."
     receipt:
       result: done
       summary: "T009 completed during the progressive board motion demo."
@@ -118,7 +118,7 @@ tasks:
     type: worker
     assignee: Worker
     status: done
-    objective: "Prepare final extension packaging check."
+    objective: "Prepare final board packaging check."
     receipt:
       result: done
       summary: "T014 completed during the progressive board motion demo."

package/{plugins/goalbuddy/skills/goalbuddy/extend → goalbuddy/surfaces}/local-goal-board/examples/subgoal-parent/state.yaml

@@ -31,10 +31,10 @@ tasks:
     status: active
     objective: "Build the sub-goal board view."
     allowed_files:
-      - goalbuddy/extend/local-goal-board/scripts/lib/goal-board.mjs
-      - goalbuddy/extend/local-goal-board/test/local-goal-board.test.mjs
+      - goalbuddy/surfaces/local-goal-board/scripts/lib/goal-board.mjs
+      - goalbuddy/surfaces/local-goal-board/test/local-goal-board.test.mjs
     verify:
-      - node --test goalbuddy/extend/local-goal-board/test/local-goal-board.test.mjs
+      - node --test goalbuddy/surfaces/local-goal-board/test/local-goal-board.test.mjs
     stop_if:
       - "Need files outside allowed_files."
     subgoal:

package/goalbuddy/{extend → surfaces}/local-goal-board/examples/subgoal-parent/subgoals/T004-board-view/state.yaml

@@ -24,16 +24,16 @@ tasks:
       result: done
       summary: "Child board payload needs normal columns and task details."
       evidence:
-        - goalbuddy/extend/local-goal-board/scripts/lib/goal-board.mjs
+        - goalbuddy/surfaces/local-goal-board/scripts/lib/goal-board.mjs
   - id: T002
     type: worker
     assignee: Worker
     status: active
     objective: "Render the read-only embedded child board."
     allowed_files:
-      - goalbuddy/extend/local-goal-board/scripts/lib/goal-board.mjs
+      - goalbuddy/surfaces/local-goal-board/scripts/lib/goal-board.mjs
     verify:
-      - node --test goalbuddy/extend/local-goal-board/test/local-goal-board.test.mjs
+      - node --test goalbuddy/surfaces/local-goal-board/test/local-goal-board.test.mjs
     stop_if:
       - "Need files outside allowed_files."
     receipt: null

package/{plugins/goalbuddy/skills/goalbuddy/extend → goalbuddy/surfaces}/local-goal-board/scripts/lib/goal-board.mjs

@@ -6,8 +6,8 @@ import { fileURLToPath } from "node:url";
 const VALID_STATUSES = new Set(["queued", "active", "blocked", "done"]);
 const COLUMN_ORDER = ["todo", "in-progress", "blocked", "completed"];
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const extensionRoot = resolve(__dirname, "../..");
-const logoAssetPath = join(extensionRoot, "assets", "goalbuddy-mark.png");
+const surfaceRoot = resolve(__dirname, "../..");
+const logoAssetPath = join(surfaceRoot, "assets", "goalbuddy-mark.png");
 
 export class GoalBoardError extends Error {
   constructor(message) {
@@ -142,8 +142,8 @@ export function buildColumns(tasks) {
     byColumn.get(task.column).push(task);
   }
 
-  for (const columnTasks of byColumn.values()) {
-    columnTasks.sort((left, right) => taskSortKey(left).localeCompare(taskSortKey(right)));
+  for (const [columnId, columnTasks] of byColumn.entries()) {
+    columnTasks.sort((left, right) => compareColumnTasks(columnId, left, right));
   }
 
   return [
@@ -289,7 +289,7 @@ function titleForTask(task) {
 function compactTaskTitle(value) {
   const text = cleanText(value).replace(/\.$/, "");
   const routeMatch = text.match(/^Implement\b.*?\s(\/[A-Za-z0-9_./:-]+)\s+(route|queue slice|slice)\b/i);
-  if (routeMatch) return truncateTitle(`Implement ${routeMatch[1]} ${routeMatch[2]}`);
+  if (routeMatch) return `Implement ${routeMatch[1]} ${routeMatch[2]}`;
 
   const firstClause = text
     .split(/(?<=[.!?])\s+|\s+(?:Use only|Add|Match|Render|Clearly label|Do not)\b/i)[0]
@@ -300,14 +300,7 @@ function compactTaskTitle(value) {
     .replace(/[.;:,]\s*$/, "")
     .trim();
 
-  return truncateTitle(firstClause || text);
-}
-
-function truncateTitle(value, maxLength = 82) {
-  const text = cleanText(value).replace(/\.$/, "");
-  if (text.length <= maxLength) return text;
-  const shortened = text.slice(0, maxLength + 1).replace(/\s+\S*$/, "").trim();
-  return `${shortened || text.slice(0, maxLength).trim()}...`;
+  return firstClause || text;
 }
 
 function columnForStatus(status) {
@@ -322,6 +315,12 @@ function taskSortKey(task) {
   return `${rank}:${task.id}`;
 }
 
+function compareColumnTasks(columnId, left, right) {
+  const order = taskSortKey(left).localeCompare(taskSortKey(right));
+  if (columnId === "completed") return -order;
+  return order;
+}
+
 function normalizeStringList(value) {
   if (!value) return [];
   if (Array.isArray(value)) return value.map(cleanText).filter(Boolean);
@@ -1503,8 +1502,13 @@ h1 {
 .task-title {
   margin: 0;
   color: #2f3437;
+  display: -webkit-box;
   font-size: 15px;
   line-height: 1.35;
+  overflow: hidden;
+  overflow-wrap: anywhere;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 5;
 }
 
 .card-footer {

package/goalbuddy/{extend → surfaces}/local-goal-board/scripts/local-goal-board.mjs

@@ -228,8 +228,7 @@ export async function startBoardServer(options = {}) {
 
       const route = routeBoardRequest(url.pathname, boards, initialBoard);
       if (!route.board) {
-        response.writeHead(404);
-        response.end("Not found");
+        sendUnregisteredBoardPath(response, url.pathname, boards, baseUrl);
         return;
       }
       if (route.pathname === "/api/board") {
@@ -400,6 +399,28 @@ function routeBoardRequest(pathname, boards, initialBoard) {
   return matches[0] || { board: null, pathname };
 }
 
+function sendUnregisteredBoardPath(response, pathname, boards, baseUrl) {
+  response.writeHead(404, {
+    "Content-Type": "text/plain; charset=utf-8",
+    "Cache-Control": "no-store",
+  });
+  const registeredBoards = [...boards.values()].map((board) => {
+    const summary = boardSummary(board, baseUrl);
+    return `- ${summary.title}: ${summary.url}`;
+  });
+  response.end([
+    `GoalBuddy board path is not registered in this local hub: ${pathname}`,
+    "",
+    "This server is the GoalBuddy multi-board hub. Do not stop it just because a /<slug>/ board URL returned 404.",
+    "Start or rerun `npx goalbuddy board <goal-dir>` to register that goal on this same port, then open the printed /<slug>/ URL.",
+    "",
+    "Registered boards:",
+    registeredBoards.length ? registeredBoards.join("\n") : "- none",
+    "",
+    `Hub API: ${baseUrl}/api/boards`,
+  ].join("\n"));
+}
+
 function stripBoardPathPrefix(pathname, boardPath) {
   const prefix = boardPath.endsWith("/") ? boardPath.slice(0, -1) : boardPath;
   if (pathname === prefix) return "/";
@@ -527,9 +548,9 @@ function serveStatic(appDir, pathname, response) {
     return;
   }
 
-  const extension = cleanPath.match(/\.[^.]+$/)?.[0] || "";
+  const fileExtension = cleanPath.match(/\.[^.]+$/)?.[0] || "";
   response.writeHead(200, {
-    "Content-Type": textTypes[extension] || "application/octet-stream",
+    "Content-Type": textTypes[fileExtension] || "application/octet-stream",
     "Cache-Control": "no-store",
   });
   response.end(readFileSync(file));
@@ -580,8 +601,8 @@ function usage() {
   console.log(`GoalBuddy Local Goal Board
 
 Usage:
-  node extend/local-goal-board/scripts/local-goal-board.mjs --goal docs/goals/<slug>
-  node extend/local-goal-board/scripts/local-goal-board.mjs --goal docs/goals/<slug> --once --json
+  npx goalbuddy board docs/goals/<slug>
+  npx goalbuddy board docs/goals/<slug> --once --json
 
 Options:
   --goal <path>   Goal directory containing state.yaml.

package/{plugins/goalbuddy/skills/goalbuddy/extend → goalbuddy/surfaces}/local-goal-board/test/local-goal-board.test.mjs

@@ -4,13 +4,13 @@ import { cpSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } f
 import { spawnSync } from "node:child_process";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
-import { createBoardPayload, writeBoardApp } from "../scripts/lib/goal-board.mjs";
+import { buildColumns, createBoardPayload, writeBoardApp } from "../scripts/lib/goal-board.mjs";
 import { parseArgs, startBoardServer } from "../scripts/local-goal-board.mjs";
 
 test("normalizes a dense goal into local board columns", () => {
-  const payload = createBoardPayload(resolve("extend/local-goal-board/examples/sample-goal"));
+  const payload = createBoardPayload(resolve("goalbuddy/surfaces/local-goal-board/examples/sample-goal"));
 
-  assert.equal(payload.goal.title, "Local Kanban Board Extension");
+  assert.equal(payload.goal.title, "Local Goal Board Surface");
   assert.equal(payload.goal.activeTask, "");
   assert.equal(payload.counts.total, 14);
   assert.equal(payload.counts.todo, 0);
@@ -23,8 +23,20 @@ test("normalizes a dense goal into local board columns", () => {
   assert.equal(scout.receipt.summary, "T001 completed during the progressive board motion demo.");
 });
 
+test("orders completed cards newest first while preserving queued order", () => {
+  const columns = buildColumns([
+    { id: "T001", column: "completed", status: "done" },
+    { id: "T002", column: "todo", status: "queued" },
+    { id: "T003", column: "completed", status: "done" },
+    { id: "T004", column: "todo", status: "queued" },
+  ]);
+
+  assert.deepEqual(columns.find((column) => column.id === "todo").tasks.map((task) => task.id), ["T002", "T004"]);
+  assert.deepEqual(columns.find((column) => column.id === "completed").tasks.map((task) => task.id), ["T003", "T001"]);
+});
+
 test("loads depth-1 subgoal boards into parent task payloads", () => {
-  const payload = createBoardPayload(resolve("goalbuddy/extend/local-goal-board/examples/subgoal-parent"));
+  const payload = createBoardPayload(resolve("goalbuddy/surfaces/local-goal-board/examples/subgoal-parent"));
   const parentTask = payload.tasks.find((task) => task.id === "T004");
 
   assert.equal(parentTask.subgoal.status, "active");
@@ -37,10 +49,10 @@ test("loads depth-1 subgoal boards into parent task payloads", () => {
   assert.equal(parentTask.subgoal.board.tasks.find((task) => task.id === "T002").subgoal, null);
 });
 
-test("uses compact card titles while preserving full objectives", () => {
-  const root = mkdtempSync(join(tmpdir(), "goalbuddy-compact-titles-"));
+test("uses readable card titles while preserving full objectives", () => {
+  const root = mkdtempSync(join(tmpdir(), "goalbuddy-readable-titles-"));
   try {
-    const goalDir = join(root, "compact-titles");
+    const goalDir = join(root, "readable-titles");
     mkdirSync(join(goalDir, "notes"), { recursive: true });
     writeFileSync(join(goalDir, "state.yaml"), `version: 2
 goal:
@@ -70,6 +82,13 @@ tasks:
     status: queued
     objective: "This objective can stay much more detailed because it belongs in the modal, not on the card face."
     receipt: null
+  - id: T004
+    title: "Run installed-Cursor runtime proof for a named model request through the local BYOK bridge"
+    type: worker
+    assignee: Worker
+    status: queued
+    objective: "Run installed-Cursor runtime proof for a named model request through the local BYOK bridge."
+    receipt: null
 `);
 
     const payload = createBoardPayload(goalDir);
@@ -77,6 +96,10 @@ tasks:
     assert.equal(payload.tasks.find((task) => task.id === "T001").objective.includes("admin_seed_metrics.enrichment_qa"), true);
     assert.equal(payload.tasks.find((task) => task.id === "T002").title, "Implement /contacts/con_aaron_keller route");
     assert.equal(payload.tasks.find((task) => task.id === "T003").title, "Human-friendly release title");
+    assert.equal(
+      payload.tasks.find((task) => task.id === "T004").title,
+      "Run installed-Cursor runtime proof for a named model request through the local BYOK bridge",
+    );
   } finally {
     rmSync(root, { recursive: true, force: true });
   }
@@ -229,7 +252,7 @@ tasks:
 });
 
 test("writes a minimal GoalBuddy web app into the goal directory", () => {
-  const appDir = writeBoardApp(resolve("extend/local-goal-board/examples/sample-goal"));
+  const appDir = writeBoardApp(resolve("goalbuddy/surfaces/local-goal-board/examples/sample-goal"));
   const html = readFileSync(join(appDir, "index.html"), "utf8");
   const css = readFileSync(join(appDir, "styles.css"), "utf8");
   const js = readFileSync(join(appDir, "app.js"), "utf8");
@@ -249,6 +272,7 @@ test("writes a minimal GoalBuddy web app into the goal directory", () => {
   assert.match(css, /:root\[data-theme="dark"\]/);
   assert.match(css, /:root\[data-density="compact"\] \.task-card/);
   assert.match(css, /:root\[data-completed-visibility="collapse"\]/);
+  assert.match(css, /-webkit-line-clamp: 5/);
   assert.match(css, /\.subgoal-board/);
   assert.match(css, /\.board-error/);
   assert.match(js, /new EventSource\("\.\/events"\)/);
@@ -393,20 +417,20 @@ test("advertises goalbuddy.localhost while binding to loopback", async () => {
 test("runs when installed under a symlinked temp path", () => {
   const root = mkdtempSync(join(tmpdir(), "goalbuddy-local-board-direct-"));
   try {
-    cpSync("extend/local-goal-board/scripts", join(root, "scripts"), { recursive: true });
-    cpSync("extend/local-goal-board/assets", join(root, "assets"), { recursive: true });
+    cpSync("goalbuddy/surfaces/local-goal-board/scripts", join(root, "scripts"), { recursive: true });
+    cpSync("goalbuddy/surfaces/local-goal-board/assets", join(root, "assets"), { recursive: true });
 
     const result = spawnSync(process.execPath, [
       join(root, "scripts", "local-goal-board.mjs"),
       "--goal",
-      resolve("extend/local-goal-board/examples/sample-goal"),
+      resolve("goalbuddy/surfaces/local-goal-board/examples/sample-goal"),
       "--once",
       "--json",
     ], { encoding: "utf8" });
 
     assert.equal(result.status, 0, result.stderr || result.stdout);
     const report = JSON.parse(result.stdout);
-    assert.equal(report.board.goal.title, "Local Kanban Board Extension");
+    assert.equal(report.board.goal.title, "Local Goal Board Surface");
   } finally {
     rmSync(root, { recursive: true, force: true });
   }
@@ -558,6 +582,33 @@ test("serves multiple local boards from one shared hub URL", async () => {
   }
 });
 
+test("unregistered board paths explain hub reuse instead of stale-port cleanup", async () => {
+  const root = mkdtempSync(join(tmpdir(), "goalbuddy-local-board-unregistered-"));
+  const goalDir = join(root, "first-goal");
+  try {
+    mkdirSync(join(goalDir, "notes"), { recursive: true });
+    writeFileSync(join(goalDir, "state.yaml"), stateYaml("active", { title: "First Goal", slug: "first-goal" }));
+
+    const server = await startBoardServer({ goalDir, host: "127.0.0.1", port: 0 });
+    try {
+      const baseUrl = new URL(server.url).origin;
+      const missingResponse = await fetch(`${baseUrl}/rinova-client-revision-redesign/`);
+      assert.equal(missingResponse.status, 404);
+      const message = await missingResponse.text();
+      assert.match(message, /board path is not registered/i);
+      assert.match(message, /multi-board hub/i);
+      assert.match(message, /Do not stop it just because a \/<slug>\/ board URL returned 404/);
+      assert.match(message, /npx goalbuddy board <goal-dir>/);
+      assert.match(message, /First Goal/);
+      assert.match(message, /\/api\/boards/);
+    } finally {
+      await server.close();
+    }
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
 async function readUntil(reader, pattern) {
   const decoder = new TextDecoder();
   let text = "";

package/goalbuddy/templates/goal.md

@@ -15,10 +15,19 @@
 - Authority: `requested | approved | inferred | needs_approval | blocked`
 - Proof type: `test | demo | artifact | metric | review | source_backed_answer | decision`
 - Completion proof: <observable signal that closes the full original outcome>
+- Goal oracle: <live check, walkthrough, artifact, metric, source-backed answer, or decision that keeps pressure on the goal>
 - Likely misfire: <how GoalBuddy could succeed at the wrong thing>
 - Blind spots considered: <risks, unstated choices, or success dimensions surfaced during diagnostic intake>
 - Existing plan facts: <user-provided steps/files/constraints/sequencing to preserve and validate, or none>
 
+## Goal Oracle
+
+The oracle for this goal is:
+
+`<specific observable signal>`
+
+The PM must keep comparing task receipts to this oracle. Planning, discovery, a passing tiny slice, or a clean-looking board is not enough. The goal finishes only when a final Judge/PM audit maps receipts and verification back to this oracle and records `full_outcome_complete: true`.
+
 ## Goal Kind
 
 `specific | open_ended | existing_plan | recovery | audit`

package/goalbuddy/templates/state.yaml

@@ -9,6 +9,10 @@ goal:
   kind: open_ended # specific | open_ended | existing_plan | recovery | audit
   tranche: "<continuous execution: complete successive safe verified slices until the full original outcome is complete>"
   status: active # active | blocked | done
+  oracle:
+    signal: "<live check, walkthrough, artifact, metric, source-backed answer, or decision that proves the owner outcome>"
+    cadence: "after each Worker package and at final audit"
+    final_proof: "<receipt-backed evidence required before full_outcome_complete: true>"
   intake:
     original_request: "<shortest faithful user request>"
     interpreted_outcome: "<one sentence>"
@@ -33,6 +37,8 @@ rules:
   missing_input_or_credentials_do_not_stop_goal: true
   preserve_and_validate_existing_plan: true
   intake_misfire_must_be_audited: true
+  goal_pressure_requires_oracle: true
+  no_completion_on_weak_proof: true
   slice_policy:
     max_consecutive_tiny_tasks: 2
     prefer_vertical_slices: true
@@ -47,17 +53,12 @@ agents:
   judge: unknown
 
 visual_board:
-  # none | local | github_projects | both | unknown
+  # none | local | unknown
   selected: unknown
   local:
     status: not_requested # not_requested | starting | live | generated | blocked
     url: null
     command: "npx goalbuddy board docs/goals/<goal-slug>"
-  github_projects:
-    status: not_requested # not_requested | needs_approval | dry_run_ready | synced | blocked
-    url: null
-    command: "npx goalbuddy extend github-projects"
-    missing: []
 
 active_task: T001