@signet-registry/operator 0.0.0-stage → 0.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +29 -0
- package/README.md +191 -2
- package/dist/clients/api.js +257 -0
- package/dist/clients/mcp.js +118 -0
- package/dist/clients/verify.js +125 -0
- package/dist/config/env.js +42 -0
- package/dist/keyless.js +52 -0
- package/dist/main.js +7 -0
- package/dist/operator.js +1729 -0
- package/dist/transparency/sample-graph.js +203 -0
- package/dist/types.js +111 -0
- package/examples/bootstrap/agents/bootstrap-agent.md +5 -0
- package/examples/bootstrap/agents/bootstrap-ops-agent.md +8 -0
- package/examples/bootstrap/bootstrap.manifest.json +107 -0
- package/examples/bootstrap/skills/bootstrap-example.md +8 -0
- package/examples/bootstrap/skills/bootstrap-ops.md +8 -0
- package/examples/demo/agents/registry-agent.md +34 -0
- package/examples/demo/demo.manifest.json +90 -0
- package/examples/demo/skills/registry-mcp.md +74 -0
- package/examples/demo/skills/tame-llama.md +37 -0
- package/examples/signet-demo/agents/signet-demo-agent.md +39 -0
- package/examples/signet-demo/agents/signet-security-agent.md +36 -0
- package/examples/signet-demo/signet-demo.manifest.json +219 -0
- package/examples/signet-demo/skills/access-review.md +40 -0
- package/examples/signet-demo/skills/certification-workflow.md +39 -0
- package/examples/signet-demo/skills/governance-audit.md +39 -0
- package/examples/signet-demo/skills/graph-explorer.md +38 -0
- package/examples/signet-demo/skills/mcp-onboarding.md +39 -0
- package/examples/signet-demo/skills/policy-authoring.md +39 -0
- package/examples/signet-demo/skills/provenance-audit.md +39 -0
- package/examples/signet-demo/skills/registry-search.md +38 -0
- package/examples/signet-demo/skills/secrets-hygiene.md +39 -0
- package/examples/signet-demo/skills/skill-authoring.md +40 -0
- package/examples/transparency/README.md +39 -0
- package/examples/transparency/sample-graph.spec.json +16 -0
- package/package.json +58 -4
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: Secrets Hygiene
|
|
3
|
+
description: Handle Cloudflare Access service tokens and API keys safely.
|
|
4
|
+
triggers: [onboard a client, rotate a credential, secret leaked]
|
|
5
|
+
capabilities:
|
|
6
|
+
- issue and rotate API keys
|
|
7
|
+
- rotate the Cloudflare Access service token
|
|
8
|
+
constraints:
|
|
9
|
+
- never store secrets in git or shell history
|
|
10
|
+
tags: [security, secrets, topic:security]
|
|
11
|
+
---
|
|
12
|
+
# Secrets Hygiene
|
|
13
|
+
|
|
14
|
+
Issue, store, and rotate registry credentials without leaking them.
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
|
|
18
|
+
- Onboarding a machine client that needs a service token or API key.
|
|
19
|
+
- A credential may have leaked.
|
|
20
|
+
|
|
21
|
+
## Inputs → Outputs
|
|
22
|
+
|
|
23
|
+
- **In:** a client identity (agent/CLI) that needs access.
|
|
24
|
+
- **Out:** credentials stored in a secret manager, never in git.
|
|
25
|
+
|
|
26
|
+
## Steps
|
|
27
|
+
|
|
28
|
+
1. Store secrets in a secret manager, never in git.
|
|
29
|
+
2. Service token: taint `cloudflare_zero_trust_access_service_token.signet_machines`, then update clients.
|
|
30
|
+
3. API key: `POST /v1/api-keys/{keyId}/rotate`; revoke with `DELETE /v1/api-keys/{keyId}`.
|
|
31
|
+
|
|
32
|
+
## Example
|
|
33
|
+
|
|
34
|
+
> **Prompt:** "Rotate the API key for the analytics agent."
|
|
35
|
+
> **Result:** a new `agk_` secret returned once; the old secret stops resolving.
|
|
36
|
+
|
|
37
|
+
## Constraints
|
|
38
|
+
|
|
39
|
+
- The API stores only a scrypt digest; plaintext is shown once.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: Skill Authoring
|
|
3
|
+
description: Author a new skill version and drive it through the lifecycle.
|
|
4
|
+
triggers: [add a skill, new version, publish a skill]
|
|
5
|
+
capabilities:
|
|
6
|
+
- create a skill draft with a CAS artifact
|
|
7
|
+
- run validate / publish / certify
|
|
8
|
+
constraints:
|
|
9
|
+
- requires an admin principal
|
|
10
|
+
tags: [registry, lifecycle, topic:registry]
|
|
11
|
+
---
|
|
12
|
+
# Skill Authoring
|
|
13
|
+
|
|
14
|
+
Turn a markdown file into a versioned, certified registry skill.
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
|
|
18
|
+
- You are adding a new skill to the registry.
|
|
19
|
+
- You need to ship an update as a new version of an existing skill.
|
|
20
|
+
|
|
21
|
+
## Inputs → Outputs
|
|
22
|
+
|
|
23
|
+
- **In:** `skill_key`, artifact bytes, and lineage metadata (source path, commit, tag).
|
|
24
|
+
- **Out:** a draft → validated → published → certified skill version.
|
|
25
|
+
|
|
26
|
+
## Steps
|
|
27
|
+
|
|
28
|
+
1. Create a draft: `POST /v1/skills/{skillKey}/drafts` with the artifact.
|
|
29
|
+
2. Validate: `POST /v1/skills/{skillKey}/versions/{version}/validate`.
|
|
30
|
+
3. Publish: `.../publish`, then `.../certify`.
|
|
31
|
+
|
|
32
|
+
## Example
|
|
33
|
+
|
|
34
|
+
> **Prompt:** "Add skill:hello-world from this markdown and publish it."
|
|
35
|
+
> **Result:** v1 is created, validated, published, and certified; the active version updates.
|
|
36
|
+
|
|
37
|
+
## Constraints
|
|
38
|
+
|
|
39
|
+
- Writes require Okta `app_signet_admin` or a write-scoped `agk_` key.
|
|
40
|
+
- Validation failures are recorded and block the `draft → validated` transition.
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
## Transparency Sample Graph
|
|
2
|
+
|
|
3
|
+
This directory is the committed, teammate-facing transparency sample for `signet`.
|
|
4
|
+
|
|
5
|
+
Files:
|
|
6
|
+
- `sample-graph.spec.json`
|
|
7
|
+
- canonical sample shape for the operator CLI
|
|
8
|
+
- inspectable without reading TypeScript source
|
|
9
|
+
|
|
10
|
+
What it models:
|
|
11
|
+
- one transparency log
|
|
12
|
+
- one trusted checkpoint key
|
|
13
|
+
- two witnesses
|
|
14
|
+
- two checkpoint states
|
|
15
|
+
- one conflicting same-size-different-root observation
|
|
16
|
+
- one witness-to-witness gossip event
|
|
17
|
+
|
|
18
|
+
Inspect the sample without running the stack:
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
cd signet/client/registry-cli
|
|
22
|
+
npm run dev -- seed transparency-sample --spec examples/transparency/sample-graph.spec.json --dry-run
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Seed it through the real operator path:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
cd signet/client/registry-cli
|
|
29
|
+
npm run dev -- seed transparency-sample --api-token "<api-token>" --spec examples/transparency/sample-graph.spec.json
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Print the smaller human-facing proof report:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
cd signet/client/registry-cli
|
|
36
|
+
npm run dev -- seed transparency-sample --api-token "<api-token>" --spec examples/transparency/sample-graph.spec.json --human-proof-report
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
This gives teammates a real sample graph to play with while keeping generated graph state and CAS objects out of git.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"sampleSlug": "transparency-sample",
|
|
3
|
+
"logId": "sg-transparency-sample-log",
|
|
4
|
+
"checkpointKeyRef": "kms://registry/transparency-sample-checkpoint",
|
|
5
|
+
"witnessAlphaKeyRef": "kms://registry/transparency-sample-witness-alpha",
|
|
6
|
+
"witnessBetaKeyRef": "kms://registry/transparency-sample-witness-beta",
|
|
7
|
+
"entryOneLabel": "transparency-sample-entry-1",
|
|
8
|
+
"entryTwoLabel": "transparency-sample-entry-2",
|
|
9
|
+
"entryTwoAltLabel": "transparency-sample-entry-2-alt",
|
|
10
|
+
"signerName": "sg-transparency-sample-cosignature",
|
|
11
|
+
"observationOccurredAt": "2026-01-03T00:10:00.000Z",
|
|
12
|
+
"witnessAlphaObservationAt": "2026-01-03T00:11:00.000Z",
|
|
13
|
+
"witnessBetaObservationAt": "2026-01-03T00:12:00.000Z",
|
|
14
|
+
"gossipOccurredAt": "2026-01-03T00:13:00.000Z",
|
|
15
|
+
"sourceCheckpointOccurredAt": "2026-01-03T00:00:00.000Z"
|
|
16
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,60 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@signet-registry/operator",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.5",
|
|
4
|
+
"description": "Operator/assistant CLI for the Signet registry: bootstrap, seed, and verify agents and skills.",
|
|
5
|
+
"license": "BSD-3-Clause",
|
|
6
|
+
"contributors": [
|
|
7
|
+
{
|
|
8
|
+
"name": "Pablo Ferrari",
|
|
9
|
+
"url": "https://github.com/pabshazon"
|
|
10
|
+
}
|
|
11
|
+
],
|
|
12
|
+
"type": "module",
|
|
13
|
+
"repository": {
|
|
14
|
+
"type": "git",
|
|
15
|
+
"url": "git+https://github.com/therandomsecurityguy/signet.git",
|
|
16
|
+
"directory": "client/registry-cli"
|
|
17
|
+
},
|
|
18
|
+
"engines": {
|
|
19
|
+
"node": ">=20"
|
|
20
|
+
},
|
|
21
|
+
"bin": {
|
|
22
|
+
"registry-operator": "dist/main.js"
|
|
23
|
+
},
|
|
24
|
+
"main": "dist/main.js",
|
|
25
|
+
"files": [
|
|
26
|
+
"dist",
|
|
27
|
+
"examples",
|
|
28
|
+
"README.md"
|
|
29
|
+
],
|
|
30
|
+
"scripts": {
|
|
31
|
+
"dev": "node --import tsx src/main.ts",
|
|
32
|
+
"build": "tsc -p tsconfig.json",
|
|
33
|
+
"start": "node dist/main.js",
|
|
34
|
+
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
35
|
+
"lint": "eslint .",
|
|
36
|
+
"test": "vitest run",
|
|
37
|
+
"prepack": "npm run build"
|
|
38
|
+
},
|
|
39
|
+
"dependencies": {
|
|
40
|
+
"@modelcontextprotocol/sdk": "^1.17.4",
|
|
41
|
+
"@sigstore/bundle": "^5.0.0",
|
|
42
|
+
"@sigstore/core": "^4.0.1",
|
|
43
|
+
"@sigstore/sign": "^5.0.0",
|
|
44
|
+
"zod": "^4.6.7"
|
|
45
|
+
},
|
|
46
|
+
"devDependencies": {
|
|
47
|
+
"@eslint/js": "^10.0.1",
|
|
48
|
+
"@types/node": "^26.6.6",
|
|
49
|
+
"@typescript-eslint/eslint-plugin": "^8.72.2",
|
|
50
|
+
"@typescript-eslint/parser": "^8.71.1",
|
|
51
|
+
"eslint": "^10.13.0",
|
|
52
|
+
"tsx": "^4.23.15",
|
|
53
|
+
"typescript": "^5.8.2",
|
|
54
|
+
"vitest": "^5.0.5"
|
|
55
|
+
},
|
|
56
|
+
"overrides": {
|
|
57
|
+
"body-parser": "^2.4.0",
|
|
58
|
+
"fast-uri": "^3.1.9"
|
|
59
|
+
}
|
|
60
|
+
}
|