* chore: initialise BEACON framework with all bootstrap artefacts - Problem statement, constitution, architecture doc, roadmap populated - CHANGELOG.md created (Keep a Changelog); README expanded with What-is-this, Install, and Quickstart sections - pyproject.toml gains [project.urls] (repository + documentation) - beacon doctor: 32 pass, 2 pre-commit warns, 0 failures Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore: Phase 1 — add NullHandler to package root, remove hardcoded setLevel T001: logging.getLogger("comfydv").addHandler(NullHandler()) in __init__.py T002: remove logger.setLevel(logging.DEBUG) from format_string.py Also fix pyproject.toml TOML structure (project.urls was inside [project] block) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * test: failing tests for logging modernisation (T010-T through T030-T) RED phase — 5 tests fail for the correct reasons before implementation: T010-T: format_string produces stdout (print block) T011-T: update_widget emits INFO records on hot path T012-T: random_choice produces stdout (colorama/rich prints) T020-T: load_node_state uses print() on error instead of logger.error T021-T: circuit_breaker uses print() instead of logger T001/T002/T030-T already green: NullHandler registered, setLevel removed. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * feat: standardise logging across all nodes (T010-I through T044) GREEN phase — all 11 logging tests pass: T010-I: Remove 8-line diagnostic print block from format_string() T011-I: Downgrade all hot-path logger.info() calls to logger.debug(); switch all logger calls to %-style formatting; remove rich import T012-I: Replace colorama/termcolor/rich print calls in random_choice with logger.debug(); add logger = logging.getLogger(__name__) T020-I: Convert print() on load_node_state error to logger.error() T021-I: Add logger to circuit_breaker; replace print() with logger.debug(); fix logic so status=False triggers the interrupt (per BDD spec) T040: Remove colorama, rich, termcolor from pyproject.toml dependencies T042: ruff check + format clean T044: beacon doctor --strict passes (34/34) Also adds ADR-001 and ADR-002 capturing the stdlib logging and NullHandler decisions, linked from the logging-modernisation epic. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore: mark all 001-standardise-logging tasks complete in tasks.md All [x] checkboxes flipped after 11/11 tests pass and beacon doctor --strict reports 0 failures. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore: mark logging-modernisation epic success criteria complete All success criteria verified: NullHandler added, setLevel removed, print() calls converted, colorama/rich/termcolor removed from deps, zero stdout in normal operation, errors surface at ERROR level, all tests pass. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore: commit spec artefacts and dependency lock for 001-standardise-logging Includes spec.md, plan.md, research.md, BDD feature files, contracts, .beacon.toml backlink, and uv.lock after removing colorama/rich/termcolor. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: James Veitch <darthveitcher@office-mac-mini.local> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Work/ — Transient Workspace
This directory is a scratchpad. Everything here is temporary by design.
Lifecycle
During work → Create freely in Work/
After commit → Promote important insights to ADRs; delete the rest
After merge → Delete sessions/*; prune planning/*; delete analysis/* (if ADR written)
Rule: If it matters long-term, it belongs in ADRs/, Background/, or the codebase. If it lives only in Work/, it will be lost.
Subdirectories
| Directory | Contents | When to delete |
|---|---|---|
sessions/ |
Session summaries, daily notes | After merge to develop |
planning/ |
Feature planning docs, future-features.md | After the feature ships |
analysis/ |
Architecture analysis, spike results | After promoted to ADR, or if stale |
Cleanup command
Run after a release PR merges:
cd project-management/Work
rm -rf sessions/*
rm -rf planning/* # keep only active WIP
rm -rf analysis/* # only if ADRs are written
The post-merge git hook will remind you if session files are older than 2 weeks.
Session file naming
sessions/YYYY-MM-DD-[bullet-or-topic].md
Example content:
# Session: 2026-01-15 — Bullet #3: Azure DevOps integration
## Goal
Wire up MCP azure-devops server to create work items from Claude Code
## What I did
- Installed @tiberriver256/mcp-server-azure-devops
- Configured in .claude/settings.json
- Tested with /azure:devops-task create task: test item
## Decisions made
- Using PAT not service principal for now — ADR-002 written
## Blockers
- None
## Tomorrow
- Bullet #4: Add Fabric query support