@kynetic-ai/spec 0.1.0

package/dist/strings/validation.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Validation warning and status messages
+ */
+/**
+ * Alignment validation messages
+ */
+export declare const alignment: {
+    readonly ok: string;
+    readonly warnings: (count: number) => string;
+    readonly orphanedSpecs: {
+        readonly header: string;
+        readonly item: (ref: string, title: string) => string;
+        readonly truncated: (remaining: number) => string;
+    };
+    readonly statusMismatches: {
+        readonly header: string;
+        readonly item: (ref: string, title: string, taskStatus: string, specImpl: string) => string;
+    };
+    readonly staleImplementation: {
+        readonly header: string;
+        readonly item: (ref: string, title: string) => string;
+    };
+    readonly noFixes: string;
+    readonly fixesApplied: (count: number, files: number) => string;
+};
+/**
+ * Shadow branch status messages
+ */
+export declare const shadowBranch: {
+    readonly header: string;
+    readonly healthy: string;
+    readonly notInitialized: {
+        readonly status: string;
+        readonly hint: string;
+    };
+    readonly hasIssues: {
+        readonly status: string;
+        readonly repair: string;
+        readonly reinitialize: string;
+    };
+};
+/**
+ * General validation messages
+ */
+export declare const validation: {
+    readonly noManifest: "No kspec manifest found";
+    readonly initHint: "Run `kspec init` to create a new project";
+    readonly failed: "Validation failed";
+    readonly lintFailed: "Lint failed";
+    readonly revalidating: string;
+    readonly nowPasses: string;
+    readonly issuesRemain: string;
+    readonly alignmentStats: (specsWithTasks: number, totalSpecs: number, aligned: number) => string;
+};
+/**
+ * Shadow command messages
+ */
+export declare const shadowCommands: {
+    readonly notGitRepo: "Not a git repository";
+    readonly statusFailed: "Failed to get shadow status";
+    readonly repair: {
+        readonly alreadyHealthy: "Shadow branch is already healthy, nothing to repair";
+        readonly branchNotExist: "Shadow branch does not exist";
+        readonly initHint: string;
+        readonly repairing: "Repairing shadow branch worktree...";
+        readonly stillHealthy: "Shadow branch is already healthy";
+        readonly repaired: "Shadow branch repaired";
+        readonly worktreeCreated: (dir: string) => string;
+        readonly failed: (error: string) => string;
+        readonly commandFailed: "Failed to repair shadow branch";
+    };
+    readonly log: {
+        readonly branchNotExist: "Shadow branch does not exist";
+        readonly initHint: string;
+        readonly hasIssues: "Shadow branch has issues";
+        readonly repairHint: string;
+        readonly noCommits: "No commits in shadow branch";
+        readonly failed: "Failed to get shadow log";
+    };
+    readonly resolve: {
+        readonly notHealthy: "Shadow branch not healthy";
+        readonly repairHint: string;
+        readonly acceptingRemote: "Accepting remote changes...";
+        readonly acceptedRemote: "Resolved: accepted all remote changes";
+        readonly keepingLocal: "Keeping local changes...";
+        readonly keptLocal: "Resolved: kept local changes and pushed to remote";
+        readonly pushFailed: "Could not push local changes to remote";
+        readonly localPreserved: string;
+        readonly failed: "Failed to resolve conflicts";
+        readonly interactive: {
+            readonly header: string;
+            readonly separator: string;
+            readonly rebaseInProgress: string;
+            readonly options: "Options:";
+            readonly theirs: {
+                readonly command: string;
+                readonly description: string;
+            };
+            readonly ours: {
+                readonly command: string;
+                readonly description: string;
+            };
+            readonly manual: {
+                readonly header: string;
+                readonly cdCommand: (dir: string) => string;
+                readonly rebaseSteps: readonly [string, string, string];
+                readonly pullSteps: readonly [string, string, string];
+            };
+        };
+    };
+    readonly sync: {
+        readonly notHealthy: "Shadow branch not healthy";
+        readonly repairHint: string;
+        readonly noRemote: "No remote tracking configured for shadow branch";
+        readonly localOnly: string;
+        readonly syncing: "Syncing shadow branch...";
+        readonly conflictDetected: "Sync conflict detected";
+        readonly resolveHint: string;
+        readonly syncedBoth: "Shadow branch synced (pulled and pushed)";
+        readonly syncedPull: "Shadow branch synced (pulled, nothing to push)";
+        readonly syncedPush: "Shadow branch synced (pushed, nothing to pull)";
+        readonly alreadyInSync: "Shadow branch already in sync";
+        readonly failed: "Failed to sync shadow branch";
+    };
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/strings/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/strings/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,eAAO,MAAM,SAAS;;+BAEF,MAAM;;;6BAIV,MAAM,SAAS,MAAM;wCACV,MAAM;;;;6BAMjB,MAAM,SAAS,MAAM,cAAc,MAAM,YAAY,MAAM;;;;6BAM3D,MAAM,SAAS,MAAM;;;mCAIb,MAAM,SAAS,MAAM;CAEnC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;CAef,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;8CAUY,MAAM,cAAc,MAAM,WAAW,MAAM;CAIpE,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;wCAWA,MAAM;iCACb,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0CAwCD,MAAM;;;;;;;;;;;;;;;;;;;;CA6BrB,CAAC"}

package/dist/strings/validation.js

@@ -0,0 +1,135 @@
+/**
+ * Validation warning and status messages
+ */
+import chalk from 'chalk';
+/**
+ * Alignment validation messages
+ */
+export const alignment = {
+    ok: chalk.green('Alignment: OK'),
+    warnings: (count) => chalk.yellow(`Alignment warnings: ${count}`),
+    orphanedSpecs: {
+        header: chalk.yellow('\nOrphaned specs (no implementation status):'),
+        item: (ref, title) => `  ${ref}: ${title}`,
+        truncated: (remaining) => chalk.gray(`  ... and ${remaining} more (use --verbose to see all)`),
+    },
+    statusMismatches: {
+        header: chalk.yellow('\nStatus mismatches (task status != spec implementation):'),
+        item: (ref, title, taskStatus, specImpl) => `  ${ref}: ${title} (task=${taskStatus}, spec=${specImpl})`,
+    },
+    staleImplementation: {
+        header: chalk.yellow('\nStale implementation status (task completed but spec not implemented):'),
+        item: (ref, title) => `  ${ref}: ${title}`,
+    },
+    noFixes: chalk.gray('No auto-fixable issues found.'),
+    fixesApplied: (count, files) => chalk.cyan(`✓ Applied ${count} fix(es) to ${files} file(s):`),
+};
+/**
+ * Shadow branch status messages
+ */
+export const shadowBranch = {
+    header: chalk.bold('Shadow Branch Status'),
+    healthy: chalk.green.bold('✓ Shadow branch is healthy'),
+    notInitialized: {
+        status: chalk.yellow('○ Shadow branch not initialized'),
+        hint: chalk.gray('Run `kspec init` to set up shadow branch'),
+    },
+    hasIssues: {
+        status: chalk.red.bold('✗ Shadow branch has issues'),
+        repair: chalk.gray('Run `kspec shadow repair` to fix issues'),
+        reinitialize: chalk.gray('Or `kspec init --force` to reinitialize'),
+    },
+};
+/**
+ * General validation messages
+ */
+export const validation = {
+    noManifest: 'No kspec manifest found',
+    initHint: 'Run `kspec init` to create a new project',
+    failed: 'Validation failed',
+    lintFailed: 'Lint failed',
+    revalidating: chalk.gray('\nRe-validating after fixes...'),
+    nowPasses: chalk.green.bold('✓ Validation now passes'),
+    issuesRemain: chalk.yellow('Some issues remain after auto-fix'),
+    alignmentStats: (specsWithTasks, totalSpecs, aligned) => chalk.gray(`\nAlignment stats: ${specsWithTasks}/${totalSpecs} specs have tasks, ${aligned} aligned`),
+};
+/**
+ * Shadow command messages
+ */
+export const shadowCommands = {
+    notGitRepo: 'Not a git repository',
+    statusFailed: 'Failed to get shadow status',
+    repair: {
+        alreadyHealthy: 'Shadow branch is already healthy, nothing to repair',
+        branchNotExist: 'Shadow branch does not exist',
+        initHint: chalk.gray('Run `kspec init` to create a new shadow branch'),
+        repairing: 'Repairing shadow branch worktree...',
+        stillHealthy: 'Shadow branch is already healthy',
+        repaired: 'Shadow branch repaired',
+        worktreeCreated: (dir) => chalk.green(`  ✓ Recreated worktree: ${dir}/`),
+        failed: (error) => `Repair failed: ${error}`,
+        commandFailed: 'Failed to repair shadow branch',
+    },
+    log: {
+        branchNotExist: 'Shadow branch does not exist',
+        initHint: chalk.gray('Run `kspec init` to set up shadow branch'),
+        hasIssues: 'Shadow branch has issues',
+        repairHint: chalk.gray('Run `kspec shadow repair` to fix'),
+        noCommits: 'No commits in shadow branch',
+        failed: 'Failed to get shadow log',
+    },
+    resolve: {
+        notHealthy: 'Shadow branch not healthy',
+        repairHint: chalk.gray('Run `kspec shadow repair` first'),
+        acceptingRemote: 'Accepting remote changes...',
+        acceptedRemote: 'Resolved: accepted all remote changes',
+        keepingLocal: 'Keeping local changes...',
+        keptLocal: 'Resolved: kept local changes and pushed to remote',
+        pushFailed: 'Could not push local changes to remote',
+        localPreserved: chalk.gray('Local changes are preserved, but remote may differ'),
+        failed: 'Failed to resolve conflicts',
+        interactive: {
+            header: chalk.bold('Shadow Branch Conflict Resolution'),
+            separator: chalk.gray('─'.repeat(40)),
+            rebaseInProgress: chalk.yellow('A rebase is currently in progress.'),
+            options: 'Options:',
+            theirs: {
+                command: chalk.cyan('  kspec shadow resolve --theirs'),
+                description: chalk.gray('    Accept all remote changes, discard local uncommitted work'),
+            },
+            ours: {
+                command: chalk.cyan('  kspec shadow resolve --ours'),
+                description: chalk.gray('    Keep local changes and force-push to remote'),
+            },
+            manual: {
+                header: chalk.cyan('  Manual resolution:'),
+                cdCommand: (dir) => chalk.gray(`    cd ${dir}`),
+                rebaseSteps: [
+                    chalk.gray('    # Edit conflicting files'),
+                    chalk.gray('    git add <resolved-files>'),
+                    chalk.gray('    git rebase --continue'),
+                ],
+                pullSteps: [
+                    chalk.gray('    git pull --rebase'),
+                    chalk.gray('    # Resolve any conflicts, then:'),
+                    chalk.gray('    git push'),
+                ],
+            },
+        },
+    },
+    sync: {
+        notHealthy: 'Shadow branch not healthy',
+        repairHint: chalk.gray('Run `kspec shadow repair` first'),
+        noRemote: 'No remote tracking configured for shadow branch',
+        localOnly: chalk.gray('Shadow changes are local only'),
+        syncing: 'Syncing shadow branch...',
+        conflictDetected: 'Sync conflict detected',
+        resolveHint: chalk.gray('Run `kspec shadow resolve` to fix'),
+        syncedBoth: 'Shadow branch synced (pulled and pushed)',
+        syncedPull: 'Shadow branch synced (pulled, nothing to push)',
+        syncedPush: 'Shadow branch synced (pushed, nothing to pull)',
+        alreadyInSync: 'Shadow branch already in sync',
+        failed: 'Failed to sync shadow branch',
+    },
+};
+//# sourceMappingURL=validation.js.map

package/dist/strings/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/strings/validation.ts"],"names":[],"mappings":"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"}

package/dist/utils/commit.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Commit message formatting utilities
+ */
+import type { Task } from '../schema/index.js';
+export interface CommitGuidance {
+    /** Suggested commit message subject line */
+    message: string;
+    /** Trailers to append (e.g., Task: @slug, Spec: @ref) */
+    trailers: string[];
+    /** Whether spec gap warning should be shown */
+    hasSpecGap: boolean;
+}
+/**
+ * Generate commit guidance for a task
+ */
+export declare function formatCommitGuidance(task: Task, options?: {
+    wip?: boolean;
+}): CommitGuidance;
+/**
+ * Output commit guidance to console
+ */
+export declare function printCommitGuidance(guidance: CommitGuidance): void;
+//# sourceMappingURL=commit.d.ts.map

package/dist/utils/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../src/utils/commit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B,cAAc,CAoBhB;AAsBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAelE"}

package/dist/utils/commit.js

@@ -0,0 +1,67 @@
+/**
+ * Commit message formatting utilities
+ */
+import chalk from 'chalk';
+/**
+ * Generate commit guidance for a task
+ */
+export function formatCommitGuidance(task, options = {}) {
+    const prefix = options.wip ? 'wip' : inferCommitType(task);
+    // Remove "Implement: " prefix if present (from derive command)
+    const subject = task.title.replace(/^Implement:\s*/i, '');
+    const trailers = [];
+    const taskRef = task.slugs[0] ? `@${task.slugs[0]}` : `@${task._ulid.slice(0, 8)}`;
+    trailers.push(`Task: ${taskRef}`);
+    if (task.spec_ref) {
+        trailers.push(`Spec: ${task.spec_ref}`);
+    }
+    const message = `${prefix}: ${subject}`;
+    return {
+        message,
+        trailers,
+        hasSpecGap: !task.spec_ref,
+    };
+}
+/**
+ * Infer conventional commit type from task metadata
+ */
+function inferCommitType(task) {
+    // Check task type first
+    if (task.type === 'bug')
+        return 'fix';
+    if (task.type === 'infra')
+        return 'chore';
+    // Check tags
+    const tags = task.tags.map((t) => t.toLowerCase());
+    if (tags.includes('docs') || tags.includes('documentation'))
+        return 'docs';
+    if (tags.includes('test') || tags.includes('testing'))
+        return 'test';
+    if (tags.includes('refactor'))
+        return 'refactor';
+    if (tags.includes('perf') || tags.includes('performance'))
+        return 'perf';
+    if (tags.includes('chore'))
+        return 'chore';
+    // Default to feat for features and other tasks
+    return 'feat';
+}
+/**
+ * Output commit guidance to console
+ */
+export function printCommitGuidance(guidance) {
+    console.log('');
+    console.log(chalk.gray('--- Suggested Commit ---'));
+    console.log(chalk.cyan(guidance.message));
+    console.log('');
+    for (const trailer of guidance.trailers) {
+        console.log(chalk.gray(trailer));
+    }
+    if (guidance.hasSpecGap) {
+        console.log('');
+        console.log(chalk.yellow('This task has no spec_ref.'));
+        console.log(chalk.gray('Is this a spec gap? Consider: kspec item add --under @parent ...'));
+        console.log(chalk.gray('Or is this intentional (infra/cleanup)?'));
+    }
+}
+//# sourceMappingURL=commit.js.map

package/dist/utils/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../src/utils/commit.ts"],"names":[],"mappings":"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"}

package/dist/utils/git.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Git integration utilities
+ */
+export interface GitCommit {
+    hash: string;
+    fullHash: string;
+    date: Date;
+    message: string;
+    author: string;
+}
+export interface GitFileStatus {
+    path: string;
+    status: 'modified' | 'added' | 'deleted' | 'renamed' | 'untracked';
+    staged: boolean;
+}
+export interface GitWorkingTree {
+    clean: boolean;
+    staged: GitFileStatus[];
+    unstaged: GitFileStatus[];
+    untracked: string[];
+}
+/**
+ * Check if current directory is in a git repository
+ */
+export declare function isGitRepo(cwd?: string): boolean;
+/**
+ * Get the current git branch name
+ */
+export declare function getCurrentBranch(cwd?: string): string | null;
+/**
+ * Get recent git commits
+ *
+ * @param options.limit Number of commits to return
+ * @param options.since Only commits after this date
+ * @param options.cwd Working directory
+ */
+export declare function getRecentCommits(options: {
+    limit?: number;
+    since?: Date;
+    cwd?: string;
+}): GitCommit[];
+/**
+ * Get the working tree status (staged, unstaged, untracked files)
+ */
+export declare function getWorkingTreeStatus(cwd?: string): GitWorkingTree;
+/**
+ * Get git diff since a specific timestamp
+ *
+ * Returns unified diff output showing all changes made after the given timestamp.
+ * Includes both committed changes and working tree changes.
+ *
+ * @param since - Date to get changes since
+ * @param cwd - Working directory
+ * @returns Diff output as string, or null if no changes or error
+ */
+export declare function getDiffSince(since: Date, cwd?: string): string | null;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IACnE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAW/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY5D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,SAAS,EAAE,CAiCd;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CA0DjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6CrE"}

package/dist/utils/git.js

@@ -0,0 +1,192 @@
+/**
+ * Git integration utilities
+ */
+import { execSync } from 'node:child_process';
+/**
+ * Check if current directory is in a git repository
+ */
+export function isGitRepo(cwd) {
+    try {
+        execSync('git rev-parse --git-dir', {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the current git branch name
+ */
+export function getCurrentBranch(cwd) {
+    try {
+        return (execSync('git branch --show-current', {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        }).trim() || null);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get recent git commits
+ *
+ * @param options.limit Number of commits to return
+ * @param options.since Only commits after this date
+ * @param options.cwd Working directory
+ */
+export function getRecentCommits(options) {
+    const { limit = 10, since, cwd } = options;
+    try {
+        // Format: hash|ISO date|subject|author name
+        // Using %aI for ISO 8601 author date
+        let cmd = `git log --format="%H|%aI|%s|%an" -n ${limit}`;
+        if (since) {
+            cmd += ` --since="${since.toISOString()}"`;
+        }
+        const output = execSync(cmd, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        }).trim();
+        if (!output)
+            return [];
+        return output.split('\n').map((line) => {
+            const [fullHash, dateStr, message, author] = line.split('|');
+            return {
+                hash: fullHash.slice(0, 7),
+                fullHash,
+                date: new Date(dateStr),
+                message,
+                author,
+            };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the working tree status (staged, unstaged, untracked files)
+ */
+export function getWorkingTreeStatus(cwd) {
+    const result = {
+        clean: true,
+        staged: [],
+        unstaged: [],
+        untracked: [],
+    };
+    try {
+        const output = execSync('git status --porcelain', {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        }).trim();
+        if (!output) {
+            return result;
+        }
+        result.clean = false;
+        for (const line of output.split('\n')) {
+            if (!line)
+                continue;
+            const indexStatus = line[0];
+            const workTreeStatus = line[1];
+            // Path starts after status codes - trim to normalize
+            const path = line.slice(2).trim();
+            // Untracked files
+            if (indexStatus === '?' && workTreeStatus === '?') {
+                result.untracked.push(path);
+                continue;
+            }
+            // Staged changes (index has changes)
+            if (indexStatus !== ' ' && indexStatus !== '?') {
+                result.staged.push({
+                    path,
+                    status: parseStatusCode(indexStatus),
+                    staged: true,
+                });
+            }
+            // Unstaged changes (work tree has changes)
+            if (workTreeStatus !== ' ' && workTreeStatus !== '?') {
+                result.unstaged.push({
+                    path,
+                    status: parseStatusCode(workTreeStatus),
+                    staged: false,
+                });
+            }
+        }
+        return result;
+    }
+    catch {
+        return result;
+    }
+}
+/**
+ * Get git diff since a specific timestamp
+ *
+ * Returns unified diff output showing all changes made after the given timestamp.
+ * Includes both committed changes and working tree changes.
+ *
+ * @param since - Date to get changes since
+ * @param cwd - Working directory
+ * @returns Diff output as string, or null if no changes or error
+ */
+export function getDiffSince(since, cwd) {
+    try {
+        // Get the commit hash at the given time
+        const sinceCommit = execSync(`git log --format="%H" --before="${since.toISOString()}" -n 1`, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        }).trim();
+        if (!sinceCommit) {
+            // No commit before this time, diff from the beginning
+            // Using Git's magic empty tree hash - this is the hash of an empty tree object
+            // that exists conceptually in every Git repo (commonly used for initial diffs)
+            const diff = execSync('git diff 4b825dc642cb6eb9a060e54bf8d69288fbee4904..HEAD', {
+                cwd,
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'ignore'],
+            }).trim();
+            return diff || null;
+        }
+        // Get diff from that commit to HEAD (includes committed changes)
+        const committedDiff = execSync(`git diff ${sinceCommit}..HEAD`, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        }).trim();
+        // Get diff for working tree changes (uncommitted)
+        const workingTreeDiff = execSync('git diff HEAD', {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        }).trim();
+        // Combine both diffs
+        const combined = [committedDiff, workingTreeDiff].filter(Boolean).join('\n\n');
+        return combined || null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseStatusCode(code) {
+    switch (code) {
+        case 'M':
+            return 'modified';
+        case 'A':
+            return 'added';
+        case 'D':
+            return 'deleted';
+        case 'R':
+            return 'renamed';
+        default:
+            return 'modified';
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAuB9C;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,IAAI,CAAC;QACH,QAAQ,CAAC,yBAAyB,EAAE;YAClC,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,CAAC;QACH,OAAO,CACL,QAAQ,CAAC,2BAA2B,EAAE;YACpC,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAClB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAIhC;IACC,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAE3C,IAAI,CAAC;QACH,4CAA4C;QAC5C,qCAAqC;QACrC,IAAI,GAAG,GAAG,uCAAuC,KAAK,EAAE,CAAC;QAEzD,IAAI,KAAK,EAAE,CAAC;YACV,GAAG,IAAI,aAAa,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;QAC7C,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE;YAC3B,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAEvB,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACrC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO;gBACL,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC1B,QAAQ;gBACR,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC;gBACvB,OAAO;gBACP,MAAM;aACP,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,MAAM,MAAM,GAAmB;QAC7B,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;KACd,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,EAAE;YAChD,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAErB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,qDAAqD;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAElC,kBAAkB;YAClB,IAAI,WAAW,KAAK,GAAG,IAAI,cAAc,KAAK,GAAG,EAAE,CAAC;gBAClD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5B,SAAS;YACX,CAAC;YAED,qCAAqC;YACrC,IAAI,WAAW,KAAK,GAAG,IAAI,WAAW,KAAK,GAAG,EAAE,CAAC;gBAC/C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;oBACjB,IAAI;oBACJ,MAAM,EAAE,eAAe,CAAC,WAAW,CAAC;oBACpC,MAAM,EAAE,IAAI;iBACb,CAAC,CAAC;YACL,CAAC;YAED,2CAA2C;YAC3C,IAAI,cAAc,KAAK,GAAG,IAAI,cAAc,KAAK,GAAG,EAAE,CAAC;gBACrD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACnB,IAAI;oBACJ,MAAM,EAAE,eAAe,CAAC,cAAc,CAAC;oBACvC,MAAM,EAAE,KAAK;iBACd,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,KAAW,EAAE,GAAY;IACpD,IAAI,CAAC;QACH,wCAAwC;QACxC,MAAM,WAAW,GAAG,QAAQ,CAC1B,mCAAmC,KAAK,CAAC,WAAW,EAAE,QAAQ,EAC9D;YACE,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CACF,CAAC,IAAI,EAAE,CAAC;QAET,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,sDAAsD;YACtD,+EAA+E;YAC/E,+EAA+E;YAC/E,MAAM,IAAI,GAAG,QAAQ,CAAC,yDAAyD,EAAE;gBAC/E,GAAG;gBACH,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;aAClC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEV,OAAO,IAAI,IAAI,IAAI,CAAC;QACtB,CAAC;QAED,iEAAiE;QACjE,MAAM,aAAa,GAAG,QAAQ,CAAC,YAAY,WAAW,QAAQ,EAAE;YAC9D,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,kDAAkD;QAClD,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,EAAE;YAChD,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,qBAAqB;QACrB,MAAM,QAAQ,GAAG,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/E,OAAO,QAAQ,IAAI,IAAI,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,IAAY;IAEZ,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG;YACN,OAAO,UAAU,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,OAAO,CAAC;QACjB,KAAK,GAAG;YACN,OAAO,SAAS,CAAC;QACnB,KAAK,GAAG;YACN,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/utils/grep.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Grep-like content search across item fields.
+ *
+ * Recursively searches all text content (title, description, notes, AC text)
+ * and returns matched field paths.
+ */
+/**
+ * Result of grep search on an item
+ */
+export interface GrepMatch {
+    /** Field paths where pattern matched (e.g., "description", "notes[1].content") */
+    matchedFields: string[];
+}
+/**
+ * Search an item for a regex pattern across all text fields.
+ *
+ * @param item - The item to search
+ * @param pattern - Regex pattern string
+ * @param caseInsensitive - Whether to match case-insensitively (default: true)
+ * @returns GrepMatch with matched field paths, or null if no matches
+ */
+export declare function grepItem(item: Record<string, unknown>, pattern: string, caseInsensitive?: boolean): GrepMatch | null;
+/**
+ * Format matched fields for display.
+ * Groups and simplifies paths for readability.
+ */
+export declare function formatMatchedFields(fields: string[]): string;
+//# sourceMappingURL=grep.d.ts.map