@chronova/wiki-agent 1.2.2 → 1.3.1

package/README.md

@@ -109,21 +109,20 @@ Environment variables take priority over config files.
 
 ## GitHub Actions
 
-Running `wiki --init` automatically creates `.github/workflows/update-wiki.yml` in your repo. The workflow publishes generated pages to your repository's **GitHub Wiki tab**, not to the main repo's file tree:
+Running `wiki --init --wiki` automatically creates `.github/workflows/update-wiki.yml` in your repo. With `--wiki`, the workflow publishes generated pages to your repository's **GitHub Wiki tab**; without `--wiki` it only stages `.wiki/` and opens a staging PR.
 
 1. Generates a GitHub App token if `APP_CLIENT_ID` and `APP_PRIVATE_KEY` secrets are set (falls back to `GITHUB_TOKEN`)
 2. Checks out your repo, clones and builds wiki-agent from `nx-solutions-ug/wiki-agent`
-3. Runs `wiki --update --print` with your Ollama Cloud credentials, staging pages under `.wiki/`
+3. Runs `wiki --update --print --verbose` (with `--wiki` if the flag was passed at `--init` time), staging pages under `.wiki/`
 4. Probes the wiki remote (`<repo>.wiki.git`) with `git ls-remote` to detect whether the wiki has been initialized
-5. If there are content changes and the wiki is initialized: clones `<repo>.wiki.git`, syncs the `.wiki/` content (excluding `config.json`, `.last-update-report.md`, `.last-updated.json`) via `rsync`, commits on a `wiki/update-<timestamp>` branch, and pushes
-6. Opens a pull request against the wiki repo (`--repo <owner>/<repo>.wiki`, base `master`) with `.wiki/.last-update-report.md` as the body — a human merges to make updates live
-7. Always opens a `docs: wiki staging snapshot` pull request against the main repo with the `.wiki/` changes, so the staged content stays auditable
+5. If there are content changes and the wiki is initialized: clones `<repo>.wiki.git`, syncs the staged `.wiki/` content (excluding `config.json` and the run metadata) via `rsync`, commits, and **pushes directly to `master`** — the wiki goes live immediately (no PR, no review gate)
+6. Always opens a `docs: wiki staging snapshot` pull request against the main repo with the `.wiki/` changes, so the staged content stays auditable
 
 ### Bootstrap the wiki first
 
 GitHub wikis must be initialized once through the UI before they can be pushed to programmatically. Open the **Wiki** tab in your repository, create the first page (any content), then run the workflow. Until then the publish step is skipped with a warning; the staging PR still opens so you can inspect the generated content.
 
-The full workflow is written to `.github/workflows/update-wiki.yml` by `wiki --init`. See that file (or the template in [`src/agent.ts`](src/agent.ts) `createWorkflowFile`) for the authoritative, current definition. The steps in brief: generate token → checkout → build wiki-agent → run `--update --print` → probe wiki remote → if there are content changes and the wiki is initialized, clone `<repo>.wiki.git`, `rsync` the staged `.wiki/` content (excluding `config.json` and the run metadata), commit on `wiki/update-<timestamp>`, push → open a PR against the wiki repo (base `master`) → open a `docs: wiki staging snapshot` PR against the main repo.
+The full workflow is written to `.github/workflows/update-wiki.yml` by `wiki --init`. See that file (or the template in [`src/agent.ts`](src/agent.ts) `createWorkflowFile`) for the authoritative, current definition.
 
 ### Required secrets
 

package/dist/agent.d.ts

@@ -21,6 +21,7 @@ export interface RunOptions {
     gitSummary?: string;
     maxIterations?: number;
     stream?: boolean;
+    wikiPublish?: boolean;
     onEvent?: (event: AgentEvent) => void;
 }
 export declare function runAgent(client: Ollama, options: RunOptions): Promise<void>;

package/dist/agent.js

@@ -43,7 +43,7 @@ function normalizeToolCallArgs(args) {
     return {};
 }
 export async function runAgent(client, options) {
-    const { command, projectRoot, model, gitSummary, maxIterations, stream = false, onEvent = () => { }, } = options;
+    const { command, projectRoot, model, gitSummary, maxIterations, stream = false, wikiPublish = false, onEvent = () => { }, } = options;
     const maxIter = maxIterations ?? resolveMaxIterations();
     const tools = createTools(projectRoot);
     const systemPrompt = await createSystemPrompt(projectRoot);
@@ -156,8 +156,8 @@ export async function runAgent(client, options) {
             });
         }
     }
-    await createWorkflowFile(projectRoot);
-    onEvent({ type: "tool", name: "create_workflow", result: "Created .github/workflows/update-wiki.yml" });
+    await createWorkflowFile(projectRoot, wikiPublish);
+    onEvent({ type: "tool", name: "create_workflow", result: wikiPublish ? "Created .github/workflows/update-wiki.yml (with wiki publish)" : "Created .github/workflows/update-wiki.yml" });
     if (changedFiles.length === 0) {
         onEvent({ type: "done", summary: "Wiki is already current. No files changed." });
         return;
@@ -172,10 +172,11 @@ export async function runAgent(client, options) {
  * Creates a GitHub Actions workflow file in the target repo that checks out
  * the wiki-agent source, builds it, and runs --update --print on a schedule.
  */
-async function createWorkflowFile(projectRoot) {
+async function createWorkflowFile(projectRoot, wikiPublish) {
     const workflowsDir = path.join(projectRoot, ".github", "workflows");
     const workflowPath = path.join(workflowsDir, "update-wiki.yml");
     await mkdir(workflowsDir, { recursive: true });
+    const runFlags = wikiPublish ? "--update --print --verbose --wiki" : "--update --print --verbose";
     const workflow = [
         "name: Wiki Update",
         "",
@@ -221,7 +222,7 @@ async function createWorkflowFile(projectRoot) {
         "          npx tsc -p tsconfig.json",
         "",
         "      - name: Run Wiki Agent",
-        "        run: node /tmp/wiki-agent/dist/cli.js --update --print --verbose",
+        `        run: node /tmp/wiki-agent/dist/cli.js ${runFlags}`,
         "        env:",
         "          WIKI_OLLAMA_MODE: cloud",
         '          WIKI_OLLAMA_API_KEY: ${{ secrets.WIKI_OLLAMA_API_KEY }}',
@@ -231,23 +232,6 @@ async function createWorkflowFile(projectRoot) {
         "        id: timestamp",
         "        run: echo \"timestamp=$(date +%s)\" >> $GITHUB_OUTPUT",
         "",
-        "      - 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: Check for changes",
         "        id: report",
         "        run: |",
@@ -264,61 +248,12 @@ async function createWorkflowFile(projectRoot) {
         "            echo \"has_changes=false\" >> $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: |",
-        "          BRANCH=\"wiki/update-${{ steps.timestamp.outputs.timestamp }}\"",
-        "          WIKI_URL=\"https://x-access-token:${TOKEN}@github.com/${{ steps.coords.outputs.owner_repo }}.wiki.git\"",
-        "          rm -rf /tmp/wiki",
-        "          git clone \"$WIKI_URL\" /tmp/wiki",
-        "          cd /tmp/wiki",
-        "          git checkout -b \"$BRANCH\"",
-        "          # --exclude='.git' protects the wiki clone's .git directory from --delete.",
-        "          rsync -a --delete \\",
-        "            --exclude='.git' \\",
-        "            --exclude='.last-update-report.md' \\",
-        "            --exclude='.last-updated.json' \\",
-        "            --exclude='config.json' \\",
-        "            \"$GITHUB_WORKSPACE/.wiki/\" ./",
-        "          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 \"$BRANCH\" 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 \"branch=$BRANCH\" >> $GITHUB_OUTPUT",
-        "          else",
-        "            echo \"::warning::No net wiki content changes after sync; skipping wiki push.\"",
-        "            echo \"branch=\" >> $GITHUB_OUTPUT",
-        "          fi",
-        "",
-        "      - name: Open wiki update pull request",
-        "        if: steps.report.outputs.has_changes == 'true' && steps.wiki-init.outputs.initialized == 'true' && steps.publish.outputs.branch != ''",
-        "        env:",
-        "          GH_TOKEN: ${{ secrets.WIKI_PUSH_TOKEN || steps.token.outputs.token || secrets.GITHUB_TOKEN }}",
-        "        run: |",
-        "          gh pr create --repo \"${{ steps.coords.outputs.owner_repo }}.wiki\" \\",
-        "            --head \"wiki/update-${{ steps.timestamp.outputs.timestamp }}\" \\",
-        "            --base master \\",
-        "            --title \"docs: update wiki\" \\",
-        "            --body-file .wiki/.last-update-report.md",
-        "",
-        "      - 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 }}',
-    ].join("\n");
-    await writeFile(workflowPath, workflow, "utf8");
+    ];
+    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", "          git clone \"$WIKI_URL\" /tmp/wiki", "          cd /tmp/wiki", "          # --exclude='.git' protects the wiki clone's .git directory from --delete.", "          rsync -a --delete \\", "            --exclude='.git' \\", "            --exclude='.last-update-report.md' \\", "            --exclude='.last-updated.json' \\", "            --exclude='config.json' \\", "            \"$GITHUB_WORKSPACE/.wiki/\" ./", "          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");
 }
 /**
  * Generates a markdown report of what changed during this run.

package/dist/cli.js

@@ -9,7 +9,7 @@ import { getHelpText } from "./prompt.js";
 import { App } from "./tui/App.js";
 const execAsync = promisify(exec);
 function parseArgs(argv) {
-    const args = { command: null, print: false, verbose: false, help: false };
+    const args = { command: null, print: false, verbose: false, wiki: false, help: false };
     for (let i = 2; i < argv.length; i++) {
         const arg = argv[i];
         switch (arg) {
@@ -26,6 +26,9 @@ function parseArgs(argv) {
             case "-v":
                 args.verbose = true;
                 break;
+            case "--wiki":
+                args.wiki = true;
+                break;
             case "--model":
                 args.model = argv[++i];
                 break;
@@ -49,7 +52,7 @@ async function getGitSummary(cwd) {
         return "(git not available or not a git repository)";
     }
 }
-async function runHeadless(command, cwd, model, verbose) {
+async function runHeadless(command, cwd, model, verbose, wiki) {
     const config = await resolveConfig(cwd, model);
     const client = createOllamaClient(config);
     const gitSummary = await getGitSummary(cwd);
@@ -58,6 +61,7 @@ async function runHeadless(command, cwd, model, verbose) {
         projectRoot: cwd,
         model: config.model,
         gitSummary,
+        wikiPublish: wiki,
         stream: false,
         onEvent: (event) => {
             switch (event.type) {
@@ -95,7 +99,7 @@ async function main() {
         process.exit(1);
     }
     if (args.print) {
-        await runHeadless(command, cwd, config.model, args.verbose);
+        await runHeadless(command, cwd, config.model, args.verbose, args.wiki);
     }
     else {
         const { waitUntilExit } = inkRender(React.createElement(App, {
@@ -103,6 +107,7 @@ async function main() {
             cwd,
             config,
             verbose: args.verbose,
+            wiki: args.wiki,
         }));
         await waitUntilExit();
     }

package/dist/prompt.js

@@ -121,6 +121,7 @@ Usage
   wiki --update --print          Headless update (non-interactive)
   wiki --init --print --model <id>   Specify model
   wiki --update --print --verbose    Headless update with full tool logs
+  wiki --update --print --wiki       Update and publish to the GitHub Wiki tab
   wiki --help                     Show this help
 
 Options
@@ -129,6 +130,7 @@ Options
   --print         Run headless (non-interactive, output to stdout)
   --verbose, -v   Show full tool call results (default: assistant prose only)
   --model <id>    Override the model ID
+  --wiki          Publish to the GitHub Wiki tab (generates wiki-publish workflow)
   --help, -h      Show help
 
 Environment variables

package/dist/tui/App.d.ts

@@ -5,6 +5,7 @@ interface AppProps {
     cwd: string;
     config: ResolvedConfig;
     verbose: boolean;
+    wiki: boolean;
 }
-export declare function App({ command, cwd, config, verbose }: AppProps): React.ReactElement;
+export declare function App({ command, cwd, config, verbose, wiki }: AppProps): React.ReactElement;
 export {};

package/dist/tui/App.js

@@ -2,7 +2,7 @@ import React, { useState, useCallback } from "react";
 import { Box, Text, useApp, useInput } from "ink";
 import { CredentialsSetup } from "./CredentialsSetup.js";
 import { RunView } from "./RunView.js";
-export function App({ command, cwd, config, verbose }) {
+export function App({ command, cwd, config, verbose, wiki }) {
     const [needsSetup, setNeedsSetup] = useState(config.mode === "cloud" && !config.apiKey);
     const [resolvedConfig, setResolvedConfig] = useState(config);
     const { exit } = useApp();
@@ -26,6 +26,7 @@ export function App({ command, cwd, config, verbose }) {
         cwd,
         config: resolvedConfig,
         verbose,
+        wiki,
         onExit: exit,
     }));
 }

package/dist/tui/RunView.d.ts

@@ -6,7 +6,8 @@ interface RunViewProps {
     cwd: string;
     config: ResolvedConfig;
     verbose: boolean;
+    wiki: boolean;
     onExit: () => void;
 }
-export declare function RunView({ command, cwd, config, verbose, onExit, }: RunViewProps): React.ReactElement;
+export declare function RunView({ command, cwd, config, verbose, wiki, onExit, }: RunViewProps): React.ReactElement;
 export {};

package/dist/tui/RunView.js

@@ -2,7 +2,7 @@ import React, { useState, useEffect, useRef } from "react";
 import { Box, Text, useApp } from "ink";
 import { runAgent } from "../agent.js";
 import { createOllamaClient } from "../config.js";
-export function RunView({ command, cwd, config, verbose, onExit, }) {
+export function RunView({ command, cwd, config, verbose, wiki, onExit, }) {
     const [events, setEvents] = useState([]);
     const [running, setRunning] = useState(true);
     const [error, setError] = useState(null);
@@ -15,6 +15,7 @@ export function RunView({ command, cwd, config, verbose, onExit, }) {
             command,
             projectRoot: cwd,
             model: config.model,
+            wikiPublish: wiki,
             stream: true,
             onEvent: (event) => {
                 // Merge consecutive assistant chunks into one line so streaming

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chronova/wiki-agent",
-  "version": "1.2.2",
+  "version": "1.3.1",
   "description": "Standalone Ollama-only documentation agent",
   "type": "module",
   "bin": {