@fyso/awareness-framework 0.3.0 → 0.3.1

package/docs/cli.md

@@ -118,7 +118,7 @@ awareness init --wrappers \
 
 ### `status`
 
-Shows the current focus and warnings.
+Shows the current focus and warnings. Warnings are printed but do not make the command fail; use `awareness check --strict` when automation should fail on warnings.
 
 ```bash
 awareness status
@@ -153,9 +153,12 @@ awareness focus \
   --summary "Agent awareness framework" \
   --repo fyso-dev/awareness-framework \
   --branch codex/cli-and-personality \
+  --state in-progress \
   --next "Run tests and open a PR"
 ```
 
+Valid states are `started`, `in-progress`, `paused`, `blocked`, `waiting`, `done`, `in-review`, and `ready`. Underscore aliases such as `in_progress` and `in_review` are accepted and normalized.
+
 ### `log`
 
 Appends a concrete progress entry to the daily worklog.
@@ -170,7 +173,7 @@ awareness log \
 
 ### `handoff`
 
-Prints a handoff snapshot from the awareness board.
+Prints a handoff snapshot from the awareness board. Like `status`, warnings are informational and return exit code 0.
 
 ```bash
 awareness handoff
@@ -202,6 +205,8 @@ awareness memory promote --kind preference --text "Surface memory candidates pro
 
 `memory review` scans promotion candidates and suggests repeated candidates as `pattern` promotions once they appear at least twice by default.
 
+`memory candidates` lists active promotion candidates only. Text that has been pruned or revised remains in the Markdown history but is hidden from active candidates, excluded from suggestions, and rejected by `memory promote`.
+
 Valid promotion kinds are `preference`, `pattern`, `project`, and `review`.
 
 ### Local memory operations
@@ -216,9 +221,9 @@ awareness improve
 ```
 
 `remember` records a promotion candidate and appends `memory.candidate.created` to `memory/events.jsonl`.
-`recall` performs deterministic local text search across memory, memory events, worklogs, and evaluations.
-`forget` records a prune/revision entry and appends `memory.pruned`; it does not destructively delete historical evidence.
-`improve` runs the evaluation/review loop and appends `evaluation.created` and `pattern.suggested` events when applicable.
+`recall` performs deterministic local text search across memory, memory events, worklogs, and evaluations. Matching is case- and accent-insensitive, includes simple singular/plural normalization, and includes a small English/Spanish alias set for memory/user terms.
+`forget` records a prune/revision entry and appends `memory.pruned`; it does not destructively delete historical evidence, but pruned text is inactive for candidate review and promotion.
+`improve` runs the evaluation/review loop and appends `evaluation.created` and `pattern.suggested` events when applicable. Auto-generated evaluation candidates are deduplicated by text across days so recurring diagnostics do not flood human-curated candidates.
 
 ### `hook run`
 

package/docs/evaluation-loop.md

@@ -115,7 +115,7 @@ Each evaluation should end with one of these outcomes:
 - Propose framework PR.
 - Ask user for confirmation.
 
-Daily evaluation is active by default: when it writes an evaluation note, the CLI also records promotion candidates under `memory/long-term.md`. Candidates are intentionally reviewable. Use `awareness memory review` to surface repeated candidates as suggested `pattern` promotions, then promote them with `awareness memory promote` only after they are user-confirmed, repeated, or operationally important.
+Daily evaluation is active by default: when it writes an evaluation note, the CLI also records promotion candidates under `memory/long-term.md`. Auto-generated candidates are deduplicated by text across days so repeated diagnostics do not crowd out human-curated observations. Candidates are intentionally reviewable. Use `awareness memory review` to surface repeated candidates as suggested `pattern` promotions, then promote them with `awareness memory promote` only after they are user-confirmed, repeated, operationally important, and not pruned or revised.
 
 ## Example Outcomes
 

package/docs/lifecycle.md

@@ -74,12 +74,16 @@ When switching tasks, the agent:
 
 Valid states:
 
+- `started`
 - `in-progress`
 - `paused`
 - `blocked`
 - `waiting`
 - `done`
 - `in-review`
+- `ready`
+
+The CLI also accepts underscore aliases such as `in_progress` and normalizes them to hyphenated state names.
 
 ## 5. Handoff
 

package/docs/memory.md

@@ -19,7 +19,7 @@ Do not load every layer into every prompt. Load the smallest layer that answers
 Awareness uses a small local operation vocabulary:
 
 - `remember`: capture an evidence-backed candidate.
-- `recall`: search local memory, events, worklogs, and evaluations.
+- `recall`: search local memory, events, worklogs, and evaluations with deterministic normalized text matching.
 - `forget`: prune or revise stale memory without destructive deletion.
 - `improve`: run evaluation plus memory review to surface repeated candidates.
 
@@ -113,10 +113,13 @@ Information should move from short-term to long-term only when it earns promotio
 
 Hooks and scheduled maintenance may perform steps 1 and 2 by recording observations, warnings, or evaluation notes. They must not perform step 4 silently.
 
+Pruned or revised text remains in the Markdown history for auditability, but it is inactive. It should not appear in active candidate listings, repeated-candidate suggestions, or promotion commands.
+
 ## Promotion Rules
 
 - Promote explicit user preferences immediately when they affect future collaboration.
 - Promote inferred preferences only after repeated evidence.
+- Do not promote text that has been pruned or revised; record a new corrected candidate instead.
 - Promote framework changes only through version control.
 - Keep private memory private; do not copy private examples into public docs.
 - Prefer small, operational statements over long stories.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fyso/awareness-framework",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Methodology and helper CLI for agent awareness, initialization, daily worklogs, handoffs, and evaluation loops.",
   "type": "module",
   "author": "Fyso",

package/src/cli.js

@@ -3,9 +3,21 @@ import os from 'node:os';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
+import {
+  activeMemoryCandidates,
+  isPrunedMemoryText,
+  memoryCandidateExists,
+  memoryCandidateTextExists,
+  repeatedMemoryCandidateSuggestions,
+} from './memory-candidates.js';
+import { normalizeSearchText, recallTermGroups } from './text.js';
 
 const VALID_STATES = new Set(['started', 'in-progress', 'paused', 'blocked', 'waiting', 'done', 'in-review', 'ready']);
 const DEFAULT_STATE = 'in-progress';
+const STATE_ALIASES = {
+  in_progress: 'in-progress',
+  in_review: 'in-review',
+};
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const repoRoot = path.resolve(__dirname, '..');
 
@@ -142,6 +154,9 @@ Scope options:
   --channel NAME              Store state under <folder>/channels/<safe-name>.
   --user ID                   Select a user memory file for user commands.
 
+State values:
+  ${[...VALID_STATES].join(', ')}
+
 The CLI maintains private files under ~/.agents by default. It does not post to Jira, GitHub, or any external system.`);
 }
 
@@ -209,7 +224,7 @@ function statusCommand(ctx, opts) {
   for (const warning of warnings) {
     out(ctx, `- ${warning}`);
   }
-  return warnings.length ? 1 : 0;
+  return 0;
 }
 
 function checkCommand(ctx, opts) {
@@ -330,7 +345,7 @@ function handoffCommand(ctx, opts) {
     }
   }
 
-  return warnings.length ? 1 : 0;
+  return 0;
 }
 
 function evaluateCommand(ctx, opts) {
@@ -354,8 +369,9 @@ function evaluateCommand(ctx, opts) {
   ensureDir(path.dirname(evaluationPath));
   fs.writeFileSync(evaluationPath, content);
   const candidates = recordEvaluationMemoryCandidates(home, today);
+  const candidateSummary = candidates.length ? `${candidates.length} recorded` : 'none';
   out(ctx, `Evaluation written: ${evaluationPath}`);
-  out(ctx, `Memory candidates: ${candidates.length ? `${candidates.length} recorded` : 'none'}`);
+  out(ctx, `Memory candidates: ${candidateSummary}`);
   return 0;
 }
 
@@ -382,8 +398,11 @@ function memoryCommand(ctx, subcommand, opts) {
 
 function memoryCandidatesCommand(ctx, home) {
   const content = fs.readFileSync(longTermMemoryPath(home), 'utf8');
+  const activeCandidates = activeMemoryCandidates(content)
+    .map((candidate) => candidate.line)
+    .join('\n');
   out(ctx, 'Promotion Candidates');
-  out(ctx, extractSection(content, 'Promotion Candidates').trim() || '- None yet.');
+  out(ctx, activeCandidates || '- None yet.');
   return 0;
 }
 
@@ -427,6 +446,9 @@ function memoryPromoteCommand(ctx, home, opts) {
   const today = todayParts(ctx);
   const file = longTermMemoryPath(home);
   let content = fs.readFileSync(file, 'utf8');
+  if (isPrunedMemoryText(content, text)) {
+    throw new Error(`Cannot promote pruned or revised memory: ${text}`);
+  }
   content = replaceMetadata(content, 'Updated', formatTimestamp(today));
   content = appendToSection(content, section, `- ${today.date}: ${text} (evidence: ${evidence})\n`);
   fs.writeFileSync(file, content);
@@ -553,7 +575,8 @@ function improveCommand(ctx, opts) {
   }
 
   out(ctx, `Evaluation: ${evaluation.status} (${evaluation.file})`);
-  out(ctx, `Memory candidates: ${evaluation.candidates ? evaluation.candidates.length : 'not changed'}`);
+  const candidateSummary = evaluation.candidates ? `${evaluation.candidates.length} (from evaluation diagnostics)` : 'not changed';
+  out(ctx, `Auto-generated candidates: ${candidateSummary}`);
   out(ctx, `Pattern suggestions: ${suggestions.length}`);
   for (const suggestion of suggestions) {
     out(ctx, `- ${suggestion.text} (${suggestion.count} observations)`);
@@ -767,7 +790,10 @@ function scheduleRunCommand(ctx, opts) {
   out(ctx, `Schedule run complete: ${cadence}`);
   out(ctx, `Runtime log: ${eventFile}`);
   if (evaluation) out(ctx, `Evaluation: ${evaluation.status} (${evaluation.file})`);
-  if (evaluation?.candidates) out(ctx, `Memory candidates: ${evaluation.candidates.length ? `${evaluation.candidates.length} recorded` : 'none'}`);
+  if (evaluation?.candidates) {
+    const candidateSummary = evaluation.candidates.length ? `${evaluation.candidates.length} recorded` : 'none';
+    out(ctx, `Memory candidates: ${candidateSummary}`);
+  }
   out(ctx, warnings.length ? `Warnings: ${warnings.length}` : 'Warnings: none');
   return 0;
 }
@@ -806,7 +832,8 @@ function scheduleInstallCommand(ctx, opts) {
     if (opts.load) {
       const result = loadLaunchAgent(file, label);
       if (result.status !== 0) {
-        throw new Error(`launchctl failed for ${file}: ${result.stderr || result.stdout || `exit ${result.status}`}`);
+        const failure = result.stderr || result.stdout || `exit ${result.status}`;
+        throw new Error(`launchctl failed for ${file}: ${failure}`);
       }
       loaded.push(file);
     }
@@ -1086,6 +1113,7 @@ function buildEvaluation(home, today) {
   const handoff = /- Next:\s+(?!The next concrete action)\S+/.test(extractSection(current, 'Current Focus')) ? 2 : current ? 1 : 0;
   const noise = current.split('\n').length <= 180 && !/YYYY-MM-DD|branch-name/.test(current) ? 2 : 1;
   const reporting = sectionHasMeaningfulContent(extractSection(current, 'End-of-Day Candidates')) ? 2 : entries.length ? 1 : 0;
+  const warningsMarkdown = warnings.length ? warnings.map((warning) => `- ${warning}`).join('\n') : '- None.';
 
   return `# Awareness Evaluation - ${today.date}
 
@@ -1101,7 +1129,7 @@ function buildEvaluation(home, today) {
 
 ## Warnings
 
-${warnings.length ? warnings.map((warning) => `- ${warning}`).join('\n') : '- None.'}
+${warningsMarkdown}
 
 ## Proposed Changes
 
@@ -1112,7 +1140,9 @@ ${warnings.length ? warnings.map((warning) => `- ${warning}`).join('\n') : '- No
 
 function recordEvaluationMemoryCandidates(home, today) {
   const candidates = buildEvaluationMemoryCandidates(home, today);
-  return candidates.filter((candidate) => appendMemoryCandidate(home, today, candidate.text, candidate.evidence, 'evaluation'));
+  return candidates.filter((candidate) => appendMemoryCandidate(home, today, candidate.text, candidate.evidence, 'evaluation', {
+    dedupeByText: true,
+  }));
 }
 
 function buildEvaluationMemoryCandidates(home, today) {
@@ -1159,10 +1189,12 @@ function buildEvaluationMemoryCandidates(home, today) {
   return candidates;
 }
 
-function appendMemoryCandidate(home, today, text, evidence, source = 'memory.note') {
+function appendMemoryCandidate(home, today, text, evidence, source = 'memory.note', opts = {}) {
   const file = longTermMemoryPath(home);
   let content = fs.readFileSync(file, 'utf8');
   if (memoryCandidateExists(content, text, evidence)) return false;
+  if (isPrunedMemoryText(content, text)) return false;
+  if (opts.dedupeByText && memoryCandidateTextExists(content, text)) return false;
 
   content = replaceMetadata(content, 'Updated', formatTimestamp(today));
   content = appendToSection(content, 'Promotion Candidates', `- ${today.date}: ${text} (evidence: ${evidence})\n`);
@@ -1176,58 +1208,6 @@ function appendMemoryCandidate(home, today, text, evidence, source = 'memory.not
   return true;
 }
 
-function memoryCandidateExists(content, text, evidence) {
-  const candidates = extractSection(content, 'Promotion Candidates');
-  return candidates.split('\n').some((line) => line.includes(`: ${text} (evidence: ${evidence})`));
-}
-
-function repeatedMemoryCandidateSuggestions(content, minCount) {
-  const grouped = new Map();
-  const prunedTexts = prunedMemoryCandidateTexts(content);
-  for (const candidate of parseMemoryCandidates(content)) {
-    const key = normalizeMemoryCandidateText(candidate.text);
-    if (prunedTexts.has(key)) continue;
-    const group = grouped.get(key) || { text: candidate.text, count: 0, evidence: [] };
-    group.count += 1;
-    group.evidence.push(candidate.evidence);
-    grouped.set(key, group);
-  }
-
-  return [...grouped.values()]
-    .filter((group) => group.count >= minCount)
-    .map((group) => ({
-      text: group.text,
-      count: group.count,
-      evidence: [...new Set(group.evidence)].join('; '),
-    }))
-    .sort((left, right) => right.count - left.count || left.text.localeCompare(right.text));
-}
-
-function parseMemoryCandidates(content) {
-  return extractSection(content, 'Promotion Candidates')
-    .split('\n')
-    .map((line) => line.trim())
-    .map((line) => line.match(/^- \d{4}-\d{2}-\d{2}: (.+) \(evidence: (.+)\)$/))
-    .filter(Boolean)
-    .map((match) => ({
-      text: match[1],
-      evidence: match[2],
-    }));
-}
-
-function prunedMemoryCandidateTexts(content) {
-  return new Set(extractSection(content, 'Pruned Or Revised')
-    .split('\n')
-    .map((line) => line.trim())
-    .map((line) => line.match(/^- \d{4}-\d{2}-\d{2}: (.+) \(reason: .+; evidence: .+\)$/))
-    .filter(Boolean)
-    .map((match) => normalizeMemoryCandidateText(match[1])));
-}
-
-function normalizeMemoryCandidateText(text) {
-  return text.toLowerCase().replace(/\s+/g, ' ').trim();
-}
-
 function shellQuoteText(text) {
   return text.replace(/["\\$`]/g, '\\$&');
 }
@@ -1269,7 +1249,7 @@ function parseWorklogEntries(worklog) {
     const headingText = heading[0];
     const headingParts = headingText.replace(/^#{2,3} \d{2}:\d{2} - /, '').split(' - ');
     const headingTask = headingParts.length > 1 && isTaskId(headingParts[0]) ? headingParts[0] : null;
-    const jiraTask = block.match(/^- Jira:\s+(.+)$/m)?.[1]?.trim();
+    const jiraTask = metadataValue(block, 'Jira');
     return {
       block,
       task: headingTask || jiraTask || null,
@@ -1340,12 +1320,13 @@ function replaceSection(content, section, body) {
 function appendToSection(content, section, addition) {
   const current = extractSection(content, section);
   const cleaned = current.replace(/^- None yet\.\n?/m, '').trimEnd();
-  return replaceSection(content, section, `${cleaned ? `${cleaned}\n\n` : ''}${addition.trimEnd()}\n`);
+  const prefix = cleaned ? `${cleaned}\n\n` : '';
+  return replaceSection(content, section, `${prefix}${addition.trimEnd()}\n`);
 }
 
 function extractSection(content, section) {
   const pattern = new RegExp(`(?:^|\\n)## ${escapeRegExp(section)}\\n\\n?([\\s\\S]*?)(?=\\n## |$)`);
-  const match = content.match(pattern);
+  const match = pattern.exec(content);
   return match ? match[1] : '';
 }
 
@@ -1357,12 +1338,18 @@ function replaceMetadata(content, key, value) {
   return content.replace(/^# .+$/m, (heading) => `${heading}\n\n- ${key}: ${value}`);
 }
 
+function metadataValue(content, key) {
+  const prefix = `- ${key}:`;
+  const line = content.split('\n').find((candidate) => candidate.startsWith(prefix));
+  return line?.slice(prefix.length).trim() || null;
+}
+
 function currentContext(home) {
   const file = awarenessPath(home);
   if (!fs.existsSync(file)) return 'Not specified';
   const focus = extractSection(fs.readFileSync(file, 'utf8'), 'Current Focus');
-  const repo = focus.match(/^- Repository:\s+(.+)$/m)?.[1] || 'Not specified';
-  const branch = focus.match(/^- Branch:\s+(.+)$/m)?.[1] || 'Not specified';
+  const repo = metadataValue(focus, 'Repository') || 'Not specified';
+  const branch = metadataValue(focus, 'Branch') || 'Not specified';
   return `${repo} / ${branch}`;
 }
 
@@ -1540,10 +1527,11 @@ function initialUserMemory(user, timestamp) {
 }
 
 function normalizeState(state) {
-  if (!VALID_STATES.has(state)) {
+  const normalized = STATE_ALIASES[state] || String(state).replaceAll('_', '-');
+  if (!VALID_STATES.has(normalized)) {
     throw new Error(`Invalid state: ${state}. Valid states: ${[...VALID_STATES].join(', ')}`);
   }
-  return state;
+  return normalized;
 }
 
 function expandTargets(value, allowed) {
@@ -1560,11 +1548,15 @@ function expandTargets(value, allowed) {
 
 function required(opts, key) {
   if (!opts[key] || opts[key] === true) {
-    throw new Error(`Missing required option: --${key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`);
+    throw new Error(`Missing required option: --${optionName(key)}`);
   }
   return opts[key];
 }
 
+function optionName(key) {
+  return key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+
 function agentsHome(ctx, opts) {
   const raw = opts.home
     || opts.agentFolder
@@ -1704,14 +1696,14 @@ function markdownFilesRecursive(dir) {
 }
 
 function recallMatches(home, query, limit) {
-  const terms = [...new Set(query.toLowerCase().split(/\s+/).filter(Boolean))];
+  const termGroups = recallTermGroups(query);
   const results = [];
   for (const file of collectRecallSources(home)) {
     const content = fs.readFileSync(file, 'utf8');
     const lines = content.split('\n');
     lines.forEach((line, index) => {
-      const haystack = line.toLowerCase();
-      const score = terms.filter((term) => haystack.includes(term)).length;
+      const haystack = normalizeSearchText(line);
+      const score = termGroups.filter((terms) => terms.some((term) => haystack.includes(term))).length;
       if (score > 0) {
         results.push({
           file,

package/src/memory-candidates.js

@@ -0,0 +1,82 @@
+import { normalizeSearchText } from './text.js';
+
+export function activeMemoryCandidates(content) {
+  const prunedTexts = prunedMemoryCandidateTexts(content);
+  return parseMemoryCandidates(content).filter((candidate) => !prunedTexts.has(normalizeMemoryCandidateText(candidate.text)));
+}
+
+export function isPrunedMemoryText(content, text) {
+  return prunedMemoryCandidateTexts(content).has(normalizeMemoryCandidateText(text));
+}
+
+export function memoryCandidateExists(content, text, evidence) {
+  const candidates = extractMarkdownSection(content, 'Promotion Candidates');
+  return candidates.split('\n').some((line) => line.includes(`: ${text} (evidence: ${evidence})`));
+}
+
+export function memoryCandidateTextExists(content, text) {
+  const key = normalizeMemoryCandidateText(text);
+  return parseMemoryCandidates(content).some((candidate) => normalizeMemoryCandidateText(candidate.text) === key);
+}
+
+export function repeatedMemoryCandidateSuggestions(content, minCount) {
+  const grouped = new Map();
+  for (const candidate of activeMemoryCandidates(content)) {
+    const key = normalizeMemoryCandidateText(candidate.text);
+    const group = grouped.get(key) || { text: candidate.text, count: 0, evidence: [] };
+    group.count += 1;
+    group.evidence.push(candidate.evidence);
+    grouped.set(key, group);
+  }
+
+  return [...grouped.values()]
+    .filter((group) => group.count >= minCount)
+    .map((group) => ({
+      text: group.text,
+      count: group.count,
+      evidence: [...new Set(group.evidence)].join('; '),
+    }))
+    .sort((left, right) => right.count - left.count || left.text.localeCompare(right.text));
+}
+
+function parseMemoryCandidates(content) {
+  const candidates = [];
+  const candidatePattern = /^- \d{4}-\d{2}-\d{2}: (.+) \(evidence: (.+)\)$/;
+  for (const rawLine of extractMarkdownSection(content, 'Promotion Candidates').split('\n')) {
+    const match = candidatePattern.exec(rawLine.trim());
+    if (!match) continue;
+    candidates.push({
+      line: match[0],
+      text: match[1],
+      evidence: match[2],
+    });
+  }
+  return candidates;
+}
+
+function prunedMemoryCandidateTexts(content) {
+  const pruned = new Set();
+  const prunedPattern = /^- \d{4}-\d{2}-\d{2}: (.+) \(reason: .+; evidence: .+\)$/;
+  for (const rawLine of extractMarkdownSection(content, 'Pruned Or Revised').split('\n')) {
+    const match = prunedPattern.exec(rawLine.trim());
+    if (match) pruned.add(normalizeMemoryCandidateText(match[1]));
+  }
+  return pruned;
+}
+
+function normalizeMemoryCandidateText(text) {
+  return normalizeSearchText(text);
+}
+
+function extractMarkdownSection(content, section) {
+  const lines = content.split('\n');
+  const start = lines.findIndex((line) => line.trimEnd() === `## ${section}`);
+  if (start === -1) return '';
+
+  const body = [];
+  for (const line of lines.slice(start + 1)) {
+    if (line.startsWith('## ')) break;
+    body.push(line);
+  }
+  return body.join('\n').replace(/^\n/, '');
+}

package/src/text.js

@@ -0,0 +1,35 @@
+const RECALL_ALIASES = {
+  memoria: ['memory'],
+  memorias: ['memory'],
+  memory: ['memoria', 'memorias'],
+  user: ['usuario', 'usuarios'],
+  users: ['usuario', 'usuarios'],
+  usuario: ['user', 'users'],
+  usuarios: ['user', 'users'],
+};
+
+export function normalizeSearchText(text) {
+  return String(text)
+    .normalize('NFD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .toLowerCase()
+    .replace(/[^a-z0-9._-]+/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+export function recallTermGroups(query) {
+  return normalizeSearchText(query)
+    .split(/\s+/)
+    .filter(Boolean)
+    .map((term) => new Set([term, ...recallTokenVariants(term), ...(RECALL_ALIASES[term] || [])]))
+    .map((terms) => [...terms].filter(Boolean))
+    .filter((terms, index, groups) => groups.findIndex((group) => group[0] === terms[0]) === index);
+}
+
+function recallTokenVariants(term) {
+  const variants = [];
+  if (term.endsWith('es') && term.length > 4) variants.push(term.slice(0, -2));
+  if (term.endsWith('s') && term.length > 3) variants.push(term.slice(0, -1));
+  return variants;
+}