coffee DIR executes DIR/index.coffee

[marchaefner]

Resolves #2496 and brings the CLI behavior for directories in line with redux, node and coco/LS. Runs either index.coffee, index.litcoffee or index.coffee.md (just like require DIR does already).

coffee --watch DIR watches and (re-)runs only the index file (and no longer all contained coffee files and subdirectories). This behavior is copied from coco/LS and provides a nice symmetry between invocations with and without --watch, but I'm not entirely sure about potential use cases...

[vendethiel]

Thanks ! But isn't the error message inaccurate ?

[marchaefner]

Yeah, it's far from perfect. It's meant as a compromise between accuracy and readability comprehensibility. Suggestions for a better message are very welcome.

[michaelficarra]

LGTM. Merging. @jashkenas: This is a breaking change we'll need to note in the changelog for the next release.

[aseemk]

This is an awesome improvement — thanks! Just wanted to note though that full Node parity means also respecting the directory's package.json main field, if there is one. My understanding is that you can access this entire algorithm via require('module')._resolveFilename(path), but that may be outdated.