info-tech-canon/infospace/assimilation/orwell-logging-diagnostics/ASSIMILATION.md
tegwick 5a1ea90f64 Dispose OrwellLoggingDiagnostics as adapt (INFO-DEC-2026-003)
The canon owner disposed coordination-engine's candidate practice pattern as
adapt, which unblocks COORDINATION-WP-0004-T01. Preserve the source, record
the DecisionRecord, and register the assimilation. The TAMQ known use is
implemented and tested, so the pattern enters at candidate. Canon placement
is planned as proposed workplan INFO-WP-0030.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 121421@bnt-lap001
Assistant-Session: 36f8657c-ebfa-4a2e-9ba0-bff06738f233
2026-09-22 16:21:37 +02:00

3.1 KiB

Assimilation — OrwellLoggingDiagnostics

Status: Decided. Canon placement is pending under INFO-WP-0030. Disposition: Adapt Source: coordination-engine candidate docs/orwell-logging-diagnostics-candidate.md at 628f984, preserved under source/ Authority: INFO-DEC-2026-003, canon owner decision of 2026-09-22 Consumer follow-up: coordination-engine COORDINATION-WP-0004

Scope

The candidate proposes a practice for rare local debugging that needs fields normal logging must omit, such as message bodies, credentials, and terminal output. The capture is an explicit, per-invocation, non-production diagnostic mode that writes to an owner-controlled private sink and is never projected remotely. This assimilation covers the generic practice. TAMQ's --orwell flag, its field list, and its sink location remain owned by tmux-amq.

Findings

  • Not a duplicate. The Observability Model owns Log, LogRecord, LogLevel and LogStream, but states no rule separating verbosity from disclosure. The Data and Security models own sensitive-data classification and do not describe a controlled, temporary exception to omission. No existing pattern covers the tension between diagnosability and non-disclosure.
  • Pattern-shaped. The candidate resolves a recurring tension with ordered practice steps and evidence (the six verifications in its §6). That fits PracticePatternScheme.
  • Known use is implemented, not intended. tmux-amq 04de219 implements the flag in src/tamq/diagnostics.py and src/tamq/cli.py, with tests/test_diagnostics.py. That satisfies the scheme's rule that a known use identifies what was observed. There is one known use, so the lifecycle entry point is candidate.
  • Why adapt, not adopt. The name and the --orwell flag are consumer-specific. The canon form needs a generic name, the scheme's section layout, and imports of the owning concepts instead of restated definitions. The substance of the six practice points carries over.

DecisionRecord — INFO-DEC-2026-003

Context

coordination-engine prepared the candidate under COORDINATION-WP-0003-T04 and transferred canon review to COORDINATION-WP-0004. That workplan cannot close without an explicit owner disposition. The request had not reached this repository through intake. It was raised with the owner directly on 2026-09-22.

Decision

Adapt the candidate into a generic candidate-status practice pattern under infospace/patterns/. It will have a neutral name, import Log/LogRecord, data classification and environment concepts from their owners, and cite tmux-amq as its known use. The Orwell name may remain as an alias in the pattern's Known Uses.

Consequences

  • Canon placement, registration, and the canon version change are INFO-WP-0030 (stage 4 and 5). The assimilation closes when that workplan finishes.
  • coordination-engine can record this disposition in COORDINATION-WP-0004-T01. COORDINATION-WP-0004-T02 waits for the registered artifact ID from INFO-WP-0030.
  • This disposition does not authorize unsafe logging in any runtime. The pattern describes a practice, and its adoption stays with each consumer.