@jterrats/open-orchestra 0.5.7 → 1.0.2

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 (260) hide show
  1. package/AGENTS.md +9 -8
  2. package/CLAUDE.md +13 -11
  3. package/README.md +78 -11
  4. package/dist/assets/web-console.js +169 -32
  5. package/dist/automation-evidence.d.ts +23 -0
  6. package/dist/automation-evidence.js +97 -0
  7. package/dist/automation-evidence.js.map +1 -0
  8. package/dist/autonomous-run-store.js +3 -3
  9. package/dist/autonomous-run-store.js.map +1 -1
  10. package/dist/benchmark.d.ts +4 -1
  11. package/dist/benchmark.js +93 -4
  12. package/dist/benchmark.js.map +1 -1
  13. package/dist/cli.js +73 -2
  14. package/dist/cli.js.map +1 -1
  15. package/dist/collaboration-flows.js +3 -5
  16. package/dist/collaboration-flows.js.map +1 -1
  17. package/dist/collection-utils.d.ts +3 -0
  18. package/dist/collection-utils.js +10 -0
  19. package/dist/collection-utils.js.map +1 -0
  20. package/dist/command-manifest.d.ts +12 -1
  21. package/dist/command-manifest.js +213 -10
  22. package/dist/command-manifest.js.map +1 -1
  23. package/dist/commands.d.ts +10 -5
  24. package/dist/commands.js +16 -6
  25. package/dist/commands.js.map +1 -1
  26. package/dist/config-migrations.d.ts +24 -0
  27. package/dist/config-migrations.js +102 -0
  28. package/dist/config-migrations.js.map +1 -0
  29. package/dist/constants.d.ts +2 -0
  30. package/dist/constants.js +23 -0
  31. package/dist/constants.js.map +1 -1
  32. package/dist/dashboard-commands.d.ts +2 -0
  33. package/dist/dashboard-commands.js +14 -0
  34. package/dist/dashboard-commands.js.map +1 -0
  35. package/dist/defaults.d.ts +13 -0
  36. package/dist/defaults.js +13 -0
  37. package/dist/defaults.js.map +1 -1
  38. package/dist/delegation-decision.js +23 -8
  39. package/dist/delegation-decision.js.map +1 -1
  40. package/dist/delivery-commands.js +5 -0
  41. package/dist/delivery-commands.js.map +1 -1
  42. package/dist/delivery-dashboard-charts.d.ts +4 -0
  43. package/dist/delivery-dashboard-charts.js +156 -0
  44. package/dist/delivery-dashboard-charts.js.map +1 -0
  45. package/dist/delivery-dashboard-html.d.ts +2 -0
  46. package/dist/delivery-dashboard-html.js +115 -0
  47. package/dist/delivery-dashboard-html.js.map +1 -0
  48. package/dist/delivery-dashboard-types.d.ts +78 -0
  49. package/dist/delivery-dashboard-types.js +2 -0
  50. package/dist/delivery-dashboard-types.js.map +1 -0
  51. package/dist/delivery-dashboard.d.ts +8 -0
  52. package/dist/delivery-dashboard.js +124 -0
  53. package/dist/delivery-dashboard.js.map +1 -0
  54. package/dist/effort-classification.d.ts +7 -0
  55. package/dist/effort-classification.js +72 -0
  56. package/dist/effort-classification.js.map +1 -0
  57. package/dist/extension-commands.d.ts +3 -0
  58. package/dist/extension-commands.js +40 -0
  59. package/dist/extension-commands.js.map +1 -0
  60. package/dist/extensions.d.ts +22 -0
  61. package/dist/extensions.js +126 -0
  62. package/dist/extensions.js.map +1 -0
  63. package/dist/github.d.ts +2 -0
  64. package/dist/github.js +15 -3
  65. package/dist/github.js.map +1 -1
  66. package/dist/health-checks.js +51 -0
  67. package/dist/health-checks.js.map +1 -1
  68. package/dist/lucid-story-map.d.ts +73 -0
  69. package/dist/lucid-story-map.js +112 -0
  70. package/dist/lucid-story-map.js.map +1 -0
  71. package/dist/mcp-integrations.d.ts +19 -0
  72. package/dist/mcp-integrations.js +58 -0
  73. package/dist/mcp-integrations.js.map +1 -0
  74. package/dist/mcp-tool-adapter.d.ts +21 -0
  75. package/dist/mcp-tool-adapter.js +56 -0
  76. package/dist/mcp-tool-adapter.js.map +1 -0
  77. package/dist/memory.js +18 -8
  78. package/dist/memory.js.map +1 -1
  79. package/dist/metrics-commands.js +47 -13
  80. package/dist/metrics-commands.js.map +1 -1
  81. package/dist/model-commands.d.ts +5 -0
  82. package/dist/model-commands.js +101 -3
  83. package/dist/model-commands.js.map +1 -1
  84. package/dist/model-providers.js +13 -1
  85. package/dist/model-providers.js.map +1 -1
  86. package/dist/package-update-check.d.ts +18 -0
  87. package/dist/package-update-check.js +20 -0
  88. package/dist/package-update-check.js.map +1 -1
  89. package/dist/phase-executor.d.ts +1 -0
  90. package/dist/phase-executor.js +118 -14
  91. package/dist/phase-executor.js.map +1 -1
  92. package/dist/phase-playbooks.d.ts +15 -0
  93. package/dist/phase-playbooks.js +82 -0
  94. package/dist/phase-playbooks.js.map +1 -1
  95. package/dist/planning-commands.d.ts +1 -0
  96. package/dist/planning-commands.js +24 -1
  97. package/dist/planning-commands.js.map +1 -1
  98. package/dist/project-detection.js +9 -7
  99. package/dist/project-detection.js.map +1 -1
  100. package/dist/prompt-registry-update.d.ts +2 -0
  101. package/dist/prompt-registry-update.js +25 -1
  102. package/dist/prompt-registry-update.js.map +1 -1
  103. package/dist/prompt-registry-validation.js +39 -2
  104. package/dist/prompt-registry-validation.js.map +1 -1
  105. package/dist/qa-commands.d.ts +2 -0
  106. package/dist/qa-commands.js +18 -0
  107. package/dist/qa-commands.js.map +1 -0
  108. package/dist/qa-coverage.d.ts +24 -0
  109. package/dist/qa-coverage.js +198 -0
  110. package/dist/qa-coverage.js.map +1 -0
  111. package/dist/qa-readiness.d.ts +5 -0
  112. package/dist/qa-readiness.js +26 -0
  113. package/dist/qa-readiness.js.map +1 -0
  114. package/dist/refresh-generated.d.ts +10 -1
  115. package/dist/refresh-generated.js +83 -6
  116. package/dist/refresh-generated.js.map +1 -1
  117. package/dist/release-candidate.d.ts +9 -1
  118. package/dist/release-candidate.js +52 -1
  119. package/dist/release-candidate.js.map +1 -1
  120. package/dist/release-commands.js +202 -12
  121. package/dist/release-commands.js.map +1 -1
  122. package/dist/release-readiness.d.ts +36 -1
  123. package/dist/release-readiness.js +217 -6
  124. package/dist/release-readiness.js.map +1 -1
  125. package/dist/runtime-bootstrap.js +1 -1
  126. package/dist/runtime-bootstrap.js.map +1 -1
  127. package/dist/runtime-commands.d.ts +2 -0
  128. package/dist/runtime-commands.js +77 -0
  129. package/dist/runtime-commands.js.map +1 -1
  130. package/dist/runtime-execution-renderer.d.ts +3 -2
  131. package/dist/runtime-execution-renderer.js +19 -1
  132. package/dist/runtime-execution-renderer.js.map +1 -1
  133. package/dist/runtime-execution.d.ts +2 -1
  134. package/dist/runtime-execution.js +71 -11
  135. package/dist/runtime-execution.js.map +1 -1
  136. package/dist/runtime-guardrails.d.ts +26 -0
  137. package/dist/runtime-guardrails.js +168 -0
  138. package/dist/runtime-guardrails.js.map +1 -0
  139. package/dist/setup-agents-import.js +5 -3
  140. package/dist/setup-agents-import.js.map +1 -1
  141. package/dist/skills-catalog.js +63 -0
  142. package/dist/skills-catalog.js.map +1 -1
  143. package/dist/skills-commands.d.ts +4 -0
  144. package/dist/skills-commands.js +55 -2
  145. package/dist/skills-commands.js.map +1 -1
  146. package/dist/skills-memory.d.ts +36 -2
  147. package/dist/skills-memory.js +165 -6
  148. package/dist/skills-memory.js.map +1 -1
  149. package/dist/skills-planning.js +2 -4
  150. package/dist/skills-planning.js.map +1 -1
  151. package/dist/skills-render.js +2 -4
  152. package/dist/skills-render.js.map +1 -1
  153. package/dist/skills.d.ts +1 -1
  154. package/dist/skills.js +1 -1
  155. package/dist/skills.js.map +1 -1
  156. package/dist/sprint-commands.js +2 -1
  157. package/dist/sprint-commands.js.map +1 -1
  158. package/dist/subagent-protocol.js +3 -5
  159. package/dist/subagent-protocol.js.map +1 -1
  160. package/dist/support-commands.d.ts +2 -0
  161. package/dist/support-commands.js +18 -0
  162. package/dist/support-commands.js.map +1 -0
  163. package/dist/support-diagnostics.d.ts +49 -0
  164. package/dist/support-diagnostics.js +86 -0
  165. package/dist/support-diagnostics.js.map +1 -0
  166. package/dist/task-graph-commands.js +5 -3
  167. package/dist/task-graph-commands.js.map +1 -1
  168. package/dist/telemetry-redaction.js +8 -1
  169. package/dist/telemetry-redaction.js.map +1 -1
  170. package/dist/tool-commands.d.ts +3 -0
  171. package/dist/tool-commands.js +62 -0
  172. package/dist/tool-commands.js.map +1 -1
  173. package/dist/tracker-adapters.d.ts +71 -0
  174. package/dist/tracker-adapters.js +186 -0
  175. package/dist/tracker-adapters.js.map +1 -0
  176. package/dist/tracker-commands.d.ts +2 -0
  177. package/dist/tracker-commands.js +119 -0
  178. package/dist/tracker-commands.js.map +1 -0
  179. package/dist/types/metrics.d.ts +24 -0
  180. package/dist/types/model-config.d.ts +39 -0
  181. package/dist/types/runtime.d.ts +56 -0
  182. package/dist/types/skills.d.ts +2 -0
  183. package/dist/types/tasks.d.ts +6 -0
  184. package/dist/types/workflow-run.d.ts +17 -0
  185. package/dist/types.d.ts +4 -4
  186. package/dist/types.js.map +1 -1
  187. package/dist/upgrade-commands.js +13 -4
  188. package/dist/upgrade-commands.js.map +1 -1
  189. package/dist/validation.js +2 -2
  190. package/dist/validation.js.map +1 -1
  191. package/dist/visual-validation.d.ts +81 -0
  192. package/dist/visual-validation.js +290 -0
  193. package/dist/visual-validation.js.map +1 -0
  194. package/dist/web-action-security.d.ts +11 -0
  195. package/dist/web-action-security.js +45 -0
  196. package/dist/web-action-security.js.map +1 -0
  197. package/dist/web-api-read-routes.js +101 -1
  198. package/dist/web-api-read-routes.js.map +1 -1
  199. package/dist/web-api.js +507 -5
  200. package/dist/web-api.js.map +1 -1
  201. package/dist/web-artifacts.d.ts +55 -0
  202. package/dist/web-artifacts.js +222 -0
  203. package/dist/web-artifacts.js.map +1 -0
  204. package/dist/web-console/assets/index-BNESIVvk.js +11 -0
  205. package/dist/web-console/assets/index-jxCY5eEc.css +1 -0
  206. package/dist/web-console/index.html +13 -0
  207. package/dist/web-console.js +9 -3
  208. package/dist/web-console.js.map +1 -1
  209. package/dist/web-recovery.d.ts +30 -0
  210. package/dist/web-recovery.js +163 -0
  211. package/dist/web-recovery.js.map +1 -0
  212. package/dist/web-workflow-progress.d.ts +41 -0
  213. package/dist/web-workflow-progress.js +114 -0
  214. package/dist/web-workflow-progress.js.map +1 -0
  215. package/dist/workflow-approval-service.d.ts +2 -1
  216. package/dist/workflow-approval-service.js +72 -0
  217. package/dist/workflow-approval-service.js.map +1 -1
  218. package/dist/workflow-evidence-service.js +8 -1
  219. package/dist/workflow-evidence-service.js.map +1 -1
  220. package/dist/workflow-gates.d.ts +2 -0
  221. package/dist/workflow-gates.js +221 -0
  222. package/dist/workflow-gates.js.map +1 -1
  223. package/dist/workflow-run-commands.js +13 -1
  224. package/dist/workflow-run-commands.js.map +1 -1
  225. package/dist/workflow-services.d.ts +16 -12
  226. package/dist/workflow-services.js +313 -253
  227. package/dist/workflow-services.js.map +1 -1
  228. package/dist/workflow-task-service.d.ts +11 -0
  229. package/dist/workflow-task-service.js +242 -0
  230. package/dist/workflow-task-service.js.map +1 -0
  231. package/dist/workspace-validator.js +109 -3
  232. package/dist/workspace-validator.js.map +1 -1
  233. package/dist/workspace.js +8 -2
  234. package/dist/workspace.js.map +1 -1
  235. package/docs/adoption-guide.md +147 -0
  236. package/docs/autonomous-workflow.md +118 -27
  237. package/docs/benchmark.md +15 -7
  238. package/docs/command-contracts.md +18 -1
  239. package/docs/core-command-surface.md +59 -13
  240. package/docs/end-to-end-demo.md +1 -0
  241. package/docs/extension-contracts.md +83 -0
  242. package/docs/orchestra-mvp.md +83 -3
  243. package/docs/persona-workflows.md +32 -0
  244. package/docs/release-test-matrix.md +42 -0
  245. package/docs/runtime-adapters.md +92 -0
  246. package/docs/runtime-llm-flow.md +13 -0
  247. package/docs/setup-agents-applicability-review.md +173 -0
  248. package/docs/skill-loading-strategy.md +1 -0
  249. package/docs/source-of-truth-and-agent-learning.md +14 -0
  250. package/docs/traceability-flow.md +16 -1
  251. package/docs/tracker-adapter-contract.md +10 -1
  252. package/docs/web-console-qa.md +35 -0
  253. package/package.json +12 -6
  254. package/rules/development-engineering.mdc +68 -0
  255. package/rules/devops-tooling.mdc +1 -0
  256. package/rules/dry-clean-code.mdc +1 -0
  257. package/rules/performance-reliability.mdc +1 -0
  258. package/rules/testing-discipline.mdc +4 -1
  259. package/skills/collection-standards/SKILL.md +63 -0
  260. package/skills/collection-standards/manifest.json +69 -0
@@ -2,7 +2,7 @@ import { readFile } from "node:fs/promises";
2
2
  import { dirname, join } from "node:path";
3
3
  import { fileURLToPath } from "node:url";
4
4
  import { getLocalHealthReport } from "./health-checks.js";
5
- import { canonicalInstallCommand, checkPackageUpdate, postInstallSmokeCommand, } from "./package-update-check.js";
5
+ import { buildInstalledPackageUpgradePlan, canonicalInstallCommand, checkPackageUpdate, postInstallSmokeCommand, } from "./package-update-check.js";
6
6
  const PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
7
7
  const PACKAGE_NAME = "@jterrats/open-orchestra";
8
8
  export async function upgradeCommand(options, io) {
@@ -33,15 +33,24 @@ export async function upgradeCommand(options, io) {
33
33
  currentVersion: packageInfo.version,
34
34
  distTag,
35
35
  });
36
- const fallbackCommand = canonicalInstallCommand(PACKAGE_NAME, distTag);
36
+ const targetVersionOrTag = update?.latestVersion ?? distTag;
37
+ const plan = buildInstalledPackageUpgradePlan({
38
+ packageName: PACKAGE_NAME,
39
+ currentVersion: packageInfo.version,
40
+ targetVersionOrTag,
41
+ });
37
42
  const result = {
38
43
  packageName: PACKAGE_NAME,
39
44
  currentVersion: packageInfo.version,
40
45
  distTag,
41
46
  latestVersion: update?.latestVersion,
42
47
  isOutdated: update?.isOutdated ?? false,
43
- installCommand: update?.updateCommand ?? fallbackCommand,
44
- smokeCommand: postInstallSmokeCommand(),
48
+ installCommand: update?.updateCommand ?? canonicalInstallCommand(PACKAGE_NAME, distTag),
49
+ smokeCommand: plan.smokeCommand,
50
+ rollbackCommand: plan.rollbackCommand,
51
+ rollbackSmokeCommand: plan.rollbackSmokeCommand,
52
+ migrationCheckCommand: plan.migrationCheckCommand,
53
+ postUpgradeCommands: plan.postUpgradeCommands,
45
54
  registryChecked: Boolean(update),
46
55
  };
47
56
  if (options.json) {
@@ -1 +1 @@
1
- {"version":3,"file":"upgrade-commands.js","sourceRoot":"","sources":["../src/upgrade-commands.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"upgrade-commands.js","sourceRoot":"","sources":["../src/upgrade-commands.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { EVIDENCE_TYPE_ALIASES, EVIDENCE_TYPES, REVIEW_RESULTS, REVIEW_ROLE_ALIASES, SEVERITIES, TASK_STATUSES, } from "./constants.js";
1
+ import { EVIDENCE_TYPE_ALIASES, EVIDENCE_TYPES, REVIEW_RESULTS, REVIEW_ROLE_ALIASES, SEVERITIES, normalizeTaskStatus, } from "./constants.js";
2
2
  export function assertObject(value, name) {
3
3
  if (!value || typeof value !== "object" || Array.isArray(value)) {
4
4
  throw new Error(`${name} must be an object`);
@@ -80,7 +80,7 @@ export function validateTasks(tasks, roleIds) {
80
80
  throw new Error(`task ${task.id} has unknown owner role: ${task.ownerRole}`);
81
81
  }
82
82
  if (typeof task.status !== "string" ||
83
- !TASK_STATUSES.includes(task.status)) {
83
+ normalizeTaskStatus(task.status) === undefined) {
84
84
  throw new Error(`task ${task.id} has invalid status: ${task.status}`);
85
85
  }
86
86
  if (taskIds.has(task.id)) {
@@ -1 +1 @@
1
- {"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,81 @@
1
+ export type VisualTool = "lucid" | "figma" | "drawio" | "mermaid";
2
+ export type VisualValidationSeverity = "info" | "warning" | "blocking";
3
+ export interface VisualBounds {
4
+ x: number;
5
+ y: number;
6
+ width: number;
7
+ height: number;
8
+ }
9
+ export interface VisualArtifactItem extends VisualBounds {
10
+ id: string;
11
+ text?: string;
12
+ expectedText?: string;
13
+ kind?: "shape" | "icon" | "label" | "container" | "edge";
14
+ groupId?: string;
15
+ containerId?: string;
16
+ requiredContent?: boolean;
17
+ rotation?: number;
18
+ rotationUnit?: "degrees" | "radians";
19
+ expectedRotation?: number;
20
+ expectedRotationUnit?: "degrees" | "radians";
21
+ }
22
+ export interface VisualExportArtifact {
23
+ type: "png" | "svg" | "json";
24
+ path: string;
25
+ }
26
+ export interface VisualArtifactManifest {
27
+ tool: VisualTool;
28
+ documentId: string;
29
+ pageId?: string;
30
+ items: VisualArtifactItem[];
31
+ exports?: VisualExportArtifact[];
32
+ }
33
+ export interface VisualValidationConfig {
34
+ duplicateThresholdPx: number;
35
+ minIconTextGapPx: number;
36
+ fallbackTextPatterns: string[];
37
+ maxLabelOverflowPx: number;
38
+ rotationToleranceRadians: number;
39
+ requirePngExport: boolean;
40
+ }
41
+ export interface VisualValidationFinding {
42
+ id: string;
43
+ severity: VisualValidationSeverity;
44
+ type: "bounds" | "duplicate" | "fallback_text" | "icon_text_gap" | "orphan" | "png_export" | "rotation";
45
+ message: string;
46
+ itemIds: string[];
47
+ remediable: boolean;
48
+ }
49
+ export interface VisualValidationResult {
50
+ gateId: "visual_validation";
51
+ passed: boolean;
52
+ blocking: boolean;
53
+ summary: string;
54
+ tool: VisualTool;
55
+ documentId: string;
56
+ pageId?: string;
57
+ itemCount: number;
58
+ pngExports: string[];
59
+ findings: VisualValidationFinding[];
60
+ remediations: string[];
61
+ }
62
+ export declare const DEFAULT_VISUAL_VALIDATION_CONFIG: VisualValidationConfig;
63
+ export declare function readVisualArtifactManifest(manifestPath: string): Promise<VisualArtifactManifest>;
64
+ export declare function readVisualValidationConfig(configPath?: string): Promise<VisualValidationConfig>;
65
+ export declare function validateVisualManifest(manifest: VisualArtifactManifest, config?: VisualValidationConfig): VisualValidationResult;
66
+ export declare function recordVisualArtifactsManifest({ taskId, manifest, root, }: {
67
+ taskId: string;
68
+ manifest: VisualArtifactManifest;
69
+ root?: string;
70
+ }): Promise<void>;
71
+ export declare function recordVisualValidationEvidence({ taskId, result, root, }: {
72
+ taskId: string;
73
+ result: VisualValidationResult;
74
+ root?: string;
75
+ }): Promise<{
76
+ artifact: string;
77
+ content: string;
78
+ }>;
79
+ export declare function renderVisualValidationReport(taskId: string, result: VisualValidationResult): string;
80
+ export declare function rotationToRadians(value: number, unit: "degrees" | "radians" | undefined, tool: VisualTool): number;
81
+ export declare function visualArtifactPath(root: string, artifactPath: string): string;
@@ -0,0 +1,290 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { appendEvent, writeArtifact } from "./workspace.js";
4
+ export const DEFAULT_VISUAL_VALIDATION_CONFIG = {
5
+ duplicateThresholdPx: 200,
6
+ minIconTextGapPx: 10,
7
+ fallbackTextPatterns: [
8
+ "aws-general-*",
9
+ "plugin-flowchart-shape-*",
10
+ "Type something",
11
+ ],
12
+ maxLabelOverflowPx: 0,
13
+ rotationToleranceRadians: 0.01,
14
+ requirePngExport: true,
15
+ };
16
+ export async function readVisualArtifactManifest(manifestPath) {
17
+ return JSON.parse(await readFile(manifestPath, "utf8"));
18
+ }
19
+ export async function readVisualValidationConfig(configPath) {
20
+ if (!configPath)
21
+ return DEFAULT_VISUAL_VALIDATION_CONFIG;
22
+ const parsed = JSON.parse(await readFile(configPath, "utf8"));
23
+ return { ...DEFAULT_VISUAL_VALIDATION_CONFIG, ...parsed };
24
+ }
25
+ export function validateVisualManifest(manifest, config = DEFAULT_VISUAL_VALIDATION_CONFIG) {
26
+ const findings = [
27
+ ...pngExportFindings(manifest, config),
28
+ ...duplicateTextFindings(manifest, config),
29
+ ...fallbackTextFindings(manifest, config),
30
+ ...orphanFindings(manifest),
31
+ ...boundsFindings(manifest, config),
32
+ ...iconTextGapFindings(manifest, config),
33
+ ...rotationFindings(manifest, config),
34
+ ];
35
+ const blocking = findings.some((finding) => finding.severity === "blocking");
36
+ const remediations = findings
37
+ .filter((finding) => finding.remediable)
38
+ .map((finding) => remediationFor(finding));
39
+ return {
40
+ gateId: "visual_validation",
41
+ passed: !blocking,
42
+ blocking,
43
+ summary: blocking
44
+ ? "Visual validation blocked"
45
+ : "Visual validation passed",
46
+ tool: manifest.tool,
47
+ documentId: manifest.documentId,
48
+ ...(manifest.pageId ? { pageId: manifest.pageId } : {}),
49
+ itemCount: manifest.items.length,
50
+ pngExports: (manifest.exports ?? [])
51
+ .filter((artifact) => artifact.type === "png")
52
+ .map((artifact) => artifact.path),
53
+ findings,
54
+ remediations,
55
+ };
56
+ }
57
+ export async function recordVisualArtifactsManifest({ taskId, manifest, root = process.cwd(), }) {
58
+ await appendEvent(root, {
59
+ type: "VISUAL_ARTIFACTS_RECORDED",
60
+ taskId,
61
+ actor: "architect",
62
+ summary: `Visual artifacts manifest recorded for ${manifest.tool}`,
63
+ artifacts: manifest.exports?.map((artifact) => artifact.path) ?? [],
64
+ metadata: { manifest },
65
+ });
66
+ }
67
+ export async function recordVisualValidationEvidence({ taskId, result, root = process.cwd(), }) {
68
+ const content = renderVisualValidationReport(taskId, result);
69
+ const artifact = await writeArtifact(root, "evidence", `${taskId}-${Date.now()}-visual-validation.md`, content);
70
+ await appendEvent(root, {
71
+ type: "VISUAL_VALIDATION_RECORDED",
72
+ taskId,
73
+ actor: "qa",
74
+ summary: result.summary,
75
+ artifacts: [artifact, ...result.pngExports],
76
+ metadata: { ...result, findingCount: result.findings.length },
77
+ });
78
+ await appendEvent(root, {
79
+ type: "EVIDENCE_ADDED",
80
+ taskId,
81
+ actor: "qa",
82
+ summary: result.summary,
83
+ artifacts: [artifact, ...result.pngExports],
84
+ metadata: {
85
+ type: result.pngExports.length > 0 ? "screenshot" : "report",
86
+ visualValidation: true,
87
+ gateId: result.gateId,
88
+ passed: result.passed,
89
+ findingCount: result.findings.length,
90
+ pngExports: result.pngExports,
91
+ },
92
+ });
93
+ return { artifact, content };
94
+ }
95
+ export function renderVisualValidationReport(taskId, result) {
96
+ return [
97
+ `# Visual Validation ${taskId}`,
98
+ "",
99
+ `- Status: ${result.passed ? "passed" : "blocked"}`,
100
+ `- Tool: ${result.tool}`,
101
+ `- Document: ${result.documentId}`,
102
+ `- Page: ${result.pageId ?? "not applicable"}`,
103
+ `- Items: ${result.itemCount}`,
104
+ `- PNG exports: ${result.pngExports.length}`,
105
+ "",
106
+ "## Findings",
107
+ ...(result.findings.length === 0
108
+ ? ["- none"]
109
+ : result.findings.map((finding) => `- ${finding.severity} ${finding.type}: ${finding.message}`)),
110
+ "",
111
+ "## Remediations",
112
+ ...(result.remediations.length === 0
113
+ ? ["- none"]
114
+ : result.remediations.map((remediation) => `- ${remediation}`)),
115
+ "",
116
+ ].join("\n");
117
+ }
118
+ export function rotationToRadians(value, unit, tool) {
119
+ if (unit === "degrees")
120
+ return (value * Math.PI) / 180;
121
+ if (unit === "radians")
122
+ return value;
123
+ return tool === "lucid" ? value : (value * Math.PI) / 180;
124
+ }
125
+ function pngExportFindings(manifest, config) {
126
+ if (!config.requirePngExport)
127
+ return [];
128
+ const hasPng = (manifest.exports ?? []).some((artifact) => artifact.type === "png");
129
+ return hasPng
130
+ ? []
131
+ : [
132
+ {
133
+ id: "png-export-required",
134
+ severity: "blocking",
135
+ type: "png_export",
136
+ message: "PNG export artifact is required for visual validation",
137
+ itemIds: [],
138
+ remediable: false,
139
+ },
140
+ ];
141
+ }
142
+ function duplicateTextFindings(manifest, config) {
143
+ const findings = [];
144
+ for (let leftIndex = 0; leftIndex < manifest.items.length; leftIndex += 1) {
145
+ const left = manifest.items[leftIndex];
146
+ if (!left?.text?.trim())
147
+ continue;
148
+ for (let rightIndex = leftIndex + 1; rightIndex < manifest.items.length; rightIndex += 1) {
149
+ const right = manifest.items[rightIndex];
150
+ if (!right?.text?.trim())
151
+ continue;
152
+ if (left.text.trim() !== right.text.trim())
153
+ continue;
154
+ const distance = Math.hypot(left.x - right.x, left.y - right.y);
155
+ if (distance <= config.duplicateThresholdPx) {
156
+ findings.push({
157
+ id: `duplicate-${left.id}-${right.id}`,
158
+ severity: "blocking",
159
+ type: "duplicate",
160
+ message: `Duplicate text '${left.text.trim()}' within ${Math.round(distance)}px`,
161
+ itemIds: [left.id, right.id],
162
+ remediable: true,
163
+ });
164
+ }
165
+ }
166
+ }
167
+ return findings;
168
+ }
169
+ function fallbackTextFindings(manifest, config) {
170
+ return manifest.items
171
+ .filter((item) => config.fallbackTextPatterns.some((pattern) => wildcardMatch(pattern, item.text ?? "")))
172
+ .map((item) => ({
173
+ id: `fallback-${item.id}`,
174
+ severity: "blocking",
175
+ type: "fallback_text",
176
+ message: `Fallback text is visible: '${item.text}'`,
177
+ itemIds: [item.id],
178
+ remediable: true,
179
+ }));
180
+ }
181
+ function orphanFindings(manifest) {
182
+ return manifest.items
183
+ .filter((item) => item.requiredContent && !(item.text ?? "").trim())
184
+ .map((item) => ({
185
+ id: `orphan-${item.id}`,
186
+ severity: "blocking",
187
+ type: "orphan",
188
+ message: "Required visual item has no text content",
189
+ itemIds: [item.id],
190
+ remediable: false,
191
+ }));
192
+ }
193
+ function boundsFindings(manifest, config) {
194
+ const byId = new Map(manifest.items.map((item) => [item.id, item]));
195
+ return manifest.items
196
+ .filter((item) => item.containerId && byId.has(item.containerId))
197
+ .filter((item) => {
198
+ const container = byId.get(item.containerId);
199
+ return container
200
+ ? overflowPx(item, container) > config.maxLabelOverflowPx
201
+ : false;
202
+ })
203
+ .map((item) => ({
204
+ id: `bounds-${item.id}`,
205
+ severity: "blocking",
206
+ type: "bounds",
207
+ message: `Item ${item.id} exceeds container ${item.containerId}`,
208
+ itemIds: [item.id, item.containerId],
209
+ remediable: false,
210
+ }));
211
+ }
212
+ function iconTextGapFindings(manifest, config) {
213
+ const groups = new Map();
214
+ for (const item of manifest.items) {
215
+ if (!item.groupId)
216
+ continue;
217
+ groups.set(item.groupId, [...(groups.get(item.groupId) ?? []), item]);
218
+ }
219
+ const findings = [];
220
+ for (const [groupId, items] of groups) {
221
+ const icon = items.find((item) => item.kind === "icon");
222
+ const label = items.find((item) => item.kind === "label");
223
+ if (!icon || !label)
224
+ continue;
225
+ const gap = label.x - (icon.x + icon.width);
226
+ if (gap < config.minIconTextGapPx) {
227
+ findings.push({
228
+ id: `gap-${groupId}`,
229
+ severity: "blocking",
230
+ type: "icon_text_gap",
231
+ message: `Icon/text gap is ${Math.round(gap)}px; expected at least ${config.minIconTextGapPx}px`,
232
+ itemIds: [icon.id, label.id],
233
+ remediable: true,
234
+ });
235
+ }
236
+ }
237
+ return findings;
238
+ }
239
+ function rotationFindings(manifest, config) {
240
+ return manifest.items
241
+ .filter((item) => typeof item.rotation === "number" &&
242
+ typeof item.expectedRotation === "number")
243
+ .filter((item) => {
244
+ const actual = rotationToRadians(item.rotation, item.rotationUnit, manifest.tool);
245
+ const expected = rotationToRadians(item.expectedRotation, item.expectedRotationUnit, manifest.tool);
246
+ return Math.abs(actual - expected) > config.rotationToleranceRadians;
247
+ })
248
+ .map((item) => ({
249
+ id: `rotation-${item.id}`,
250
+ severity: "blocking",
251
+ type: "rotation",
252
+ message: `Rotation mismatch for ${item.id}; Lucid values are normalized as radians`,
253
+ itemIds: [item.id],
254
+ remediable: true,
255
+ }));
256
+ }
257
+ function overflowPx(item, container) {
258
+ const rightOverflow = item.x + item.width - (container.x + container.width);
259
+ const bottomOverflow = item.y + item.height - (container.y + container.height);
260
+ const leftOverflow = container.x - item.x;
261
+ const topOverflow = container.y - item.y;
262
+ return Math.max(0, rightOverflow, bottomOverflow, leftOverflow, topOverflow);
263
+ }
264
+ function wildcardMatch(pattern, value) {
265
+ const escaped = pattern
266
+ .replace(/[.+?^${}()|[\]\\]/g, "\\$&")
267
+ .replace(/\*/g, ".*");
268
+ return new RegExp(`^${escaped}$`, "i").test(value);
269
+ }
270
+ function remediationFor(finding) {
271
+ if (finding.type === "duplicate") {
272
+ return `Delete duplicate item ${finding.itemIds[1]} after fresh fetch confirms same text.`;
273
+ }
274
+ if (finding.type === "fallback_text") {
275
+ return `Clear fallback text on ${finding.itemIds.join(", ")}.`;
276
+ }
277
+ if (finding.type === "icon_text_gap") {
278
+ return `Reposition label ${finding.itemIds[1]} to satisfy minimum icon/text gap.`;
279
+ }
280
+ if (finding.type === "rotation") {
281
+ return `Normalize rotation for ${finding.itemIds[0]} to radians before writing through Lucid MCP.`;
282
+ }
283
+ return `Review ${finding.itemIds.join(", ")} manually.`;
284
+ }
285
+ export function visualArtifactPath(root, artifactPath) {
286
+ return path.isAbsolute(artifactPath)
287
+ ? artifactPath
288
+ : path.resolve(root, artifactPath);
289
+ }
290
+ //# sourceMappingURL=visual-validation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"visual-validation.js","sourceRoot":"","sources":["../src/visual-validation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ export interface WebActionAuthorizationInput {
2
+ root: string;
3
+ taskId?: string;
4
+ actor: string;
5
+ action: string;
6
+ command?: string;
7
+ paths?: string[];
8
+ confirmed?: boolean;
9
+ }
10
+ export declare function authorizeWebAction({ root, taskId, actor, action, command, paths, confirmed, }: WebActionAuthorizationInput): Promise<void>;
11
+ export declare const WEB_ACTION_AUTHORIZED_EVENT = "WEB_ACTION_AUTHORIZED";
@@ -0,0 +1,45 @@
1
+ import { resolveWorkspaceLocalPath } from "./web-evidence.js";
2
+ import { appendEvent } from "./workspace.js";
3
+ import { evaluateActionPolicy } from "./policy.js";
4
+ import { removeUndefined } from "./command-utils.js";
5
+ export async function authorizeWebAction({ root, taskId, actor, action, command, paths = [], confirmed = false, }) {
6
+ validateWorkspaceRelativePaths(root, paths);
7
+ const evaluation = await evaluateActionPolicy(removeUndefined({
8
+ root,
9
+ taskId,
10
+ action,
11
+ command,
12
+ paths,
13
+ }));
14
+ if (!evaluation.allowed) {
15
+ throw new Error([
16
+ "web action blocked by policy",
17
+ evaluation.tier,
18
+ evaluation.approvalCommand ?? "approval required",
19
+ ].join(": "));
20
+ }
21
+ if (evaluation.tier !== "routine" && !confirmed) {
22
+ throw new Error(`web action requires explicit confirmation: ${action}`);
23
+ }
24
+ await appendEvent(root, removeUndefined({
25
+ type: WEB_ACTION_AUTHORIZED_EVENT,
26
+ taskId,
27
+ actor,
28
+ summary: `Web action authorized: ${action}`,
29
+ metadata: removeUndefined({
30
+ action,
31
+ command,
32
+ paths,
33
+ tier: evaluation.tier,
34
+ confirmed,
35
+ reasons: evaluation.reasons,
36
+ }),
37
+ }));
38
+ }
39
+ export const WEB_ACTION_AUTHORIZED_EVENT = "WEB_ACTION_AUTHORIZED";
40
+ function validateWorkspaceRelativePaths(root, paths) {
41
+ for (const item of paths) {
42
+ resolveWorkspaceLocalPath(root, item);
43
+ }
44
+ }
45
+ //# sourceMappingURL=web-action-security.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web-action-security.js","sourceRoot":"","sources":["../src/web-action-security.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAYrD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,IAAI,EACJ,MAAM,EACN,KAAK,EACL,MAAM,EACN,OAAO,EACP,KAAK,GAAG,EAAE,EACV,SAAS,GAAG,KAAK,GACW;IAC5B,8BAA8B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAC3C,eAAe,CAAC;QACd,IAAI;QACJ,MAAM;QACN,MAAM;QACN,OAAO;QACP,KAAK;KACN,CAAC,CACH,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb;YACE,8BAA8B;YAC9B,UAAU,CAAC,IAAI;YACf,UAAU,CAAC,eAAe,IAAI,mBAAmB;SAClD,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,8CAA8C,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,WAAW,CACf,IAAI,EACJ,eAAe,CAAC;QACd,IAAI,EAAE,2BAA2B;QACjC,MAAM;QACN,KAAK;QACL,OAAO,EAAE,0BAA0B,MAAM,EAAE;QAC3C,QAAQ,EAAE,eAAe,CAAC;YACxB,MAAM;YACN,OAAO;YACP,KAAK;YACL,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,SAAS;YACT,OAAO,EAAE,UAAU,CAAC,OAAO;SAC5B,CAAC;KACH,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAAC;AAEnE,SAAS,8BAA8B,CAAC,IAAY,EAAE,KAAe;IACnE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}