diff --git a/docs/markdown/GLOSSARY.md b/docs/markdown/GLOSSARY.md index 43740082..fe5020ae 100644 --- a/docs/markdown/GLOSSARY.md +++ b/docs/markdown/GLOSSARY.md @@ -66,7 +66,7 @@ Think of this glossary as your companion guide to understanding how we keep AI s ### AI Safety Framework -**What it means:** A comprehensive system designed to ensure AI systems operate safely, reliably, and in alignment with human values and instructions. +**What it means:** A comprehensive system designed to help AI systems operate safely, reliably, and in alignment with human values and instructions. **Why it matters:** As AI systems become more capable and autonomous, the risk of unintended consequences increases. Safety frameworks provide guardrails that prevent AI from causing harm, whether through errors, misunderstandings, or operating beyond its intended scope. @@ -96,7 +96,7 @@ Think of this glossary as your companion guide to understanding how we keep AI s **Real-world analogy:** Imagine filing documents. Some go in permanent files (company policies), some in project folders (accessible until project ends), some on your desk (relevant today only). The Instruction Persistence Classifier is the filing system for AI instructions. -**In Tractatus:** When you say "always use port 27027," the classifier recognizes the word "always" and the explicit number, marking this as HIGH persistence. The AI system stores this instruction and checks every future database connection against it. +**In Tractatus:** When you say "always use port 27027," the classifier recognizes the word "always" and the explicit number, marking this as HIGH persistence. The AI system stores this instruction and checks every future database connection against it, designed to prevent violations. --- @@ -154,12 +154,14 @@ Think of this glossary as your companion guide to understanding how we keep AI s **Why it matters:** AI systems, like humans, perform worse under pressure. A fresh AI at the start of a conversation is more reliable than one that's been working for hours with thousands of pieces of information to track. The Context Pressure Monitor detects these degraded states and adjusts AI behavior accordingly. **How it works:** -Tracks five weighted factors: -- **Token Usage (35%):** How much of the AI's "working memory" is consumed -- **Conversation Length (25%):** How many messages in the current session +Tracks five weighted factors (updated 2025-10-12): +- **Conversation Length (40%):** PRIMARY factor - message count drives compaction events +- **Token Usage (30%):** How much of the AI's "working memory" is consumed - **Task Complexity (15%):** Number of simultaneous tasks and dependencies -- **Error Frequency (15%):** Recent errors indicate degraded performance -- **Instruction Density (10%):** Too many competing directives cause confusion +- **Error Frequency (10%):** Recent errors indicate degraded performance +- **Instruction Density (5%):** Too many competing directives cause confusion + +**Why conversation length is PRIMARY:** Empirical evidence shows compaction events (triggered by message count ~60 messages, not just tokens) are the main cause of session disruption. Each compaction loses critical context and degrades quality dramatically. Calculates overall pressure level: - **NORMAL (0-30%):** Proceed normally @@ -1134,5 +1136,41 @@ If any term remains unclear or you need deeper explanation, please ask. The goal --- -**Last Updated:** 2025-10-12 -**Next Review:** 2025-11-12 (or on request) +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Summary:** +- ✅ Commercial use allowed +- ✅ Modification allowed +- ✅ Distribution allowed +- ✅ Patent grant included +- ✅ Private use allowed +- ⚠️ Must include license and copyright notice +- ⚠️ Must state significant changes +- ❌ No trademark rights granted +- ❌ No liability or warranty + +--- + +## Document Metadata + +
+ +- **Version:** 1.1 +- **Created:** 2025-10-07 +- **Last Modified:** 2025-10-13 +- **Author:** John Stroh +- **Word Count:** ~11,000 words +- **Reading Time:** ~55 minutes +- **Document ID:** glossary +- **Status:** Active +- **Next Review:** 2025-11-12 + +
diff --git a/docs/markdown/business-case-tractatus-framework.md b/docs/markdown/business-case-tractatus-framework.md index 4d2faebc..5da95df9 100644 --- a/docs/markdown/business-case-tractatus-framework.md +++ b/docs/markdown/business-case-tractatus-framework.md @@ -14,7 +14,7 @@ date_created: 2025-10-09 **Document Purpose:** This template helps organizations evaluate AI governance needs and assess whether the Tractatus Framework approach aligns with their strategic requirements. It is designed to be completed with your organization's actual data, not used as-is. -**What This Is NOT:** This is not a complete business case with guaranteed ROI figures. Organizations must conduct their own analysis based on their specific risk profile, regulatory exposure, and AI deployment plans. +**What This Is NOT:** This is not a complete business case with projected ROI figures. Organizations must conduct their own analysis based on their specific risk profile, regulatory exposure, and AI deployment plans. --- @@ -700,7 +700,7 @@ For each high-risk system, estimate: This template is provided as a starting point for organizational assessment. It is not: - A completed business case ready for presentation -- A guarantee of specific outcomes or ROI +- An assurance of specific outcomes or ROI - Legal or compliance advice - A substitute for professional risk assessment - An endorsement or recommendation of any specific approach @@ -727,3 +727,46 @@ Any statistics cited in this template reference industry research (not Tractatus --- *This is a template document. It must be completed with organization-specific data before use in decision-making processes.* + +--- + +## Document Metadata + +
+ +- **Version:** 2.0 +- **Created:** 2025-10-09 +- **Last Modified:** 2025-10-13 +- **Author:** SyDigital Ltd +- **Word Count:** 3,250 words +- **Reading Time:** ~16 minutes +- **Document ID:** business-case-tractatus-framework +- **Status:** Active (Template) + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. diff --git a/docs/markdown/case-studies.md b/docs/markdown/case-studies.md index 124db172..2852f231 100644 --- a/docs/markdown/case-studies.md +++ b/docs/markdown/case-studies.md @@ -591,7 +591,7 @@ Catching errors **before** they execute is 10x better than debugging after. Values, ethics, user agency - these require human judgment. -**Tractatus Solution**: BoundaryEnforcer with architectural guarantees +**Tractatus Solution**: BoundaryEnforcer with architectural design ### 4. Quality Degrades Predictably @@ -601,7 +601,7 @@ Context pressure, token usage, error rates - these predict quality loss. ### 5. Architecture > Training -You can't train an AI to "be careful" - you need structural guarantees. +You can't train an AI to "be careful" - you need structural design. **Tractatus Solution**: All six services working together @@ -641,3 +641,46 @@ All incidents prevented before execution: --- **Related:** Browse more topics in [Framework Documentation](/docs.html) + +--- + +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-09-01 +- **Last Modified:** 2025-10-13 +- **Author:** SyDigital Ltd +- **Word Count:** 2,230 words +- **Reading Time:** ~11 minutes +- **Document ID:** case-studies +- **Status:** Active + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. diff --git a/docs/markdown/comparison-matrix.md b/docs/markdown/comparison-matrix.md index 333caf0e..a28a9d92 100644 --- a/docs/markdown/comparison-matrix.md +++ b/docs/markdown/comparison-matrix.md @@ -519,7 +519,7 @@ AuditLogger (log decision) **CLAUDE.md:** Manual project documentation **Tractatus:** Automated governance enforcement -**Together:** Production-ready AI with architectural safety guarantees +**Together:** Production-ready AI with architectural safety design **The Trade-Off:** - **Cost:** <10ms overhead, 1-2 days integration, MongoDB requirement @@ -538,6 +538,86 @@ AuditLogger (log decision) --- -**Version:** 1.0 -**Last Updated:** October 12, 2025 -**Maintained By:** Tractatus Framework Team +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-10-12 +- **Last Modified:** 2025-10-13 +- **Author:** Tractatus Framework Team +- **Word Count:** 2,305 words +- **Reading Time:** ~12 minutes +- **Document ID:** comparison-matrix +- **Status:** Active + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Full License Text:** + +Apache License, Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. + +"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work. + +"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: + + (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. + + You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS diff --git a/docs/markdown/core-concepts.md b/docs/markdown/core-concepts.md index d05c8140..1194102a 100644 --- a/docs/markdown/core-concepts.md +++ b/docs/markdown/core-concepts.md @@ -341,18 +341,22 @@ Tractatus approach: **Monitor and intervene before failure** ### Pressure Factors (Weighted) -1. **Token Usage** (35% weight) +**Updated 2025-10-12:** Weights rebalanced after observing that compaction events (triggered by message count, not just tokens) are the PRIMARY cause of session disruption. Each compaction loses critical context and degrades quality dramatically. + +1. **Conversation Length** (40% weight) - **PRIMARY FACTOR** + - Number of messages exchanged + - Compaction events occur at ~60 messages + - Short (<20 messages) = LOW + - Medium (20-40 messages) = MODERATE + - Long (40-60 messages) = HIGH + - Multiple compactions = CRITICAL + +2. **Token Usage** (30% weight) - Context window capacity - 0-30% tokens = LOW pressure - 30-70% tokens = MODERATE pressure - 70%+ tokens = HIGH pressure -2. **Conversation Length** (25% weight) - - Number of messages exchanged - - Short (<20 messages) = LOW - - Medium (20-50 messages) = MODERATE - - Long (50+ messages) = HIGH - 3. **Task Complexity** (15% weight) - Number of active tasks - File modifications in progress @@ -361,13 +365,13 @@ Tractatus approach: **Monitor and intervene before failure** - Complex (3-5 tasks) = MODERATE - Very complex (5+ tasks) = HIGH -4. **Error Frequency** (15% weight) +4. **Error Frequency** (10% weight) - Recent errors/failures - No errors = LOW - 1-2 errors = MODERATE - 3+ errors = HIGH -5. **Instruction Density** (10% weight) +5. **Instruction Density** (5% weight) - Number of active instructions - Conflicting directives - Low (<5 instructions) = LOW @@ -853,3 +857,43 @@ The six services integrate at multiple levels: --- **Related:** Browse more topics in [Framework Documentation](/docs.html) + +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Summary:** +- ✅ Commercial use allowed +- ✅ Modification allowed +- ✅ Distribution allowed +- ✅ Patent grant included +- ✅ Private use allowed +- ⚠️ Must include license and copyright notice +- ⚠️ Must state significant changes +- ❌ No trademark rights granted +- ❌ No liability or warranty + +--- + +## Document Metadata + +
+ +- **Version:** 0.5.0 +- **Created:** 2025-10-12 +- **Last Modified:** 2025-10-13 +- **Author:** John Stroh +- **Word Count:** 3,359 words +- **Reading Time:** ~17 minutes +- **Document ID:** core-concepts +- **Status:** Active + +
diff --git a/docs/markdown/implementation-guide-v1.1.md b/docs/markdown/implementation-guide-v1.1.md index ab20cd7e..72832681 100644 --- a/docs/markdown/implementation-guide-v1.1.md +++ b/docs/markdown/implementation-guide-v1.1.md @@ -544,3 +544,46 @@ mongosh **Version History**: - v1.1 (2025-10-11): Complete rewrite for MongoDB architecture - v1.0 (2025-10-07): Initial version (filesystem-based) + +--- + +## Document Metadata + +
+ +- **Version:** 1.1 +- **Created:** 2025-10-07 +- **Last Modified:** 2025-10-13 +- **Author:** Tractatus Framework Team +- **Word Count:** 1,389 words +- **Reading Time:** ~7 minutes +- **Document ID:** implementation-guide-v1.1 +- **Status:** Active + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. diff --git a/docs/markdown/implementation-guide.md b/docs/markdown/implementation-guide.md index aa39c4ae..14eea7a4 100644 --- a/docs/markdown/implementation-guide.md +++ b/docs/markdown/implementation-guide.md @@ -863,4 +863,90 @@ const validation = validator.validate( --- +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-10-12 +- **Last Modified:** 2025-10-13 +- **Author:** SyDigital Ltd +- **Word Count:** 2,248 words +- **Reading Time:** ~12 minutes +- **Document ID:** implementation-guide +- **Status:** Active + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Full License Text:** + +Apache License, Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. + +"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work. + +"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: + + (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. + + You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +--- + **Questions?** Contact: john.stroh.nz@pm.me diff --git a/docs/markdown/introduction-to-the-tractatus-framework.md b/docs/markdown/introduction-to-the-tractatus-framework.md index 0cb06d85..693046c4 100644 --- a/docs/markdown/introduction-to-the-tractatus-framework.md +++ b/docs/markdown/introduction-to-the-tractatus-framework.md @@ -14,13 +14,9 @@ The framework operates through six specialized services that continuously monito ## The Core Problem -Current AI safety approaches rely on: +Current AI safety approaches rely on alignment training (teaching "correct" values), Constitutional AI (embedding principles in training), and RLHF (Reinforcement Learning from Human Feedback). -- **Alignment training** - Teaching AI "correct" values through examples -- **Constitutional AI** - Embedding principles in training data -- **RLHF** - Reinforcement Learning from Human Feedback - -**Fundamental flaw:** These approaches assume the AI will maintain alignment regardless of context pressure, capability level, or competing constraints. Empirical evidence shows this assumption fails. +**Fundamental flaw:** These assume AI maintains alignment regardless of context pressure or competing constraints. Empirical evidence shows this fails. ## The Tractatus Solution @@ -81,11 +77,11 @@ AI defers to humans when decisions involve: **Function:** Tracks session degradation across five factors. **Monitors:** -- Token usage (35% weight) - Context window pressure -- Conversation length (25% weight) - Attention span decay +- Conversation length (40% weight) - PRIMARY factor: message count drives compaction events +- Token usage (30% weight) - Context window pressure - Task complexity (15% weight) - Competing demands -- Error frequency (15% weight) - Quality indicators -- Instruction density (10% weight) - Directive overload +- Error frequency (10% weight) - Quality indicators +- Instruction density (5% weight) - Directive overload **Action:** Recommends session handoff before quality degrades. @@ -191,15 +187,9 @@ Applied to AI safety: ## Integration Requirements -**Minimum:** -1. LLM with structured output support (function calling) -2. Persistent storage (instruction history, precedents) -3. Ability to wrap LLM calls in governance layer +**Minimum:** LLM with structured output support, persistent storage for instruction history, ability to wrap LLM calls in governance layer. -**Recommended:** -1. Session state management -2. Token counting capability -3. User authentication (for human approval workflows) +**Recommended:** Session state management, token counting, user authentication for human approval workflows. ## Limitations @@ -276,6 +266,23 @@ Unless required by applicable law or agreed to in writing, software distributed --- +## Document Metadata + +
+ +- **Version:** 0.5.0 +- **Created:** 2025-10-12 +- **Last Modified:** 2025-10-13 +- **Author:** John Stroh +- **Word Count:** 1,372 words +- **Reading Time:** ~7 minutes +- **Document ID:** introduction-to-the-tractatus-framework +- **Status:** Active + +
+ +--- + **Next Steps:** - [Core Concepts: Deep Dive into Six Services →](/docs.html) - [Case Studies: Real-World Failure Modes →](/docs.html) diff --git a/docs/markdown/introduction.md b/docs/markdown/introduction.md index 0d6905d8..c64f290e 100644 --- a/docs/markdown/introduction.md +++ b/docs/markdown/introduction.md @@ -12,7 +12,7 @@ author: SyDigital Ltd ## What is Tractatus? -The **Tractatus-Based LLM Safety Framework** is a world-first architectural approach to AI safety that preserves human agency through **structural guarantees** rather than aspirational goals. +The **Tractatus-Based LLM Safety Framework** is a world-first architectural approach to AI safety that preserves human agency through **structural design** rather than aspirational goals. Instead of hoping AI systems "behave correctly," Tractatus implements **architectural constraints** that certain decision types **structurally require human judgment**. This creates bounded AI operation that scales safely with capability growth. @@ -81,11 +81,13 @@ Ensures certain decision types **structurally require human approval**: Tracks session degradation across multiple factors: -- **Token usage** (35% weight) - Context window pressure -- **Conversation length** (25% weight) - Attention decay +- **Conversation length** (40% weight) - Message count drives compaction events (PRIMARY degradation factor) +- **Token usage** (30% weight) - Context window pressure - **Task complexity** (15% weight) - Concurrent tasks, dependencies -- **Error frequency** (15% weight) - Recent errors indicate degraded state -- **Instruction density** (10% weight) - Too many competing directives +- **Error frequency** (10% weight) - Recent errors indicate degraded state +- **Instruction density** (5% weight) - Too many competing directives + +**Updated 2025-10-12:** Weights rebalanced after observing that compaction events (triggered by message count ~60 messages, not just tokens) are the PRIMARY cause of session disruption. Each compaction loses critical context and degrades quality dramatically. Recommends session handoffs before quality degrades. @@ -244,3 +246,46 @@ Apache 2.0 - See [LICENSE](https://github.com/anthropics/tractatus/blob/main/LIC --- **Next:** [Core Concepts](https://agenticgovernance.digital/docs.html?doc=core-concepts-of-the-tractatus-framework) | [Implementation Guide](https://agenticgovernance.digital/docs.html?doc=implementation-guide-python-code-examples) | [Case Studies](https://agenticgovernance.digital/docs.html?category=case-studies) + +--- + +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-09-01 +- **Last Modified:** 2025-10-13 +- **Author:** SyDigital Ltd +- **Word Count:** 1,228 words +- **Reading Time:** ~6 minutes +- **Document ID:** introduction +- **Status:** Active + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. diff --git a/docs/markdown/llm-integration-feasibility-research-scope.md b/docs/markdown/llm-integration-feasibility-research-scope.md index c6dcf43d..93eba6d6 100644 --- a/docs/markdown/llm-integration-feasibility-research-scope.md +++ b/docs/markdown/llm-integration-feasibility-research-scope.md @@ -115,7 +115,7 @@ This document defines the *scope* of a proposed 12-18 month feasibility study. I - **Sub-questions**: - Baseline: External governance overhead (minimal, ~0%) - Target: Internal governance overhead (<10%? <25%?) - - Trade-off: Stronger guarantees vs. slower responses + - Trade-off: Stronger assurance vs. slower responses - User perception: At what latency do users notice degradation? **Q4: Does internal governance require model retraining?** @@ -1255,7 +1255,7 @@ During early Phase 5 planning, a critical breakthrough was identified: **Anthrop 2. **Addresses Core Research Questions**: - **Q1 (Persistent state)**: Memory tool provides native, provider-backed persistence - **Q3 (Performance cost)**: API-driven overhead likely <20% (acceptable) - - **Q5 (Instructions vs. training)**: Middleware validation ensures enforcement + - **Q5 (Instructions vs. training)**: Middleware validation helps ensure enforcement - **Q8 (User management)**: Memory API provides programmatic interface 3. **De-risks Long-Term Research**: @@ -1377,3 +1377,46 @@ This document now represents two parallel tracks: |---------|------|---------| | 1.1 | 2025-10-10 08:30 UTC | **Major Update**: Added Section 3.6 (Memory Tool Integration), Section 15 (Recent Developments), updated feasibility assessment to reflect memory tool breakthrough | | 1.0 | 2025-10-10 00:00 UTC | Initial public release | + +--- + +## Document Metadata + +
+ +- **Version:** 1.1 +- **Created:** 2025-10-10 +- **Last Modified:** 2025-10-13 +- **Author:** Tractatus Framework Research Team +- **Word Count:** 6,675 words +- **Reading Time:** ~33 minutes +- **Document ID:** llm-integration-feasibility-research-scope +- **Status:** Active (Research Proposal) + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. diff --git a/docs/markdown/organizational-theory-foundations.md b/docs/markdown/organizational-theory-foundations.md index 58b550c1..6667d52c 100644 --- a/docs/markdown/organizational-theory-foundations.md +++ b/docs/markdown/organizational-theory-foundations.md @@ -24,7 +24,7 @@ Traditional organizational hierarchies were designed around a fundamental premis This model faces existential challenges in the AI era. When artificial intelligence assistants provide universal access to information and capabilities, knowledge is no longer scarce but ubiquitous. The fundamental organizing principle of knowledge control breaks down. -The Tractatus Framework emerged from recognizing this paradigm shift and asking: **If not knowledge control, what should organize human-AI collaborative systems?** +The Tractatus Framework emerged from recognizing this fundamental change and asking: **If not knowledge control, what should organize human-AI collaborative systems?** The answer came from organizational theory research spanning 40+ years: **Time horizons and information persistence**. @@ -103,7 +103,7 @@ The answer came from organizational theory research spanning 40+ years: **Time h **Novel Contribution**: Operationalizes persistence theory as computable metadata for AI instruction processing. -**Recommendation**: Validate persistence level classifications against organizational change research to ensure theoretical consistency. +**Recommendation**: Validate persistence level classifications against organizational change research to verify theoretical consistency. --- @@ -174,7 +174,7 @@ Organizations adopting Tractatus gain advantages documented in organizational re ## Conclusion: Theory-Grounded AI Safety -The Tractatus Framework demonstrates that AI safety doesn't require inventing entirely new paradigms. Instead, it applies decades of validated organizational theory to the specific challenge of human-AI collaboration. +The Tractatus Framework applies decades of validated organizational theory to human-AI collaboration challenges. By grounding AI safety in established research on time-based organization, agentic structures, and persistence theory, Tractatus provides: @@ -246,24 +246,48 @@ When knowledge becomes ubiquitous through AI, organizations must shift from know **SyDigital Project** (2022-2025). Internal documentation of 3-year implementation of agentic organizational framework with AI collaboration. Demonstrates real-world effectiveness of time-based, persistence-aware organizational structure in human-AI systems. -**STO-INN-0002**: "Agentic Organizational Structure: A New Paradigm for Digital Sovereignty" (2025). Internal whitepaper documenting original application of organizational theory to AI safety challenge. +**STO-INN-0002**: "Agentic Organizational Structure for Digital Sovereignty" (2025). Internal whitepaper documenting original application of organizational theory to AI safety challenge. --- ## Document Metadata -**Creation Date**: 2025-10-08 -**Source Material**: Appendix D (Research Review) from Anthropic Technical Proposal -**Related Documents**: -- Core Concepts of the Tractatus Framework -- Implementation Guide -- Case Studies: Real-World LLM Failure Modes -- Glossary of Terms +
-**Keywords**: organizational theory, time-based design, agentic organizations, persistence theory, AI safety, human-AI collaboration, knowledge orchestration +- **Version:** 1.0 +- **Created:** 2025-10-08 +- **Last Modified:** 2025-10-13 +- **Author:** Tractatus Framework Research Team +- **Word Count:** 1,713 words +- **Reading Time:** ~9 minutes +- **Document ID:** organizational-theory-foundations +- **Status:** Active +- **Source:** Appendix D (Research Review) from Anthropic Technical Proposal -**License**: Apache 2.0 +
--- -*This document provides the scholarly foundation for understanding why Tractatus works. The framework isn't speculative AI research—it's applied organizational theory, validated by decades of research and 3+ years of real-world implementation.* +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. diff --git a/docs/markdown/technical-architecture.md b/docs/markdown/technical-architecture.md index 6272e986..2ffed30c 100644 --- a/docs/markdown/technical-architecture.md +++ b/docs/markdown/technical-architecture.md @@ -614,7 +614,93 @@ services: **Together:** Claude Code provides the foundation, Tractatus provides the guardrails -**Example:** Claude Code enables AI to edit files. Tractatus ensures AI doesn't violate explicit instructions or cross values boundaries when doing so. +**Example:** Claude Code enables AI to edit files. Tractatus helps ensure AI doesn't violate explicit instructions or cross values boundaries when doing so. + +--- + +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-10-12 +- **Last Modified:** 2025-10-13 +- **Author:** Tractatus Framework Team +- **Word Count:** 2,120 words +- **Reading Time:** ~11 minutes +- **Document ID:** technical-architecture +- **Status:** Active + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Full License Text:** + +Apache License, Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. + +"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work. + +"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: + + (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. + + You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS --- diff --git a/docs/markdown/tractatus-ai-safety-framework-core-values-and-principles.md b/docs/markdown/tractatus-ai-safety-framework-core-values-and-principles.md new file mode 100644 index 00000000..60bc9e12 --- /dev/null +++ b/docs/markdown/tractatus-ai-safety-framework-core-values-and-principles.md @@ -0,0 +1,375 @@ +# Tractatus AI Safety Framework - Core Values and Principles + +**Document Type:** Strategic Foundation +**Created:** 2025-10-06 +**Author:** John Stroh +**Version:** 1.0 +**Status:** Active + +--- + +## Purpose + +This document establishes the foundational values and principles that guide the Tractatus AI Safety Framework and all aspects of this website platform. These enduring elements represent our deepest commitments to safe AI development and provide the basis for strategic alignment across all features, content, and operations. + +--- + +## Core Values + +### Sovereignty & Self-determination +- **Human Agency Preservation**: AI systems must augment, never replace, human decision-making authority +- **User Control**: Individuals maintain complete control over their data and engagement with AI features +- **No Manipulation**: Zero dark patterns, no hidden AI influence, complete transparency in AI operations +- **Explicit Consent**: All AI features require clear user understanding and opt-in + +### Transparency & Honesty +- **Visible AI Reasoning**: All AI-generated suggestions include the reasoning process +- **Public Moderation Queue**: Human oversight decisions are documented and visible +- **Clear Boundaries**: Explicitly communicate what AI can and cannot do +- **Honest Limitations**: Acknowledge framework limitations and edge cases +- **No Proprietary Lock-in**: Open source, open standards, exportable data + +### Harmlessness & Protection +- **Privacy-First Design**: No tracking, no surveillance, minimal data collection +- **Security by Default**: Regular audits, penetration testing, zero-trust architecture +- **Fail-Safe Mechanisms**: AI errors default to human review, not automatic action +- **Boundary Enforcement**: Architectural design prevents AI from making values decisions +- **User Safety**: Protection from AI-generated misinformation or harmful content + +### Human Judgment Primacy +- **Values Decisions**: Always require human approval, never delegated to AI +- **Strategic Oversight**: Human authority over mission, values, and governance +- **Escalation Protocols**: Clear pathways for AI to request human guidance +- **Override Capability**: Humans can always override AI suggestions +- **Accountability**: Human responsibility for all AI-assisted actions + +### Community & Accessibility +- **Universal Access**: Core framework documentation freely available to all +- **Three Audience Paths**: Tailored content for Researchers, Implementers, Advocates +- **Economic Accessibility**: Free tier with substantive capabilities +- **Knowledge Sharing**: Open collaboration, peer review, community contributions +- **WCAG Compliance**: Accessible to all abilities and assistive technologies + +### Biodiversity & Ecosystem Thinking +- **Multiple Valid Approaches**: No single solution, respect for alternative frameworks +- **Interoperability**: Integration with diverse AI safety approaches +- **Sustainability**: Long-term viability over short-term growth +- **Resilience**: Distributed systems, multiple mirrors, no single points of failure +- **Environmental Responsibility**: Green hosting, efficient code, minimal resource consumption + +--- + +## Guiding Principles + +### Architectural Safety Guarantees +- **Structural over Training**: Safety through architecture, not just fine-tuning +- **Explicit Boundaries**: Codified limits on AI action authority +- **Verifiable Compliance**: Automated checks against strategic values +- **Cross-Reference Validation**: AI actions validated against explicit instructions +- **Context Pressure Monitoring**: Detection of error-prone conditions + +### Dogfooding Implementation +- **Self-Application**: This website uses Tractatus to govern its own AI operations +- **Living Demonstration**: Platform proves framework effectiveness through use +- **Continuous Validation**: Real-world testing of governance mechanisms +- **Transparent Meta-Process**: Public documentation of how AI governs AI + +### Progressive Implementation +- **Phased Rollout**: 4-phase deployment over 18 months +- **Incremental Features**: Add capabilities as governance matures +- **No Shortcuts**: Quality over speed, world-class execution +- **Learn and Adapt**: Iterate based on real-world feedback + +### Education-Centered Approach +- **Demystify AI Safety**: Make complex concepts accessible +- **Build Literacy**: Empower users to understand AI governance +- **Interactive Demonstrations**: Learn by doing (classification, 27027 incident, boundary enforcement) +- **Case Study Learning**: Real-world failures and successes +- **Open Research**: Share findings, encourage replication + +### Jurisdictional Awareness & Data Sovereignty +- **Respect Indigenous Leadership**: Honor indigenous data sovereignty principles (CARE Principles) +- **Te Tiriti Foundation**: Acknowledge Te Tiriti o Waitangi as strategic baseline +- **Location-Aware Hosting**: Consider data residency and jurisdiction +- **Global Application**: Framework designed for worldwide implementation +- **Local Adaptation**: Support for cultural and legal contexts + +### AI Governance Framework +- **Quadrant-Based Classification**: Strategic/Operational/Tactical/System/Stochastic organization +- **Time-Persistence Metadata**: Instructions classified by longevity and importance +- **Human-AI Collaboration**: Clear delineation of authority and responsibility +- **Instruction Persistence**: Critical directives maintained across context windows +- **Metacognitive Verification**: AI self-assessment before proposing actions + +### Research & Validation Priority +- **Peer Review**: Academic rigor, scholarly publication +- **Reproducible Results**: Open code, documented methodologies +- **Falsifiability**: Framework designed to be tested and potentially disproven +- **Continuous Research**: Ongoing validation and refinement +- **Industry Collaboration**: Partnerships with AI organizations + +### Sustainable Operations +- **Koha Model**: Transparent, community-supported funding (Phase 3+) +- **No Exploitation**: Fair pricing, clear value exchange +- **Resource Efficiency**: Optimized code, cached content, minimal overhead +- **Long-Term Thinking**: Decades, not quarters +- **Community Ownership**: Contributors have stake in success + +--- + +## Te Tiriti o Waitangi Commitment + +**Strategic Baseline (Not Dominant Cultural Overlay):** + +The Tractatus framework acknowledges **Te Tiriti o Waitangi** and indigenous leadership in digital sovereignty as a strategic foundation for this work. We: + +- **Respect Indigenous Data Sovereignty**: Follow documented principles (CARE Principles, Te Mana Raraunga research) +- **Acknowledge Historical Leadership**: Indigenous peoples have led sovereignty struggles for centuries +- **Apply Published Standards**: Use peer-reviewed indigenous data governance frameworks +- **Defer Deep Engagement**: Will wait to approach Māori organizations until we have a stable and well developed platform in production. Our objective will be to request help in editing a Māori version that has their support and approval. + +**Implementation:** +- Footer acknowledgment (subtle, respectful) +- `/about/values` page (detailed explanation) +- Resource directory (links to Māori data sovereignty work) +- No tokenism, no performative gestures + +--- + +## Values Alignment in Practice + +### Content Curation (Blog, Resources) +- **AI Suggests**: Claude analyzes trends, proposes topics +- **Human Approves**: All values-sensitive content requires human review +- **Transparency**: AI reasoning visible in moderation queue +- **Attribution**: Clear "AI-curated, human-approved" labels + +### Media Inquiries +- **AI Triages**: Analyzes urgency, topic sensitivity +- **Human Responds**: All responses written or approved by humans +- **Escalation**: Values-sensitive topics immediately escalated to strategic review + +### Case Study Submissions +- **AI Reviews**: Assesses relevance, completeness +- **Human Validates**: Final publication decision always human +- **Quality Control**: Framework alignment checked against TRA-VAL-0001 + +### Interactive Demonstrations +- **Educational Purpose**: Teach framework concepts through interaction +- **No Live Data**: Demonstrations use example scenarios only +- **Transparency**: Show exactly how classification and validation work + +--- + +## Decision Framework + +When values conflict (e.g., transparency vs. privacy, speed vs. safety): + +1. **Explicit Recognition**: Acknowledge the tension publicly +2. **Context Analysis**: Consider specific situation and stakeholders +3. **Hierarchy Application**: + - Human Safety > System Performance + - Privacy > Convenience + - Transparency > Proprietary Advantage + - Long-term Sustainability > Short-term Growth +4. **Document Resolution**: Record decision rationale for future reference +5. **Community Input**: Seek feedback on significant value trade-offs + +--- + +## Review and Evolution + +### Annual Review Process +- **Scheduled:** 2026-10-06 (one year from creation) +- **Scope:** Comprehensive evaluation of values relevance and implementation +- **Authority:** Human PM (John Stroh) with community input +- **Outcome:** Updated version or reaffirmation of current values + +### Triggering Extraordinary Review +Immediate review required if: +- Framework fails to prevent significant AI harm +- Values found to be in conflict with actual operations +- Major regulatory or ethical landscape changes +- Community identifies fundamental misalignment + +### Evolution Constraints +- Core values (Sovereignty, Transparency, Harmlessness, Human Judgment) are **immutable** +- Guiding principles may evolve based on evidence and experience +- Changes require explicit human approval and public documentation + +--- + +## Metrics for Values Adherence + +### Sovereignty & Self-determination +- Zero instances of hidden AI influence +- 100% opt-in for AI features +- User data export capability maintained + +### Transparency & Honesty +- All AI reasoning documented in moderation queue +- Public disclosure of framework limitations +- Clear attribution of AI vs. human content + +### Harmlessness & Protection +- Zero security breaches +- Privacy audit pass rate: 100% +- Fail-safe activation rate (AI defers to human) + +### Human Judgment Primacy +- 100% of values decisions reviewed by humans +- Average escalation response time < 24 hours +- Zero unauthorized AI autonomous actions + +### Community & Accessibility +- WCAG AA compliance: 100% of pages +- Free tier usage: >80% of all users +- Community contributions accepted and integrated + +--- + +## Implementation Requirements + +All features, content, and operations must: + +1. **Pass Values Alignment Check**: Documented review against this framework +2. **Include Tractatus Governance**: Boundary enforcement, classification, validation +3. **Maintain Human Oversight**: Clear escalation paths to human authority +4. **Support Transparency**: Reasoning and decision processes visible +5. **Respect User Sovereignty**: No manipulation, complete control, clear consent + +**Failure to align with these values is grounds for feature rejection or removal.** + +--- + +## Appendix A: Values in Action Examples + +### Example 1: Blog Post Suggestion +**AI Action:** Suggests topic "Is AI Safety Overblown?" +**Classification:** STOCHASTIC (exploration) → escalate to STRATEGIC (values-sensitive) +**Human Review:** Topic involves framework credibility, requires strategic approval +**Decision:** Approved with requirement for balanced, evidence-based treatment +**Outcome:** Blog post published with AI reasoning visible, cites peer-reviewed research + +### Example 2: Media Inquiry Response +**AI Action:** Triages inquiry from major tech publication as "high urgency" +**Classification:** OPERATIONAL (standard process) +**Human Review:** Response drafted by human, reviews AI summary for accuracy +**Decision:** Human-written response sent, AI triage saved time +**Outcome:** Effective media engagement, human authority maintained + +### Example 3: Feature Request +**AI Action:** Suggests adding "auto-approve" for low-risk blog posts +**Classification:** STRATEGIC (changes governance boundary) +**Human Review:** Would reduce human oversight, conflicts with core values +**Decision:** Rejected - all content requires human approval per TRA-VAL-0001 +**Outcome:** Framework integrity preserved, alternative efficiency improvements explored + +--- + +## Appendix B: Glossary + +**AI Governance:** Frameworks and mechanisms that control AI system behavior +**Boundary Enforcement:** Preventing AI from actions outside defined authority +**Dogfooding:** Using the framework to govern itself (meta-implementation) +**Human Judgment Primacy:** Core principle that humans retain decision authority +**Quadrant Classification:** Strategic/Operational/Tactical/System/Stochastic categorization +**Time-Persistence Metadata:** Instruction classification by longevity and importance +**Values-Sensitive:** Content or decisions that intersect with strategic values + +--- + +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-10-06 +- **Last Modified:** 2025-10-13 +- **Author:** John Stroh +- **Word Count:** 1,717 words +- **Reading Time:** ~9 minutes +- **Document ID:** tractatus-ai-safety-framework-core-values-and-principles +- **Status:** Active + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Full License Text:** + +Apache License, Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. + +"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work. + +"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: + + (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. + + You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +--- + +**Document Authority:** This document has final authority over all platform operations. In case of conflict between this document and any other guidance, TRA-VAL-0001 takes precedence. + +**Next Review:** 2026-10-06 +**Version History:** v1.0 (2025-10-06) - Initial creation + +--- + +*This document is maintained by John Stroh (john.stroh.nz@pm.me) and subject to annual review. Changes require explicit human approval and public documentation.* diff --git a/docs/plans/integrated-implementation-roadmap-2025.md b/docs/plans/integrated-implementation-roadmap-2025.md index 52130124..22e7d634 100644 --- a/docs/plans/integrated-implementation-roadmap-2025.md +++ b/docs/plans/integrated-implementation-roadmap-2025.md @@ -43,6 +43,13 @@ This integrated roadmap combines: - Glossary updated with 8 value pluralism terms - FAQ updated with 5 new value pluralism Q&As (22 total questions) - Maintenance guide updated (six mandatory services) +- ✅ **Content Accuracy Audit and Fixes** (October 12, 2025) + - 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) + - generate-card-sections.js script created for systematic card presentation implementation + - Docs/markdown files verified correct (historical context appropriate) - 🔄 GitHub Repository Setup - Partially Complete (October 12, 2025) **Overall Progress (as of October 12, 2025):** diff --git a/docs/pluralistic-values-deliberation-plan-v2.md b/docs/pluralistic-values-deliberation-plan-v2.md index 44363f8b..0c1840ca 100644 --- a/docs/pluralistic-values-deliberation-plan-v2.md +++ b/docs/pluralistic-values-deliberation-plan-v2.md @@ -1234,4 +1234,48 @@ Given the additions above, the implementation phases are revised: --- +## Document Metadata + +
+ +- **Version:** 0.2 +- **Created:** 2025-10-12 +- **Last Modified:** 2025-10-13 +- **Author:** John Stroh, [Serious Thinker - Name TBD] +- **Word Count:** 10,147 words +- **Reading Time:** ~51 minutes +- **Document ID:** pluralistic-values-deliberation-plan-v2 +- **Status:** Planning / Awaiting Stakeholder Feedback +- **Document Type:** Enhancement Plan + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. + +--- + **END OF PLAN DOCUMENT** diff --git a/docs/research/concurrent-session-architecture-limitations.md b/docs/research/concurrent-session-architecture-limitations.md index 5f97bcb3..170d4f68 100644 --- a/docs/research/concurrent-session-architecture-limitations.md +++ b/docs/research/concurrent-session-architecture-limitations.md @@ -845,3 +845,47 @@ T4: File contains inst_020 only (inst_019 lost!) **Contributions**: See CONTRIBUTING.md (to be created in GitHub repository) **Anonymization**: All identifying information (server IPs, personal names, organizational details) removed. Technical details preserved for research value. + +--- + +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-10-09 +- **Last Modified:** 2025-10-13 +- **Author:** Tractatus Framework Research Team +- **Word Count:** 6,674 words +- **Reading Time:** ~33 minutes +- **Document ID:** concurrent-session-architecture-limitations +- **Status:** Discovered Design Constraint +- **Document Type:** Research Analysis + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. diff --git a/docs/research/executive-summary-tractatus-inflection-point.md b/docs/research/executive-summary-tractatus-inflection-point.md index c55bf4cf..dbf7658e 100644 --- a/docs/research/executive-summary-tractatus-inflection-point.md +++ b/docs/research/executive-summary-tractatus-inflection-point.md @@ -171,6 +171,49 @@ This research documents operational results from a production deployment of the **Authors:** Tractatus Research Team **Review Status:** Published October 2025 - Available for peer review and collaboration -**License:** Available for academic citation and research collaboration For inquiries: agenticgovernance.digital + +--- + +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-10-11 +- **Last Modified:** 2025-10-13 +- **Author:** Tractatus Research Team +- **Word Count:** 1,483 words +- **Reading Time:** ~7 minutes +- **Document ID:** executive-summary-tractatus-inflection-point +- **Status:** Active +- **Document Type:** Executive Summary / Blog Post + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. diff --git a/docs/research/pluralistic-values-research-foundations.md b/docs/research/pluralistic-values-research-foundations.md index 87d74e90..e9b5bc3c 100644 --- a/docs/research/pluralistic-values-research-foundations.md +++ b/docs/research/pluralistic-values-research-foundations.md @@ -1204,3 +1204,47 @@ What if stakeholder argues in bad faith? - `/CLAUDE_Tractatus_Maintenance_Guide.md` (Framework governance) --- + +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-10-12 +- **Last Modified:** 2025-10-13 +- **Author:** Tractatus Framework Research Team +- **Word Count:** 10,463 words +- **Reading Time:** ~52 minutes +- **Document ID:** pluralistic-values-research-foundations +- **Status:** Work in Progress +- **Document Type:** Research Synthesis + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. + +--- diff --git a/docs/research/rule-proliferation-and-transactional-overhead.md b/docs/research/rule-proliferation-and-transactional-overhead.md index a3c7a937..a417f60f 100644 --- a/docs/research/rule-proliferation-and-transactional-overhead.md +++ b/docs/research/rule-proliferation-and-transactional-overhead.md @@ -677,3 +677,47 @@ The question isn't "Can we prevent rule proliferation?" but "How do we manage it - ML-based optimization (Phase 8-9) **Contributions**: See CONTRIBUTING.md (to be created in GitHub repository) + +--- + +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-10-09 +- **Last Modified:** 2025-10-13 +- **Author:** Tractatus Framework Research Team +- **Word Count:** 5,183 words +- **Reading Time:** ~26 minutes +- **Document ID:** rule-proliferation-and-transactional-overhead +- **Status:** Open Research Question +- **Document Type:** Research Analysis + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. diff --git a/docs/value-pluralism-faq.md b/docs/value-pluralism-faq.md index 812bfb10..7a9a7f8a 100644 --- a/docs/value-pluralism-faq.md +++ b/docs/value-pluralism-faq.md @@ -468,3 +468,47 @@ PluralisticDeliberationOrchestrator is now the **6th mandatory service** in the - Maintenance guide (inst_028-031 documentation) --- + +## Document Metadata + +
+ +- **Version:** 1.0 +- **Created:** 2025-10-12 +- **Last Modified:** 2025-10-13 +- **Author:** Tractatus Framework Team +- **Word Count:** 3,847 words +- **Reading Time:** ~19 minutes +- **Document ID:** value-pluralism-faq +- **Status:** Draft +- **Document Type:** FAQ / Explainer + +
+ +--- + +## License + +Copyright 2025 John Stroh + +Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +**Additional Terms:** + +1. **Attribution Requirement**: Any use, modification, or distribution of this work must include clear attribution to the original author and the Tractatus Framework project. + +2. **Moral Rights**: The author retains moral rights to the work, including the right to be identified as the author and to object to derogatory treatment of the work. + +3. **Research and Educational Use**: This work is intended for research, educational, and practical implementation purposes. Commercial use is permitted under the terms of the Apache 2.0 license. + +4. **No Warranty**: This work is provided "as is" without warranty of any kind, express or implied. The author assumes no liability for any damages arising from its use. + +5. **Community Contributions**: Contributions to this work are welcome and should be submitted under the same Apache 2.0 license terms. + +For questions about licensing, please contact the author through the project repository. + +--- diff --git a/public/downloads/concurrent-session-architecture-limitations.pdf b/public/downloads/concurrent-session-architecture-limitations.pdf index 2e6a0aac..a6fe1022 100644 Binary files a/public/downloads/concurrent-session-architecture-limitations.pdf and b/public/downloads/concurrent-session-architecture-limitations.pdf differ diff --git a/public/downloads/executive-summary-tractatus-inflection-point.pdf b/public/downloads/executive-summary-tractatus-inflection-point.pdf index 458534fd..4ac39a19 100644 Binary files a/public/downloads/executive-summary-tractatus-inflection-point.pdf and b/public/downloads/executive-summary-tractatus-inflection-point.pdf differ diff --git a/public/downloads/implementation-guide.pdf b/public/downloads/implementation-guide.pdf index 3991a406..df16a8fb 100644 Binary files a/public/downloads/implementation-guide.pdf and b/public/downloads/implementation-guide.pdf differ diff --git a/public/downloads/introduction-to-the-tractatus-framework.pdf b/public/downloads/introduction-to-the-tractatus-framework.pdf index 43f63181..cb3be871 100644 Binary files a/public/downloads/introduction-to-the-tractatus-framework.pdf and b/public/downloads/introduction-to-the-tractatus-framework.pdf differ diff --git a/public/downloads/rule-proliferation-and-transactional-overhead.pdf b/public/downloads/rule-proliferation-and-transactional-overhead.pdf index e210771c..eea46b5e 100644 Binary files a/public/downloads/rule-proliferation-and-transactional-overhead.pdf and b/public/downloads/rule-proliferation-and-transactional-overhead.pdf differ diff --git a/public/downloads/technical-architecture-diagram.pdf b/public/downloads/technical-architecture-diagram.pdf index 04341fe8..40463558 100644 Binary files a/public/downloads/technical-architecture-diagram.pdf and b/public/downloads/technical-architecture-diagram.pdf differ diff --git a/tests/unit/ContextPressureMonitor.test.js b/tests/unit/ContextPressureMonitor.test.js index 8a4c077b..6b14c4f3 100644 --- a/tests/unit/ContextPressureMonitor.test.js +++ b/tests/unit/ContextPressureMonitor.test.js @@ -28,10 +28,10 @@ describe('ContextPressureMonitor', () => { test('should detect ELEVATED pressure at moderate token usage', () => { const context = { - token_usage: 0.6, // 0.6 * 0.35 = 0.21 - conversation_length: 50, // 0.5 * 0.25 = 0.125 + token_usage: 0.4, // 0.4 * 0.30 = 0.12 + conversation_length: 20, // (20/40) * 0.40 = 0.2 token_limit: 200000 - // Combined: 0.21 + 0.125 = 0.335 → ELEVATED + // Combined: 0.12 + 0.2 = 0.32 → ELEVATED }; const result = monitor.analyzePressure(context); @@ -41,17 +41,17 @@ describe('ContextPressureMonitor', () => { test('should detect CRITICAL pressure at high token usage', () => { const context = { - token_usage: 0.85, // 0.85 * 0.35 = 0.2975 - conversation_length: 90, // 0.9 * 0.25 = 0.225 - errors_recent: 3, // 1.0 * 0.15 = 0.15 - task_depth: 5, // 1.0 * 0.15 = 0.15 + token_usage: 0.85, // 0.85 * 0.30 = 0.255 + conversation_length: 90, // (90/40 capped at 1.0) * 0.40 = 0.40 + errors_recent: 3, // (3/3 = 1.0) * 0.10 = 0.10 + task_depth: 5, // (5*0.8/5 = 0.8) * 0.15 = 0.12 token_limit: 200000 - // Combined: 0.2975 + 0.225 + 0.15 + 0.15 = 0.8225 → CRITICAL + // Combined: 0.255 + 0.40 + 0.10 + 0.12 = 0.875 → DANGEROUS }; const result = monitor.analyzePressure(context); - expect(['HIGH', 'CRITICAL']).toContain(result.level); + expect(['CRITICAL', 'DANGEROUS']).toContain(result.level); }); test('should detect DANGEROUS pressure near token limit', () => { @@ -268,9 +268,9 @@ describe('ContextPressureMonitor', () => { test('should recommend increased verification at ELEVATED pressure', () => { const context = { - token_usage: 0.55, // 0.55 * 0.35 = 0.1925 - conversation_length: 50 // 0.5 * 0.25 = 0.125 - // Combined: 0.1925 + 0.125 = 0.3175 → ELEVATED + token_usage: 0.4, // 0.4 * 0.30 = 0.12 + conversation_length: 20 // (20/40 = 0.5) * 0.40 = 0.20 + // Combined: 0.12 + 0.20 = 0.32 → ELEVATED }; const result = monitor.analyzePressure(context); @@ -280,10 +280,10 @@ describe('ContextPressureMonitor', () => { test('should recommend context refresh at HIGH pressure', () => { const context = { - token_usage: 0.75, // 0.75 * 0.35 = 0.2625 - conversation_length: 85, // 0.85 * 0.25 = 0.2125 - task_depth: 4 // 0.8 * 0.15 = 0.12 - // Combined: 0.2625 + 0.2125 + 0.12 = 0.595 → HIGH + token_usage: 0.6, // 0.6 * 0.30 = 0.18 + conversation_length: 38, // (38/40 = 0.95) * 0.40 = 0.38 + task_depth: 1 // (1*0.3/5 = 0.06) * 0.15 = 0.009 + // Combined: 0.18 + 0.38 + 0.009 = 0.569 → HIGH }; const result = monitor.analyzePressure(context); @@ -293,11 +293,11 @@ describe('ContextPressureMonitor', () => { test('should recommend mandatory verification at CRITICAL pressure', () => { const context = { - token_usage: 0.85, // 0.85 * 0.35 = 0.2975 - conversation_length: 95, // 0.95 * 0.25 = 0.2375 - errors_recent: 4, // 1.33 * 0.15 = 0.2 (capped at 0.15) - task_depth: 6 // 1.2 * 0.15 = 0.18 - // Combined: 0.2975 + 0.2375 + 0.15 + 0.18 = 0.865 → DANGEROUS (includes MANDATORY_VERIFICATION) + token_usage: 0.7, // 0.7 * 0.30 = 0.21 + conversation_length: 52, // (52/40 = 1.3 capped at 1.0) * 0.40 = 0.40 + errors_recent: 2, // (2/3 = 0.67) * 0.10 = 0.067 + task_depth: 3 // (3*0.8/5 = 0.48) * 0.15 = 0.072 + // Combined: 0.21 + 0.40 + 0.067 + 0.072 = 0.749 → CRITICAL }; const result = monitor.analyzePressure(context); @@ -501,9 +501,9 @@ describe('ContextPressureMonitor', () => { }); test('should track pressure level distribution', () => { - monitor.analyzePressure({ token_usage: 0.2 }); // 0.07 → NORMAL - monitor.analyzePressure({ token_usage: 0.6, conversation_length: 50 }); // 0.21 + 0.125 = 0.335 → ELEVATED - monitor.analyzePressure({ token_usage: 0.75, conversation_length: 70 }); // 0.2625 + 0.175 = 0.4375 → ELEVATED (close to HIGH) + monitor.analyzePressure({ token_usage: 0.2 }); // 0.2 * 0.30 = 0.06 → NORMAL + monitor.analyzePressure({ token_usage: 0.4, conversation_length: 20 }); // 0.12 + 0.20 = 0.32 → ELEVATED + monitor.analyzePressure({ token_usage: 0.5, conversation_length: 28 }); // 0.15 + 0.28 = 0.43 → ELEVATED const stats = monitor.getStats();