agent-steward 0.0.5 → 0.0.6

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 (191) hide show
  1. package/CHANGELOG.md +176 -1
  2. package/README.md +9 -7
  3. package/ROADMAP-STRATEGY.md +5 -5
  4. package/ROADMAP.md +107 -17
  5. package/dist/cli.js +5 -0
  6. package/dist/core/analytics.d.ts +6 -0
  7. package/dist/core/analytics.d.ts.map +1 -1
  8. package/dist/core/analytics.js +20 -3
  9. package/dist/core/audit.d.ts +6 -0
  10. package/dist/core/audit.d.ts.map +1 -1
  11. package/dist/core/audit.js +24 -0
  12. package/dist/core/budget.d.ts +118 -0
  13. package/dist/core/budget.d.ts.map +1 -0
  14. package/dist/core/budget.js +206 -0
  15. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  16. package/dist/core/cron-to-schtasks.js +38 -0
  17. package/dist/core/dry-run.d.ts +26 -1
  18. package/dist/core/dry-run.d.ts.map +1 -1
  19. package/dist/core/dry-run.js +199 -8
  20. package/dist/core/feedback.d.ts +192 -0
  21. package/dist/core/feedback.d.ts.map +1 -0
  22. package/dist/core/feedback.js +426 -0
  23. package/dist/core/gate-integrity.d.ts +36 -0
  24. package/dist/core/gate-integrity.d.ts.map +1 -1
  25. package/dist/core/gate-integrity.js +144 -1
  26. package/dist/core/local-ai.d.ts.map +1 -1
  27. package/dist/core/local-ai.js +7 -3
  28. package/dist/core/matrix.d.ts +8 -0
  29. package/dist/core/matrix.d.ts.map +1 -1
  30. package/dist/core/matrix.js +57 -2
  31. package/dist/core/mission.d.ts +20 -0
  32. package/dist/core/mission.d.ts.map +1 -1
  33. package/dist/core/mission.js +45 -5
  34. package/dist/core/opencode-models.d.ts +2 -2
  35. package/dist/core/opencode-models.d.ts.map +1 -1
  36. package/dist/core/opencode-models.js +28 -21
  37. package/dist/core/opencode-usage.d.ts +35 -0
  38. package/dist/core/opencode-usage.d.ts.map +1 -0
  39. package/dist/core/opencode-usage.js +132 -0
  40. package/dist/core/pipeline-io.d.ts +1 -1
  41. package/dist/core/pipeline-io.d.ts.map +1 -1
  42. package/dist/core/pipeline-io.js +26 -12
  43. package/dist/core/pipeline-map.d.ts +6 -0
  44. package/dist/core/pipeline-map.d.ts.map +1 -1
  45. package/dist/core/pipeline-map.js +12 -0
  46. package/dist/core/ps-wrapper.d.ts +10 -2
  47. package/dist/core/ps-wrapper.d.ts.map +1 -1
  48. package/dist/core/ps-wrapper.js +176 -5
  49. package/dist/core/record-history.d.ts.map +1 -1
  50. package/dist/core/record-history.js +76 -4
  51. package/dist/core/run-mode.d.ts +12 -0
  52. package/dist/core/run-mode.d.ts.map +1 -0
  53. package/dist/core/run-mode.js +17 -0
  54. package/dist/core/scheduler/logs.d.ts +4 -0
  55. package/dist/core/scheduler/logs.d.ts.map +1 -1
  56. package/dist/core/scheduler/logs.js +25 -1
  57. package/dist/core/secrets.d.ts.map +1 -1
  58. package/dist/core/secrets.js +18 -8
  59. package/dist/core/self-analysis.d.ts +32 -2
  60. package/dist/core/self-analysis.d.ts.map +1 -1
  61. package/dist/core/self-analysis.js +38 -27
  62. package/dist/core/shutdown.d.ts +33 -2
  63. package/dist/core/shutdown.d.ts.map +1 -1
  64. package/dist/core/shutdown.js +58 -2
  65. package/dist/core/structured-log.d.ts +30 -0
  66. package/dist/core/structured-log.d.ts.map +1 -1
  67. package/dist/core/structured-log.js +37 -0
  68. package/dist/core/usage-surface.d.ts +25 -0
  69. package/dist/core/usage-surface.d.ts.map +1 -0
  70. package/dist/core/usage-surface.js +41 -0
  71. package/dist/core/wrappers/bash.d.ts +2 -0
  72. package/dist/core/wrappers/bash.d.ts.map +1 -1
  73. package/dist/core/wrappers/bash.js +58 -6
  74. package/dist/db/history-repo.d.ts +32 -0
  75. package/dist/db/history-repo.d.ts.map +1 -1
  76. package/dist/db/history-repo.js +85 -7
  77. package/dist/db/metrics-repo.d.ts +20 -2
  78. package/dist/db/metrics-repo.d.ts.map +1 -1
  79. package/dist/db/metrics-repo.js +33 -11
  80. package/dist/db/migrate.d.ts.map +1 -1
  81. package/dist/db/migrate.js +37 -17
  82. package/dist/db/recovery.d.ts +3 -1
  83. package/dist/db/recovery.d.ts.map +1 -1
  84. package/dist/db/recovery.js +9 -4
  85. package/dist/db/runs-repo.d.ts.map +1 -1
  86. package/dist/db/runs-repo.js +71 -56
  87. package/dist/db/schema.d.ts +2 -2
  88. package/dist/db/schema.d.ts.map +1 -1
  89. package/dist/db/schema.js +70 -1
  90. package/dist/db/templates-repo.d.ts +2 -2
  91. package/dist/db/templates-repo.d.ts.map +1 -1
  92. package/dist/db/templates-repo.js +5 -3
  93. package/dist/history.d.ts +6 -1
  94. package/dist/history.d.ts.map +1 -1
  95. package/dist/history.js +4 -2
  96. package/dist/hook-output.d.ts +2 -0
  97. package/dist/hook-output.d.ts.map +1 -0
  98. package/dist/hook-output.js +31 -0
  99. package/dist/index.d.ts +247 -53
  100. package/dist/index.d.ts.map +1 -1
  101. package/dist/index.js +999 -211
  102. package/dist/notifications.d.ts +31 -2
  103. package/dist/notifications.d.ts.map +1 -1
  104. package/dist/notifications.js +132 -13
  105. package/dist/profiles.d.ts.map +1 -1
  106. package/dist/profiles.js +66 -15
  107. package/dist/rpc.d.ts +108 -0
  108. package/dist/rpc.d.ts.map +1 -1
  109. package/dist/rpc.js +28 -0
  110. package/dist/server.d.ts +17 -2
  111. package/dist/server.d.ts.map +1 -1
  112. package/dist/server.js +77 -12
  113. package/dist/settings.d.ts +42 -0
  114. package/dist/settings.d.ts.map +1 -1
  115. package/dist/settings.js +82 -0
  116. package/dist/task-transfer.d.ts +5 -0
  117. package/dist/task-transfer.d.ts.map +1 -1
  118. package/dist/task-transfer.js +48 -3
  119. package/dist/templates.d.ts +2 -2
  120. package/dist/templates.d.ts.map +1 -1
  121. package/dist/templates.js +3 -3
  122. package/dist/types.d.ts +22 -2
  123. package/dist/types.d.ts.map +1 -1
  124. package/dist/workspaces.d.ts.map +1 -1
  125. package/dist/workspaces.js +34 -11
  126. package/docs/ARCHITECTURE.md +49 -12
  127. package/docs/COMPATIBILITY.md +2 -2
  128. package/docs/EXECUTION-LOOP.md +6 -3
  129. package/docs/FEATURES.md +65 -4
  130. package/docs/FEATURES.zh.md +45 -2
  131. package/docs/QA-A2-GUI-TUI.md +205 -0
  132. package/docs/README.ru.md +3 -3
  133. package/docs/README.zh.md +2 -2
  134. package/gui-experimental.cjs +9 -9
  135. package/locales/en.json +42 -3
  136. package/locales/ru.json +42 -3
  137. package/locales/zh.json +42 -3
  138. package/package.json +15 -2
  139. package/scripts/check-eslint-baseline.mjs +139 -0
  140. package/scripts/gen-test-plan-counters.mjs +117 -0
  141. package/scripts/github-ci-fetch.ps1 +37 -0
  142. package/scripts/pl-commit.ps1 +112 -0
  143. package/scripts/qa-a2-commit.ps1 +104 -0
  144. package/scripts/test-home.mjs +26 -2
  145. package/skills/scheduled-job-best-practices/SKILL.md +95 -1
  146. package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
  147. package/src/cli.ts +5 -0
  148. package/src/core/analytics.ts +27 -4
  149. package/src/core/audit.ts +25 -0
  150. package/src/core/budget.ts +340 -0
  151. package/src/core/cron-to-schtasks.ts +42 -0
  152. package/src/core/dry-run.ts +233 -10
  153. package/src/core/feedback.ts +582 -0
  154. package/src/core/gate-integrity.ts +171 -1
  155. package/src/core/local-ai.ts +7 -3
  156. package/src/core/matrix.ts +63 -2
  157. package/src/core/mission.ts +51 -5
  158. package/src/core/opencode-models.ts +30 -21
  159. package/src/core/opencode-usage.ts +182 -0
  160. package/src/core/pipeline-io.ts +28 -11
  161. package/src/core/pipeline-map.ts +19 -0
  162. package/src/core/ps-wrapper.ts +173 -4
  163. package/src/core/record-history.ts +94 -4
  164. package/src/core/run-mode.ts +19 -0
  165. package/src/core/scheduler/logs.ts +32 -1
  166. package/src/core/secrets.ts +18 -11
  167. package/src/core/self-analysis.ts +75 -29
  168. package/src/core/shutdown.ts +90 -4
  169. package/src/core/structured-log.ts +67 -0
  170. package/src/core/usage-surface.ts +70 -0
  171. package/src/core/wrappers/bash.ts +60 -5
  172. package/src/db/history-repo.ts +153 -19
  173. package/src/db/metrics-repo.ts +38 -11
  174. package/src/db/migrate.ts +57 -32
  175. package/src/db/recovery.ts +10 -4
  176. package/src/db/runs-repo.ts +113 -61
  177. package/src/db/schema.ts +70 -1
  178. package/src/db/templates-repo.ts +5 -3
  179. package/src/gui.tsx +261 -5
  180. package/src/history.ts +10 -3
  181. package/src/hook-output.ts +39 -0
  182. package/src/index.ts +1407 -345
  183. package/src/notifications.ts +189 -39
  184. package/src/profiles.ts +72 -16
  185. package/src/rpc.ts +30 -0
  186. package/src/server.ts +107 -23
  187. package/src/settings.ts +120 -0
  188. package/src/task-transfer.ts +59 -6
  189. package/src/templates.ts +3 -3
  190. package/src/types.ts +23 -2
  191. package/src/workspaces.ts +37 -14
package/src/types.ts CHANGED
@@ -201,8 +201,8 @@ export type ListJobsArgs = z.infer<typeof ListJobsArgs>;
201
201
  * Результат преобразования cron в флаги schtasks.
202
202
  */
203
203
  export interface CronConversion {
204
- /** Тип расписания schtasks: MINUTE, DAILY или WEEKLY. */
205
- sc: "MINUTE" | "HOURLY" | "DAILY" | "WEEKLY";
204
+ /** Тип расписания schtasks: MINUTE, HOURLY, DAILY, WEEKLY или MONTHLY. */
205
+ sc: "MINUTE" | "HOURLY" | "DAILY" | "WEEKLY" | "MONTHLY";
206
206
  /** Дополнительные флаги командной строки (кроме /sc и /tn /tr /f). */
207
207
  extraFlags: string[];
208
208
  /** Время начала для /st (HH:MM) или undefined. */
@@ -233,3 +233,24 @@ export interface ScheduledTaskInfo {
233
233
  /** true — задача поставлена на паузу (disabled). */
234
234
  paused?: boolean;
235
235
  }
236
+
237
+ /**
238
+ * Строка history.json, приведённая к колонкам БД миграцией (QA-A2.4).
239
+ * Все поля уже проверены type guard'ами в src/db/migrate.ts: строки непустые,
240
+ * числа конечные, а status сужен до значений, которые умеет писать миграция.
241
+ */
242
+ export interface MigrationHistoryRow {
243
+ taskName: string;
244
+ /** skipped/running в legacy JSON не встречаются: миграция пишет только эти четыре. */
245
+ status: "success" | "partial" | "timeout" | "error";
246
+ startedAt: string;
247
+ finishedAt: string | null;
248
+ durationMs: number | null;
249
+ error: string | null;
250
+ tokens: number | null;
251
+ costUsd: number | null;
252
+ model: string | null;
253
+ preFlightStatus: string | null;
254
+ postFlightStatus: string | null;
255
+ nextTask: string | null;
256
+ }
package/src/workspaces.ts CHANGED
@@ -46,6 +46,25 @@ export interface UpdateWorkspacePatch {
46
46
  /** Максимум пар env на workspace — защита от раздувания строки JSON. */
47
47
  export const MAX_WORKSPACE_ENV_PAIRS = 100;
48
48
 
49
+ /**
50
+ * Строковое представление unknown для env и колонок БД (QA-A2.5).
51
+ * Для примитивов совпадает с String(); объекты дают стандартный '[object Object]'
52
+ * (в JSON и в текстовых колонках SQLite таких значений не бывает).
53
+ */
54
+ function safeString(value: unknown): string {
55
+ if (value === null || value === undefined) return String(value);
56
+ switch (typeof value) {
57
+ case "string":
58
+ case "number":
59
+ case "boolean":
60
+ case "bigint":
61
+ case "symbol":
62
+ return String(value);
63
+ default:
64
+ return "[object Object]";
65
+ }
66
+ }
67
+
49
68
  /** Палитра цветных маркеров для GUI/дашборда. */
50
69
  export const WORKSPACE_COLORS = [
51
70
  "#5b8def",
@@ -90,7 +109,7 @@ export function normalizeWorkspaceEnv(
90
109
  if (typeof rawValue === "object") {
91
110
  throw new Error(`Значение env '${key}' должно быть строкой.`);
92
111
  }
93
- result[key] = String(rawValue);
112
+ result[key] = safeString(rawValue);
94
113
  }
95
114
  return result;
96
115
  }
@@ -279,24 +298,24 @@ export function writeWorkspaceEnvFile(
279
298
  return file;
280
299
  }
281
300
 
282
- function rowToWorkspace(row: any): Workspace {
301
+ function rowToWorkspace(row: Record<string, unknown>): Workspace {
283
302
  let env: Record<string, string> | undefined;
284
303
  if (row.env_json) {
285
304
  try {
286
- env = normalizeWorkspaceEnv(JSON.parse(String(row.env_json)));
305
+ env = normalizeWorkspaceEnv(JSON.parse(safeString(row.env_json)));
287
306
  } catch {
288
307
  env = undefined;
289
308
  }
290
309
  }
291
310
  return {
292
- id: String(row.id),
293
- name: String(row.name),
294
- path: String(row.path),
295
- gitRemote: row.git_remote == null ? undefined : String(row.git_remote),
296
- color: row.color == null ? undefined : String(row.color),
311
+ id: safeString(row.id),
312
+ name: safeString(row.name),
313
+ path: safeString(row.path),
314
+ gitRemote: row.git_remote == null ? undefined : safeString(row.git_remote),
315
+ color: row.color == null ? undefined : safeString(row.color),
297
316
  env,
298
- envFile: row.env_file == null ? undefined : String(row.env_file),
299
- createdAt: String(row.created_at),
317
+ envFile: row.env_file == null ? undefined : safeString(row.env_file),
318
+ createdAt: safeString(row.created_at),
300
319
  };
301
320
  }
302
321
 
@@ -371,14 +390,16 @@ export function readGitBranch(workspacePath: string): string | undefined {
371
390
  export function listWorkspaces(): Workspace[] {
372
391
  const rows = getDb()
373
392
  .prepare("SELECT * FROM workspaces ORDER BY name COLLATE NOCASE ASC")
374
- .all();
393
+ .all() as Record<string, unknown>[];
375
394
  return rows.map(rowToWorkspace);
376
395
  }
377
396
 
378
397
  /** Workspace по id. */
379
398
  export function getWorkspace(id: string): Workspace | undefined {
380
399
  if (!id) return undefined;
381
- const row = getDb().prepare("SELECT * FROM workspaces WHERE id = ?").get(id);
400
+ const row = getDb()
401
+ .prepare("SELECT * FROM workspaces WHERE id = ?")
402
+ .get(id) as Record<string, unknown> | undefined;
382
403
  return row ? rowToWorkspace(row) : undefined;
383
404
  }
384
405
 
@@ -387,7 +408,7 @@ export function getWorkspaceByPath(workspacePath: string): Workspace | undefined
387
408
  const normalized = normalizePath(workspacePath);
388
409
  const row = getDb()
389
410
  .prepare("SELECT * FROM workspaces WHERE lower(path) = lower(?) LIMIT 1")
390
- .get(normalized);
411
+ .get(normalized) as Record<string, unknown> | undefined;
391
412
  return row ? rowToWorkspace(row) : undefined;
392
413
  }
393
414
 
@@ -531,6 +552,8 @@ export function deleteWorkspace(id: string): boolean {
531
552
 
532
553
  /** Количество workspace (для сводок и тестов). */
533
554
  export function countWorkspaces(): number {
534
- const row = getDb().prepare("SELECT COUNT(*) AS count FROM workspaces").get();
555
+ const row = getDb()
556
+ .prepare("SELECT COUNT(*) AS count FROM workspaces")
557
+ .get() as Record<string, unknown> | undefined;
535
558
  return Number(row?.count) || 0;
536
559
  }