@chronova/wiki-agent 1.4.0 → 1.5.1

package/dist/agent.js

@@ -209,20 +209,14 @@ async function createWorkflowFile(projectRoot, wikiPublish) {
         "        with:",
         "          token: ${{ steps.token.outputs.token || secrets.GITHUB_TOKEN }}",
         "",
-        "      - name: Set up Node.js",
-        "        uses: actions/setup-node@v7",
-        "        with:",
-        '          node-version: "25"',
+        "      - name: Set up Bun",
+        "        uses: oven-sh/setup-bun@v2",
         "",
-        "      - name: Build Wiki Agent",
-        "        run: |",
-        "          git clone --branch main --depth 1 https://github.com/nx-solutions-ug/wiki-agent.git /tmp/wiki-agent",
-        "          cd /tmp/wiki-agent",
-        "          npm install",
-        "          npx tsc -p tsconfig.json",
+        "      - name: Install Wiki Agent",
+        "        run: bun add -g @chronova/wiki-agent",
         "",
         "      - name: Run Wiki Agent",
-        `        run: node /tmp/wiki-agent/dist/cli.js ${runFlags}`,
+        `        run: wiki ${runFlags}`,
         "        env:",
         "          WIKI_OLLAMA_MODE: cloud",
         '          WIKI_OLLAMA_API_KEY: ${{ secrets.WIKI_OLLAMA_API_KEY }}',
@@ -250,7 +244,7 @@ async function createWorkflowFile(projectRoot, wikiPublish) {
         "",
     ];
     if (wikiPublish) {
-        workflow.push("      - name: Repository coordinates", "        id: coords", "        run: echo \"owner_repo=${GITHUB_REPOSITORY}\" >> $GITHUB_OUTPUT", "", "      - name: Detect wiki initialization", "        id: wiki-init", "        env:", "          TOKEN: ${{ secrets.WIKI_PUSH_TOKEN || steps.token.outputs.token || secrets.GITHUB_TOKEN }}", "        run: |", "          REMOTE=\"https://x-access-token:${TOKEN}@github.com/${{ steps.coords.outputs.owner_repo }}.wiki.git\"", "          if git ls-remote --exit-code \"$REMOTE\" HEAD >/dev/null 2>&1; then", "            echo \"initialized=true\" >> $GITHUB_OUTPUT", "          else", "            echo \"initialized=false\" >> $GITHUB_OUTPUT", "            echo \"::warning::Wiki is not initialized. Create the first page in the GitHub UI (Wiki tab -> New Page), then rerun. Staging PR will still be opened.\" >> $GITHUB_OUTPUT", "          fi", "", "      - name: Publish to wiki repo", "        id: publish", "        if: steps.report.outputs.has_changes == 'true' && steps.wiki-init.outputs.initialized == 'true'", "        env:", "          TOKEN: ${{ secrets.WIKI_PUSH_TOKEN || steps.token.outputs.token || secrets.GITHUB_TOKEN }}", "        run: |", "          WIKI_URL=\"https://x-access-token:${TOKEN}@github.com/${{ steps.coords.outputs.owner_repo }}.wiki.git\"", "          rm -rf /tmp/wiki /tmp/wiki-flat", "          node /tmp/wiki-agent/dist/flatten-wiki.js \"$GITHUB_WORKSPACE/.wiki\" /tmp/wiki-flat", "          git clone \"$WIKI_URL\" /tmp/wiki", "          cd /tmp/wiki", "          # rsync the flattened wiki output (flat names, Home.md, _Sidebar.md).", "          # --exclude='.git' protects the wiki clone's .git directory from --delete.", "          rsync -a --delete \\", "            --exclude='.git' \\", "            /tmp/wiki-flat/ ./", "          git add -A", "          if ! git diff --cached --quiet; then", "            git -c user.name='wiki-agent[bot]' -c user.email='bot@wiki-agent' \\", "              commit -m \"docs: update wiki\"", "            if ! git push origin master 2>&1 | tee /tmp/wiki-push.log; then", "              echo \"::error::Failed to push to the wiki repo. Ensure the GitHub App has contents:write on the repository (which covers the wiki), or set a WIKI_PUSH_TOKEN secret with repo scope.\"", "              exit 1", "            fi", "            echo \"published=true\" >> $GITHUB_OUTPUT", "          else", "            echo \"::warning::No net wiki content changes after sync; skipping wiki push.\"", "            echo \"published=false\" >> $GITHUB_OUTPUT", "          fi");
+        workflow.push("      - name: Repository coordinates", "        id: coords", "        run: echo \"owner_repo=${GITHUB_REPOSITORY}\" >> $GITHUB_OUTPUT", "", "      - name: Detect wiki initialization", "        id: wiki-init", "        env:", "          TOKEN: ${{ secrets.WIKI_PUSH_TOKEN || steps.token.outputs.token || secrets.GITHUB_TOKEN }}", "        run: |", "          REMOTE=\"https://x-access-token:${TOKEN}@github.com/${{ steps.coords.outputs.owner_repo }}.wiki.git\"", "          if git ls-remote --exit-code \"$REMOTE\" HEAD >/dev/null 2>&1; then", "            echo \"initialized=true\" >> $GITHUB_OUTPUT", "          else", "            echo \"initialized=false\" >> $GITHUB_OUTPUT", "            echo \"::warning::Wiki is not initialized. Create the first page in the GitHub UI (Wiki tab -> New Page), then rerun. Staging PR will still be opened.\" >> $GITHUB_OUTPUT", "          fi", "", "      - name: Publish to wiki repo", "        id: publish", "        if: steps.report.outputs.has_changes == 'true' && steps.wiki-init.outputs.initialized == 'true'", "        env:", "          TOKEN: ${{ secrets.WIKI_PUSH_TOKEN || steps.token.outputs.token || secrets.GITHUB_TOKEN }}", "        run: |", "          WIKI_URL=\"https://x-access-token:${TOKEN}@github.com/${{ steps.coords.outputs.owner_repo }}.wiki.git\"", "          rm -rf /tmp/wiki /tmp/wiki-flat", "          wiki-flatten \"$GITHUB_WORKSPACE/.wiki\" /tmp/wiki-flat", "          git clone \"$WIKI_URL\" /tmp/wiki", "          cd /tmp/wiki", "          # rsync the flattened wiki output (flat names, Home.md, _Sidebar.md).", "          # --exclude='.git' protects the wiki clone's .git directory from --delete.", "          rsync -a --delete \\", "            --exclude='.git' \\", "            /tmp/wiki-flat/ ./", "          git add -A", "          if ! git diff --cached --quiet; then", "            git -c user.name='wiki-agent[bot]' -c user.email='bot@wiki-agent' \\", "              commit -m \"docs: update wiki\"", "            if ! git push origin master 2>&1 | tee /tmp/wiki-push.log; then", "              echo \"::error::Failed to push to the wiki repo. Ensure the GitHub App has contents:write on the repository (which covers the wiki), or set a WIKI_PUSH_TOKEN secret with repo scope.\"", "              exit 1", "            fi", "            echo \"published=true\" >> $GITHUB_OUTPUT", "          else", "            echo \"::warning::No net wiki content changes after sync; skipping wiki push.\"", "            echo \"published=false\" >> $GITHUB_OUTPUT", "          fi");
     }
     workflow.push("      - name: Create wiki staging snapshot pull request", "        uses: peter-evans/create-pull-request@v8", "        if: steps.report.outputs.has_changes == 'true'", "        with:", "          token: ${{ secrets.WIKI_PUSH_TOKEN || steps.token.outputs.token || secrets.GITHUB_TOKEN }}", "          branch: wiki/staging-${{ steps.timestamp.outputs.timestamp }}", "          add-paths: .wiki", '          title: "docs: wiki staging snapshot"', '          body: ${{ steps.report.outputs.body }}');
     await writeFile(workflowPath, workflow.join("\n") + "\n", "utf8");

package/dist/flatten-wiki.d.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 /**
  * Flattens the nested .wiki/ directory structure into a flat set of
  * GitHub Wiki-compatible files in the output directory.

package/dist/flatten-wiki.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { readFile, writeFile, mkdir, rm, readdir } from "node:fs/promises";
 import path from "node:path";
 /**
@@ -67,6 +68,19 @@ function extractTitle(content, wikiName) {
     }
     return wikiName.replace(/-/g, " ");
 }
+/**
+ * Strips a leading YAML frontmatter block (`---\n...\n---`) from markdown
+ * content. GitHub Wiki does not process frontmatter — it renders the YAML
+ * as visible text — so the block must be removed before publishing.
+ * A single optional newline after the closing `---` is also trimmed so the
+ * body starts cleanly. Files without frontmatter are returned unchanged.
+ */
+function stripFrontmatter(content) {
+    const match = content.match(/^---\n[\s\S]*?\n---\n?/);
+    if (!match)
+        return content;
+    return content.slice(match[0].length);
+}
 /**
  * Recursively walks the source .wiki/ directory and collects all .md files
  * with their relative paths, excluding metadata and config files.
@@ -199,9 +213,11 @@ export async function flattenWiki(wikiRoot, outputDir) {
         const wikiName = flatFile.replace(/\.md$/, "");
         // Determine the source file's directory relative to .wiki/
         const sourceRelDir = path.dirname(file.relPath) === "." ? "" : path.dirname(file.relPath);
-        // Rewrite links
-        const rewritten = rewriteLinks(content, sourceRelDir, pathMap);
-        // Extract title for sidebar
+        // Rewrite links on the frontmatter-stripped body. GitHub Wiki renders
+        // frontmatter as literal text, so strip it before publishing.
+        const body = stripFrontmatter(content);
+        const rewritten = rewriteLinks(body, sourceRelDir, pathMap);
+        // Extract title for sidebar (uses the original content with frontmatter)
         const title = extractTitle(content, wikiName);
         pageInfos.push({ relPath: file.relPath, wikiName, title });
         // Write the file

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@chronova/wiki-agent",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Standalone Ollama-only documentation agent",
   "type": "module",
   "bin": {
-    "wiki": "dist/cli.js"
+    "wiki": "dist/cli.js",
+    "wiki-flatten": "dist/flatten-wiki.js"
   },
   "files": [
     "dist",