docs: share bilingual DevsLab publisher attribution

.github/workflows/publisher.yml

@@ -0,0 +1,17 @@
+name: Publisher attribution
+on:
+  pull_request:
+  push:
+    branches: [main]
+permissions:
+  contents: read
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - run: npm ci --prefix tools/publisher --ignore-scripts
+      - run: npm run check --prefix tools/publisher

README.ko.md

@@ -1,5 +1,9 @@
 # FlowLinq
 
+<!-- publisher:start -->
+Published by [데브스랩(DevsLab)](https://devslab.kr/).
+<!-- publisher:end -->
+
 🌐 [English](README.md)
 
 **AI-powered Document Operations Platform — 인도 SMB를 위한 WhatsApp-native EDMS.**

README.md

@@ -1,5 +1,9 @@
 # FlowLinq
 
+<!-- publisher:start -->
+Published by [데브스랩(DevsLab)](https://devslab.kr/).
+<!-- publisher:end -->
+
 🌐 [한국어](README.ko.md)
 
 **AI-powered Document Operations Platform — WhatsApp-native EDMS for Indian SMBs.**

tools/publisher/.gitignore

@@ -0,0 +1 @@
+node_modules/

tools/publisher/README.md

@@ -0,0 +1,9 @@
+# Publisher attribution
+
+Documentation-only tooling; this dependency is not shipped with the library.
+
+`npm ci --prefix tools/publisher` installs the pinned shared publisher helper.
+`npm run sync --prefix tools/publisher` regenerates the marked README and public HTML attribution from `@devslab/site-kit/devslab`.
+`npm run check --prefix tools/publisher` detects drift without writing files.
+
+Edit the product URL or repository in `config.json`; update the shared preset in site-kit for company-wide identity changes. Do not hand-edit generated publisher blocks.

tools/publisher/config.json

@@ -0,0 +1,12 @@
+{
+  "name": "flowlinq",
+  "kind": "readme",
+  "url": "https://github.com/devslab-kr/flowlinq",
+  "repository": "https://github.com/devslab-kr/flowlinq",
+  "pages": [],
+  "readmes": [
+    "README.md",
+    "README.ko.md"
+  ],
+  "attributionLabel": "Published by"
+}

tools/publisher/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "flowlinq-publisher-docs",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "sync": "node sync.mjs",
+    "check": "node sync.mjs --check"
+  },
+  "devDependencies": {
+    "@devslab/site-kit": "0.8.0"
+  }
+}

tools/publisher/sync.mjs

@@ -0,0 +1,50 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { buildPublisher, renderPublisherHtml, serializeJsonLd } from "@devslab/site-kit";
+import { DEVSLAB_PUBLISHER } from "@devslab/site-kit/devslab";
+
+const root = new URL("../../", import.meta.url);
+const config = JSON.parse(await readFile(new URL("./config.json", import.meta.url), "utf8"));
+const check = process.argv.includes("--check");
+const { link, reference } = buildPublisher(DEVSLAB_PUBLISHER);
+const start = "<!-- publisher:start -->";
+const end = "<!-- publisher:end -->";
+const markdown = `${start}\n${config.attributionLabel ?? "Open source by"} [${link.label}](${link.href}).\n${end}`;
+const source = {
+  "@context": "https://schema.org",
+  "@type": "SoftwareSourceCode",
+  "@id": `${config.repository}#software`,
+  name: config.name,
+  url: config.url,
+  codeRepository: config.repository,
+  publisher: reference,
+};
+const html = `${start}\n<p class="publisher-attribution">Open source by ${renderPublisherHtml(DEVSLAB_PUBLISHER)}</p>\n<script type="application/ld+json">${serializeJsonLd(source)}</script>\n${end}`;
+
+async function update(relative, transform) {
+  const url = new URL(relative, root);
+  const current = (await readFile(url, "utf8").catch((error) => {
+    if (error.code === "ENOENT") return "";
+    throw error;
+  })).replaceAll("\r\n", "\n");
+  const next = transform(current);
+  if (current === next) return;
+  if (check) throw new Error(`Publisher output is stale: ${fileURLToPath(url)}; run npm run sync --prefix tools/publisher`);
+  await writeFile(url, next);
+}
+function replaceBlock(text, value) {
+  const from = text.indexOf(start);
+  const to = text.indexOf(end);
+  if (from < 0 || to < from) throw new Error("Missing publisher markers");
+  return text.slice(0, from) + value + text.slice(to + end.length);
+}
+for (const path of config.readmes ?? ["README.md", "README.ko.md"]) {
+  await update(path, (text) => replaceBlock(text, markdown));
+}
+if (config.kind === "mkdocs") {
+  await update("docs/overrides/publisher.html", () => html + "\n");
+}
+for (const path of config.pages) {
+  await update(path, (text) => replaceBlock(text, html));
+}
+console.log(check ? "Publisher output is current." : "Publisher output synchronized.");