holonovel 2026.8.22 → 2026.8.24

package/dist/core/anchors.d.ts

@@ -0,0 +1 @@
+export declare function deriveAnchor(heading: string, explicitId?: string, existing?: Set<string>): string;

package/dist/core/anchors.js

@@ -0,0 +1,35 @@
+// REQ-194 — deterministic anchor derivation. Anchors are derived from heading
+// text: lowercase, strip `[\p{P}\p{S}]`, collapse whitespace/hyphen runs to a
+// single hyphen, trim leading/trailing hyphens. Explicit `{#id}` takes
+// precedence; role-scoping markers (`*Keeper only*`, `*Player only*`) are
+// stripped before derivation; duplicate anchors within a file append `-1`,
+// `-2`, … per GFM convention. CJK and non-ASCII word characters are preserved.
+// Re-deriving the same source reproduces identical anchors (determinism).
+export function deriveAnchor(heading, explicitId, existing) {
+    // Explicit `{#id}` takes precedence over derived anchors (REQ-194a).
+    const inlineId = String(heading).match(/\{#([^}]+)\}/)?.[1];
+    if (explicitId)
+        return explicitId;
+    if (inlineId)
+        return inlineId;
+    let text = heading
+        .replace(/\*[^*]+\*/g, "")
+        .toLowerCase()
+        .replace(/[\p{P}\p{S}]/gu, "")
+        .replace(/[\s\u00a0]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (!text)
+        text = "section";
+    if (existing) {
+        if (existing.has(text)) {
+            let n = 1;
+            while (existing.has(`${text}-${n}`))
+                n++;
+            text = `${text}-${n}`;
+        }
+        existing.add(text);
+    }
+    return text;
+}
+//# sourceMappingURL=anchors.js.map

package/dist/core/anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../src/core/anchors.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,uEAAuE;AACvE,0EAA0E;AAC1E,2EAA2E;AAC3E,+EAA+E;AAC/E,0EAA0E;AAE1E,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,UAAmB,EACnB,QAAsB;IAEtB,qEAAqE;IACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,IAAI,GAAG,OAAO;SACf,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,WAAW,EAAE;SACb,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI;QAAE,IAAI,GAAG,SAAS,CAAC;IAC5B,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;gBAAE,CAAC,EAAE,CAAC;YACzC,IAAI,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;QACxB,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/server.js

@@ -25,6 +25,10 @@ export function novelSnapshot() {
         _state.snapshot(novel, getBadge());
 }
 export function withForbiddenAudit(handler, toolName) {
+    // REQ-133 — forbidden-call audit: every [FORBIDDEN] is recorded with the
+    // active badge, tool name, and arguments, tagged `violation_type: boundary`
+    // (see StateManager.auditForbidden) and surfaced with a [BOUNDARY_VIOLATION]
+    // marker in compress_audit / audit://novel.
     return async (args, ctx) => {
         try {
             return await handler(args, ctx);

package/dist/core/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,gFAAgF;AAUhF,IAAI,MAAoB,CAAC;AAEzB,MAAM,UAAU,UAAU,CAAC,KAAmB;IAC5C,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,MAAM,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,YAAY,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;IACjC,IAAI,KAAK;QAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAoB,EACpB,QAAgB;IAEhB,OAAO,KAAK,EAAE,IAAS,EAAE,GAAY,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,gFAAgF;AAUhF,IAAI,MAAoB,CAAC;AAEzB,MAAM,UAAU,UAAU,CAAC,KAAmB;IAC5C,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,MAAM,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,YAAY,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;IACjC,IAAI,KAAK;QAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAoB,EACpB,QAAgB;IAEhB,yEAAyE;IACzE,4EAA4E;IAC5E,6EAA6E;IAC7E,4CAA4C;IAC5C,OAAO,KAAK,EAAE,IAAS,EAAE,GAAY,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/state.d.ts

@@ -21,6 +21,19 @@ export interface NovelEntity {
     conditions: string[];
     condition_rounds: Record<string, number>;
     stats?: Record<string, any>;
+    knowledge?: {
+        explored?: Array<{
+            type: "room" | "thing";
+            name: string;
+            at: string;
+        }>;
+    };
+    codex_source?: {
+        id: string;
+        kind: string;
+        imported_at: string;
+        codex_modified_at: string;
+    };
 }
 export interface NpcState {
     id: string;
@@ -28,6 +41,7 @@ export interface NpcState {
     description?: string;
     disposition?: string;
     location?: string;
+    room_id?: string;
     personality?: {
         description?: string;
         voice?: string;
@@ -41,6 +55,26 @@ export interface NpcState {
     }[];
     conditions: string[];
     condition_rounds: Record<string, number>;
+    memory?: {
+        witnessed_events: Array<{
+            event: string;
+            at: string;
+        }>;
+        contacts: Record<string, {
+            encounters: number;
+            first_contact: string;
+            last_contact: string;
+            last_disposition: string;
+            prior_dispositions: string[];
+        }>;
+        stress_markers: string[];
+        goals?: string[];
+        last_3_interactions: Array<{
+            entity: string;
+            summary: string;
+            at: string;
+        }>;
+    };
 }
 export interface LoreEntry {
     key: string;
@@ -52,6 +86,8 @@ export interface LoreEntry {
     sticky_remaining: number;
     enabled: boolean;
     group?: string;
+    source?: string;
+    world_target?: string;
 }
 export interface Countdown {
     name: string;
@@ -62,6 +98,15 @@ export interface Countdown {
     direction?: string;
     clock_type?: "danger" | "racing" | "linked" | "tug_of_war" | "faction" | "mission";
     on_scene_transition?: boolean;
+    triggers?: string[];
+    world_effect?: {
+        type: "describe" | "property" | "exit";
+        target: string;
+        direction?: string;
+        destination?: string;
+        property?: string;
+        value?: string;
+    };
 }
 export interface CombatState {
     participants: string[];
@@ -92,6 +137,8 @@ export interface StoryEntry {
     scene_anchor: string;
     entity_ids: string[];
     timestamp: string;
+    discovered?: boolean;
+    room_id?: string;
 }
 export interface FactionState {
     id: string;
@@ -102,6 +149,23 @@ export interface FactionState {
     clock: number;
     clock_max: number;
     status: string;
+    territory?: string[];
+}
+export interface StoryBeat {
+    beat: string;
+    scene_preview: string;
+    source?: "adventure-scaffold" | "gm";
+    codex_source?: {
+        id: string;
+        kind: string;
+        imported_at: string;
+        codex_modified_at: string;
+    };
+}
+export interface GoalSuggestion {
+    npc_id: string;
+    text: string;
+    state: "pending" | "deferred" | "dismissed" | "accepted";
 }
 export interface SecretState {
     key: string;
@@ -109,6 +173,7 @@ export interface SecretState {
     triggers: string[];
     badge_scope: "game_master" | "shared";
     known_by: string[];
+    world_target?: string;
 }
 export interface Relationship {
     entity_a: string;
@@ -194,6 +259,10 @@ export interface ConditionState {
     conditions: string[];
     condition_rounds: Record<string, number>;
 }
+export interface WorkflowSnapshot {
+    timestamp: string;
+    state: any;
+}
 export interface AutonomyState {
     level: "full" | "mechanical_prompt" | "manual";
     confirmation: "auto" | "confirm" | "prompt";
@@ -223,7 +292,9 @@ export interface NovelState {
         location?: string;
         time_of_day?: string;
         atmosphere?: string;
+        beat?: string;
     }[];
+    scene_beat: string;
     scene_type: ("combat" | "social" | "exploration" | "neutral")[];
     narrative_directive: string;
     combat: CombatState | null;
@@ -244,11 +315,13 @@ export interface NovelState {
     adventure_set: boolean;
     pending_workflow: {
         decision: string;
-        snapshot: any;
+        snapshot: WorkflowSnapshot | null;
+        payload?: any;
     } | {
         decision: string;
-        snapshot: any;
+        snapshot: WorkflowSnapshot | null;
         creation?: import("./character-creation.js").CreationWorkflowState;
+        payload?: any;
     } | null;
     connection_counter: number;
     pending_staleness_counter: number;
@@ -270,6 +343,20 @@ export interface NovelState {
     }[];
     synthesis_activated: Record<string, number>;
     synthesis_module_enabled: Record<string, boolean>;
+    player_synthesis: Record<string, Array<{
+        key: string;
+        content: string;
+        triggers?: string[];
+        badge_scope: string;
+        created_at: string;
+    }>>;
+    campaign_memory: Array<{
+        category: "npcs" | "threads" | "locations";
+        text: string;
+        at: string;
+        badge_scope: "gm" | "shared" | "discovered";
+        scene: string;
+    }>;
     notes: NoteEntry[];
     vows: VowState[];
     checkpoints: Checkpoint[];
@@ -290,19 +377,63 @@ export interface NovelState {
         }>;
         premise: string;
         hooks: string[];
+        scene_count?: number;
     } | null;
     adventure_scene_waypoint: {
         anchor: string;
         description: string;
     } | null;
     world: WorldModel;
+    story_beats: StoryBeat[];
+    pacing_counter: number;
+    pacing_autonomy_fired: boolean;
+    scene_transition_count: number;
+    faction_autonomous_ticks: Record<string, number>;
+    npc_goal_suggestions: GoalSuggestion[];
+    voice_corrections_this_session: number;
+    auto_record: boolean;
+    session_no_mutation_windows: string[];
+    state_regression: {
+        audit_gap: number;
+        timestamp_gap_ms: number;
+        recorded_at: string;
+    } | null;
+    last_mutation_at: string | null;
+    mutation_counts_by_group: Record<string, number>;
+    uncommitted_rolls: Array<{
+        roll: string;
+        suggested_tool: string;
+        at: string;
+    }>;
     metadata: {
         created: string;
         modified: string;
         session_count: number;
         total_combat_rounds: number;
         last_scene_anchor: string;
+        sessions: Array<{
+            session_id: string;
+            entry_count: number;
+            timespan_start: string;
+            timespan_end: string | null;
+            combat_rounds: number;
+            significant_roll_count: number;
+            scene_transitions: number;
+        }>;
     };
+    active_session_id: string | null;
+    pending_vow_countdown_suggestion: {
+        vow_name: string;
+        countdown_name: string;
+        tick_count: number;
+        scope: string;
+    } | null;
+    codex_sources: Array<{
+        id: string;
+        kind: string;
+        imported_at: string;
+        codex_modified_at: string;
+    }>;
 }
 export interface RosterEntity extends NovelEntity {
 }
@@ -323,7 +454,10 @@ export declare class StateManager {
     enriched: boolean;
     enrichmentManifest: any;
     maxLoreTokens: number | null;
-    serverNotes: Map<string, string>;
+    serverNotes: Map<string, {
+        content: string;
+        narrative_tag?: string;
+    }>;
     codex: Map<string, CodexEntry>;
     private npcCounter;
     private entityCounter;
@@ -342,10 +476,25 @@ export declare class StateManager {
     resumeNovel(slug: string): NovelState;
     private loadNovelFromData;
     switchNovel(slug: string): NovelState;
+    renameNovel(novel: NovelState, newSlug: string): NovelState;
     endNovel(novel: NovelState, dispose: "yes" | "cancel"): {
         removed: boolean;
     };
+    archiveNovel(slug: string): {
+        archived: boolean;
+        at: string;
+    };
+    unarchiveNovel(slug: string): NovelState;
+    archivedNovels(): Array<{
+        slug: string;
+        archived_at: string;
+    }>;
     cleanupExpiredTrash(): void;
+    captureWorkflowSnapshot(novel: NovelState): WorkflowSnapshot;
+    restoreFromSnapshot(novel: NovelState, snapshot: WorkflowSnapshot | null): {
+        timestamp: string;
+    };
+    checkWorkflowStaleness(novel: NovelState): string | null;
     snapshot(novel: NovelState, badge: Badge): void;
     undo(novel: NovelState, badge: Badge): {
         data: any;
@@ -355,6 +504,11 @@ export declare class StateManager {
     } | null;
     audit(novel: NovelState, badge: Badge, tool: string, args: any, output_prefix?: string): void;
     auditForbidden(badge: Badge, tool: string, args: any): void;
+    recordMutation(novel: NovelState, tool: string, group: string): void;
+    closeSessionWindow(novel: NovelState, sessionId: string): void;
+    stateGate(): "off" | "warn" | "block";
+    stateDriftActive(novel: NovelState): boolean;
+    markStateRegression(novel: NovelState, auditEntryCountGap: number, timestampGapMs: number): void;
     verifyAuditChain(novel: NovelState): {
         valid: boolean;
         entries: number;
@@ -394,3 +548,6 @@ export declare class StateManager {
     }, stats?: Record<string, any>): NovelEntity;
     addEntity(novel: NovelState, entity: NovelEntity): void;
 }
+export declare function exportNovelJSON(novel: NovelState): any;
+export declare function importNovelJSON(data: any): NovelState;
+export declare function applyNovelState(target: NovelState, source: NovelState): void;