@tangle-network/starter-foundry 0.5.4 → 0.7.2

package/dist/lib/planner/signals.js

@@ -17,7 +17,19 @@ export const IMPLICIT_UI_FAMILIES = new Set(['react-vite-ts', 'nextjs-ts', 'full
 // React families that get unconditional tailwind + shadcn attachment.
 // Keep in sync with IMPLICIT_UI_FAMILIES — any addition here should also
 // go there.
-export const REACT_FAMILIES = new Set(['react-vite-ts', 'nextjs-ts', 'fullstack-ts', 'remix-ts']);
+export const REACT_FAMILIES = new Set([
+    'react-vite-ts',
+    'nextjs-ts',
+    'fullstack-ts',
+    'remix-ts',
+    // S+ tier new React+Vite families — auto-attach tailwind + shadcn so
+    // agents don't have to `pnpm add` them every time. Signal from
+    // .evolve/buildout-analysis.json topAddedPackages (17× lucide-react,
+    // 14× tailwindcss, 9× clsx) showed these utilities are near-universal
+    // across real agent work.
+    'electron-native-os',
+    'multimodal-agent',
+]);
 // Chat-first archetype: product's primary surface is a conversational thread,
 // not a data-heavy dashboard. Matches phrases where the user interacts by
 // talking to the AI (assistant / tutor / companion) or the product IS a chatbot.
@@ -242,6 +254,40 @@ export const VIDEO_ARCHETYPE_SIGNALS = [
     'peer-to-peer',
     'jam session',
 ];
+// SaaS archetypes — multi-customer products where tenant isolation is
+// non-negotiable. When the prompt describes a SaaS shape (teams, orgs,
+// workspaces, subscription tiers, customer accounts), the scaffold must
+// ship capability:multi-tenancy by default so agents don't bolt it on
+// after deploy (tenant leakage is a P0 bug, not a nice-to-have).
+export const SAAS_ARCHETYPE_SIGNALS = [
+    'saas',
+    'saas app',
+    'saas product',
+    'saas platform',
+    'saas tool',
+    'team management',
+    'teams and members',
+    'organization',
+    'organizations',
+    'workspace',
+    'workspaces',
+    'customer accounts',
+    'customer portal',
+    'subscription tiers',
+    'subscription plans',
+    'billing plans',
+    'usage-based billing',
+    'per-seat billing',
+    'tenant',
+    'tenants',
+    'multi-tenant',
+    'multi tenancy',
+    'per-tenant',
+    'tenant isolation',
+    'workspace-level',
+    'org-level',
+    'account-scoped',
+];
 // Admin/operations archetypes — internal SaaS tools with bulk management,
 // document workflows, role-based access, approval flows. These want layout-admin
 // alongside layout-dashboard.
@@ -267,6 +313,109 @@ export const ADMIN_ARCHETYPE_SIGNALS = [
     'hr tool',
     'admin panel',
 ];
+// Code-editor surface: AI code assistants, prompt playgrounds, markdown
+// editors with code blocks, SQL query builders, config UIs. Triggers
+// capability:code-editor attachment on web-producing families.
+export const CODE_EDITOR_ARCHETYPE_SIGNALS = [
+    'code editor',
+    'query editor',
+    'sql editor',
+    'prompt playground',
+    'code playground',
+    'syntax highlight',
+    'syntax highlighting',
+    'markdown editor',
+    'config editor',
+    'schema editor',
+    'json editor',
+    'javascript editor',
+    'typescript editor',
+    'codemirror',
+    'code dashboard',
+    'strategy editor',
+    '"strategy" editor',
+    'strategy builder',
+    'script editor',
+    'rules editor',
+    'dsl editor',
+    'embedded editor',
+    'policy editor',
+    'workflow editor',
+    'expression editor',
+    // Trading-bot / quant phrasings — agent-trading scenario shipped
+    // codemirror 5x because the "TypeScript snippet" editor surface wasn't
+    // recognized as needing capability:code-editor. Add the realistic
+    // domain language so future trading/algorithm/strategy prompts attach.
+    'typescript snippet',
+    'typescript snippet editor',
+    'algorithm editor',
+    'algo editor',
+    'algorithm playground',
+    'trading strategy',
+    'on-chain strategy',
+    'inline editor',
+    'code snippet editor',
+    'live editor',
+];
+// Date-heavy products — scheduling, calendar, timeline, booking, deadline
+// tracking. Triggers capability:date-utils attachment on web-producing
+// families. Kept narrow: "dashboard" isn't date-heavy, but "scheduling
+// dashboard" is.
+//
+// Governance/DAO phrasings surface here because every proposal UI shows
+// "ends at", "voting period", "pending → active → executed" — all
+// time-relative renders that need date-fns. Observed in dao-proposals
+// scenarios (3× date-fns install cluster, 2026-04-22 trace corpus).
+export const DATE_HEAVY_ARCHETYPE_SIGNALS = [
+    'calendar',
+    'scheduling',
+    'booking',
+    'appointment',
+    'timeline',
+    'deadline',
+    'date range',
+    'date picker',
+    'recurring event',
+    'relative time',
+    'event scheduler',
+    'reminders',
+    'due date',
+    'time tracking',
+    // Governance archetypes — proposals have state transitions on timelines,
+    // voting periods with "ends at" relative rendering, execution queues.
+    'dao',
+    'governance',
+    'proposal',
+    'voting period',
+    'quorum',
+    'governor bravo',
+    'on-chain governance',
+    'snapshot vote',
+];
+// Browser-native ZK: products where proofs are generated client-side
+// (snarkjs + circom) rather than on a Rust prover service. Mixers, private
+// voting, anonymous credentials, commitment-nullifier flows. Triggers
+// capability:zk-browser attachment on web-producing families.
+export const ZK_BROWSER_ARCHETYPE_SIGNALS = [
+    'mixer',
+    'privacy-preserving mixer',
+    'private voting',
+    'anonymous voting',
+    'anonymous credential',
+    'nullifier',
+    'commitment preimage',
+    'merkle root display',
+    'zk proof',
+    'zk-snark',
+    'zero-knowledge proof',
+    'circom',
+    'zk mixer',
+    'verify your note',
+    'downloadable note',
+    'stealth address',
+    'private deposit',
+    'private withdraw',
+];
 // Auth/portal archetypes — client portals, tenant portals, customer-specific
 // views with login flows.
 export const AUTH_ARCHETYPE_SIGNALS = [
@@ -279,6 +428,59 @@ export const AUTH_ARCHETYPE_SIGNALS = [
     'patient portal',
     'secure login',
 ];
+// Multi-page archetypes — products that have more than one view, needing a
+// client-side router on Vite/Electron/Tauri hosts (Next.js / Remix /
+// SvelteKit have file-based routers and don't get this capability).
+// Observed in dao-proposals (3× react-router-dom install cluster) +
+// expected in any list-detail pattern.
+export const ROUTING_ARCHETYPE_SIGNALS = [
+    'proposal list',
+    'proposal detail',
+    'list and detail',
+    'multi-page',
+    'nested routes',
+    'nested layouts',
+    'dashboard with pages',
+    'admin panel with pages',
+    'portal with multiple views',
+    'navigation menu',
+    'deep linking',
+    'route params',
+    'url params',
+    'tabs with pages',
+];
+// ZK circuit DSLs / frameworks that LAYER onto existing families. zkVMs
+// themselves (RISC Zero, SP1, Arkworks) are separate families — they
+// route through planPrompt's family selection, not via capability signals.
+//
+// Naming: all end in _ARCHETYPE_SIGNALS so signal-manifest parity test
+// catches any drift between these arrays and the capability manifests'
+// tieredKeywords.archetypes lists.
+export const ZK_NOIR_ARCHETYPE_SIGNALS = [
+    'noir',
+    'aztec noir',
+    'barretenberg',
+    'nargo',
+    'ultrahonk',
+    'honk prover',
+    'aztec noir circuit',
+    'build a noir program',
+    'noir zk app',
+    'nargo new',
+    'ultrahonk verifier',
+];
+export const ZK_GNARK_ARCHETYPE_SIGNALS = [
+    'gnark',
+    'consensys gnark',
+    'gnark circuit',
+    'groth16 gnark',
+    'plonk gnark',
+    'gnark prover in go',
+    'consensys gnark circuit',
+    'gnark groth16 service',
+    'zk rollup sequencer in go',
+    'go-native zk proof',
+];
 // Single-surface families that never become workspaces.
 export const SINGLE_LANE_SIGNALS = [
     'expo', 'react native', 'mobile app', 'ios app', 'android app',

package/dist/lib/planner/signals.js.map

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

package/dist/lib/planner/zk-preferences.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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 declare function pickZkCapability(text: string, group: string): string | null;

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/promoter-gates.d.ts

@@ -0,0 +1,114 @@
+export type GateStatus = 'pass' | 'fail' | 'skipped';
+export interface BaseGateResult {
+    gate: string;
+    status: GateStatus;
+    message?: string;
+    reason?: string;
+}
+export interface DeclaredDepUsedResult extends BaseGateResult {
+    gate: 'declared-dep-used';
+    /** All packageDeps keys that had no matching import/require in any emitted file. Populated on fail. */
+    unusedDeps?: string[];
+    /** Files searched for import/require (relative paths). Populated always so the scorecard shows search scope. */
+    filesSearched?: string[];
+}
+export interface ScaffoldRunsResult extends BaseGateResult {
+    gate: 'scaffold-runs';
+    reason?: string;
+    stderr?: string;
+    /** Port the scaffold was booted on (pass case only). */
+    port?: number;
+    /** Handle to the still-running process so gate 3 can reuse it. Only set on pass. */
+    process?: {
+        pid: number;
+        kill: () => void;
+    };
+}
+export interface EvalScoresResult extends BaseGateResult {
+    gate: 'eval-scores';
+    aggregate?: number;
+    threshold?: number;
+    failing?: string[];
+    reason?: string;
+}
+/**
+ * Walk every emitted file in the composed output. For each declared
+ * package (dependencies + devDependencies + peerDependencies on the
+ * capability/family manifest), assert at least one file contains
+ * `import ... from '<pkg>'` or `require('<pkg>')`.
+ *
+ * Handles scoped packages (`@scope/name`) — the regex is built from
+ * escaped package names, so the `@` and `/` don't trip the pattern.
+ *
+ * Search scope: the ENTIRE composed output, not just the capability's
+ * own files/. Rationale: the motivating case is a capability declaring
+ * a dep whose consumer sits one layer up (family framework layer uses
+ * it; the capability-under-audit just declares it because it composes
+ * alongside). Limiting to the capability's own files would false-fail
+ * those valid cases. A broken declaration is still caught — the scope
+ * widening preserves correctness while accepting a superset.
+ */
+export declare function checkDeclaredDepUsed(args: {
+    manifest: Record<string, unknown>;
+    composedDir: string;
+}): DeclaredDepUsedResult;
+export interface ScaffoldRunsOptions {
+    /** Override port — defaults to manifest `defaults.port` then 3100. */
+    port?: number;
+    /** Max time to wait for /health 2xx. Defaults to 20s. */
+    readyTimeoutMs?: number;
+    /** Skip cleanup of the process — gate 3 will reuse it. */
+    keepProcess?: boolean;
+}
+/**
+ * Boot the composed scaffold's `start` script, wait for /health 2xx on
+ * PORT, then either SIGTERM or return a handle for gate 3 to reuse.
+ *
+ * Language dispatch:
+ *   - TS/JS: checks package.json for a `start` script. Runs
+ *     `pnpm start` with PORT=<port>, waits on /health.
+ *   - Other: returns skipped with `reason: 'unsupported-lang'`. See
+ *     TODO below — second iteration will add language branches for
+ *     rust/python/go.
+ *
+ * Skip contract: we DO NOT silently pass. When there's no `start`
+ * script, we emit `status: 'skipped'` with `reason: 'no-start-script'`.
+ * The scorecard can detect "scaffold has an agent surface but didn't
+ * declare a boot contract" from a higher level.
+ */
+export declare function checkScaffoldRuns(args: {
+    composedDir: string;
+    manifest: Record<string, unknown>;
+    options?: ScaffoldRunsOptions;
+}): Promise<ScaffoldRunsResult>;
+export interface EvalScoresOptions {
+    /** Port where the agent is already listening (from gate 2). */
+    port: number;
+    /** Max time for the eval harness to finish. */
+    timeoutMs?: number;
+}
+/**
+ * If the scaffold composed `capability:agent-eval`, run its own
+ * `tests/eval/run-eval.mjs --no-spawn --base <url>` against the
+ * already-booted agent (gate 2 hands the port in). Read
+ * `.evolve/eval/latest.json`, assert aggregate ≥ manifest threshold
+ * (fall back to 0.7).
+ *
+ * Why reuse the booted process from gate 2: the eval runner's default
+ * lifecycle spawns the agent itself, but we already have it running.
+ * Passing `--no-spawn` tells it to skip spawn and talk to `--base`.
+ * This matches how a user would run `run-eval.mjs` against a local
+ * dev server, which is the scenario we're dogfooding.
+ *
+ * Skip conditions:
+ *   - scaffold did not compose capability:agent-eval (check
+ *     composedLayers arg).
+ *   - run-eval.mjs is missing (defensive — should not happen if the
+ *     capability composed).
+ */
+export declare function checkEvalScores(args: {
+    composedDir: string;
+    manifest: Record<string, unknown>;
+    composedLayers: string[];
+    options: EvalScoresOptions;
+}): Promise<EvalScoresResult>;