vvauth 2.6.0 → 2.6.2

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.
@@ -1,8 +1,5 @@
1
1
  name: publish-npm
2
- on:
3
- create:
4
- tags:
5
- - 'v*'
2
+ on: create
6
3
 
7
4
  permissions:
8
5
  id-token: write
@@ -10,6 +7,7 @@ permissions:
10
7
 
11
8
  jobs:
12
9
  publish-npm:
10
+ if: github.event.ref_type == 'tag' && startsWith(github.event.ref, 'v')
13
11
  runs-on: ubuntu-latest
14
12
  steps:
15
13
  - uses: actions/checkout@v4
@@ -49,4 +49,5 @@ jobs:
49
49
  - run: npm install --omit=dev --ignore-scripts --no-audit
50
50
  - run: |
51
51
  node --check index.js
52
- node index.js version
52
+ node --check cmd/vauth.js
53
+ node cmd/vauth.js version
package/API_and_tests.md CHANGED
@@ -1,144 +1,127 @@
1
- # vvauth: CLI contract, API and tests
1
+ # API, CLI and verification
2
2
 
3
- Back to the [README](README.md). Node (`npm install -g vvauth`) and Go
4
- (`go install github.com/131/vvauth/v2/cmd/vauth@latest`, release binaries)
5
- expose the same `vauth` command; everything below holds for both.
3
+ Node and Go implement the same authentication/profile/environment behavior.
4
+ Constructors, errors and return types stay native to each language. Their CLI
5
+ contracts differ except for the shared calls below.
6
6
 
7
- ## CLI contract
7
+ ## Shared calls
8
8
 
9
- ```
10
- vauth <command> [positional...] [--flag[=value]] [--ir://json]
9
+ ```bash
10
+ vauth env --ir://json
11
+ venv
12
+ venv --renew
13
+ venv --gitlab
11
14
  ```
12
15
 
13
- `env.map` names must match `^[A-Za-z_][A-Za-z0-9_]*$`; any other key is an
14
- error, since names reach `export KEY=` unescaped. Flags may replace positionals (`vauth set GITLAB_TOKEN x` ≡
15
- `vauth set --k=GITLAB_TOKEN --v=x`). `--flag` alone means `true`; `--flag=`,
16
- `--flag=false` and `--flag=0` mean `false`. `--` ends flag parsing.
16
+ `env --ir://json` writes one JSON object to stdout, with diagnostics on stderr.
17
+ JSON key order and final whitespace are not significant. `venv` sources
18
+ `vauth env --source "$@"`; renewal forces authentication.
17
19
 
18
- | Command | Effect | stdout |
19
- | --- | --- | --- |
20
- | `env [--source] [--renew]` | Resolve the `.vauthrc` environment (`env.map`, `env.paths`, `env.git`, `ssh-agent-crypt`) | JSON object with `--ir://json`; `export K='v'` lines with `--source`; JSON otherwise |
21
- | `login [--source] [--renew]` | Authenticate, cache the token | `export VAULT_TOKEN='…'` with `--source`; nothing otherwise |
22
- | `connect [--renew]` | Authenticate, print the token | raw token, no trailing newline (`--ir://json`: JSON string) |
23
- | `run <command> [args...]` | Run a command with the resolved environment merged over the current one | the command's; exit code propagated |
24
- | `dotenv` | Resolved environment as `K=v` lines | one `K=v` per line |
25
- | `show` | Identity metadata merged over `.vauth_database` | JSON object |
26
- | `set <key> <value>` | Store `KEY` (upper-cased) in `private/<login>/.vauth_database` | nothing |
27
- | `unset <key>` | Remove a key from `.vauth_database` | nothing |
28
- | `install` | Append the `venv` shell function to `~/.bashrc` | nothing |
29
- | `version` (`--version`) | Build version | one line |
30
-
31
- Diagnostics (`Vauth token: generated · 12h`, `export K=[redacted]`,
32
- errors) go to stderr; stdout is machine-readable for every command. Exit code is
33
- `0` on success, `1` on error (or the child's code for `run`). `--renew` discards
34
- the cached token and authenticates again.
20
+ ## Node CLI — cnyks
35
21
 
36
- ```bash
37
- vauth env --ir://json # {"VAULT_TOKEN":"…","VAULT_ADDR":"…","TF_HTTP_USERNAME":"…"}
38
- source <(vauth env --source) # what the `venv` function does
39
- vauth run -- terraform plan
22
+ ```text
23
+ vauth <command> [--parameter=value] [--ir://json | --ir://raw]
40
24
  ```
41
25
 
42
- ## Environment
26
+ The first positional selects the command; remaining method arguments are named
27
+ flags, not positional remapping. Aliases expose `env`, `login`, `show`, `set`,
28
+ `unset`, `dotenv`, `install`, `version` and `gitlab`. `Connect` remains a hidden
29
+ SDK operation; cnyks retains its namespaced `vauth:Connect` entry, not a
30
+ short `Connect`/`connect` alias. cnyks also reflects other public
31
+ methods; its interactive rendering is not the Go CLI contract.
43
32
 
44
- | Variable | Role |
45
- | --- | --- |
46
- | `VAUTHRC` | Explicit `.vauthrc` path; else `./.vauthrc`, then `~/.vauthrc` |
47
- | `VAULT_ADDR` | Fallback when `.vauthrc` has no `vault_addr` |
48
- | `VAULT_TOKEN` | Returned offline by Connect without renewal/persistence; LookupSelf validates online when the profile is requested |
49
- | `SSH_AUTH_SOCK` | Agent for `ssh_auth` and for the token cache; on Windows, else Pageant (≥ 0.75), else the OpenSSH pipe |
50
- | `VAUTH_USER_IDENTITY`, `VAUTH_USER_MAIL` | Agent key selector for the token cache (first key otherwise) |
51
- | `CI` | When set, `env.gitlab` does not derive `CI_PROJECT_*` from `git remote get-url origin` |
33
+ | Command | Parameters | Effect |
34
+ | --- | --- | --- |
35
+ | `env` | `--source`, `--renew`, `--gitlab` | Resolve environment, export it, or initialize GitLab variables |
36
+ | `login` | `--source`, `--renew` | Authentication only; optionally export only VAULT_TOKEN |
37
+ | `show` | — | Merged profile/private database |
38
+ | `set` | `--k=KEY --v=VALUE` | Store an upper-cased private key |
39
+ | `unset` | `--k=KEY` | Remove a private key |
40
+ | `dotenv` | — | Resolved K=v output |
41
+ | `install` | — | Install the venv shell function |
42
+ | `version` | — | Package version |
43
+ | `gitlab` | — | Only CI_PROJECT_* exports |
44
+
45
+ The executable is `cmd/vauth.js`; `index.js` only exports the SDK. Use
46
+ `--ir://json` for machine-readable return values. `env` selects raw cnyks output
47
+ when JSON was not requested, so sourcing does not show the runner menu.
48
+
49
+ ## Go CLI — native
50
+
51
+ ```text
52
+ vauth <command> [positionals...] [--flag=value] [--ir://json]
53
+ ```
52
54
 
53
- Tokens are cached in `~/.vauth/tokens/<sha256(vault_addr, ssh_auth, jwt_auth)>.creds`,
54
- armored with [ssh-agent-crypt](https://github.com/131/ssh-agent-crypt);
55
- `token_cache: false` disables the cache. Without an agent, nothing is written.
55
+ Commands are `env`, `login`, `show`, `set`, `unset`, `dotenv`, `install`, `version`
56
+ and `gitlab`. `set KEY VALUE` / `unset KEY` also accept `--k` / `--v`. Boolean
57
+ flags accept true, false, 0 and empty forms. `env` supports source, renew and
58
+ gitlab flags; `login` supports source and renew. Hidden `connect` remains
59
+ available for token-only callers. No command runner is part of this API.
56
60
 
57
- ## Node module
61
+ Objects are JSON, strings are raw without JSON mode, and version is one line.
62
+ Exit is zero on success and one on failure; errors go to stderr.
58
63
 
59
- Node.js 16 or newer is supported. CI checks JavaScript syntax and CLI/module
60
- loading on Node 16 separately from the existing suite. JSON copies use
61
- `nyks/object/structuredClone`, native when available with a JSON fallback.
64
+ ## SDK
62
65
 
63
66
  ```js
64
67
  const Vauth = require('vvauth');
65
- const vauth = new Vauth(); // reads .vauthrc and process.env
66
- const token = await vauth.Connect(); // Connect(renew = false)
67
- const env = await vauth.Env(); // Env(source = false, renew = false) → object
68
- await vauth.Login(false, true); // login(source, renew)
69
- const profile = await vauth.Show(); // {...database, ...metadata}
70
- await vauth.Set('KEY', 'value'); await vauth.Unset('KEY');
68
+ const client = new Vauth();
69
+ const token = await client.Connect(renew);
70
+ const env = await client.Env(source, renew, gitlab);
71
+ await client.Login(source, renew);
72
+ const profile = await client.Show();
73
+ await client.Set(key, value);
74
+ await client.Unset(key);
75
+ await client.Gitlab();
71
76
  ```
72
77
 
73
- Node extends the vauth-login client directly. `Connect`, `LookupSelf` and
74
- `Request` are inherited, not forwarded through compatibility wrappers.
75
- `GetProfile`, `Env`, `Show`, `Set`, `Unset`, `Login`, `Dotenv`, `Run` and
76
- `PublishEnv` own the environment/profile behavior. `Version()` is static.
77
- `RC`, `VAULT_ADDR` and `VAULT_TOKEN` are the inherited read-only getters.
78
- `config` contains a mutable copy of only `env` and `ssh-agent-crypt`, with local
79
- `env` macros expanded; the full frozen RC retains original values/macros.
80
- vvauth does not reopen the selected configuration file.
78
+ ```go
79
+ client, err := vvauth.New()
80
+ token, err := client.Connect(renew)
81
+ env, err := client.Env(renew)
82
+ err = client.Login(source, renew)
83
+ profile, err := client.Show()
84
+ err = client.Set(key, value)
85
+ err = client.Unset(key)
86
+ err = client.Gitlab()
87
+ ```
81
88
 
82
- `Env(true)`, `Login(true)`, `Dotenv()` and `PublishEnv()` write to stdout but do
83
- not exit the SDK caller. `Run(command, ...args)` returns the child's exit code;
84
- launch/authentication errors reject. Public methods use PascalCase without old
85
- SDK aliases. The CLI independently keeps its lowercase commands and flags,
86
- without reflecting inherited HTTP methods into CLI commands.
89
+ `Connect`, `LookupSelf`, `Request`, immutable `RC` and address/token readers
90
+ belong to vauth-login. vvauth owns `Config`/`config`, profiles, KV operations,
91
+ macro expansion, shell publication and GitLab initialization. Constructors
92
+ check required CI variables when `env.gitlab` is true; explicit initialization
93
+ bypasses that prerequisite. There is no Git inference at construction.
87
94
 
88
- ## Go module
95
+ RC is the complete raw configuration; environment sections are copied before
96
+ macro expansion. Both support
97
+ SSH-agent-backed local secret decryption, inherited tokens and forced renewal.
98
+ `env.map` names must be valid environment names. Values become strings; null
99
+ becomes empty, and objects/arrays are rejected, including macro results. Raw RC
100
+ values retain their JSON types. Missing Git identity fields export empty values.
89
101
 
90
- ```go
91
- import vvauth "github.com/131/vvauth/v2"
92
-
93
- v, err := vvauth.New() // .vauthrc + os.Environ()
94
- token, err := v.Connect(false) // renew bool
95
- env, err := v.Env(false) // *OrderedMap, deterministic output order
96
- profile, err := v.GetProfile(false) // EntityID, Metadata, Database; Merged()
97
- err = v.Login(source, renew)
98
- err = v.Set("KEY", "value"); err = v.Unset("KEY")
99
- code, err := v.Run("terraform", "plan")
100
- v.PublishEnv(env) // export lines on stdout, redacted echo on stderr
101
- ```
102
+ ## Configuration trust boundary
103
+
104
+ The selected configuration controls exported variable names/values and which
105
+ local armored files are decrypted. Name validation enforces shell syntax,
106
+ not a variable allowlist. Review and trust a project configuration before
107
+ sourcing it with `venv`; this tool is not a sandbox for hostile configurations.
108
+ The Vault-origin guard checks authentication destinations, not every effect
109
+ of the environment exported into the calling shell.
102
110
 
103
- `Vauth` embeds `*vauthlogin.Vauth`; `Connect`, `LookupSelf` and `Request`,
104
- the read-only `RC()`, `VAULT_ADDR()` and `VAULT_TOKEN()` readers, plus mutable
105
- `Agent`, `TokenCache`, `CacheDir`, `HomeDir`, `Environ`, `Stderr`, `Now` and
106
- `HTTPClient` settings, are owned by that client.
107
- Use `New()` or supply the embedded client explicitly for isolated programmatic
108
- use. `Config` holds only `Env`/`AgentCrypt`; `Stdout`/`Stdin` belong to vvauth.
109
- `ParseConfig`, `ReplaceEnv`, `ShellEscape` and `FunctionExists` support environment and shell operations.
110
- Construction consumes `RC()` directly: an independent JSON snapshot is decoded
111
- into vvauth's own configuration, without reopening its file. The JSON map does
112
- not retain YAML key order; `env.map` keys from this path have deterministic sorted
113
- order. Explicit `OrderedMap.Set` calls and standalone `ParseConfig` keep their
114
- insertion/YAML order. There is no second auth parser, token lifecycle, cache
115
- implementation or HTTP transport in vvauth.
116
-
117
- Node and Go consume vauth-login 1.1.5 and ssh-agent-crypt 1.4.2; Node uses nyks
118
- 6.17.0. `env.gitlab` derives `CI_PROJECT_*` from the current working repository,
119
- including when `VAUTHRC` is elsewhere. In CI, supplied variables are retained.
120
- This is distinct from standalone Go `ParseConfig`, whose explicit file argument
121
- identifies its Git directory.
122
-
123
- The SDK keeps language-native conventions: promises/throws in Node,
124
- values plus errors in Go. Node `Env(source, renew)` can publish directly;
125
- Go `Env(renew)` returns an ordered map for `PublishEnv`. CLI `--ir://json`
126
- outputs JSON without a trailing newline in both implementations. JSON object
127
- key order is not part of the profile (`show`) contract.
128
-
129
- ## Tests
130
-
131
- Node and Go are tested against an in-process fake Vault (nonce, login, lookup,
132
- renew, identity, KV) and a throwaway `ssh-agent`; both suites cover token reuse,
133
- renewal in the final third, expiry, isolation of the cache by Vault and auth,
134
- corrupt or plaintext cache rejection, identity selection and the interoperability
135
- of the armored cache with the `ssh-agent-crypt` CLI.
111
+ ## Verification
136
112
 
137
113
  ```bash
138
- npm install && npm run eslint && npm test
139
- gofmt -l . && go vet ./... && go test ./...
114
+ npm install
115
+ npm run eslint
116
+ npm test
117
+ go vet ./...
118
+ go test -race ./...
119
+ GOOS=windows GOARCH=amd64 go build ./cmd/vauth
140
120
  ```
141
121
 
142
- CI (`test.yml`) runs both on Linux and Windows runners; `release.yml` builds the
143
- static binaries on `v*` tags, signs the Windows one when `SIGNING_SERVER` is
144
- set, and attaches `SHA256SUMS`.
122
+ Tests use disposable SSH keys/agents, temporary configuration and loopback
123
+ Vault fixtures; they do not require real credentials. Differential checks cover
124
+ profile/KV operations, renewal, trust refusal, local secrets, configuration,
125
+ JSON environment output and the shared armor/cache. Linux/Windows builds and
126
+ Node 16 parsing/loading are checked separately. Release CI publishes npm,
127
+ Go tags and Linux/signed Windows binaries; verify asset checksums independently.
package/README.md CHANGED
@@ -1,148 +1,111 @@
1
1
  # vvauth
2
2
 
3
- Node.js 16 or newer is supported; CI includes Node 16 JavaScript syntax and
4
- module/CLI loading checks alongside the existing test suites.
5
-
6
3
  Resolve a shell environment from your Vault identity, private settings and
7
- secrets. [vauth-login](https://github.com/131/vauth-login) handles authentication,
8
- token caching and HTTP; vvauth owns profiles, macro expansion, KV operations
9
- and environment publication. Available as a Node module/CLI and a Go module/CLI.
10
- Both consume vauth-login 1.1.5's complete read-only RC and token/address readers;
11
- vvauth copies its own sections for macro expansion without reopening the file.
4
+ secrets. [vauth-login](https://github.com/131/vauth-login) owns authentication,
5
+ HTTP and token caching; [ssh-agent-crypt](https://github.com/131/ssh-agent-crypt)
6
+ protects local secrets. Node and Go are canonical implementations.
12
7
 
13
- # Installation
8
+ ## Install
14
9
 
15
10
  ```bash
16
- # node
17
11
  npm install -g vvauth
18
-
19
- # go
20
12
  go install github.com/131/vvauth/v2/cmd/vauth@latest
21
-
22
- # static binary, linux
23
- wget -O vauth https://github.com/131/vvauth/releases/latest/download/vauth-linux-amd64
24
- chmod +x vauth
25
-
26
- # static binary, windows (curl.exe ships with every supported Windows, cmd or PowerShell)
27
- curl.exe -fsSL -o vauth.exe https://github.com/131/vvauth/releases/latest/download/vauth-windows-amd64.exe
28
13
  ```
29
14
 
30
- The [npm](https://www.npmjs.com/package/vvauth) module and the Go module ship
31
- the same `vauth` command, flags and `.vauthrc`, and share the token cache.
32
- Binaries are static, signed on Windows, with `SHA256SUMS` on every
33
- [release](https://github.com/131/vvauth/releases); `vauth version` prints the
34
- build version. On Windows, the SSH agent is `SSH_AUTH_SOCK` when set, else
35
- Pageant (≥ 0.75, named pipe autodiscovery), else the OpenSSH agent pipe.
15
+ Native Linux and signed Windows binaries, with checksums, are available from
16
+ [GitHub Releases](https://github.com/131/vvauth/releases).
36
17
 
37
- ## The `venv` shell function
18
+ ## Load the environment
38
19
 
39
- A program cannot change the environment of the shell that started it, so the
40
- `VAULT_TOKEN`, credentials and `env.map` variables that `vauth` resolves have
41
- to be *sourced*. `vauth install` appends this one-liner to `~/.bashrc`:
20
+ ```bash
21
+ vauth install
22
+ source ~/.bashrc
23
+ venv
24
+ venv --renew
25
+ ```
26
+
27
+ `vauth install` defines the Bash function `venv` in `~/.bashrc`:
42
28
 
43
29
  ```bash
44
30
  function venv() { source <(/usr/bin/env vauth env --source "$@"); }
45
31
  ```
46
32
 
47
- `venv` then loads the resolved environment into the current shell (`venv
48
- --renew` forces a fresh token); the exported names are echoed to stderr with
49
- their values redacted. In scripts or CI, without a shell to source into, use
50
- `vauth run <command>`, `vauth env --ir://json` or `vauth dotenv` instead.
51
-
33
+ `source ~/.bashrc` loads it in the current shell. `--renew` forces fresh
34
+ authentication. For a machine-readable result:
52
35
 
53
- # Vauth configuration
54
- ## Vauth configuration file location
55
- vauth configuration file lies on a `.vauthrc` file (this name can be controlled by the VAUTHRC env var).
56
- vauth will try to find
57
- * if specified, the VAUTHRC file
58
- * fallback to a .vauthrc file in the current directory
59
- * fallback to a .vauthrc file in the current user home directory
36
+ ```bash
37
+ vauth env --ir://json
38
+ ```
60
39
 
61
- ## Vauth configuration format
62
- vauth configuration file is a simple yaml file with a specific macro expansion syntax for dynamic parts.
63
- The configuration file should abide the following schema
40
+ Both implementations write one JSON object to stdout; diagnostics remain on
41
+ stderr. Node uses cnyks for its CLI; Go has a native command interface.
42
+ [API_and_tests.md](API_and_tests.md) defines both contracts.
64
43
 
65
- ### configuration macro expansion set
66
- * $${profile.XXX} expand to vault entity metadata and user `.vauth_database` vars
67
- * $${env.XXX} expand to local environement vars
68
- * $${secrets.XXX} expand to remote scrapped secrets (see the env.paths)
44
+ ## Configuration
69
45
 
70
- ```
71
- # vauth URL
72
- vault_addr: https://vauth.myserver.org
46
+ The first existing configuration is selected: `VAUTHRC`, `./.vauthrc`, then
47
+ `~/.vauthrc`. It is YAML; `VAULT_ADDR` supplies the address fallback.
48
+ The resolved SSH role is normalized to lowercase by vauth-login in both
49
+ implementations; the source configuration, other fields and JWT roles are unchanged.
73
50
 
74
- # SSH authentication role, consumed by vauth-login
51
+ ```yaml
52
+ vault_addr: https://vault.example.test
75
53
  ssh_auth:
76
54
  role: $${env.VAUTH_USER_LOGIN}
77
55
  env:
78
56
  map:
79
57
  TF_HTTP_USERNAME: $${profile.VAUTH_USER_LOGIN}
80
58
  TF_HTTP_PASSWORD: $${profile.GITLAB_API_TOKEN}
81
- AWS_ACCESS_KEY_ID: $${secrets.AWS_ACCESS_KEY_ID}
82
59
  AWS_SECRET_ACCESS_KEY: $${secrets.AWS_SECRET_ACCESS_KEY}
83
-
84
- # remote secrets mecanism
85
- # set the secrets mount point - default to secrets
86
- [path: secrets]
87
- # list extra secrets to be reached and populated into the $${secrets.XXX} macro
60
+ path: secrets
88
61
  paths:
89
- - /some/pa4-backend.creds
90
-
62
+ - /some/backend.creds
91
63
  ```
92
64
 
65
+ Macros read local `env`, Vault `profile` (entity metadata and the user's
66
+ `.vauth_database`), or collected `secrets`. `env.git` supplies Git author and
67
+ committer fields. A `ssh-agent-crypt` section can supply local encrypted secrets
68
+ without contacting Vault when no SSH/JWT authentication is configured.
93
69
 
94
- # Machine-readable environment
95
-
96
- `vauth env --ir://json` writes the resolved environment as one JSON object on
97
- stdout; diagnostics stay on stderr, so a caller can parse stdout directly.
98
- CLI command spelling remains lowercase; public Node/Go SDK methods use the
99
- same PascalCase names. Every command, flag, output and module signature is in
100
- [API_and_tests.md](API_and_tests.md).
70
+ With `env.gitlab: true`, project variables must already exist in the shell.
71
+ Initialize them explicitly from `origin`:
101
72
 
102
73
  ```bash
103
- vauth env --ir://json
74
+ venv --gitlab
104
75
  ```
105
76
 
77
+ ## Tokens and trust
106
78
 
107
- # Token cache
108
-
109
- [vauth-login](https://github.com/131/vauth-login) owns the cache in
110
- `~/.vauth/tokens/<session>.creds`, shared by Node and Go. It reuses, renews or
111
- replaces cached tokens as needed. An inherited `VAULT_TOKEN` is returned as is,
112
- without renewal or persistence; profile retrieval is an explicit separate step.
113
-
114
- Each session file is armored using
115
- [ssh-agent-crypt](https://github.com/131/ssh-agent-crypt) and your SSH agent’s
116
- first key (`VAUTH_USER_IDENTITY`, then `VAUTH_USER_MAIL`, select another one).
117
- Without an SSH agent, disk caching is disabled.
118
-
119
- Set `token_cache: false` in `.vauthrc` to disable disk cache reads and writes.
120
-
121
- ## Force reauthentication
122
-
123
- `venv --renew` forces authentication, generates and caches a new token.
124
-
79
+ An inherited `VAULT_TOKEN` is reused offline. Otherwise, vauth-login handles
80
+ login and the SSH-agent-encrypted cache in `~/.vauth/tokens`. `token_cache: false`
81
+ disables disk caching. SSH uses `SSH_AUTH_SOCK`, or native Windows Pageant/OpenSSH
82
+ pipe discovery. Review a project-selected Vault before vouching for it in the
83
+ home configuration or environment.
125
84
 
126
- ## Security audit
85
+ Review and trust the project configuration before sourcing it. It controls
86
+ the exported environment and local file decryption; the Vault-address check
87
+ is not a sandbox for hostile configuration files.
127
88
 
128
- The reports below describe the pre-integration implementation. This integration
129
- uses vauth-login 1.1.5 without regenerating or rewriting their findings/scores.
89
+ Tokens and resolved secrets are credentials: do not log them or store plaintext
90
+ exports. Neither implementation prompts to trust an unknown project Vault.
130
91
 
92
+ ## Security assessments
131
93
 
132
- Two independent reviews of the design and of both implementations (Node, Go),
133
- each scoring Coolness, Robustness and Safety out of 20:
134
- [SECURITY_AUDIT_fable-5.1.md](SECURITY_AUDIT_fable-5.1.md) and
135
- [SECURITY_AUDIT_gpt-6.1-sol.md](SECURITY_AUDIT_gpt-6.1-sol.md).
94
+ [Claude](SECURITY_AUDIT_claude-opus-5-5.md) and
95
+ [Sol](SECURITY_AUDIT_gpt-6.1-sol.md) reports identify their exact source commit,
96
+ checks and limitations. They are independent source reviews, not certification.
97
+ [Coordination and open risks](SECURITY_AUDIT_COORDINATION.md) distinguish
98
+ reviewer limitations from host validation; [provenance](SECURITY_AUDIT_PROVENANCE.json)
99
+ records the exact source, models and prompt/report hashes.
136
100
 
137
- | Criterion | Codex (Claude Fable 5.1) | Codex (GPT 6.1) |
101
+ | Criterion | Claude Opus 5.5 | GPT 6.1 Sol |
138
102
  | --- | ---: | ---: |
139
103
  | ✨ **Coolness** | 15/20 | 17/20 |
140
- | Robustness | 16/20 | 11/20 |
141
- | Safety | 14/20 | 10/20 |
104
+ | Robustness | 13/20 | 13/20 |
105
+ | Safety | 13/20 | 12/20 |
142
106
 
107
+ ## Credits
143
108
 
144
- # Credits
145
- * [Francois Leurent](https://github.com/131)
146
- * [OpenAI](https://openai.com) Codex (GPT 6.1-sol), in collaboration
147
- * [Anthropic](https://www.anthropic.com) Claude (Fable 5.1), in collaboration
148
- * Code signing, courtesy of Essilor International
109
+ - [Francois Leurent](https://github.com/131)
110
+ - OpenAI Codex and Anthropic Claude, in collaboration
111
+ - Code signing, courtesy of Essilor International
@@ -0,0 +1,36 @@
1
+ # Security assessment coordination
2
+
3
+ Two independent source-only reviews assess f368802700f03c8b632bbacefbfc71dbfaae04f4.
4
+ Reports are preserved verbatim; neither findings nor scores were calibrated.
5
+ Execution headers verify Claude Opus 5.5 and GPT 6.1-sol. Exact successful
6
+ inputs are maintained in the operator's SA prompt files; hashes/commands are
7
+ in SECURITY_AUDIT_PROVENANCE.json. Excluded-report/README input boundaries
8
+ were checked against the logged commands; Git hashes/filename inventory are metadata.
9
+
10
+ | Review | Coolness | Robustness | Safety |
11
+ | --- | --- | --- | --- |
12
+ | Claude Opus 5.5 | 15/20 | 13/20 | 13/20 |
13
+ | GPT 6.1-sol | 17/20 | 13/20 | 12/20 |
14
+
15
+ ## Release disposition and open boundaries
16
+
17
+ The npm job is explicitly gated on a created v* tag. Functional code and
18
+ workflow assessed here precede release-version metadata only.
19
+ Host validation independently passes 74 Node24 tests, ESLint, Go vet/race,
20
+ Node16 parsing/loading and native Windows cross-builds. Reviewers' read-only
21
+ sandboxes blocked runtime checks; that is a limitation, not evidence that
22
+ those product tests fail. Signing/checksums are checked on the actual release
23
+ artifacts, not inferred from workflow configuration.
24
+
25
+ Project configuration has broad authority over the environment and local
26
+ armored files. The high-severity untrusted-configuration finding remains an
27
+ open boundary: documentation requires reviewing/trusting configurations but
28
+ is not a technical trust gate or sandbox. Host synthetic probes confirm the
29
+ export/decrypt capability without executing exported commands or using a real
30
+ cache. No project-approval system or arbitrary variable denylist was introduced.
31
+
32
+ Other reported boundaries remain: shell-wrapper failure propagation, dotenv
33
+ encoding, concurrent KV writes, response/resource limits, mutable publication
34
+ inputs, and the declared interpolation semantics. Exact nyks behavior and
35
+ native recursion are retained; these reviews do not certify exhaustive parity
36
+ or vulnerability-database clearance. No claim is made that every finding is fixed.
@@ -0,0 +1,35 @@
1
+ {
2
+ "sourceCommit": "f368802700f03c8b632bbacefbfc71dbfaae04f4",
3
+ "date": "2026-10-25",
4
+ "method": "Fresh independent source-only codex exec sessions; no previous reports or coordinator history as inputs",
5
+ "reviews": [
6
+ {
7
+ "profile": "claude",
8
+ "actualModel": "claude-opus-5-5",
9
+ "exit": 0,
10
+ "command": "codex -p claude exec --ephemeral --sandbox read-only -c 'web_search=\"disabled\"' --output-last-message /mnt/d/tmp/tasks/FLEURENT-09/audits/f368802/claude-report.md - < /mnt/d/tmp/tasks/FLEURENT-09/audits/f368802/claude-input.txt",
11
+ "hashes": {
12
+ "input.txt": "f30a9fe080b37646dfd1c0fc18318fa6a30e1db24847b10c1240292fe63a7c1c",
13
+ "report.md": "526c89b5874b420a1229c9414e461028b2012dd5cdcc7ab7f62635841a71aade",
14
+ "exec.log": "e8187235115d563e7e9017155b34dd310970f90b746075e7242f3138440368b6"
15
+ },
16
+ "output": "SECURITY_AUDIT_claude-opus-5-5.md",
17
+ "inputExclusionsChecked": true,
18
+ "modelCheckedAgainstExecutionHeader": true
19
+ },
20
+ {
21
+ "profile": "codex",
22
+ "actualModel": "gpt-6.1-sol_codeassist",
23
+ "exit": 0,
24
+ "command": "codex exec --ephemeral --sandbox read-only -c 'web_search=\"disabled\"' --output-last-message /mnt/d/tmp/tasks/FLEURENT-09/audits/f368802/codex-report.md - < /mnt/d/tmp/tasks/FLEURENT-09/audits/f368802/codex-input.txt",
25
+ "hashes": {
26
+ "input.txt": "7617ec6debad726eed09829efbbd63a180660af91fc1f393927460193094179a",
27
+ "report.md": "60c4fc1f72df58c96ece263d1dc4d64dec619301116e7bdf459bd02f83165400",
28
+ "exec.log": "10b1ae8df60c50acf8a4cd66ce73aaa813aac583eb48304d40144186afc2becc"
29
+ },
30
+ "output": "SECURITY_AUDIT_gpt-6.1-sol.md",
31
+ "inputExclusionsChecked": true,
32
+ "modelCheckedAgainstExecutionHeader": true
33
+ }
34
+ ]
35
+ }