@decibelsystems/tools 2.0.0

package/dist/tools/git-sentinel/index.js

@@ -0,0 +1,178 @@
+// ============================================================================
+// Git-Sentinel Domain Tool Definitions
+// ============================================================================
+// Tools for linking git commits to Sentinel artifacts (issues, epics).
+// Bidirectional: link commits to artifacts, query linked commits,
+// and reverse-lookup which artifacts reference a commit.
+// ============================================================================
+import { toolSuccess, toolError } from '../shared/index.js';
+import { sentinelLinkCommit, sentinelGetLinkedCommits, gitFindLinkedIssues, autoLinkCommit, isLinkError, } from '../git-sentinel.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const RELATIONSHIP_TYPES = [
+    'fixes',
+    'closes',
+    'related',
+    'reverts',
+    'breaks',
+    'implements',
+];
+// ============================================================================
+// sentinel_link_commit
+// ============================================================================
+export const sentinelLinkCommitTool = {
+    definition: {
+        name: 'sentinel_link_commit',
+        description: 'Link a git commit to a Sentinel artifact (issue or epic). Creates a bidirectional reference stored in the artifact YAML. Use after committing a fix, implementing a feature, or reverting a change.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+                artifactId: {
+                    type: 'string',
+                    description: 'Sentinel artifact ID to link to (e.g., "ISS-0042", "EPIC-0015")',
+                },
+                commitSha: {
+                    type: 'string',
+                    description: 'Full or short git commit SHA to link',
+                },
+                relationship: {
+                    type: 'string',
+                    enum: [...RELATIONSHIP_TYPES],
+                    description: 'How the commit relates to the artifact (default: "related")',
+                },
+            },
+            required: ['artifactId', 'commitSha'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await sentinelLinkCommit(args);
+            if (isLinkError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// sentinel_get_linked_commits
+// ============================================================================
+export const sentinelListLinkedCommitsTool = {
+    definition: {
+        name: 'sentinel_list_linked_commits',
+        description: 'List all git commits linked to a Sentinel artifact (issue or epic). Shows commit SHAs, messages, relationships, and when they were linked.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+                artifactId: {
+                    type: 'string',
+                    description: 'Sentinel artifact ID to query (e.g., "ISS-0042", "EPIC-0015")',
+                },
+            },
+            required: ['artifactId'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await sentinelGetLinkedCommits(args);
+            if (isLinkError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// git_find_linked_issues
+// ============================================================================
+export const gitFindLinkedIssuesTool = {
+    definition: {
+        name: 'git_find_linked_issues',
+        description: 'Reverse lookup: find all Sentinel artifacts (issues, epics) that reference a specific git commit. Useful for understanding the impact and context of a commit.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+                commitSha: {
+                    type: 'string',
+                    description: 'Full or short git commit SHA to search for',
+                },
+            },
+            required: ['commitSha'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await gitFindLinkedIssues(args);
+            if (isLinkError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// sentinel_auto_link
+// ============================================================================
+export const sentinelAutoLinkTool = {
+    definition: {
+        name: 'sentinel_auto_link',
+        description: 'Auto-link a commit to issues/epics referenced in its message. Parses patterns like "fixes ISS-0042", "closes EPIC-0001", or standalone "ISS-0042" references. Call after commits to automatically create links.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+                commitSha: {
+                    type: 'string',
+                    description: 'Commit SHA to process (default: HEAD). Parses commit message for issue/epic references.',
+                },
+            },
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await autoLinkCommit(args);
+            if (isLinkError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Export All Tools
+// ============================================================================
+export const gitSentinelTools = [
+    sentinelLinkCommitTool,
+    sentinelListLinkedCommitsTool,
+    gitFindLinkedIssuesTool,
+    sentinelAutoLinkTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/git-sentinel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/git-sentinel/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,uCAAuC;AACvC,+EAA+E;AAC/E,uEAAuE;AACvE,kEAAkE;AAClE,yDAAyD;AACzD,+EAA+E;AAG/E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,WAAW,GAKZ,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,kBAAkB,GAAG;IACzB,OAAO;IACP,QAAQ;IACR,SAAS;IACT,SAAS;IACT,QAAQ;IACR,YAAY;CACJ,CAAC;AAEX,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,sBAAsB,GAAa;IAC9C,UAAU,EAAE;QACV,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,qMAAqM;QACvM,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4DAA4D;iBAC/D;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,iEAAiE;iBACpE;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,GAAG,kBAAkB,CAAC;oBAC7B,WAAW,EACT,6DAA6D;iBAChE;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;SACtC;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAA+B,CAAC,CAAC;YACzE,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,6BAA6B,GAAa;IACrD,UAAU,EAAE;QACV,IAAI,EAAE,8BAA8B;QACpC,WAAW,EACT,4IAA4I;QAC9I,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4DAA4D;iBAC/D;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,+DAA+D;iBAClE;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAC3C,IAA+B,CAChC,CAAC;YACF,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,UAAU,EAAE;QACV,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,gKAAgK;QAClK,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4DAA4D;iBAC/D;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAyB,CAAC,CAAC;YACpE,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,oBAAoB,GAAa;IAC5C,UAAU,EAAE;QACV,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,iNAAiN;QACnN,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4DAA4D;iBAC/D;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,yFAAyF;iBAC5F;aACF;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAqB,CAAC,CAAC;YAC3D,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,sBAAsB;IACtB,6BAA6B;IAC7B,uBAAuB;IACvB,oBAAoB;CACrB,CAAC"}

package/dist/tools/git-sentinel.d.ts

@@ -0,0 +1,78 @@
+export interface LinkedCommit {
+    sha: string;
+    shortSha: string;
+    message: string;
+    relationship: 'fixes' | 'closes' | 'related' | 'reverts' | 'breaks' | 'implements';
+    linked_at: string;
+    linked_by?: string;
+}
+export interface SentinelLinkCommitInput {
+    projectId?: string;
+    artifactId: string;
+    commitSha: string;
+    relationship?: LinkedCommit['relationship'];
+}
+export interface SentinelLinkCommitOutput {
+    artifactId: string;
+    artifactPath: string;
+    commit: LinkedCommit;
+    totalLinkedCommits: number;
+}
+export interface SentinelGetCommitsInput {
+    projectId?: string;
+    artifactId: string;
+}
+export interface SentinelGetCommitsOutput {
+    artifactId: string;
+    commits: LinkedCommit[];
+}
+export interface GitFindIssueInput {
+    projectId?: string;
+    commitSha: string;
+}
+export interface GitFindIssueOutput {
+    commitSha: string;
+    linkedArtifacts: Array<{
+        id: string;
+        type: 'issue' | 'epic';
+        title: string;
+        relationship: string;
+    }>;
+}
+export interface LinkError {
+    error: string;
+    details?: string;
+}
+export interface ParsedReference {
+    artifactId: string;
+    relationship: LinkedCommit['relationship'];
+}
+export interface AutoLinkInput {
+    projectId?: string;
+    commitSha?: string;
+}
+export interface AutoLinkOutput {
+    commitSha: string;
+    commitMessage: string;
+    referencesFound: ParsedReference[];
+    linked: Array<{
+        artifactId: string;
+        relationship: string;
+        status: 'linked' | 'already_linked' | 'not_found';
+    }>;
+}
+export declare function sentinelLinkCommit(input: SentinelLinkCommitInput): Promise<SentinelLinkCommitOutput | LinkError>;
+export declare function sentinelGetLinkedCommits(input: SentinelGetCommitsInput): Promise<SentinelGetCommitsOutput | LinkError>;
+export declare function gitFindLinkedIssues(input: GitFindIssueInput): Promise<GitFindIssueOutput | LinkError>;
+/**
+ * Parse commit message for issue/epic references.
+ * Supports patterns:
+ *   - ISS-0042, EPIC-0001 (standalone references -> 'related')
+ *   - fixes ISS-0042, closes EPIC-0001 (action + reference)
+ *   - fix: ISS-0042, close: EPIC-0001 (conventional commit style)
+ *   - implements EPIC-0001, reverts ISS-0042
+ */
+export declare function parseCommitMessage(message: string): ParsedReference[];
+export declare function autoLinkCommit(input: AutoLinkInput): Promise<AutoLinkOutput | LinkError>;
+export declare function isLinkError(result: unknown): result is LinkError;
+//# sourceMappingURL=git-sentinel.d.ts.map

package/dist/tools/git-sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-sentinel.d.ts","sourceRoot":"","sources":["../../src/tools/git-sentinel.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,KAAK,CAAC;QACrB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,MAAM,EAAE,KAAK,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,WAAW,CAAC;KACnD,CAAC,CAAC;CACJ;AA4DD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAkF/C;AAMD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CA8B/C;AAMD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAiFzC;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAqCrE;AAkCD,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA2FrC;AAMD,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,SAAS,CAEhE"}

package/dist/tools/git-sentinel.js

@@ -0,0 +1,391 @@
+// ============================================================================
+// Git-Sentinel Integration Tools
+// ============================================================================
+// Tools for linking git history to Decibel artifacts.
+// These are METADATA operations - they update .decibel files, not git.
+// ============================================================================
+import fs from 'fs/promises';
+import path from 'path';
+import YAML from 'yaml';
+import { resolveProjectPaths } from '../projectRegistry.js';
+import { gitLogRecent, isGitErrorResult } from './git.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+function makeError(message, details) {
+    return { error: message, details };
+}
+async function findArtifactFile(resolved, artifactId) {
+    const id = artifactId.toUpperCase();
+    // Check issues
+    const issuesDir = resolved.subPath('sentinel', 'issues');
+    try {
+        const issueFiles = await fs.readdir(issuesDir);
+        const issueFile = issueFiles.find(f => f.toUpperCase().startsWith(id));
+        if (issueFile) {
+            return { path: path.join(issuesDir, issueFile), type: 'issue' };
+        }
+    }
+    catch { /* dir doesn't exist */ }
+    // Check epics
+    const epicsDir = resolved.subPath('sentinel', 'epics');
+    try {
+        const epicFiles = await fs.readdir(epicsDir);
+        const epicFile = epicFiles.find(f => f.toUpperCase().startsWith(id));
+        if (epicFile) {
+            return { path: path.join(epicsDir, epicFile), type: 'epic' };
+        }
+    }
+    catch { /* dir doesn't exist */ }
+    return null;
+}
+async function getCommitInfo(projectId, sha) {
+    const logResult = await gitLogRecent({ projectId, count: 100 });
+    if (isGitErrorResult(logResult)) {
+        return null;
+    }
+    const commit = logResult.commits.find(c => c.sha.startsWith(sha) || c.shortSha === sha);
+    return commit || null;
+}
+// ============================================================================
+// sentinel_link_commit
+// ============================================================================
+export async function sentinelLinkCommit(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeError('Failed to resolve project path');
+    }
+    // Find the artifact file
+    const artifact = await findArtifactFile(resolved, input.artifactId);
+    if (!artifact) {
+        return makeError(`Artifact not found: ${input.artifactId}`, 'Check that the issue or epic ID is correct');
+    }
+    // Get commit info
+    const commitInfo = await getCommitInfo(input.projectId, input.commitSha);
+    if (!commitInfo) {
+        return makeError(`Commit not found: ${input.commitSha}`, 'Verify the commit SHA exists in this repository');
+    }
+    // Read current artifact
+    const content = await fs.readFile(artifact.path, 'utf-8');
+    // Parse YAML (handle frontmatter format)
+    let data;
+    let prefix = '';
+    let suffix = '';
+    if (content.startsWith('---')) {
+        const parts = content.split('---');
+        if (parts.length >= 3) {
+            prefix = '---\n';
+            data = YAML.parse(parts[1]) || {};
+            suffix = '\n---' + parts.slice(2).join('---');
+        }
+        else {
+            data = YAML.parse(content) || {};
+        }
+    }
+    else {
+        data = YAML.parse(content) || {};
+    }
+    // Create linked commit entry
+    const linkedCommit = {
+        sha: commitInfo.sha,
+        shortSha: commitInfo.shortSha,
+        message: commitInfo.message,
+        relationship: input.relationship || 'related',
+        linked_at: new Date().toISOString(),
+        linked_by: 'ai:claude',
+    };
+    // Add to linked_commits array
+    const existingCommits = data.linked_commits || [];
+    // Check for duplicate
+    if (existingCommits.some(c => c.sha === linkedCommit.sha)) {
+        return makeError('Commit already linked', `${input.commitSha} is already linked to ${input.artifactId}`);
+    }
+    existingCommits.push(linkedCommit);
+    data.linked_commits = existingCommits;
+    data.updated_at = new Date().toISOString();
+    // Write back
+    const newContent = prefix + YAML.stringify(data) + suffix;
+    await fs.writeFile(artifact.path, newContent, 'utf-8');
+    return {
+        artifactId: input.artifactId,
+        artifactPath: artifact.path,
+        commit: linkedCommit,
+        totalLinkedCommits: existingCommits.length,
+    };
+}
+// ============================================================================
+// sentinel_get_linked_commits
+// ============================================================================
+export async function sentinelGetLinkedCommits(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeError('Failed to resolve project path');
+    }
+    const artifact = await findArtifactFile(resolved, input.artifactId);
+    if (!artifact) {
+        return makeError(`Artifact not found: ${input.artifactId}`);
+    }
+    const content = await fs.readFile(artifact.path, 'utf-8');
+    // Parse YAML
+    let data;
+    if (content.startsWith('---')) {
+        const parts = content.split('---');
+        data = parts.length >= 3 ? YAML.parse(parts[1]) || {} : YAML.parse(content) || {};
+    }
+    else {
+        data = YAML.parse(content) || {};
+    }
+    const commits = data.linked_commits || [];
+    return {
+        artifactId: input.artifactId,
+        commits,
+    };
+}
+// ============================================================================
+// git_find_linked_issues
+// ============================================================================
+export async function gitFindLinkedIssues(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeError('Failed to resolve project path');
+    }
+    const linkedArtifacts = [];
+    // Scan issues
+    const issuesDir = resolved.subPath('sentinel', 'issues');
+    try {
+        const issueFiles = await fs.readdir(issuesDir);
+        for (const file of issueFiles) {
+            if (!file.endsWith('.yml') && !file.endsWith('.yaml') && !file.endsWith('.md'))
+                continue;
+            const content = await fs.readFile(path.join(issuesDir, file), 'utf-8');
+            // Quick check before parsing
+            if (!content.includes(input.commitSha))
+                continue;
+            // Parse and check linked_commits
+            let data;
+            if (content.startsWith('---')) {
+                const parts = content.split('---');
+                data = parts.length >= 3 ? YAML.parse(parts[1]) || {} : {};
+            }
+            else {
+                data = YAML.parse(content) || {};
+            }
+            const commits = data.linked_commits || [];
+            const match = commits.find(c => c.sha.startsWith(input.commitSha) || c.shortSha === input.commitSha);
+            if (match) {
+                linkedArtifacts.push({
+                    id: data.id,
+                    type: 'issue',
+                    title: data.title,
+                    relationship: match.relationship,
+                });
+            }
+        }
+    }
+    catch { /* dir doesn't exist */ }
+    // Scan epics
+    const epicsDir = resolved.subPath('sentinel', 'epics');
+    try {
+        const epicFiles = await fs.readdir(epicsDir);
+        for (const file of epicFiles) {
+            if (!file.endsWith('.yml') && !file.endsWith('.yaml') && !file.endsWith('.md'))
+                continue;
+            const content = await fs.readFile(path.join(epicsDir, file), 'utf-8');
+            if (!content.includes(input.commitSha))
+                continue;
+            let data;
+            if (content.startsWith('---')) {
+                const parts = content.split('---');
+                data = parts.length >= 3 ? YAML.parse(parts[1]) || {} : {};
+            }
+            else {
+                data = YAML.parse(content) || {};
+            }
+            const commits = data.linked_commits || [];
+            const match = commits.find(c => c.sha.startsWith(input.commitSha) || c.shortSha === input.commitSha);
+            if (match) {
+                linkedArtifacts.push({
+                    id: data.id,
+                    type: 'epic',
+                    title: data.title,
+                    relationship: match.relationship,
+                });
+            }
+        }
+    }
+    catch { /* dir doesn't exist */ }
+    return {
+        commitSha: input.commitSha,
+        linkedArtifacts,
+    };
+}
+// ============================================================================
+// parseCommitMessage - Extract issue/epic references from commit message
+// ============================================================================
+/**
+ * Parse commit message for issue/epic references.
+ * Supports patterns:
+ *   - ISS-0042, EPIC-0001 (standalone references -> 'related')
+ *   - fixes ISS-0042, closes EPIC-0001 (action + reference)
+ *   - fix: ISS-0042, close: EPIC-0001 (conventional commit style)
+ *   - implements EPIC-0001, reverts ISS-0042
+ */
+export function parseCommitMessage(message) {
+    const refs = [];
+    const seen = new Set();
+    // Pattern: action + artifact (fixes ISS-0042, closes EPIC-0001, etc.)
+    const actionPatterns = [
+        { pattern: /(?:fix(?:es|ed)?|fixing)[:\s]+((iss|epic|issue)-?\d+)/gi, relationship: 'fixes' },
+        { pattern: /(?:close[sd]?|closing)[:\s]+((iss|epic|issue)-?\d+)/gi, relationship: 'closes' },
+        { pattern: /(?:implement[sd]?|implementing)[:\s]+((iss|epic|issue)-?\d+)/gi, relationship: 'implements' },
+        { pattern: /(?:revert[sd]?|reverting)[:\s]+((iss|epic|issue)-?\d+)/gi, relationship: 'reverts' },
+        { pattern: /(?:break[sd]?|breaking)[:\s]+((iss|epic|issue)-?\d+)/gi, relationship: 'breaks' },
+    ];
+    for (const { pattern, relationship } of actionPatterns) {
+        let match;
+        while ((match = pattern.exec(message)) !== null) {
+            const artifactId = normalizeArtifactId(match[1]);
+            if (!seen.has(artifactId)) {
+                seen.add(artifactId);
+                refs.push({ artifactId, relationship });
+            }
+        }
+    }
+    // Pattern: standalone artifact references (ISS-0042, EPIC-0001)
+    // Only add as 'related' if not already captured with a specific relationship
+    const standalonePattern = /\b(iss(?:ue)?-?\d+|epic-?\d+)\b/gi;
+    let match;
+    while ((match = standalonePattern.exec(message)) !== null) {
+        const artifactId = normalizeArtifactId(match[1]);
+        if (!seen.has(artifactId)) {
+            seen.add(artifactId);
+            refs.push({ artifactId, relationship: 'related' });
+        }
+    }
+    return refs;
+}
+/**
+ * Normalize artifact ID to standard format (ISS-0042, EPIC-0001)
+ */
+function normalizeArtifactId(raw) {
+    const upper = raw.toUpperCase();
+    // Handle ISSUE -> ISS
+    if (upper.startsWith('ISSUE')) {
+        const num = upper.replace(/[^0-9]/g, '');
+        return `ISS-${num.padStart(4, '0')}`;
+    }
+    // Handle ISS0042 -> ISS-0042
+    if (upper.startsWith('ISS') && !upper.includes('-')) {
+        const num = upper.replace(/[^0-9]/g, '');
+        return `ISS-${num.padStart(4, '0')}`;
+    }
+    // Handle EPIC0001 -> EPIC-0001
+    if (upper.startsWith('EPIC') && !upper.includes('-')) {
+        const num = upper.replace(/[^0-9]/g, '');
+        return `EPIC-${num.padStart(4, '0')}`;
+    }
+    // Already normalized
+    return upper;
+}
+// ============================================================================
+// autoLinkCommit - Auto-link commit to referenced issues/epics
+// ============================================================================
+export async function autoLinkCommit(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeError('Failed to resolve project path');
+    }
+    // Get commit info (HEAD if not specified)
+    const logResult = await gitLogRecent({ projectId: input.projectId, count: 1 });
+    if (isGitErrorResult(logResult) || logResult.commits.length === 0) {
+        return makeError('Failed to get commit info');
+    }
+    // If SHA specified, find it; otherwise use HEAD (first commit)
+    let commit = logResult.commits[0];
+    if (input.commitSha) {
+        const fullLog = await gitLogRecent({ projectId: input.projectId, count: 100 });
+        if (!isGitErrorResult(fullLog)) {
+            const found = fullLog.commits.find(c => c.sha.startsWith(input.commitSha) || c.shortSha === input.commitSha);
+            if (found)
+                commit = found;
+        }
+    }
+    // Parse commit message for references
+    const refs = parseCommitMessage(commit.message);
+    if (refs.length === 0) {
+        return {
+            commitSha: commit.sha,
+            commitMessage: commit.message,
+            referencesFound: [],
+            linked: [],
+        };
+    }
+    // Try to link each reference
+    const linked = [];
+    for (const ref of refs) {
+        const artifact = await findArtifactFile(resolved, ref.artifactId);
+        if (!artifact) {
+            linked.push({
+                artifactId: ref.artifactId,
+                relationship: ref.relationship,
+                status: 'not_found',
+            });
+            continue;
+        }
+        // Try to link
+        const linkResult = await sentinelLinkCommit({
+            projectId: input.projectId,
+            artifactId: ref.artifactId,
+            commitSha: commit.sha,
+            relationship: ref.relationship,
+        });
+        if (isLinkError(linkResult)) {
+            if (linkResult.error === 'Commit already linked') {
+                linked.push({
+                    artifactId: ref.artifactId,
+                    relationship: ref.relationship,
+                    status: 'already_linked',
+                });
+            }
+            else {
+                linked.push({
+                    artifactId: ref.artifactId,
+                    relationship: ref.relationship,
+                    status: 'not_found',
+                });
+            }
+        }
+        else {
+            linked.push({
+                artifactId: ref.artifactId,
+                relationship: ref.relationship,
+                status: 'linked',
+            });
+        }
+    }
+    return {
+        commitSha: commit.sha,
+        commitMessage: commit.message,
+        referencesFound: refs,
+        linked,
+    };
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export function isLinkError(result) {
+    return typeof result === 'object' && result !== null && 'error' in result;
+}
+//# sourceMappingURL=git-sentinel.js.map