@redaksjon/protokoll 0.2.0 → 0.3.0

package/README.md

@@ -18,7 +18,7 @@ Protokoll solves this.
 Protokoll is an intelligent audio transcription system that uses advanced reasoning models to create highly accurate, context-enhanced transcripts. Unlike basic transcription tools, Protokoll:
 
 - **Learns Your World**: Maintains a knowledge base of people, projects, and organizations you mention. When Whisper mishears someone, Protokoll recognizes and corrects it using phonetic variants and context awareness
-- **Routes Intelligently**: Multi-signal classification sends notes to the right destination—work notes stay in your work folder, client calls go to client projects, personal thoughts go to personal notes
+- **Routes Intelligently**: Multi-signal classification sends notes to the right destination—work notes stay in your work folder, client calls go to client projects, personal thoughts go to personal notes. Tags are automatically deduplicated when multiple classification signals identify the same topic
 - **Preserves Everything**: This is NOT a summarizer. Protokoll preserves the full content of what you said while cleaning up filler words, false starts, and obvious transcription errors
 - **Improves Over Time**: The more you use it, the smarter it gets. Build context incrementally and watch transcription quality improve session after session
 - **Zero Configuration Start**: Works out of the box with sensible defaults. No API wrestling, no complex setup—just transcribe
@@ -583,6 +583,10 @@ protokoll term add --term "Kubernetes" --domain "devops" \
   --topics "containers,orchestration,cloud-native" \
   --projects "infrastructure"
 
+# Edit existing entities (incremental changes)
+protokoll project edit <id> --add-topic <topic> --add-phrase <phrase>
+protokoll term edit <id> --add-sound <variant> --add-project <id>
+
 # Update existing entity with new content (regenerates metadata)
 protokoll project update redaksjon https://github.com/user/redaksjon/README.md
 protokoll term update kubernetes https://kubernetes.io/docs/concepts/overview/
@@ -730,6 +734,35 @@ Override per-command with `--smart` or `--no-smart` flags.
 - OpenAI API key set in environment (`OPENAI_API_KEY`)
 - Network access for URL fetching and API calls
 
+### Editing Project Classification
+
+Modify how projects are matched to transcripts:
+
+```bash
+# Add trigger phrases (high-confidence matching)
+protokoll project edit work \
+  --add-phrase "work meeting" \
+  --add-phrase "office discussion"
+
+# Add topics (theme-based matching)
+protokoll project edit work \
+  --add-topic standup \
+  --add-topic sprint
+
+# Associate people (routes when mentioned)
+protokoll project edit client-alpha \
+  --add-person priya-sharma \
+  --add-person john-smith
+
+# Associate companies
+protokoll project edit client-work \
+  --add-company acme-corp
+```
+
+Use `protokoll project show <id>` to see all classification fields.
+
+**See:** [Context Commands Guide](./guide/context-commands.md#understanding-classification) for detailed explanation of each field.
+
 ### Example: Adding a Project
 
 The interactive prompt guides you through each field with explanations:
@@ -1229,6 +1262,29 @@ projects:  # Associated project IDs where this term is relevant
   - myapp
 ```
 
+### Project Relationships (Optional)
+
+If you have a parent project with subprojects, you can model the hierarchy. Protokoll will automatically suggest relationships when you create projects:
+
+```bash
+# When creating a project interactively, Protokoll suggests:
+protokoll project add --name "Kronologi"
+
+# [Suggested parent project: Redaksjon]
+#   Reason: topic "redaksjon-subproject" indicates subproject
+#   Confidence: high
+# Set "Redaksjon" as parent? (Y/n): y
+```
+
+Or edit relationships manually:
+
+```bash
+protokoll project edit kronologi --parent redaksjon --add-sibling protokoll
+```
+
+This helps routing and disambiguation. Most users won't need this.
+
+
 ## Routing System
 
 ### Multi-Signal Classification

package/dist/main.js

@@ -418,6 +418,156 @@ async function main() {
   }
 }
 
+const suggestRelationships = (context, options) => {
+  const allProjects = context.getAllProjects();
+  const allTerms = context.getAllTerms();
+  const suggestions = {};
+  const parentCandidates = findParentCandidates(allProjects, options);
+  if (parentCandidates.length > 0) {
+    suggestions.parent = parentCandidates[0];
+  }
+  const siblingCandidates = findSiblingCandidates(allProjects, options, suggestions.parent?.id);
+  if (siblingCandidates.length > 0) {
+    suggestions.siblings = siblingCandidates.slice(0, 5);
+  }
+  const termCandidates = findRelatedTerms(allTerms, options);
+  if (termCandidates.length > 0) {
+    suggestions.relatedTerms = termCandidates.slice(0, 5);
+  }
+  return suggestions;
+};
+function findParentCandidates(projects, options) {
+  const candidates = [];
+  for (const project of projects) {
+    if (project.id === options.projectId) continue;
+    const reasons = [];
+    let score = 0;
+    const projectNameLower = options.projectName.toLowerCase();
+    const candidateNameLower = project.name.toLowerCase();
+    if (projectNameLower.includes(candidateNameLower)) {
+      score += 50;
+      reasons.push(`name contains "${project.name}"`);
+    }
+    if (options.topics) {
+      const subprojectTopic = options.topics.find(
+        (t) => t.toLowerCase().includes(`${project.id}-subproject`) || t.toLowerCase().includes(`${candidateNameLower}-subproject`)
+      );
+      if (subprojectTopic) {
+        score += 100;
+        reasons.push(`topic "${subprojectTopic}" indicates subproject`);
+      }
+      const projectTopics = project.classification?.topics || [];
+      const sharedTopics = options.topics.filter(
+        (t) => projectTopics.some((pt) => pt.toLowerCase() === t.toLowerCase())
+      );
+      if (sharedTopics.length > 0) {
+        score += sharedTopics.length * 10;
+        reasons.push(`${sharedTopics.length} shared topics`);
+      }
+    }
+    if (options.destination && project.routing?.destination) {
+      if (options.destination.startsWith(project.routing.destination + "/")) {
+        score += 75;
+        reasons.push("destination is subdirectory");
+      }
+    }
+    if (options.description && options.description.toLowerCase().includes(candidateNameLower)) {
+      score += 25;
+      reasons.push("mentioned in description");
+    }
+    if (score > 0) {
+      candidates.push({ project, score, reasons });
+    }
+  }
+  const sorted = candidates.sort((a, b) => b.score - a.score);
+  return sorted.map((c) => ({
+    id: c.project.id,
+    name: c.project.name,
+    reason: c.reasons.join(", "),
+    confidence: c.score >= 75 ? "high" : c.score >= 40 ? "medium" : "low"
+  }));
+}
+function findSiblingCandidates(projects, options, suggestedParentId) {
+  const candidates = [];
+  for (const project of projects) {
+    if (project.id === options.projectId) continue;
+    const reasons = [];
+    let score = 0;
+    if (suggestedParentId && project.relationships?.parent === suggestedParentId) {
+      score += 100;
+      reasons.push(`shares parent "${suggestedParentId}"`);
+    }
+    if (options.topics) {
+      const projectTopics = project.classification?.topics || [];
+      const sharedTopics = options.topics.filter(
+        (t) => projectTopics.some((pt) => pt.toLowerCase() === t.toLowerCase())
+      );
+      if (sharedTopics.length >= 2) {
+        score += sharedTopics.length * 15;
+        reasons.push(`${sharedTopics.length} shared topics`);
+      }
+    }
+    if (options.destination && project.routing?.destination) {
+      const newDir = options.destination.split("/").slice(0, -1).join("/");
+      const projDir = project.routing.destination.split("/").slice(0, -1).join("/");
+      if (newDir === projDir) {
+        score += 30;
+        reasons.push("same destination directory");
+      }
+    }
+    if (score > 0) {
+      candidates.push({ project, score, reasons });
+    }
+  }
+  const sorted = candidates.sort((a, b) => b.score - a.score);
+  return sorted.map((c) => ({
+    id: c.project.id,
+    name: c.project.name,
+    reason: c.reasons.join(", ")
+  }));
+}
+function findRelatedTerms(terms, options) {
+  const candidates = [];
+  for (const term of terms) {
+    const reasons = [];
+    let score = 0;
+    const projectNameLower = options.projectName.toLowerCase();
+    const termNameLower = term.name.toLowerCase();
+    if (projectNameLower.includes(termNameLower)) {
+      score += 50;
+      reasons.push("appears in project name");
+    }
+    if (options.description && options.description.toLowerCase().includes(termNameLower)) {
+      score += 40;
+      reasons.push("mentioned in description");
+    }
+    if (options.topics && term.topics) {
+      const sharedTopics = options.topics.filter(
+        (t) => term.topics.some((tt) => tt.toLowerCase() === t.toLowerCase())
+      );
+      if (sharedTopics.length > 0) {
+        score += sharedTopics.length * 20;
+        reasons.push(`${sharedTopics.length} shared topics`);
+      }
+    }
+    if (options.topics) {
+      if (options.topics.some((t) => t.toLowerCase() === termNameLower)) {
+        score += 30;
+        reasons.push("matches project topic");
+      }
+    }
+    if (score > 0) {
+      candidates.push({ term, score, reasons });
+    }
+  }
+  const sorted = candidates.sort((a, b) => b.score - a.score);
+  return sorted.map((c) => ({
+    id: c.term.id,
+    name: c.term.name,
+    reason: c.reasons.join(", ")
+  }));
+}
+
 const print$2 = (text) => process.stdout.write(text + "\n");
 const calculateId = (name) => {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
@@ -628,6 +778,12 @@ const displayEntityDetails = (entity, filePath) => {
       if (project.classification.topics && project.classification.topics.length > 0) {
         rows.push(["Topics", formatValue$1(project.classification.topics)]);
       }
+      if (project.classification.associated_people && project.classification.associated_people.length > 0) {
+        rows.push(["Associated People", formatValue$1(project.classification.associated_people)]);
+      }
+      if (project.classification.associated_companies && project.classification.associated_companies.length > 0) {
+        rows.push(["Associated Companies", formatValue$1(project.classification.associated_companies)]);
+      }
     }
     if (project.routing) {
       if (project.routing.destination) {
@@ -641,15 +797,38 @@ const displayEntityDetails = (entity, filePath) => {
     if (project.sounds_like && project.sounds_like.length > 0) {
       rows.push(["Sounds Like", formatValue$1(project.sounds_like)]);
     }
+    if (project.relationships) {
+      const rel = project.relationships;
+      const relParts = [];
+      if (rel.parent) {
+        relParts.push(`Parent: ${rel.parent}`);
+      }
+      if (rel.children && rel.children.length > 0) {
+        relParts.push(`Children: ${rel.children.join(", ")}`);
+      }
+      if (rel.siblings && rel.siblings.length > 0) {
+        relParts.push(`Siblings: ${rel.siblings.join(", ")}`);
+      }
+      if (rel.relatedTerms && rel.relatedTerms.length > 0) {
+        relParts.push(`Related Terms: ${rel.relatedTerms.join(", ")}`);
+      }
+      if (relParts.length > 0) {
+        rows.push(["Relationships", relParts.join("\n  ")]);
+      }
+    }
     rows.push(["Active", project.active !== false ? "true" : "false"]);
     if (project.notes) rows.push(["Notes", project.notes]);
   } else if (entity.type === "term") {
     const term = entity;
     if (term.expansion) rows.push(["Expansion", term.expansion]);
     if (term.domain) rows.push(["Domain", term.domain]);
+    if (term.description) rows.push(["Description", term.description]);
     if (term.sounds_like && term.sounds_like.length > 0) {
       rows.push(["Sounds Like", formatValue$1(term.sounds_like)]);
     }
+    if (term.topics && term.topics.length > 0) {
+      rows.push(["Topics", formatValue$1(term.topics)]);
+    }
     if (term.projects && term.projects.length > 0) {
       rows.push(["Projects", formatValue$1(term.projects)]);
     }
@@ -984,6 +1163,60 @@ Description (Enter for suggested, or edit):
         }
       }
     }
+    let relationships;
+    if (!options.yes && (topics.length > 0 || description)) {
+      const relationshipSuggestions = suggestRelationships(context, {
+        projectName: name,
+        projectId: id,
+        topics,
+        destination,
+        description
+      });
+      if (relationshipSuggestions.parent && relationshipSuggestions.parent.confidence !== "low") {
+        print$2(`
+[Suggested parent project: ${relationshipSuggestions.parent.name}]`);
+        print$2(`  Reason: ${relationshipSuggestions.parent.reason}`);
+        print$2(`  Confidence: ${relationshipSuggestions.parent.confidence}`);
+        const parentAnswer = await askQuestion$1(rl, `Set "${relationshipSuggestions.parent.name}" as parent? (Y/n): `);
+        if (parentAnswer.toLowerCase() !== "n" && parentAnswer.toLowerCase() !== "no") {
+          relationships = relationships || {};
+          relationships.parent = relationshipSuggestions.parent.id;
+          print$2(`  ✓ Parent set to "${relationshipSuggestions.parent.name}"`);
+        }
+      }
+      if (relationshipSuggestions.siblings && relationshipSuggestions.siblings.length > 0) {
+        print$2(`
+[Suggested sibling projects:]`);
+        relationshipSuggestions.siblings.forEach((s, i) => {
+          print$2(`  ${i + 1}. ${s.name} (${s.reason})`);
+        });
+        const siblingsAnswer = await askQuestion$1(rl, "Add siblings? (Enter numbers comma-separated, or Enter to skip): ");
+        if (siblingsAnswer.trim()) {
+          const indices = siblingsAnswer.split(",").map((n) => parseInt(n.trim()) - 1).filter((i) => i >= 0 && i < relationshipSuggestions.siblings.length);
+          if (indices.length > 0) {
+            relationships = relationships || {};
+            relationships.siblings = indices.map((i) => relationshipSuggestions.siblings[i].id);
+            print$2(`  ✓ Added ${indices.length} siblings`);
+          }
+        }
+      }
+      if (relationshipSuggestions.relatedTerms && relationshipSuggestions.relatedTerms.length > 0) {
+        print$2(`
+[Suggested related terms:]`);
+        relationshipSuggestions.relatedTerms.forEach((t, i) => {
+          print$2(`  ${i + 1}. ${t.name} (${t.reason})`);
+        });
+        const termsAnswer = await askQuestion$1(rl, "Add related terms? (Enter numbers comma-separated, or Enter to skip): ");
+        if (termsAnswer.trim()) {
+          const indices = termsAnswer.split(",").map((n) => parseInt(n.trim()) - 1).filter((i) => i >= 0 && i < relationshipSuggestions.relatedTerms.length);
+          if (indices.length > 0) {
+            relationships = relationships || {};
+            relationships.relatedTerms = indices.map((i) => relationshipSuggestions.relatedTerms[i].id);
+            print$2(`  ✓ Added ${indices.length} related terms`);
+          }
+        }
+      }
+    }
     const project = {
       id,
       name,
@@ -1000,6 +1233,7 @@ Description (Enter for suggested, or edit):
       },
       ...soundsLike.length && { sounds_like: soundsLike },
       ...description && { description },
+      ...relationships && { relationships },
       active: true
     };
     await context.saveEntity(project);
@@ -1063,6 +1297,117 @@ Term "${name}" saved successfully.`);
     rl.close();
   }
 };
+const editProject = async (context, id, options) => {
+  const project = context.getProject(id);
+  if (!project) {
+    print$2(`Error: Project "${id}" not found`);
+    process.exit(1);
+  }
+  const mergeArray = (existing, add, remove) => {
+    let result = existing ? [...existing] : [];
+    if (add && add.length > 0) {
+      result = [...result, ...add.filter((v) => !result.includes(v))];
+    }
+    if (remove && remove.length > 0) {
+      result = result.filter((v) => !remove.includes(v));
+    }
+    return result.length > 0 ? result : void 0;
+  };
+  const changes = [];
+  const updated = { ...project };
+  if (options.name) {
+    updated.name = options.name;
+    changes.push(`name: "${options.name}"`);
+  }
+  if (options.description) {
+    updated.description = options.description;
+    changes.push(`description updated`);
+  }
+  if (options.active) {
+    updated.active = options.active === "true";
+    changes.push(`active: ${options.active}`);
+  }
+  const classification = { ...project.classification };
+  if (options.contextType) {
+    classification.context_type = options.contextType;
+    changes.push(`context_type: ${options.contextType}`);
+  }
+  const updatedTopics = mergeArray(classification.topics, options.addTopic, options.removeTopic);
+  if (updatedTopics !== void 0 && updatedTopics !== classification.topics) {
+    classification.topics = updatedTopics;
+    if (options.addTopic?.length) changes.push(`added ${options.addTopic.length} topics`);
+    if (options.removeTopic?.length) changes.push(`removed ${options.removeTopic.length} topics`);
+  }
+  const updatedPhrases = mergeArray(classification.explicit_phrases, options.addPhrase, options.removePhrase);
+  if (updatedPhrases !== void 0 && updatedPhrases !== classification.explicit_phrases) {
+    classification.explicit_phrases = updatedPhrases;
+    if (options.addPhrase?.length) changes.push(`added ${options.addPhrase.length} trigger phrases`);
+    if (options.removePhrase?.length) changes.push(`removed ${options.removePhrase.length} trigger phrases`);
+  }
+  const updatedPeople = mergeArray(classification.associated_people, options.addPerson, options.removePerson);
+  if (updatedPeople !== void 0 && updatedPeople !== classification.associated_people) {
+    classification.associated_people = updatedPeople;
+    if (options.addPerson?.length) changes.push(`added ${options.addPerson.length} associated people`);
+    if (options.removePerson?.length) changes.push(`removed ${options.removePerson.length} associated people`);
+  }
+  const updatedCompanies = mergeArray(classification.associated_companies, options.addCompany, options.removeCompany);
+  if (updatedCompanies !== void 0 && updatedCompanies !== classification.associated_companies) {
+    classification.associated_companies = updatedCompanies;
+    if (options.addCompany?.length) changes.push(`added ${options.addCompany.length} associated companies`);
+    if (options.removeCompany?.length) changes.push(`removed ${options.removeCompany.length} associated companies`);
+  }
+  updated.classification = classification;
+  const routing = { ...project.routing };
+  if (options.destination) {
+    routing.destination = options.destination;
+    changes.push(`destination: ${options.destination}`);
+  }
+  if (options.structure) {
+    routing.structure = options.structure;
+    changes.push(`structure: ${options.structure}`);
+  }
+  updated.routing = routing;
+  if (options.parent || options.addChild || options.removeChild || options.addSibling || options.removeSibling || options.addTerm || options.removeTerm) {
+    const existingRel = project.relationships || {};
+    const relationships = { ...existingRel };
+    if (options.parent) {
+      relationships.parent = options.parent;
+      changes.push(`parent: ${options.parent}`);
+    }
+    const updatedChildren = mergeArray(existingRel.children, options.addChild, options.removeChild);
+    if (updatedChildren) {
+      relationships.children = updatedChildren;
+      if (options.addChild?.length) changes.push(`added ${options.addChild.length} children`);
+      if (options.removeChild?.length) changes.push(`removed ${options.removeChild.length} children`);
+    }
+    const updatedSiblings = mergeArray(existingRel.siblings, options.addSibling, options.removeSibling);
+    if (updatedSiblings) {
+      relationships.siblings = updatedSiblings;
+      if (options.addSibling?.length) changes.push(`added ${options.addSibling.length} siblings`);
+      if (options.removeSibling?.length) changes.push(`removed ${options.removeSibling.length} siblings`);
+    }
+    const updatedRelatedTerms = mergeArray(existingRel.relatedTerms, options.addTerm, options.removeTerm);
+    if (updatedRelatedTerms) {
+      relationships.relatedTerms = updatedRelatedTerms;
+      if (options.addTerm?.length) changes.push(`added ${options.addTerm.length} related terms`);
+      if (options.removeTerm?.length) changes.push(`removed ${options.removeTerm.length} related terms`);
+    }
+    updated.relationships = relationships;
+  }
+  updated.updatedAt = /* @__PURE__ */ new Date();
+  await context.saveEntity(updated);
+  if (changes.length > 0) {
+    print$2(`
+✓ Updated project "${project.name}":`);
+    changes.forEach((c) => print$2(`  • ${c}`));
+    print$2("");
+  } else {
+    print$2(`
+No changes made to project "${project.name}"
+`);
+  }
+  displayEntityDetails(updated);
+};
 const updateProject = async (context, id, source, options) => {
   const existingProject = context.getProject(id);
   if (!existingProject) {
@@ -1112,6 +1457,68 @@ Updating project: ${existingProject.name} (${existingProject.id})`);
   print$2(`
 ✓ Project "${existingProject.name}" updated successfully.`);
 };
+const editTerm = async (context, id, options) => {
+  const term = context.getTerm(id);
+  if (!term) {
+    print$2(`Error: Term "${id}" not found`);
+    process.exit(1);
+  }
+  const mergeArray = (existing, add, remove) => {
+    let result = existing ? [...existing] : [];
+    if (add && add.length > 0) {
+      result = [...result, ...add.filter((v) => !result.includes(v))];
+    }
+    if (remove && remove.length > 0) {
+      result = result.filter((v) => !remove.includes(v));
+    }
+    return result.length > 0 ? result : void 0;
+  };
+  const changes = [];
+  const updated = { ...term };
+  if (options.description) {
+    updated.description = options.description;
+    changes.push("description updated");
+  }
+  if (options.domain) {
+    updated.domain = options.domain;
+    changes.push(`domain: ${options.domain}`);
+  }
+  if (options.expansion) {
+    updated.expansion = options.expansion;
+    changes.push(`expansion: ${options.expansion}`);
+  }
+  const updatedSounds = mergeArray(term.sounds_like, options.addSound, options.removeSound);
+  if (updatedSounds !== term.sounds_like) {
+    updated.sounds_like = updatedSounds;
+    if (options.addSound?.length) changes.push(`added ${options.addSound.length} sounds_like variants`);
+    if (options.removeSound?.length) changes.push(`removed ${options.removeSound.length} sounds_like variants`);
+  }
+  const updatedTopics = mergeArray(term.topics, options.addTopic, options.removeTopic);
+  if (updatedTopics !== term.topics) {
+    updated.topics = updatedTopics;
+    if (options.addTopic?.length) changes.push(`added ${options.addTopic.length} topics`);
+    if (options.removeTopic?.length) changes.push(`removed ${options.removeTopic.length} topics`);
+  }
+  const updatedProjects = mergeArray(term.projects, options.addProject, options.removeProject);
+  if (updatedProjects !== term.projects) {
+    updated.projects = updatedProjects;
+    if (options.addProject?.length) changes.push(`added ${options.addProject.length} project associations`);
+    if (options.removeProject?.length) changes.push(`removed ${options.removeProject.length} project associations`);
+  }
+  updated.updatedAt = /* @__PURE__ */ new Date();
+  await context.saveEntity(updated);
+  if (changes.length > 0) {
+    print$2(`
+✓ Updated term "${term.name}":`);
+    changes.forEach((c) => print$2(`  • ${c}`));
+    print$2("");
+  } else {
+    print$2(`
+No changes made to term "${term.name}"
+`);
+  }
+  displayEntityDetails(updated);
+};
 const updateTerm = async (context, id, source, options) => {
   const existingTerm = context.getTerm(id);
   if (!existingTerm) {
@@ -1396,6 +1803,14 @@ const createProjectCommand = () => {
     }
     await addProject(context, { source, ...cmdOptions });
   });
+  cmd.command("edit <id>").description("Edit project fields (classification, routing, relationships)").option("--name <name>", "Update project name").option("--description <text>", "Update description").option("--destination <path>", "Update routing destination").option("--structure <type>", "Update directory structure: none, year, month, day").option("--context-type <type>", "Update context type: work, personal, mixed").option("--add-topic <topic>", "Add a classification topic (repeatable)", collect, []).option("--remove-topic <topic>", "Remove a classification topic (repeatable)", collect, []).option("--add-phrase <phrase>", "Add trigger phrase (repeatable)", collect, []).option("--remove-phrase <phrase>", "Remove trigger phrase (repeatable)", collect, []).option("--add-person <id>", "Associate person ID (repeatable)", collect, []).option("--remove-person <id>", "Remove associated person (repeatable)", collect, []).option("--add-company <id>", "Associate company ID (repeatable)", collect, []).option("--remove-company <id>", "Remove associated company (repeatable)", collect, []).option("--parent <id>", "Set parent project ID").option("--add-child <id>", "Add child project (repeatable)", collect, []).option("--remove-child <id>", "Remove child project (repeatable)", collect, []).option("--add-sibling <id>", "Add sibling project (repeatable)", collect, []).option("--remove-sibling <id>", "Remove sibling project (repeatable)", collect, []).option("--add-term <id>", "Add related term (repeatable)", collect, []).option("--remove-term <id>", "Remove related term (repeatable)", collect, []).option("--active <bool>", "Set active status (true/false)").action(async (id, options) => {
+    const context = await create$5();
+    if (!context.hasContext()) {
+      print$2("Error: No .protokoll directory found.");
+      process.exit(1);
+    }
+    await editProject(context, id, options);
+  });
   cmd.command("delete <id>").description("Delete a project").option("-f, --force", "Skip confirmation").action(async (id, options) => {
     const context = await create$5();
     await deleteEntity(context, "project", id, options);
@@ -1410,6 +1825,9 @@ const createProjectCommand = () => {
   });
   return cmd;
 };
+function collect(value, previous) {
+  return previous.concat([value]);
+}
 const createTermCommand = () => {
   const cmd = new Command("term").description("Manage terms");
   cmd.command("list").description("List all terms").option("-v, --verbose", "Show full details").action(async (options) => {
@@ -1428,6 +1846,14 @@ const createTermCommand = () => {
     }
     await addTermEnhanced(context, { source, ...cmdOptions });
   });
+  cmd.command("edit <id>").description("Edit term fields (sounds_like, projects, metadata)").option("--description <text>", "Update description").option("--domain <domain>", "Update domain").option("--expansion <text>", "Update expansion").option("--add-sound <variant>", "Add sounds_like variant (repeatable)", collect, []).option("--remove-sound <variant>", "Remove sounds_like variant (repeatable)", collect, []).option("--add-topic <topic>", "Add topic (repeatable)", collect, []).option("--remove-topic <topic>", "Remove topic (repeatable)", collect, []).option("--add-project <id>", "Associate with project (repeatable)", collect, []).option("--remove-project <id>", "Remove project association (repeatable)", collect, []).action(async (id, options) => {
+    const context = await create$5();
+    if (!context.hasContext()) {
+      print$2("Error: No .protokoll directory found.");
+      process.exit(1);
+    }
+    await editTerm(context, id, options);
+  });
   cmd.command("delete <id>").description("Delete a term").option("-f, --force", "Skip confirmation").action(async (id, options) => {
     const context = await create$5();
     await deleteEntity(context, "term", id, options);