shakers-cli 0.14.2 → 0.16.0

package/src/share.js

@@ -33,7 +33,7 @@ const {
 
 /* ---------- minimal HTTP utility (no dependencies) ---------- */
 
-// POSTs `body` to the ONE backend (talents-ai-score, ADR-042 — the PRIMARY -> FALLBACK chain is retired), via src/backend-request.js.
+// POSTs `body` to the ONE backend (the PRIMARY -> FALLBACK chain is retired), via src/backend-request.js.
 async function requestJsonBackend(endpoint, body, { timeoutMs = 15000, idempotencyKey = null } = {}) {
   const { status, raw, backend } = await requestBackend({ endpoint, body, timeoutMs, idempotencyKey });
   let json = null;
@@ -53,7 +53,7 @@ async function autoShare(report, maturity, { root, bypassThrottle = false } = {}
   if (!state.email) {
     return { ok: false, skipped: true, reason: 'no-email' };
   }
-  // ADR-006: never SEND under an email whose ownership wasn't proven — every
+  // Never SEND under an email whose ownership wasn't proven — every
   // profile, `external` included (legal requirement), must have verified.
   if (state.emailVerified === false) {
     return { ok: false, skipped: true, reason: 'email-unverified' };
@@ -92,14 +92,14 @@ async function autoShare(report, maturity, { root, bypassThrottle = false } = {}
     return { ok: false, skipped: false, reason: 'rate-limited' };
   }
   if (res.status === 503) {
-    // Generic "service unavailable" from the server (ADR-011 retires the
-    // server-side kill switch that used to be the main 503 cause).
+    // Generic "service unavailable" from the server (the retired
+    // server-side kill switch used to be the main 503 cause).
     return { ok: false, skipped: false, reason: 'service-unavailable' };
   }
   return { ok: false, skipped: false, reason: `http-${res.status}` };
 }
 
-/* ---------- certification persistence (skill-code-certification, issue 005) ---------- */
+/* ---------- certification persistence ---------- */
 
 // Persists the analyzed certification result if (and only if) consent is granted.
 async function shareCertification(items, { repository = null, commitRange = null, toolVersion = null, superadminToken = null, root = null } = {}) {
@@ -112,7 +112,7 @@ async function shareCertification(items, { repository = null, commitRange = null
   if (!state.email) {
     return { ok: false, skipped: true, reason: 'no-email' };
   }
-  // ADR-006 (mirror of autoShare): don't persist under an unverified email.
+  // Don't persist under an unverified email.
   if (state.emailVerified === false) {
     return { ok: false, skipped: true, reason: 'email-unverified' };
   }
@@ -132,7 +132,7 @@ async function shareCertification(items, { repository = null, commitRange = null
 
   let res;
   try {
-    // ADR-027: forward the superadmin session token so the backend stamps test_origin=true (server-authoritative, non-prod only).
+    // Forward the superadmin session token so the backend stamps test_origin=true (server-authoritative, non-prod only).
     const body = { email: state.email, payload };
     if (superadminToken) body.superadminToken = superadminToken;
     // Idempotency-Key (three-way security review, cross-repo): ONE key per

package/src/signup-client.js

@@ -4,7 +4,7 @@ const { postJsonWithTimeout, extractSetCookie } = require('./backend-request');
 const { SESSION_COOKIE_NAME } = require('./auth-client');
 const { toUpperLang } = require('./lang-codes');
 
-// Register a talent via the Hub's better-auth email engine, in two steps (owner decision, supersedes ADR-031 for the email path — WEB-login parity): 1.
+// Register a talent via the Hub's better-auth email engine, in two steps (WEB-login parity): 1.
 
 const DEFAULT_TIMEOUT_MS = 30000;
 

package/src/signup-copy.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// Talent-facing copy of the MCP sign-up (ticket 39540, UX review 39574): fixed text the AI shows word for word, in the talent's language.
+// Talent-facing copy of the MCP sign-up: fixed text the AI shows word for word, in the talent's language.
 
 const SIGNUP_LANGUAGES = ['es', 'en', 'it', 'pt'];
 

package/src/skills-client.js

@@ -2,7 +2,7 @@
 
 const { postJsonWithTimeout } = require('./backend-request');
 
-// Talent-skills client (talents-ai-score, ADR-054/055 — `start`'s "Añadir skills" route, src/start-add-skills.js).
+// Talent-skills client (`start`'s "Añadir skills" route, src/start-add-skills.js).
 
 const DEFAULT_TIMEOUT_MS = 20000;
 

package/src/start-add-agents.js

@@ -24,7 +24,7 @@ const { reasonCopy, pickPortfolios } = require('./start-add-skills');
 const { askWithDefault } = require('./start-add-portfolio');
 const { styleQuestion, styleSuccess } = require('./ansi');
 
-// `start`'s "Add agent to profile" route (talents-ai-score Phase 2), mirror of src/start-add-portfolio.js: the IA pre-drafts, the Talent edits.
+// `start`'s "Add agent to profile" route, mirror of src/start-add-portfolio.js: the IA pre-drafts, the Talent edits.
 
 const MAX_DEFINITION_CHARS = 4000;
 
@@ -68,7 +68,7 @@ async function chooseAgent({ ask, stdinIsTTY, agents, c, input, output }) {
   return idx === null ? null : agents[idx];
 }
 
-// Step 4 — the two AI-drafted fields, consent-gated (ADR-052) before any egress.
+// Step 4 — the two AI-drafted fields, consent-gated before any egress.
 async function resolveAgentFields({ ask, catalog, c, stdinIsTTY, agent, accessToken, preAccepted = false }) {
   const freeText = async () => ({
     whatItDoes: await askFreeText(ask, c.agentWhatItDoesFreeTextPrompt),

package/src/start-add-portfolio.js

@@ -8,7 +8,7 @@ const {
   getPortfoliosListEndpoint, getPortfoliosDeclareEndpoint, getPortfolioDraftDescriptionEndpoint,
   getSkillsResolveMatchedEndpoint, getSkillsResolveAddableEndpoint, getSkillsDeclareEndpoint,
 } = require('./config');
-const { requestListPortfolios, requestDeclarePortfolio, requestDraftDescription } = require('./portfolio-client');
+const { requestListPortfolios, requestDeclarePortfolio, requestDraftDescription, normalizeDomain } = require('./portfolio-client');
 const { requestResolveAddableSkills: requestResolveMatchedSkills, requestResolveAddableSkills } = require('./skills-client');
 const { getRemoteUrl, getCommitDateRange } = require('./portfolio-git-info');
 const { confirmDisclaimerAcceptance } = require('./certify-disclaimer');
@@ -21,7 +21,7 @@ const { palette, styleQuestion, styleSuccess } = require('./ansi');
 // Only `dim`/`reset` for the numbered fallback's descriptions — the exact treatment bin/start.js's own menu and bin/certify.js's picker give theirs.
 const ANSI = palette({ reset: '\x1b[0m', dim: '\x1b[2m' });
 
-// `start`'s "Add project to portfolio" route (talents-ai-score, ADR-059).
+// `start`'s "Add project to portfolio" route.
 
 const MAX_README_CHARS = 4000;
 const MAX_PACKAGE_DESCRIPTION_CHARS = 500;
@@ -56,15 +56,6 @@ async function askFreeText(ask, promptText) {
   return String(await ask(styleQuestion(promptText))).trim();
 }
 
-function normalizeDomain(raw) {
-  let s = String(raw || '').trim().toLowerCase();
-  if (!s) return '';
-  s = s.replace(/^https?:\/\//, '');
-  s = s.split('/')[0].split('?')[0].split('#')[0];
-  s = s.replace(/^www\./, '');
-  return s;
-}
-
 // Step 2 — Type.
 function typeOptions(c) {
   return [
@@ -345,7 +336,7 @@ async function runAddPortfolio({
 
   if (declared.ok) {
     process.stdout.write(`\n  ${styleSuccess(c.portfolioDeclaredSuccess(title))}\n\n`);
-    // OPT-IN (dueño, 2026-08-12): offer the REST of the detected skills for the Talent's PROFILE, now that the portfolio itself (and whatever skillIds it carried) is safely declared.
+    // OPT-IN: offer the REST of the detected skills for the Talent's PROFILE, now that the portfolio itself (and whatever skillIds it carried) is safely declared.
     await offerAddableSkillsForProfile({ ask, catalog, c, technologies, session, stdinIsTTY, input, output, runLogin });
     return;
   }
@@ -383,6 +374,5 @@ module.exports = {
   askWithDefault,
   chooseType,
   typeOptions,
-  normalizeDomain,
   offerAddableSkillsForProfile,
 };

package/src/start-add-skills.js

@@ -9,7 +9,7 @@ const { runInteractiveMultiSelect } = require('./interactive-select');
 const { loadAuthSession, sessionStatus } = require('./auth-session-store');
 const { styleSuccess } = require('./ansi');
 
-// `start`'s "Añadir skills" route (talents-ai-score, ADR-054/055).
+// `start`'s "Añadir skills" route.
 
 // Maps a technical failure reason to the localized `start.errorReason` copy.
 function reasonCopy(reason, c) {
@@ -255,6 +255,6 @@ module.exports = {
   declareAll,
   printProfileBoost,
   offerRelateToPortfolios,
-  // Exported for src/start-add-agents.js's own relate step (ADR-041): the multi-select over the Talent's portfolios, reused verbatim.
+  // Exported for src/start-add-agents.js's own relate step: the multi-select over the Talent's portfolios, reused verbatim.
   pickPortfolios,
 };

package/src/stdin-ask.js

@@ -49,14 +49,14 @@ function createLineQueueAsk(writeQuestion) {
 
 // `onInterrupt` (optional): a Ctrl-C (SIGINT) handler for a TTY.
 function createStdinAsk({ onInterrupt } = {}) {
-  // `rl` is re-createable (issue 102), not a `const`.
+  // `rl` is re-createable, not a `const`.
   let rl = null;
   let ended = false;
   let suspending = false;
   let currentPrompt = '';
 
   const { ask, pushLine, markEnded, drain } = createLineQueueAsk((question) => {
-    // Long-answer wrap bug (skill-code-certification, certify agents): in a TTY, `readline` runs in terminal mode and redraws the current line on every keystroke (wrap, cursor).
+    // Long-answer wrap bug (certify agents): in a TTY, `readline` runs in terminal mode and redraws the current line on every keystroke (wrap, cursor).
     const text = `  ${question} `;
     const lastNewline = text.lastIndexOf('\n');
     if (lastNewline >= 0) {
@@ -98,7 +98,7 @@ function createStdinAsk({ onInterrupt } = {}) {
     r.close();
     suspending = false;
   }
-  // SECRETS DO NOT ECHO (issue 102).
+  // SECRETS DO NOT ECHO.
   ask.secret = async (question) => {
     if (!canPromptSecretly(process.stdin)) return ask(question);
     process.stdout.write(`  ${question} `);

package/src/strip-internal-comments.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// Our comments do not travel in the talent's shareable report (issue 098).
+// Our comments do not travel in the talent's shareable report.
 
 // `<!-- … -->`, including multi-line.
 const HTML_COMMENT_RE = /<!--[\s\S]*?-->/g;

package/src/tech-detector.js

@@ -10,7 +10,7 @@ const {
   isExcludedWalkPath,
 } = require('./scan-exclusions');
 
-// Monorepo support (skill-code-certification, issue 008): manifests are discovered RECURSIVELY under `root`, not just at the top level.
+// Monorepo support: manifests are discovered RECURSIVELY under `root`, not just at the top level.
 
 // Exact dependency-name -> canonical framework/library name (npm + pip).
 const EXACT_FRAMEWORK_MAP = {
@@ -202,7 +202,7 @@ function fromPyprojectTomlFile(filePath) {
   return names;
 }
 
-// Manifest filename -> reader (skill-code-certification, issue 008).
+// Manifest filename -> reader.
 const MANIFEST_READERS = {
   'package.json': fromPackageJsonFile,
   'requirements.txt': fromRequirementsTxtFile,

package/src/templates/report-sheet.html

@@ -146,7 +146,7 @@ header.top{
 .col-head{display:flex; align-items:baseline; gap:10px; margin:2px 0 14px}
 .col-head h2{margin:0; font-size:13px; letter-spacing:.12em; text-transform:uppercase; color:var(--fg-muted); font-weight:650}
 .col-head .dot{width:6px;height:6px;border-radius:50%; background:var(--accent)}
-/* Column note (issue 096): one line under the column head, for copy that has to
+/* Column note: one line under the column head, for copy that has to
    be read before the numbers below it. `.sub` only exists inside `.card`. */
 .col-note{margin:-8px 0 14px; font-size:12.5px; line-height:1.5; color:var(--fg-muted)}
 .col-note b{color:var(--fg); font-weight:650}
@@ -211,16 +211,15 @@ header.top{
 .chip .d{width:7px;height:7px;border-radius:50%; background:var(--accent)}
 
 /* --- Agent tree --------------------------------------------- *
- * ORPHANED BUT OWNED (issue 090, kept for issue 089).
+ * ORPHANED BUT OWNED.
  *
  * Nothing emits `class="agent"` today: `render-sheet.js` builds no agent tree, so
  * this block styles markup that does not exist. It is NOT dead by accident — it
- * came with the approved mockup and it is exactly the material issue 089 (the
- * shareable report has no agents at all) needs, so that design does not have to
- * re-invent the nesting rail. Recovering the markup that used to pair with it:
- * `git show 7fae2c8^:src/render-html.js` (see `agentNodeHtml`/`agentCardsSection`).
+ * came with the approved mockup and it is exactly the material an agent section in
+ * the shareable report (which has no agents at all) needs, so that design does not
+ * have to re-invent the nesting rail.
  *
- * If 089 is dropped or solved another way, this goes with it. What it must not
+ * If that section is dropped or solved another way, this goes with it. What it must not
  * do is sit here with no owner, which is how it got orphaned in the first place.
  * ------------------------------------------------------------ */
 .tree{margin:0; padding:0; list-style:none}
@@ -312,7 +311,7 @@ header.top{
 .tag-na{background:var(--chip-bg); color:var(--fg-muted)}
 .area .icn{width:16px; text-align:center}
 
-/* anchored quotes (issue 054): one block per quote, under its own area row, with
+/* anchored quotes: one block per quote, under its own area row, with
    a left rail whose colour differs per SOURCE. The .qt-k label is the real
    distinction between the two — the rail is lost in greyscale, the label is not. */
 .area-block{display:flex; flex-direction:column; gap:3px}
@@ -401,7 +400,7 @@ __BODY__
   "use strict";
 
   /* Runs ONE independent init/update step in isolation from its siblings
-     (issue 067). `load`, `resize` and the theme toggle each chain several
+     `load`, `resize` and the theme toggle each chain several
      UNRELATED effects (paint the ring, count up the score, slide the tab
      indicator, sync a label…) as a plain sequence of statements. Before this,
      one throwing — as `paintRing()` did pre-066, on ITS OWN unguarded lookup —
@@ -448,9 +447,8 @@ __BODY__
        reached countUp / moveInd / syncExpandLabel — leaving the tab indicator
        unpositioned and the expand-all label unsynced — and the theme toggle, whose
        handler ends in paintRing(), threw on every single click. A broken script
-       fails no test; it silently degrades a report someone is reading. Found in
-       issue 066, when a report with only an agent certification became reachable
-       for the first time. */
+       fails no test; it silently degrades a report someone is reading. Found when
+       a report with only an agent certification first became reachable. */
     if(!fill) return;
     var circumference = 2 * Math.PI * 54; // r=54
     fill.style.strokeDasharray = circumference;
@@ -556,7 +554,7 @@ __BODY__
   });
 
   /* ---- init ---- */
-  // Four UNRELATED effects (issue 067): each isolated so one failing never
+  // Four UNRELATED effects: each isolated so one failing never
   // takes the other three down with it — see safeStep() above for why this,
   // and not a guard on #ringFill/#scoreNum alone, is the fix at this level.
   window.addEventListener('load', function(){

package/src/terminal-agents.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// The agents + activity blocks of the terminal report, extracted from src/render-terminal.js (structure refactor, issue 020).
+// The agents + activity blocks of the terminal report, extracted from src/render-terminal.js.
 
 const { label } = require('./i18n');
 const { buildAgentCardTree } = require('./render-html');
@@ -11,7 +11,7 @@ const { DEFAULT_REPORT_GATE } = require('./report-gating');
 const { c, wrap, summarize } = require('./terminal-format');
 const { detectedToolNames } = require('./detected-tools');
 
-// agents (ADR-016: one line per agent) As SIMPLE as possible: ONE line per agent.
+// agents: As SIMPLE as possible: ONE line per agent.
 
 // AI product (from the source, e.g. Claude Code) shown in place of the LLM model.
 function agentProductLabel(card, t) {
@@ -24,7 +24,7 @@ function agentLine(card, depth, t) {
   const indent = '  '.repeat(depth);
   // Root = a filled bullet; every deeper level = that many stacked down-arrows.
   const marker = depth === 0 ? `${c.success}●${c.reset}` : `${c.primary}${'↓'.repeat(depth)}${c.reset}`;
-  // card.symbolicName is agent-synthesis (LLM, ADR-010) content; card.name is
+  // card.symbolicName is agent-synthesis (LLM) content; card.name is
   // the local, deterministic agent id — only the former needs stripping.
   const title = card.symbolicName
     ? `${sanitizeRenderText(card.symbolicName)} ${c.muted}(${card.name})${c.reset}`
@@ -67,7 +67,7 @@ function agentClassLine(card, depth, t) {
   const catLabel = (category && cc.categories[category]) || sanitizeRenderText(category);
   const levelLabel = (level && cc.levels[level]) || sanitizeRenderText(level);
   const bits = [];
-  // The FLOOR category is dimmed, not accented (issue 120).
+  // The FLOOR category is dimmed, not accented.
   const floor = isFloorCategory(category);
   if (catLabel) {
     bits.push(floor ? `${c.dim}${catLabel}${c.reset}` : `${c.primary}${catLabel}${c.reset}`);
@@ -127,7 +127,7 @@ function printActivity(report, t, p) {
       `  ${c.success}●${c.reset} ${a.workStreams(w.streamCount, w.multiDayStreams, w.maxStreamSpanDays)}`,
     );
   }
-  // Traction (ADR-039): recency-windowed signals from the local scan; agentsOnProfile
+  // Traction: recency-windowed signals from the local scan; agentsOnProfile
   // is hub-only, shown only when the ai-profile preview has already been fetched.
   const tr = tractionParts(report, s, a);
   if (tr.length) p(`  ${c.success}●${c.reset} ${a.tractionLabel}: ${tr.join(' · ')}`);
@@ -157,7 +157,7 @@ function printAgents(report, t, p, gate = DEFAULT_REPORT_GATE) {
     p();
     return;
   }
-  // THE ROOT THE AGENTS HANG FROM (issue 086 — restored, not invented).
+  // THE ROOT THE AGENTS HANG FROM (restored, not invented).
   p(`  ${c.muted}${label(t.html.orchestratorLabel, 'Orchestrator')}${c.reset}`);
   const visited = new Set();
   const walk = (card, depth) => {
@@ -187,11 +187,11 @@ function printAgents(report, t, p, gate = DEFAULT_REPORT_GATE) {
     const names = [...omittedNames].map(sanitizeRenderText).join(', ');
     for (const line of wrap(t.classification.agentsEvalPartial(names, omittedNames.size))) p(`  ${c.dim}${line}${c.reset}`);
   }
-  // THE CASE THAT SAID NOTHING AT ALL (issue 116).
+  // THE CASE THAT SAID NOTHING AT ALL.
   if (callFailed(report, MODEL_CALL.EVALUATION)) {
     const detected = Array.isArray(report.agents) ? report.agents.length : 0;
     const cls = t.classification;
-    // FOUR outcomes, because they ask the talent to do different things — and ADR-042 is what made three of them distinguishable at all.
+    // FOUR outcomes, because they ask the talent to do different things.
     const record = modelCall(report, MODEL_CALL.EVALUATION);
     const reason = record && record.reason;
     let notice;

package/src/terminal-format.js

@@ -21,7 +21,7 @@ function bar(score, width = 24) {
   return '█'.repeat(filled) + '░'.repeat(width - filled);
 }
 
-// ADR-016: a light visual break between the reordered sections — a dim rule
+// A light visual break between the reordered sections — a dim rule
 // with air around it, keeping the branded ANSI look and zero deps.
 function sep(p) {
   p();
@@ -29,7 +29,7 @@ function sep(p) {
   p();
 }
 
-// WRAPPING, added for issue 087.
+// WRAPPING.
 const WRAP_COLS = 76;
 
 function wrap(text, width = WRAP_COLS) {
@@ -71,7 +71,7 @@ function labelledBlock(p, label, value, indent = '    ') {
   for (const line of wrap(value, WRAP_COLS - indent.length)) p(`${indent}${c.muted}${line}${c.reset}`);
 }
 
-// Terminal-SUMMARIZE (user feedback, 2026-07-16): the earlier condense (commit 465badb) over-trimmed — it left the terminal as headings + copyable prompts with the prose stripped out.
+// Terminal-SUMMARIZE: the earlier condense over-trimmed — it left the terminal as headings + copyable prompts with the prose stripped out.
 function summarize(text, max = 140) {
   const s = String(text || '').trim().replace(/\s+/g, ' ');
   if (s.length <= max) return s;

package/src/terminal-sections.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// The MCP-services, tier-analysis, progression-ladder and tier-roadmap sections of the terminal report, extracted from src/render-terminal.js (structure refactor, issue 020).
+// The MCP-services, tier-analysis, progression-ladder and tier-roadmap sections of the terminal report, extracted from src/render-terminal.js.
 
 const { getRoadmapEntry } = require('./roadmap-content');
 const { analyzeTier, buildLadder } = require('./tier-analysis');
@@ -27,7 +27,7 @@ function printMcpServices(report, t, p) {
     p(`  ${c.primary}${shown.join(`${c.reset}${c.muted} · ${c.reset}${c.primary}`)}${c.reset}`);
   }
   // Stated, never omitted: the list has to account for every server the tier
-  // counted, or the screen shows two different numbers for one set (issue 096).
+  // counted, or the screen shows two different numbers for one set.
   if (unidentified > 0) {
     for (const line of wrap(t.html.mcpUnidentified(unidentified))) p(`  ${c.dim}${line}${c.reset}`);
   }
@@ -82,7 +82,7 @@ function printLadder(report, t, p) {
   p(`  ${c.muted}${ld.setupIntro}${c.reset}`);
   p(`  ${c.dim}${ld.legend(done, current, pending)}${c.reset}`);
   p();
-  // NESTED (ADR-016): each SETUP LEVEL, then its tiers indented beneath.
+  // NESTED: each SETUP LEVEL, then its tiers indented beneath.
   for (const lvl of setupLevels) {
     const nameStyle = lvl.status === 'pending' ? c.muted : `${c.bold}${c.white}`;
     const keys = lvl.tierKeys.length ? ` ${c.muted}— [${lvl.tierKeys.join(', ')}]${c.reset}` : '';
@@ -138,8 +138,8 @@ function printRoadmap(report, maturity, t, lang, p) {
   }
 
   p(`  ${c.bold}${c.warning}${t.html.roadmapHeading}${c.reset}`);
-  // Issue 083: the register, stated before the content.
-  // Wrapped like every other prose line in this block (issue 087): it was the one line still running past the 80th column, which is the shape the squad read as a dump.
+  // The register, stated before the content.
+  // Wrapped like every other prose line in this block: it was the one line still running past the 80th column, which is the shape the squad read as a dump.
   for (const line of wrap(t.html.roadmapSubheading)) p(`  ${c.dim}${line}${c.reset}`);
 
   if (curatedEntry.contentUnavailable) {
@@ -152,15 +152,15 @@ function printRoadmap(report, maturity, t, lang, p) {
   const personalization = report && report.roadmapPersonalization;
   const entry = mergeRoadmapPersonalization(curatedEntry, personalization);
 
-  // Issue 087: the jump title gets air and its own line, and everything below it hangs off it.
-  // THE BEFORE AND THE AFTER (issue 084), above the steps and not below them.
+  // The jump title gets air and its own line, and everything below it hangs off it.
+  // THE BEFORE AND THE AFTER, above the steps and not below them.
   printProjection(report, t, p);
 
   p();
   p(`  ${c.white}${c.bold}${sanitizeRenderText(entry.title)}${c.reset}`);
   p();
 
-  // Issue 109: whether this roadmap is YOURS or the template, said out loud.
+  // Whether this roadmap is YOURS or the template, said out loud.
   if (personalization) {
     p(`  ${c.dim}${t.html.roadmapPersonalizedNotice}${c.reset}`);
     p();
@@ -170,7 +170,7 @@ function printRoadmap(report, maturity, t, lang, p) {
   }
 
   if (entry.maxTier) {
-    // ADR-008 (skill-code-certification): T7 is NOT a dead end.
+    // T7 is NOT a dead end.
     if (entry.whatRemains) {
       for (const line of wrap(sanitizeRenderText(entry.whatRemains))) p(`  ${c.muted}${line}${c.reset}`);
       p();
@@ -198,7 +198,7 @@ function printRoadmap(report, maturity, t, lang, p) {
   {
     const promptText = buildImplementationPrompt(entry, report, maturity, lang);
     if (promptText) {
-      // Issue 087: THE wall of text.
+      // THE wall of text.
       sep(p);
       p(`  ${c.bold}${t.html.implementationPromptHeading}${c.reset}`);
       for (const line of wrap(t.html.implementationPromptHint)) p(`  ${c.dim}${line}${c.reset}`);
@@ -210,7 +210,7 @@ function printRoadmap(report, maturity, t, lang, p) {
     }
   }
 
-  // --build-next-level (issue 021) is now a SECONDARY, opt-in alternative to the prompt above — never when already at the terminal T7 entry (there is nothing left to build).
+  // --build-next-level is now a SECONDARY, opt-in alternative to the prompt above — never when already at the terminal T7 entry (there is nothing left to build).
   if (!entry.maxTier) p(`  ${c.dim}${t.cli.buildNextLevelHint}${c.reset}`);
 
   p();

package/src/tier-engine.js

@@ -20,7 +20,7 @@ const AGENTIC_IDS = ['claude-code', 'aider', 'gemini-cli', 'codex-cli', 'amazon-
 // Band 0-4 derived from tier (level-model.md, single source of truth): index = tier -> band.
 const BAND_BY_TIER = [0, 1, 2, 3, 3, 4, 4, 4];
 
-// Setup Level (Talent Certification Framework, ADR-016): the 3-value rollup that REPLACES the retired 0-4 band on every display surface.
+// Setup Level (Talent Certification Framework): the 3-value rollup that REPLACES the retired 0-4 band on every display surface.
 const SETUP_LEVELS = [
   { key: 'none', code: null, rank: 0, emoji: '○' },
   { key: 'S1', code: 'S1', rank: 1, emoji: '◔' },
@@ -60,7 +60,7 @@ function aggregateTierSignals(report) {
       ? report.agentCounts.agents
       : 0;
 
-  // THE MCP SIGNAL IS THE DEDUPED SET THE REPORT SHOWS (issue 112).
+  // THE MCP SIGNAL IS THE DEDUPED SET THE REPORT SHOWS.
   const mcpTotal =
     report && report.mcp && typeof report.mcp.total === 'number' ? report.mcp.total : mcp;
 
@@ -93,7 +93,7 @@ function computeTierResult(report) {
     tierKey: meta.key,
     tierName: meta.name,
     band: bandForTier(tier),
-    // Setup Level (ADR-016) — the shown rollup. `{key, code, rank, emoji}`;
+    // Setup Level — the shown rollup. `{key, code, rank, emoji}`;
     // the label is resolved from i18n by `key` at the render layer.
     setupLevel: setupLevelForTier(tier),
     signals,

package/src/tier-projection.js

@@ -3,7 +3,7 @@
 const { classify } = require('./maturity');
 const { computeTierResult, aggregateTierSignals, computeTier } = require('./tier-engine');
 
-// Where this roadmap leaves you, computed with the REAL engine (issue 084).
+// Where this roadmap leaves you, computed with the REAL engine.
 
 // One entry per TARGET tier: the smallest report-shape changes that satisfy that tier's criterion.
 const AGENTIC_TOOL_ID = 'claude-code';
@@ -42,7 +42,7 @@ const bumpDepth = (field) => (r) => {
   tool.depth[field] = (tool.depth[field] || 0) + 1;
 };
 
-// "Configure one MCP server" needs its own delta, and the reason is a collision worth recording (issue 112 landing after issue 084).
+// "Configure one MCP server" needs its own delta, and the reason is a collision worth recording.
 const addMcpServer = (r) => {
   const tool = ensureDetectedTool(r);
   tool.depth.mcpServers = (tool.depth.mcpServers || 0) + 1;

package/src/transcript-turns.js

@@ -2,7 +2,7 @@
 
 const { iterateSessionObjects } = require('./session-scan');
 
-// Human-turn reader for the steering/decisions extractors (hybrid evaluation, Slice 2).
+// Human-turn reader for the steering/decisions extractors.
 
 function isHumanTurn(obj) {
   if (!obj || typeof obj !== 'object') return false;

package/src/typewriter.js

@@ -2,7 +2,7 @@
 
 const { isInteractive } = require('./terminal-progress');
 
-// Progressive reveal of text that is ALREADY IN HAND (talents-ai-score, camino A).
+// Progressive reveal of text that is ALREADY IN HAND.
 
 // 60fps. Fine enough that the reveal reads as continuous, coarse enough that a
 // 700ms budget is ~43 writes rather than one per character.

package/src/usage-model-calls.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// The three ephemeral model-call orchestrators of the `ai-usage` flow, extracted from bin/ai-usage.js (structure refactor, issue 020).
+// The three ephemeral model-call orchestrators of the `ai-usage` flow, extracted from bin/ai-usage.js.
 
 const { parseAgentDescriptions, parseAgentDefinitionsForRoots } = require('./agent-org-chart');
 const {
@@ -21,7 +21,7 @@ const { hasTraceContentConsent } = require('./share');
 const { getRoadmapEntry } = require('./roadmap-content');
 const { computeTierResult } = require('./tier-engine');
 
-// Agent-synthesis call (talents-ai-score, ADR-010/ADR-011, "ephemeral" — not persisted; ADR-051 amends WHEN it runs, not that).
+// Agent-synthesis call ("ephemeral" — not persisted).
 async function maybeSynthesizeAgents(report, root) {
   const KEY = MODEL_CALL.SYNTHESIS;
   if (!Array.isArray(report.agents) || report.agents.length === 0) {
@@ -51,7 +51,7 @@ async function maybeSynthesizeAgents(report, root) {
   }
 }
 
-// Ephemeral agent-evaluation call (ADR-016): scores each agent's DEFINITION quality server-side (gemini-2.5-flash — see src/agent-evaluation.js).
+// Ephemeral agent-evaluation call: scores each agent's DEFINITION quality server-side (gemini-2.5-flash — see src/agent-evaluation.js).
 async function maybeEvaluateAgents(report, roots, lang) {
   const KEY = MODEL_CALL.EVALUATION;
   if (!Array.isArray(report.agents) || report.agents.length === 0) {
@@ -66,7 +66,7 @@ async function maybeEvaluateAgents(report, roots, lang) {
 
   try {
     const definitions = parseAgentDefinitionsForRoots(roots);
-    // ADR-026: pass the report language so the rationale + the one-line description come back translated (a Spanish-authored definition still yields report-language prose).
+    // Pass the report language so the rationale + the one-line description come back translated (a Spanish-authored definition still yields report-language prose).
     const requestBody = buildAgentEvaluationRequest(report.agents, definitions, lang, hasTraceContentConsent());
     return await requestAgentEvaluation(requestBody, {
       endpoint,
@@ -103,8 +103,8 @@ async function maybePersonalizeRoadmap(report, maturity, lang) {
 
   try {
     const tierResult = computeTierResult(report);
-    // ADR-026: pass the report language so the personalized prose is localized.
-    // ADR-028: fresh consent read, see maybeSynthesizeAgents above.
+    // Pass the report language so the personalized prose is localized.
+    // Fresh consent read, see maybeSynthesizeAgents above.
     const requestBody = buildRoadmapPersonalizationRequest(entry, tierResult, report, lang, hasTraceContentConsent());
     return await requestRoadmapPersonalization(requestBody, {
       endpoint,

package/src/usage-oneshot-commands.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// One-shot command handlers extracted from bin/ai-usage.js (structure refactor, issue 020).
+// One-shot command handlers extracted from bin/ai-usage.js.
 
 const {
   getConsentStatus,
@@ -17,7 +17,7 @@ const {
 } = require('./config');
 const { buildNextLevelStarter } = require('./build-next-level');
 
-// One-shot consent management commands (issue 007). Mirror the retired
+// One-shot consent management commands. Mirror the retired
 // `--enroll` pattern: they act immediately and do NOT scan.
 
 function doConsentStatus(catalog) {
@@ -41,7 +41,7 @@ function doConsentRevoke(catalog) {
   process.stdout.write(`\n  ${catalog.consent.revoked}\n\n`);
 }
 
-// skill-code-certification / ADR-003: clears the decision back to "no decision yet" so the consent question is asked again next run — distinct from revoke (which persists `denied`).
+// Clears the decision back to "no decision yet" so the consent question is asked again next run — distinct from revoke (which persists `denied`).
 function doConsentReset(catalog) {
   resetConsent();
   process.stdout.write(`\n  ${catalog.consent.reset}\n\n`);
@@ -102,14 +102,14 @@ function doShowEndpoint(catalog) {
     process.stdout.write(`\n  ${e.showNone}\n\n`);
   }
 
-  // ADR-042: there is no second hop any more.
+  // There is no second hop any more.
   if (hasRetiredFallbackConfig()) {
     process.stdout.write(`  ${e.showFallbackRetired}\n\n`);
   }
 
 }
 
-// "Construir el siguiente nivel ahora" (issue 021): optional, explicit phase — never runs unless the talent asks for it via --build-next-level.
+// "Construir el siguiente nivel ahora": optional, explicit phase — never runs unless the talent asks for it via --build-next-level.
 function doBuildNextLevel(root, maturity, force, catalog) {
   const b = catalog.buildNextLevel;
   const result = buildNextLevelStarter(root || process.cwd(), maturity.tierKey, { force });