peaks-loop 4.0.21 → 4.0.24

package/dist/services/best-practice/scan-orchestrator.js

@@ -0,0 +1,85 @@
+const DEFAULT_CONTEXT7_TIMEOUT_MS = 30_000;
+const DEFAULT_CONTEXT7_DELAY_MS = 100;
+const DEFAULT_WEBSEARCH_DELAY_MS = 200;
+const defaultContext7Lookup = async (intent, language) => {
+    // TODO: real MCP integration — call `@upstash/context7-mcp`'s
+    // resolve-library-id + query-docs and translate errors into the
+    // shared `{ ok, results }` envelope.
+    await new Promise((resolveFn) => setTimeout(resolveFn, DEFAULT_CONTEXT7_DELAY_MS));
+    return {
+        ok: true,
+        results: [
+            {
+                title: `Context7 ${language} doc for "${intent}"`,
+                url: `https://context7.com/${language}/${encodeURIComponent(intent)}`,
+                snippet: `best practice for ${intent} in ${language} (context7 stub)`
+            }
+        ]
+    };
+};
+const defaultWebSearchLookup = async (intent, language) => {
+    // TODO: real web search wiring — use Context7 WebSearch tool or
+    // WebFetch + ranking; current stub returns a synthetic fragment.
+    await new Promise((resolveFn) => setTimeout(resolveFn, DEFAULT_WEBSEARCH_DELAY_MS));
+    return {
+        ok: true,
+        results: [
+            {
+                title: `WebSearch ${language} case for "${intent}"`,
+                url: `https://example.com/search?q=${encodeURIComponent(intent)}&lang=${language}`,
+                snippet: `implementation example for ${intent} in ${language} (websearch stub)`
+            }
+        ]
+    };
+};
+export async function scanBestPractice(opts) {
+    const timeoutMs = opts.context7TimeoutMs ?? DEFAULT_CONTEXT7_TIMEOUT_MS;
+    const startedAt = Date.now();
+    opts.io.stdout(`[scan-orchestrator] querying context7 for "${opts.intent}" (${opts.language})`);
+    let context7Outcome = null;
+    let context7Error = null;
+    try {
+        const ctxPromise = defaultContext7Lookup(opts.intent, opts.language);
+        const ctxTimer = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error(`context7 timeout after ${timeoutMs}ms`)), timeoutMs).unref();
+        });
+        context7Outcome = await Promise.race([ctxPromise, ctxTimer]);
+    }
+    catch (err) {
+        context7Error = err instanceof Error ? err.message : String(err);
+        opts.io.stderr(`[scan-orchestrator] context7 failed: ${context7Error}`);
+    }
+    if (context7Outcome !== null && context7Outcome.ok && context7Outcome.results.length > 0) {
+        return {
+            results: context7Outcome.results,
+            fragments: context7Outcome.results,
+            source: 'context7',
+            elapsedMs: Date.now() - startedAt
+        };
+    }
+    opts.io.stdout(`[scan-orchestrator] falling back to websearch for "${opts.intent}" (${opts.language})`);
+    let webOutcome = null;
+    let webError = null;
+    try {
+        webOutcome = await defaultWebSearchLookup(opts.intent, opts.language);
+    }
+    catch (err) {
+        webError = err instanceof Error ? err.message : String(err);
+        opts.io.stderr(`[scan-orchestrator] websearch failed: ${webError}`);
+    }
+    if (webOutcome !== null && webOutcome.ok && webOutcome.results.length > 0) {
+        return {
+            results: webOutcome.results,
+            fragments: webOutcome.results,
+            source: 'websearch',
+            elapsedMs: Date.now() - startedAt
+        };
+    }
+    opts.io.stderr('[scan-orchestrator] both sources empty; returning empty fallback');
+    return {
+        results: [],
+        fragments: [],
+        source: 'fallback',
+        elapsedMs: Date.now() - startedAt
+    };
+}

package/dist/services/context/collector.d.ts

@@ -3,19 +3,12 @@ import type { CollectorOutput } from './types.js';
 declare const CollectInputSchema: z.ZodObject<{
     goal: z.ZodString;
     project: z.ZodString;
-    depsMode: z.ZodEnum<["locked", "latest"]>;
+    depsMode: z.ZodEnum<{
+        latest: "latest";
+        locked: "locked";
+    }>;
     out: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    project: string;
-    goal: string;
-    depsMode: "latest" | "locked";
-    out?: string | undefined;
-}, {
-    project: string;
-    goal: string;
-    depsMode: "latest" | "locked";
-    out?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type CollectInput = z.infer<typeof CollectInputSchema>;
 export declare function collectContext(rawInput: unknown): Promise<{
     readonly goal: string;

package/dist/services/context/context-builder.d.ts

@@ -3,28 +3,20 @@ import type { ContextJson } from './types.js';
 declare const BuildInputSchema: z.ZodObject<{
     goal: z.ZodString;
     project: z.ZodString;
-    audience: z.ZodEnum<["peaks-rd", "peaks-qa", "peaks-mut", "all"]>;
-    depsMode: z.ZodEnum<["locked", "latest"]>;
+    audience: z.ZodEnum<{
+        all: "all";
+        "peaks-rd": "peaks-rd";
+        "peaks-qa": "peaks-qa";
+        "peaks-mut": "peaks-mut";
+    }>;
+    depsMode: z.ZodEnum<{
+        latest: "latest";
+        locked: "locked";
+    }>;
     docBudgetTokens: z.ZodDefault<z.ZodNumber>;
     out: z.ZodString;
-    fetcher: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
-}, "strip", z.ZodTypeAny, {
-    project: string;
-    goal: string;
-    audience: "all" | "peaks-rd" | "peaks-qa" | "peaks-mut";
-    depsMode: "latest" | "locked";
-    out: string;
-    docBudgetTokens: number;
-    fetcher: (...args: unknown[]) => unknown;
-}, {
-    project: string;
-    goal: string;
-    audience: "all" | "peaks-rd" | "peaks-qa" | "peaks-mut";
-    depsMode: "latest" | "locked";
-    out: string;
-    fetcher: (...args: unknown[]) => unknown;
-    docBudgetTokens?: number | undefined;
-}>;
+    fetcher: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+}, z.core.$strip>;
 export type BuildInput = z.infer<typeof BuildInputSchema>;
 export declare function buildContext(rawInput: unknown): Promise<ContextJson>;
 export {};

package/dist/services/context/context-builder.js

@@ -19,7 +19,7 @@ const BuildInputSchema = z.object({
     project: z.string().min(1),
     audience: z.enum(['peaks-rd', 'peaks-qa', 'peaks-mut', 'all']),
     depsMode: z.enum(['locked', 'latest']),
-    docBudgetTokens: z.number().int().positive().default(8000),
+    docBudgetTokens: z.number().int().gt(0).default(8000),
     out: z.string().min(1),
     fetcher: z.function(),
 });

package/dist/services/context/context-schema.d.ts

@@ -11,114 +11,44 @@ export declare const ContextJsonSchema: z.ZodObject<{
     collector: z.ZodObject<{
         files: z.ZodArray<z.ZodObject<{
             path: z.ZodString;
-            kind: z.ZodEnum<["source", "test", "config", "doc"]>;
+            kind: z.ZodEnum<{
+                doc: "doc";
+                source: "source";
+                config: "config";
+                test: "test";
+            }>;
             lines: z.ZodNumber;
             hash: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            lines: number;
-            kind: "doc" | "source" | "config" | "test";
-            hash: string;
-        }, {
-            path: string;
-            lines: number;
-            kind: "doc" | "source" | "config" | "test";
-            hash: string;
-        }>, "many">;
+        }, z.core.$strip>>;
         gitStatus: z.ZodObject<{
             branch: z.ZodString;
             lastCommit: z.ZodString;
             dirty: z.ZodBoolean;
-        }, "strip", z.ZodTypeAny, {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        }, {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        }>;
+        }, z.core.$strip>;
         memoryEntries: z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             title: z.ZodString;
             relevanceScore: z.ZodNumber;
             excerptHash: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }, {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }>, "many">;
+        }, z.core.$strip>>;
         deps: z.ZodRecord<z.ZodString, z.ZodObject<{
             version: z.ZodString;
-            source: z.ZodEnum<["package.json", "pnpm-lock.yaml", "yarn.lock"]>;
+            source: z.ZodEnum<{
+                "package.json": "package.json";
+                "pnpm-lock.yaml": "pnpm-lock.yaml";
+                "yarn.lock": "yarn.lock";
+            }>;
             resolved: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        files: {
-            path: string;
-            lines: number;
-            kind: "doc" | "source" | "config" | "test";
-            hash: string;
-        }[];
-        deps: Record<string, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }>;
-        gitStatus: {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        };
-        memoryEntries: {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }[];
-    }, {
-        files: {
-            path: string;
-            lines: number;
-            kind: "doc" | "source" | "config" | "test";
-            hash: string;
-        }[];
-        deps: Record<string, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }>;
-        gitStatus: {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        };
-        memoryEntries: {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }[];
-    }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
     docRetriever: z.ZodObject<{
         fetchedDocs: z.ZodArray<z.ZodObject<{
             dep: z.ZodString;
             version: z.ZodString;
-            source: z.ZodEnum<["local-cache", "remote-fetch"]>;
+            source: z.ZodEnum<{
+                "local-cache": "local-cache";
+                "remote-fetch": "remote-fetch";
+            }>;
             url: z.ZodOptional<z.ZodString>;
             fetchedAt: z.ZodString;
             contentHash: z.ZodString;
@@ -126,290 +56,47 @@ export declare const ContextJsonSchema: z.ZodObject<{
                 title: z.ZodString;
                 tokenEstimate: z.ZodNumber;
                 excerpt: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }, {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }>, "many">;
+            }, z.core.$strip>>;
             stale: z.ZodBoolean;
-        }, "strip", z.ZodTypeAny, {
-            version: string;
-            stale: boolean;
-            source: "local-cache" | "remote-fetch";
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }, {
-            version: string;
-            stale: boolean;
-            source: "local-cache" | "remote-fetch";
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }>, "many">;
+        }, z.core.$strip>>;
         skipped: z.ZodArray<z.ZodObject<{
             dep: z.ZodString;
-            reason: z.ZodEnum<["unconfigured", "network_error", "version_unknown"]>;
-        }, "strip", z.ZodTypeAny, {
-            reason: "unconfigured" | "network_error" | "version_unknown";
-            dep: string;
-        }, {
-            reason: "unconfigured" | "network_error" | "version_unknown";
-            dep: string;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        skipped: {
-            reason: "unconfigured" | "network_error" | "version_unknown";
-            dep: string;
-        }[];
-        fetchedDocs: {
-            version: string;
-            stale: boolean;
-            source: "local-cache" | "remote-fetch";
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }[];
-    }, {
-        skipped: {
-            reason: "unconfigured" | "network_error" | "version_unknown";
-            dep: string;
-        }[];
-        fetchedDocs: {
-            version: string;
-            stale: boolean;
-            source: "local-cache" | "remote-fetch";
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }[];
-    }>;
+            reason: z.ZodEnum<{
+                unconfigured: "unconfigured";
+                network_error: "network_error";
+                version_unknown: "version_unknown";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
     tokenizer: z.ZodObject<{
         metadata: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
-            kind: z.ZodEnum<["doc", "code", "memory", "git"]>;
+            kind: z.ZodEnum<{
+                git: "git";
+                code: "code";
+                doc: "doc";
+                memory: "memory";
+            }>;
             version: z.ZodOptional<z.ZodString>;
-            blastRadius: z.ZodArray<z.ZodString, "many">;
+            blastRadius: z.ZodArray<z.ZodString>;
             conflictScore: z.ZodNumber;
             timeDecayScore: z.ZodNumber;
-            tags: z.ZodArray<z.ZodString, "many">;
-        }, "strip", z.ZodTypeAny, {
-            id: string;
-            kind: "git" | "code" | "doc" | "memory";
-            tags: string[];
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            version?: string | undefined;
-        }, {
-            id: string;
-            kind: "git" | "code" | "doc" | "memory";
-            tags: string[];
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            version?: string | undefined;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        metadata: {
-            id: string;
-            kind: "git" | "code" | "doc" | "memory";
-            tags: string[];
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            version?: string | undefined;
-        }[];
-    }, {
-        metadata: {
-            id: string;
-            kind: "git" | "code" | "doc" | "memory";
-            tags: string[];
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            version?: string | undefined;
-        }[];
-    }>;
+            tags: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
     renderer: z.ZodObject<{
-        audience: z.ZodEnum<["peaks-rd", "peaks-qa", "peaks-mut", "all"]>;
+        audience: z.ZodEnum<{
+            all: "all";
+            "peaks-rd": "peaks-rd";
+            "peaks-qa": "peaks-qa";
+            "peaks-mut": "peaks-mut";
+        }>;
         renderedAt: z.ZodString;
         sizeBytes: z.ZodNumber;
         truncated: z.ZodBoolean;
-        truncatedReason: z.ZodOptional<z.ZodEnum<["doc_budget_exceeded", "section_count_exceeded"]>>;
-    }, "strip", z.ZodTypeAny, {
-        sizeBytes: number;
-        truncated: boolean;
-        audience: "all" | "peaks-rd" | "peaks-qa" | "peaks-mut";
-        renderedAt: string;
-        truncatedReason?: "doc_budget_exceeded" | "section_count_exceeded" | undefined;
-    }, {
-        sizeBytes: number;
-        truncated: boolean;
-        audience: "all" | "peaks-rd" | "peaks-qa" | "peaks-mut";
-        renderedAt: string;
-        truncatedReason?: "doc_budget_exceeded" | "section_count_exceeded" | undefined;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    version: "1.0";
-    goal: string;
-    sha256: string;
-    generatedAt: string;
-    collector: {
-        files: {
-            path: string;
-            lines: number;
-            kind: "doc" | "source" | "config" | "test";
-            hash: string;
-        }[];
-        deps: Record<string, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }>;
-        gitStatus: {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        };
-        memoryEntries: {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }[];
-    };
-    docRetriever: {
-        skipped: {
-            reason: "unconfigured" | "network_error" | "version_unknown";
-            dep: string;
-        }[];
-        fetchedDocs: {
-            version: string;
-            stale: boolean;
-            source: "local-cache" | "remote-fetch";
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }[];
-    };
-    tokenizer: {
-        metadata: {
-            id: string;
-            kind: "git" | "code" | "doc" | "memory";
-            tags: string[];
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            version?: string | undefined;
-        }[];
-    };
-    renderer: {
-        sizeBytes: number;
-        truncated: boolean;
-        audience: "all" | "peaks-rd" | "peaks-qa" | "peaks-mut";
-        renderedAt: string;
-        truncatedReason?: "doc_budget_exceeded" | "section_count_exceeded" | undefined;
-    };
-}, {
-    version: "1.0";
-    goal: string;
-    sha256: string;
-    generatedAt: string;
-    collector: {
-        files: {
-            path: string;
-            lines: number;
-            kind: "doc" | "source" | "config" | "test";
-            hash: string;
-        }[];
-        deps: Record<string, {
-            version: string;
-            source: "package.json" | "pnpm-lock.yaml" | "yarn.lock";
-            resolved: string;
-        }>;
-        gitStatus: {
-            dirty: boolean;
-            branch: string;
-            lastCommit: string;
-        };
-        memoryEntries: {
-            path: string;
-            title: string;
-            relevanceScore: number;
-            excerptHash: string;
-        }[];
-    };
-    docRetriever: {
-        skipped: {
-            reason: "unconfigured" | "network_error" | "version_unknown";
-            dep: string;
-        }[];
-        fetchedDocs: {
-            version: string;
-            stale: boolean;
-            source: "local-cache" | "remote-fetch";
-            dep: string;
-            fetchedAt: string;
-            contentHash: string;
-            sections: {
-                title: string;
-                tokenEstimate: number;
-                excerpt: string;
-            }[];
-            url?: string | undefined;
-        }[];
-    };
-    tokenizer: {
-        metadata: {
-            id: string;
-            kind: "git" | "code" | "doc" | "memory";
-            tags: string[];
-            blastRadius: string[];
-            conflictScore: number;
-            timeDecayScore: number;
-            version?: string | undefined;
-        }[];
-    };
-    renderer: {
-        sizeBytes: number;
-        truncated: boolean;
-        audience: "all" | "peaks-rd" | "peaks-qa" | "peaks-mut";
-        renderedAt: string;
-        truncatedReason?: "doc_budget_exceeded" | "section_count_exceeded" | undefined;
-    };
-}>;
+        truncatedReason: z.ZodOptional<z.ZodEnum<{
+            doc_budget_exceeded: "doc_budget_exceeded";
+            section_count_exceeded: "section_count_exceeded";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/services/context/context-schema.js

@@ -12,7 +12,7 @@ export const ContextJsonSchema = z.object({
         files: z.array(z.object({
             path: z.string(),
             kind: z.enum(['source', 'test', 'config', 'doc']),
-            lines: z.number().int().nonnegative(),
+            lines: z.number().int().gte(0),
             hash: z.string(),
         })),
         gitStatus: z.object({
@@ -42,7 +42,7 @@ export const ContextJsonSchema = z.object({
             contentHash: z.string(),
             sections: z.array(z.object({
                 title: z.string(),
-                tokenEstimate: z.number().int().nonnegative(),
+                tokenEstimate: z.number().int().gte(0),
                 excerpt: z.string(),
             })),
             stale: z.boolean(),
@@ -66,7 +66,7 @@ export const ContextJsonSchema = z.object({
     renderer: z.object({
         audience: z.enum(['peaks-rd', 'peaks-qa', 'peaks-mut', 'all']),
         renderedAt: z.string().datetime(),
-        sizeBytes: z.number().int().nonnegative(),
+        sizeBytes: z.number().int().gte(0),
         truncated: z.boolean(),
         truncatedReason: z.enum(['doc_budget_exceeded', 'section_count_exceeded']).optional(),
     }),

package/dist/services/crystallization/crystallization-service.d.ts

@@ -70,17 +70,7 @@ export declare const CrystallizationTaskStateSchema: z.ZodObject<{
     task_status: z.ZodLiteral<"completed">;
     gates_passed: z.ZodLiteral<true>;
     evidence_collected: z.ZodLiteral<true>;
-}, "strip", z.ZodTypeAny, {
-    task_id: string;
-    task_status: "completed";
-    gates_passed: true;
-    evidence_collected: true;
-}, {
-    task_id: string;
-    task_status: "completed";
-    gates_passed: true;
-    evidence_collected: true;
-}>;
+}, z.core.$strip>;
 export type CrystallizationTaskState = z.infer<typeof CrystallizationTaskStateSchema>;
 export type CrystallizationIntegrityErrorCode = "CRYSTALLIZATION_PRE_RUN" | "CRYSTALLIZATION_INVALID_TASK_STATE" | "CRYSTALLIZATION_TX_FAILED" | "MISSING_BRIEF_SECTION";
 export declare class CrystallizationIntegrityError extends Error {
@@ -183,7 +173,6 @@ export declare class CrystallizationService {
      * (newest-first).
      */
     list(opts?: Parameters<typeof listCrystallizationEvents>[1]): {
-        schema_version: "peaks.crystallization/1";
         trigger: "user_explicit" | "llm_suggested" | "success_default_prompt" | "similar_task_recurrence";
         evidence_brief: {
             what_happened: string;
@@ -197,6 +186,7 @@ export declare class CrystallizationService {
         user_decision_summary: string;
         lifecycle_status: "candidate" | "stable" | "retired";
         id: string;
+        schema_version: "peaks.crystallization/1";
         created_at: string;
         created_loop_release_id?: string | undefined;
         updated_loop_release_id?: string | undefined;