@nightloom/isy 1.0.0

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 (223) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +69 -0
  3. package/dist/agents/claude.d.ts +6 -0
  4. package/dist/agents/claude.js +66 -0
  5. package/dist/agents/claude.js.map +1 -0
  6. package/dist/agents/codex-records.d.ts +34 -0
  7. package/dist/agents/codex-records.js +492 -0
  8. package/dist/agents/codex-records.js.map +1 -0
  9. package/dist/agents/codex.d.ts +5 -0
  10. package/dist/agents/codex.js +205 -0
  11. package/dist/agents/codex.js.map +1 -0
  12. package/dist/agents/index.d.ts +25 -0
  13. package/dist/agents/index.js +50 -0
  14. package/dist/agents/index.js.map +1 -0
  15. package/dist/agents/kimi-records.d.ts +24 -0
  16. package/dist/agents/kimi-records.js +252 -0
  17. package/dist/agents/kimi-records.js.map +1 -0
  18. package/dist/agents/kimi-wire.d.ts +8 -0
  19. package/dist/agents/kimi-wire.js +158 -0
  20. package/dist/agents/kimi-wire.js.map +1 -0
  21. package/dist/agents/kimi.d.ts +6 -0
  22. package/dist/agents/kimi.js +332 -0
  23. package/dist/agents/kimi.js.map +1 -0
  24. package/dist/agents/types.d.ts +83 -0
  25. package/dist/agents/types.js +2 -0
  26. package/dist/agents/types.js.map +1 -0
  27. package/dist/alert.d.ts +24 -0
  28. package/dist/alert.js +68 -0
  29. package/dist/alert.js.map +1 -0
  30. package/dist/api.d.ts +103 -0
  31. package/dist/api.js +171 -0
  32. package/dist/api.js.map +1 -0
  33. package/dist/commands/analyze.d.ts +61 -0
  34. package/dist/commands/analyze.js +198 -0
  35. package/dist/commands/analyze.js.map +1 -0
  36. package/dist/commands/check.d.ts +55 -0
  37. package/dist/commands/check.js +180 -0
  38. package/dist/commands/check.js.map +1 -0
  39. package/dist/commands/commit.d.ts +26 -0
  40. package/dist/commands/commit.js +130 -0
  41. package/dist/commands/commit.js.map +1 -0
  42. package/dist/commands/health.d.ts +47 -0
  43. package/dist/commands/health.js +366 -0
  44. package/dist/commands/health.js.map +1 -0
  45. package/dist/commands/init.d.ts +3 -0
  46. package/dist/commands/init.js +173 -0
  47. package/dist/commands/init.js.map +1 -0
  48. package/dist/commands/logout.d.ts +1 -0
  49. package/dist/commands/logout.js +30 -0
  50. package/dist/commands/logout.js.map +1 -0
  51. package/dist/commands/notes.d.ts +11 -0
  52. package/dist/commands/notes.js +49 -0
  53. package/dist/commands/notes.js.map +1 -0
  54. package/dist/commands/scan.d.ts +47 -0
  55. package/dist/commands/scan.js +199 -0
  56. package/dist/commands/scan.js.map +1 -0
  57. package/dist/commands/settings.d.ts +15 -0
  58. package/dist/commands/settings.js +94 -0
  59. package/dist/commands/settings.js.map +1 -0
  60. package/dist/commands/status.d.ts +61 -0
  61. package/dist/commands/status.js +151 -0
  62. package/dist/commands/status.js.map +1 -0
  63. package/dist/commands/upload.d.ts +42 -0
  64. package/dist/commands/upload.js +429 -0
  65. package/dist/commands/upload.js.map +1 -0
  66. package/dist/config.d.ts +4 -0
  67. package/dist/config.js +32 -0
  68. package/dist/config.js.map +1 -0
  69. package/dist/detectors.d.ts +43 -0
  70. package/dist/detectors.js +1026 -0
  71. package/dist/detectors.js.map +1 -0
  72. package/dist/git.d.ts +22 -0
  73. package/dist/git.js +68 -0
  74. package/dist/git.js.map +1 -0
  75. package/dist/githook.d.ts +71 -0
  76. package/dist/githook.js +238 -0
  77. package/dist/githook.js.map +1 -0
  78. package/dist/hook.d.ts +39 -0
  79. package/dist/hook.js +173 -0
  80. package/dist/hook.js.map +1 -0
  81. package/dist/index.d.ts +2 -0
  82. package/dist/index.js +205 -0
  83. package/dist/index.js.map +1 -0
  84. package/dist/log.d.ts +19 -0
  85. package/dist/log.js +97 -0
  86. package/dist/log.js.map +1 -0
  87. package/dist/mask-paths.d.ts +75 -0
  88. package/dist/mask-paths.js +364 -0
  89. package/dist/mask-paths.js.map +1 -0
  90. package/dist/pairing.d.ts +60 -0
  91. package/dist/pairing.js +137 -0
  92. package/dist/pairing.js.map +1 -0
  93. package/dist/parser.d.ts +48 -0
  94. package/dist/parser.js +516 -0
  95. package/dist/parser.js.map +1 -0
  96. package/dist/paths.d.ts +41 -0
  97. package/dist/paths.js +181 -0
  98. package/dist/paths.js.map +1 -0
  99. package/dist/plan.d.ts +25 -0
  100. package/dist/plan.js +39 -0
  101. package/dist/plan.js.map +1 -0
  102. package/dist/queue.d.ts +26 -0
  103. package/dist/queue.js +120 -0
  104. package/dist/queue.js.map +1 -0
  105. package/dist/redact.d.ts +29 -0
  106. package/dist/redact.js +254 -0
  107. package/dist/redact.js.map +1 -0
  108. package/dist/spawn.d.ts +13 -0
  109. package/dist/spawn.js +32 -0
  110. package/dist/spawn.js.map +1 -0
  111. package/dist/stage0.d.ts +20 -0
  112. package/dist/stage0.js +90 -0
  113. package/dist/stage0.js.map +1 -0
  114. package/dist/state.d.ts +84 -0
  115. package/dist/state.js +150 -0
  116. package/dist/state.js.map +1 -0
  117. package/dist/test/analyze.test.d.ts +1 -0
  118. package/dist/test/analyze.test.js +408 -0
  119. package/dist/test/analyze.test.js.map +1 -0
  120. package/dist/test/check.test.d.ts +1 -0
  121. package/dist/test/check.test.js +193 -0
  122. package/dist/test/check.test.js.map +1 -0
  123. package/dist/test/cli.test.d.ts +1 -0
  124. package/dist/test/cli.test.js +132 -0
  125. package/dist/test/cli.test.js.map +1 -0
  126. package/dist/test/codex.test.d.ts +1 -0
  127. package/dist/test/codex.test.js +585 -0
  128. package/dist/test/codex.test.js.map +1 -0
  129. package/dist/test/commit.test.d.ts +1 -0
  130. package/dist/test/commit.test.js +430 -0
  131. package/dist/test/commit.test.js.map +1 -0
  132. package/dist/test/git.test.d.ts +1 -0
  133. package/dist/test/git.test.js +75 -0
  134. package/dist/test/git.test.js.map +1 -0
  135. package/dist/test/health.test.d.ts +1 -0
  136. package/dist/test/health.test.js +156 -0
  137. package/dist/test/health.test.js.map +1 -0
  138. package/dist/test/hook.test.d.ts +1 -0
  139. package/dist/test/hook.test.js +144 -0
  140. package/dist/test/hook.test.js.map +1 -0
  141. package/dist/test/kimi.test.d.ts +1 -0
  142. package/dist/test/kimi.test.js +349 -0
  143. package/dist/test/kimi.test.js.map +1 -0
  144. package/dist/test/mask-paths.test.d.ts +1 -0
  145. package/dist/test/mask-paths.test.js +230 -0
  146. package/dist/test/mask-paths.test.js.map +1 -0
  147. package/dist/test/notes.test.d.ts +1 -0
  148. package/dist/test/notes.test.js +41 -0
  149. package/dist/test/notes.test.js.map +1 -0
  150. package/dist/test/pairing.test.d.ts +1 -0
  151. package/dist/test/pairing.test.js +138 -0
  152. package/dist/test/pairing.test.js.map +1 -0
  153. package/dist/test/parser.test.d.ts +1 -0
  154. package/dist/test/parser.test.js +312 -0
  155. package/dist/test/parser.test.js.map +1 -0
  156. package/dist/test/plan.test.d.ts +1 -0
  157. package/dist/test/plan.test.js +34 -0
  158. package/dist/test/plan.test.js.map +1 -0
  159. package/dist/test/redact.test.d.ts +1 -0
  160. package/dist/test/redact.test.js +303 -0
  161. package/dist/test/redact.test.js.map +1 -0
  162. package/dist/test/settings.test.d.ts +1 -0
  163. package/dist/test/settings.test.js +32 -0
  164. package/dist/test/settings.test.js.map +1 -0
  165. package/dist/test/stage0.test.d.ts +1 -0
  166. package/dist/test/stage0.test.js +607 -0
  167. package/dist/test/stage0.test.js.map +1 -0
  168. package/dist/test/sweep.test.d.ts +1 -0
  169. package/dist/test/sweep.test.js +298 -0
  170. package/dist/test/sweep.test.js.map +1 -0
  171. package/dist/test/update.test.d.ts +1 -0
  172. package/dist/test/update.test.js +26 -0
  173. package/dist/test/update.test.js.map +1 -0
  174. package/dist/test/upload.test.d.ts +1 -0
  175. package/dist/test/upload.test.js +331 -0
  176. package/dist/test/upload.test.js.map +1 -0
  177. package/dist/types.d.ts +142 -0
  178. package/dist/types.js +2 -0
  179. package/dist/types.js.map +1 -0
  180. package/dist/update.d.ts +17 -0
  181. package/dist/update.js +46 -0
  182. package/dist/update.js.map +1 -0
  183. package/package.json +60 -0
  184. package/src/agents/claude.ts +89 -0
  185. package/src/agents/codex-records.ts +533 -0
  186. package/src/agents/codex.ts +238 -0
  187. package/src/agents/index.ts +58 -0
  188. package/src/agents/kimi-records.ts +274 -0
  189. package/src/agents/kimi-wire.ts +179 -0
  190. package/src/agents/kimi.ts +390 -0
  191. package/src/agents/types.ts +92 -0
  192. package/src/alert.ts +68 -0
  193. package/src/api.ts +269 -0
  194. package/src/commands/analyze.ts +308 -0
  195. package/src/commands/check.ts +239 -0
  196. package/src/commands/commit.ts +179 -0
  197. package/src/commands/health.ts +444 -0
  198. package/src/commands/init.ts +186 -0
  199. package/src/commands/logout.ts +33 -0
  200. package/src/commands/notes.ts +57 -0
  201. package/src/commands/scan.ts +278 -0
  202. package/src/commands/settings.ts +107 -0
  203. package/src/commands/status.ts +236 -0
  204. package/src/commands/upload.ts +524 -0
  205. package/src/config.ts +33 -0
  206. package/src/detectors.ts +1138 -0
  207. package/src/git.ts +86 -0
  208. package/src/githook.ts +269 -0
  209. package/src/hook.ts +237 -0
  210. package/src/index.ts +229 -0
  211. package/src/log.ts +113 -0
  212. package/src/mask-paths.ts +434 -0
  213. package/src/pairing.ts +190 -0
  214. package/src/parser.ts +581 -0
  215. package/src/paths.ts +191 -0
  216. package/src/plan.ts +56 -0
  217. package/src/queue.ts +145 -0
  218. package/src/redact.ts +335 -0
  219. package/src/spawn.ts +33 -0
  220. package/src/stage0.ts +121 -0
  221. package/src/state.ts +208 -0
  222. package/src/types.ts +165 -0
  223. package/src/update.ts +46 -0
package/dist/hook.js ADDED
@@ -0,0 +1,173 @@
1
+ import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
2
+ import { basename, dirname, join } from "node:path";
3
+ import { claudeConfigDir, claudeSettingsPath } from "./paths.js";
4
+ export const HOOK_EVENT = "SessionEnd";
5
+ export const HOOK_COMMAND = "npx @nightloom/isy upload --hook";
6
+ export const START_HOOK_EVENT = "SessionStart";
7
+ export const START_HOOK_COMMAND = "npx @nightloom/isy check --hook";
8
+ /**
9
+ * The scope is spelled out, and npx stays. npx resolves a bare name against the
10
+ * registry rather than against PATH, and the registry's `isy` is an unrelated
11
+ * package — this one publishes as `@nightloom/isy`, so a hook saying `npx isy`
12
+ * would fetch a stranger. Keeping npx is what lets a machine that was set up
13
+ * with `npx @nightloom/isy init` and never installed anything globally keep
14
+ * working. Every command an older isy wrote is listed as superseded, so
15
+ * installing over it rewrites that line in place instead of leaving two hooks
16
+ * to fire.
17
+ */
18
+ export const ISY_HOOKS = [
19
+ {
20
+ event: HOOK_EVENT,
21
+ command: HOOK_COMMAND,
22
+ superseded: ["npx isy upload --silent", "npx isy upload --hook"],
23
+ },
24
+ { event: START_HOOK_EVENT, command: START_HOOK_COMMAND, superseded: ["npx isy check --hook"] },
25
+ ];
26
+ export function claudeHookFile() {
27
+ return { path: claudeSettingsPath(), hooks: ISY_HOOKS };
28
+ }
29
+ function isObject(value) {
30
+ return typeof value === "object" && value !== null && !Array.isArray(value);
31
+ }
32
+ async function readSettings(file) {
33
+ let contents;
34
+ try {
35
+ contents = await readFile(file.path, "utf8");
36
+ }
37
+ catch {
38
+ return {};
39
+ }
40
+ let parsed;
41
+ try {
42
+ parsed = JSON.parse(contents);
43
+ }
44
+ catch (cause) {
45
+ const reason = cause instanceof Error ? cause.message : String(cause);
46
+ throw new Error(`${file.path} is not valid JSON: ${reason}`);
47
+ }
48
+ if (!isObject(parsed)) {
49
+ throw new Error(`${file.path} does not contain a JSON object`);
50
+ }
51
+ return parsed;
52
+ }
53
+ async function writeSettings(file, settings) {
54
+ await mkdir(dirname(file.path), { recursive: true });
55
+ const temporary = join(dirname(file.path), `.${basename(file.path)}.isy-${process.pid}`);
56
+ await writeFile(temporary, `${JSON.stringify(settings, null, 2)}\n`, "utf8");
57
+ await rename(temporary, file.path);
58
+ }
59
+ function matchers(settings, event) {
60
+ const hooks = settings.hooks;
61
+ if (!isObject(hooks))
62
+ return [];
63
+ const entries = hooks[event];
64
+ return Array.isArray(entries) ? entries.filter(isObject) : [];
65
+ }
66
+ function hasHook(settings, event, commands) {
67
+ return matchers(settings, event).some((matcher) => Array.isArray(matcher.hooks) &&
68
+ matcher.hooks.some((entry) => isObject(entry) && typeof entry.command === "string" && commands.includes(entry.command)));
69
+ }
70
+ function stripHook(settings, hooks, event, commands) {
71
+ const kept = [];
72
+ for (const matcher of matchers(settings, event)) {
73
+ if (!Array.isArray(matcher.hooks)) {
74
+ kept.push(matcher);
75
+ continue;
76
+ }
77
+ const remaining = matcher.hooks.filter((entry) => !(isObject(entry) && typeof entry.command === "string" && commands.includes(entry.command)));
78
+ if (remaining.length > 0)
79
+ kept.push({ ...matcher, hooks: remaining });
80
+ }
81
+ if (kept.length > 0)
82
+ hooks[event] = kept;
83
+ else
84
+ delete hooks[event];
85
+ }
86
+ /**
87
+ * Swap the first superseded command for its replacement at the same group and
88
+ * position, dropping any further copies, so no group's index moves.
89
+ */
90
+ function replaceSuperseded(groups, commands, command) {
91
+ let replaced = false;
92
+ for (const group of groups) {
93
+ if (!isObject(group) || !Array.isArray(group.hooks))
94
+ continue;
95
+ group.hooks = group.hooks.filter((entry) => {
96
+ if (!isObject(entry) || typeof entry.command !== "string" || !commands.includes(entry.command)) {
97
+ return true;
98
+ }
99
+ if (replaced)
100
+ return false;
101
+ entry.command = command;
102
+ replaced = true;
103
+ return true;
104
+ });
105
+ }
106
+ return replaced;
107
+ }
108
+ export async function installedHooksIn(file) {
109
+ const settings = await readSettings(file);
110
+ return file.hooks.filter((hook) => hasHook(settings, hook.event, [hook.command])).map((hook) => hook.event);
111
+ }
112
+ export async function installHookIn(file) {
113
+ const settings = await readSettings(file);
114
+ const missing = file.hooks.filter((hook) => !hasHook(settings, hook.event, [hook.command]));
115
+ if (missing.length === 0)
116
+ return "already-present";
117
+ const hooks = isObject(settings.hooks) ? { ...settings.hooks } : {};
118
+ for (const hook of missing) {
119
+ // Appended, never prepended: Codex keys its hook trust ledger by position
120
+ // (`hooks.json:session_start:0:0`), so inserting ahead of an existing group
121
+ // would silently untrust the user's own hooks.
122
+ const existing = Array.isArray(hooks[hook.event]) ? [...hooks[hook.event]] : [];
123
+ // An older isy wrote a different command for the same job: swap it in
124
+ // place. Strip-then-append would move it to the end, shifting the groups
125
+ // after it — and with them the positions Codex keys its approvals on, so
126
+ // the user's hooks would lose their approval and ours would inherit one it
127
+ // was never given.
128
+ const replaced = hook.superseded !== undefined && replaceSuperseded(existing, hook.superseded, hook.command);
129
+ if (!replaced)
130
+ existing.push({ hooks: [{ type: "command", command: hook.command }] });
131
+ hooks[hook.event] = existing;
132
+ }
133
+ await writeSettings(file, { ...settings, hooks });
134
+ return "installed";
135
+ }
136
+ export async function removeHookIn(file) {
137
+ const settings = await readSettings(file);
138
+ const present = file.hooks.filter((hook) => hasHook(settings, hook.event, [hook.command, ...(hook.superseded ?? [])]));
139
+ if (present.length === 0)
140
+ return "absent";
141
+ const hooks = isObject(settings.hooks) ? { ...settings.hooks } : {};
142
+ for (const hook of present) {
143
+ stripHook(settings, hooks, hook.event, [hook.command, ...(hook.superseded ?? [])]);
144
+ }
145
+ const next = { ...settings };
146
+ if (Object.keys(hooks).length > 0)
147
+ next.hooks = hooks;
148
+ else
149
+ delete next.hooks;
150
+ await writeSettings(file, next);
151
+ return "removed";
152
+ }
153
+ export async function isHookInstalled() {
154
+ const file = claudeHookFile();
155
+ const settings = await readSettings(file);
156
+ return ISY_HOOKS.every((hook) => hasHook(settings, hook.event, [hook.command]));
157
+ }
158
+ export function installedHooks() {
159
+ return installedHooksIn(claudeHookFile());
160
+ }
161
+ export function installHook() {
162
+ return installHookIn(claudeHookFile());
163
+ }
164
+ export function removeHook() {
165
+ return removeHookIn(claudeHookFile());
166
+ }
167
+ export function settingsLocation() {
168
+ return claudeSettingsPath();
169
+ }
170
+ export function configDirectory() {
171
+ return claudeConfigDir();
172
+ }
173
+ //# sourceMappingURL=hook.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hook.js","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
package/dist/index.js ADDED
@@ -0,0 +1,205 @@
1
+ #!/usr/bin/env node
2
+ import { parseArgs } from "node:util";
3
+ import { agentById } from "./agents/index.js";
4
+ import { parkAlert } from "./alert.js";
5
+ import { claimSweep, releaseSweep } from "./state.js";
6
+ import { runAnalyze } from "./commands/analyze.js";
7
+ import { runCheck } from "./commands/check.js";
8
+ import { runCommitCommand } from "./commands/commit.js";
9
+ import { runHealth } from "./commands/health.js";
10
+ import { runInit } from "./commands/init.js";
11
+ import { runLogout } from "./commands/logout.js";
12
+ import { runNotes } from "./commands/notes.js";
13
+ import { runSettings } from "./commands/settings.js";
14
+ import { runStatus } from "./commands/status.js";
15
+ import { formatUploadAlert, formatUploadReport, runUpload } from "./commands/upload.js";
16
+ import { errorMessage, logError } from "./log.js";
17
+ import { spawnIsy } from "./spawn.js";
18
+ const COMMANDS = new Set([
19
+ "init",
20
+ "status",
21
+ "check",
22
+ "health",
23
+ "upload",
24
+ "sweep",
25
+ "commit",
26
+ "logout",
27
+ "analyze",
28
+ "notes",
29
+ "settings",
30
+ ]);
31
+ const USAGE = "Usage: isy <init|status|logout> [--silent] [--json] [--token <token>]\n" +
32
+ " isy upload [--silent] [--hook] [--all] [--agent <claude|kimi|codex>]\n" +
33
+ " isy sweep [--silent] [--json]\n" +
34
+ " isy commit [--hook] [--json]\n" +
35
+ " isy check [--ping] [--json] [--hook] [--agent <claude|kimi|codex>]\n" +
36
+ " isy health [--json] [--fix] [--scan]\n" +
37
+ " isy notes [--pr <number>] [--json]\n" +
38
+ " isy settings [set|unset <key> [value]] [--json]\n" +
39
+ " isy analyze <file.jsonl|directory>... [--stage 0] [--json]\n" +
40
+ " [--expect <dir>] [--update]";
41
+ const silentRequested = process.argv.includes("--silent") || process.argv.includes("--hook");
42
+ function fail(message, silent) {
43
+ logError(message);
44
+ if (!silent)
45
+ console.error(`isy: ${message}`);
46
+ process.exit(silent ? 0 : 1);
47
+ }
48
+ function parse() {
49
+ try {
50
+ return parseArgs({
51
+ allowPositionals: true,
52
+ options: {
53
+ silent: { type: "boolean", default: false },
54
+ json: { type: "boolean", default: false },
55
+ token: { type: "string" },
56
+ stage: { type: "string" },
57
+ expect: { type: "string" },
58
+ update: { type: "boolean", default: false },
59
+ hook: { type: "boolean", default: false },
60
+ ping: { type: "boolean", default: false },
61
+ all: { type: "boolean", default: false },
62
+ agent: { type: "string" },
63
+ fix: { type: "boolean", default: false },
64
+ scan: { type: "boolean", default: false },
65
+ pr: { type: "string" },
66
+ help: { type: "boolean", short: "h", default: false },
67
+ },
68
+ });
69
+ }
70
+ catch (error) {
71
+ fail(errorMessage(error), silentRequested);
72
+ }
73
+ }
74
+ async function run(command, values, positionals) {
75
+ switch (command) {
76
+ case "status":
77
+ return runStatus({ json: values.json }, process.cwd());
78
+ case "check":
79
+ return runCheck({
80
+ json: values.json,
81
+ hook: values.hook,
82
+ ping: values.ping,
83
+ agent: values.agent,
84
+ catchUp: () => spawnIsy(["sweep", "--silent"]),
85
+ });
86
+ case "notes": {
87
+ const pr = values.pr === undefined ? undefined : Number(values.pr);
88
+ if (pr !== undefined && !Number.isInteger(pr))
89
+ throw new Error("--pr takes a pull request number");
90
+ return runNotes({ json: values.json, pr }, process.cwd());
91
+ }
92
+ case "settings":
93
+ return runSettings({
94
+ json: values.json,
95
+ action: positionals[1],
96
+ key: positionals[2],
97
+ value: positionals[3],
98
+ });
99
+ case "health":
100
+ return runHealth({ json: values.json, fix: values.fix, scan: values.scan }, process.cwd());
101
+ case "init":
102
+ return runInit({ token: values.token }, process.cwd());
103
+ case "logout":
104
+ return runLogout(process.cwd());
105
+ // post-commit runs this. Git ignores what it returns — the commit is already
106
+ // made — but it must still never throw, or the user sees a stack trace after
107
+ // every commit.
108
+ case "commit": {
109
+ if (values.hook) {
110
+ try {
111
+ await runCommitCommand({ json: values.json, hook: true }, process.cwd());
112
+ }
113
+ catch {
114
+ return;
115
+ }
116
+ return;
117
+ }
118
+ return runCommitCommand({ json: values.json, hook: false }, process.cwd());
119
+ }
120
+ case "upload": {
121
+ // A SessionEnd hook must not break the session it reports on.
122
+ if (values.hook) {
123
+ try {
124
+ const report = await runUpload({ silent: true, agent: values.agent, all: values.all, hook: true }, process.cwd());
125
+ const alert = formatUploadAlert(report);
126
+ // Each CLI displays a line its own way; the wording is the same.
127
+ if (alert)
128
+ await agentById(report.agent).deliver(alert, "SessionEnd");
129
+ }
130
+ catch {
131
+ return;
132
+ }
133
+ return;
134
+ }
135
+ const report = await runUpload({ silent: values.silent, agent: values.agent, all: values.all }, process.cwd());
136
+ if (!values.silent)
137
+ console.log(formatUploadReport(report));
138
+ return;
139
+ }
140
+ // What stands in for SessionEnd where a CLI has none: every session on the
141
+ // machine, whatever directory it ran in. Run detached from any CLI — by a
142
+ // SessionStart hook, later by a timer — so a line worth showing is parked
143
+ // for the next session start rather than written to a stdout nobody reads.
144
+ case "sweep": {
145
+ // One sweep at a time on a machine: two CLIs opened together would scan
146
+ // the same transcripts and upload each of them twice.
147
+ if (!(await claimSweep())) {
148
+ if (!values.silent)
149
+ console.log("isy: a sweep is already running");
150
+ return;
151
+ }
152
+ try {
153
+ const report = await runUpload({ silent: values.silent, sweep: true }, process.cwd());
154
+ if (values.json) {
155
+ console.log(JSON.stringify(report, null, 2));
156
+ return;
157
+ }
158
+ if (values.silent) {
159
+ const alert = formatUploadAlert(report);
160
+ if (alert)
161
+ await parkAlert(alert);
162
+ return;
163
+ }
164
+ console.log(formatUploadReport(report));
165
+ }
166
+ catch (error) {
167
+ // Spawned detached with its output discarded, so an uncaught throw would
168
+ // leave nothing anywhere — and `isy health` reads the journal to answer
169
+ // exactly this question.
170
+ logError(`sweep: ${String(error)}`);
171
+ }
172
+ finally {
173
+ await releaseSweep();
174
+ }
175
+ return;
176
+ }
177
+ case "analyze":
178
+ return runAnalyze({
179
+ files: positionals.slice(1),
180
+ stage: values.stage,
181
+ json: values.json,
182
+ expect: values.expect,
183
+ update: values.update,
184
+ });
185
+ default:
186
+ throw new Error("not implemented yet");
187
+ }
188
+ }
189
+ const { values, positionals } = parse();
190
+ const silent = values.silent;
191
+ const command = positionals[0] ?? "status";
192
+ if (values.help) {
193
+ console.log(USAGE);
194
+ process.exit(0);
195
+ }
196
+ if (!COMMANDS.has(command)) {
197
+ fail(`unknown command '${command}'. ${USAGE}`, silent);
198
+ }
199
+ try {
200
+ await run(command, values, positionals);
201
+ }
202
+ catch (error) {
203
+ fail(`${command}: ${errorMessage(error)}`, silent);
204
+ }
205
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/log.d.ts ADDED
@@ -0,0 +1,19 @@
1
+ export type LogLevel = "info" | "error";
2
+ export interface JournalEntry {
3
+ at: string;
4
+ level: LogLevel;
5
+ message: string;
6
+ /** The word before the first colon: which operation wrote this, when it says. */
7
+ operation?: string;
8
+ }
9
+ export declare function logLine(message: string): void;
10
+ /** A failure `isy health` must be able to find long after it happened. */
11
+ export declare function logError(message: string): void;
12
+ export declare function errorMessage(error: unknown): string;
13
+ export declare function readJournal(limit?: number): JournalEntry[];
14
+ /**
15
+ * Failures of unattended work that no later success has answered for. An upload
16
+ * that failed and then succeeded is history; one that failed after the last
17
+ * success is a machine that is still broken.
18
+ */
19
+ export declare function unresolvedErrors(lastSuccessAt?: string, entries?: JournalEntry[]): JournalEntry[];
package/dist/log.js ADDED
@@ -0,0 +1,97 @@
1
+ import { appendFileSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
2
+ import { isyHome, logPath } from "./paths.js";
3
+ /**
4
+ * ponytail: past this size the oldest half is dropped in place. A journal
5
+ * nobody rotates fills a disk, and nothing here is worth a rotation scheme.
6
+ */
7
+ const MAX_LOG_BYTES = 512 * 1024;
8
+ /**
9
+ * Operations that run unattended. A failure in one of these is invisible until
10
+ * something goes looking, which is what `isy health` is for. Failures of the
11
+ * commands a user typed are already on their screen.
12
+ */
13
+ const UNATTENDED = new Set(["upload", "commit", "check"]);
14
+ function trim() {
15
+ try {
16
+ if (statSync(logPath()).size <= MAX_LOG_BYTES)
17
+ return;
18
+ const lines = readFileSync(logPath(), "utf8").split("\n");
19
+ writeFileSync(logPath(), lines.slice(Math.floor(lines.length / 2)).join("\n"), { mode: 0o600 });
20
+ }
21
+ catch {
22
+ return;
23
+ }
24
+ }
25
+ function write(level, message) {
26
+ try {
27
+ mkdirSync(isyHome(), { recursive: true, mode: 0o700 });
28
+ trim();
29
+ appendFileSync(logPath(), `${new Date().toISOString()} ${level} ${message}\n`, { mode: 0o600 });
30
+ }
31
+ catch {
32
+ return;
33
+ }
34
+ }
35
+ export function logLine(message) {
36
+ write("info", message);
37
+ }
38
+ /** A failure `isy health` must be able to find long after it happened. */
39
+ export function logError(message) {
40
+ write("error", message);
41
+ }
42
+ export function errorMessage(error) {
43
+ if (error instanceof Error)
44
+ return error.message;
45
+ return String(error);
46
+ }
47
+ function operationOf(message) {
48
+ const colon = message.indexOf(":");
49
+ if (colon <= 0)
50
+ return undefined;
51
+ const head = message.slice(0, colon);
52
+ return /^[a-z-]+$/.test(head) ? head : undefined;
53
+ }
54
+ function parseEntry(line) {
55
+ const space = line.indexOf(" ");
56
+ const at = space > 0 ? line.slice(0, space) : "";
57
+ const rest = space > 0 ? line.slice(space + 1) : line;
58
+ // Lines written before levels existed are informational by definition:
59
+ // logError did not exist to write them.
60
+ const levelled = /^(info|error) (.*)$/s.exec(rest);
61
+ const level = (levelled?.[1] ?? "info");
62
+ const message = levelled?.[2] ?? rest;
63
+ return { at, level, message, operation: operationOf(message) };
64
+ }
65
+ export function readJournal(limit = 200) {
66
+ let contents;
67
+ try {
68
+ contents = readFileSync(logPath(), "utf8");
69
+ }
70
+ catch {
71
+ return [];
72
+ }
73
+ const entries = contents
74
+ .split("\n")
75
+ .filter((line) => line.trim().length > 0)
76
+ .map(parseEntry);
77
+ return entries.slice(-limit);
78
+ }
79
+ /**
80
+ * Failures of unattended work that no later success has answered for. An upload
81
+ * that failed and then succeeded is history; one that failed after the last
82
+ * success is a machine that is still broken.
83
+ */
84
+ export function unresolvedErrors(lastSuccessAt, entries = readJournal()) {
85
+ const since = lastSuccessAt ? Date.parse(lastSuccessAt) : Number.NaN;
86
+ return entries.filter((entry) => {
87
+ if (entry.level !== "error")
88
+ return false;
89
+ if (entry.operation !== undefined && !UNATTENDED.has(entry.operation))
90
+ return false;
91
+ if (Number.isNaN(since))
92
+ return true;
93
+ const at = Date.parse(entry.at);
94
+ return Number.isNaN(at) || at > since;
95
+ });
96
+ }
97
+ //# sourceMappingURL=log.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ /**
2
+ * Absolute paths, rewritten so they say where a file is without saying whose
3
+ * machine it is on.
4
+ *
5
+ * A transcript records paths as the agent saw them —
6
+ * `/home/alice/work/isy/src/a.ts` — and those strings reach a pull request
7
+ * comment, the report page and a third-party model gateway. The account name in
8
+ * the second segment is the leak; the rest is information a reviewer wants.
9
+ * So a path is rewritten rather than blanked:
10
+ *
11
+ * inside the working directory → `src/a.ts`
12
+ * elsewhere under a home → `~/.config/gh/hosts.yml`
13
+ * anywhere else → left alone
14
+ *
15
+ * The repository-relative form is not a compromise, it is the form the rest of
16
+ * ISY already wants: `context.ts:wasRead` and `detectors.ts:samePath` both
17
+ * compare by suffix precisely because a transcript
18
+ * is absolute and GitHub is not, and `report.ts:fileAnchor` hashes the path
19
+ * GitHub uses. Masking makes those comparisons exact instead of lucky.
20
+ *
21
+ * Shared with the server through `isy/mask-paths`: the comment and the report
22
+ * page must mask identically, and transcripts uploaded before this existed are
23
+ * still on disk and still get published from.
24
+ */
25
+ /** The marker vocabulary the whole redaction speaks. `redact.ts` re-exports it. */
26
+ export declare const REDACTION_MARKER = "ISY_REDACTED";
27
+ export declare function marker(type: string): string;
28
+ export interface MaskRoots {
29
+ /** Where the session ran. Paths under it become repository-relative. */
30
+ cwd?: string;
31
+ /** The developer's home. Paths under it become `~/…`. */
32
+ home?: string;
33
+ }
34
+ /** `MaskRoots` split into segments once, ready for the segment-by-segment match. */
35
+ export interface PreparedRoots {
36
+ cwd?: string[];
37
+ home?: string[];
38
+ }
39
+ /**
40
+ * Roots as the matcher wants them. Accepts them already split so a caller
41
+ * masking every string of a transcript does not re-split its own working
42
+ * directory a hundred thousand times.
43
+ */
44
+ export declare function resolveRoots(roots: MaskRoots | PreparedRoots): PreparedRoots;
45
+ /** Whether the string is a path outright, rather than text that may hold one. */
46
+ export declare function looksAbsolute(value: string): boolean;
47
+ /**
48
+ * Every absolute path inside a stretch of text — a shell command, a compiler
49
+ * error, a line of stdout. `onMask` is called once per path actually rewritten,
50
+ * so the redaction summary can count them the way it counts secrets.
51
+ */
52
+ export declare function maskPaths(text: string, roots: MaskRoots | PreparedRoots, onMask?: (amount: number) => void): string;
53
+ /**
54
+ * A value that is a path and nothing else — `file_path`, `cwd`, `filePath`.
55
+ * Handled apart from `maskPaths` because such a value may hold a space, which
56
+ * inside free text is where a path ends.
57
+ */
58
+ export declare function maskPath(value: string, roots: MaskRoots | PreparedRoots, onMask?: (amount: number) => void): string;
59
+ /** The keys whose value is a path outright, wherever it sits in a record. */
60
+ export declare const PATH_KEYS: ReadonlySet<string>;
61
+ /**
62
+ * The working directory a transcript record names, which is the root every
63
+ * other path in that transcript is relative to. One rule, two callers: the
64
+ * client learns it while redacting, the server while reading a transcript back
65
+ * off disk — and they must agree, or a comment and a report page would spell
66
+ * the same file two ways.
67
+ */
68
+ export declare function rootOf(record: unknown): string | undefined;
69
+ /**
70
+ * Every string anywhere in a value, masked. Used where a whole record has to
71
+ * come out clean and naming the fields one by one would mean a leak per field
72
+ * missed — a tool result nests its payload differently for every tool, and the
73
+ * transcript format is undocumented and moves between CLI versions.
74
+ */
75
+ export declare function maskDeep<T>(value: T, roots: MaskRoots | PreparedRoots, onMask?: (amount: number) => void): T;