@goodandready/dsh-github-ops 0.1.0

package/lib/tools/repos.js

@@ -0,0 +1,108 @@
+// Repository and file operations: metadata, file content at a ref, repository
+// search (its own quota), plus repository creation and edits.
+
+function ensureRepo({ owner, repo }) {
+  if (!owner || !repo) {
+    throw new Error('owner and repo are required (pass "repository": "owner/repo" or set defaults in settings)')
+  }
+}
+
+export function normalizeRepo(data) {
+  if (!data || typeof data !== 'object') return data
+  return {
+    fullName: data.full_name,
+    description: data.description || '',
+    private: Boolean(data.private),
+    archived: Boolean(data.archived),
+    defaultBranch: data.default_branch,
+    language: data.language,
+    stars: data.stargazers_count,
+    forks: data.forks_count,
+    openIssues: data.open_issues_count,
+    topics: Array.isArray(data.topics) ? data.topics : [],
+    license: data.license && (data.license.spdx_id || data.license.name),
+    homepage: data.homepage || '',
+    pushedAt: data.pushed_at,
+    updatedAt: data.updated_at,
+    url: data.html_url,
+  }
+}
+
+export async function getRepo(client, { owner, repo }) {
+  ensureRepo({ owner, repo })
+  const { data } = await client.get(`/repos/${owner}/${repo}`)
+  return normalizeRepo(data)
+}
+
+export async function getFile(client, { owner, repo, path, ref }) {
+  ensureRepo({ owner, repo })
+  if (!path) throw new Error('path is required')
+  const { data } = await client.get(`/repos/${owner}/${repo}/contents/${path}`, {
+    query: ref ? { ref } : undefined,
+  })
+  if (Array.isArray(data)) {
+    return {
+      kind: 'directory',
+      path,
+      entries: data.map((e) => ({ name: e.name, type: e.type, size: e.size, path: e.path })),
+    }
+  }
+  const encoded = String((data && data.content) || '').replace(/\n/g, '')
+  const decoded = encoded && String(data.encoding || 'base64') === 'base64'
+    ? Buffer.from(encoded, 'base64').toString('utf8')
+    : String((data && data.content) || '')
+  return {
+    kind: 'file',
+    path: data && data.path ? data.path : path,
+    sha: data && data.sha,
+    size: data && data.size,
+    truncated: Boolean(data && data.truncated),
+    content: decoded,
+  }
+}
+
+export async function searchRepos(client, { query, limit = 20 }) {
+  if (!query) throw new Error('query is required')
+  const capped = Math.max(1, Math.min(Number(limit) || 20, 100))
+  const { data } = await client.get('/search/repositories', {
+    query: { q: query, per_page: capped },
+  })
+  const items = (data && data.items) || []
+  return {
+    total: (data && data.total_count) || items.length,
+    repos: items.map(normalizeRepo),
+  }
+}
+
+export async function createRepo(client, { name, org, description, private: isPrivate = true, autoInit = false }) {
+  if (!name) throw new Error('name is required')
+  const payload = {
+    name,
+    description: description || '',
+    private: Boolean(isPrivate),
+    auto_init: Boolean(autoInit),
+  }
+  const path = org ? `/orgs/${org}/repos` : '/user/repos'
+  const { data } = await client.post(path, payload)
+  return normalizeRepo(data)
+}
+
+export async function editRepo(client, { owner, repo, description, homepage, private: isPrivate, archived, topics }) {
+  ensureRepo({ owner, repo })
+  const payload = {}
+  if (description !== undefined) payload.description = description
+  if (homepage !== undefined) payload.homepage = homepage
+  if (isPrivate !== undefined) payload.private = Boolean(isPrivate)
+  if (archived !== undefined) payload.archived = Boolean(archived)
+  const { data } = Object.keys(payload).length
+    ? await client.patch(`/repos/${owner}/${repo}`, payload)
+    : { data: null }
+  const result = data ? normalizeRepo(data) : await getRepo(client, { owner, repo })
+  if (Array.isArray(topics)) {
+    // The topics endpoint is separate and its response is the only place the applied
+    // list is reported: a PATCH response may still carry the previous topics.
+    const { data: topicData } = await client.put(`/repos/${owner}/${repo}/topics`, { names: topics })
+    if (topicData && Array.isArray(topicData.names)) result.topics = topicData.names
+  }
+  return result
+}

package/lib/tools/tags.js

@@ -0,0 +1,68 @@
+// Tag (git ref) operations. Tags are refs under refs/tags; creating an annotated
+// tag needs a tag object first, a lightweight tag is a plain ref.
+
+function ensureRepo({ owner, repo }) {
+  if (!owner || !repo) {
+    throw new Error('owner and repo are required (pass "repository": "owner/repo" or set defaults in settings)')
+  }
+}
+
+export async function listTags(client, { owner, repo, limit = 100 } = {}) {
+  ensureRepo({ owner, repo })
+  const capped = Math.max(1, Math.min(Number(limit) || 100, 100))
+  const refs = await client.paginate(`/repos/${owner}/${repo}/git/refs/tags`, {
+    pageSize: Math.min(capped, 100),
+    maxItems: capped,
+  })
+  const tags = refs.map((ref) => ({
+    name: String(ref.ref || '').replace('refs/tags/', ''),
+    sha: ref.object && ref.object.sha,
+    type: ref.object && ref.object.type,
+  }))
+  return { tags, count: tags.length }
+}
+
+export async function getTag(client, { owner, repo, tag }) {
+  ensureRepo({ owner, repo })
+  if (!tag) throw new Error('tag is required')
+  const { data } = await client.get(`/repos/${owner}/${repo}/git/ref/tags/${encodeURIComponent(tag)}`)
+  return { name: tag, sha: data && data.object && data.object.sha, type: data && data.object && data.object.type }
+}
+
+/**
+ * Create a tag. With `message` the tag is annotated: GitHub needs a tag object,
+ * so the tag object is created first and the ref points at it.
+ */
+export async function createTag(client, { owner, repo, tag, sha, message }) {
+  ensureRepo({ owner, repo })
+  if (!tag) throw new Error('tag is required')
+  let target = sha
+  if (!target) {
+    const { data } = await client.get(`/repos/${owner}/${repo}/commits/HEAD`)
+    target = data && data.sha
+    if (!target) throw new Error('cannot resolve HEAD to tag')
+  }
+  let refTarget = target
+  if (message) {
+    const { data: tagObject } = await client.post(`/repos/${owner}/${repo}/git/tags`, {
+      tag,
+      message,
+      object: target,
+      type: 'commit',
+    })
+    refTarget = tagObject && tagObject.sha
+    if (!refTarget) throw new Error('cannot create annotated tag object')
+  }
+  const { data } = await client.post(`/repos/${owner}/${repo}/git/refs`, {
+    ref: `refs/tags/${tag}`,
+    sha: refTarget,
+  })
+  return { name: tag, sha: refTarget, target, annotated: Boolean(message), url: data && data.url }
+}
+
+export async function deleteTag(client, { owner, repo, tag }) {
+  ensureRepo({ owner, repo })
+  if (!tag) throw new Error('tag is required')
+  await client.del(`/repos/${owner}/${repo}/git/refs/tags/${encodeURIComponent(tag)}`)
+  return { deleted: true, tag }
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@goodandready/dsh-github-ops",
+  "version": "0.1.0",
+  "description": "GitHub operations for DeepSeek Harness: releases, tags, a guarded generic API pass-through, workflow runs, secrets and sanitized mirror publication.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "LICENSE",
+    "CHANGELOG.md",
+    "README.md",
+    "README.zh.md",
+    "README.ru.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ]
+    }
+  },
+  "scripts": {
+    "pretest": "for f in lib/index.js lib/github.js lib/tools/*.js; do node --check \"$f\" || exit 1; done",
+    "test": "node --test test/*.test.mjs"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.8",
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.8",
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GooDAnDReaDY/dsh-github-ops.git"
+  },
+  "homepage": "https://github.com/GooDAnDReaDY/dsh-github-ops#readme",
+  "bugs": {
+    "url": "https://github.com/GooDAnDReaDY/dsh-github-ops/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "GooDAnDReaDY <support@goodandready.app>",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "github",
+    "releases",
+    "tags",
+    "mirror",
+    "ci"
+  ]
+}