broad-announce.dlog 4.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. ================================================================================
  2. broad-announce.dlog — deployment log
  3. ================================================================================
  4. Project: broad-announce
  5. Owner: Luis Rosales
  6. Last update: 2026-06-17 19:14 EDT
  7. Purpose: This is the canonical project log. Entries here point to
  8. milestone-specific .dlog files for the rich narrative; this
  9. file is the table of contents and the project-wide
  10. standing rule.
  11. ================================================================================
  12. STANDING RULE — DEPLOYMENT PROTOCOL (binding for every session)
  13. ================================================================================
  14. Rule: Update this file (or the relevant milestone .dlog) at the END
  15. of every deployment. This is a hard rule, not a suggestion.
  16. It applies to every session, every model, every operator.
  17. What counts as a "deployment" (UPDATE the file):
  18. • Code changes that pass tests and are committed
  19. • Schema migrations (up OR down)
  20. • New HTTP routes / new endpoints
  21. • New UI features / new pages
  22. • Smoke scripts that exercise real endpoints
  23. • Bug fixes that change behavior
  24. • Any change to a service binary's runtime behavior
  25. • Config / env changes that affect runtime behavior
  26. What does NOT count (DO NOT update the file just for these):
  27. • Documentation changes (README, comments, this file itself)
  28. • Architecture decisions / plans / surveys
  29. • Pure refactors with no behavior change
  30. • Test-only changes that don't exercise new code paths
  31. • Cosmetic UI tweaks that don't add a feature
  32. What an entry must contain:
  33. 1. Timestamp (EDT)
  34. 2. One-line summary of what shipped
  35. 3. Commit hash
  36. 4. Top-level files added/changed
  37. 5. Tests run + result
  38. 6. Verification commands
  39. 7. Known issues / next step
  40. When to update: at the END of the session, OR when an obvious natural
  41. break appears. Never mid-implementation.
  42. ================================================================================
  43. MILESTONE LOGS (richer, narrative-style)
  44. ================================================================================
  45. The actual deployment entries live in milestone-specific files.
  46. This file is the index. Add a row here when you create a new
  47. milestone .dlog.
  48. M13b.dlog — M13b (admin UI). W0 + W1 shipped; W2 (Sources)
  49. and W3 (Telegram bot) next. See M13b.dlog for the
  50. full status, files, tests, and verify commands.
  51. ================================================================================
  52. ENTRY LOG (most recent first; append new entries at the TOP of this block)
  53. ================================================================================
  54. [Cross-cutting deployments only. Milestone-specific entries live in
  55. the milestone .dlog referenced above. Add a row here only when a
  56. deployment spans milestones or is workspace-meta (e.g. adopting the
  57. .dlog protocol itself).]
  58. 2026-06-17 19:14 EDT — .dlog protocol adopted workspace-wide
  59. Commit: this commit (broad-announce.dlog created + this index)
  60. Files: broad-announce.dlog (new), M13b.dlog (existing),
  61. DEPLOYMENT_LOG.md (workspace root), MEMORY.md (workspace root)
  62. Tests: n/a (protocol setup, not a code change)
  63. Verify: cat /root/.openclaw/workspace/DEPLOYMENT_LOG.md
  64. cat broad-announce.dlog
  65. cat M13b.dlog
  66. Notes: Per the new rule, M13b.dlog entries are the deployment log
  67. for M13b work. broad-announce.dlog is the project index.
  68. Future milestones (M14, M15, etc.) should get their own
  69. <milestone>.dlog with a row added above.
  70. ================================================================================
  71. ENTRY TEMPLATE (copy this for each new deployment)
  72. ================================================================================
  73. YYYY-MM-DD HH:MM EDT — <one-line summary>
  74. Commit: <hash>
  75. Files: <top-level paths added/changed>
  76. Tests: <go test / pnpm test / smoke> → <result>
  77. Verify: <one or more commands the next session can run to confirm>
  78. Notes: <known issues, follow-ups, or 'none'>
  79. ================================================================================