ctxman 3.0.0

package/examples/wizard-profiles/full/.methodinclude

@@ -0,0 +1,5 @@
+# Full Profile - Method Level Include Filters
+# Include all methods (no filtering)
+
+# Include everything with wildcard
+*

package/examples/wizard-profiles/full/profile.json

@@ -0,0 +1,28 @@
+{
+  "id": "full",
+  "name": "Full",
+  "icon": "📦",
+  "description": "Comprehensive analysis including everything",
+  "tokenBudget": {
+    "small": "50K-100K",
+    "medium": "100K-250K",
+    "large": "250K-500K+"
+  },
+  "includes": {
+    "files": ["All source code", "All tests", "All documentation", "All configuration"],
+    "methods": ["All methods (no filtering)"]
+  },
+  "excludes": {
+    "files": ["Only build artifacts and dependencies"],
+    "methods": ["None (includes everything)"]
+  },
+  "bestFor": [
+    "Complete codebase analysis",
+    "Large-scale refactoring",
+    "Architecture overhauls",
+    "Comprehensive documentation generation",
+    "Full system understanding",
+    "Migration projects"
+  ],
+  "warning": "High token usage - requires large context window LLMs"
+}

package/examples/wizard-profiles/llm-explain/.contextignore

@@ -0,0 +1,25 @@
+# LLM Explain Profile - File Level Ignore Filters
+
+# Tests (reduce noise)
+test/**
+tests/**
+__tests__/**
+**/*.test.*
+**/*.spec.*
+
+# Dependencies
+node_modules/**
+vendor/**
+
+# Build artifacts
+dist/**
+build/**
+out/**
+.next/**
+
+# Coverage
+coverage/**
+
+# Minified files
+**/*.min.js
+**/*.min.css

package/examples/wizard-profiles/llm-explain/.contextinclude

@@ -0,0 +1,33 @@
+# LLM Explain Profile - File Level Include Filters
+# Balanced view for explaining code to AI
+
+# Core source code
+src/**/*.js
+src/**/*.ts
+src/**/*.jsx
+src/**/*.tsx
+lib/**/*.js
+lib/**/*.ts
+
+# Entry points
+index.js
+index.ts
+main.*
+app.js
+app.ts
+server.js
+server.ts
+
+# Type definitions
+**/*.d.ts
+**/types/**
+**/interfaces/**
+
+# Configuration
+package.json
+tsconfig.json
+
+# Documentation
+README.md
+ARCHITECTURE.md
+API.md

package/examples/wizard-profiles/llm-explain/.methodignore

@@ -0,0 +1,19 @@
+# LLM Explain Profile - Method Level Ignore Filters
+
+# Private methods
+_*
+*Private*
+*Internal*
+__*
+
+# Test methods
+test*
+it
+describe
+beforeEach
+afterEach
+
+# Mock/stub helpers
+mock*
+stub*
+fake*

package/examples/wizard-profiles/llm-explain/.methodinclude

@@ -0,0 +1,48 @@
+# LLM Explain Profile - Method Level Include Filters
+
+# Constructors and initialization
+constructor
+initialize
+init*
+setup*
+
+# Public APIs
+*Handler
+*Controller
+*Service
+*Manager
+*Provider
+*Factory
+
+# Core business logic
+process*
+handle*
+execute*
+run*
+start*
+create*
+update*
+delete*
+get*
+set*
+
+# Data transformation
+transform*
+convert*
+parse*
+format*
+serialize*
+
+# Async operations
+async *
+*Async
+
+# Event handling
+on*
+emit*
+trigger*
+
+# Lifecycle methods
+mount*
+unmount*
+render

package/examples/wizard-profiles/llm-explain/profile.json

@@ -0,0 +1,27 @@
+{
+  "id": "llm-explain",
+  "name": "LLM Explain",
+  "icon": "💡",
+  "description": "Balanced view for explaining code architecture and implementation to AI",
+  "tokenBudget": {
+    "small": "25K-50K",
+    "medium": "50K-100K",
+    "large": "100K-200K"
+  },
+  "includes": {
+    "files": ["Core source code", "Entry points", "Types/interfaces", "Documentation"],
+    "methods": ["Constructors", "Public APIs", "Business logic", "Lifecycle methods"]
+  },
+  "excludes": {
+    "files": ["Tests", "Build artifacts"],
+    "methods": ["Private methods", "Test helpers"]
+  },
+  "bestFor": [
+    "Understanding unfamiliar codebases",
+    "Onboarding new team members",
+    "Generating architectural documentation",
+    "AI-assisted refactoring",
+    "Pair programming with AI",
+    "Learning from existing implementations"
+  ]
+}

package/examples/wizard-profiles/minimal/.contextignore

@@ -0,0 +1,27 @@
+# Minimal Profile - File Level Ignore Filters
+# Exclude everything non-essential
+
+# Tests
+test/**
+tests/**
+__tests__/**
+**/*.test.*
+**/*.spec.*
+
+# Dependencies
+node_modules/**
+vendor/**
+
+# Build artifacts
+dist/**
+build/**
+coverage/**
+
+# Documentation
+docs/**
+**/*.md
+
+# All config files except package.json
+*.config.js
+*.config.ts
+tsconfig.json

package/examples/wizard-profiles/minimal/.contextinclude

@@ -0,0 +1,14 @@
+# Minimal Profile - File Level Include Filters
+
+# Only core source files
+src/**/*.js
+src/**/*.ts
+lib/**/*.js
+lib/**/*.ts
+
+# Main entry point
+index.js
+index.ts
+
+# Essential configuration
+package.json

package/examples/wizard-profiles/minimal/.methodignore

@@ -0,0 +1,22 @@
+# Minimal Profile - Method Level Ignore Filters
+# Ignore most helper and utility methods
+
+# Private/internal
+_*
+*Private*
+*Internal*
+__*
+
+# Helpers
+*Helper
+*Util
+*Utils
+
+# Tests
+test*
+it
+describe
+
+# Getters/setters
+get *
+set *

package/examples/wizard-profiles/minimal/.methodinclude

@@ -0,0 +1,18 @@
+# Minimal Profile - Method Level Include Filters
+
+# Core entry points
+main
+init*
+setup*
+
+# Primary operations
+process*
+handle*
+execute*
+run*
+
+# Essential CRUD
+create*
+get*
+update*
+delete*

package/examples/wizard-profiles/minimal/profile.json

@@ -0,0 +1,26 @@
+{
+  "id": "minimal",
+  "name": "Minimal",
+  "icon": "🎯",
+  "description": "Extremely focused context for token-limited scenarios",
+  "tokenBudget": {
+    "small": "5K-10K",
+    "medium": "10K-25K",
+    "large": "25K-50K"
+  },
+  "includes": {
+    "files": ["Core source code only", "Main entry point", "Essential configuration"],
+    "methods": ["Entry points", "Primary operations", "Essential CRUD"]
+  },
+  "excludes": {
+    "files": ["Tests", "Documentation", "Build artifacts", "All non-essential files"],
+    "methods": ["Helper methods", "Test methods", "Internal utilities"]
+  },
+  "bestFor": [
+    "Quick bug fixes",
+    "Small feature additions",
+    "Token-limited LLM contexts",
+    "Fast responses from AI",
+    "Focus on specific functionality"
+  ]
+}

package/examples/wizard-profiles/security-audit/.contextignore

@@ -0,0 +1,36 @@
+# Security Audit Profile - File Level Ignore Filters
+# Exclude non-security-related code
+
+# Tests (focus on production code)
+test/**
+tests/**
+__tests__/**
+**/*.test.*
+**/*.spec.*
+
+# Documentation
+docs/**
+**/*.md
+!SECURITY.md
+
+# Dependencies
+node_modules/**
+vendor/**
+
+# Build artifacts
+dist/**
+build/**
+out/**
+
+# Frontend assets (usually not security-critical)
+public/**
+static/**
+assets/**
+**/*.css
+**/*.scss
+**/*.less
+
+# Mock/example data
+mocks/**
+fixtures/**
+examples/**

package/examples/wizard-profiles/security-audit/.contextinclude

@@ -0,0 +1,37 @@
+# Security Audit Profile - File Level Include Filters
+# Focus on security-critical code
+
+# Authentication & Authorization
+**/auth/**
+**/authentication/**
+**/authorization/**
+**/security/**
+**/guards/**
+**/middleware/**
+
+# API & Route handlers
+**/routes/**
+**/api/**
+**/controllers/**
+**/handlers/**
+**/endpoints/**
+
+# Database layer
+**/models/**
+**/schemas/**
+**/repositories/**
+**/migrations/**
+**/queries/**
+
+# Configuration (may contain security settings)
+*.config.js
+*.config.ts
+.env.example
+config/**/*.js
+config/**/*.ts
+
+# Security utilities
+**/validators/**
+**/sanitizers/**
+**/crypto/**
+**/encryption/**

package/examples/wizard-profiles/security-audit/.methodignore

@@ -0,0 +1,29 @@
+# Security Audit Profile - Method Level Ignore Filters
+# Exclude non-security methods
+
+# Test methods
+test*
+it
+describe
+beforeEach
+afterEach
+beforeAll
+afterAll
+
+# Mock/stub helpers
+mock*
+stub*
+fake*
+spy*
+
+# UI/presentation methods
+render*
+display*
+show*
+hide*
+
+# Logging (unless it's audit logging)
+log*
+debug*
+!auditLog*
+!securityLog*

package/examples/wizard-profiles/security-audit/.methodinclude

@@ -0,0 +1,60 @@
+# Security Audit Profile - Method Level Include Filters
+# Focus on security-critical functions
+
+# Authentication & Authorization
+auth*
+*Auth
+login*
+logout*
+verify*
+*Token
+*Session
+*Permission
+*Role
+authorize*
+authenticate*
+check*Access
+
+# Data validation and sanitization
+validate*
+sanitize*
+escape*
+clean*
+filter*
+*Validator
+
+# Input/Output handling
+parse*
+*Input
+*Output
+encode*
+decode*
+
+# Cryptography
+encrypt*
+decrypt*
+hash*
+*Hash
+sign*
+*Signature
+*Crypto
+
+# Database queries (SQL injection risks)
+query*
+execute*
+*Query
+*SQL
+*Database
+
+# File operations (path traversal risks)
+read*
+write*
+upload*
+download*
+*File
+*Path
+
+# Error handling (information disclosure)
+*Error
+*Exception
+handle*Error

package/examples/wizard-profiles/security-audit/profile.json

@@ -0,0 +1,34 @@
+{
+  "id": "security-audit",
+  "name": "Security Audit",
+  "icon": "🔒",
+  "description": "Focus on security-critical code and potential vulnerabilities",
+  "tokenBudget": {
+    "small": "15K-30K",
+    "medium": "30K-60K",
+    "large": "60K-120K"
+  },
+  "includes": {
+    "files": ["Auth modules", "API endpoints", "Middleware", "Database code", "Security configs"],
+    "methods": ["Authentication", "Validation", "Cryptography", "Database queries", "File operations"]
+  },
+  "excludes": {
+    "files": ["Tests", "Documentation", "Build artifacts"],
+    "methods": ["Test methods", "Mock/stub helpers"]
+  },
+  "bestFor": [
+    "Pre-deployment security reviews",
+    "Vulnerability assessments",
+    "Compliance audits",
+    "Penetration testing preparation",
+    "Security-focused code reviews"
+  ],
+  "securityFocus": [
+    "SQL Injection",
+    "XSS",
+    "Authentication Issues",
+    "Path Traversal",
+    "Information Disclosure",
+    "Cryptography"
+  ]
+}

package/index.js

@@ -0,0 +1,68 @@
+/**
+ * Ctxman - Public API
+ * Exports all modules for programmatic usage
+ */
+
+// Core analyzers
+import TokenCalculator from './lib/analyzers/token-calculator.js';
+import MethodAnalyzer from './lib/analyzers/method-analyzer.js';
+
+// Parsers
+import GitIgnoreParser from './lib/parsers/gitignore-parser.js';
+import MethodFilterParser from './lib/parsers/method-filter-parser.js';
+
+// Formatters
+import GitIngestFormatter from './lib/formatters/gitingest-formatter.js';
+import ToonFormatter from './lib/formatters/toon-formatter.js';
+import FormatRegistry from './lib/formatters/format-registry.js';
+
+// Utils
+import TokenUtils from './lib/utils/token-utils.js';
+import FileUtils from './lib/utils/file-utils.js';
+import ClipboardUtils from './lib/utils/clipboard-utils.js';
+import ConfigUtils from './lib/utils/config-utils.js';
+import FormatConverter from './lib/utils/format-converter.js';
+import ErrorHandler from './lib/utils/error-handler.js';
+import { Logger, getLogger, createLogger } from './lib/utils/logger.js'; // v2.3.6+
+import Updater from './lib/utils/updater.js'; // v2.3.6+
+import GitUtils from './lib/utils/git-utils.js'; // v2.3.6+
+
+// Orchestrator functions
+import { generateDigestFromReport, generateDigestFromContext } from './ctxman.js';
+
+export {
+    // Analyzers
+    TokenCalculator,
+    MethodAnalyzer,
+
+    // Parsers
+    GitIgnoreParser,
+    MethodFilterParser,
+
+    // Formatters
+    GitIngestFormatter,
+    ToonFormatter,
+    FormatRegistry,
+
+    // Utils
+    TokenUtils,
+    FileUtils,
+    ClipboardUtils,
+    ConfigUtils,
+    FormatConverter,
+    ErrorHandler,
+
+    // v2.3.6+ Utils
+    Logger,
+    getLogger,
+    createLogger,
+    Updater,
+    GitUtils,
+
+    // Functions
+    generateDigestFromReport,
+    generateDigestFromContext
+};
+
+// Alias for backward compatibility
+export { TokenCalculator as TokenAnalyzer };