@signet-registry/operator 0.0.0-stage → 0.1.3

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.
Files changed (36) hide show
  1. package/LICENSE +28 -0
  2. package/README.md +191 -2
  3. package/dist/clients/api.js +245 -0
  4. package/dist/clients/mcp.js +118 -0
  5. package/dist/clients/verify.js +71 -0
  6. package/dist/config/env.js +42 -0
  7. package/dist/keyless.js +52 -0
  8. package/dist/main.js +7 -0
  9. package/dist/operator.js +1498 -0
  10. package/dist/transparency/sample-graph.js +203 -0
  11. package/dist/types.js +111 -0
  12. package/examples/bootstrap/agents/bootstrap-agent.md +5 -0
  13. package/examples/bootstrap/agents/bootstrap-ops-agent.md +8 -0
  14. package/examples/bootstrap/bootstrap.manifest.json +107 -0
  15. package/examples/bootstrap/skills/bootstrap-example.md +8 -0
  16. package/examples/bootstrap/skills/bootstrap-ops.md +8 -0
  17. package/examples/demo/agents/registry-agent.md +34 -0
  18. package/examples/demo/demo.manifest.json +90 -0
  19. package/examples/demo/skills/registry-mcp.md +74 -0
  20. package/examples/demo/skills/tame-llama.md +37 -0
  21. package/examples/signet-demo/agents/signet-demo-agent.md +39 -0
  22. package/examples/signet-demo/agents/signet-security-agent.md +36 -0
  23. package/examples/signet-demo/signet-demo.manifest.json +219 -0
  24. package/examples/signet-demo/skills/access-review.md +40 -0
  25. package/examples/signet-demo/skills/certification-workflow.md +39 -0
  26. package/examples/signet-demo/skills/governance-audit.md +39 -0
  27. package/examples/signet-demo/skills/graph-explorer.md +38 -0
  28. package/examples/signet-demo/skills/mcp-onboarding.md +39 -0
  29. package/examples/signet-demo/skills/policy-authoring.md +39 -0
  30. package/examples/signet-demo/skills/provenance-audit.md +39 -0
  31. package/examples/signet-demo/skills/registry-search.md +38 -0
  32. package/examples/signet-demo/skills/secrets-hygiene.md +39 -0
  33. package/examples/signet-demo/skills/skill-authoring.md +40 -0
  34. package/examples/transparency/README.md +39 -0
  35. package/examples/transparency/sample-graph.spec.json +16 -0
  36. package/package.json +52 -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,54 @@
1
1
  {
2
2
  "name": "@signet-registry/operator",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.3",
4
+ "description": "Operator/assistant CLI for the Signet registry: bootstrap, seed, and verify agents and skills.",
5
+ "license": "BSD-3-Clause",
6
+ "type": "module",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/therandomsecurityguy/signet.git",
10
+ "directory": "client/registry-cli"
11
+ },
12
+ "engines": {
13
+ "node": ">=20"
14
+ },
15
+ "bin": {
16
+ "registry-operator": "dist/main.js"
17
+ },
18
+ "main": "dist/main.js",
19
+ "files": [
20
+ "dist",
21
+ "examples",
22
+ "README.md"
23
+ ],
24
+ "scripts": {
25
+ "dev": "node --import tsx src/main.ts",
26
+ "build": "tsc -p tsconfig.json",
27
+ "start": "node dist/main.js",
28
+ "typecheck": "tsc -p tsconfig.json --noEmit",
29
+ "lint": "eslint .",
30
+ "test": "vitest run",
31
+ "prepack": "npm run build"
32
+ },
33
+ "dependencies": {
34
+ "@modelcontextprotocol/sdk": "^1.17.4",
35
+ "@sigstore/bundle": "^5.0.0",
36
+ "@sigstore/core": "^4.0.1",
37
+ "@sigstore/sign": "^5.0.0",
38
+ "zod": "^4.6.7"
39
+ },
40
+ "devDependencies": {
41
+ "@eslint/js": "^10.0.1",
42
+ "@types/node": "^26.6.6",
43
+ "@typescript-eslint/eslint-plugin": "^8.72.2",
44
+ "@typescript-eslint/parser": "^8.71.1",
45
+ "eslint": "^10.13.0",
46
+ "tsx": "^4.23.15",
47
+ "typescript": "^5.8.2",
48
+ "vitest": "^5.0.5"
49
+ },
50
+ "overrides": {
51
+ "body-parser": "^2.4.0",
52
+ "fast-uri": "^3.1.9"
53
+ }
54
+ }