Adding Journaling to BrainDrive

BrainDrive Development
1

Hi All,

We now have the interview, spec, plan functionality live in the current version of BrainDrive.

This allows us to work with AI to define our goals, and create a plan for reaching them.

The next step is to give us the ability to keep our BrainDrive’s up to date with our progress, so we can continue to remain aligned and track and update our progress as we work towards our goals and create new ones.

That’s what the new journaling functionality we want to add to BrainDrive is all about.

Here are the documents we’re working off of:

We are going to roll this out first to our Relationship and Fitness pages and then the rest once we have tested and proven it works there:

The work has two main parts:

  1. Building journaling into the starter pack and sidebar — the instructions that run a journaling session on each page.
  2. Updating our test harness to verify it — the harder part. These changes touch the same files that already produce a great interview, spec, and plan, so the real challenge is adding journaling without regressing what already works. The harness locks in a baseline of today’s interview quality and gates every change against it.

Thoughts, ideas, questions etc welcome as always. Just hit the reply button.

Thanks,
Dave W.

2

@DJJones pls see above and then here is a summary of what I think is needed from your end. I’m handling the starter pack updates.

journaling-dj-handoff.md (6.0 KB)

Any questions or issues let me know.

Thanks,
Dave W.

3

My hand off has been merged into dev

dj-implementation-plan.md (22.8 KB)

1 Like
4

@DJJones great working on my part now.

Thanks,
Dave W.

5

@DJJones

I am still doing testing but I think I am close enough now that we can start your part.

I put PR 181 up just now with the starter pack edits so you can start working on the runtime and getting it wired into the sidebar as “Your Journal”. So when we are done it should be Your Goals, Your Plan, Your Journal, with “Run Journal” added alongside of the other two Run docs.

Here is the work handoff doc that the AI created but don’t take this as gospel obviously if there is something you feel should be done differently do it.

Any questions or issues let me know.

Thanks
Dave W.
dj-handoff.md (14.1 KB)

6

FYI we are starting with Fitness and Relationships and getting those dialed in and then I am going to add the other pages.

7

@DJJones from BD +1:

"One thing we found this morning doing a fresh provision on my dev instance. The seeder in the runtime has a hardcoded file list for journal projects — JOURNAL_PROJECT_TEMPLATE_FILES in memory/init.ts, line 62 — and it still points at the old stub layout: journal/AGENT.md and journal/journal.md in a subfolder. The new pack uses a single top-level journal.md. So on a fresh provision today, you get a stale journal folder and no actual journal file.

The fix is one line plus a deletion, but they have to land together in the same commit: change that list to run-journal.md and journal.md, and delete the four old stub template files under templates/fitness/journal/ and templates/relationships/journal/ — those are still on dev from the old journaling commit. If you delete the templates without the code change, the seeder fabricates fallback stubs from its hardcoded list; if you change the code without deleting them, dead files linger.

We kept it out of PR #210 since that’s pack-only — this is the answer to the ‘confirm seed point’ checkbox in your work order, so it slots into your runtime PR. It may also be most of the double-Journal sidebar bug, since the stub folder was creating a second Journal entry."

8

Your PR has been added, then my hand off work was added after that.

journal-runtime-implementation-plan.md (19.4 KB)

9

Your PR (#214) just got merged as well

10

I just ran through it for fitness and it’s looking and working good. Still doing testing and optimization but we’re looking pretty good I think.

Thanks
Dave W.

1 Like
11

@DJJones just put a small PR up no urgency on merging it just a few tweaks to the relationship and journal pack after going through the transcripts in the test harness.

I am going to start working on adding the other pages in now and may do a PR on it over the weekend or it may be Monday. Either way nothing urgent we’re in a good spot for Monday I think either way.

Any questions or issues let me know.

Thanks
Dave W.

1 Like
12

@DJJones just put a PR through to add journaling to finance, career, and new project.

There are a few things in the PR description that you need to do related to runtime when you put this live.

No rush on getting this merged I just didn’t want to lose it.

Thanks,
Dave W.

1 Like
13

The 2 PR’s above have been merged into the Dev, followed up by a 3rd PR from me to activate based on your PR description.

journal-go-live-activation-implementation-plan.md (36.8 KB)
journal-go-live-activation-spec.md (25.8 KB)

I am currently testing and merging a few PRs from Dependabot as well at the moment. Since I am assuming you will want to test this a bit I am holding off on building a release from all this work at the moment.

1 Like