harness-alchemist 0.1.0

package/templates/v0.1.0/universal-typescript/.agents/skills/develop-template/scripts/sync-metadata.mjs.tpl

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+
+import { existsSync } from "node:fs"
+import { readFile, writeFile } from "node:fs/promises"
+import { dirname, join, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+function findRoot(start) {
+  let current = resolve(start)
+  while (true) {
+    if (existsSync(join(current, "package.json")) && existsSync(join(current, ".claude-plugin"))) {
+      return current
+    }
+    const parent = dirname(current)
+    if (parent === current) return undefined
+    current = parent
+  }
+}
+
+async function readJson(path) {
+  return JSON.parse(await readFile(path, "utf8"))
+}
+
+async function writeJson(path, value) {
+  await writeFile(path, `${JSON.stringify(value, null, 2)}\n`)
+}
+
+function authorObject(author, repository) {
+  if (typeof author === "string") return { name: author }
+  if (author && typeof author === "object") return author
+  return { name: "Plugin contributors", url: repository }
+}
+
+const scriptDirectory = dirname(fileURLToPath(import.meta.url))
+const root = findRoot(process.cwd()) ?? findRoot(scriptDirectory)
+if (!root) throw new Error("Could not find the plugin project root")
+const packagePath = join(root, "package.json")
+const packageJson = await readJson(packagePath)
+const pluginName = packageJson.name?.split("/").at(-1)
+
+if (!pluginName || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(pluginName)) {
+  throw new Error("package.json name must have a lowercase kebab-case basename")
+}
+
+const repository = typeof packageJson.repository === "string"
+  ? packageJson.repository
+  : packageJson.repository?.url
+const author = authorObject(packageJson.author, repository)
+
+if (!packageJson.version || !packageJson.description || !repository || !packageJson.license) {
+  throw new Error("package.json requires version, description, repository, and license")
+}
+
+const claudePath = join(root, ".claude-plugin/plugin.json")
+const claude = await readJson(claudePath)
+Object.assign(claude, {
+  name: pluginName,
+  version: packageJson.version,
+  description: packageJson.description,
+  author,
+  homepage: repository,
+  repository,
+  license: packageJson.license,
+})
+await writeJson(claudePath, claude)
+
+const codexPath = join(root, ".codex-plugin/plugin.json")
+const codex = await readJson(codexPath)
+Object.assign(codex, {
+  name: pluginName,
+  version: packageJson.version,
+  description: packageJson.description,
+  author: { ...author, url: author.url ?? repository },
+  homepage: repository,
+  repository,
+  license: packageJson.license,
+})
+await writeJson(codexPath, codex)
+
+const antigravityPath = join(root, "plugin.json")
+const antigravity = await readJson(antigravityPath)
+Object.assign(antigravity, { name: pluginName, description: packageJson.description })
+await writeJson(antigravityPath, antigravity)
+
+const claudeMarketplacePath = join(root, ".claude-plugin/marketplace.json")
+const claudeMarketplace = await readJson(claudeMarketplacePath)
+claudeMarketplace.owner = author
+const claudeEntry = claudeMarketplace.plugins?.find((entry) => entry.name === pluginName)
+if (!claudeEntry) throw new Error("Claude marketplace does not contain the package plugin")
+Object.assign(claudeEntry, { description: packageJson.description, author })
+await writeJson(claudeMarketplacePath, claudeMarketplace)
+
+const codexMarketplacePath = join(root, ".agents/plugins/marketplace.json")
+const codexMarketplace = await readJson(codexMarketplacePath)
+const codexEntry = codexMarketplace.plugins?.find((entry) => entry.name === pluginName)
+if (!codexEntry) throw new Error("Codex marketplace does not contain the package plugin")
+await writeJson(codexMarketplacePath, codexMarketplace)
+
+const cordisPath = join(root, "cordis.patch.yml")
+const cordisLines = (await readFile(cordisPath, "utf8")).split("\n")
+let updatedCordisEntry = false
+
+for (let index = 0; index < cordisLines.length; index += 1) {
+  const idMatch = cordisLines[index].match(/^(\s*)-\s+id:\s*['\"]?([^'\"\s]+)['\"]?\s*$/)
+  if (!idMatch || idMatch[2] !== pluginName) continue
+
+  const idIndent = idMatch[1].length
+  for (let next = index + 1; next < cordisLines.length; next += 1) {
+    const line = cordisLines[next]
+    if (line.trim() && line.search(/\S/) <= idIndent) break
+    const nameMatch = line.match(/^(\s*)name:\s*.+$/)
+    if (nameMatch) {
+      cordisLines[next] = `${nameMatch[1]}name: '${packageJson.name}/deepseek'`
+      updatedCordisEntry = true
+      break
+    }
+  }
+  break
+}
+
+if (!updatedCordisEntry) throw new Error(`Could not find Cordis entry '${pluginName}' to update`)
+await writeFile(cordisPath, cordisLines.join("\n"))
+
+console.log(`Synchronized plugin manifests from ${packagePath}`)

package/templates/v0.1.0/universal-typescript/.claude-plugin/marketplace.json.tpl

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": {{MARKETPLACE_JSON}},
+  "description": "Plugin marketplace for {{DISPLAY_NAME}}.",
+  "owner": {
+    "name": {{AUTHOR_JSON}}
+  },
+  "plugins": [
+    {
+      "name": {{NAME_JSON}},
+      "displayName": {{DISPLAY_NAME_JSON}},
+      "description": {{DESCRIPTION_JSON}},
+      "author": {
+        "name": {{AUTHOR_JSON}}
+      },
+      "source": "./"
+    }
+  ]
+}

package/templates/v0.1.0/universal-typescript/.claude-plugin/plugin.json.tpl

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
+  "name": {{NAME_JSON}},
+  "displayName": {{DISPLAY_NAME_JSON}},
+  "version": "0.1.0",
+  "description": {{DESCRIPTION_JSON}},
+  "author": {
+    "name": {{AUTHOR_JSON}}
+  },
+  "homepage": {{REPOSITORY_URL_JSON}},
+  "repository": {{REPOSITORY_URL_JSON}},
+  "license": {{LICENSE_JSON}},
+  "skills": "./skills/"
+}

package/templates/v0.1.0/universal-typescript/.codex-plugin/plugin.json.tpl

@@ -0,0 +1,13 @@
+{
+  "name": {{NAME_JSON}},
+  "version": "0.1.0",
+  "description": {{DESCRIPTION_JSON}},
+  "author": {
+    "name": {{AUTHOR_JSON}},
+    "url": {{REPOSITORY_URL_JSON}}
+  },
+  "homepage": {{REPOSITORY_URL_JSON}},
+  "repository": {{REPOSITORY_URL_JSON}},
+  "license": {{LICENSE_JSON}},
+  "skills": "./skills/"
+}

package/templates/v0.1.0/universal-typescript/.github/workflows/npm-publish.yml.tpl

@@ -0,0 +1,43 @@
+name: Publish npm package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 22.20.0
+          registry-url: https://registry.npmjs.org
+
+      - name: Resolve release version
+        id: version
+        shell: bash
+        run: |
+          TAG="${{ github.event.release.tag_name }}"
+          VERSION="${TAG#v}"
+          if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$ ]]; then
+            echo "::error::Tag '$TAG' is not a valid semver version"
+            exit 1
+          fi
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+      - run: npm ci
+      - name: Set package version from tag
+        run: npm version "${{ steps.version.outputs.version }}" --no-git-tag-version --allow-same-version
+      - run: npm run sync
+      - run: npm run verify
+      - name: Verify npm package contents
+        run: npm pack --dry-run
+      - name: Publish npm package
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/templates/v0.1.0/universal-typescript/.gitignore.tpl

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+coverage/
+*.tgz
+.DS_Store
+.env
+.env.*
+!.env.example
+*.log

package/templates/v0.1.0/universal-typescript/AGENTS.md.tpl

@@ -0,0 +1,16 @@
+# Repository Guidance
+
+This generated repository packages one shared Agent Skill with separate runtime
+entrypoints for several coding-agent harnesses.
+
+- `skills/{{NAME}}/SKILL.md` is the plugin's end-user workflow; keep its
+  instructions portable and domain-specific.
+- `.agents/skills/develop-{{NAME}}/` is the project-maintenance workflow. Read
+  it before changing manifests, metadata, or runtime entrypoints.
+- Keep OpenCode behavior in `src/opencode.ts`; keep Cordis behavior in
+  `src/deepseek.ts` with named exports and no default export.
+- Treat `package.json` as canonical metadata and run `npm run sync` after
+  metadata changes.
+- Keep manifest paths inside the repository. Do not add invented connector IDs,
+  credentials, legal URLs, or presentation assets.
+- Run `npm run verify` before reporting a change complete.

package/templates/v0.1.0/universal-typescript/README.md.tpl

@@ -0,0 +1,131 @@
+# {{DISPLAY_NAME}}
+
+{{DESCRIPTION}}
+
+This repository packages one shared Agent Skill and separate runtime entrypoints for Claude Code, Codex/ChatGPT, OpenCode, Google Antigravity, and DeepSeek Harness/Cordis.
+
+## Structure
+
+```text
+.claude-plugin/              Claude plugin and marketplace manifests
+.codex-plugin/               Codex/ChatGPT plugin manifest
+.agents/plugins/             Codex repository marketplace
+.agents/skills/              Project development skill
+.github/workflows/           GitHub release publishing
+skills/                      Shared installable Agent Skills
+src/opencode.ts              OpenCode npm plugin entrypoint
+src/deepseek.ts              Cordis plugin entrypoint
+cordis.patch.yml             DeepSeek Harness bundle layer
+plugin.json                  Antigravity plugin manifest
+```
+
+The initial runtime entrypoints are intentionally inert. Add only the hooks, tools, or services the plugin actually needs.
+
+## Skill Boundaries
+
+`skills/{{NAME}}/SKILL.md` is the plugin's shared end-user workflow. Replace
+its starter procedure with the plugin's domain-specific behavior.
+
+`.agents/skills/develop-{{NAME}}/` is this repository's maintenance skill. It
+identifies where shared skills, manifests, runtime code, and metadata belong;
+load it before changing those surfaces.
+
+## Development
+
+Requires Node.js 22.20 or newer.
+
+```bash
+npm install
+npm run verify
+```
+
+After changing the version, description, author, repository, or license in `package.json`, synchronize the harness manifests:
+
+```bash
+npm run sync
+npm run verify
+```
+
+Inspect the npm payload before publishing:
+
+```bash
+npm pack --dry-run
+```
+
+## GitHub Release Publishing
+
+`.github/workflows/npm-publish.yml` publishes when a GitHub release is
+published. Tag the release as `vX.Y.Z` (or a semver prerelease such as
+`vX.Y.Z-rc.1`); the workflow applies that version, synchronizes manifests,
+verifies the package, and publishes with npm provenance.
+
+Configure the repository `NPM_TOKEN` secret with an npm publish token before
+creating a release.
+
+## Claude Code
+
+```bash
+claude plugin marketplace add {{REPOSITORY_SOURCE}}
+claude plugin install {{NAME}}@{{MARKETPLACE}}
+```
+
+For local development:
+
+```bash
+claude --plugin-dir .
+claude plugin validate . --strict
+```
+
+## Codex and ChatGPT
+
+```bash
+codex plugin marketplace add {{REPOSITORY_SOURCE}}
+```
+
+Open `/plugins`, install **{{DISPLAY_NAME}}**, and start a new session.
+
+## OpenCode
+
+After publishing `{{PACKAGE_NAME}}`, add it to `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [{{PACKAGE_NAME_JSON}}]
+}
+```
+
+Install the shared skill separately:
+
+```bash
+npx skills add {{REPOSITORY_SOURCE}} --agent opencode
+```
+
+## Google Antigravity
+
+Clone the repository and install its root as a plugin:
+
+```bash
+agy plugin install /absolute/path/to/{{NAME}}
+```
+
+Antigravity also discovers repository-local development skills from `.agents/skills/`.
+
+## DeepSeek Harness
+
+After publishing the npm package:
+
+```bash
+dsh plugin --profile demo add {{PACKAGE_NAME}}
+dsh --profile demo --dump-config
+```
+
+The bundle loads `{{PACKAGE_NAME}}/deepseek`. Install the shared Agent Skill separately when the workflow needs it:
+
+```bash
+npx skills add {{REPOSITORY_SOURCE}}
+```
+
+## License
+
+{{LICENSE}}

package/templates/v0.1.0/universal-typescript/cordis.patch.yml.tpl

@@ -0,0 +1,3 @@
+- insert:
+    - id: {{NAME}}
+      name: '{{PACKAGE_NAME}}/deepseek'

package/templates/v0.1.0/universal-typescript/package.json.tpl

@@ -0,0 +1,70 @@
+{
+  "name": {{PACKAGE_NAME_JSON}},
+  "version": "0.1.0",
+  "description": {{DESCRIPTION_JSON}},
+  "type": "module",
+  "main": "./dist/opencode.js",
+  "types": "./dist/opencode.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/opencode.d.ts",
+      "import": "./dist/opencode.js"
+    },
+    "./deepseek": {
+      "types": "./dist/deepseek.d.ts",
+      "import": "./dist/deepseek.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "cordis.patch.yml",
+    ".claude-plugin/plugin.json",
+    ".codex-plugin/plugin.json",
+    "plugin.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "sync": "node .agents/skills/develop-{{NAME}}/scripts/sync-metadata.mjs",
+    "validate": "node .agents/skills/develop-{{NAME}}/scripts/validate.mjs",
+    "pack:check": "node .agents/skills/develop-{{NAME}}/scripts/check-package.mjs",
+    "verify": "npm run check && npm test && npm run validate && npm run pack:check",
+    "prepack": "npm run verify"
+  },
+  "engines": {
+    "node": ">=22.20.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@opencode-ai/plugin": "^1.18.21"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@opencode-ai/plugin": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@opencode-ai/plugin": "^1.18.21",
+    "typescript": "^5.9.3"
+  },
+  "author": {{AUTHOR_JSON}},
+  "license": {{LICENSE_JSON}},
+  "repository": {
+    "type": "git",
+    "url": {{REPOSITORY_URL_JSON}}
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}

package/templates/v0.1.0/universal-typescript/plugin.json.tpl

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": {{NAME_JSON}},
+  "description": {{DESCRIPTION_JSON}}
+}

package/templates/v0.1.0/universal-typescript/skills/shared-skill/SKILL.md.tpl

@@ -0,0 +1,18 @@
+---
+name: {{NAME}}
+description: {{SHARED_SKILL_DESCRIPTION_JSON}}
+---
+
+# {{DISPLAY_NAME}}
+
+Apply the {{DISPLAY_NAME}} workflow to the user's request.
+
+## Workflow
+
+1. Confirm the requested outcome and inspect the relevant project context.
+2. Perform the smallest complete change that satisfies the request.
+3. Use harness-provided tools only when they are needed for the workflow.
+4. Verify the result with the project's available checks.
+5. Report the outcome and any unresolved external dependency.
+
+Replace this starter workflow with the plugin's domain-specific procedure as the capability develops.

package/templates/v0.1.0/universal-typescript/src/deepseek.ts.tpl

@@ -0,0 +1,7 @@
+import type { Context } from "@deepseek-ai/cordis"
+
+export const name = {{NAME_JSON}}
+
+export function apply(_context: Context): void {
+  // Register Cordis services, tools, or lifecycle effects here.
+}

package/templates/v0.1.0/universal-typescript/src/opencode.ts.tpl

@@ -0,0 +1,7 @@
+import type { Plugin } from "@opencode-ai/plugin"
+
+const plugin = (async () => {
+  return {}
+}) satisfies Plugin
+
+export default plugin

package/templates/v0.1.0/universal-typescript/tests/runtimes.test.mjs.tpl

@@ -0,0 +1,15 @@
+import assert from "node:assert/strict"
+import test from "node:test"
+
+import opencodePlugin from "../dist/opencode.js"
+import * as deepseekPlugin from "../dist/deepseek.js"
+
+test("OpenCode entrypoint returns an inert hooks object", async () => {
+  assert.deepEqual(await opencodePlugin({}), {})
+})
+
+test("DeepSeek entrypoint exposes a Cordis namespace plugin", () => {
+  assert.equal(deepseekPlugin.name, {{NAME_JSON}})
+  assert.equal(typeof deepseekPlugin.apply, "function")
+  assert.equal("default" in deepseekPlugin, false)
+})

package/templates/v0.1.0/universal-typescript/tsconfig.json.tpl

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "rootDir": "src",
+    "outDir": "dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true,
+    "noUncheckedIndexedAccess": true
+  },
+  "include": ["src/**/*.ts"]
+}