@nebulacomponents/citable 1.16.0 → 1.18.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 (142) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.md +16 -3
  3. package/dist/universal/.agents/skills/citable/SKILL.md +66 -1
  4. package/dist/universal/.agents/skills/citable/VERSION +1 -1
  5. package/dist/universal/.agents/skills/citable/manifest.json +9 -6
  6. package/dist/universal/.agents/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  7. package/dist/universal/.agents/skills/citable/schemas/finding.schema.json +69 -0
  8. package/dist/universal/.agents/skills/citable/schemas/remediation-verification.schema.json +98 -0
  9. package/dist/universal/.agents/skills/citable/schemas/sow.schema.json +92 -0
  10. package/dist/universal/.claude/agents/citable/manifest.json +2 -2
  11. package/dist/universal/.claude/skills/citable/SKILL.md +66 -1
  12. package/dist/universal/.claude/skills/citable/VERSION +1 -1
  13. package/dist/universal/.claude/skills/citable/manifest.json +9 -6
  14. package/dist/universal/.claude/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  15. package/dist/universal/.claude/skills/citable/schemas/finding.schema.json +69 -0
  16. package/dist/universal/.claude/skills/citable/schemas/remediation-verification.schema.json +98 -0
  17. package/dist/universal/.claude/skills/citable/schemas/sow.schema.json +92 -0
  18. package/dist/universal/.cursor/skills/citable/SKILL.md +66 -1
  19. package/dist/universal/.cursor/skills/citable/VERSION +1 -1
  20. package/dist/universal/.cursor/skills/citable/manifest.json +9 -6
  21. package/dist/universal/.cursor/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  22. package/dist/universal/.cursor/skills/citable/schemas/finding.schema.json +69 -0
  23. package/dist/universal/.cursor/skills/citable/schemas/remediation-verification.schema.json +98 -0
  24. package/dist/universal/.cursor/skills/citable/schemas/sow.schema.json +92 -0
  25. package/dist/universal/.gemini/skills/citable/SKILL.md +66 -1
  26. package/dist/universal/.gemini/skills/citable/VERSION +1 -1
  27. package/dist/universal/.gemini/skills/citable/manifest.json +9 -6
  28. package/dist/universal/.gemini/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  29. package/dist/universal/.gemini/skills/citable/schemas/finding.schema.json +69 -0
  30. package/dist/universal/.gemini/skills/citable/schemas/remediation-verification.schema.json +98 -0
  31. package/dist/universal/.gemini/skills/citable/schemas/sow.schema.json +92 -0
  32. package/dist/universal/.github/skills/citable/SKILL.md +66 -1
  33. package/dist/universal/.github/skills/citable/VERSION +1 -1
  34. package/dist/universal/.github/skills/citable/manifest.json +9 -6
  35. package/dist/universal/.github/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  36. package/dist/universal/.github/skills/citable/schemas/finding.schema.json +69 -0
  37. package/dist/universal/.github/skills/citable/schemas/remediation-verification.schema.json +98 -0
  38. package/dist/universal/.github/skills/citable/schemas/sow.schema.json +92 -0
  39. package/dist/universal/.kiro/skills/citable/SKILL.md +66 -1
  40. package/dist/universal/.kiro/skills/citable/VERSION +1 -1
  41. package/dist/universal/.kiro/skills/citable/manifest.json +9 -6
  42. package/dist/universal/.kiro/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  43. package/dist/universal/.kiro/skills/citable/schemas/finding.schema.json +69 -0
  44. package/dist/universal/.kiro/skills/citable/schemas/remediation-verification.schema.json +98 -0
  45. package/dist/universal/.kiro/skills/citable/schemas/sow.schema.json +92 -0
  46. package/dist/universal/.opencode/skills/citable/SKILL.md +66 -1
  47. package/dist/universal/.opencode/skills/citable/VERSION +1 -1
  48. package/dist/universal/.opencode/skills/citable/manifest.json +9 -6
  49. package/dist/universal/.opencode/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  50. package/dist/universal/.opencode/skills/citable/schemas/finding.schema.json +69 -0
  51. package/dist/universal/.opencode/skills/citable/schemas/remediation-verification.schema.json +98 -0
  52. package/dist/universal/.opencode/skills/citable/schemas/sow.schema.json +92 -0
  53. package/dist/universal/.pi/agent/skills/citable/SKILL.md +66 -1
  54. package/dist/universal/.pi/agent/skills/citable/VERSION +1 -1
  55. package/dist/universal/.pi/agent/skills/citable/manifest.json +9 -6
  56. package/dist/universal/.pi/agent/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  57. package/dist/universal/.pi/agent/skills/citable/schemas/finding.schema.json +69 -0
  58. package/dist/universal/.pi/agent/skills/citable/schemas/remediation-verification.schema.json +98 -0
  59. package/dist/universal/.pi/agent/skills/citable/schemas/sow.schema.json +92 -0
  60. package/dist/universal/.qoder/skills/citable/SKILL.md +66 -1
  61. package/dist/universal/.qoder/skills/citable/VERSION +1 -1
  62. package/dist/universal/.qoder/skills/citable/manifest.json +9 -6
  63. package/dist/universal/.qoder/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  64. package/dist/universal/.qoder/skills/citable/schemas/finding.schema.json +69 -0
  65. package/dist/universal/.qoder/skills/citable/schemas/remediation-verification.schema.json +98 -0
  66. package/dist/universal/.qoder/skills/citable/schemas/sow.schema.json +92 -0
  67. package/dist/universal/.rovodev/skills/citable/SKILL.md +66 -1
  68. package/dist/universal/.rovodev/skills/citable/VERSION +1 -1
  69. package/dist/universal/.rovodev/skills/citable/manifest.json +9 -6
  70. package/dist/universal/.rovodev/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  71. package/dist/universal/.rovodev/skills/citable/schemas/finding.schema.json +69 -0
  72. package/dist/universal/.rovodev/skills/citable/schemas/remediation-verification.schema.json +98 -0
  73. package/dist/universal/.rovodev/skills/citable/schemas/sow.schema.json +92 -0
  74. package/dist/universal/.trae/skills/citable/SKILL.md +66 -1
  75. package/dist/universal/.trae/skills/citable/VERSION +1 -1
  76. package/dist/universal/.trae/skills/citable/manifest.json +9 -6
  77. package/dist/universal/.trae/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  78. package/dist/universal/.trae/skills/citable/schemas/finding.schema.json +69 -0
  79. package/dist/universal/.trae/skills/citable/schemas/remediation-verification.schema.json +98 -0
  80. package/dist/universal/.trae/skills/citable/schemas/sow.schema.json +92 -0
  81. package/dist/universal/.trae-cn/skills/citable/SKILL.md +66 -1
  82. package/dist/universal/.trae-cn/skills/citable/VERSION +1 -1
  83. package/dist/universal/.trae-cn/skills/citable/manifest.json +9 -6
  84. package/dist/universal/.trae-cn/skills/citable/schemas/cli-output-envelope.schema.json +30 -0
  85. package/dist/universal/.trae-cn/skills/citable/schemas/finding.schema.json +69 -0
  86. package/dist/universal/.trae-cn/skills/citable/schemas/remediation-verification.schema.json +98 -0
  87. package/dist/universal/.trae-cn/skills/citable/schemas/sow.schema.json +92 -0
  88. package/dist/universal/manifest.json +112 -76
  89. package/package.json +1 -1
  90. package/schemas/cli-output-envelope.schema.json +30 -0
  91. package/schemas/finding.schema.json +69 -0
  92. package/schemas/remediation-verification.schema.json +98 -0
  93. package/schemas/sow.schema.json +92 -0
  94. package/skill/SKILL.md +66 -1
  95. package/src/analysis/behavioral.js +126 -0
  96. package/src/analysis/croAudit.js +302 -0
  97. package/src/analysis/croRoadmap.js +121 -0
  98. package/src/analysis/eeat.js +300 -0
  99. package/src/analysis/funnelAnalysis.js +171 -0
  100. package/src/analysis/iceMatrix.js +205 -0
  101. package/src/analysis/offpage.js +228 -0
  102. package/src/analysis/readiness.js +253 -0
  103. package/src/analysis/saliency.js +119 -0
  104. package/src/analysis/schemaRecommendations.js +173 -0
  105. package/src/analysis/strategicRoadmap.js +148 -0
  106. package/src/cli/index.js +418 -9
  107. package/src/commands/answerEngineReadiness.js +48 -0
  108. package/src/commands/audit.js +2 -2
  109. package/src/commands/auditBacklinks.js +79 -0
  110. package/src/commands/ciWorkflow.js +63 -0
  111. package/src/commands/compatibility.js +205 -0
  112. package/src/commands/context.js +2 -1
  113. package/src/commands/croBacklog.js +182 -0
  114. package/src/commands/croSuite.js +156 -0
  115. package/src/commands/edgeRules.js +80 -4
  116. package/src/commands/edgeSecurity.js +192 -0
  117. package/src/commands/executive.js +6 -0
  118. package/src/commands/executiveCro.js +30 -0
  119. package/src/commands/executiveSearch.js +28 -0
  120. package/src/commands/experimentGuardrails.js +213 -0
  121. package/src/commands/goldenCorpus.js +155 -0
  122. package/src/commands/implementationKit.js +202 -0
  123. package/src/commands/inspectCro.js +67 -0
  124. package/src/commands/inspectEeat.js +53 -0
  125. package/src/commands/planExperiment.js +52 -0
  126. package/src/commands/previewCro.js +241 -0
  127. package/src/commands/prioritize.js +42 -6
  128. package/src/commands/remediate.js +461 -0
  129. package/src/commands/roadmapCmd.js +69 -0
  130. package/src/commands/schemaCmd.js +10 -2
  131. package/src/commands/sowCmd.js +67 -0
  132. package/src/commands/sweep.js +357 -0
  133. package/src/commands/verifyRemediation.js +204 -0
  134. package/src/commands/visualRegression.js +165 -0
  135. package/src/components/index.js +556 -0
  136. package/src/detectors/cro.js +48 -0
  137. package/src/detectors/framework.js +31 -1
  138. package/src/reporting/executiveCroReport.js +731 -0
  139. package/src/reporting/executiveExport.js +175 -1
  140. package/src/reporting/executiveSearchReport.js +704 -0
  141. package/src/sow/admissibilityGate.js +194 -0
  142. package/src/sow/generateSow.js +762 -0
@@ -0,0 +1,98 @@
1
+ {
2
+ "$id": "citable://schemas/remediation-verification.schema.json",
3
+ "$schema": "http://json-schema.org/draft-07/schema#",
4
+ "title": "Remediation verification record",
5
+ "description": "Closed-loop evidence that a detector finding was addressed: before-run finding, applied patch, re-run detector result, and verdict. Proves only that the detector no longer reports the same subject; it never proves a conversion or outcome guarantee.",
6
+ "type": "object",
7
+ "required": [
8
+ "verification_id", "timestamp", "status", "tool_version",
9
+ "source_run_id", "detector_id", "subject", "verdict",
10
+ "provenance", "limitations"
11
+ ],
12
+ "properties": {
13
+ "verification_id": { "type": "string", "pattern": "^VR-[0-9]{14,20}-[a-z0-9]{2,8}$" },
14
+ "timestamp": { "type": "string" },
15
+ "status": { "type": "string", "enum": ["verified", "not_resolved", "blocked", "patch_refused"] },
16
+ "tool_version": { "type": "string" },
17
+ "repository_commit": { "type": ["string", "null"] },
18
+ "source_run_id": { "type": ["string", "null"], "minLength": 1 },
19
+ "recheck_run_id": { "type": ["string", "null"] },
20
+ "detector_id": { "type": ["string", "null"] },
21
+ "subject": {
22
+ "type": ["object", "null"],
23
+ "properties": {
24
+ "type": { "type": "string" },
25
+ "identifier": { "type": ["string", "null"] }
26
+ }
27
+ },
28
+ "verdict": {
29
+ "type": "object",
30
+ "required": ["resolved"],
31
+ "properties": {
32
+ "resolved": { "type": "boolean" },
33
+ "before_finding_ids": { "type": "array", "items": { "type": "string" } },
34
+ "after_finding_ids": { "type": "array", "items": { "type": "string" } },
35
+ "new_regressions": {
36
+ "type": "array",
37
+ "items": {
38
+ "type": "object",
39
+ "required": ["finding_id", "detector_id", "severity", "summary"],
40
+ "properties": {
41
+ "finding_id": { "type": "string" },
42
+ "detector_id": { "type": "string" },
43
+ "severity": { "type": "string" },
44
+ "summary": { "type": "string" }
45
+ }
46
+ }
47
+ },
48
+ "resolution_definition": {
49
+ "type": "string",
50
+ "description": "States the exact resolution criterion used; detector absence is not an outcome guarantee."
51
+ }
52
+ }
53
+ },
54
+ "patch": {
55
+ "type": ["object", "null"],
56
+ "properties": {
57
+ "target_file": { "type": "string" },
58
+ "framework": { "type": ["string", "null"] },
59
+ "patcher_class": { "type": ["string", "null"] },
60
+ "confidence": { "type": ["number", "null"] },
61
+ "validation_passed": { "type": "boolean" },
62
+ "applied": { "type": "boolean" },
63
+ "refusal_reason": { "type": ["string", "null"] },
64
+ "rollback_snapshot": { "type": ["string", "null"] },
65
+ "before_sha256": { "type": ["string", "null"] },
66
+ "after_sha256": { "type": ["string", "null"] }
67
+ }
68
+ },
69
+ "provenance": {
70
+ "type": "object",
71
+ "required": ["command", "recheck_target", "detectors_run"],
72
+ "properties": {
73
+ "command": { "type": "string" },
74
+ "recheck_target": { "type": ["string", "null"] },
75
+ "detectors_run": { "type": "array", "items": { "type": "string" } },
76
+ "detectors_skipped": {
77
+ "type": "array",
78
+ "items": {
79
+ "type": "object",
80
+ "properties": {
81
+ "detector_id": { "type": "string" },
82
+ "reason": { "type": "string" }
83
+ }
84
+ }
85
+ },
86
+ "recheck_errors": { "type": "array", "items": { "type": "string" } },
87
+ "recheck_warnings": { "type": "array", "items": { "type": "string" } }
88
+ }
89
+ },
90
+ "limitations": {
91
+ "type": "array",
92
+ "items": { "type": "string" },
93
+ "minItems": 1
94
+ },
95
+ "bundle_dir": { "type": ["string", "null"] },
96
+ "bundle_checksums": { "type": "object" }
97
+ }
98
+ }
@@ -0,0 +1,92 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "citable://schemas/sow.schema.json",
4
+ "title": "Enterprise Statement of Work (SOW)",
5
+ "type": "object",
6
+ "required": [
7
+ "sow_id",
8
+ "version",
9
+ "title",
10
+ "client",
11
+ "supplier",
12
+ "effective_date",
13
+ "executive_scope",
14
+ "admissibility_gate",
15
+ "work_packages",
16
+ "deliverables",
17
+ "acceptance_criteria",
18
+ "traceability_matrix"
19
+ ],
20
+ "properties": {
21
+ "sow_id": { "type": "string" },
22
+ "version": { "type": "string" },
23
+ "title": { "type": "string" },
24
+ "client": {
25
+ "type": "object",
26
+ "required": ["name", "contact"],
27
+ "properties": {
28
+ "name": { "type": "string" },
29
+ "contact": { "type": "string" }
30
+ }
31
+ },
32
+ "supplier": {
33
+ "type": "object",
34
+ "required": ["name", "contact"],
35
+ "properties": {
36
+ "name": { "type": "string" },
37
+ "contact": { "type": "string" }
38
+ }
39
+ },
40
+ "effective_date": { "type": "string" },
41
+ "term_days": { "type": "integer" },
42
+ "executive_scope": {
43
+ "type": "object",
44
+ "required": ["business_objective", "in_scope_properties", "in_scope_systems"],
45
+ "properties": {
46
+ "business_objective": { "type": "string" },
47
+ "in_scope_properties": { "type": "array", "items": { "type": "string" } },
48
+ "in_scope_systems": { "type": "array", "items": { "type": "string" } },
49
+ "channels": { "type": "array", "items": { "type": "string" } },
50
+ "geographies": { "type": "array", "items": { "type": "string" } }
51
+ }
52
+ },
53
+ "admissibility_gate": {
54
+ "type": "object",
55
+ "required": ["total_findings_evaluated", "admitted_count", "refused_count"],
56
+ "properties": {
57
+ "total_findings_evaluated": { "type": "integer" },
58
+ "admitted_count": { "type": "integer" },
59
+ "refused_count": { "type": "integer" },
60
+ "refusal_log": { "type": "array" }
61
+ }
62
+ },
63
+ "work_packages": { "type": "array" },
64
+ "deliverables": { "type": "array" },
65
+ "acceptance_criteria": { "type": "array" },
66
+ "traceability_matrix": {
67
+ "type": "array",
68
+ "items": {
69
+ "type": "object",
70
+ "required": [
71
+ "finding_id",
72
+ "recommendation",
73
+ "sow_requirement_id",
74
+ "deliverable_id",
75
+ "acceptance_test_id",
76
+ "owner",
77
+ "evidence_id"
78
+ ],
79
+ "properties": {
80
+ "finding_id": { "type": "string" },
81
+ "recommendation": { "type": "string" },
82
+ "sow_requirement_id": { "type": "string" },
83
+ "work_package_id": { "type": "string" },
84
+ "deliverable_id": { "type": "string" },
85
+ "acceptance_test_id": { "type": "string" },
86
+ "owner": { "type": "string" },
87
+ "evidence_id": { "type": "string" }
88
+ }
89
+ }
90
+ }
91
+ }
92
+ }