@wrongstack/core 0.306.3 → 0.307.0

package/dist/plugins/auto-review-config.d.ts

@@ -0,0 +1,53 @@
+import type { ProviderModelStatusTracker } from '../coordination/provider-status-tracker.js';
+import type { Config } from '../types/config.js';
+import type { CascadeAgentKind } from './chimera-plugin.js';
+import type { ChimeraFinding } from './review-finding-types.js';
+export interface AutoReviewConfig {
+    enabled?: boolean | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
+    fallbackProfile?: string | undefined;
+    modelSelection?: 'round-robin' | 'random' | undefined;
+    debounceMs?: number | undefined;
+    maxFilesPerBatch?: number | undefined;
+    maxConcurrentReviews?: number | undefined;
+    cascadeOn?: 'off' | 'critical' | 'high' | undefined;
+    maxCascadeDepth?: number | undefined;
+}
+export interface ResolvedAutoReviewConfig {
+    enabled: boolean;
+    provider: string;
+    model: string;
+    fallbackModels: string[];
+    modelSelection: 'round-robin' | 'random';
+    debounceMs: number;
+    maxFilesPerBatch: number;
+    maxConcurrentReviews: number;
+    cascadeOn: 'off' | 'critical' | 'high';
+    maxCascadeDepth: number;
+}
+export declare const DEFAULT_DEBOUNCE_MS = 15000;
+export declare const DEFAULT_MAX_FILES_PER_BATCH = 15;
+export declare const DEFAULT_MAX_CONCURRENT_REVIEWS = 2;
+export declare const DEFAULT_MAX_CASCADE_DEPTH = 2;
+export declare const MAX_KNOWN_FINGERPRINTS = 5000;
+export declare function trimKnownFingerprints(map: Map<string, string>, max: number): void;
+export interface ReviewerModelAssignment {
+    provider: string;
+    model: string;
+    fallbackModels: string[];
+    nextCursor: number;
+}
+export declare function buildReviewerModelPool(provider: string, model: string, fallbackModels?: readonly string[], statusTracker?: ProviderModelStatusTracker | undefined): string[];
+export declare function selectRoundRobinReviewerAssignment(pool: readonly string[], cursor: number, fallbackProvider?: string, fallbackModel?: string, statusTracker?: ProviderModelStatusTracker | undefined): ReviewerModelAssignment;
+export declare function resolveAutoReviewConfig(cfg: AutoReviewConfig, sessionConfig: Config): ResolvedAutoReviewConfig;
+export interface ParsedSeverities {
+    critical: number;
+    high: number;
+    medium: number;
+}
+export declare function severitiesFromFindings(findings: readonly ChimeraFinding[]): ParsedSeverities;
+export declare function parseReviewSeverity(text: string): ParsedSeverities;
+export declare function decideCascadeAgents(text: string, severities: ParsedSeverities, findings?: readonly ChimeraFinding[] | undefined): CascadeAgentKind[];
+export declare function shouldCascade(cascadeOn: 'off' | 'critical' | 'high', severities: ParsedSeverities): 'high' | 'critical' | null;
+//# sourceMappingURL=auto-review-config.d.ts.map

package/dist/plugins/auto-review-git.d.ts

@@ -0,0 +1,19 @@
+export interface ChangedFile {
+    path: string;
+    status: 'added' | 'modified';
+}
+export interface ChangedFileSnapshot extends ChangedFile {
+    content: string;
+    fingerprint: string;
+}
+export declare const MAX_SNAPSHOT_FILE_BYTES: number;
+export declare const MAX_SNAPSHOT_TOTAL_BYTES: number;
+export declare function runGit(args: string[], cwd: string): Promise<{
+    stdout: string;
+    stderr: string;
+    code: number;
+}>;
+export declare function isGitRepo(cwd: string): Promise<boolean>;
+export declare function getChangedFiles(cwd: string): Promise<ChangedFile[]>;
+export declare function snapshotChangedFiles(cwd: string): Promise<ChangedFileSnapshot[]>;
+//# sourceMappingURL=auto-review-git.d.ts.map

package/dist/plugins/auto-review-plugin.d.ts

@@ -1,143 +1,5 @@
-import type { ProviderModelStatusTracker } from '../coordination/provider-status-tracker.js';
-import type { Config } from '../types/config.js';
 import type { Plugin } from '../types/plugin.js';
-import type { CascadeAgentKind } from './chimera-plugin.js';
-import type { ChimeraFinding } from './review-finding-types.js';
-export interface AutoReviewConfig {
-    enabled?: boolean | undefined;
-    /** Provider for review subagents. Falls back to session provider. */
-    provider?: string | undefined;
-    /** Model for review subagents. Falls back to session model. */
-    model?: string | undefined;
-    /**
-     * Named fallback profile from config.fallbackProfiles.
-     * Resolved via FallbackProfileManager. The first valid entry
-     * becomes the primary provider/model (when provider/model are
-     * omitted), and the remaining entries form the fallback chain.
-     */
-    fallbackProfile?: string | undefined;
-    /** How each review chooses its starting model from the resolved profile pool. */
-    modelSelection?: 'round-robin' | 'random' | undefined;
-    /** Debounce window in ms — wait for quiet before firing review (default 15000). */
-    debounceMs?: number | undefined;
-    /** Max files per review batch (default 15). */
-    maxFilesPerBatch?: number | undefined;
-    /** Max concurrent in-flight reviews (default 2). */
-    maxConcurrentReviews?: number | undefined;
-    /**
-     * Cascade severity threshold: when a review finds findings at or above this
-     * level, spawn follow-up agents automatically. "off" disables cascading,
-     * "high" cascades on High+, "critical" cascades only on Critical.
-     * Default: "off".
-     */
-    cascadeOn?: 'off' | 'critical' | 'high' | undefined;
-    /**
-     * Maximum cascade iterations (fix → re-review cycles) before the
-     * self-correcting loop stops. Prevents infinite cycles. Default: 2.
-     * 0 disables re-review (cascade agents investigate/fix once, no re-check).
-     */
-    maxCascadeDepth?: number | undefined;
-}
-export interface ResolvedAutoReviewConfig {
-    enabled: boolean;
-    provider: string;
-    model: string;
-    fallbackModels: string[];
-    modelSelection: 'round-robin' | 'random';
-    debounceMs: number;
-    maxFilesPerBatch: number;
-    maxConcurrentReviews: number;
-    cascadeOn: 'off' | 'critical' | 'high';
-    maxCascadeDepth: number;
-}
-/**
- * Evict the oldest fingerprint entries past the cap (Map insertion order =
- * oldest first). Exported as a pure helper so the cap is unit-testable; the
- * plugin applies it on every `knownFingerprints` write.
- */
-export declare function trimKnownFingerprints(map: Map<string, string>, max: number): void;
-/**
- * Primary + fallback assignment for a single Chimera reviewer spawn.
- * Produced by {@link selectRoundRobinReviewerAssignment} so concurrent
- * reviewers start on different models and only share a provider after
- * their own in-place retries are exhausted.
- */
-export interface ReviewerModelAssignment {
-    provider: string;
-    model: string;
-    /** Remaining pool entries after the selected primary, wrap-around order. */
-    fallbackModels: string[];
-    /** Cursor to pass on the next spawn (`cursor + 1`). */
-    nextCursor: number;
-}
-/**
- * Build the deduped provider/model pool a reviewer can start on.
- *
- * Order is stable: configured primary first, then the fallback chain.
- * Entries must be `provider/model` (or parseable refs); bare blanks are dropped.
- *
- * When a {@link ProviderModelStatusTracker} is supplied, every entry that is
- * currently `state: 'blocked'` (waiting-room / token-reset-limit room) is
- * filtered out before the pool is returned. Without this filter, concurrent
- * Chimera reviewers would re-spawn on a 429-stricken model on every round-
- * robin turn and burn the entire chain instead of leaving the doomed model
- * quarantined until the tracker re-admits it.
- */
-export declare function buildReviewerModelPool(provider: string, model: string, fallbackModels?: readonly string[], statusTracker?: ProviderModelStatusTracker | undefined): string[];
-/**
- * Pick primary + fallback chain for the Nth concurrent reviewer via round-robin.
- *
- * Index `cursor % pool.length` becomes the primary; the rest of the pool is
- * rotated so the former primary lands last (still available after rate limits).
- * The pool must be pre-filtered by {@link buildReviewerModelPool} so every
- * non-empty entry contains both a provider and a model.
- *
- * When a {@link ProviderModelStatusTracker} is supplied, the cursor advances
- * over blocked entries too — a doomed entry is never picked as the primary,
- * but the cursor saturates against the live pool so the next-after-blocked
- * round inherits the rest of the unwalked chain instead of looping back to
- * the head. Without the tracker, the cursor advances mod `pool.length`,
- * which is the pre-waiting-room behavior.
- * Pure: the caller owns the cursor (typically a process-local counter).
- */
-export declare function selectRoundRobinReviewerAssignment(pool: readonly string[], cursor: number, 
-/** Used only when the selected ref is somehow unparseable — defensive. */
-fallbackProvider?: string, fallbackModel?: string, statusTracker?: ProviderModelStatusTracker | undefined): ReviewerModelAssignment;
-export declare function resolveAutoReviewConfig(cfg: AutoReviewConfig, sessionConfig: Config): ResolvedAutoReviewConfig;
-export interface ParsedSeverities {
-    critical: number;
-    high: number;
-    medium: number;
-}
-/**
- * Count verified findings into the severity shape `shouldCascade` expects.
- * Used by the P0-2 cascade gate: only disk-verified findings count toward
- * the cascade threshold when a parsed report is available.
- */
-export declare function severitiesFromFindings(findings: readonly ChimeraFinding[]): ParsedSeverities;
-/** Parse report counts for clean-vs-actionable classification. */
-export declare function parseReviewSeverity(text: string): ParsedSeverities;
-/**
- * Decide which follow-up cascade agents to spawn based on the review.
- *
- * When structured, disk-verified findings are supplied (P0-1/P0-2), routing
- * uses the finding's `category` tag: `security` selects security-scanner,
- * and any High+ finding selects bug-hunter. The legacy keyword scan on the
- * report text remains the fallback for reports without structured findings.
- *
- * Both agents may be returned in parallel when a finding is both severe and
- * security-related.
- */
-export declare function decideCascadeAgents(text: string, severities: ParsedSeverities, findings?: readonly ChimeraFinding[] | undefined): CascadeAgentKind[];
-/**
- * Determine whether a review result should trigger a cascade, given the
- * configured threshold and parsed severities. Returns the crossed
- * threshold, or `null` when the cascade should not fire.
- *
- *  - `'high'`      → fires on any High OR Critical finding
- *  - `'critical'`  → fires only on Critical findings
- *  - `'off'`       → never fires
- */
-export declare function shouldCascade(cascadeOn: 'off' | 'critical' | 'high', severities: ParsedSeverities): 'high' | 'critical' | null;
+import { type AutoReviewConfig, buildReviewerModelPool, decideCascadeAgents, parseReviewSeverity, resolveAutoReviewConfig, type ResolvedAutoReviewConfig, type ReviewerModelAssignment, selectRoundRobinReviewerAssignment, severitiesFromFindings, shouldCascade, trimKnownFingerprints } from './auto-review-config.js';
+export { buildReviewerModelPool, decideCascadeAgents, parseReviewSeverity, resolveAutoReviewConfig, selectRoundRobinReviewerAssignment, severitiesFromFindings, shouldCascade, trimKnownFingerprints, type AutoReviewConfig, type ResolvedAutoReviewConfig, type ReviewerModelAssignment, };
 export declare function createAutoReviewPlugin(): Plugin;
 //# sourceMappingURL=auto-review-plugin.d.ts.map

package/dist/plugins/review-finding-verification.d.ts

@@ -27,6 +27,13 @@ export interface VerifyFindingsOptions {
      */
     anchorWindow?: number | undefined;
 }
+/**
+ * Extract all candidate code identifiers from finding text, prioritizing:
+ *   1. Identifiers inside backticks (explicit code mentions: `foo.bar()`, `varName`)
+ *   2. Code-like identifiers (camelCase, snake_case, $-suffixed)
+ *   3. Other meaningful non-stopword tokens (>= 3 chars)
+ */
+export declare function extractFindingAnchors(title: string, description: string, suggestedFix?: string): string[];
 /**
  * Extract the most distinctive code identifier from a finding's
  * title + description. Prefers camelCase / snake_case / `$`-suffixed

package/dist/prompts/index.d.ts

@@ -1,3 +1,4 @@
 export { type JsonFetcher, PromptInstaller, type PromptInstallerOptions, type PromptPullResult, } from './prompt-installer.js';
 export { PromptManifestStore } from './prompt-manifest-store.js';
+export { ensureGitignore, getPromptJournalEntries, recordPromptJournalEntry, type PromptCategory, type PromptJournalEntry, type PromptJournalFilter, type RecordPromptOptions, } from './prompt-journal.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/prompts/prompt-journal.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Hierarchical Prompt Journal & Detailed Interaction Trace Logger.
+ *
+ * Persists comprehensive prompt history within a clean date & session folder hierarchy
+ * at `<projectRoot>/.wrongstack/prompts/`:
+ *
+ * ├── index.json                  <-- High-level catalog of dates, sessions & stats
+ * ├── index.md                    <-- Visual navigation board linking to daily journals
+ * └── YYYY-MM/                    <-- Month folder (e.g. 2026-08)
+ *     └── YYYY-MM-DD/             <-- Day folder (e.g. 2026-08-15)
+ *         ├── daily-summary.md    <-- Day's overview & interaction breakdown
+ *         ├── session-<id>.md     <-- Rich Markdown journal for that session
+ *         └── session-<id>.jsonl  <-- Machine-readable JSONL for that session
+ *
+ * Automatically ensures `.wrongstack/` is in `.gitignore` so traces are never
+ * accidentally committed to version control.
+ */
+export type PromptCategory = 'raw_user' | 'refined_user' | 'system_prompt' | 'autonomous_next_step' | 'self_healing_retry' | 'clarify_interaction' | 'subagent_delegation';
+export interface PromptJournalEntry {
+    id: string;
+    timestamp: string;
+    sessionId: string;
+    projectRoot: string;
+    role: 'user' | 'system' | 'assistant' | 'tool';
+    category: PromptCategory;
+    content: string;
+    rawContent?: string | undefined;
+    metadata: {
+        model?: string | undefined;
+        provider?: string | undefined;
+        iterationIndex?: number | undefined;
+        tokenEstimate: number;
+        characterCount: number;
+        lineCount: number;
+        activeTools?: string[] | undefined;
+        contextFiles?: string[] | undefined;
+        durationMs?: number | undefined;
+        decisionReason?: string | undefined;
+        tags?: string[] | undefined;
+    };
+}
+export interface RecordPromptOptions {
+    projectRoot: string;
+    sessionId?: string | undefined;
+    role?: 'user' | 'system' | 'assistant' | 'tool' | undefined;
+    category: PromptCategory;
+    content: string;
+    rawContent?: string | undefined;
+    model?: string | undefined;
+    provider?: string | undefined;
+    iterationIndex?: number | undefined;
+    activeTools?: string[] | undefined;
+    contextFiles?: string[] | undefined;
+    durationMs?: number | undefined;
+    decisionReason?: string | undefined;
+    tags?: string[] | undefined;
+}
+export interface PromptJournalFilter {
+    sessionId?: string | undefined;
+    category?: PromptCategory | undefined;
+    date?: string | undefined;
+    month?: string | undefined;
+    since?: string | undefined;
+    limit?: number | undefined;
+}
+export interface PromptJournalIndex {
+    updatedAt: string;
+    totalPrompts: number;
+    totalTokensEstimated: number;
+    months: Record<string, {
+        days: Record<string, {
+            sessions: Record<string, {
+                promptCount: number;
+                tokenEstimate: number;
+                lastTimestamp: string;
+                categories: Record<string, number>;
+            }>;
+        }>;
+    }>;
+}
+/**
+ * Ensures `<projectRoot>/.gitignore` contains `.wrongstack/` to keep all
+ * prompt logs, telemetry, and indexes out of version control.
+ */
+export declare function ensureGitignore(projectRoot: string): Promise<void>;
+/**
+ * Record a comprehensive prompt entry into the hierarchical date-based prompt journal.
+ */
+export declare function recordPromptJournalEntry(opts: RecordPromptOptions): Promise<PromptJournalEntry>;
+/**
+ * Read prompt journal entries hierarchically across all date directories.
+ */
+export declare function getPromptJournalEntries(projectRoot: string, filter?: PromptJournalFilter): Promise<PromptJournalEntry[]>;
+//# sourceMappingURL=prompt-journal.d.ts.map