npm - @grainulation/barn - Versions diffs - 1.0.0 - Mend

@grainulation/barn 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (50) hide show

package/CHANGELOG.md +13 -0
package/LICENSE +21 -0
package/README.md +87 -0
package/bin/barn.js +98 -0
package/lib/index.js +93 -0
package/lib/server.js +368 -0
package/package.json +52 -0
package/public/grainulation-tokens.css +321 -0
package/public/index.html +907 -0
package/templates/README.md +48 -0
package/templates/adr.html +223 -0
package/templates/adr.json +29 -0
package/templates/brief.html +297 -0
package/templates/brief.json +26 -0
package/templates/certificate.html +247 -0
package/templates/certificate.json +23 -0
package/templates/changelog.html +239 -0
package/templates/changelog.json +19 -0
package/templates/ci-workflow.yml +52 -0
package/templates/comparison.html +248 -0
package/templates/comparison.json +21 -0
package/templates/conflict-map.html +240 -0
package/templates/conflict-map.json +19 -0
package/templates/dashboard.html +515 -0
package/templates/dashboard.json +22 -0
package/templates/email-digest.html +178 -0
package/templates/email-digest.json +18 -0
package/templates/evidence-matrix.html +232 -0
package/templates/evidence-matrix.json +21 -0
package/templates/explainer.html +342 -0
package/templates/explainer.json +23 -0
package/templates/handoff.html +343 -0
package/templates/handoff.json +24 -0
package/templates/one-pager.html +248 -0
package/templates/one-pager.json +22 -0
package/templates/postmortem.html +303 -0
package/templates/postmortem.json +20 -0
package/templates/rfc.html +199 -0
package/templates/rfc.json +32 -0
package/templates/risk-register.html +231 -0
package/templates/risk-register.json +22 -0
package/templates/slide-deck.html +239 -0
package/templates/slide-deck.json +23 -0
package/templates/template.schema.json +25 -0
package/templates/wiki-page.html +222 -0
package/templates/wiki-page.json +23 -0
package/tools/README.md +31 -0
package/tools/build-pdf.js +43 -0
package/tools/detect-sprints.js +292 -0
package/tools/generate-manifest.js +237 -0

package/templates/certificate.html ADDED Viewed

@@ -0,0 +1,247 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Compilation Certificate -- {{SPRINT_NAME}}</title>
+<style>
+  /* barn/templates/certificate.html — compilation certificate as visual artifact
+     Centered formal layout with double border frame, monospace hash display.
+     System font stack, no external dependencies, fully self-contained. */
+  :root {
+    --bg: #0a0e1a;
+    --bg2: #111827;
+    --bg3: #1e293b;
+    --accent: #3b82f6;
+    --accent-light: #60a5fa;
+    --green: #22c55e;
+    --green-dim: rgba(34,197,94,0.12);
+    --red: #e11d48;
+    --red-dim: rgba(225,29,72,0.12);
+    --text: #f1f5f9;
+    --text-muted: #94a3b8;
+    --text-dim: #64748b;
+  }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  html, body { height: 100%; }
+  body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Inter', sans-serif;
+    background: var(--bg);
+    color: var(--text);
+    -webkit-font-smoothing: antialiased;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    min-height: 100vh;
+    padding: 40px 20px;
+  }
+  .certificate {
+    width: 100%; max-width: 640px;
+    background: var(--bg2);
+    border: 2px solid rgba(59,130,246,0.2);
+    border-radius: 16px;
+    padding: 48px 40px;
+    position: relative;
+    text-align: center;
+  }
+  /* Double frame border effect */
+  .certificate::before {
+    content: '';
+    position: absolute; top: 8px; left: 8px; right: 8px; bottom: 8px;
+    border: 1px solid rgba(59,130,246,0.08);
+    border-radius: 12px; pointer-events: none;
+  }
+  .certificate::after {
+    content: '';
+    position: absolute; top: 16px; left: 16px; right: 16px; bottom: 16px;
+    border: 1px solid rgba(59,130,246,0.05);
+    border-radius: 10px; pointer-events: none;
+  }
+  .cert-label {
+    font-size: 8pt; font-weight: 600;
+    letter-spacing: 0.2em; text-transform: uppercase;
+    color: var(--accent-light); margin-bottom: 12px;
+  }
+  .cert-sprint {
+    font-size: 20pt; font-weight: 700;
+    color: #fff; margin-bottom: 4px;
+  }
+  .cert-divider {
+    width: 60px; height: 2px;
+    background: var(--accent); border-radius: 1px;
+    margin: 20px auto;
+  }
+  .cert-hash {
+    font-family: 'SF Mono', 'Fira Code', 'Consolas', monospace;
+    font-size: 16pt; font-weight: 600;
+    color: var(--accent-light); letter-spacing: 0.06em;
+    word-break: break-all; padding: 16px 20px;
+    background: var(--bg); border-radius: 8px;
+    border: 1px solid rgba(59,130,246,0.15);
+    margin: 20px 0;
+  }
+  .cert-details {
+    display: grid;
+    grid-template-columns: 1fr 1fr 1fr;
+    gap: 16px;
+    margin: 24px 0;
+  }
+  .cert-detail {
+    padding: 12px 8px;
+    background: var(--bg);
+    border-radius: 8px;
+  }
+  .cert-detail-label {
+    font-size: 7pt; font-weight: 600;
+    text-transform: uppercase; letter-spacing: 0.12em;
+    color: var(--text-dim); margin-bottom: 4px;
+  }
+  .cert-detail-value {
+    font-size: 14pt; font-weight: 700;
+    color: var(--text);
+    font-family: 'SF Mono', 'Fira Code', 'Consolas', monospace;
+  }
+  /* Evidence tier bars */
+  .cert-evidence { margin: 20px 0; text-align: left; }
+  .cert-evidence h3 {
+    font-size: 8pt; font-weight: 600;
+    text-transform: uppercase; letter-spacing: 0.1em;
+    color: var(--text-dim); margin-bottom: 10px;
+    text-align: center;
+  }
+  .tier-row {
+    display: flex; align-items: center;
+    gap: 10px; margin-bottom: 6px;
+  }
+  .tier-name {
+    min-width: 90px; color: var(--text-muted);
+    text-transform: uppercase; letter-spacing: 0.06em;
+    font-size: 8pt; text-align: right;
+  }
+  .tier-track {
+    flex: 1; height: 6px;
+    background: var(--bg); border-radius: 3px; overflow: hidden;
+  }
+  .tier-fill { height: 100%; border-radius: 3px; background: var(--accent); }
+  .tier-fill.stated { background: var(--text-dim); }
+  .tier-fill.web { background: #f59e0b; }
+  .tier-fill.documented { background: var(--accent); }
+  .tier-fill.tested { background: var(--green); }
+  .tier-fill.production { background: #a78bfa; }
+  .tier-count {
+    min-width: 28px; color: var(--text-dim);
+    font-family: monospace; font-size: 9pt;
+  }
+  /* Conflict status */
+  .cert-conflict {
+    margin: 16px 0; padding: 10px 16px;
+    border-radius: 6px; font-size: 10pt; font-weight: 500;
+  }
+  .cert-conflict.resolved { background: var(--green-dim); color: var(--green); }
+  .cert-conflict.unresolved { background: var(--red-dim); color: var(--red); }
+  .cert-statement {
+    margin-top: 24px; font-size: 9pt;
+    color: var(--text-dim); font-style: italic; line-height: 1.5;
+  }
+  .cert-footer {
+    margin-top: 20px; font-size: 8pt; color: var(--text-dim);
+  }
+  @media (max-width: 768px) {
+    body { padding: 16px; }
+    .certificate { padding: 32px 20px; }
+    .cert-sprint { font-size: 16pt; }
+    .cert-hash { font-size: 11pt; padding: 12px; }
+    .cert-details { grid-template-columns: 1fr; gap: 8px; }
+    .cert-detail-value { font-size: 12pt; }
+    .certificate::before, .certificate::after { display: none; }
+  }
+  @media print {
+    body { background: #fff; }
+    .certificate { background: #fff; border-color: #ccc; }
+    .cert-sprint { color: #111; }
+    .cert-hash { background: #f5f5f5; color: #333; border-color: #ddd; }
+    .cert-detail { background: #f9f9f9; }
+    .cert-detail-value { color: #111; }
+    .cert-label { color: #555; }
+    .tier-name, .tier-count { color: #555; }
+    .tier-track { background: #eee; }
+    .cert-statement { color: #666; }
+    .certificate::before { border-color: #ddd; }
+    .certificate::after { border-color: #eee; }
+  }
+</style>
+</head>
+<body>
+<article class="certificate" role="document" aria-label="Compilation certificate">
+  <div class="cert-header">
+    <div class="cert-label">Compilation Certificate</div>
+    <div class="cert-sprint">{{SPRINT_NAME}}</div>
+  </div>
+  <div class="cert-divider"></div>
+  <div class="cert-hash" aria-label="Compilation hash">{{HASH}}</div>
+  <div class="cert-details" aria-label="Compilation details">
+    <div class="cert-detail">
+      <div class="cert-detail-label">Claims</div>
+      <div class="cert-detail-value">{{CLAIM_COUNT}}</div>
+    </div>
+    <div class="cert-detail">
+      <div class="cert-detail-label">Compiled</div>
+      <div class="cert-detail-value">{{COMPILED_AT}}</div>
+    </div>
+    <div class="cert-detail">
+      <div class="cert-detail-label">Compiler</div>
+      <div class="cert-detail-value">{{COMPILER_VERSION}}</div>
+    </div>
+  </div>
+  <div class="cert-evidence" aria-label="Evidence tier breakdown">
+    <h3>Evidence Breakdown</h3>
+    {{EVIDENCE_BREAKDOWN}}
+  </div>
+  <div class="cert-conflict {{CONFLICT_STATUS}}" aria-label="Conflict status">
+    {{CONFLICT_STATUS}}
+  </div>
+  <p class="cert-statement">
+    This compilation is reproducible. The hash above uniquely identifies the claim
+    set and compiler version used. Re-running the compiler with identical inputs
+    will produce the same hash.
+  </p>
+  <div class="cert-footer">Built with barn</div>
+</article>
+</body>
+</html>

package/templates/certificate.json ADDED Viewed

@@ -0,0 +1,23 @@
+{
+  "title": "Certificate",
+  "description": "Compilation certificate rendered as a formal visual artifact. Shows hash, claim count, evidence breakdown, and conflict status with a centered, framed layout.",
+  "tags": ["certificate", "compilation", "verification", "reproducible", "hash"],
+  "author": "grainulation",
+  "version": "1.0.0",
+  "exportPresets": [
+    { "name": "pdf", "format": "pdf" },
+    { "name": "static-site", "format": "html" }
+  ],
+  "seedPacks": [],
+  "scaffoldConfig": {
+    "defaultPlaceholders": {
+      "SPRINT_NAME": "Sprint",
+      "HASH": "",
+      "CLAIM_COUNT": "0",
+      "COMPILED_AT": "",
+      "COMPILER_VERSION": "1.0.0",
+      "CONFLICT_STATUS": "resolved"
+    },
+    "postInit": ["load-claims"]
+  }
+}

package/templates/changelog.html ADDED Viewed

@@ -0,0 +1,239 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>{{TITLE}} -- {{SPRINT_NAME}}</title>
+<style>
+  :root {
+    --bg: #0a0e1a;
+    --bg2: #111827;
+    --bg3: #1e293b;
+    --accent: #3b82f6;
+    --accent-light: #60a5fa;
+    --green: #22c55e;
+    --green-dim: rgba(34,197,94,0.15);
+    --orange: #f59e0b;
+    --orange-dim: rgba(245,158,11,0.15);
+    --red: #e11d48;
+    --red-dim: rgba(225,29,72,0.15);
+    --purple: #a78bfa;
+    --text: #f1f5f9;
+    --text-muted: #94a3b8;
+    --text-dim: #64748b;
+    --border: rgba(255,255,255,0.06);
+  }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  html { scroll-snap-type: y mandatory; scroll-behavior: smooth; }
+  body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Inter', sans-serif;
+    background: var(--bg);
+    color: var(--text);
+    font-size: 10pt;
+    line-height: 1.5;
+    -webkit-font-smoothing: antialiased;
+  }
+  section {
+    scroll-snap-align: start;
+    min-height: 100vh;
+    padding: 40px;
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+  }
+  .header-section { justify-content: flex-end; padding-bottom: 80px; }
+  .header-section h1 {
+    font-size: 28pt;
+    font-weight: 800;
+    letter-spacing: -0.02em;
+    background: linear-gradient(135deg, #fff 0%, #94a3b8 100%);
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+    margin-bottom: 12px;
+  }
+  .meta-row {
+    display: flex;
+    gap: 24px;
+    color: var(--text-muted);
+    font-size: 10pt;
+    font-family: monospace;
+  }
+  .stats-bar {
+    display: flex;
+    gap: 16px;
+    margin-top: 24px;
+  }
+  .stat-card {
+    background: var(--bg2);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    padding: 16px 24px;
+    text-align: center;
+  }
+  .stat-card .value {
+    font-size: 20pt;
+    font-weight: 800;
+    color: var(--accent-light);
+  }
+  .stat-card .label {
+    font-size: 8pt;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+    color: var(--text-dim);
+    margin-top: 4px;
+  }
+  .panel {
+    background: var(--bg2);
+    border-radius: 12px;
+    padding: 24px;
+    border: 1px solid var(--border);
+    margin-bottom: 16px;
+  }
+  .panel-title {
+    font-size: 9pt;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+    color: var(--text-dim);
+    margin-bottom: 16px;
+  }
+  .timeline-entry {
+    display: flex;
+    gap: 16px;
+    padding: 12px 0;
+    border-bottom: 1px solid var(--border);
+  }
+  .timeline-entry:last-child { border-bottom: none; }
+  .timeline-ts {
+    font-family: monospace;
+    font-size: 9pt;
+    color: var(--text-dim);
+    width: 120px;
+    flex-shrink: 0;
+  }
+  .timeline-body { flex: 1; color: var(--text-muted); font-size: 10pt; }
+  .badge {
+    display: inline-block;
+    padding: 2px 8px;
+    border-radius: 4px;
+    font-size: 8pt;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+  }
+  .badge.new { color: var(--green); background: var(--green-dim); }
+  .badge.resolved { color: var(--accent-light); background: rgba(59,130,246,0.12); }
+  .badge.upgraded { color: var(--purple); background: rgba(167,139,250,0.12); }
+  .badge.constraint { color: var(--purple); background: rgba(167,139,250,0.12); }
+  .badge.factual { color: var(--accent-light); background: rgba(59,130,246,0.12); }
+  .badge.risk { color: var(--red); background: var(--red-dim); }
+  .badge.estimate { color: var(--orange); background: var(--orange-dim); }
+  .badge.recommendation { color: var(--green); background: var(--green-dim); }
+  .claim-row {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    padding: 10px 0;
+    border-bottom: 1px solid var(--border);
+    font-size: 9pt;
+  }
+  .claim-row:last-child { border-bottom: none; }
+  .claim-id { font-family: monospace; color: var(--text-dim); width: 60px; flex-shrink: 0; }
+  .claim-text { flex: 1; color: var(--text-muted); }
+  .upgrade-arrow {
+    font-family: monospace;
+    color: var(--text-dim);
+    padding: 0 8px;
+  }
+  .compilation-bar {
+    margin-top: 32px;
+    padding: 16px 24px;
+    background: var(--bg2);
+    border-radius: 8px;
+    border: 1px solid var(--border);
+    display: flex;
+    justify-content: space-between;
+    font-size: 9pt;
+    color: var(--text-dim);
+  }
+  @media (max-width: 768px) {
+    section { padding: 20px; min-height: auto; }
+    .header-section h1 { font-size: 18pt; }
+    .meta-row { flex-wrap: wrap; gap: 8px; font-size: 9pt; }
+    .stats-bar { flex-wrap: wrap; }
+    .stat-card { flex: 1 1 calc(50% - 8px); padding: 12px 16px; }
+    .stat-card .value { font-size: 16pt; }
+    .timeline-entry { flex-direction: column; gap: 4px; }
+    .timeline-ts { width: auto; }
+  }
+  @media print {
+    html { scroll-snap-type: none; }
+    section { min-height: auto; page-break-inside: avoid; padding: 16px 0; }
+    body { background: #fff; color: #111; }
+    .panel { border-color: #ccc; background: #f9f9f9; }
+    .badge { border: 1px solid #ccc; }
+    .compilation-bar { background: #f9f9f9; border-color: #ccc; }
+  }
+</style>
+</head>
+<body>
+<section class="header-section" aria-label="Changelog header">
+  <h1>{{TITLE}}</h1>
+  <div class="meta-row">
+    <span>Sprint: {{SPRINT_NAME}}</span>
+    <span>Compiled: {{COMPILED_AT}}</span>
+  </div>
+  <div class="stats-bar">
+    <div class="stat-card">
+      <div class="value">{{TOTAL_CHANGES}}</div>
+      <div class="label">Total Changes</div>
+    </div>
+    <div class="stat-card">
+      <div class="value">{{NEW_COUNT}}</div>
+      <div class="label">New Claims</div>
+    </div>
+    <div class="stat-card">
+      <div class="value">{{RESOLVED_COUNT}}</div>
+      <div class="label">Resolved</div>
+    </div>
+  </div>
+</section>
+<section aria-label="Timeline">
+  <div class="panel">
+    <div class="panel-title">Timeline</div>
+    {{TIMELINE_ENTRIES}}
+  </div>
+</section>
+<section aria-label="New claims">
+  <div class="panel">
+    <div class="panel-title">New Claims</div>
+    {{NEW_CLAIMS}}
+  </div>
+</section>
+<section aria-label="Resolved conflicts">
+  <div class="panel">
+    <div class="panel-title">Resolved Conflicts</div>
+    {{RESOLVED_CONFLICTS}}
+  </div>
+</section>
+<section aria-label="Evidence upgrades">
+  <div class="panel">
+    <div class="panel-title">Evidence Upgrades</div>
+    {{EVIDENCE_UPGRADES}}
+  </div>
+</section>
+<section aria-label="Compilation footer">
+  <div class="compilation-bar">
+    <div>Compiled with barn</div>
+    <div style="font-family: monospace; font-size: 8pt;">{{CERTIFICATE_HASH}}</div>
+  </div>
+</section>
+</body>
+</html>

package/templates/changelog.json ADDED Viewed

@@ -0,0 +1,19 @@
+{
+  "title": "Changelog",
+  "description": "Sprint changelog showing what changed since last compile. Timeline view with new claims, resolved conflicts, and evidence upgrades.",
+  "tags": ["changelog", "history", "timeline", "diff"],
+  "author": "grainulation",
+  "version": "1.0.0",
+  "exportPresets": [
+    { "name": "pdf", "format": "pdf" },
+    { "name": "markdown-outline", "format": "md" }
+  ],
+  "seedPacks": [],
+  "scaffoldConfig": {
+    "defaultPlaceholders": {
+      "TITLE": "Sprint Changelog",
+      "SPRINT_NAME": "Untitled Sprint"
+    },
+    "postInit": ["load-claims", "diff-previous-compile"]
+  }
+}

package/templates/ci-workflow.yml ADDED Viewed

@@ -0,0 +1,52 @@
+# Grainulation CI Workflow Template
+#
+# Reusable GitHub Actions workflow for all 8 grainulation repos.
+# Copy this file to .github/workflows/ci.yml in each repo.
+#
+# What it does:
+#   1. Runs npm test across Node 18, 20, 22
+#   2. Verifies zero npm dependencies (core ecosystem constraint d001)
+#   3. Dry-run npm pack to catch packaging issues before publish
+#
+# Addresses blind spots r042/r059: no GitHub Actions workflow for any of the 8 repos.
+name: CI
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm test
+  zero-dep-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Verify zero dependencies
+        run: |
+          node -e "
+            const pkg = require('./package.json');
+            if (pkg.dependencies && Object.keys(pkg.dependencies).length > 0) {
+              console.error('Found dependencies:', pkg.dependencies);
+              process.exit(1);
+            }
+            console.log('Zero dependencies verified');
+          "
+  publish-dry-run:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm pack --dry-run