@haystackeditor/cli 0.25.0 → 0.26.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 (113) hide show
  1. package/README.md +39 -455
  2. package/dist/capture/adapters/django.js +7 -0
  3. package/dist/capture/adapters/index.js +10 -0
  4. package/dist/capture/adapters/next-build.js +113 -0
  5. package/dist/capture/adapters/next.js +272 -105
  6. package/dist/capture/adapters/nuxt.js +7 -0
  7. package/dist/capture/adapters/rails.js +7 -0
  8. package/dist/capture/adapters/react-router.js +7 -0
  9. package/dist/capture/adapters/sveltekit.js +7 -0
  10. package/dist/capture/adapters/vite.js +14 -0
  11. package/dist/capture/app-config.js +27 -2
  12. package/dist/capture/csp.js +7 -6
  13. package/dist/capture/url-rewrites.js +232 -0
  14. package/dist/capture-step.js +3 -0
  15. package/dist/commands/capture-brief.js +41 -32
  16. package/dist/commands/capture-manifest.js +25 -17
  17. package/dist/commands/feedback.js +66 -0
  18. package/dist/commands/init-capture.js +44 -27
  19. package/dist/commands/init-telemetry.js +77 -14
  20. package/dist/commands/init.js +19 -4
  21. package/dist/commands/lockfile-pin.js +307 -0
  22. package/dist/commands/verify-onboarding.js +16 -0
  23. package/dist/commands/verify.js +70 -15
  24. package/dist/index.js +29 -923
  25. package/dist/schema.js +4 -10
  26. package/dist/utils/haystack-api.js +0 -36
  27. package/package.json +1 -5
  28. package/schemas/feedback.v1.json +13 -0
  29. package/schemas/init.v1.json +1 -1
  30. package/schemas/pre-verify.v2.json +240 -0
  31. package/schemas/verify-raw.v1.json +1132 -0
  32. package/schemas/verify.v2.json +655 -0
  33. package/dist/assets/hooks/agent-context/detect.ts +0 -316
  34. package/dist/assets/hooks/agent-context/format.ts +0 -100
  35. package/dist/assets/hooks/agent-context/index.ts +0 -41
  36. package/dist/assets/hooks/agent-context/parsers/claude.ts +0 -262
  37. package/dist/assets/hooks/agent-context/parsers/codex.ts +0 -416
  38. package/dist/assets/hooks/agent-context/parsers/gemini.ts +0 -155
  39. package/dist/assets/hooks/agent-context/parsers/opencode.ts +0 -174
  40. package/dist/assets/hooks/agent-context/tsconfig.json +0 -14
  41. package/dist/assets/hooks/agent-context/types.ts +0 -58
  42. package/dist/assets/hooks/llm-rules-template.md +0 -59
  43. package/dist/assets/hooks/package-lock.json +0 -598
  44. package/dist/assets/hooks/package.json +0 -12
  45. package/dist/assets/hooks/scripts/commit-msg.sh +0 -5
  46. package/dist/assets/hooks/scripts/post-commit.sh +0 -5
  47. package/dist/assets/hooks/scripts/pre-commit.sh +0 -175
  48. package/dist/assets/hooks/scripts/pre-push.sh +0 -25
  49. package/dist/assets/hooks/scripts/prepare-commit-msg.sh +0 -5
  50. package/dist/assets/hooks/truncation-checker/ast-analyzer.ts +0 -528
  51. package/dist/assets/hooks/truncation-checker/index.ts +0 -595
  52. package/dist/assets/hooks/truncation-checker/tsconfig.json +0 -13
  53. package/dist/assets/skills/map-cloud-verifier-universe/SKILL.md +0 -2051
  54. package/dist/assets/skills/map-cloud-verifier-universe/agents/openai.yaml +0 -4
  55. package/dist/assets/skills/map-cloud-verifier-universe/references/output-contract.md +0 -3411
  56. package/dist/assets/skills/map-your-system.md +0 -143
  57. package/dist/assets/skills/submit.md +0 -200
  58. package/dist/commands/ask.js +0 -20
  59. package/dist/commands/cloud-verifier-behaviors.js +0 -218
  60. package/dist/commands/cloud-verifier-data-store-census.js +0 -539
  61. package/dist/commands/cloud-verifier-data-store-drift.js +0 -158
  62. package/dist/commands/cloud-verifier-identity-census.js +0 -4060
  63. package/dist/commands/cloud-verifier-materialization.js +0 -704
  64. package/dist/commands/cloud-verifier-pascal-selector-census.js +0 -1382
  65. package/dist/commands/cloud-verifier-python-manifest-selector-census.js +0 -2015
  66. package/dist/commands/cloud-verifier-specialized-operational-census.js +0 -11432
  67. package/dist/commands/cloud-verifier-universe.js +0 -10178
  68. package/dist/commands/config.js +0 -549
  69. package/dist/commands/design-verify.js +0 -311
  70. package/dist/commands/dismiss.js +0 -159
  71. package/dist/commands/hooks.js +0 -226
  72. package/dist/commands/inbox.js +0 -137
  73. package/dist/commands/mcp.js +0 -201
  74. package/dist/commands/policy.js +0 -371
  75. package/dist/commands/pr-status.js +0 -207
  76. package/dist/commands/pr.js +0 -105
  77. package/dist/commands/prepare-universe-review.js +0 -1092
  78. package/dist/commands/production-source-deny-policy.js +0 -100
  79. package/dist/commands/request-review.js +0 -74
  80. package/dist/commands/review.js +0 -191
  81. package/dist/commands/rules.js +0 -98
  82. package/dist/commands/scaffold-provisional-universe.js +0 -806
  83. package/dist/commands/setup.js +0 -1170
  84. package/dist/commands/skills.js +0 -447
  85. package/dist/commands/submit.js +0 -745
  86. package/dist/commands/system-map.js +0 -228
  87. package/dist/commands/triage.js +0 -598
  88. package/dist/commands/webhooks.js +0 -241
  89. package/dist/states.js +0 -46
  90. package/dist/tools/detect.js +0 -832
  91. package/dist/triage/astra.js +0 -202
  92. package/dist/triage/prompts.js +0 -188
  93. package/dist/triage/runner.js +0 -200
  94. package/dist/triage/types.js +0 -7
  95. package/dist/utils/action-output.js +0 -26
  96. package/dist/utils/analysis-api.js +0 -416
  97. package/dist/utils/design-verifier-api.js +0 -294
  98. package/dist/utils/design-verifier-history.js +0 -79
  99. package/dist/utils/design-verifier-result.js +0 -424
  100. package/dist/utils/github-api.js +0 -324
  101. package/dist/utils/pending-state.js +0 -86
  102. package/dist/utils/pr-ref.js +0 -56
  103. package/dist/utils/prompter.js +0 -328
  104. package/schemas/action.v1.json +0 -22
  105. package/schemas/ask.v1.json +0 -40
  106. package/schemas/inbox.v1.json +0 -27
  107. package/schemas/pr-status.v1.json +0 -61
  108. package/schemas/pr.v1.json +0 -97
  109. package/schemas/pr.v3.json +0 -45
  110. package/schemas/setup.v1.json +0 -75
  111. package/schemas/submit.v1.json +0 -90
  112. package/schemas/triage.v1.json +0 -103
  113. package/schemas/triage.v2.json +0 -64
@@ -1,174 +0,0 @@
1
- import * as fs from 'fs';
2
- import type {
3
- AgentContext,
4
- AgentParser,
5
- DetectionResult,
6
- InteractionTurn,
7
- ModifiedFile,
8
- TokenUsage,
9
- ToolUseInfo,
10
- } from '../types.js';
11
- import { detectAgent } from '../detect.js';
12
-
13
- const FILE_MOD_TOOLS = new Set(['edit', 'write', 'patch']);
14
-
15
- interface OpenCodeTokens {
16
- input?: number;
17
- output?: number;
18
- cache?: {
19
- read?: number;
20
- write?: number;
21
- };
22
- }
23
-
24
- interface OpenCodePart {
25
- type: 'text' | 'tool';
26
- text?: string;
27
- tool?: string;
28
- state?: {
29
- input?: Record<string, unknown>;
30
- };
31
- }
32
-
33
- interface OpenCodeMessage {
34
- info: {
35
- id?: string;
36
- role: 'user' | 'assistant';
37
- createdAt?: string;
38
- tokens?: OpenCodeTokens;
39
- };
40
- parts: OpenCodePart[];
41
- }
42
-
43
- interface OpenCodeSession {
44
- info: {
45
- id: string;
46
- title?: string;
47
- createdAt?: string;
48
- updatedAt?: string;
49
- };
50
- messages: OpenCodeMessage[];
51
- }
52
-
53
- function extractTextContent(parts: OpenCodePart[]): string {
54
- return parts
55
- .filter((p) => p.type === 'text' && p.text)
56
- .map((p) => p.text!)
57
- .join('\n');
58
- }
59
-
60
- function extractModifiedFiles(parts: OpenCodePart[]): ModifiedFile[] {
61
- const files: ModifiedFile[] = [];
62
- for (const part of parts) {
63
- if (part.type !== 'tool' || !part.tool) continue;
64
- if (!FILE_MOD_TOOLS.has(part.tool)) continue;
65
-
66
- const input = part.state?.input;
67
- if (!input) continue;
68
-
69
- const filePath = (input.filePath as string) || (input.path as string);
70
- if (filePath) {
71
- files.push({
72
- filePath,
73
- toolName: part.tool,
74
- });
75
- }
76
- }
77
- return files;
78
- }
79
-
80
- function extractToolUses(parts: OpenCodePart[]): ToolUseInfo[] {
81
- const tools: ToolUseInfo[] = [];
82
- for (const part of parts) {
83
- if (part.type !== 'tool' || !part.tool) continue;
84
- tools.push({
85
- toolName: part.tool,
86
- toolUseId: '',
87
- input: (part.state?.input as Record<string, unknown>) || {},
88
- });
89
- }
90
- return tools;
91
- }
92
-
93
- export class OpenCodeParser implements AgentParser {
94
- async detect(repoPath: string): Promise<DetectionResult> {
95
- return detectAgent(repoPath);
96
- }
97
-
98
- async parse(
99
- sessionFilePath: string,
100
- _repoPath: string,
101
- ): Promise<AgentContext> {
102
- const raw = fs.readFileSync(sessionFilePath, 'utf-8');
103
- const session: OpenCodeSession = JSON.parse(raw);
104
- const messages = session.messages || [];
105
-
106
- const transcript: InteractionTurn[] = [];
107
- const totalUsage: TokenUsage = {
108
- inputTokens: 0,
109
- outputTokens: 0,
110
- cacheCreationTokens: 0,
111
- cacheReadTokens: 0,
112
- };
113
-
114
- let taskPrompt = '';
115
-
116
- for (let i = 0; i < messages.length; i++) {
117
- const msg = messages[i];
118
- const role = msg.info.role;
119
- const content = extractTextContent(msg.parts);
120
-
121
- if (role === 'user' && !taskPrompt && content) {
122
- taskPrompt = content;
123
- }
124
-
125
- const tokens = msg.info.tokens;
126
- if (tokens) {
127
- totalUsage.inputTokens += tokens.input || 0;
128
- totalUsage.outputTokens += tokens.output || 0;
129
- totalUsage.cacheReadTokens! += tokens.cache?.read || 0;
130
- totalUsage.cacheCreationTokens! += tokens.cache?.write || 0;
131
- }
132
-
133
- transcript.push({
134
- turnIndex: i,
135
- role,
136
- content,
137
- modifiedFiles:
138
- role === 'assistant' ? extractModifiedFiles(msg.parts) : [],
139
- tokenUsage: tokens
140
- ? {
141
- inputTokens: tokens.input || 0,
142
- outputTokens: tokens.output || 0,
143
- cacheReadTokens: tokens.cache?.read,
144
- cacheCreationTokens: tokens.cache?.write,
145
- }
146
- : undefined,
147
- toolUses: role === 'assistant' ? extractToolUses(msg.parts) : [],
148
- });
149
- }
150
-
151
- const allModifiedFiles = new Set<string>();
152
- for (const turn of transcript) {
153
- for (const f of turn.modifiedFiles) {
154
- allModifiedFiles.add(f.filePath);
155
- }
156
- }
157
-
158
- const stat = fs.statSync(sessionFilePath);
159
-
160
- return {
161
- agent: 'opencode',
162
- sessionId: session.info.id,
163
- sessionFilePath,
164
- taskPrompt,
165
- modifiedFiles: Array.from(allModifiedFiles),
166
- tokenUsage: totalUsage,
167
- transcript,
168
- metadata: {
169
- startedAt: session.info.createdAt,
170
- sessionFileModifiedAt: stat.mtime.toISOString(),
171
- },
172
- };
173
- }
174
- }
@@ -1,14 +0,0 @@
1
- {
2
- "compilerOptions": {
3
- "target": "ES2022",
4
- "module": "Node16",
5
- "moduleResolution": "Node16",
6
- "strict": true,
7
- "esModuleInterop": true,
8
- "types": ["node"],
9
- "resolveJsonModule": true,
10
- "noEmit": true,
11
- "skipLibCheck": true
12
- },
13
- "include": ["./**/*.ts"]
14
- }
@@ -1,58 +0,0 @@
1
- export type AgentType = 'claude-code' | 'gemini-cli' | 'opencode' | 'codex';
2
-
3
- export interface ModifiedFile {
4
- filePath: string;
5
- toolName: string;
6
- toolUseId?: string;
7
- }
8
-
9
- export interface TokenUsage {
10
- inputTokens: number;
11
- outputTokens: number;
12
- cacheCreationTokens?: number;
13
- cacheReadTokens?: number;
14
- }
15
-
16
- export interface ToolUseInfo {
17
- toolName: string;
18
- toolUseId: string;
19
- input: Record<string, unknown>;
20
- }
21
-
22
- export interface InteractionTurn {
23
- turnIndex: number;
24
- role: 'user' | 'assistant';
25
- content: string;
26
- modifiedFiles: ModifiedFile[];
27
- tokenUsage?: TokenUsage;
28
- toolUses: ToolUseInfo[];
29
- }
30
-
31
- export interface AgentContext {
32
- agent: AgentType;
33
- sessionId: string;
34
- sessionFilePath: string;
35
- taskPrompt: string;
36
- modifiedFiles: string[];
37
- tokenUsage: TokenUsage;
38
- transcript: InteractionTurn[];
39
- metadata: {
40
- model?: string;
41
- version?: string;
42
- gitBranch?: string;
43
- startedAt?: string;
44
- sessionFileModifiedAt: string;
45
- };
46
- }
47
-
48
- export interface DetectionResult {
49
- detected: boolean;
50
- agent?: AgentType;
51
- sessionFilePath?: string;
52
- sessionId?: string;
53
- }
54
-
55
- export interface AgentParser {
56
- detect(repoPath: string): Promise<DetectionResult>;
57
- parse(sessionFilePath: string, repoPath: string): Promise<AgentContext>;
58
- }
@@ -1,59 +0,0 @@
1
- # LLM Rules
2
-
3
- These rules govern how LLM agents should interact with this codebase. They are enforced by a pre-commit hook.
4
-
5
- ## Creating Pull Requests
6
-
7
- **Always use `haystack submit` instead of `gh pr create` or GitHub API.**
8
-
9
- ```bash
10
- # Default submit - creates the PR from the current branch
11
- haystack submit
12
-
13
- # Request Haystack review - for complex/uncertain changes
14
- haystack submit --review
15
- ```
16
-
17
- This routes your PR through Haystack's submit workflow:
18
- 1. Haystack runs pre-PR triage on your changes
19
- 2. Pushes the current branch and creates the PR
20
- 3. Waits for analysis results by default
21
- 4. Auto-merges only if the repo has auto-merge enabled and the PR is approved
22
-
23
- Do NOT use `gh pr create` - it bypasses Haystack's submit workflow.
24
-
25
- After submitting, use `haystack triage <pr-number>` to check analysis results (rating, findings, agent fix prompts). Use `--json` for machine-readable output.
26
-
27
- - When you write or edit LLM prompts in response to a failure running against some test data, be certain that your edit is not specific to the test data, and is actually addressing the more generic problem that caused the failure.
28
- - If the user specifies a model, follow it. Your understanding of current LLM models is outdated.
29
- - Do not add silent fallbacks.
30
- - Do not add backwards compatibility, unless you confirmed with the user first that it's desired.
31
- - Do not add TODOs and incomplete code unless they have been explicitly flagged to the user.
32
- - When the user asks for a general or systematic fix, do not satisfy it with a check that only catches the known example. Implement the requested class of protection, or explicitly say what remains unfinished.
33
- - Finish both sides of cross-boundary implementations. When adding a new keyed capability, mode, event, route, config value, feature flag, enum variant, or serialized field, verify and update every required consumer, producer, registry, allow-list, schema, persistence path, and delivery surface. If the existing system requires "also register it in X", do that wiring or explicitly report that it is intentionally out of scope.
34
-
35
- ## No Truncation Without Permission
36
-
37
- When writing or modifying agent code (tool calls, prompts, LLM pipelines):
38
-
39
- - **Never truncate, slice, or omit content** from tool call inputs, tool call outputs, prompt context, search results, file contents, or any data passed to/from LLMs without explicit user permission.
40
- - **Never summarize in place of full content** (e.g., "... [content omitted]", "showing first 50 lines", "[truncated for brevity]").
41
- - **No silent length limits** - do not add code that silently cuts off text at N characters/lines/tokens.
42
-
43
- If truncation is technically necessary (e.g., context limits):
44
- 1. **Disclose explicitly** that truncation will occur
45
- 2. **State what and how much** will be omitted
46
- 3. **Ask for user permission** before proceeding
47
- 4. **Offer alternatives** (e.g., chunking, pagination with user control)
48
-
49
- This applies to: grep/search results, file reads, API responses, prompt templates, tool definitions, agent memory, conversation history, and any other text flowing through agent pipelines.
50
-
51
- ## No Hardcoded Repo Knowledge in Prompts
52
-
53
- When writing LLM prompts for generic tools:
54
-
55
- - **Never hardcode repo-specific examples** like component names, file paths, or internal terminology.
56
- - **Use generic examples** that would work for any codebase (e.g., "Sidebar", "Card", "Modal").
57
- - **Let the LLM infer from context** rather than baking in assumptions about your specific codebase.
58
-
59
- This keeps tools portable and prevents prompts from becoming stale when the codebase changes.