Skip to content

Commit 4f1099e

Browse files
Jonathan D.A. Jewellclaude
andcommitted
chore: sync template files and configuration
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 6ce3a41 commit 4f1099e

3 files changed

Lines changed: 1077 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 157 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,157 @@
1+
# Changelog
2+
3+
All notable changes to the Anamnesis project will be documented in this file.
4+
5+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7+
8+
## [Unreleased]
9+
10+
### Added
11+
- Comprehensive RSR (Rhodium Standard Repository) compliance
12+
- LICENSE.txt (dual MIT + Palimpsest v0.8)
13+
- SECURITY.md with vulnerability reporting
14+
- CONTRIBUTING.md with TPCF Perimeter 2 classification
15+
- CODE_OF_CONDUCT.md based on CCCP principles
16+
- MAINTAINERS.md with team structure
17+
- .well-known/ directory (security.txt RFC 9116, ai.txt, humans.txt)
18+
- RSR compliance audit document (docs/RSR_COMPLIANCE_AUDIT.md)
19+
20+
## [0.1.0-alpha] - 2025-11-22
21+
22+
### Added
23+
24+
#### Project Foundation
25+
- Initial repository structure and organization
26+
- CLAUDE.md with comprehensive project guidance
27+
- README.md with project overview and getting started guide
28+
- Complete multi-language component structure (parser, orchestrator, reasoning, learning, visualization)
29+
30+
#### Research & Architecture
31+
- 6 comprehensive research reports (AsciiDoc format):
32+
- Julia RDF Ecosystem Analysis (Serd.jl, SPARQL via HTTP.jl)
33+
- Julia Reservoir Computing Survey (ReservoirComputing.jl, KBANN)
34+
- PuppyGraph Evaluation (recommendation: stick with Virtuoso)
35+
- ReScript Visualization Ecosystem (Reagraph, rescript-recharts)
36+
- OCaml Parsing & Elixir Bridge (Angstrom, ports over NIFs)
37+
- λProlog/ELPI Meta-Reasoning (HOAS, integration patterns)
38+
- System architecture document (docs/architecture/system-architecture.adoc, 50+ sections)
39+
- RDF schema/ontology (docs/specifications/rdf-schema.ttl, Turtle format)
40+
41+
#### Parser Component (OCaml)
42+
- ATD schema definitions (conversation_types.atd)
43+
- Generic conversation module with validation and utilities
44+
- Claude JSON format parser with artifact extraction
45+
- Dune build system configuration
46+
- Port interface scaffolding (Erlang External Term Format via Alberto)
47+
48+
#### Orchestrator Component (Elixir)
49+
- OTP application with supervision tree
50+
- ParserPort GenServer for OCaml communication
51+
- PortSupervisor for process management
52+
- IngestionPipeline with full parse→reason→RDF→store flow
53+
- Mix project configuration
54+
- Development and test configurations
55+
56+
#### Reasoning Component (λProlog/ELPI)
57+
- Artifact lifecycle state machine (lifecycle/artifact_states.elpi)
58+
- Fuzzy multi-category membership logic (categorization/fuzzy_membership.elpi)
59+
- Contamination detection for cross-project artifacts (categorization/contamination.elpi)
60+
- Example queries and test data
61+
62+
#### Learning Component (Julia)
63+
- Project structure with dependencies (Project.toml)
64+
- RDF schema constants module
65+
- RDF serialization (conversation → triples → N-Triples)
66+
- Port interface for Elixir communication
67+
- Module scaffolding for reservoir computing and KBANN
68+
69+
#### Visualization Component (ReScript)
70+
- Type-safe domain model with phantom types (Domain.res)
71+
- Color mixing for fuzzy project categorization (ColorMixing.res)
72+
- ReScript compiler and npm configuration
73+
- Component scaffolding
74+
75+
#### Documentation
76+
- Component-specific READMEs (parser, orchestrator, reasoning, learning, visualization)
77+
- Autonomous development session summary (docs/AUTONOMOUS_SESSION_SUMMARY.adoc)
78+
- Architecture and design documentation
79+
- Contribution guidelines
80+
81+
### Technical Decisions
82+
- **NO PYTHON constraint** enforced throughout (Julia for scientific computing)
83+
- Type safety via OCaml, Elixir typespecs, ReScript, Julia type annotations
84+
- Functional paradigm across all components
85+
- Fault tolerance through OTP supervision trees and Erlang ports
86+
- Multi-LLM support designed from the start (stubbed complexity initially)
87+
- Academic rigor in documentation and research
88+
89+
### Known Issues
90+
- No test infrastructure yet (planned for Phase 2)
91+
- Starter code only (not production-ready)
92+
- Some dependencies not yet installed (see component READMEs)
93+
- No CI/CD pipeline yet (planned)
94+
95+
### Migration Notes
96+
- Project in planning phase → initial implementation
97+
- TPCF Perimeter 2 (Trusted Collaborators) - limited write access
98+
- Will migrate to Perimeter 3 (Community Sandbox) post-Milestone 1
99+
100+
## Versioning Policy
101+
102+
Anamnesis follows [Semantic Versioning 2.0.0](https://semver.org/):
103+
104+
- **MAJOR.MINOR.PATCH** (e.g., 1.2.3)
105+
- **MAJOR**: Breaking changes (incompatible API changes)
106+
- **MINOR**: New features (backward-compatible)
107+
- **PATCH**: Bug fixes (backward-compatible)
108+
109+
**Pre-release versions**:
110+
- **0.y.z**: Initial development (API may change without notice)
111+
- **alpha**: Unstable, experimental (current phase)
112+
- **beta**: Feature-complete, needs testing
113+
- **rc**: Release candidate, stabilization
114+
115+
**Current status**: `0.1.0-alpha` (planning phase, not production-ready)
116+
117+
## Release Schedule
118+
119+
**Planned Milestones**:
120+
121+
- **Milestone 1** (Q2 2026): Parse single Claude conversation JSON → Virtuoso RDF triples
122+
- **Milestone 2** (Q3 2026): Multi-format parsing (ChatGPT, Mistral, Git)
123+
- **Milestone 3** (Q4 2026): λProlog reasoning and contamination detection
124+
- **1.0.0** (2027): Production-ready, stable API
125+
126+
Actual dates subject to change based on development progress and community contributions.
127+
128+
## How to Read This Changelog
129+
130+
- **[Unreleased]**: Changes in development, not yet released
131+
- **[Version]**: Released version with date
132+
- **Added**: New features, files, components
133+
- **Changed**: Changes to existing functionality
134+
- **Deprecated**: Features marked for removal (will warn in next MAJOR)
135+
- **Removed**: Features removed (breaking change)
136+
- **Fixed**: Bug fixes
137+
- **Security**: Security fixes (always highlighted)
138+
139+
## Contributing to Changelog
140+
141+
When submitting a PR, update the `[Unreleased]` section with your changes in the appropriate category. Maintainers will move entries to versioned sections upon release.
142+
143+
For more information, see [CONTRIBUTING.md](CONTRIBUTING.md).
144+
145+
---
146+
147+
**Legend**:
148+
- 🎉 Major milestone
149+
- ⚡ Breaking change
150+
- 🐛 Bug fix
151+
- 📝 Documentation
152+
- 🔒 Security fix
153+
- ⚠️ Deprecated feature
154+
155+
**Links**:
156+
- [Unreleased]: https://github.com/Hyperpolymath/anamnesis/compare/v0.1.0-alpha...HEAD
157+
- [0.1.0-alpha]: https://github.com/Hyperpolymath/anamnesis/releases/tag/v0.1.0-alpha

0 commit comments

Comments
 (0)