njuboy11-ark-kb 1.0.0

package/.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  version-sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check version consistency
+        run: |
+          pkg_ver=$(node -p "JSON.parse(require('fs').readFileSync('package.json','utf8')).version")
+          plugin_ver=$(node -p "JSON.parse(require('fs').readFileSync('openclaw.plugin.json','utf8')).version")
+          if [ "$pkg_ver" != "$plugin_ver" ]; then
+            echo "::error::Version mismatch: package.json=$pkg_ver, openclaw.plugin.json=$plugin_ver"
+            exit 1
+          fi
+          echo "Versions match: $pkg_ver"
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: TypeScript compile
+        run: npx tsc --noEmit
+
+      - name: Build
+        run: npm run build
+
+      - name: Check no leftover .js/.d.ts in src/
+        run: |
+          js_count=$(find src -name '*.js' -o -name '*.d.ts' | wc -l)
+          if [ "$js_count" -gt 0 ]; then
+            echo "::error::Found $(js_count) compiled files in src/:"
+            find src -name '*.js' -o -name '*.d.ts'
+            exit 1
+          fi
+          echo "No compiled files in src/: clean"

package/CLA.md

@@ -0,0 +1,37 @@
+# Contributor License Agreement
+
+**Project**: ark-kb
+**Maintainer**: njuboy11
+**License**: AGPL-3.0
+
+By submitting a Pull Request to this project, you agree to the following:
+
+## You Grant Me
+
+1. **Copyright License** — A permanent, worldwide, royalty-free, non-exclusive license to use, reproduce, modify, merge, publish, distribute, sublicense, and create derivative works of your contribution, including the right to relicense it under a different open-source or commercial license.
+
+2. **Patent License** — A permanent, worldwide, royalty-free, non-exclusive license under any patents you own or control, to make, have made, use, offer to sell, sell, import, and otherwise transfer your contribution, where such license applies only to those patent claims necessarily infringed by your contribution alone.
+
+## You Keep
+
+3. Your full copyright ownership of your contribution. You may use, reproduce, modify, distribute, and sublicense your contribution for any purpose, outside of this project.
+
+## You Promise
+
+4. Your contribution is your original creation, or you have all necessary permissions to submit it.
+
+5. Your contribution does not infringe on any third-party copyright, patent, trademark, or other intellectual property rights.
+
+6. If your employer has rights to intellectual property you create, you have obtained permission from them to submit this contribution under the terms of this agreement.
+
+## I Promise
+
+7. Your contribution is licensed to the public under the AGPL-3.0 license, unless a separate written agreement is made between you and me.
+
+8. I may grant additional permissions (including commercial/closed-source use) to third parties for the project as a whole, without requiring further consent from you.
+
+9. I will not hold you liable for any damages or claims related to your contribution, except as required by law.
+
+---
+
+*Based on the Apache Individual Contributor License Agreement v2.0, simplified for solo-maintainer open-source projects.*

package/CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing to ark-kb
+
+## Contributor License Agreement (CLA)
+
+Before we can accept your contribution, you must agree to the [Contributor License Agreement](CLA.md). By submitting a Pull Request, you confirm that you have read and agree to the terms of the CLA.
+
+## Development
+
+```bash
+git clone https://github.com/njuboy11/ark-kb.git
+cd ark-kb
+npm install
+npm run build   # TypeScript compile
+```
+
+## Pull Request Process
+
+1. Fork the repo and create your branch from `main`
+2. Ensure `npm run build` compiles without errors
+3. Submit a Pull Request
+4. A maintainer will review and merge once approved