clinkx 0.2.2 → 0.3.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 (145) hide show
  1. package/README.md +40 -1
  2. package/clinkx-workflows/dist/clink-client.js +35 -10
  3. package/clinkx-workflows/dist/clink-client.js.map +1 -1
  4. package/clinkx-workflows/dist/config.d.ts +10 -0
  5. package/clinkx-workflows/dist/config.js +18 -0
  6. package/clinkx-workflows/dist/config.js.map +1 -1
  7. package/clinkx-workflows/dist/council-expander.d.ts +43 -0
  8. package/clinkx-workflows/dist/council-expander.js +330 -0
  9. package/clinkx-workflows/dist/council-expander.js.map +1 -0
  10. package/clinkx-workflows/dist/index.d.ts +14 -0
  11. package/clinkx-workflows/dist/index.js +264 -16
  12. package/clinkx-workflows/dist/index.js.map +1 -1
  13. package/clinkx-workflows/dist/server.d.ts +8 -1
  14. package/clinkx-workflows/dist/server.js +87 -1
  15. package/clinkx-workflows/dist/server.js.map +1 -1
  16. package/clinkx-workflows/dist/shutdown.d.ts +5 -9
  17. package/clinkx-workflows/dist/shutdown.js +6 -23
  18. package/clinkx-workflows/dist/shutdown.js.map +1 -1
  19. package/clinkx-workflows/dist/state.d.ts +13 -0
  20. package/clinkx-workflows/dist/state.js +198 -2
  21. package/clinkx-workflows/dist/state.js.map +1 -1
  22. package/clinkx-workflows/dist/transport.js +24 -8
  23. package/clinkx-workflows/dist/transport.js.map +1 -1
  24. package/clinkx-workflows/dist/workflow-tools.d.ts +14 -1
  25. package/clinkx-workflows/dist/workflow-tools.js +173 -12
  26. package/clinkx-workflows/dist/workflow-tools.js.map +1 -1
  27. package/clinkx-workflows/dist/workflows/index.d.ts +4 -3
  28. package/clinkx-workflows/dist/workflows/index.js +4 -3
  29. package/clinkx-workflows/dist/workflows/index.js.map +1 -1
  30. package/clinkx-workflows/templates/council/answer-chairman.txt +49 -0
  31. package/clinkx-workflows/templates/council/answer-cross-reviewer.txt +37 -0
  32. package/clinkx-workflows/templates/council/answer-specialist.txt +40 -0
  33. package/clinkx-workflows/templates/council/chairman.txt +59 -0
  34. package/clinkx-workflows/templates/council/code-review-chairman.txt +57 -0
  35. package/clinkx-workflows/templates/council/code-review-cross-reviewer.txt +43 -0
  36. package/clinkx-workflows/templates/council/code-review-reviewer.txt +39 -0
  37. package/clinkx-workflows/templates/council/debug-chairman.txt +57 -0
  38. package/clinkx-workflows/templates/council/debug-cross-reviewer.txt +41 -0
  39. package/clinkx-workflows/templates/council/debug-debugger.txt +46 -0
  40. package/clinkx-workflows/templates/council/discover-analyst.txt +38 -0
  41. package/clinkx-workflows/templates/council/discover-chairman.txt +51 -0
  42. package/clinkx-workflows/templates/council/discover-cross-reviewer.txt +40 -0
  43. package/clinkx-workflows/templates/council/member.txt +48 -0
  44. package/clinkx-workflows/templates/council/reviewer.txt +57 -0
  45. package/clinkx-workflows/workflows/council-answer.yaml +147 -0
  46. package/clinkx-workflows/workflows/council-code-review.yaml +152 -0
  47. package/clinkx-workflows/workflows/council-debug.yaml +152 -0
  48. package/clinkx-workflows/workflows/council-default.yaml +147 -0
  49. package/clinkx-workflows/workflows/council-discover.yaml +147 -0
  50. package/conf/prompts/json-codereviewer.txt +1 -0
  51. package/conf/prompts/json.txt +1 -0
  52. package/dist/allowed-roots.d.ts +12 -0
  53. package/dist/allowed-roots.js +94 -0
  54. package/dist/allowed-roots.js.map +1 -0
  55. package/dist/context-builder/anchors.d.ts +11 -0
  56. package/dist/context-builder/anchors.js +19 -0
  57. package/dist/context-builder/anchors.js.map +1 -0
  58. package/dist/context-builder/bundle.d.ts +76 -0
  59. package/dist/context-builder/bundle.js +3573 -0
  60. package/dist/context-builder/bundle.js.map +1 -0
  61. package/dist/context-builder/codemap.d.ts +17 -0
  62. package/dist/context-builder/codemap.js +301 -0
  63. package/dist/context-builder/codemap.js.map +1 -0
  64. package/dist/context-builder/config.d.ts +60 -0
  65. package/dist/context-builder/config.js +204 -0
  66. package/dist/context-builder/config.js.map +1 -0
  67. package/dist/context-builder/delegate-packet.d.ts +182 -0
  68. package/dist/context-builder/delegate-packet.js +898 -0
  69. package/dist/context-builder/delegate-packet.js.map +1 -0
  70. package/dist/context-builder/delegate-reconstruction.d.ts +13 -0
  71. package/dist/context-builder/delegate-reconstruction.js +220 -0
  72. package/dist/context-builder/delegate-reconstruction.js.map +1 -0
  73. package/dist/context-builder/delegate-validation.d.ts +18 -0
  74. package/dist/context-builder/delegate-validation.js +367 -0
  75. package/dist/context-builder/delegate-validation.js.map +1 -0
  76. package/dist/context-builder/delegate.d.ts +24 -0
  77. package/dist/context-builder/delegate.js +133 -0
  78. package/dist/context-builder/delegate.js.map +1 -0
  79. package/dist/context-builder/diagnostics.d.ts +27 -0
  80. package/dist/context-builder/diagnostics.js +74 -0
  81. package/dist/context-builder/diagnostics.js.map +1 -0
  82. package/dist/context-builder/discovery.d.ts +118 -0
  83. package/dist/context-builder/discovery.js +1829 -0
  84. package/dist/context-builder/discovery.js.map +1 -0
  85. package/dist/context-builder/globs.d.ts +14 -0
  86. package/dist/context-builder/globs.js +175 -0
  87. package/dist/context-builder/globs.js.map +1 -0
  88. package/dist/context-builder/handler.d.ts +17 -0
  89. package/dist/context-builder/handler.js +3848 -0
  90. package/dist/context-builder/handler.js.map +1 -0
  91. package/dist/context-builder/path-signals.d.ts +7 -0
  92. package/dist/context-builder/path-signals.js +66 -0
  93. package/dist/context-builder/path-signals.js.map +1 -0
  94. package/dist/context-builder/paths.d.ts +30 -0
  95. package/dist/context-builder/paths.js +153 -0
  96. package/dist/context-builder/paths.js.map +1 -0
  97. package/dist/context-builder/progress.d.ts +15 -0
  98. package/dist/context-builder/progress.js +70 -0
  99. package/dist/context-builder/progress.js.map +1 -0
  100. package/dist/context-builder/receipt.d.ts +89 -0
  101. package/dist/context-builder/receipt.js +169 -0
  102. package/dist/context-builder/receipt.js.map +1 -0
  103. package/dist/context-builder/run-id.d.ts +7 -0
  104. package/dist/context-builder/run-id.js +31 -0
  105. package/dist/context-builder/run-id.js.map +1 -0
  106. package/dist/context-builder/schema.d.ts +431 -0
  107. package/dist/context-builder/schema.js +293 -0
  108. package/dist/context-builder/schema.js.map +1 -0
  109. package/dist/context-builder/secrets.d.ts +13 -0
  110. package/dist/context-builder/secrets.js +222 -0
  111. package/dist/context-builder/secrets.js.map +1 -0
  112. package/dist/context-builder/selection.d.ts +52 -0
  113. package/dist/context-builder/selection.js +1649 -0
  114. package/dist/context-builder/selection.js.map +1 -0
  115. package/dist/context-builder/status.d.ts +45 -0
  116. package/dist/context-builder/status.js +105 -0
  117. package/dist/context-builder/status.js.map +1 -0
  118. package/dist/context-builder/storage.d.ts +85 -0
  119. package/dist/context-builder/storage.js +746 -0
  120. package/dist/context-builder/storage.js.map +1 -0
  121. package/dist/context-builder/token-estimate.d.ts +8 -0
  122. package/dist/context-builder/token-estimate.js +17 -0
  123. package/dist/context-builder/token-estimate.js.map +1 -0
  124. package/dist/index.d.ts +11 -0
  125. package/dist/index.js +246 -14
  126. package/dist/index.js.map +1 -1
  127. package/dist/paths.d.ts +8 -0
  128. package/dist/paths.js +31 -43
  129. package/dist/paths.js.map +1 -1
  130. package/dist/pipeline.d.ts +48 -4
  131. package/dist/pipeline.js +164 -44
  132. package/dist/pipeline.js.map +1 -1
  133. package/dist/runner.d.ts +2 -2
  134. package/dist/runner.js +24 -3
  135. package/dist/runner.js.map +1 -1
  136. package/dist/server.d.ts +1 -0
  137. package/dist/server.js +42 -11
  138. package/dist/server.js.map +1 -1
  139. package/package.json +6 -2
  140. package/clinkx-workflows/dist/workflows/council-default.d.ts +0 -123
  141. package/clinkx-workflows/dist/workflows/council-default.js +0 -141
  142. package/clinkx-workflows/dist/workflows/council-default.js.map +0 -1
  143. package/dist/artifacts.d.ts +0 -9
  144. package/dist/artifacts.js +0 -24
  145. package/dist/artifacts.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/context-builder/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,GAEtC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAevE,MAAM,CAAC,MAAM,kDAAkD,GAC7D,6BAA6B,CAAC;AAUhC,MAAM,UAAU,yBAAyB,CAAC,KAKzC;IACC,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QACrE,MAAM,EAAE,kDAAkD;QAC1D,OAAO,EAAE,qCAAqC,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE;QAC7E,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,QAAgD;IAEhD,OAAO,QAAQ,CAAC,MAAM,KAAK,kDAAkD,CAAC;AAChF,CAAC;AAED,MAAM,0BAA0B,GAAG,GAAG,CAAC;AACvC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACjC,MAAM,8BAA8B,GAClC,wEAAwE,CAAC;AAE3E,MAAM,UAAU,2BAA2B,CACzC,QAAiC,EACjC,OACE,qCAAqC;IAEvC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5D,IAAI,EAAE,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC;QAC1C,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC;KACjD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,SAAmC,EACnC,OAGI,qCAAqC;IAEzC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC/D,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC3E,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC/C,OAAO,EAAE,sBAAsB,CAAC,QAAQ,CAAC,OAAO,CAAC;QACjD,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI;YACxB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,KAAK,EAAE,2BAA2B,CAChC,QAAQ,CAAC,KAAK,EACd,IAAI,CAAC,sBAAsB,CAC5B;gBACD,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAC1B,CAAC,EACD,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,sBAAsB,CACpD;aACF,CAAC;KACP,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAe,EACf,QAAQ,GAAG,qCAAqC,CAAC,sBAAsB;IAEvE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,SAAS,GAAG,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,IAAI,uBAAuB,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,MAAM,OAAO,GACX,SAAS,CAAC,MAAM,GAAG,0BAA0B;QAC3C,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,0BAA0B,GAAG,CAAC,CAAC,KAAK;QAC5D,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,8BAA8B,CAAC,SAAS,GAAG,CAAC,CAAC;IAC7C,OAAO,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,2BAA2B,CAAC,IAAY;IAC/C,8BAA8B,CAAC,SAAS,GAAG,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,OAAO,CACjB,8BAA8B,EAC9B,4BAA4B,CAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAClD,OAAO,SAAS,CAAC,MAAM,GAAG,wBAAwB;QAChD,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,GAAG,CAAC,CAAC,KAAK;QAC1D,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACtD,IACE,cAAc,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC;QACrC,uBAAuB,CAAC,UAAU,CAAC,EACnC,CAAC;QACD,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAE1D,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,118 @@
1
+ import { lstat as fsLstat, open as fsOpen, readdir as fsReaddir, realpath as fsRealpath, stat as fsStat } from "node:fs/promises";
2
+ import { type ContextBuilderInternalCaps } from "./config.js";
3
+ import { type ContextBuilderOmission } from "./diagnostics.js";
4
+ import { type ContextBuilderResolvedFocusPath, type ContextBuilderResolvedRoot } from "./paths.js";
5
+ import { type ContextBuilderPublicBudget } from "./schema.js";
6
+ export type ContextBuilderTreeFile = {
7
+ root_index: number;
8
+ path: string;
9
+ size_bytes: number;
10
+ eligible: boolean;
11
+ content_eligible: boolean;
12
+ omission_reason?: string;
13
+ };
14
+ export type ContextBuilderContentCandidate = {
15
+ root_index: number;
16
+ path: string;
17
+ absolute_path: string;
18
+ content: string;
19
+ byte_length: number;
20
+ line_count: number;
21
+ has_final_newline: boolean;
22
+ selection_hint?: "local_dependency" | "project_support";
23
+ };
24
+ export type ContextBuilderSearchRecord = {
25
+ root_index: number;
26
+ path: string;
27
+ line: number;
28
+ column: number;
29
+ search_term: string;
30
+ search_term_index: number;
31
+ preview: string;
32
+ };
33
+ export type ContextBuilderSliceRecord = {
34
+ root_index: number;
35
+ path: string;
36
+ start_line: number;
37
+ end_line: number;
38
+ source: "focus" | "search";
39
+ content: string;
40
+ search_term_index?: number;
41
+ };
42
+ export type ContextBuilderDiscoveryMetrics = {
43
+ files_seen: number;
44
+ files_considered: number;
45
+ scan_cap_hit: boolean;
46
+ search_cap_hit: boolean;
47
+ discovery_byte_cap_hit: boolean;
48
+ discovery_candidate_cap_hit: boolean;
49
+ candidate_cap_hit: boolean;
50
+ bytes_read: number;
51
+ };
52
+ export type ContextBuilderDiscoveryResult = {
53
+ tree: ContextBuilderTreeFile[];
54
+ content_candidates: ContextBuilderContentCandidate[];
55
+ search: ContextBuilderSearchRecord[];
56
+ slices: ContextBuilderSliceRecord[];
57
+ omissions: ContextBuilderOmission[];
58
+ metrics: ContextBuilderDiscoveryMetrics;
59
+ };
60
+ export type ContextBuilderDiscoveryOptions = {
61
+ roots: readonly ContextBuilderResolvedRoot[];
62
+ task?: string;
63
+ focus_paths?: readonly ContextBuilderResolvedFocusPath[];
64
+ include_globs?: readonly string[];
65
+ exclude_globs?: readonly string[];
66
+ excluded_real_roots?: readonly string[];
67
+ search_terms?: readonly string[];
68
+ budget: ContextBuilderPublicBudget;
69
+ internal_caps?: ContextBuilderInternalCaps;
70
+ signal?: AbortSignal;
71
+ fs?: {
72
+ readdir?: typeof fsReaddir;
73
+ lstat?: typeof fsLstat;
74
+ open?: typeof fsOpen;
75
+ realpath?: typeof fsRealpath;
76
+ stat?: typeof fsStat;
77
+ };
78
+ };
79
+ type LineRange = {
80
+ start_line: number;
81
+ end_line: number;
82
+ search_term_index?: number;
83
+ };
84
+ export declare function discoverContextBuilderCandidates(options: ContextBuilderDiscoveryOptions): Promise<ContextBuilderDiscoveryResult>;
85
+ export declare function buildCandidateSearchRecords(input: {
86
+ candidates: readonly ContextBuilderContentCandidate[];
87
+ task?: string;
88
+ focusPaths?: readonly ContextBuilderResolvedFocusPath[];
89
+ searchTerms: readonly string[];
90
+ maxSearchResults: number;
91
+ maxPreviewBytes?: number;
92
+ maxCandidateBytes?: number;
93
+ signal?: AbortSignal;
94
+ }): {
95
+ records: ContextBuilderSearchRecord[];
96
+ capHit: boolean;
97
+ candidateBytes: number;
98
+ };
99
+ export declare function buildCandidateSliceRecords(input: {
100
+ candidates: readonly ContextBuilderContentCandidate[];
101
+ focusPaths: readonly ContextBuilderResolvedFocusPath[];
102
+ searchRecords: readonly ContextBuilderSearchRecord[];
103
+ maxCandidateSlices?: number;
104
+ maxCandidateBytes?: number;
105
+ maxSearchSliceBytesPerCandidate?: number;
106
+ maxFullFocusSliceBytes?: number;
107
+ signal?: AbortSignal;
108
+ }): {
109
+ records: ContextBuilderSliceRecord[];
110
+ capHit: boolean;
111
+ omissions: ContextBuilderOmission[];
112
+ };
113
+ export declare function splitTextLines(text: string): string[];
114
+ export declare function mergeLineRanges(ranges: readonly LineRange[], options?: {
115
+ bridgeGapLines?: number;
116
+ maxMergedSpanLines?: number;
117
+ }): LineRange[];
118
+ export {};