@chronicle.app/claude-code 0.3.0 → 0.5.0

package/dist/connectors/ClaudeCodeExtractor.d.ts

@@ -1,4 +1,4 @@
-import { Extractor, Record } from '@chronicle.app/etl';
+import { Extractor, Record, type Survey, type SurveyOptions } from '@chronicle.app/etl';
 import { z } from 'zod';
 import ClaudeCodeTransformer from './ClaudeCodeTransformer.js';
 declare const ASSISTANT_MODES: readonly ["full", "terse", "off"];
@@ -87,6 +87,11 @@ export declare class ClaudeCodeExtractor extends Extractor<typeof ClaudeCodeExtr
     private readLocalAccount;
     private sessionFilesIn;
     extract(): AsyncGenerator<Record>;
+    /**
+     * The messages a run reads, when, and in how many sessions, from reading
+     * every transcript: nothing else in them says how many messages they hold.
+     */
+    survey(options?: SurveyOptions): Promise<Survey>;
     /** Apply the assistant and tools flags to a parsed session, in file order. */
     private messagesOf;
     /** The responses of a turn whose text becomes a Message. */

package/dist/connectors/ClaudeCodeExtractor.js

@@ -2,7 +2,7 @@ import { createReadStream, promises as fs } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import readline from 'node:readline';
-import { Extractor } from '@chronicle.app/etl';
+import { Extractor, countMonth } from '@chronicle.app/etl';
 import { z } from 'zod';
 import ClaudeCodeTransformer from './ClaudeCodeTransformer.js';
 const ASSISTANT_MODES = ['full', 'terse', 'off'];
@@ -131,6 +131,44 @@ export class ClaudeCodeExtractor extends Extractor {
             }
         }
     }
+    /**
+     * The messages a run reads, when, and in how many sessions, from reading
+     * every transcript: nothing else in them says how many messages they hold.
+     */
+    async survey(options = {}) {
+        // Every message in range, whatever the run's limit.
+        const all = new ClaudeCodeExtractor({ ...this.config, limit: undefined });
+        let count = 0;
+        let earliest;
+        let latest;
+        const sessions = new Set();
+        const byMonth = {};
+        await all.setup();
+        try {
+            for await (const { data, context } of all.extract()) {
+                count++;
+                sessions.add(context.sessionId);
+                const time = new Date(data.timestamp);
+                if (!earliest || time < earliest)
+                    earliest = time;
+                if (!latest || time > latest)
+                    latest = time;
+                if (options.byMonth)
+                    countMonth(byMonth, time);
+            }
+        }
+        finally {
+            await all.teardown();
+        }
+        return {
+            messages: {
+                count,
+                ...(earliest && { earliest, latest }),
+                measures: [{ key: 'sessions', label: 'sessions', value: sessions.size }],
+                ...(options.byMonth && { byMonth }),
+            },
+        };
+    }
     /** Apply the assistant and tools flags to a parsed session, in file order. */
     *messagesOf(session, assistant, tools) {
         for (const turn of session.turns) {

package/dist/connectors/ClaudeCodeTransformer.js

@@ -40,13 +40,13 @@ export default class ClaudeCodeTransformer extends ChronicleTransformer {
         return [
             {
                 '@type': 'MessageAction',
-                '@key': BY_SOURCE_ID,
+                // Keyed by the message it sent.
+                '@key': ['@type', 'source', 'result.sourceId'],
                 source: SOURCE,
-                sourceId: message.uuid,
                 timestamp: new Date(message.timestamp),
                 agent: author,
-                ...(!human && { instrument: this.model(message.model) }),
-                object: {
+                ...(!human && { instrument: [this.model(message.model)] }),
+                result: {
                     '@type': 'Message',
                     '@key': BY_SOURCE_ID,
                     source: SOURCE,
@@ -94,7 +94,7 @@ export default class ClaudeCodeTransformer extends ChronicleTransformer {
      */
     model(id) {
         return {
-            '@type': 'SoftwareApplication',
+            '@type': 'AIModel',
             '@key': BY_HANDLE,
             source: ANTHROPIC,
             handle: id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chronicle.app/claude-code",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -19,9 +19,9 @@
   "type": "module",
   "description": "Chronicle claude-code extraction plugin",
   "devDependencies": {
-    "@chronicle.app/etl": "0.3.0",
-    "@chronicle.app/schema": "0.3.0",
-    "@chronicle.app/tsconfig": "0.3.0",
+    "@chronicle.app/etl": "0.5.0",
+    "@chronicle.app/schema": "0.5.0",
+    "@chronicle.app/tsconfig": "0.5.0",
     "@types/node": "^22.10.1",
     "typescript": "^5.7.2"
   },
@@ -61,7 +61,12 @@
             "recordTypes": [
               "messages"
             ],
-            "default": true
+            "default": true,
+            "locations": [
+              {
+                "path": "~/.claude/projects"
+              }
+            ]
           }
         }
       }