@lumenflow/core 3.1.3 → 3.2.1

package/dist/lane-suggest-prompt.js

@@ -0,0 +1,362 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Lane Suggestion Prompt Module (WU-1189)
+ *
+ * Generates prompts for LLM-driven lane suggestions based on codebase context.
+ * This module gathers project context and generates structured prompts for
+ * the LLM to analyze and suggest appropriate lane definitions.
+ *
+ * Design decisions:
+ * - Uses LLM for semantic understanding (not hardcoded heuristics)
+ * - Gathers context from docs, structure, and existing config
+ * - Returns structured JSON for easy parsing
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import YAML from 'yaml';
+import { z } from 'zod';
+/**
+ * Schema for a single lane suggestion from the LLM
+ */
+export const LaneSuggestionSchema = z.object({
+    lane: z.string().describe('Lane name in "Parent: Sublane" format'),
+    description: z.string().describe('Brief description of what this lane covers'),
+    rationale: z.string().describe('Why this lane was suggested based on the codebase'),
+    code_paths: z.array(z.string()).describe('Glob patterns for files in this lane'),
+    keywords: z.array(z.string()).describe('Keywords that indicate work belongs to this lane'),
+});
+/**
+ * Schema for the complete LLM response
+ */
+export const LaneSuggestResponseSchema = z.object({
+    suggestions: z.array(LaneSuggestionSchema),
+});
+/**
+ * Read directory structure from project root
+ */
+function readDirectoryStructure(projectRoot) {
+    try {
+        const entries = readdirSync(projectRoot, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name)
+            .filter((name) => !name.startsWith('.') && name !== 'node_modules');
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read README.md content
+ */
+function readReadme(projectRoot) {
+    const readmePath = path.join(projectRoot, 'README.md');
+    if (!existsSync(readmePath))
+        return null;
+    try {
+        return readFileSync(readmePath, 'utf-8').slice(0, 2000);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read package.json and detect monorepo
+ */
+function readPackageJson(projectRoot) {
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        return { packageJson: null, isMonorepo: false };
+    }
+    try {
+        const content = readFileSync(packageJsonPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        const hasWorkspaces = !!pkg.workspaces;
+        const hasPnpmWorkspace = existsSync(path.join(projectRoot, 'pnpm-workspace.yaml'));
+        return {
+            packageJson: {
+                name: pkg.name,
+                description: pkg.description,
+                workspaces: pkg.workspaces,
+            },
+            isMonorepo: hasWorkspaces || hasPnpmWorkspace,
+        };
+    }
+    catch {
+        return { packageJson: null, isMonorepo: false };
+    }
+}
+/**
+ * Gather package names from packages/ directory
+ */
+function gatherPackageNames(projectRoot) {
+    const packagesDir = path.join(projectRoot, 'packages');
+    if (!existsSync(packagesDir))
+        return [];
+    try {
+        const packageDirs = readdirSync(packagesDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+        const names = [];
+        for (const pkgDir of packageDirs) {
+            const pkgPath = path.join(packagesDir, pkgDir);
+            if (pkgDir.startsWith('@')) {
+                // Scoped packages
+                const scopePackages = readdirSync(pkgPath, { withFileTypes: true })
+                    .filter((e) => e.isDirectory())
+                    .map((e) => `${pkgDir}/${e.name}`);
+                names.push(...scopePackages);
+            }
+            else if (existsSync(path.join(pkgPath, 'package.json'))) {
+                names.push(pkgDir);
+            }
+        }
+        return names;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read existing lane configuration
+ */
+function readExistingLanes(projectRoot) {
+    const laneConfigPath = path.join(projectRoot, '.lumenflow.lane-inference.yaml');
+    if (!existsSync(laneConfigPath))
+        return [];
+    try {
+        const content = readFileSync(laneConfigPath, 'utf-8');
+        const config = YAML.parse(content);
+        const lanes = [];
+        for (const [parent, sublanes] of Object.entries(config)) {
+            if (typeof sublanes === 'object' && sublanes !== null) {
+                for (const sublane of Object.keys(sublanes)) {
+                    lanes.push(`${parent}: ${sublane}`);
+                }
+            }
+        }
+        return lanes;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Gather project context from the filesystem
+ */
+export function gatherProjectContext(projectRoot) {
+    const directoryStructure = readDirectoryStructure(projectRoot);
+    const { packageJson, isMonorepo: isMonorepoPkg } = readPackageJson(projectRoot);
+    const hasPnpmWorkspace = existsSync(path.join(projectRoot, 'pnpm-workspace.yaml'));
+    const hasPackagesDir = directoryStructure.includes('packages');
+    return {
+        directoryStructure,
+        hasDocsDir: directoryStructure.includes('docs'),
+        hasAppsDir: directoryStructure.includes('apps'),
+        hasPackagesDir,
+        readme: readReadme(projectRoot),
+        packageJson,
+        isMonorepo: isMonorepoPkg || hasPnpmWorkspace,
+        packageNames: hasPackagesDir ? gatherPackageNames(projectRoot) : [],
+        existingLanes: readExistingLanes(projectRoot),
+    };
+}
+/**
+ * Generate the system prompt for lane suggestion
+ */
+export function generateSystemPrompt() {
+    return `You are an expert software architect helping configure a LumenFlow workflow project.
+
+LumenFlow uses "lanes" to organize work. Each lane has:
+- A name in "Parent: Sublane" format (e.g., "Framework: Core", "Operations: CI/CD")
+- code_paths: Glob patterns for files that belong to this lane
+- keywords: Terms that indicate work belongs to this lane
+- description: Brief explanation of what the lane covers
+
+Lane naming conventions:
+- Parent categories: Framework, Operations, Content, Experience, Intelligence, Quality
+- Sublane names should be specific and descriptive
+- Use "/" for sublanes that are further subdivisions (e.g., "Operations: CI/CD")
+
+Your task is to analyze the provided project context and suggest appropriate lane definitions.
+
+Respond with a JSON object containing an array of lane suggestions. Each suggestion must include:
+- lane: The lane name in "Parent: Sublane" format
+- description: Brief description of what this lane covers
+- rationale: Why you're suggesting this lane based on the project structure
+- code_paths: Array of glob patterns for files in this lane
+- keywords: Array of keywords that indicate work belongs to this lane
+
+Example response:
+{
+  "suggestions": [
+    {
+      "lane": "Framework: Core",
+      "description": "Core library with shared utilities and base functionality",
+      "rationale": "Found packages/core with TypeScript source files and utility modules",
+      "code_paths": ["packages/core/**"],
+      "keywords": ["core", "utilities", "shared", "base"]
+    }
+  ]
+}`;
+}
+/**
+ * Generate the user prompt with project context
+ */
+export function generateUserPrompt(context) {
+    const sections = [];
+    sections.push('# Project Analysis Request\n');
+    sections.push('Please analyze this project structure and suggest appropriate LumenFlow lanes.\n');
+    // Project type
+    sections.push(`## Project Type`);
+    sections.push(`- Monorepo: ${context.isMonorepo ? 'Yes' : 'No'}`);
+    sections.push(`- Has packages/: ${context.hasPackagesDir ? 'Yes' : 'No'}`);
+    sections.push(`- Has apps/: ${context.hasAppsDir ? 'Yes' : 'No'}`);
+    sections.push(`- Has docs/: ${context.hasDocsDir ? 'Yes' : 'No'}`);
+    sections.push('');
+    // Directory structure
+    if (context.directoryStructure.length > 0) {
+        sections.push('## Top-Level Directories');
+        sections.push(context.directoryStructure.map((d) => `- ${d}/`).join('\n'));
+        sections.push('');
+    }
+    // Package names
+    if (context.packageNames.length > 0) {
+        sections.push('## Packages Found');
+        sections.push(context.packageNames.map((p) => `- ${p}`).join('\n'));
+        sections.push('');
+    }
+    // Package.json info
+    if (context.packageJson) {
+        sections.push('## Package Info');
+        if (context.packageJson.name) {
+            sections.push(`- Name: ${context.packageJson.name}`);
+        }
+        if (context.packageJson.description) {
+            sections.push(`- Description: ${context.packageJson.description}`);
+        }
+        sections.push('');
+    }
+    // README excerpt
+    if (context.readme) {
+        sections.push('## README Excerpt');
+        sections.push('```');
+        sections.push(context.readme.slice(0, 1000));
+        sections.push('```');
+        sections.push('');
+    }
+    // Existing lanes
+    if (context.existingLanes.length > 0) {
+        sections.push('## Existing Lanes (for reference)');
+        sections.push('The project already has these lanes configured:');
+        sections.push(context.existingLanes.map((l) => `- ${l}`).join('\n'));
+        sections.push('');
+        sections.push('Consider these when making suggestions to maintain consistency.');
+        sections.push('');
+    }
+    sections.push('## Instructions');
+    sections.push('Based on this context, suggest lanes that would help organize work on this project.');
+    sections.push('Consider:');
+    sections.push('- The types of packages/modules present');
+    sections.push('- Common development patterns for this project type');
+    sections.push('- Standard lanes for documentation, CI/CD, and operations');
+    sections.push('');
+    sections.push('Respond with JSON only, no markdown code fences or explanation.');
+    return sections.join('\n');
+}
+/**
+ * Parse and validate LLM response
+ */
+export function parseLLMResponse(response) {
+    // Try to extract JSON from response (LLMs sometimes add markdown code fences)
+    let jsonStr = response.trim();
+    // Remove markdown code fences if present
+    if (jsonStr.startsWith('```json')) {
+        jsonStr = jsonStr.slice(7);
+    }
+    else if (jsonStr.startsWith('```')) {
+        jsonStr = jsonStr.slice(3);
+    }
+    if (jsonStr.endsWith('```')) {
+        jsonStr = jsonStr.slice(0, -3);
+    }
+    jsonStr = jsonStr.trim();
+    // Parse JSON
+    const parsed = JSON.parse(jsonStr);
+    // Validate with schema
+    return LaneSuggestResponseSchema.parse(parsed);
+}
+/**
+ * Validate that a lane name follows the "Parent: Sublane" format
+ */
+export function isValidLaneFormat(lane) {
+    // Format: "Parent: Sublane" where both start with uppercase
+    return /^[A-Z][a-zA-Z]+: [A-Z][a-zA-Z/]+$/.test(lane);
+}
+/**
+ * Generate a dry-run preview of what would be sent to the LLM
+ */
+export function generateDryRunPreview(projectRoot) {
+    const context = gatherProjectContext(projectRoot);
+    const systemPrompt = generateSystemPrompt();
+    const userPrompt = generateUserPrompt(context);
+    return {
+        context,
+        systemPrompt,
+        userPrompt,
+    };
+}
+/**
+ * Get default lane suggestions for a minimal project
+ * Used when LLM is not available or for dry-run
+ */
+export function getDefaultSuggestions(context) {
+    const suggestions = [];
+    // Always suggest documentation lane if docs exist
+    if (context.hasDocsDir) {
+        suggestions.push({
+            lane: 'Content: Documentation',
+            description: 'Project documentation and guides',
+            rationale: 'Found docs/ directory',
+            code_paths: ['docs/**', 'README.md', '*.md'],
+            keywords: ['docs', 'documentation', 'readme', 'guide'],
+        });
+    }
+    // Suggest operations lane for CI/CD
+    if (context.directoryStructure.some((d) => d === '.github' || d === '.gitlab-ci')) {
+        suggestions.push({
+            lane: 'Operations: CI/CD',
+            description: 'Continuous integration and deployment',
+            rationale: 'Found CI/CD configuration directory',
+            code_paths: ['.github/**', '.gitlab-ci.yml'],
+            keywords: ['ci', 'cd', 'workflow', 'pipeline', 'actions'],
+        });
+    }
+    // For monorepos, suggest lanes based on package names
+    if (context.isMonorepo && context.packageNames.length > 0) {
+        for (const pkg of context.packageNames) {
+            const pkgName = pkg.split('/').pop() || pkg;
+            const capitalizedName = pkgName.charAt(0).toUpperCase() + pkgName.slice(1);
+            suggestions.push({
+                lane: `Framework: ${capitalizedName}`,
+                description: `${capitalizedName} package functionality`,
+                rationale: `Found package: ${pkg}`,
+                code_paths: [`packages/${pkg}/**`],
+                keywords: [pkgName.toLowerCase()],
+            });
+        }
+    }
+    // Fallback: suggest a core development lane
+    if (suggestions.length === 0) {
+        suggestions.push({
+            lane: 'Development: Core',
+            description: 'Main application code',
+            rationale: 'Default lane for project source code',
+            code_paths: ['src/**', 'lib/**'],
+            keywords: ['source', 'core', 'main'],
+        });
+    }
+    return suggestions;
+}
+//# sourceMappingURL=lane-suggest-prompt.js.map

package/dist/lane-suggest-prompt.js.map

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

package/dist/lane-validator.d.ts

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * Lane-to-Code_Paths Validator (WU-1372)
+ *
+ * Validates that a WU's code_paths are consistent with its assigned lane.
+ * This is an advisory validation - it warns but never blocks wu:claim or wu:done.
+ *
+ * Uses LANE_PATH_PATTERNS from wu-constants.ts to define which paths
+ * are discouraged for each lane parent.
+ *
+ * Part of INIT-002: Workflow Integrity initiative.
+ *
+ * @see {@link wu-constants.ts} - LANE_PATH_PATTERNS definition
+ * @see {@link lane-checker.ts} - extractParent for lane parsing
+ */
+/**
+ * @typedef {object} LaneValidationResult
+ * @property {boolean} hasWarnings - True if UnsafeAny code_paths violate lane patterns
+ * @property {string[]} warnings - Human-readable warning messages
+ * @property {string[]} violations - List of violating code_paths
+ * @property {boolean} skipped - True if validation was skipped (no patterns or no code_paths)
+ */
+/**
+ * Validate WU code_paths against lane's expected patterns.
+ *
+ * Checks if UnsafeAny code_paths match the "exclude" patterns for the lane,
+ * unless they also match an "allowExceptions" pattern.
+ *
+ * @param {object} doc - WU YAML document (parsed)
+ * @param {string} lane - Lane name (e.g., "Operations: Tooling")
+ * @returns {LaneValidationResult} Validation result with warnings if UnsafeAny
+ */
+export declare function validateLaneCodePaths(doc: UnsafeAny, lane: UnsafeAny): {
+    hasWarnings: boolean;
+    warnings: any;
+    violations: any;
+    skipped: boolean;
+};
+/**
+ * Log lane validation warnings to console.
+ *
+ * Helper function to format and display warnings consistently.
+ * Uses LOG_PREFIX.CLAIM format.
+ *
+ * @param {LaneValidationResult} result - Result from validateLaneCodePaths
+ * @param {string} logPrefix - Log prefix (e.g., "[wu-claim]")
+ */
+export declare function logLaneValidationWarnings(result: UnsafeAny, logPrefix?: string): void;
+//# sourceMappingURL=lane-validator.d.ts.map

package/dist/lane-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-validator.d.ts","sourceRoot":"","sources":["../src/lane-validator.ts"],"names":[],"mappings":";AAGA;;;;;;;;;;;;;GAaG;AAMH;;;;;;GAMG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS;;;;;EAuEpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,SAAe,QAUpF"}

package/dist/lane-validator.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Lane-to-Code_Paths Validator (WU-1372)
+ *
+ * Validates that a WU's code_paths are consistent with its assigned lane.
+ * This is an advisory validation - it warns but never blocks wu:claim or wu:done.
+ *
+ * Uses LANE_PATH_PATTERNS from wu-constants.ts to define which paths
+ * are discouraged for each lane parent.
+ *
+ * Part of INIT-002: Workflow Integrity initiative.
+ *
+ * @see {@link wu-constants.ts} - LANE_PATH_PATTERNS definition
+ * @see {@link lane-checker.ts} - extractParent for lane parsing
+ */
+import micromatch from 'micromatch';
+import { extractParent } from './lane-checker.js';
+import { LANE_PATH_PATTERNS } from './wu-constants.js';
+/**
+ * @typedef {object} LaneValidationResult
+ * @property {boolean} hasWarnings - True if UnsafeAny code_paths violate lane patterns
+ * @property {string[]} warnings - Human-readable warning messages
+ * @property {string[]} violations - List of violating code_paths
+ * @property {boolean} skipped - True if validation was skipped (no patterns or no code_paths)
+ */
+/**
+ * Validate WU code_paths against lane's expected patterns.
+ *
+ * Checks if UnsafeAny code_paths match the "exclude" patterns for the lane,
+ * unless they also match an "allowExceptions" pattern.
+ *
+ * @param {object} doc - WU YAML document (parsed)
+ * @param {string} lane - Lane name (e.g., "Operations: Tooling")
+ * @returns {LaneValidationResult} Validation result with warnings if UnsafeAny
+ */
+export function validateLaneCodePaths(doc, lane) {
+    const codePaths = doc.code_paths || [];
+    // Skip validation if no code_paths
+    if (!codePaths || codePaths.length === 0) {
+        return {
+            hasWarnings: false,
+            warnings: [],
+            violations: [],
+            skipped: true,
+        };
+    }
+    // Extract parent lane (e.g., "Operations" from "Operations: Tooling")
+    const parentLane = extractParent(lane);
+    // Get patterns for this lane parent
+    const patterns = LANE_PATH_PATTERNS[parentLane];
+    // Skip validation if no patterns defined for this lane
+    if (!patterns) {
+        return {
+            hasWarnings: false,
+            warnings: [],
+            violations: [],
+            skipped: true,
+        };
+    }
+    const { exclude = [], allowExceptions = [] } = patterns;
+    // Find violations: paths that match exclude patterns but NOT exception patterns
+    const violations = codePaths.filter((codePath) => {
+        // Check if path matches UnsafeAny exclude pattern
+        const matchesExclude = micromatch.isMatch(codePath, exclude, { nocase: true });
+        if (!matchesExclude) {
+            return false; // Path doesn't match UnsafeAny exclude pattern, not a violation
+        }
+        // Check if path matches UnsafeAny exception pattern
+        if (allowExceptions.length > 0) {
+            const matchesException = micromatch.isMatch(codePath, allowExceptions, { nocase: true });
+            if (matchesException) {
+                return false; // Path is allowed by exception, not a violation
+            }
+        }
+        return true; // Path matches exclude and no exception, this is a violation
+    });
+    if (violations.length === 0) {
+        return {
+            hasWarnings: false,
+            warnings: [],
+            violations: [],
+            skipped: false,
+        };
+    }
+    // Build warning messages
+    const warnings = violations.map((path) => {
+        return `Lane "${lane}" typically doesn't include "${path}" (expected for different lane)`;
+    });
+    return {
+        hasWarnings: true,
+        warnings,
+        violations,
+        skipped: false,
+    };
+}
+/**
+ * Log lane validation warnings to console.
+ *
+ * Helper function to format and display warnings consistently.
+ * Uses LOG_PREFIX.CLAIM format.
+ *
+ * @param {LaneValidationResult} result - Result from validateLaneCodePaths
+ * @param {string} logPrefix - Log prefix (e.g., "[wu-claim]")
+ */
+export function logLaneValidationWarnings(result, logPrefix = '[wu-claim]') {
+    if (!result.hasWarnings) {
+        return;
+    }
+    console.warn(`${logPrefix} Lane/code_paths mismatch detected (advisory only):`);
+    for (const warning of result.warnings) {
+        console.warn(`${logPrefix}   ${warning}`);
+    }
+    console.warn(`${logPrefix} This is a warning only - proceeding with claim.`);
+}
+//# sourceMappingURL=lane-validator.js.map

package/dist/lane-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-validator.js","sourceRoot":"","sources":["../src/lane-validator.ts"],"names":[],"mappings":";AACA,iCAAiC;AACjC,yCAAyC;AACzC;;;;;;;;;;;;;GAaG;AAEH,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;GAMG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAc,EAAE,IAAe;IACnE,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;IAEvC,mCAAmC;IACnC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEvC,oCAAoC;IACpC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,UAA6C,CAAC,CAAC;IAEnF,uDAAuD;IACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,QAAQ,CAAC;IAExD,gFAAgF;IAChF,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,QAAmB,EAAE,EAAE;QAC1D,kDAAkD;QAClD,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/E,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC,CAAC,gEAAgE;QAChF,CAAC;QAED,oDAAoD;QACpD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACzF,IAAI,gBAAgB,EAAE,CAAC;gBACrB,OAAO,KAAK,CAAC,CAAC,gDAAgD;YAChE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,CAAC,6DAA6D;IAC5E,CAAC,CAAC,CAAC;IAEH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAe,EAAE,EAAE;QAClD,OAAO,SAAS,IAAI,gCAAgC,IAAI,iCAAiC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,QAAQ;QACR,UAAU;QACV,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,SAAS,GAAG,YAAY;IACnF,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,qDAAqD,CAAC,CAAC;IAChF,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,MAAM,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,kDAAkD,CAAC,CAAC;AAC/E,CAAC"}

package/dist/logs-lib.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Log source configurations
+ * Each source has a path relative to project root and a source identifier
+ */
+/**
+ * Log entry structure from JSON logs
+ */
+interface LogEntry {
+    time?: string;
+    level?: string;
+    msg?: string;
+    message?: string;
+    event?: string;
+    _source?: string;
+    [key: string]: unknown;
+}
+/**
+ * Parsed log arguments
+ */
+interface ParsedLogsArgs {
+    last?: number;
+    level?: string;
+    service?: string;
+    filter?: string;
+    json?: boolean;
+    help?: boolean;
+}
+export declare const LOG_SOURCES: {
+    path: string;
+    source: string;
+}[];
+/**
+ * Parse a single log line (NDJSON format)
+ *
+ * @param {string} line - JSON log line
+ * @returns {object|null} Parsed log object or null if invalid
+ */
+export declare function parseLogLine(line: UnsafeAny): any;
+/**
+ * Options for filtering logs
+ */
+export interface FilterLogsOptions {
+    /** Filter by log level (info, warn, error) */
+    level?: string;
+    /** Filter by service/message prefix */
+    service?: string;
+    /** Arbitrary text filter (searches in JSON) */
+    filter?: string;
+    /** Return only last N entries */
+    last?: number;
+}
+/**
+ * Filter log entries by criteria
+ *
+ * @param {object[]} logs - Array of log objects
+ * @param {FilterLogsOptions} options - Filter options
+ * @returns {object[]} Filtered logs
+ */
+export declare function filterLogs(logs: LogEntry[], options?: FilterLogsOptions): LogEntry[];
+/**
+ * Options for aggregating logs
+ */
+export interface AggregateLogsOptions {
+    /** Working directory (defaults to process.cwd()) */
+    cwd?: string;
+}
+/**
+ * Aggregate logs from all configured sources
+ *
+ * @param {AggregateLogsOptions} options - Options
+ * @returns {Promise<object[]>} Aggregated and sorted log entries
+ */
+export declare function aggregateLogs(options?: AggregateLogsOptions): Promise<any[]>;
+/**
+ * Parse command line arguments for logs command
+ *
+ * @param {string[]} args - Command line arguments (without node and script)
+ * @returns {object} Parsed options
+ */
+export declare function parseLogsArgs(args: string[]): ParsedLogsArgs;
+/**
+ * Format a log entry for console display
+ *
+ * @param {object} log - Log object
+ * @returns {string} Formatted log line
+ */
+export declare function formatLogEntry(log: LogEntry): string;
+export {};
+//# sourceMappingURL=logs-lib.d.ts.map

package/dist/logs-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs-lib.d.ts","sourceRoot":"","sources":["../src/logs-lib.ts"],"names":[],"mappings":"AAwBA;;;GAGG;AACH;;GAEG;AACH,UAAU,QAAQ;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AASD,eAAO,MAAM,WAAW;;;GAKvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,OAe3C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,GAAE,iBAAsB,GAAG,QAAQ,EAAE,CAiCxF;AAiCD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,kBAmBrE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,CAgC5D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,UAoC3C"}