Reframe Morning Signal as public agent starter kit

Author: nehalagrawal191-afk

.env.example

@@ -1,4 +1,7 @@
-# Required for live runs
+# Start here: demo mode runs with deterministic fixtures and no provider keys.
+DEMO_MODE=true
+
+# Required only when DEMO_MODE=false
 NIMBLE_API_KEY=
 NIMBLE_BASE_URL=https://sdk.nimbleway.com/v1
 OPENAI_API_KEY=
@@ -8,9 +11,6 @@ LANGSMITH_TRACING=true
 LANGSMITH_API_KEY=
 LANGSMITH_PROJECT=nimble-gtm-signal-agent
 
-# Optional: set to true for a reliable presentation run without external API calls
-DEMO_MODE=false
-
 # Optional newsletter delivery
 RESEND_API_KEY=
 NEWSLETTER_FROM="Nimble GTM Signal <onboarding@resend.dev>"

.gitignore

@@ -10,3 +10,5 @@ data/*.db
 data/*.db-*
 assignment_extracted.txt
 .DS_Store
+.vercel
+presentation/

.vercelignore

@@ -0,0 +1,10 @@
+.env
+.env.*
+!.env.example
+.next
+node_modules
+data
+presentation
+assignment_extracted.txt
+*.tsbuildinfo
+.DS_Store

CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Contributing
+
+Contributions are welcome if they make Morning Signal a clearer, safer, or more
+useful reference implementation for source-grounded agents.
+
+Good contribution areas:
+
+- new adaptation recipes
+- clearer docs
+- better demo fixtures
+- source scoring improvements
+- citation validation
+- production deployment guides
+- UI improvements that preserve the workflow narrative
+
+## Local Development
+
+```bash
+npm install
+cp .env.example .env
+```
+
+For no-secret local development:
+
+```bash
+DEMO_MODE=true npm run dev
+```
+
+Before opening a pull request:
+
+```bash
+npm run typecheck
+npm run build
+```
+
+## Guidelines
+
+- Keep retrieval, extraction, evidence assembly, and synthesis as separate stages.
+- Do not add features that require secrets in demo mode.
+- Keep source links inspectable in final outputs.
+- Prefer small, readable examples over broad abstractions.
+- Document new environment variables in `.env.example`.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nehal Agrawal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.