ultimate-jekyll-manager 1.7.2 → 1.8.0

package/dist/defaults/dist/_layouts/themes/newsflash/frontend/pages/team/index.html

@@ -0,0 +1,207 @@
+---
+### ALL PAGES ###
+layout: themes/[ site.theme.id ]/frontend/core/base
+
+### PAGE CONFIG ###
+# Newsroom principles — news voice: a theme's frontmatter defaults are part
+# of its identity (see docs/themes.md). The company_values key is universal.
+company_values:
+  - title: "Accuracy first"
+    description: "Get it right before getting it first. Every fact is checked, every correction is published."
+    icon: "shield-check"
+  - title: "Independent always"
+    description: "No advertiser, owner, or party gets a say in what we publish. Readers fund the reporting."
+    icon: "scale-balanced"
+  - title: "Show our work"
+    description: "We cite sources, link documents, and explain how we know what we know."
+    icon: "magnifying-glass"
+  - title: "Readers before clicks"
+    description: "We write to inform, not to bait. If a headline overpromises, we've failed."
+    icon: "heart"
+---
+
+{% comment %}
+  NEWSFLASH TEAM — the masthead page
+  Same data contract as classy's team index (site.team loop, member.position/
+  description/links, company_values, CEO-resolution Liquid for the mission
+  attribution), presented as the newsroom: byline cards, an ink-slab charter,
+  and principle cards.
+{% endcomment %}
+
+<!-- ============================================ -->
+<!-- HERO -->
+<!-- ============================================ -->
+<section class="pb-4">
+  <div class="container text-center" data-lazy="@class animation-slide-up">
+    <span class="kicker mb-3">{% uj_icon "pen-nib", "me-1" %}The masthead</span>
+    <h1 class="display-4 my-3">
+      The people behind <span class="text-accent">the bylines</span>
+    </h1>
+    <p class="lead mb-0">
+      Reporters, editors, and producers — the newsroom that puts {{ site.brand.name }} out every day.
+    </p>
+  </div>
+</section>
+
+<!-- ============================================ -->
+<!-- THE NEWSROOM — byline cards -->
+<!-- ============================================ -->
+<section class="pt-0">
+  <div class="container">
+    <div class="section-head" data-lazy="@class animation-slide-up">
+      <h2>The newsroom</h2>
+      <span class="rule"></span>
+    </div>
+
+    <div class="row g-4 justify-content-center">
+      {% for member in site.team %}
+        <div class="col-lg-4 col-md-6" data-lazy="@class animation-slide-up">
+          <div class="card h-100 p-4 text-center d-flex flex-column">
+            <a href="{{ site.url }}{{ member.url }}" class="text-decoration-none d-inline-block mx-auto mb-3">
+              <div class="avatar avatar-2xl">
+                {%- uj_member member.id, "image-tag", class="rounded-circle object-fit-cover d-block team-member-image" -%}
+              </div>
+            </a>
+
+            <h3 class="h4 mb-1">
+              <a href="{{ site.url }}{{ member.url }}" class="text-decoration-none text-body">
+                {%- uj_member member.id, "name" -%}
+              </a>
+            </h3>
+            <span class="kicker justify-content-center mb-3">{{ member.member.position }}</span>
+            <p class="text-body-secondary small mb-0 flex-grow-1">{{ member.member.description }}</p>
+
+            {% iftruthy member.member.links %}
+              <div class="d-flex justify-content-center gap-2 mt-3">
+                {% for link in member.member.links %}
+                  {% assign link_icon = link.id %}
+                  {% if link.id == "website" %}{% assign link_icon = "globe" %}{% endif %}
+                  <a href="{{ link.url }}" class="btn btn-outline-dark btn-sm avatar avatar-md rounded-circle d-flex align-items-center justify-content-center" target="_blank" rel="nofollow noopener" title="{{ link.title }}">
+                    {% uj_icon link_icon, "" %}
+                  </a>
+                {% endfor %}
+              </div>
+            {% endiftruthy %}
+
+            <div class="mt-3">
+              <a href="{{ site.url }}{{ member.url }}" class="btn btn-outline-dark btn-sm">
+                Read their work
+              </a>
+            </div>
+          </div>
+        </div>
+      {% endfor %}
+    </div>
+  </div>
+</section>
+
+<!-- ============================================ -->
+<!-- THE CHARTER — ink slab -->
+<!-- ============================================ -->
+<section class="pt-0">
+  <div class="container">
+    <div class="cta-panel" data-lazy="@class animation-slide-up">
+      <div class="cta-rings" aria-hidden="true"></div>
+      <div class="position-relative">
+        <span class="kicker mb-3">{% uj_icon "quote-left", "me-1" %}The charter</span>
+        <h2 class="cta-title">Report it right. <span class="text-accent">Write it sharp.</span></h2>
+        <p class="cta-desc mb-4">
+          "Our job is simple to say and hard to do: find out what's true, explain why it matters, and answer to no one but the reader."
+        </p>
+        {% assign mission_member = nil %}
+        {% for member in site.team %}
+          {% assign position_lower = member.member.position | downcase %}
+          {% if position_lower == "ceo" or position_lower == "chief executive officer" %}
+            {% assign mission_member = member %}
+            {% break %}
+          {% endif %}
+        {% endfor %}
+        {% unless mission_member %}
+          {% for member in site.team %}
+            {% assign position_lower = member.member.position | downcase %}
+            {% if position_lower == "owner" %}
+              {% assign mission_member = member %}
+              {% break %}
+            {% endif %}
+          {% endfor %}
+        {% endunless %}
+        {% unless mission_member %}
+          {% for member in site.team %}
+            {% assign position_lower = member.member.position | downcase %}
+            {% if position_lower == "president" %}
+              {% assign mission_member = member %}
+              {% break %}
+            {% endif %}
+          {% endfor %}
+        {% endunless %}
+        {% unless mission_member %}
+          {% assign mission_member = site.team | first %}
+        {% endunless %}
+        {% if mission_member %}
+          <div class="d-flex align-items-center gap-3">
+            <div class="avatar avatar-lg">
+              {%- uj_member mission_member.id, "image-tag", class="rounded-circle object-fit-cover d-block" -%}
+            </div>
+            <div>
+              <div class="fw-bold">{%- uj_member mission_member.id, "name" -%}</div>
+              <div class="opacity-75">{{ mission_member.member.position }}</div>
+            </div>
+          </div>
+        {% endif %}
+      </div>
+    </div>
+  </div>
+</section>
+
+<!-- ============================================ -->
+<!-- PRINCIPLES -->
+<!-- ============================================ -->
+<section class="pt-0">
+  <div class="container">
+    <div class="section-head" data-lazy="@class animation-slide-up">
+      <h2>How we work</h2>
+      <span class="rule"></span>
+    </div>
+
+    <div class="row g-4">
+      {% for value in page.resolved.company_values %}
+        <div class="col-lg-3 col-md-6" data-lazy="@class animation-slide-up">
+          <div class="card h-100 p-4">
+            <span class="feature-icon d-inline-flex align-items-center justify-content-center rounded-circle text-bg-primary mb-3">
+              {% uj_icon value.icon %}
+            </span>
+            <h3 class="h4 mb-2">{{ value.title }}</h3>
+            <p class="text-body-secondary mb-0">{{ value.description }}</p>
+          </div>
+        </div>
+      {% endfor %}
+    </div>
+  </div>
+</section>
+
+<!-- ============================================ -->
+<!-- JOIN CTA -->
+<!-- ============================================ -->
+<section class="pt-0">
+  <div class="container text-center" data-lazy="@class animation-slide-up">
+    <div class="row justify-content-center">
+      <div class="col-lg-8">
+        <span class="kicker justify-content-center mb-3">{% uj_icon "briefcase", "me-1" %}Join us</span>
+        <h2 class="h1 mb-3">Want your name on <span class="text-accent">the masthead?</span></h2>
+        <p class="lead mb-4">
+          We're always looking for sharp reporters, ruthless editors, and people who sweat the details.
+        </p>
+        <div class="d-flex flex-column flex-sm-row gap-3 justify-content-center">
+          <a href="/careers" class="btn btn-primary btn-lg">
+            {% uj_icon "rocket", "me-2" %}Apply now
+          </a>
+          <a href="/contact" class="btn btn-outline-dark btn-lg">
+            {% uj_icon "envelope", "me-2" %}Get in touch
+          </a>
+        </div>
+      </div>
+    </div>
+  </div>
+</section>
+
+{{ content | uj_content_format }}

package/dist/defaults/dist/_layouts/themes/newsflash/frontend/pages/team/member.html

@@ -0,0 +1,134 @@
+---
+### ALL PAGES ###
+layout: themes/[ site.theme.id ]/frontend/core/base
+
+### PAGE CONFIG ###
+---
+
+{% comment %}
+  NEWSFLASH TEAM MEMBER — the byline page
+  Same data contract as classy's member page (page.member.id/position/links/
+  description/location/joined/skills/hobbies + page content as the bio),
+  presented as a reporter profile: byline head, beat facts, and the bio.
+{% endcomment %}
+
+<!-- ============================================ -->
+<!-- BYLINE HEAD -->
+<!-- ============================================ -->
+<section class="pb-4">
+  <div class="container text-center" data-lazy="@class animation-slide-up">
+    <div class="avatar avatar-5xl mb-4 mx-auto">
+      {%- uj_member page.member.id, "image-tag", class="rounded-circle object-fit-cover team-member-image" -%}
+    </div>
+
+    <span class="kicker d-flex justify-content-center mb-2">{{ page.member.position }}</span>
+    <h1 class="display-4 my-2">
+      {%- uj_member page.member.id, "name" -%}
+    </h1>
+
+    {% iftruthy page.member.description %}
+      <p class="lead mb-4">{{ page.member.description }}</p>
+    {% endiftruthy %}
+
+    {% iftruthy page.member.links %}
+      <div class="d-flex justify-content-center gap-2">
+        {% for link in page.member.links %}
+          {% assign link_icon = link.id %}
+          {% if link.id == "website" %}{% assign link_icon = "globe" %}{% endif %}
+          <a href="{{ link.url }}" class="btn btn-outline-dark avatar avatar-lg rounded-circle d-flex align-items-center justify-content-center" target="_blank" rel="nofollow noopener" title="{{ link.title }}">
+            {% uj_icon link_icon, "" %}
+          </a>
+        {% endfor %}
+      </div>
+    {% endiftruthy %}
+  </div>
+</section>
+
+<!-- ============================================ -->
+<!-- THE FACTS — beat card strip -->
+<!-- ============================================ -->
+<section class="pt-0">
+  <div class="container">
+    <div class="row g-4 justify-content-center">
+      {% iftruthy page.member.location %}
+        <div class="col-lg-3 col-md-6" data-lazy="@class animation-slide-up">
+          <div class="card h-100 p-4 text-center">
+            <span class="feature-icon d-inline-flex align-items-center justify-content-center rounded-circle text-bg-primary mb-3 mx-auto">
+              {% uj_icon "map-marker-alt" %}
+            </span>
+            <span class="kicker justify-content-center mb-2">Based in</span>
+            <p class="fw-bold mb-0">{{ page.member.location }}</p>
+          </div>
+        </div>
+      {% endiftruthy %}
+
+      {% iftruthy page.member.joined %}
+        <div class="col-lg-3 col-md-6" data-lazy="@class animation-slide-up">
+          <div class="card h-100 p-4 text-center">
+            <span class="feature-icon d-inline-flex align-items-center justify-content-center rounded-circle text-bg-primary mb-3 mx-auto">
+              {% uj_icon "calendar" %}
+            </span>
+            <span class="kicker justify-content-center mb-2">On the masthead since</span>
+            <p class="fw-bold mb-0">{{ page.member.joined | date: "%B %Y" }}</p>
+          </div>
+        </div>
+      {% endiftruthy %}
+
+      {% iftruthy page.member.skills %}
+        <div class="col-lg-3 col-md-6" data-lazy="@class animation-slide-up">
+          <div class="card h-100 p-4 text-center">
+            <span class="feature-icon d-inline-flex align-items-center justify-content-center rounded-circle text-bg-primary mb-3 mx-auto">
+              {% uj_icon "briefcase" %}
+            </span>
+            <span class="kicker justify-content-center mb-2">The beat</span>
+            <p class="fw-bold mb-0">{{ page.member.skills | join: ", " }}</p>
+          </div>
+        </div>
+      {% endiftruthy %}
+
+      {% iftruthy page.member.hobbies %}
+        <div class="col-lg-3 col-md-6" data-lazy="@class animation-slide-up">
+          <div class="card h-100 p-4 text-center">
+            <span class="feature-icon d-inline-flex align-items-center justify-content-center rounded-circle text-bg-primary mb-3 mx-auto">
+              {% uj_icon "heart" %}
+            </span>
+            <span class="kicker justify-content-center mb-2">Off the clock</span>
+            <p class="fw-bold mb-0">{{ page.member.hobbies | join: ", " }}</p>
+          </div>
+        </div>
+      {% endiftruthy %}
+    </div>
+  </div>
+</section>
+
+<!-- ============================================ -->
+<!-- BIO -->
+<!-- ============================================ -->
+<section class="pt-0">
+  <div class="container">
+    <div class="row justify-content-center">
+      <div class="col-lg-9">
+        {%- capture member_name -%}{%- uj_member page.member.id, "name" -%}{%- endcapture -%}
+        {%- assign first_name = member_name | split: ' ' | first -%}
+        <div class="section-head" data-lazy="@class animation-slide-up">
+          <h2>About {{ first_name }}</h2>
+          <span class="rule"></span>
+        </div>
+        <div class="fs-5" data-lazy="@class animation-slide-up">
+          {{ content | uj_content_format }}
+        </div>
+      </div>
+    </div>
+  </div>
+</section>
+
+<!-- ============================================ -->
+<!-- BACK TO THE NEWSROOM -->
+<!-- ============================================ -->
+<section class="pt-0">
+  <div class="container text-center" data-lazy="@class animation-slide-up">
+    <a href="/team" class="btn btn-outline-dark btn-lg">
+      {% uj_icon "arrow-left", "me-2" %}Back to the newsroom
+    </a>
+  </div>
+</section>

package/dist/defaults/test/README.md

@@ -12,6 +12,10 @@ Match the framework's three layers — Ultimate Jekyll Manager's test runner dis
 | `test/page/` | Browser page served from a local HTTP server | DOM, frontend Manager, page-specific scripts, `data-wm-bind` directives |
 | `test/boot/` | Consumer's actual built `_site/` | End-to-end smoke tests (does the site boot, does the service worker register, do dynamic pages load) |
 
+## Coverage
+
+Every feature ships with tests at every layer it has a surface in — logic (`build`/`page`), UI (`page`), end-to-end (`boot`). Skip a layer only when the feature genuinely has no surface there; "the logic test covers it" does not excuse the UI test.
+
 ## Quick example
 
 ```js

package/dist/gulp/tasks/jekyll.js

@@ -115,8 +115,10 @@ async function jekyll(complete) {
       ].filter(Boolean).join(','),
       '--incremental',
       (Manager.isBuildMode() || argv.profile) ? ' --profile' : '',
-      // Limit posts in development for faster builds (use --all-posts to disable)
-      (!Manager.isBuildMode() && !argv['all-posts']) ? '--limit_posts 15' : '',
+      // Limit posts in development for faster builds (use --all-posts to disable).
+      // 18 keeps a fully-populated newsflash front page visible in dev (its
+      // deduplicated slots consume 17 distinct posts).
+      (!Manager.isBuildMode() && !argv['all-posts']) ? '--limit_posts 18' : '',
       // '--disable-disk-cache',
     ]
 

package/dist/test/runner.js

@@ -40,12 +40,13 @@ class SkipError extends Error {
 
 async function run(options = {}) {
   options.layer    = options.layer    || 'all';
+  options.target   = options.target   || null;
   options.filter   = options.filter   || null;
   options.reporter = options.reporter || 'pretty';
 
   const startTime = Date.now();
 
-  const sources = discoverTestFiles();
+  const sources = discoverTestFiles(options.target);
 
   console.log('');
   console.log(chalk.bold('  Ultimate Jekyll Manager Tests'));
@@ -356,7 +357,50 @@ function reportResults(results, durationMs) {
   console.log(chalk.gray(`\n    Total: ${total} tests in ${durationMs}ms\n`));
 }
 
-function discoverTestFiles() {
+// Parse a positional test target into a source filter + path part.
+// Source prefixes (standardized across all OMEGA frameworks):
+//   'mgr:' / 'ujm:' / 'framework:' → framework tests  ('mgr:' is the universal alias)
+//   'project:'                     → project tests
+//   no prefix                      → both sources, matched by path
+function parseTarget(target) {
+  if (!target) {
+    return { source: null, pathPart: null };
+  }
+
+  const m = String(target).match(/^(project|mgr|ujm|framework):(.*)$/);
+  if (m) {
+    const source = m[1] === 'project' ? 'project' : 'framework';
+    return { source, pathPart: m[2] || null };
+  }
+
+  return { source: null, pathPart: target };
+}
+
+// Narrow a source's file list by the parsed target. A source-prefixed target
+// excludes the other source entirely; the path part (if any) matches by
+// relative path prefix.
+function filterBySource(source, files, sourceFilter, pathPart) {
+  if (sourceFilter && sourceFilter !== source) {
+    return [];
+  }
+  if (!pathPart) {
+    return files;
+  }
+
+  return files.filter((file) => {
+    const rel = relativizePath(file, source);
+    const relNoExt = rel.replace(/\.js$/, '').replace(/\.test$/, '');
+    const partNoExt = pathPart.replace(/\.js$/, '').replace(/\.test$/, '');
+    return rel.startsWith(pathPart)
+      || relNoExt === partNoExt
+      || relNoExt.startsWith(partNoExt + '/')
+      || rel.includes(pathPart);
+  });
+}
+
+function discoverTestFiles(target) {
+  const { source: sourceFilter, pathPart } = parseTarget(target);
+
   const framework = [];
   const project = [];
 
@@ -393,7 +437,10 @@ function discoverTestFiles() {
     });
   }
 
-  return { framework, project };
+  return {
+    framework: filterBySource('framework', framework, sourceFilter, pathPart),
+    project:   filterBySource('project',   project,   sourceFilter, pathPart),
+  };
 }
 
 function relativizePath(file, source) {

package/dist/test/suites/build/attach-log-file.test.js

@@ -0,0 +1,102 @@
+// Build-layer tests for src/utils/attach-log-file.js (shipped to dist/utils/attach-log-file.js)
+// — tee process.stdout/stderr to logs/<name>.log with ANSI stripping. Each test attaches,
+// writes, detaches, then inspects the file.
+//
+// CRITICAL: these tests run INSIDE a live `npx mgr test` process whose own output is being
+// teed to logs/test.log by the singleton. So they must NOT touch the singleton — exercising
+// attach()/detach() on it would detach the live tee mid-run and truncate logs/test.log. Each
+// test uses its OWN `createTee()` instance, which stacks under the live singleton tee and
+// restores it cleanly on detach.
+//
+// UJM's tee is NAME-based (attach('<name>') → <cwd>/logs/<name>.log) and SYNCHRONOUS (detach
+// closes the fd immediately; writes are fs.writeSync so the tail is already on disk). The
+// throwaway log files are cleaned up in each test's finally block.
+
+const path = require('path');
+const fs   = require('fs');
+
+// Resolve the SAME path the tee writes to: <cwd>/logs/<name>.log.
+function logPath(name) {
+  return path.resolve(process.cwd(), 'logs', `${name}.log`);
+}
+
+module.exports = {
+  type: 'suite',
+  layer: 'build',
+  description: 'attach-log-file — tee stdout/stderr to a file',
+  tests: [
+    {
+      name: 'exports the expected surface',
+      run: (ctx) => {
+        const mod = require(path.join(__dirname, '..', '..', '..', 'utils', 'attach-log-file.js'));
+        ctx.expect(typeof mod).toBe('function');
+        ctx.expect(typeof mod.detach).toBe('function');
+        ctx.expect(typeof mod.stripAnsi).toBe('function');
+        ctx.expect(typeof mod.createTee).toBe('function');
+      },
+    },
+    {
+      name: 'stripAnsi removes color escape codes',
+      run: (ctx) => {
+        const { stripAnsi } = require(path.join(__dirname, '..', '..', '..', 'utils', 'attach-log-file.js'));
+        const colored = '\x1B[31mred\x1B[0m and \x1B[32mgreen\x1B[0m';
+        ctx.expect(stripAnsi(colored)).toBe('red and green');
+      },
+    },
+    {
+      name: 'attach + stdout.write + detach: file contains the writes',
+      run: (ctx) => {
+        const attach = require(path.join(__dirname, '..', '..', '..', 'utils', 'attach-log-file.js'));
+        // Isolated instance — stacks under the live test.log tee, never clobbers it.
+        const tee  = attach.createTee();
+        const name = `ujm-log-${Date.now()}`;
+        const file = logPath(name);
+        try {
+          const fd = tee.attach(name);
+          // attach() returns null when skipped (isServer()) — guard so the test is meaningful.
+          if (fd === null) return ctx.skip('attach skipped (isServer)');
+
+          process.stdout.write('hello world\n');
+          process.stdout.write('\x1B[31mcolored\x1B[0m line\n');
+          // Synchronous writes — already flushed to disk. detach() just closes the fd.
+          tee.detach();
+
+          const contents = fs.readFileSync(file, 'utf8');
+          ctx.expect(contents).toContain('hello world');
+          ctx.expect(contents).toContain('colored line');
+          ctx.expect(contents).not.toContain('\x1B[');
+        } finally {
+          tee.detach();
+          try { fs.unlinkSync(file); } catch (e) {}
+        }
+      },
+    },
+    {
+      name: 'idempotent: attaching twice with same name returns same fd',
+      run: (ctx) => {
+        const attach = require(path.join(__dirname, '..', '..', '..', 'utils', 'attach-log-file.js'));
+        const tee  = attach.createTee();
+        const name = `ujm-log-idem-${Date.now()}`;
+        const file = logPath(name);
+        try {
+          const fd1 = tee.attach(name);
+          if (fd1 === null) return ctx.skip('attach skipped (isServer)');
+          const fd2 = tee.attach(name);
+          ctx.expect(fd1).toBe(fd2);
+        } finally {
+          tee.detach();
+          try { fs.unlinkSync(file); } catch (e) {}
+        }
+      },
+    },
+    {
+      name: 'attach with falsy name returns null and does nothing',
+      run: (ctx) => {
+        const attach = require(path.join(__dirname, '..', '..', '..', 'utils', 'attach-log-file.js'));
+        const tee = attach.createTee();
+        ctx.expect(tee.attach(null)).toBe(null);
+        ctx.expect(tee.attach('')).toBe(null);
+      },
+    },
+  ],
+};