@yansirplus/cli 0.5.17

package/dist/generate/project-docs-site.mjs

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+
+const root = process.cwd();
+const check = process.argv.includes("--check");
+const watch = process.argv.includes("--watch");
+const docsRoot = path.join(root, "docs");
+const targetRoot = path.join(root, "tooling/docs-site/src/content/docs");
+const failures = [];
+
+const generatedNotice = (source) =>
+  `<!-- generated by packages/cli/src/generate/project-docs-site.mjs; edit ${source} -->`;
+
+const walk = (dir) => {
+  if (!fs.existsSync(dir)) return [];
+  const out = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      out.push(...walk(full));
+      continue;
+    }
+    if (entry.isFile()) out.push(full);
+  }
+  return out;
+};
+
+const slash = (value) => value.replaceAll(path.sep, "/");
+const relRoot = (file) => slash(path.relative(root, file));
+const escapeYaml = (value) => value.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
+
+const isProjectedSource = (file) => {
+  const rel = slash(path.relative(docsRoot, file));
+  if (!file.endsWith(".md")) return false;
+  if (rel.startsWith("templates/")) return false;
+  return true;
+};
+
+const siteRouteForDocsRel = (docsRel, anchor = "") => {
+  const normalized = slash(docsRel).replace(/\.md$/u, "");
+  if (normalized === "README") return `/${anchor}`;
+  return `/${normalized}/${anchor}`;
+};
+
+const targetRelForDocsRel = (docsRel) => {
+  if (docsRel === "README.md") return "index.md";
+  return docsRel;
+};
+
+const parseTargetHref = (href, sourceDocsRel) => {
+  if (!href.endsWith(".md") && !href.includes(".md#")) return null;
+  const [rawPath, rawAnchor] = href.split("#");
+  if (!rawPath.endsWith(".md")) return null;
+  const sourceDir = path.posix.dirname(sourceDocsRel);
+  const targetDocsRel = slash(path.posix.normalize(path.posix.join(sourceDir, rawPath)));
+  const anchor = rawAnchor === undefined ? "" : `#${rawAnchor}`;
+  return siteRouteForDocsRel(targetDocsRel, anchor);
+};
+
+const rewriteLinksForSite = (text, sourceDocsRel) =>
+  text.replace(/\[([^\]\n]+)\]\(([^)\s]+)(\s+"[^"]*")?\)/gu, (full, label, href, title = "") => {
+    const rewritten = parseTargetHref(href, sourceDocsRel);
+    return rewritten === null ? full : `[${label}](${rewritten}${title})`;
+  });
+
+const projectMarkdown = (sourceFile, options = {}) => {
+  const docsRel = slash(path.relative(docsRoot, sourceFile));
+  const sourceRel = relRoot(sourceFile);
+  const source = fs.readFileSync(sourceFile, "utf8").replace(/\s+$/u, "");
+  const h1 = source.match(/^# (.+)$/mu);
+  const title = h1?.[1] ?? sourceRel;
+  const withoutH1 =
+    h1 === null ? source : source.replace(/^# .+\r?\n\r?\n?/u, "").replace(/\s+$/u, "");
+  const bodyPrefix = options.bodyPrefix ?? "";
+  const body = `${bodyPrefix}${rewriteLinksForSite(withoutH1, docsRel)}`;
+  return [
+    "---",
+    `title: "${escapeYaml(title)}"`,
+    "---",
+    "",
+    generatedNotice(sourceRel),
+    "",
+    body,
+    "",
+  ].join("\n");
+};
+
+const formatProjectedMarkdown = (expected) => {
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "agent-docs-site-"));
+  try {
+    for (const [targetRel, content] of expected) {
+      const target = path.join(tmpDir, targetRel);
+      fs.mkdirSync(path.dirname(target), { recursive: true });
+      fs.writeFileSync(target, `${content.replace(/\s+$/u, "")}\n`);
+    }
+    const result = spawnSync("vp", ["fmt", tmpDir, "--write"], {
+      cwd: root,
+      encoding: "utf8",
+    });
+    if (result.status !== 0) {
+      failures.push(
+        `docs-site projection formatting failed: ${result.stderr || result.stdout || result.status}`,
+      );
+      return expected;
+    }
+    const formatted = new Map();
+    for (const targetRel of expected.keys()) {
+      formatted.set(targetRel, fs.readFileSync(path.join(tmpDir, targetRel), "utf8"));
+    }
+    return formatted;
+  } finally {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+};
+
+const removeEmptyDirs = (dir) => {
+  if (!fs.existsSync(dir)) return;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) removeEmptyDirs(path.join(dir, entry.name));
+  }
+  if (dir !== targetRoot && fs.readdirSync(dir).length === 0) fs.rmdirSync(dir);
+};
+
+const project = () => {
+  failures.length = 0;
+  const sources = walk(docsRoot).filter(isProjectedSource).sort();
+  const expected = new Map();
+
+  for (const source of sources) {
+    const docsRel = slash(path.relative(docsRoot, source));
+    const targetRel = targetRelForDocsRel(docsRel);
+    expected.set(targetRel, projectMarkdown(source));
+  }
+  const formattedExpected = formatProjectedMarkdown(expected);
+
+  for (const [targetRel, content] of formattedExpected) {
+    const target = path.join(targetRoot, targetRel);
+    const expectedText = `${content.replace(/\s+$/u, "")}\n`;
+    if (check) {
+      const actual = fs.existsSync(target) ? fs.readFileSync(target, "utf8") : "";
+      if (actual !== expectedText) failures.push(`${slash(path.relative(root, target))} is stale`);
+      continue;
+    }
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, expectedText);
+  }
+
+  const actualTargets = walk(targetRoot)
+    .filter((file) => file.endsWith(".md"))
+    .map((file) => slash(path.relative(targetRoot, file)))
+    .sort();
+  for (const targetRel of actualTargets) {
+    if (!formattedExpected.has(targetRel)) {
+      const target = path.join(targetRoot, targetRel);
+      if (check) {
+        failures.push(`${slash(path.relative(root, target))} is stale extra projection`);
+      } else {
+        fs.rmSync(target);
+      }
+    }
+  }
+  if (!check) removeEmptyDirs(targetRoot);
+
+  if (failures.length > 0) {
+    console.error(failures.join("\n"));
+    process.exitCode = 1;
+    return false;
+  }
+
+  console.log(`projected docs site content for ${expected.size} pages`);
+  return true;
+};
+
+project();
+
+if (watch) {
+  console.log("watching docs/** for docs-site projection changes");
+  let timer = null;
+  const schedule = () => {
+    if (timer !== null) clearTimeout(timer);
+    timer = setTimeout(() => {
+      timer = null;
+      project();
+    }, 100);
+  };
+  fs.watch(docsRoot, { recursive: true }, schedule);
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare const compileAgentTree: any;
+export declare const linkWorkspaceStaticTarget: any;

package/dist/index.js

@@ -0,0 +1,25 @@
+import { compileAgentTree as compileAgentTreeImpl, linkWorkspaceStaticTarget as linkWorkspaceStaticTargetImpl, } from "./build/agent-authoring.js";
+/**
+ * Compile an authored `agent/` tree into one normalized manifest plus
+ * provenance. Runtime facts and provider material are rejected before they can
+ * become manifest truth.
+ *
+ * @agentosPrimitive primitive.agent-authoring.compileAgentTree
+ * @agentosInvariant invariant.docs.agent-projection
+ * @agentosInvariant invariant.algebra.single-code-source
+ * @agentosDocs docs/guides/build-natural-language-workspace-agent.md
+ * @public
+ */
+export const compileAgentTree = compileAgentTreeImpl;
+/**
+ * Link normalized workspace authoring intent to a closed-target residual
+ * program. Implementation wiring is static imports and factory composition;
+ * manifest and deployment JSON remain semantic/provenance data only.
+ *
+ * @agentosPrimitive primitive.agent-authoring.linkWorkspaceStaticTarget
+ * @agentosInvariant invariant.docs.agent-projection
+ * @agentosInvariant invariant.algebra.single-code-source
+ * @agentosDocs docs/guides/build-natural-language-workspace-agent.md
+ * @public
+ */
+export const linkWorkspaceStaticTarget = linkWorkspaceStaticTargetImpl;