@ibalzam/codejitsu-core 0.3.2 → 0.4.0

package/bin/codejitsu.mjs

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { runBlog } from '../modules/cli/src/blog.mjs';
+
+const subcommand = process.argv[2];
+
+const COMMANDS = {
+  'blog:list': () => runBlog('blog:list'),
+  'blog:drafts': () => runBlog('blog:drafts'),
+  // Aliases for the existing standalone bins
+  llms: () => import('../modules/llms/bin/generate.mjs'),
+  'optimize-images': () => import('../modules/images/bin/optimize.mjs'),
+  check: () => import('../checklist/bin/run.mjs'),
+};
+
+if (!subcommand || subcommand === '--help' || subcommand === '-h') {
+  printHelp();
+  process.exit(0);
+}
+
+const handler = COMMANDS[subcommand];
+if (!handler) {
+  console.error(`Unknown subcommand: ${subcommand}\n`);
+  printHelp();
+  process.exit(1);
+}
+
+try {
+  await handler();
+} catch (err) {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+}
+
+function printHelp() {
+  console.log(`\nUsage: codejitsu <subcommand>\n`);
+  console.log(`Subcommands:`);
+  console.log(`  blog:list           List every non-draft post with publish status + URL + image check`);
+  console.log(`  blog:drafts         List future-dated (pending) posts only`);
+  console.log(``);
+  console.log(`  llms                Generate public/llms.txt and public/llms-full.txt`);
+  console.log(`  optimize-images     Optimize images per codejitsu.config`);
+  console.log(`  check               Run sitewide checklist`);
+  console.log(``);
+  console.log(`All commands read codejitsu.config.{ts,mjs,json} from the current directory.`);
+}

package/modules/blog/src/collection.d.ts

@@ -4,28 +4,14 @@ export interface CollectionBlogConfig extends CommonBlogConfig {
     collectionName?: string;
 }
 /**
- * Astro Content Collections blog loader. Use this in Astro projects.
+ * Astro Content Collections blog loader. Use in any Astro project.
  *
- * Returns raw CollectionEntry objects (preserving `entry.data`, `entry.id`,
- * and the ability to call `render(entry)` from astro:content). Filtering and
- * sorting are applied:
- *   - Drafts excluded (when `draftField` is set)
- *   - Sorted newest first by `dateField`
- *   - `getPublishedEntries()` further excludes future-dated entries
+ * Returns raw CollectionEntry objects with filtering applied (drafts excluded,
+ * sorted newest first by `dateField`). Preserves `entry.data`, `entry.id`,
+ * and the ability to call `render(entry)` for `<Content />`.
  *
- * The collection's actual entry type is `CollectionEntry<'<name>'>` from
- * `astro:content`. Pass it as the generic to get full typed `data`:
- *
- * ```ts
- * import type { CollectionEntry } from 'astro:content';
- * export const blog = createBlogFromCollection<CollectionEntry<'blog'>>({
- *   collectionName: 'blog',
- *   dateField: 'pubDate',
- *   draftField: 'draft',
- * });
- * ```
- *
- * Dynamically imports `astro:content` at call time so the package stays
- * usable in non-Astro projects.
+ * Import only from inside Astro code (`src/lib/blog.ts`, page routes). Do not
+ * import from `astro.config.mjs` — Astro CC isn't initialized at config time.
+ * Use `createBlog` (fs) for astro.config.
  */
 export declare function createBlogFromCollection<E extends BlogCollectionEntry = BlogCollectionEntry>(config?: CollectionBlogConfig): BlogCollectionAPI<E>;

package/modules/blog/src/collection.js

@@ -1,3 +1,9 @@
+// @ts-expect-error - 'astro:content' is a virtual module resolved by Astro at build time.
+// Static import (not dynamic) so Vite/Astro processes the dependency correctly.
+// This file is only safe to import from inside an Astro project. It lives at the
+// `/blog/collection` subpath; sites that aren't Astro should import from `/blog`
+// (which doesn't pull this in).
+import { getCollection as astroGetCollection } from 'astro:content';
 import readingTime from 'reading-time';
 function getTodayUTC() {
     const now = new Date();
@@ -20,29 +26,15 @@ function asDate(value) {
     return null;
 }
 /**
- * Astro Content Collections blog loader. Use this in Astro projects.
+ * Astro Content Collections blog loader. Use in any Astro project.
  *
- * Returns raw CollectionEntry objects (preserving `entry.data`, `entry.id`,
- * and the ability to call `render(entry)` from astro:content). Filtering and
- * sorting are applied:
- *   - Drafts excluded (when `draftField` is set)
- *   - Sorted newest first by `dateField`
- *   - `getPublishedEntries()` further excludes future-dated entries
+ * Returns raw CollectionEntry objects with filtering applied (drafts excluded,
+ * sorted newest first by `dateField`). Preserves `entry.data`, `entry.id`,
+ * and the ability to call `render(entry)` for `<Content />`.
  *
- * The collection's actual entry type is `CollectionEntry<'<name>'>` from
- * `astro:content`. Pass it as the generic to get full typed `data`:
- *
- * ```ts
- * import type { CollectionEntry } from 'astro:content';
- * export const blog = createBlogFromCollection<CollectionEntry<'blog'>>({
- *   collectionName: 'blog',
- *   dateField: 'pubDate',
- *   draftField: 'draft',
- * });
- * ```
- *
- * Dynamically imports `astro:content` at call time so the package stays
- * usable in non-Astro projects.
+ * Import only from inside Astro code (`src/lib/blog.ts`, page routes). Do not
+ * import from `astro.config.mjs` — Astro CC isn't initialized at config time.
+ * Use `createBlog` (fs) for astro.config.
  */
 export function createBlogFromCollection(config = {}) {
     const collectionName = config.collectionName ?? 'blog';
@@ -50,20 +42,8 @@ export function createBlogFromCollection(config = {}) {
     const categories = config.categories ?? [];
     const dateField = config.dateField ?? 'date';
     const draftField = config.draftField ?? null;
-    async function getCollection() {
-        let mod;
-        try {
-            // @ts-expect-error - 'astro:content' is a virtual module resolved by Astro at build time.
-            mod = await import('astro:content');
-        }
-        catch (err) {
-            throw new Error(`createBlogFromCollection() requires Astro and a configured content collection ` +
-                `named '${collectionName}'. Original error: ${err instanceof Error ? err.message : String(err)}`);
-        }
-        return mod.getCollection(collectionName);
-    }
     async function readAll() {
-        const all = await getCollection();
+        const all = (await astroGetCollection(collectionName));
         const filtered = draftField ? all.filter((e) => !e.data[draftField]) : all;
         return filtered.sort((a, b) => {
             const da = asDate(a.data[dateField])?.valueOf() ?? 0;

package/modules/blog/src/collection.ts

@@ -1,3 +1,9 @@
+// @ts-expect-error - 'astro:content' is a virtual module resolved by Astro at build time.
+// Static import (not dynamic) so Vite/Astro processes the dependency correctly.
+// This file is only safe to import from inside an Astro project. It lives at the
+// `/blog/collection` subpath; sites that aren't Astro should import from `/blog`
+// (which doesn't pull this in).
+import { getCollection as astroGetCollection } from 'astro:content';
 import readingTime from 'reading-time';
 import type {
   BlogCategory,
@@ -33,29 +39,15 @@ function asDate(value: unknown): Date | null {
 }
 
 /**
- * Astro Content Collections blog loader. Use this in Astro projects.
+ * Astro Content Collections blog loader. Use in any Astro project.
  *
- * Returns raw CollectionEntry objects (preserving `entry.data`, `entry.id`,
- * and the ability to call `render(entry)` from astro:content). Filtering and
- * sorting are applied:
- *   - Drafts excluded (when `draftField` is set)
- *   - Sorted newest first by `dateField`
- *   - `getPublishedEntries()` further excludes future-dated entries
+ * Returns raw CollectionEntry objects with filtering applied (drafts excluded,
+ * sorted newest first by `dateField`). Preserves `entry.data`, `entry.id`,
+ * and the ability to call `render(entry)` for `<Content />`.
  *
- * The collection's actual entry type is `CollectionEntry<'<name>'>` from
- * `astro:content`. Pass it as the generic to get full typed `data`:
- *
- * ```ts
- * import type { CollectionEntry } from 'astro:content';
- * export const blog = createBlogFromCollection<CollectionEntry<'blog'>>({
- *   collectionName: 'blog',
- *   dateField: 'pubDate',
- *   draftField: 'draft',
- * });
- * ```
- *
- * Dynamically imports `astro:content` at call time so the package stays
- * usable in non-Astro projects.
+ * Import only from inside Astro code (`src/lib/blog.ts`, page routes). Do not
+ * import from `astro.config.mjs` — Astro CC isn't initialized at config time.
+ * Use `createBlog` (fs) for astro.config.
  */
 export function createBlogFromCollection<E extends BlogCollectionEntry = BlogCollectionEntry>(
   config: CollectionBlogConfig = {}
@@ -66,22 +58,8 @@ export function createBlogFromCollection<E extends BlogCollectionEntry = BlogCol
   const dateField = config.dateField ?? 'date';
   const draftField = config.draftField ?? null;
 
-  async function getCollection(): Promise<E[]> {
-    let mod: { getCollection: (name: string) => Promise<E[]> };
-    try {
-      // @ts-expect-error - 'astro:content' is a virtual module resolved by Astro at build time.
-      mod = await import('astro:content');
-    } catch (err) {
-      throw new Error(
-        `createBlogFromCollection() requires Astro and a configured content collection ` +
-          `named '${collectionName}'. Original error: ${err instanceof Error ? err.message : String(err)}`
-      );
-    }
-    return mod.getCollection(collectionName);
-  }
-
   async function readAll(): Promise<E[]> {
-    const all = await getCollection();
+    const all = (await astroGetCollection(collectionName)) as E[];
     const filtered = draftField ? all.filter((e) => !e.data[draftField]) : all;
     return filtered.sort((a, b) => {
       const da = asDate(a.data[dateField])?.valueOf() ?? 0;

package/modules/blog/src/index.d.ts

@@ -1,5 +1,3 @@
 export * from './types.js';
 export { createBlog } from './fs.js';
 export type { FsBlogConfig } from './fs.js';
-export { createBlogFromCollection } from './collection.js';
-export type { CollectionBlogConfig } from './collection.js';

package/modules/blog/src/index.js

@@ -1,3 +1,8 @@
+// fs (gray-matter) blog loader — safe to import from anywhere (including
+// astro.config.mjs and non-Astro projects).
+//
+// For the Astro Content Collections variant, import from
+// `@ibalzam/codejitsu-core/blog/collection` (separate subpath because it
+// statically imports `astro:content`, which is only available inside Astro).
 export * from './types.js';
 export { createBlog } from './fs.js';
-export { createBlogFromCollection } from './collection.js';

package/modules/blog/src/index.ts

@@ -1,5 +1,10 @@
+// fs (gray-matter) blog loader — safe to import from anywhere (including
+// astro.config.mjs and non-Astro projects).
+//
+// For the Astro Content Collections variant, import from
+// `@ibalzam/codejitsu-core/blog/collection` (separate subpath because it
+// statically imports `astro:content`, which is only available inside Astro).
+
 export * from './types.js';
 export { createBlog } from './fs.js';
 export type { FsBlogConfig } from './fs.js';
-export { createBlogFromCollection } from './collection.js';
-export type { CollectionBlogConfig } from './collection.js';

package/modules/cli/src/blog.mjs

@@ -0,0 +1,99 @@
+import fs from 'fs';
+import path from 'path';
+import { loadConfig, isModuleEnabled } from '../../config/src/load.mjs';
+import { createBlog } from '../../blog/src/fs.js';
+import { c, table } from './format.mjs';
+
+/**
+ * `codejitsu blog:list` — show every non-draft post (published + pending).
+ * `codejitsu blog:drafts` — show only future-dated (pending) posts.
+ */
+export async function runBlog(subcommand) {
+  const cwd = process.cwd();
+  const config = await loadConfig(cwd);
+
+  if (!isModuleEnabled(config, 'blog')) {
+    console.error(c.red('blog module is disabled in codejitsu.config'));
+    process.exit(1);
+  }
+
+  const blogCfg = config.blog && typeof config.blog === 'object' ? config.blog : {};
+  const contentDir = blogCfg.contentDir ?? 'src/content/blog';
+  const dateField = blogCfg.dateField ?? 'date';
+  const draftField = blogCfg.draftField ?? null;
+
+  const blog = createBlog({
+    contentDir,
+    dateField,
+    draftField,
+  });
+
+  const today = todayUTC();
+  const siteUrl = config.site.url.replace(/\/$/, '');
+
+  if (subcommand === 'blog:drafts') {
+    const future = await blog.getAllPostsIncludingFuture();
+    const drafts = future.filter((p) => new Date(p.date) > today);
+    printPosts(drafts, { siteUrl, contentDir, today, kind: 'drafts' });
+    return;
+  }
+
+  // blog:list — published + pending, sorted newest first
+  const all = await blog.getAllPostsIncludingFuture();
+  printPosts(all, { siteUrl, contentDir, today, kind: 'all' });
+}
+
+function todayUTC() {
+  const now = new Date();
+  return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
+}
+
+function daysBetween(future, today) {
+  return Math.round((future.getTime() - today.getTime()) / 86_400_000);
+}
+
+function printPosts(posts, { siteUrl, contentDir, today, kind }) {
+  if (posts.length === 0) {
+    console.log(c.dim(kind === 'drafts' ? 'No pending posts.' : 'No posts.'));
+    return;
+  }
+
+  const cwd = process.cwd();
+  const publicDir = path.join(cwd, 'public');
+
+  const rows = posts.map((p) => {
+    const postDate = new Date(p.date);
+    const isFuture = postDate > today;
+    const days = isFuture ? `+${daysBetween(postDate, today)}d` : 'live';
+
+    const url = `${siteUrl}/blog/${p.slug}/`;
+    const imgStatus = formatImageStatus(p.image, publicDir);
+
+    return [
+      isFuture ? c.yellow(days) : c.green(days),
+      p.date,
+      imgStatus,
+      url,
+    ];
+  });
+
+  table(['STATUS', 'DATE', 'IMG', 'URL'], rows);
+
+  const published = posts.filter((p) => new Date(p.date) <= today).length;
+  const pending = posts.length - published;
+  console.log('');
+  console.log(
+    `${c.bold(String(posts.length))} posts · ` +
+      `${c.green(`${published} live`)} · ` +
+      `${c.yellow(`${pending} pending`)}`
+  );
+}
+
+function formatImageStatus(image, publicDir) {
+  if (!image) return c.gray('—');
+  const rel = image.startsWith('/') ? image.slice(1) : image;
+  const fullPath = path.join(publicDir, rel);
+  if (fs.existsSync(fullPath)) return c.green('✓');
+  return c.red(`✗ ${image}`);
+}
+

package/modules/cli/src/format.mjs

@@ -0,0 +1,65 @@
+// Tiny ANSI color + table helpers. No deps.
+
+const isTTY = process.stdout.isTTY && !process.env.NO_COLOR;
+
+function wrap(code) {
+  return isTTY ? (s) => `\x1b[${code}m${s}\x1b[0m` : (s) => s;
+}
+
+export const c = {
+  dim: wrap('2'),
+  bold: wrap('1'),
+  red: wrap('31'),
+  green: wrap('32'),
+  yellow: wrap('33'),
+  blue: wrap('34'),
+  magenta: wrap('35'),
+  cyan: wrap('36'),
+  gray: wrap('90'),
+};
+
+const ansiRe = /\x1b\[[0-9;]*m/g;
+
+function visibleLength(s) {
+  return s.replace(ansiRe, '').length;
+}
+
+function padCol(s, width) {
+  const diff = width - visibleLength(s);
+  return diff > 0 ? s + ' '.repeat(diff) : s;
+}
+
+function truncate(s, width) {
+  if (visibleLength(s) <= width) return s;
+  const plain = s.replace(ansiRe, '');
+  return plain.slice(0, width - 1) + '…';
+}
+
+/**
+ * Print a table.
+ *
+ * @param {string[]} headers
+ * @param {string[][]} rows
+ * @param {object} [opts]
+ * @param {number[]} [opts.maxWidths]
+ */
+export function table(headers, rows, opts = {}) {
+  const cols = headers.length;
+  const widths = new Array(cols).fill(0);
+
+  for (let i = 0; i < cols; i++) {
+    widths[i] = visibleLength(headers[i]);
+    for (const row of rows) {
+      widths[i] = Math.max(widths[i], visibleLength(row[i] ?? ''));
+    }
+    if (opts.maxWidths?.[i]) {
+      widths[i] = Math.min(widths[i], opts.maxWidths[i]);
+    }
+  }
+
+  console.log(headers.map((h, i) => c.bold(padCol(h, widths[i]))).join('  '));
+  console.log(widths.map((w) => c.gray('─'.repeat(w))).join('  '));
+  for (const row of rows) {
+    console.log(row.map((cell, i) => padCol(truncate(cell ?? '', widths[i]), widths[i])).join('  '));
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibalzam/codejitsu-core",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "type": "module",
   "description": "Shared core for Codejitsu Astro sites — reusable code and Claude-facing instructions for blog, SEO, images, deploy, and llms.txt.",
   "keywords": [
@@ -43,6 +43,10 @@
       "types": "./modules/blog/src/index.d.ts",
       "default": "./modules/blog/src/index.js"
     },
+    "./blog/collection": {
+      "types": "./modules/blog/src/collection.d.ts",
+      "default": "./modules/blog/src/collection.js"
+    },
     "./seo": {
       "types": "./modules/seo/src/index.d.ts",
       "default": "./modules/seo/src/index.js"
@@ -64,6 +68,7 @@
     "./package.json": "./package.json"
   },
   "bin": {
+    "codejitsu": "./bin/codejitsu.mjs",
     "codejitsu-llms": "./modules/llms/bin/generate.mjs",
     "codejitsu-optimize-images": "./modules/images/bin/optimize.mjs",
     "codejitsu-check": "./checklist/bin/run.mjs"