@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 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-and-what-that-does-not-yet-prove).
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
  ![setup --no-pair finishing with "Ready."](https://raw.githubusercontent.com/ascendaone-com/ai-engineer-tools/main/docs/images/cli-setup-no-pair.png)
149
150
 
150
- Two things work with no pairing at all, which is why this mode exists. The
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. Neither owes anything to a backend, and gating the install on
154
- one kept them from the people still setting Ascenda up.
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`) |