@ginkoai/cli 1.0.0 → 1.4.1

package/dist/utils/ginko-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"ginko-root.js","sourceRoot":"","sources":["../../src/utils/ginko-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAiB;IACnD,IAAI,UAAU,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAEzC,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAElD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,yBAAyB;YACzB,MAAM;QACR,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,kCAAkC;IAClC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAiB;IACtD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAiB;IACpD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,IAAI,KAAK,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB,EAAE,QAAiB;IACxE,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAiB;IAC3E,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC"}
+{"version":3,"file":"ginko-root.js","sourceRoot":"","sources":["../../src/utils/ginko-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;GAKG;AACH,SAAS,UAAU,CAAC,QAAiB;IACnC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,+BAA+B,EAAE;YACxD,QAAQ,EAAE,MAAM;YAChB,GAAG,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE;YAC9B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,kBAAkB;SACrD,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAiB;IACnD,kEAAkE;IAClE,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC1C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,IAAI,UAAU,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAEzC,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAElD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,yBAAyB;YACzB,MAAM;QACR,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,kCAAkC;IAClC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAiB;IACtD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAiB;IACpD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,IAAI,KAAK,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB,EAAE,QAAiB;IACxE,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAiB;IAC3E,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC"}

package/dist/utils/helpers.d.ts

@@ -8,6 +8,7 @@
  * @complexity: low
  */
 export declare function getGinkoDir(): Promise<string>;
+export declare function getProjectRoot(): Promise<string>;
 export declare function getUserEmail(): Promise<string>;
 export declare function formatTimeAgo(date: Date): string;
 export declare function detectWorkMode(gitStatus: any): Promise<string>;

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAGnD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAmBpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAWhD;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBpE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAqCD"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAGnD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAEtD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAmBpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAWhD;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBpE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAqCD"}

package/dist/utils/helpers.js

@@ -15,6 +15,9 @@ export async function getGinkoDir() {
     const root = await requireGinkoRoot();
     return path.join(root, '.ginko');
 }
+export async function getProjectRoot() {
+    return await requireGinkoRoot();
+}
 export async function getUserEmail() {
     try {
         // Try git config first

package/dist/utils/helpers.js.map

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

package/dist/utils/log-quality.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-22
+ * @tags: [session-logging, quality-validation, adr-033, defensive-logging]
+ * @related: [../core/session-log-manager.ts, ../commands/log.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [simple-git, child_process]
+ */
+import { LogEntry } from '../core/session-log-manager.js';
+export interface QualityMetrics {
+    score: number;
+    hasRootCauses: boolean;
+    hasWhyForFeatures: boolean;
+    hasAlternatives: boolean;
+    hasInsights: boolean;
+    hasGitOps: boolean;
+    terseEntries: number;
+    suggestions: string[];
+}
+export interface GitContext {
+    recentCommits: string[];
+    currentBranch: string;
+    modifiedFiles: string[];
+    hasUncommittedChanges: boolean;
+}
+/**
+ * Detect git operations and context for smart logging
+ */
+export declare function detectGitContext(): Promise<GitContext>;
+/**
+ * Auto-detect files affected from git status
+ */
+export declare function autoDetectFiles(): Promise<string[]>;
+/**
+ * Score session log quality based on criteria
+ */
+export declare function scoreSessionLog(logContent: string): QualityMetrics;
+/**
+ * Validate a single log entry for quality
+ */
+export declare function validateEntry(entry: LogEntry): {
+    isValid: boolean;
+    warnings: string[];
+};
+/**
+ * Generate quality examples for help text
+ */
+export declare function getQualityExamples(): string;
+/**
+ * Suggest insights based on patterns in session log
+ */
+export declare function suggestInsights(logContent: string): string[];
+//# sourceMappingURL=log-quality.d.ts.map

package/dist/utils/log-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-quality.d.ts","sourceRoot":"","sources":["../../src/utils/log-quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,QAAQ,EAAe,MAAM,gCAAgC,CAAC;AAGvE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC,CAqC5D;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGzD;AAmFD;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAgFlE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CA0CA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAmC3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAqC5D"}

package/dist/utils/log-quality.js

@@ -0,0 +1,297 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-22
+ * @tags: [session-logging, quality-validation, adr-033, defensive-logging]
+ * @related: [../core/session-log-manager.ts, ../commands/log.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [simple-git, child_process]
+ */
+import simpleGit from 'simple-git';
+/**
+ * Detect git operations and context for smart logging
+ */
+export async function detectGitContext() {
+    const git = simpleGit();
+    try {
+        // Get current branch
+        const currentBranch = await git.revparse(['--abbrev-ref', 'HEAD']);
+        // Get recent commits (last 5)
+        const log = await git.log({ maxCount: 5 });
+        const recentCommits = log.all.map(commit => `${commit.hash.substring(0, 7)} - ${commit.message}`);
+        // Get modified files
+        const status = await git.status();
+        const modifiedFiles = [
+            ...status.modified,
+            ...status.created,
+            ...status.deleted,
+            ...status.renamed.map(r => r.to)
+        ];
+        return {
+            recentCommits,
+            currentBranch: currentBranch.trim(),
+            modifiedFiles,
+            hasUncommittedChanges: !status.isClean()
+        };
+    }
+    catch (error) {
+        // Return empty context if git operations fail
+        return {
+            recentCommits: [],
+            currentBranch: '',
+            modifiedFiles: [],
+            hasUncommittedChanges: false
+        };
+    }
+}
+/**
+ * Auto-detect files affected from git status
+ */
+export async function autoDetectFiles() {
+    const context = await detectGitContext();
+    return context.modifiedFiles;
+}
+/**
+ * Check if description contains WHY keywords
+ */
+function hasWhyKeywords(description) {
+    const whyKeywords = [
+        'because',
+        'to enable',
+        'to fix',
+        'to address',
+        'solves',
+        'addresses',
+        'enables',
+        'fixes',
+        'root cause',
+        'caused by',
+        'rationale',
+        'reason',
+        'problem',
+        'issue'
+    ];
+    const lowerDesc = description.toLowerCase();
+    return whyKeywords.some(keyword => lowerDesc.includes(keyword));
+}
+/**
+ * Check if description contains alternatives for decisions
+ */
+function hasAlternatives(description) {
+    const alternativeKeywords = [
+        'alternative',
+        'alternatives',
+        'considered',
+        'vs',
+        'versus',
+        'instead of',
+        'rather than',
+        'over',
+        'compared to',
+        'option',
+        'choice'
+    ];
+    const lowerDesc = description.toLowerCase();
+    return alternativeKeywords.some(keyword => lowerDesc.includes(keyword));
+}
+/**
+ * Count words in a description
+ */
+function countWords(text) {
+    return text.trim().split(/\s+/).length;
+}
+/**
+ * Check if entry is terse (< 15 words)
+ */
+function isTerse(description) {
+    return countWords(description) < 15;
+}
+/**
+ * Extract entries by category from log content
+ */
+function extractByCategory(logContent, category) {
+    const entries = [];
+    // Match entry pattern: ### HH:MM - [category]
+    const entryRegex = new RegExp(`### \\d{2}:\\d{2} - \\[${category}\\]\\n([\\s\\S]*?)(?=\\n### |\\n## |$)`, 'g');
+    let match;
+    while ((match = entryRegex.exec(logContent)) !== null) {
+        entries.push(match[1].trim());
+    }
+    return entries;
+}
+/**
+ * Score session log quality based on criteria
+ */
+export function scoreSessionLog(logContent) {
+    const fixes = extractByCategory(logContent, 'fix');
+    const features = extractByCategory(logContent, 'feature');
+    const decisions = extractByCategory(logContent, 'decision');
+    const insights = extractByCategory(logContent, 'insight');
+    const gitOps = extractByCategory(logContent, 'git');
+    let score = 10.0;
+    const suggestions = [];
+    // Check root causes in fixes
+    const fixesWithRootCause = fixes.filter(f => hasWhyKeywords(f));
+    const fixRatio = fixes.length > 0 ? fixesWithRootCause.length / fixes.length : 1;
+    const hasRootCauses = fixRatio >= 0.8;
+    if (!hasRootCauses && fixes.length > 0) {
+        score -= 1.0;
+        suggestions.push(`Add root causes to fix entries (${fixesWithRootCause.length}/${fixes.length} have them)`);
+    }
+    // Check WHY in features
+    const featuresWithWhy = features.filter(f => hasWhyKeywords(f));
+    const featureRatio = features.length > 0 ? featuresWithWhy.length / features.length : 1;
+    const hasWhyForFeatures = featureRatio >= 0.7;
+    if (!hasWhyForFeatures && features.length > 0) {
+        score -= 1.5;
+        suggestions.push(`Add WHY (problem solved) to feature entries (${featuresWithWhy.length}/${features.length} have it)`);
+    }
+    // Check alternatives in decisions
+    const decisionsWithAlternatives = decisions.filter(d => hasAlternatives(d));
+    const decisionRatio = decisions.length > 0 ? decisionsWithAlternatives.length / decisions.length : 1;
+    const hasAlternativesPresent = decisionRatio >= 0.6;
+    if (!hasAlternativesPresent && decisions.length > 0) {
+        score -= 1.0;
+        suggestions.push(`Document alternatives in decision entries (${decisionsWithAlternatives.length}/${decisions.length} have them)`);
+    }
+    // Check for insights
+    const hasInsightsPresent = insights.length > 0;
+    if (!hasInsightsPresent) {
+        score -= 0.5;
+        suggestions.push('Consider documenting insights and learnings discovered during session');
+    }
+    // Check for git operations
+    const hasGitOps = gitOps.length > 0;
+    if (!hasGitOps) {
+        suggestions.push('Consider logging git operations (commits, merges, branch changes)');
+    }
+    // Count terse entries across all categories
+    const allDescriptions = [...fixes, ...features, ...decisions, ...insights, ...gitOps];
+    const terseEntries = allDescriptions.filter(d => isTerse(d)).length;
+    if (terseEntries > 0) {
+        score -= 0.5;
+        suggestions.push(`${terseEntries} entries are terse (<15 words). Add more context for better handoffs.`);
+    }
+    return {
+        score: Math.max(0, Math.min(10, score)),
+        hasRootCauses,
+        hasWhyForFeatures,
+        hasAlternatives: hasAlternativesPresent,
+        hasInsights: hasInsightsPresent,
+        hasGitOps,
+        terseEntries,
+        suggestions
+    };
+}
+/**
+ * Validate a single log entry for quality
+ */
+export function validateEntry(entry) {
+    const warnings = [];
+    // Check for terse descriptions
+    if (isTerse(entry.description)) {
+        warnings.push('Description is terse (<15 words). Consider adding more context.');
+    }
+    // Check category-specific requirements
+    switch (entry.category) {
+        case 'fix':
+            if (!hasWhyKeywords(entry.description)) {
+                warnings.push('Fix entry should include root cause (why it happened).');
+            }
+            break;
+        case 'feature':
+            if (!hasWhyKeywords(entry.description)) {
+                warnings.push('Feature entry should explain WHY (what problem it solves).');
+            }
+            break;
+        case 'decision':
+            if (!hasAlternatives(entry.description)) {
+                warnings.push('Decision entry should mention alternatives considered.');
+            }
+            break;
+        case 'insight':
+            // Insights are flexible, just check they're not too terse
+            break;
+        case 'git':
+        case 'achievement':
+            // These are typically fine as-is
+            break;
+    }
+    return {
+        isValid: warnings.length === 0,
+        warnings
+    };
+}
+/**
+ * Generate quality examples for help text
+ */
+export function getQualityExamples() {
+    return `
+Quality Examples:
+
+GOOD - Fix with root cause:
+  "Fixed authentication timeout in login flow. Root cause: bcrypt rounds set to 15
+   (too slow). Reduced to 11 for 200ms response time while maintaining security."
+
+BAD - Fix without root cause:
+  "Fixed auth timeout"
+
+GOOD - Feature with WHY:
+  "Implemented --show flag for ginko log command. Problem: Users couldn't view logged
+   events without opening files manually. Solution: Added terminal view with summary
+   statistics for quick access."
+
+BAD - Feature without WHY:
+  "Implemented --show flag"
+
+GOOD - Decision with alternatives:
+  "Chose JWT over session cookies for authentication. Alternatives: 1) Server-side
+   sessions (better security but harder to scale), 2) OAuth only (simpler but vendor
+   lock-in). JWT selected for stateless scaling and mobile client support."
+
+BAD - Decision without alternatives:
+  "Chose JWT for authentication"
+
+GOOD - Insight with context:
+  "Discovered bcrypt rounds 10-11 provide optimal security/performance balance. Testing
+   showed rounds 15 caused 800ms login delays; rounds 11 achieved 200ms with acceptable
+   entropy per OWASP standards."
+
+BAD - Insight without context:
+  "Bcrypt rounds should be 11"
+`;
+}
+/**
+ * Suggest insights based on patterns in session log
+ */
+export function suggestInsights(logContent) {
+    const suggestions = [];
+    const fixes = extractByCategory(logContent, 'fix');
+    // Check for repeated errors
+    const errorPatterns = new Map();
+    for (const fix of fixes) {
+        // Extract potential error patterns (simplified)
+        const words = fix.toLowerCase().split(/\s+/);
+        for (const word of words) {
+            if (word.length > 5) {
+                // Only count meaningful words
+                errorPatterns.set(word, (errorPatterns.get(word) || 0) + 1);
+            }
+        }
+    }
+    // Find patterns that occurred multiple times
+    for (const [pattern, count] of errorPatterns) {
+        if (count >= 2) {
+            suggestions.push(`Pattern detected: "${pattern}" mentioned in ${count} fix entries. Consider documenting this as an insight.`);
+        }
+    }
+    // Check for performance-related fixes
+    const performanceKeywords = ['slow', 'timeout', 'performance', 'latency', 'delay'];
+    const hasPerformanceFixes = fixes.some(f => performanceKeywords.some(kw => f.toLowerCase().includes(kw)));
+    if (hasPerformanceFixes) {
+        suggestions.push('Performance improvements detected. Consider documenting the optimization as an insight.');
+    }
+    return suggestions;
+}
+//# sourceMappingURL=log-quality.js.map

package/dist/utils/log-quality.js.map

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

package/dist/utils/reference-parser.d.ts

@@ -0,0 +1,164 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-22
+ * @tags: [references, parsing, navigation, context-linking, prd-009, task-010]
+ * @related: [config-loader.ts, log.ts, session-log-manager.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path, glob]
+ */
+/**
+ * Reference types supported by the system
+ */
+export type ReferenceType = 'task' | 'feature' | 'prd' | 'adr' | 'sprint';
+/**
+ * A parsed reference with type and ID
+ */
+export interface Reference {
+    type: ReferenceType;
+    id: string;
+    rawText: string;
+}
+/**
+ * A resolved reference with file path
+ */
+export interface ResolvedReference extends Reference {
+    filePath: string | null;
+    exists: boolean;
+}
+/**
+ * Reference chain showing document relationships
+ */
+export interface ReferenceChain {
+    source: string;
+    chain: ResolvedReference[];
+    depth: number;
+}
+/**
+ * Extract all references from text
+ *
+ * @param text - Text to search for references
+ * @returns Array of Reference objects
+ *
+ * @example
+ * const refs = extractReferences("Fixed TASK-006 per PRD-009 and ADR-033");
+ * // → [
+ * //   { type: 'task', id: '006', rawText: 'TASK-006' },
+ * //   { type: 'prd', id: '009', rawText: 'PRD-009' },
+ * //   { type: 'adr', id: '033', rawText: 'ADR-033' }
+ * // ]
+ */
+export declare function extractReferences(text: string): Reference[];
+/**
+ * Resolve a reference to its file path
+ * Uses config-loader to map reference types to directory paths
+ *
+ * @param reference - Reference to resolve
+ * @returns ResolvedReference with file path and exists flag
+ *
+ * @example
+ * const resolved = await resolveReference({ type: 'task', id: '006', rawText: 'TASK-006' });
+ * // → {
+ * //   type: 'task',
+ * //   id: '006',
+ * //   rawText: 'TASK-006',
+ * //   filePath: '/path/to/backlog/items/TASK-006.md',
+ * //   exists: true
+ * // }
+ */
+export declare function resolveReference(reference: Reference): Promise<ResolvedReference>;
+/**
+ * Validate references - check if all targets exist
+ * Non-blocking, returns validation results with warnings
+ *
+ * @param references - Array of references to validate
+ * @returns Validation results with broken references
+ *
+ * @example
+ * const validation = await validateReferences(refs);
+ * if (validation.broken.length > 0) {
+ *   console.warn('Broken references:', validation.broken);
+ * }
+ */
+export declare function validateReferences(references: Reference[]): Promise<{
+    valid: ResolvedReference[];
+    broken: ResolvedReference[];
+}>;
+/**
+ * Load content of a referenced document
+ *
+ * @param reference - Resolved reference to load
+ * @returns File content or null if doesn't exist
+ *
+ * @example
+ * const content = await getReferencedContent(resolvedRef);
+ * if (content) {
+ *   // Parse and use content
+ * }
+ */
+export declare function getReferencedContent(reference: ResolvedReference): Promise<string | null>;
+/**
+ * Follow reference chain recursively (with depth limit)
+ * Detects circular references
+ *
+ * @param sourceRef - Starting reference to follow
+ * @param maxDepth - Maximum depth to traverse (default: 3)
+ * @returns ReferenceChain object
+ *
+ * @example
+ * const chain = await getReferenceChain(taskRef, 3);
+ * // → {
+ * //   source: 'TASK-006',
+ * //   chain: [
+ * //     { type: 'feature', id: '024', rawText: 'FEATURE-024', ... },
+ * //     { type: 'prd', id: '009', rawText: 'PRD-009', ... },
+ * //     { type: 'adr', id: '037', rawText: 'ADR-037', ... }
+ * //   ],
+ * //   depth: 3
+ * // }
+ */
+export declare function getReferenceChain(sourceRef: Reference, maxDepth?: number): Promise<ReferenceChain>;
+/**
+ * Format reference chain as human-readable string
+ *
+ * @param chain - Reference chain to format
+ * @returns Formatted string like "TASK-006 → FEATURE-024 → PRD-009 → ADR-037"
+ *
+ * @example
+ * const formatted = formatReferenceChain(chain);
+ * console.log(formatted);
+ * // → "TASK-006 → FEATURE-024 → PRD-009 → ADR-037"
+ */
+export declare function formatReferenceChain(chain: ReferenceChain): string;
+/**
+ * Get backlinks - find all documents referencing a given document
+ * Useful for understanding what depends on a document
+ *
+ * @param targetRef - Reference to find backlinks for
+ * @param searchPaths - Array of directory paths to search (defaults to all doc paths)
+ * @returns Array of file paths containing references to target
+ *
+ * @example
+ * const backlinks = await getBacklinks({ type: 'prd', id: '009', rawText: 'PRD-009' });
+ * // → [
+ * //   '/path/to/backlog/items/TASK-006.md',
+ * //   '/path/to/backlog/items/TASK-010.md',
+ * //   '/path/to/docs/sprints/SPRINT-2025-10-22-configuration-system.md'
+ * // ]
+ */
+export declare function getBacklinks(targetRef: Reference, searchPaths?: string[]): Promise<string[]>;
+/**
+ * Clear the resolved path cache
+ * Useful after file changes or for testing
+ */
+export declare function clearResolvedPathCache(): void;
+/**
+ * Get all references from a file
+ * Convenience wrapper around extractReferences
+ *
+ * @param filePath - Path to file to extract references from
+ * @returns Array of Reference objects
+ */
+export declare function getReferencesFromFile(filePath: string): Promise<Reference[]>;
+//# sourceMappingURL=reference-parser.d.ts.map

package/dist/utils/reference-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-parser.d.ts","sourceRoot":"","sources":["../../src/utils/reference-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAmBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CA0B3D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqFvF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,SAAS,EAAE,GACtB,OAAO,CAAC;IACT,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B,CAAC,CAOD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,SAAS,EACpB,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,cAAc,CAAC,CAyCzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAOlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,SAAS,EACpB,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CA2CnB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAOlF"}