@whittakertech/virgil 0.1.0

package/.tool-versions

@@ -0,0 +1 @@
+nodejs 20.11.1

package/README.md

@@ -0,0 +1,230 @@
+# WhittakerTech::Virgil
+
+**Build-phase sigil forge for static site artifacts**
+
+Virgil generates OG images, sitemaps, robots.txt, and other build artifacts deterministically with content-addressed caching.
+
+## Philosophy
+
+- **Deterministic**: Content-addressed hashing eliminates timestamp lies
+- **Locked**: Only regenerates what actually changed
+- **CI-first**: Designed for GitHub Actions, not local dev servers
+- **Declarative**: Everything in `virgil.spec.json`
+
+## Installation
+
+```bash
+npm install @whittakertech/virgil
+```
+
+## Quick Start
+
+### 1. Create `virgil.spec.json`
+
+```json
+{
+  "brand": {
+    "name": "WhittakerTech",
+    "logo": "docs/public/logo.svg",
+    "color": "#5b7cff"
+  },
+  "product": {
+    "name": "MosaicJS",
+    "logo": "docs/public/mosaic-logo.svg",
+    "version": "0.3.0"
+  },
+  "outputs": [
+    {
+      "type": "og-image",
+      "id": "getting-started",
+      "page": {
+        "title": "Getting Started",
+        "url": "https://mosaicjs.whittakertech.com/getting-started",
+        "description": "Learn how to use MosaicJS"
+      }
+    }
+  ]
+}
+```
+
+### 2. Run Virgil
+
+```bash
+npx virgil build
+```
+
+### 3. Reference in frontmatter
+
+```yaml
+---
+og-image: og:getting-started
+---
+```
+
+Your static site generator resolves `og:getting-started` via `virgil.manifest.json`.
+
+## How It Works
+
+### Execution Flow
+
+1. **Load spec** (`virgil.spec.json`) - declarative intent
+2. **Load lock** (`virgil.lock.json`) - truth from last run
+3. **Hash inputs** - SHA-256 of data + template + generator version
+4. **Compare** - skip if hash matches
+5. **Generate** - create artifacts only when needed
+6. **Update manifest** (`virgil.manifest.json`) - stable references
+7. **Write lock** - record current state
+
+### Content-Addressed Hashing
+
+```typescript
+hash = sha256(
+  JSON.stringify(data) +
+  templateContents +
+  generatorVersion
+)
+```
+
+Changes to **data**, **template**, or **generator** trigger regeneration. Timestamp changes do not.
+
+### Lock File (`virgil.lock.json`)
+
+```json
+{
+  "version": "0.1",
+  "entries": {
+    "getting-started": {
+      "hash": "sha256:9fa4c...",
+      "generatedAt": "2025-01-15T10:30:00Z",
+      "generator": "og-image",
+      "generatorVersion": "0.1.0"
+    }
+  }
+}
+```
+
+### Manifest (`virgil.manifest.json`)
+
+```json
+{
+  "version": "0.1",
+  "og": {
+    "getting-started": "/og/getting-started.1735346221.png"
+  }
+}
+```
+
+Frontmatter uses stable IDs (`og:getting-started`), manifest maps to cache-busted filenames.
+
+## Output Types
+
+### OG Images
+
+```json
+{
+  "type": "og-image",
+  "id": "home",
+  "page": {
+    "title": "Welcome",
+    "url": "https://example.com",
+    "description": "Optional description"
+  }
+}
+```
+
+Generates 1200×630 PNG using Playwright.
+
+### Sitemap
+
+```json
+{
+  "type": "sitemap",
+  "id": "main",
+  "baseUrl": "https://example.com",
+  "pages": [
+    {
+      "path": "/",
+      "lastmod": "2025-01-15",
+      "changefreq": "weekly",
+      "priority": 1.0
+    }
+  ]
+}
+```
+
+### Robots.txt
+
+```json
+{
+  "type": "robots",
+  "id": "default",
+  "rules": [
+    {
+      "userAgent": "*",
+      "allow": ["/"],
+      "disallow": ["/admin"]
+    }
+  ],
+  "sitemap": "https://example.com/sitemap.xml"
+}
+```
+
+## CLI
+
+```bash
+virgil build [options]
+
+Options:
+  -r, --root <dir>     Project root directory (default: cwd)
+  -o, --output <dir>   Output directory (default: public)
+  -v, --verbose        Verbose output
+```
+
+## Programmatic Usage
+
+```typescript
+import { run } from '@whittakertech/virgil';
+
+const result = await run({
+  rootDir: process.cwd(),
+  outputDir: 'public',
+  verbose: true
+});
+
+console.log(`Generated: ${result.generated}`);
+console.log(`Skipped: ${result.skipped}`);
+```
+
+## GitHub Actions
+
+```yaml
+- name: Generate artifacts
+  run: npx virgil build --verbose
+```
+
+Virgil skips unchanged artifacts, keeping CI fast.
+
+## v0.1 Scope
+
+**Supported:**
+- ✅ OG image generation (PNG)
+- ✅ sitemap.xml generation
+- ✅ robots.txt generation
+- ✅ Content-addressed locking
+- ✅ Manifest rewriting
+- ✅ No-op if nothing changed
+
+**Not Yet:**
+- ❌ Watch mode
+- ❌ Vite/VitePress runtime integration
+- ❌ React/Vue rendering
+- ❌ Remote data fetching
+- ❌ Partial page crawling
+
+## License
+
+MIT
+
+## Author
+
+Lee Whittaker • WhittakerTech

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { run } from './engine/run.js';
+import { resolve } from 'path';
+const program = new Command();
+program
+    .name('virgil')
+    .description('Build-phase sigil forge for static site artifacts')
+    .version('0.1.0');
+program
+    .command('build')
+    .description('Generate artifacts from virgil.spec.json')
+    .option('-r, --root <dir>', 'Project root directory', process.cwd())
+    .option('-o, --output <dir>', 'Output directory', 'public')
+    .option('-v, --verbose', 'Verbose output', false)
+    .action(async (options) => {
+    const rootDir = resolve(options.root);
+    const outputDir = resolve(rootDir, options.output);
+    console.log('🔮 Virgil v0.1.0');
+    console.log(`📁 Root: ${rootDir}`);
+    console.log(`📦 Output: ${outputDir}`);
+    console.log('');
+    const result = await run({
+        rootDir,
+        outputDir,
+        verbose: options.verbose
+    });
+    if (result.errors.length > 0) {
+        console.error('\n❌ Errors:');
+        for (const error of result.errors) {
+            console.error(`  ${error}`);
+        }
+        process.exit(1);
+    }
+    console.log('\n✨ Done');
+    process.exit(0);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,mDAAmD,CAAC;KAChE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACnE,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,QAAQ,CAAC;KAC1D,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,KAAK,CAAC;KAChD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnD,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,cAAc,SAAS,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC;QACvB,OAAO;QACP,SAAS;QACT,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/engine/hash.d.ts

@@ -0,0 +1,20 @@
+export declare const GENERATOR_VERSION = "0.1.0";
+export interface HashInput {
+    data: unknown;
+    templatePath?: string;
+    generatorName: string;
+}
+/**
+ * Compute deterministic hash from input data, template contents, and generator version.
+ *
+ * This ensures:
+ * - Data changes trigger regeneration
+ * - Template changes trigger regeneration
+ * - Generator version changes trigger regeneration
+ */
+export declare function computeHash(input: HashInput): Promise<string>;
+/**
+ * Compute hash for a file's contents
+ */
+export declare function hashFile(filepath: string): Promise<string>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/engine/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/engine/hash.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAsBD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBnE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKhE"}

package/dist/engine/hash.js

@@ -0,0 +1,53 @@
+import { createHash } from 'crypto';
+import { readFile } from 'fs/promises';
+export const GENERATOR_VERSION = '0.1.0';
+function stableStringify(value) {
+    if (value === null || typeof value !== 'object') {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return JSON.stringify(value.map(stableStringify));
+    }
+    const obj = value;
+    const sortedKeys = Object.keys(obj).sort();
+    const normalized = {};
+    for (const key of sortedKeys) {
+        normalized[key] = obj[key];
+    }
+    return JSON.stringify(normalized);
+}
+/**
+ * Compute deterministic hash from input data, template contents, and generator version.
+ *
+ * This ensures:
+ * - Data changes trigger regeneration
+ * - Template changes trigger regeneration
+ * - Generator version changes trigger regeneration
+ */
+export async function computeHash(input) {
+    const parts = [];
+    // 1. Serialize data (stable JSON)
+    parts.push(stableStringify(input.data));
+    // 2. Include template contents if specified
+    if (input.templatePath) {
+        const templateContents = await readFile(input.templatePath, 'utf-8');
+        parts.push(templateContents);
+    }
+    // 3. Include generator identity
+    parts.push(input.generatorName);
+    parts.push(GENERATOR_VERSION);
+    // Compute SHA-256
+    const hash = createHash('sha256');
+    hash.update(parts.join('\n'));
+    return `sha256:${hash.digest('hex')}`;
+}
+/**
+ * Compute hash for a file's contents
+ */
+export async function hashFile(filepath) {
+    const contents = await readFile(filepath);
+    const hash = createHash('sha256');
+    hash.update(contents);
+    return `sha256:${hash.digest('hex')}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/engine/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/engine/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAQzC,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAE3C,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,UAAU,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAgB;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,kCAAkC;IAClC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAExC,4CAA4C;IAC5C,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,gBAAgB,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAE9B,kBAAkB;IAClB,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9B,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtB,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACxC,CAAC"}

package/dist/engine/lock.d.ts

@@ -0,0 +1,18 @@
+import { VirgilLock } from '../types/lock.js';
+/**
+ * Load lock file if it exists, return empty lock otherwise
+ */
+export declare function loadLock(lockPath: string): Promise<VirgilLock>;
+/**
+ * Write lock file atomically
+ */
+export declare function saveLock(lockPath: string, lock: VirgilLock): Promise<void>;
+/**
+ * Check if output needs regeneration
+ */
+export declare function needsRegeneration(lock: VirgilLock, id: string, currentHash: string): boolean;
+/**
+ * Update lock entry
+ */
+export declare function updateLockEntry(lock: VirgilLock, id: string, hash: string, generator: string, generatorVersion: string): void;
+//# sourceMappingURL=lock.d.ts.map

package/dist/engine/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/engine/lock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AAIzD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAWpE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,GAClB,OAAO,CAUT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,IAAI,CAON"}

package/dist/engine/lock.js

@@ -0,0 +1,54 @@
+import { readFile, writeFile } from 'fs/promises';
+const LOCK_VERSION = '0.1';
+/**
+ * Load lock file if it exists, return empty lock otherwise
+ */
+export async function loadLock(lockPath) {
+    try {
+        const contents = await readFile(lockPath, 'utf-8');
+        return JSON.parse(contents);
+    }
+    catch (err) {
+        // Lock doesn't exist or is invalid - start fresh
+        return {
+            version: LOCK_VERSION,
+            entries: {}
+        };
+    }
+}
+/**
+ * Write lock file atomically
+ */
+export async function saveLock(lockPath, lock) {
+    const contents = JSON.stringify(lock, null, 2);
+    // Write to temp file, then rename (atomic on POSIX)
+    const tempPath = `${lockPath}.tmp`;
+    await writeFile(tempPath, contents, 'utf-8');
+    // Atomic rename
+    const { rename } = await import('fs/promises');
+    await rename(tempPath, lockPath);
+}
+/**
+ * Check if output needs regeneration
+ */
+export function needsRegeneration(lock, id, currentHash) {
+    const entry = lock.entries[id];
+    if (!entry) {
+        // Never generated before
+        return true;
+    }
+    // Compare hashes
+    return entry.hash !== currentHash;
+}
+/**
+ * Update lock entry
+ */
+export function updateLockEntry(lock, id, hash, generator, generatorVersion) {
+    lock.entries[id] = {
+        hash,
+        generatedAt: new Date().toISOString(),
+        generator,
+        generatorVersion
+    };
+}
+//# sourceMappingURL=lock.js.map

package/dist/engine/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/engine/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,YAAY,GAAG,KAAc,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iDAAiD;QACjD,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB,EAAE,IAAgB;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE/C,oDAAoD;IACpD,MAAM,QAAQ,GAAG,GAAG,QAAQ,MAAM,CAAC;IACnC,MAAM,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE7C,gBAAgB;IAChB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAgB,EAChB,EAAU,EACV,WAAmB;IAEnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAE/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,yBAAyB;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB;IACjB,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAgB,EAChB,EAAU,EACV,IAAY,EACZ,SAAiB,EACjB,gBAAwB;IAExB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG;QACjB,IAAI;QACJ,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,SAAS;QACT,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/engine/manifest.d.ts

@@ -0,0 +1,14 @@
+import { VirgilManifest } from '../types/manifest.js';
+/**
+ * Load manifest if it exists, return empty manifest otherwise
+ */
+export declare function loadManifest(manifestPath: string): Promise<VirgilManifest>;
+/**
+ * Write manifest atomically
+ */
+export declare function saveManifest(manifestPath: string, manifest: VirgilManifest): Promise<void>;
+/**
+ * Update manifest entry for given output type
+ */
+export declare function updateManifestEntry(manifest: VirgilManifest, type: 'og' | 'sitemap' | 'robots', id: string, path: string): void;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/engine/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/engine/manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAYhF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,EACjC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GACX,IAAI,CAKN"}

package/dist/engine/manifest.js

@@ -0,0 +1,39 @@
+import { readFile, writeFile } from 'fs/promises';
+const MANIFEST_VERSION = '0.1';
+/**
+ * Load manifest if it exists, return empty manifest otherwise
+ */
+export async function loadManifest(manifestPath) {
+    try {
+        const contents = await readFile(manifestPath, 'utf-8');
+        return JSON.parse(contents);
+    }
+    catch (err) {
+        return {
+            version: MANIFEST_VERSION,
+            og: {},
+            sitemap: {},
+            robots: {}
+        };
+    }
+}
+/**
+ * Write manifest atomically
+ */
+export async function saveManifest(manifestPath, manifest) {
+    const contents = JSON.stringify(manifest, null, 2);
+    const tempPath = `${manifestPath}.tmp`;
+    await writeFile(tempPath, contents, 'utf-8');
+    const { rename } = await import('fs/promises');
+    await rename(tempPath, manifestPath);
+}
+/**
+ * Update manifest entry for given output type
+ */
+export function updateManifestEntry(manifest, type, id, path) {
+    if (!manifest[type]) {
+        manifest[type] = {};
+    }
+    manifest[type][id] = path;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/engine/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/engine/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,gBAAgB,GAAG,KAAc,CAAC;AAExC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB;IACrD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,gBAAgB;YACzB,EAAE,EAAE,EAAE;YACN,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE;SACX,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,YAAoB,EACpB,QAAwB;IAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAG,GAAG,YAAY,MAAM,CAAC;IACvC,MAAM,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE7C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAwB,EACxB,IAAiC,EACjC,EAAU,EACV,IAAY;IAEZ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,CAAC;IACD,QAAQ,CAAC,IAAI,CAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;AAC7B,CAAC"}

package/dist/engine/run.d.ts

@@ -0,0 +1,15 @@
+export interface RunOptions {
+    rootDir: string;
+    outputDir: string;
+    verbose?: boolean;
+}
+export interface RunResult {
+    generated: number;
+    skipped: number;
+    errors: string[];
+}
+/**
+ * Main orchestration - this is the heart of Virgil
+ */
+export declare function run(options: RunOptions): Promise<RunResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/engine/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/engine/run.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAkDjE"}

package/dist/engine/run.js

@@ -0,0 +1,110 @@
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { PathResolver } from '../utils/paths.js';
+import { computeHash, GENERATOR_VERSION } from './hash.js';
+import { loadLock, saveLock, needsRegeneration, updateLockEntry } from './lock.js';
+import { loadManifest, saveManifest, updateManifestEntry } from './manifest.js';
+import { generateOGImage, generateOGImageFilename } from '../generators/og-image.js';
+import { generateSitemap } from '../generators/sitemap.js';
+import { generateRobots } from '../generators/robots.js';
+/**
+ * Main orchestration - this is the heart of Virgil
+ */
+export async function run(options) {
+    const paths = new PathResolver(options.rootDir);
+    const result = {
+        generated: 0,
+        skipped: 0,
+        errors: []
+    };
+    try {
+        // Step 1: Load spec
+        const specContents = await readFile(paths.spec, 'utf-8');
+        const spec = JSON.parse(specContents);
+        if (options.verbose) {
+            console.log(`📋 Loaded spec with ${spec.outputs.length} outputs`);
+        }
+        // Step 2: Load previous lock
+        const lock = await loadLock(paths.lock);
+        // Step 3: Load manifest
+        const manifest = await loadManifest(paths.manifest);
+        // Step 4-7: Process each output
+        for (const output of spec.outputs) {
+            try {
+                await processOutput(spec, output, lock, manifest, options, result);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                result.errors.push(`${output.id}: ${message}`);
+            }
+        }
+        // Step 8: Write updated lock
+        await saveLock(paths.lock, lock);
+        // Step 9: Write updated manifest
+        await saveManifest(paths.manifest, manifest);
+        if (options.verbose) {
+            console.log(`✅ Generated: ${result.generated}, Skipped: ${result.skipped}, Errors: ${result.errors.length}`);
+        }
+        return result;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        result.errors.push(`Fatal: ${message}`);
+        return result;
+    }
+}
+async function processOutput(spec, output, lock, manifest, options, result) {
+    // Compute current hash
+    const hash = await computeHash({
+        data: output,
+        generatorName: output.type
+    });
+    // Check if regeneration needed
+    if (!needsRegeneration(lock, output.id, hash)) {
+        if (options.verbose) {
+            console.log(`⏭️  Skipping ${output.id} (unchanged)`);
+        }
+        result.skipped++;
+        return;
+    }
+    if (options.verbose) {
+        console.log(`🔨 Generating ${output.id}`);
+    }
+    // Generate based on type
+    let outputPath;
+    let manifestPath;
+    switch (output.type) {
+        case 'og-image': {
+            const filename = generateOGImageFilename(output.id);
+            outputPath = join(options.outputDir, 'og', filename);
+            manifestPath = `/og/${filename}`;
+            await generateOGImage({
+                brand: spec.brand,
+                product: spec.product,
+                output
+            }, outputPath);
+            updateManifestEntry(manifest, 'og', output.id, manifestPath);
+            break;
+        }
+        case 'sitemap': {
+            outputPath = join(options.outputDir, 'sitemap.xml');
+            manifestPath = '/sitemap.xml';
+            await generateSitemap({ output }, outputPath);
+            updateManifestEntry(manifest, 'sitemap', output.id, manifestPath);
+            break;
+        }
+        case 'robots': {
+            outputPath = join(options.outputDir, 'robots.txt');
+            manifestPath = '/robots.txt';
+            await generateRobots({ output }, outputPath);
+            updateManifestEntry(manifest, 'robots', output.id, manifestPath);
+            break;
+        }
+        default:
+            throw new Error(`Unknown output type: ${output.type}`);
+    }
+    // Update lock
+    updateLockEntry(lock, output.id, hash, output.type, GENERATOR_VERSION);
+    result.generated++;
+}
+//# sourceMappingURL=run.js.map

package/dist/engine/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/engine/run.ts"],"names":[],"mappings":"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"}

package/dist/generators/og-image.d.ts

@@ -0,0 +1,16 @@
+import { OGImageOutput, BrandConfig, ProductConfig } from '../types/spec.js';
+export interface OGImageContext {
+    brand: BrandConfig;
+    product: ProductConfig;
+    output: OGImageOutput;
+    templatePath?: string;
+}
+/**
+ * Generate OG image using Playwright
+ */
+export declare function generateOGImage(ctx: OGImageContext, outputPath: string): Promise<void>;
+/**
+ * Generate filename for OG image with cache-busting timestamp
+ */
+export declare function generateOGImageFilename(id: string): string;
+//# sourceMappingURL=og-image.d.ts.map