@openmnemo/report 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 openmnemo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/chunk-RCUFIYQZ.js

@@ -0,0 +1,14 @@
+// src/log.ts
+function getLogger() {
+  const prefix = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
+  return {
+    debug: (m) => console.debug(`${prefix()} [DEBUG] ${m}`),
+    info: (m) => console.info(`${prefix()} [INFO]  ${m}`),
+    warn: (m) => console.warn(`${prefix()} [WARN]  ${m}`),
+    error: (m) => console.error(`${prefix()} [ERROR] ${m}`)
+  };
+}
+
+export {
+  getLogger
+};

package/dist/github-pages-XPQKYB2E.js

@@ -0,0 +1,102 @@
+import {
+  getLogger
+} from "./chunk-RCUFIYQZ.js";
+
+// src/deploy/github-pages.ts
+import { cpSync, existsSync, mkdtempSync, readdirSync, rmSync, writeFileSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+import { execFileSync } from "child_process";
+var COMMIT_MESSAGE = "chore: publish memorytree report";
+var COMMITTER_NAME = "MemoryTree";
+var COMMITTER_EMAIL = "memorytree@local.invalid";
+var BRANCH_RE = /^[a-zA-Z0-9._/-]+$/;
+async function deployGithubPages(options) {
+  const { repoRoot, outputDir, branch, cname } = options;
+  const logger = getLogger();
+  if (!branch) return;
+  if (!BRANCH_RE.test(branch)) {
+    logger.warn(`[gh-pages] Invalid branch name, skipping deploy: "${branch}"`);
+    return;
+  }
+  if (!existsSync(outputDir)) {
+    logger.warn(`[gh-pages] Output directory does not exist, skipping deploy: ${outputDir}`);
+    return;
+  }
+  try {
+    if (cname) {
+      const cnamePath = join(outputDir, "CNAME");
+      writeFileSync(cnamePath, cname + "\n", "utf-8");
+      logger.info(`[gh-pages] CNAME written: ${cname}`);
+    }
+    const remoteUrl = git(repoRoot, "remote", "get-url", "origin").trim();
+    if (!remoteUrl) {
+      logger.warn("[gh-pages] No origin remote configured, skipping deploy.");
+      return;
+    }
+    const publishRoot = mkdtempSync(join(tmpdir(), "mt-gh-pages-"));
+    try {
+      git(publishRoot, "init");
+      git(publishRoot, "remote", "add", "origin", remoteUrl);
+      if (remoteBranchExists(publishRoot, branch)) {
+        logger.info(`[gh-pages] Updating existing origin/${branch} branch.`);
+        git(publishRoot, "fetch", "--depth", "1", "origin", branch);
+        git(publishRoot, "checkout", "-B", branch, "FETCH_HEAD");
+      } else {
+        logger.info(`[gh-pages] Branch '${branch}' not found, creating orphan publish branch.`);
+        git(publishRoot, "checkout", "--orphan", branch);
+      }
+      clearDirectory(publishRoot);
+      copyDirectoryContents(outputDir, publishRoot);
+      git(publishRoot, "add", "--all");
+      if (!hasPendingChanges(publishRoot)) {
+        logger.info(`[gh-pages] No changes to publish for origin/${branch}.`);
+        return;
+      }
+      git(
+        publishRoot,
+        "-c",
+        `user.name=${COMMITTER_NAME}`,
+        "-c",
+        `user.email=${COMMITTER_EMAIL}`,
+        "commit",
+        "-m",
+        COMMIT_MESSAGE
+      );
+      git(publishRoot, "push", "origin", `HEAD:${branch}`);
+      logger.info(`[gh-pages] Successfully pushed report to origin/${branch}`);
+    } finally {
+      rmSync(publishRoot, { recursive: true, force: true });
+    }
+  } catch (err) {
+    logger.warn(`[gh-pages] Deploy failed: ${String(err)}`);
+  }
+}
+function remoteBranchExists(cwd, branch) {
+  try {
+    git(cwd, "ls-remote", "--exit-code", "--heads", "origin", branch);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function clearDirectory(root) {
+  for (const entry of readdirSync(root)) {
+    if (entry === ".git") continue;
+    rmSync(join(root, entry), { recursive: true, force: true });
+  }
+}
+function copyDirectoryContents(source, destination) {
+  for (const entry of readdirSync(source)) {
+    cpSync(join(source, entry), join(destination, entry), { recursive: true, force: true });
+  }
+}
+function hasPendingChanges(cwd) {
+  return git(cwd, "status", "--short").trim().length > 0;
+}
+function git(cwd, ...args) {
+  return execFileSync("git", args, { cwd, stdio: "pipe" }).toString();
+}
+export {
+  deployGithubPages
+};

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Type definitions for the report generation subsystem.
+ */
+
+interface BuildReportOptions {
+    root: string;
+    output: string;
+    noAi?: boolean;
+    model?: string;
+    /** Build-time locale (e.g. 'en', 'zh-CN'). Default: 'en'. */
+    locale?: string;
+    /** gh-pages branch name. Empty string = skip deploy. Default: ''. */
+    ghPagesBranch?: string;
+    /** Custom domain for CNAME file. Empty string = skip. Default: ''. */
+    cname?: string;
+    /** Webhook URL for post-build notifications. Empty string = skip. Default: ''. */
+    webhookUrl?: string;
+    /** Session IDs newly imported in this heartbeat cycle (for webhook). */
+    newSessionIds?: string[];
+    /** Absolute base URL for RSS/OG links (e.g. 'https://memory.example.com'). Empty = skip. */
+    reportBaseUrl?: string;
+}
+
+/**
+ * Report build orchestrator.
+ * Generates a self-contained multi-page HTML website in Memory/07_reports/.
+ */
+
+declare function buildReport(options: BuildReportOptions): Promise<void>;
+
+export { type BuildReportOptions, buildReport };