project.json

{
  "projectName": "MyBlog",
  "canonicalDoc": "README.md",
  "machineReadableEntry": "project.json",
  "githubRepo": "https://github.com/emptyinkpot/emptyinkpot.github.io",
  "defaultBranch": "main",
  "localSourceRoot": null,
  "remoteIde": {
    "status": "canonical",
    "host": "ubuntu@124.220.233.126",
    "sourceRoot": "/srv/myblog/repo",
    "deploymentRoot": "/srv/myblog/site",
    "repoLocalSshKey": "/home/ubuntu/.ssh/myblog_source_ed25519",
    "repoLocalSshCommandRequired": true,
    "localCheckoutPolicy": "retired-local-mirror-only"
  },
  "siteAppRoot": "apps/web",
  "adminAppRoot": "apps/admin-next",
  "androidShellRoot": "apps/android-shell",
  "runtimeContractRoot": "packages/runtime-contract",
  "runtimeDatabaseApiContract": "contracts/runtime-database-api-contract.json",
  "runtimeConstitution": {
    "status": "active",
    "aiEntry": "AI_RULES.md",
    "frontendContractEntry": "project.frontend-runtime-contract.json",
    "contractsRoot": "contracts",
    "philosophyRoot": "philosophy",
    "topologyRoot": "topology",
    "adrRoot": "adr",
    "primaryModel": "Knowledge Runtime Surface",
    "coreRule": "Collection is context. Drawer is reading. Homepage is discovery.",
    "forbidden": [
      "turn collections into standalone CMS pages",
      "replace mixed-object homepage with collection grids",
      "make feed tabs route navigation",
      "put card walls inside reader drawers",
      "make topic collections prerender into static collection pages"
    ]
  },
  "objectModelRoot": "packages/object-model",
  "runtimeKernelRoot": "packages/runtime-kernel",
  "designSystemRoot": "packages/design-system",
  "activeArticleTruthRoot": "public-data/runtime/content-index.json",
  "vaultFileTruthRoot": "Windows:E:\\Vaults\\Obsidian",
  "authoringTruthRoot": "Windows:E:\\Vaults\\Obsidian",
  "serverHotMirrorRoot": "Linux:/home/vault/Obsidian",
  "publicContentAccessRoot": "/openlist/Obsidian",
  "contentControlPlaneRoot": "OpenList:/openlist/Obsidian",
  "openListLocalMount": "OpenList:/Obsidian -> Linux:/home/vault/Obsidian",
  "openListPublicRoots": [
    "/Obsidian",
    "/腾讯云COS",
    "/夸克网盘"
  ],
  "serverStorageBoundary": {
    "status": "active",
    "hotLayerRule": "Keep runtime, databases, Syncthing hot mirror, Astro dist, Pagefind, OpenList DB and /srv/myblog on the server local filesystem.",
    "coldLayerRule": "OpenList/COS/Quark are public access, blob backend, cold archive and content address space only; they are not an ext4/system disk replacement.",
    "maintenanceCommand": "npm run server:openlist-storage",
    "pruneCommand": "npm run server:openlist-storage -- --prune-openlist-file-cache --apply"
  },
  "coldArchiveBackends": [
    "Quark:/夸克网盘/ObsidianArchive",
    "Tencent COS:/腾讯云COS",
    "S3/WebDAV backends mounted through OpenList"
  ],
  "generatedRuntimeRoot": "/srv/myblog/site/runtime/content-index.json",
  "runtimeTruth": "MySQL via apps/admin-next",
  "canonicalStructuredContentPlatform": {
    "status": "optional-projection",
    "owner": "DataBase",
    "gatewayEndpoint": "POST /writes/project-obsidian-markdown",
    "enableEnv": "MYBLOG_DATABASE_CANONICAL_PROJECTION=1",
    "gatewayUrlEnv": "MYBLOG_DATABASE_GATEWAY_URL",
    "apiKeyEnv": "MYBLOG_DATABASE_GATEWAY_API_KEY",
    "sourceRule": "Obsidian/Vault remains Markdown file truth; DataBase owns structured identity, blocks, assets and relations.",
    "myblogRole": "projection client and public rendering shell only",
    "forbidden": [
      "direct DataBase MySQL access from MyBlog canonical content projection",
      "MyBlog-owned shadow content work registry",
      "local DataBase schema copies",
      "silent fallback when DataBase projection is enabled"
    ]
  },
  "fileTruth": "Windows Vault synced to Linux hot mirror and exposed through OpenList",
  "contentRoots": [
    "apps/web/src/content/notes",
    "apps/web/src/content/projects",
    "apps/web/src/content/pages",
    "public-data/evidence-library"
  ],
  "buildOutputRoot": "apps/web/dist",
  "docsEntrypoints": {
    "frontendReadme": "apps/web/README.md",
    "architectureCodex": "apps/web/src/data/architectureCodex.ts",
    "frontendRuntimeAudit": "docs/frontend-runtime-audit.md",
    "frontendRuntimeConvergence": "docs/frontend-runtime-convergence.md",
    "runtimeExperienceLayer": "docs/runtime-experience-layer.md",
    "planDoc": "docs/plans/update-plan.md",
    "adminP0Checklist": "docs/plans/admin-next-p0-checklist.md",
    "architectureChecklist": "docs/architecture/astro-blog-redesign-checklist.md",
    "maintenanceLog": "docs/maintenance/astro-redesign-execution-log.md"
  },
  "sourceOfTruthMap": {
    "gitRepo": "https://github.com/emptyinkpot/emptyinkpot.github.io",
    "localActiveSourceRoot": null,
    "vaultFileTruthRoot": "Windows:E:\\Vaults\\Obsidian",
    "authoringTruthRoot": "Windows:E:\\Vaults\\Obsidian",
    "serverHotMirrorRoot": "Linux:/home/vault/Obsidian",
    "publicContentAccessRoot": "/openlist/Obsidian",
    "contentControlPlaneRoot": "OpenList:/openlist/Obsidian",
    "openListLocalMount": "OpenList:/Obsidian -> Linux:/home/vault/Obsidian",
    "openListPublicRoots": [
      "/Obsidian",
      "/腾讯云COS",
      "/夸克网盘"
    ],
    "serverStorageBoundary": {
      "status": "active",
      "hotLayerRule": "Keep runtime, databases, Syncthing hot mirror, Astro dist, Pagefind, OpenList DB and /srv/myblog on the server local filesystem.",
      "coldLayerRule": "OpenList/COS/Quark are public access, blob backend, cold archive and content address space only; they are not an ext4/system disk replacement.",
      "maintenanceCommand": "npm run server:openlist-storage",
      "pruneCommand": "npm run server:openlist-storage -- --prune-openlist-file-cache --apply"
    },
    "coldArchiveBackendRoots": [
      "Quark:/夸克网盘/ObsidianArchive",
      "Tencent COS:/腾讯云COS"
    ],
    "generatedRuntimeRoot": "/srv/myblog/site/runtime/content-index.json",
    "activeArticleTruthRoot": "public-data/runtime/content-index.json",
    "runtimeTruth": "MySQL via apps/admin-next",
    "canonicalStructuredContentPlatform": {
      "owner": "DataBase",
      "gatewayEndpoint": "POST /writes/project-obsidian-markdown",
      "projectionClient": "tools/server-runtime-content-projector.mjs",
      "projectionBuildSource": "tools/build-runtime-content-index.mjs",
      "enableEnv": "MYBLOG_DATABASE_CANONICAL_PROJECTION=1",
      "gatewayUrlEnv": "MYBLOG_DATABASE_GATEWAY_URL",
      "apiKeyEnv": "MYBLOG_DATABASE_GATEWAY_API_KEY"
    },
    "fileTruth": "Windows Vault synced to Linux hot mirror and exposed through OpenList",
    "runtimeContractRoot": "packages/runtime-contract",
    "objectModelRoot": "packages/object-model",
    "runtimeKernelRoot": "packages/runtime-kernel",
    "designSystemRoot": "packages/design-system",
    "objectStorageTruth": "Tencent COS bucket myblog-media-1410041307 mounted in OpenList at /腾讯云COS",
    "buildOutputRoot": "apps/web/dist",
    "serverRuntimeRoot": "/srv/myblog/site",
    "remoteFirstSourceRoot": "ubuntu@124.220.233.126:/srv/myblog/repo",
    "retiredLocalSourceRoot": "E:\\My Project\\MyBlog",
    "remoteIde": {
      "host": "ubuntu@124.220.233.126",
      "sourceRoot": "/srv/myblog/repo",
      "deploymentRoot": "/srv/myblog/site",
      "repoLocalSshKey": "/home/ubuntu/.ssh/myblog_source_ed25519",
      "gitRemote": "git@github.com:emptyinkpot/emptyinkpot.github.io.git",
      "sshOutageRule": "Do not promote a local checkout to canonical when SSH is unavailable; use GitHub as a delivery surface and reconcile the server source root after recovery."
    },
    "runtimeDatabase": {
      "status": "active",
      "type": "Tencent Cloud CynosDB Serverless MySQL",
      "clusterId": "cynosdbmysql-no0zqua0",
      "engine": "MySQL 8.0",
      "publicEndpoint": "124.220.245.121:22295",
      "privateEndpoint": "172.17.0.3:3306",
      "privateEndpointStatus": "not-routable-from-current-lighthouse-as-of-2026-05-10",
      "database": "cloudbase-4glvyyq9f61b19cd",
      "user": "openclaw",
      "secretSource": "/etc/myblog-admin-next.env",
      "serviceOwner": "apps/admin-next",
      "schemaOwner": "apps/admin-next/lib/runtime-db.js",
      "connectionEnv": [
        "MYBLOG_DB_HOST",
        "MYBLOG_DB_PORT",
        "MYBLOG_DB_USER",
        "MYBLOG_DB_PASSWORD",
        "MYBLOG_DB_NAME"
      ],
      "activeTables": [
        "reader_memory",
        "reader_highlights",
        "visual_sources",
        "visual_pins",
        "visual_sync_runs",
        "personal_secret_entries"
      ],
      "owns": [
        "reader progress and last-read state",
        "reader highlights and anchors",
        "visual source registry",
        "visual pin runtime index",
        "visual sync run logs"
      ],
      "forbidden": [
        "article markdown body source",
        "EPUB/PDF/image/video blobs",
        "OpenList file objects",
        "Tencent COS objects",
        "Quark netdisk files",
        "Astro dist or Pagefind output",
        "Syncthing hot mirror files"
      ],
      "integrationRole": "dynamic runtime state layer beside OpenList/COS/Quark file storage and Obsidian content truth"
    },
    "plaintextPersonalSecretStore": {
      "status": "active-schema",
      "table": "personal_secret_entries",
      "valueColumn": "secret_value",
      "storageMode": "plaintext-by-user-requirement",
      "purpose": "store personal account/password/API-key style information directly in MySQL as readable text",
      "owner": "apps/admin-next / MySQL Runtime Layer",
      "database": "cloudbase-4glvyyq9f61b19cd",
      "warning": "Values are intentionally stored as plaintext in MySQL; do not commit real values to Git or logs."
    },
    "productionSourceRoot": "ubuntu@124.220.233.126:/srv/myblog/repo",
    "remoteIntegrationRoot": "server-170:/home/ubuntu/workspaces/MyBlog-production-integration",
    "productionSiteRoot": "/srv/myblog/site",
    "githubProductionBackupBranch": "backup/production-myblog-source-20260510",
    "githubProductionBackupPr": "https://github.com/emptyinkpot/emptyinkpot.github.io/pull/42"
  },
  "stabilizationSprint": {
    "status": "active",
    "mode": "reduction-not-feature-sprint",
    "thesis": "Stabilize the base before activating more runtimes. AppFlowy, Immich, Directus and Meilisearch remain target/skeleton services until file truth, MarkdownObject schema and Quartz runtime layer are stable.",
    "priorityOrder": [
      "Syncthing or Obsidian Sync of complete vault into Linux:/home/vault/Obsidian hot mirror",
      "Linux Vault hot mirror layout stability: /home/vault/Obsidian/docs, /home/vault/Obsidian/image, .obsidian and attachments",
      "MarkdownObject schema freeze and validation",
      "tools/build-runtime-content-index.mjs refactor as the CMS kernel",
      "Quartz 4 / Flowershow runtime layer evaluation for wikilink, backlink, graph, callout and semantic markdown",
      "AppFlowy collaboration runtime evaluation after the above are stable"
    ],
    "matureSubstratePolicy": [
      "Syncthing",
      "Quartz 4 / Flowershow",
      "Meilisearch",
      "Immich",
      "Payload / Directus"
    ],
    "glueOnlyRule": "MyBlog only writes glue, projection, and runtime contracts; it does not reimplement sync, markdown compiler, graph engine, search engine, media runtime, or CMS backends.",
    "frozenTargetRuntimes": {
      "appflowyCloud": {
        "status": "skeleton-installed-target-not-deployed",
        "serverRoot": "/srv/myblog/services/appflowy-cloud",
        "allowStart": false
      },
      "immich": {
        "status": "skeleton-installed-not-started",
        "allowStart": false
      },
      "directus": {
        "status": "target-not-deployed",
        "allowStart": false
      },
      "meilisearch": {
        "status": "target-not-deployed",
        "allowStart": false
      }
    },
    "forbidden": [
      "start AppFlowy Cloud containers during this sprint",
      "start Immich, Directus or Meilisearch during this sprint",
      "add new pages, overlays, feeds, graphs or AI runtimes",
      "continue expanding Project Workbench into a bespoke collaboration suite",
      "claim a target/skeleton service is active before readiness gate and source alignment"
    ],
    "allowedWork": [
      "Syncthing/Linux Vault readiness and docs",
      "MarkdownObject schema and validation",
      "runtime content index refactor",
      "Quartz/Flowershow capability evaluation",
      "documentation and machine-readable authority cleanup"
    ]
  },
  "contentInfrastructureReduction": {
    "status": "target-policy-active",
    "displayName": "Content Infrastructure Reduction",
    "mode": "reduce-bespoke-content-infrastructure",
    "thesis": "MyBlog has crossed from blog code into content infrastructure. Do not expand bespoke runtime JSON, giant runtime JSON, watcher, RSS, projection, search or deploy glue when mature substrates can own those jobs.",
    "activeNow": {
      "articleProjection": "Runtime MarkdownObject index at public-data/runtime/content-index.json and /srv/myblog/site/runtime/content-index.json",
      "search": "Pagefind static archive search plus runtime feed filtering; not unified full-site dynamic search",
      "deploy": "npm run deploy:site",
      "storage": "Linux hot mirror plus OpenList/COS/Quark cold/blob/public browse boundary",
      "openListBoundary": "OpenList exposes /Obsidian and cold/blob mounts; it does not own runtime build, projection, search, database, Pagefind, Astro dist, Syncthing hot mirror or node_modules"
    },
    "targetCandidates": {
      "quartz": {
        "status": "candidate-not-integrated",
        "role": "Obsidian digital garden substrate for Markdown pipeline, wikilinks, backlinks, graph, RSS, search and content index ideas",
        "mustNotClaim": "active site engine"
      },
      "contentlayer": {
        "status": "candidate-not-installed",
        "role": "Astro-native typed content schema, parsing, watch and projection replacement candidate",
        "mustNotClaim": "active content pipeline"
      },
      "meilisearch": {
        "status": "target-not-deployed",
        "role": "dynamic object, OpenList file, metadata and semantic search runtime",
        "currentFallback": "Pagefind remains static archive search"
      },
      "coolify": {
        "status": "candidate-not-deployed",
        "role": "deployment platform candidate for Git deploy, env, healthcheck, rollback, cron and compose",
        "currentFallback": "npm run deploy:site"
      }
    },
    "forbidden": [
      "grow content-index.json into a database or search engine",
      "add new bespoke watcher, RSS race workaround, build sync, deploy wrapper or projection governance layer before evaluating Quartz/Contentlayer/Meilisearch/Coolify",
      "claim Quartz, Contentlayer, Meilisearch or Coolify are active before integration or service readiness evidence",
      "let OpenList participate in runtime build, projection authority or hot storage"
    ]
  },
  "workspaceFederation": {
    "status": "active",
    "thesis": "Multiple workspaces are allowed, but authority is capability-based and machine-checked before deployment.",
    "manifest": "workspace.manifest.json",
    "profilesRoot": "workspaces",
    "guardScript": "tools/deploy-guard.mjs",
    "deployScript": "tools/deploy-static-site.mjs",
    "checkCommand": "npm run check:workspace",
    "deployCommand": "npm run deploy:site",
    "currentDeployAuthority": {
      "workspaceId": "myblog-canonical-active",
      "workspaceType": "canonical",
      "root": "/srv/myblog/repo",
      "deploymentAuthority": true
    },
    "profiles": {
      "canonical": {
        "profile": "workspaces/canonical.json",
        "defaultRoot": "/srv/myblog/repo",
        "deploymentAuthority": true,
        "capabilities": [
          "build",
          "deploy",
          "runtime",
          "schema",
          "pwa",
          "openlist-authority",
          "search-index"
        ]
      },
      "experimental": {
        "profile": "workspaces/experimental.json",
        "defaultRootPattern": "C:\\Users\\ASUS-KL\\.codex-runtime\\worktrees\\*",
        "deploymentAuthority": false,
        "capabilities": [
          "build",
          "preview",
          "frontend-ui",
          "feed-ui",
          "drawer-ui",
          "animations",
          "visual-prototype",
          "codex-draft"
        ],
        "forbidden": [
          "deployment",
          "pwa",
          "runtime-books",
          "runtime-schema",
          "openlist-authority",
          "server-runtime"
        ]
      },
      "sandbox": {
        "profile": "workspaces/sandbox.json",
        "deploymentAuthority": false,
        "capabilities": [
          "prototype",
          "research",
          "throwaway-demo"
        ],
        "forbidden": [
          "deployment",
          "pwa",
          "runtime-books",
          "runtime-schema",
          "openlist-authority",
          "server-runtime",
          "production-content"
        ]
      }
    },
    "rules": [
      "workspace existence is not authority",
      "deploys must run through npm run deploy:site or at least tools/deploy-guard.mjs",
      "do not hand-run scp to /srv/myblog/site from an unchecked workspace",
      ".codex-runtime worktrees are experimental by default and cannot deploy",
      "production promotion means moving changes back into a workspace with the required capability"
    ],
    "incidentReference": "2026-05-07 stale .codex-runtime worktree deploy regression"
  },
  "contentPipeline": {
    "status": "Runtime MarkdownObject projection active; Syncthing syncs the complete Windows E:\\Vaults\\Obsidian vault to Linux /home/vault/Obsidian, OpenList exposes public content at /openlist/Obsidian, and Windows watcher/scp content sync is disabled",
    "contentSourceBase": {
      "fileTruth": "Windows:E:\\Vaults\\Obsidian",
      "serverHotMirror": "Linux:/home/vault/Obsidian",
      "publicContentAccess": "/openlist/Obsidian",
      "fileMapping": "OpenList public access layer",
      "frontendIndex": "public-data/runtime/content-index.json",
      "presentationShell": "Astro apps/web",
      "rule": "Vault decides files; Runtime MarkdownObject projection decides public article objects; current tags/categories are filesystem/frontmatter/wikilink derived taxonomy, not AI semantic ontology; KnowledgeCollection buffers objects as Reading Sessions before homepage surfaces; frontend cards only read generated card metadata"
    },
    "vaultFileTruth": "Windows:E:\\Vaults\\Obsidian",
    "vaultSync": {
      "status": "active",
      "currentObsidianSideOwner": "Syncthing",
      "localVaultRoot": "Windows:E:\\Vaults\\Obsidian",
      "serverOwner": "Syncthing",
      "serverService": "syncthing@ubuntu.service",
      "transport": [
        "file-system sync",
        "server-local Linux Vault"
      ],
      "targetRoot": "Linux:/home/vault/Obsidian",
      "folders": [
        {
          "id": "obsidian-vault",
          "localPath": "E:\\Vaults\\Obsidian",
          "serverPath": "/home/vault/Obsidian",
          "type": "sendreceive",
          "lastVerified": "2026-05-07",
          "verification": "idle on both peers; needBytes=0; create/modify/delete acceptance passed"
        }
      ],
      "syncScope": [
        "docs",
        "image",
        ".obsidian",
        "canvas",
        "pdf",
        "attachments"
      ],
      "forbidden": [
        "MyBlog one-off image upload as vault sync",
        "visual-manifest as vault attachment truth",
        "storing WebDAV credentials in source, README, logs or frontend bundle"
      ]
    },
    "authoringTruth": "Windows:E:\\Vaults\\Obsidian",
    "projectorInput": "Linux:/home/vault/Obsidian/docs",
    "publicContentAccess": "/openlist/Obsidian/docs",
    "gitMirror": "content-vault working copy target; path not created as active source yet",
    "cmsPriority": [
      "TinaCMS",
      "Decap CMS"
    ],
    "cmsRule": "choose one CMS in P1; CMS edits must commit/write back to the vault working copy, not to MySQL or dist",
    "activeArticleTruth": "public-data/runtime/content-index.json",
    "runtimeProjectionTruth": "public-data/runtime/content-index.json",
    "runtimeFeatureRegistry": "public-data/runtime/features.json",
    "runtimeScript": "tools/build-runtime-content-index.mjs",
    "commands": {
      "runtimeIndex": "npm run runtime:content -- --vault <path>",
      "vaultSyncCheck": "npm run check:vault-sync",
      "serverRuntimeProjector": "npm run runtime:content:server",
      "deprecatedWindowsSync": "removed from package scripts; old tools/watch-obsidian-home-sync.mjs and tools/sync-runtime-content-index.mjs must not be used"
    },
    "pipeline": [
      "Obsidian local vault",
      "Syncthing",
      "Linux /home/vault/Obsidian runtime hot mirror",
      "OpenList /openlist/Obsidian content control plane and public identity",
      "server-side Runtime MarkdownObject projector",
      "Feed/Reader/Search/Graph projection",
      "optional Git mirror",
      "optional TinaCMS or Decap CMS"
    ],
    "runtimeProjection": {
      "objectType": "MarkdownObject",
      "collectionType": "KnowledgeCollection",
      "taxonomyMode": {
        "status": "active",
        "mode": "filesystem-frontmatter-wikilink-derived",
        "semanticAuthority": false,
        "sources": [
          "frontmatter.tags",
          "frontmatter.categories",
          "frontmatter.keywords",
          "frontmatter.topics",
          "filesystem.folderTags",
          "obsidian.wikilinks"
        ],
        "rule": "Do not describe current tags/categories as AI semantic tagging, ontology, embeddings, clusters or knowledge graph truth."
      },
      "semanticPipeline": {
        "status": "active-sidecar-generator",
        "runtime": "mortis-glm-openai-compatible",
        "lastProviderCheck": "2026-05-08 cloud sub2api coze-glm-shell key generated one valid sidecar and runtime projection read it as semantic.status=active",
        "command": "npm run semantic:sidecars -- --limit 1",
        "sidecarPattern": "*.semantic.json",
        "allowedFields": [
          "entities",
          "topics",
          "relations",
          "collections",
          "clusters",
          "model",
          "generatedAt"
        ],
        "writePolicy": "semantic pipeline may write sidecar projection only; it must never rewrite Markdown body or frontmatter and must never override explicit tags/categories",
        "candidateReferences": [
          "Atomic",
          "Blinko",
          "NoteGen"
        ]
      },
      "schema": {
        "required": [
          "id",
          "slug",
          "title",
          "sourcePath",
          "openlistPath",
          "openlistUrl",
          "sourceRoot",
          "kind",
          "categories",
          "tags",
          "folderTags",
          "derivedTaxonomy",
          "semantic",
          "visibility",
          "published",
          "runtimeFeed",
          "relations",
          "card"
        ],
        "sourceRoot": "vault",
        "kindDerivation": "frontmatter.kind, then docs folder mapping: blog/post, notes/note, papers or 论文/paper, projects/project, books/book-note, codex/codex",
        "visibilityDerivation": "frontmatter.visibility/private/draft plus private and drafts path guards",
        "relations": "wikilinks, backlinks and assets normalized during content-index compile",
        "card": "card.eyebrow, card.chips and card.subtitle are generated by the index compiler from categories, tags, project and series"
      },
      "collectionSchema": {
        "basis": [
          "folder",
          "series",
          "topic"
        ],
        "required": [
          "id",
          "type",
          "title",
          "description",
          "basis",
          "objects",
          "relations",
          "tags",
          "layout",
          "projections",
          "card",
          "stats"
        ],
        "generation": "tools/build-runtime-content-index.mjs groups MarkdownObject into folder collections, frontmatter series collections and shared topic collections",
        "surfaceRule": "homepage is a mixed-object runtime surface and may include folder/series KnowledgeCollection lens cards without becoming collection-first or collection-only; a collection card only opens a Reading Session drawer; /collections/ lists folder/series collection entry points; /collections/[slug]/ is only generated for folder/series Reading Session surfaces with article reader plus collection TOC; topic collections remain metadata/search/Graph dimensions in the runtime index and must not be batch prerendered into static collection pages; object switching inside a collection must not full reload or degrade into an object card grid"
      },
      "filter": [
        "draft != true",
        "published != false",
        "visibility is public",
        "default include all Markdown under /home/vault/Obsidian/docs unless blocked by draft/private rules"
      ],
      "route": "/posts/[slug]/",
      "feedConsumer": [
        "apps/web/src/pages/index.astro",
        "apps/web/src/pages/posts/index.astro"
      ],
      "indexFiles": [
        "public-data/runtime/content-index.json",
        "apps/web/public/runtime/content-index.json"
      ],
      "featureRegistryFiles": [
        "public-data/runtime/features.json",
        "apps/web/public/runtime/features.json"
      ],
      "homepageFeedUi": "Homepage is Runtime Surface v2: mixed-object masonry, feed tabs, drawer peek, search, OpenList/Pinterest shell and runtime refresh stay alive together. It may insert a small number of KnowledgeCollection lens cards, but must not become a Collection Gateway or collection-only feed. Collection drawer templates are Reading Sessions where current article html is the reading center and collection TOC is the context rail. Clicking another object swaps drawer article content from /runtime/articles/*.json without page navigation. /posts/ remains the article index and /posts/[slug]/ remains the permalink detail route. /runtime/events SSE is preferred and 30 second polling is only used when EventSource is unavailable",
      "runtimeReaderUi": "/posts/[slug]/ is the only public article detail route. It is generated from Runtime MarkdownObject metadata and reads the matching /runtime/articles/*.json detail payload for body/html/toc.",
      "cardUiRule": "ArticleCard, homepage runtime feed, /posts/ and /posts/[slug]/ display chips only from MarkdownObject.card.chips; tags/categories remain indexing metadata, not ad hoc card labels",
      "autoSyncWatcher": "deprecated: Windows watcher/scp content sync is disabled",
      "serverRuntimeProjector": "tools/server-runtime-content-projector.mjs runs as systemd myblog-runtime-content-projector.service on Linux, watches and scans /home/vault/Obsidian/docs, writes /srv/myblog/site/runtime/content-index.json with /openlist/Obsidian/docs public identity, and never runs Astro build/Pagefind/deploy/scp",
      "runtimeEvents": "tools/runtime-content-sse-server.mjs runs as systemd myblog-runtime-sse.service on 127.0.0.1:4121; nginx proxies /runtime/events; it only emits content-index events when the live JSON file changes",
      "syncOnlyRule": "Obsidian markdown edits sync as files into /home/vault/Obsidian; Linux projection updates only /srv/myblog/site/runtime/content-index.json and OpenList identity fields. Astro build, Pagefind, scp and deploy are reserved for shell code, route or static asset changes",
      "postsPageUi": "Runtime MarkdownObject articles are the only /posts/ listing source",
      "metadataUi": "Editorial metadata line; no badge/chip controls on runtime article metadata"
    },
    "folderMapping": {
      "folderTags": "path segments",
      "explicitTags": "frontmatter tags",
      "finalTags": "deduped folderTags + explicitTags",
      "collectionId": "parent folder path"
    },
    "inspirations": [
      "TinaCMS",
      "Decap CMS",
      "Quartz 4",
      "Flowershow",
      "Logseq Publish",
      "Obsidian Publish"
    ],
    "forbidden": [
      "treat Obsidian Vault as public site source",
      "treat OpenList as CMS",
      "treat MySQL as article body source",
      "run TinaCMS and Decap CMS as parallel editors",
      "edit apps/web/dist or /srv/myblog/site as content source"
    ]
  },
  "composableServiceStack": {
    "status": "target architecture documented; OpenList+COS is active, Immich skeleton is installed but not started, Directus and Meilisearch are not deployed",
    "thesis": "MyBlog is the presentation shell; mature services own files, AI media management, metadata curation and search",
    "presentationShell": {
      "service": "Astro/MyBlog",
      "status": "active",
      "role": "Feed, Drawer, Reader, Visual Collections, Graph and public routes; consumes APIs, snapshots, manifests and Astro content collections"
    },
    "fileTruth": {
      "service": "OpenList + Tencent COS",
      "status": "active",
      "openListMount": "/腾讯云COS",
      "bucket": "myblog-media-1410041307",
      "region": "ap-shanghai",
      "verifiedWriteObject": "_verify/openlist-cos.txt",
      "role": "large original files, books, visuals, videos and archives"
    },
    "mediaRuntime": {
      "service": "Immich",
      "status": "skeleton-installed-not-started",
      "publicUrl": "https://photos.blog.tengokukk.com/",
      "serverRoot": "/srv/immich",
      "role": "photo/video ingest, thumbnails, EXIF, face/object recognition, CLIP embeddings and semantic search",
      "blockedBy": [
        "photos.blog.tengokukk.com DNS NXDOMAIN",
        "root disk below readiness threshold",
        "dedicated media volume not configured"
      ]
    },
    "metadataOverlay": {
      "service": "Directus",
      "status": "target-not-deployed",
      "composeSkeleton": "infra/composable-stack/docker-compose.yml",
      "p0Sidecar": "public-data/books/books.metadata.json",
      "role": "metadata layer for books, visuals, collections and knowledge_objects; P0 books metadata is a versioned sidecar until Directus or an equivalent metadata DB is deployed",
      "filePolicy": "stores structured metadata only; large files remain in OpenList/COS"
    },
    "searchRuntime": {
      "service": "Meilisearch",
      "status": "target-not-deployed",
      "composeSkeleton": "infra/composable-stack/docker-compose.yml",
      "role": "dynamic full-text and semantic search for KnowledgeObject snapshots, OpenList file index, Directus metadata and Immich imports",
      "currentFallback": "Pagefind remains the current static search until Meilisearch is deployed"
    },
    "infraSkeleton": {
      "root": "infra/composable-stack",
      "composeFile": "infra/composable-stack/docker-compose.yml",
      "envExample": "infra/composable-stack/.env.example",
      "readinessScript": "infra/composable-stack/check-readiness.sh",
      "serverTargetRoot": "/srv/myblog/services/composable-stack",
      "serverSkeletonStatus": "synced to server; .env is intentionally missing and containers are not started",
      "startupGate": "run ./check-readiness.sh and require ready before docker compose up -d",
      "status": "source skeleton only; not deployed as running services"
    },
    "authorityRules": [
      "OpenList/COS owns file existence only; it does not own tags, descriptions, status or collections",
      "public-data/books/books-index.json is a regenerable file index projection, not an editable metadata database",
      "public-data/books/books.metadata.json is the current P0 editable metadata layer and must migrate to Directus or an equivalent metadata DB before scaling",
      "browser localStorage is preference/cache/legacy migration only, never runtime truth",
      "apps/admin-next is a gateway/import/cache/runtime bridge, not a full CMS, media library or search engine",
      "visitor page loads must read snapshots and caches, not run AI inference or re-index large files",
      "do not describe Directus or Meilisearch as active before deployment and verification"
    ],
    "targetPipeline": [
      "COS/OpenList canonical file index",
      "Directus metadata overlay",
      "Meilisearch search index",
      "Astro/MyBlog frontend",
      "Immich API snapshot",
      "VisualCollection and KnowledgeObject projection"
    ]
  },
  "projectionClients": {
    "status": "target architecture documented; PWA/TWA first, native Android only after Runtime API schema stabilizes",
    "thesis": "One Runtime and Object Graph, multiple projection surfaces. Web and Android may have different UI, but must not duplicate authority or business logic.",
    "runtimeAuthority": [
      "OpenList/COS blob backend and content access",
      "MySQL runtime state",
      "Directus metadata overlay target",
      "Meilisearch search target",
      "Immich media runtime target",
      "KnowledgeObject graph"
    ],
    "runtimeApiTarget": [
      "/api/feed",
      "/api/books",
      "/api/visuals",
      "/api/search",
      "/api/graph",
      "/api/runtime/*"
    ],
    "surfaces": {
      "web": {
        "status": "active",
        "stack": "Astro + React islands",
        "role": "current production projection shell"
      },
      "pwaTwa": {
        "status": "auto-generated-twa-artifacts-verified",
        "workspace": "apps/android-shell",
        "stack": "PWA manifest + service worker + Bubblewrap / Trusted Web Activity",
        "role": "installable Android shell that follows Web Runtime updates",
        "manifestSource": "apps/web/public/manifest.webmanifest",
        "serviceWorkerSource": "apps/web/public/sw.js",
        "assetLinksSource": "apps/web/public/.well-known/assetlinks.json",
        "sha256CertFingerprints": [
          "1C:64:9F:75:41:AE:39:B7:A7:D7:E3:4D:EE:41:CB:EA:BC:1F:13:7F:27:39:6A:F4:19:F0:76:B6:FE:A3:11:BD"
        ],
        "serviceWorkerBoundary": [
          "do not intercept /api/*",
          "do not intercept /openlist/*",
          "do not intercept /reader/openlist",
          "do not intercept /books/openlist",
          "do not intercept HTTP Range requests"
        ],
        "validationCommand": "npm run android:twa:validate",
        "generateCommand": "npm run android:twa:generate",
        "buildCommand": "npm run android:twa:build",
        "buildTestSignedCommand": "npm run android:twa:build:test-signed",
        "generatedProjectRoot": ".runtime/android-twa",
        "ciWorkflow": ".github/workflows/android-twa.yml",
        "generatedArtifacts": [
          ".runtime/android-twa/app-release-unsigned-aligned.apk",
          ".runtime/android-twa/app/build/outputs/bundle/release/app-release.aab",
          ".runtime/android-twa/app-release-signed.apk"
        ],
        "artifactRule": "generated-only; do not commit Bubblewrap output"
      },
      "androidNative": {
        "status": "target phase 3",
        "stack": "Kotlin + Compose + ViewModel/Flow + Ktor/Retrofit + Coil + Room",
        "role": "native runtime client consuming the same Runtime API"
      }
    },
    "sharedPackages": {
      "runtimeContract": "packages/runtime-contract",
      "objectModel": "packages/object-model"
    },
    "forbidden": [
      "WebView shell as final app architecture",
      "duplicating book existence logic in Android",
      "duplicating OpenList parsing or metadata authority in Android",
      "duplicating search ranking or graph relation logic per client",
      "treating Room/local cache as source of truth"
    ],
    "localCacheRule": "Android Room/cache may mirror runtime data for offline and speed, but must use version/etag/modified/size/sync watermark invalidation and never become upstream truth",
    "updateTarget": "GitHub Releases + AppUpdater first; F-Droid repo is optional later"
  },
  "runtimeFederation": {
    "status": "architecture contract documented; only OpenList/COS and MyBlog runtime pieces are active unless separately marked",
    "thesis": "Clone mature system roles, not UI or duplicate engines. MyBlog owns Object Layer Glue, Runtime Schema, Projection Logic and Knowledge Semantics.",
    "targetPipeline": [
      "Obsidian",
      "Syncthing",
      "Linux /home/vault/Obsidian hot mirror",
      "OpenList /openlist/Obsidian content control plane",
      "Quartz-compatible Markdown runtime layer",
      "MyBlog Runtime API and Object Layer Glue",
      "Astro UI Shell / PWA-TWA / Android / Search / CLI / AI Agent"
    ],
    "matureReplacementPriority": [
      {
        "rank": 1,
        "service": "Syncthing",
        "replace": "Windows watcher, scp content sync, Obsidian in-process projection and custom Vault sync"
      },
      {
        "rank": 2,
        "service": "Runtime MarkdownObject",
        "replace": "parallel article systems, Astro posts authority, ad-hoc runtime article projections and browser-side markdown rendering"
      },
      {
        "rank": 3,
        "service": "Quartz 4",
        "replace": "custom Markdown compiler, wikilink/backlink/graph basics, TOC, LaTeX, callout and table rendering"
      },
      {
        "rank": 4,
        "service": "Meilisearch",
        "replace": "runtime object search gaps left by Pagefind/local search"
      },
      {
        "rank": 5,
        "service": "Immich",
        "replace": "custom visual snapshot, thumbnail manifest, AI tagging, embedding and gallery runtime"
      },
      {
        "rank": 6,
        "service": "Payload or Directus",
        "replace": "custom object/media admin and metadata relation editor"
      },
      {
        "rank": 7,
        "service": "AppFlowy Cloud",
        "replace": "custom Project Studio collaboration runtime, block editor, kanban/database, comments, realtime presence and workspace permissions"
      }
    ],
    "referenceSystems": {
      "obsidian": {
        "url": "https://obsidian.md/",
        "role": "Authoring Truth",
        "status": "active upstream",
        "learn": [
          "vault writing",
          "wikilinks",
          "attachments",
          "long-form knowledge authoring"
        ]
      },
      "remotelySave": {
        "url": "https://github.com/remotely-save/remotely-save",
        "role": "Vault Sync",
        "status": "target workflow",
        "learn": [
          "WebDAV sync",
          "S3 sync",
          "conflict handling",
          "vault-level file sync"
        ]
      },
      "syncthing": {
        "url": "https://github.com/syncthing/syncthing",
        "role": "Hot Mirror Sync",
        "status": "active for complete Obsidian vault",
        "learn": [
          "real-time file sync",
          "incremental transfer",
          "automatic recovery",
          "conflict handling",
          "Linux server hot mirror"
        ]
      },
      "openListCos": {
        "url": "https://github.com/OpenListTeam/OpenList",
        "role": "Content Control Plane / Blob Backend",
        "status": "active",
        "activeMounts": [
          {
            "mountPath": "/Obsidian",
            "driver": "Local via OpenList public route",
            "root": "/home/vault/Obsidian",
            "publicRoute": "/openlist/Obsidian",
            "verified": "2026-05-08"
          },
          {
            "mountPath": "/腾讯云COS",
            "driver": "S3",
            "root": "/",
            "verified": "2026-05-07"
          },
          {
            "mountPath": "/夸克网盘",
            "driver": "Quark",
            "root": "provider-root",
            "verified": "existing legacy mount"
          }
        ],
        "learn": [
          "file listing",
          "raw file access",
          "WebDAV bridge",
          "object storage mount"
        ]
      },
      "serverStorageIntegration": {
        "status": "active",
        "serverRootDisk": "/dev/vda2 40GB root filesystem",
        "hotLayer": [
          "/home/vault/Obsidian",
          "/srv/myblog/site",
          "/srv/myblog/site/runtime",
          "/srv/myblog/site/pagefind",
          "/srv/myblog/public-data/openlist-covers",
          "/srv/myblog/public-data/openlist-pages",
          "/srv/openlist/data"
        ],
        "coldLayer": [
          "OpenList:/腾讯云COS",
          "OpenList:/夸克网盘",
          "future S3/WebDAV backends",
          "manual archive candidates under /home/vault/*.legacy-disabled-*"
        ],
        "activeOpenListMounts": [
          {
            "mountPath": "/Obsidian",
            "driver": "Local",
            "root": "/home/vault/Obsidian",
            "role": "public content access and OpenList identity for the Linux hot mirror"
          },
          {
            "mountPath": "/腾讯云COS",
            "driver": "S3",
            "bucket": "myblog-media-1410041307",
            "region": "ap-shanghai",
            "role": "large original files, media, books and archive backend"
          },
          {
            "mountPath": "/夸克网盘",
            "driver": "Quark",
            "role": "legacy/cold netdisk backend"
          }
        ],
        "adminNextPublicRoots": [
          "/Obsidian",
          "/腾讯云COS",
          "/夸克网盘"
        ],
        "maintenanceCommand": "npm run server:openlist-storage",
        "pruneCommand": "npm run server:openlist-storage -- --prune-openlist-file-cache --apply",
        "lastAction": "2026-05-08 pruned re-generable /srv/myblog/public-data/openlist-files cache, reducing root disk from 94% used to 91% used",
        "rules": [
          "OpenList is not an ext4/system disk replacement",
          "do not place databases, node_modules, Astro dist, Pagefind, Syncthing hot mirror or /srv/myblog runtime roots on OpenList mounts",
          "OpenList file cache is re-generable and may be pruned under explicit apply mode",
          "legacy-disabled Vault folders are manual cold-archive candidates, not automatic deletion targets"
        ]
      },
      "quartz": {
        "url": "https://github.com/jackyzha0/quartz",
        "role": "Obsidian Digital Garden substrate",
        "status": "reference / substrate candidate",
        "learn": [
          "Markdown transform",
          "wikilinks",
          "backlinks",
          "graph",
          "search",
          "folder and tag publish"
        ]
      },
      "flowershow": {
        "url": "https://github.com/flowershow/flowershow",
        "role": "Obsidian Publish / CMS-like substrate",
        "status": "reference / substrate candidate",
        "learn": [
          "Obsidian to website pipeline",
          "Markdown site publish",
          "hosted publish model"
        ]
      },
      "payload": {
        "url": "https://github.com/payloadcms/payload",
        "role": "Object / Media Admin reference",
        "status": "reference / metadata candidate",
        "learn": [
          "object modeling",
          "media layer",
          "relation layer",
          "admin architecture"
        ]
      },
      "appflowy": {
        "url": "https://github.com/AppFlowy-IO/AppFlowy",
        "cloudUrl": "https://github.com/AppFlowy-IO/AppFlowy-Cloud",
        "role": "Project Studio Collaboration Runtime target",
        "status": "target-not-deployed",
        "recommendedPublicUrl": "https://project.tengokukk.com/",
        "skeletonRoot": "infra/appflowy-cloud",
        "serverTargetRoot": "/srv/myblog/services/appflowy-cloud",
        "readinessScript": "infra/appflowy-cloud/check-readiness.sh",
        "serverReadinessCommand": "cd /srv/myblog/services/appflowy-cloud && ./check-readiness.sh",
        "upstreamInstallScript": "infra/appflowy-cloud/install-upstream.sh",
        "currentMyBlogIntegration": "apps/web/src/pages/projects/[slug].astro exposes an AppFlowy target panel and falls back to GitHub Workbench until appflowyUrl is configured per project.",
        "learn": [
          "block runtime",
          "object graph",
          "CRDT",
          "collaboration",
          "local-first sync",
          "database workspace",
          "kanban",
          "comments"
        ],
        "authorityBoundary": "AppFlowy owns collaborative editing, realtime workspace, block documents, kanban/database and comments after deployment. MyBlog owns only public projection, feed/graph references and GitHub signal fallback.",
        "blockedBy": [
          "AppFlowy Cloud not deployed on project.tengokukk.com",
          "project.tengokukk.com DNS does not currently resolve to 124.220.233.126",
          "server /srv/myblog/services/appflowy-cloud has about 6GB free, below the 40GB AppFlowy readiness gate",
          "server .env currently contains placeholder values only",
          "project content entries do not yet have production appflowyUrl values",
          "no AppFlowy snapshot importer/API contract exists yet"
        ]
      },
      "affine": {
        "url": "https://github.com/toeverything/AFFiNE",
        "role": "Workspace Runtime reference",
        "status": "reference only",
        "learn": [
          "workspace runtime",
          "blocks",
          "local-first",
          "projection",
          "object runtime"
        ]
      },
      "anytype": {
        "url": "https://github.com/anyproto/anytype-ts",
        "role": "Object Graph reference",
        "status": "reference only",
        "learn": [
          "object identity",
          "relation graph",
          "schema",
          "projection"
        ]
      },
      "immich": {
        "url": "https://github.com/immich-app/immich",
        "role": "Media Runtime",
        "status": "skeleton-not-started",
        "learn": [
          "media ingest",
          "thumbnails",
          "EXIF",
          "AI tagging",
          "embeddings",
          "timeline"
        ]
      },
      "paperlessNgx": {
        "url": "https://github.com/paperless-ngx/paperless-ngx",
        "role": "Document Object reference",
        "status": "reference only",
        "learn": [
          "file is not document",
          "metadata runtime",
          "document object lifecycle"
        ]
      },
      "mihon": {
        "url": "https://github.com/mihonapp/mihon",
        "role": "Android Runtime reference",
        "status": "reference only",
        "learn": [
          "source abstraction",
          "reader runtime",
          "cache",
          "downloads",
          "updates",
          "extensions"
        ]
      },
      "readYou": {
        "url": "https://github.com/Ashinch/ReadYou",
        "role": "Feed Runtime reference",
        "status": "reference only",
        "learn": [
          "feed sync",
          "offline cache",
          "reading state",
          "projection"
        ]
      },
      "directus": {
        "url": "https://github.com/directus/directus",
        "role": "Metadata Overlay",
        "status": "target-not-deployed",
        "learn": [
          "curation metadata",
          "relations",
          "admin editing",
          "structured overlay"
        ]
      },
      "meilisearch": {
        "url": "https://github.com/meilisearch/meilisearch",
        "role": "Search Runtime",
        "status": "target-not-deployed",
        "learn": [
          "dynamic object search",
          "file index search",
          "metadata search"
        ]
      },
      "contentlayer": {
        "url": "https://github.com/contentlayerdev/contentlayer",
        "role": "Astro-native typed content pipeline candidate",
        "status": "candidate-not-installed",
        "learn": [
          "typed Markdown schema",
          "parsing",
          "watch",
          "projection"
        ]
      },
      "coolify": {
        "url": "https://github.com/coollabsio/coolify",
        "role": "Deployment platform candidate",
        "status": "candidate-not-deployed",
        "learn": [
          "Git deploy",
          "environment management",
          "healthcheck",
          "rollback",
          "Docker Compose",
          "cron"
        ]
      }
    },
    "ownOnly": [
      "Object Layer Glue",
      "Runtime Schema",
      "Projection Logic",
      "Relation System",
      "Knowledge Runtime Semantics",
      "KnowledgeObject projection"
    ],
    "doNotBuild": [
      "sync engine",
      "media server",
      "WebDAV or object storage",
      "Markdown compiler or Digital Garden base",
      "backlink or graph publish engine",
      "PDF engine",
      "image cache or thumbnail pipeline",
      "auth system",
      "full CMS",
      "search engine",
      "Android source/download/update runtime"
    ],
    "rules": [
      "clone roles, not UI",
      "reuse Quartz or Flowershow style garden substrate before inventing Markdown, backlink, graph or publish basics",
      "replace custom runtime with mature layers before adding new runtime abstraction",
      "files are carriers and objects are identity",
      "MyBlog writes glue, not engines",
      "Android is a runtime projection, not a second app universe",
      "every federation member must declare authority, status, integration path, secret boundary and failure mode"
    ],
    "runtimeDatabase": {
      "status": "active",
      "type": "Tencent Cloud CynosDB Serverless MySQL",
      "clusterId": "cynosdbmysql-no0zqua0",
      "engine": "MySQL 8.0",
      "publicEndpoint": "124.220.245.121:22295",
      "privateEndpoint": "172.17.0.3:3306",
      "privateEndpointStatus": "not-routable-from-current-lighthouse-as-of-2026-05-10",
      "database": "cloudbase-4glvyyq9f61b19cd",
      "user": "openclaw",
      "secretSource": "/etc/myblog-admin-next.env",
      "serviceOwner": "apps/admin-next",
      "schemaOwner": "apps/admin-next/lib/runtime-db.js",
      "connectionEnv": [
        "MYBLOG_DB_HOST",
        "MYBLOG_DB_PORT",
        "MYBLOG_DB_USER",
        "MYBLOG_DB_PASSWORD",
        "MYBLOG_DB_NAME"
      ],
      "activeTables": [
        "reader_memory",
        "reader_highlights",
        "visual_sources",
        "visual_pins",
        "visual_sync_runs",
        "personal_secret_entries"
      ],
      "owns": [
        "reader progress and last-read state",
        "reader highlights and anchors",
        "visual source registry",
        "visual pin runtime index",
        "visual sync run logs"
      ],
      "forbidden": [
        "article markdown body source",
        "EPUB/PDF/image/video blobs",
        "OpenList file objects",
        "Tencent COS objects",
        "Quark netdisk files",
        "Astro dist or Pagefind output",
        "Syncthing hot mirror files"
      ],
      "integrationRole": "dynamic runtime state layer beside OpenList/COS/Quark file storage and Obsidian content truth"
    },
    "plaintextPersonalSecretStore": {
      "status": "active-schema",
      "table": "personal_secret_entries",
      "valueColumn": "secret_value",
      "storageMode": "plaintext-by-user-requirement",
      "purpose": "store personal account/password/API-key style information directly in MySQL as readable text",
      "owner": "apps/admin-next / MySQL Runtime Layer",
      "database": "cloudbase-4glvyyq9f61b19cd",
      "warning": "Values are intentionally stored as plaintext in MySQL; do not commit real values to Git or logs."
    }
  },
  "projectCollaborationRuntime": {
    "status": "reduction-mode; AppFlowy is target-not-deployed and GitHub Workbench is interim-active fallback",
    "principle": "Do not keep growing a full collaboration system inside the blog runtime.",
    "activeFallback": {
      "name": "GitHub Workbench",
      "status": "interim-active",
      "route": "apps/web/src/pages/projects/[slug].astro",
      "contentModel": "apps/web/src/content/projects/*.md",
      "apiOwner": "apps/admin-next/app/api/github/** and apps/admin-next/app/api/projects/[slug]/timeline/route.js",
      "capabilities": [
        "repo status projection",
        "issues/pulls/commits/contributors runtime read",
        "service-side GitHub file save",
        "timeline.json write-back"
      ],
      "notAuthorityFor": [
        "realtime collaboration",
        "block editor runtime",
        "workspace comments",
        "kanban/database authority",
        "presence or permissions"
      ]
    },
    "targetRuntime": {
      "name": "AppFlowy Cloud",
      "status": "target-not-deployed",
      "source": "https://github.com/AppFlowy-IO/AppFlowy-Cloud",
      "recommendedPublicUrl": "https://project.tengokukk.com/",
      "skeletonRoot": "infra/appflowy-cloud",
      "serverTargetRoot": "/srv/myblog/services/appflowy-cloud",
      "embedField": "projects frontmatter appflowyUrl",
      "workspaceField": "projects frontmatter appflowyWorkspace",
      "responsibilities": [
        "workspace runtime",
        "block documents",
        "realtime editing",
        "database/kanban",
        "comments",
        "collaboration permissions"
      ]
    },
    "myBlogResponsibilities": [
      "Project Studio entry and public projection shell",
      "GitHub code signals",
      "Feed and Knowledge Graph references",
      "Reader/project cross-links",
      "clear pending/connected state"
    ],
    "forbidden": [
      "claim AppFlowy is active before project.tengokukk.com is deployed and appflowyUrl is configured",
      "continue adding custom wiki/timeline/kanban/comments as the primary collaboration runtime",
      "read secrets or tokens from the browser",
      "scrape AppFlowy iframe DOM for data"
    ]
  },
  "frontendRuntimeAudit": {
    "status": "first-pass documented",
    "canonicalDoc": "docs/frontend-runtime-audit.md",
    "method": "trace user behavior through DOM, event, state, render, hydration, network, animation, authority and fallback",
    "mustCover": [
      "pages",
      "interactions",
      "hover",
      "click",
      "drag",
      "scroll",
      "keyboard",
      "hydration islands",
      "localStorage",
      "sessionStorage",
      "runtime fetch",
      "lazy load",
      "modal drawer dialog",
      "command palette",
      "search runtime",
      "iframe embed shell",
      "third-party runtime",
      "hidden fallback"
    ],
    "knownRuntimeOwners": [
      "apps/web/src/layouts/BaseLayout.astro",
      "apps/web/src/pages/index.astro",
      "apps/web/src/pages/visuals/index.astro",
      "apps/web/src/pages/knowledge/index.astro",
      "apps/web/src/pages/projects/[slug].astro",
      "apps/web/src/components/react/HomeCommandPalette.tsx",
      "apps/web/src/components/react/HoverPreviewSystem.tsx",
      "apps/web/src/components/books/BookDrawerReader.tsx",
      "apps/web/src/components/books/BookReader.tsx"
    ],
    "rule": "frontend runtime changes must update docs/frontend-runtime-audit.md or explicitly state why the audit map is unaffected"
  },
  "frontendRuntimeConvergence": {
    "status": "reduction mode; legacy inline runtime and React islands remain current overlay/drawer authority",
    "canonicalDoc": "docs/frontend-runtime-convergence.md",
    "runtimeKernelRoot": "packages/runtime-kernel",
    "thesis": "MyBlog must converge command, keyboard, overlays, drawers, focus, navigation and client cache behavior into one frontend runtime kernel before adding more independent runtime layers.",
    "currentRisk": [
      "Inline Script Empire in apps/web/src/pages/index.astro",
      "Ctrl/Cmd+K split authority between HomeCommandPalette and fallback search",
      "custom window events as integration layer",
      "localStorage behaving as mixed preference/cache/migration/local-authority store"
    ],
    "kernelResponsibilities": [
      "command bus",
      "keyboard layer",
      "overlay stack",
      "drawer intents",
      "focus restore",
      "typed runtime events",
      "navigation/history intents",
      "storage classification"
    ],
    "activeLibraries": [
      "cmdk",
      "motion",
      "@floating-ui/react"
    ],
    "installedButNotActiveOwners": [
      "zustand",
      "Radix UI primitives",
      "Vaul",
      "React Flow"
    ],
    "targetConventionsNotInitialized": [
      "shadcn/ui component directory"
    ],
    "legacyBridgeEvents": [
      "home-search-open",
      "openlist-embed-open",
      "pinterest-embed-open",
      "reader-command",
      "emptyinkpot:book-drawer-open",
      "emptyinkpot:book-drawer-close"
    ],
    "storageClasses": [
      "preference",
      "cache",
      "legacy-migration",
      "temporary-local-authority",
      "forbidden-authority"
    ],
    "p1Implemented": [
      "HomeCommandPalette sets html[data-home-command-ready=true] after hydration",
      "home inline Ctrl/Cmd+K fallback only runs before command palette ready marker exists",
      "HomeCommandPalette dispatches runtime:command kind search.open before legacy home-search-open bridge",
      "home command and fallback search layers use runtime experience depth/surface/elevation/motion tokens"
    ],
    "rules": [
      "migrate one interaction owner at a time",
      "state current owner, target owner and fallback owner for runtime changes",
      "do not add global listeners without updating audit and convergence docs",
      "do not add custom events without typed runtime-kernel commands/events",
      "do not introduce localStorage as new source of truth",
      "installed runtime libraries only become active owners after a concrete migrated surface and browser evidence"
    ]
  },
  "runtimeExperienceLayer": {
    "status": "P1 command/search surfaces use runtime tokens; broader surfaces still pending",
    "canonicalDoc": "docs/runtime-experience-layer.md",
    "designSystemRoot": "packages/design-system",
    "thesis": "MyBlog needs interaction quality and runtime coherence across surfaces, not more isolated components.",
    "targetFeel": [
      "Linear discipline",
      "Arc spatial layers",
      "Cosmos visual browsing",
      "Immich gallery runtime",
      "MyBlog reading atmosphere"
    ],
    "surfaceVocabulary": {
      "drawer": "Spatial Layer",
      "modal": "Runtime Overlay",
      "card": "Interactive Object",
      "search": "Command Runtime",
      "reader": "Continuous Surface",
      "visuals": "Infinite Semantic Canvas"
    },
    "activeLibraries": [
      "cmdk",
      "motion",
      "@floating-ui/react",
      "lucide-react"
    ],
    "installedButNotActiveOwners": [
      "zustand",
      "Radix UI primitives",
      "Vaul",
      "React Flow"
    ],
    "targetConventionsNotInitialized": [
      "shadcn/ui component directory"
    ],
    "referenceOnly": [
      "Aceternity UI",
      "Magic UI",
      "React Bits",
      "tldraw",
      "AFFiNE",
      "Linear",
      "Arc Browser",
      "Cosmos",
      "Immich Web"
    ],
    "tokenGroups": [
      "motion",
      "depth",
      "elevation",
      "focus",
      "surface"
    ],
    "cssVariables": [
      "--runtime-motion-*",
      "--runtime-ease-*",
      "--runtime-depth-*",
      "--runtime-elevation-*",
      "--runtime-focus-*",
      "--runtime-surface-*"
    ],
    "p1Implemented": [
      "home command layer uses runtime depth/surface/elevation tokens",
      "fallback knowledge search layer uses runtime overlay depth/backdrop/elevation/motion tokens",
      "Command/Search owner convergence is tracked in frontendRuntimeConvergence"
    ],
    "rules": [
      "do not add isolated visual effects that are not tied to a runtime surface",
      "do not import generic glowing particles, orbs, bokeh or marketing hero effects",
      "new z-index values must use or extend the runtime depth scale",
      "new motion timings must use or extend the runtime motion scale",
      "new overlays must use Runtime Kernel ownership",
      "new component libraries require a named migrated surface and browser evidence"
    ]
  },
  "publicBaseUrl": "https://blog.tengokukk.com/",
  "siteEntrypoints": {
    "home": "https://blog.tengokukk.com/",
    "github": "https://blog.tengokukk.com/github/",
    "books": "https://blog.tengokukk.com/books/",
    "bookReader": "https://blog.tengokukk.com/reader/three-body/",
    "music": "https://blog.tengokukk.com/music/",
    "visuals": "https://blog.tengokukk.com/visuals/",
    "immichMediaRuntime": "https://photos.blog.tengokukk.com/",
    "codex": "https://blog.tengokukk.com/codex/",
    "posts": "https://blog.tengokukk.com/posts/",
    "tags": "https://blog.tengokukk.com/tags/",
    "evidenceLibrary": "https://blog.tengokukk.com/evidence-library/",
    "openListEmbed": "https://blog.tengokukk.com/openlist/",
    "search": "https://blog.tengokukk.com/search/",
    "settings": "https://blog.tengokukk.com/settings/"
  },
  "observability": {
    "nginxAccessLog": "/var/log/nginx/access.log",
    "nginxErrorLog": "/var/log/nginx/error.log",
    "buildLogs": "local-cli-or-ci",
    "analytics": "not-configured",
    "errorTracking": "not-configured"
  },
  "contentModel": {
    "posts": [
      "title",
      "date",
      "tags",
      "categories",
      "summary",
      "slug"
    ],
    "notes": [
      "title",
      "date",
      "summary",
      "slug"
    ],
    "projects": [
      "title",
      "summary",
      "slug"
    ],
    "pages": [
      "title",
      "slug"
    ],
    "books": [
      "id",
      "title",
      "author",
      "category",
      "tags",
      "sourceType",
      "openlistPath"
    ],
    "visualCollections": [
      "id",
      "title",
      "source",
      "sourceLabel",
      "summary",
      "mood",
      "tags",
      "palette",
      "coverImages",
      "images",
      "curationNote"
    ],
    "evidenceLibrary": [
      "asset",
      "clip",
      "unlabeledQueue",
      "openlistPath",
      "entities",
      "visualKinds",
      "license",
      "visibility",
      "remotionExport"
    ]
  },
  "visualCollectionSystem": {
    "status": "P0 collection model implemented; Pinterest/Pixiv are bookmark-sync sources, Pinterest runtime mirror is backed by MySQL visual_pins",
    "canonicalSource": "apps/web/src/data/visuals.ts",
    "canonicalModel": "VisualCollection[]",
    "compatibilityProjection": "visualItems is derived from visualCollections.flatMap(collection => collection.images)",
    "importCommand": "npm run import:visual-sources",
    "sourceConfig": "public-data/visual-sources/sources.json",
    "generatedManifest": "public-data/visual-sources/visual-manifest.json",
    "browserProfile": ".runtime/visual-import-browser-profile",
    "secretPolicy": "never write Pinterest/Pixiv passwords, cookies, session storage, local storage auth blobs or tokens into JSON/docs/logs/source",
    "frontendSurfaces": [
      "apps/web/src/pages/index.astro",
      "apps/web/src/pages/visuals/index.astro",
      "apps/web/src/styles/global.css"
    ],
    "sourcePolicy": "Pinterest/Pixiv/OpenList are bookmark or mirror sources, not frontend live reads; current sync records source links and platform preview URLs without downloading originals",
    "runtimeMirror": {
      "schemaOwner": "apps/admin-next/lib/runtime-db.js",
      "syncOwner": "apps/admin-next/lib/visual-runtime.js",
      "snapshotApi": "/api/runtime/visuals/snapshot",
      "syncApi": "/api/runtime/visuals/sync",
      "providers": [
        "pinterest_api",
        "apify_dataset"
      ],
      "secretPolicy": "provider tokens stay in server env or provider secret store, never in source json or README",
      "partitionPattern": [
        6,
        4,
        9,
        12
      ]
    },
    "mediaRuntime": {
      "chosenService": "Immich",
      "status": "server skeleton installed; service not started because DNS and dedicated storage are not ready",
      "publicUrl": "https://photos.blog.tengokukk.com/",
      "expectedPort": 2283,
      "serverRoot": "/srv/immich",
      "composeFile": "/srv/immich/docker-compose.yml",
      "envFile": "/srv/immich/.env",
      "readinessScript": "/srv/immich/check-readiness.sh",
      "nginxConfig": "/etc/nginx/sites-available/immich-photos.conf",
      "deploymentMode": "independent Docker Compose service behind its own root subdomain",
      "subpathPolicy": "do not serve Immich from /immich or /openlist; use photos.blog.tengokukk.com root",
      "storagePolicy": "do not place Immich uploads, thumbnails, database or ML cache on the current nearly-full root filesystem",
      "responsibilities": [
        "photo video ingest",
        "timeline",
        "faces",
        "object recognition",
        "CLIP embeddings",
        "semantic search",
        "EXIF",
        "video thumbnails"
      ],
      "myBlogResponsibilities": [
        "VisualCollection curation",
        "Knowledge Object projection",
        "Graph links",
        "article/project references",
        "drawer/feed entry"
      ],
      "integrationPipeline": [
        "Immich API",
        "admin-next import",
        "MySQL runtime snapshot",
        "VisualCollection partition",
        "Search and Graph projection"
      ],
      "blockedBy": [
        "photos.blog.tengokukk.com DNS currently returns NXDOMAIN",
        "/srv/immich has about 7GB free, below the 30GB startup gate",
        "dedicated media storage volume not attached or configured"
      ],
      "forbidden": [
        "train custom image tagging model before using Immich",
        "run Immich inside Astro",
        "iframe a subpath deployment as the primary integration",
        "trigger AI inference during visitor page load"
      ]
    },
    "currentPipeline": [
      "bookmark sync fallback",
      "runtime mirror sync",
      "MySQL upsert visual_pins",
      "deterministic partition",
      "frontend runtime snapshot"
    ],
    "futurePipeline": [
      "optional thumbnail mirror after explicit approval",
      "palette extraction",
      "collection intelligence",
      "graph integration"
    ]
  },
  "serverHost": "124.220.233.126",
  "serverRuntimeRoot": "/srv/myblog/site",
  "adminServerRuntimeRoot": "/srv/myblog/admin-next/current",
  "adminServerService": "myblog-admin-next.service",
  "adminServerPort": 4117,
  "adminServerEnvFile": "/etc/myblog-admin-next.env",
  "nginxSiteConfig": "/etc/nginx/sites-available/myblog.conf",
  "nginxStaticRouteRule": "Astro static site only: location / must use try_files $uri $uri/index.html =404; unknown routes must not fall back to /index.html.",
  "publishMode": "local-build-then-upload-dist",
  "publishArtifactRoots": [
    "apps/web/dist"
  ],
  "publishChecklist": [
    "confirm source-of-truth boundary",
    "npm run lint",
    "npm run check",
    "npm run build",
    "visible verification when user-facing behavior changed",
    "push branch and update PR before deploy"
  ],
  "verificationCommands": [
    "npm run lint",
    "npm run check",
    "npm run build"
  ],
  "adminPrototypeVerificationCommands": [
    "npm run admin:build"
  ],
  "forbiddenActions": [
    "treat old working copies or static snapshots as active source",
    "treat server runtime directories as long-term source of truth",
    "publish without lint-check-build quality gate",
    "declare analytics or tracing as active without verification",
    "write local preview URLs as canonical public entry",
    "deploy GitHub Pages artifact over /srv/myblog/site before production source integration",
    "treat GitHub main as production-complete without checking /srv/myblog/repo"
  ],
  "platformRoadmap": [
    "observability layer",
    "content model expansion",
    "admin-next app-router control surface",
    "api route-handlers under app/api",
    "ai-assisted writing pipeline",
    "releases-current-rollback publish system",
    "token-pool provider scoring"
  ],
  "platformExecutionOrder": {
    "P0": [
      "admin-next bootstrap",
      "dashboard page",
      "publish build/release/rollback api",
      "releases-current rollback publish flow"
    ],
    "P1": [
      "token-pool provider scoring",
      "token-pool status api",
      "ai generate via token-pool"
    ],
    "P2": [
      "content editor",
      "ai pipeline",
      "save draft"
    ],
    "P3": [
      "analytics",
      "logs viewer",
      "auto publish agent"
    ]
  },
  "frontendInteractionModel": {
    "uiDirection": "content-os-ui",
    "layers": [
      "content-layer",
      "action-layer",
      "system-layer"
    ],
    "homepagePattern": [
      "hero-system-entry",
      "quick-actions",
      "content-feed",
      "signals",
      "system-panels"
    ],
    "requiredFeedbackStates": [
      "loading",
      "empty",
      "error",
      "action-feedback"
    ],
    "searchTarget": [
      "instant-filtering",
      "type-filter-all-posts-notes-projects",
      "title-type-tag-surface"
    ],
    "contentSurfaceTarget": [
      "metadata-bar",
      "status-badges",
      "content-relations",
      "action-entrypoints"
    ]
  },
  "frontendPixelContract": {
    "sources": [
      "apps/web/src/styles/global.css",
      "apps/admin-next/app/globals.css"
    ],
    "source": "apps/web/src/styles/global.css",
    "rootPx": 16,
    "coverage": {
      "homepage": "px-level",
      "postsNotesProjectsLists": "px-level shared workbench-page contract",
      "proseDetailPages": "shared page-wrap/prose-shell contract",
      "searchAndTaxonomy": "shared page-wrap/pagefind/workbench list contract",
      "publicEvidenceLibrary": "px-level",
      "adminPrototype": "px-level global admin shell contract"
    },
    "homepage": {
      "shell": {
        "className": "home-feed-shell",
        "maxWidthPx": 1480,
        "viewportGutterPx": 40,
        "columns": [
          "280px",
          "minmax(0, 1fr)"
        ],
        "gapPx": 20,
        "paddingBlockPx": 20
      },
      "desktopScrollContainers": [
        "home-feed-main"
      ],
      "secondaryScrollContainers": [
        "home-feed-rail",
        "home-article-drawer__body"
      ],
      "leftRailWidthPx": 280,
      "drawerWidthPx": 760,
      "feedColumnCount": 3,
      "feedColumnGapPx": 16,
      "primaryGrids": {
        "homeFeedShell": [
          "280px",
          "minmax(0, 1fr)"
        ],
        "articleReader": [
          "180px",
          "minmax(0, 1fr)"
        ]
      },
      "keyComponentSizesPx": {
        "feedProfilePadding": 16,
        "feedBrandMinHeight": 34,
        "feedAvatar": 82,
        "feedFilterMinHeight": 34,
        "feedCardBodyPadding": 15,
        "feedCardCoverMinHeight": 160,
        "feedCardTallCoverMinHeight": 238,
        "feedCardCompactCoverMinHeight": 118,
        "drawerHeaderPaddingY": 18,
        "drawerHeaderPaddingX": 22,
        "drawerBodyPadding": 24,
        "drawerTocWidth": 180
      },
      "breakpoints": {
        "max1240": "home-feed-grid changes from 3 columns to 2 columns",
        "max900": "home shell becomes block, page-level scrolling returns, feed grid becomes 1 column",
        "max760": "article drawer becomes full viewport width and toc becomes non-sticky",
        "max860": "evidence-library grids collapse",
        "max720": "workbench page stats collapse"
      }
    },
    "visualSettings": {
      "route": "apps/web/src/pages/settings.astro",
      "runtimeStorageKey": "emptyinkpot-visual-settings",
      "appliedBy": "apps/web/src/layouts/BaseLayout.astro",
      "styleSource": "apps/web/src/styles/global.css",
      "scope": "browser-local homepage display preferences",
      "defaultTheme": "heritage",
      "themeOptions": [
        "heritage",
        "glass"
      ],
      "heritageTheme": {
        "status": "default",
        "intent": "Cultural OS visual language: paper background, pure color panels, semantic color strips, low shadow, no glass blur",
        "tokens": {
          "--heritage-bg": "#f5f1e8",
          "--heritage-paper": "#efe8da",
          "--heritage-paper-deep": "#e4dac7",
          "--heritage-purple": "#6b2d5c",
          "--heritage-red": "#9e2a2b",
          "--heritage-green": "#2f5d50",
          "--heritage-gold": "#c9a227",
          "--heritage-line": "#d8cfc2",
          "--heritage-ink": "#1e1b18",
          "--heritage-muted": "#6b645c"
        },
        "rules": [
          "future homepage visual changes target heritage by default",
          "avoid large gradients, glow, glass blur, neon colors and large SaaS rounded cards",
          "use semantic left borders for feed card type identity",
          "full page links remain in drawer actions; main homepage click behavior remains drawer"
        ]
      },
      "exposedTokens": [
        "theme",
        "--home-card-glass-top-alpha",
        "--home-card-glass-bottom-alpha",
        "--home-rail-glass-top-alpha",
        "--home-rail-glass-bottom-alpha",
        "--home-toolbar-glass-top-alpha",
        "--home-toolbar-glass-bottom-alpha",
        "--home-background-overlay-alpha",
        "--home-glass-blur",
        "--home-glass-saturate",
        "--home-background-image"
      ],
      "persistence": "localStorage only; not a server-side CMS setting"
    },
    "bookshelfReader": {
      "status": "implemented",
      "routes": [
        "apps/web/src/pages/books/index.astro",
        "apps/web/src/pages/books/[id].astro",
        "apps/web/src/pages/reader/[id].astro",
        "apps/web/src/pages/settings.astro"
      ],
      "dataSource": "apps/web/public/public-data/books/books-index.json",
      "metadataSource": "public-data/books/books.metadata.json",
      "clientModules": [
        "apps/web/src/lib/books/types.ts",
        "apps/web/src/lib/books/manifest.ts",
        "apps/web/src/lib/books/storage.ts"
      ],
      "reactIslands": [
        "apps/web/src/components/books/BookshelfGrid.tsx",
        "apps/web/src/components/books/BookReader.tsx",
        "apps/web/src/components/books/EpubReader.tsx",
        "apps/web/src/components/books/PdfReader.tsx"
      ],
      "openList": {
        "localProjectRoot": "E:\\My Project\\OpenList",
        "defaultBaseUrl": "http://127.0.0.1:5244",
        "publicEmbedRoute": "https://blog.tengokukk.com/openlist/",
        "apiPrefix": "/openlist",
        "verifiedMounts": [
          "/夸克网盘",
          "/腾讯云COS"
        ],
        "objectStorage": {
          "provider": "Tencent COS",
          "bucket": "myblog-media-1410041307",
          "region": "ap-shanghai",
          "endpoint": "cos.ap-shanghai.myqcloud.com",
          "openListMount": "/腾讯云COS",
          "openListStorageId": 2,
          "driver": "S3",
          "verifiedWriteObject": "_verify/openlist-cos.txt",
          "pathContract": {
            "books": "/腾讯云COS/books",
            "visuals": "/腾讯云COS/visuals",
            "videos": "/腾讯云COS/videos",
            "archive": "/腾讯云COS/archive"
          },
          "role": "large original files and archives; not a database disk and not a direct replacement for Immich/Postgres local volumes"
        },
        "verifiedApis": [
          "POST /api/fs/list",
          "POST /api/fs/get",
          "POST /api/fs/mkdir",
          "PUT /api/fs/put",
          "GET /api/admin/storage/list",
          "POST /api/admin/storage/create",
          "POST /api/admin/storage/load_all"
        ],
        "rawUrlField": "raw_url",
        "frontendSecretPolicy": "do not store OpenList tokens or netdisk cookies in static frontend source"
      },
      "localStorageKeys": [
        "emptyinkpot-book-settings",
        "emptyinkpot-book-progress:<id>",
        "emptyinkpot-book-location:<id>",
        "emptyinkpot-book-recent",
        "emptyinkpot-reader-theme"
      ],
      "readerLibraries": [
        "react-reader",
        "react-pdf"
      ],
      "pdfWorker": "https://unpkg.com/pdfjs-dist@<react-pdf pdfjs.version>/build/pdf.worker.min.mjs"
    },
    "githubVisualizationAssets": {
      "status": "implemented as Visualization layer; homepage surfaces mini Feed chart cards and /github renders full dashboard",
      "dataSource": "apps/web/src/data/github-overview.emptyinkpot.json",
      "loader": "apps/web/src/lib/github.ts",
      "analyticsLayer": "apps/web/src/lib/analytics.ts",
      "components": [
        "apps/web/src/components/visualizations/ChartCard.astro",
        "apps/web/src/components/visualizations/GitHubHeatmap.astro",
        "apps/web/src/components/visualizations/GitHubMonthlyLine.astro",
        "apps/web/src/components/visualizations/GitHubLanguageDonut.astro",
        "apps/web/src/components/visualizations/GitHubRepoMatrix.astro",
        "apps/web/src/components/visualizations/TeamSignalGraph.astro"
      ],
      "detailPage": "apps/web/src/pages/github/index.astro",
      "visualSurfaces": [
        {
          "name": "GitHub contribution heatmap",
          "data": [
            "overview.months",
            "overview.weeks",
            "overview.totalContributions"
          ],
          "legacyTypes": [
            "HomeCheckInData",
            "HomeCheckInWeek",
            "HomeCheckInCell"
          ]
        },
        {
          "name": "GitHub monthly contribution line chart",
          "data": [
            "overview.monthly"
          ],
          "legacyTypes": [
            "HomeGitHubMonthlyPoint"
          ]
        },
        {
          "name": "GitHub language donut chart",
          "data": [
            "overview.languages"
          ],
          "legacyTypes": [
            "HomeGitHubLanguageSlice"
          ]
        },
        {
          "name": "Team and repository signal panels",
          "data": [
            "overview.profile",
            "overview.repos"
          ],
          "legacyTypes": [
            "HomeTeamSignal",
            "HomeRepoSignal",
            "HomeAutomationSignal"
          ]
        }
      ],
      "legacyCssClasses": [
        "home-workbench__cell--0..4",
        "home-workbench__analytics",
        "home-workbench__donut",
        "home-workbench__linechart",
        "home-team-switcher",
        "home-github-signals"
      ],
      "currentHomepageMapping": [
        "GitHub repo feed cards use overview.repos",
        "GitHub mini heatmap/line/language cards use analytics.ts derived data",
        "left rail GitHub card uses overview.profile and overview.totalContributions"
      ]
    },
    "showcaseLayer": {
      "status": "implemented as lightweight data plus Astro showcase components",
      "dataSources": [
        "apps/web/public/public-data/books/books-index.json",
        "public-data/books/books.metadata.json",
        "apps/web/src/data/music.ts"
      ],
      "components": [
        "apps/web/src/components/showcase/BookCover.astro",
        "apps/web/src/components/showcase/BookshelfCard.astro",
        "apps/web/src/components/showcase/AlbumCover.astro",
        "apps/web/src/components/showcase/MusicCard.astro"
      ],
      "detailPages": [
        "apps/web/src/pages/books/index.astro",
        "apps/web/src/pages/music/index.astro"
      ],
      "homepageMapping": [
        "book entries are FeedItem type=book",
        "music entries are FeedItem type=music",
        "homepage rail only shows bookshelf/music summaries"
      ]
    },
    "knowledgeLayer": {
      "status": "implemented v1 as static Astro plus browser-local reader memory",
      "principles": {
        "highlight": "memory point",
        "search": "entry point",
        "graph": "structure",
        "bookmarkObject": "physical metaphor for feed item type",
        "readerDrawer": "temporary book page, not a generic side panel"
      },
      "routes": {
        "knowledgeGraph": "apps/web/src/pages/knowledge/index.astro",
        "knowledgeIndex": "apps/web/src/pages/data/knowledge-index.json.ts"
      },
      "sourceFiles": [
        "apps/web/src/lib/knowledge/types.ts",
        "apps/web/src/lib/knowledge/anchors.ts",
        "apps/web/src/lib/knowledge/storage.ts",
        "apps/web/src/lib/knowledge/search.ts",
        "apps/web/src/lib/knowledge/graph.ts",
        "apps/web/src/pages/index.astro",
        "apps/web/src/styles/global.css"
      ],
      "localStorageKeys": [
        "emptyinkpot-reading-history",
        "emptyinkpot-reader-bookmarks",
        "emptyinkpot-reader-highlights",
        "emptyinkpot-reader-theme"
      ],
      "readerThemes": [
        "light",
        "sepia",
        "dark"
      ],
      "bookmarkObjectSystem": {
        "className": "bookmark",
        "rules": [
          "bookmark extends from top of feed card",
          "clip-path creates paper bookmark notch",
          "post=purple, project/github=green, note/book=red, music=gold",
          "card title color follows bookmark semantic color"
        ]
      },
      "highlightAnchorContract": {
        "primary": "TextQuoteSelector exact/prefix/suffix",
        "secondary": "TextPositionSelector start/end",
        "fallback": "DomPathSelector start/end path and offsets",
        "status": "types and anchor utilities implemented; homepage v1 currently restores by exact text and must migrate to anchors.ts in P1"
      },
      "searchContract": {
        "indexEndpoint": "/data/knowledge-index.json",
        "homepageOverlay": "Cmd/Ctrl+K and homepage search button",
        "dependencyPolicy": "no external search dependency in v1; future FlexSearch must preserve KnowledgeSearchDoc shape"
      },
      "graphContract": {
        "route": "/knowledge/",
        "layout": "radial levels: self, collections, content, tags/highlights",
        "dependencyPolicy": "no force graph dependency in v1; future graph libraries must preserve KnowledgeGraphNode/KnowledgeGraphLink semantics"
      }
    },
    "pageFamilies": {
      "home": {
        "files": [
          "apps/web/src/pages/index.astro",
          "apps/web/src/lib/books/manifest.ts",
          "apps/web/public/public-data/books/books-index.json",
          "apps/web/src/data/music.ts",
          "apps/web/src/lib/analytics.ts",
          "apps/web/src/lib/profile.ts"
        ],
        "mustKeep": [
          "280px profile rail",
          "css-columns feed",
          "right drawer width min(760px, 100vw)",
          "feed scroll position must not reset on filter or drawer close"
        ]
      },
      "collectionPages": {
        "files": [
          "apps/web/src/pages/posts/index.astro",
          "apps/web/src/pages/notes/index.astro",
          "apps/web/src/pages/projects/index.astro"
        ],
        "wrapperMaxWidthPx": 1180,
        "viewportGutterPx": 24,
        "gridColumns": [
          "repeat(2, minmax(0, 1fr))"
        ],
        "postCardColumns": [
          "176px",
          "minmax(0, 1fr)"
        ],
        "postCoverMinHeightPx": 176,
        "collapseBreakpointPx": 1100
      },
      "detailPages": {
        "files": [
          "apps/web/src/pages/posts/[slug].astro",
          "apps/web/src/pages/notes/[slug].astro",
          "apps/web/src/pages/projects/[slug].astro",
          "apps/web/src/pages/about.astro",
          "apps/web/src/pages/settings.astro",
          "apps/web/src/pages/github/index.astro",
          "apps/web/src/pages/books/index.astro",
          "apps/web/src/pages/music/index.astro"
        ],
        "wrapperMaxWidthPx": 1180,
        "codeBlockRule": "pre may scroll horizontally; it must not widen page-wrap"
      },
      "searchAndTaxonomy": {
        "files": [
          "apps/web/src/pages/search.astro",
          "apps/web/src/pages/tags/**",
          "apps/web/src/pages/categories/**",
          "apps/web/src/pages/series/**"
        ],
        "rule": "use page-wrap width; do not add fixed-width sidebars"
      }
    },
    "publicEvidenceLibrary": {
      "heroColumns": [
        "minmax(0, 1.5fr)",
        "minmax(256px, 0.75fr)"
      ],
      "heroGapPx": 24,
      "heroPaddingPx": 24,
      "heroPreMinHeightPx": 144,
      "gridColumns": [
        "repeat(3, minmax(0, 1fr))"
      ],
      "gridGapPx": 16,
      "cardPaddingPx": 21.6,
      "sourceGridColumns": [
        "160px",
        "minmax(0, 1fr)"
      ],
      "collapseBreakpointPx": 860,
      "longTextRule": "evidence-library__mono and source code must use overflow-wrap:anywhere"
    },
    "adminPrototype": {
      "source": "apps/admin-next/app/globals.css",
      "shellColumns": [
        "240px",
        "1fr"
      ],
      "sidebarPaddingPx": 24,
      "mainPaddingPx": 24,
      "mainScrollContainer": "console-main",
      "cardPaddingPx": 20,
      "cardRadiusPx": 24,
      "pageStackGapPx": 24,
      "metricGridColumns": [
        "repeat(3, minmax(0, 1fr))"
      ],
      "twoColumnGridColumns": [
        "repeat(2, minmax(0, 1fr))"
      ],
      "metricCardMinHeightPx": 128,
      "metaGridColumns": [
        "120px",
        "minmax(0, 1fr)"
      ],
      "timelineGridColumns": [
        "repeat(6, minmax(0, 1fr))"
      ],
      "aiLayoutColumns": [
        "220px",
        "minmax(0, 1fr)",
        "280px"
      ],
      "aiLayoutMinHeight": "calc(100vh - 48px)",
      "chatBubbleMaxWidth": "80%",
      "tableCellPaddingPx": [
        14,
        16
      ],
      "collapseBreakpointPx": 1100,
      "overlapRules": [
        "console-main is the only admin main scroll container",
        "chat-shell must keep min-height:0 so chat-thread can scroll",
        "long paths use meta-grid code overflow-wrap:anywhere",
        "wide tables stay inside table-shell"
      ]
    },
    "overlapRules": [
      "home-feed-main is the only homepage main scroll container",
      "do not reset home-feed-main scrollTop on filter/list/drawer selection",
      "all grid children that contain text must keep min-width: 0",
      "long text/path/code surfaces must use overflow-wrap:anywhere or line-clamp",
      "article toc sticky behavior must stay inside home-article-drawer",
      "admin wide tables/logs must not create console-main horizontal overflow",
      "fix overlap through grid constraints and wrapping, not z-index layering"
    ]
  },
  "homepageFeedDrawerContract": {
    "status": "implemented",
    "source": "apps/web/src/pages/index.astro",
    "styleSource": "apps/web/src/styles/global.css",
    "dataSources": [
      "public-data/runtime/content-index.json",
      "apps/web/src/content/notes",
      "apps/web/src/content/projects",
      "apps/web/public/public-data/books/books-index.json",
      "public-data/books/books.metadata.json",
      "apps/web/src/data/music.ts",
      "apps/web/src/lib/profile.ts",
      "apps/web/src/data/github-overview.emptyinkpot.json"
    ],
    "feedItemTypes": [
      "post",
      "note",
      "project",
      "book",
      "music",
      "github",
      "bilibili",
      "update"
    ],
    "githubFeedVariants": [
      "repo",
      "heatmap",
      "line",
      "language",
      "team"
    ],
    "drawerTypes": [
      "post",
      "note",
      "project",
      "book",
      "music",
      "github",
      "bilibili",
      "update"
    ],
    "implementation": {
      "masonry": "css-columns",
      "drawer": "astro-rendered hidden reader nodes cloned by vanilla js",
      "clientFetch": false,
      "extraDependencies": []
    },
    "hardRules": [
      "do not restore module-stacked homepage as the primary home experience",
      "all homepage feed cards and rail summary actions open drawer without navigation",
      "drawer close restores home-feed-main scrollTop before returning focus",
      "full detail pages remain canonical share and seo routes",
      "bilibili link must be configured in apps/web/src/lib/profile.ts before claiming a real profile"
    ]
  },
  "frontendRefactorPriority": [
    "restructure-homepage-as-console",
    "add-content-status-visibility",
    "upgrade-search-interaction",
    "upgrade-content-page-metadata-and-relations",
    "add-system-bar-and-dashboard-signals"
  ],
  "adminPrototype": {
    "appRoot": "apps/admin-next",
    "routeGroup": "app/admin",
    "pages": [
      "dashboard",
      "content",
      "evidence-library",
      "ai",
      "publish",
      "token-pool",
      "logs"
    ],
    "apiRoutes": [
      "app/api/ai/generate/route.ts",
      "app/api/evidence-library/plan/route.js",
      "app/api/evidence-library/assets/route.js",
      "app/api/evidence-library/queue/route.js",
      "app/api/evidence-library/openlist/scan/route.js",
      "app/api/evidence-library/export/remotion/route.js",
      "app/api/github/repo/route.js",
      "app/api/github/commits/route.js",
      "app/api/github/issues/route.js",
      "app/api/github/pulls/route.js",
      "app/api/github/contributors/route.js",
      "app/api/github/file/read/route.js",
      "app/api/github/file/save/route.js",
      "app/api/projects/[slug]/timeline/route.js",
      "app/api/publish/build/route.ts",
      "app/api/publish/release/route.ts",
      "app/api/publish/rollback/route.ts",
      "app/api/token-pool/status/route.ts"
    ],
    "componentGroups": [
      "components/admin",
      "components/ai",
      "components/publish",
      "components/token-pool"
    ]
  },
  "adminUiLanguage": {
    "background": "neutral-950",
    "card": "neutral-900 border-neutral-800 rounded-2xl",
    "primaryActions": [
      "blue",
      "green"
    ],
    "dangerAction": "red",
    "statusColors": {
      "healthy": "green",
      "success": "green",
      "draft": "yellow",
      "cooldown": "yellow",
      "pending": "yellow",
      "error": "red",
      "failed": "red",
      "ai-generated": "purple"
    },
    "sharedComponentNames": [
      "StatusBadge",
      "MetricCard",
      "ActionButton",
      "LogPanel",
      "StateTimeline",
      "ProviderTable",
      "ChatPanel"
    ]
  },
  "adminDeliveryOrder": {
    "P0": [
      "admin layout",
      "dashboard",
      "publish center static ui",
      "token-pool static table"
    ],
    "P1": [
      "token-pool status api",
      "publish release api",
      "publish rollback api",
      "publish state machine wired to real api"
    ],
    "P2": [
      "ai writer chat ui",
      "ai generate api",
      "token-pool integration",
      "save draft"
    ],
    "P3": [
      "content management page",
      "logs page",
      "analytics",
      "auto publish agent"
    ]
  },
  "qualityGate": [
    "npm run lint",
    "npm run check",
    "npm run build"
  ],
  "status": "active",
  "markdownRenderingSystem": {
    "status": "active",
    "owner": "apps/web/src/lib/markdown/pipeline.ts",
    "styleOwner": "apps/web/src/styles/global.css:.prose-shell",
    "appliesTo": [
      "Astro content posts",
      "Runtime MarkdownObject articles"
    ],
    "stack": [
      "remark-parse",
      "remark-gfm",
      "remark-rehype",
      "rehype-slug",
      "rehype-pretty-code",
      "Shiki",
      "custom Obsidian callout transform",
      "custom table wrapper transform"
    ],
    "rule": "Quartz is a Markdown rendering reference only; MyBlog keeps its Astro presentation shell and shared prose system."
  },
  "remoteFirstSourceRoot": "ubuntu@124.220.233.126:/srv/myblog/repo",
  "localSourceRootStatus": "retired-local-mirror",
  "remoteIdeSourceRoot": "ubuntu@124.220.233.126:/srv/myblog/repo",
  "serverRepoLocalSshKey": "/home/ubuntu/.ssh/myblog_source_ed25519",
  "runtimeDatabase": {
    "status": "active",
    "type": "Tencent Cloud CynosDB Serverless MySQL",
    "clusterId": "cynosdbmysql-no0zqua0",
    "engine": "MySQL 8.0",
    "publicEndpoint": "124.220.245.121:22295",
    "privateEndpoint": "172.17.0.3:3306",
    "privateEndpointStatus": "not-routable-from-current-lighthouse-as-of-2026-05-10",
    "database": "cloudbase-4glvyyq9f61b19cd",
    "user": "openclaw",
    "secretSource": "/etc/myblog-admin-next.env",
    "serviceOwner": "apps/admin-next",
    "schemaOwner": "apps/admin-next/lib/runtime-db.js",
    "connectionEnv": [
      "MYBLOG_DB_HOST",
      "MYBLOG_DB_PORT",
      "MYBLOG_DB_USER",
      "MYBLOG_DB_PASSWORD",
      "MYBLOG_DB_NAME"
    ],
    "activeTables": [
      "reader_memory",
      "reader_highlights",
      "visual_sources",
      "visual_pins",
      "visual_sync_runs",
      "personal_secret_entries"
    ],
    "owns": [
      "reader progress and last-read state",
      "reader highlights and anchors",
      "visual source registry",
      "visual pin runtime index",
      "visual sync run logs"
    ],
    "forbidden": [
      "article markdown body source",
      "EPUB/PDF/image/video blobs",
      "OpenList file objects",
      "Tencent COS objects",
      "Quark netdisk files",
      "Astro dist or Pagefind output",
      "Syncthing hot mirror files"
    ],
    "integrationRole": "dynamic runtime state layer beside OpenList/COS/Quark file storage and Obsidian content truth",
    "plaintextPersonalSecretStore": {
      "status": "active-schema",
      "table": "personal_secret_entries",
      "valueColumn": "secret_value",
      "storageMode": "plaintext-by-user-requirement",
      "purpose": "store personal account/password/API-key style information directly in MySQL as readable text",
      "owner": "apps/admin-next / MySQL Runtime Layer",
      "database": "cloudbase-4glvyyq9f61b19cd",
      "warning": "Values are intentionally stored as plaintext in MySQL; do not commit real values to Git or logs."
    }
  },
  "remoteIntegrationRoot": "server-170:/home/ubuntu/workspaces/MyBlog-production-integration"
}