@morehao/dsh-github-trending 0.0.0-stage → 0.1.0

package/contract/CONTRACT.sha256

@@ -0,0 +1,10 @@
+# trendradar contract hash (v1)
+# algorithm: sha256 per file (sorted), then sha256 of the concatenated lines
+f34aa3642938bad32df912768d543925f91858da66a8e726e4e4bf88a07d086c  fixtures/digest-degraded.json
+7bc67dcdc36c7b81df1915c4b50025cef6f0304ef2feb24f393d17771df252c9  fixtures/digest-empty-lang.json
+4fe9d91ce3f0ddcc17982e4f0acac950ebc6ec7f63427fe962ea581f3114c0c4  fixtures/digest-normal.json
+d52adbbb473d7ee2d856398a5651f96ba2019ee53ba6e14c27ef2d792b5db723  schema/api.v1.yaml
+ca9b640f374cded12a09ea00f0686eac14eee59eef94c27a61016175bc0d4ebb  schema/digest.v1.json
+16f8f69c8a01da905b2653fb360eea798c1773808737251b54f1f56b134dad22  schema/ipc.v1.json
+2140c9d538bc935c092a83fb6377e3878b2c060992bf458f2437898f4649d41d  schema/model.v1.json
+aggregate: eb7f1ac9e117a709d15d87de89cf30e309c479e62dfa3d320cb8f154d3f1dc1e

package/contract/UPSTREAM.json

@@ -0,0 +1,37 @@
+{
+  "repo": "https://github.com/morehao/trendradar.git",
+  "ref": "d3bf720",
+  "commit": "d3bf720a869732e7a2ee04fa39d32dd50868fd61",
+  "aggregate": "eb7f1ac9e117a709d15d87de89cf30e309c479e62dfa3d320cb8f154d3f1dc1e",
+  "syncedAt": "2026-10-30T13:20:43.663Z",
+  "files": [
+    {
+      "path": "schema/api.v1.yaml",
+      "sha256": "d52adbbb473d7ee2d856398a5651f96ba2019ee53ba6e14c27ef2d792b5db723"
+    },
+    {
+      "path": "schema/digest.v1.json",
+      "sha256": "ca9b640f374cded12a09ea00f0686eac14eee59eef94c27a61016175bc0d4ebb"
+    },
+    {
+      "path": "schema/ipc.v1.json",
+      "sha256": "16f8f69c8a01da905b2653fb360eea798c1773808737251b54f1f56b134dad22"
+    },
+    {
+      "path": "schema/model.v1.json",
+      "sha256": "2140c9d538bc935c092a83fb6377e3878b2c060992bf458f2437898f4649d41d"
+    },
+    {
+      "path": "fixtures/digest-degraded.json",
+      "sha256": "f34aa3642938bad32df912768d543925f91858da66a8e726e4e4bf88a07d086c"
+    },
+    {
+      "path": "fixtures/digest-empty-lang.json",
+      "sha256": "7bc67dcdc36c7b81df1915c4b50025cef6f0304ef2feb24f393d17771df252c9"
+    },
+    {
+      "path": "fixtures/digest-normal.json",
+      "sha256": "4fe9d91ce3f0ddcc17982e4f0acac950ebc6ec7f63427fe962ea581f3114c0c4"
+    }
+  ]
+}

package/contract/fixtures/digest-degraded.json

@@ -0,0 +1,39 @@
+{
+  "schema": 1,
+  "date": "2026-10-30",
+  "period": "daily",
+  "languages": ["all", "go"],
+  "count": 2,
+  "degraded": true,
+  "contentHash": "sha256:b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2",
+  "coreVersion": "0.1.0",
+  "generatedAt": "2026-10-30T00:05:00Z",
+  "repos": [
+    {
+      "fullName": "golang/go",
+      "url": "https://github.com/golang/go",
+      "description": "The Go programming language",
+      "language": "go",
+      "stars": 126000,
+      "starsInPeriod": 0,
+      "forks": 17800,
+      "rank": 1,
+      "source": "search-api",
+      "summaryZh": "[原文] The Go programming language",
+      "summarySource": "original"
+    },
+    {
+      "fullName": "gin-gonic/gin",
+      "url": "https://github.com/gin-gonic/gin",
+      "description": "HTTP web framework written in Go",
+      "language": "go",
+      "stars": 80200,
+      "starsInPeriod": 0,
+      "forks": 8100,
+      "rank": 2,
+      "source": "search-api",
+      "summaryZh": "[原文] HTTP web framework written in Go",
+      "summarySource": "original"
+    }
+  ]
+}

package/contract/fixtures/digest-empty-lang.json

@@ -0,0 +1,39 @@
+{
+  "schema": 1,
+  "date": "2026-10-30",
+  "period": "daily",
+  "languages": ["all", "unknown"],
+  "count": 2,
+  "degraded": false,
+  "contentHash": "sha256:c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2",
+  "coreVersion": "0.1.0",
+  "generatedAt": "2026-10-30T00:05:00Z",
+  "repos": [
+    {
+      "fullName": "someorg/no-language",
+      "url": "https://github.com/someorg/no-language",
+      "description": "A repo whose primary language could not be detected",
+      "language": "unknown",
+      "stars": 1200,
+      "starsInPeriod": 40,
+      "forks": 30,
+      "rank": 1,
+      "source": "trending-html",
+      "summaryZh": "语言未知的仓库，热度进入榜单。",
+      "summarySource": "model"
+    },
+    {
+      "fullName": "someorg/aggregate-only",
+      "url": "https://github.com/someorg/aggregate-only",
+      "description": "Repo surfaced only in the all-languages list",
+      "language": "unknown",
+      "stars": 980,
+      "starsInPeriod": 33,
+      "forks": 12,
+      "rank": 2,
+      "source": "trending-html",
+      "summaryZh": "仅在全局榜单出现的仓库。",
+      "summarySource": "model"
+    }
+  ]
+}

package/contract/fixtures/digest-normal.json

@@ -0,0 +1,91 @@
+{
+  "schema": 1,
+  "date": "2026-10-30",
+  "period": "daily",
+  "languages": ["all", "go", "python", "rust"],
+  "count": 6,
+  "degraded": false,
+  "contentHash": "sha256:3f7a2c9e1b4d5a6f8c0e2d4b6a8f0c2e4d6b8a0f2c4e6d8b0a2f4c6e8d0b2a4f",
+  "coreVersion": "0.1.0",
+  "generatedAt": "2026-10-30T00:05:00Z",
+  "repos": [
+    {
+      "fullName": "golang/go",
+      "url": "https://github.com/golang/go",
+      "description": "The Go programming language",
+      "language": "go",
+      "stars": 126000,
+      "starsInPeriod": 320,
+      "forks": 17800,
+      "rank": 1,
+      "source": "trending-html",
+      "summaryZh": "Go 官方仓库，今日新增 star 位居榜单前列。",
+      "summarySource": "model"
+    },
+    {
+      "fullName": "gin-gonic/gin",
+      "url": "https://github.com/gin-gonic/gin",
+      "description": "HTTP web framework written in Go",
+      "language": "go",
+      "stars": 80200,
+      "starsInPeriod": 210,
+      "forks": 8100,
+      "rank": 2,
+      "source": "trending-html",
+      "summaryZh": "流行的 Go Web 框架，热度持续。",
+      "summarySource": "model"
+    },
+    {
+      "fullName": "python/cpython",
+      "url": "https://github.com/python/cpython",
+      "description": "The Python programming language",
+      "language": "python",
+      "stars": 64500,
+      "starsInPeriod": 180,
+      "forks": 30500,
+      "rank": 3,
+      "source": "trending-html",
+      "summaryZh": "CPython 官方实现，今日关注度上升。",
+      "summarySource": "model"
+    },
+    {
+      "fullName": "psf/requests",
+      "url": "https://github.com/psf/requests",
+      "description": "A simple, yet elegant HTTP library",
+      "language": "python",
+      "stars": 52500,
+      "starsInPeriod": 95,
+      "forks": 9400,
+      "rank": 4,
+      "source": "trending-html",
+      "summaryZh": "经典 Python HTTP 库，稳居热榜。",
+      "summarySource": "model"
+    },
+    {
+      "fullName": "rust-lang/rust",
+      "url": "https://github.com/rust-lang/rust",
+      "description": "Empowering everyone to build reliable and efficient software",
+      "language": "rust",
+      "stars": 102000,
+      "starsInPeriod": 260,
+      "forks": 13200,
+      "rank": 5,
+      "source": "trending-html",
+      "summaryZh": "Rust 语言主仓库，社区活跃。",
+      "summarySource": "model"
+    },
+    {
+      "fullName": "tokio-rs/tokio",
+      "url": "https://github.com/tokio-rs/tokio",
+      "description": "A runtime for writing reliable asynchronous applications with Rust",
+      "language": "rust",
+      "stars": 28600,
+      "starsInPeriod": 120,
+      "forks": 2650,
+      "rank": 6,
+      "source": "trending-html",
+      "summaryZh": "Rust 异步运行时，性能方向关注度高。",
+      "summarySource": "model"
+    }
+  ]
+}

package/contract/schema/api.v1.yaml

@@ -0,0 +1,70 @@
+openapi: 3.1.0
+info:
+  title: trendradar serve API
+  version: 1.0.0
+  description: |
+    Read-only HTTP surface exposed by `trendradar serve`. All payloads reuse the
+    digest.v1 schema, so the plugin can consume the same shape whether data comes
+    from the filesystem or over HTTP.
+servers:
+  - url: http://127.0.0.1:8787
+paths:
+  /api/v1/digests/{date}:
+    get:
+      operationId: getDigest
+      summary: Fetch one day's digest
+      parameters:
+        - name: date
+          in: path
+          required: true
+          schema:
+            type: string
+            format: date
+      responses:
+        "200":
+          description: The digest document
+          content:
+            application/json:
+              schema:
+                $ref: "./digest.v1.json"
+        "404":
+          description: No digest for that date
+  /api/v1/manifest:
+    get:
+      operationId: getManifest
+      summary: List available dates and their contentHash
+      responses:
+        "200":
+          description: Manifest of available digests
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [entries]
+                properties:
+                  coreVersion:
+                    type: string
+                  entries:
+                    type: array
+                    items:
+                      type: object
+                      required: [date, contentHash]
+                      properties:
+                        date:
+                          type: string
+                          format: date
+                        contentHash:
+                          type: string
+                        degraded:
+                          type: boolean
+  /feed.xml:
+    get:
+      operationId: getFeed
+      summary: RSS feed of the most recent digests
+      responses:
+        "200":
+          description: RSS 2.0 feed
+          content:
+            application/rss+xml:
+              schema:
+                type: string

package/contract/schema/digest.v1.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/morehao/trendradar/contract/schema/digest.v1.json",
+  "title": "trendradar digest v1",
+  "description": "One day's rendered digest document. contentHash is stable across runs (generatedAt/coreVersion excluded).",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema", "date", "period", "languages", "count", "degraded", "contentHash", "repos"],
+  "properties": {
+    "schema": { "const": 1 },
+    "date": { "type": "string", "format": "date" },
+    "period": { "type": "string", "enum": ["daily", "weekly", "monthly"] },
+    "languages": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+    "count": { "type": "integer", "minimum": 0 },
+    "degraded": { "type": "boolean" },
+    "contentHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "coreVersion": { "type": "string" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "repos": {
+      "type": "array",
+      "items": { "$ref": "model.v1.json#/$defs/RepoDigest" }
+    }
+  }
+}

package/contract/schema/ipc.v1.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/morehao/trendradar/contract/schema/ipc.v1.json",
+  "title": "trendradar ipc v1",
+  "description": "Envelope exchanged between the trendradar core binary and the DSH plugin. Only RunRequest forbids extra fields.",
+  "oneOf": [
+    { "$ref": "#/$defs/RunRequest" },
+    { "$ref": "#/$defs/RunResult" }
+  ],
+  "$defs": {
+    "ErrorCode": {
+      "type": "string",
+      "enum": [
+        "INTERNAL",
+        "CONFIG_INVALID",
+        "PAYLOAD_TOO_LARGE",
+        "FETCH_FAILED",
+        "FETCH_RATE_LIMITED",
+        "PARSE_FAILED",
+        "MODEL_UNAUTHORIZED",
+        "MODEL_RATE_LIMITED",
+        "MODEL_TIMEOUT",
+        "MODEL_FAILED",
+        "MODEL_BAD_OUTPUT",
+        "GIT_NOT_INSTALLED",
+        "REPO_NOT_GIT",
+        "REPO_DIRTY",
+        "GIT_OPERATION_FAILED",
+        "PR_FAILED",
+        "NOT_MERGEABLE"
+      ]
+    },
+    "ErrorInfo": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["code", "message", "retriable"],
+      "properties": {
+        "code": { "$ref": "#/$defs/ErrorCode" },
+        "message": { "type": "string" },
+        "retriable": { "type": "boolean" },
+        "details": { "type": "object", "additionalProperties": true }
+      }
+    },
+    "FileArtifact": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["path", "bytes", "sha256"],
+      "properties": {
+        "path": { "type": "string" },
+        "bytes": { "type": "integer", "minimum": 0 },
+        "sha256": { "type": "string" }
+      }
+    },
+    "RunRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ipcSchema", "command"],
+      "properties": {
+        "ipcSchema": { "const": 1 },
+        "command": { "type": "string", "enum": ["run", "serve", "config", "version"] },
+        "configPath": { "type": "string" },
+        "date": { "type": "string", "format": "date" },
+        "dryRun": { "type": "boolean" },
+        "outputDir": { "type": "string" }
+      }
+    },
+    "RunResult": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["ipcSchema", "ok", "command", "startedAt", "finishedAt", "skipped", "files"],
+      "properties": {
+        "ipcSchema": { "const": 1 },
+        "ok": { "type": "boolean" },
+        "command": { "type": "string", "enum": ["run", "serve", "config", "version"] },
+        "startedAt": { "type": "string", "format": "date-time" },
+        "finishedAt": { "type": "string", "format": "date-time" },
+        "skipped": { "type": "boolean" },
+        "files": { "type": "array", "items": { "$ref": "#/$defs/FileArtifact" } },
+        "error": { "$ref": "#/$defs/ErrorInfo" },
+        "warnings": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "StateRun": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["date", "contentHash", "runAt"],
+      "properties": {
+        "date": { "type": "string", "format": "date" },
+        "contentHash": { "type": "string" },
+        "runAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "State": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["ipcSchema"],
+      "properties": {
+        "ipcSchema": { "const": 1 },
+        "lastRun": { "$ref": "#/$defs/StateRun" }
+      }
+    }
+  }
+}

package/contract/schema/model.v1.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/morehao/trendradar/contract/schema/model.v1.json",
+  "title": "trendradar model v1",
+  "description": "Domain model: a scraped repository snapshot and its digested form.",
+  "$ref": "#/$defs/RepoSnapshot",
+  "$defs": {
+    "RepoSnapshot": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["fullName", "url", "language", "stars", "starsInPeriod", "rank", "source"],
+      "properties": {
+        "fullName": { "type": "string", "pattern": "^[^/]+/[^/]+$" },
+        "url": { "type": "string", "format": "uri" },
+        "description": { "type": "string" },
+        "language": { "type": "string" },
+        "stars": { "type": "integer", "minimum": 0 },
+        "starsInPeriod": { "type": "integer", "minimum": 0 },
+        "forks": { "type": "integer", "minimum": 0 },
+        "rank": { "type": "integer", "minimum": 1 },
+        "source": { "type": "string", "enum": ["trending-html", "search-api"] }
+      }
+    },
+    "RepoDigest": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": [
+        "fullName", "url", "language", "stars", "starsInPeriod", "rank",
+        "source", "summaryZh", "summarySource"
+      ],
+      "properties": {
+        "fullName": { "type": "string", "pattern": "^[^/]+/[^/]+$" },
+        "url": { "type": "string", "format": "uri" },
+        "description": { "type": "string" },
+        "language": { "type": "string" },
+        "stars": { "type": "integer", "minimum": 0 },
+        "starsInPeriod": { "type": "integer", "minimum": 0 },
+        "forks": { "type": "integer", "minimum": 0 },
+        "rank": { "type": "integer", "minimum": 1 },
+        "source": { "type": "string", "enum": ["trending-html", "search-api"] },
+        "summaryZh": { "type": "string" },
+        "summarySource": { "type": "string", "enum": ["model", "original"] }
+      }
+    }
+  }
+}

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# dsh-github-trending profile bundle patch
+# `name` 是宿主 import() 用的模块标识符，必须与 npm 包名一致。
+# `id` 是 cordis 配置树内的键，与插件导出的插件名保持一致。
+#
+# config 只放「安装形态」相关的覆盖项；用户设置（模型 / 仓库 / 调度等）在
+# $DSH_HOME/github-trending/settings.json，由设置页写入，不进 profile 补丁。
+- insert:
+    - id: dsh-github-trending
+      name: '@morehao/dsh-github-trending'
+      config: {}

package/icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect x="4" y="4" width="56" height="56" rx="14" fill="#0d1117"/>
+  <path d="M18 46V22l14 12 14-12v24" fill="none" stroke="#58a6ff" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="32" cy="45" r="3" fill="#3fb950"/>
+</svg>