@takemo101/mikan 0.0.6 → 0.0.8

package/README.md

@@ -2,6 +2,8 @@
 
 mikan is a tiny local-first Issue board for AI-assisted development. It stores Issues as Markdown files under `.mikan/` and exposes the same board through a CLI, keyboard-first TUI, stdio MCP server, and polling watcher.
 
+Manual: <https://takemo101.github.io/mikan/>
+
 ## Install
 
 ```sh
@@ -17,7 +19,7 @@ mikan is currently built for Bun-based execution. The npm package installs the `
 
 - **Markdown source of truth**: each Issue is a file such as `.mikan/ready/MIK-001.md`.
 - **Primitive CLI commands**: `init`, `add`, `list`, `show`, `update`, `move`, `append`, `github`, `tui`, `watch`, `mcp`, `skills`.
-- **Keyboard TUI**: board-first flow with detail view, Note modal, Move shortcuts, and Archive confirmation.
+- **Keyboard TUI**: board-first flow with detail view, Label/Note/Warning modals, Move shortcuts, and Archive confirmation.
 - **MCP server**: stdio tools for agents: `get_board`, `list_issues`, `get_issue`, `create_issue`, `update_issue`, `move_issue`, `append_issue`, `mirror_issue_to_github`.
 - **GitHub Mirror**: explicit one-way publication from local Markdown Issues to GitHub Issues.
 - **Agent setup**: register the MCP server or install agent guidance for common AI agents.

package/dist/bin.js

@@ -100301,8 +100301,12 @@ function updateIssue(options) {
     const target = findIssueById(options);
     if (!target.ok)
       return target;
-    const labels = options.labels ?? target.value.issue.labels.map(String);
-    const labelsValidation = validateLabels(options.config, labels);
+    const existingLabels = target.value.issue.labels.map(String);
+    const configuredLabelIds = new Set(options.config.labels.map((label) => label.id));
+    const existingUnknownLabels = new Set(existingLabels.filter((label) => !configuredLabelIds.has(label)));
+    const labels = options.labels ?? existingLabels;
+    const labelsToValidate = options.preserveUnknownLabels ? labels.filter((label) => !existingUnknownLabels.has(label)) : labels;
+    const labelsValidation = validateLabels(options.config, labelsToValidate);
     if (!labelsValidation.ok)
       return labelsValidation;
     const dependenciesValidation = options.dependencies ? validateDependencies(options.dependencies) : undefined;
@@ -100798,9 +100802,18 @@ var labelSchema = exports_external.object({
   id: nonEmptyString,
   title: nonEmptyString
 });
+var hookEntrySchema = exports_external.union([
+  nonEmptyString,
+  exports_external.object({
+    command: nonEmptyString,
+    when: exports_external.object({
+      labels_include: exports_external.array(nonEmptyString).min(1).optional()
+    }).optional()
+  })
+]);
 var hookSchema = exports_external.object({
-  on_enter: exports_external.record(exports_external.string(), exports_external.array(exports_external.string())).optional(),
-  on_transition: exports_external.record(exports_external.string(), exports_external.array(exports_external.string())).optional()
+  on_enter: exports_external.record(exports_external.string(), exports_external.array(hookEntrySchema)).optional(),
+  on_transition: exports_external.record(exports_external.string(), exports_external.array(hookEntrySchema)).optional()
 });
 var githubSchema = exports_external.object({
   repo: githubRepoSchema,
@@ -107389,7 +107402,7 @@ var import_react20 = __toESM(require_react(), 1);
 // package.json
 var package_default = {
   name: "@takemo101/mikan",
-  version: "0.0.6",
+  version: "0.0.8",
   private: false,
   type: "module",
   bin: {
@@ -107453,13 +107466,16 @@ function visibleDetailLineCount(viewportHeight) {
   return Math.max(1, viewportHeight - 8);
 }
 function footerText(mode) {
+  if (mode === "note-modal") {
+    return "Note | Enter newline | Ctrl+S save | Esc cancel";
+  }
   if (mode === "modal") {
     return "Modal | enter confirm | esc cancel | ? keys";
   }
   if (mode === "detail") {
-    return "Detail | \u2191\u2193 scroll | g github | esc board | ? keys";
+    return "Detail | \u2191\u2193 scroll | esc board | ? keys";
   }
-  return "Board | \u2191\u2193 card | \u2190\u2192 column | enter detail | g github | ? keys";
+  return "Board | \u2191\u2193 card | \u2190\u2192 column | enter detail | ? keys";
 }
 
 // ../tui/src/selection.ts
@@ -107566,6 +107582,7 @@ function buildTuiModel(board, labels = [], githubRepo) {
     })),
     warnings: board.warnings.map(formatWarning),
     ...board.warnings.length > 0 ? { warningDetails: board.warnings.map(formatTuiWarning) } : {},
+    labels: labels.map((label) => ({ id: label.id, title: label.title })),
     labelTitles: Object.fromEntries(labels.map((label) => [label.id, label.title])),
     githubRepo
   };
@@ -107940,7 +107957,7 @@ function moveSelection(model, selection, direction, options = {}) {
       message: undefined
     };
   }
-  if (selection.detailOpen && !selection.moveOpen && !selection.noteOpen) {
+  if (selection.detailOpen && !selection.moveOpen && !selection.noteOpen && !selection.labelOpen) {
     if (direction === "up" || direction === "down") {
       return {
         ...selection,
@@ -107961,6 +107978,9 @@ function moveSelection(model, selection, direction, options = {}) {
     if (selection.githubConfirmOpen) {
       return { ...selection, githubConfirmOpen: false };
     }
+    if (selection.labelOpen) {
+      return { ...selection, labelOpen: false };
+    }
     if (selection.warningsOpen) {
       return { ...selection, warningsOpen: false };
     }
@@ -107968,7 +107988,10 @@ function moveSelection(model, selection, direction, options = {}) {
       ...selection,
       detailOpen: false,
       moveOpen: false,
-      noteOpen: false
+      noteOpen: false,
+      noteDraft: undefined,
+      labelOpen: false,
+      message: selection.noteOpen ? undefined : selection.message
     };
   }
   if (direction === "move") {
@@ -107977,6 +108000,8 @@ function moveSelection(model, selection, direction, options = {}) {
       archiveOpen: false,
       detailOpen: false,
       noteOpen: false,
+      noteDraft: undefined,
+      labelOpen: false,
       moveOpen: true,
       moveTargetIndex: 0
     };
@@ -107987,7 +108012,25 @@ function moveSelection(model, selection, direction, options = {}) {
       archiveOpen: false,
       detailOpen: false,
       moveOpen: false,
-      noteOpen: true
+      labelOpen: false,
+      noteOpen: true,
+      noteDraft: "",
+      message: undefined
+    };
+  }
+  if (direction === "edit-labels") {
+    const card = model.columns[selection.columnIndex]?.cards[selection.cardIndex];
+    const knownLabelIds = new Set((model.labels ?? []).map((label) => label.id));
+    return {
+      ...selection,
+      archiveOpen: false,
+      githubConfirmOpen: false,
+      moveOpen: false,
+      noteOpen: false,
+      noteDraft: undefined,
+      labelOpen: true,
+      labelFocusIndex: 0,
+      labelDraftIds: card?.labels.filter((label) => knownLabelIds.has(label)) ?? []
     };
   }
   if (direction === "archive") {
@@ -107996,6 +108039,8 @@ function moveSelection(model, selection, direction, options = {}) {
       archiveOpen: true,
       moveOpen: false,
       noteOpen: false,
+      noteDraft: undefined,
+      labelOpen: false,
       githubConfirmOpen: false
     };
   }
@@ -108005,6 +108050,8 @@ function moveSelection(model, selection, direction, options = {}) {
       archiveOpen: false,
       moveOpen: false,
       noteOpen: false,
+      noteDraft: undefined,
+      labelOpen: false,
       githubConfirmOpen: true
     };
   }
@@ -108036,28 +108083,38 @@ function getAdjacentMoveTarget(model, selection, direction) {
   const column = model.columns[selection.columnIndex + offset];
   return column ? { id: column.id, title: column.title } : undefined;
 }
-function applyNoteInput(selection, keyName2, shift = false) {
-  if (!selection.noteOpen || !keyName2)
+function moveLabelFocus(model, selection, direction) {
+  if (!selection.labelOpen)
     return selection;
-  if (keyName2 === "backspace") {
-    return {
-      ...selection,
-      noteDraft: (selection.noteDraft ?? "").slice(0, -1)
-    };
-  }
-  const character = keyName2 === "space" ? " " : keyName2;
-  if (character.length !== 1)
+  return {
+    ...selection,
+    labelFocusIndex: clamp((selection.labelFocusIndex ?? 0) + (direction === "down" ? 1 : -1), 0, Math.max(0, (model.labels ?? []).length - 1))
+  };
+}
+function toggleFocusedLabel(model, selection) {
+  if (!selection.labelOpen)
+    return selection;
+  const label = (model.labels ?? [])[selection.labelFocusIndex ?? 0];
+  if (!label)
     return selection;
-  const value = shift && /[a-z]/.test(character) ? character.toUpperCase() : character;
-  return { ...selection, noteDraft: `${selection.noteDraft ?? ""}${value}` };
+  const current = new Set(selection.labelDraftIds ?? []);
+  if (current.has(label.id))
+    current.delete(label.id);
+  else
+    current.add(label.id);
+  return { ...selection, labelDraftIds: [...current] };
 }
 function footerMode(selection) {
-  if (selection.moveOpen || selection.noteOpen || selection.archiveOpen || selection.githubConfirmOpen) {
+  if (selection.noteOpen)
+    return "note-modal";
+  if (selection.moveOpen || selection.labelOpen || selection.archiveOpen || selection.githubConfirmOpen) {
     return "modal";
   }
   return selection.detailOpen ? "detail" : "board";
 }
-function keyToTuiAction(keyName2, shift = false) {
+function keyToTuiAction(keyName2, shift = false, ctrl = false) {
+  if (ctrl && keyName2 === "s")
+    return "save-note";
   if (shift && keyName2 === "h")
     return "move-left";
   if (shift && keyName2 === "l")
@@ -108090,6 +108147,8 @@ function keyToTuiAction(keyName2, shift = false) {
       return "move";
     case "n":
       return "append-note";
+    case "e":
+      return "edit-labels";
     case "a":
       return "archive";
     case "g":
@@ -108136,8 +108195,31 @@ function buildNotePromptViewModel(model, selection) {
   return {
     title: `Append note to ${card.id}`,
     focused: Boolean(selection.noteOpen),
-    draft: selection.noteDraft ?? "",
-    hint: "enter append  esc cancel"
+    feedback: selection.message === "Note cannot be empty" ? selection.message : undefined,
+    hint: "Enter newline | Ctrl+S save | Esc cancel"
+  };
+}
+function buildLabelPromptViewModel(model, selection) {
+  const card = model.columns[selection.columnIndex]?.cards[selection.cardIndex];
+  if (!card)
+    return;
+  const configuredLabels = model.labels ?? [];
+  const draft = new Set(selection.labelDraftIds ?? card.labels);
+  const known = new Set(configuredLabels.map((label) => label.id));
+  return {
+    title: `Edit Labels for ${card.id}`,
+    focused: Boolean(selection.labelOpen),
+    labels: configuredLabels.map((label, index2) => ({
+      id: label.id,
+      title: label.title,
+      checked: draft.has(label.id),
+      focused: index2 === (selection.labelFocusIndex ?? 0)
+    })),
+    unknownLabels: card.labels.filter((label) => !known.has(label)),
+    ...configuredLabels.length === 0 ? {
+      emptyMessage: "No Labels configured. Add Labels in .mikan/config.yaml."
+    } : {},
+    hint: configuredLabels.length === 0 ? "esc close" : "space toggle  enter save  esc cancel"
   };
 }
 function buildArchivePromptViewModel(model, selection) {
@@ -108166,66 +108248,174 @@ Local Markdown remains the source of truth.`,
   };
 }
 
+// ../tui/src/prompt-text.ts
+function renderMoveInteraction(model, selection) {
+  const view = buildMovePromptViewModel(model, selection);
+  if (!view)
+    return ["Move", "No Issue selected"];
+  return [
+    `${view.title} to Status`,
+    ...view.targets.map((target) => `${target.selected ? ">" : " "} ${target.id} (${target.title})`),
+    view.hint
+  ];
+}
+function renderLabelInteraction(model, selection) {
+  const view = buildLabelPromptViewModel(model, selection);
+  if (!view)
+    return ["Edit Labels", "No Issue selected"];
+  if (view.emptyMessage) {
+    return [view.title, "", view.emptyMessage, "", view.hint];
+  }
+  return [
+    view.title,
+    "",
+    ...view.labels.map((label) => `${label.focused ? "\u25B6" : " "} [${label.checked ? "x" : " "}] ${label.title}`),
+    ...view.unknownLabels.length > 0 ? ["", `Unknown Labels (read-only): ${view.unknownLabels.join(", ")}`] : [],
+    "",
+    view.hint
+  ];
+}
+function renderArchiveInteraction(model, selection) {
+  const view = buildArchivePromptViewModel(model, selection);
+  if (!view)
+    return ["Archive", "No Issue selected"];
+  return [view.title, view.body, view.hint];
+}
+function renderGitHubMirrorInteraction(model, selection) {
+  const view = buildGitHubMirrorPromptViewModel(model, selection);
+  if (!view)
+    return ["GitHub Mirror", "No Issue selected"];
+  return [view.title, view.body, view.hint];
+}
+function renderWarningDetails(model) {
+  return [
+    "Warning details",
+    ...model.warnings.length > 0 ? model.warnings.map((warning) => `! ${warning}`) : ["No warnings"]
+  ];
+}
+function renderKeyHelp() {
+  return [
+    "Key help",
+    "\u2191/\u2193 or j/k card/scroll",
+    "\u2190/\u2192 or h/l column",
+    "enter detail/confirm",
+    "esc back/cancel",
+    "H/L move Issue",
+    "m move menu",
+    "n append Note",
+    "note: enter newline, ctrl+s save",
+    "e edit Labels",
+    "a archive Issue",
+    "g GitHub Mirror",
+    "w warning details",
+    "r reload",
+    "q quit"
+  ];
+}
+
 // ../tui/src/modals.ts
 function MovePrompt(props) {
-  const theme = props.theme ?? buildTuiTheme();
-  return import_react3.default.createElement("box", {
-    id: "move-modal-backdrop",
-    style: modalBackdropStyle(theme)
-  }, import_react3.default.createElement("box", {
-    id: "move-prompt",
+  return renderModalText({
+    theme: props.theme,
+    backdropId: "move-modal-backdrop",
+    panelId: "move-prompt",
     title: "Move Issue",
-    border: true,
-    style: modalStyle(theme)
-  }, import_react3.default.createElement("text", {
-    content: renderMoveInteraction(props.model, props.selection).join(`
-`)
-  })));
+    content: renderMoveInteraction(props.model, props.selection)
+  });
 }
 function NotePrompt(props) {
-  const theme = props.theme ?? buildTuiTheme();
-  return import_react3.default.createElement("box", {
-    id: "note-modal-backdrop",
-    style: modalBackdropStyle(theme)
-  }, import_react3.default.createElement("box", {
-    id: "note-prompt",
+  const view = buildNotePromptViewModel(props.model, props.selection);
+  if (!view) {
+    return renderModalText({
+      theme: props.theme,
+      backdropId: "note-modal-backdrop",
+      panelId: "note-prompt",
+      title: "Append Note",
+      content: ["Append note", "No Issue selected"]
+    });
+  }
+  const initialValue = props.selection.noteDraft ?? "";
+  return renderModalShell({
+    theme: props.theme,
+    backdropId: "note-modal-backdrop",
+    panelId: "note-prompt",
     title: "Append Note",
-    border: true,
-    style: modalStyle(theme)
+    panelStyle: { height: view.feedback ? 14 : 13 }
   }, import_react3.default.createElement("text", {
-    content: renderNoteInteraction(props.model, props.selection).join(`
+    content: [view.title, "", "Note:"].join(`
 `)
-  })));
+  }), import_react3.default.createElement("textarea", {
+    id: "note-textarea",
+    ref: props.noteTextareaRef,
+    focused: true,
+    initialValue,
+    placeholder: "Write a Note...",
+    height: 5,
+    wrapMode: "word",
+    keyBindings: [{ name: "s", ctrl: true, action: "submit" }],
+    onSubmit: () => {
+      props.onNoteSubmit?.(props.noteTextareaRef?.current?.plainText ?? "");
+    },
+    style: {
+      alignSelf: "stretch",
+      backgroundColor: props.theme?.base.canvas,
+      textColor: props.theme?.base.text,
+      focusedBackgroundColor: props.theme?.base.canvas,
+      focusedTextColor: props.theme?.base.text,
+      width: "auto"
+    }
+  }), import_react3.default.createElement("text", {
+    content: ["", ...view.feedback ? [view.feedback] : [], view.hint].join(`
+`)
+  }));
+}
+function LabelPrompt(props) {
+  return renderModalText({
+    theme: props.theme,
+    backdropId: "label-modal-backdrop",
+    panelId: "label-prompt",
+    title: "Edit Labels",
+    content: renderLabelInteraction(props.model, props.selection)
+  });
 }
 function ArchivePrompt(props) {
-  const theme = props.theme ?? buildTuiTheme();
-  return import_react3.default.createElement("box", {
-    id: "archive-modal-backdrop",
-    style: modalBackdropStyle(theme)
-  }, import_react3.default.createElement("box", {
-    id: "archive-prompt",
+  return renderModalText({
+    theme: props.theme,
+    backdropId: "archive-modal-backdrop",
+    panelId: "archive-prompt",
     title: "Archive Issue",
-    border: true,
-    style: modalStyle(theme)
-  }, import_react3.default.createElement("text", {
-    content: renderArchiveInteraction(props.model, props.selection).join(`
-`)
-  })));
+    content: renderArchiveInteraction(props.model, props.selection)
+  });
 }
 function GitHubMirrorPrompt(props) {
-  const theme = props.theme ?? buildTuiTheme();
+  return renderModalText({
+    theme: props.theme,
+    backdropId: "github-mirror-modal-backdrop",
+    panelId: "github-mirror-prompt",
+    title: "GitHub Mirror",
+    content: renderGitHubMirrorInteraction(props.model, props.selection)
+  });
+}
+function renderModalText(options) {
+  return renderModalShell(options, import_react3.default.createElement("text", {
+    content: options.content.join(`
+`)
+  }));
+}
+function renderModalShell(options, ...children) {
+  const theme = options.theme ?? buildTuiTheme();
   return import_react3.default.createElement("box", {
-    id: "github-mirror-modal-backdrop",
+    id: options.backdropId,
     style: modalBackdropStyle(theme)
   }, import_react3.default.createElement("box", {
-    id: "github-mirror-prompt",
-    title: "GitHub Mirror",
+    id: options.panelId,
+    title: options.title,
     border: true,
-    style: modalStyle(theme)
-  }, import_react3.default.createElement("text", {
-    content: renderGitHubMirrorInteraction(props.model, props.selection).join(`
-`)
-  })));
+    style: {
+      ...modalStyle(theme),
+      ...options.panelStyle ?? {}
+    }
+  }, ...children));
 }
 function modalBackdropStyle(_theme) {
   return {
@@ -108250,83 +108440,24 @@ function modalStyle(theme) {
   };
 }
 function HelpPanel(props) {
-  const theme = props.theme ?? buildTuiTheme();
-  return import_react3.default.createElement("box", {
-    id: "help-panel-backdrop",
-    style: modalBackdropStyle(theme)
-  }, import_react3.default.createElement("box", {
-    id: "help-panel",
+  return renderModalText({
+    theme: props.theme,
+    backdropId: "help-panel-backdrop",
+    panelId: "help-panel",
     title: "Key help",
-    border: true,
-    style: modalStyle(theme)
-  }, import_react3.default.createElement("text", { content: renderKeyHelp().join(`
-`) })));
+    content: renderKeyHelp()
+  });
 }
 function WarningPanel(props) {
   const theme = props.theme ?? buildTuiTheme();
-  return import_react3.default.createElement("box", {
-    id: "warning-panel",
+  return renderModalText({
+    theme,
+    backdropId: "warning-panel-backdrop",
+    panelId: "warning-panel",
     title: "Warning details",
-    border: true,
-    style: {
-      backgroundColor: theme.base.surface,
-      borderColor: theme.feedback.warning,
-      flexDirection: "column"
-    }
-  }, import_react3.default.createElement("text", {
-    content: props.model.warnings.length > 0 ? props.model.warnings.map((warning) => `! ${warning}`).join(`
-`) : "No warnings"
-  }));
-}
-function renderMoveInteraction(model, selection) {
-  const view = buildMovePromptViewModel(model, selection);
-  if (!view)
-    return ["Move", "No Issue selected"];
-  return [
-    `${view.title} to Status`,
-    ...view.targets.map((target) => `${target.selected ? ">" : " "} ${target.id} (${target.title})`),
-    view.hint
-  ];
-}
-function renderNoteInteraction(model, selection) {
-  const view = buildNotePromptViewModel(model, selection);
-  if (!view)
-    return ["Append note", "No Issue selected"];
-  return [
-    view.title,
-    `Note: ${view.draft}`,
-    ...view.feedback ? [view.feedback] : [],
-    view.hint
-  ];
-}
-function renderArchiveInteraction(model, selection) {
-  const view = buildArchivePromptViewModel(model, selection);
-  if (!view)
-    return ["Archive", "No Issue selected"];
-  return [view.title, view.body, view.hint];
-}
-function renderGitHubMirrorInteraction(model, selection) {
-  const view = buildGitHubMirrorPromptViewModel(model, selection);
-  if (!view)
-    return ["GitHub Mirror", "No Issue selected"];
-  return [view.title, view.body, view.hint];
-}
-function renderKeyHelp() {
-  return [
-    "Key help",
-    "\u2191/\u2193 or j/k card/scroll",
-    "\u2190/\u2192 or h/l column",
-    "enter detail/confirm",
-    "esc back/cancel",
-    "H/L move Issue",
-    "m move menu",
-    "n append Note",
-    "a archive Issue",
-    "g GitHub Mirror",
-    "w warning details",
-    "r reload",
-    "q quit"
-  ];
+    content: renderWarningDetails(props.model).slice(1),
+    panelStyle: { borderColor: theme.feedback.warning }
+  });
 }
 
 // ../tui/src/mutations.ts
@@ -108347,6 +108478,9 @@ function refreshTuiModel(options) {
       moveTargetIndex: stillSelected ? options.selection.moveTargetIndex : undefined,
       noteOpen: stillSelected ? options.selection.noteOpen : false,
       noteDraft: stillSelected ? options.selection.noteDraft : undefined,
+      labelOpen: stillSelected ? options.selection.labelOpen : false,
+      labelFocusIndex: stillSelected ? options.selection.labelFocusIndex : undefined,
+      labelDraftIds: stillSelected ? options.selection.labelDraftIds : undefined,
       message: options.selection.message,
       archiveOpen: stillSelected ? options.selection.archiveOpen : false,
       githubConfirmOpen: stillSelected ? options.selection.githubConfirmOpen : false,
@@ -108439,6 +108573,59 @@ function archiveSelectedIssue(options) {
     selection: { ...result.selection, archiveOpen: false }
   } : result;
 }
+function updateSelectedIssueLabels(options) {
+  const card = selectedCard(options.model, options.selection);
+  if (!card) {
+    return {
+      ok: false,
+      model: options.model,
+      selection: { ...options.selection, labelOpen: false },
+      message: "No Issue selected"
+    };
+  }
+  const loaded = loadProjectConfig(options.cwd ?? process.cwd());
+  if (!loaded.ok) {
+    return {
+      ok: false,
+      model: options.model,
+      selection: { ...options.selection, labelOpen: false },
+      message: loaded.error.message
+    };
+  }
+  const selectedKnown = new Set(options.selection.labelDraftIds ?? []);
+  const configuredIds = loaded.value.config.labels.map((label) => label.id);
+  const configuredSet = new Set(configuredIds);
+  const knownLabels = configuredIds.filter((label) => selectedKnown.has(label));
+  const unknownLabels = card.labels.filter((label) => !configuredSet.has(label));
+  const updated = updateIssue({
+    projectRoot: loaded.value.projectRoot,
+    config: loaded.value.config,
+    id: card.id,
+    labels: [...knownLabels, ...unknownLabels],
+    preserveUnknownLabels: true,
+    now: options.now
+  });
+  if (!updated.ok) {
+    return {
+      ok: false,
+      model: options.model,
+      selection: { ...options.selection, labelOpen: false },
+      message: updated.error.message
+    };
+  }
+  const model = loadTuiModel(options.cwd);
+  const selection = findSelectionByCardId(model, card.id) ?? clampSelection(model, options.selection);
+  return {
+    ok: true,
+    model,
+    selection: {
+      ...selection,
+      detailOpen: options.selection.detailOpen,
+      labelOpen: false
+    },
+    message: `${card.id} Labels updated`
+  };
+}
 async function beginSelectedIssueGitHubMirror(options) {
   if (options.selection.githubBusy)
     return githubAlreadyRunning(options);
@@ -108608,7 +108795,7 @@ function appendSelectedIssueNote(options) {
     return {
       ok: false,
       model: options.model,
-      selection: { ...options.selection, noteOpen: false },
+      selection: { ...options.selection, noteOpen: true },
       message: "Note cannot be empty"
     };
   }
@@ -108655,7 +108842,8 @@ function appendSelectedIssueNote(options) {
     selection: {
       ...selection,
       detailOpen: options.selection.detailOpen,
-      noteOpen: false
+      noteOpen: false,
+      noteDraft: undefined
     },
     message: `${card.id} note appended`
   };
@@ -108672,7 +108860,9 @@ function TuiAppView({
   theme = buildTuiTheme(),
   viewportHeight,
   viewportWidth,
-  columns
+  columns,
+  noteTextareaRef,
+  onNoteSubmit
 }) {
   const details = selection.detailOpen ? getSelectedDetails(model, selection) : undefined;
   return import_react20.default.createElement("box", {
@@ -108698,7 +108888,13 @@ function TuiAppView({
     viewportHeight,
     viewportWidth,
     columns
-  })), selection.moveOpen ? import_react20.default.createElement(MovePrompt, { model, selection, theme }) : undefined, selection.noteOpen ? import_react20.default.createElement(NotePrompt, { model, selection, theme }) : undefined, selection.archiveOpen ? import_react20.default.createElement(ArchivePrompt, { model, selection, theme }) : undefined, selection.githubConfirmOpen ? import_react20.default.createElement(GitHubMirrorPrompt, { model, selection, theme }) : undefined, selection.warningsOpen ? import_react20.default.createElement(WarningPanel, { model, theme }) : undefined, selection.helpOpen ? import_react20.default.createElement(HelpPanel, { theme }) : undefined, import_react20.default.createElement(Footer, {
+  })), selection.moveOpen ? import_react20.default.createElement(MovePrompt, { model, selection, theme }) : undefined, selection.noteOpen ? import_react20.default.createElement(NotePrompt, {
+    model,
+    selection,
+    theme,
+    noteTextareaRef,
+    onNoteSubmit
+  }) : undefined, selection.labelOpen ? import_react20.default.createElement(LabelPrompt, { model, selection, theme }) : undefined, selection.archiveOpen ? import_react20.default.createElement(ArchivePrompt, { model, selection, theme }) : undefined, selection.githubConfirmOpen ? import_react20.default.createElement(GitHubMirrorPrompt, { model, selection, theme }) : undefined, selection.warningsOpen ? import_react20.default.createElement(WarningPanel, { model, theme }) : undefined, selection.helpOpen ? import_react20.default.createElement(HelpPanel, { theme }) : undefined, import_react20.default.createElement(Footer, {
     message: selection.message,
     mode: footerMode(selection),
     theme
@@ -108732,6 +108928,19 @@ async function launchTui(options = {}) {
     const modelRef = import_react20.default.useRef(model);
     const selectionRef = import_react20.default.useRef(selection);
     const githubBusyRef = import_react20.default.useRef(false);
+    const noteTextareaRef = import_react20.default.useRef(null);
+    const submitNote = import_react20.default.useCallback((body) => {
+      const result = appendSelectedIssueNote({
+        cwd: options.cwd,
+        model: modelRef.current,
+        selection: selectionRef.current,
+        body
+      });
+      modelRef.current = result.model;
+      selectionRef.current = { ...result.selection, message: result.message };
+      setModel(result.model);
+      setSelection({ ...result.selection, message: result.message });
+    }, []);
     modelRef.current = model;
     selectionRef.current = selection;
     import_react20.default.useEffect(() => {
@@ -108749,7 +108958,7 @@ async function launchTui(options = {}) {
       return () => clearInterval(interval);
     }, []);
     useKeyboard2((key) => {
-      const action = keyToTuiAction(key.name, key.shift);
+      const action = keyToTuiAction(key.name, key.shift, key.ctrl);
       if (selection.helpOpen) {
         if (action === "escape" || action === "help") {
           setSelection((current) => moveSelection(model, current, action));
@@ -108757,26 +108966,10 @@ async function launchTui(options = {}) {
         return;
       }
       if (selection.noteOpen) {
-        if (action === "help") {
-          setSelection((current) => moveSelection(model, current, action));
-          return;
-        }
         if (action === "escape") {
           setSelection((current) => moveSelection(model, current, action));
           return;
         }
-        if (action === "enter") {
-          const result = appendSelectedIssueNote({
-            cwd: options.cwd,
-            model,
-            selection,
-            body: selection.noteDraft ?? ""
-          });
-          setModel(result.model);
-          setSelection({ ...result.selection, message: result.message });
-          return;
-        }
-        setSelection((current) => applyNoteInput(current, key.name, key.shift));
         return;
       }
       if (selection.archiveOpen) {
@@ -108831,6 +109024,35 @@ async function launchTui(options = {}) {
         }
         return;
       }
+      if (selection.labelOpen) {
+        if (action === "help") {
+          setSelection((current) => moveSelection(model, current, action));
+          return;
+        }
+        if (action === "escape") {
+          setSelection((current) => moveSelection(model, current, action));
+          return;
+        }
+        if (action === "up" || action === "down") {
+          setSelection((current) => moveLabelFocus(model, current, action));
+          return;
+        }
+        if (key.name === "space") {
+          setSelection((current) => toggleFocusedLabel(model, current));
+          return;
+        }
+        if (action === "enter") {
+          const result = updateSelectedIssueLabels({
+            cwd: options.cwd,
+            model,
+            selection
+          });
+          setModel(result.model);
+          setSelection({ ...result.selection, message: result.message });
+          return;
+        }
+        return;
+      }
       if (!action)
         return;
       if (action === "quit") {
@@ -108880,6 +109102,8 @@ async function launchTui(options = {}) {
         setSelection((current) => moveSelection(model, current, action));
         return;
       }
+      if (action === "save-note")
+        return;
       if (action === "github") {
         if (githubBusyRef.current)
           return;
@@ -108912,7 +109136,9 @@ async function launchTui(options = {}) {
       selection,
       viewportHeight: renderer.height,
       viewportWidth: renderer.width,
-      columns: options.columns
+      columns: options.columns,
+      noteTextareaRef,
+      onNoteSubmit: submitNote
     });
   }
   root.render(import_react20.default.createElement(App));
@@ -109191,7 +109417,10 @@ function fireHooks(loaded, issue2, fromStatus, toStatus, options) {
     ...hooks?.on_enter?.[toStatus] ?? [],
     ...hooks?.on_transition?.[`${fromStatus}->${toStatus}`] ?? []
   ];
-  for (const command of commands2) {
+  for (const entry of commands2) {
+    const command = hookCommandForIssue(entry, loaded, issue2, options);
+    if (!command)
+      continue;
     const rendered = renderHookCommand(command, {
       project_root: loaded.projectRoot,
       issue_path: issue2.path,
@@ -109217,6 +109446,22 @@ function fireHooks(loaded, issue2, fromStatus, toStatus, options) {
     }
   }
 }
+function hookCommandForIssue(entry, loaded, issue2, options) {
+  if (typeof entry === "string")
+    return entry;
+  const labelsInclude = entry.when?.labels_include;
+  if (!labelsInclude)
+    return entry.command;
+  const knownLabels = new Set(loaded.config.labels.map((label) => label.id));
+  for (const label of labelsInclude) {
+    if (!knownLabels.has(label)) {
+      emitError(options, `hook skipped: ${String(issue2.issue.id)} references unknown label in hook filter: ${label}`);
+      return;
+    }
+  }
+  const issueLabels = new Set(issue2.issue.labels.map(String));
+  return labelsInclude.every((label) => issueLabels.has(label)) ? entry.command : undefined;
+}
 function recordGitHubMirrorPushFailure(projectRoot, issueId, message, options) {
   appendHookFailure(projectRoot, {
     timestamp: utcNow3(options.now),
@@ -109628,6 +109873,10 @@ function helpText() {
 Usage:
   mikan <command> [options]
 
+Options:
+  -v, --version Print mikan version
+  -h, --help    Show this help
+
 Commands:
   init      Create .mikan project files
   add       Create an Issue
@@ -109858,6 +110107,9 @@ async function runCli(argv = process.argv.slice(2), options = {}) {
   const command = argv[0];
   if (!command || isHelpFlag(command))
     return ok2(helpText());
+  if (isVersionFlag(command))
+    return ok2(`${package_default.version}
+`);
   if (command === "help") {
     const topic = argv[1];
     return topic ? commandHelp(topic) : ok2(helpText());
@@ -109916,6 +110168,9 @@ Run \`mikan help tui\` for usage.`);
     return fail2(error51 instanceof Error ? error51.message : String(error51));
   }
 }
+function isVersionFlag(input) {
+  return input === "-v" || input === "--version";
+}
 async function main(argv = process.argv.slice(2)) {
   const result = await runInteractiveCommand(argv, { cwd: process.cwd() });
   if (result.stdout)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@takemo101/mikan",
-	"version": "0.0.6",
+	"version": "0.0.8",
 	"private": false,
 	"type": "module",
 	"bin": {