@odori/cli 0.0.10 → 0.0.12

package/src/docs.ts

@@ -0,0 +1,54 @@
+import snapshot from "./docs-snapshot.json" with {type: "json"};
+
+export type DocPage = {
+  slug: string;
+  title: string;
+  description: string;
+  section: string;
+  body: string;
+};
+
+export type DocHit = {page: DocPage; line: number; text: string};
+
+/** Every page, in the order the snapshot fixed at build time. */
+export const docPages = (): DocPage[] => (snapshot as {pages: DocPage[]}).pages;
+
+/**
+ * The page a reader asked for, by slug or by the tail of one.
+ *
+ * `odori docs audio` should find `guides/audio` without the reader knowing
+ * how the site files things: the section is the site's organisation, not
+ * theirs. An exact slug still wins, so a page named after a section is never
+ * shadowed by one inside it.
+ */
+export const findDoc = (query: string): DocPage | undefined => {
+  const wanted = query.replace(/^\/+|\/+$|\.mdx$/g, "").toLowerCase();
+  const pages = docPages();
+  return (
+    pages.find((page) => page.slug.toLowerCase() === wanted) ??
+    pages.find((page) => page.slug.toLowerCase().endsWith(`/${wanted}`)) ??
+    pages.find((page) => page.title.toLowerCase() === wanted)
+  );
+};
+
+/**
+ * Lines that mention the query, with the page they came from.
+ *
+ * Line-level rather than page-level, because "which page mentions ducking"
+ * is a worse answer than the sentence that does: an agent can act on the
+ * line and open the page only if it needs the rest.
+ */
+export const searchDocs = (query: string, limit = 20): DocHit[] => {
+  const needle = query.toLowerCase();
+  if (!needle) return [];
+  const hits: DocHit[] = [];
+  for (const page of docPages()) {
+    const lines = page.body.split("\n");
+    for (let index = 0; index < lines.length; index += 1) {
+      if (!lines[index].toLowerCase().includes(needle)) continue;
+      hits.push({page, line: index + 1, text: lines[index].trim()});
+      if (hits.length >= limit) return hits;
+    }
+  }
+  return hits;
+};

package/src/index.ts

@@ -30,6 +30,8 @@ export {
 } from "./jobs";
 export {buildAudioFilter, resolveCueFile, type MixInput} from "./audio-mix";
 export {checkDeterminism, type DeterminismFinding} from "./determinism";
+export {checkStructure, type StructureFinding} from "./structure";
+export {buildGraphArtifact, type GraphArtifact} from "./commands/graph";
 export {FORMATS, alphaWarning, formatNames, resolveFormat, type VideoFormat} from "./formats";
 export {
   CHROME_BUILD,