agentic-lang 0.2.0

package/COMMUNITY.md

@@ -0,0 +1,220 @@
+# Agentic Community Guide
+
+Welcome to the Agentic programming language community! We're building the world's first AI-native programming language together.
+
+## 🌟 **Code of Conduct**
+
+Based on the Rust Community Code of Conduct: **Treat everyone with respect and kindness.**
+
+We are committed to providing a friendly, safe, and welcoming environment for all, regardless of:
+- Experience level
+- Gender identity and expression
+- Sexual orientation
+- Disability
+- Personal appearance
+- Body size
+- Race
+- Ethnicity
+- Age
+- Religion
+- Nationality
+- Or other similar characteristic
+
+### Our Standards
+
+**✅ We welcome:**
+- Thoughtful questions and discussions
+- Constructive feedback and ideas
+- Celebrating successes and supporting struggles
+- Helping newcomers learn
+
+**❌ We don't tolerate:**
+- Harassment or discriminatory language
+- Trolling or insulting/derogatory comments
+- Personal or political attacks
+- Publishing others' private information
+- Other conduct inappropriate for a professional setting
+
+## 💬 **Communication Channels**
+
+### Discord (Primary Chat)
+**https://discord.gg/agentic**
+
+Channels:
+- `#welcome` - Introduce yourself!
+- `#general` - General discussion
+- `#help` - Get help with Agentic
+- `#show-and-tell` - Share your projects
+- `#ai-agents` - Discuss AI-specific topics
+- `#language-design` - RFC discussions
+- `#contributors` - Core contributor coordination
+
+### GitHub Discussions (Long-Form)
+**https://github.com/agentic-lang/agentic/discussions**
+
+Categories:
+- 💡 Ideas - Feature proposals and brainstorming
+- 🙏 Q&A - Ask and answer questions
+- 📣 Announcements - Official updates
+- 🌱 Show and Tell - Share your work
+- 🔧 Technical - Deep technical discussions
+
+### Twitter/X
+**@agenticLang**
+
+Follow for:
+- Daily tips and tricks
+- Community highlights
+- Release announcements
+
+## 🚀 **Getting Started**
+
+### 1. Install Agentic
+```bash
+npm install -g agentic-lang
+```
+
+### 2. Try the Tutorial
+https://agentic-lang.org/docs/tutorials/hello-world
+
+### 3. Join Discord
+Introduce yourself in `#welcome`!
+
+### 4. Build Something
+Start with our [example projects](https://github.com/agentic-lang/examples)
+
+## 🤝 **How to Contribute**
+
+We welcome contributions of all kinds! See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
+
+### Quick Ways to Help
+
+**For Everyone:**
+- ⭐ Star the repo on GitHub
+- 📖 Improve documentation
+- 🐛 Report bugs
+- 💬 Answer questions in Discord/Discussions
+- 📝 Write blog posts or tutorials
+- 🎤 Give talks about Agentic
+
+**For Developers:**
+- 🔧 Fix bugs
+- ✨ Implement features
+- 🧪 Add tests
+- 📦 Create packages
+- 🎨 Improve error messages
+
+**For AI Researchers:**
+- 📊 Validate confidence tracking approach
+- 🔬 Research formal verification integration
+- 📈 Analyze AI-generated code quality
+- 📄 Publish papers using Agentic
+
+## 🎓 **Learning Resources**
+
+### Documentation
+- [The Agentic Book](https://agentic-lang.org/docs/book) - Complete guide
+- [Language Specification](https://agentic-lang.org/docs/specification)
+- [Error Reference](https://agentic-lang.org/docs/errors)
+- [Cookbook](https://agentic-lang.org/docs/cookbook) - Common patterns
+
+### Video Tutorials
+- [Agentic in 100 Seconds](https://youtube.com/watch?v=...) - Quick overview
+- [Building Your First Agent](https://youtube.com/watch?v=...) - Tutorial series
+
+### Blog Posts
+- [Why AI Needs a New Programming Language](https://blog.agentic-lang.org/why)
+- [Confidence-Driven Development](https://blog.agentic-lang.org/confidence)
+- [From @stub to @complete](https://blog.agentic-lang.org/incremental)
+
+## 🏆 **Community Programs**
+
+### Ambassador Program
+Become an Agentic Ambassador! Benefits:
+- Early access to new features
+- Direct line to core team
+- Swag and recognition
+- Speaking opportunities
+
+**Apply:** https://agentic-lang.org/ambassadors
+
+### Office Hours
+**Weekly Zoom sessions** with the core team
+- Open Q&A
+- Live coding and debugging
+- Feature discussions
+
+**Schedule:** https://agentic-lang.org/office-hours
+
+### Mentorship
+Looking for guidance? We match experienced developers with newcomers.
+
+**Sign up:** https://agentic-lang.org/mentorship
+
+## 📅 **Events**
+
+### Upcoming
+- **AgenticConf 2026** - Annual conference (Sept 15-17, Virtual + San Francisco)
+- **Monthly Meetups** - 20+ cities worldwide
+
+### Past Events
+- [Watch recordings](https://youtube.com/agenticLang)
+
+## 🎁 **Swag**
+
+Show your Agentic pride!
+- T-shirts
+- Stickers
+- Laptop stickers
+- Hoodies
+
+**Shop:** https://swag.agentic-lang.org
+
+**Contributors get free swag!** 🎉
+
+## 💰 **Sponsorship**
+
+Help sustain Agentic development!
+
+**GitHub Sponsors:** https://github.com/sponsors/agentic-lang
+
+Tiers:
+- **$5/month** - Supporter (name in README)
+- **$25/month** - Professional (priority support)
+- **$100/month** - Team (team license + support)
+- **$500/month** - Corporate (custom integrations)
+
+## 📢 **Spreading the Word**
+
+Help us grow!
+- Tweet about Agentic (@agenticLang)
+- Write a blog post
+- Give a talk at your local meetup
+- Create a video tutorial
+- Answer questions on Stack Overflow (tag: agentic-lang)
+
+## 📊 **Community Stats**
+
+- **5 contributors** (and growing!)
+- **100+ GitHub stars**
+- **50+ Discord members**
+- **10+ production deployments**
+
+*Want to see your name here? [Start contributing!](CONTRIBUTING.md)*
+
+## 🙏 **Thank You**
+
+Special thanks to all our contributors, sponsors, and community members. You make Agentic possible!
+
+### Core Team
+- [Add names as team forms]
+
+### Top Contributors
+- [Will be automatically updated]
+
+### Sponsors
+- [Current sponsors]
+
+---
+
+**Questions?** Join our [Discord](https://discord.gg/agentic) or open a [Discussion](https://github.com/agentic-lang/agentic/discussions)!

package/CONTRIBUTING.md

@@ -0,0 +1,194 @@
+# Contributing to Agentic
+
+Thank you for your interest in contributing to the Agentic programming language!
+
+## Getting Started
+
+1. **Fork the repository**
+2. **Clone your fork**
+   ```bash
+   git clone https://github.com/your-username/agentic-lang.git
+   cd agentic-lang
+   ```
+3. **Install dependencies**
+   ```bash
+   npm install
+   ```
+4. **Build the project**
+   ```bash
+   npm run build
+   ```
+5. **Run tests**
+   ```bash
+   npm test
+   ```
+
+## Development Workflow
+
+### Making Changes
+
+1. Create a new branch
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. Make your changes
+
+3. Test your changes
+   ```bash
+   npm run build
+   npm test
+   ./bin/agentic.js compile examples/simple.agentic
+   ```
+
+4. Commit with descriptive message
+   ```bash
+   git add .
+   git commit -m "feat: Add support for X"
+   ```
+
+5. Push to your fork
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+6. Open a Pull Request
+
+### Commit Message Convention
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+- `feat:` - New feature
+- `fix:` - Bug fix
+- `docs:` - Documentation only
+- `test:` - Adding or updating tests
+- `refactor:` - Code refactoring
+- `perf:` - Performance improvement
+- `chore:` - Maintenance tasks
+
+## Project Structure
+
+```
+agentic-lang/
+├── src/
+│   ├── parser/           # Lexer and parser
+│   ├── generator/        # Code generation
+│   ├── runtime/          # Runtime library
+│   ├── property-tests/   # Test generation
+│   └── cli.ts            # Command-line interface
+├── examples/             # Example .agentic files
+├── vscode-extension/     # VSCode extension
+├── docs/                 # Documentation
+└── tests/                # Test suite
+```
+
+## Areas for Contribution
+
+### High Priority
+- **Parser improvements** - Better error recovery
+- **Type inference** - Smarter type deduction
+- **Property test generation** - More sophisticated property extraction
+- **Error messages** - More helpful diagnostics
+
+### Medium Priority
+- **Standard library** - Common functions and types
+- **Optimization** - Faster compilation
+- **Documentation** - Tutorials and guides
+- **Examples** - Real-world use cases
+
+### Future
+- **Language Server Protocol** - IDE integration
+- **Native compiler** - Rust → LLVM backend
+- **Formal verification** - Integration with proof assistants
+
+## Testing
+
+### Running Tests
+
+```bash
+npm test                  # Run all tests
+npm test -- parser        # Run parser tests only
+npm test -- --watch       # Watch mode
+```
+
+### Adding Tests
+
+Place tests in `tests/` directory:
+
+```typescript
+import { describe, test, expect } from 'vitest';
+import { Parser } from '../src/parser/parser';
+
+describe('Parser', () => {
+  test('parses function declaration', () => {
+    const source = 'func add(a: number, b: number) -> number { return a + b }';
+    const parser = new Parser();
+    const ast = parser.parse(source);
+    expect(ast).toBeDefined();
+  });
+});
+```
+
+## Code Style
+
+- **TypeScript** with strict mode
+- **2 spaces** for indentation
+- **No semicolons** (except in generated code)
+- **Descriptive variable names**
+- **Comments** for complex logic
+
+Format code before committing:
+```bash
+npm run format  # (if available)
+```
+
+## Documentation
+
+When adding features:
+1. Update `docs/SPECIFICATION.md` with formal grammar
+2. Add examples to `examples/` directory
+3. Update `README.md` if user-facing
+4. Add JSDoc comments to public APIs
+
+## VSCode Extension Development
+
+```bash
+cd vscode-extension
+npm install
+code .
+# Press F5 to open Extension Development Host
+```
+
+Test your changes in the Extension Development Host before submitting.
+
+## Reporting Issues
+
+### Bug Reports
+
+Include:
+- Agentic version (`agentic version`)
+- Input `.agentic` code
+- Expected behavior
+- Actual behavior
+- Error messages
+
+### Feature Requests
+
+Include:
+- Use case description
+- Example syntax (if applicable)
+- Why this would be valuable
+
+## Questions?
+
+- Open a Discussion on GitHub
+- Check existing issues and PRs
+- Read `docs/SPECIFICATION.md`
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.
+
+---
+
+Thank you for contributing to Agentic! 🚀