@sayknow-cli/coding-agent 0.3.4 → 0.3.6

package/dist/types/commit/analysis/conventional.d.ts

@@ -1,22 +0,0 @@
-import type { ThinkingLevel } from "@sayknow-cli/agent-core";
-import type { Api, Model } from "@sayknow-cli/ai";
-import type { ConventionalAnalysis } from "../../commit/types";
-export interface ConventionalAnalysisInput {
-    model: Model<Api>;
-    apiKey: string;
-    thinkingLevel?: ThinkingLevel;
-    contextFiles?: Array<{
-        path: string;
-        content: string;
-    }>;
-    userContext?: string;
-    typesDescription?: string;
-    recentCommits?: string[];
-    scopeCandidates: string;
-    stat: string;
-    diff: string;
-}
-/**
- * Generate conventional analysis data from a diff and metadata.
- */
-export declare function generateConventionalAnalysis({ model, apiKey, thinkingLevel, contextFiles, userContext, typesDescription, recentCommits, scopeCandidates, stat, diff }: ConventionalAnalysisInput): Promise<ConventionalAnalysis>;

package/dist/types/commit/analysis/index.d.ts

@@ -1,4 +0,0 @@
-export * from "./conventional";
-export * from "./scope";
-export * from "./summary";
-export * from "./validation";

package/dist/types/commit/analysis/scope.d.ts

@@ -1,6 +0,0 @@
-import type { NumstatEntry } from "../../commit/types";
-export interface ScopeCandidatesResult {
-    scopeCandidates: string;
-    isWide: boolean;
-}
-export declare function extractScopeCandidates(numstat: NumstatEntry[]): ScopeCandidatesResult;

package/dist/types/commit/analysis/summary.d.ts

@@ -1,19 +0,0 @@
-import type { ThinkingLevel } from "@sayknow-cli/agent-core";
-import type { Api, Model } from "@sayknow-cli/ai";
-import type { CommitSummary } from "../../commit/types";
-export interface SummaryInput {
-    model: Model<Api>;
-    apiKey: string;
-    thinkingLevel?: ThinkingLevel;
-    commitType: string;
-    scope: string | null;
-    details: string[];
-    stat: string;
-    maxChars: number;
-    userContext?: string;
-}
-/**
- * Generate a commit summary line for the conventional commit header.
- */
-export declare function generateSummary({ model, apiKey, thinkingLevel, commitType, scope, details, stat, maxChars, userContext }: SummaryInput): Promise<CommitSummary>;
-export declare function stripTypePrefix(summary: string, commitType: string, scope: string | null): string;

package/dist/types/commit/analysis/validation.d.ts

@@ -1,8 +0,0 @@
-import type { ConventionalAnalysis } from "../../commit/types";
-export interface ValidationResult {
-    valid: boolean;
-    errors: string[];
-}
-export declare function validateSummary(summary: string, maxChars: number): ValidationResult;
-export declare function validateScope(scope: string | null): ValidationResult;
-export declare function validateAnalysis(analysis: ConventionalAnalysis): ValidationResult;

package/dist/types/commit/changelog/detect.d.ts

@@ -1,2 +0,0 @@
-import type { ChangelogBoundary } from "../../commit/types";
-export declare function detectChangelogBoundaries(cwd: string, stagedFiles: string[]): Promise<ChangelogBoundary[]>;

package/dist/types/commit/changelog/generate.d.ts

@@ -1,30 +0,0 @@
-import type { ThinkingLevel } from "@sayknow-cli/agent-core";
-import type { Api, Model } from "@sayknow-cli/ai";
-import * as z from "zod/v4";
-import { type ChangelogGenerationResult } from "../../commit/types";
-export declare const changelogTool: {
-    name: string;
-    description: string;
-    parameters: z.ZodObject<{
-        entries: z.ZodObject<{
-            Added: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            "Breaking Changes": z.ZodOptional<z.ZodArray<z.ZodString>>;
-            Changed: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            Deprecated: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            Fixed: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            Removed: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            Security: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>;
-    }, z.core.$strip>;
-};
-export interface ChangelogPromptInput {
-    model: Model<Api>;
-    apiKey: string;
-    thinkingLevel?: ThinkingLevel;
-    changelogPath: string;
-    isPackageChangelog: boolean;
-    existingEntries?: string;
-    stat: string;
-    diff: string;
-}
-export declare function generateChangelogEntries({ model, apiKey, thinkingLevel, changelogPath, isPackageChangelog, existingEntries, stat, diff }: ChangelogPromptInput): Promise<ChangelogGenerationResult>;

package/dist/types/commit/changelog/index.d.ts

@@ -1,30 +0,0 @@
-import type { ThinkingLevel } from "@sayknow-cli/agent-core";
-import type { Api, Model } from "@sayknow-cli/ai";
-export interface ChangelogFlowInput {
-    cwd: string;
-    model: Model<Api>;
-    apiKey: string;
-    thinkingLevel?: ThinkingLevel;
-    stagedFiles: string[];
-    dryRun: boolean;
-    maxDiffChars?: number;
-    onProgress?: (message: string) => void;
-}
-export interface ChangelogProposalInput {
-    cwd: string;
-    proposals: Array<{
-        path: string;
-        entries: Record<string, string[]>;
-        deletions?: Record<string, string[]>;
-    }>;
-    dryRun: boolean;
-    onProgress?: (message: string) => void;
-}
-/**
- * Update CHANGELOG.md entries for staged changes.
- */
-export declare function runChangelogFlow({ cwd, model, apiKey, thinkingLevel, stagedFiles, dryRun, maxDiffChars, onProgress }: ChangelogFlowInput): Promise<string[]>;
-/**
- * Apply changelog entries provided by the commit agent.
- */
-export declare function applyChangelogProposals({ cwd, proposals, dryRun, onProgress }: ChangelogProposalInput): Promise<string[]>;

package/dist/types/commit/changelog/parse.d.ts

@@ -1,2 +0,0 @@
-import type { UnreleasedSection } from "../../commit/types";
-export declare function parseUnreleasedSection(content: string): UnreleasedSection;

package/dist/types/commit/cli.d.ts

@@ -1,3 +0,0 @@
-import type { CommitCommandArgs } from "./types";
-export declare function parseCommitArgs(args: string[]): CommitCommandArgs | undefined;
-export declare function printCommitHelp(): void;

package/dist/types/commit/git/diff.d.ts

@@ -1,5 +0,0 @@
-import type { FileDiff, FileHunks, NumstatEntry } from "../../commit/types";
-export declare function parseNumstat(output: string): NumstatEntry[];
-export declare function parseFileDiffs(diff: string): FileDiff[];
-export declare function parseDiffHunks(diff: string): FileHunks[];
-export declare function parseFileHunks(fileDiff: FileDiff): FileHunks;

package/dist/types/commit/index.d.ts

@@ -1,4 +0,0 @@
-/**
- * Entry points for the skc commit command.
- */
-export { runCommitCommand } from "./pipeline";

package/dist/types/commit/map-reduce/index.d.ts

@@ -1,28 +0,0 @@
-import type { ThinkingLevel } from "@sayknow-cli/agent-core";
-import type { Api, Model } from "@sayknow-cli/ai";
-import type { ConventionalAnalysis } from "../../commit/types";
-export interface MapReduceSettings {
-    enabled?: boolean;
-    minFiles?: number;
-    maxFileTokens?: number;
-    maxConcurrency?: number;
-    timeoutMs?: number;
-}
-export interface MapReduceInput {
-    model: Model<Api>;
-    apiKey: string;
-    thinkingLevel?: ThinkingLevel;
-    smolModel: Model<Api>;
-    smolApiKey: string;
-    smolThinkingLevel?: ThinkingLevel;
-    diff: string;
-    stat: string;
-    scopeCandidates: string;
-    typesDescription?: string;
-    settings?: MapReduceSettings;
-}
-export declare function shouldUseMapReduce(diff: string, settings?: MapReduceSettings): boolean;
-/**
- * Run map-reduce analysis for large diffs using smol + primary models.
- */
-export declare function runMapReduceAnalysis(input: MapReduceInput): Promise<ConventionalAnalysis>;

package/dist/types/commit/map-reduce/map-phase.d.ts

@@ -1,17 +0,0 @@
-import type { ThinkingLevel } from "@sayknow-cli/agent-core";
-import type { Api, Model } from "@sayknow-cli/ai";
-import type { FileDiff, FileObservation } from "../../commit/types";
-export interface MapPhaseInput {
-    model: Model<Api>;
-    apiKey: string;
-    thinkingLevel?: ThinkingLevel;
-    files: FileDiff[];
-    config?: {
-        maxFileTokens?: number;
-        maxConcurrency?: number;
-        timeoutMs?: number;
-        maxRetries?: number;
-        retryBackoffMs?: number;
-    };
-}
-export declare function runMapPhase({ model, apiKey, thinkingLevel, files, config }: MapPhaseInput): Promise<FileObservation[]>;

package/dist/types/commit/map-reduce/reduce-phase.d.ts

@@ -1,13 +0,0 @@
-import type { ThinkingLevel } from "@sayknow-cli/agent-core";
-import type { Api, Model } from "@sayknow-cli/ai";
-import type { ConventionalAnalysis, FileObservation } from "../../commit/types";
-export interface ReducePhaseInput {
-    model: Model<Api>;
-    apiKey: string;
-    thinkingLevel?: ThinkingLevel;
-    observations: FileObservation[];
-    stat: string;
-    scopeCandidates: string;
-    typesDescription?: string;
-}
-export declare function runReducePhase({ model, apiKey, thinkingLevel, observations, stat, scopeCandidates, typesDescription }: ReducePhaseInput): Promise<ConventionalAnalysis>;

package/dist/types/commit/map-reduce/utils.d.ts

@@ -1,2 +0,0 @@
-export declare function estimateTokens(text: string): number;
-export declare function truncateToTokenLimit(text: string, maxTokens: number): string;

package/dist/types/commit/message.d.ts

@@ -1,2 +0,0 @@
-import type { ConventionalAnalysis } from "./types";
-export declare function formatCommitMessage(analysis: ConventionalAnalysis, summary: string): string;

package/dist/types/commit/model-selection.d.ts

@@ -1,15 +0,0 @@
-import type { ThinkingLevel } from "@sayknow-cli/agent-core";
-import type { Api, Model } from "@sayknow-cli/ai";
-import { type ModelLookupRegistry } from "../config/model-resolver";
-import type { Settings } from "../config/settings";
-export interface ResolvedCommitModel {
-    model: Model<Api>;
-    apiKey: string;
-    thinkingLevel?: ThinkingLevel;
-}
-type CommitModelRegistry = ModelLookupRegistry & {
-    getApiKey: (model: Model<Api>) => Promise<string | undefined>;
-};
-export declare function resolvePrimaryModel(override: string | undefined, settings: Settings, modelRegistry: CommitModelRegistry): Promise<ResolvedCommitModel>;
-export declare function resolveSecondaryCommitModel(settings: Settings, modelRegistry: CommitModelRegistry, fallbackModel: Model<Api>, fallbackApiKey: string): Promise<ResolvedCommitModel>;
-export {};

package/dist/types/commit/pipeline.d.ts

@@ -1,5 +0,0 @@
-import type { CommitCommandArgs } from "./types";
-/**
- * Execute the skc commit pipeline for staged changes.
- */
-export declare function runCommitCommand(args: CommitCommandArgs): Promise<void>;

package/dist/types/commit/shared-llm.d.ts

@@ -1,54 +0,0 @@
-import type { AssistantMessage } from "@sayknow-cli/ai";
-import * as z from "zod/v4";
-import type { ConventionalAnalysis } from "./types";
-/**
- * Shared Zod schema for the `create_conventional_analysis` tool used by
- * both the single-pass analysis call and the map-reduce reduce phase. Schemas
- * are identical across phases — only the surrounding tool `description`
- * differs to reflect the input the phase is summarizing.
- */
-export declare const conventionalAnalysisParameters: z.ZodObject<{
-    type: z.ZodEnum<{
-        build: "build";
-        chore: "chore";
-        ci: "ci";
-        docs: "docs";
-        feat: "feat";
-        fix: "fix";
-        perf: "perf";
-        refactor: "refactor";
-        revert: "revert";
-        style: "style";
-        test: "test";
-    }>;
-    scope: z.ZodUnion<readonly [z.ZodString, z.ZodNull]>;
-    details: z.ZodArray<z.ZodObject<{
-        text: z.ZodString;
-        changelog_category: z.ZodOptional<z.ZodEnum<{
-            Added: "Added";
-            "Breaking Changes": "Breaking Changes";
-            Changed: "Changed";
-            Deprecated: "Deprecated";
-            Fixed: "Fixed";
-            Removed: "Removed";
-            Security: "Security";
-        }>>;
-        user_visible: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    issue_refs: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-export interface ConventionalAnalysisTool {
-    name: "create_conventional_analysis";
-    description: string;
-    parameters: typeof conventionalAnalysisParameters;
-}
-/**
- * Build a `create_conventional_analysis` tool descriptor. Phase-specific
- * `description` text is the only thing that varies between callers.
- */
-export declare function createConventionalAnalysisTool(description: string): ConventionalAnalysisTool;
-/**
- * Extract a {@link ConventionalAnalysis} from an assistant response, preferring
- * a structured tool call and falling back to JSON embedded in text content.
- */
-export declare function parseConventionalAnalysisResponse(message: AssistantMessage, tool: ConventionalAnalysisTool): ConventionalAnalysis;

package/dist/types/commit/types.d.ts

@@ -1,78 +0,0 @@
-/**
- * Types for the skc 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 declare const CHANGELOG_CATEGORIES: ChangelogCategory[];
-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/dist/types/commit/utils/exclusions.d.ts

@@ -1,4 +0,0 @@
-export declare function isExcludedFile(path: string): boolean;
-export declare function filterExcludedFiles<T extends {
-    filename: string;
-}>(files: T[]): T[];

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

@@ -1,20 +0,0 @@
-import type { AssistantMessage, ToolCall } from "@sayknow-cli/ai";
-import type { ChangelogCategory, ConventionalAnalysis, ConventionalDetail } from "./types";
-export declare function extractToolCall(message: AssistantMessage, name: string): ToolCall | undefined;
-export declare function extractTextContent(message: AssistantMessage): string;
-export declare function parseJsonPayload(text: string): unknown;
-export declare function normalizeAnalysis(parsed: {
-    type: ConventionalAnalysis["type"];
-    scope: string | null;
-    details: Array<{
-        text: string;
-        changelog_category?: ChangelogCategory;
-        user_visible?: boolean;
-    }>;
-    issue_refs: string[];
-}): ConventionalAnalysis;
-export declare function normalizeDetails(details: Array<{
-    text: string;
-    changelog_category?: ConventionalDetail["changelogCategory"];
-    user_visible?: boolean;
-}>): ConventionalDetail[];

package/dist/types/config/config-file.d.ts

@@ -1,58 +0,0 @@
-import type { ZodType } from "zod/v4";
-/** Minimal subset of the AJV ConfigSchemaError shape this module actually relies on. */
-interface ConfigSchemaError {
-    instancePath: string;
-    message: string | undefined;
-}
-export interface IConfigFile<T> {
-    readonly id: string;
-    readonly schema: ZodType<T>;
-    path?(): string;
-    load(): T | null;
-    invalidate?(): void;
-}
-export declare class ConfigError extends Error {
-    #private;
-    readonly id: string;
-    readonly schemaErrors: ConfigSchemaError[] | null | undefined;
-    readonly other?: {
-        err: unknown;
-        stage: string;
-    } | undefined;
-    constructor(id: string, schemaErrors: ConfigSchemaError[] | null | undefined, other?: {
-        err: unknown;
-        stage: string;
-    } | undefined);
-    get message(): string;
-    toString(): string;
-}
-export type LoadStatus = "ok" | "error" | "not-found";
-export type LoadResult<T> = {
-    value?: null;
-    error: ConfigError;
-    status: "error";
-} | {
-    value: T;
-    error?: undefined;
-    status: "ok";
-} | {
-    value?: null;
-    error?: unknown;
-    status: "not-found";
-};
-export declare class ConfigFile<T> implements IConfigFile<T> {
-    #private;
-    readonly id: string;
-    readonly schema: ZodType<T>;
-    constructor(id: string, schema: ZodType<T>, configPath?: string);
-    relocate(configPath?: string): ConfigFile<T>;
-    getMtimeMs(): number | null;
-    withValidation(name: string, validate: (value: T) => void): this;
-    createDefault(): T;
-    tryLoad(): LoadResult<T>;
-    load(): T | null;
-    loadOrDefault(): T;
-    path(): string;
-    invalidate(): void;
-}
-export {};

package/dist/types/config/file-lock-gc.d.ts

@@ -1,5 +0,0 @@
-/**
- * GC adapter for config file-locks (`<file>.lock` dirs holding `{pid, timestamp}`).
- */
-import type { GcStoreAdapter } from "../skc-runtime/gc-runtime";
-export declare const fileLocksGcAdapter: GcStoreAdapter;

package/dist/types/config/file-lock.d.ts

@@ -1,35 +0,0 @@
-export interface FileLockOptions {
-    staleMs?: number;
-    retries?: number;
-    retryDelayMs?: number;
-}
-/** @internal */
-export declare function readFileLockInfoForGc(lockDir: string): Promise<{
-    pid: number;
-    timestamp: number;
-} | null>;
-/** Owner identity stamped into a `<file>.lock/info` record. */
-export interface FileLockOwnerToken {
-    pid: number;
-    timestamp: number;
-}
-/** Outcome of a guarded GC removal attempt (`removeFileLockDirForGc`). */
-export type FileLockGcRemoval = "removed" | "owner_changed" | "missing";
-/**
- * @internal
- * Fail-closed removal of a dead lock dir for GC. Re-reads the on-disk owner
- * token as close to the unlink as possible and only deletes the dir when it
- * STILL holds the exact `{pid, timestamp}` identity the caller observed dead.
- *
- * Closes the prune-time TOCTOU window (#606): between GC's dead re-read/probe
- * and the unlink, a live process can reclaim a stale lock at the same path
- * (`acquireLock` rms the stale dir, then re-`mkdir`s and rewrites `info` with a
- * fresh pid+timestamp). Deleting by path alone would reap that LIVE lock. Any
- * mismatch (`owner_changed`) or absent/unreadable info (`missing` — e.g. a
- * fresh acquirer between `mkdir` and `writeLockInfo`) refuses the delete and
- * leaves the dir intact. POSIX has no atomic compare-and-delete for a
- * directory, so the residual read->unlink window cannot be fully eliminated,
- * but the reclaim-after-stale scenario the issue describes is now guarded.
- */
-export declare function removeFileLockDirForGc(lockDir: string, expected: FileLockOwnerToken): Promise<FileLockGcRemoval>;
-export declare function withFileLock<T>(filePath: string, fn: () => Promise<T>, options?: FileLockOptions): Promise<T>;