diffwiki-core 0.8.0 → 0.9.0-rc.202607291540.2b773e4

package/dist/index.cjs

@@ -570,6 +570,7 @@ __export(index_exports, {
   InvalidTargetError: () => InvalidTargetError,
   NATIVE_ENGINE: () => NATIVE_ENGINE,
   NoDefaultCollectionError: () => NoDefaultCollectionError,
+  PROJECT_CONFIG_FILE: () => PROJECT_CONFIG_FILE,
   PluginError: () => PluginError,
   REPO_CONFIG_FILE: () => REPO_CONFIG_FILE,
   WorktreeNotAllowedError: () => WorktreeNotAllowedError,
@@ -580,6 +581,7 @@ __export(index_exports, {
   buildLinkGraph: () => buildLinkGraph,
   buildNavTree: () => buildNavTree,
   buildSearchIndex: () => buildSearchIndex,
+  buildSiteConfig: () => buildSiteConfig,
   collectionDir: () => collectionDir,
   collectionGitStatus: () => collectionGitStatus,
   collectionMeta: () => collectionMeta,
@@ -624,8 +626,10 @@ __export(index_exports, {
   readArticle: () => readArticle,
   readConfig: () => readConfig,
   readPluginRegistry: () => readPluginRegistry,
+  readProjectConfig: () => readProjectConfig,
   readRegistry: () => readRegistry,
   readRepoConfig: () => readRepoConfig,
+  readSiteConfig: () => readSiteConfig,
   registerCollection: () => registerCollection,
   registerPlugin: () => registerPlugin,
   registryPath: () => registryPath,
@@ -639,10 +643,14 @@ __export(index_exports, {
   resolveCollectionSelection: () => resolveCollectionSelection,
   resolveCwdCollection: () => resolveCwdCollection,
   resolveDefaultSearchMode: () => resolveDefaultSearchMode,
+  resolveEditTarget: () => resolveEditTarget,
+  resolveEditorCommand: () => resolveEditorCommand,
   resolveHome: () => resolveHome,
   resolveLogLevel: () => resolveLogLevel,
   resolvePage: () => resolvePage,
+  resolveProjectCollections: () => resolveProjectCollections,
   search: () => search,
+  seedProjectHome: () => seedProjectHome,
   serializeArticle: () => serializeArticle,
   setConfigValue: () => setConfigValue,
   setTags: () => setTags,
@@ -1127,12 +1135,120 @@ async function collectionGitStatus(entry) {
   return { branch: s.branch, ahead: s.ahead, behind: s.behind, hasUpstream: s.hasUpstream };
 }
 
+// src/project.ts
+var import_promises8 = __toESM(require("fs/promises"), 1);
+var import_node_os2 = __toESM(require("os"), 1);
+var import_node_path6 = __toESM(require("path"), 1);
+var import_yaml3 = require("yaml");
+var PROJECT_CONFIG_FILE = "diffwiki.yaml";
+function normaliseSite(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const r = raw;
+  const repo = typeof r.repo === "string" ? r.repo : void 0;
+  let copyright;
+  if (typeof r.copyright === "string") {
+    copyright = { text: r.copyright };
+  } else if (r.copyright && typeof r.copyright === "object") {
+    const c = r.copyright;
+    if (typeof c.text === "string") {
+      copyright = { text: c.text, ...typeof c.url === "string" ? { url: c.url } : {} };
+    }
+  }
+  let home;
+  if (r.home && typeof r.home === "object") {
+    const h = r.home;
+    const tagline = typeof h.tagline === "string" ? h.tagline : void 0;
+    const cards = [];
+    if (Array.isArray(h.cards)) {
+      for (const c of h.cards) {
+        if (!c || typeof c !== "object") continue;
+        const cc = c;
+        if (typeof cc.title === "string" && typeof cc.link === "string") {
+          cards.push({
+            title: cc.title,
+            link: cc.link,
+            ...typeof cc.icon === "string" ? { icon: cc.icon } : {},
+            ...typeof cc.subtitle === "string" ? { subtitle: cc.subtitle } : {}
+          });
+        }
+      }
+    }
+    home = { ...tagline !== void 0 ? { tagline } : {}, ...cards.length > 0 ? { cards } : {} };
+    if (Object.keys(home).length === 0) home = void 0;
+  }
+  if (repo === void 0 && copyright === void 0 && home === void 0) return void 0;
+  return {
+    ...repo !== void 0 ? { repo } : {},
+    ...copyright !== void 0 ? { copyright } : {},
+    ...home !== void 0 ? { home } : {}
+  };
+}
+async function readProjectConfig(dir) {
+  let raw;
+  try {
+    raw = await import_promises8.default.readFile(import_node_path6.default.join(dir, PROJECT_CONFIG_FILE), "utf8");
+  } catch (err) {
+    if (err.code === "ENOENT") return void 0;
+    throw err;
+  }
+  const parsed = (0, import_yaml3.parse)(raw) ?? {};
+  const collections = [];
+  if (Array.isArray(parsed.collections)) {
+    for (const c of parsed.collections) {
+      if (!c || typeof c !== "object") continue;
+      const cc = c;
+      if (typeof cc.name === "string" && typeof cc.path === "string") {
+        collections.push({
+          name: cc.name,
+          path: cc.path,
+          ...typeof cc.order === "number" ? { order: cc.order } : {}
+        });
+      }
+    }
+    collections.sort((a, b) => (a.order ?? Number.MAX_SAFE_INTEGER) - (b.order ?? Number.MAX_SAFE_INTEGER));
+  } else if (typeof parsed.path === "string") {
+    const name = typeof parsed.collection === "string" ? parsed.collection : import_node_path6.default.basename(import_node_path6.default.resolve(dir));
+    collections.push({ name, path: parsed.path });
+  }
+  const site = normaliseSite(parsed.site);
+  return { ...site ? { site } : {}, collections };
+}
+async function resolveProjectCollections(dir) {
+  const config = await readProjectConfig(dir);
+  if (!config) return [];
+  const root = import_node_path6.default.resolve(dir);
+  const createdAt = (/* @__PURE__ */ new Date()).toISOString();
+  return config.collections.map((c) => ({
+    name: c.name,
+    type: "repo",
+    path: import_node_path6.default.resolve(root, c.path),
+    createdAt
+  }));
+}
+async function readSiteConfig(dir) {
+  return (await readProjectConfig(dir))?.site ?? {};
+}
+async function seedProjectHome(dir) {
+  const entries = await resolveProjectCollections(dir);
+  if (entries.length === 0) {
+    throw new Error(`No collections to render from diffwiki.yaml in ${import_node_path6.default.resolve(dir)}`);
+  }
+  const home = await import_promises8.default.mkdtemp(import_node_path6.default.join(import_node_os2.default.tmpdir(), "diffwiki-project-"));
+  await import_promises8.default.writeFile(
+    import_node_path6.default.join(home, "registry.json"),
+    `${JSON.stringify({ version: 1, collections: entries }, null, 2)}
+`,
+    "utf8"
+  );
+  return { home, entries };
+}
+
 // src/site.ts
 init_collections();
 
 // src/browse.ts
-var import_promises8 = __toESM(require("fs/promises"), 1);
-var import_node_path6 = __toESM(require("path"), 1);
+var import_promises9 = __toESM(require("fs/promises"), 1);
+var import_node_path7 = __toESM(require("path"), 1);
 init_collections();
 init_errors();
 var INDEX_RE = /^(index|readme)\.mdx?$/i;
@@ -1178,7 +1294,7 @@ function buildArticleTree(relPaths) {
 async function collectRelPaths(dir, rel = "") {
   let dirents;
   try {
-    dirents = await import_promises8.default.readdir(dir, { withFileTypes: true });
+    dirents = await import_promises9.default.readdir(dir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -1187,7 +1303,7 @@ async function collectRelPaths(dir, rel = "") {
     if (d.name.startsWith(".")) continue;
     const childRel = rel ? `${rel}/${d.name}` : d.name;
     if (d.isDirectory()) {
-      out.push(...await collectRelPaths(import_node_path6.default.join(dir, d.name), childRel));
+      out.push(...await collectRelPaths(import_node_path7.default.join(dir, d.name), childRel));
     } else if (/\.(mdx?)$/.test(d.name)) {
       out.push(childRel);
     }
@@ -1196,7 +1312,7 @@ async function collectRelPaths(dir, rel = "") {
 }
 async function readdirSafe(dir) {
   try {
-    return await import_promises8.default.readdir(dir);
+    return await import_promises9.default.readdir(dir);
   } catch {
     return [];
   }
@@ -1214,7 +1330,7 @@ var CHEAP_META_BYTES = 8192;
 async function cheapMeta(absPath) {
   let handle;
   try {
-    handle = await import_promises8.default.open(absPath, "r");
+    handle = await import_promises9.default.open(absPath, "r");
     const buf = Buffer.alloc(CHEAP_META_BYTES);
     const { bytesRead } = await handle.read(buf, 0, CHEAP_META_BYTES, 0);
     const snippet = buf.subarray(0, bytesRead).toString("utf8");
@@ -1225,10 +1341,13 @@ async function cheapMeta(absPath) {
     const titleM = /^title:\s*(.+)$/m.exec(inner);
     const audienceM = /^audience:\s*(.+)$/m.exec(inner);
     const statusM = /^status:\s*(.+)$/m.exec(inner);
+    const orderM = /^order:\s*(.+)$/m.exec(inner);
     const title = titleM ? clean(titleM[1]) : void 0;
     const audience = audienceM && clean(audienceM[1]) === "private" ? "private" : void 0;
     const status = statusM && clean(statusM[1]) === "draft" ? "draft" : void 0;
-    return { title, audience, status };
+    const orderNum = orderM ? Number(clean(orderM[1])) : NaN;
+    const order = Number.isFinite(orderNum) ? orderNum : void 0;
+    return { title, audience, status, order };
   } catch {
   } finally {
     await handle?.close();
@@ -1236,86 +1355,90 @@ async function cheapMeta(absPath) {
   return {};
 }
 async function enrichTitles(nodes, collDir) {
-  return Promise.all(
+  const enriched = await Promise.all(
     nodes.map(async (node) => {
       if (node.children) {
         const children = await enrichTitles(node.children, collDir);
         let title = node.title;
         let audience = node.audience;
         let status = node.status;
+        let order = node.order;
         if (node.slug) {
-          const dir = import_node_path6.default.join(collDir, node.slug);
+          const dir = import_node_path7.default.join(collDir, node.slug);
           const idx = pickIndexFile(await readdirSafe(dir));
           if (idx) {
-            const meta = await cheapMeta(import_node_path6.default.join(dir, idx));
+            const meta = await cheapMeta(import_node_path7.default.join(dir, idx));
             title = meta.title ?? title;
             audience = meta.audience ?? audience;
             status = meta.status ?? status;
+            order = meta.order ?? order;
           }
         }
-        return { ...node, title, audience, status, children };
+        return { ...node, title, audience, status, order, children };
       }
       for (const ext of [".mdx", ".md"]) {
-        const meta = await cheapMeta(import_node_path6.default.join(collDir, `${node.slug}${ext}`));
-        if (meta.title || meta.audience || meta.status) {
+        const meta = await cheapMeta(import_node_path7.default.join(collDir, `${node.slug}${ext}`));
+        if (meta.title || meta.audience || meta.status || meta.order != null) {
           return {
             ...node,
             title: meta.title ?? node.title,
             audience: meta.audience ?? node.audience,
-            status: meta.status ?? node.status
+            status: meta.status ?? node.status,
+            order: meta.order ?? node.order
           };
         }
       }
       return node;
     })
   );
+  return enriched.sort((a, b) => (a.order ?? Number.MAX_SAFE_INTEGER) - (b.order ?? Number.MAX_SAFE_INTEGER));
 }
 async function collectionMeta(collDir) {
   const idx = pickIndexFile(await readdirSafe(collDir));
   if (!idx) return {};
-  const meta = await cheapMeta(import_node_path6.default.join(collDir, idx));
-  return { audience: meta.audience, status: meta.status };
+  const meta = await cheapMeta(import_node_path7.default.join(collDir, idx));
+  return { title: meta.title, audience: meta.audience, status: meta.status };
 }
 async function listArticleTree(coll) {
   const entry = await findCollection(coll);
   if (!entry) throw new CollectionNotFoundError(coll);
   const rels = await collectRelPaths(entry.path);
-  return enrichTitles(buildArticleTree(rels), import_node_path6.default.resolve(entry.path));
+  return enrichTitles(buildArticleTree(rels), import_node_path7.default.resolve(entry.path));
 }
 async function readArticle(coll, slug) {
   const entry = await findCollection(coll);
   if (!entry) throw new CollectionNotFoundError(coll);
-  const collDir = import_node_path6.default.resolve(entry.path);
+  const collDir = import_node_path7.default.resolve(entry.path);
   const normalized = slug.replace(/\\/g, "/");
   if (normalized.split("/").some((s) => s === "..")) {
     throw new InvalidTargetError(slug, "path traversal detected");
   }
   const safeSlug = normalized.split("/").filter((s) => s !== "" && s !== ".").join("/");
-  const inJail = (p) => p === collDir || p.startsWith(collDir + import_node_path6.default.sep);
+  const inJail = (p) => p === collDir || p.startsWith(collDir + import_node_path7.default.sep);
   let abs;
   let isIndex = false;
   for (const rel of safeSlug ? [`${safeSlug}.mdx`, `${safeSlug}.md`] : []) {
-    const candidate = import_node_path6.default.resolve(collDir, rel);
+    const candidate = import_node_path7.default.resolve(collDir, rel);
     if (!inJail(candidate)) throw new InvalidTargetError(slug, "path traversal detected");
     try {
-      await import_promises8.default.access(candidate);
+      await import_promises9.default.access(candidate);
       abs = candidate;
       break;
     } catch {
     }
   }
   if (!abs) {
-    const dir = import_node_path6.default.resolve(collDir, safeSlug);
+    const dir = import_node_path7.default.resolve(collDir, safeSlug);
     if (inJail(dir)) {
       const idx = pickIndexFile(await readdirSafe(dir));
       if (idx) {
-        abs = import_node_path6.default.join(dir, idx);
+        abs = import_node_path7.default.join(dir, idx);
         isIndex = true;
       }
     }
   }
   if (!abs) throw new ArticleNotFoundError(`${coll}/${safeSlug}`);
-  const parsed = parseArticle(await import_promises8.default.readFile(abs, "utf8"));
+  const parsed = parseArticle(await import_promises9.default.readFile(abs, "utf8"));
   const title = parsed.title?.trim() || (safeSlug ? safeSlug.split("/").pop() ?? safeSlug : coll);
   return {
     coll,
@@ -1331,7 +1454,7 @@ async function readArticle(coll, slug) {
 }
 
 // src/render.ts
-var import_node_path7 = __toESM(require("path"), 1);
+var import_node_path8 = __toESM(require("path"), 1);
 var import_unified = require("unified");
 var import_remark_parse = __toESM(require("remark-parse"), 1);
 var import_remark_gfm = __toESM(require("remark-gfm"), 1);
@@ -1348,7 +1471,7 @@ function isNonRelativeHref(href) {
   return /^[a-z][a-z0-9+.-]*:/i.test(href);
 }
 function rehypeRewriteLinks(ctx) {
-  const slugDir = ctx.isIndex ? ctx.slug || "." : import_node_path7.default.posix.dirname(ctx.slug || ".");
+  const slugDir = ctx.isIndex ? ctx.slug || "." : import_node_path8.default.posix.dirname(ctx.slug || ".");
   return (tree) => {
     (0, import_unist_util_visit.visit)(tree, "element", (node) => {
       if (node.tagName !== "a") return;
@@ -1358,8 +1481,8 @@ function rehypeRewriteLinks(ctx) {
       const suffix = suffixMatch ? suffixMatch[0] : "";
       const pathPart = suffix ? raw.slice(0, raw.length - suffix.length) : raw;
       if (pathPart === "") return;
-      const joined = import_node_path7.default.posix.join(slugDir === "." ? "" : slugDir, pathPart);
-      const normalized = import_node_path7.default.posix.normalize(joined);
+      const joined = import_node_path8.default.posix.join(slugDir === "." ? "" : slugDir, pathPart);
+      const normalized = import_node_path8.default.posix.normalize(joined);
       const toRoute = (p) => p.replace(/\.(mdx?)$/i, "").replace(/(^|\/)(index|readme)$/i, "$1").replace(/\/+$/, "").replace(/^\/+/, "");
       if (normalized.startsWith("../")) {
         const sibling = normalized.slice(3);
@@ -1477,6 +1600,10 @@ async function renderArticle(body, ctx) {
     themes: { light: "github-light", dark: "github-dark" },
     defaultColor: false,
     langAlias: LANG_ALIASES,
+    // `defaultLanguage` styles fences with no language, `fallbackLanguage` those
+    // with an unknown one — both as plaintext, so every code block renders as a
+    // themed `pre.shiki` (light background + copy button), never a bare dark <pre>.
+    defaultLanguage: "plaintext",
     fallbackLanguage: "plaintext"
   }).use(import_rehype_stringify.default).process(body);
   return { html: String(file), toc, links };
@@ -1613,11 +1740,12 @@ async function buildCollections() {
   const entries = await listCollections();
   const infos = await Promise.all(
     entries.map(async (e) => {
-      const { audience, status } = await collectionMeta(e.path);
+      const { title, audience, status } = await collectionMeta(e.path);
       return {
         name: e.name,
         type: e.type,
         path: e.path,
+        ...title ? { title } : {},
         ...await gitInfo(e),
         ...audience ? { audience } : {},
         ...status ? { status } : {}
@@ -1630,12 +1758,13 @@ async function buildNavTree() {
   const entries = await listCollections();
   const trees = await Promise.all(
     entries.map(async (e) => {
-      const { audience, status } = await collectionMeta(e.path);
+      const { title, audience, status } = await collectionMeta(e.path);
       return {
         collection: {
           name: e.name,
           type: e.type,
           path: e.path,
+          ...title ? { title } : {},
           ...await gitInfo(e),
           ...audience ? { audience } : {},
           ...status ? { status } : {}
@@ -1708,6 +1837,15 @@ async function resolvePage(coll, slug, opts) {
     };
   }
 }
+async function buildSiteConfig() {
+  const dir = process.env.DIFFWIKI_PROJECT_DIR;
+  if (!dir) return {};
+  try {
+    return await readSiteConfig(dir);
+  } catch {
+    return {};
+  }
+}
 
 // src/select.ts
 function globToRegExp(glob) {
@@ -1737,8 +1875,8 @@ function resolveCollectionSelection(all, sel = {}) {
 }
 
 // src/query.ts
-var import_promises9 = __toESM(require("fs/promises"), 1);
-var import_node_path8 = __toESM(require("path"), 1);
+var import_promises10 = __toESM(require("fs/promises"), 1);
+var import_node_path9 = __toESM(require("path"), 1);
 init_collections();
 init_errors();
 init_logger();
@@ -1807,13 +1945,13 @@ var log2 = getLogger("query");
 async function collectMarkdownFiles(dir) {
   let entries;
   try {
-    entries = await import_promises9.default.readdir(dir, { withFileTypes: true });
+    entries = await import_promises10.default.readdir(dir, { withFileTypes: true });
   } catch {
     return [];
   }
   const files = [];
   for (const entry of entries) {
-    const full = import_node_path8.default.join(dir, entry.name);
+    const full = import_node_path9.default.join(dir, entry.name);
     if (entry.isDirectory()) {
       files.push(...await collectMarkdownFiles(full));
     } else if (entry.isFile() && /\.mdx?$/.test(entry.name)) {
@@ -1832,12 +1970,12 @@ async function nativeSearch(term, collections, collection) {
   const docs = [];
   for (const entry of targets) {
     for (const full of await collectMarkdownFiles(entry.path)) {
-      const fallbackTitle = import_node_path8.default.basename(full).replace(/\.mdx?$/, "");
+      const fallbackTitle = import_node_path9.default.basename(full).replace(/\.mdx?$/, "");
       let title = fallbackTitle;
       let tags = [];
       let body = "";
       try {
-        const parsed = parseArticle(await import_promises9.default.readFile(full, "utf8"));
+        const parsed = parseArticle(await import_promises10.default.readFile(full, "utf8"));
         if (parsed.title) title = parsed.title;
         tags = parsed.tags;
         body = parsed.body;
@@ -1920,14 +2058,14 @@ async function query(term, opts) {
 }
 
 // src/search.ts
-var import_promises10 = __toESM(require("fs/promises"), 1);
-var import_node_path9 = __toESM(require("path"), 1);
+var import_promises11 = __toESM(require("fs/promises"), 1);
+var import_node_path10 = __toESM(require("path"), 1);
 init_collections();
 var isStatic2 = () => process.env.DIFFWIKI_STATIC === "1";
 async function readArticleParts(collDir, slug) {
   for (const ext of [".mdx", ".md"]) {
     try {
-      const parsed = parseArticle(await import_promises10.default.readFile(import_node_path9.default.join(collDir, `${slug}${ext}`), "utf8"));
+      const parsed = parseArticle(await import_promises11.default.readFile(import_node_path10.default.join(collDir, `${slug}${ext}`), "utf8"));
       return { tags: parsed.tags, body: parsed.body };
     } catch {
     }
@@ -1962,7 +2100,7 @@ async function buildSearchIndex(collection) {
   for (const e of entries) {
     try {
       const collEntry = await findCollection(e.name);
-      const collDir = import_node_path9.default.resolve(collEntry?.path ?? e.path);
+      const collDir = import_node_path10.default.resolve(collEntry?.path ?? e.path);
       if (isStatic2()) {
         const cm = await collectionMeta(collDir);
         if (cm.audience === "private" || cm.status === "draft") continue;
@@ -1975,15 +2113,15 @@ async function buildSearchIndex(collection) {
 }
 
 // src/doctor.ts
-var import_promises12 = __toESM(require("fs/promises"), 1);
+var import_promises13 = __toESM(require("fs/promises"), 1);
 init_paths();
 init_registry();
 init_collections();
 
 // src/plugins/manager.ts
-var import_promises11 = __toESM(require("fs/promises"), 1);
-var import_node_os2 = __toESM(require("os"), 1);
-var import_node_path11 = __toESM(require("path"), 1);
+var import_promises12 = __toESM(require("fs/promises"), 1);
+var import_node_os3 = __toESM(require("os"), 1);
+var import_node_path12 = __toESM(require("path"), 1);
 init_paths();
 init_errors();
 init_collections();
@@ -1994,7 +2132,7 @@ init_host();
 var import_node_child_process4 = require("child_process");
 var import_node_util3 = require("util");
 var import_node_fs = require("fs");
-var import_node_path10 = require("path");
+var import_node_path11 = require("path");
 var import_node_url = require("url");
 var execFileAsync3 = (0, import_node_util3.promisify)(import_node_child_process4.execFile);
 async function runProcess(file, args, opts) {
@@ -2010,7 +2148,7 @@ async function runProcess(file, args, opts) {
 // src/plugins/manager.ts
 async function readPackageJson(file) {
   try {
-    return JSON.parse(await import_promises11.default.readFile(file, "utf8"));
+    return JSON.parse(await import_promises12.default.readFile(file, "utf8"));
   } catch {
     return null;
   }
@@ -2026,7 +2164,7 @@ function binOf(manifest) {
 async function pluginManifestDirs(nodeModules) {
   let entries;
   try {
-    entries = await import_promises11.default.readdir(nodeModules);
+    entries = await import_promises12.default.readdir(nodeModules);
   } catch {
     return [];
   }
@@ -2036,44 +2174,44 @@ async function pluginManifestDirs(nodeModules) {
     if (entry.startsWith("@")) {
       let scoped;
       try {
-        scoped = await import_promises11.default.readdir(import_node_path11.default.join(nodeModules, entry));
+        scoped = await import_promises12.default.readdir(import_node_path12.default.join(nodeModules, entry));
       } catch {
         continue;
       }
       for (const pkg of scoped) {
         if (pkg.startsWith(".")) continue;
-        dirs.push(import_node_path11.default.join(nodeModules, entry, pkg));
+        dirs.push(import_node_path12.default.join(nodeModules, entry, pkg));
       }
     } else {
-      dirs.push(import_node_path11.default.join(nodeModules, entry));
+      dirs.push(import_node_path12.default.join(nodeModules, entry));
     }
   }
   return dirs;
 }
 async function ensurePluginRoot() {
   const dir = pluginsDir();
-  await import_promises11.default.mkdir(dir, { recursive: true });
-  const pkgPath = import_node_path11.default.join(dir, "package.json");
+  await import_promises12.default.mkdir(dir, { recursive: true });
+  const pkgPath = import_node_path12.default.join(dir, "package.json");
   if (await readPackageJson(pkgPath) === null) {
     const pkg = { name: "diffwiki-plugins", private: true, version: "0.0.0" };
-    await import_promises11.default.writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}
+    await import_promises12.default.writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
   }
   return dir;
 }
 async function asSearchPackage(pkgDir) {
-  const manifest = await readPackageJson(import_node_path11.default.join(pkgDir, "package.json"));
+  const manifest = await readPackageJson(import_node_path12.default.join(pkgDir, "package.json"));
   if (!manifest?.name || manifest.diffwiki?.kind !== "search") return null;
   const bin = binOf(manifest);
   if (!bin) return null;
-  return { name: manifest.name, version: manifest.version, binAbs: import_node_path11.default.resolve(pkgDir, bin) };
+  return { name: manifest.name, version: manifest.version, binAbs: import_node_path12.default.resolve(pkgDir, bin) };
 }
 async function packageNameFromSpec(spec) {
   const looksLikePath = spec.startsWith(".") || spec.startsWith("/") || spec.startsWith("~") || spec.startsWith("file:");
   if (looksLikePath) {
     const raw = spec.startsWith("file:") ? spec.slice("file:".length) : spec;
-    const abs = import_node_path11.default.resolve(raw.replace(/^~(?=$|\/)/, import_node_os2.default.homedir()));
-    return (await readPackageJson(import_node_path11.default.join(abs, "package.json")))?.name ?? null;
+    const abs = import_node_path12.default.resolve(raw.replace(/^~(?=$|\/)/, import_node_os3.default.homedir()));
+    return (await readPackageJson(import_node_path12.default.join(abs, "package.json")))?.name ?? null;
   }
   if (/^(git\+|git:|https?:|ssh:)/.test(spec)) return null;
   if (spec.startsWith("@")) {
@@ -2084,10 +2222,10 @@ async function packageNameFromSpec(spec) {
   return at <= 0 ? spec : spec.slice(0, at);
 }
 async function resolveSearchPackage(dir, name) {
-  return asSearchPackage(import_node_path11.default.join(dir, "node_modules", ...name.split("/")));
+  return asSearchPackage(import_node_path12.default.join(dir, "node_modules", ...name.split("/")));
 }
 async function discoverSearchPackage(dir) {
-  const nodeModules = import_node_path11.default.join(dir, "node_modules");
+  const nodeModules = import_node_path12.default.join(dir, "node_modules");
   for (const pkgDir of await pluginManifestDirs(nodeModules)) {
     const found = await asSearchPackage(pkgDir);
     if (found) return found;
@@ -2219,7 +2357,7 @@ init_host();
 init_types();
 async function exists(target) {
   try {
-    await import_promises12.default.access(target);
+    await import_promises13.default.access(target);
     return true;
   } catch {
     return false;
@@ -2327,6 +2465,32 @@ async function appendPluginDiagnostics(out, config) {
 // src/index.ts
 init_logger();
 
+// src/edit.ts
+init_collections();
+init_paths();
+init_errors();
+async function resolveEditTarget(target, cwd) {
+  if (target && target.trim()) {
+    const [coll, ...rest] = target.trim().split(":");
+    const slug = rest.join(":");
+    const entry = await findCollection(coll);
+    if (!entry) throw new CollectionNotFoundError(coll);
+    if (slug) {
+      const article = await readArticle(coll, slug);
+      return { path: article.path, kind: "article" };
+    }
+    return { path: entry.path, kind: "collection" };
+  }
+  const cwdColl = await resolveCwdCollection(cwd);
+  if (cwdColl) return { path: cwdColl.path, kind: "collection" };
+  return { path: collectionsDir(), kind: "root" };
+}
+async function resolveEditorCommand(flag) {
+  const raw = flag ?? await getConfigValue("editor") ?? process.env.VISUAL ?? process.env.EDITOR;
+  if (!raw || !raw.trim()) return void 0;
+  return raw.trim().split(/\s+/);
+}
+
 // src/plugins/index.ts
 init_host();
 init_events();
@@ -2365,6 +2529,7 @@ init_registry2();
   InvalidTargetError,
   NATIVE_ENGINE,
   NoDefaultCollectionError,
+  PROJECT_CONFIG_FILE,
   PluginError,
   REPO_CONFIG_FILE,
   WorktreeNotAllowedError,
@@ -2375,6 +2540,7 @@ init_registry2();
   buildLinkGraph,
   buildNavTree,
   buildSearchIndex,
+  buildSiteConfig,
   collectionDir,
   collectionGitStatus,
   collectionMeta,
@@ -2419,8 +2585,10 @@ init_registry2();
   readArticle,
   readConfig,
   readPluginRegistry,
+  readProjectConfig,
   readRegistry,
   readRepoConfig,
+  readSiteConfig,
   registerCollection,
   registerPlugin,
   registryPath,
@@ -2434,10 +2602,14 @@ init_registry2();
   resolveCollectionSelection,
   resolveCwdCollection,
   resolveDefaultSearchMode,
+  resolveEditTarget,
+  resolveEditorCommand,
   resolveHome,
   resolveLogLevel,
   resolvePage,
+  resolveProjectCollections,
   search,
+  seedProjectHome,
   serializeArticle,
   setConfigValue,
   setTags,