Business Outcome

<aside> 💡

Problem: digital-companion-core is a TypeScript library for AI personas that remember conversations, have moods and evolve over time. But a persona couldn't be fully saved and restored: part of the state was lost, dates came back as strings, and repeated import duplicated memories.

Before: export()/import() only partially transferred state. Bad data could leave a persona half-restored. withMood() ignored the mood passed to it.

What we built: A versioned SoulSnapshot format that carries the full persona state, and a two-phase import: first full validation, then state change. Plus tests, an example and documentation.

Result: The pull request passed code review by the maintainer (AI Systems Architect, founder of Contentsaurus) and was merged into main. CI is green on Node 16, 18 and 20.

</aside>

A contribution to a real open-source project on GitHub: from agreeing on the design with the maintainer to a merged pull request.

Pull request: github.com/Ahmed-KHI/digital-companion-core/pull/3

Repository: github.com/Ahmed-KHI/digital-companion-core

Project Details

Context:

• Project: digital-companion-core (SoulForge), an npm library for stateful AI personas: identity, personality, memory, mood.
• Way of working: open-source contribution via fork, feature branch and pull request, with a design proposal agreed up front and code review by the maintainer.

Problem:

• Persona state couldn't be reliably saved between sessions.
• Dates stayed strings after import instead of Date objects.
• Repeated import duplicated memories and conversations.
• Invalid data could partially change the persona's state before an error was thrown.

Solution