Created a SPEC to implement bg agents using pg-boss library

[MatLBS]

Created a first spec to implements backgrounds agents in nao to handle cron jobs or triggers

I used pg-boss : https://timgit.github.io/pg-boss/#/

[github-actions]

🚀 Preview Deployment

URL	https://pr-551-cf86964.preview.getnao.io
Commit	cf86964

⚠️ No LLM API keys configured - you'll see the API key setup flow when trying to chat.

---

_{Preview will be automatically removed when this PR is closed.}

[cubic-dev-ai]

1 issue found across 1 file

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="spec-architecture-background-agents.md">

<violation number="1" location="spec-architecture-background-agents.md:177">
P2: The spec gives conflicting guidance on whether `saveAgentResult` should pass `finishReason` or `stopReason` to `chatQueries.upsertMessage`. REQ-009 says `finishReason`, but the example call uses `stopReason`. This inconsistency can lead to incorrect payloads during implementation.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

P2: The spec gives conflicting guidance on whether saveAgentResult should pass finishReason or stopReason to chatQueries.upsertMessage. REQ-009 says finishReason, but the example call uses stopReason. This inconsistency can lead to incorrect payloads during implementation.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At spec-architecture-background-agents.md, line 177:

<comment>The spec gives conflicting guidance on whether `saveAgentResult` should pass `finishReason` or `stopReason` to `chatQueries.upsertMessage`. REQ-009 says `finishReason`, but the example call uses `stopReason`. This inconsistency can lead to incorrect payloads during implementation.</comment>

<file context>
@@ -0,0 +1,465 @@
+
+Calls:
+
+1. `chatQueries.upsertMessage({ role: 'assistant', chatId: chat.id, parts: [...], stopReason: result.finishReason, tokenUsage: result.usage, llmProvider: modelSelection.provider, llmModelId: modelSelection.modelId })`
+2. `memoryService.safeScheduleMemoryExtraction({ userId: chat.userId, projectId: chat.projectId, chatId: chat.id, messages: uiMessages, provider: modelSelection.provider })`
+
</file context>

[Bl3f]

Awesome thank you!