tractatus/scripts/generate-single-pdf.js
TheFlow d95dc4663c feat(infra): semantic versioning and systemd service implementation
**Cache-Busting Improvements:**
- Switched from timestamp-based to semantic versioning (v1.0.2)
- Updated all HTML files: index.html, docs.html, leader.html
- CSS: tailwind.css?v=1.0.2
- JS: navbar.js, document-cards.js, docs-app.js v1.0.2
- Professional versioning approach for production stability

**systemd Service Implementation:**
- Created tractatus-dev.service for development environment
- Created tractatus-prod.service for production environment
- Added install-systemd.sh script for easy deployment
- Security hardening: NoNewPrivileges, PrivateTmp, ProtectSystem
- Resource limits: 1GB dev, 2GB prod memory limits
- Proper logging integration with journalctl
- Automatic restart on failure (RestartSec=10)

**Why systemd over pm2:**
1. Native Linux integration, no additional dependencies
2. Better OS-level security controls (ProtectSystem, ProtectHome)
3. Superior logging with journalctl integration
4. Standard across Linux distributions
5. More robust process management for production

**Usage:**
  # Development:
  sudo ./scripts/install-systemd.sh dev

  # Production:
  sudo ./scripts/install-systemd.sh prod

  # View logs:
  sudo journalctl -u tractatus -f

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-09 09:16:22 +13:00

380 lines
8.1 KiB
JavaScript
Executable file

#!/usr/bin/env node
/**
* Generate PDF from Single Markdown File
*
* Usage: node scripts/generate-single-pdf.js <input.md> [output.pdf]
*
* Copyright 2025 Tractatus Project
* Licensed under Apache License 2.0
*/
const puppeteer = require('puppeteer');
const marked = require('marked');
const fs = require('fs').promises;
const path = require('path');
// Parse command line arguments
const args = process.argv.slice(2);
if (args.length < 1) {
console.error('Usage: node scripts/generate-single-pdf.js <input.md> [output.pdf]');
process.exit(1);
}
const inputPath = path.resolve(args[0]);
const outputPath = args[1]
? path.resolve(args[1])
: inputPath.replace(/\.md$/, '.pdf');
/**
* HTML template for PDF generation
*/
function generatePdfHtml(title, content) {
return `
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>${title}</title>
<style>
@page {
margin: 2cm;
size: A4;
}
* {
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
font-size: 11pt;
line-height: 1.6;
color: #1f2937;
max-width: 100%;
margin: 0;
padding: 0;
}
/* Cover page */
.cover {
page-break-after: always;
display: flex;
flex-direction: column;
justify-content: center;
align-items: center;
min-height: 80vh;
text-align: center;
border-bottom: 3px solid #2563eb;
padding-bottom: 2cm;
}
.cover h1 {
font-size: 2.5rem;
font-weight: 700;
color: #111827;
margin-bottom: 1rem;
line-height: 1.2;
}
.cover .metadata {
font-size: 1rem;
color: #6b7280;
margin-top: 2rem;
}
.cover .metadata p {
margin: 0.5rem 0;
}
/* Content */
.content {
color: #374151;
}
h1 {
font-size: 1.875rem;
font-weight: 700;
color: #111827;
margin-top: 2rem;
margin-bottom: 1rem;
line-height: 1.2;
border-bottom: 2px solid #e5e7eb;
padding-bottom: 0.5rem;
page-break-after: avoid;
}
h2 {
font-size: 1.5rem;
font-weight: 600;
color: #111827;
margin-top: 1.75rem;
margin-bottom: 0.875rem;
line-height: 1.3;
border-bottom: 1px solid #e5e7eb;
padding-bottom: 0.375rem;
page-break-after: avoid;
}
h3 {
font-size: 1.25rem;
font-weight: 600;
color: #1f2937;
margin-top: 1.5rem;
margin-bottom: 0.75rem;
line-height: 1.4;
page-break-after: avoid;
}
h4 {
font-size: 1.125rem;
font-weight: 600;
color: #374151;
margin-top: 1.25rem;
margin-bottom: 0.5rem;
line-height: 1.5;
page-break-after: avoid;
}
p {
margin-bottom: 1rem;
line-height: 1.75;
orphans: 3;
widows: 3;
}
ul, ol {
margin-bottom: 1rem;
padding-left: 1.75rem;
line-height: 1.75;
}
li {
margin-bottom: 0.375rem;
}
ul ul,
ol ul {
list-style-type: circle;
margin-top: 0.375rem;
margin-bottom: 0.375rem;
}
ul ol,
ol ol {
list-style-type: lower-alpha;
margin-top: 0.375rem;
margin-bottom: 0.375rem;
}
code {
background-color: #f3f4f6;
padding: 0.125rem 0.375rem;
border-radius: 0.25rem;
font-size: 0.875rem;
font-family: "Courier New", Courier, monospace;
color: #1f2937;
border: 1px solid #e5e7eb;
}
pre {
background-color: #f9fafb;
color: #1f2937;
padding: 1rem;
border-radius: 0.375rem;
margin-bottom: 1rem;
overflow-x: auto;
border: 1px solid #d1d5db;
page-break-inside: avoid;
}
pre code {
background-color: transparent;
padding: 0;
border: none;
color: inherit;
font-size: 0.8125rem;
line-height: 1.5;
}
blockquote {
border-left: 4px solid #3b82f6;
padding-left: 1rem;
font-style: italic;
color: #6b7280;
margin: 1.25rem 0;
background-color: #f9fafb;
padding: 0.875rem 0.875rem 0.875rem 1rem;
border-radius: 0.25rem;
page-break-inside: avoid;
}
table {
width: 100%;
border-collapse: collapse;
margin-bottom: 1.25rem;
font-size: 0.875rem;
page-break-inside: avoid;
}
th {
background-color: #f3f4f6;
border: 1px solid #d1d5db;
padding: 0.625rem 0.875rem;
text-align: left;
font-weight: 600;
color: #111827;
}
td {
border: 1px solid #d1d5db;
padding: 0.625rem 0.875rem;
color: #374151;
}
tbody tr:nth-child(even) {
background-color: #f9fafb;
}
a {
color: #2563eb;
text-decoration: underline;
}
strong, b {
font-weight: 600;
color: #111827;
}
em, i {
font-style: italic;
}
hr {
border: none;
border-top: 1px solid #d1d5db;
margin: 1.5rem 0;
}
/* Footer */
.footer {
margin-top: 3rem;
padding-top: 1.5rem;
border-top: 1px solid #e5e7eb;
font-size: 0.875rem;
color: #6b7280;
text-align: center;
}
/* Avoid breaking these elements */
h1, h2, h3, h4, h5, h6 {
page-break-inside: avoid;
}
pre, blockquote, table, figure {
page-break-inside: avoid;
}
</style>
</head>
<body>
<div class="cover">
<h1>${title}</h1>
<div class="metadata">
<p><strong>Document Type:</strong> Technical Documentation</p>
<p><strong>Generated:</strong> ${new Date().toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric' })}</p>
<p style="margin-top: 2rem; font-style: italic;">Tractatus AI Safety Framework</p>
<p style="font-size: 0.875rem;">https://agenticgovernance.digital</p>
</div>
</div>
<div class="content">
${content}
</div>
<div class="footer">
<p>© ${new Date().getFullYear()} Tractatus AI Safety Framework</p>
<p>This document is part of the Tractatus Agentic Governance System</p>
<p>https://agenticgovernance.digital</p>
</div>
</body>
</html>
`;
}
/**
* Main execution
*/
async function main() {
console.log('=== PDF Generation from Markdown ===\n');
let browser;
try {
// Read markdown file
console.log(`Reading: ${inputPath}`);
const markdown = await fs.readFile(inputPath, 'utf8');
// Extract title from first # heading
const titleMatch = markdown.match(/^#\s+(.+)$/m);
const title = titleMatch ? titleMatch[1] : path.basename(inputPath, '.md');
console.log(`Title: ${title}`);
// Convert markdown to HTML
console.log('Converting markdown to HTML...');
const contentHtml = marked.parse(markdown);
// Generate full HTML
const html = generatePdfHtml(title, contentHtml);
// Launch Puppeteer
console.log('Launching browser...');
browser = await puppeteer.launch({
headless: true,
args: ['--no-sandbox', '--disable-setuid-sandbox']
});
const page = await browser.newPage();
// Set content
console.log('Rendering HTML...');
await page.setContent(html, {
waitUntil: 'networkidle0'
});
// Generate PDF
console.log(`Generating PDF: ${outputPath}`);
await page.pdf({
path: outputPath,
format: 'A4',
printBackground: true,
margin: {
top: '2cm',
right: '2cm',
bottom: '2cm',
left: '2cm'
},
displayHeaderFooter: true,
headerTemplate: '<div></div>',
footerTemplate: `
<div style="width: 100%; font-size: 9pt; text-align: center; color: #6b7280; padding: 0 2cm;">
<span class="pageNumber"></span> / <span class="totalPages"></span>
</div>
`
});
console.log('\n✓ PDF generated successfully!\n');
console.log(`Output: ${outputPath}`);
} catch (error) {
console.error('\n✗ Error:', error.message);
process.exit(1);
} finally {
if (browser) await browser.close();
}
}
// Run
main();