Merge pull request #2 from agentcommunity/feat/dual-sources-rewrite

feat(rewrite): migrate docs to local-only dual sources (Community + A…

Author: nembal

.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": ["next/core-web-vitals", "next/typescript"]
+}

.gitignore

@@ -1,11 +1,41 @@
-site/
-venv/
-__pycache__/
-*.py[cod]
-*$py.class 
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
 .vercel
-NEXTSTEPS.md
-TODO.md
-@/.cache
-.cache
-/docs/aid
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+# temporary directories
+tmp-spec-repo/
+
+# external content (cloned during build)
+# (Removed: AID docs are now kept locally and tracked)

.source/index.ts

@@ -0,0 +1,31 @@
+// @ts-nocheck -- skip type checking
+import * as docs_11 from "../content/docs/aid/quickstart/quickstart_openapi.md?collection=docs&hash=1754756397453"
+import * as docs_10 from "../content/docs/aid/quickstart/quickstart_mcp.md?collection=docs&hash=1754756397453"
+import * as docs_9 from "../content/docs/aid/quickstart/quickstart_a2a.md?collection=docs&hash=1754756397453"
+import * as docs_8 from "../content/docs/aid/quickstart/index.md?collection=docs&hash=1754756397453"
+import * as docs_7 from "../content/docs/work-items/index.mdx?collection=docs&hash=1754756397453"
+import * as docs_6 from "../content/docs/aid/versioning.md?collection=docs&hash=1754756397453"
+import * as docs_5 from "../content/docs/aid/specification.md?collection=docs&hash=1754756397453"
+import * as docs_4 from "../content/docs/aid/security.md?collection=docs&hash=1754756397453"
+import * as docs_3 from "../content/docs/aid/rationale.md?collection=docs&hash=1754756397453"
+import * as docs_2 from "../content/docs/aid/index.md?collection=docs&hash=1754756397453"
+import * as docs_1 from "../content/docs/test.mdx?collection=docs&hash=1754756397453"
+import * as docs_0 from "../content/docs/index.mdx?collection=docs&hash=1754756397453"
+import * as aid_8 from "../content/docs/aid/quickstart/quickstart_openapi.md?collection=aid&hash=1754756397453"
+import * as aid_7 from "../content/docs/aid/quickstart/quickstart_mcp.md?collection=aid&hash=1754756397453"
+import * as aid_6 from "../content/docs/aid/quickstart/quickstart_a2a.md?collection=aid&hash=1754756397453"
+import * as aid_5 from "../content/docs/aid/quickstart/index.md?collection=aid&hash=1754756397453"
+import * as aid_4 from "../content/docs/aid/versioning.md?collection=aid&hash=1754756397453"
+import * as aid_3 from "../content/docs/aid/specification.md?collection=aid&hash=1754756397453"
+import * as aid_2 from "../content/docs/aid/security.md?collection=aid&hash=1754756397453"
+import * as aid_1 from "../content/docs/aid/rationale.md?collection=aid&hash=1754756397453"
+import * as aid_0 from "../content/docs/aid/index.md?collection=aid&hash=1754756397453"
+import * as blog_3 from "../content/blog/what_when_domain.mdx?collection=blog&hash=1754756397453"
+import * as blog_2 from "../content/blog/missing_record.mdx?collection=blog&hash=1754756397453"
+import * as blog_1 from "../content/blog/missing_grep_mcp.mdx?collection=blog&hash=1754756397453"
+import * as blog_0 from "../content/blog/finding_door_a2a.mdx?collection=blog&hash=1754756397453"
+import { _runtime } from "fumadocs-mdx"
+import * as _source from "../source.config"
+export const aid = _runtime.docs<typeof _source.aid>([{ info: {"path":"index.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/index.md"}, data: aid_0 }, { info: {"path":"rationale.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/rationale.md"}, data: aid_1 }, { info: {"path":"security.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/security.md"}, data: aid_2 }, { info: {"path":"specification.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/specification.md"}, data: aid_3 }, { info: {"path":"versioning.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/versioning.md"}, data: aid_4 }, { info: {"path":"quickstart/index.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/quickstart/index.md"}, data: aid_5 }, { info: {"path":"quickstart/quickstart_a2a.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/quickstart/quickstart_a2a.md"}, data: aid_6 }, { info: {"path":"quickstart/quickstart_mcp.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/quickstart/quickstart_mcp.md"}, data: aid_7 }, { info: {"path":"quickstart/quickstart_openapi.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/quickstart/quickstart_openapi.md"}, data: aid_8 }], [{"info":{"path":"meta.json","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/meta.json"},"data":{"title":"Agent Interface Discovery (AID)","pages":["index","rationale","quickstart","specification","versioning"],"icon":"globe"}}, {"info":{"path":"quickstart/meta.json","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/quickstart/meta.json"},"data":{"title":"Quickstart","pages":["index","quickstart_mcp","quickstart_a2a","quickstart_openapi"],"icon":"rocket"}}])
+export const blog = _runtime.docs<typeof _source.blog>([{ info: {"path":"finding_door_a2a.mdx","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/blog/finding_door_a2a.mdx"}, data: blog_0 }, { info: {"path":"missing_grep_mcp.mdx","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/blog/missing_grep_mcp.mdx"}, data: blog_1 }, { info: {"path":"missing_record.mdx","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/blog/missing_record.mdx"}, data: blog_2 }, { info: {"path":"what_when_domain.mdx","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/blog/what_when_domain.mdx"}, data: blog_3 }], [{"info":{"path":"meta.json","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/blog/meta.json"},"data":{"title":"Blog","pages":["index"]}}])
+export const docs = _runtime.docs<typeof _source.docs>([{ info: {"path":"index.mdx","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/index.mdx"}, data: docs_0 }, { info: {"path":"test.mdx","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/test.mdx"}, data: docs_1 }, { info: {"path":"aid/index.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/index.md"}, data: docs_2 }, { info: {"path":"aid/rationale.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/rationale.md"}, data: docs_3 }, { info: {"path":"aid/security.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/security.md"}, data: docs_4 }, { info: {"path":"aid/specification.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/specification.md"}, data: docs_5 }, { info: {"path":"aid/versioning.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/versioning.md"}, data: docs_6 }, { info: {"path":"work-items/index.mdx","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/work-items/index.mdx"}, data: docs_7 }, { info: {"path":"aid/quickstart/index.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/quickstart/index.md"}, data: docs_8 }, { info: {"path":"aid/quickstart/quickstart_a2a.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/quickstart/quickstart_a2a.md"}, data: docs_9 }, { info: {"path":"aid/quickstart/quickstart_mcp.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/quickstart/quickstart_mcp.md"}, data: docs_10 }, { info: {"path":"aid/quickstart/quickstart_openapi.md","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/quickstart/quickstart_openapi.md"}, data: docs_11 }], [{"info":{"path":"meta.json","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/meta.json"},"data":{"title":".agent Community","pages":["index","work-items"],"icon":"book"}}, {"info":{"path":"aid/meta.json","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/meta.json"},"data":{"title":"Agent Interface Discovery (AID)","pages":["index","rationale","quickstart","specification","versioning"],"icon":"globe"}}, {"info":{"path":"aid/quickstart/meta.json","absolutePath":"/Users/user/dev/side-projects/AgentCommunity/docs/content/docs/aid/quickstart/meta.json"},"data":{"title":"Quickstart","pages":["index","quickstart_mcp","quickstart_a2a","quickstart_openapi"],"icon":"rocket"}}])

.source/source.config.mjs

@@ -0,0 +1,99 @@
+// source.config.ts
+import {
+  defineConfig,
+  defineDocs,
+  frontmatterSchema,
+  metaSchema
+} from "fumadocs-mdx/config";
+import { z } from "zod";
+
+// lib/remark/mermaid-to-component.js
+function remarkMermaidToComponent() {
+  return (tree) => {
+    visit(tree, "code", (node, index, parent) => {
+      if (!parent || index == null) return;
+      if (node.lang !== "mermaid") return;
+      const mdxJsxNode = {
+        type: "mdxJsxFlowElement",
+        name: "Mermaid",
+        attributes: [
+          {
+            type: "mdxJsxAttribute",
+            name: "chart",
+            value: node.value
+          }
+        ],
+        children: []
+      };
+      parent.children.splice(index, 1, mdxJsxNode);
+    });
+  };
+}
+function visit(node, type, callback, index = null, parent = null) {
+  if (!node) return;
+  const isType = node.type === type;
+  if (isType) callback(node, index, parent);
+  const children = node.children || [];
+  for (let i = 0; i < children.length; i++) {
+    visit(children[i], type, callback, i, node);
+  }
+}
+
+// source.config.ts
+var blogSchema = frontmatterSchema.extend({
+  author: z.string().optional(),
+  date: z.string().datetime().or(z.date()).optional(),
+  tags: z.array(z.string()).optional()
+});
+var docs = defineDocs({
+  dir: "content/docs",
+  docs: {
+    schema: frontmatterSchema
+  },
+  meta: {
+    // allow optional Lucide icon name in meta.json
+    schema: metaSchema.extend({ icon: z.string().optional() })
+  }
+});
+var aidFrontmatterSchema = frontmatterSchema.extend({
+  icon: z.string().optional(),
+  edit_url: z.string().url().optional(),
+  extra_css_class: z.string().optional(),
+  tags: z.array(z.string()).optional()
+});
+var aid = defineDocs({
+  dir: "content/docs/aid",
+  docs: {
+    schema: aidFrontmatterSchema
+  },
+  meta: {
+    // allow optional Lucide icon name in meta.json
+    schema: metaSchema.extend({ icon: z.string().optional() })
+  }
+});
+var blog = defineDocs({
+  dir: "content/blog",
+  docs: {
+    schema: blogSchema
+  },
+  meta: {
+    schema: metaSchema
+  }
+});
+var source_config_default = defineConfig({
+  mdxOptions: {
+    remarkPlugins: [remarkMermaidToComponent],
+    rehypeCodeOptions: {
+      themes: {
+        light: "github-light",
+        dark: "github-dark"
+      }
+    }
+  }
+});
+export {
+  aid,
+  blog,
+  source_config_default as default,
+  docs
+};