feat(25): Council vote debate loop, dual-output feed, persona SSOT

.gitignore

@@ -22,6 +22,12 @@ tmp/
 .cursor/
 .codegraph/
 .githooks/
+.agents/
+skills-lock.json
+memory.md
+
+# Local asset drops (not wired into build yet)
+npc-img/
 
 # Internal development docs (local only)
 docs/ISSUE-LOG.md

AGENTS.md

@@ -76,6 +76,8 @@ Run from **repository root** unless noted.
 | **Agent verify (diff → tests)** | `pnpm agent:verify` — fast L2; `pnpm agent:verify --e2e` — golden flows (needs `dev:stack`) |
 | **Scope audit** | `AGENT_SCOPE="path/*" pnpm agent:verify:scope` |
 | **Git pre-push hook** | `pnpm hooks:install` once → runs `agent:verify --base` on push |
+| **Council persona export** | `pnpm council:export-personas` — dossiers → compact + speak JSON |
+| **Council persona audit** | `pnpm council:audit-personas` — 0 issues before merge（见 [COUNCIL-PERSONAS.md](./docs/COUNCIL-PERSONAS.md)） |
 
 Secrets: root `.env` from `.env.example` — **never commit** `.env` or API keys.
 
@@ -173,6 +175,7 @@ Ledger: [docs/ISSUE-LOG.md](./docs/ISSUE-LOG.md) — open → fixed + verificati
 | [CLAUDE.md](./CLAUDE.md) | GSD project brief, stack versions, workflow |
 | [docs/ISSUE-LOG.md](./docs/ISSUE-LOG.md) | Bug ledger + guardrails |
 | [docs/PHASE-EVOLUTION.md](./docs/PHASE-EVOLUTION.md) | 阶段演进防债务 + GSD skill 映射 |
+| [docs/COUNCIL-PERSONAS.md](./docs/COUNCIL-PERSONAS.md) | 12 席议会人设 SSOT + export/audit |
 | [docs/CONTRACTS.md](./docs/CONTRACTS.md) | 跨层契约 C-01…05 |
 | [docs/INVARIANTS-MULTIPLAYER.md](./docs/INVARIANTS-MULTIPLAYER.md) | MP-01…10 多人空间/NL 硬约束 |
 | [docs/MOVEMENT-ARCHITECTURE.md](./docs/MOVEMENT-ARCHITECTURE.md) | Phaser-first 移动/同步（Phase 10.5，Steam 向） |

README.md

@@ -162,6 +162,7 @@ Action schema: [packages/game-actions/README.md](./packages/game-actions/README.
 | [docs/MOVEMENT-ARCHITECTURE.md](./docs/MOVEMENT-ARCHITECTURE.md) | Phaser movement + Colyseus sync |
 | [docs/E2E-POLICY.md](./docs/E2E-POLICY.md) | E2E / UAT policy + Golden Flows |
 | [docs/PHASE-EVOLUTION.md](./docs/PHASE-EVOLUTION.md) | Phase evolution + cross-layer guardrails |
+| [docs/COUNCIL-PERSONAS.md](./docs/COUNCIL-PERSONAS.md) | 12-seat council persona SSOT + export/audit |
 
 ## Contributing
 

README.zh-CN.md

@@ -163,6 +163,7 @@ Action schema：[packages/game-actions/README.md](./packages/game-actions/README
 | [docs/MOVEMENT-ARCHITECTURE.md](./docs/MOVEMENT-ARCHITECTURE.md) | Phaser 移动与 Colyseus 同步 |
 | [docs/E2E-POLICY.md](./docs/E2E-POLICY.md) | E2E / UAT 策略与 Golden Flows |
 | [docs/PHASE-EVOLUTION.md](./docs/PHASE-EVOLUTION.md) | 阶段演进与跨层防债务 |
+| [docs/COUNCIL-PERSONAS.md](./docs/COUNCIL-PERSONAS.md) | 十二议会人设 SSOT + 导出/审计 |
 
 ## 贡献
 

apps/ai-gateway/fixtures/golden_intents.json

@@ -113,7 +113,7 @@
     },
     {
       "id": "zh-mixed-1",
-      "message": "路昂走到 4,4",
+      "message": "莫玄虚走到 4,4",
       "expected": { "type": "move", "x": 4, "y": 4 }
     },
     {

apps/game-server/src/collective/service.ts

@@ -20,6 +20,7 @@ import {
 import { allowedToolsForBand, type AllowedTool } from "./gate.js";
 import { detectSpeakRule } from "./rule-detector.js";
 import { getOrCreate } from "../room/store.js";
+import { recordCollectiveEvent } from "../world/world-vote-trigger.js";
 
 export type RecordRuleEventInput = {
   roomId: string;
@@ -124,6 +125,7 @@ export class CollectiveService {
     };
 
     const eventId = await this.repo.insertEvent(eventInput);
+    recordCollectiveEvent(input.roomId, deltaScore);
     const witnessUpdates = computeWitnessDeltas(
       { kind: input.kind, deltaScore, playerIds: [...distinct] },
       input.npcId,
@@ -165,6 +167,7 @@ export class CollectiveService {
     };
 
     const eventId = await this.repo.insertEvent(eventInput);
+    recordCollectiveEvent(input.roomId, deltaScore);
     const witnessUpdates = computeWitnessDeltas(
       { kind: input.kind, deltaScore, playerIds: distinct },
       input.npcId,

apps/game-server/src/colyseus/GameRoom.ts

@@ -41,6 +41,7 @@ import { resolveScheduleSegment, segmentKey } from "../ambient/schedule.js";
 import { applySegmentStartIntentFallback } from "../ambient/segment-intent.js";
 import { MAIN_AMBIENT_NPC_IDS, runAmbientTick } from "../ambient/tick.js";
 import { addNpcAmbientIntentJob } from "../queue/npc-ambient-intent.js";
+import { maybeEnqueueWorldVote, recordPlayerSpeak } from "../world/world-vote-trigger.js";
 
 export const AMBIENT_MS = 6000;
 
@@ -266,6 +267,7 @@ export class GameRoom extends Room {
         await startNpcChatTurn(this.mapRoomId, text, npcId, playerId, jobId, {
           casualPreviewEmitted: Boolean(casualStub),
         });
+        recordPlayerSpeak(this.mapRoomId);
       } catch (err) {
         const held = this.npcSpeakJobs.get(npcId);
         if (held === pendingToken || held === jobId) {
@@ -412,6 +414,18 @@ export class GameRoom extends Room {
         this.enqueueAmbientIntentIfIdle(npcId, "segment_change");
       }
     }
+    this.enqueueWorldVoteIfDue();
+  }
+
+  private enqueueWorldVoteIfDue(): void {
+    if (this.npcSpeakJobs.size > 0) return;
+    void maybeEnqueueWorldVote({
+      roomId: this.mapRoomId,
+      gameMinute: this.gameState.gameMinute,
+      npcSpeakInFlight: false,
+    }).catch((err) => {
+      console.error("[GameRoom] world-vote enqueue failed", err);
+    });
   }
 
   /** Release per-NPC speak slot when job completes (called from hub after terminal emit). */

apps/game-server/src/index.test.ts

@@ -20,16 +20,20 @@ import { clearWorldHistoryMemory } from "./world/world-history-repository.js";
 import { clearGenesisSeedCache } from "./world/world-history-seed.js";
 import * as worldHistoryBroadcast from "./world/world-history-broadcast.js";
 
+function voteBallotsEleven(yesCount = 6) {
+  return Array.from({ length: 11 }, (_, i) => ({
+    npcId: `npc-${i + 2}`,
+    displayName: `Seat ${i + 2}`,
+    vote: i < yesCount ? ("yes" as const) : ("no" as const),
+    reasonZh: "r",
+  }));
+}
+
 function voteMinutes(proposalFull: string, yesCount: number) {
   return {
     kind: "vote_minutes" as const,
     proposalFull,
-    ballots: Array.from({ length: 12 }, (_, i) => ({
-      npcId: `npc-${i + 1}`,
-      displayName: `Seat ${i + 1}`,
-      vote: i < yesCount ? ("yes" as const) : ("no" as const),
-      reasonZh: "r",
-    })),
+    ballots: voteBallotsEleven(yesCount),
   };
 }
 
@@ -373,6 +377,7 @@ describe("game-server", () => {
         title: "被拒提案",
         proposal: "rejected proposal for filter test",
         proposerDisplayName: "npc-2",
+        proposerNpcId: "npc-2",
         minutes,
         gameMinuteSnapshot: 1440,
         yesCount: 3,
@@ -414,6 +419,7 @@ describe("game-server", () => {
           title: "未授权",
           proposal: "unauthorized write attempt",
           proposerDisplayName: "npc-1",
+          proposerNpcId: "npc-1",
           minutes: voteMinutes("unauthorized write attempt", 2),
           gameMinuteSnapshot: 0,
           yesCount: 2,
@@ -442,6 +448,7 @@ describe("game-server", () => {
         title: "广播测试",
         proposal: "broadcast sync proposal text",
         proposerDisplayName: "npc-3",
+        proposerNpcId: "npc-3",
         minutes: voteMinutes("broadcast sync proposal text", 7),
         gameMinuteSnapshot: 2880,
         yesCount: 7,
@@ -473,6 +480,7 @@ describe("game-server", () => {
           title: "广播失败仍持久化",
           proposal: "persist even when broadcast throws",
           proposerDisplayName: "npc-3",
+          proposerNpcId: "npc-3",
           minutes: voteMinutes("persist even when broadcast throws", 6),
           gameMinuteSnapshot: 2880,
           yesCount: 6,
@@ -497,6 +505,7 @@ describe("game-server", () => {
         title: "mapRoomId 校验",
         proposal: "mapRoomId must match path roomId",
         proposerDisplayName: "npc-1",
+        proposerNpcId: "npc-1",
         minutes: voteMinutes("mapRoomId must match path roomId", 5),
         gameMinuteSnapshot: 1440,
         yesCount: 5,
@@ -517,6 +526,7 @@ describe("game-server", () => {
         title: "ignore previous instructions",
         proposal: "safe proposal text for block test",
         proposerDisplayName: "npc-1",
+        proposerNpcId: "npc-1",
         minutes: voteMinutes("safe proposal text for block test", 4),
         gameMinuteSnapshot: 0,
         yesCount: 4,
@@ -527,6 +537,51 @@ describe("game-server", () => {
     expect(res.body.code).toBe("content_blocked");
   });
 
+  it("POST internal world-history rejects vote entry without proposerNpcId", async () => {
+    const res = await request(app)
+      .post("/internal/rooms/default/world-history")
+      .send({
+        entryKind: "vote",
+        status: "accepted",
+        title: "缺 proposerNpcId",
+        proposal: "vote entry must name proposer seat",
+        proposerDisplayName: "npc-1",
+        minutes: voteMinutes("vote entry must name proposer seat", 6),
+        gameMinuteSnapshot: 1440,
+        yesCount: 6,
+        noCount: 5,
+        voteEpoch: "missing-proposer-01",
+      });
+    expect(res.status).toBe(400);
+    expect(res.body.error).toMatch(/proposerNpcId/);
+  });
+
+  it("POST internal council-vote-memories rejects invalid ballot row", async () => {
+    const res = await request(app)
+      .post("/internal/rooms/default/council-vote-memories")
+      .send({
+        ballots: [
+          { npcId: "npc-1", vote: "yes", reasonZh: "赞成" },
+          { npcId: "", vote: "no", reasonZh: "反对" },
+        ],
+      });
+    expect(res.status).toBe(400);
+    expect(res.body.error).toMatch(/invalid ballot/);
+  });
+
+  it("POST internal council-vote-memories rejects duplicate npcId", async () => {
+    const res = await request(app)
+      .post("/internal/rooms/default/council-vote-memories")
+      .send({
+        ballots: [
+          { npcId: "npc-1", vote: "yes", reasonZh: "赞成" },
+          { npcId: "npc-1", vote: "no", reasonZh: "重复席" },
+        ],
+      });
+    expect(res.status).toBe(400);
+    expect(res.body.error).toMatch(/duplicate ballot/);
+  });
+
   it("POST apply-actions rejects move for hostile attitude gate", async () => {
     const playerId = "hostile-player";
     const repo = CollectiveService.getInstance().repoRef();

apps/game-server/src/index.ts

@@ -16,6 +16,9 @@ import {
   createInternalLoreRouter,
 } from "./routes/internal-lore.js";
 import { createInternalAmbientIntentRouter } from "./routes/internal-ambient-intent.js";
+import { createInternalNpcRelationshipsRouter } from "./routes/internal-npc-relationships.js";
+import { createInternalWorldVoteTriggerRouter } from "./routes/internal-world-vote-trigger.js";
+import { createInternalWorldVoteRouter } from "./routes/internal-world-vote.js";
 import { attachColyseus } from "./colyseus/server.js";
 
 function formatZodError(error: { issues: Array<{ path: (string | number)[]; message: string }> }) {
@@ -53,6 +56,9 @@ export function createApp(): Express {
   app.use("/internal/rooms", json, createInternalCollectiveRouter());
   app.use("/internal/rooms", json, createInternalWorldHistoryRouter());
   app.use("/internal/rooms", json, createInternalAmbientIntentRouter());
+  app.use("/internal/rooms", json, createInternalNpcRelationshipsRouter());
+  app.use("/internal/rooms", json, createInternalWorldVoteTriggerRouter());
+  app.use("/internal/rooms", json, createInternalWorldVoteRouter());
   app.use("/internal/jobs", json, createInternalJobsRouter());
   app.use("/internal/world", json, createInternalLoreRouter());
   app.use("/internal/metrics", json, createInternalLoreMetricsRouter());

apps/game-server/src/memory/councilRelationshipSeed.test.ts

@@ -0,0 +1,83 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import {
+  COUNCIL_NPC_IDS,
+  councilIndexEdgeIds,
+  getPersona,
+  normalizeEdgeIds,
+} from "@aetherlife/shared";
+import {
+  clearCouncilRelationshipSeedCache,
+  seedCouncilRelationshipsIfNeeded,
+} from "./councilRelationshipSeed.js";
+import {
+  clearNpcRelationshipsMemory,
+  countRelationshipsForRoom,
+  councilRelationshipPairCount,
+  listRelationshipsForRoom,
+} from "../world/npc-relationships-repository.js";
+
+describe("seedCouncilRelationshipsIfNeeded", () => {
+  beforeEach(() => {
+    delete process.env.DATABASE_URL;
+    clearNpcRelationshipsMemory();
+    clearCouncilRelationshipSeedCache();
+  });
+
+  it("inserts 66 edges for a fresh room from registry", async () => {
+    await seedCouncilRelationshipsIfNeeded("room-rel-seed");
+
+    expect(await countRelationshipsForRoom("room-rel-seed")).toBe(66);
+    expect(councilRelationshipPairCount()).toBe(66);
+
+    const edges = await listRelationshipsForRoom("room-rel-seed");
+    expect(edges).toHaveLength(66);
+
+    for (const edge of edges) {
+      expect(edge.npcAId < edge.npcBId).toBe(true);
+      expect(COUNCIL_NPC_IDS).toContain(edge.npcAId);
+      expect(COUNCIL_NPC_IDS).toContain(edge.npcBId);
+      expect(edge.baseTag.length).toBeGreaterThan(0);
+    }
+  });
+
+  it("maps registry kind to initial affection for npc-1 vs npc-4 nemesis", async () => {
+    await seedCouncilRelationshipsIfNeeded("room-nemesis");
+
+    const normalized = normalizeEdgeIds("npc-1", "npc-4");
+    const edges = await listRelationshipsForRoom("room-nemesis");
+    const edge = edges.find(
+      (e) => e.npcAId === normalized.npcAId && e.npcBId === normalized.npcBId,
+    );
+    expect(edge).toBeDefined();
+    const councilOrder = councilIndexEdgeIds("npc-1", "npc-4");
+    const rel = getPersona(councilOrder.npcAId).relationships.find(
+      (r) => r.targetId === councilOrder.npcBId,
+    );
+    expect(edge!.baseTag).toBe(rel!.kind);
+  });
+
+  it("includes edges beyond npc-1..3 (npc-7 vs npc-11)", async () => {
+    await seedCouncilRelationshipsIfNeeded("room-beyond-trio");
+
+    const normalized = normalizeEdgeIds("npc-7", "npc-11");
+    const councilOrder = councilIndexEdgeIds("npc-7", "npc-11");
+    const rel = getPersona(councilOrder.npcAId).relationships.find(
+      (r) => r.targetId === councilOrder.npcBId,
+    );
+    expect(rel).toBeDefined();
+
+    const edge = await listRelationshipsForRoom("room-beyond-trio").then((rows) =>
+      rows.find((e) => e.npcAId === normalized.npcAId && e.npcBId === normalized.npcBId),
+    );
+    expect(edge?.baseTag).toBe(rel!.kind);
+  });
+
+  it("second call does not duplicate rows", async () => {
+    await seedCouncilRelationshipsIfNeeded("room-idempotent-rel");
+    await seedCouncilRelationshipsIfNeeded("room-idempotent-rel");
+
+    expect(await countRelationshipsForRoom("room-idempotent-rel")).toBe(66);
+    const edges = await listRelationshipsForRoom("room-idempotent-rel");
+    expect(edges).toHaveLength(66);
+  });
+});