ei-tui 1.2.0 → 1.3.0

package/src/prompts/room/sections.ts

@@ -5,6 +5,7 @@
 import type { RoomParticipantIdentity, RoomHistoryMessage, RoomJudgeCandidate } from "./types.js";
 import type { PersonaTrait, PersonaTopic } from "../../core/types.js";
 import { RoomMode } from "../../core/types.js";
+import { partitionTraits, bucketTraits } from "../trait-utils.js";
 
 const DESCRIPTION_MAX_CHARS = 500;
 
@@ -70,14 +71,35 @@ export function buildRoomGuidelinesSection(personaName: string, mode?: RoomMode)
   return baseGuidelines;
 }
 
+const ROOM_TRAIT_BUCKETS = [
+  { min: 90, max: 100, header: "### Core Expression\nEvident in every response." },
+  { min: 66, max: 89,  header: "### Strong Tendencies\nFrequent, but not every sentence." },
+  { min: 36, max: 65,  header: "### Noticeable in Casual Messages\nSurfaces naturally, not constantly." },
+  { min: 1,  max: 35,  header: "### Subtle Undercurrents\nBackground texture only." },
+] as const;
+
 export function buildRoomTraitsSection(traits: PersonaTrait[]): string {
   if (traits.length === 0) return "";
-  const sorted = [...traits].sort((a, b) => (b.strength ?? 0.5) - (a.strength ?? 0.5)).slice(0, 12);
-  const lines = sorted.map(t => {
-    const pct = t.strength !== undefined ? ` (${Math.round(t.strength * 100)}%)` : "";
-    return `- **${t.name}**${pct}: ${truncate(t.description)}`;
-  });
-  return `## Your Personality\n\n${lines.join("\n")}`;
+
+  const capped = [...traits].sort((a, b) => (b.strength ?? 0.5) - (a.strength ?? 0.5)).slice(0, 12);
+  const { guardrails, active } = partitionTraits(capped);
+
+  const sections: string[] = [];
+
+  if (guardrails.length > 0) {
+    const lines = guardrails.map(t => `**${t.name}**`).join("\n");
+    sections.push(`### Must NEVER Do — User Explicitly Asked You To Stop\n${lines}`);
+  }
+
+  for (const { bucket, traits: inBucket } of bucketTraits(active, ROOM_TRAIT_BUCKETS)) {
+    if (inBucket.length === 0) continue;
+    const lines = inBucket.map(t => `**${t.name}**: ${truncate(t.description)}`).join("\n");
+    sections.push(`${bucket.header}\n${lines}`);
+  }
+
+  if (sections.length === 0) return "";
+
+  return `## Your Personality\n\n${sections.join("\n\n")}`;
 }
 
 export function buildRoomTopicsSection(topics: PersonaTopic[]): string {

package/src/prompts/trait-utils.ts

@@ -0,0 +1,33 @@
+import type { PersonaTrait } from "../core/types.js";
+
+export interface TraitBucket {
+  min: number;
+  max: number;
+  header: string;
+}
+
+export interface PartitionedTraits {
+  guardrails: PersonaTrait[];
+  active: PersonaTrait[];
+}
+
+// Special-case: .filter() is intentional here. This file is the designated home
+// for trait partitioning logic that prompt builders need for rendering. Keeping it
+// here (rather than inline in each builder) is what lets the structural check
+// enforce "no .filter() in prompt builders" elsewhere.
+export function partitionTraits(traits: PersonaTrait[]): PartitionedTraits {
+  return {
+    guardrails: traits.filter(t => (t.strength ?? 0.5) === 0),
+    active: traits.filter(t => (t.strength ?? 0.5) > 0),
+  };
+}
+
+export function bucketTraits(active: PersonaTrait[], buckets: readonly TraitBucket[]): Array<{ bucket: TraitBucket; traits: PersonaTrait[] }> {
+  return buckets.map(bucket => ({
+    bucket,
+    traits: active.filter(t => {
+      const pct = Math.round((t.strength ?? 0.5) * 100);
+      return pct >= bucket.min && pct <= bucket.max;
+    }),
+  }));
+}

package/tui/README.md

@@ -132,6 +132,8 @@ Rooms have three modes, set at creation time:
 | `/me <type>` | | Edit one type: `facts`, `topics`, or `people` |
 | `/import <path>` | | Import a document (txt, md, pdf, etc.) into Ei — extracted knowledge is attributed to the "Emmett" persona |
 | `/unsource <source_tag>` | | Remove all knowledge extracted from a previously imported document |
+| `/generate <subject>` | | Synthesize everything Ei knows about a subject into a markdown document — lands in `$EI_DATA_PATH/docs/` automatically |
+| `/generate` | | (no args) Manage your generated documents — re-run, re-export, or delete |
 | `/dedupe <person\|topic> <term> [term2 ...]` | | Fuzzy-search and merge duplicate people or topics in `$EDITOR`. Unquoted words are individual OR terms; quoted strings match as exact phrases: `/dedupe person Flare "Jeremy Scherer"` finds records matching `Flare` OR `Jeremy Scherer` |
 | `/settings` | `/set` | Edit your global settings in `$EDITOR` |
 | `/setsync <user> <pass>` | `/ss` | Set sync credentials (triggers restart) |

package/tui/src/util/help-content.ts

@@ -109,6 +109,17 @@ EXTENDED COMMANDS
         document. Use the source tag shown when the import completed.
         /unsource my-journal-2024
 
+    /generate <subject>
+        Synthesize everything Ei knows about a subject into a clean markdown
+        document. Uses your rewrite_model (Opus-class recommended). The file
+        lands in $EI_DATA_PATH/docs/ automatically.
+        /generate everything about the Uniform project
+        /generate comprehensive runbook for the IDP deployment issues
+
+    /generate
+        (no args) — Open your generated documents. Re-run, re-export, or
+        delete from here.
+
     /tools
         Manage tool providers — enable or disable tools per persona.