mirror of
https://github.com/garrytan/gstack.git
synced 2026-05-05 05:05:08 +02:00
Garry Tan
0708273e5a
Skill templates can now embed {{MAKE_PDF_SETUP}} to resolve $P to the
make-pdf binary via the same discovery order as $B / $D: env override
(MAKE_PDF_BIN), local skill root, global install, or PATH.
Mirrors the pattern established by generateBrowseSetup() and
generateDesignSetup() in scripts/resolvers/design.ts.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
51 lines
2.2 KiB
TypeScript
51 lines
2.2 KiB
TypeScript
import type { TemplateContext } from './types';
|
|
|
|
/**
|
|
* {{MAKE_PDF_SETUP}} — emits the shell preamble that resolves $P to the
|
|
* make-pdf binary. Mirrors generateBrowseSetup / generateDesignSetup.
|
|
*
|
|
* $P = make-pdf/dist/pdf.
|
|
*
|
|
* Resolution order (matches src/browseClient.ts::resolveBrowseBin):
|
|
* 1. Local skill root: $_ROOT/{localSkillRoot}/make-pdf/dist/pdf
|
|
* 2. Global: ~/{globalRoot}/make-pdf/dist/pdf
|
|
* 3. Env override (MAKE_PDF_BIN) — for contributor dev builds
|
|
*/
|
|
export function generateMakePdfSetup(ctx: TemplateContext): string {
|
|
return `## MAKE-PDF SETUP (run this check BEFORE any make-pdf command)
|
|
|
|
\`\`\`bash
|
|
_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
|
|
P=""
|
|
[ -n "$MAKE_PDF_BIN" ] && [ -x "$MAKE_PDF_BIN" ] && P="$MAKE_PDF_BIN"
|
|
[ -z "$P" ] && [ -n "$_ROOT" ] && [ -x "$_ROOT/${ctx.paths.localSkillRoot}/make-pdf/dist/pdf" ] && P="$_ROOT/${ctx.paths.localSkillRoot}/make-pdf/dist/pdf"
|
|
[ -z "$P" ] && P="$HOME${ctx.paths.makePdfDir.replace(/^~/, '')}/pdf"
|
|
if [ -x "$P" ]; then
|
|
echo "MAKE_PDF_READY: $P"
|
|
alias _p_="$P" # shellcheck alias helper (not exported)
|
|
export P # available as $P in subsequent blocks within the same skill invocation
|
|
else
|
|
echo "MAKE_PDF_NOT_AVAILABLE (run './setup' in the gstack repo to build it)"
|
|
fi
|
|
\`\`\`
|
|
|
|
If \`MAKE_PDF_NOT_AVAILABLE\` is printed: tell the user the binary is not
|
|
built. Have them run \`./setup\` from the gstack repo, then retry.
|
|
|
|
If \`MAKE_PDF_READY\` is printed: \`$P\` is the binary path for the rest of
|
|
the skill. Use \`$P\` (not an explicit path) so the skill body stays portable.
|
|
|
|
Core commands:
|
|
- \`$P generate <input.md> [output.pdf]\` — render markdown to PDF (80% use case)
|
|
- \`$P generate --cover --toc essay.md out.pdf\` — full publication layout
|
|
- \`$P generate --watermark DRAFT memo.md draft.pdf\` — diagonal DRAFT watermark
|
|
- \`$P preview <input.md>\` — render HTML and open in browser (fast iteration)
|
|
- \`$P setup\` — verify browse + Chromium + pdftotext and run a smoke test
|
|
- \`$P --help\` — full flag reference
|
|
|
|
Output contract:
|
|
- \`stdout\`: ONLY the output path on success. One line.
|
|
- \`stderr\`: progress (\`Rendering HTML... Generating PDF...\`) unless \`--quiet\`.
|
|
- Exit 0 success / 1 bad args / 2 render error / 3 Paged.js timeout / 4 browse unavailable.`;
|
|
}
|