https://raven.nopejs.me/docs/reference/Recent content in Reference on RavenHugoen-ushttps://raven.nopejs.me/docs/reference/logging/Mon, 01 Jan 0001 00:00:00 +0000https://raven.nopejs.me/docs/reference/logging/<h1 id="logging"> Logging <a class="anchor" href="#logging">#</a> </h1> <p>All Raven job commands emit live progress and write timestamped log files.</p> <h2 id="default-behavior"> Default behavior <a class="anchor" href="#default-behavior">#</a> </h2> <ul> <li>Progress phases printed to stdout</li> <li>Summary line with counts and elapsed time</li> <li>Log file written to <code>data/logs/</code></li> </ul> <p>Example log paths:</p> <pre tabindex="0"><code>data/logs/discover-2026-07-04T08-30-00.log data/logs/draft-2026-07-04T08-35-12.log data/logs/sync-jobs-2026-07-04T07-00-00.log data/logs/send-2026-07-04T09-00-00.log </code></pre><h2 id="flags"> Flags <a class="anchor" href="#flags">#</a> </h2> <table> <thead> <tr> <th>Flag</th> <th>Effect</th> </tr> </thead> <tbody> <tr> <td><em>(default)</em></td> <td>Live progress + log file</td> </tr> <tr> <td><code>--verbose</code></td> <td>Extra detail (per-ATS logs during discover)</td> </tr> <tr> <td><code>--quiet</code></td> <td>One-line summary only</td> </tr> <tr> <td><code>--no-log</code></td> <td>Disable log file (stdout only)</td> </tr> </tbody> </table> <h2 id="commands-with-logging"> Commands with logging <a class="anchor" href="#commands-with-logging">#</a> </h2> <ul> <li><code>raven discover</code></li> <li><code>raven draft</code></li> <li><code>raven sync-jobs</code></li> <li><code>raven scan-ats</code> / <code>scan-boards</code></li> <li><code>raven query</code></li> <li><code>raven send</code></li> </ul> <h2 id="log-contents"> Log contents <a class="anchor" href="#log-contents">#</a> </h2> <p>Typical discover log:</p>https://raven.nopejs.me/docs/reference/file-layout/Mon, 01 Jan 0001 00:00:00 +0000https://raven.nopejs.me/docs/reference/file-layout/<h1 id="repository-layout"> Repository layout <a class="anchor" href="#repository-layout">#</a> </h1> <pre tabindex="0"><code>raven/ ├── bin/raven # CLI entry (npm link → global raven) ├── raven # Symlink to bin/raven ├── scripts/ # Bash wrappers (_lib.sh, discover.sh, draft.sh, …) ├── jobs/ # Node.js job engine │ ├── discover.mjs # Unified discovery orchestrator │ ├── draft-outreach.mjs # Draft orchestrator │ ├── lib/ # Shared modules (profile, resume, log, portals, …) │ └── plugins/ # Optional plugins (gemini-draft.mjs) ├── config/ │ ├── portals.example.yml │ ├── profile.example.yml │ └── outreach.example.yml ├── files/ │ └── resume.example.md # Template resume ├── data/ # Gitignored runtime data │ ├── jobs.json # Latest discover results │ ├── jobs.db # openjobdata SQLite index │ ├── cache/ # Resume parse cache, ATS slug lists │ └── logs/ # Command logs ├── drafts/ # Generated outreach CSV/MD/XLSX ├── docs/ # Markdown docs (source for this site) └── raven-web-docs/ # Hugo documentation site </code></pre><h2 id="tracked-vs-gitignored"> Tracked vs gitignored <a class="anchor" href="#tracked-vs-gitignored">#</a> </h2> <table> <thead> <tr> <th>Tracked (committed)</th> <th>Gitignored (local)</th> </tr> </thead> <tbody> <tr> <td><code>*.example.yml</code></td> <td><code>config/profile.yml</code></td> </tr> <tr> <td><code>files/resume.example.md</code></td> <td><code>config/portals.yml</code></td> </tr> <tr> <td>Source code</td> <td><code>config/outreach.yml</code></td> </tr> <tr> <td></td> <td><code>files/resume.md</code></td> </tr> <tr> <td></td> <td><code>data/*.json</code>, <code>data/jobs.db</code></td> </tr> <tr> <td></td> <td><code>data/logs/</code>, <code>data/cache/</code></td> </tr> <tr> <td></td> <td><code>drafts/outreach-*</code></td> </tr> <tr> <td></td> <td><code>.env</code></td> </tr> </tbody> </table> <h2 id="key-data-files"> Key data files <a class="anchor" href="#key-data-files">#</a> </h2> <table> <thead> <tr> <th>Path</th> <th>Created by</th> <th>Purpose</th> </tr> </thead> <tbody> <tr> <td><code>data/jobs.json</code></td> <td><code>raven discover</code></td> <td>Latest job matches (default draft input)</td> </tr> <tr> <td><code>data/jobs.db</code></td> <td><code>raven sync-jobs</code></td> <td>Local openjobdata index</td> </tr> <tr> <td><code>data/cache/resume-parsed.json</code></td> <td><code>raven draft</code></td> <td>Parsed resume cache</td> </tr> <tr> <td><code>drafts/outreach-*.csv</code></td> <td><code>raven draft</code></td> <td>Send-ready spreadsheet</td> </tr> </tbody> </table> <h2 id="npm-scripts"> npm scripts <a class="anchor" href="#npm-scripts">#</a> </h2> <p>Equivalent to <code>./raven</code> subcommands:</p>https://raven.nopejs.me/docs/reference/troubleshooting/Mon, 01 Jan 0001 00:00:00 +0000https://raven.nopejs.me/docs/reference/troubleshooting/<h1 id="troubleshooting"> Troubleshooting <a class="anchor" href="#troubleshooting">#</a> </h1> <p>Common issues and fixes.</p> <h2 id="raven-command-not-found"> <code>raven: command not found</code> <a class="anchor" href="#raven-command-not-found">#</a> </h2> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#75715e"># From repo root</span> </span></span><span style="display:flex;"><span>./raven --help </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># Or install globally</span> </span></span><span style="display:flex;"><span>npm link </span></span><span style="display:flex;"><span>raven --help </span></span></code></pre></div><p>If <code>npm link</code> resolves to the wrong path, use <code>./raven</code> from the repo root.</p> <h2 id="raven-draft--no-input-file"> <code>raven draft</code> — no input file <a class="anchor" href="#raven-draft--no-input-file">#</a> </h2> <p>Discover auto-saves to <code>data/jobs.json</code>. Run discover first:</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>raven discover --q <span style="color:#e6db74">&#34;engineer&#34;</span> </span></span><span style="display:flex;"><span>raven draft --max <span style="color:#ae81ff">25</span> </span></span></code></pre></div><p>Or pass explicit input:</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>raven draft --input data/jobs.json </span></span></code></pre></div><h2 id="unrelated-jobs-nurse-sales-etc"> Unrelated jobs (nurse, sales, etc.) <a class="anchor" href="#unrelated-jobs-nurse-sales-etc">#</a> </h2> <p>Bare <code>raven discover</code> reads <code>config/portals.yml</code>. Fix filters:</p>