@shortlink-org/portolan 0.2.0 → 0.2.2

package/scripts/catalog-sources.mjs

@@ -37,7 +37,11 @@ export async function loadCatalog(manifestPath = "portolan.json", { exclude = []
     if (!excluded.has(normalize(path))) paths.push(path);
   }
 
-  if (paths.length === 0) {
+  const emptyWorkspace = Array.isArray(manifest.projects)
+    && manifest.projects.length === 0
+    && (manifest.extract ?? []).length === 0
+    && (manifest.verify ?? []).length === 0;
+  if (paths.length === 0 && !emptyWorkspace) {
     throw new Error(
       `${manifestPath}: no catalog matched ${JSON.stringify(patterns)}`,
     );
@@ -49,6 +53,13 @@ export async function loadCatalog(manifestPath = "portolan.json", { exclude = []
       catalog: JSON.parse(readFileSync(path, "utf8")),
     })),
   );
+  if (paths.length === 0) {
+    // An intentionally empty workspace still needs a valid, deterministic
+    // catalog value for generators and the local preview. These are state
+    // markers, not provenance claims: there is no source file to stamp.
+    merged.catalog.generatedAt = "1970-01-01T00:00:00Z";
+    merged.catalog.commit = "empty";
+  }
 
   // The edges the flows imply are added before validation, the same way the
   // app does it, so a generator draws the same estate the reader sees.

package/scripts/catalog-sources.test.mjs

@@ -0,0 +1,35 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+
+import { loadCatalog } from "./catalog-sources.mjs";
+
+const roots = [];
+afterEach(() => {
+  for (const root of roots.splice(0)) rmSync(root, { recursive: true, force: true });
+});
+
+function manifest(value) {
+  const root = mkdtempSync(join(tmpdir(), "portolan-empty-catalog-"));
+  roots.push(root);
+  const path = join(root, "portolan.json");
+  writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`);
+  return { path, missing: join(root, "portolan/*.json") };
+}
+
+describe("catalog sources", () => {
+  it("loads an intentional empty workspace as an empty catalog", async () => {
+    const { path, missing } = manifest({ sources: [], projects: [], extract: [], verify: [] });
+    writeFileSync(path, `${JSON.stringify({ sources: [missing], projects: [], extract: [], verify: [] }, null, 2)}\n`);
+    const loaded = await loadCatalog(path);
+    expect(loaded.sources).toEqual([]);
+    expect(loaded.catalog).toMatchObject({ contexts: [], defs: {}, flows: [], adrs: [] });
+  });
+
+  it("still reports missing sources for a configured project", async () => {
+    const { path, missing } = manifest({ sources: [], projects: [] });
+    writeFileSync(path, `${JSON.stringify({ sources: [missing], projects: [{ id: "billing" }], extract: [] }, null, 2)}\n`);
+    await expect(loadCatalog(path)).rejects.toThrow(/no catalog matched/);
+  });
+});