@ascenda-one/claude-code-hooks 0.1.34 → 0.1.35
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/NOTICE +6 -0
- package/README.md +8 -4
- package/dist/cli.js +647 -390
- package/dist/cli.js.map +1 -1
- package/dist/setup.js +20 -1
- package/dist/setup.js.map +1 -1
- package/package.json +3 -2
package/NOTICE
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
@ascenda-one/claude-code-hooks
|
|
2
|
+
Copyright 2026 Ascenda One Pty Ltd
|
|
3
|
+
|
|
4
|
+
Licensed under the Apache License, Version 2.0. See LICENSE.
|
|
5
|
+
|
|
6
|
+
Metadata-only AI workload telemetry adapter. Do not send source code, raw prompts, raw responses, file names, branch names, repository names, or terminal output by default.
|
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
Claude Code hooks adapter for Ascenda AI workload telemetry.
|
|
4
4
|
|
|
5
5
|
Part of [ai-engineer-tools](../). For what these measurements do and do not
|
|
6
|
-
establish, see [What this measures](../#what-this-measures
|
|
6
|
+
establish, see [What this measures](../#what-this-measures).
|
|
7
7
|
Event mapping: [docs/CLAUDE_MAPPING.md](./docs/CLAUDE_MAPPING.md).
|
|
8
8
|
|
|
9
9
|
## What it sends
|
|
@@ -74,6 +74,7 @@ npx @ascenda-one/claude-code-hooks uninstall # removes hooks and the binary
|
|
|
74
74
|
| `--local [port]` | shorthand for a local [dev server](../ascenda-dev-server/) (default `4477`) |
|
|
75
75
|
| `--tool-installation-id <id>` / `--token <t>` | reuse an existing pairing instead of creating one |
|
|
76
76
|
| `--no-pair` | install the local half only: hooks work, nothing is sent |
|
|
77
|
+
| `--event-log [path\|off]` | keep every event in a local JSONL file (default `~/.ascenda/events.jsonl`). On by default without a pairing; `off` stops it |
|
|
77
78
|
| `--scope user\|project` | register in `~/.claude/settings.json` (default, every project) or in this project's `.claude/settings.local.json` |
|
|
78
79
|
| `--project-dir <path>` | project root for `--scope project` (default cwd) |
|
|
79
80
|
| `--dry-run` | print what would change, write nothing |
|
|
@@ -147,11 +148,13 @@ the retry:
|
|
|
147
148
|
|
|
148
149
|

|
|
149
150
|
|
|
150
|
-
|
|
151
|
+
Three things work with no pairing at all, which is why this mode exists. The
|
|
151
152
|
session prompts are composed locally in the hook process. The live signal goes
|
|
152
153
|
to a socket on your own machine, so a listener there sees an agent working the
|
|
153
|
-
moment it starts.
|
|
154
|
-
|
|
154
|
+
moment it starts. And every event is written to `~/.ascenda/events.jsonl`, the
|
|
155
|
+
same metadata a paired install would send, for you or any other tool to read.
|
|
156
|
+
[examples/local-event-reader](../examples/local-event-reader/) is a small
|
|
157
|
+
script that does. None of it owes anything to a backend.
|
|
155
158
|
|
|
156
159
|
What that install holds: the hook binary, the registered events, and a
|
|
157
160
|
credentials file with an installation id, `localOnly: true` and `installedAt`.
|
|
@@ -230,6 +233,7 @@ Optional environment:
|
|
|
230
233
|
| `ASCENDA_EVENT_WRITE_TOKEN` | Only if you have no prior pairing to reuse — normally the token file supplies this |
|
|
231
234
|
| `ASCENDA_EVENT_WRITE_TOKEN_FILE` | Override token file path (default `~/.ascenda/tokens/<toolInstallationId>`) |
|
|
232
235
|
| `ASCENDA_SESSION_ID` | Stable session id across hooks |
|
|
236
|
+
| `ASCENDA_EVENT_LOG_FILE` | Local JSONL event log path, or `off`. Wins over `setup --event-log`. Without either, an unpaired install writes `~/.ascenda/events.jsonl` and a paired one writes nothing |
|
|
233
237
|
| `ASCENDA_WORKSPACE_HASH` | Override only. By default the hook derives this from the payload's own `cwd`: a machine-salted hash of the checkout folder's basename (never the path itself) |
|
|
234
238
|
| `ASCENDA_PROJECT_HASH` | Override only. Defaults to the salted hash of the canonical repository's basename — a git worktree folds into the repo it was created from |
|
|
235
239
|
| `ASCENDA_STATE_FILE` | Override the send journal path (default `~/.ascenda/state/<toolInstallationId>.json`) |
|