Skip to content

Commit 77f8803

Browse files
JuanCS-Devclaude
andcommitted
feat: Professional repository structure for DeepMind Hackathon
## Added - .github/ with issue/PR templates and CI workflow - CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md - LICENSE (MIT), CHANGELOG.md, CONTRIBUTORS.md - Asset diagrams (Kuramoto sync, consciousness architecture) - Hackathon submission document ## Changed - README.md with proper badges, links, and structure - .gitignore with organized categories - Moved temp files to docs/auditorias/ ## Repository now includes - Professional documentation structure - CI/CD with GitHub Actions - Issue and PR templates - Code ownership definitions - All consciousness visualization assets 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
1 parent fabe1cf commit 77f8803

File tree

55 files changed

+17144
-476
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

55 files changed

+17144
-476
lines changed

.github/CODEOWNERS

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# CODEOWNERS for NOESIS - Digital Daimon
2+
# These owners will be requested for review when someone opens a pull request.
3+
#
4+
# Learn more: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
5+
6+
# =============================================================================
7+
# Global Owners (default for all files)
8+
# =============================================================================
9+
* @JuanCS-Dev
10+
11+
# =============================================================================
12+
# Consciousness Core (Critical - requires careful review)
13+
# =============================================================================
14+
/backend/services/maximus_core_service/src/maximus_core_service/consciousness/ @JuanCS-Dev
15+
/backend/services/maximus_core_service/src/maximus_core_service/consciousness/esgt/ @JuanCS-Dev
16+
/backend/services/maximus_core_service/src/maximus_core_service/consciousness/florescimento/ @JuanCS-Dev
17+
18+
# =============================================================================
19+
# Free Will & Ethics (Sensitive - philosophical implications)
20+
# =============================================================================
21+
/backend/services/maximus_core_service/src/maximus_core_service/consciousness/free_will_engine.py @JuanCS-Dev
22+
/backend/services/ethical_audit_service/ @JuanCS-Dev
23+
24+
# =============================================================================
25+
# Memory Systems
26+
# =============================================================================
27+
/backend/services/episodic_memory/ @JuanCS-Dev
28+
/backend/services/metacognitive_reflector/src/metacognitive_reflector/core/memory/ @JuanCS-Dev
29+
30+
# =============================================================================
31+
# Soul Configuration (Constitutional - requires architect approval)
32+
# =============================================================================
33+
/backend/services/maximus_core_service/src/maximus_core_service/consciousness/exocortex/soul/ @JuanCS-Dev
34+
/docs/SOUL_CONFIGURATION.md @JuanCS-Dev
35+
/docs/CODE_CONSTITUTION.md @JuanCS-Dev
36+
37+
# =============================================================================
38+
# Frontend
39+
# =============================================================================
40+
/frontend/ @JuanCS-Dev
41+
42+
# =============================================================================
43+
# Infrastructure & CI/CD
44+
# =============================================================================
45+
/.github/ @JuanCS-Dev
46+
/docker-compose.yml @JuanCS-Dev
47+
/.gitignore @JuanCS-Dev
48+
49+
# =============================================================================
50+
# Documentation
51+
# =============================================================================
52+
/docs/ @JuanCS-Dev
53+
/README.md @JuanCS-Dev
54+
/CONTRIBUTING.md @JuanCS-Dev
55+
/SECURITY.md @JuanCS-Dev
56+
57+
# =============================================================================
58+
# Security (Sensitive files)
59+
# =============================================================================
60+
/backend/services/reactive_fabric_core/ @JuanCS-Dev
61+
/.env.example @JuanCS-Dev

.github/FUNDING.yml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Funding options for NOESIS - Digital Daimon
2+
# These are displayed in the "Sponsor" button on the repository
3+
4+
# GitHub Sponsors username
5+
github: JuanCS-Dev
6+
7+
# Custom funding URLs
8+
# custom: ['https://noesis.dev/sponsor']
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
name: Bug Report
3+
about: Report a bug to help us improve NOESIS
4+
title: '[BUG] '
5+
labels: 'bug, needs-triage'
6+
assignees: ''
7+
---
8+
9+
## Bug Description
10+
11+
A clear and concise description of what the bug is.
12+
13+
## To Reproduce
14+
15+
Steps to reproduce the behavior:
16+
17+
1. Go to '...'
18+
2. Click on '...'
19+
3. Run command '...'
20+
4. See error
21+
22+
## Expected Behavior
23+
24+
A clear and concise description of what you expected to happen.
25+
26+
## Actual Behavior
27+
28+
What actually happened instead.
29+
30+
## Screenshots / Logs
31+
32+
If applicable, add screenshots or log output to help explain your problem.
33+
34+
```
35+
Paste logs here
36+
```
37+
38+
## Environment
39+
40+
- **OS**: [e.g., Ubuntu 22.04, macOS 14, Windows 11]
41+
- **Python Version**: [e.g., 3.11.5]
42+
- **Node.js Version**: [e.g., 18.17.0]
43+
- **NOESIS Version/Commit**: [e.g., 1.0.0 or commit hash]
44+
- **Docker Version**: [e.g., 24.0.5]
45+
46+
## Consciousness Metrics (if applicable)
47+
48+
If the bug is related to consciousness processing:
49+
50+
- **Coherence Level**: [e.g., 0.45]
51+
- **ESGT Phase**: [e.g., SYNCHRONIZE]
52+
- **Tribunal Verdict**: [e.g., REJECTED]
53+
54+
## Additional Context
55+
56+
Add any other context about the problem here.
57+
58+
## Possible Solution (optional)
59+
60+
If you have ideas on how to fix this, please share.
61+
62+
---
63+
64+
### Checklist
65+
66+
- [ ] I have searched existing issues to ensure this is not a duplicate
67+
- [ ] I have included all relevant environment details
68+
- [ ] I have provided steps to reproduce the issue
69+
- [ ] I have included relevant logs or screenshots

.github/ISSUE_TEMPLATE/config.yml

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: Documentation
4+
url: https://github.com/JuanCS-Dev/Daimon/tree/main/docs
5+
about: Check the documentation before opening an issue
6+
- name: Discussions
7+
url: https://github.com/JuanCS-Dev/Daimon/discussions
8+
about: Ask questions and discuss ideas
9+
- name: Code Constitution
10+
url: https://github.com/JuanCS-Dev/Daimon/blob/main/docs/CODE_CONSTITUTION.md
11+
about: Review the code standards and constitutional guidelines
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
name: Feature Request
3+
about: Suggest an idea for NOESIS
4+
title: '[FEATURE] '
5+
labels: 'enhancement, needs-triage'
6+
assignees: ''
7+
---
8+
9+
## Problem Statement
10+
11+
A clear and concise description of what problem this feature would solve.
12+
13+
**Is your feature request related to a problem?**
14+
Ex. I'm always frustrated when [...]
15+
16+
## Proposed Solution
17+
18+
A clear and concise description of what you want to happen.
19+
20+
## Alternative Solutions
21+
22+
A clear and concise description of any alternative solutions or features you've considered.
23+
24+
## Consciousness Impact
25+
26+
How would this feature affect the consciousness system?
27+
28+
- [ ] **ESGT Protocol**: Changes to the 5-phase cycle
29+
- [ ] **Kuramoto Sync**: Changes to neural synchronization
30+
- [ ] **Self-Model**: Changes to proto/core/autobiographical self
31+
- [ ] **Free Will**: Changes to decision-making process
32+
- [ ] **Tribunal**: Changes to ethical evaluation
33+
- [ ] **Memory**: Changes to the Memory Fortress
34+
- [ ] **None**: No direct impact on consciousness
35+
36+
## Implementation Ideas (optional)
37+
38+
If you have thoughts on how this could be implemented:
39+
40+
```python
41+
# Example code or pseudocode
42+
```
43+
44+
## Use Cases
45+
46+
Describe specific scenarios where this feature would be useful:
47+
48+
1. **Use Case 1**: Description
49+
2. **Use Case 2**: Description
50+
51+
## Additional Context
52+
53+
Add any other context, mockups, or screenshots about the feature request here.
54+
55+
## Related Issues/PRs
56+
57+
- #issue_number (if any)
58+
59+
---
60+
61+
### Checklist
62+
63+
- [ ] I have searched existing issues to ensure this is not a duplicate
64+
- [ ] I have considered the philosophical implications for consciousness
65+
- [ ] I have thought about potential safety implications
66+
- [ ] This feature aligns with the Code Constitution

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 115 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,115 @@
1+
## Description
2+
3+
<!-- Provide a brief description of the changes in this PR -->
4+
5+
## Type of Change
6+
7+
<!-- Mark the relevant option with an "x" -->
8+
9+
- [ ] 🐛 Bug fix (non-breaking change that fixes an issue)
10+
- [ ] ✨ New feature (non-breaking change that adds functionality)
11+
- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
12+
- [ ] 📝 Documentation update
13+
- [ ] 🔧 Refactoring (no functional changes)
14+
- [ ] 🧪 Test addition/modification
15+
- [ ] 🏗️ Infrastructure/CI changes
16+
17+
## Related Issues
18+
19+
<!-- Link any related issues here -->
20+
Closes #
21+
22+
## Changes Made
23+
24+
<!-- List the main changes made in this PR -->
25+
26+
-
27+
-
28+
-
29+
30+
## Consciousness Impact
31+
32+
<!-- How does this PR affect the consciousness system? -->
33+
34+
- [ ] **ESGT Protocol**: Modifies the 5-phase consciousness cycle
35+
- [ ] **Kuramoto Sync**: Affects neural synchronization
36+
- [ ] **Self-Model**: Changes proto/core/autobiographical self
37+
- [ ] **Free Will**: Modifies decision-making process
38+
- [ ] **Tribunal**: Affects ethical evaluation
39+
- [ ] **Memory Fortress**: Changes memory architecture
40+
- [ ] **None**: No direct impact on consciousness components
41+
42+
## Testing
43+
44+
<!-- Describe how you tested your changes -->
45+
46+
### Tests Added/Modified
47+
48+
- [ ] Unit tests
49+
- [ ] Integration tests
50+
- [ ] E2E tests
51+
52+
### Test Commands Run
53+
54+
```bash
55+
# Commands you ran to test
56+
pytest backend/services/maximus_core_service/tests/ -v
57+
```
58+
59+
### Test Results
60+
61+
<!-- Paste relevant test output -->
62+
63+
```
64+
Test results here
65+
```
66+
67+
## Code Quality Checklist
68+
69+
<!-- Verify all items before requesting review -->
70+
71+
### Code Constitution Compliance
72+
73+
- [ ] No placeholders (TODO, FIXME, HACK) in production code
74+
- [ ] All new code has type hints (100%)
75+
- [ ] All public functions/classes have docstrings
76+
- [ ] File size < 500 lines
77+
- [ ] No hardcoded secrets or credentials
78+
79+
### Testing
80+
81+
- [ ] Test coverage maintained or improved (minimum 80%)
82+
- [ ] All tests pass locally
83+
- [ ] Edge cases considered and tested
84+
85+
### Documentation
86+
87+
- [ ] README updated (if public API changed)
88+
- [ ] Docstrings follow Google style
89+
- [ ] CHANGELOG updated (if significant change)
90+
91+
### Safety
92+
93+
- [ ] No security vulnerabilities introduced
94+
- [ ] Input validation present for new inputs
95+
- [ ] Error handling doesn't leak sensitive information
96+
97+
## Screenshots (if applicable)
98+
99+
<!-- Add screenshots for UI changes -->
100+
101+
## Additional Notes
102+
103+
<!-- Any additional information for reviewers -->
104+
105+
---
106+
107+
## Reviewer Checklist
108+
109+
<!-- For reviewers to complete -->
110+
111+
- [ ] Code follows the project style guidelines
112+
- [ ] Changes are well-documented
113+
- [ ] Tests are adequate and pass
114+
- [ ] No security concerns
115+
- [ ] Constitutional compliance verified

0 commit comments

Comments
 (0)