Prepare OpenCode Power Pack for the HOL plugin registry

Add a least-privilege HOL Guard workflow, scanner policy, security reporting guidance, dependency monitoring, and immutable GitHub Action references. Align the Codex marketplace with its local plugin source and keep scanner verification reproducible for the awesome-ai-plugins submission.
This commit is contained in:
Wayner Barrios
2026-08-17 14:51:12 -05:00
parent 65a868eb14
commit 7f7f0912dc
12 changed files with 133 additions and 20 deletions
+2 -3
View File
@@ -7,9 +7,8 @@
{
"name": "opencode-power-pack",
"source": {
"source": "url",
"url": "https://github.com/waybarrios/opencode-power-pack.git",
"ref": "main"
"source": "local",
"path": "./"
},
"policy": {
"installation": "AVAILABLE",
+18
View File
@@ -0,0 +1,18 @@
# Local environment and credential files
.env
.env.*
!.env.example
*.pem
*.key
# Dependency and generated output
node_modules/
coverage/
dist/
evals/reports/
# Editor and operating-system state
.DS_Store
.idea/
.vscode/
*.swp
+13
View File
@@ -0,0 +1,13 @@
version: 2
updates:
- package-ecosystem: npm
directory: "/"
schedule:
interval: weekly
open-pull-requests-limit: 5
- package-ecosystem: github-actions
directory: "/"
schedule:
interval: weekly
open-pull-requests-limit: 5
+5 -5
View File
@@ -9,13 +9,13 @@ jobs:
lint-skills:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
node-version: "lts/*"
- run: npm ci
- run: node --test
- uses: actions/setup-python@v5
- uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
with:
python-version: "3.x"
- name: Validate Agent Skills specification
@@ -34,8 +34,8 @@ jobs:
matrix:
os: [ubuntu-latest, macos-latest]
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
node-version: "20.11.1"
- name: Install Linux sandbox dependencies
+2 -2
View File
@@ -15,8 +15,8 @@ jobs:
runs-on: ubuntu-latest
timeout-minutes: 5
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
node-version: "lts/*"
- name: Validate plugin and marketplace manifests
+2 -2
View File
@@ -15,8 +15,8 @@ jobs:
runs-on: ubuntu-latest
timeout-minutes: 5
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
node-version: "24"
- run: node scripts/opencode-smoke.mjs 1.18.7
@@ -0,0 +1,29 @@
name: Plugin Security Scan
on:
pull_request:
push:
branches: [main]
workflow_dispatch:
permissions:
contents: read
jobs:
scan:
name: HOL plugin scanner
runs-on: ubuntu-latest
timeout-minutes: 10
steps:
- name: Check out repository
uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
with:
persist-credentials: false
- name: Scan plugin package
uses: hashgraph-online/ai-plugin-scanner-action@55616c962cf86368423f7673b2ecdfdbe613d1af # v1.2.515
with:
plugin_dir: "."
mode: scan
min_score: 80
fail_on_severity: high
pr_comment: off
+2 -2
View File
@@ -25,10 +25,10 @@ jobs:
env:
RELEASE_REF: ${{ github.event_name == 'workflow_dispatch' && inputs.ref || github.event.release.tag_name }}
steps:
- uses: actions/checkout@v4
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
with:
ref: ${{ env.RELEASE_REF }}
- uses: actions/setup-node@v4
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
node-version: "20"
registry-url: "https://npm.pkg.github.com"
+25
View File
@@ -0,0 +1,25 @@
[scanner]
profile = "public-marketplace"
# Tests and behavioral-evaluation fixtures are contributor-only and excluded
# from the published npm package. The two reference files intentionally contain
# insecure examples that their skills teach reviewers to detect.
ignore_paths = [
"tests/*",
"evals/*",
"skills/insecure-defaults/references/examples.md",
"skills/sharp-edges/references/config-patterns.md",
"skills/agentic-actions-auditor/SKILL.md",
"skills/agentic-actions-auditor/references/*",
# Cisco's generic YARA rules treat these reviewed examples as command or
# prompt injection: a Ruby anti-pattern, a shell-free argv list, and HTML
# guidance that mentions a hidden input.
"skills/sharp-edges/references/lang-ruby.md",
"skills/hf-cloud-python-env-setup/scripts/setup_env.py",
"skills/huggingface-lora-space-builder/references/creative-mode.md",
]
[rules]
# Network-capable Hugging Face skills intentionally document explicit remote
# reads. Keep the findings visible without classifying those expected examples
# as high-severity vulnerabilities.
severity_overrides = { RISKY_SKILL_INSTRUCTION = "medium" }
+30
View File
@@ -0,0 +1,30 @@
# Security Policy
## Supported versions
Security fixes are applied to the latest published release and the `main`
branch. Older releases should be upgraded before reporting a version-specific
problem.
## Reporting a vulnerability
Please use GitHub's private vulnerability reporting flow for this repository:
<https://github.com/waybarrios/opencode-power-pack/security/advisories/new>
Include the affected version, host agent and operating system, reproduction
steps, expected security boundary, observed behavior, and any minimal proof of
concept needed to validate the report. Do not include real credentials,
personal data, or secrets.
Please do not open a public issue for an undisclosed vulnerability. You can
expect an initial acknowledgement within seven days. We will coordinate
validation, remediation, release timing, and public disclosure through the
private advisory.
## Scope
Reports about sandbox boundary bypasses, credential exposure, unsafe package
installation, plugin loading, or workflow permission escalation are in scope.
The sandbox runner is currently documented as `shell-contained`; unrelated
host-native tools are not claimed to be isolated until host adapters land.
+2 -2
View File
@@ -147,7 +147,7 @@ public function __construct(
) {}
```
See [config-patterns.md](references/config-patterns.md#unvalidated-constructor-parameters) for detailed patterns.
See [config-patterns.md](references/config-patterns.md) for detailed patterns.
### 5. Silent Failures
@@ -286,4 +286,4 @@ Before concluding analysis:
- [ ] Considered all three adversary types
- [ ] Verified error paths don't bypass security
- [ ] Checked configuration validation
- [ ] Constructor params validated (not just defaulted) - see [config-patterns.md](references/config-patterns.md#unvalidated-constructor-parameters)
- [ ] Constructor params validated (not just defaulted) - see [config-patterns.md](references/config-patterns.md)
+3 -4
View File
@@ -57,7 +57,7 @@ test("Codex manifest does not declare absent plugin components", () => {
assert.equal("hooks" in manifest, false);
});
test("repository marketplace installs the root plugin from main", () => {
test("repository marketplace installs the root plugin from its checkout", () => {
assert.equal(marketplace.name, "opencode-power-pack");
assert.equal(
marketplace.interface.displayName,
@@ -68,9 +68,8 @@ test("repository marketplace installs the root plugin from main", () => {
const [entry] = marketplace.plugins;
assert.equal(entry.name, manifest.name);
assert.deepEqual(entry.source, {
source: "url",
url: "https://github.com/waybarrios/opencode-power-pack.git",
ref: "main",
source: "local",
path: "./",
});
assert.deepEqual(entry.policy, {
installation: "AVAILABLE",