feat: prepare npm publishing automation (#3)

* Prepare npm publishing and add release workflow

* Rename npm package and trim README release docs

* Add CI lint workflow

* chore: add semantic-release scaffolding

* ci: add conventional PR title check

* ci: fix PR title check

Author: lan17

.github/workflows/lint.yml

@@ -0,0 +1,33 @@
+name: Lint
+
+on:
+  push:
+    branches:
+      - main
+      - codex/**
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: lint-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run lint
+        run: npm run lint

.github/workflows/pr-title.yml

@@ -0,0 +1,48 @@
+name: PR Title
+
+on:
+  pull_request:
+    types:
+      - opened
+      - edited
+      - reopened
+      - synchronize
+
+permissions:
+  contents: read
+  pull-requests: read
+
+concurrency:
+  group: pr-title-${{ github.workflow }}-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  conventional-pr-title:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate PR title
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+        run: |
+          python3 - <<'PY'
+          import os
+          import re
+          import sys
+
+          title = os.environ["PR_TITLE"]
+          pattern = re.compile(
+              r"^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\([^)]+\))?(!)?: .+"
+          )
+
+          if pattern.match(title):
+              print("PR title is a valid conventional commit title.")
+              raise SystemExit(0)
+
+          print(f"Invalid PR title: {title}", file=sys.stderr)
+          print("Expected format: type(scope): description", file=sys.stderr)
+          print(
+              "Allowed types: build, chore, ci, docs, feat, fix, perf, refactor, revert, style, test",
+              file=sys.stderr,
+          )
+          raise SystemExit(1)
+          PY

.github/workflows/release.yml

@@ -0,0 +1,41 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+  id-token: write
+
+concurrency:
+  group: release-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24.10.0"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npm run release

.releaserc.json

@@ -0,0 +1,12 @@
+{
+  "branches": [
+    "main"
+  ],
+  "tagFormat": "v${version}",
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/npm",
+    "@semantic-release/github"
+  ]
+}

README.md

@@ -1,12 +1,22 @@
-# @agentcontrol/agent-control
+# agent-control-openclaw-plugin
 
 Agent Control plugin for OpenClaw.
 
 > [!WARNING]
 > Experimental plugin: this project is currently a hacky integration and may
 > break across OpenClaw updates. Use in non-production or pinned environments.
 
-## Local dev install (no publish)
+## Install from npm
+
+Install the published plugin directly into OpenClaw:
+
+```bash
+openclaw plugins install agent-control-openclaw-plugin
+```
+
+Then restart the gateway.
+
+## Local dev install
 
 1. Clone this repo anywhere on disk.
 2. Install plugin deps in this repo: