Contributing

# Clone the repository
git clone https://github.com/NAEOS-foundation/naeos.git
cd naeos

# Build the project
go build ./cmd/naeos/

# Run tests
go test -race -count=1 -timeout 300s ./...

# Run linter
golangci-lint run ./...

naeos/
├── cmd/naeos/           # CLI commands (35+ files)
│   ├── main.go          # Root command
│   ├── run_cmd.go       # Run pipeline
│   ├── compile_cmd.go   # Compile to AI tools
│   ├── context_cmd.go   # Generate context bundles
│   └── ...              # 30+ command files
├── internal/
│   ├── specification/   # Parser, normalizer, resolver
│   ├── neir/            # NEIR model and builder
│   ├── compiler/        # AI instruction compiler
│   ├── context/         # Context bundle generator
│   ├── generation/      # Code generation
│   ├── governance/      # Policy and review
│   ├── artifacts/       # Artifact store
│   ├── profiles/        # Industry profiles
│   ├── migration/       # Schema migration
│   ├── security/        # Security rules
│   └── shared/          # Shared utilities
├── pkg/
│   ├── pipeline/        # Main pipeline
│   ├── kernel/          # System kernel
│   ├── config/          # Configuration
│   └── plugin/          # Plugin system
├── docs/                # NES specifications (56 files)
├── governance/          # Governance documents
├── constitution/        # Engineering constitution
├── specification/       # Specification documents
└── site/                # Hugo website

func TestValidator(t *testing.T) {
    tests := []struct {
        name    string
        input   string
        want    bool
        wantErr bool
    }{
        {"valid spec", validSpec, true, false},
        {"missing project", missingProject, false, true},
        {"empty modules", emptyModules, true, false},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            t.Parallel()
            got, err := Validate(tt.input)
            if (err != nil) != tt.wantErr {
                t.Errorf("Validate() error = %v, wantErr %v", err, tt.wantErr)
            }
            if got != tt.want {
                t.Errorf("Validate() = %v, want %v", got, tt.want)
            }
        })
    }
}

feat: add new parser for HCL configuration
fix: resolve circular dependency detection in validator
docs: update CLI reference with new flags
test: add integration tests for pipeline
refactor: simplify NEIR builder API
chore: update dependencies