@golden-frijoles/kit 1.3.0 → 1.5.0

package/dist/lib/config-registry.mjs

@@ -44,6 +44,19 @@ export const REGISTRY = Object.freeze([
     question:
       'An account adds flags you can roll out and turn off, each bet measured on its read date, every product in one place and an outcome report you can send. Sign in now (recommended: frijoles login, then frijoles init), or later?',
   },
+  {
+    // one-bet-wired D6 — the one place an account is suggested outside setup: refine's Measure question, when the
+    // founder wants to know if a feature worked and is not signed in. Asked once per project; the answer is kept here.
+    key: 'measure.signIn',
+    module: 'Measure',
+    // Asked by refine's Measure step, never by setup, and only when the founder is signed out: `never-yet` keeps
+    // `frijoles doctor` from reporting Measure as unconfigured for everyone (verifier, #341).
+    askWhen: 'never-yet',
+    default: null,
+    choices: ['later', 'now'],
+    question:
+      'Measuring needs a Golden Frijoles account: it serves the flag and counts who used it. Sign in now (opens your browser once), or later (the bet is saved here either way)?',
+  },
   {
     key: 'board.sink',
     module: 'Plan',

package/dist/lib/config.mjs

@@ -45,6 +45,7 @@ export const SECTIONS = Object.freeze([
   'routines',
   'intent',
   'lint',
+  'measure', // one-bet-wired D6: refine's Measure step (measure.signIn)
 ]);
 
 /**

package/dist/lib/cross-agent-cli.mjs

@@ -54,10 +54,10 @@ export const AGENT_BIN = {
 // Harmless here since AGY_MODEL/AGY_FALLBACK_MODEL below are always valid, listed model names (checked via
 // `agy models`), but it means a future typo in either constant would silently review with the WRONG model
 // instead of failing loud — watch for that if either constant is ever edited.
-// agy-doctor: last verified 2026-10-09 against 1.3.2.
+// agy-doctor: last verified 2026-10-10 against 1.3.3.
 //   ^ machine-managed marker — `node scripts/cross-agent-doctor.mjs agy --fix` rewrites it (with the constant
 //   below) after a green live contract probe. Don't hand-edit the marker's shape.
-export const AGY_PINNED = '1.3.2';
+export const AGY_PINNED = '1.3.3';
 
 // agy's `--print` mode prints NOTHING unless `--model` names a model — and, crucially, it ALSO prints
 // nothing (exit 0, empty stdout — the error lands only in agy's log, see --log-file) when the model is

package/dist/lib/roadmap-contract.mjs

@@ -162,6 +162,31 @@ export function validateFlagKey(fm) {
 // grounded-bets D1 — `grounded:` is the founder's word at Stage 1.5: true (traced to a North Star input), false (funded
 // anyway, and `grounded_reason` says why), or absent/null (a Bug, a Chore, or an epic refined before it existed).
 // Whether a bet COUNTS as grounded is derived from its target (bets-grounded.mjs, D2), never from this field alone.
+// one-bet-wired D1 — a bet's measurement: what its flag funnel reads. Optional as a whole; once any field is set it
+// needs a flag and an adoption event, the only segment is `everyone` (named segments are tars-segments), and the window
+// is 1–90 whole days. Event names are tokens: what the SDK sends.
+export const BET_FIELDS = ['target_segment', 'adopted_event', 'retained_event', 'retention_days', 'satisfied_event'];
+export const BET_SEGMENTS = ['everyone'];
+const EVENT_NAME = /^[A-Za-z0-9_.:$-]{1,200}$/;
+
+/** The bet's measurement fields → offenses (`contract-bet-invalid`). All absent is fine. */
+export function validateBet(fm) {
+  const offenses = [];
+  const bad = (detail) => offenses.push({ rule: 'contract-bet-invalid', detail });
+  const has = (key) => fm[key] !== undefined && fm[key] !== null;
+  if (!BET_FIELDS.some(has)) return offenses;
+  if (!has('flag_key')) bad('a bet with measurement needs a flag_key (the flag whose funnel it reads)');
+  if (!has('adopted_event')) bad('a bet with measurement needs an adopted_event (what counts as adopting)');
+  if (has('target_segment') && !BET_SEGMENTS.includes(fm.target_segment))
+    bad(`target_segment: "${fm.target_segment}" is not one of ${BET_SEGMENTS.join(' | ')} (named segments come with tars-segments)`);
+  for (const key of ['adopted_event', 'retained_event', 'satisfied_event'])
+    if (has(key) && !(typeof fm[key] === 'string' && EVENT_NAME.test(fm[key])))
+      bad(`${key}: "${fm[key]}" is not an event name (letters, digits, _ . : $ -)`);
+  if (has('retention_days') && !(Number.isInteger(fm.retention_days) && fm.retention_days >= 1 && fm.retention_days <= 90))
+    bad(`retention_days: "${fm.retention_days}" is not a whole number of days from 1 to 90`);
+  return offenses;
+}
+
 /** `grounded:` as a boolean: the frontmatter readers keep a bare `true` as the string "true". Null when absent or neither. */
 export function groundedValue(v) {
   if (v === true || v === 'true') return true;
@@ -401,6 +426,7 @@ export function validateEpicFrontmatter(parsed, ctx = {}) {
   offenses.push(...validateResultFields(fm));
   offenses.push(...validateFlagKey(fm));
   offenses.push(...validateGrounded(fm));
+  offenses.push(...validateBet(fm));
   offenses.push(...validateLockedAt(fm));
   if (isInt(fm.sprints_total) && isInt(ctx.sprintCount) && fm.sprints_total !== ctx.sprintCount)
     offenses.push({

package/dist/roadmap-extract.mjs

@@ -178,6 +178,22 @@ export function flagFields(fm, readme) {
   return { flag_key: !blank && FLAG_KEY_RE.test(raw) ? raw : null, flag_note: note || null };
 }
 
+/**
+ * one-bet-wired D1 — the bet's measurement as pushed: each field as written when it is well-formed, else null (the
+ * contract names a bad one). Defaults are the reader's (an absent window is 7 days), never written here.
+ */
+export function betFields(fm) {
+  const token = (v) => (typeof v === 'string' && /^[A-Za-z0-9_.:$-]{1,200}$/.test(v.trim()) ? v.trim() : null);
+  const days = Number(fm.retention_days);
+  return {
+    target_segment: fm.target_segment === 'everyone' ? 'everyone' : null,
+    adopted_event: token(fm.adopted_event),
+    retained_event: token(fm.retained_event),
+    retention_days: Number.isInteger(days) && days >= 1 && days <= 90 ? days : null,
+    satisfied_event: token(fm.satisfied_event),
+  };
+}
+
 /**
  * grounded-bets D9 — the founder's grounding, as recorded at Stage 1.5: `grounded` true | false | null and, when false,
  * `grounded_reason`. Anything else is null (the contract names it); the reason travels only with false.
@@ -648,6 +664,7 @@ export function buildRows({
       ...resultFields(epicFm, stage === 'Shipped' ? statusDay : null),
       ...flagFields(epicFm, readme),
       ...groundedFields(epicFm),
+      ...betFields(epicFm),
     });
 
     // Sprint rows (one per sprint-N.md), related to the Epic by slug. boardSprints already carries

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@golden-frijoles/kit",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "The scripts the Golden Frijoles skills run, packaged so they work in any repo: planning, build-order, reporting and verification rails. Zero dependencies.",
   "type": "module",
   "bin": {