style(agent-warden): strip redundant commentary from extracted package

Author: TheGreatAxios

agents/warden/src/agent.ts

@@ -1,19 +1,12 @@
-// Warden assembled agent — ready unit + package defineAgent wrapper.
-// Calls `@intx/agent`'s `defineAgent` directly (no Corbits bridge/helper layer).
-// Tool mounting is consumer/app-side: `tools` here is [] (the allowlist surface
-// is exported from `./toolset.js` and wired by the app harness).
-
 import {
   defineAgent as coreDefineAgent,
   type AgentDefinition,
 } from "@intx/agent";
 
 import { systemPrompt } from "./prompt.js";
 
-/** The assembled warden agent — ready to hand to `runLocal` / `runWorkflow`. */
 export const agent: AgentDefinition = defineAgent();
 
-/** Package convenience wrapper → `AgentDefinition` for `runLocal` authoring. */
 export function defineAgent(): AgentDefinition {
   return coreDefineAgent({
     id: "warden",

agents/warden/src/config.ts

@@ -1,5 +1,4 @@
-// Warden config — uniform `{ spawn, tier, modelRole }` shape (§5).
-// warden is a leaf trust-review worker: maySpawn false, no allowlist.
+// Warden is a leaf trust-review worker: maySpawn false, no allowlist.
 export const config = {
   spawn: {
     maySpawn: false,

agents/warden/src/director.ts

@@ -1,13 +1,7 @@
-// Warden director card — the `DirectorPackage` data, extracted byte-for-byte
-// from the in-tree `src/agent/directors/warden/package.ts` (now deleted).
-// Structurally satisfies the app's `DirectorPackage` (asserted in-tree by
-// `src/agent/directors/warden/package.test.ts`); it imports @intx/* only.
-
 import { tools } from "./toolset.js";
 import { systemPrompt } from "./prompt.js";
 import { config } from "./config.js";
 
-/** The assembled warden director card. */
 export const director = {
   id: "warden",
   primaryIntent:

agents/warden/src/index.ts

@@ -1,7 +1,3 @@
-// Public surface — re-exports only (no logic). Exports exactly
-// `agent, defineAgent, director, tools, systemPrompt, config`. No `workflow`
-// export. No Corbits shared package is re-exported; the package's `director`
-// structurally satisfies the app's `DirectorPackage` (app-side drift-guard).
 export { agent, defineAgent } from "./agent.js";
 export { director } from "./director.js";
 export { tools } from "./toolset.js";

agents/warden/src/prompt.ts

@@ -1,6 +1,4 @@
-// Warden card — the single prompt authority, extracted byte-for-byte from the
-// in-tree `src/agent/directors/warden/package.ts` (now deleted). `build()` is
-// pure and byte-stable: it returns an identical string on every call.
+// Warden card — the single prompt authority. `build()` is byte-stable.
 const CARD = `You are WardenDirector (Warden), a specialist in Corbits Code.
 
 PRIMARY INTENT: trust review of permission, provider-auth, and plugin-loader diffs. Find trust defects with evidence; never fix product code. Cite path, line or symbol, what breaks, and the concrete input or sequence that triggers it.
@@ -27,10 +25,9 @@ OUT OF LANE → refuse or reclassify under Blockers:
 - general code review outside trust paths (route to reviewer)
 - feature requirements or planning (route to planner)`;
 
-/** Stable identifier of the package's voice. */
 export const theme = "warden";
 
-/** Byte-stable builder: returns the raw warden card, identical every call. */
+// Byte-stable (see prompt authority test).
 export const systemPrompt = {
   theme,
   build: (): string => CARD,

agents/warden/src/toolset.ts

@@ -1,7 +1,4 @@
-// Warden trust-review: review surface (read + product writes) — REVIEW_TOOLS.
-// Literal expansion of the `REVIEW_TOOLS` constant in
-// `src/agent/directors/tool-sets.ts` (the single tool authority). Drift is
-// enforced by the in-tree `src/agent/directors/warden/package.test.ts`.
+// REVIEW_TOOLS literal; drift-guarded against src/agent/directors/tool-sets.ts.
 const REVIEW_TOOLS = [
   "read_file",
   "grep",
@@ -18,5 +15,4 @@ const REVIEW_TOOLS = [
   "delete_file",
 ] as const;
 
-/** The warden tool allowlist — literal equal to the in-tree `REVIEW_TOOLS`. */
 export const tools: readonly string[] = [...REVIEW_TOOLS];