hataraku/dist/cjs/shared/context-mentions.js

An autonomous coding agent for building AI-powered development tools. The name "Hataraku" (働く) means "to work" in Japanese.

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.mentionRegexGlobal = exports.mentionRegex = void 0;
exports.formatGitSuggestion = formatGitSuggestion;
/*
Mention regex:
- **Purpose**:
  - To identify and highlight specific mentions in text that start with '@'.
  - These mentions can be file paths, URLs, or the exact word 'problems'.
  - Ensures that trailing punctuation marks (like commas, periods, etc.) are not included in the match, allowing punctuation to follow the mention without being part of it.

- **Regex Breakdown**:
  - `/@`:
    - **@**: The mention must start with the '@' symbol.
  
  - `((?:\/|\w+:\/\/)[^\s]+?|problems\b|git-changes\b)`:
    - **Capturing Group (`(...)`)**: Captures the part of the string that matches one of the specified patterns.
    - `(?:\/|\w+:\/\/)`:
      - **Non-Capturing Group (`(?:...)`)**: Groups the alternatives without capturing them for back-referencing.
      - `\/`:
        - **Slash (`/`)**: Indicates that the mention is a file or folder path starting with a '/'.
      - `|`: Logical OR.
      - `\w+:\/\/`:
        - **Protocol (`\w+://`)**: Matches URLs that start with a word character sequence followed by '://', such as 'http://', 'https://', 'ftp://', etc.
    - `[^\s]+?`:
      - **Non-Whitespace Characters (`[^\s]+`)**: Matches one or more characters that are not whitespace.
      - **Non-Greedy (`+?`)**: Ensures the smallest possible match, preventing the inclusion of trailing punctuation.
    - `|`: Logical OR.
    - `problems\b`:
      - **Exact Word ('problems')**: Matches the exact word 'problems'.
      - **Word Boundary (`\b`)**: Ensures that 'problems' is matched as a whole word and not as part of another word (e.g., 'problematic').
        - `|`: Logical OR.
    - `problems\b`:
      - **Exact Word ('git-changes')**: Matches the exact word 'git-changes'.
      - **Word Boundary (`\b`)**: Ensures that 'git-changes' is matched as a whole word and not as part of another word.

  - `(?=[.,;:!?]?(?=[\s\r\n]|$))`:
    - **Positive Lookahead (`(?=...)`)**: Ensures that the match is followed by specific patterns without including them in the match.
    - `[.,;:!?]?`:
      - **Optional Punctuation (`[.,;:!?]?`)**: Matches zero or one of the specified punctuation marks.
    - `(?=[\s\r\n]|$)`:
      - **Nested Positive Lookahead (`(?=[\s\r\n]|$)`)**: Ensures that the punctuation (if present) is followed by a whitespace character, a line break, or the end of the string.
  
- **Summary**:
  - The regex effectively matches:
    - Mentions that are file or folder paths starting with '/' and containing any non-whitespace characters (including periods within the path).
    - URLs that start with a protocol (like 'http://') followed by any non-whitespace characters (including query parameters).
    - The exact word 'problems'.
    - The exact word 'git-changes'.
  - It ensures that any trailing punctuation marks (such as ',', '.', '!', etc.) are not included in the matched mention, allowing the punctuation to follow the mention naturally in the text.

- **Global Regex**:
  - `mentionRegexGlobal`: Creates a global version of the `mentionRegex` to find all matches within a given string.

*/
exports.mentionRegex = /@((?:\/|\w+:\/\/)[^\s]+?|[a-f0-9]{7,40}\b|problems\b|git-changes\b)(?=[.,;:!?]?(?=[\s\r\n]|$))/;
exports.mentionRegexGlobal = new RegExp(exports.mentionRegex.source, "g");
function formatGitSuggestion(commit) {
    return {
        type: 'git',
        label: commit.subject,
        description: `${commit.shortHash} by ${commit.author} on ${commit.date}`,
        value: commit.hash,
        icon: '$(git-commit)', // VSCode git commit icon
        hash: commit.hash,
        shortHash: commit.shortHash,
        subject: commit.subject,
        author: commit.author,
        date: commit.date
    };
}
//# sourceMappingURL=context-mentions.js.map