@nghyane/arcane 0.1.12 → 0.1.14

package/src/commit/prompts/changelog-system.md

@@ -1,50 +0,0 @@
-You're expert changelog writer analyzing git diffs to produce Keep a Changelog entries.
-
-<instructions>
-1. Identify only user-visible changes
-2. Categorize each change (use categories below)
-3. Omit categories with no entries
-</instructions>
-
-<categories>
-- Added: New features, public APIs, user-facing capabilities
-- Changed: Modified behavior
-- Deprecated: Features scheduled for removal
-- Removed: Deleted features or APIs
-- Fixed: Bug fixes with observable impact
-- Security: Vulnerability fixes
-- Breaking Changes: API-incompatible changes (use sparingly)
-</categories>
-
-<entry_format>
-- Start with past-tense verb (Added, Fixed, Implemented, Updated)
-- Describe user-visible impact, not implementation
-- Name specific feature, option, or behavior
-- Keep 1-2 lines, no trailing periods
-</entry_format>
-
-<examples>
-Good:
-- Added --dry-run flag to preview changes without applying them
-- Fixed memory leak when processing large files
-- Changed default timeout from 30s to 60s for slow connections
-
-Bad:
-- **cli**: Added dry-run flag -> redundant scope prefix
-- Added new feature. -> vague, trailing period
-- Refactored parser internals -> not user-visible
-
-Breaking Changes:
-- Removed legacy auth flow; users must re-authenticate with OAuth tokens
-</examples>
-
-<exclude>
-Internal refactoring, code style changes, test-only modifications, minor doc updates.
-</exclude>
-
-<output_format>
-Return ONLY valid JSON; no markdown fences or explanation.
-
-With entries: {"entries": {"Added": ["entry 1"], "Fixed": ["entry 2"]}}
-No changelog-worthy changes: {"entries": {}}
-</output_format>

package/src/commit/prompts/changelog-user.md

@@ -1,18 +0,0 @@
-<context>
-Changelog: {{ changelog_path }}
-{{#if is_package_changelog}}Scope: Package-level changelog. Omit package name prefix from entries.{{/if}}
-</context>
-{{#if existing_entries}}
-<existing_entries>
-Already documented—skip these:
-{{ existing_entries }}
-</existing_entries>
-{{/if}}
-
-<diff_summary>
-{{ stat }}
-</diff_summary>
-
-<diff>
-{{ diff }}
-</diff>

package/src/commit/prompts/file-observer-system.md

@@ -1,24 +0,0 @@
-<role>Expert code analyst extracting structured observations from diffs.</role>
-
-<instructions>
-Extract factual observations from diff. This matters—be precise.
-1. Use past-tense verb + specific target + optional purpose
-2. Max 100 characters per observation
-3. Consolidate related changes (e.g., "renamed 5 helper functions")
-4. Return 1-5 observations only
-</instructions>
-
-<scope>
-Include: functions, methods, types, API changes, behavior/logic changes, error handling, performance, security.
-
-Exclude: import reordering, whitespace/formatting, comment-only changes, debug statements.
-</scope>
-
-<output_format>
-Plain list, no preamble, no summary, no markdown formatting.
-- added 'parse_config()' function for TOML configuration loading
-- removed deprecated 'legacy_init()' and all callers
-- changed 'Connection::new()' to accept '&Config' instead of individual params
-</output_format>
-
-Observations only. Classification in reduce phase.

package/src/commit/prompts/file-observer-user.md

@@ -1,8 +0,0 @@
-<file path="{{ filename }}">
-{{ diff }}
-</file>
-{{#if context_header}}
-<related_files>
-{{ context_header }}
-</related_files>
-{{/if}}

package/src/commit/prompts/reduce-system.md

@@ -1,50 +0,0 @@
-Senior engineer synthesizing file-level observations into conventional commit analysis.
-<context>
-Given map-phase observations, produce unified commit classification with changelog metadata.
-</context>
-<instructions>
-Determine:
-1. TYPE: Single classification
-2. SCOPE: Primary component
-3. DETAILS: 3–4 summary points (max 6)
-4. CHANGELOG: Metadata for user-visible changes
-</instructions>
-<scope_rules>
-- Component name if >=60% changes target it
-- null if spread across multiple components
-- scope_candidates as primary source
-- Valid: specific component names (api, parser, config, etc.)
-</scope_rules>
-<output_format>
-Each detail point:
-- Start with past-tense verb (added, fixed, moved, extracted)
-- Under 120 chars, ends with period
-- Group related cross-file changes
-Priority: user-visible behavior > performance/security > architecture > internal implementation
-changelog_category: Added|Changed|Fixed|Deprecated|Removed|Security
-user_visible: true for features, user-facing bugs, breaking changes, security
-</output_format>
-<example>
-Input observations:
-- api/client.ts: added token refresh guard to prevent duplicate refreshes
-- api/http.ts: introduced retry wrapper for 429 responses
-- api/index.ts: updated exports for retry helper
-Output:
-{
-"type": "fix",
-"scope": "api",
-"details": [
-{
-"text": "Added token refresh guard to prevent duplicate refreshes.",
-"changelog_category": "Fixed",
-"user_visible": true
-},
-{
-"text": "Introduced retry wrapper for 429 responses.",
-"changelog_category": "Fixed",
-"user_visible": true
-}
-],
-"issue_refs": []
-}
-</example>

package/src/commit/prompts/reduce-user.md

@@ -1,17 +0,0 @@
-{{#if types_description}}
-<type_definitions>
-{{ types_description }}
-</type_definitions>
-{{/if}}
-
-<observations>
-{{ observations }}
-</observations>
-
-<diff_statistics>
-{{ stat }}
-</diff_statistics>
-
-<scope_candidates>
-{{ scope_candidates }}
-</scope_candidates>

package/src/commit/prompts/summary-retry.md

@@ -1,3 +0,0 @@
-{{#if base_context}}
-{{ base_context }}
-{{/if}}Previous summary failed validation: {{ errors }}

package/src/commit/prompts/summary-system.md

@@ -1,38 +0,0 @@
-You are commit message specialist generating precise, informative descriptions.
-<context>
-Output: ONLY description after "{{ commit_type }}{{ scope_prefix }}:"; max {{ chars }} chars; no trailing period; no type prefix.
-</context>
-
-<instructions>
-1. Start with lowercase past-tense verb (not "{{ commit_type }}")
-2. Name specific subsystem/component affected
-3. Include WHY when clarifies intent
-4. One focused concept per message
-</instructions>
-
-<verb_reference>
-|Type|Use|
-|---|---|
-|feat|added, introduced, implemented, enabled|
-|fix|corrected, resolved, patched, addressed|
-|refactor|restructured, reorganized, migrated, simplified|
-|perf|optimized, reduced, eliminated, accelerated|
-|docs|documented, clarified, expanded|
-|build|upgraded, pinned, configured|
-|chore|cleaned, removed, renamed, organized|
-</verb_reference>
-<examples>
-feat | TLS encryption added to HTTP client for MITM prevention
--> added TLS support to prevent man-in-the-middle attacks
-refactor | Consolidated HTTP transport into unified builder pattern
--> migrated HTTP transport to unified builder API
-fix | Race condition in connection pool causing exhaustion under load
--> corrected race condition causing connection pool exhaustion
-perf | Batch processing optimized to reduce memory allocations
--> eliminated allocation overhead in batch processing
-build | Updated serde to fix CVE-2024-1234
--> upgraded serde to 1.0.200 for CVE-2024-1234
-</examples>
-<banned_words>
-comprehensive, various, several, improved, enhanced, quickly, simply, basically, this change, this commit, now
-</banned_words>

package/src/commit/prompts/summary-user.md

@@ -1,13 +0,0 @@
-{{#if user_context}}
-<user_context>
-{{ user_context }}
-</user_context>
-{{/if}}
-
-<detail_points>
-{{ details }}
-</detail_points>
-
-<diff_stat>
-{{ stat }}
-</diff_stat>

package/src/commit/prompts/types-description.md

@@ -1,2 +0,0 @@
-Types: feat, fix, refactor, perf, docs, test, build, ci, chore, style, revert.
-Format: <type>(<scope>): <summary> with past-tense summary.

package/src/commit/types.ts

@@ -1,109 +0,0 @@
-/**
- * Types for the arcane commit pipeline.
- */
-
-export type CommitType =
-	| "feat"
-	| "fix"
-	| "refactor"
-	| "perf"
-	| "docs"
-	| "test"
-	| "build"
-	| "ci"
-	| "chore"
-	| "style"
-	| "revert";
-
-export type ChangelogCategory =
-	| "Breaking Changes"
-	| "Added"
-	| "Changed"
-	| "Deprecated"
-	| "Removed"
-	| "Fixed"
-	| "Security";
-
-export interface CommitCommandArgs {
-	/** Push after commit */
-	push: boolean;
-	/** Preview without committing */
-	dryRun: boolean;
-	/** Skip changelog updates */
-	noChangelog: boolean;
-	/** Use legacy deterministic pipeline */
-	legacy?: boolean;
-	/** Additional user context for the model */
-	context?: string;
-	/** Override the model selection */
-	model?: string;
-}
-
-export interface NumstatEntry {
-	path: string;
-	additions: number;
-	deletions: number;
-}
-
-export interface ConventionalDetail {
-	text: string;
-	changelogCategory?: ChangelogCategory;
-	userVisible: boolean;
-}
-
-export interface ConventionalAnalysis {
-	type: CommitType;
-	scope: string | null;
-	details: ConventionalDetail[];
-	issueRefs: string[];
-}
-
-export interface CommitSummary {
-	summary: string;
-}
-
-export interface FileObservation {
-	file: string;
-	observations: string[];
-	additions: number;
-	deletions: number;
-}
-
-export interface FileDiff {
-	filename: string;
-	content: string;
-	additions: number;
-	deletions: number;
-	isBinary: boolean;
-}
-
-export interface DiffHunk {
-	index: number;
-	header: string;
-	oldStart: number;
-	oldLines: number;
-	newStart: number;
-	newLines: number;
-	content: string;
-}
-
-export interface FileHunks {
-	filename: string;
-	isBinary: boolean;
-	hunks: DiffHunk[];
-}
-
-export interface ChangelogBoundary {
-	changelogPath: string;
-	files: string[];
-}
-
-export interface UnreleasedSection {
-	startLine: number;
-	endLine: number;
-	entries: Record<string, string[]>;
-}
-
-export interface ChangelogGenerationResult {
-	entries: Record<string, string[]>;
-}

package/src/commit/utils/exclusions.ts

@@ -1,42 +0,0 @@
-const EXCLUDED_FILES = [
-	"Cargo.lock",
-	"package-lock.json",
-	"npm-shrinkwrap.json",
-	"yarn.lock",
-	"pnpm-lock.yaml",
-	"shrinkwrap.yaml",
-	"bun.lock",
-	"bun.lockb",
-	"deno.lock",
-	"composer.lock",
-	"Gemfile.lock",
-	"poetry.lock",
-	"Pipfile.lock",
-	"pdm.lock",
-	"uv.lock",
-	"go.sum",
-	"flake.lock",
-	"pubspec.lock",
-	"Podfile.lock",
-	"Packages.resolved",
-	"mix.lock",
-	"packages.lock.json",
-	"config.yml.lock",
-	"config.yaml.lock",
-	"settings.yml.lock",
-	"settings.yaml.lock",
-];
-
-const EXCLUDED_SUFFIXES = [".lock.yml", ".lock.yaml", "-lock.yml", "-lock.yaml"];
-
-export function isExcludedFile(path: string): boolean {
-	const lower = path.toLowerCase();
-	if (EXCLUDED_FILES.some(name => lower.endsWith(name.toLowerCase()))) {
-		return true;
-	}
-	return EXCLUDED_SUFFIXES.some(suffix => lower.endsWith(suffix));
-}
-
-export function filterExcludedFiles<T extends { filename: string }>(files: T[]): T[] {
-	return files.filter(file => !isExcludedFile(file.filename));
-}

package/src/mcp/render.ts

@@ -1,123 +0,0 @@
-/**
- * TUI rendering for MCP tools.
- *
- * Provides structured display of MCP tool calls and results,
- * showing args and output in JSON tree format similar to task tool.
- */
-import type { Component } from "@nghyane/arcane-tui";
-import { Text } from "@nghyane/arcane-tui";
-import type { RenderResultOptions } from "../extensibility/custom-tools/types";
-import type { Theme } from "../modes/theme/theme";
-import {
-	formatArgsInline,
-	JSON_TREE_MAX_DEPTH_COLLAPSED,
-	JSON_TREE_MAX_DEPTH_EXPANDED,
-	JSON_TREE_MAX_LINES_COLLAPSED,
-	JSON_TREE_MAX_LINES_EXPANDED,
-	JSON_TREE_SCALAR_LEN_COLLAPSED,
-	JSON_TREE_SCALAR_LEN_EXPANDED,
-	renderJsonTreeLines,
-} from "../tools/json-tree";
-import { formatExpandHint, truncateToWidth } from "../tools/render-utils";
-import { renderStatusLine } from "../tui";
-import type { MCPToolDetails } from "./tool-bridge";
-
-/**
- * Render MCP tool call.
- */
-export function renderMCPCall(args: Record<string, unknown>, theme: Theme, label: string): Component {
-	const lines: string[] = [];
-	lines.push(renderStatusLine({ icon: "pending", title: label }, theme));
-
-	if (args && typeof args === "object" && Object.keys(args).length > 0) {
-		// Show args inline preview
-		const preview = formatArgsInline(args, 70);
-		if (preview) {
-			lines.push(` ${theme.fg("dim", theme.tree.last)} ${theme.fg("dim", preview)}`);
-		}
-	}
-
-	return new Text(lines.join("\n"), 0, 0);
-}
-
-/**
- * Render MCP tool result.
- */
-export function renderMCPResult(
-	result: { content: Array<{ type: string; text?: string }>; details?: MCPToolDetails; isError?: boolean },
-	options: RenderResultOptions,
-	theme: Theme,
-	args?: Record<string, unknown>,
-): Component {
-	const { expanded } = options;
-	const lines: string[] = [];
-
-	// Args section (when expanded)
-	if (expanded && args && typeof args === "object" && Object.keys(args).length > 0) {
-		lines.push(`${theme.fg("dim", "Args")}`);
-		const maxDepth = JSON_TREE_MAX_DEPTH_EXPANDED;
-		const maxLines = JSON_TREE_MAX_LINES_EXPANDED;
-		const tree = renderJsonTreeLines(args, theme, maxDepth, maxLines, JSON_TREE_SCALAR_LEN_EXPANDED);
-		for (const line of tree.lines) {
-			lines.push(line);
-		}
-		if (tree.truncated) {
-			lines.push(theme.fg("dim", "…"));
-		}
-		lines.push(""); // Blank line before output
-	}
-
-	// Output section
-	const textContent = result.content?.find(c => c.type === "text")?.text ?? "";
-	const trimmedOutput = textContent.trimEnd();
-
-	if (!trimmedOutput) {
-		lines.push(theme.fg("dim", "(no output)"));
-		return new Text(lines.join("\n"), 0, 0);
-	}
-
-	// Try to parse as JSON for structured display
-	if (trimmedOutput.startsWith("{") || trimmedOutput.startsWith("[")) {
-		try {
-			const parsed = JSON.parse(trimmedOutput);
-			const maxDepth = expanded ? JSON_TREE_MAX_DEPTH_EXPANDED : JSON_TREE_MAX_DEPTH_COLLAPSED;
-			const maxLines = expanded ? JSON_TREE_MAX_LINES_EXPANDED : JSON_TREE_MAX_LINES_COLLAPSED;
-			const maxScalarLen = expanded ? JSON_TREE_SCALAR_LEN_EXPANDED : JSON_TREE_SCALAR_LEN_COLLAPSED;
-			const tree = renderJsonTreeLines(parsed, theme, maxDepth, maxLines, maxScalarLen);
-
-			if (tree.lines.length > 0) {
-				for (const line of tree.lines) {
-					lines.push(line);
-				}
-				// Always show expand hint when collapsed (expanded view shows longer values and deeper nesting)
-				if (!expanded) {
-					lines.push(formatExpandHint(theme, expanded, true));
-				} else if (tree.truncated) {
-					lines.push(theme.fg("dim", "…"));
-				}
-				return new Text(lines.join("\n"), 0, 0);
-			}
-		} catch {
-			// Fall through to raw output
-		}
-	}
-
-	// Raw text output
-	const outputLines = trimmedOutput.split("\n");
-	const maxOutputLines = expanded ? 12 : 4;
-	const displayLines = outputLines.slice(0, maxOutputLines);
-
-	for (const line of displayLines) {
-		lines.push(theme.fg("toolOutput", truncateToWidth(line, 80)));
-	}
-
-	if (outputLines.length > maxOutputLines) {
-		const remaining = outputLines.length - maxOutputLines;
-		lines.push(`${theme.fg("dim", `… ${remaining} more lines`)} ${formatExpandHint(theme, expanded, true)}`);
-	} else if (!expanded) {
-		// Show expand hint when collapsed even if all lines shown (lines may be truncated)
-		lines.push(formatExpandHint(theme, expanded, true));
-	}
-
-	return new Text(lines.join("\n"), 0, 0);
-}