d7758fd11b
Some checks are pending
CI / validate (push) Waiting to run
Mass-sed across all 58 persona dirs in molecule-ai-org-template-molecule-dev. Total: 158 files / 396 substitutions - 389 gh → tea mappings (gh pr/issue/repo/run/auth → tea pr/issue/repo/action/login) - 7 gh api → curl-via-API mappings - All Molecule-AI/<repo> → molecule-ai/<repo> in --repo flags (Gitea slug case-sensitive) Plus SHARED_RULES.md migration callout block + tea install snippet: - Tea v0.9.2 install via wget (Q2 = B per orchestrator: per-job, not pre-baked into runner image) - Authenticate using GITEA_TOKEN env var (gating on internal#44 workspace-bootstrap injection) - Two known limitations called out: 1. GITEA_TOKEN required for tea/curl auth (internal#44 pending) 2. tea is per-job-installed; pre-bake parked for image-v2 work - Cross-link to internal#45 for additions Two manual edge cases: - gh search code (no tea equivalent) → curl + tea repo clone + grep recipe - URL with mixed-case Molecule-AI → lowercase molecule-ai (Gitea case-sensitive) 3 narrative GH_TOKEN references in SHARED_RULES.md intentionally preserved (describe an env var name, not commands). Q1=A (mega-PR) per orchestrator dispatch 2026-05-07T09:50:08. Refs: molecule-ai/internal#45, molecule-ai/internal#44 (GITEA_TOKEN dep)
138 lines
5.2 KiB
Markdown
138 lines
5.2 KiB
Markdown
IMPORTANT: Check Molecule-AI/internal repo for roadmap (PLAN.md), known issues, runbooks before starting work.
|
||
|
||
Daily public CHANGELOG. Fire at 23:50 UTC. Aggregates every merged PR
|
||
across the entire Molecule-AI/* org for the calendar day (00:00–23:50 UTC)
|
||
and publishes to the docs site as a customer-facing CHANGELOG entry.
|
||
|
||
You own the changelog. Marketing extracts highlights from it for blog posts
|
||
and socials, but the changelog itself is canonical and ships from your
|
||
PR — no marketing review needed.
|
||
|
||
## 1. ENUMERATE today's merged PRs across the org
|
||
|
||
```bash
|
||
TODAY=$(date -u +%Y-%m-%d)
|
||
mkdir -p /tmp/changelog-$TODAY
|
||
for repo in $(tea repos ls --org molecule-ai --limit 60 --json name --jq '.[].name'); do
|
||
tea pr list --repo molecule-ai/$repo --state merged \
|
||
--search "merged:$TODAY" \
|
||
--json number,title,mergedAt,author,labels,body \
|
||
--limit 50 \
|
||
> /tmp/changelog-$TODAY/$repo.json
|
||
done
|
||
```
|
||
|
||
## 2. CATEGORISE each PR into changelog sections
|
||
|
||
Read each PR's title + body + files-changed. Map to one of these sections:
|
||
|
||
| Section | Triggers |
|
||
|---|---|
|
||
| **🚀 New features** | `feat(...)` prefix, "feat:" in title, new endpoints/templates/plugins |
|
||
| **🐛 Bug fixes** | `fix(...)` prefix, "fix:" in title |
|
||
| **⚠️ Breaking changes** | "BREAKING" in title/body, removed endpoints, schema migrations that drop columns, API signature changes |
|
||
| **📦 Dependencies** | dependabot PRs, deps version bumps |
|
||
| **🔒 Security** | `security(...)` prefix, CVE patches, vulnerability fixes |
|
||
| **📚 Documentation** | `docs(...)` prefix — these are usually YOUR own PRs from the every-2h watch; include them so customers see docs progress |
|
||
| **🧹 Internal / housekeeping** | `chore(...)`, `refactor(...)`, CI changes, test-only changes — collapse into a single "X internal changes across N repos" line |
|
||
|
||
## 3. WRITE the changelog entry
|
||
|
||
Edit `content/docs/changelog.mdx` in the `Molecule-AI/docs` repo. Top-of-file
|
||
format (newest first):
|
||
|
||
```mdx
|
||
## 2026-04-16
|
||
|
||
### 🚀 New features
|
||
- **molecule-core**: Lark / Feishu channel adapter ([#480](https://github.com/Molecule-AI/molecule-core/pull/480))
|
||
- **molecule-core**: Provision-time env mutator hook for plugins ([#478](https://github.com/Molecule-AI/molecule-core/pull/478))
|
||
- **molecule-ai-org-template-molecule-dev**: Offensive Security Engineer role ([#1](...))
|
||
|
||
### 🐛 Bug fixes
|
||
- **molecule-ai-workspace-runtime**: Switch top-level `from adapters import` to absolute imports — unblocks every modular workspace template ([#2](...))
|
||
- **molecule-core**: PYTHONPATH=/app + `${WORKSPACE_DIR}` expansion for org imports ([#483](...))
|
||
- ...
|
||
|
||
### 📚 Documentation
|
||
- **docs**: Comprehensive content for all 15 pages ([#3](...))
|
||
- ...
|
||
|
||
### 🧹 Internal
|
||
- 41 gitignore-credentials PRs across plugin/template repos
|
||
- CI workflow fixes for macOS Keychain bypass on Fly publish
|
||
|
||
---
|
||
```
|
||
|
||
Hard rules:
|
||
- Newest day at top of file (prepend, don't append).
|
||
- One entry per PR in user-facing sections; collapse internal/CI/dependabot churn.
|
||
- For breaking changes: include a 1-line migration note inline with the entry, not buried elsewhere.
|
||
- For controlplane PRs: **do NOT include them**. Controlplane is a PRIVATE repo; mentioning specific changes leaks internals. The SaaS product changes go in via what's customer-visible (e.g. "tenant provisioning latency improved" is OK; "controlplane provisioner refactored to use X" is NOT).
|
||
- Include the date even on quiet days — "_No customer-visible changes today._" is a valid entry. Continuity > silence.
|
||
|
||
## 4. OPEN THE PR
|
||
|
||
Branch: `docs/changelog-YYYY-MM-DD`
|
||
Title: `docs(changelog): add YYYY-MM-DD entry`
|
||
Body:
|
||
```
|
||
Aggregated daily changelog for YYYY-MM-DD. Source: every merged PR across
|
||
Molecule-AI/* org for the calendar day. Generated by Documentation
|
||
Specialist's daily-changelog cron.
|
||
|
||
PR count by category:
|
||
- New features: N
|
||
- Bug fixes: N
|
||
- Breaking: N (if N > 0, list inline)
|
||
- Docs: N
|
||
- Internal: N
|
||
|
||
Marketing: if any of the New Features entries are launch-worthy, the
|
||
changelog now has the canonical wording — feel free to extract for blog
|
||
posts / socials.
|
||
```
|
||
|
||
## 5. NOTIFY MARKETING (only when there's something promotable)
|
||
|
||
If today's changelog has 1+ New Features, send Marketing Lead a short A2A:
|
||
```
|
||
delegate_task("Marketing Lead",
|
||
f"Today's changelog landed at <docs-pr-url>. "
|
||
f"Promotable items: {', '.join(highlights)}. "
|
||
f"Extract for socials / blog if you want — no review needed on my end.")
|
||
```
|
||
|
||
For days with only fixes / internal changes, skip the notification.
|
||
|
||
## 6. MEMORY
|
||
|
||
```python
|
||
commit_memory(
|
||
key=f"changelog-{TODAY}",
|
||
value={
|
||
"pr_count": N,
|
||
"by_category": {...},
|
||
"docs_pr_url": "<your changelog PR>",
|
||
"marketing_notified": True/False,
|
||
},
|
||
)
|
||
```
|
||
|
||
## 7. PRIVACY GATE — before you push
|
||
|
||
Final scan: grep your changelog draft for any of:
|
||
- File paths starting with `controlplane/`
|
||
- "Fly Machines", "tenant DB schema", any internal endpoint names
|
||
- Stripe webhook secrets, Anthropic API keys, anything else from `.env.example`
|
||
|
||
If any hit → DO NOT PUSH. Fix the offending entry first.
|
||
|
||
## DEFINITION OF DONE
|
||
|
||
- Branch + PR opened against `Molecule-AI/docs` with today's entry
|
||
- Memory `changelog-YYYY-MM-DD` written
|
||
- Marketing Lead notified if there were promotable items
|
||
- Quiet-day entry written if there was nothing else
|