@ramarivera/coding-buddy 0.4.0-alpha.9 → 0.7.0

package/core/engine.ts

@@ -1,5 +1,5 @@
 /**
- * claude-buddy engine — deterministic companion generation
+ * coding-buddy engine — deterministic companion generation
  * Matches Claude Code's exact algorithm: wyhash → mulberry32 → species/stats
  */
 
@@ -24,6 +24,8 @@ export const SPECIES = [
   "rabbit",
   "mushroom",
   "chonk",
+  "wyvern",
+  "pikachu",
 ] as const;
 
 export type Species = (typeof SPECIES)[number];
@@ -296,6 +298,84 @@ export function generateBones(userId: string, salt: string = SALT): BuddyBones {
   return { rarity, species, eye, hat, shiny, stats, peak, dump };
 }
 
+// ─── Personality ────────────────────────────────────────────────────────────
+
+const PEAK_PHRASES: Record<StatName, string[]> = {
+  DEBUGGING: [
+    "spots segfaults before the stack unwinds",
+    "can read a backtrace like a map",
+    "finds the off-by-one before the tests do",
+  ],
+  PATIENCE: [
+    "outlasts any flaky test suite",
+    "waits for the slow CI build without complaint",
+    "never merges before the green check",
+  ],
+  CHAOS: [
+    "treats breaking changes as a love language",
+    "rewrites the Makefile on a Tuesday for fun",
+    "thrives wherever the incident channel is loudest",
+  ],
+  WISDOM: [
+    "has seen this bug before — in three other repos",
+    "quotes the relevant RFC from memory",
+    "recognizes the abstraction that will outlive its author",
+  ],
+  SNARK: [
+    "leaves code review comments that linger",
+    "finds the edge case you forgot and mentions it twice",
+    "names things with uncomfortable accuracy",
+  ],
+};
+
+const DUMP_PHRASES: Record<StatName, string[]> = {
+  DEBUGGING: [
+    "occasionally ships the workaround instead of the fix",
+    "skips the repro step",
+    "trusts the logs a little too much",
+  ],
+  PATIENCE: [
+    "starts the rebase before the review is done",
+    "has been known to close slow issues as stale",
+    "has been known to force-push main",
+  ],
+  CHAOS: [
+    "prefers everything to stay exactly where it is",
+    "dislikes surprise refactors",
+    "writes very thorough migration guides",
+  ],
+  WISDOM: [
+    "sometimes reinvents the wheel with enthusiasm",
+    "skips the existing prior art",
+    "learns by doing, not by reading",
+  ],
+  SNARK: [
+    "only leaves encouraging comments",
+    "approves PRs with genuine warmth",
+    "never says what it actually thinks",
+  ],
+};
+
+const RARITY_CLOSER: Record<string, string[]> = {
+  common:    ["Gets the job done.", "Reliable, if unassuming."],
+  uncommon:  ["Has a few tricks up its sleeve.", "Worth keeping around."],
+  rare:      ["Not to be underestimated.", "Earns its keep."],
+  epic:      ["Commands quiet respect.", "The kind of companion repos are built around."],
+  legendary: ["The kind you find once, if you're lucky.", "Leaves every codebase better than it found it."],
+};
+
+export function generatePersonality(bones: BuddyBones, userId: string): string {
+  const seed = parseInt(userId.slice(0, 8), 16);
+  const pickPhrase = <T>(arr: T[], salt: number = 0): T => arr[(seed + salt) % arr.length];
+
+  const shiny  = bones.shiny ? " Shimmers faintly in dark mode." : "";
+  const peak   = pickPhrase(PEAK_PHRASES[bones.peak]);
+  const dump   = pickPhrase(DUMP_PHRASES[bones.dump], 1);
+  const closer = pickPhrase(RARITY_CLOSER[bones.rarity] ?? ["Gets the job done."], 2);
+
+  return `A ${bones.rarity} ${bones.species} that ${peak}.${shiny} ${closer} Though it ${dump}.`;
+}
+
 // ─── ASCII Art ──────────────────────────────────────────────────────────────
 
 const FACE_TEMPLATES: Record<Species, string> = {
@@ -317,6 +397,8 @@ const FACE_TEMPLATES: Record<Species, string> = {
   rabbit: "({E}..{E})",
   mushroom: "|{E}  {E}|",
   chonk: "({E}.{E})",
+  wyvern: "\\ {E}' '{E} /",
+  pikachu: "({E}ω{E})",
 };
 
 export function renderFace(species: Species, eye: Eye): string {

package/core/ports.ts

@@ -5,6 +5,7 @@ import type {
   ReactionState,
   UnlockedAchievement,
 } from "./model.ts";
+import type { Achievement } from "./achievements.ts";
 
 export interface IdentityProvider {
   getStableUserId(): string;
@@ -13,12 +14,17 @@ export interface IdentityProvider {
 export interface BuddyRepository {
   loadActive(): Companion | null;
   saveActive(companion: Companion): void;
+  updateActive(transform: (companion: Companion) => Companion): Companion;
   loadSlot(slot: string): Companion | null;
   saveSlot(slot: string, companion: Companion): void;
   deleteSlot(slot: string): void;
   listSlots(): Array<{ slot: string; companion: Companion }>;
   loadActiveSlot(): string | null;
   saveActiveSlot(slot: string): void;
+  ensureCompanion(
+    userId: string,
+    create: (existingSlots: string[]) => { companion: Companion; slot: string },
+  ): { companion: Companion; slot: string; created: boolean };
 }
 
 export interface ReactionRepository {
@@ -37,4 +43,8 @@ export interface BuddyEventRepository {
   loadUnlocked(): UnlockedAchievement[];
   saveUnlocked(unlocked: UnlockedAchievement[]): void;
   trackActiveDay(): void;
+  unlockAchievements(
+    slot: string | undefined,
+    evaluate: (counters: EventCounters, unlockedIds: Set<string>) => Achievement[],
+  ): Achievement[];
 }