@hobin/developer 0.1.1 → 0.1.3

package/extensions/state.ts

@@ -1,6 +1,8 @@
-export const PROTOCOL = "developer/v2" as const;
+export const PROTOCOL = "developer/v3" as const;
+export const PREVIOUS_PROTOCOL = "developer/v2" as const;
 export const LEGACY_PROTOCOL = "developer/v1" as const;
 export const MODE_ENTRY = "developer.mode" as const;
+export const FOCUS_ENTRY = "developer.question-focus" as const;
 export const ROUTE_TOOL = "developer_route_question" as const;
 export const JUDGMENT_TOOL = "developer_record_judgment" as const;
 export const LEGACY_ROUTE_TOOL = "route_question" as const;
@@ -9,6 +11,7 @@ export const LEGACY_JUDGMENT_TOOL = "record_judgment" as const;
 export type DeveloperMode = "off" | "on" | "strict";
 export type JudgmentStatus = "resolved" | "needs-evidence" | "not-applicable" | "blocked";
 export type PendingQuestionStatus = "needs-evidence" | "blocked";
+export type DirectExecutionProfile = "ordinary" | "behavior-preserving-structure";
 
 export interface ModeEvent {
   protocol: typeof PROTOCOL;
@@ -16,6 +19,18 @@ export interface ModeEvent {
   mode: DeveloperMode;
 }
 
+export interface FocusEvent {
+  protocol: typeof PROTOCOL;
+  kind: "focus";
+  questionId: string;
+}
+
+export interface DirectStepContract {
+  movement: string;
+  stopCondition: string;
+  verification: string;
+}
+
 export interface RouteEvent {
   protocol: typeof PROTOCOL;
   kind: "route";
@@ -26,6 +41,8 @@ export interface RouteEvent {
   knownEvidence: string[];
   targetQuestionId?: string;
   methodLocation?: string;
+  executionProfile?: DirectExecutionProfile;
+  directStep?: DirectStepContract;
 }
 
 export interface PendingQuestion {
@@ -46,9 +63,10 @@ export interface JudgmentEvent {
   basis: string[];
   openedQuestions: PendingQuestion[];
   artifacts: string[];
+  changedArtifacts: boolean;
 }
 
-export type DeveloperEvent = ModeEvent | RouteEvent | JudgmentEvent;
+export type DeveloperEvent = ModeEvent | FocusEvent | RouteEvent | JudgmentEvent;
 
 export interface DeveloperState {
   mode: DeveloperMode;
@@ -56,19 +74,25 @@ export interface DeveloperState {
   lastRoute?: RouteEvent;
   lastJudgment?: JudgmentEvent;
   pendingQuestions: PendingQuestion[];
+  focusedQuestionId?: string;
+  implementationFramingRequired: boolean;
+  verificationRequired: boolean;
 }
 
 export const initialState = (): DeveloperState => ({
   mode: "off",
   pendingQuestions: [],
+  implementationFramingRequired: false,
+  verificationRequired: false,
 });
 
-export type ProtocolState = "idle" | "needs-judgment" | "needs-evidence" | "blocked";
+export type ProtocolState = "idle" | "needs-judgment" | "needs-evidence" | "needs-verification" | "blocked";
 
 export function protocolState(state: DeveloperState): ProtocolState {
   if (state.activeRoute) return "needs-judgment";
   if (state.pendingQuestions.some((question) => question.status === "blocked")) return "blocked";
   if (state.pendingQuestions.length > 0) return "needs-evidence";
+  if (state.verificationRequired) return "needs-verification";
   return "idle";
 }
 
@@ -82,12 +106,19 @@ export function applyDeveloperEvent(state: DeveloperState, event: DeveloperEvent
     return { ...state, mode: event.mode };
   }
 
+  if (event.kind === "focus") {
+    if (!state.pendingQuestions.some((question) => question.id === event.questionId)) return state;
+    return { ...state, focusedQuestionId: event.questionId };
+  }
+
   if (event.kind === "route") {
     if (state.activeRoute) return state;
     return {
       ...state,
       activeRoute: event,
       lastRoute: event,
+      focusedQuestionId:
+        event.targetQuestionId === state.focusedQuestionId ? undefined : state.focusedQuestionId,
     };
   }
 
@@ -104,7 +135,7 @@ export function applyDeveloperEvent(state: DeveloperState, event: DeveloperEvent
       pending = upsertQuestion(pending, {
         id: route.targetQuestionId,
         question: route.question,
-        status: event.status,
+        status: event.status === "blocked" ? "blocked" : "needs-evidence",
         sourceRouteId: route.routeId,
       });
     }
@@ -112,18 +143,35 @@ export function applyDeveloperEvent(state: DeveloperState, event: DeveloperEvent
     pending = upsertQuestion(pending, {
       id: `question:${route.routeId}`,
       question: route.question,
-      status: event.status,
+      status: event.status === "blocked" ? "blocked" : "needs-evidence",
       sourceRouteId: route.routeId,
     });
   }
 
   for (const question of event.openedQuestions) pending = upsertQuestion(pending, question);
 
+  const closesFramingGate =
+    (route.owner === "sketch" || route.owner === "signal") &&
+    (event.status === "resolved" || event.status === "not-applicable");
+  const opensFramingGate = route.owner === "model" && event.status === "resolved";
+  let implementationFramingRequired = state.implementationFramingRequired;
+  if (opensFramingGate) implementationFramingRequired = true;
+  if (closesFramingGate) implementationFramingRequired = false;
+
+  let verificationRequired = state.verificationRequired;
+  if (route.owner === "direct" && event.changedArtifacts) verificationRequired = true;
+  if (route.owner === "verify" && event.status === "resolved") verificationRequired = false;
+
   return {
     ...state,
     activeRoute: undefined,
     lastJudgment: judgment,
     pendingQuestions: pending,
+    focusedQuestionId: pending.some((question) => question.id === state.focusedQuestionId)
+      ? state.focusedQuestionId
+      : undefined,
+    implementationFramingRequired,
+    verificationRequired,
   };
 }
 
@@ -143,6 +191,26 @@ function isJudgmentStatus(value: unknown): value is JudgmentStatus {
   return value === "resolved" || value === "needs-evidence" || value === "not-applicable" || value === "blocked";
 }
 
+function isDirectExecutionProfile(value: unknown): value is DirectExecutionProfile {
+  return value === "ordinary" || value === "behavior-preserving-structure";
+}
+
+function parseDirectStep(value: unknown): DirectStepContract | undefined {
+  if (!isObject(value)) return undefined;
+  if (
+    typeof value.movement !== "string" ||
+    typeof value.stopCondition !== "string" ||
+    typeof value.verification !== "string"
+  ) {
+    return undefined;
+  }
+  return {
+    movement: value.movement,
+    stopCondition: value.stopCondition,
+    verification: value.verification,
+  };
+}
+
 function parsePendingQuestion(value: unknown): PendingQuestion | undefined {
   if (!isObject(value)) return undefined;
   if (
@@ -163,13 +231,22 @@ function parsePendingQuestion(value: unknown): PendingQuestion | undefined {
 
 export function normalizeDeveloperEvent(value: unknown): DeveloperEvent | undefined {
   if (!isObject(value)) return undefined;
-  if (value.protocol !== PROTOCOL && value.protocol !== LEGACY_PROTOCOL) return undefined;
+  if (
+    value.protocol !== PROTOCOL &&
+    value.protocol !== PREVIOUS_PROTOCOL &&
+    value.protocol !== LEGACY_PROTOCOL
+  ) return undefined;
 
   if (value.kind === "mode") {
     if (!isMode(value.mode)) return undefined;
     return { protocol: PROTOCOL, kind: "mode", mode: value.mode };
   }
 
+  if (value.kind === "focus") {
+    if (value.protocol !== PROTOCOL || typeof value.questionId !== "string") return undefined;
+    return { protocol: PROTOCOL, kind: "focus", questionId: value.questionId };
+  }
+
   if (value.kind === "route") {
     if (
       typeof value.routeId !== "string" ||
@@ -178,7 +255,9 @@ export function normalizeDeveloperEvent(value: unknown): DeveloperEvent | undefi
       typeof value.reason !== "string" ||
       !isStringArray(value.knownEvidence) ||
       (value.targetQuestionId !== undefined && typeof value.targetQuestionId !== "string") ||
-      (value.methodLocation !== undefined && typeof value.methodLocation !== "string")
+      (value.methodLocation !== undefined && typeof value.methodLocation !== "string") ||
+      (value.executionProfile !== undefined && !isDirectExecutionProfile(value.executionProfile)) ||
+      (value.directStep !== undefined && !parseDirectStep(value.directStep))
     ) {
       return undefined;
     }
@@ -192,6 +271,8 @@ export function normalizeDeveloperEvent(value: unknown): DeveloperEvent | undefi
       knownEvidence: value.knownEvidence,
       targetQuestionId: value.targetQuestionId,
       methodLocation: value.methodLocation,
+      executionProfile: value.executionProfile,
+      directStep: value.directStep === undefined ? undefined : parseDirectStep(value.directStep),
     };
   }
 
@@ -223,9 +304,10 @@ export function normalizeDeveloperEvent(value: unknown): DeveloperEvent | undefi
         id: `question:${value.routeId}:legacy:${index + 1}`,
         question,
         status: "needs-evidence",
-        sourceRouteId: value.routeId,
+        sourceRouteId: String(value.routeId),
       })),
       artifacts: value.artifacts,
+      changedArtifacts: false,
     };
   }
 
@@ -243,6 +325,7 @@ export function normalizeDeveloperEvent(value: unknown): DeveloperEvent | undefi
     basis: value.basis,
     openedQuestions: openedQuestions as PendingQuestion[],
     artifacts: value.artifacts,
+    changedArtifacts: typeof value.changedArtifacts === "boolean" ? value.changedArtifacts : false,
   };
 }
 
@@ -253,7 +336,7 @@ interface BranchEntryLike {
   message?: { role?: string; toolName?: string; details?: unknown };
 }
 
-const DEVELOPER_TOOL_NAMES = new Set([
+const DEVELOPER_TOOL_NAMES = new Set<string>([
   ROUTE_TOOL,
   JUDGMENT_TOOL,
   LEGACY_ROUTE_TOOL,
@@ -261,7 +344,10 @@ const DEVELOPER_TOOL_NAMES = new Set([
 ]);
 
 export function eventFromBranchEntry(entry: BranchEntryLike): DeveloperEvent | undefined {
-  if (entry.type === "custom" && entry.customType === MODE_ENTRY) {
+  if (
+    entry.type === "custom" &&
+    (entry.customType === MODE_ENTRY || entry.customType === FOCUS_ENTRY)
+  ) {
     return normalizeDeveloperEvent(entry.data);
   }
   if (

package/extensions/tui.ts

@@ -5,6 +5,7 @@ import {
   type ThemeColor,
 } from "@earendil-works/pi-coding-agent";
 import {
+  Box,
   Container,
   matchesKey,
   type SelectItem,
@@ -32,7 +33,7 @@ function modeName(mode: DeveloperMode): string {
 
 function protocolColor(value: ProtocolState): ThemeColor {
   if (value === "blocked") return "error";
-  if (value === "needs-evidence") return "warning";
+  if (value === "needs-evidence" || value === "needs-verification") return "warning";
   if (value === "needs-judgment") return "accent";
   return "dim";
 }
@@ -109,6 +110,51 @@ interface SelectDialogOptions {
   maxPrimaryColumnWidth?: number;
 }
 
+class SelectionPreview {
+  private item?: SelectItem;
+  private offset = 0;
+  private lastWidth = 40;
+  private readonly theme: Theme;
+  private readonly maxLines: number;
+
+  constructor(theme: Theme, maxLines = 5) {
+    this.theme = theme;
+    this.maxLines = maxLines;
+  }
+
+  setItem(item: SelectItem): void {
+    this.item = item;
+    this.offset = 0;
+  }
+
+  scroll(delta: number): void {
+    const total = this.contentLines(this.lastWidth).length;
+    this.offset = Math.max(0, Math.min(this.offset + delta, Math.max(0, total - this.maxLines)));
+  }
+
+  render(width: number): string[] {
+    this.lastWidth = width;
+    const lines = this.contentLines(width);
+    const visible = lines.slice(this.offset, this.offset + this.maxLines);
+    if (lines.length > this.maxLines) {
+      const end = Math.min(lines.length, this.offset + this.maxLines);
+      visible.push(this.theme.fg("dim", `  detail ${this.offset + 1}–${end}/${lines.length} · shift+↑↓ scroll`));
+    }
+    return visible;
+  }
+
+  invalidate(): void {}
+
+  private contentLines(width: number): string[] {
+    if (!this.item) return [];
+    const content = [
+      this.theme.fg("accent", this.theme.bold(this.item.label)),
+      ...(this.item.description ? [this.theme.fg("muted", this.item.description)] : []),
+    ].join("\n");
+    return new Text(content, 1, 0).render(width);
+  }
+}
+
 async function showSelectDialog(
   ctx: ExtensionCommandContext,
   options: SelectDialogOptions,
@@ -116,13 +162,17 @@ async function showSelectDialog(
   const result = await ctx.ui.custom<string | null>(
     (tui, theme, _keybindings, done) => {
       const container = new Container();
+      const surface = new Box(1, 0, (text) => theme.bg("customMessageBg", text));
+      surface.addChild(container);
       const title = new Text("", 1, 0);
       const subtitle = new Text("", 1, 0);
       const hint = new Text("", 1, 0);
+      const previewLabel = new Text(theme.fg("dim", "Selected detail"), 1, 0);
+      const preview = new SelectionPreview(theme);
       const updateText = () => {
-        title.setText(theme.fg("accent", theme.bold(options.title)));
+        title.setText(theme.fg("accent", theme.bold(`◆ ${options.title}`)));
         subtitle.setText(theme.fg("muted", options.subtitle));
-        hint.setText(theme.fg("dim", "↑↓ navigate · enter select · esc cancel"));
+        hint.setText(theme.fg("dim", "↑↓ navigate · shift+↑↓ scroll detail · enter select · esc cancel"));
       };
       updateText();
 
@@ -142,24 +192,32 @@ async function showSelectDialog(
       );
       list.onSelect = (item) => done(item.value);
       list.onCancel = () => done(null);
+      list.onSelectionChange = (item) => preview.setItem(item);
+      const initialItem = list.getSelectedItem();
+      if (initialItem) preview.setItem(initialItem);
 
       container.addChild(new DynamicBorder((text) => theme.fg("borderAccent", text)));
       container.addChild(title);
       container.addChild(subtitle);
       container.addChild(list);
+      container.addChild(new DynamicBorder((text) => theme.fg("borderMuted", text)));
+      container.addChild(previewLabel);
+      container.addChild(preview);
       container.addChild(hint);
       container.addChild(new DynamicBorder((text) => theme.fg("borderAccent", text)));
 
       return {
         render(width: number) {
-          return container.render(width);
+          return surface.render(width);
         },
         invalidate() {
           updateText();
-          container.invalidate();
+          surface.invalidate();
         },
         handleInput(data: string) {
-          list.handleInput(data);
+          if (matchesKey(data, "shift+up")) preview.scroll(-1);
+          else if (matchesKey(data, "shift+down")) preview.scroll(1);
+          else list.handleInput(data);
           tui.requestRender();
         },
       };
@@ -169,7 +227,7 @@ async function showSelectDialog(
       overlayOptions: {
         anchor: "center",
         width: options.width,
-        maxHeight: Math.min(options.maxVisible + 7, 20),
+        maxHeight: Math.min(options.maxVisible + 15, 26),
         margin: 1,
       },
     },
@@ -241,6 +299,12 @@ export class DeveloperWidget {
     if (this.state.pendingQuestions.length > 3) {
       lines.push(this.theme.fg("dim", `  +${this.state.pendingQuestions.length - 3} more open questions`));
     }
+    if (this.state.implementationFramingRequired) {
+      lines.push(this.theme.fg("warning", "→ next · sketch feature shape or signal structural movement"));
+    }
+    if (this.state.verificationRequired) {
+      lines.push(this.theme.fg("warning", "→ next · verify changed artifacts before completion"));
+    }
     return lines;
   }
 
@@ -259,17 +323,35 @@ export class DeveloperStatusPanel {
   private readonly view: DeveloperStatusView;
   private readonly theme: Theme;
   private readonly onClose: () => void;
-
-  constructor(view: DeveloperStatusView, theme: Theme, onClose: () => void) {
+  private readonly requestRender: () => void;
+  private readonly viewportHeight: number;
+  private scrollOffset = 0;
+  private maxScrollOffset = 0;
+
+  constructor(
+    view: DeveloperStatusView,
+    theme: Theme,
+    onClose: () => void,
+    options: { viewportHeight?: number; requestRender?: () => void } = {},
+  ) {
     this.view = view;
     this.theme = theme;
     this.onClose = onClose;
+    this.viewportHeight = options.viewportHeight ?? 24;
+    this.requestRender = options.requestRender ?? (() => {});
   }
 
   handleInput(data: string): void {
     if (matchesKey(data, "escape") || matchesKey(data, "enter") || matchesKey(data, "ctrl+c")) {
       this.onClose();
+      return;
     }
+    if (matchesKey(data, "up")) this.scrollOffset = Math.max(0, this.scrollOffset - 1);
+    else if (matchesKey(data, "down")) {
+      this.scrollOffset = Math.min(this.maxScrollOffset, this.scrollOffset + 1);
+    } else return;
+    this.invalidate();
+    this.requestRender();
   }
 
   render(width: number): string[] {
@@ -278,17 +360,22 @@ export class DeveloperStatusPanel {
     const panelWidth = Math.max(20, width);
     const innerWidth = Math.max(18, panelWidth - 2);
     const rows: string[] = [];
-    const border = (text: string) => this.theme.fg("borderMuted", text);
-    const row = (content = "") => `${border("│")}${truncateToWidth(content, innerWidth, "…", true)}${border("│")}`;
-    const addWrapped = (label: string, value: string, color: ThemeColor = "muted", maxLines = 2) => {
+    const background = (text: string) => this.theme.bg("customMessageBg", text);
+    const border = (text: string) => this.theme.fg("borderAccent", text);
+    const row = (content = "") => {
+      const clipped = truncateToWidth(content, innerWidth, "…", true);
+      const padding = " ".repeat(Math.max(0, innerWidth - visibleWidth(clipped)));
+      return background(`${border("│")}${clipped}${padding}${border("│")}`);
+    };
+    const addWrapped = (label: string, value: string, color: ThemeColor = "muted", _maxLines?: number) => {
       const prefix = `  ${this.theme.fg("dim", `${label} ·`)} `;
-      const wrapped = wrapTextWithAnsi(prefix + this.theme.fg(color, value), innerWidth).slice(0, maxLines);
+      const wrapped = wrapTextWithAnsi(prefix + this.theme.fg(color, value), innerWidth);
       for (const line of wrapped) rows.push(row(line));
     };
     const section = (title: string) => rows.push(row(`  ${this.theme.fg("accent", this.theme.bold(title))}`));
 
-    rows.push(border(`╭${"─".repeat(innerWidth)}╮`));
-    rows.push(row(`  ${this.theme.fg("accent", this.theme.bold("Developer status"))}`));
+    rows.push(background(border(`╭${"─".repeat(innerWidth)}╮`)));
+    rows.push(row(`  ${this.theme.fg("accent", this.theme.bold("◆ Developer status"))}`));
     rows.push(row());
 
     const state = this.view.state;
@@ -320,7 +407,7 @@ export class DeveloperStatusPanel {
     if (state.pendingQuestions.length === 0) {
       addWrapped("state", "No unresolved Developer questions.", "dim", 1);
     } else {
-      for (const question of state.pendingQuestions.slice(0, 4)) {
+      for (const question of state.pendingQuestions) {
         addWrapped(
           question.status === "blocked" ? "blocked" : "needs evidence",
           question.question,
@@ -328,9 +415,6 @@ export class DeveloperStatusPanel {
           1,
         );
       }
-      if (state.pendingQuestions.length > 4) {
-        addWrapped("more", String(state.pendingQuestions.length - 4), "dim", 1);
-      }
     }
 
     rows.push(row());
@@ -363,11 +447,27 @@ export class DeveloperStatusPanel {
     );
     rows.push(row());
     rows.push(row(`  ${this.theme.fg("dim", "enter/esc close · /develop questions revisits open work")}`));
-    rows.push(border(`╰${"─".repeat(innerWidth)}╯`));
+    rows.push(background(border(`╰${"─".repeat(innerWidth)}╯`)));
+
+    const header = rows.slice(0, 2);
+    const body = rows.slice(2, -2);
+    const bodyCapacity = Math.max(1, this.viewportHeight - 4);
+    this.maxScrollOffset = Math.max(0, body.length - bodyCapacity);
+    this.scrollOffset = Math.min(this.scrollOffset, this.maxScrollOffset);
+    const visibleBody = body.slice(this.scrollOffset, this.scrollOffset + bodyCapacity);
+    const position = body.length > bodyCapacity
+      ? `↑↓ scroll · ${this.scrollOffset + 1}–${Math.min(body.length, this.scrollOffset + bodyCapacity)}/${body.length} · enter/esc close`
+      : "enter/esc close · /develop questions revisits open work";
+    const visibleRows = [
+      ...header,
+      ...visibleBody,
+      row(`  ${this.theme.fg("dim", position)}`),
+      background(border(`╰${"─".repeat(innerWidth)}╯`)),
+    ];
 
     this.cachedWidth = width;
-    this.cachedLines = rows;
-    return rows;
+    this.cachedLines = visibleRows;
+    return visibleRows;
   }
 
   invalidate(): void {
@@ -380,12 +480,27 @@ export async function showDeveloperStatus(
   ctx: ExtensionCommandContext,
   view: DeveloperStatusView,
 ): Promise<void> {
-  await ctx.ui.custom<void>((_tui, theme, _keybindings, done) =>
-    new DeveloperStatusPanel(view, theme, () => done()));
+  await ctx.ui.custom<void>(
+    (tui, theme, _keybindings, done) =>
+      new DeveloperStatusPanel(view, theme, () => done(), {
+        viewportHeight: Math.max(12, Math.floor(tui.terminal.rows * 0.8)),
+        requestRender: () => tui.requestRender(),
+      }),
+    {
+      overlay: true,
+      overlayOptions: {
+        anchor: "center",
+        width: "82%",
+        minWidth: 56,
+        maxHeight: "85%",
+        margin: 1,
+      },
+    },
+  );
 }
 
 export function prepareQuestionPrompt(ctx: ExtensionCommandContext, question: PendingQuestion): void {
-  const prompt = `Revisit Developer question ${question.id}: ${question.question}`;
+  const prompt = `Revisit this Developer question: ${question.question}`;
   const current = ctx.ui.getEditorText();
   ctx.ui.setEditorText(current.trim() ? `${current.trimEnd()}\n\n${prompt}` : prompt);
 }

package/package.json

@@ -1,14 +1,9 @@
 {
   "name": "@hobin/developer",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Adaptive product-development reasoning and evidence for Pi.",
   "type": "module",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "developer",
-    "skills"
-  ],
+  "keywords": ["pi-package", "pi", "developer", "skills"],
   "license": "MIT",
   "author": {
     "name": "dev-hobin",
@@ -26,32 +21,23 @@
   "publishConfig": {
     "access": "public"
   },
-  "files": [
-    "extensions",
-    "skills",
-    "README.md",
-    "LICENSE"
-  ],
+  "files": ["extensions", "skills", "README.md", "SOURCES.md", "LICENSE"],
   "engines": {
     "node": ">=22.19.0"
   },
+  "scripts": {
+    "check": "node scripts/check-package.mjs && node --test tests/*.test.ts",
+    "eval": "node scripts/eval-rpc.mjs",
+    "eval:json": "node scripts/eval-json.mjs"
+  },
   "pi": {
-    "extensions": [
-      "./extensions/developer.ts"
-    ],
-    "skills": [
-      "./skills"
-    ]
+    "extensions": ["./extensions/developer.ts"],
+    "skills": ["./skills"]
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*",
     "typebox": "*"
-  },
-  "scripts": {
-    "check": "node scripts/check-package.mjs && node --test tests/*.test.ts",
-    "eval": "node scripts/eval-rpc.mjs",
-    "eval:json": "node scripts/eval-json.mjs"
   }
-}
+}

package/skills/abstraction-review/references/field-card.md

@@ -30,6 +30,12 @@ The wish opens freedom; the stop check brings the review back to evidence.
 Failure is not handled by a better name. Failure exposes a broken layer,
 contract, or missing artifact.
 
+Use [the recipe cards](recipe-cards.md) when the derivation rule is missing,
+[the repair table](repair-table.md) when the stop check fails, and
+[the worked examples](worked-examples.md) when a completed calibration case is
+needed. The field card remains the auditable summary; these files supply focused
+construction, repair, and examples.
+
 ## Field Card
 
 Fill this card for serious reviews.
@@ -153,6 +159,7 @@ If the sentence cannot be filled:
 | --- | --- | --- |
 | The problem vocabulary is missing or misleading | Language | Notation As Data |
 | Similar functions, workflows, or tests move together | Language/Unit | Movement Pattern Extraction |
+| Data, methods, messages, or change reasons suggest a misplaced owner | Unit/Boundary | Responsibility Boundary |
 | Operation results do not remain composable | Unit | Closure Composition Unit |
 | A loop, state transition, or contract has no preserved meaning | Law | Invariant Iteration |
 | Callers must know raw representation or hidden policy | Boundary | Data Abstraction Boundary |