trace-to-skill 0.1.69 → 0.1.71

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 (21) hide show
  1. package/README.md +18 -5
  2. package/dist/src/checkpoint.d.ts +38 -0
  3. package/dist/src/checkpoint.js +214 -0
  4. package/dist/src/checkpoint.js.map +1 -0
  5. package/dist/src/cli.js +14 -0
  6. package/dist/src/cli.js.map +1 -1
  7. package/dist/src/index.d.ts +3 -1
  8. package/dist/src/index.js +1 -0
  9. package/dist/src/index.js.map +1 -1
  10. package/dist/src/usageEvidence.d.ts +28 -1
  11. package/dist/src/usageEvidence.js +146 -3
  12. package/dist/src/usageEvidence.js.map +1 -1
  13. package/docs/ADOPTION_GUIDE.md +1 -0
  14. package/docs/CODEX_ISSUE_MAP.md +6 -1
  15. package/docs/DISCOVERY.md +7 -2
  16. package/docs/OPENAI_OSS_BRIEF.md +2 -2
  17. package/docs/USE_CASES.md +28 -6
  18. package/llms.txt +8 -2
  19. package/package.json +9 -2
  20. package/schemas/usage-evidence-result.schema.json +106 -3
  21. package/schemas/workspace-checkpoint-result.schema.json +110 -0
package/schemas/usage-evidence-result.schema.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "$id": "https://github.com/grnbtqdbyx-create/trace-to-skill/schemas/usage-evidence-result.schema.json",
4
4
  "title": "trace-to-skill Codex usage evidence result",
5
5
  "type": "object",
6
- "required": ["generatedAt", "status", "inputs", "summary", "snapshots", "tokenUsage", "findings", "checklist"],
6
+ "required": ["generatedAt", "status", "inputs", "summary", "snapshots", "tokenUsage", "receipt", "findings", "checklist"],
7
7
  "additionalProperties": false,
8
8
  "properties": {
9
9
  "generatedAt": {
@@ -20,7 +20,7 @@
20
20
  },
21
21
  "summary": {
22
22
  "type": "object",
23
- "required": ["snapshots", "tokenUsageRecords", "usageLimitSignals", "resetDriftWindows", "highCachedInputRecords"],
23
+ "required": ["snapshots", "tokenUsageRecords", "usageLimitSignals", "resetDriftWindows", "highCachedInputRecords", "overheadSignals"],
24
24
  "additionalProperties": false,
25
25
  "properties": {
26
26
  "snapshots": {
@@ -42,6 +42,10 @@
42
42
  "highCachedInputRecords": {
43
43
  "type": "integer",
44
44
  "minimum": 0
45
+ },
46
+ "overheadSignals": {
47
+ "type": "integer",
48
+ "minimum": 0
45
49
  }
46
50
  }
47
51
  },
@@ -57,6 +61,9 @@
57
61
  "$ref": "#/$defs/tokenUsage"
58
62
  }
59
63
  },
64
+ "receipt": {
65
+ "$ref": "#/$defs/receipt"
66
+ },
60
67
  "findings": {
61
68
  "type": "array",
62
69
  "items": {
@@ -143,7 +150,8 @@
143
150
  "quota_percentage_jump",
144
151
  "usage_limit_with_remaining_quota",
145
152
  "high_cached_input",
146
- "high_total_tokens"
153
+ "high_total_tokens",
154
+ "orchestration_overhead_signal"
147
155
  ]
148
156
  },
149
157
  "severity": {
@@ -182,6 +190,101 @@
182
190
  "type": "string"
183
191
  }
184
192
  }
193
+ },
194
+ "receipt": {
195
+ "type": "object",
196
+ "required": ["quotaWindows", "localTokenTotals", "overheadSignals", "suspectedCauses"],
197
+ "additionalProperties": false,
198
+ "properties": {
199
+ "quotaWindows": {
200
+ "type": "array",
201
+ "items": {
202
+ "$ref": "#/$defs/quotaWindow"
203
+ }
204
+ },
205
+ "localTokenTotals": {
206
+ "$ref": "#/$defs/localTokenTotals"
207
+ },
208
+ "overheadSignals": {
209
+ "type": "array",
210
+ "items": {
211
+ "$ref": "#/$defs/overheadSignal"
212
+ }
213
+ },
214
+ "suspectedCauses": {
215
+ "type": "array",
216
+ "items": {
217
+ "type": "string"
218
+ }
219
+ }
220
+ }
221
+ },
222
+ "quotaWindow": {
223
+ "type": "object",
224
+ "required": ["window", "samples", "resetValues"],
225
+ "additionalProperties": false,
226
+ "properties": {
227
+ "window": {
228
+ "type": "string"
229
+ },
230
+ "samples": {
231
+ "type": "integer",
232
+ "minimum": 0
233
+ },
234
+ "firstPercent": {
235
+ "type": "number"
236
+ },
237
+ "lastPercent": {
238
+ "type": "number"
239
+ },
240
+ "resetValues": {
241
+ "type": "array",
242
+ "items": {
243
+ "type": "string"
244
+ }
245
+ }
246
+ }
247
+ },
248
+ "localTokenTotals": {
249
+ "type": "object",
250
+ "additionalProperties": false,
251
+ "properties": {
252
+ "total": {
253
+ "type": "number"
254
+ },
255
+ "input": {
256
+ "type": "number"
257
+ },
258
+ "cachedInput": {
259
+ "type": "number"
260
+ },
261
+ "output": {
262
+ "type": "number"
263
+ },
264
+ "reasoning": {
265
+ "type": "number"
266
+ }
267
+ }
268
+ },
269
+ "overheadSignal": {
270
+ "type": "object",
271
+ "required": ["kind", "source", "line", "excerpt"],
272
+ "additionalProperties": false,
273
+ "properties": {
274
+ "kind": {
275
+ "enum": ["background_polling", "compaction_loop", "retry_or_tool_loop", "subagent_fanout", "idle_drain"]
276
+ },
277
+ "source": {
278
+ "type": "string"
279
+ },
280
+ "line": {
281
+ "type": "integer",
282
+ "minimum": 1
283
+ },
284
+ "excerpt": {
285
+ "type": "string"
286
+ }
287
+ }
185
288
  }
186
289
  }
187
290
  }
package/schemas/workspace-checkpoint-result.schema.json ADDED
@@ -0,0 +1,110 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/grnbtqdbyx-create/trace-to-skill/schemas/workspace-checkpoint-result.schema.json",
4
+ "title": "trace-to-skill workspace checkpoint result",
5
+ "type": "object",
6
+ "required": ["generatedAt", "root", "outputDir", "includeUntracked", "includeIgnored", "summary", "files", "artifacts"],
7
+ "additionalProperties": false,
8
+ "properties": {
9
+ "generatedAt": {
10
+ "type": "string"
11
+ },
12
+ "root": {
13
+ "type": "string"
14
+ },
15
+ "outputDir": {
16
+ "type": "string"
17
+ },
18
+ "gitHead": {
19
+ "type": "string"
20
+ },
21
+ "includeUntracked": {
22
+ "type": "boolean"
23
+ },
24
+ "includeIgnored": {
25
+ "type": "boolean"
26
+ },
27
+ "summary": {
28
+ "type": "object",
29
+ "required": ["statusEntries", "copiedFiles", "deletedFiles", "symlinks"],
30
+ "additionalProperties": false,
31
+ "properties": {
32
+ "statusEntries": {
33
+ "type": "integer",
34
+ "minimum": 0
35
+ },
36
+ "copiedFiles": {
37
+ "type": "integer",
38
+ "minimum": 0
39
+ },
40
+ "deletedFiles": {
41
+ "type": "integer",
42
+ "minimum": 0
43
+ },
44
+ "symlinks": {
45
+ "type": "integer",
46
+ "minimum": 0
47
+ }
48
+ }
49
+ },
50
+ "files": {
51
+ "type": "array",
52
+ "items": {
53
+ "$ref": "#/$defs/file"
54
+ }
55
+ },
56
+ "artifacts": {
57
+ "type": "object",
58
+ "required": ["manifest", "status", "unstagedDiff", "stagedDiff", "notes"],
59
+ "additionalProperties": false,
60
+ "properties": {
61
+ "manifest": {
62
+ "type": "string"
63
+ },
64
+ "status": {
65
+ "type": "string"
66
+ },
67
+ "unstagedDiff": {
68
+ "type": "string"
69
+ },
70
+ "stagedDiff": {
71
+ "type": "string"
72
+ },
73
+ "notes": {
74
+ "type": "string"
75
+ }
76
+ }
77
+ }
78
+ },
79
+ "$defs": {
80
+ "file": {
81
+ "type": "object",
82
+ "required": ["path", "status", "copied", "deleted"],
83
+ "additionalProperties": false,
84
+ "properties": {
85
+ "path": {
86
+ "type": "string"
87
+ },
88
+ "status": {
89
+ "type": "string"
90
+ },
91
+ "copied": {
92
+ "type": "boolean"
93
+ },
94
+ "deleted": {
95
+ "type": "boolean"
96
+ },
97
+ "symlinkTarget": {
98
+ "type": "string"
99
+ },
100
+ "blob": {
101
+ "type": "string"
102
+ },
103
+ "sha256": {
104
+ "type": "string",
105
+ "pattern": "^[a-f0-9]{64}$"
106
+ }
107
+ }
108
+ }
109
+ }
110
+ }