@tangle-network/starter-foundry 0.5.3 → 0.7.0

package/dist/lib/planner/zk-preferences.js

@@ -0,0 +1,91 @@
+// Operator-controlled weighted pick for ambiguous zk capability selection.
+// When a prompt mentions a zk primitive generically (e.g. "zkvm", "zk proof")
+// without naming a specific framework, resolve via weights in
+// .evolve/capability-preferences.json.
+//
+// Selection is DETERMINISTIC per prompt — we hash the prompt text into an
+// integer and use weighted-interval selection. Same prompt → same pick across
+// runs (no session-to-session variance), but different prompts cycle through
+// the weighted distribution.
+//
+// Explicit prompts bypass this entirely; see implicit-caps.ts for the
+// explicit-first branches.
+import { readFileSync, existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Repo-rooted path so this resolves correctly from test fixtures + production.
+// We re-resolve per call so test overrides via STARTER_FOUNDRY_REPO_OVERRIDE
+// work.
+function preferencesPath() {
+    const override = process.env.STARTER_FOUNDRY_REPO_OVERRIDE;
+    if (override)
+        return join(override, '.evolve/capability-preferences.json');
+    // __filename equivalent for ESM — resolve from dist/lib/planner/zk-preferences.js
+    // up to the repo root. src/lib/planner/zk-preferences.ts compiles to the same
+    // relative structure.
+    return resolve(dirname(fileURLToPath(import.meta.url)), '../../../.evolve/capability-preferences.json');
+}
+function loadPreferences() {
+    const path = preferencesPath();
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+// Deterministic integer hash over the prompt — stable across runs, no crypto
+// (fast + predictable). 32-bit unsigned; good enough for distribution
+// spreading across 3-10 weighted options.
+function hashText(text) {
+    let h = 2166136261 >>> 0; // FNV-1a seed
+    for (let i = 0; i < text.length; i += 1) {
+        h ^= text.charCodeAt(i);
+        h = Math.imul(h, 16777619) >>> 0;
+    }
+    return h >>> 0;
+}
+// Weighted interval selection: flatten weights into a cumulative array,
+// pick the bucket where hash%total falls. Returns null when the group has
+// no weights (operator disabled the pool) or the group is unknown.
+function weightedPick(weights, hash) {
+    const entries = Object.entries(weights).filter(([, w]) => w > 0);
+    if (entries.length === 0)
+        return null;
+    const total = entries.reduce((sum, [, w]) => sum + w, 0);
+    if (total <= 0)
+        return null;
+    const target = hash % total;
+    let acc = 0;
+    for (const [name, w] of entries) {
+        acc += w;
+        if (target < acc)
+            return name;
+    }
+    // Unreachable given total > 0 and target < total; belt-and-suspenders.
+    return entries[entries.length - 1][0];
+}
+/**
+ * Pick a zk capability for a prompt that mentions a zk primitive generically.
+ *
+ * @param text - the prompt text; hashed for deterministic selection.
+ * @param group - which preference group to consult (today: only "zkvm").
+ * @returns the capability ID (e.g. "capability:zkvm-risczero") or null when
+ *   the group is unknown or has no weights.
+ */
+export function pickZkCapability(text, group) {
+    const prefs = loadPreferences();
+    if (!prefs)
+        return null;
+    const g = prefs.groups?.[group];
+    if (!g)
+        return null;
+    const hash = hashText(text);
+    const picked = weightedPick(g.weights, hash) ?? g.default;
+    if (!picked)
+        return null;
+    return `capability:${picked}`;
+}
+//# sourceMappingURL=zk-preferences.js.map

package/dist/lib/planner/zk-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zk-preferences.js","sourceRoot":"","sources":["../../../src/lib/planner/zk-preferences.ts"],"names":[],"mappings":"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"}

package/dist/lib/product-brief.d.ts

@@ -0,0 +1,25 @@
+export interface ProductBrief {
+    canonicalPrompt: string;
+    vision: string;
+    taskChecklist: string[];
+    milestones: string[];
+    testingPlan: string[];
+    e2ePlan: string[];
+    securityConcerns: string[];
+    openQuestions: string[];
+    confidence: number;
+}
+export interface BriefArgs {
+    prompt: string;
+    partner?: string | null;
+    knownFamilies: string[];
+    knownCapabilities: string[];
+}
+export interface BriefResult {
+    brief: ProductBrief;
+    cacheHit: boolean;
+    latencyMs: number;
+}
+export type BriefFn = (args: BriefArgs) => Promise<BriefResult | null>;
+export declare function __setTestBrief(fn: BriefFn | null): void;
+export declare function generateProductBrief(args: BriefArgs): Promise<BriefResult | null>;

package/dist/lib/product-brief.js

@@ -0,0 +1,129 @@
+import { createHash } from 'node:crypto';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { performance } from 'node:perf_hooks';
+import { ax } from '@ax-llm/ax';
+import { createLLM, isLLMAvailable } from './llm.js';
+const CACHE_DIR = '.evolve';
+const CACHE_PATH = path.join(CACHE_DIR, 'product-brief-cache.json');
+const MAX_LRU = 256;
+const inMemLRU = new Map();
+let diskCache = null;
+let testOverride = null;
+export function __setTestBrief(fn) {
+    testOverride = fn;
+}
+function hashKey(prompt, partner) {
+    return createHash('sha1').update(`brief::${prompt}::${partner ?? ''}`).digest('hex').slice(0, 16);
+}
+async function loadDiskCache() {
+    if (diskCache)
+        return diskCache;
+    try {
+        const raw = await fs.readFile(CACHE_PATH, 'utf8');
+        const obj = JSON.parse(raw);
+        diskCache = new Map(Object.entries(obj));
+    }
+    catch {
+        diskCache = new Map();
+    }
+    return diskCache;
+}
+async function persistDiskCache() {
+    if (!diskCache)
+        return;
+    await fs.mkdir(CACHE_DIR, { recursive: true });
+    const obj = {};
+    for (const [k, v] of diskCache)
+        obj[k] = v;
+    await fs.writeFile(CACHE_PATH, JSON.stringify(obj, null, 2));
+}
+// Rich brief generator: one LLM call yields everything the downstream pipeline
+// needs — the canonical routing prompt AND the product plan. Signatures use
+// ax's field-description syntax so the model knows what each field should
+// contain without needing a prose system prompt.
+const briefAgent = ax([
+    '"Turn a user product prompt into a structured product brief that drives a deterministic scaffold pipeline downstream. The canonicalPrompt must be a keyword-rich expansion that names concrete technologies drawn from knownFamilies (e.g. nextjs-ts, fullstack-ts, agent-service-ts, go-api, python-api, forge-contracts, solana-program) and concrete UI/infra capabilities drawn from knownCapabilities (e.g. capability:ai-chat-ui, capability:layout-dashboard, capability:saas-billing). It MUST be longer and more specific than the user prompt. Preserve the user intent exactly — do not invent features. The brief is for humans AND for AI agents that will build the project, so be concrete and specific. Each list field should have 3-8 items." ',
+    'userPrompt:string, ',
+    'knownFamilies:string[], ',
+    'knownCapabilities:string[] ',
+    '-> ',
+    'canonicalPrompt:string, ',
+    'vision:string, ',
+    'taskChecklist:string[], ',
+    'milestones:string[], ',
+    'testingPlan:string[], ',
+    'e2ePlan:string[], ',
+    'securityConcerns:string[], ',
+    'openQuestions:string[], ',
+    'confidence:number',
+].join(''));
+function normalizeConfidence(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return 0.5;
+    if (value <= 0)
+        return 0;
+    if (value >= 1)
+        return 1;
+    return value;
+}
+function sanitizeList(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map((v) => String(v).trim()).filter(Boolean);
+}
+async function generateProductBriefImpl({ prompt, partner = null, knownFamilies, knownCapabilities, }) {
+    const key = hashKey(prompt, partner);
+    const mem = inMemLRU.get(key);
+    if (mem)
+        return { brief: mem, cacheHit: true, latencyMs: 0 };
+    const disk = await loadDiskCache();
+    const cached = disk.get(key);
+    if (cached) {
+        inMemLRU.set(key, cached);
+        return { brief: cached, cacheHit: true, latencyMs: 0 };
+    }
+    if (!isLLMAvailable())
+        return null;
+    const llm = createLLM();
+    const t0 = performance.now();
+    let raw;
+    try {
+        raw = (await briefAgent.forward(llm, {
+            userPrompt: prompt,
+            knownFamilies,
+            knownCapabilities,
+        }, { stream: false }));
+    }
+    catch {
+        return null;
+    }
+    const latencyMs = performance.now() - t0;
+    const canonicalPrompt = (raw.canonicalPrompt ?? '').trim();
+    if (!canonicalPrompt)
+        return null;
+    const brief = {
+        canonicalPrompt,
+        vision: (raw.vision ?? '').trim(),
+        taskChecklist: sanitizeList(raw.taskChecklist),
+        milestones: sanitizeList(raw.milestones),
+        testingPlan: sanitizeList(raw.testingPlan),
+        e2ePlan: sanitizeList(raw.e2ePlan),
+        securityConcerns: sanitizeList(raw.securityConcerns),
+        openQuestions: sanitizeList(raw.openQuestions),
+        confidence: normalizeConfidence(raw.confidence),
+    };
+    inMemLRU.set(key, brief);
+    if (inMemLRU.size > MAX_LRU) {
+        const first = inMemLRU.keys().next().value;
+        if (typeof first === 'string')
+            inMemLRU.delete(first);
+    }
+    disk.set(key, brief);
+    persistDiskCache().catch(() => { });
+    return { brief, cacheHit: false, latencyMs };
+}
+export function generateProductBrief(args) {
+    return (testOverride ?? generateProductBriefImpl)(args);
+}
+//# sourceMappingURL=product-brief.js.map

package/dist/lib/product-brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-brief.js","sourceRoot":"","sources":["../../src/lib/product-brief.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEpD,MAAM,SAAS,GAAG,SAAS,CAAA;AAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAA;AACnE,MAAM,OAAO,GAAG,GAAG,CAAA;AA6BnB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAA;AAChD,IAAI,SAAS,GAAqC,IAAI,CAAA;AACtD,IAAI,YAAY,GAAmB,IAAI,CAAA;AAEvC,MAAM,UAAU,cAAc,CAAC,EAAkB;IAC/C,YAAY,GAAG,EAAE,CAAA;AACnB,CAAC;AAED,SAAS,OAAO,CAAC,MAAc,EAAE,OAAsB;IACrD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,UAAU,MAAM,KAAK,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACnG,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,IAAI,SAAS;QAAE,OAAO,SAAS,CAAA;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiC,CAAA;QAC3D,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,SAAS,GAAG,IAAI,GAAG,EAAE,CAAA;IACvB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,KAAK,UAAU,gBAAgB;IAC7B,IAAI,CAAC,SAAS;QAAE,OAAM;IACtB,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9C,MAAM,GAAG,GAAiC,EAAE,CAAA;IAC5C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,SAAS;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAC1C,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC9D,CAAC;AAED,+EAA+E;AAC/E,4EAA4E;AAC5E,0EAA0E;AAC1E,iDAAiD;AACjD,MAAM,UAAU,GAAG,EAAE,CACnB;IACE,kuBAAkuB;IACluB,qBAAqB;IACrB,0BAA0B;IAC1B,6BAA6B;IAC7B,KAAK;IACL,0BAA0B;IAC1B,iBAAiB;IACjB,0BAA0B;IAC1B,uBAAuB;IACvB,wBAAwB;IACxB,oBAAoB;IACpB,6BAA6B;IAC7B,0BAA0B;IAC1B,mBAAmB;CACpB,CAAC,IAAI,CAAC,EAAE,CAAC,CACX,CAAA;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAA;IACpE,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACxB,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACxB,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAC3D,CAAC;AAED,KAAK,UAAU,wBAAwB,CAAC,EACtC,MAAM,EACN,OAAO,GAAG,IAAI,EACd,aAAa,EACb,iBAAiB,GACP;IACV,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEpC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAA;IAE5D,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACzB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAA;IACxD,CAAC;IAED,IAAI,CAAC,cAAc,EAAE;QAAE,OAAO,IAAI,CAAA;IAElC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAC5B,IAAI,GAA0B,CAAA;IAC9B,IAAI,CAAC;QACH,GAAG,GAAG,CAAC,MAAM,UAAU,CAAC,OAAO,CAC7B,GAAG,EACH;YACE,UAAU,EAAE,MAAM;YAClB,aAAa;YACb,iBAAiB;SAClB,EACD,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAA0B,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,CAAA;IAExC,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC1D,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAA;IAEjC,MAAM,KAAK,GAAiB;QAC1B,eAAe;QACf,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACjC,aAAa,EAAE,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC;QAC9C,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC;QACxC,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC;QAC1C,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;QAClC,gBAAgB,EAAE,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACpD,aAAa,EAAE,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC;QAC9C,UAAU,EAAE,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC;KAChD,CAAA;IAED,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACxB,IAAI,QAAQ,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;QAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACvD,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACpB,gBAAgB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAElC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,OAAO,CAAC,YAAY,IAAI,wBAAwB,CAAC,CAAC,IAAI,CAAC,CAAA;AACzD,CAAC"}

package/dist/lib/prompt-planner.d.ts

@@ -1,9 +1,13 @@
 import type { PromptPlan } from '../types.js';
-export declare function planPrompt({ prompt, partner, forceKind, familyHint, }: {
+export declare function planPrompt({ prompt, partner, forceKind, familyHint, rewriter, brief, }: {
     prompt: string;
     partner?: string | null;
     /** Force the result to be 'starter' or 'workspace'. Used by scaffold-builder for curated templates. */
     forceKind?: 'starter' | 'workspace' | null;
     /** Hint the family directly. Skips family scoring, only detects capabilities + slots. */
     familyHint?: string | null;
+    /** Narrow rewriter: LLM produces a short canonical prompt for re-planning. Back-compat flag; prefer `brief`. */
+    rewriter?: boolean;
+    /** Rich product brief: one LLM call produces canonical prompt + vision + tasks + milestones + tests + e2e + security + openQuestions. Attached to the returned plan via .brief for downstream context-pack use. */
+    brief?: boolean;
 }): Promise<PromptPlan>;