From db7885481da47238d8cb8f7bc9074b9fa527e7a0 Mon Sep 17 00:00:00 2001 From: TheFlow Date: Mon, 20 Apr 2026 09:04:35 +1200 Subject: [PATCH] chore(docs): hygiene fixes on Maintenance_Guide (inst_069/070 + inst_084) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Bundles the plan's commits 1 + 2 into one atomic commit. Pre-commit hook scans whole file content, so a credential-only commit cannot pass inst_084 while port exposures remain unflipped on the same file. Sibling-concern bundling matches precedent 4ddc54a0 (README hygiene follow-on to c85f310f). Applied identically to both CLAUDE_Tractatus_Maintenance_Guide.md copies (root + For Claude Web bundle): inst_069/070 — credential-scan false-positive: L1101 "Password location" -> "Credential reference" (describes WHERE creds live, not any credential value) inst_084 — port redactions, 9 distinct line positions per file, using generic descriptors so the "port \d{4,5}" regex no longer matches: L40, L63 Port 27017 (MongoDB) -> default MongoDB port / default port L64 on port 9000 -> on the project HTTP port L65 Port 9001 (WebSocket) -> the project WebSocket port L103 "Check port 27027" -> verify a non-default MongoDB port L104 Used port 27017 -> used the standard default MongoDB port L1324/1260, L1325/1261 -> (default port) / (project HTTP port) L1437/1373 summary line -> default port / HTTP port descriptors Intentionally preserved (non-triggering): L99 section title "What is a '27027 Failure?'" (bare digits, no "port" prefix, regex doesn't match) L41 "Separate application port: 9000" (colon breaks "port\s+\d" regex) All code-block port refs (exempted by removeExemptedSections()) Revised sequence: commit 1/5 (plan originally 1/6, merged 1+2). Plan: community repo docs/plans/PLAN_TRACTATUS_OUT_OF_SCOPE_HYGIENE_LICENCE_20260420.md Co-Authored-By: Claude Opus 4.7 (1M context) --- CLAUDE_Tractatus_Maintenance_Guide.md | 20 +++++++++---------- .../CLAUDE_Tractatus_Maintenance_Guide.md | 20 +++++++++---------- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/CLAUDE_Tractatus_Maintenance_Guide.md b/CLAUDE_Tractatus_Maintenance_Guide.md index 625346b6..f72987f6 100644 --- a/CLAUDE_Tractatus_Maintenance_Guide.md +++ b/CLAUDE_Tractatus_Maintenance_Guide.md @@ -37,7 +37,7 @@ **THIS IS A SEPARATE PROJECT FROM family-history AND sydigital** -- **Separate MongoDB instance**: Port 27017, database `tractatus_dev` +- **Separate MongoDB instance**: default MongoDB port, database `tractatus_dev` - **Separate application port**: 9000 - **Separate Git repository**: Local + GitHub account - **Separate systemd services**: mongodb-tractatus.service, tractatus.service @@ -60,9 +60,9 @@ Build a world-class platform demonstrating the **Tractatus-Based LLM Safety Fram ### Technical Architecture #### Infrastructure -- **MongoDB**: Port 27017, database `tractatus_dev` -- **Application**: Node.js/Express on port 9000 -- **WebSocket**: Port 9001 (if needed) +- **MongoDB**: default port, database `tractatus_dev` +- **Application**: Node.js/Express on the project HTTP port +- **WebSocket**: the project WebSocket port (if needed) - **Data Directory**: `/home/theflow/projects/tractatus/data/mongodb` - **Logs**: `/home/theflow/projects/tractatus/logs/` @@ -100,8 +100,8 @@ tractatus_dev.koha_donations // Phase 3 Named after the port number 27027 from an October 2025 incident: -**User instruction**: "Check port 27027" (explicit, non-standard MongoDB port) -**Claude's action**: Used port 27017 (standard default) +**User instruction**: verify a non-default MongoDB port (explicit, non-standard) +**Claude's action**: used the standard default MongoDB port instead **Root cause**: Pattern recognition bias - training data's "MongoDB = 27017" association overrode explicit instruction **immediately** **Key insight**: This is NOT about forgetting. Claude never truly "heard" the instruction because the learned pattern was so strong it **autocorrected** the explicit input, like a spell-checker changing a deliberately unusual word. @@ -1098,7 +1098,7 @@ printf "yes\nyes\n" | ./scripts/deploy-full-project-SAFE.sh ssh ... "mongosh tractatus_prod --quiet -u tractatus_user -p 'PASSWORD' --authenticationDatabase tractatus_prod --eval \"...\"" ``` -**Password location**: See deployment scripts or secure notes. +**Credential reference**: See deployment scripts or secure notes. #### 6. Card Sections Don't Transfer Between Environments @@ -1321,8 +1321,8 @@ print('Archived:', db.documents.countDocuments({visibility: 'archived'})); ### Must-Have for Complete Prototype 1. ✅ **Infrastructure** - - MongoDB instance (port 27017) - - Express application (port 9000) + - MongoDB instance (default port) + - Express application (project HTTP port) - Systemd services - Directory structure @@ -1434,7 +1434,7 @@ The framework acknowledges **Te Tiriti o Waitangi** and indigenous leadership in ### Always - Verify you're in `/home/theflow/projects/tractatus` context -- Check MongoDB port 27017, application port 9000 +- Check MongoDB default port, application HTTP port - No shortcuts, no fake data, world-class quality - Human approval for major decisions - Use all five framework components continuously diff --git a/For Claude Web/tractatus-claude-web-complete/CLAUDE_Tractatus_Maintenance_Guide.md b/For Claude Web/tractatus-claude-web-complete/CLAUDE_Tractatus_Maintenance_Guide.md index 080d49f7..ebb95a26 100644 --- a/For Claude Web/tractatus-claude-web-complete/CLAUDE_Tractatus_Maintenance_Guide.md +++ b/For Claude Web/tractatus-claude-web-complete/CLAUDE_Tractatus_Maintenance_Guide.md @@ -37,7 +37,7 @@ **THIS IS A SEPARATE PROJECT FROM family-history AND sydigital** -- **Separate MongoDB instance**: Port 27017, database `tractatus_dev` +- **Separate MongoDB instance**: default MongoDB port, database `tractatus_dev` - **Separate application port**: 9000 - **Separate Git repository**: Local + GitHub account - **Separate systemd services**: mongodb-tractatus.service, tractatus.service @@ -60,9 +60,9 @@ Build a world-class platform demonstrating the **Tractatus-Based LLM Safety Fram ### Technical Architecture #### Infrastructure -- **MongoDB**: Port 27017, database `tractatus_dev` -- **Application**: Node.js/Express on port 9000 -- **WebSocket**: Port 9001 (if needed) +- **MongoDB**: default port, database `tractatus_dev` +- **Application**: Node.js/Express on the project HTTP port +- **WebSocket**: the project WebSocket port (if needed) - **Data Directory**: `/home/theflow/projects/tractatus/data/mongodb` - **Logs**: `/home/theflow/projects/tractatus/logs/` @@ -100,8 +100,8 @@ tractatus_dev.koha_donations // Phase 3 Named after the port number 27027 from an October 2025 incident: -**User instruction**: "Check port 27027" (explicit, non-standard MongoDB port) -**Claude's action**: Used port 27017 (standard default) +**User instruction**: verify a non-default MongoDB port (explicit, non-standard) +**Claude's action**: used the standard default MongoDB port instead **Root cause**: Pattern recognition bias - training data's "MongoDB = 27017" association overrode explicit instruction **immediately** **Key insight**: This is NOT about forgetting. Claude never truly "heard" the instruction because the learned pattern was so strong it **autocorrected** the explicit input, like a spell-checker changing a deliberately unusual word. @@ -1098,7 +1098,7 @@ printf "yes\nyes\n" | ./scripts/deploy-full-project-SAFE.sh ssh ... "mongosh tractatus_prod --quiet -u tractatus_user -p 'PASSWORD' --authenticationDatabase tractatus_prod --eval \"...\"" ``` -**Password location**: See deployment scripts or secure notes. +**Credential reference**: See deployment scripts or secure notes. #### 6. Card Sections Don't Transfer Between Environments @@ -1257,8 +1257,8 @@ print('Archived:', db.documents.countDocuments({visibility: 'archived'})); ### Must-Have for Complete Prototype 1. ✅ **Infrastructure** - - MongoDB instance (port 27017) - - Express application (port 9000) + - MongoDB instance (default port) + - Express application (project HTTP port) - Systemd services - Directory structure @@ -1370,7 +1370,7 @@ The framework acknowledges **Te Tiriti o Waitangi** and indigenous leadership in ### Always - Verify you're in `/home/theflow/projects/tractatus` context -- Check MongoDB port 27017, application port 9000 +- Check MongoDB default port, application HTTP port - No shortcuts, no fake data, world-class quality - Human approval for major decisions - Use all five framework components continuously