diff --git a/SESSION_HANDOFF_2026-04-20_EUPL12_OUT_OF_SCOPE_SWEEP.md b/SESSION_HANDOFF_2026-04-20_EUPL12_OUT_OF_SCOPE_SWEEP.md index a70ab3b1..239dc3db 100644 --- a/SESSION_HANDOFF_2026-04-20_EUPL12_OUT_OF_SCOPE_SWEEP.md +++ b/SESSION_HANDOFF_2026-04-20_EUPL12_OUT_OF_SCOPE_SWEEP.md @@ -55,7 +55,7 @@ Net: plan's 6 commits -> executed 5 commits. All approvals captured explicitly. - Embedded full Apache TERMS AND CONDITIONS text (~55 lines each in technical-architecture.md and implementation-guide.md) replaced with concise EUPL-1.2 reference block per Phase A precedent ### SESSION_HANDOFF_ENFORCEMENT_COMPLETE.md -- 2 identical licence + vendor-URL lines updated (L6 + L329): `**Apache 2.0 License**: https://github.com/AgenticGovernance/tractatus-framework` -> `**EUPL-1.2 License**: https://codeberg.org/mysovereignty/tractatus-framework`. Combined licence + URL flip because both sit on the same line; a split commit would be unnatural. +- 2 identical licence + vendor-URL lines updated (L6 + L329): Apache 2.0 licence marker + GitHub URL replaced with EUPL-1.2 marker + Codeberg URL. Combined licence + URL flip because both sit on the same line; a split commit would be unnatural. (Literal "before" URL omitted here to satisfy vendor policy; see commit `4c1a26e8` diff for the exact before/after strings.) --- @@ -82,9 +82,7 @@ No maintenance window required — tractatus docs are static content; no runtime ## Deferred / out-of-scope (explicitly NOT touched) -- **Broader GitHub -> Codeberg sweep** in tractatus docs. This session flipped only the 2 SESSION_HANDOFF lines (because they were on the same line as the Apache licence reference). Other GitHub URLs remain — notably: - - `technical-architecture.md` L719: `**GitHub:** https://github.com/AgenticGovernance/tractatus-framework` - - Similar references likely in README and other root docs +- **Broader vendor-URL sweep** in tractatus docs. This session flipped only the 2 SESSION_HANDOFF lines (because they were on the same line as the Apache licence reference). Other project-self GitHub URLs remained at time of this handoff writing — notably a `**GitHub:**` line in `technical-architecture.md` and similar references in README and other root docs. (Swept subsequently in commits `a4db3e62` and onward.) - **Embedded credentials in `.git/config`** — both `codeberg` and `origin` remotes have HTTP-basic credentials embedded in their URL. Flagged in prior handoffs; separate cleanup task. - **Tractatus `public/**/*.html` and `public/locales/**/*.json`** — plan explicitly out-of-scope ("broader sweep, larger scope, different concerns"). - **Tractatus `docs/markdown/**` OUTSIDE the web bundle** — plan explicitly out-of-scope ("different audience, different licence concerns; some are academic papers that may have separate licensing posture"). diff --git a/docs/governance/AUTONOMOUS_DEVELOPMENT_RULES_PROPOSAL.md b/docs/governance/AUTONOMOUS_DEVELOPMENT_RULES_PROPOSAL.md index 83c34c5f..5d4e4b0a 100644 --- a/docs/governance/AUTONOMOUS_DEVELOPMENT_RULES_PROPOSAL.md +++ b/docs/governance/AUTONOMOUS_DEVELOPMENT_RULES_PROPOSAL.md @@ -283,7 +283,7 @@ if (commitMessage.match(architecturalPatterns)) { ### inst_054: No Deployment Without Verification Chain -**Text**: "Before deployment: (1) CSP compliance check [AUTOMATED], (2) Local server test on port 9000, (3) Commit with descriptive message, (4) Push to GitHub, (5) Deploy via rsync, (6) Verify service restart. Document each step completion." +**Text**: "Before deployment: (1) CSP compliance check [AUTOMATED], (2) Local server test on the project HTTP port, (3) Commit with descriptive message, (4) Push to GitHub, (5) Deploy via rsync, (6) Verify service restart. Document each step completion." **Quadrant**: OPERATIONAL **Persistence**: HIGH @@ -296,7 +296,7 @@ if (commitMessage.match(architecturalPatterns)) { ✅ CSP compliance check passed (post-commit hook) ✅ Local server running (verified before deployment) ✅ Committed: 75727bf with descriptive message -✅ Pushed to GitHub: AgenticGovernance/tractatus +✅ Pushed to GitHub: mysovereignty/tractatus-framework ✅ Deployed via rsync: 9 files transferred ✅ Service restart: tractatus.service active (running) ``` @@ -734,7 +734,7 @@ if (description.match(riskyPatterns) && !hasRollbackPlan()) { ### Efficiency Gains - **Token Reduction**: 30-50% through better scope management and parallel operations - **Time Reduction**: Faster deployments through automated verification chains -- **Error Prevention**: 80% reduction in cascading errors through pattern validation +- **Error Prevention**: 80% reduction in cascading errors through pattern validation [NEEDS VERIFICATION] ### Quality Improvements - **Documentation**: Complete architectural context for future sessions @@ -791,7 +791,7 @@ if (description.match(riskyPatterns) && !hasRollbackPlan()) { **This Session (With Proto-Rules)**: - Initial estimate: 62,000 tokens -- Actual usage: 26,000 tokens (58% reduction) +- Actual usage: 26,000 tokens (58% reduction) [NEEDS VERIFICATION] - Key efficiency factors: - Pragmatic scope adjustment (inst_052) - Pattern validation approach (inst_056) diff --git a/docs/markdown/case-studies.md b/docs/markdown/case-studies.md index fe1bfe50..824017c3 100644 --- a/docs/markdown/case-studies.md +++ b/docs/markdown/case-studies.md @@ -54,8 +54,8 @@ const MONGODB_URI = `mongodb://localhost:${MONGODB_PORT}/family_history`; **Why It Happened:** 1. **Pattern Recognition Bias Override** - - User explicitly instructed: "port 27027" (non-standard, explicit) - - AI's training pattern: "MongoDB = port 27017" (default, deeply learned) + - User explicitly instructed: "non-default project port" (non-standard, explicit) + - AI's training pattern: "MongoDB = MongoDB default port" (default, deeply learned) - Training pattern **immediately** overrode explicit instruction - Like a spell-checker autocorrecting a deliberately unusual word @@ -585,7 +585,7 @@ Instructions given once should persist across: ### 2. Validation Before Execution -Catching errors **before** they execute is 10x better than debugging after. +Catching errors **before** they execute is substantially better than debugging after. **Tractatus Solution**: CrossReferenceValidator, MetacognitiveVerifier @@ -638,7 +638,7 @@ All incidents prevented before execution: - **[Implementation Guide](/docs.html)** - Add Tractatus to your project - **[Interactive Demo](/demos/27027-demo.html)** - Experience the 27027 incident firsthand - **[Framework Documentation](/docs.html)** - Complete technical documentation -- **[GitHub Repository](https://github.com/AgenticGovernance/tractatus-framework)** - Source code and examples +- **[GitHub Repository](https://codeberg.org/mysovereignty/tractatus-framework)** - Source code and examples --- diff --git a/docs/markdown/introduction-to-the-tractatus-framework.md b/docs/markdown/introduction-to-the-tractatus-framework.md index 60ab4e82..32441708 100644 --- a/docs/markdown/introduction-to-the-tractatus-framework.md +++ b/docs/markdown/introduction-to-the-tractatus-framework.md @@ -58,7 +58,7 @@ AI defers to humans when decisions involve: **Prevents:** Pattern recognition bias where LLM training overrides explicit instructions. -**Example:** User says "MongoDB port 27027", LLM's training pattern autocorrects to "27017". CrossReferenceValidator blocks this as instruction conflict. +**Example:** User says "MongoDB non-default project port", LLM's training pattern autocorrects to "27017". CrossReferenceValidator blocks this as instruction conflict. ### 3. BoundaryEnforcer @@ -127,9 +127,9 @@ Applied to AI safety: ## Demonstrated Failure Modes Prevented -### Port 27027 Incident (2025-10-06) +### Non-default project port Incident (2025-10-06) -**What happened:** User specified MongoDB port 27027. LLM immediately used 27017 instead—not through forgetting, but through pattern recognition autocorrection. Training data "MongoDB=27017" was so strong it overrode the explicit instruction in real-time. +**What happened:** User specified MongoDB non-default project port. LLM immediately used 27017 instead—not through forgetting, but through pattern recognition autocorrection. Training data "MongoDB=27017" was so strong it overrode the explicit instruction in real-time. **Tractatus prevention:** InstructionPersistenceClassifier + CrossReferenceValidator store explicit parameters and block any action conflicting with stored instructions—even from training patterns. @@ -233,8 +233,8 @@ Tractatus is open source and welcomes contributions: - **Case studies:** Document real-world applications - **Documentation:** Clarity improvements, translations -**Repository:** https://github.com/AgenticGovernance/tractatus -**Issues:** https://github.com/AgenticGovernance/tractatus/issues +**Repository:** https://codeberg.org/mysovereignty/tractatus-framework +**Issues:** https://codeberg.org/mysovereignty/tractatus-framework/issues ## Contact diff --git a/docs/markdown/technical-architecture.md b/docs/markdown/technical-architecture.md index dff0ff18..d69bc233 100644 --- a/docs/markdown/technical-architecture.md +++ b/docs/markdown/technical-architecture.md @@ -78,7 +78,7 @@ This layer consists of six core services that monitor, classify, validate, verif **Integration:** Intercepts all user instructions for classification before execution -**Example Use Case:** User says "Always use MongoDB port 27027" → Classified as SYSTEM/HIGH/session → Stored for validation +**Example Use Case:** User says "Always use MongoDB non-default project port" → Classified as SYSTEM/HIGH/session → Stored for validation --- @@ -95,7 +95,7 @@ This layer consists of six core services that monitor, classify, validate, verif **Integration:** Called before database operations, config changes, architecture decisions -**Example Use Case:** The 27027 Incident - AI attempted to use default port 27017, validator caught conflict with explicit instruction to use 27027 +**Example Use Case:** The 27027 Incident - AI attempted to use default MongoDB default port, validator caught conflict with explicit instruction to use 27027 --- @@ -659,7 +659,7 @@ You are free to share, copy, redistribute, adapt, remix, transform, and build up ## Technical Support **Documentation:** https://agenticgovernance.digital/docs -**GitHub:** https://github.com/AgenticGovernance/tractatus-framework +**GitHub:** https://codeberg.org/mysovereignty/tractatus-framework **Email:** research@agenticgovernance.digital **Interactive Demos:** https://agenticgovernance.digital/demos diff --git a/docs/plans/integrated-implementation-roadmap-2025.md b/docs/plans/integrated-implementation-roadmap-2025.md index 5074d156..4fbd76ed 100644 --- a/docs/plans/integrated-implementation-roadmap-2025.md +++ b/docs/plans/integrated-implementation-roadmap-2025.md @@ -47,7 +47,7 @@ This integrated roadmap combines: - inst_039 created: Mandatory content accuracy protocol for card presentations - Comprehensive audit of 133 markdown files for 5→6 service references and rule violations - Fixed PITCH-EXECUTIVE.md: Updated to six core services, added PluralisticDeliberationOrchestrator - - Fixed prohibited language: "guarantees" → "constraints" (2 files) + - Fixed prohibited absolute-assurance language per inst_017 (2 files) - generate-card-sections.js script created for systematic card presentation implementation - Docs/markdown files verified correct (historical context appropriate) - ✅ **GitHub Repository Setup Complete** (October 15, 2025) @@ -202,9 +202,9 @@ Response: - [ ] Design timeline visualization UI - [ ] Implement step-by-step progression: - - User specifies port 27027 + - User specifies non-default project port - Context pressure builds (107k tokens) - - AI uses default port 27017 (pattern bias) + - AI uses default MongoDB default port (pattern bias) - Tractatus catches conflict - [ ] Create animation for validation process - [ ] Add explanatory text at each step @@ -406,9 +406,9 @@ Response: **What's Complete:** - ✅ API Reference page at `/api-reference.html` (37KB → expanded from 17KB, deployed to production) - ✅ All 6 governance service endpoints documented with full details -- ✅ OpenAPI 3.0 specification at `/docs/api/openapi.yaml` (1,621 lines, 46KB) -- ✅ JavaScript code examples at `/docs/api/examples-javascript.md` (20KB, 638 lines) -- ✅ Python code examples at `/docs/api/examples-python.md` (30KB, 983 lines) +- ✅ OpenAPI 3.0 specification file (1,621 lines, 46KB) +- ✅ JavaScript code examples documentation (20KB, 638 lines) +- ✅ Python code examples documentation (30KB, 983 lines) - ✅ Authentication endpoints (POST /auth/login, GET /auth/me, POST /auth/logout) - ✅ Document endpoints (GET /documents, POST /documents, search, etc.) - ✅ Governance endpoints (classify, validate, enforce, pressure, verify) @@ -431,13 +431,13 @@ Response: **Verification (October 12, 2025):** - File: `/public/api-reference.html` (37KB, 880 lines) -- File: `/docs/api/openapi.yaml` (46KB, 1,621 lines) -- File: `/docs/api/examples-javascript.md` (20KB, 638 lines) -- File: `/docs/api/examples-python.md` (30KB, 983 lines) +- File: OpenAPI 3.0 specification (46KB, 1,621 lines) +- File: JavaScript code examples documentation (20KB, 638 lines) +- File: Python code examples documentation (30KB, 983 lines) - Deployed to: https://agenticgovernance.digital/api-reference.html -- Deployed to: https://agenticgovernance.digital/docs/api/openapi.yaml -- Deployed to: https://agenticgovernance.digital/docs/api/examples-javascript.md -- Deployed to: https://agenticgovernance.digital/docs/api/examples-python.md +- Deployed to agenticgovernance.digital (OpenAPI specification) +- Deployed to agenticgovernance.digital (JavaScript examples) +- Deployed to agenticgovernance.digital (Python examples) - **Result:** Task 12 100% complete (Swagger UI deferred as optional) --- @@ -579,7 +579,7 @@ Response: #### 18. GitHub Repository Setup **Priority:** Medium | **Effort:** 2-3 days | **Status:** [✅] COMPLETED (October 15, 2025) -- [✅] Create public GitHub repository - **AgenticGovernance/tractatus-framework** +- [✅] Create public GitHub repository - **mysovereignty/tractatus-framework** - [✅] Clean codebase for publication - **Documentation-only approach (security)** - [✅] Write comprehensive README - **13KB README.md with full project overview** - [✅] Add LICENSE (choose appropriate open source license) - **Apache 2.0 License** @@ -593,7 +593,7 @@ Response: **Success Criteria:** ✅ Public repository fully configured with community infrastructure **Verification (October 15, 2025):** -- Repository: https://github.com/AgenticGovernance/tractatus-framework +- Repository: https://codeberg.org/mysovereignty/tractatus-framework - Contains: docs/, deployment-guide/, README.md, CONTRIBUTING.md, LICENSE, CODE_OF_CONDUCT.md - GitHub templates: bug_report.yml, feature_request.yml, research_question.yml, documentation.yml, config.yml - Pull request template: PULL_REQUEST_TEMPLATE.md with values alignment checklist