Remove unused "main" entry from package.json.

Clients who were require()ing hackmyresume should now require()
hackmycore instead.

.gitignore

@@ -1,4 +1,40 @@
 node_modules/
 tests/sandbox/
+doc/
 docs/
+local/
 npm-debug.log
+
+# Emacs detritus
+# -*- mode: gitignore; -*-
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# Org-mode
+.org-id-locations
+*_archive
+
+# flymake-mode
+*_flymake.*
+
+# eshell files
+/eshell/history
+/eshell/lastdir
+
+# elpa packages
+/elpa/
+
+# reftex files
+*.rel
+
+# AUCTeX auto folder
+/auto/
+
+# cask packages
+.cask/

CHANGELOG.md

@@ -0,0 +1,306 @@
+CHANGELOG
+=========
+## v1.6.0
+
+### Major Improvements
+
+- Better consistency and coverage for all FRESH resumes and themes ([#45][i45]).
+
+- Initial support for overridable fonts in FRESH themes. Like a particular
+theme, but want to change the typography? The specific fonts used by a theme
+can now be overridden by the user. (FRESH themes only).
+
+- New resume sections! Support for `projects` and `affiliation` resume sections
+for technical and creative projects and memberships / clubs / associations,
+respectively ([#92][i92]).
+
+- New command! `PEEK` at any arbitrary field or entry on your `.json` resume.
+
+### Added
+
+- Improved handling of start and end dates on `employment`, `projects`,
+`education`, and other sections with start/end dates.
+
+- Support for an `.ignore` property on any FRESH or JSON Resume section or field.
+Ignored properties will be treated by HackMyResume as if they weren't present.
+
+- Emit extended status and error info with the `--debug` or `-d` switch.
+
+- The `-o` or `--options` switch can now handle either the path to a **JSON
+settings file** or **raw JSON/JavaScript**. Since the JSON double quote syntax
+is a bit cumbersome from the command line, HackMyResume accepts regular
+JavaScript object literal syntax:
+
+        hackmyresume build resume.json -o "{ theme: 'compact', silent: 'true' }"
+
+- Ability to disable sorting of resume sections (employments, projects, etc.)
+with the `--no-sort` option. HMR will respect the order of items as they appear
+in your resume `.json` file.
+
+- Improvements to the starter resume emitted by `hackmyresume new`.
+
+- Theme Authoring: Annotated the HTML and MS Word (XML) formats of the Modern
+theme for FRESH theme authors.
+
+- Theme Authoring: Support for templatized CSS files in FRESH themes. CSS files
+are now expanded via Handlebars or Underscore prior to copying to the
+destination.
+
+- Added CHANGELOG.md (this file).
+
+### Changed
+
+- Rewrote the HackMyResume man/help page.
+
+- Minor incremental updates to the [FRESCA][fresca] schema.
+
+- PDF generation now uses asynchronous `spawn()` which has better compatibility
+with old or boutique versions of Node.js.
+
+- Refactored colors in HackMyResume output. Errors will now display as red,
+warnings as yellow, successful operations as green, and informational messages
+as cyan.
+
+- Theme messages and usage tips will no longer display during resume generation
+by default. Use the `--tips` option to view them.
+
+- The `--no-tips` option (default: false) has been replaced with the `--tips`
+option, also defaulting to false.
+
+- Removed the `hello-world` theme from the [prebuilt themes][themes] that ship
+with HackMyResume. It can be installed separately from NPM:
+
+  ```bash
+  npm install fresh-theme-hello-world
+  hackmyresume resume.json -t node_modules/fresh-theme-hello-world
+  ```
+
+- sd
+
+### Fixed
+
+- PDF generation issues on older versions of Node.
+
+- Stack traces not being emitted correctly.
+
+- Missing `speaking` section will now appear on generated resumes ([#101][i101]).
+
+- Incomplete `education` details will now appear on generated resumes ([#65][i65]).
+
+- Missing employment end date being interpreted as "employment ends today"
+([#84][i84]).
+
+- Merging multiple source resumes during `BUILD` sometimes fails.
+
+- Document `--pdf` flag in README ([#111][i111]).
+
+### Internal
+
+- Logging messages have been moved out of core HackMyResume code ahead of
+localization support.
+
+- All HackMyResume console output is described in `msg.yml`.
+
+- Relaxed pure JavaScript requirement. CoffeeScript will now start appearing
+in HackMyResume and FluentCV sources!
+
+- Additional tests.
+
+## v1.5.2
+
+### Fixed
+
+- Tweak stack trace under `--debug`.
+
+## v1.5.1
+
+### Added
+
+- Preliminary support for `-d` or `--debug` flag. Forces HackMyResume to emit a stack trace under error conditions.
+
+## v1.5.0
+
+### Added
+
+- HackMyResume now supports **CLI-based generation of PDF formats across multiple engines (Phantom, wkhtmltopdf, etc)**. Instead of talking to these engines over a programmatic API, as in prior versions, HackMyResume 1.5+ speaks to them over the same command-line interface (CLI) you'd use if you were using these tools directly.
+
+- HackMyResume will now (attempt to) **generate a PDF output for JSON Resume themes** (in addition to HTML).
+
+- Minor README and FAQ additions.
+
+### Changed
+
+- **Cleaner, quicker installs**. Installing HackMyResume with `npm install hackmyresume -g` will no longer trigger a lengthy, potentially error-prone install for Phantom.js and/or wkhtmltopdf for PDF support. Instead, users can install these engines externally and HMR will use them when present.
+
+- Minor error handling improvements.
+
+### Fixed
+
+- Fixed an error with generating specific formats with the `BUILD` command (#97).
+
+- Fixed numerous latent/undocumented bugs and glitches.
+
+## v1.4.2
+
+### Added
+
+- Introduced [FAQ](https://github.com/hacksalot/HackMyResume/blob/master/FAQ.md).
+- Additional README notes.
+
+## v1.4.1
+
+### Added
+
+- `hackmyresume new` now generates a [valid starter resume with sample data](https://github.com/fluentdesk/fresh-resume-starter).
+
+### Fixed
+
+- Fixed warning message when `hackmyresume new` is run without a filename.
+
+## v1.4.0
+
+### Added
+
+- **"Projects" support**: FRESH resumes and themes can now store and display
+open source, commercial, private, personal, and creative projects.
+- **New command: ANALYZE**. Inspect your resume for gaps, keyword counts, and other metrics. (Experimental.)
+- **Side-by-side PDF generation** with Phantom and wkhtmltopdf. Use the `--pdf` or `-p` flag to pick between `phantom` and `wkhtmltopdf` generation.
+- **Disable PDF generation** with the `--pdf none` switch.
+- **Inherit formats between themes**. Themes can now inherit formats (Word, HTML, .txt, etc.) from other themes. (FRESH themes only.)
+- **Rename resume sections** to different languages or wordings.
+- **Specify complex options via external file**. Use with the `-o` or `--opts` option.
+- **Disable colors** with the `--no-color` flag.
+- **Theme messages and usage tips** instructions will now appear in the default HackMyResume output for the `build` command. Run `hackmyresume build resume.json -t awesome` for an example. Turn off with the `--no-tips` flag.
+- **Treat validation errors as warnings** with the `--assert` switch (VALIDATE command only).
+
+### Fixed
+
+- Fixed a minor glitch in the FRESCA schema.
+- Fixed encoding issues in the `Highlights` section of certain resumes.
+- Fix behavior of `-s` and `--silent` flags.
+
+### Changed
+
+- PDF generation now defaults to Phantom for all platforms, with `wkhtmltopdf`
+accessible with `--pdf wkhtmltopdf`.
+- Resumes are now validated, by default, prior to generation. This
+behavior can be disabled with the `--novalidate` or `--force` switch.
+- Syntax errors in source FRESH and JSON Resumes are now captured for all
+commands.
+- Minor updates to README.
+- Most themes now inherit Markdown and Plain Text formats from the **Basis**
+theme.
+
+### Internal
+
+- Switched from color to chalk.
+- Command invocations now handled through commander.js.
+- Improved FRESH theme infrastructure (more partials, more DRY).
+
+## v1.3.1
+
+### Added
+
+- Add additional Travis badges.
+
+### Fixed
+
+- Fix extraneous console log output when generating a FRESH theme to MS Word.
+- Fix Travis tests on `dev`.
+
+## v1.3.0
+
+### Added
+
+- **Local generation of JSON Resume themes**. To use a JSON Resume theme, first install it with `npm install jsonresume-theme-[blah]` (most JSON Resume themes are on NPM). Then pass it into HackMyResume via the `-t` parameter:
+
+    `hackmyresume BUILD resume.json TO out/somefile.all -t node_modules/jsonresume-theme-classy`
+- **Better Markdown support.** HackMyResume will start flowing basic Markdown styles to JSON Resume (HTML) themes. FRESH's existing Markdown support has also been improved.
+- **.PNG output formats** will start appearing in themes that declare an HTML output.
+- **Tweak CSS embedding / linking via the --css option** (`<style></style>` vs `<link>`). Only works for HTML (or HTML-driven) formats of FRESH themes. Use `--css=link` to link in CSS assets and `--css=embed` to embed the styles in the HTML document. For example `hackmyresume BUILD resume.json TO out/resume.all --css=link`.
+- **Improved Handlebars/Underscore helper support** for FRESH themes. Handlebars themes can access helpers via `{{helperName}}`. Underscore themes can access helpers via the `h` object.
+
+### Changed
+
+- **Distinguish between validation errors and syntax errors** when validating a FRESH or JRS resume with `hackmyresume validate <blah>`.
+- **Emit line and column info** for syntax errors during validation of FRESH and JRS resumes.
+- **FRESH themes now embed CSS into HTML formats by default** so that the HTML resume output doesn't have an external CSS file dependency by default. Users can specify normal linked stylesheets by setting `--css=link`.
+- **Renamed fluent-themes repo to fresh-themes** in keeping with the other parts of the project.
+
+### Fixed
+
+- Fix various encoding errors in MS Word outputs.
+- Fix assorted FRESH-to-JRS and JRS-to-FRESH conversion glitches.
+- Fix error when running HMR with no parameters.
+- Other minor fixes.
+
+## v1.3.0-beta
+
+- Numerous changes supporting v1.3.0.
+
+## v1.2.2
+
+### Fixed
+
+- Various in-passing fixes.
+
+## v1.2.1
+
+### Fixed
+
+- Fix `require('FRESCA')` error.
+- Fix `.history` and `.map` errors on loading incomplete or empty JRS resumes.
+
+### Added
+
+- Better test coverage of incomplete/empty resumes.
+
+## v1.2.0
+
+### Fixed
+
+- Fixed the `new` command: Generate a new FRESH-format resume with `hackmyresume new resume.json` or a new JSON Resume with `hackmyresume new resume.json -f jrs`.
+
+### Added
+
+- Introduced CLI tests.
+
+## v1.1.0
+
+### Fixed
+
+- MS Word formats: Fixed skill coloring/level bug.
+
+### Changed
+
+- Make the `TO` keyword optional. If no `TO` keyword is specified (for the `build` and `convert` commands), HMR will assume the last file passed in is the desired output file. So these are equivalent:
+
+    ```shell
+    hackmyresume BUILD resume.json TO out/resume.all
+    hackmyresume BUILD resume.json out/resume.all
+    ```
+
+    `TO` only needs to be included if you have multipled output files:
+
+    ```shell
+     hackmyresume BUILD resume.json TO out1.doc out2.html out3.tex
+    ```
+
+## v1.0.1
+
+### Fixed
+
+- Correctly generate MS Word hyperlinks from Markdown source data.
+
+## v1.0.0
+
+- Initial public 1.0 release.
+
+[i45]: https://github.com/hacksalot/HackMyResume/issues/45
+[i65]: https://github.com/hacksalot/HackMyResume/issues/65
+[i84]: https://github.com/hacksalot/HackMyResume/issues/84
+[i92]: https://github.com/hacksalot/HackMyResume/issues/92
+[i101]: https://github.com/hacksalot/HackMyResume/issues/101
+[i111]: https://github.com/hacksalot/HackMyResume/issues/111
+[fresca]: https://github.com/fluentdesk/FRESCA
+[themes]: https://github.com/fluentdesk/fresh-themes

FAQ.md

@@ -0,0 +1,228 @@
+Frequently Asked Questions (FAQ)
+================================
+
+## How do I get started with HackMyResume?
+
+1. Install with NPM: `[sudo] npm install hackmyresume -g`.
+
+2. Create a new resume with: `hackmyresume NEW <resume-name>.json`.
+
+3. Test with `hackmyresume BUILD <resume-name>.json`. Look in the `out/` folder.
+
+4. Play around with different themes with the `-t` or `--theme` parameter.
+You can use any [FRESH](https://github.com/fluentdesk/fresh-themes) or
+[JSON Resume](https://jsonresume.org/themes) theme. The latter have to be
+installed first.
+
+## What is FRESH?
+
+FRESH is the **F**luent **R**esume and **E**mployment **S**ystem for **H**umans.
+It's an open-source, user-first workflow, schema, and set of practices for
+technical candidates and recruiters.
+
+## What is FRESCA?
+
+The **F**RESH **R**esume and **E**mployment **SC**hem**A**&mdash;an open-source,
+JSON-driven schema for resumes, CVs, and other employment artifacts. FRESCA is
+the recommended schema/format for FRESH, with optional support for JSON Resume.
+
+## What is JSON Resume?
+
+An [open resume standard](http://jsonresume.org/themes/) sponsored by Hired.com.
+Like FRESCA, JSON Resume is JSON-driven and open-source. Unlike FRESCA, JSON
+Resume targets a worldwide audience where FRESCA is optimized for technical
+candidates.
+
+## Should I use the FRESH or JSON Resume format/schema for my resume?
+
+Both! The workflow we like to use:
+
+1. Create a resume in FRESH format for tooling and analysis.
+2. Convert it to JSON Resume format for additional themes/tools.
+3. Maintain both versions.
+
+Both formats are open-source and both formats are JSON-driven. FRESH was
+designed as a universal container format and superset of existing formats, where
+the JSON Resume format is intended for a generic audience.
+
+## How do I use a FRESH theme?
+
+Several FRESH themes come preinstalled with HackMyResume; others can be
+installed from NPM and GitHub.
+
+### To use a preinstalled FRESH theme:
+
+1. Pass the theme name into HackMyResume via the `--theme` or `-t` parameter:
+
+    ```bash
+    hackmyresume build resume.json --theme compact
+    ```
+
+### To use an external FRESH theme:
+
+1. Install the theme locally. The easiest way to do that is with NPM.
+
+    ```bash
+    npm install fresh-theme-underscore
+    ```
+
+2. Pass the theme folder into HackMyResume:
+
+    ```bash
+    hackmyresume BUILD resume.json --theme node_modules/fresh-theme-underscore
+    ```
+
+3. Check your output folder. It's best to view HTML formats over a local web
+server connection.
+
+## How do I use a JSON Resume theme?
+
+JSON Resume (JRS) themes can be installed from NPM and GitHub and passed into
+HackMyResume via the `--theme` or `-t` parameter.
+
+1. Install the theme locally. The easiest way to do that is with NPM.
+
+    ```bash
+    npm install jsonresume-theme-classy
+    ```
+
+2. Pass the theme folder path into HackMyResume:
+
+    ```bash
+    hackmyresume BUILD resume.json --theme node_modules/jsonresume-theme-classy
+    ```
+
+3. Check your output folder. It's best to view HTML formats over a local web
+server connection.
+
+## Should I keep my resume in version control?
+
+Absolutely! As text-based, JSON-driven documents, both FRESH and JSON Resume are
+ideal candidates for version control. Future versions of HackMyResume will have
+this functionality built in.
+
+## Can I change the default section titles ("Employment", "Skills", etc.)?
+
+If you're using a FRESH theme, yes. First, create a HackMyResume options file
+mapping resume sections to your preferred section title:
+
+```javascript
+// myoptions.json
+{
+  "sectionTitles": {
+    "employment": "empleo",
+    "skills": "habilidades",
+    "education": "educación"
+  }
+}
+```
+
+Then, pass the options file into the `-o` or `--opts` parameter:
+
+```bash
+hackmyresume BUILD resume.json -o myoptions.json
+```
+
+This ability is currently only supported for FRESH resume themes.
+
+## How does resume merging work?
+
+Resume merging is a way of storing your resume in separate files that
+HackMyResume will merge into a single "master" resume file prior to generating
+specific output formats like HTML or PDF. It's a way of producing flexible,
+configurable, targeted resumes with minimal duplication.
+
+For example, a software developer who moonlights as a game programmer might
+create three FRESH or JRS resumes at different levels of specificity:
+
+- **generic.json**: A generic technical resume, suitable for all audiences.
+- **game-developer.json**: Overrides and amendments for game developer
+positions.
+- **blizzard.json**: Overrides and amendments specific to a hypothetical
+position at Blizzard.
+
+If you run `hackmyresume BUILD generic.json TO out/resume.all`, HMR will
+generate all available output formats for the `generic.json` as usual. But if
+you instead run...
+
+```bash
+hackmyresume BUILD generic.json game-developer.json TO out/resume.all
+```
+
+...HackMyResume will notice that multiple source resumes were specified and
+merge `game-developer.json` onto `generic.json` before generating, yielding a
+resume that's more suitable for game-developer-related positions.
+
+You can take this a step further. Let's say you want to do a targeted resume
+submission to a game developer position at Blizzard, and `blizzard.json`
+contains the edits and revisions you'd like to show up in the targeted resume.
+In that case, merge again! Feed all three resumes to HackMyResume, in order
+from most generic to most specific, and HMR will merge them all prior to
+generating the final output format(s) for your resume.
+
+```bash
+# Merge blizzard.json onto game-developer.json onto generic.json, then build
+hackmyresume BUILD generic.json game-developer.json blizzard.json TO out/resume.all
+```
+
+There's no limit to the number of resumes you can merge this way.
+
+You can also divide your resume into files containing different sections:
+
+- **resume-a.json**: Contains `info`, `employment`, and `summary` sections.
+- **resume-b.json**: Contains all other sections except `references`.
+- **references.json**: Contains the private `references` section.
+
+Under that scenario, `hackmyresume BUILD resume-a.json resume-b.json` would
+
+
+## The HackMyResume terminal color scheme is giving me a headache. Can I disable it?
+
+Yes. Use the `--no-color` option to disable terminal colors:
+
+`hackmyresume <somecommand> <someoptions> --no-color`
+
+## What's the difference between a FRESH theme and a JSON Resume theme?
+
+FRESH themes are multiformat (HTML, Word, PDF, etc.) and required to support
+Markdown formatting, configurable section titles, and various other features.
+
+JSON Resume themes are typically HTML-driven, but capable of expansion to other
+formats through tools. JSON Resume themes don't support Markdown natively, but
+HMR does its best to apply your Markdown, when present, to any JSON Resume
+themes it encounters.
+
+## Do I have to have a FRESH resume to use a FRESH theme or a JSON Resume to use a JSON Resume theme?
+
+No. You can mix and match FRESH and JRS-format themes freely. HackMyResume will
+perform the necessary conversions on the fly.
+
+## Can I build my own custom FRESH theme?
+
+Yes. The easiest way is to copy an existing FRESH theme, like `modern` or
+`compact`, and make your changes there. You can test your theme with:
+
+```bash
+hackmyresume build resume.json --theme path/to/my/theme/folder
+```
+
+## Can I build my own custom JSON Resume theme?
+
+Yes. The easiest way is to copy an existing JSON Rsume theme and make your
+changes there. You can test your theme with:
+
+```bash
+hackmyresume build resume.json --theme path/to/my/theme/folder
+```
+
+## Can I build my own tools / services / apps / websites around FRESH / FRESCA?
+
+Yes! FRESH/FRESCA formats are 100% open source, permissively licensed under MIT,
+and 100% free from company-specific, tool-specific, or commercially oriented
+lock-in or cruft. These are clean formats designed for users and builders.
+
+## Can I build my own tools / services / apps / websites around JSON Resume?
+
+Yes! HackMyResume is not affiliated with JSON Resume, but like FRESH/FRESCA,
+JSON Resume is open-source, permissively licensed, and free of proprietary
+lock-in. See the JSON Resume website for details.

Gruntfile.js

@@ -17,6 +17,16 @@ module.exports = function (grunt) {
       all: { src: ['test/*.js'] }
     },
 
+    jsdoc : {
+      dist : {
+        src: ['src/**/*.js'],
+        options: {
+          private: true,
+          destination: 'doc'
+        }
+      }
+    },
+
     clean: ['test/sandbox'],
 
     yuidoc: {
@@ -47,13 +57,14 @@ module.exports = function (grunt) {
 
   grunt.loadNpmTasks('grunt-simple-mocha');
   grunt.loadNpmTasks('grunt-contrib-yuidoc');
+  grunt.loadNpmTasks('grunt-jsdoc');
   grunt.loadNpmTasks('grunt-contrib-jshint');
   grunt.loadNpmTasks('grunt-contrib-clean');
 
   grunt.registerTask('test', 'Test the HackMyResume library.',
-    function( config ) { grunt.task.run( ['clean','jshint','simplemocha:all'] ); });
+    function( config ) { grunt.task.run(['clean','jshint','simplemocha:all']); });
   grunt.registerTask('document', 'Generate HackMyResume library documentation.',
-    function( config ) { grunt.task.run( ['yuidoc'] ); });
-  grunt.registerTask('default', [ 'test', 'yuidoc' ]);
+    function( config ) { grunt.task.run( ['jsdoc'] ); });
+  grunt.registerTask('default', [ 'test', 'jsdoc' ]);
 
 };

LICENSE.md

@@ -1,7 +1,7 @@
 The MIT License
 ===============
 
-Copyright (c) 2015 James M. Devlin (https://github.com/hacksalot)
+Copyright (c) 2016 hacksalot (https://github.com/hacksalot)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -10,7 +10,7 @@ shell. Author in clean Markdown and JSON, export to Word, HTML, PDF, LaTeX,
 plain text, and other arbitrary formats. Fight the power, save trees. Compatible
 with [FRESH][fresca] and [JRS][6] resumes.*
 
-![](assets/resume-bouqet.png)
+![](assets/hackmyresume.cli.1.6.0.png)
 
 HackMyResume is a dev-friendly, local-only Swiss Army knife for resumes and CVs.
 Use it to:
@@ -18,25 +18,29 @@ Use it to:
 1. **Generate** HTML, Markdown, LaTeX, MS Word, PDF, plain text, JSON, XML,
 YAML, print, smoke signal, carrier pigeon, and other arbitrary-format resumes
 and CVs, from a single source of truth—without violating DRY.
-2. **Convert** resumes between [FRESH][fresca] and [JSON Resume][6] formats.
-3. **Validate** resumes against either format.
+2. **Analyze** your resume for keyword density, gaps/overlaps, and other
+metrics.
+3. **Convert** resumes between [FRESH][fresca] and [JSON Resume][6] formats.
+4. **Validate** resumes against either format.
 
 HackMyResume is built with Node.js and runs on recent versions of OS X, Linux,
-or Windows.
+or Windows. View the [FAQ](FAQ.md).
 
 ## Features
 
 - OS X, Linux, and Windows.
 - Choose from dozens of FRESH or JSON Resume themes.
 - Private, local-only resume authoring and analysis.
+- Analyze your resume for keywords, gaps, and other metrics.
 - Store your resume data as a durable, versionable JSON or YAML document.
 - Generate polished resumes in multiple formats without violating [DRY][dry].
 - Output to HTML, Markdown, LaTeX, PDF, MS Word, JSON, YAML, plain text, or XML.
 - Validate resumes against the FRESH or JSON Resume schema.
 - Support for multiple input and output resumes.
+- Convert between FRESH and JSON Resume resumes.
 - Use from your command line or [desktop][7].
 - Free and open-source through the MIT license.
-- Updated daily / weekly. Contributions welcome.
+- Updated daily / weekly. Contributions are [welcome](CONTRIBUTING.md).
 
 ## Install
 
@@ -46,13 +50,22 @@ Install the latest stable version of HackMyResume with NPM:
 [sudo] npm install hackmyresume -g
 ```
 
-To install the latest bleeding-edge version (updated daily):
+Alternately, install the latest bleeding-edge version (updated daily):
 
 ```bash
 [sudo] npm install hacksalot/hackmyresume#dev -g
 ```
 
-**For PDF generation**, you'll need to install a copy of [wkhtmltopdf][3] and/or PhantomJS for your platform.
+## Installing PDF Support (optional)
+
+HackMyResume tries not to impose a specific PDF engine requirement on
+the user, but will instead work with whatever PDF engines you have installed.
+
+Currently, HackMyResume's PDF generation requires either [Phantom.js][2] or
+[wkhtmltopdf][3] to be installed on your system and the `phantomjs` and/or
+`wkhtmltopdf` binaries to be accessible on your PATH. This is an optional
+requirement for users who care about PDF formats. If you don't care about PDF
+formats, skip this step.
 
 ## Installing Themes
 
@@ -94,7 +107,7 @@ Use it when you need to submit, upload, print, or email resumes in specific
 formats.
 
     ```bash
-    # hackmyresume BUILD <INPUTS> TO <OUTPUTS> [-t THEME]
+    # hackmyresume BUILD <INPUTS...> TO <OUTPUTS...> [-t THEME]
     hackmyresume BUILD resume.json TO out/resume.all
     hackmyresume BUILD r1.json r2.json TO out/rez.html out/rez.md foo/rez.all
     ```
@@ -102,7 +115,7 @@ formats.
 - **new** creates a new resume in FRESH or JSON Resume format.
 
     ```bash
-    # hackmyresume NEW <OUTPUTS> [-f <FORMAT>]
+    # hackmyresume NEW <OUTPUTS...> [-f <FORMAT>]
     hackmyresume NEW resume.json
     hackmyresume NEW resume.json -f fresh
     hackmyresume NEW r1.json r2.json -f jrs
@@ -110,12 +123,18 @@ formats.
 
 - **analyze** inspects your resume for keywords, duration, and other metrics.
 
+    ```bash
+    # hackmyresume ANALYZE <INPUTS...>
+    hackmyresume ANALYZE resume.json
+    hackmyresume ANALYZE r1.json r2.json
+    ```
+
 - **convert** converts your source resume between FRESH and JSON Resume
 formats. Use it to convert between the two formats to take advantage of tools
 and services.
 
     ```bash
-    # hackmyresume CONVERT <INPUTS> TO <OUTPUTS>
+    # hackmyresume CONVERT <INPUTS...> TO <OUTPUTS...>
     hackmyresume CONVERT resume.json TO resume-jrs.json
     hackmyresume CONVERT 1.json 2.json 3.json TO out/1.json out/2.json out/3.json
     ```
@@ -124,11 +143,22 @@ and services.
 Resume schema. Use it to make sure your resume data is sufficient and complete.
 
     ```bash
-    # hackmyresume VALIDATE <INPUTS>
+    # hackmyresume VALIDATE <INPUTS...>
     hackmyresume VALIDATE resume.json
     hackmyresume VALIDATE r1.json r2.json r3.json
     ```
 
+- **peek** echoes your resume or any field, property, or object path on your
+resume to standard output.
+
+    ```bash
+    # hackmyresume PEEK <INPUTS...> [OBJECT-PATH]
+    hackmyresume PEEK rez.json # Echo the whole resume
+    hackmyresume PEEK rez.json info.brief # Echo the "info.brief" field
+    hackmyresume PEEK rez.json employment.history[1] # Echo the 1st job
+    hackmyresume PEEK rez.json rez2.json info.brief # Compare value
+    ```    
+
 ## Supported Output Formats
 
 HackMyResume supports these output formats:
@@ -150,7 +180,7 @@ image | .png, .bmp | Forthcoming.
 ## Use
 
 Assuming you've got a JSON-formatted resume handy, generating resumes in
-different formats and combinations easy. Just run:
+different formats and combinations is easy. Just run:
 
 ```bash
 hackmyresume BUILD <INPUTS> <OUTPUTS> [-t theme].
@@ -196,24 +226,36 @@ Generating YAML resume: out/resume.yml
 
 ### Applying a theme
 
-HackMyResume can work with any FRESH or JSON Resume theme. To specify a theme
-when generating your resume, use the `-t` or `--theme` parameter:
+HackMyResume can work with any FRESH or JSON Resume theme (the latter must be
+installed first). To specify a theme when generating your resume, use the `-t`
+or `--theme` parameter:
 
 ```bash
 hackmyresume BUILD resume.json TO out/rez.all -t [theme]
 ```
 
-The `[theme]` parameter can be the name of a predefined theme or the path to any
+The `[theme]` parameter can be the name of a predefined theme OR the path to any
 FRESH or JSON Resume theme folder:
 
 ```bash
 hackmyresume BUILD resume.json TO out/rez.all -t modern
 hackmyresume BUILD resume.json TO OUT.rez.all -t ../some-folder/my-custom-theme/
-hackmyresume BUILD resume.json TO OUT.rez.all -t npm_modules/jsonresume-theme-classy
+hackmyresume BUILD resume.json TO OUT.rez.all -t node_modules/jsonresume-theme-classy
 ```
 
-As of v1.4.0, available predefined themes are `positive`, `modern`, `compact`,
-`minimist`, and `hello-world`.
+FRESH themes are currently pre-installed with HackMyResume. JSON Resume themes
+can be installed prior to use:
+
+```bash
+# Install a JSON Resume theme into a local node_modules subfolder:
+npm install jsonresume-theme-[name]
+# Use it with HackMyResume
+hackmyresume build resume.json -t node_modules/jsonresume-theme-[name]
+```
+
+As of v1.6.0, available predefined FRESH themes are `positive`, `modern`,
+`compact`, `minimist`, and `hello-world`. For a list of JSON Resume themes,
+check the [NPM Registry](https://www.npmjs.com/search?q=jsonresume-theme).
 
 ### Merging resumes
 
@@ -266,6 +308,134 @@ hackmyresume BUILD me.json TO out/resume.all
 `out/resume.doc`, `out/resume.html`, `out/resume.txt`, `out/resume.pdf`, and
 `out/resume.json`.
 
+### Building PDFs
+
+*Users who don't care about PDFs can turn off PDF generation across all themes
+and formats with the `--pdf none` switch.*
+
+HackMyResume takes a unique approach to PDF generation. Instead of enforcing
+a specific PDF engine on users, HackMyResume will attempt to work with whatever
+PDF engine you have installed through the engine's command-line interface (CLI).
+Currently that means one or both of...
+
+- [wkhtmltopdf][3]
+- [Phantom.js][3]
+
+..with support for other engines planned in the future. But for now, **one or
+both of these engines must be installed and accessible on your PATH in order to
+generate PDF resumes with HackMyResume**. That means you should be able to
+invoke either of these tools directly from your shell or terminal without error:
+
+```bash
+wkhtmltopdf input.html output.pdf
+phantomjs script.js input.html output.pdf
+```
+
+Assuming you've installed one or both of these engines on your system, you can
+tell HackMyResume which flavor of PDF generation to use via the `--pdf` option
+(`-p` for short):
+
+```bash
+hackmyresume BUILD resume.json TO out.all --pdf phantom
+hackmyresume BUILD resume.json TO out.all --pdf wkhtmltopdf
+hackmyresume BUILD resume.json TO out.all --pdf none
+```
+
+### Analyzing
+
+HackMyResume can analyze your resume for keywords, employment gaps, and other
+metrics. Run:
+
+```bash
+hackmyresume ANALYZE <my-resume>.json
+```
+
+Depending on the HackMyResume version, you should see output similar to:
+
+
+```
+*** HackMyResume v1.6.0 ***
+Reading resume: resume.json
+Analyzing FRESH resume: resume.json
+
+SECTIONS (10):
+
+        employment:    12
+         education:     2
+           service:     1
+            skills:     8
+           writing:     1
+       recognition:     0
+            social:     4
+         interests:     2
+        references:     1
+         languages:     2
+
+COVERAGE (61.1%):
+
+        Total Days:  6034
+          Employed:  3688
+              Gaps:     8  [31, 1065, 273, 153, 671, 61, 61, 31]
+          Overlaps:     1  [243]
+
+KEYWORDS (61):
+
+           Node.js:     6 mentions
+        JavaScript:     9 mentions
+        SQL Server:     3 mentions
+     Visual Studio:     6 mentions
+           Web API:     1 mentions
+   N-tier / 3-tier:     1 mentions
+            HTML 5:     1 mentions
+        JavaScript:     6 mentions
+               CSS:     2 mentions
+Sass / LESS / SCSS:     1 mentions
+              LAMP:     3 mentions
+              WISC:     1 mentions
+              HTTP:    21 mentions
+              JSON:     1 mentions
+               XML:     2 mentions
+              REST:     1 mentions
+        WebSockets:     2 mentions
+       Backbone.js:     3 mentions
+        Angular.js:     1 mentions
+           Node.js:     4 mentions
+               NPM:     1 mentions
+             Bower:     1 mentions
+             Grunt:     2 mentions
+              Gulp:     1 mentions
+            jQuery:     2 mentions
+         Bootstrap:     3 mentions
+     Underscore.js:     1 mentions
+         PhantomJS:     1 mentions
+      CoffeeScript:     1 mentions
+            Python:    11 mentions
+              Perl:     4 mentions
+               PHP:     7 mentions
+             MySQL:    12 mentions
+        PostgreSQL:     4 mentions
+             NoSQL:     2 mentions
+            Apache:     2 mentions
+               AWS:     2 mentions
+               EC2:     2 mentions
+               RDS:     3 mentions
+                S3:     1 mentions
+             Azure:     1 mentions
+         Rackspace:     1 mentions
+               C++:    23 mentions
+            C++ 11:     1 mentions
+             Boost:     1 mentions
+             Xcode:     2 mentions
+               gcc:     1 mentions
+             OO&AD:     1 mentions
+              .NET:    20 mentions
+           Unity 5:     2 mentions
+              Mono:     3 mentions
+       MonoDevelop:     1 mentions
+           Xamarin:     1 mentions
+             TOTAL:   180 mentions
+```
+
 ### Validating
 
 HackMyResume can also validate your resumes against either the [FRESH /
@@ -280,7 +450,7 @@ hackmyresume VALIDATE resumeA.json resumeB.json
 HackMyResume will validate each specified resume in turn:
 
 ```bash
-*** HackMyResume v0.9.0 ***
+*** HackMyResume v1.6.0 ***
 Validating JSON resume: resumeA.json (INVALID)
 Validating JSON resume: resumeB.json (VALID)
 ```
@@ -299,14 +469,49 @@ where <INPUTS> is one or more resumes in FRESH or JSON Resume format, and
 autodetect the format (FRESH or JRS) of each input resume and convert it to the
 other format (JRS or FRESH).
 
+### File-based Options
+
+You can pass options into HackMyResume via an external options or ".hackmyrc"
+file with the `--options` or `-o` switch:
+
+```bash
+hackmyresume BUILD resume.json -o path/to/options.json
+```
+
+The options file can contain any documented HackMyResume option, including
+`theme`, `silent`, `debug`, `pdf`, `css`, and other settings.
+
+```javascript
+{
+  // Set the default theme to "compact"
+  "theme": "compact",
+  // Change the "employment" section title text to "Work"
+  "sectionTitles": {
+    "employment": "Work"
+  }
+}
+```
+
+If a particular option is specified both on the command line and in an external
+options file, the explicit command-line option takes precedence.
+
+```bash
+# path/to/options.json specifes the POSITIVE theme
+# -t parameter specifies the COMPACT theme
+# The -t parameter wins.
+hackmyresume BUILD resume.json -o path/to/options.json -t compact
+> Reading resume: resume.json
+> Applying COMPACT theme (7 formats)
+```
+
 ### Prettifying
 
 HackMyResume applies [js-beautify][10]-style HTML prettification by default to
-HTML-formatted resumes. To disable prettification, the `--nopretty` or `-n` flag
-can be used:
+HTML-formatted resumes. To disable prettification, the `--no-prettify` or `-n`
+flag can be used:
 
 ```bash
-hackmyresume BUILD resume.json out.all --nopretty
+hackmyresume BUILD resume.json out.all --no-prettify
 ```
 
 ### Silent Mode
@@ -318,6 +523,16 @@ hackmyresume BUILD resume.json -o someFile.all -s
 hackmyresume BUILD resume.json -o someFile.all --silent
 ```
 
+### Debug Mode
+
+Use `-d` or `--debug` to force HMR to emit a call stack when errors occur. In
+the future, this option will emit detailed error logging.
+
+```bash
+hackmyresume BUILD resume.json -d
+hackmyresume ANALYZE resume.json --debug
+```
+
 ## Contributing
 
 HackMyResume is a community-driven free and open source project under the MIT

ROADMAP.md

@@ -0,0 +1,107 @@
+Development Roadmap
+===================
+
+## Short-Term
+
+### FluentCV Desktop: Beta 1
+
+The **FluentCV Desktop 1.0 beta release** will present HackMyResume
+functionality in a cross-platform desktop application for OS X, Linux, and
+Windows.
+
+### GitHub Integration
+
+HackMyResume will offer GitHub integration for versioned resume storage and
+retrieval via the `COMMIT` or `STORE` command(s) starting in 1.7.0 or 1.8.0.
+
+### fresh-themes 1.0.0
+
+The **fresh-themes 1.0** release will bring 100% coverage of the FRESH and JRS
+object models—all resume sections and fields—along with
+documentation, theme developer's guide, new themes, and a freeze to the FRESH
+theme structure.
+
+### Better LaTeX support
+
+Including Markdown-to-LaTeX translation and more LaTeX-driven themes / formats.
+
+### StackOverflow and LinkedIn support
+
+Will start appearing in v1.7.0, with incremental improvements in 1.8.0 and
+beyond.
+
+### Improved resume sorting and arranging
+
+**Better resume sorting** of items and sections: ascending, descending, by
+date or other criteria ([#67][i67]).
+
+### Remote resume / theme loading
+
+Support remote loading of themes and resumes over `http`, `https`, and
+`git://`. Enable these usage patterns:
+
+    ```bash
+    hackmyresume build https://somesite.com/my-resume.json -t informatic
+
+    hackmyresume build resume.json -t npm:fresh-theme-ergonomic
+
+    hackmyresume analyze https://github.com/foo/my-resume
+    ```
+
+### 100% code coverage
+
+Should reduce certain classes of errors and allow HMR to display a nifty 100%
+code coverage badge.
+
+### Improved **documentation and samples**
+
+Expanded documentation and samples throughout.
+
+## Mid-Term
+
+### Cover letters and job descriptions
+
+Add support for schema-driven **cover letters** and **job descriptions**.
+
+### Character Sheets
+
+HackMyResume 2.0 will ship with support for, yes, RPG-style character sheets.
+This will demonstrate the tool's ability to flow arbitrary JSON to concrete
+document(s) and provide unique albeit niche functionality around various games
+([#117][i117]).
+
+### Rich text (.rtf) output formats
+
+Basic support for **rich text** `.rtf` output formats.
+
+### Investigate: groff support
+
+Investigate adding [**groff**][groff] support, because that would, indeed, be
+[dope][d] ([#37][i37]).
+
+### Investigate: org-mode support
+
+Investigate adding [**org mode**][om] support ([#38][i38]).
+
+### Investigate: Scribus
+
+Investigate adding [**Scribus SLA**][scri] support ([#54][i54]).
+
+### Support JSON Resume 1.0.0
+
+When released.
+
+## Long-Term
+
+- TBD
+
+[groff]: http://www.gnu.org/software/groff/
+[om]: http://orgmode.org/
+[scri]: https://en.wikipedia.org/wiki/Scribus
+[d]: https://github.com/hacksalot/HackMyResume/issues/37#issue-123818674
+[i37]: https://github.com/hacksalot/HackMyResume/issues/37
+[i38]: https://github.com/hacksalot/HackMyResume/issues/38
+[i54]: https://github.com/hacksalot/HackMyResume/issues/54
+[i67]: https://github.com/hacksalot/HackMyResume/issues/67
+[i107]: https://github.com/hacksalot/HackMyResume/issues/107
+[i117]: https://github.com/hacksalot/HackMyResume/issues/117

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hackmyresume",
-  "version": "1.4.1",
+  "version": "1.7.0",
   "description": "Generate polished résumés and CVs in HTML, Markdown, LaTeX, MS Word, PDF, plain text, JSON, XML, YAML, smoke signal, and carrier pigeon.",
   "repository": {
     "type": "git",
@@ -30,6 +30,7 @@
   ],
   "author": "hacksalot <hacksalot@indevious.com> (https://github.com/hacksalot)",
   "contributors": [
+    "aruberto (https://github.com/aruberto)",
     "jjanusch (https://github.com/driftdev)",
     "robertmain (https://github.com/robertmain)",
     "tomheon (https://github.com/tomheon)",
@@ -41,7 +42,6 @@
   "bugs": {
     "url": "https://github.com/hacksalot/HackMyResume/issues"
   },
-  "main": "src/hackmyapi.js",
   "bin": {
     "hackmyresume": "src/index.js"
   },
@@ -50,42 +50,27 @@
     "chalk": "^1.1.1",
     "commander": "^2.9.0",
     "copy": "^0.1.3",
-    "fresca": "~0.3.0",
-    "fresh-resume-starter": "^0.1.1",
-    "fresh-themes": "~0.12.0-beta",
-    "fs-extra": "^0.24.0",
+    "extend": "^3.0.0",
+    "fresca": "~0.6.0",
+    "hackmycore": "^0.2.0",
     "handlebars": "^4.0.5",
-    "html": "0.0.10",
-    "is-my-json-valid": "^2.12.2",
-    "json-lint": "^0.1.0",
-    "jst": "0.0.13",
     "lodash": "^3.10.1",
-    "marked": "^0.3.5",
-    "mkdirp": "^0.5.1",
-    "moment": "^2.10.6",
-    "parse-filepath": "^0.6.3",
-    "path-exists": "^2.1.0",
-    "phantom": "^0.8.4",
-    "recursive-readdir-sync": "^1.0.6",
-    "simple-html-tokenizer": "^0.2.0",
-    "slash": "^1.0.0",
+    "printf": "^0.2.3",
     "string-padding": "^1.0.2",
     "string.prototype.startswith": "^0.2.0",
     "underscore": "^1.8.3",
-    "webshot": "^0.16.0",
-    "wkhtmltopdf": "^0.1.5",
     "word-wrap": "^1.1.0",
-    "xml-escape": "^1.0.0",
     "yamljs": "^0.2.4"
   },
   "devDependencies": {
     "chai": "*",
-    "fresh-test-resumes": "^0.2.1",
+    "fresh-test-resumes": "^0.6.0",
     "grunt": "*",
     "grunt-cli": "^0.1.13",
     "grunt-contrib-clean": "^0.7.0",
     "grunt-contrib-jshint": "^0.11.3",
     "grunt-contrib-yuidoc": "^0.10.0",
+    "grunt-jsdoc": "^1.1.0",
     "grunt-simple-mocha": "*",
     "jsonresume-theme-boilerplate": "^0.1.2",
     "jsonresume-theme-classy": "^1.0.9",

src/cli/analyze.hbs

@@ -0,0 +1,30 @@
+
+{{style "SECTIONS (" "bold"}}{{style totals.numSections "white" }}{{style ")" "bold"}}
+
+        employment:     {{v totals.totals.employment "-" 2 "bold" }}
+          projects:     {{v totals.totals.projects "-" 2 "bold" }}
+         education:     {{v totals.totals.education "-" 2 "bold" }}
+           service:     {{v totals.totals.service "-" 2 "bold" }}
+            skills:     {{v totals.totals.skills "-" 2 "bold" }}
+           writing:     {{v totals.totals.writing "-" 2 "bold" }}
+          speaking:     {{v totals.totals.speaking "-" 2 "bold" }}
+           reading:     {{v totals.totals.reading "-" 2 "bold" }}
+            social:     {{v totals.totals.social "-" 2 "bold" }}
+        references:     {{v totals.totals.references "-" 2 "bold" }}
+      testimonials:     {{v totals.totals.testimonials "-" 2 "bold" }}
+         languages:     {{v totals.totals.languages "-" 2 "bold" }}
+         interests:     {{v totals.totals.interests "-" 2 "bold" }}
+
+{{style "COVERAGE (" "bold"}}{{style coverage.pct "white"}}{{style ")" "bold"}}
+
+        Total Days:  {{v coverage.duration.total "-" 5 "bold" }}
+          Employed:  {{v coverage.duration.work "-" 5 "bold" }}
+              Gaps:  {{v coverage.gaps.length "-" 5 "bold" }}  [{{#if coverage.gaps.length }}{{#each coverage.gaps }}{{#unless @first}} {{/unless}}{{gapLength duration }}{{/each}}{{/if}}]
+          Overlaps:  {{v coverage.overlaps.length "-" 5 "bold" }}  [{{#if coverage.overlaps.length }}{{#each coverage.overlaps }}{{#unless @first}} {{/unless}}{{gapLength duration }}{{/each}}{{/if}}]
+
+{{style "KEYWORDS (" "bold"}}{{style keywords.length "white" }}{{style ")" "bold"}}
+
+{{#each keywords }}{{{pad name 18}}}:  {{v count "-" 5 "bold"}} mention{{#isPlural count}}s{{/isPlural}}
+{{/each}}
+    -------------------------------
+{{v keywords.length "0" 9 "bold"}} {{style "KEYWORDS" "bold"}}   {{v keywords.totalKeywords "0" 5 "bold"}} {{style "mentions" "bold"}}

src/cli/error.js

@@ -0,0 +1,280 @@
+/**
+Error-handling routines for HackMyResume.
+@module cli/error
+@license MIT. See LICENSE.md for details.
+*/
+
+
+
+(function() {
+
+
+
+  var HMSTATUS = require('hackmycore/src/core/status-codes')
+    , PKG = require('../../package.json')
+    , FS = require('fs')
+    , FCMD = require('hackmycore')
+    , PATH = require('path')
+    , WRAP = require('word-wrap')
+    , M2C = require('hackmycore/src/utils/md2chalk.js')
+    , chalk = require('chalk')
+    , extend = require('extend')
+    , YAML = require('yamljs')
+    , printf = require('printf')
+    , SyntaxErrorEx = require('hackmycore/src/utils/syntax-error-ex');
+    require('string.prototype.startswith');
+
+
+
+  /**
+  Error handler for HackMyResume. All errors are handled here.
+  @class ErrorHandler
+  */
+  var ErrorHandler = module.exports = {
+
+
+
+    init: function( debug, assert, silent ) {
+      this.debug = debug;
+      this.assert = assert;
+      this.silent = silent;
+      this.msgs = require('./msg.js').errors;
+      return this;
+    },
+
+
+
+    err: function( ex, shouldExit ) {
+
+      // Short-circuit logging output if --silent is on
+      var o = this.silent ? function() { } : _defaultLog;
+
+      // Special case; can probably be removed.
+      if( ex.pass ) throw ex;
+
+      // Load error messages
+      this.msgs = this.msgs || require('./msg.js').errors;
+
+      // Handle packaged HMR exceptions
+      if( ex.fluenterror ) {
+
+        // Output the error message
+        var objError = assembleError.call( this, ex );
+        o( this[ 'format_' + objError.etype ]( objError.msg ));
+
+        // Output the stack (sometimes)
+        if( objError.withStack ) {
+          var stack = ex.stack || (ex.inner && ex.inner.stack);
+          stack && o( chalk.gray( stack ) );
+        }
+
+        // Quit if necessary
+        if( ex.quit || objError.quit ) {
+          this.debug && o(
+            chalk.cyan('Exiting with error code ' + ex.fluenterror.toString()));
+          if( this.assert ) { ex.pass = true; throw ex; }
+          process.exit( ex.fluenterror );
+        }
+
+      }
+
+      // Handle raw exceptions
+      else {
+        o( ex );
+        var stackTrace = ex.stack || (ex.inner && ex.inner.stack);
+        if( stackTrace && this.debug )
+          o( M2C(ex.stack || ex.inner.stack, 'gray') );
+      }
+
+    },
+
+
+
+    format_error: function( msg ) {
+      msg = msg || '';
+      return chalk.red.bold(
+        msg.toUpperCase().startsWith('ERROR:') ? msg : 'Error: ' + msg );
+    },
+
+
+
+    format_warning: function( brief, msg ) {
+      return chalk.yellow(brief) + chalk.yellow(msg || '');
+    },
+
+
+    format_custom: function( msg ) {
+      return msg;
+    }
+
+
+
+  };
+
+
+
+  function _defaultLog() {
+    console.log.apply( console.log, arguments );
+  }
+
+
+
+  function assembleError( ex ) {
+
+    var msg = '', withStack = false, quit = false, etype = 'warning';
+    if( this.debug ) withStack = true;
+
+    switch( ex.fluenterror ) {
+
+      case HMSTATUS.themeNotFound:
+        msg = printf( M2C( this.msgs.themeNotFound.msg, 'yellow' ), ex.data);
+        break;
+
+      case HMSTATUS.copyCSS:
+        msg = M2C( this.msgs.copyCSS.msg, 'red' );
+        quit = false;
+        break;
+
+      case HMSTATUS.resumeNotFound:
+        msg = M2C( this.msgs.resumeNotFound.msg, 'yellow' );
+        break;
+
+      case HMSTATUS.missingCommand:
+        msg = M2C( this.msgs.missingCommand.msg + " (", 'yellow');
+        msg += Object.keys( FCMD.verbs ).map( function(v, idx, ar) {
+          return (idx === ar.length - 1 ? chalk.yellow('or ') : '') +
+            chalk.yellow.bold(v.toUpperCase());
+        }).join( chalk.yellow(', ')) + chalk.yellow(").\n\n");
+
+        msg += chalk.gray(FS.readFileSync(
+          PATH.resolve(__dirname, '../cli/use.txt'), 'utf8' ));
+        break;
+
+      case HMSTATUS.invalidCommand:
+        msg = printf( M2C( this.msgs.invalidCommand.msg, 'yellow'), ex.attempted );
+        break;
+
+      case HMSTATUS.resumeNotFoundAlt:
+        msg = M2C( this.msgs.resumeNotFoundAlt.msg, 'yellow' );
+        break;
+
+      case HMSTATUS.inputOutputParity:
+        msg = M2C( this.msgs.inputOutputParity.msg );
+        break;
+
+      case HMSTATUS.createNameMissing:
+        msg = M2C( this.msgs.createNameMissing.msg );
+        break;
+
+      case HMSTATUS.pdfGeneration:
+        msg = M2C( this.msgs.pdfGeneration.msg, 'bold' );
+        if( ex.inner ) msg += chalk.red('\n' + ex.inner);
+        withStack = true; quit = false; etype = 'error';
+        break;
+
+      case HMSTATUS.invalid:
+        msg = M2C( this.msgs.invalid.msg, 'red' );
+        etype = 'error';
+        break;
+
+      case HMSTATUS.generateError:
+        msg = (ex.inner && ex.inner.toString()) || ex;
+        quit = false;
+        etype = 'error';
+        break;
+
+      case HMSTATUS.fileSaveError:
+        msg = printf( M2C( this.msgs.fileSaveError.msg ), (ex.inner || ex).toString() );
+        etype = 'error';
+        quit = false;
+        break;
+
+      case HMSTATUS.invalidFormat:
+        ex.data.forEach(function(d){
+          msg += printf( M2C( this.msgs.invalidFormat.msg, 'bold' ),
+            ex.theme.name.toUpperCase(), d.format.toUpperCase());
+        }, this);
+        break;
+
+      case HMSTATUS.missingParam:
+        msg = printf( M2C( this.msgs.missingParam.msg ), ex.expected, ex.helper );
+        break;
+
+      case HMSTATUS.invalidHelperUse:
+        msg = printf( M2C( this.msgs.invalidHelperUse.msg ), ex.helper );
+        if( ex.error ) {
+          msg += '\n--> ' + assembleError.call( this, extend( true, {}, ex, {fluenterror: ex.error} )).msg;
+          //msg += printf( '\n--> ' + M2C( this.msgs.invalidParamCount.msg ), ex.expected );
+        }
+        quit = false;
+        etype = 'warning';
+        break;
+
+      case HMSTATUS.notOnPath:
+        msg = printf( M2C(this.msgs.notOnPath.msg, 'bold'), ex.engine);
+        quit = false;
+        etype = 'error';
+        break;
+
+      case HMSTATUS.readError:
+        if( !ex.quiet )
+          console.error(printf( M2C(this.msgs.readError.msg, 'red'), ex.file));
+        msg = ex.inner.toString();
+        etype = 'error';
+        break;
+
+      case HMSTATUS.mixedMerge:
+        msg = M2C( this.msgs.mixedMerge.msg );
+        quit = false;
+        break;
+
+      case HMSTATUS.invokeTemplate:
+        msg = M2C( this.msgs.invokeTemplate.msg, 'red' );
+        msg += M2C( '\n' + WRAP(ex.inner.toString(), { width: 60, indent: '   ' }), 'gray' );
+        etype = 'custom';
+        break;
+
+      case HMSTATUS.compileTemplate:
+        etype = 'error';
+        break;
+
+      case HMSTATUS.themeLoad:
+        msg = M2C( printf( this.msgs.themeLoad.msg, ex.attempted.toUpperCase() ), 'red');
+        if( ex.inner && ex.inner.fluenterror ) {
+          msg += M2C('\nError: ', 'red') + assembleError.call( this, ex.inner ).msg;
+        }
+        quit = true;
+        etype = 'custom';
+        break;
+
+      case HMSTATUS.parseError:
+        if( SyntaxErrorEx.is( ex.inner )) {
+          console.error( printf( M2C(this.msgs.readError.msg, 'red'), ex.file ) );
+          var se = new SyntaxErrorEx( ex, ex.raw );
+          msg = printf( M2C( this.msgs.parseError.msg, 'red' ),
+            se.line, se.col);
+        }
+        else if( ex.inner && ex.inner.line !== undefined && ex.inner.col !== undefined ) {
+          msg = printf( M2C( this.msgs.parseError.msg, 'red' ),
+            ex.inner.line, ex.inner.col);
+        }
+        else {
+          msg = ex;
+        }
+        etype = 'error';
+        break;
+
+    }
+
+    return {
+      msg: msg,              // The error message to display
+      withStack: withStack,  // Whether to include the stack
+      quit: quit,
+      etype: etype
+    };
+  }
+
+
+
+
+}());

src/cli/main.js

@@ -0,0 +1,331 @@
+/**
+Definition of the `main` function.
+@module cli/main
+@license MIT. See LICENSE.md for details.
+*/
+
+
+
+(function(){
+
+
+
+  var HMR  = require( 'hackmycore')
+    , PKG = require('../../package.json')
+    , FS = require('fs')
+    , EXTEND = require('extend')
+    , chalk = require('chalk')
+    , PATH = require('path')
+    , HMSTATUS = require('hackmycore/src/core/status-codes')
+    , HME = require('hackmycore/src/core/event-codes')
+    , safeLoadJSON = require('hackmycore/src/utils/safe-json-loader')
+    , StringUtils = require('hackmycore/src/utils/string.js')
+    , _ = require('underscore')
+    , OUTPUT = require('./out')
+    , PAD = require('string-padding')
+    , Command = require('commander').Command;
+
+  var _opts = { };
+  var _title = chalk.white.bold('\n*** HackMyResume v' +PKG.version+ ' ***');
+  var _out = new OUTPUT( _opts );
+
+
+
+  /**
+  A callable implementation of the HackMyResume CLI. Encapsulates the command
+  line interface as a single method accepting a parameter array.
+  @alias module:cli/main.main
+  @param rawArgs {Array} An array of command-line parameters. Will either be
+  process.argv (in production) or custom parameters (in test).
+  */
+  var main = module.exports = function( rawArgs ) {
+
+    var initInfo = initialize( rawArgs );
+    var args = initInfo.args;
+
+    // Create the top-level (application) command...
+    var program = new Command('hackmyresume')
+      .version(PKG.version)
+      .description(chalk.yellow.bold('*** HackMyResume ***'))
+      .option('-s --silent', 'Run in silent mode')
+      .option('--no-color', 'Disable colors')
+      .option('--color', 'Enable colors')
+      .option('-d --debug', 'Enable diagnostics', false)
+      .option('-a --assert', 'Treat warnings as errors', false)
+      .option('-v --version', 'Show the version')
+      .allowUnknownOption();
+      program.jsonArgs = initInfo.options;
+
+    // Create the NEW command
+    program
+      .command('new')
+      .arguments('<sources...>')
+      .option('-f --format <fmt>', 'FRESH or JRS format', 'FRESH')
+      .alias('create')
+      .description('Create resume(s) in FRESH or JSON RESUME format.')
+      .action(function( sources ) {
+        execute.call( this, sources, [], this.opts(), logMsg);
+      });
+
+    // Create the VALIDATE command
+    program
+      .command('validate')
+      .arguments('<sources...>')
+      .description('Validate a resume in FRESH or JSON RESUME format.')
+      .action(function(sources) {
+        execute.call( this, sources, [], this.opts(), logMsg);
+      });
+
+    // Create the CONVERT command
+    program
+      .command('convert')
+      .description('Convert a resume to/from FRESH or JSON RESUME format.')
+      .action(function() {
+        var x = splitSrcDest.call( this );
+        execute.call( this, x.src, x.dst, this.opts(), logMsg);
+      });
+
+    // Create the ANALYZE command
+    program
+      .command('analyze')
+      .arguments('<sources...>')
+      .description('Analyze one or more resumes.')
+      .action(function( sources ) {
+        execute.call( this, sources, [], this.opts(), logMsg);
+      });
+
+    // Create the PEEK command
+    program
+      .command('peek')
+      .arguments('<sources...>')
+      .description('Peek at a resume field or section')
+      .action(function( sources, sectionOrField ) {
+        var dst = (sources && sources.length > 1) ? [sources.pop()] : [];
+        execute.call( this, sources, dst, this.opts(), logMsg);
+      });
+
+    // Create the BUILD command
+    program
+      .command('build')
+      .alias('generate')
+      .option('-t --theme <theme>', 'Theme name or path')
+      .option('-n --no-prettify', 'Disable HTML prettification', true)
+      .option('-c --css <option>', 'CSS linking / embedding')
+      .option('-p --pdf <engine>', 'PDF generation engine')
+      .option('--no-sort', 'Sort resume sections by date', false)
+      .option('--tips', 'Display theme tips and warnings.', false)
+      .description('Generate resume to multiple formats')
+      .action(function( sources, targets, options ) {
+        var x = splitSrcDest.call( this );
+        execute.call( this, x.src, x.dst, this.opts(), logMsg);
+      });
+
+    program.parse( args );
+
+    if (!program.args.length) { throw { fluenterror: 4 }; }
+
+  };
+
+
+
+  /** Massage command-line args and setup Commander.js. */
+  function initialize( ar ) {
+
+    var o = initOptions( ar );
+
+    o.silent || logMsg( _title );
+
+    // Emit debug prelude if --debug was specified
+    if( o.debug ) {
+      _out.log(chalk.cyan('The -d or --debug switch was specified. DEBUG mode engaged.'));
+      _out.log('');
+      _out.log(chalk.cyan(PAD('  Platform:',25, null, PAD.RIGHT)) + chalk.cyan.bold( process.platform === 'win32' ? 'windows' : process.platform ));
+      _out.log(chalk.cyan(PAD('  Node.js:',25, null, PAD.RIGHT)) + chalk.cyan.bold( process.version ));
+      _out.log(chalk.cyan(PAD('  HackMyResume:',25, null, PAD.RIGHT)) + chalk.cyan.bold('v' + PKG.version ));
+      _out.log(chalk.cyan(PAD('  FRESCA:',25, null, PAD.RIGHT)) + chalk.cyan.bold( PKG.dependencies.fresca ));
+      //_out.log(chalk.cyan(PAD('  fresh-themes:',25, null, PAD.RIGHT)) + chalk.cyan.bold( PKG.dependencies['fresh-themes'] ));
+      //_out.log(chalk.cyan(PAD('  fresh-jrs-converter:',25, null, PAD.RIGHT)) + chalk.cyan.bold( PKG.dependencies['fresh-jrs-converter'] ));
+      _out.log('');
+    }
+
+    // Handle invalid verbs here (a bit easier here than in commander.js)...
+    if( o.verb && !HMR.verbs[ o.verb ] && !HMR.alias[ o.verb ] ) {
+      throw { fluenterror: HMSTATUS.invalidCommand, quit: true,
+              attempted: o.orgVerb };
+    }
+
+    // Override the .missingArgument behavior
+    Command.prototype.missingArgument = function(name) {
+      if( this.name() !== 'new' ) {
+        throw { fluenterror: HMSTATUS.resumeNotFound, quit: true };
+      }
+    };
+
+    // Override the .helpInformation behavior
+    Command.prototype.helpInformation = function() {
+      var manPage = FS.readFileSync(
+        PATH.join(__dirname, 'use.txt'), 'utf8' );
+      return chalk.green.bold(manPage);
+    };
+
+    return {
+      args: o.args,
+      options: o.json
+    };
+  }
+
+
+
+  /** Init options prior to setting up command infrastructure. */
+  function initOptions( ar ) {
+    var oVerb, verb = '', args = ar.slice(), cleanArgs = args.slice(2), oJSON;
+    if( cleanArgs.length ) {
+
+      // Support case-insensitive sub-commands (build, generate, validate, etc)
+      var vidx = _.findIndex( cleanArgs, function(v){ return v[0] !== '-'; });
+      if( vidx !== -1 ) {
+        oVerb = cleanArgs[ vidx ];
+        verb = args[ vidx + 2 ] = oVerb.trim().toLowerCase();
+      }
+
+      // Remove --options --opts -o and process separately
+      var optsIdx = _.findIndex( cleanArgs, function(v){
+        return v === '-o' || v === '--options' || v === '--opts';
+      });
+      if(optsIdx !== -1) {
+        var optStr = cleanArgs[ optsIdx + 1];
+        args.splice( optsIdx + 2, 2 );
+        if( optStr && (optStr = optStr.trim()) ) {
+          //var myJSON = JSON.parse(optStr);
+          if( optStr[0] === '{')
+            oJSON = eval('(' + optStr + ')'); // jshint ignore:line
+          else {
+            var inf = safeLoadJSON( optStr );
+            if( !inf.ex )
+              oJSON = inf.json;
+            // TODO: Error handling
+          }
+        }
+      }
+    }
+
+    // Grab the --debug flag
+    var isDebug = _.some( args, function(v) {
+      return v === '-d' || v === '--debug';
+    });
+
+    // Grab the --silent flag
+    var isSilent = _.some( args, function(v) {
+      return v === '-s' || v === '--silent';
+    });
+
+    return {
+      debug: isDebug,
+      silent: isSilent,
+      orgVerb: oVerb,
+      verb: verb,
+      json: oJSON,
+      args: args
+    };
+  }
+
+
+
+  /** Invoke a HackMyResume verb. */
+  function execute( src, dst, opts, log ) {
+
+    loadOptions.call( this, opts, this.parent.jsonArgs );
+    var hand = require( './error' );
+    hand.init( _opts.debug, _opts.assert, _opts.silent );
+    var v = new HMR.verbs[ this.name() ]();
+    _opts.errHandler = v;
+    _out.init( _opts );
+    v.on( 'hmr:status', function() { _out.do.apply( _out, arguments ); });
+    v.on( 'hmr:error', function() {
+      hand.err.apply( hand, arguments );
+    });
+    v.invoke.call( v, src, dst, _opts, log );
+    if( v.errorCode )
+      process.exit(v.errorCode);
+  }
+
+
+
+  /**
+  Initialize HackMyResume options.
+  TODO: Options loading is a little hacky, for two reasons:
+    - Commander.js idiosyncracies
+    - Need to accept JSON inputs from the command line.
+  */
+  function loadOptions( o, cmdO ) {
+
+    // o and this.opts() seem to be the same (command-specific options)
+
+    // Load the specified options file (if any) and apply options
+    if( cmdO )
+      o = EXTEND(true, o, cmdO);
+
+    // Merge in command-line options
+    o = EXTEND( true, o, this.opts() );
+
+    // Kludge parent-level options until piping issue is resolved
+    if( this.parent.silent !== undefined && this.parent.silent !== null)
+      o.silent = this.parent.silent;
+    if( this.parent.debug !== undefined && this.parent.debug !== null)
+      o.debug = this.parent.debug;
+    if( this.parent.assert !== undefined && this.parent.assert !== null)
+      o.assert = this.parent.assert;
+
+    if( o.debug ) {
+      logMsg(chalk.cyan('OPTIONS:') + '\n');
+      _.each(o, function(val, key) {
+        logMsg(chalk.cyan('  %s') + chalk.cyan.bold(' %s'),
+          PAD(key,22,null,PAD.RIGHT), val);
+      });
+      logMsg('');
+    }
+
+    // Cache
+    EXTEND(true, _opts, o);
+  }
+
+
+
+  /** Split multiple command-line filenames by the 'TO' keyword */
+  function splitSrcDest() {
+
+    var params = this.parent.args.filter(function(j) { return String.is(j); });
+    if( params.length === 0 )
+      throw { fluenterror: HMSTATUS.resumeNotFound, quit: true };
+
+    // Find the TO keyword, if any
+    var splitAt = _.findIndex( params, function(p) {
+      return p.toLowerCase() === 'to';
+    });
+
+    // TO can't be the last keyword
+    if( splitAt === params.length - 1 && splitAt !== -1 ) {
+      logMsg(chalk.yellow('Please ') +
+        chalk.yellow.bold('specify an output file') +
+        chalk.yellow(' for this operation or ') +
+        chalk.yellow.bold('omit the TO keyword') +
+        chalk.yellow('.') );
+      return;
+    }
+
+    return {
+      src: params.slice(0, splitAt === -1 ? undefined : splitAt ),
+      dst: splitAt === -1 ? [] : params.slice( splitAt + 1 )
+    };
+  }
+
+
+
+  /** Simple logging placeholder. */
+  function logMsg() {
+    _opts.silent || console.log.apply( console.log, arguments );
+  }
+
+
+
+}());

src/cli/msg.js

@@ -0,0 +1,18 @@
+/**
+Message-handling routines for HackMyResume.
+@module msg.js
+@license MIT. See LICENSE.md for details.
+*/
+
+
+
+(function() {
+
+  var PATH = require('path');
+  var YAML = require('yamljs');
+
+  var cache = module.exports = function() {
+    return cache ? cache : YAML.load( PATH.join(__dirname, 'msg.yml') );
+  }();
+
+}());

src/cli/msg.yml

@@ -0,0 +1,98 @@
+events:
+  begin:
+    msg: Invoking **%s** command.
+  beforeCreate:
+    msg: Creating new **%s** resume: **%s**
+  afterRead:
+    msg: Reading **%s** resume: **%s**
+  beforeTheme:
+    msg: Verifying **%s** theme.
+  afterTheme:
+    msg: Verifying outputs:  ???
+  beforeMerge:
+    msg:
+      - "Merging **%s**"
+      - " onto **%s**"
+  applyTheme:
+    msg: Applying **%s** theme (**%s** format%s)
+  afterBuild:
+    msg:
+      - "The **%s** theme says:"
+      - |
+          "For best results view JSON Resume themes over a
+          local or remote HTTP connection. For example:
+
+            npm install http-server -g
+            http-server <resume-folder>
+
+          For more information, see the README."
+  afterGenerate:
+    msg:
+      - " (with %s)"
+      - "Skipping %s resume: %s"
+      - "Generating **%s** resume: **%s**"
+  beforeAnalyze:
+    msg: "Analyzing **%s** resume: **%s**"
+  beforeConvert:
+    msg: "Converting **%s** (**%s**) to **%s** (**%s**)"
+  afterValidate:
+    msg:
+      - "Validating **%s** against the **%s** schema: "
+      - "VALID!"
+      - "INVALID"
+      - "BROKEN"
+  beforePeek:
+    msg:
+      - Peeking at **%s** in **%s**
+      - Peeking at **%s**
+  afterPeek:
+    msg: "The specified key **%s** was not found in **%s**."
+  afterInlineConvert:
+    msg: Converting **%s** to **%s** format.
+errors:
+  themeNotFound:
+    msg: >
+      **Couldn't find the '%s' theme.** Please specify the name of a preinstalled
+      FRESH theme or the path to a locally installed FRESH or JSON Resume theme.
+  copyCSS:
+    msg: Couldn't copy CSS file to destination folder.
+  resumeNotFound:
+    msg: Please **feed me a resume** in FRESH or JSON Resume format.
+  missingCommand:
+    msg: Please **give me a command**
+  invalidCommand:
+    msg: Invalid command: '%s'
+  resumeNotFoundAlt:
+    msg: Please **feed me a resume** in either FRESH or JSON Resume format.
+  inputOutputParity:
+    msg: Please **specify an output file name** for every input file you wish to convert.
+  createNameMissing:
+    msg: Please **specify the filename** of the resume to create.
+  pdfGeneration:
+    msg: PDF generation failed. Make sure wkhtmltopdf is installed and accessible from your path.
+  invalid:
+    msg: Validation failed and the --assert option was specified.
+  invalidFormat:
+    msg: The **%s** theme doesn't support the **%s** format.
+  notOnPath:
+    msg: %s wasn't found on your system path or is inaccessible. PDF not generated.
+  readError:
+    msg: Reading **???** resume: **%s**
+  parseError:
+    msg: Invalid or corrupt JSON on line %s column %s.
+  invalidHelperUse:
+    msg: "**Warning**: Incorrect use of the **%s** theme helper."
+  fileSaveError:
+    msg: An error occurred while writing %s to disk: %s.
+  mixedMerge:
+    msg: "**Warning:** merging mixed resume types. Errors may occur."
+  invokeTemplate:
+    msg: "An error occurred during template invocation."
+  compileTemplate:
+    msg: "An error occurred during template compilation."
+  themeLoad:
+    msg: "Applying **%s** theme (? formats)"
+  invalidParamCount:
+    msg: "Invalid number of parameters. Expected: **%s**."
+  missingParam:
+    msg: The '**%s**' parameter was needed but not supplied.

src/cli/out.js

@@ -0,0 +1,229 @@
+/**
+Output routines for HackMyResume.
+@license MIT. See LICENSE.md for details.
+@module out.js
+*/
+
+
+
+(function() {
+
+
+
+  var chalk = require('chalk')
+    , HME = require('hackmycore/src/core/event-codes')
+    , _ = require('underscore')
+    , Class = require('hackmycore/src/utils/class.js')
+    , M2C = require('hackmycore/src/utils/md2chalk.js')
+    , PATH = require('path')
+    , LO = require('lodash')
+    , FS = require('fs')
+    , EXTEND = require('extend')
+    , HANDLEBARS = require('handlebars')
+    , YAML = require('yamljs')
+    , printf = require('printf')
+    , pad = require('string-padding')
+    , dbgStyle = 'cyan';
+
+
+
+  /**
+  A stateful output module. All HMR console output handled here.
+  */
+  var OutputHandler = module.exports = Class.extend({
+
+
+
+    init: function( opts ) {
+      this.opts = EXTEND( true, this.opts || { }, opts );
+      this.msgs = YAML.load(PATH.join( __dirname, 'msg.yml' )).events;
+    },
+
+
+
+    log: function( msg ) {
+      msg = msg || '';
+      var printf = require('printf');
+      var finished = printf.apply( printf, arguments );
+      this.opts.silent || console.log( finished );
+    },
+
+
+
+    do: function( evt ) {
+
+      var that = this;
+      function L() {
+        that.log.apply( that, arguments );
+      }
+
+      switch( evt.sub ) {
+
+        case HME.begin:
+          this.opts.debug &&
+          L( M2C( this.msgs.begin.msg, dbgStyle), evt.cmd.toUpperCase() );
+          break;
+
+        case HME.error:
+          break;
+
+        case HME.beforeCreate:
+          L( M2C( this.msgs.beforeCreate.msg, 'green' ), evt.fmt, evt.file );
+          break;
+
+        case HME.beforeRead:
+          break;
+
+        case HME.afterRead:
+          break;
+
+        case HME.beforeTheme:
+          this.opts.debug &&
+            L( M2C( this.msgs.beforeTheme.msg, dbgStyle), evt.theme.toUpperCase() );
+          break;
+
+        case HME.afterParse:
+          L(
+            M2C( this.msgs.afterRead.msg, 'gray', 'white.dim'), evt.fmt.toUpperCase(), evt.file
+          );
+
+          break;
+
+        case HME.afterTheme:
+          break;
+
+        case HME.beforeMerge:
+          var msg = '';
+          evt.f.reverse().forEach( function( a, idx ) {
+            msg += printf(
+              ((idx === 0) ?
+                this.msgs.beforeMerge.msg[0] :
+                this.msgs.beforeMerge.msg[1] ), a.file
+            );
+          }, this);
+          L( M2C(msg, evt.mixed ? 'yellow' : 'gray', 'white.dim') );
+          break;
+
+        case HME.afterMerge:
+          break;
+
+        case HME.applyTheme:
+          this.theme = evt.theme;
+          var numFormats = Object.keys( evt.theme.formats ).length;
+          L( M2C(this.msgs.applyTheme.msg, evt.status === 'error' ? 'red' : 'gray', evt.status === 'error' ? 'bold' : 'white.dim'),
+            evt.theme.name.toUpperCase(),
+            numFormats, ( numFormats === 1 ? '' : 's') );
+          break;
+
+        case HME.end:
+          if( evt.cmd === 'build' ) {
+            var themeName = this.theme.name.toUpperCase();
+            if( this.opts.tips && (this.theme.message || this.theme.render) ) {
+              var WRAP = require('word-wrap');
+              if( this.theme.message ) {
+                L( M2C( this.msgs.afterBuild.msg[0], 'cyan' ), themeName );
+                L( M2C( this.theme.message, 'white' ));
+              }
+              else if ( this.theme.render ) {
+                L( M2C( this.msgs.afterBuild.msg[0], 'cyan'), themeName);
+                L( M2C( this.msgs.afterBuild.msg[1], 'white'));
+              }
+            }
+          }
+          break;
+
+        case HME.afterGenerate:
+          var suffix = '';
+          if( evt.fmt === 'pdf' ) {
+            if( this.opts.pdf ) {
+              if( this.opts.pdf !== 'none' ) {
+                suffix = printf( M2C( this.msgs.afterGenerate.msg[0], evt.error ? 'red' : 'green' ), this.opts.pdf );
+              }
+              else {
+                L( M2C( this.msgs.afterGenerate.msg[1], 'gray' ),
+                  evt.fmt.toUpperCase(), evt.file );
+                return;
+              }
+            }
+          }
+
+          L( M2C( this.msgs.afterGenerate.msg[2] + suffix, evt.error ? 'red' : 'green' ),
+              pad(evt.fmt.toUpperCase(),4,null,pad.RIGHT),
+              PATH.relative(process.cwd(), evt.file ));
+          break;
+
+        case HME.beforeAnalyze:
+          L( M2C( this.msgs.beforeAnalyze.msg, 'green' ), evt.fmt, evt.file);
+          break;
+
+        case HME.afterAnalyze:
+          var info = evt.info;
+          var rawTpl = FS.readFileSync( PATH.join( __dirname, 'analyze.hbs' ), 'utf8');
+          HANDLEBARS.registerHelper( require('../helpers/console-helpers') );
+          var template = HANDLEBARS.compile(rawTpl, { strict: false, assumeObjects: false });
+          var tot = 0;
+          info.keywords.forEach(function(g) { tot += g.count; });
+          info.keywords.totalKeywords = tot;
+          var output = template( info );
+          this.log( chalk.cyan(output) );
+          break;
+
+        case HME.beforeConvert:
+          L( M2C( this.msgs.beforeConvert.msg, 'green' ),
+            evt.srcFile, evt.srcFmt, evt.dstFile, evt.dstFmt
+          );
+          break;
+
+        case HME.afterInlineConvert:
+          L( M2C( this.msgs.afterInlineConvert.msg, 'gray', 'white.dim' ),
+            evt.file, evt.fmt );
+          break;
+
+        case HME.afterValidate:
+          var style = evt.isValid ? 'green' : 'yellow';
+          L(
+            M2C( this.msgs.afterValidate.msg[0], 'white' ) +
+            chalk[style].bold( evt.isValid ?
+                               this.msgs.afterValidate.msg[1] :
+                               this.msgs.afterValidate.msg[2] ),
+            evt.file, evt.fmt
+          );
+
+          if( evt.errors ) {
+            _.each(evt.errors, function(err,idx) {
+              L( chalk.yellow.bold('--> ') +
+                chalk.yellow(err.field.replace('data.','resume.').toUpperCase() + ' ' +
+                err.message) );
+            }, this);
+          }
+          break;
+
+        case HME.beforePeek:
+          // if( evt.target )
+          //   L(M2C(this.msgs.beforePeek.msg[0], evt.isError ? 'red' : 'green'), evt.target, evt.file);
+          // else
+          //   L(M2C(this.msgs.beforePeek.msg[1], evt.isError ? 'red' : 'green'), evt.file);
+          break;
+
+        case HME.afterPeek:
+          var sty = evt.error ? 'red' : ( evt.target !== undefined ? 'green' : 'yellow' );
+          if( evt.requested )
+            L(M2C(this.msgs.beforePeek.msg[0], sty), evt.requested, evt.file);
+          else
+            L(M2C(this.msgs.beforePeek.msg[1], sty), evt.file);
+
+          if( evt.target !== undefined )
+            console.dir( evt.target, { depth: null, colors: true } );
+          else if( !evt.error )
+            L(M2C( this.msgs.afterPeek.msg, 'yellow'), evt.requested, evt.file);
+          break;
+
+      }
+    }
+
+
+
+  });
+
+
+}());

src/cli/use.txt

@@ -0,0 +1,51 @@
+Usage:
+
+  hackmyresume <command> <sources> [TO <targets>] [<options>]
+
+Available commands:
+
+  BUILD         Build your resume to the destination format(s).
+  ANALYZE       Analyze your resume for keywords, gaps, and metrics.
+  VALIDATE      Validate your resume for errors and typos.
+  CONVERT       Convert your resume between FRESH and JSON Resume.
+  NEW           Create a new resume in FRESH or JSON Resume format.
+  PEEK          View a specific field or element on your resume.
+
+Available options:
+
+  --theme -t    Path to a FRESH or JSON Resume theme.
+  --pdf -p      Specify the PDF engine to use (wkhtmltopdf or phantom).
+  --options -o  Load options from an external JSON file.
+  --format -f   The format (FRESH or JSON Resume) to use.
+  --debug -d    Emit extended debugging info.
+  --assert -a   Treat resume validation warnings as errors.
+  --no-colors   Disable terminal colors.
+  --tips        Display theme messages and tips.
+  --help -h     Display help documentation.
+  --version -v  Display the current version.
+
+Not all options are supported for all commands. For example, the
+--theme option is only supported for the BUILD command.
+
+Examples:
+
+  hackmyresume  BUILD resume.json TO out/resume.all --theme modern
+  hackmyresume  ANALYZE resume.json
+  hackmyresume  NEW my-new-resume.json --format JRS
+  hackmyresume  CONVERT resume-fresh.json TO resume-jrs.json
+  hackmyresume  VALIDATE resume.json
+  hackmyresume  PEEK resume.json employment[2].summary
+
+Tips:
+
+  - You can specify multiple sources and/or targets for all commands.
+  - You can use any FRESH or JSON Resume theme with HackMyResume.
+  - Specify a file extension of .all to generate your resume to all
+    available formats supported by the theme. (BUILD command.)
+  - The --theme parameter can specify either the name of a preinstalled
+    theme, or the path to a local FRESH or JSON Resume theme.
+  - Visit https://www.npmjs.com/search?q=jsonresume-theme for a full
+    listing of all available JSON Resume themes.
+  - Visit https://github.com/fluentdesk/fresh-themes for a complete
+    listing of all available FRESH themes.
+  - Report bugs to https://githut.com/hacksalot/HackMyResume/issues.

src/core/convert.js

@@ -1,419 +0,0 @@
-/**
-FRESH to JSON Resume conversion routiens.
-@license MIT. See LICENSE.md for details.
-@module convert.js
-*/
-
-
-
-(function(){ // TODO: refactor everything
-
-
-
-  var _ = require('underscore');
-
-
-
-  /**
-  Convert between FRESH and JRS resume/CV formats.
-  @class FRESHConverter
-  */
-  var FRESHConverter = module.exports = {
-
-
-
-    /**
-    Convert from JSON Resume format to FRESH.
-    @method toFresh
-    @todo Refactor
-    */
-    toFRESH: function( src, foreign ) {
-
-      foreign = (foreign === undefined || foreign === null) ? true : foreign;
-
-      return {
-        name: src.basics.name,
-        imp: src.basics.imp,
-        info: {
-          label: src.basics.label,
-          class: src.basics.class, // <--> round-trip
-          image: src.basics.picture,
-          brief: src.basics.summary
-        },
-        contact: {
-          email: src.basics.email,
-          phone: src.basics.phone,
-          website: src.basics.website,
-          other: src.basics.other // <--> round-trip
-        },
-        meta: meta( true, src.meta ),
-        location: {
-          city: src.basics.location.city,
-          region: src.basics.location.region,
-          country: src.basics.location.countryCode,
-          code: src.basics.location.postalCode,
-          address: src.basics.location.address
-        },
-        employment: employment( src.work, true ),
-        education: education( src.education, true),
-        service: service( src.volunteer, true),
-        skills: skillsToFRESH( src.skills ),
-        writing: writing( src.publications, true),
-        recognition: recognition( src.awards, true, foreign ),
-        social: social( src.basics.profiles, true ),
-        interests: src.interests,
-        testimonials: references( src.references, true ),
-        languages: src.languages,
-        disposition: src.disposition // <--> round-trip
-      };
-    },
-
-
-
-    /**
-    Convert from FRESH format to JSON Resume.
-    @param foreign True if non-JSON-Resume properties should be included in
-    the result, false if those properties should be excluded.
-    @todo Refactor
-    */
-    toJRS: function( src, foreign ) {
-
-      foreign = (foreign === undefined || foreign === null) ? false : foreign;
-
-      return {
-        basics: {
-          name: src.name,
-          label: src.info.label,
-          class: foreign ? src.info.class : undefined,
-          summary: src.info.brief,
-          website: src.contact.website,
-          phone: src.contact.phone,
-          email: src.contact.email,
-          picture: src.info.image,
-          location: {
-            address: src.location.address,
-            postalCode: src.location.code,
-            city: src.location.city,
-            countryCode: src.location.country,
-            region: src.location.region
-          },
-          profiles: social( src.social, false ),
-          imp: src.imp
-        },
-        work: employment( src.employment, false ),
-        education: education( src.education, false ),
-        skills: skillsToJRS( src.skills, false ),
-        volunteer: service( src.service, false ),
-        awards: recognition( src.recognition, false, foreign ),
-        publications: writing( src.writing, false ),
-        interests: src.interests,
-        references: references( src.testimonials, false ),
-        samples: foreign ? src.samples : undefined,
-        disposition: foreign ? src.disposition : undefined,
-        languages: src.languages
-      };
-
-    },
-
-
-
-    toSTRING: function( src ) {
-      function replacerJRS( key,value ) { // Exclude these keys
-        return _.some(['imp', 'warnings', 'computed', 'filt', 'ctrl', 'index',
-          'safeStartDate', 'safeEndDate', 'safeDate', 'safeReleaseDate',
-          'result', 'isModified', 'htmlPreview', 'display_progress_bar'],
-          function( val ) { return key.trim() === val; }
-        ) ? undefined : value;
-      }
-      function replacerFRESH( key,value ) { // Exclude these keys
-        return _.some(['imp', 'warnings', 'computed', 'filt', 'ctrl', 'index',
-          'safe', 'result', 'isModified', 'htmlPreview', 'display_progress_bar'],
-          function( val ) { return key.trim() === val; }
-        ) ? undefined : value;
-      }
-
-      return JSON.stringify( src, src.basics ? replacerJRS : replacerFRESH, 2 );
-    }
-
-  };
-
-
-
-  function meta( direction, obj ) {
-    //if( !obj ) return obj; // preserve null and undefined
-    if( direction ) {
-      obj = obj || { };
-      obj.format = obj.format || "FRESH@0.1.0";
-      obj.version = obj.version || "0.1.0";
-    }
-    return obj;
-  }
-
-
-
-  function employment( obj, direction ) {
-    if( !obj ) return obj;
-    if( !direction ) {
-      return obj && obj.history ?
-        obj.history.map(function(emp){
-          return {
-            company: emp.employer,
-            website: emp.url,
-            position: emp.position,
-            startDate: emp.start,
-            endDate: emp.end,
-            summary: emp.summary,
-            highlights: emp.highlights
-          };
-        }) : undefined;
-    }
-    else {
-      return {
-        history: obj && obj.length ?
-          obj.map( function( job ) {
-            return {
-              position: job.position,
-              employer: job.company,
-              summary: job.summary,
-              current: (!job.endDate || !job.endDate.trim() ||
-                job.endDate.trim().toLowerCase() === 'current') || undefined,
-              start: job.startDate,
-              end: job.endDate,
-              url: job.website,
-              keywords: [],
-              highlights: job.highlights
-            };
-          }) : undefined
-      };
-    }
-  }
-
-
-
-  function education( obj, direction ) {
-    if( !obj ) return obj;
-    if( direction ) {
-      return obj && obj.length ? {
-        level: "",
-        history: obj.map(function(edu){
-          return {
-            institution: edu.institution,
-            start: edu.startDate,
-            end: edu.endDate,
-            grade: edu.gpa,
-            curriculum: edu.courses,
-            url: edu.website || edu.url || undefined,
-            summary: edu.summary || "",
-            area: edu.area,
-            studyType: edu.studyType
-          };
-        })
-      } : undefined;
-    }
-    else {
-      return obj && obj.history ?
-        obj.history.map(function(edu){
-          return {
-            institution: edu.institution,
-            gpa: edu.grade,
-            courses: edu.curriculum,
-            startDate: edu.start,
-            endDate: edu.end,
-            area: edu.area,
-            studyType: edu.studyType
-          };
-        }) : undefined;
-    }
-  }
-
-
-
-  function service( obj, direction, foreign ) {
-    if( !obj ) return obj;
-    if( direction ) {
-      return {
-        history: obj && obj.length ? obj.map(function(vol) {
-          return {
-            type: 'volunteer',
-            position: vol.position,
-            organization: vol.organization,
-            start: vol.startDate,
-            end: vol.endDate,
-            url: vol.website,
-            summary: vol.summary,
-            highlights: vol.highlights
-          };
-        }) : undefined
-      };
-    }
-    else {
-      return obj && obj.history ?
-        obj.history.map(function(srv){
-          return {
-            flavor: foreign ? srv.flavor : undefined,
-            organization: srv.organization,
-            position: srv.position,
-            startDate: srv.start,
-            endDate: srv.end,
-            website: srv.url,
-            summary: srv.summary,
-            highlights: srv.highlights
-          };
-        }) : undefined;
-    }
-  }
-
-
-
-  function social( obj, direction ) {
-    if( !obj ) return obj;
-    if( direction ) {
-      return obj.map(function(pro){
-        return {
-          label: pro.network,
-          network: pro.network,
-          url: pro.url,
-          user: pro.username
-        };
-      });
-    }
-    else {
-      return obj.map( function( soc ) {
-        return {
-          network: soc.network,
-          username: soc.user,
-          url: soc.url
-        };
-      });
-    }
-  }
-
-
-
-  function recognition( obj, direction, foreign ) {
-    if( !obj ) return obj;
-    if( direction ) {
-      return obj && obj.length ? obj.map(
-        function(awd){
-          return {
-            flavor: foreign ? awd.flavor : undefined,
-            url: foreign ? awd.url: undefined,
-            title: awd.title,
-            date: awd.date,
-            from: awd.awarder,
-            summary: awd.summary
-          };
-      }) : undefined;
-    }
-    else {
-      return obj && obj.length ? obj.map(function(awd){
-        return {
-          flavor: foreign ? awd.flavor : undefined,
-          url: foreign ? awd.url: undefined,
-          title: awd.title,
-          date: awd.date,
-          awarder: awd.from,
-          summary: awd.summary
-        };
-      }) : undefined;
-    }
-  }
-
-
-
-  function references( obj, direction ) {
-    if( !obj ) return obj;
-    if( direction ) {
-      return obj && obj.length && obj.map(function(ref){
-        return {
-          name: ref.name,
-          flavor: 'professional',
-          quote: ref.reference,
-          private: false
-        };
-      });
-    }
-    else {
-      return obj && obj.length && obj.map(function(ref){
-        return {
-          name: ref.name,
-          reference: ref.quote
-        };
-      });
-    }
-  }
-
-
-
-  function writing( obj, direction ) {
-    if( !obj ) return obj;
-    if( direction ) {
-      return obj.map(function( pub ) {
-        return {
-          title: pub.name,
-          flavor: undefined,
-          publisher: pub.publisher,
-          url: pub.website,
-          date: pub.releaseDate,
-          summary: pub.summary
-        };
-      });
-    }
-    else {
-      return obj && obj.length ? obj.map(function(pub){
-        return {
-          name: pub.title,
-          publisher: pub.publisher &&
-            pub.publisher.name ? pub.publisher.name : pub.publisher,
-          releaseDate: pub.date,
-          website: pub.url,
-          summary: pub.summary
-        };
-      }) : undefined;
-    }
-  }
-
-
-
-  function skillsToFRESH( skills ) {
-    if( !skills ) return skills;
-    return {
-      sets: skills.map(function( set ) {
-        return {
-          name: set.name,
-          level: set.level,
-          skills: set.keywords
-        };
-      })
-    };
-  }
-
-
-
-  function skillsToJRS( skills ) {
-    if( !skills ) return skills;
-    var ret = [];
-    if( skills.sets && skills.sets.length ) {
-      ret = skills.sets.map(function(set){
-        return {
-          name: set.name,
-          level: set.level,
-          keywords: set.skills
-        };
-      });
-    }
-    else if( skills.list ) {
-      ret = skills.list.map(function(sk){
-        return {
-          name: sk.name,
-          level: sk.level,
-          keywords: sk.keywords
-        };
-      });
-    }
-    return ret;
-  }
-
-
-
-}());

src/core/default-formats.js

@@ -1,21 +0,0 @@
-(function(){
-
-  /**
-  Supported resume formats.
-  */
-
-  module.exports = [
-
-    { name: 'html', ext: 'html', gen: new (require('../gen/html-generator'))() },
-    { name: 'txt',  ext: 'txt', gen: new (require('../gen/text-generator'))()  },
-    { name: 'doc',  ext: 'doc',  fmt: 'xml', gen: new (require('../gen/word-generator'))() },
-    { name: 'pdf',  ext: 'pdf', fmt: 'html', is: false, gen: new (require('../gen/html-pdf-generator'))() },
-    { name: 'png',  ext: 'png', fmt: 'html', is: false, gen: new (require('../gen/html-png-generator'))() },
-    { name: 'md', ext: 'md', fmt: 'txt', gen: new (require('../gen/markdown-generator'))() },
-    { name: 'json', ext: 'json', gen: new (require('../gen/json-generator'))() },
-    { name: 'yml', ext: 'yml', fmt: 'yml', gen: new (require('../gen/json-yaml-generator'))() },
-    { name: 'latex', ext: 'tex', fmt: 'latex', gen: new (require('../gen/latex-generator'))() }
-
-  ];
-
-}());

src/core/default-options.js

@@ -1,13 +0,0 @@
-(function(){
-
-  module.exports = {
-    theme: 'modern',
-    prettify: { // ← See https://github.com/beautify-web/js-beautify#options
-      indent_size: 2,
-      unformatted: ['em','strong'],
-      max_char: 80, // ← See lib/html.js in above-linked repo
-      //wrap_line_length: 120, ← Don't use this
-    }
-  };
-
-}());

src/core/empty-jrs.json

@@ -1,77 +0,0 @@
-{
-  "basics": {
-    "name": "",
-    "label": "",
-    "picture": "",
-    "email": "",
-    "phone": "",
-    "degree": "",
-    "website": "",
-    "summary": "",
-    "location": {
-      "address": "",
-      "postalCode": "",
-      "city": "",
-      "countryCode": "",
-      "region": ""
-    },
-    "profiles": [{
-      "network": "",
-      "username": "",
-      "url": ""
-    }]
-  },
-
-  "work": [{
-    "company": "",
-    "position": "",
-    "website": "",
-    "startDate": "",
-    "endDate": "",
-    "summary": "",
-    "highlights": [
-      ""
-    ]
-  }],
-
-  "awards": [{
-    "title": "",
-    "date": "",
-    "awarder": "",
-    "summary": ""
-  }],
-
-  "education": [{
-    "institution": "",
-    "area": "",
-    "studyType": "",
-    "startDate": "",
-    "endDate": "",
-    "gpa": "",
-    "courses": [ "" ]
-  }],
-
-  "publications": [{
-    "name": "",
-    "publisher": "",
-    "releaseDate": "",
-    "website": "",
-    "summary": ""
-  }],
-
-  "volunteer": [{
-    "organization": "",
-    "position": "",
-    "website": "",
-    "startDate": "",
-    "endDate": "",
-    "summary": "",
-    "highlights": [ "" ]
-  }],
-
-  "skills": [{
-      "name": "",
-      "level": "",
-      "keywords": [""]
-  }]
-}

src/core/error-handler.js

@@ -1,128 +0,0 @@
-/**
-Error-handling routines for HackMyResume.
-@module error-handler.js
-@license MIT. See LICENSE.md for details.
-*/
-
-
-
-(function() {
-
-
-
-  var HACKMYSTATUS = require('./status-codes')
-    , PKG = require('../../package.json')
-    , FS = require('fs')
-    , FCMD = require('../hackmyapi')
-    , PATH = require('path')
-    , chalk = require('chalk');
-
-
-
-  /**
-  An amorphous blob of error handling code for HackMyResume.
-  @class ErrorHandler
-  */
-  var ErrorHandler = module.exports = {
-
-
-
-    err: function( ex, shouldExit ) {
-      var msg = '', exitCode;
-
-      if( ex.handled ) {
-        if( shouldExit )
-          process.exit( exitCode );
-        return;
-      }
-
-
-      if( ex.fluenterror ){
-
-        switch( ex.fluenterror ) {
-
-          case HACKMYSTATUS.themeNotFound:
-            msg = "The specified theme couldn't be found: " + ex.data;
-            break;
-
-          case HACKMYSTATUS.copyCSS:
-            msg = "Couldn't copy CSS file to destination folder";
-            break;
-
-          case HACKMYSTATUS.resumeNotFound:
-            msg = chalk.yellow('Please ') + chalk.yellow.bold('feed me a resume') +
-              chalk.yellow(' in FRESH or JSON Resume format.');
-            break;
-
-          case HACKMYSTATUS.missingCommand:
-            msg = chalk.yellow("Please ") + chalk.yellow.bold("give me a command") +
-              chalk.yellow(" (");
-
-            msg += Object.keys( FCMD.verbs ).map( function(v, idx, ar) {
-              return (idx === ar.length - 1 ? chalk.yellow('or ') : '') +
-                chalk.yellow.bold(v.toUpperCase());
-            }).join( chalk.yellow(', ')) + chalk.yellow(").\n\n");
-
-            msg += chalk.gray(FS.readFileSync( PATH.resolve(__dirname, '../use.txt'), 'utf8' ));
-            break;
-
-          case HACKMYSTATUS.invalidCommand:
-            msg = chalk.yellow('Invalid command: "') + chalk.yellow.bold(ex.attempted) + chalk.yellow('"');
-            break;
-
-          case HACKMYSTATUS.resumeNotFoundAlt:
-            msg = chalk.yellow('Please ') + chalk.yellow.bold('feed me a resume') +
-              chalk.yellow(' in either FRESH or JSON Resume format.');
-            break;
-
-          case HACKMYSTATUS.inputOutputParity:
-            msg = chalk.yellow('Please ') + chalk.yellow.bold('specify an output file name') +
-              chalk.yellow(' for every input file you wish to convert.');
-            break;
-
-          case HACKMYSTATUS.createNameMissing:
-            msg = chalk.yellow('Please ') + chalk.yellow.bold('specify the filename of the resume') +
-              chalk.yellow(' to create.');
-            break;
-
-          case HACKMYSTATUS.wkhtmltopdf:
-            msg = chalk.red.bold('ERROR: PDF generation failed. ') + chalk.red('Make sure wkhtmltopdf is ' +
-            'installed and accessible from your path.');
-            break;
-
-          case HACKMYSTATUS.invalid:
-            msg = chalk.red.bold('ERROR: Validation failed and the --assert option was specified.');
-            break;
-        }
-        exitCode = ex.fluenterror;
-
-      }
-      else {
-        msg = ex.toString();
-        exitCode = 4;
-      }
-
-      // Deal with pesky 'Error:' prefix.
-      var idx = msg.indexOf('Error: ');
-      var trimmed = idx === -1 ? msg : msg.substring( idx + 7 );
-
-      // If this is an unhandled error, or a specific class of handled error,
-      // output the error message and stack.
-      if( !ex.fluenterror || ex.fluenterror < 3 ) { // TODO: magic #s
-        console.log( chalk.red.bold('ERROR: ' + trimmed.toString()) );
-        if( ex.code !== 'ENOENT' ) // Don't emit stack for common stuff
-          console.log( chalk.gray(ex.stack) );
-      }
-      else {
-        console.log( trimmed.toString() );
-      }
-
-      // Let the error code be the process's return code.
-      if( shouldExit || ex.shouldExit )
-        process.exit( exitCode );
-
-    }
-
-  };
-
-}());

src/core/fluent-date.js

@@ -1,84 +0,0 @@
-/**
-The HackMyResume date representation.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module fluent-date.js
-*/
-
-var moment = require('moment');
-
-/**
-Create a FluentDate from a string or Moment date object. There are a few date
-formats to be aware of here.
-1. The words "Present" and "Now", referring to the current date
-2. The default "YYYY-MM-DD" format used in JSON Resume ("2015-02-10")
-3. Year-and-month only ("2015-04")
-4. Year-only "YYYY" ("2015")
-5. The friendly HackMyResume "mmm YYYY" format ("Mar 2015" or "Dec 2008")
-6. Empty dates ("", " ")
-7. Any other date format that Moment.js can parse from
-Note: Moment can transparently parse all or most of these, without requiring us
-to specify a date format...but for maximum parsing safety and to avoid Moment
-deprecation warnings, it's recommended to either a) explicitly specify the date
-format or b) use an ISO format. For clarity, we handle these cases explicitly.
-@class FluentDate
-*/
-function FluentDate( dt ) {
-  this.rep = this.fmt( dt );
-}
-
-FluentDate/*.prototype*/.fmt = function( dt ) {
-  if( (typeof dt === 'string' || dt instanceof String) ) {
-    dt = dt.toLowerCase().trim();
-    if( /^(present|now|current)$/.test(dt) ) { // "Present", "Now"
-      return moment();
-    }
-    else if( /^\D+\s+\d{4}$/.test(dt) ) { // "Mar 2015"
-      var parts = dt.split(' ');
-      var month = (months[parts[0]] || abbr[parts[0]]);
-      var temp = parts[1] + '-' + (month < 10 ? '0' + month : month.toString());
-      return moment( temp, 'YYYY-MM' );
-    }
-    else if( /^\d{4}-\d{1,2}$/.test(dt) ) { // "2015-03", "1998-4"
-      return moment( dt, 'YYYY-MM' );
-    }
-    else if( /^\s*\d{4}\s*$/.test(dt) ) { // "2015"
-      return moment( dt, 'YYYY' );
-    }
-    else if( /^\s*$/.test(dt) ) { // "", " "
-      var defTime = {
-        isNull: true,
-        isBefore: function( other ) {
-          return( other && !other.isNull ) ? true : false;
-        },
-        isAfter: function( other ) {
-          return( other && !other.isNull ) ? false : false;
-        },
-        unix: function() { return 0; },
-        format: function() { return ''; },
-        diff: function() { return 0; }
-      };
-      return defTime;
-    }
-    else {
-      var mt = moment( dt );
-      if(mt.isValid())
-        return mt;
-      throw 'Invalid date format encountered.';
-    }
-  }
-  else {
-    if( !dt ) {
-      return moment();
-    }
-    else if( dt.isValid && dt.isValid() )
-      return dt;
-    throw 'Unknown date object encountered.';
-  }
-};
-
-var months = {}, abbr = {};
-moment.months().forEach(function(m,idx){months[m.toLowerCase()]=idx+1;});
-moment.monthsShort().forEach(function(m,idx){abbr[m.toLowerCase()]=idx+1;});
-abbr.sept = 9;
-
-module.exports = FluentDate;

src/core/fresh-resume.js

@@ -1,539 +0,0 @@
-/**
-Definition of the FRESHResume class.
-@license MIT. See LICENSE .md for details.
-@module fresh-resume.js
-*/
-
-
-
-(function() {
-
-
-
-  var FS = require('fs')
-    , extend = require('../utils/extend')
-    , validator = require('is-my-json-valid')
-    , _ = require('underscore')
-    , __ = require('lodash')
-    , PATH = require('path')
-    , moment = require('moment')
-    , XML = require('xml-escape')
-    , MD = require('marked')
-    , CONVERTER = require('./convert')
-    , JRSResume = require('./jrs-resume');
-
-
-
-  /**
-  A FRESH resume or CV. FRESH resumes are backed by JSON, and each FreshResume
-  object is an instantiation of that JSON decorated with utility methods.
-  @class FreshResume
-  */
-  function FreshResume() {
-
-  }
-
-
-
-  /**
-  Initialize the FreshResume from file.
-  */
-  FreshResume.prototype.open = function( file, title ) {
-    this.imp = { fileName: file };
-    this.imp.raw = FS.readFileSync( file, 'utf8' );
-    return this.parse( this.imp.raw, title );
-  };
-
-
-
-  /**
-  Initialize the the FreshResume from string.
-  */
-  FreshResume.prototype.parse = function( stringData, opts ) {
-    return this.parseJSON( JSON.parse( stringData ), opts );
-  };
-
-
-
-  /**
-  Initialize the FreshResume from JSON.
-  Open and parse the specified FRESH resume. Merge the JSON object model onto
-  this Sheet instance with extend() and convert sheet dates to a safe &
-  consistent format. Then sort each section by startDate descending.
-  */
-  FreshResume.prototype.parseJSON = function( rep, opts ) {
-    // Convert JSON Resume to FRESH if necessary
-    if( rep.basics ) {
-      rep = CONVERTER.toFRESH( rep );
-      rep.imp = rep.imp || { };
-      rep.imp.orgFormat = 'JRS';
-    }
-
-    // Now apply the resume representation onto this object
-    extend( true, this, rep );
-
-    // Set up metadata
-    opts = opts || { };
-    if( opts.imp === undefined || opts.imp ) {
-      this.imp = this.imp || { };
-      this.imp.title = (opts.title || this.imp.title) || this.name;
-    }
-    // Parse dates, sort dates, and calculate computed values
-    (opts.date === undefined || opts.date) && _parseDates.call( this );
-    (opts.sort === undefined || opts.sort) && this.sort();
-    (opts.compute === undefined || opts.compute) && (this.computed = {
-       numYears: this.duration(),
-       keywords: this.keywords()
-    });
-    return this;
-  };
-
-
-
-  /**
-  Save the sheet to disk (for environments that have disk access).
-  */
-  FreshResume.prototype.save = function( filename ) {
-    this.imp.fileName = filename || this.imp.fileName;
-    FS.writeFileSync( this.imp.fileName, this.stringify(), 'utf8' );
-    return this;
-  };
-
-
-
-  /**
-  Save the sheet to disk in a specific format, either FRESH or JSON Resume.
-  */
-  FreshResume.prototype.saveAs = function( filename, format ) {
-
-    if( format !== 'JRS' ) {
-      this.imp.fileName = filename || this.imp.fileName;
-      FS.writeFileSync( this.imp.fileName, this.stringify(), 'utf8' );
-    }
-    else {
-      var newRep = CONVERTER.toJRS( this );
-      FS.writeFileSync( filename, JRSResume.stringify( newRep ), 'utf8' );
-    }
-    return this;
-  };
-
-
-
-  /**
-  Duplicate this FreshResume instance.
-  */
-  FreshResume.prototype.dupe = function() {
-    var rnew = new FreshResume();
-    rnew.parse( this.stringify(), { } );
-    return rnew;
-  };
-
-
-
-  /**
-  Convert the supplied FreshResume to a JSON string, sanitizing meta-properties
-  along the way.
-  */
-  FreshResume.stringify = function( obj ) {
-    function replacer( key,value ) { // Exclude these keys from stringification
-      return _.some(['imp', 'warnings', 'computed', 'filt', 'ctrl', 'index',
-        'safe', 'result', 'isModified', 'htmlPreview', 'display_progress_bar'],
-        function( val ) { return key.trim() === val; }
-      ) ? undefined : value;
-    }
-    return JSON.stringify( obj, replacer, 2 );
-  };
-
-
-
-  /**
-  Convert this object to a JSON string, sanitizing meta-properties along the
-  way.
-  */
-  FreshResume.prototype.stringify = function() {
-    return FreshResume.stringify( this );
-  };
-
-
-
-  /**
-  Create a copy of this resume in which all string fields have been run through
-  a transformation function (such as a Markdown filter or XML encoder).
-  */
-  FreshResume.prototype.transformStrings = function( filt, transformer ) {
-
-    var that = this;
-    var ret = this.dupe();
-
-    // TODO: refactor recursion
-    function transformStringsInObject( obj, filters ) {
-
-      if( !obj ) return;
-      if( moment.isMoment( obj ) ) return;
-
-      if( _.isArray( obj ) ) {
-        obj.forEach( function(elem, idx, ar) {
-          if( typeof elem === 'string' || elem instanceof String )
-            ar[idx] = transformer( null, elem );
-          else if (_.isObject(elem))
-            transformStringsInObject( elem, filters );
-        });
-      }
-      else if (_.isObject( obj )) {
-        Object.keys( obj ).forEach(function(k) {
-          if( filters.length && _.contains(filters, k) )
-            return;
-          var sub = obj[k];
-          if( typeof sub === 'string' || sub instanceof String ) {
-            obj[k] = transformer( k, sub );
-          }
-          else if (_.isObject( sub ))
-            transformStringsInObject( sub, filters );
-        });
-      }
-
-    }
-
-    Object.keys( ret ).forEach(function(member){
-      if( !filt || !filt.length || !_.contains(filt, member) )
-        transformStringsInObject( ret[ member ], filt || [] );
-    });
-
-    return ret;
-  };
-
-
-
-  /**
-  Create a copy of this resume in which all fields have been interpreted as
-  Markdown.
-  */
-  FreshResume.prototype.markdownify = function() {
-
-    function MDIN( txt ){
-      return MD(txt || '' ).replace(/^\s*<p>|<\/p>\s*$/gi, '');
-    }
-
-    function trx(key, val) {
-      if( key === 'summary' ) {
-        return MD(val);
-      }
-      return MDIN(val);
-    }
-
-    return this.transformStrings( ['skills','url','start','end','date'], trx );
-  };
-
-
-
-  /**
-  Create a copy of this resume in which all fields have been interpreted as
-  Markdown.
-  */
-  FreshResume.prototype.xmlify = function() {
-    function trx(key, val) {
-      return XML(val);
-    }
-    return this.transformStrings( [], trx );
-  };
-
-
-
-  /**
-  Return the resume format.
-  */
-  FreshResume.prototype.format = function() {
-    return 'FRESH';
-  };
-
-
-
-  /**
-  Return internal metadata. Create if it doesn't exist.
-  */
-  FreshResume.prototype.i = function() {
-    this.imp = (this.imp || { });
-    return this.imp;
-  };
-
-
-
-  /**
-  Return a unique list of all keywords across all skills.
-  */
-  FreshResume.prototype.keywords = function() {
-    var flatSkills = [];
-    if( this.skills ) {
-      if( this.skills.sets ) {
-        flatSkills = this.skills.sets.map(function(sk) { return sk.skills;  })
-          .reduce(function(a,b) { return a.concat(b); });
-      }
-      else if( this.skills.list ) {
-        flatSkills = flatSkills.concat( this.skills.list.map(function(sk) {
-          return sk.name;
-        }));
-      }
-      flatSkills = _.uniq( flatSkills );
-    }
-    return flatSkills;
-  },
-
-
-
-  /**
-  Reset the sheet to an empty state. TODO: refactor/review
-  */
-  FreshResume.prototype.clear = function( clearMeta ) {
-    clearMeta = ((clearMeta === undefined) && true) || clearMeta;
-    clearMeta && (delete this.imp);
-    delete this.computed; // Don't use Object.keys() here
-    delete this.employment;
-    delete this.service;
-    delete this.education;
-    delete this.recognition;
-    delete this.reading;
-    delete this.writing;
-    delete this.interests;
-    delete this.skills;
-    delete this.social;
-  };
-
-
-
-  /**
-  Get a safe count of the number of things in a section.
-  */
-  FreshResume.prototype.count = function( obj ) {
-    if( !obj ) return 0;
-    if( obj.history ) return obj.history.length;
-    if( obj.sets ) return obj.sets.length;
-    return obj.length || 0;
-  };
-
-
-
-  /**
-  Get the default (starter) sheet.
-  */
-  FreshResume.default = function() {
-    return new FreshResume().parseJSON( require('fresh-resume-starter')  );
-  };
-
-
-
-  /**
-  Add work experience to the sheet.
-  */
-  FreshResume.prototype.add = function( moniker ) {
-    var defSheet = FreshResume.default();
-    var newObject = defSheet[moniker].history ?
-      $.extend( true, {}, defSheet[ moniker ].history[0] ) :
-      (moniker === 'skills' ?
-        $.extend( true, {}, defSheet.skills.sets[0] ) :
-        $.extend( true, {}, defSheet[ moniker ][0] ));
-    this[ moniker ] = this[ moniker ] || [];
-    if( this[ moniker ].history )
-      this[ moniker ].history.push( newObject );
-    else if( moniker === 'skills' )
-      this.skills.sets.push( newObject );
-    else
-      this[ moniker ].push( newObject );
-    return newObject;
-  };
-
-
-
-  /**
-  Determine if the sheet includes a specific social profile (eg, GitHub).
-  */
-  FreshResume.prototype.hasProfile = function( socialNetwork ) {
-    socialNetwork = socialNetwork.trim().toLowerCase();
-    return this.social && _.some( this.social, function(p) {
-      return p.network.trim().toLowerCase() === socialNetwork;
-    });
-  };
-
-
-
-  /**
-  Return the specified network profile.
-  */
-  FreshResume.prototype.getProfile = function( socialNetwork ) {
-    socialNetwork = socialNetwork.trim().toLowerCase();
-    return this.social && _.find( this.social, function(sn) {
-      return sn.network.trim().toLowerCase() === socialNetwork;
-    });
-  };
-
-
-
-  /**
-  Return an array of profiles for the specified network, for when the user
-  has multiple eg. GitHub accounts.
-  */
-  FreshResume.prototype.getProfiles = function( socialNetwork ) {
-    socialNetwork = socialNetwork.trim().toLowerCase();
-    return this.social && _.filter( this.social, function(sn){
-      return sn.network.trim().toLowerCase() === socialNetwork;
-    });
-  };
-
-
-
-  /**
-  Determine if the sheet includes a specific skill.
-  */
-  FreshResume.prototype.hasSkill = function( skill ) {
-    skill = skill.trim().toLowerCase();
-    return this.skills && _.some( this.skills, function(sk) {
-      return sk.keywords && _.some( sk.keywords, function(kw) {
-        return kw.trim().toLowerCase() === skill;
-      });
-    });
-  };
-
-
-
-  /**
-  Validate the sheet against the FRESH Resume schema.
-  */
-  FreshResume.prototype.isValid = function( info ) {
-    var schemaObj = require('fresca');
-    var validator = require('is-my-json-valid');
-    var validate = validator( schemaObj, { // See Note [1].
-      formats: { date: /^\d{4}(?:-(?:0[0-9]{1}|1[0-2]{1})(?:-[0-9]{2})?)?$/ }
-    });
-    var ret = validate( this );
-    if( !ret ) {
-      this.imp = this.imp || { };
-      this.imp.validationErrors = validate.errors;
-    }
-    return ret;
-  };
-
-
-
-  /**
-  Calculate the total duration of the sheet. Assumes this.work has been sorted
-  by start date descending, perhaps via a call to Sheet.sort().
-  @returns The total duration of the sheet's work history, that is, the number
-  of years between the start date of the earliest job on the resume and the
-  *latest end date of all jobs in the work history*. This last condition is for
-  sheets that have overlapping jobs.
-  */
-  FreshResume.prototype.duration = function(unit) {
-    unit = unit || 'years';
-    var empHist = __.get(this, 'employment.history');
-    if( empHist && empHist.length ) {
-      var firstJob = _.last( empHist );
-      var careerStart = firstJob.start ? firstJob.safe.start : '';
-      if ((typeof careerStart === 'string' || careerStart instanceof String) &&
-          !careerStart.trim())
-        return 0;
-      var careerLast = _.max( empHist, function( w ) {
-        return( w.safe && w.safe.end ) ? w.safe.end.unix() : moment().unix();
-      });
-      return careerLast.safe.end.diff( careerStart, unit );
-    }
-    return 0;
-  };
-
-
-
-  /**
-  Sort dated things on the sheet by start date descending. Assumes that dates
-  on the sheet have been processed with _parseDates().
-  */
-  FreshResume.prototype.sort = function( ) {
-
-    function byDateDesc(a,b) {
-      return( a.safe.start.isBefore(b.safe.start) ) ? 1
-        : ( a.safe.start.isAfter(b.safe.start) && -1 ) || 0;
-    }
-
-    function sortSection( key ) {
-      var ar = __.get(this, key);
-      if( ar && ar.length ) {
-        var datedThings = obj.filter( function(o) { return o.start; } );
-        datedThings.sort( byDateDesc );
-      }
-    }
-
-    sortSection( 'employment.history' );
-    sortSection( 'education.history' );
-    sortSection( 'service.history' );
-    sortSection( 'projects.history' );
-
-    // this.awards && this.awards.sort( function(a, b) {
-    //   return( a.safeDate.isBefore(b.safeDate) ) ? 1
-    //     : ( a.safeDate.isAfter(b.safeDate) && -1 ) || 0;
-    // });
-    this.writing && this.writing.sort( function(a, b) {
-      return( a.safe.date.isBefore(b.safe.date) ) ? 1
-        : ( a.safe.date.isAfter(b.safe.date) && -1 ) || 0;
-    });
-  };
-
-
-
-  /**
-  Convert human-friendly dates into formal Moment.js dates for all collections.
-  We don't want to lose the raw textual date as entered by the user, so we store
-  the Moment-ified date as a separate property with a prefix of .safe. For ex:
-  job.startDate is the date as entered by the user. job.safeStartDate is the
-  parsed Moment.js date that we actually use in processing.
-  */
-  function _parseDates() {
-
-    var _fmt = require('./fluent-date').fmt;
-    var that = this;
-
-    // TODO: refactor recursion
-    function replaceDatesInObject( obj ) {
-
-      if( !obj ) return;
-      if( Object.prototype.toString.call( obj ) === '[object Array]' ) {
-        obj.forEach(function(elem){
-          replaceDatesInObject( elem );
-        });
-      }
-      else if (typeof obj === 'object') {
-        if( obj._isAMomentObject || obj.safe )
-         return;
-        Object.keys( obj ).forEach(function(key) {
-          replaceDatesInObject( obj[key] );
-        });
-        ['start','end','date'].forEach( function(val) {
-          if( (obj[val] !== undefined) && (!obj.safe || !obj.safe[val] )) {
-            obj.safe = obj.safe || { };
-            obj.safe[ val ] = _fmt( obj[val] );
-            if( obj[val] && (val === 'start') && !obj.end ) {
-              obj.safe.end = _fmt('current');
-            }
-          }
-        });
-      }
-    }
-
-    Object.keys( this ).forEach(function(member){
-      replaceDatesInObject( that[ member ] );
-    });
-
-  }
-
-
-
-  /**
-  Export the Sheet function/ctor.
-  */
-  module.exports = FreshResume;
-
-
-
-}());
-
-// Note 1: Adjust default date validation to allow YYYY and YYYY-MM formats
-// in addition to YYYY-MM-DD. The original regex:
-//
-//     /^\d{4}-(?:0[0-9]{1}|1[0-2]{1})-[0-9]{2}$/
-//

src/core/fresh-theme.js

@@ -1,336 +0,0 @@
-/**
-Definition of the FRESHTheme class.
-@module fresh-theme.js
-@license MIT. See LICENSE.md for details.
-*/
-
-(function() {
-
-
-
-  var FS = require('fs')
-    , extend = require('../utils/extend')
-    , validator = require('is-my-json-valid')
-    , _ = require('underscore')
-    , PATH = require('path')
-    , parsePath = require('parse-filepath')
-    , pathExists = require('path-exists').sync
-    , EXTEND = require('../utils/extend')
-    , moment = require('moment')
-    , READFILES = require('recursive-readdir-sync');
-
-
-
-  /**
-  The FRESHTheme class is a representation of a FRESH theme
-  asset. See also: JRSTheme.
-  @class FRESHTheme
-  */
-  function FRESHTheme() {
-
-  }
-
-
-
-  /**
-  Open and parse the specified theme.
-  */
-  FRESHTheme.prototype.open = function( themeFolder ) {
-
-    this.folder = themeFolder;
-
-    // Open the [theme-name].json file; should have the same name as folder
-    var pathInfo = parsePath( themeFolder );
-
-    // Set up a formats hash for the theme
-    var formatsHash = { };
-
-    // Load the theme
-    var themeFile = PATH.join( themeFolder, 'theme.json' );
-    var themeInfo = JSON.parse( FS.readFileSync( themeFile, 'utf8' ) );
-    var that = this;
-
-    // Move properties from the theme JSON file to the theme object
-    EXTEND( true, this, themeInfo );
-
-    // Check for an "inherits" entry in the theme JSON.
-    if( this.inherits ) {
-      var cached = { };
-      _.each( this.inherits, function(th, key) {
-        var themesFolder = require.resolve('fresh-themes');
-        var d = parsePath( themeFolder ).dirname;
-        var themePath = PATH.join(d, th);
-        cached[ th ] = cached[th] || new FRESHTheme().open( themePath );
-        formatsHash[ key ] = cached[ th ].getFormat( key );
-      });
-    }
-
-    // Check for an explicit "formats" entry in the theme JSON. If it has one,
-    // then this theme declares its files explicitly.
-    if( !!this.formats ) {
-      formatsHash = loadExplicit.call( this, formatsHash );
-      this.explicit = true;
-    }
-    else {
-      formatsHash = loadImplicit.call( this, formatsHash );
-    }
-
-    // Cache
-    this.formats = formatsHash;
-
-    // Set the official theme name
-    this.name = parsePath( this.folder ).name;
-
-    return this;
-  };
-
-
-
-  /**
-  Determine if the theme supports the specified output format.
-  */
-  FRESHTheme.prototype.hasFormat = function( fmt ) {
-    return _.has( this.formats, fmt );
-  };
-
-
-
-  /**
-  Determine if the theme supports the specified output format.
-  */
-  FRESHTheme.prototype.getFormat = function( fmt ) {
-    return this.formats[ fmt ];
-  };
-
-
-  /**
-  Load the theme implicitly, by scanning the theme folder for
-  files. TODO: Refactor duplicated code with loadExplicit.
-  */
-  function loadImplicit(formatsHash) {
-
-    // Set up a hash of formats supported by this theme.
-    var that = this;
-    var major = false;
-
-    // Establish the base theme folder
-    var tplFolder = PATH.join( this.folder, 'src' );
-
-    // Iterate over all files in the theme folder, producing an array, fmts,
-    // containing info for each file. While we're doing that, also build up
-    // the formatsHash object.
-    var fmts = READFILES(tplFolder).map( function(absPath) {
-
-      // If this file lives in a specific format folder within the theme,
-      // such as "/latex" or "/html", then that format is the output format
-      // for all files within the folder.
-      var pathInfo = parsePath(absPath);
-      var outFmt = '', isMajor = false;
-      var portion = pathInfo.dirname.replace(tplFolder,'');
-      if( portion && portion.trim() ) {
-        if( portion[1] === '_' ) return;
-        var reg = /^(?:\/|\\)(html|latex|doc|pdf|png|partials)(?:\/|\\)?/ig;
-        var res = reg.exec( portion );
-        if( res ) {
-          if( res[1] !== 'partials' ) {
-            outFmt = res[1];
-          }
-          else {
-            that.partials = that.partials || [];
-            that.partials.push( { name: pathInfo.name, path: absPath } );
-            return null;
-          }
-        }
-      }
-
-      // Otherwise, the output format is inferred from the filename, as in
-      // compact-[outputformat].[extension], for ex, compact-pdf.html.
-      if( !outFmt ) {
-        var idx = pathInfo.name.lastIndexOf('-');
-        outFmt = (idx === -1) ? pathInfo.name : pathInfo.name.substr(idx + 1);
-        isMajor = true;
-      }
-
-      // We should have a valid output format now.
-      formatsHash[ outFmt ] = formatsHash[outFmt] || {
-        outFormat: outFmt,
-        files: []
-      };
-
-      // Create the file representation object.
-      var obj = {
-        action: 'transform',
-        path: absPath,
-        major: isMajor,
-        orgPath: PATH.relative(tplFolder, absPath),
-        ext: pathInfo.extname.slice(1),
-        title: friendlyName( outFmt ),
-        pre: outFmt,
-        // outFormat: outFmt || pathInfo.name,
-        data: FS.readFileSync( absPath, 'utf8' ),
-        css: null
-      };
-
-      // Add this file to the list of files for this format type.
-      formatsHash[ outFmt ].files.push( obj );
-      return obj;
-    });
-
-    // Now, get all the CSS files...
-    (this.cssFiles = fmts.filter(function( fmt ){
-      return fmt && (fmt.ext === 'css');
-    }))
-
-    // For each CSS file, get its corresponding HTML file. It's possible that
-    // a theme can have a CSS file but *no* HTML file, as when a theme author
-    // creates a pure CSS override of an existing theme.
-    .forEach(function( cssf ) {
-
-      var idx = _.findIndex(fmts, function( fmt ) {
-        return fmt && fmt.pre === cssf.pre && fmt.ext === 'html';
-      });
-      cssf.action = null;
-      if( idx > -1) {
-        fmts[ idx ].css = cssf.data;
-        fmts[ idx ].cssPath = cssf.path;
-      }
-      else {
-        if( that.inherits ) {
-          // Found a CSS file without an HTML file in a theme that inherits
-          // from another theme. This is the override CSS file.
-          that.overrides = { file: cssf.path, data: cssf.data };
-        }
-      }
-    });
-
-    // Remove CSS files from the formats array
-    fmts = fmts.filter( function( fmt) {
-      return fmt && (fmt.ext !== 'css');
-    });
-
-    return formatsHash;
-  }
-
-
-
-  /**
-  Load the theme explicitly, by following the 'formats' hash
-  in the theme's JSON settings file.
-  */
-  function loadExplicit(formatsHash) {
-
-    // Housekeeping
-    var tplFolder = PATH.join( this.folder, 'src' );
-    var act = null;
-    var that = this;
-
-    // Iterate over all files in the theme folder, producing an array, fmts,
-    // containing info for each file. While we're doing that, also build up
-    // the formatsHash object.
-    var fmts = READFILES( tplFolder ).map( function( absPath ) {
-
-      act = null;
-      // If this file is mentioned in the theme's JSON file under "transforms"
-      var pathInfo = parsePath(absPath);
-      var absPathSafe = absPath.trim().toLowerCase();
-      var outFmt = _.find(
-        Object.keys( that.formats ),
-        function( fmtKey ) {
-          var fmtVal = that.formats[ fmtKey ];
-          return _.some( fmtVal.transform, function(fpath) {
-            var absPathB = PATH.join( that.folder, fpath )
-              .trim().toLowerCase();
-            return absPathB === absPathSafe;
-          });
-        });
-      if( outFmt ) {
-        act = 'transform';
-      }
-
-      // If this file lives in a specific format folder within the theme,
-      // such as "/latex" or "/html", then that format is the output format
-      // for all files within the folder.
-      if( !outFmt ) {
-        var portion = pathInfo.dirname.replace(tplFolder,'');
-        if( portion && portion.trim() ) {
-          var reg = /^(?:\/|\\)(html|latex|doc|pdf)(?:\/|\\)?/ig;
-          var res = reg.exec( portion );
-          res && (outFmt = res[1]);
-        }
-      }
-
-      // Otherwise, the output format is inferred from the filename, as in
-      // compact-[outputformat].[extension], for ex, compact-pdf.html.
-      if( !outFmt ) {
-        var idx = pathInfo.name.lastIndexOf('-');
-        outFmt = (idx === -1) ? pathInfo.name : pathInfo.name.substr(idx + 1);
-      }
-
-      // We should have a valid output format now.
-      formatsHash[ outFmt ] =
-        formatsHash[ outFmt ] || {
-          outFormat: outFmt,
-          files: [],
-          symLinks: that.formats[ outFmt ].symLinks
-        };
-
-      // Create the file representation object.
-      var obj = {
-        action: act,
-        orgPath: PATH.relative(that.folder, absPath),
-        path: absPath,
-        ext: pathInfo.extname.slice(1),
-        title: friendlyName( outFmt ),
-        pre: outFmt,
-        // outFormat: outFmt || pathInfo.name,
-        data: FS.readFileSync( absPath, 'utf8' ),
-        css: null
-      };
-
-      // Add this file to the list of files for this format type.
-      formatsHash[ outFmt ].files.push( obj );
-      return obj;
-    });
-
-    // Now, get all the CSS files...
-    (this.cssFiles = fmts.filter(function( fmt ){
-      return fmt.ext === 'css';
-    }))
-
-    // For each CSS file, get its corresponding HTML file
-    .forEach(function( cssf ) {
-        // For each CSS file, get its corresponding HTML file
-        var idx = _.findIndex(fmts, function( fmt ) {
-          return fmt.pre === cssf.pre && fmt.ext === 'html';
-      });
-      fmts[ idx ].css = cssf.data;
-      fmts[ idx ].cssPath = cssf.path;
-    });
-
-    // Remove CSS files from the formats array
-    fmts = fmts.filter( function( fmt) {
-      return fmt.ext !== 'css';
-    });
-
-    return formatsHash;
-  }
-
-
-
-  /**
-  Return a more friendly name for certain formats.
-  TODO: Refactor
-  */
-  function friendlyName( val ) {
-    val = val.trim().toLowerCase();
-    var friendly = { yml: 'yaml', md: 'markdown', txt: 'text' };
-    return friendly[val] || val;
-  }
-
-
-
-  module.exports = FRESHTheme;
-
-
-
-}());

src/core/jrs-resume.js

@@ -1,431 +0,0 @@
-/**
-Definition of the JRSResume class.
-@license MIT. See LICENSE.md for details.
-@module jrs-resume.js
-*/
-
-
-
-(function() {
-
-
-
-  var FS = require('fs')
-    , extend = require('../utils/extend')
-    , validator = require('is-my-json-valid')
-    , _ = require('underscore')
-    , PATH = require('path')
-    , MD = require('marked')
-    , CONVERTER = require('./convert')
-    , moment = require('moment');
-
-
-
-  /**
-  A JRS resume or CV. JRS resumes are backed by JSON, and each JRSResume object
-  is an instantiation of that JSON decorated with utility methods.
-  @class JRSResume
-  */
-  function JRSResume() {
-
-  }
-
-
-
-  /**
-  Initialize the JSResume from file.
-  */
-  JRSResume.prototype.open = function( file, title ) {
-    //this.imp = { fileName: file }; <-- schema violation, tuck it into .basics
-    this.basics = {
-      imp: {
-        fileName: file,
-        raw: FS.readFileSync( file, 'utf8' )
-      }
-    };
-    return this.parse( this.basics.imp.raw, title );
-  };
-
-
-
-  /**
-  Initialize the the JSResume from string.
-  */
-  JRSResume.prototype.parse = function( stringData, opts ) {
-    opts = opts || { };
-    var rep = JSON.parse( stringData );
-    return this.parseJSON( rep, opts );
-  };
-
-
-
-  /**
-  Initialize the JRSResume from JSON.
-  Open and parse the specified JRS resume. Merge the JSON object model onto this
-  Sheet instance with extend() and convert sheet dates to a safe & consistent
-  format. Then sort each section by startDate descending.
-  */
-  JRSResume.prototype.parseJSON = function( rep, opts ) {
-    opts = opts || { };
-    extend( true, this, rep );
-    // Set up metadata
-    if( opts.imp === undefined || opts.imp ) {
-      this.basics.imp = this.basics.imp || { };
-      this.basics.imp.title =
-        (opts.title || this.basics.imp.title) || this.basics.name;
-      this.basics.imp.orgFormat = 'JRS';
-    }
-    // Parse dates, sort dates, and calculate computed values
-    (opts.date === undefined || opts.date) && _parseDates.call( this );
-    (opts.sort === undefined || opts.sort) && this.sort();
-    (opts.compute === undefined || opts.compute) && (this.basics.computed = {
-      numYears: this.duration(),
-      keywords: this.keywords()
-    });
-    return this;
-  };
-
-
-
-  /**
-  Save the sheet to disk (for environments that have disk access).
-  */
-  JRSResume.prototype.save = function( filename ) {
-    this.basics.imp.fileName = filename || this.basics.imp.fileName;
-    FS.writeFileSync(this.basics.imp.fileName, this.stringify( this ), 'utf8');
-    return this;
-  };
-
-
-
-  /**
-  Save the sheet to disk in a specific format, either FRESH or JRS.
-  */
-  JRSResume.prototype.saveAs = function( filename, format ) {
-
-    if( format === 'JRS' ) {
-      this.basics.imp.fileName = filename || this.imp.fileName;
-      FS.writeFileSync( this.basics.imp.fileName, this.stringify(), 'utf8' );
-    }
-    else {
-      var newRep = CONVERTER.toFRESH( this );
-      var stringRep = CONVERTER.toSTRING( newRep );
-      FS.writeFileSync( filename, stringRep, 'utf8' );
-    }
-    return this;
-
-  };
-
-
-
-  /**
-  Return the resume format.
-  */
-  JRSResume.prototype.format = function() {
-    return 'JRS';
-  };
-
-
-
-  /**
-  Convert this object to a JSON string, sanitizing meta-properties along the
-  way. Don't override .toString().
-  */
-  JRSResume.stringify = function( obj ) {
-    function replacer( key,value ) { // Exclude these keys from stringification
-      return _.some(['imp', 'warnings', 'computed', 'filt', 'ctrl', 'index',
-        'safeStartDate', 'safeEndDate', 'safeDate', 'safeReleaseDate', 'result',
-        'isModified', 'htmlPreview', 'display_progress_bar'],
-        function( val ) { return key.trim() === val; }
-      ) ? undefined : value;
-    }
-    return JSON.stringify( obj, replacer, 2 );
-  };
-
-
-
-  JRSResume.prototype.stringify = function() {
-    return JRSResume.stringify( this );
-  };
-
-
-
-  /**
-  Return a unique list of all keywords across all skills.
-  */
-  JRSResume.prototype.keywords = function() {
-    var flatSkills = [];
-    if( this.skills && this.skills.length ) {
-      this.skills.forEach( function( s ) {
-        flatSkills = _.union( flatSkills, s.keywords );
-      });
-    }
-    return flatSkills;
-  };
-
-
-
-  /**
-  Return internal metadata. Create if it doesn't exist.
-  JSON Resume v0.0.0 doesn't allow additional properties at the root level,
-  so tuck this into the .basic sub-object.
-  */
-  JRSResume.prototype.i = function() {
-    this.basics = this.basics || { imp: { } };
-    return this.basics;
-  };
-
-
-
-  /**
-  Reset the sheet to an empty state.
-  */
-  JRSResume.prototype.clear = function( clearMeta ) {
-    clearMeta = ((clearMeta === undefined) && true) || clearMeta;
-    clearMeta && (delete this.imp);
-    delete this.basics.computed; // Don't use Object.keys() here
-    delete this.work;
-    delete this.volunteer;
-    delete this.education;
-    delete this.awards;
-    delete this.publications;
-    delete this.interests;
-    delete this.skills;
-    delete this.basics.profiles;
-  };
-
-
-
-  /**
-  Get the default (empty) sheet.
-  */
-  JRSResume.default = function() {
-    return new JRSResume().open(
-      PATH.join( __dirname, 'empty-jrs.json'), 'Empty'
-    );
-  };
-
-
-
-  /**
-  Add work experience to the sheet.
-  */
-  JRSResume.prototype.add = function( moniker ) {
-    var defSheet = JRSResume.default();
-    var newObject = $.extend( true, {}, defSheet[ moniker ][0] );
-    this[ moniker ] = this[ moniker ] || [];
-    this[ moniker ].push( newObject );
-    return newObject;
-  };
-
-
-
-  /**
-  Determine if the sheet includes a specific social profile (eg, GitHub).
-  */
-  JRSResume.prototype.hasProfile = function( socialNetwork ) {
-    socialNetwork = socialNetwork.trim().toLowerCase();
-    return this.basics.profiles && _.some( this.basics.profiles, function(p) {
-      return p.network.trim().toLowerCase() === socialNetwork;
-    });
-  };
-
-
-
-  /**
-  Determine if the sheet includes a specific skill.
-  */
-  JRSResume.prototype.hasSkill = function( skill ) {
-    skill = skill.trim().toLowerCase();
-    return this.skills && _.some( this.skills, function(sk) {
-      return sk.keywords && _.some( sk.keywords, function(kw) {
-        return kw.trim().toLowerCase() === skill;
-      });
-    });
-  };
-
-
-
-  /**
-  Validate the sheet against the JSON Resume schema.
-  */
-  JRSResume.prototype.isValid = function( ) { // TODO: ↓ fix this path ↓
-    var schema = FS.readFileSync( PATH.join( __dirname, 'resume.json' ),'utf8');
-    var schemaObj = JSON.parse( schema );
-    var validator = require('is-my-json-valid');
-    var validate = validator( schemaObj, { // Note [1]
-      formats: { date: /^\d{4}(?:-(?:0[0-9]{1}|1[0-2]{1})(?:-[0-9]{2})?)?$/ }
-    });
-    var ret = validate( this );
-    if( !ret ) {
-      this.basics.imp = this.basics.imp || { };
-      this.basics.imp.validationErrors = validate.errors;
-    }
-    return ret;
-  };
-
-
-
-  /**
-  Calculate the total duration of the sheet. Assumes this.work has been sorted
-  by start date descending, perhaps via a call to Sheet.sort().
-  @returns The total duration of the sheet's work history, that is, the number
-  of years between the start date of the earliest job on the resume and the
-  *latest end date of all jobs in the work history*. This last condition is for
-  sheets that have overlapping jobs.
-  */
-  JRSResume.prototype.duration = function() {
-    if( this.work && this.work.length ) {
-      var careerStart = this.work[ this.work.length - 1].safeStartDate;
-      if ((typeof careerStart === 'string' || careerStart instanceof String) &&
-          !careerStart.trim())
-        return 0;
-      var careerLast = _.max( this.work, function( w ) {
-        return w.safeEndDate.unix();
-      }).safeEndDate;
-      return careerLast.diff( careerStart, 'years' );
-    }
-    return 0;
-  };
-
-
-
-  /**
-  Sort dated things on the sheet by start date descending. Assumes that dates
-  on the sheet have been processed with _parseDates().
-  */
-  JRSResume.prototype.sort = function( ) {
-
-    this.work && this.work.sort( byDateDesc );
-    this.education && this.education.sort( byDateDesc );
-    this.volunteer && this.volunteer.sort( byDateDesc );
-
-    this.awards && this.awards.sort( function(a, b) {
-      return( a.safeDate.isBefore(b.safeDate) ) ? 1
-        : ( a.safeDate.isAfter(b.safeDate) && -1 ) || 0;
-    });
-    this.publications && this.publications.sort( function(a, b) {
-      return( a.safeReleaseDate.isBefore(b.safeReleaseDate) ) ? 1
-        : ( a.safeReleaseDate.isAfter(b.safeReleaseDate) && -1 ) || 0;
-    });
-
-    function byDateDesc(a,b) {
-      return( a.safeStartDate.isBefore(b.safeStartDate) ) ? 1
-        : ( a.safeStartDate.isAfter(b.safeStartDate) && -1 ) || 0;
-    }
-
-  };
-
-
-
-  JRSResume.prototype.dupe = function() {
-    var rnew = new JRSResume();
-    rnew.parse( this.stringify(), { } );
-    return rnew;
-  };
-
-
-
-  /**
-  Create a copy of this resume in which all fields have been interpreted as
-  Markdown.
-  */
-  JRSResume.prototype.harden = function() {
-
-    var that = this;
-    var ret = this.dupe();
-
-    function HD(txt) {
-      return '@@@@~' + txt + '~@@@@';
-    }
-
-    function HDIN(txt){
-      //return MD(txt || '' ).replace(/^\s*<p>|<\/p>\s*$/gi, '');
-      return HD(txt);
-    }
-
-    // TODO: refactor recursion
-    function hardenStringsInObject( obj, inline ) {
-
-      if( !obj ) return;
-      inline = inline === undefined || inline;
-
-
-      if( Object.prototype.toString.call( obj ) === '[object Array]' ) {
-        obj.forEach(function(elem, idx, ar){
-          if( typeof elem === 'string' || elem instanceof String )
-            ar[idx] = inline ? HDIN(elem) : HD( elem );
-          else
-            hardenStringsInObject( elem );
-        });
-      }
-      else if (typeof obj === 'object') {
-        Object.keys( obj ).forEach(function(key) {
-          var sub = obj[key];
-          if( typeof sub === 'string' || sub instanceof String ) {
-            if( _.contains(['skills','url','website','startDate','endDate',
-              'releaseDate','date','phone','email','address','postalCode',
-              'city','country','region'], key) )
-              return;
-            if( key === 'summary' )
-              obj[key] = HD( obj[key] );
-            else
-              obj[key] = inline ? HDIN( obj[key] ) : HD( obj[key] );
-          }
-          else
-            hardenStringsInObject( sub );
-        });
-      }
-
-    }
-
-    Object.keys( ret ).forEach(function(member){
-      hardenStringsInObject( ret[ member ] );
-    });
-
-    return ret;
-  };
-
-
-
-  /**
-  Convert human-friendly dates into formal Moment.js dates for all collections.
-  We don't want to lose the raw textual date as entered by the user, so we store
-  the Moment-ified date as a separate property with a prefix of .safe. For ex:
-  job.startDate is the date as entered by the user. job.safeStartDate is the
-  parsed Moment.js date that we actually use in processing.
-  */
-  function _parseDates() {
-
-    var _fmt = require('./fluent-date').fmt;
-
-    this.work && this.work.forEach( function(job) {
-      job.safeStartDate = _fmt( job.startDate );
-      job.safeEndDate = _fmt( job.endDate );
-    });
-    this.education && this.education.forEach( function(edu) {
-      edu.safeStartDate = _fmt( edu.startDate );
-      edu.safeEndDate = _fmt( edu.endDate );
-    });
-    this.volunteer && this.volunteer.forEach( function(vol) {
-      vol.safeStartDate = _fmt( vol.startDate );
-      vol.safeEndDate = _fmt( vol.endDate );
-    });
-    this.awards && this.awards.forEach( function(awd) {
-      awd.safeDate = _fmt( awd.date );
-    });
-    this.publications && this.publications.forEach( function(pub) {
-      pub.safeReleaseDate = _fmt( pub.releaseDate );
-    });
-  }
-
-
-
-  /**
-  Export the JRSResume function/ctor.
-  */
-  module.exports = JRSResume;
-
-
-
-}());

src/core/jrs-theme.js

@@ -1,85 +0,0 @@
-/**
-Definition of the JRSTheme class.
-@module jrs-theme.js
-@license MIT. See LICENSE.MD for details.
-*/
-
-(function() {
-
-
-
-  var _ = require('underscore')
-    , PATH = require('path')
-    , parsePath = require('parse-filepath')
-    , pathExists = require('path-exists').sync;
-
-
-
-  /**
-  The JRSTheme class is a representation of a JSON Resume
-  theme asset. See also: FRESHTheme.
-  @class JRSTheme
-  */
-  function JRSTheme() {
-
-  }
-
-
-
-  /**
-  Open and parse the specified theme.
-  @method open
-  */
-  JRSTheme.prototype.open = function( thFolder ) {
-
-    this.folder = thFolder;
-
-    // Open the [theme-name].json file; should have the same
-    // name as folder
-    var pathInfo = parsePath( thFolder );
-
-    // Open and parse the theme's package.json file.
-    var pkgJsonPath = PATH.join( thFolder, 'package.json' );
-    if( pathExists( pkgJsonPath )) {
-      var thApi = require( thFolder )
-        , thPkg = require( pkgJsonPath );
-      this.name = thPkg.name;
-      this.render = (thApi && thApi.render) || undefined;
-      this.formats = {
-        html: { title:'html', outFormat:'html', ext:'html' }
-      };
-    }
-    else {
-      throw { fluenterror: 10 };
-    }
-
-    return this;
-  };
-
-
-
-  /**
-  Determine if the theme supports the output format.
-  @method hasFormat
-  */
-  JRSTheme.prototype.hasFormat = function( fmt ) {
-    return _.has( this.formats, fmt );
-  };
-
-
-
-  /**
-  Return the requested output format.
-  @method getFormat
-  */
-  JRSTheme.prototype.getFormat = function( fmt ) {
-    return this.formats[ fmt ];
-  };
-
-
-
-  module.exports = JRSTheme;
-
-
-
-}());

src/core/resume-factory.js

@@ -1,131 +0,0 @@
-/**
-Definition of the ResumeFactory class.
-@license MIT. See LICENSE.md for details.
-@module resume-factory.js
-*/
-
-
-
-(function(){
-
-
-
-  require('string.prototype.startswith');
-  var FS = require('fs');
-  var ResumeConverter = require('./convert');
-  var chalk = require('chalk');
-  var SyntaxErrorEx = require('../utils/syntax-error-ex');
-
-
-
-  /**
-  A simple factory class for FRESH and JSON Resumes.
-  @class ResumeFactory
-  */
-  var ResumeFactory = module.exports = {
-
-
-
-    /**
-    Load one or more resumes from disk.
-    */
-    load: function ( sources, opts ) {
-
-      // Loop over all inputs, parsing each to JSON and then to a FRESHResume
-      // or JRSResume object.
-      var that = this;
-      return sources.map( function( src ) {
-        return that.loadOne( src, opts );
-      });
-
-    },
-
-
-
-    /**
-    Load a single resume from disk.
-    */
-    loadOne: function( src, opts ) {
-
-      var log = opts.log;
-      var toFormat = opts.format;
-      var objectify = opts.objectify;
-
-      // Get the destination format. Can be 'fresh', 'jrs', or null/undefined.
-      toFormat && (toFormat = toFormat.toLowerCase().trim());
-
-      // Load and parse the resume JSON
-      var info = _parse( src, opts );
-      if( info.error ) return info;
-
-      // Determine the resume format: FRESH or JRS
-      var json = info.json;
-      var orgFormat = ( json.meta && json.meta.format &&
-                        json.meta.format.startsWith('FRESH@') ) ?
-                        'fresh' : 'jrs';
-
-      // Convert between formats if necessary
-      if( toFormat && (orgFormat !== toFormat) ) {
-        json = ResumeConverter[ 'to' + toFormat.toUpperCase() ]( json );
-      }
-
-      // Objectify the resume, that is, convert it from JSON to a FRESHResume
-      // or JRSResume object.
-      var rez;
-      if( objectify ) {
-        var ResumeClass = require('../core/' + (toFormat || orgFormat) + '-resume');
-        rez = new ResumeClass().parseJSON( json );
-        rez.i().file = src;
-      }
-
-      return {
-        file: src,
-        json: info.json,
-        rez: rez
-      };
-    }
-  };
-
-
-
-  function _parse( fileName, opts ) {
-    var rawData;
-    try {
-
-      // TODO: Core should not log
-      opts.log( chalk.cyan('Reading resume: ') + chalk.cyan.bold(fileName) );
-
-      // Read the file
-      rawData = FS.readFileSync( fileName, 'utf8' );
-
-      // Parse it to JSON
-      return {
-        json: JSON.parse( rawData )
-      };
-
-    }
-    catch( ex ) {
-
-      // JSON.parse failed due to invalid JSON
-      if ( !opts.muffle && ex instanceof SyntaxError) {
-        var info = new SyntaxErrorEx( ex, rawData );
-        opts.log( chalk.red.bold(fileName.toUpperCase() + ' contains invalid JSON on line ' +
-          info.line + ' column ' + info.col + '.' +
-          chalk.red(' Unable to validate.')));
-        opts.log( chalk.red.bold('INTERNAL: ' + ex) );
-        ex.handled = true;
-      }
-
-      if( opts.throw ) throw ex;
-      else return {
-        error: ex,
-        raw: rawData,
-        file: fileName
-      };
-
-    }
-  }
-
-
-
-}());

src/core/resume.json

@@ -1,380 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-04/schema#",
-  "title": "Resume Schema",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "basics": {
-      "type": "object",
-      "additionalProperties": true,
-      "properties": {
-        "name": {
-          "type": "string"
-        },
-        "label": {
-          "type": "string",
-          "description": "e.g. Web Developer"
-        },
-        "picture": {
-          "type": "string",
-          "description": "URL (as per RFC 3986) to a picture in JPEG or PNG format"
-        },
-        "email": {
-          "type": "string",
-          "description": "e.g. thomas@gmail.com",
-          "format": "email"
-        },
-        "phone": {
-          "type": "string",
-          "description": "Phone numbers are stored as strings so use any format you like, e.g. 712-117-2923"
-        },
-        "website": {
-          "type": "string",
-          "description": "URL (as per RFC 3986) to your website, e.g. personal homepage",
-          "format": "uri"
-        },
-        "summary": {
-          "type": "string",
-          "description": "Write a short 2-3 sentence biography about yourself"
-        },
-        "location": {
-          "type": "object",
-          "additionalProperties": true,
-          "properties": {
-            "address": {
-              "type": "string",
-              "description": "To add multiple address lines, use \n. For example, 1234 Glücklichkeit Straße\nHinterhaus 5. Etage li."
-            },
-            "postalCode": {
-              "type": "string"
-            },
-            "city": {
-              "type": "string"
-            },
-            "countryCode": {
-              "type": "string",
-              "description": "code as per ISO-3166-1 ALPHA-2, e.g. US, AU, IN"
-            },
-            "region": {
-              "type": "string",
-              "description": "The general region where you live. Can be a US state, or a province, for instance."
-            }
-          }
-        },
-        "profiles": {
-          "type": "array",
-          "description": "Specify any number of social networks that you participate in",
-          "additionalItems": false,
-          "items": {
-            "type": "object",
-            "additionalProperties": true,
-            "properties": {
-              "network": {
-                "type": "string",
-                "description": "e.g. Facebook or Twitter"
-              },
-              "username": {
-                "type": "string",
-                "description": "e.g. neutralthoughts"
-              },
-              "url": {
-                "type": "string",
-                "description": "e.g. http://twitter.com/neutralthoughts"
-              }
-            }
-          }
-        }
-      }
-    },
-    "work": {
-      "type": "array",
-      "additionalItems": false,
-      "items": {
-        "type": "object",
-        "additionalProperties": true,
-      "properties": {
-          "company": {
-            "type": "string",
-            "description": "e.g. Facebook"
-          },
-          "position": {
-            "type": "string",
-            "description": "e.g. Software Engineer"
-          },
-          "website": {
-            "type": "string",
-            "description": "e.g. http://facebook.com",
-            "format": "uri"
-          },
-          "startDate": {
-            "type": "string",
-            "description": "resume.json uses the ISO 8601 date standard e.g. 2014-06-29",
-            "format": "date"
-          },
-          "endDate": {
-            "type": "string",
-            "description": "e.g. 2012-06-29",
-            "format": "date"
-          },
-          "summary": {
-            "type": "string",
-            "description": "Give an overview of your responsibilities at the company"
-          },
-          "highlights": {
-            "type": "array",
-            "description": "Specify multiple accomplishments",
-            "additionalItems": false,
-            "items": {
-              "type": "string",
-              "description": "e.g. Increased profits by 20% from 2011-2012 through viral advertising"
-            }
-          }
-        }
-
-      }
-    },
-    "volunteer": {
-      "type": "array",
-      "additionalItems": false,
-      "items": {
-        "type": "object",
-        "additionalProperties": true,
-      "properties": {
-          "organization": {
-            "type": "string",
-            "description": "e.g. Facebook"
-          },
-          "position": {
-            "type": "string",
-            "description": "e.g. Software Engineer"
-          },
-          "website": {
-            "type": "string",
-            "description": "e.g. http://facebook.com",
-            "format": "uri"
-          },
-          "startDate": {
-            "type": "string",
-            "description": "resume.json uses the ISO 8601 date standard e.g. 2014-06-29",
-            "format": "date"
-          },
-          "endDate": {
-            "type": "string",
-            "description": "e.g. 2012-06-29",
-            "format": "date"
-          },
-          "summary": {
-            "type": "string",
-            "description": "Give an overview of your responsibilities at the company"
-          },
-          "highlights": {
-            "type": "array",
-            "description": "Specify multiple accomplishments",
-            "additionalItems": false,
-            "items": {
-              "type": "string",
-              "description": "e.g. Increased profits by 20% from 2011-2012 through viral advertising"
-            }
-          }
-        }
-
-      }
-    },
-    "education": {
-      "type": "array",
-      "additionalItems": false,
-      "items": {
-        "type": "object",
-        "additionalProperties": true,
-      "properties": {
-            "institution": {
-              "type": "string",
-              "description": "e.g. Massachusetts Institute of Technology"
-            },
-            "area": {
-              "type": "string",
-              "description": "e.g. Arts"
-            },
-            "studyType": {
-              "type": "string",
-              "description": "e.g. Bachelor"
-            },
-            "startDate": {
-              "type": "string",
-              "description": "e.g. 2014-06-29",
-              "format": "date"
-            },
-            "endDate": {
-              "type": "string",
-              "description": "e.g. 2012-06-29",
-              "format": "date"
-            },
-            "gpa": {
-              "type": "string",
-              "description": "grade point average, e.g. 3.67/4.0"
-            },
-            "courses": {
-              "type": "array",
-              "description": "List notable courses/subjects",
-              "additionalItems": false,
-              "items": {
-                "type": "string",
-                "description": "e.g. H1302 - Introduction to American history"
-              }
-            }
-          }
-
-
-      }
-    },
-    "awards": {
-      "type": "array",
-      "description": "Specify any awards you have received throughout your professional career",
-      "additionalItems": false,
-      "items": {
-          "type": "object",
-          "additionalProperties": true,
-        "properties": {
-            "title": {
-              "type": "string",
-              "description": "e.g. One of the 100 greatest minds of the century"
-            },
-            "date": {
-              "type": "string",
-              "description": "e.g. 1989-06-12",
-              "format": "date"
-            },
-            "awarder": {
-              "type": "string",
-              "description": "e.g. Time Magazine"
-            },
-            "summary": {
-              "type": "string",
-              "description": "e.g. Received for my work with Quantum Physics"
-            }
-        }
-      }
-    },
-    "publications": {
-      "type": "array",
-      "description": "Specify your publications through your career",
-      "additionalItems": false,
-      "items": {
-          "type": "object",
-          "additionalProperties": true,
-        "properties": {
-            "name": {
-              "type": "string",
-              "description": "e.g. The World Wide Web"
-            },
-            "publisher": {
-              "type": "string",
-              "description": "e.g. IEEE, Computer Magazine"
-            },
-            "releaseDate": {
-              "type": "string",
-              "description": "e.g. 1990-08-01"
-            },
-            "website": {
-              "type": "string",
-              "description": "e.g. http://www.computer.org/csdl/mags/co/1996/10/rx069-abs.html"
-            },
-            "summary": {
-              "type": "string",
-              "description": "Short summary of publication. e.g. Discussion of the World Wide Web, HTTP, HTML."
-            }
-          }
-      }
-    },
-    "skills": {
-      "type": "array",
-      "description": "List out your professional skill-set",
-      "additionalItems": false,
-      "items": {
-          "type": "object",
-          "additionalProperties": true,
-        "properties": {
-            "name": {
-              "type": "string",
-              "description": "e.g. Web Development"
-            },
-            "level": {
-              "type": "string",
-              "description": "e.g. Master"
-            },
-            "keywords": {
-              "type": "array",
-              "description": "List some keywords pertaining to this skill",
-              "additionalItems": false,
-              "items": {
-                "type": "string",
-                "description": "e.g. HTML"
-              }
-            }
-        }
-      }
-    },
-    "languages": {
-      "type": "array",
-      "description": "List any other languages you speak",
-      "additionalItems": false,
-      "items": {
-        "type": "object",
-        "additionalProperties": true,
-        "properties": {
-          "language": {
-            "type": "string",
-            "description": "e.g. English, Spanish"
-          },
-          "fluency": {
-            "type": "string",
-            "description": "e.g. Fluent, Beginner"
-          }
-        }
-      }
-    },
-    "interests": {
-      "type": "array",
-      "additionalItems": false,
-      "items": {
-        "type": "object",
-        "additionalProperties": true,
-      "properties": {
-          "name": {
-            "type": "string",
-            "description": "e.g. Philosophy"
-          },
-          "keywords": {
-            "type": "array",
-            "additionalItems": false,
-            "items": {
-              "type": "string",
-              "description": "e.g. Friedrich Nietzsche"
-            }
-          }
-        }
-
-      }
-    },
-    "references": {
-      "type": "array",
-      "description": "List references you have received",
-      "additionalItems": false,
-      "items": {
-        "type": "object",
-        "additionalProperties": true,
-      "properties": {
-          "name": {
-            "type": "string",
-            "description": "e.g. Timothy Cook"
-          },
-          "reference": {
-            "type": "string",
-            "description": "e.g. Joe blogs was a great employee, who turned up to work at least once a week. He exceeded my expectations when it came to doing nothing."
-          }
-        }
-
-      }
-    }
-  }
-}

src/core/spawn-watch.js

@@ -1,22 +0,0 @@
-/**
-@module spawn-watch.js
-*/
-
-(function() {
-
-// Catch various out-of-band child process errors such as ENOENT for PDFs
-// http://stackoverflow.com/q/27688804
-var SpawnWatcher = module.exports = function() {
-  var childProcess = require("child_process");
-  var oldSpawn = childProcess.spawn;
-  childProcess.spawn = function() {
-    return oldSpawn.apply(this, arguments)
-      .on('error', function(err) {
-        require('./error-handler').err( err, false );
-      });
-  };
-}();
-
-//SpawnWatcher();
-
-}());

src/core/status-codes.js

@@ -1,24 +0,0 @@
-/**
-Status codes for HackMyResume.
-@module status-codes.js
-@license MIT. See LICENSE.MD for details.
-*/
-
-(function(){
-
-  module.exports = {
-    success: 0,
-    themeNotFound: 1,
-    copyCss: 2,
-    resumeNotFound: 3,
-    missingCommand: 4,
-    invalidCommand: 5,
-    resumeNotFoundAlt: 6,
-    inputOutputParity: 7,
-    createNameMissing: 8,
-    wkhtmltopdf: 9,
-    missingPackageJSON: 10,
-    invalid: 11
-  };
-
-}());

src/eng/generic-helpers.js

@@ -1,290 +0,0 @@
-/**
-Generic template helper definitions for HackMyResume / FluentCV.
-@license MIT. See LICENSE.md for details.
-@module generic-helpers.js
-*/
-
-
-(function() {
-
-  var MD = require('marked')
-    , H2W = require('../utils/html-to-wpml')
-    , XML = require('xml-escape')
-    , moment = require('moment')
-    , LO = require('lodash')
-    , _ = require('underscore')
-    , unused = require('../utils/string');
-
-  /**
-  Generic template helper function definitions.
-  @class GenericHelpers
-  */
-  var GenericHelpers = module.exports = {
-
-    /**
-    Convert the input date to a specified format through Moment.js.
-    If date is invalid, will return the time provided by the user, 
-    or default to the fallback param or 'Present' if that is set to true
-    @method formatDate
-    */
-    formatDate: function(datetime, format, fallback) {
-      if (moment) {
-        var momentDate = moment( datetime );
-        if (momentDate.isValid()) return momentDate.format(format);
-      }
-
-      return datetime || (typeof fallback == 'string' ? fallback : (fallback === true ? 'Present' : null));
-    },
-
-    /**
-    Format a from/to date range.
-    @method dateRange
-    */
-    dateRange: function( obj, fmt, sep, options ) {
-      fmt = (fmt && String.is(fmt) && fmt) || 'YYYY-MM';
-      sep = (sep && String.is(sep) && sep) || ' — ';
-      if( obj.safe ) {
-        var dateA = (obj.safe.start && obj.safe.start.format(fmt)) || '';
-        var dateB = (obj.safe.end && obj.safe.end.format(fmt)) || '';
-        if( obj.safe.start && obj.safe.end ) {
-          return dateA + sep + dateB ;
-        }
-        else if( obj.safe.start || obj.safe.end ) {
-          return dateA || dateB;
-        }
-      }
-      return '';
-    },
-
-    /**
-    Return true if the section is present on the resume and has at least one
-    element.
-    @method section
-    */
-    section: function( title, options ) {
-      title = title.trim().toLowerCase();
-      var obj = LO.get( this.r, title );
-      if( _.isArray( obj ) ) {
-        return obj.length ? options.fn(this) : undefined;
-      }
-      else if( _.isObject( obj )) {
-        return ( (obj.history && obj.history.length) ||
-            ( obj.sets && obj.sets.length ) ) ?
-            options.fn(this) : undefined;
-      }
-    },
-
-    /**
-    Capitalize the first letter of the word.
-    @method section
-    */
-    camelCase: function(val) {
-      val = (val && val.trim()) || '';
-      return val ? (val.charAt(0).toUpperCase() + val.slice(1)) : val;
-    },
-
-    /**
-    Return true if the context has the property or subpropery.
-    @method has
-    */
-    has: function( title, options ) {
-      title = title && title.trim().toLowerCase();
-      if( LO.get( this.r, title ) ) {
-        return options.fn(this);
-      }
-    },
-
-    /**
-    Generic template helper function to display a user-overridable section
-    title for a FRESH resume theme. Use this in lieue of hard-coding section
-    titles.
-
-    Usage:
-
-        {{sectionTitle "sectionName"}}
-        {{sectionTitle "sectionName" "sectionTitle"}}
-
-    Example:
-
-        {{sectionTitle "Education"}}
-        {{sectionTitle "Employment" "Project History"}}
-
-    @param sect_name The name of the section being title. Must be one of the
-    top-level FRESH resume sections ("info", "education", "employment", etc.).
-    @param sect_title The theme-specified section title. May be replaced by the
-    user.
-    @method sectionTitle
-    */
-    sectionTitle: function( sname, stitle ) {
-
-      // If not provided by the user, stitle should default to sname. ps.
-      // Handlebars silently passes in the options object to the last param,
-      // where in Underscore stitle will be null/undefined, so we check both.
-      stitle = (stitle && String.is(stitle) && stitle) || sname;
-
-      // If there's a section title override, use it.
-      return ( this.opts.stitles &&
-               this.opts.stitles[ sname.toLowerCase().trim() ] ) ||
-               stitle;
-    },
-
-    /**
-    Convert inline Markdown to inline WordProcessingML.
-    @method wpml
-    */
-    wpml: function( txt, inline ) {
-      if(!txt) return '';
-      inline = (inline && !inline.hash) || false;
-      txt = XML(txt.trim());
-      txt = inline ?
-        MD(txt).replace(/^\s*<p>|<\/p>\s*$/gi, '') :
-        MD(txt);
-      txt = H2W( txt );
-      return txt;
-    },
-
-    /**
-    Emit a conditional link.
-    @method link
-    */
-    link: function( text, url ) {
-      return url && url.trim() ?
-        ('<a href="' + url + '">' + text + '</a>') : text;
-    },
-
-    /**
-    Return the last word of the specified text.
-    @method lastWord
-    */
-    lastWord: function( txt ) {
-      return txt && txt.trim() ? _.last( txt.split(' ') ) : '';
-    },
-
-    /**
-    Convert a skill level to an RGB color triplet. TODO: refactor
-    @method skillColor
-    @param lvl Input skill level. Skill level can be expressed as a string
-    ("beginner", "intermediate", etc.), as an integer (1,5,etc), as a string
-    integer ("1", "5", etc.), or as an RRGGBB color triplet ('#C00000',
-    '#FFFFAA').
-    */
-    skillColor: function( lvl ) {
-      var idx = skillLevelToIndex( lvl );
-      var skillColors = (this.theme && this.theme.palette &&
-        this.theme.palette.skillLevels) ||
-        [ '#FFFFFF', '#5CB85C', '#F1C40F', '#428BCA', '#C00000' ];
-      return skillColors[idx];
-    },
-
-    /**
-    Return an appropriate height. TODO: refactor
-    @method lastWord
-    */
-    skillHeight: function( lvl ) {
-      var idx = skillLevelToIndex( lvl );
-      return ['38.25', '30', '16', '8', '0'][idx];
-    },
-
-    /**
-    Return all but the last word of the input text.
-    @method initialWords
-    */
-    initialWords: function( txt ) {
-      return txt && txt.trim() ? _.initial( txt.split(' ') ).join(' ') : '';
-    },
-
-    /**
-    Trim the protocol (http or https) from a URL/
-    @method trimURL
-    */
-    trimURL: function( url ) {
-      return url && url.trim() ? url.trim().replace(/^https?:\/\//i, '') : '';
-    },
-
-    /**
-    Convert text to lowercase.
-    @method toLower
-    */
-    toLower: function( txt ) {
-      return txt && txt.trim() ? txt.toLowerCase() : '';
-    },
-
-    /**
-    Return true if either value is truthy.
-    @method either
-    */
-    either: function( lhs, rhs, options ) {
-      if (lhs || rhs) return options.fn(this);
-    },
-
-    /**
-    Conditional stylesheet link. Either display the link or embed the stylesheet
-    via <style></style> tag.
-    */
-    styleSheet: function( file, options ) {
-      var styles = ( this.opts.css === 'link') ?
-        '<link href="' + file + '" rel="stylesheet" type="text/css">' :
-        '<style>' + this.cssInfo.data + '</style>';
-      if( this.opts.themeObj.inherits &&
-          this.opts.themeObj.inherits.html &&
-          this.format === 'html' ) {
-        styles += (this.opts.css === 'link') ?
-          '<link href="' + this.opts.themeObj.overrides.path + '" rel="stylesheet" type="text/css">' :
-          '<style>' + this.opts.themeObj.overrides.data + '</style>';
-      }
-      return styles;
-    },
-
-    /**
-    Perform a generic comparison.
-    See: http://doginthehat.com.au/2012/02/comparison-block-helper-for-handlebars-templates
-    @method compare
-    */
-    compare: function(lvalue, rvalue, options) {
-      if (arguments.length < 3)
-        throw new Error("Handlerbars Helper 'compare' needs 2 parameters");
-      var operator = options.hash.operator || "==";
-      var operators = {
-          '==':       function(l,r) { return l == r; },
-          '===':      function(l,r) { return l === r; },
-          '!=':       function(l,r) { return l != r; },
-          '<':        function(l,r) { return l < r; },
-          '>':        function(l,r) { return l > r; },
-          '<=':       function(l,r) { return l <= r; },
-          '>=':       function(l,r) { return l >= r; },
-          'typeof':   function(l,r) { return typeof l == r; }
-      };
-      if (!operators[operator])
-        throw new Error("Handlerbars Helper 'compare' doesn't know the operator "+operator);
-      var result = operators[operator](lvalue,rvalue);
-      return result ? options.fn(this) : options.inverse(this);
-    }
-
-  };
-
-  function skillLevelToIndex( lvl ) {
-    var idx = 0;
-    if( String.is( lvl ) ) {
-      lvl = lvl.trim().toLowerCase();
-      var intVal = parseInt( lvl );
-      if( isNaN( intVal ) ) {
-        switch( lvl ) {
-          case 'beginner': idx = 1; break;
-          case 'intermediate': idx = 2; break;
-          case 'advanced': idx = 3; break;
-          case 'master': idx = 4; break;
-        }
-      }
-      else {
-        idx = Math.min( intVal / 2, 4 );
-        idx = Math.max( 0, idx );
-      }
-    }
-    else {
-      idx = Math.min( lvl / 2, 4 );
-      idx = Math.max( 0, idx );
-    }
-    return idx;
-  }
-
-}());

src/eng/handlebars-generator.js

@@ -1,99 +0,0 @@
-/**
-Definition of the HandlebarsGenerator class.
-@license MIT. See LICENSE.md for details.
-@module handlebars-generator.js
-*/
-
-
-
-(function() {
-
-
-
-  var _ = require('underscore')
-    , HANDLEBARS = require('handlebars')
-    , FS = require('fs')
-    , registerHelpers = require('./handlebars-helpers')
-    , PATH = require('path')
-    , parsePath = require('parse-filepath')
-    , READFILES = require('recursive-readdir-sync')
-    , SLASH = require('slash');
-
-
-
-  /**
-  Perform template-based resume generation using Handlebars.js.
-  @class HandlebarsGenerator
-  */
-  var HandlebarsGenerator = module.exports = {
-
-
-
-
-    generate: function( json, jst, format, cssInfo, opts, theme ) {
-
-      registerPartials( format, theme );
-      registerHelpers( theme );
-
-      // Preprocess text
-      var encData = json;
-      ( format === 'html' || format === 'pdf' ) && (encData = json.markdownify());
-      ( format === 'doc' ) && (encData = json.xmlify());
-
-      // Compile and run the Handlebars template.
-      var template = HANDLEBARS.compile(jst);
-      return template({
-        r: encData,
-        RAW: json,
-        filt: opts.filters,
-        cssInfo: cssInfo,
-        format: format,
-        opts: opts,
-        headFragment: opts.headFragment || ''
-      });
-
-    }
-
-
-
-  };
-
-
-
-  function registerPartials(format, theme) {
-    if( format !== 'html' && format != 'doc' )
-      return;
-
-    // Locate the global partials folder
-    var partialsFolder = PATH.join(
-      parsePath( require.resolve('fresh-themes') ).dirname,
-      '/partials/',
-      format
-    );
-
-    // Register global partials in the /partials folder
-    // TODO: Only do this once per HMR invocation.
-    _.each( READFILES( partialsFolder, function(error){ }), function( el ) {
-      var pathInfo = parsePath( el );
-      var name = SLASH( PATH.relative( partialsFolder, el )
-        .replace(/\.html$|\.xml$/, '') );
-      if( pathInfo.dirname.endsWith('section') ) {
-        name = SLASH(name.replace(/\.html$|\.xml$/, ''));
-      }
-      var tplData = FS.readFileSync( el, 'utf8' );
-      var compiledTemplate = HANDLEBARS.compile( tplData );
-      HANDLEBARS.registerPartial( name, compiledTemplate );
-      theme.partialsInitialized = true;
-    });
-
-    // Register theme-specific partials
-    _.each( theme.partials, function( el ) {
-      var tplData = FS.readFileSync( el.path, 'utf8' );
-      var compiledTemplate = HANDLEBARS.compile( tplData );
-      HANDLEBARS.registerPartial( el.name, compiledTemplate );
-    });
-  }
-
-
-
-}());

src/eng/handlebars-helpers.js

@@ -1,25 +0,0 @@
-/**
-Template helper definitions for Handlebars.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module handlebars-helpers.js
-*/
-
-
-(function() {
-
-  var HANDLEBARS = require('handlebars')
-  , _ = require('underscore')
-  , helpers = require('./generic-helpers');
-
-  /**
-  Register useful Handlebars helpers.
-  @method registerHelpers
-  */
-  module.exports = function( theme ) {
-
-    helpers.theme = theme;
-    HANDLEBARS.registerHelper( helpers );
-
-  };
-
-}());

src/eng/underscore-generator.js

@@ -1,57 +0,0 @@
-/**
-Definition of the UnderscoreGenerator class.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module underscore-generator.js
-*/
-
-(function() {
-
-
-
-  var _ = require('underscore');
-
-
-  /**
-  Perform template-based resume generation using Underscore.js.
-  @class UnderscoreGenerator
-  */
-  var UnderscoreGenerator = module.exports = {
-
-    generate: function( json, jst, format, cssInfo, opts, theme ) {
-
-      // Tweak underscore's default template delimeters
-      var delims = (opts.themeObj && opts.themeObj.delimeters) || opts.template;
-      if( opts.themeObj && opts.themeObj.delimeters ) {
-        delims = _.mapObject( delims, function(val,key) {
-          return new RegExp( val, "ig");
-        });
-      }
-      _.templateSettings = delims;
-
-      // Strip {# comments #}
-      jst = jst.replace( delims.comment, '');
-
-      var helpers = require('./generic-helpers');
-      helpers.opts = opts;
-      helpers.cssInfo = cssInfo;
-
-      // Compile and run the template. TODO: avoid unnecessary recompiles.
-      var compiled = _.template(jst);
-      var ret = compiled({
-        r: format === 'html' || format === 'pdf' || format === 'png' ? json.markdownify() : json,
-        filt: opts.filters,
-        XML: require('xml-escape'),
-        RAW: json,
-        cssInfo: cssInfo,
-        headFragment: opts.headFragment || '',
-        opts: opts,
-        h: helpers
-      });
-      return ret;
-    }
-
-  };
-
-
-
-}());

src/gen/base-generator.js

@@ -1,39 +0,0 @@
-/**
-Definition of the BaseGenerator class.
-@module base-generator.js
-@license MIT. See LICENSE.md for details.
-*/
-
-(function() {
-
-  // Use J. Resig's nifty class implementation
-  var Class = require( '../utils/class' );
-
-  /**
-  The BaseGenerator class is the root of the generator hierarchy. Functionality
-  common to ALL generators lives here.
-  */
-
-  var BaseGenerator = module.exports = Class.extend({
-
-    /**
-    Base-class initialize.
-    */
-    init: function( outputFormat ) {
-      this.format = outputFormat;
-    },
-
-    /**
-    Status codes.
-    */
-    codes: require('../core/status-codes'),
-
-    /**
-    Generator options.
-    */
-    opts: {
-
-    }
-
-  });
-}());

src/gen/html-generator.js

@@ -1,31 +0,0 @@
-/**
-Definition of the HTMLGenerator class.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module html-generator.js
-*/
-
-(function() {
-
-  var TemplateGenerator = require('./template-generator')
-    , FS = require('fs-extra')
-    , HTML = require( 'html' )
-    , PATH = require('path');
-
-  var HtmlGenerator = module.exports = TemplateGenerator.extend({
-
-    init: function() {
-      this._super( 'html' );
-    },
-
-    /**
-    Copy satellite CSS files to the destination and optionally pretty-print
-    the HTML resume prior to saving.
-    */
-    onBeforeSave: function( info ) {
-      return this.opts.prettify ?
-        HTML.prettyPrint( info.mk, this.opts.prettify ) : info.mk;
-    }
-
-  });
-
-}());

src/gen/html-pdf-generator.js

@@ -1,81 +0,0 @@
-/**
-Definition of the HtmlPdfGenerator class.
-@module html-pdf-generator.js
-@license MIT. See LICENSE.md for details.
-*/
-
-(function() {
-
-  var TemplateGenerator = require('./template-generator')
-    , FS = require('fs-extra')
-    , HTML = require( 'html' );
-
-  /**
-  An HTML-driven PDF resume generator for HackMyResume.
-  */
-  var HtmlPdfGenerator = module.exports = TemplateGenerator.extend({
-
-    init: function() {
-      this._super( 'pdf', 'html' );
-    },
-
-    /**
-    Generate the binary PDF.
-    */
-    onBeforeSave: function( info ) {
-      engines[ info.opts.pdf || 'wkhtmltopdf' ]
-      .call( this, info.mk, info.outputFile );
-      return null; // halt further processing
-    }
-
-  });
-
-
-  var engines = {
-    /**
-    Generate a PDF from HTML using wkhtmltopdf.
-    */
-    wkhtmltopdf: function(markup, fOut) {
-      var wk;
-      try {
-        wk = require('wkhtmltopdf');
-        wk( markup, { pageSize: 'letter' } )
-          .pipe( FS.createWriteStream( fOut ) );
-      }
-      catch(ex) {
-        // { [Error: write EPIPE] code: 'EPIPE', errno: 'EPIPE', ... }
-        // { [Error: ENOENT] }
-        throw { fluenterror: this.codes.wkhtmltopdf };
-      }
-    },
-
-    /**
-    Generate a PDF from HTML using Phantom.
-    */
-    phantom: function( markup, fOut ) {
-      require('phantom').create( function( ph ) {
-        ph.createPage( function( page ) {
-          page.setContent( markup );
-          page.set('paperSize', {
-            format: 'A4',
-            orientation: 'portrait',
-            margin: '1cm'
-          });
-          page.set("viewportSize", {
-            width: 1024, // TODO: option-ify
-            height: 768 // TODO: Use "A" sizes
-          });
-          page.set('onLoadFinished', function(success) {
-            page.render( fOut );
-            ph.exit();
-          });
-        },
-        { dnodeOpts: {  weak: false   } } );
-      });
-    }
-
-  };
-
-
-
-}());

src/gen/html-png-generator.js

@@ -1,47 +0,0 @@
-/**
-Definition of the HtmlPngGenerator class.
-@license MIT. See LICENSE.MD for details.
-@module html-png-generator.js
-*/
-
-(function() {
-
-  var TemplateGenerator = require('./template-generator')
-    , FS = require('fs-extra')
-    , HTML = require( 'html' );
-
-  /**
-  An HTML-based PNG resume generator for HackMyResume.
-  */
-  var HtmlPngGenerator = module.exports = TemplateGenerator.extend({
-
-    init: function() {
-      this._super( 'png', 'html' );
-    },
-
-    invoke: function( rez, themeMarkup, cssInfo, opts ) {
-      //return YAML.stringify( JSON.parse( rez.stringify() ), Infinity, 2 );
-    },
-
-    generate: function( rez, f, opts ) {
-      var htmlResults = opts.targets.filter(function(t){
-        return t.fmt.outFormat === 'html';
-      });
-      var htmlFile = htmlResults[0].final.files.filter(function(fl){
-        return fl.info.ext === 'html';
-      });
-      png(htmlFile[0].data, f);
-    }
-
-  });
-
-  /**
-  Generate a PNG from HTML.
-  */
-  function png( markup, fOut ) {
-    // require('webshot')( markup , { encoding: 'binary', siteType: 'html' } )
-    //   .pipe( FS.createWriteStream( fOut ) );
-    require('webshot')( markup , fOut, { siteType: 'html' }, function(err) { } );
-  }
-
-}());

src/gen/json-generator.js

@@ -1,36 +0,0 @@
-/**
-Definition of the JsonGenerator class.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module json-generator.js
-*/
-
-var BaseGenerator = require('./base-generator');
-var FS = require('fs');
-var _ = require('underscore');
-
-/**
-The JsonGenerator generates a JSON resume directly.
-*/
-var JsonGenerator = module.exports = BaseGenerator.extend({
-
-  init: function(){
-    this._super( 'json' );
-  },
-
-  invoke: function( rez ) {
-    // TODO: merge with FCVD
-    function replacer( key,value ) { // Exclude these keys from stringification
-      return _.some(['imp', 'warnings', 'computed', 'filt', 'ctrl', 'index',
-        'safeStartDate', 'safeEndDate', 'safeDate', 'safeReleaseDate', 'result',
-      'isModified', 'htmlPreview', 'safe' ],
-        function( val ) { return key.trim() === val; }
-      ) ? undefined : value;
-    }
-    return JSON.stringify( rez, replacer, 2 );
-  },
-
-  generate: function( rez, f ) {
-    FS.writeFileSync( f, this.invoke(rez), 'utf8' );
-  }
-
-});

src/gen/json-yaml-generator.js

@@ -1,37 +0,0 @@
-/**
-Definition of the JsonYamlGenerator class.
-@module json-yaml-generator.js
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-*/
-
-(function() {
-
-  var BaseGenerator = require('./base-generator');
-  var FS = require('fs');
-  var YAML = require('yamljs');
-
-  /**
-  JsonYamlGenerator takes a JSON resume object and translates it directly to
-  JSON without a template, producing an equivalent YAML-formatted resume. See
-  also YamlGenerator (yaml-generator.js).
-  */
-
-  var JsonYamlGenerator = module.exports = BaseGenerator.extend({
-
-    init: function(){
-      this._super( 'yml' );
-    },
-
-    invoke: function( rez, themeMarkup, cssInfo, opts ) {
-      return YAML.stringify( JSON.parse( rez.stringify() ), Infinity, 2 );
-    },
-
-    generate: function( rez, f, opts ) {
-      var data = YAML.stringify( JSON.parse( rez.stringify() ), Infinity, 2 );
-      FS.writeFileSync( f, data, 'utf8' );
-    }
-
-
-  });
-
-}());

src/gen/latex-generator.js

@@ -1,18 +0,0 @@
-/**
-Definition of the LaTeXGenerator class.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module latex-generator.js
-*/
-
-var TemplateGenerator = require('./template-generator');
-
-/**
-LaTeXGenerator generates a LaTeX resume via TemplateGenerator.
-*/
-var LaTeXGenerator = module.exports = TemplateGenerator.extend({
-
-  init: function(){
-    this._super( 'latex', 'tex' );
-  }
-
-});

src/gen/markdown-generator.js

@@ -1,18 +0,0 @@
-/**
-Definition of the MarkdownGenerator class.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module markdown-generator.js
-*/
-
-var TemplateGenerator = require('./template-generator');
-
-/**
-MarkdownGenerator generates a Markdown-formatted resume via TemplateGenerator.
-*/
-var MarkdownGenerator = module.exports = TemplateGenerator.extend({
-
-  init: function(){
-    this._super( 'md', 'txt' );
-  }
-
-});

src/gen/template-generator.js

@@ -1,318 +0,0 @@
-/**
-Definition of the TemplateGenerator class.
-@license MIT. See LICENSE.md for details.
-@module template-generator.js
-*/
-
-(function() {
-
-
-
-  var FS = require( 'fs-extra' )
-    , _ = require( 'underscore' )
-    , MD = require( 'marked' )
-    , XML = require( 'xml-escape' )
-    , PATH = require('path')
-    , parsePath = require('parse-filepath')
-    , MKDIRP = require('mkdirp')
-    , BaseGenerator = require( './base-generator' )
-    , EXTEND = require('../utils/extend')
-    , FRESHTheme = require('../core/fresh-theme')
-    , JRSTheme = require('../core/jrs-theme');
-
-
-
-  // Default options.
-  var _defaultOpts = {
-    engine: 'underscore',
-    keepBreaks: true,
-    freezeBreaks: false,
-    nSym: '&newl;', // newline entity
-    rSym: '&retn;', // return entity
-    template: {
-      interpolate: /\{\{(.+?)\}\}/g,
-      escape: /\{\{\=(.+?)\}\}/g,
-      evaluate: /\{\%(.+?)\%\}/g,
-      comment: /\{\#(.+?)\#\}/g
-    },
-    filters: {
-      out: function( txt ) { return txt; },
-      raw: function( txt ) { return txt; },
-      xml: function( txt ) { return XML(txt); },
-      md: function( txt ) { return MD( txt || '' ); },
-      mdin: function( txt ) {
-        return MD(txt || '' ).replace(/^\s*<p>|<\/p>\s*$/gi, '');
-      },
-      lower: function( txt ) { return txt.toLowerCase(); },
-      link: function( name, url ) { return url ?
-        '<a href="' + url + '">' + name + '</a>' : name; }
-    },
-    prettify: { // ← See https://github.com/beautify-web/js-beautify#options
-      indent_size: 2,
-      unformatted: ['em','strong','a'],
-      max_char: 80, // ← See lib/html.js in above-linked repo
-      //wrap_line_length: 120, <-- Don't use this
-    }
-  };
-
-
-
-  /**
-  TemplateGenerator performs resume generation via local Handlebar or Underscore
-  style template expansion and is appropriate for text-based formats like HTML,
-  plain text, and XML versions of Microsoft Word, Excel, and OpenOffice.
-  @class TemplateGenerator
-  */
-  var TemplateGenerator = module.exports = BaseGenerator.extend({
-
-
-
-    init: function( outputFormat, templateFormat, cssFile ){
-      this._super( outputFormat );
-      this.tplFormat = templateFormat || outputFormat;
-    },
-
-
-    /**
-    String-based template generation method.
-    @method invoke
-    @param rez A FreshResume object.
-    @param opts Generator options.
-    @returns An array of objects representing the generated output files. Each
-    object has this format:
-
-        {
-          files: [ { info: { }, data: [ ] }, { ... } ],
-          themeInfo: { }
-        }
-
-    */
-    invoke: function( rez, opts ) {
-
-      // Carry over options
-      this.opts = EXTEND( true, { }, _defaultOpts, opts );
-
-      // Load the theme
-      var themeInfo = themeFromMoniker.call( this );
-      var theme = themeInfo.theme;
-      var tFolder = themeInfo.folder;
-      var tplFolder = PATH.join( tFolder, 'src' );
-      var curFmt = theme.getFormat( this.format );
-      var that = this;
-
-      // "Generate": process individual files within the theme
-      return {
-        files: curFmt.files.map( function( tplInfo ) {
-          return {
-            info: tplInfo,
-            data: tplInfo.action === 'transform' ?
-              transform.call( that, rez, tplInfo, theme ) : undefined
-          };
-        }).filter(function(item){ return item !== null; }),
-        themeInfo: themeInfo
-      };
-
-    },
-
-
-
-    /**
-    File-based template generation method.
-    @method generate
-    @param rez A FreshResume object.
-    @param f Full path to the output resume file to generate.
-    @param opts Generator options.
-    */
-    generate: function( rez, f, opts ) {
-
-      // Call the generation method
-      var genInfo = this.invoke( rez, opts );
-
-      // Carry over options
-      this.opts = EXTEND( true, { }, _defaultOpts, opts );
-
-      // Load the theme
-      var themeInfo = genInfo.themeInfo;
-      var theme = themeInfo.theme;
-      var tFolder = themeInfo.folder;
-      var tplFolder = PATH.join( tFolder, 'src' );
-      var outFolder = parsePath(f).dirname;
-      var curFmt = theme.getFormat( this.format );
-      var that = this;
-
-      // "Generate": process individual files within the theme
-      genInfo.files.forEach(function( file ){
-
-        var thisFilePath;
-
-        if( file.info.action === 'transform' ) {
-          thisFilePath = PATH.join( outFolder, file.info.orgPath );
-          try {
-            if( that.onBeforeSave ) {
-              file.data = that.onBeforeSave({
-                theme: theme,
-                outputFile: (file.info.major ? f : thisFilePath),
-                mk: file.data,
-                opts: that.opts
-              });
-              if( !file.data ) return; // PDF etc
-            }
-            var fileName = file.info.major ? f : thisFilePath;
-            MKDIRP.sync( PATH.dirname( fileName ) );
-            FS.writeFileSync( fileName, file.data,
-              { encoding: 'utf8', flags: 'w' } );
-            that.onAfterSave && that.onAfterSave(
-              { outputFile: fileName, mk: file.data, opts: that.opts } );
-          }
-          catch(ex) {
-            require('../core/error-handler').err(ex, false);
-          }
-        }
-        else if( file.info.action === null/* && theme.explicit*/ ) {
-          thisFilePath = PATH.join( outFolder, file.info.orgPath );
-          try {
-            MKDIRP.sync( PATH.dirname(thisFilePath) );
-            FS.copySync( file.info.path, thisFilePath );
-          }
-          catch(ex) {
-            console.log(ex);
-          }
-        }
-      });
-
-      // Some themes require a symlink structure. If so, create it.
-      if( curFmt.symLinks ) {
-        Object.keys( curFmt.symLinks ).forEach( function(loc) {
-          var absLoc = PATH.join(outFolder, loc);
-          var absTarg = PATH.join(PATH.dirname(absLoc), curFmt.symLinks[loc]);
-           // 'file', 'dir', or 'junction' (Windows only)
-          var type = parsePath( absLoc ).extname ? 'file' : 'junction';
-          FS.symlinkSync( absTarg, absLoc, type);
-        });
-      }
-
-      return genInfo;
-
-    },
-
-
-
-    /**
-    Perform a single resume JSON-to-DEST resume transformation.
-    @param json A FRESH or JRS resume object.
-    @param jst The stringified template data
-    @param format The format name, such as "html" or "latex"
-    @param cssInfo Needs to be refactored.
-    @param opts Options and passthrough data.
-    */
-    single: function( json, jst, format, cssInfo, opts, theme ) {
-      this.opts.freezeBreaks && ( jst = freeze(jst) );
-
-      var eng = require( '../eng/' + theme.engine  + '-generator' );
-      var result = eng.generate( json, jst, format, cssInfo, opts, theme );
-
-      this.opts.freezeBreaks && ( result = unfreeze(result) );
-      return result;
-    }
-
-
-  });
-
-
-
-  /**
-  Export the TemplateGenerator function/ctor.
-  */
-  module.exports = TemplateGenerator;
-
-
-
-  /**
-  Given a theme title, load the corresponding theme.
-  */
-  function themeFromMoniker() {
-
-    // Verify the specified theme name/path
-    var tFolder = PATH.join(
-      parsePath( require.resolve('fresh-themes') ).dirname,
-      '/themes/',
-      this.opts.theme
-    );
-
-    var t;
-    if( this.opts.theme.startsWith('jsonresume-theme-') ) {
-      t = new JRSTheme().open( tFolder );
-    }
-    else {
-      var exists = require('path-exists').sync;
-      if( !exists( tFolder ) ) {
-        tFolder = PATH.resolve( this.opts.theme );
-        if( !exists( tFolder ) ) {
-          throw { fluenterror: this.codes.themeNotFound, data: this.opts.theme};
-        }
-      }
-      t = this.opts.themeObj || new FRESHTheme().open( tFolder );
-    }
-
-    // Load the theme and format
-    return {
-      theme: t,
-      folder: tFolder
-    };
-  }
-
-
-
-  function transform( rez, tplInfo, theme ) {
-    try {
-      var cssInfo = {
-        file: tplInfo.css ? tplInfo.cssPath : null,
-        data: tplInfo.css || null
-      };
-
-      return this.single( rez, tplInfo.data, this.format, cssInfo, this.opts,
-        theme );
-    }
-    catch(ex) {
-      console.log(ex);
-      throw ex;
-    }
-  }
-
-
-
-  /**
-  Freeze newlines for protection against errant JST parsers.
-  */
-  function freeze( markup ) {
-    return markup
-      .replace( _reg.regN, _defaultOpts.nSym )
-      .replace( _reg.regR, _defaultOpts.rSym );
-  }
-
-
-
-  /**
-  Unfreeze newlines when the coast is clear.
-  */
-  function unfreeze( markup ) {
-    return markup
-      .replace( _reg.regSymR, '\r' )
-      .replace( _reg.regSymN, '\n' );
-  }
-
-
-
-  /**
-  Regexes for linebreak preservation.
-  */
-  var _reg = {
-    regN: new RegExp( '\n', 'g' ),
-    regR: new RegExp( '\r', 'g' ),
-    regSymN: new RegExp( _defaultOpts.nSym, 'g' ),
-    regSymR: new RegExp( _defaultOpts.rSym, 'g' )
-  };
-
-
-
-}());

src/gen/text-generator.js

@@ -1,20 +0,0 @@
-/**
-Definition of the TextGenerator class.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module text-generator.js
-*/
-
-var TemplateGenerator = require('./template-generator');
-
-/**
-The TextGenerator generates a plain-text resume via the TemplateGenerator.
-*/
-var TextGenerator = TemplateGenerator.extend({
-
-  init: function(){
-    this._super( 'txt' );
-  },
-
-});
-
-module.exports = TextGenerator;

src/gen/word-generator.js

@@ -1,19 +0,0 @@
-/**
-Definition of the WordGenerator class.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module word-generator.js
-*/
-
-(function() {
-
-  var TemplateGenerator = require('./template-generator');
-  var WordGenerator = module.exports = TemplateGenerator.extend({
-
-    init: function(){
-      this._super( 'doc', 'xml' );
-    }
-
-  });
-
-
-}());

src/gen/xml-generator.js

@@ -1,18 +0,0 @@
-/**
-Definition of the XMLGenerator class.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module xml-generator.js
-*/
-
-var BaseGenerator = require('./base-generator');
-
-/**
-The XmlGenerator generates an XML resume via the TemplateGenerator.
-*/
-var XMLGenerator = module.exports = BaseGenerator.extend({
-
-  init: function(){
-    this._super( 'xml' );
-  },
-
-});

src/gen/yaml-generator.js

@@ -1,24 +0,0 @@
-/**
-Definition of the YAMLGenerator class.
-@module yaml-generator.js
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-*/
-
-
-(function() {
-
-  var TemplateGenerator = require('./template-generator');
-
-  /**
-  YamlGenerator generates a YAML-formatted resume via TemplateGenerator.
-  */
-
-  var YAMLGenerator = module.exports = TemplateGenerator.extend({
-
-    init: function(){
-      this._super( 'yml', 'yml' );
-    }
-
-  });
-
-}());

src/hackmyapi.js

@@ -1,43 +0,0 @@
-/**
-External API surface for HackMyResume.
-@license MIT. Copyright (c) 2015 James M. Devlin / FluentDesk.
-@module hackmyapi.js
-*/
-
-(function() {
-
-  var v = {
-    build: require('./verbs/generate'),
-    analyze: require('./verbs/analyze'),
-    validate: require('./verbs/validate'),
-    convert: require('./verbs/convert'),
-    new: require('./verbs/create')
-  };
-
-  var HackMyAPI = module.exports = {
-    verbs: v,
-    alias: {
-      generate: v.build,
-      create: v.new
-    },
-    options: require('./core/default-options'),
-    formats: require('./core/default-formats'),
-    Sheet: require('./core/fresh-resume'),
-    FRESHResume: require('./core/fresh-resume'),
-    JRSResume: require('./core/jrs-resume'),
-    FRESHTheme: require('./core/fresh-theme'),
-    JRSTheme: require('./core/jrs-theme'),
-    FluentDate: require('./core/fluent-date'),
-    HtmlGenerator: require('./gen/html-generator'),
-    TextGenerator: require('./gen/text-generator'),
-    HtmlPdfGenerator: require('./gen/html-pdf-generator'),
-    WordGenerator: require('./gen/word-generator'),
-    MarkdownGenerator: require('./gen/markdown-generator'),
-    JsonGenerator: require('./gen/json-generator'),
-    YamlGenerator: require('./gen/yaml-generator'),
-    JsonYamlGenerator: require('./gen/json-yaml-generator'),
-    LaTeXGenerator: require('./gen/latex-generator'),
-    HtmlPngGenerator: require('./gen/html-png-generator')
-  };
-
-}());

src/index.js

@@ -4,239 +4,19 @@
 
 /**
 Command-line interface (CLI) for HackMyResume.
-@license MIT. Copyright (c) 2015 hacksalot (https://github.com/hacksalot)
+@license MIT. See LICENSE.md for details.
 @module index.js
 */
 
 
 
-var SPAWNW = require('./core/spawn-watch')
-  , HMR  = require( './hackmyapi')
-  , PKG = require('../package.json')
-  , FS = require('fs')
-  , EXTEND = require('./utils/extend')
-  , chalk = require('chalk')
-  , PATH = require('path')
-  , HACKMYSTATUS = require('./core/status-codes')
-  , safeLoadJSON = require('./utils/safe-json-loader')
-  , _opts = { }
-  , title = chalk.white.bold('\n*** HackMyResume v' + PKG.version + ' ***')
-  , StringUtils = require('./utils/string.js')
-  , _ = require('underscore')
-  , Command = require('commander').Command;
-
-
-
 try {
-  main();
+
+  require('./cli/main')( process.argv );
+
 }
 catch( ex ) {
-  require('./core/error-handler').err( ex, true );
-}
 
-
-/**
-Kick off the HackMyResume application.
-*/
-function main() {
-
-  var args = initialize();
-
-  // Create the top-level (application) command...
-  var program = new Command('hackmyresume')
-    .version(PKG.version)
-    .description(chalk.yellow.bold('*** HackMyResume ***'))
-    .option('-o --opts <optionsFile>', 'Path to a .hackmyrc options file')
-    .option('-s --silent', 'Run in silent mode')
-    .option('--no-color', 'Disable colors')
-    .option('--color', 'Enable colors');
-    //.usage('COMMAND <sources> [TO <targets>]');
-
-  // Create the NEW command
-  program
-    .command('new')
-    .arguments('<sources...>')
-    .option('-f --format <fmt>', 'FRESH or JRS format', 'FRESH')
-    .alias('create')
-    .description('Create resume(s) in FRESH or JSON RESUME format.')
-    .action(function( sources ) {
-      execVerb.call( this, sources, [], this.opts(), logMsg);
-    });
-
-  // Create the VALIDATE command
-  program
-    .command('validate')
-    .arguments('<sources...>')
-    .option('-a --assert', 'Treat validation warnings as errors', false)
-    .description('Validate a resume in FRESH or JSON RESUME format.')
-    .action(function(sources) {
-      execVerb.call( this, sources, [], this.opts(), logMsg);
-    });
-
-  // Create the CONVERT command
-  program
-    .command('convert')
-    //.arguments('<sources...>')
-    .description('Convert a resume to/from FRESH or JSON RESUME format.')
-    .action(function() {
-      var x = splitSrcDest.call( this );
-      execVerb.call( this, x.src, x.dst, this.opts(), logMsg);
-    });
-
-  // Create the ANALYZE command
-  program
-    .command('analyze')
-    .arguments('<sources...>')
-    .description('Analyze one or more resumes.')
-    .action(function( sources ) {
-      execVerb.call( this, sources, [], this.opts(), logMsg);
-    });
-
-  // Create the BUILD command
-  program
-    .command('build')
-    .alias('generate')
-    //.arguments('<sources> TO [targets]')
-    //.usage('...')
-    .option('-t --theme <theme>', 'Theme name or path')
-    .option('-n --no-prettify', 'Disable HTML prettification', true)
-    .option('-c --css <option>', 'CSS linking / embedding', 'embed')
-    .option('-p --pdf <engine>', 'PDF generation engine')
-    .option('--no-tips', 'Disable theme tips and warnings.', false)
-    .description('Generate resume to multiple formats')
-    .action(function( sources, targets, options ) {
-      var x = splitSrcDest.call( this );
-      execVerb.call( this, x.src, x.dst, this.opts(), logMsg);
-    });
-
-  // program.on('--help', function(){
-  //   console.log('  Examples:');
-  //   console.log('');
-  //   console.log('    $ custom-help --help');
-  //   console.log('    $ custom-help -h');
-  //   console.log('');
-  // });
-
-  program.parse( args );
-
-  if (!program.args.length) { throw { fluenterror: 4 }; }
+  require('./cli/error').err( ex, true );
 
 }
-
-
-
-
-
-/**
-Massage command-line args and setup Commander.js.
-*/
-function initialize() {
-
-  logMsg( title );
-
-  // Support case-insensitive sub-commands (build, generate, validate, etc.)..
-  var oVerb, verb = '', args = process.argv.slice(), cleanArgs = args.slice(2);
-  if( cleanArgs.length ) {
-    var verbIdx = _.findIndex( cleanArgs, function(v){ return v[0] !== '-'; });
-    if( verbIdx !== -1 ) {
-      oVerb = cleanArgs[ verbIdx ];
-      verb = args[ verbIdx + 2 ] = oVerb.trim().toLowerCase();
-    }
-  }
-
-  // Handle invalid verbs here (a bit easier here than in commander.js)...
-  if( verb && !HMR.verbs[ verb ] && !HMR.alias[ verb ] ) {
-    throw { fluenterror: HACKMYSTATUS.invalidCommand, shouldExit: true,
-            attempted: oVerb };
-  }
-
-  // Override the .missingArgument behavior
-  Command.prototype.missingArgument = function(name) {
-    if( this.name() !== 'new' )
-      throw { fluenterror: HACKMYSTATUS.resumeNotFound };
-  };
-
-  // Override the .helpInformation behavior
-  Command.prototype.helpInformation = function() {
-    var manPage = FS.readFileSync( PATH.join(__dirname, 'use.txt'), 'utf8' );
-    return chalk.green.bold(manPage);
-  };
-
-  return args;
-}
-
-
-
-/**
-Invoke a HackMyResume verb.
-*/
-function execVerb( src, dst, opts, log ) {
-  loadOptions.call( this, opts );
-  HMR.verbs[ this.name() ].call( null, src, dst, _opts, log );
-}
-
-
-
-/**
-Initialize HackMyResume options.
-*/
-function loadOptions( opts ) {
-
-  opts.opts = this.parent.opts;
-
-  // Load the specified options file (if any) and apply options
-  if( opts.opts && String.is( opts.opts )) {
-    var json = safeLoadJSON( PATH.relative( process.cwd(), opts.opts ) );
-    json && ( opts = EXTEND( true, opts, json ) );
-    if( !json ) {
-      throw safeLoadJSON.error;
-    }
-  }
-
-  // Merge in command-line options
-  opts = EXTEND( true, opts, this.opts() );
-  opts.silent = this.parent.silent;
-  _opts = opts;
-}
-
-
-
-/**
-Split multiple command-line filenames by the 'TO' keyword
-*/
-function splitSrcDest() {
-
-  var params = this.parent.args.filter(function(j) { return String.is(j); });
-  if( params.length === 0 )
-    throw { fluenterror: HACKMYSTATUS.resumeNotFound };
-
-  // Find the TO keyword, if any
-  var splitAt = _.findIndex( params, function(p) {
-    return p.toLowerCase() === 'to';
-  });
-
-  // TO can't be the last keyword
-  if( splitAt === params.length - 1 && splitAt !== -1 ) {
-    logMsg(chalk.yellow('Please ') +
-      chalk.yellow.bold('specify an output file') +
-      chalk.yellow(' for this operation or ') +
-      chalk.yellow.bold('omit the TO keyword') +
-      chalk.yellow('.') );
-    return;
-  }
-
-  return {
-    src: params.slice(0, splitAt === -1 ? undefined : splitAt ),
-    dst: splitAt === -1 ? [] : params.slice( splitAt + 1 )
-  };
-}
-
-
-
-/**
-Simple logging placeholder.
-*/
-function logMsg( msg ) {
-  msg = msg || '';
-  _opts.silent || console.log( msg );
-}

src/inspectors/gap-inspector.js

@@ -1,151 +0,0 @@
-/**
-Employment gap analysis for HackMyResume.
-@license MIT. See LICENSE.md for details.
-@module gap-inspector.js
-*/
-
-
-
-(function() {
-
-
-
-  var _ = require('underscore');
-  var FluentDate = require('../core/fluent-date');
-  var moment = require('moment');
-  var LO = require('lodash');
-
-
-
-  /**
-  Identify gaps in the candidate's employment history.
-  @class gapInspector
-  */
-  var gapInspector = module.exports = {
-
-
-
-    moniker: 'gap-inspector',
-
-
-
-    /**
-    Run the Gap Analyzer on a resume.
-    @method run
-    @return An array of object representing gaps in the candidate's employment
-    history. Each object provides the start, end, and duration of the gap:
-        { <-- gap
-          start: // A Moment.js date
-          end: // A Moment.js date
-          duration: // Gap length
-        }
-    */
-    run: function( rez ) {
-
-      // This is what we'll return
-      var coverage = {
-        gaps: [],
-        overlaps: [],
-        duration: {
-          total: 0,
-          work: 0,
-          gaps: 0
-        },
-        pct: '0%'
-      };
-
-      // Missing employment section? Bye bye.
-      var hist = LO.get( rez, 'employment.history' );
-      if( !hist || !hist.length ) { return coverage; }
-
-      // Convert the candidate's employment history to an array of dates,
-      // where each element in the array is a start date or an end date of a
-      // job -- it doesn't matter which.
-      var new_e = hist.map( function( job ){
-        var obj = _.pick( job, ['start', 'end'] );
-        if( obj && (obj.start || obj.end)) {
-          obj = _.pairs( obj );
-          obj[0][1] = FluentDate.fmt( obj[0][1] );
-          if( obj.length > 1 )
-            obj[1][1] = FluentDate.fmt( obj[1][1] );
-        }
-        return obj;
-      });
-
-
-      // Flatten the array, remove empties, and sort
-      new_e = _.filter( _.flatten( new_e, true ), function(v) {
-        return ( v && v.length && v[0] && v[0].length );
-      });
-      if( !new_e || !new_e.length ) return coverage;
-      new_e = _.sortBy( new_e, function( elem ) { return elem[1].unix(); });
-
-      // Iterate over elements in the array. Each time a start date is found,
-      // increment a reference count. Each time an end date is found, decrement
-      // the reference count. When the reference count reaches 0, we have a gap.
-      // When the reference count is > 0, the candidate is employed. When the
-      // reference count reaches 2, the candidate is overlapped.
-
-      var num_gaps = 0, ref_count = 0, total_gap_days = 0, total_work_days = 0
-        , gap_start;
-
-      new_e.forEach( function(point) {
-        var inc = point[0] === 'start' ? 1 : -1;
-        ref_count += inc;
-        if( ref_count === 0 ) {
-          coverage.gaps.push( { start: point[1], end: null });
-        }
-        else if( ref_count === 1 && inc === 1 ) {
-          var lastGap = _.last( coverage.gaps );
-          if( lastGap ) {
-            lastGap.end = point[1];
-            lastGap.duration = lastGap.end.diff( lastGap.start, 'days' );
-            total_gap_days += lastGap.duration;
-          }
-        }
-        else if( ref_count === 2 && inc === 1 ) {
-          coverage.overlaps.push( { start: point[1], end: null });
-        }
-        else if( ref_count === 1 && inc === -1 ) {
-          var lastOver = _.last( coverage.overlaps );
-          if( lastOver ) {
-            lastOver.end = point[1];
-            lastOver.duration = lastOver.end.diff( lastOver.start, 'days' );
-            if( lastOver.duration === 0 ) {
-              coverage.overlaps.pop();
-            }
-            total_work_days += lastOver.duration;
-          }
-        }
-      });
-
-      // It's possible that the last overlap didn't have an explicit .end date.
-      // If so, set the end date to the present date and compute the overlap
-      // duration normally.
-      if( coverage.overlaps.length ) {
-        if( !_.last( coverage.overlaps ).end ) {
-          var l = _.last( coverage.overlaps );
-          l.end = moment();
-          l.duration = l.end.diff( l.start, 'days' );
-        }
-      }
-
-      var dur = {
-        total: rez.duration('days'),
-        work: total_work_days,
-        gaps: total_gap_days
-      };
-      coverage.pct = ( dur.total > 0 && dur.work > 0 ) ?
-        ((((dur.total - dur.gaps) / dur.total) * 100)).toFixed(1) + '%' :
-        '???';
-      coverage.duration = dur;
-
-      return coverage;
-    }
-
-
-  };
-
-
-
-}());

src/inspectors/keyword-inspector.js

@@ -1,71 +0,0 @@
-/**
-Keyword analysis for HackMyResume.
-@license MIT. See LICENSE.md for details.
-@module keyword-inspector.js
-*/
-
-
-
-(function() {
-
-
-
-  var _ = require('underscore');
-  var FluentDate = require('../core/fluent-date');
-
-
-
-  /**
-  Analyze the resume's use of keywords.
-  @class keywordInspector
-  */
-  var keywordInspector = module.exports = {
-
-
-
-    /**
-    A unique name for this inspector.
-    */
-    moniker: 'keyword-inspector',
-
-
-
-    /**
-    Run the Keyword Inspector on a resume.
-    @method run
-    @return An collection of statistical keyword data.
-    */
-    run: function( rez ) {
-
-      // http://stackoverflow.com/a/2593661/4942583
-      function regex_quote(str) {
-        return (str + '').replace(/[.?*+^$[\]\\(){}|-]/ig, "\\$&");
-      }
-
-      var searchable = '';
-      rez.transformStrings( ['imp', 'computed', 'safe'], function trxString( key, val ) {
-        searchable += ' ' + val;
-      });
-
-      return rez.keywords().map(function(kw) {
-        //var regex = new RegExp( '\\b' + regex_quote( kw )/* + '\\b'*/, 'ig');
-        var regex = new RegExp( regex_quote( kw ), 'ig');
-        var myArray, count = 0;
-        while ((myArray = regex.exec( searchable )) !== null) {
-          count++;
-        }
-        return {
-          name: kw,
-          count: count
-        };
-
-      });
-    }
-
-
-
-  };
-
-
-
-}());

src/inspectors/totals-inspector.js

@@ -1,59 +0,0 @@
-/**
-Section analysis for HackMyResume.
-@license MIT. See LICENSE.md for details.
-@module totals-inspector.js
-*/
-
-
-
-(function() {
-
-
-
-  var _ = require('underscore');
-  var FluentDate = require('../core/fluent-date');
-
-
-
-  /**
-  Retrieve sectional overview and summary information.
-  @class totalsInspector
-  */
-  var totalsInspector = module.exports = {
-
-
-
-    moniker: 'totals-inspector',
-
-
-
-    /**
-    Run the Totals Inspector on a resume.
-    @method run
-    @return An array of objects containing summary information for each section
-    on the resume.
-    */
-    run: function( rez ) {
-
-      var ret = { };
-      _.each( rez, function(val, key){
-        if( _.isArray( val ) && !_.isString(val) ) {
-          ret[ key ] = val.length;
-        }
-        else if( val.history && _.isArray( val.history ) ) {
-          ret[ key ] = val.history.length;
-        }
-        else if( val.sets && _.isArray( val.sets ) ) {
-          ret[ key ] = val.sets.length;
-        }
-      });
-
-      return ret;
-    }
-
-
-  };
-
-
-
-}());

src/use.txt

@@ -1,27 +0,0 @@
-Usage:
-
-    hackmyresume <COMMAND> <SOURCES> [TO <TARGETS>] [-t <THEME>] [-f <FORMAT>]
-
-<COMMAND> should be BUILD, NEW, CONVERT, VALIDATE, ANALYZE or HELP. <SOURCES>
-should be the path to one or more FRESH or JSON Resume format resumes. <TARGETS>
-should be the name of the destination resume to be created, if any. The <THEME>
-parameter should be the name of a predefined theme (for example: COMPACT,
-MINIMIST, MODERN, or HELLO-WORLD) or the relative path to a custom theme.
-<FORMAT> should be either FRESH (for a FRESH-format resume) or JRS (for a JSON
-Resume-format resume).
-
-    hackmyresume BUILD resume.json TO out/resume.all
-    hackmyresume NEW resume.json
-    hackmyresume CONVERT resume.json TO resume-jrs.json
-    hackmyresume ANALYZE resume.json
-    hackmyresume VALIDATE resume.json
-
-Both SOURCES and TARGETS can accept multiple files:
-
-    hackmyresume BUILD r1.json r2.json TO out/resume.all out2/resume.html
-    hackmyresume NEW r1.json r2.json r3.json
-    hackmyresume ANALYZE r1.json r2.json r3.json
-    hackmyresume VALIDATE resume.json resume2.json resume3.json
-
-See https://github.com/hacksalot/hackmyresume/blob/master/README.md for more
-information.

src/utils/class.js

@@ -1,72 +0,0 @@
-/**
-Definition of John Resig's `Class` class.
-@module class.js
-*/
-
-/* Simple JavaScript Inheritance
- * By John Resig http://ejohn.org/
- * MIT Licensed.
- * http://ejohn.org/blog/simple-javascript-inheritance/
- */
-// Inspired by base2 and Prototype
-(function(){
-  var initializing = false, fnTest = /xyz/.test(function(){xyz;}) ? /\b_super\b/ : /.*/;
-
-  // The base Class implementation (does nothing)
-  this.Class = function(){};
-  module.exports = Class;
-
-  // Create a new Class that inherits from this class
-  Class.extend = function(prop) {
-    var _super = this.prototype;
-
-    // Instantiate a base class (but only create the instance,
-    // don't run the init constructor)
-    initializing = true;
-    var prototype = new this();
-    initializing = false;
-
-    // Copy the properties over onto the new prototype
-    for (var name in prop) {
-      // Check if we're overwriting an existing function
-      prototype[name] = typeof prop[name] == "function" &&
-        typeof _super[name] == "function" && fnTest.test(prop[name]) ?
-        (function(name, fn){
-          return function() {
-            var tmp = this._super;
-
-            // Add a new ._super() method that is the same method
-            // but on the super-class
-            this._super = _super[name];
-
-            // The method only need to be bound temporarily, so we
-            // remove it when we're done executing
-            var ret = fn.apply(this, arguments);
-            this._super = tmp;
-
-            return ret;
-          };
-        })(name, prop[name]) : // jshint ignore:line
-        prop[name];
-    }
-
-    // The dummy class constructor
-    function Class() {
-      // All construction is actually done in the init method
-      if ( !initializing && this.init )
-        this.init.apply(this, arguments);
-    }
-
-    // Populate our constructed prototype object
-    Class.prototype = prototype;
-
-    // Enforce the constructor to be what we expect
-    Class.prototype.constructor = Class;
-
-    // And make this class extendable
-    Class.extend = arguments.callee;
-
-    return Class;
-  };
-
-})();

src/utils/extend.js

@@ -1,79 +0,0 @@
-/**
-Definition of the `extend` method.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module extend.js
-*/
-
-function _extend() {
-
-  function isPlainObject( obj ) {
-    if ((typeof obj !== "object") || obj.nodeType ||
-      (obj !== null && obj === obj.window)) {
-      return false;
-    }
-    if (obj.constructor &&
-      !hasOwnProperty.call( obj.constructor.prototype, "isPrototypeOf" )) {
-      return false;
-    }
-    return true;
-  }
-
-  var options
-    , name
-    , src
-    , copy
-    , copyIsArray
-    , clone
-    , target = arguments[0] || {}
-    , i = 1
-    , length = arguments.length
-    , deep = false;
-
-  // Handle a deep copy situation
-  if (typeof target === "boolean") {
-    deep = target;
-    // Skip the boolean and the target
-    target = arguments[i] || {};
-    i++;
-  }
-
-  // Handle case when target is a string or something (possible in deep copy)
-  //if (typeof target !== "object" && !jQuery.isFunction(target))
-  if (typeof target !== "object" && typeof target !== "function")
-    target = {};
-
-  for (; i < length; i++) {
-    // Only deal with non-null/undefined values
-    if ((options = arguments[i]) !== null) {
-      // Extend the base object
-      for (name in options) {
-        src = target[name];
-        copy = options[name];
-
-        // Prevent never-ending loop
-        if (target === copy) continue;
-
-        // Recurse if we're merging plain objects or arrays
-        if (deep && copy && (isPlainObject(copy) ||
-          (copyIsArray = (copy.constructor === Array)))) {
-          if (copyIsArray) {
-            copyIsArray = false;
-            clone = src && (src.constructor === Array) ? src : [];
-          } else {
-            clone = src && isPlainObject(src) ? src : {};
-          }
-          // Never move original objects, clone them
-          target[name] = _extend(deep, clone, copy);
-          // Don't bring in undefined values
-        } else if (copy !== undefined) {
-          target[name] = copy;
-        }
-      }
-    }
-  }
-
-  // Return the modified object
-  return target;
-}
-
-module.exports = _extend;

src/utils/file-contains.js

@@ -1,12 +0,0 @@
-/**
-Definition of the SyntaxErrorEx class.
-@module file-contains.js
-*/
-
-(function(){
-
-  module.exports = function( file, needle ) {
-    return require('fs').readFileSync(file,'utf-8').indexOf( needle ) > -1;
-  };
-
-}());

src/utils/html-to-wpml.js

@@ -1,66 +0,0 @@
-/**
-Definition of the Markdown to WordProcessingML conversion routine.
-@license MIT. Copyright (c) 2015 James Devlin / FluentDesk.
-@module html-to-wpml.js
-*/
-
-(function(){
-
-  var _ = require('underscore');
-  var HTML5Tokenizer = require('simple-html-tokenizer');
-
-  module.exports = function( html ) {
-
-    // Tokenize the HTML stream.
-    var tokens = HTML5Tokenizer.tokenize( html );
-
-    var final = '', is_bold, is_italic, is_link, link_url;
-
-    // Process <em>, <strong>, and <a> elements in the HTML stream, producing
-    // equivalent WordProcessingML that can be dumped into a <w:p> or other
-    // text container element.
-    _.each( tokens, function( tok ) {
-
-      switch( tok.type ) {
-
-        case 'StartTag':
-          switch( tok.tagName ) {
-            case 'p': final += '<w:p>'; break;
-            case 'strong': is_bold = true; break;
-            case 'em': is_italic = true; break;
-            case 'a':
-              is_link = true;
-              link_url = tok.attributes.filter(function(attr){
-                return attr[0] === 'href'; }
-              )[0][1];
-              break;
-          }
-          break;
-
-        case 'EndTag':
-          switch( tok.tagName ) {
-            case 'p': final += '</w:p>'; break;
-            case 'strong': is_bold = false; break;
-            case 'em': is_italic = false; break;
-            case 'a': is_link = false; break;
-          }
-          break;
-
-        case 'Chars':
-          if( tok.chars.trim().length ) {
-          var style = is_bold ? '<w:b/>' : '';
-          style += is_italic ? '<w:i/>': '';
-          style += is_link ? '<w:rStyle w:val="Hyperlink"/>' : '';
-          final +=
-            (is_link ? ('<w:hlink w:dest="' + link_url + '">') : '') +
-            '<w:r><w:rPr>' + style + '</w:rPr><w:t>' + tok.chars +
-            '</w:t></w:r>' + (is_link ? '</w:hlink>' : '');
-          }
-          break;
-      }
-    });
-    return final;
-
-  };
-
-}());

src/utils/safe-json-loader.js

@@ -1,24 +0,0 @@
-/**
-Definition of the SafeJsonLoader class.
-@module syntax-error-ex.js
-@license MIT. See LICENSE.md for details.
-*/
-
-
-
-(function() {
-
-  var FS = require('fs');
-
-  module.exports = function loadSafeJson( file ) {
-    try {
-      return JSON.parse( FS.readFileSync( file ) );
-    }
-    catch(ex) {
-      loadSafeJson.error = ex;
-    }
-    return null;
-  };
-
-
-}());

src/utils/string.js

@@ -1,26 +0,0 @@
-/**
-Definitions of string utility functions.
-@module string.js
-*/
-
-/**
-Determine if the string is null, empty, or whitespace.
-See: http://stackoverflow.com/a/32800728/4942583
-@method isNullOrWhitespace
-*/
-
-(function() {
-
-  String.isNullOrWhitespace = function( input ) {
-    return !input || !input.trim();
-  };
-
-  String.prototype.endsWith = function(suffix) {
-    return this.indexOf(suffix, this.length - suffix.length) !== -1;
-  };
-
-  String.is = function( val ) {
-    return typeof val === 'string' || val instanceof String;
-  };
-
-}());

src/utils/syntax-error-ex.js

@@ -1,41 +0,0 @@
-/**
-Definition of the SyntaxErrorEx class.
-@module syntax-error-ex.js
-@license MIT. See LICENSE.md for details.
-*/
-
-(function() {
-
-
-  /**
-  Represents a SyntaxError exception with line and column info.
-  Collect syntax error information from the provided exception object. The
-  JavaScript `SyntaxError` exception isn't interpreted uniformly across environ-
-  ments, so we first check for a .lineNumber and .columnNumber and, if that's
-  not present, fall back to the JSONLint library, which provides that info.
-  See: http://stackoverflow.com/q/13323356
-  @class SyntaxErrorEx
-  */
-
-  module.exports = function SyntaxErrorEx( ex, rawData ) {
-
-    var lineNum = null, colNum = null;
-    if( ex.lineNumber !== undefined && ex.lineNumber !== null ) {
-      lineNum = ex.lineNumber;
-    }
-    if( ex.columnNumber !== undefined && ex.columnNumber !== null ) {
-      colNum = ex.columnNumber;
-    }
-    if( lineNum === null || colNum === null ) {
-      var JSONLint = require('json-lint'); // TODO: json-lint or is-my-json-valid?
-      var lint = JSONLint( rawData, { comments: false } );
-      if( lineNum === null ) lineNum = (lint.error ? lint.line : '???');
-      if( colNum === null ) colNum = (lint.error ? lint.character : '???');
-    }
-    this.line = lineNum;
-    this.col = colNum;
-
-  };
-
-
-}());

src/verbs/analyze.js

@@ -1,107 +0,0 @@
-/**
-Implementation of the 'analyze' verb for HackMyResume.
-@module create.js
-@license MIT. See LICENSE.md for details.
-*/
-
-
-
-(function(){
-
-
-
-  var MKDIRP = require('mkdirp')
-    , PATH = require('path')
-    , _ = require('underscore')
-    , ResumeFactory = require('../core/resume-factory')
-    , chalk = require('chalk');
-
-
-
-  /**
-  Run the 'analyze' command.
-  */
-  module.exports = function analyze( sources, dst, opts, logger ) {
-    var _log = logger || console.log;
-    if( !sources || !sources.length ) throw { fluenterror: 3 };
-
-    var nlzrs = _loadInspectors();
-
-    sources.forEach( function(src) {
-      var result = ResumeFactory.loadOne( src, {
-        log: _log, format: 'FRESH', objectify: true, throw: false
-      });
-      result.error || _analyze( result, nlzrs, opts, _log );
-    });
-
-  };
-
-
-
-  /**
-  Analyze a single resume.
-  */
-  function _analyze( resumeObject, nlzrs, opts, log ) {
-    var rez = resumeObject.rez;
-    var safeFormat =
-      (rez.meta && rez.meta.format && rez.meta.format.startsWith('FRESH')) ?
-      'FRESH' : 'JRS';
-
-    var padding = 20;
-    log(chalk.cyan('Analyzing ') + chalk.cyan.bold(safeFormat) +
-      chalk.cyan(' resume: ') + chalk.cyan.bold(resumeObject.file));
-    var info = _.mapObject( nlzrs, function(val, key) {
-      return val.run( resumeObject.rez );
-    });
-
-    log(chalk.cyan.bold('\nSECTIONS') + chalk.cyan(' (') + chalk.white.bold(_.keys(info.totals).length) + chalk.cyan('):\n'));
-    var pad = require('string-padding');
-    _.each( info.totals, function(tot, key) {
-      log(chalk.cyan(pad(key + ': ',20)) + chalk.cyan.bold(pad(tot.toString(),5)));
-    });
-
-    log();
-    log(chalk.cyan.bold('COVERAGE') + chalk.cyan(' (') + chalk.white.bold( info.coverage.pct ) + chalk.cyan('):\n'));
-    log(chalk.cyan(pad('Total Days: ', padding)) + chalk.cyan.bold( pad(info.coverage.duration.total.toString(),5) ));
-    log(chalk.cyan(pad('Employed: ', padding)) + chalk.cyan.bold( pad((info.coverage.duration.total - info.coverage.duration.gaps).toString(),5) ));
-    log(chalk.cyan(pad('Gaps:     ', padding + 4)) + chalk.cyan.bold(info.coverage.gaps.length) + chalk.cyan('  [') + info.coverage.gaps.map(function(g) {
-        var clr = 'green';
-        if( g.duration > 35 ) clr = 'yellow';
-        if( g.duration > 90 ) clr = 'red';
-        return chalk[clr].bold( g.duration) ;
-      }).join(', ') + chalk.cyan(']') );
-      log(chalk.cyan(pad('Overlaps:     ', padding + 4)) + chalk.cyan.bold(info.coverage.overlaps.length) + chalk.cyan('  [') + info.coverage.overlaps.map(function(ol) {
-          var clr = 'green';
-          if( ol.duration > 35 ) clr = 'yellow';
-          if( ol.duration > 90 ) clr = 'red';
-          return chalk[clr].bold( ol.duration) ;
-        }).join(', ') + chalk.cyan(']') );
-
-    var tot = 0;
-    log();
-    log( chalk.cyan.bold('KEYWORDS') + chalk.cyan(' (') + chalk.white.bold( info.keywords.length ) +
-      chalk.cyan('):\n\n') +
-      info.keywords.map(function(g) {
-        tot += g.count;
-        return chalk.cyan( pad(g.name + ': ', padding) ) + chalk.cyan.bold( pad( g.count.toString(), 5 )) + chalk.cyan(' mentions');
-      }).join('\n'));
-
-    log(chalk.cyan( pad('TOTAL: ', padding) ) + chalk.white.bold( pad( tot.toString(), 5 )) + chalk.cyan(' mentions'));
-  }
-
-
-
-  /**
-  Load inspectors.
-  */
-  function _loadInspectors() {
-    return {
-      totals: require('../inspectors/totals-inspector'),
-      coverage: require('../inspectors/gap-inspector'),
-      keywords: require('../inspectors/keyword-inspector')
-    };
-  }
-
-
-
-}());

src/verbs/convert.js

@@ -1,69 +0,0 @@
-/**
-Implementation of the 'convert' verb for HackMyResume.
-@module convert.js
-@license MIT. See LICENSE.md for details.
-*/
-
-
-
-(function(){
-
-
-
-  var ResumeFactory = require('../core/resume-factory')
-    , chalk = require('chalk')
-    , HACKMYSTATUS = require('../core/status-codes');
-
-
-
-  /**
-  Convert between FRESH and JRS formats.
-  */
-  module.exports = function convert( srcs, dst, opts, logger ) {
-
-    // Housekeeping
-    var _log = logger || console.log;
-    if( !srcs || !srcs.length ) { throw { fluenterror: 6 }; }
-    if( !dst || !dst.length ) {
-      if( srcs.length === 1 ) {
-        throw { fluenterror: HACKMYSTATUS.inputOutputParity };
-      }
-      else if( srcs.length === 2 ) {
-        dst = dst || []; dst.push( srcs.pop() );
-      }
-      else {
-        throw { fluenterror: HACKMYSTATUS.inputOutputParity };
-      }
-    }
-    if(srcs && dst && srcs.length && dst.length && srcs.length !== dst.length){
-      throw { fluenterror: HACKMYSTATUS.inputOutputParity };
-    }
-
-    // Load source resumes
-    srcs.forEach( function( src, idx ) {
-
-      // Load the resume
-      var rinfo = ResumeFactory.loadOne( src, {
-        log: _log, format: null, objectify: true, throw: true
-      });
-
-      var s = rinfo.rez
-        , srcFmt = ((s.basics && s.basics.imp) || s.imp).orgFormat === 'JRS' ?
-          'JRS' : 'FRESH'
-        , targetFormat = srcFmt === 'JRS' ? 'FRESH' : 'JRS';
-
-      // TODO: Core should not log
-      _log( chalk.green('Converting ') + chalk.green.bold(rinfo.file) +
-        chalk.green(' (' + srcFmt + ') to ') + chalk.green.bold(dst[idx]) +
-        chalk.green(' (' + targetFormat + ').'));
-
-      // Save it to the destination format
-      s.saveAs( dst[idx], targetFormat );
-
-    });
-
-  };
-
-
-
-}());

src/verbs/create.js

@@ -1,31 +0,0 @@
-/**
-Implementation of the 'create' verb for HackMyResume.
-@module create.js
-@license MIT. See LICENSE.md for details.
-*/
-
-(function(){
-
-  var MKDIRP = require('mkdirp')
-    , PATH = require('path')
-    , chalk = require('chalk')
-    , HACKMYSTATUS = require('../core/status-codes');
-
-  /**
-  Create a new empty resume in either FRESH or JRS format.
-  */
-  module.exports = function create( src, dst, opts, logger ) {
-    var _log = logger || console.log;
-    if( !src || !src.length ) throw { fluenterror: HACKMYSTATUS.createNameMissing };
-    src.forEach( function( t ) {
-      var safeFormat = opts.format.toUpperCase();
-      _log(chalk.green('Creating new ') + chalk.green.bold(safeFormat) +
-        chalk.green(' resume: ') + chalk.green.bold(t));
-      MKDIRP.sync( PATH.dirname( t ) ); // Ensure dest folder exists;
-      var RezClass = require('../core/' + safeFormat.toLowerCase() + '-resume' );
-      RezClass.default().save(t);
-      //FLUENT[ safeFormat + 'Resume' ].default().save( t );
-    });
-  };
-
-}());

src/verbs/generate.js

@@ -1,346 +0,0 @@
-/**
-Implementation of the 'generate' verb for HackMyResume.
-@module generate.js
-@license MIT. See LICENSE.md for details.
-*/
-// TODO: EventEmitter
-
-
-(function() {
-
-
-
-  var PATH = require('path')
-    , FS = require('fs')
-    , MD = require('marked')
-    , MKDIRP = require('mkdirp')
-    , EXTEND = require('../utils/extend')
-    , parsePath = require('parse-filepath')
-    , _opts = require('../core/default-options')
-    , FluentTheme = require('../core/fresh-theme')
-    , JRSTheme = require('../core/jrs-theme')
-    , ResumeFactory = require('../core/resume-factory')
-    , _ = require('underscore')
-    , _fmts = require('../core/default-formats')
-    , extend = require('../utils/extend')
-    , chalk = require('chalk')
-    , pad = require('string-padding')
-    , _err, _log, rez;
-
-
-
-  /**
-  Handle an exception.
-  */
-  function error( ex ) {
-    throw ex;
-  }
-
-
-
-  /**
-  Given a source resume in FRESH or JRS format, a destination resume path, and a
-  theme file, generate 0..N resumes in the desired formats.
-  @param src Path to the source JSON resume file: "rez/resume.json".
-  @param dst An array of paths to the target resume file(s).
-  @param theme Friendly name of the resume theme. Defaults to "modern".
-  @param logger Optional logging override.
-  */
-  function build( src, dst, opts, logger, errHandler ) {
-
-    // Housekeeping
-    //_opts = extend( true, _opts, opts );
-    _log = logger || console.log;
-    _err = errHandler || error;
-    _opts.theme = (opts.theme && opts.theme.toLowerCase().trim())|| 'modern';
-    _opts.prettify = opts.prettify === true ? _opts.prettify : false;
-    _opts.css = opts.css || 'embed';
-    _opts.pdf = opts.pdf;
-    _opts.wrap = opts.wrap || 60;
-    _opts.stitles = opts.sectionTitles;
-    _opts.tips = opts.tips;
-    //_opts.noTips = opts.noTips;
-
-    // If two or more files are passed to the GENERATE command and the TO
-    // keyword is omitted, the last file specifies the output file.
-    if( src.length > 1 && ( !dst || !dst.length ) ) {
-      dst.push( src.pop() );
-    }
-
-    // Load the theme...we do this first because the theme choice (FRESH or
-    // JSON Resume) determines what format we'll convert the resume to.
-    var tFolder = verify_theme( _opts.theme );
-    var theme = load_theme( tFolder );
-
-    // Load input resumes...
-    if( !src || !src.length ) { throw { fluenterror: 3 }; }
-    var sheets = ResumeFactory.load(src, {
-      log: _log, format: theme.render ? 'JRS' : 'FRESH',
-      objectify: true, throw: true
-    }).map(function(sh){ return sh.rez; });
-
-    // Merge input resumes...
-    var msg = '';
-    rez = _.reduceRight( sheets, function( a, b, idx ) {
-      msg += ((idx == sheets.length - 2) ?
-        chalk.cyan('Merging ') + chalk.cyan.bold(a.i().file) : '') +
-        chalk.cyan(' onto ') + chalk.cyan.bold(b.i().file);
-      return extend( true, b, a );
-    });
-    msg && _log(msg);
-
-    // Output theme messages
-    var numFormats = Object.keys(theme.formats).length;
-    var themeName = theme.name.toUpperCase();
-    _log( chalk.yellow('Applying ') + chalk.yellow.bold(themeName) +
-      chalk.yellow(' theme (' + numFormats + ' format' +
-        ( numFormats === 1 ? ')' : 's)') ));
-
-    // Expand output resumes...
-    var targets = expand( dst, theme );
-
-    // Run the transformation!
-    targets.forEach( function(t) {
-      t.final = single( t, theme, targets );
-    });
-
-    if( _opts.tips && (theme.message || theme.render) ) {
-      var WRAP = require('word-wrap');
-      if( theme.message ) {
-        _log( WRAP( chalk.gray('The ' + themeName +
-          ' theme says: "') + chalk.white(theme.message) + chalk.gray('"'),
-          { width: _opts.wrap, indent: '' } ));
-      }
-      else {
-        _log( WRAP( chalk.gray('The ' + themeName +
-          ' theme says: "') + chalk.white('For best results view JSON Resume ' +
-          'themes over a local or remote HTTP connection. For example:'),
-          { width: _opts.wrap, indent: '' }
-        ));
-        _log('');
-        _log(
-          '    npm install http-server -g\r' +
-          '    http-server <resume-folder>' );
-        _log('');
-        _log(chalk.white('For more information, see the README."'),
-          { width: _opts.wrap, indent: '' } );
-      }
-    }
-
-
-    // Don't send the client back empty-handed
-    return { sheet: rez, targets: targets, processed: targets };
-  }
-
-
-
-  /**
-  Generate a single target resume such as "out/rez.html" or "out/rez.doc".
-  @param targInfo Information for the target resume.
-  @param theme A FRESHTheme or JRSTheme object.
-  @returns
-  */
-  function single( targInfo, theme, finished ) {
-
-    function MDIN(txt) { // TODO: Move this
-      return MD(txt || '' ).replace(/^\s*<p>|<\/p>\s*$/gi, '');
-    }
-
-    try {
-      var f = targInfo.file
-        , fType = targInfo.fmt.outFormat
-        , fName = PATH.basename(f, '.' + fType)
-        , theFormat;
-
-        var suffix = '';
-        if( targInfo.fmt.outFormat === 'pdf' ) {
-          if( _opts.pdf ) {
-            if( _opts.pdf !== 'none' ) {
-              suffix = chalk.green(' (with ' + _opts.pdf + ')');
-            }
-            else {
-              _log( chalk.gray('Skipping   ') +
-                chalk.white.bold(
-                  pad(targInfo.fmt.outFormat.toUpperCase(),4,null,pad.RIGHT)) +
-                chalk.gray(' resume') + suffix + chalk.green(': ') +
-                chalk.white( PATH.relative(process.cwd(), f )) );
-              return;
-            }
-          }
-        }
-
-        _log( chalk.green('Generating ') +
-          chalk.green.bold(
-            pad(targInfo.fmt.outFormat.toUpperCase(),4,null,pad.RIGHT)) +
-          chalk.green(' resume') + suffix + chalk.green(': ') +
-          chalk.green.bold( PATH.relative(process.cwd(), f )) );
-
-      // If targInfo.fmt.files exists, this format is backed by a document.
-      // Fluent/FRESH themes are handled here.
-      if( targInfo.fmt.files && targInfo.fmt.files.length ) {
-          theFormat = _fmts.filter(
-            function(fmt) { return fmt.name === targInfo.fmt.outFormat; })[0];
-          MKDIRP.sync( PATH.dirname( f ) ); // Ensure dest folder exists;
-          _opts.targets = finished;
-          return theFormat.gen.generate( rez, f, _opts );
-      }
-
-      // Otherwise this is either a) a JSON Resume theme or b) an ad-hoc format
-      // (JSON, YML, or PNG) that every theme gets "for free".
-      else {
-
-        theFormat = _fmts.filter( function(fmt) {
-          return fmt.name === targInfo.fmt.outFormat;
-        })[0];
-
-        var outFolder = PATH.dirname( f );
-        MKDIRP.sync( outFolder ); // Ensure dest folder exists;
-
-        // JSON Resume themes have a 'render' method that needs to be called
-        if( theme.render ) {
-          var COPY = require('copy');
-          var globs = [ '*.css', '*.js', '*.png', '*.jpg', '*.gif', '*.bmp' ];
-          COPY.sync( globs , outFolder, {
-            cwd: theme.folder, nodir: true,
-            ignore: ['node_modules/','node_modules/**']
-            // rewrite: function(p1, p2) {
-            //   return PATH.join(p2, p1);
-            // }
-          });
-
-          // Prevent JSON Resume theme .js from chattering (TODO: redirect IO)
-          var consoleLog = console.log;
-          console.log = function() { };
-
-          // Call the theme's render method
-          var rezDupe = rez.harden();
-          var rezHtml = theme.render( rezDupe );
-
-          // Turn logging back on
-          console.log = consoleLog;
-
-          // Unharden
-          rezHtml = rezHtml.replace( /@@@@~.*?~@@@@/gm, function(val){
-            return MDIN( val.replace( /~@@@@/gm,'' ).replace( /@@@@~/gm,'' ) );
-          });
-
-          // Save the file
-          FS.writeFileSync( f, rezHtml );
-
-          // Return markup to the client
-          return rezHtml;
-        }
-        else {
-          return theFormat.gen.generate( rez, f, _opts );
-        }
-      }
-    }
-    catch( ex ) {
-      _err( ex );
-    }
-  }
-
-
-
-  /**
-  Expand output files. For example, "foo.all" should be expanded to
-  ["foo.html", "foo.doc", "foo.pdf", "etc"].
-  @param dst An array of output files as specified by the user.
-  @param theTheme A FRESHTheme or JRSTheme object.
-  */
-  function expand( dst, theTheme ) {
-
-    // Add freebie formats (JSON, YAML, PNG) every theme gets...
-    // Add HTML-driven PNG only if the theme has an HTML format.
-    theTheme.formats.json = theTheme.formats.json || {
-      freebie: true, title: 'json', outFormat: 'json', pre: 'json',
-      ext: 'json', path: null, data: null
-    };
-    theTheme.formats.yml = theTheme.formats.yml || {
-      freebie: true, title: 'yaml', outFormat: 'yml', pre: 'yml',
-      ext: 'yml', path: null, data: null
-    };
-    if( theTheme.formats.html && !theTheme.formats.png ) {
-      theTheme.formats.png = {
-        freebie: true, title: 'png', outFormat: 'png',
-        ext: 'yml', path: null, data: null
-      };
-    }
-
-    // Set up the destination collection. It's either the array of files passed
-    // by the user or 'out/resume.all' if no targets were specified.
-    var destColl = (dst && dst.length && dst) ||
-                   [PATH.normalize('out/resume.all')];
-
-    // Assemble an array of expanded target files... (can't use map() here)
-    var targets = [];
-    destColl.forEach( function(t) {
-
-      var to = PATH.resolve(t), pa = parsePath(to),fmat = pa.extname || '.all';
-
-
-      targets.push.apply(
-        targets, fmat === '.all' ?
-        Object.keys( theTheme.formats ).map( function( k ) {
-          var z = theTheme.formats[k];
-          return { file: to.replace( /all$/g, z.outFormat ), fmt: z };
-        }) :
-        [{ file: to, fmt: theTheme.getFormat( fmat.slice(1) ) }]);
-
-      // targets.push.apply(
-      //   targets, fmat === '.all' ?
-      //   Object.keys( explicitFormats ).map( function( k ) {
-      //     var z = theTheme.formats[k];
-      //     return { file: to.replace( /all$/g, z.outFormat ), fmt: z };
-      //   }) :
-      //   [{ file: to, fmt: theTheme.getFormat( fmat.slice(1) ) }]);
-
-    });
-
-    return targets;
-  }
-
-
-  /**
-  Verify the specified theme name/path.
-  */
-  function verify_theme( themeNameOrPath ) {
-    var tFolder = PATH.join(
-      parsePath ( require.resolve('fresh-themes') ).dirname,
-      '/themes/',
-      themeNameOrPath
-    );
-    var exists = require('path-exists').sync;
-    if( !exists( tFolder ) ) {
-      tFolder = PATH.resolve( themeNameOrPath );
-      if( !exists( tFolder ) ) {
-        throw { fluenterror: 1, data: _opts.theme };
-      }
-    }
-    return tFolder;
-  }
-
-
-
-  /**
-  Load the specified theme.
-  */
-  function load_theme( tFolder ) {
-
-    // Create a FRESH or JRS theme object
-    var theTheme = _opts.theme.indexOf('jsonresume-theme-') > -1 ?
-      new JRSTheme().open(tFolder) : new FluentTheme().open( tFolder );
-
-    // Cache the theme object
-    _opts.themeObj = theTheme;
-
-    return theTheme;
-  }
-
-
-
-  module.exports = build;
-
-
-
-}());

src/verbs/validate.js

@@ -1,104 +0,0 @@
-/**
-Implementation of the 'validate' verb for HackMyResume.
-@module validate.js
-@license MIT. See LICENSE.md for details.
-*/
-
-(function() {
-
-  var FS = require('fs');
-  var ResumeFactory = require('../core/resume-factory');
-  var SyntaxErrorEx = require('../utils/syntax-error-ex');
-  var chalk = require('chalk');
-  var HACKMYSTATUS = require('../core/status-codes');
-
-  module.exports =
-
-  /**
-  Validate 1 to N resumes in either FRESH or JSON Resume format.
-  */
-  function validate( sources, unused, opts, logger ) {
-    var _log = logger || console.log;
-    if( !sources || !sources.length ) { throw { fluenterror: 6 }; }
-    var isValid = true;
-
-    var validator = require('is-my-json-valid');
-    var schemas = {
-      fresh: require('fresca'),
-      jars: require('../core/resume.json')
-    };
-
-    var resumes = ResumeFactory.load( sources, {
-      log: _log,
-      format: null,
-      objectify: false,
-      throw: false,
-      muffle: true
-    });
-
-    // Load input resumes...
-    resumes.forEach(function( src ) {
-
-      if( src.error ) {
-        // TODO: Core should not log
-        _log( chalk.white('Validating ') + chalk.gray.bold(src.file) +
-        chalk.white(' against ') + chalk.gray.bold('AUTO') +
-        chalk.white(' schema:') + chalk.red.bold(' BROKEN') );
-
-        var ex = src.error; // alias
-        if ( ex instanceof SyntaxError) {
-          var info = new SyntaxErrorEx( ex, src.raw );
-          _log( chalk.red.bold('--> ' + src.file.toUpperCase() + ' contains invalid JSON on line ' +
-            info.line + ' column ' + info.col + '.' +
-            chalk.red(' Unable to validate.') ) );
-          _log( chalk.red.bold('    INTERNAL: ' + ex) );
-        }
-        else {
-          _log(chalk.red.bold('ERROR: ' + ex.toString()));
-        }
-        if( opts.assert ) throw { fluenterror: HACKMYSTATUS.invalid };
-        return;
-      }
-
-      var json = src.json;
-      var isValid = false;
-      var style = 'green';
-      var errors = [];
-      var fmt = json.basics ? 'jrs' : 'fresh';
-
-      try {
-        var validate = validator( schemas[ fmt ], { // Note [1]
-          formats: {
-            date: /^\d{4}(?:-(?:0[0-9]{1}|1[0-2]{1})(?:-[0-9]{2})?)?$/
-          }
-        });
-
-        isValid = validate( json );
-        if( !isValid ) {
-          style = 'yellow';
-          errors = validate.errors;
-        }
-
-      }
-      catch(exc) {
-        return;
-      }
-
-      _log( chalk.white('Validating ') + chalk.white.bold(src.file) + chalk.white(' against ') +
-        chalk.white.bold(fmt.replace('jars','JSON Resume').toUpperCase()) +
-        chalk.white(' schema: ') + chalk[style].bold(isValid ? 'VALID!' : 'INVALID') );
-
-      errors.forEach(function(err,idx) {
-        _log( chalk.yellow.bold('--> ') +
-          chalk.yellow(err.field.replace('data.','resume.').toUpperCase() + ' ' +
-          err.message) );
-      });
-
-      if( opts.assert && !isValid ) {
-        throw { fluenterror: HACKMYSTATUS.invalid, shouldExit: true };
-      }
-
-    });
-  };
-
-}());

test/hmr-options.json

@@ -0,0 +1,4 @@
+{
+  "theme": "positive",
+  "debug": true
+}

test/test-cli.js

@@ -1,76 +1,76 @@
+/**
+CLI test routines for HackMyResume.
+@module test-cli.js
+*/
+
+
 
 var chai = require('chai')
-  , expect = chai.expect
   , should = chai.should()
-  , path = require('path')
-  , _ = require('underscore')
-	, FRESHResume = require('../src/core/fresh-resume')
-  , FCMD = require( '../src/hackmyapi')
-  , validator = require('is-my-json-valid');
+  , HMRMAIN = require('../src/cli/main')
+  , CHALK = require('chalk')
+  , FS = require('fs')
+  , PATH = require('path')
+  , PKG = require('../package.json')
+  , _ = require('underscore');
+
+
+
+var gather = '';
+var ConsoleLogOrg = console.log;
+var ProcessExitOrg = process.exit;
+var commandRetVal = 0;
 
-chai.config.includeStack = false;
 
 describe('Testing CLI interface', function () {
 
-    var _sheet;
+  // TODO: use sinon
+  // Replacement for process.exit()
+  function MyProcessExit( retVal ) {
+    commandRetVal = retVal;
+  }
 
-    function logMsg() {
+  // HackMyResume CLI stub. Handle a single HMR invocation.
+  function HackMyResumeStub( argsString ) {
 
+    var args = argsString.split(' ');
+    args.unshift( process.argv[1] );
+    args.unshift( process.argv[0] );
+    process.exit = MyProcessExit;
+
+    try {
+      var HMRMAIN = require('../src/cli/main');
+      HMRMAIN( args );
     }
-
-    var opts = {
-      format: 'FRESH',
-      prettify: true,
-      silent: false,
-      assert: true  // Causes validation errors to throw exceptions
-    };
-
-    var opts2 = {
-      format: 'JRS',
-      prettify: true,
-      silent: true
-    };
-
-    run( 'new', ['test/sandbox/new-fresh-resume.json'], [], opts, ' (FRESH format)' );
-    run( 'new', ['test/sandbox/new-jrs-resume.json'], [], opts2, ' (JRS format)' );
-    run( 'new', ['test/sandbox/new-1.json', 'test/sandbox/new-2.json', 'test/sandbox/new-3.json'], [], opts, ' (multiple FRESH resumes)' );
-    run( 'new', ['test/sandbox/new-jrs-1.json', 'test/sandbox/new-jrs-2.json', 'test/sandbox/new-jrs-3.json'], [], opts, ' (multiple JRS resumes)' );
-    fail( 'new', [], [], opts, " (when a filename isn't specified)" );
-
-    run( 'validate', ['node_modules/fresh-test-resumes/src/jane-fullstacker.fresh.json'], [], opts, ' (jane-q-fullstacker|FRESH)' );
-    run( 'validate', ['node_modules/fresh-test-resumes/src/johnny-trouble.fresh.json'], [], opts, ' (johnny-trouble|FRESH)' );
-    run( 'validate', ['test/sandbox/new-fresh-resume.json'], [], opts, ' (new-fresh-resume|FRESH)' );
-    run( 'validate', ['test/resumes/jrs-0.0.0/richard-hendriks.json'], [], opts2, ' (richard-hendriks.json|JRS)' );
-    run( 'validate', ['test/resumes/jrs-0.0.0/jane-incomplete.json'], [], opts2, ' (jane-incomplete.json|JRS)' );
-    run( 'validate', ['test/sandbox/new-1.json','test/sandbox/new-jrs-resume.json','test/sandbox/new-1.json', 'test/sandbox/new-2.json', 'test/sandbox/new-3.json'], [], opts, ' (5|BOTH)' );
-
-    run( 'analyze', ['node_modules/fresh-test-resumes/src/jane-fullstacker.json'], [], opts, ' (jane-q-fullstacker|FRESH)' );
-    run( 'analyze', ['test/resumes/jrs-0.0.0/richard-hendriks.json'], [], opts2, ' (richard-hendriks|JRS)' );
-
-    run( 'build',
-      [ 'node_modules/fresh-test-resumes/src/jane-fullstacker.fresh.json',
-        'node_modules/fresh-test-resumes/src/override/jane-fullstacker-override.fresh.json' ],
-      [ 'test/sandbox/merged/jane-fullstacker-gamedev.fresh.all'], opts, ' (jane-q-fullstacker w/ override|FRESH)'
-    );
-
-    function run( verb, src, dst, opts, msg ) {
-      msg = msg || '.';
-      it( 'The ' + verb.toUpperCase() + ' command should SUCCEED' + msg, function () {
-        function runIt() {
-          FCMD.verbs[verb]( src, dst, opts, opts.silent ? logMsg : function(msg){ msg = msg || ''; console.log(msg); } );
-        }
-        runIt.should.not.Throw();
-      });
+    catch( ex ) {
+      require('../src/cli/error').err( ex, false );
+      //if(ex.stack || (ex.inner && ex.inner.stacl))
+        //console.log(ex.stack || ex.inner.stack);
     }
+    process.exit = ProcessExitOrg;
 
-    function fail( verb, src, dst, opts, msg ) {
-      msg = msg || '.';
-      it( 'The ' + verb.toUpperCase() + ' command should FAIL' + msg, function () {
-        function runIt() {
-          FCMD.verbs[verb]( src, dst, opts, logMsg );
-        }
-        runIt.should.Throw();
-      });
+  }
+
+  // Run a test through the stub, gathering console.log output into "gather"
+  // and testing against it.
+  function run( args, expErr ) {
+    var title = args;
+    it( 'Testing: "' + title + '"\n\n', function() {
+      commandRetVal = 0;
+      HackMyResumeStub( args );
+      commandRetVal.should.equal( parseInt(expErr, 10) );
+    });
+  }
+
+  var lines = FS.readFileSync( PATH.join( __dirname, './test-hmr.txt'), 'utf8').split('\n');
+  lines.forEach(function(l){
+    if( l && l.trim() ) {
+      if(l[0] !== '#') {
+        var lineInfo = l.split('|');
+        var errCode = lineInfo[0];
+        run( lineInfo.length > 1 ? lineInfo[1] : '', errCode );
+      }
     }
+  });
 
 });

test/test-converter.js

@@ -1,39 +0,0 @@
-
-var chai = require('chai')
-  , expect = chai.expect
-  , should = chai.should()
-  , path = require('path')
-  , parsePath = require('parse-filepath')
-  , _ = require('underscore')
-	, FRESHResume = require('../src/core/fresh-resume')
-  , CONVERTER = require('../src/core/convert')
-  , FS = require('fs')
-  , MKDIRP = require('mkdirp')
-  , _ = require('underscore');
-
-chai.config.includeStack = false;
-
-describe('FRESH/JRS converter', function () {
-
-    var _sheet;
-
-	  it('should round-trip from JRS to FRESH to JRS without modifying or losing data', function () {
-
-      var fileA = path.join( __dirname, 'resumes/jrs-0.0.0/richard-hendriks.json' );
-      var fileB = path.join( __dirname, 'sandbox/richard-hendriks.json' );
-
-      _sheet = new FRESHResume().open( fileA );
-      MKDIRP.sync( parsePath( fileB ).dirname );
-      _sheet.saveAs( fileB, 'JRS' );
-
-      var rawA = FS.readFileSync( fileA, 'utf8' );
-      var rawB = FS.readFileSync( fileB, 'utf8' );
-
-      var objA = JSON.parse( rawA );
-      var objB = JSON.parse( rawB );
-
-      _.isEqual(objA, objB).should.equal(true);
-
-    });
-
-});

test/test-fresh-sheet.js

@@ -1,62 +0,0 @@
-
-var chai = require('chai')
-  , expect = chai.expect
-  , should = chai.should()
-  , path = require('path')
-  , _ = require('underscore')
-	, FRESHResume = require('../src/core/fresh-resume')
-  , validator = require('is-my-json-valid');
-
-chai.config.includeStack = false;
-
-function testResume(opts) {
-
-  describe( opts.title + ' (FRESH)', function () {
-
-      var _sheet;
-
-  	  it('should open without throwing an exception', function () {
-        function tryOpen() {
-          _sheet = new FRESHResume().open( opts.path );
-        }
-        tryOpen.should.not.Throw();
-      });
-
-      it('should have one or more of each section', function() {
-        var newObj = _.pick( _sheet, opts.sections );
-        expect( Object.keys(newObj).length ).to.equal( opts.sections.length );
-      });
-
-      it('should have a work duration of ' + opts.duration + ' years', function() {
-        _sheet.computed.numYears.should.equal( opts.duration );
-      });
-
-      it('should save without throwing an exception', function(){
-        function trySave() {
-          _sheet.save( 'test/sandbox/' + opts.title + '.json' );
-        }
-        trySave.should.not.Throw();
-      });
-
-      it('should not be modified after saving', function() {
-        var savedSheet = new FRESHResume().open('test/sandbox/' + opts.title + '.json');
-        _sheet.stringify().should.equal( savedSheet.stringify() );
-      });
-
-      it('should validate against the FRESH resume schema', function() {
-        var result = _sheet.isValid();
-        // var schemaJson = require('fresca');
-        // var validate = validator( schemaJson, { verbose: true } );
-        // var result = validate( JSON.parse( _sheet.imp.raw ) );
-        result || console.log("\n\nOops, resume didn't validate. " +
-          "Validation errors:\n\n", _sheet.imp.validationErrors, "\n\n");
-        result.should.equal( true );
-      });
-
-
-  });
-}
-
-var sects = [ 'info', 'employment', 'service', 'skills', 'education', 'writing', 'recognition', 'references' ];
-testResume({ title: 'jane-q-fullstacker', path: 'node_modules/fresh-test-resumes/src/jane-fullstacker.fresh.json', duration: 7, sections: sects });
-testResume({ title: 'johnny-trouble-resume', path: 'node_modules/fresh-test-resumes/src/johnny-trouble.fresh.json', duration: 4, sections: sects });

test/test-hmr.txt

@@ -0,0 +1,27 @@
+0|
+0|--help
+0|-h
+0|--debug
+0|-d
+5|notacommand
+3|build
+14|build doesnt-exist.json
+14|build doesnt-exist.json -t not-a-theme
+14|build doesnt-exist.json -t node_modules/not-a-theme
+8|new
+0|new test/sandbox/cli-test/new-empty-resume.auto.json
+0|new test/sandbox/cli-test/new-empty-resume.jrs.json -f jrs
+0|new test/sandbox/cli-test/new-empty-resume.fresh.json -f fresh
+3|analyze
+14|analyze doesnt-exist.json
+3|convert
+7|convert doesnt-exist.json
+3|validate
+14|validate doesnt-exist.json
+0|validate node_modules/fresh-test-resumes/src/fresh/jane-fullstacker.json
+3|peek
+14|peek doesnt-exist.json
+14|peek doesnt-exist.json not.a.path
+0|peek test/resumes/jrs-0.0.0/richard-hendriks.json work[0]
+0|peek node_modules/fresh-test-resumes/src/fresh/jane-fullstacker.json employment.history[1]
+0|peek node_modules/fresh-test-resumes/src/fresh/johnny-trouble.json skills.sets

test/test-jrs-sheet.js

@@ -1,69 +0,0 @@
-
-var chai = require('chai')
-  , expect = chai.expect
-  , should = chai.should()
-  , path = require('path')
-  , _ = require('underscore')
-	, JRSResume = require('../src/core/jrs-resume')
-  , validator = require('is-my-json-valid');
-
-chai.config.includeStack = false;
-
-function testResume( opts ) {
-
-  describe( opts.title + ' (JRS)', function() {
-
-    opts.isValid = opts.isValid !== false;
-
-    var _sheet;
-
-    it('should open without throwing an exception', function () {
-      var that = this;
-      function tryOpen() {
-        _sheet = new JRSResume().open(
-          path.join( __dirname, 'resumes/jrs-0.0.0/' + opts.title + '.json' ) );
-      }
-      tryOpen.should.not.Throw();
-    });
-
-    it('should have one or more of each section', function() {
-      var newObj = _.pick( _sheet, opts.sections );
-      expect( Object.keys(newObj).length ).to.equal( opts.sections.length );
-    });
-
-    it('should have a work duration of ' + opts.duration + ' years', function() {
-      _sheet.basics.computed.numYears.should.equal( opts.duration );
-    });
-
-    it('should save without throwing an exception', function() {
-      var that = this;
-      function trySave() {
-        _sheet.save( 'test/sandbox/' + opts.title + '.json' );
-      }
-      trySave.should.not.Throw();
-    });
-
-    it('should not be modified after saving', function() {
-      var savedSheet = new JRSResume().open( 'test/sandbox/' + opts.title + '.json' );
-      _sheet.stringify().should.equal( savedSheet.stringify() );
-    });
-
-    it('should ' + (opts.isValid ? '' : 'NOT ') + 'validate against the JSON Resume schema', function() {
-      var result = _sheet.isValid();
-      // var schemaJson = require('../src/core/resume.json');
-      // var validate = validator( schemaJson, { verbose: true } );
-      // var result = validate( JSON.parse( _sheet.imp.raw ) );
-      result || console.log("\n\nOops, resume didn't validate. " +
-       "Validation errors:\n\n", _sheet.basics.imp.validationErrors, "\n\n");
-      result.should.equal( opts.isValid );
-    });
-
-  });
-}
-
-var sects = [ 'basics', 'work', 'volunteer', 'skills', 'education', 'publications', 'awards', 'references' ];
-
-testResume({ title: 'jane-q-fullstacker', duration: 7, sections: sects });
-testResume({ title: 'jane-incomplete', duration: 0, sections: _.without(sects, 'awards', 'work') });
-testResume({ title: 'richard-hendriks', duration: 1, sections: sects });
-testResume({ title: 'empty', duration: 0, sections: [], isValid: false });

test/test-stdout.js

@@ -0,0 +1,144 @@
+/**
+Output test routines for HackMyResume.
+@module test-stdout.js
+*/
+
+
+
+var chai = require('chai')
+  , expect = chai.expect
+  , HMRMAIN = require('../src/cli/main')
+  , CHALK = require('chalk')
+  , FS = require('fs')
+  , PATH = require('path')
+  , PKG = require('../package.json')
+  , _ = require('underscore');
+
+
+
+var gather = '';
+var ConsoleLogOrg = console.log;
+var ProcessExitOrg = process.exit;
+
+
+
+describe('Testing Ouput interface', function () {
+
+  // TODO: use sinon
+  // Replacement for console.log
+  function MyConsoleLog( msg ) {
+    gather += Array.prototype.slice.call(arguments).join(' ');
+    ConsoleLogOrg.apply(this, arguments);
+  }
+
+  // Replacement for process.exit()
+  function MyProcessExit() {
+
+  }
+
+  // HackMyResume CLI stub. Handle a single HMR invocation.
+  function HackMyResumeStub( args ) {
+
+    console.log = MyConsoleLog;
+    process.exit = MyProcessExit;
+    CHALK.enabled = false;
+
+    try {
+      args.unshift( process.argv[1] );
+      args.unshift( process.argv[0] );
+      var HMRMAIN = require('../src/cli/main');
+      HMRMAIN( args );
+    }
+    catch( ex ) {
+      require('../src/cli/error').err( ex, false );
+    }
+    CHALK.enabled = true;
+    process.exit = ProcessExitOrg;
+    console.log = ConsoleLogOrg;
+
+  }
+
+  // Run a test through the stub, gathering console.log output into "gather"
+  // and testing against it.
+  function run( title, args, tests ) {
+    it( title, function() {
+
+      gather = '';
+      HackMyResumeStub( args );
+
+      expect(
+        _.all( tests, function(t) {
+          return gather.indexOf(t) > -1;
+        })
+      ).to.equal(true);
+
+    });
+  }
+
+  var title = '*** HackMyResume v' + PKG.version + ' ***';
+  var feedMe = 'Please feed me a resume in FRESH or JSON Resume format.';
+  var manPage = FS.readFileSync( PATH.resolve( __dirname, '../src/cli/use.txt' ), 'utf8');
+
+  run('HMR should output a help string when no command is specified',
+      [], [ title, 'Please give me a command (BUILD, ANALYZE, VALIDATE, CONVERT, NEW, or PEEK).' ]);
+
+  run('BUILD should output a tip when no source is specified',
+      ['build'], [ title, feedMe ]);
+
+  run('VALIDATE should output a tip when no source is specified',
+     ['validate'], [ title, feedMe ]);
+
+  run('ANALYZE should output a tip when no source is specified',
+      ['analyze'], [ title, feedMe ]);
+
+  run('BUILD should display an error on a broken resume',
+     ['build',
+      'node_modules/fresh-test-resumes/src/fresh/johnny-trouble.broken.json',
+      '-t', 'modern'
+    ], [ title, 'Error: Invalid or corrupt JSON on line'  ]);
+
+  run('CONVERT should output a tip when no source is specified',
+      ['convert'], [ title, feedMe ]);
+
+  run('NEW should output a tip when no source is specified',
+      ['new'], [ title, 'Please specify the filename of the resume to create.' ]);
+
+  // This will cause the HELP doc to be emitted, followed by an "unknown option --help"
+  // error in the log, based on the way we're calling into HMR. As long as the test
+  // passes, any extraneous error messages can be ignored here.
+  run('HMR should output help doc with --help',
+      ['--help'], [ manPage ]);
+
+  run('HMR should accept raw JSON via --options',
+      [
+        'build',
+        'node_modules/fresh-test-resumes/src/fresh/jane-fullstacker.json',
+        'to',
+        'test/sandbox/temp/janeq-1.all',
+        '-o',
+        "{ theme: 'compact', debug: true, pdf: 'wkhtmltopdf' }"],
+      [ 'Applying COMPACT theme (', '(with wkhtmltopdf)'] );
+
+  run('HMR should accept a JSON settings file via --options',
+      [
+        'build',
+        'node_modules/fresh-test-resumes/src/fresh/jane-fullstacker.json',
+        'to',
+        'test/sandbox/temp/janeq-2.all',
+        '--options',
+        "test/hmr-options.json"],
+      [ 'Applying POSITIVE theme'] );
+
+  run('Explicit command line options should override --options',
+      [
+        'build',
+        'node_modules/fresh-test-resumes/src/fresh/jane-fullstacker.json',
+        'to',
+        'test/sandbox/temp/janeq-3.all',
+        '--options',
+        "test/hmr-options.json",
+        "-t",
+        "modern"
+      ],
+      [ 'Applying MODERN theme'] );
+});

test/test-themes.js

@@ -1,87 +0,0 @@
-
-var SPAWNWATCHER = require('../src/core/spawn-watch')
-  , chai = require('chai')
-  , expect = chai.expect
-  , should = chai.should()
-  , path = require('path')
-  , _ = require('underscore')
-	, FRESHResume = require('../src/core/fresh-resume')
-  , HMR = require( '../src/hackmyapi')
-  , validator = require('is-my-json-valid')
-  , READFILES = require('recursive-readdir-sync')
-  , fileContains = require('../src/utils/file-contains')
-  , FS = require('fs');
-
-chai.config.includeStack = true;
-
-function genThemes( title, src, fmt ) {
-
-  describe('Testing themes against ' + title.toUpperCase() + ' resume ' + '(' + fmt + ')' , function () {
-
-    var _sheet;
-
-    function genTheme( fmt, src, themeName, themeLoc, testTitle ) {
-      themeLoc = themeLoc || themeName;
-      testTitle = themeName.toUpperCase() + ' theme (' + fmt + ') should generate without throwing an exception';
-      it( testTitle, function () {
-        function tryOpen() {
-          //var src = ['node_modules/jane-q-fullstacker/resume/jane-resume.json'];
-          var dst = ['test/sandbox/' + fmt + '/' + title + '/' + themeName + '/resume.all'];
-          var opts = {
-            theme: themeLoc,
-            format: fmt,
-            prettify: true,
-            silent: false,
-            css: 'embed'
-          };
-          try {
-            HMR.verbs.build( src, dst, opts, function(msg) {
-              msg = msg || '';
-              console.log(msg);
-            });
-          }
-          catch(ex) {
-            console.log(ex);
-            console.log(ex.stack);
-            throw ex;
-          }
-        }
-        tryOpen.should.not.Throw();
-      });
-    }
-
-    genTheme(fmt, src, 'hello-world');
-    genTheme(fmt, src, 'compact');
-    genTheme(fmt, src, 'modern');
-    genTheme(fmt, src, 'minimist');
-    genTheme(fmt, src, 'awesome');
-    genTheme(fmt, src, 'positive');
-    genTheme(fmt, src, 'jsonresume-theme-boilerplate', 'node_modules/jsonresume-theme-boilerplate' );
-    genTheme(fmt, src, 'jsonresume-theme-sceptile', 'node_modules/jsonresume-theme-sceptile' );
-    genTheme(fmt, src, 'jsonresume-theme-modern', 'node_modules/jsonresume-theme-modern' );
-    genTheme(fmt, src, 'jsonresume-theme-classy', 'node_modules/jsonresume-theme-classy' );
-
-  });
-
-}
-
-function folderContains( needle, haystack ) {
-  return _.some( READFILES( path.join(__dirname, haystack) ), function( absPath ) {
-    if( FS.lstatSync( absPath ).isFile() ) {
-      if( fileContains( absPath, needle ) ) {
-        console.log('Found invalid metadata in ' + absPath);
-        return true;
-      }
-    }
-  });
-}
-
-genThemes( 'jane-q-fullstacker', ['node_modules/fresh-test-resumes/src/jane-fullstacker.fresh.json'], 'FRESH' );
-genThemes( 'johnny-trouble', ['node_modules/fresh-test-resumes/src/johnny-trouble.fresh.json'], 'FRESH' );
-genThemes( 'richard-hendriks', ['test/resumes/jrs-0.0.0/richard-hendriks.json'], 'JRS' );
-
-describe('Verifying generated theme files...', function() {
-  it('Generated files should not contain ICE.', function() {
-    expect( folderContains('@@@@', 'sandbox') ).to.be.false;
-  });
-});