kiokuko-dsh 0.1.0

package/dist/commands/setup.d.ts

@@ -0,0 +1,105 @@
+import { atomicWriteTextIfUnchanged, unlinkRegularFileIfUnchanged, type FileIdentity, type RegularFileSnapshot } from '../agent-file/atomic-write.js';
+import { type PathEnvironment } from '../config/paths.js';
+import { openConnection } from '../db/connection.js';
+import { ensureGlobalWorkspace } from '../memory/workspaces.js';
+import type { SkillDiscoveryMode } from '../skills/types.js';
+import { refreshRegisteredProjectAgentFiles, type ProjectAgentRefreshResult } from '../setup/project-agent-refresh.js';
+import { type EnnoSetupMode } from '../setup/enno-client-config.js';
+export declare const SETUP_CLIENTS: readonly ["codex", "opencode", "claude", "hermes"];
+export type SetupClient = (typeof SETUP_CLIENTS)[number];
+type SetupAction = 'created' | 'updated' | 'unchanged' | 'deleted';
+interface PlannedDirectory {
+    path: string;
+    parent: PlannedDirectory | undefined;
+    original: FileIdentity | undefined;
+    created: FileIdentity | undefined;
+}
+interface PlannedFile {
+    path: string;
+    parentDirectory: PlannedDirectory;
+    content: string | undefined;
+    mode: number;
+    original: RegularFileSnapshot | undefined;
+    mustRemainAbsent?: readonly string[];
+    action: SetupAction;
+    purpose: 'mcp-config' | 'instructions' | 'standard-skill' | 'legacy-cleanup' | 'enno-hook';
+    client: SetupClient;
+    report: boolean;
+}
+export interface SetupOptions extends PathEnvironment {
+    clients?: SetupClient[];
+    command?: string;
+    dryRun?: boolean;
+    databasePath?: string;
+    migrationsDirectory?: string;
+    standardSkills?: boolean;
+    skillDiscoveryMode?: SkillDiscoveryMode;
+    replaceConflictingMcpServers?: readonly SetupClient[];
+    ennoOduno?: EnnoSetupMode;
+}
+export interface SetupCommandDependencies {
+    atomicWriteTextIfUnchanged?: typeof atomicWriteTextIfUnchanged;
+    unlinkRegularFileIfUnchanged?: typeof unlinkRegularFileIfUnchanged;
+    beforeCommit?: () => void | Promise<void>;
+    openConnection?: typeof openConnection;
+    ensureGlobalWorkspace?: typeof ensureGlobalWorkspace;
+    refreshRegisteredProjectAgentFiles?: typeof refreshRegisteredProjectAgentFiles;
+}
+export interface SetupResult {
+    clients: SetupClient[];
+    databasePath: string;
+    databaseAction: 'initialized' | 'planned';
+    databaseBackupPath: string | null;
+    appliedMigrations: number[];
+    recoveredEntries: number;
+    files: Array<Pick<PlannedFile, 'path' | 'action' | 'purpose' | 'client'>>;
+    projectAgentFiles: ProjectAgentRefreshResult[];
+    standardSkills: boolean;
+    ennoOduno: EnnoSetupMode | 'new-installs-only';
+    dryRun: boolean;
+    nextStep: string;
+}
+export interface SetupPromptOptions {
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}
+export declare function parseSetupClients(value: string): SetupClient[];
+export declare function parseSetupSkillDiscoveryMode(value: string): SkillDiscoveryMode;
+export declare function parseEnnoSetupMode(value: string): EnnoSetupMode;
+/** Ask which supported clients should receive configuration in an interactive terminal. */
+export declare function promptSetupClients(detected: SetupClient[], options?: SetupPromptOptions): Promise<SetupClient[]>;
+/** Ask whether audited community Skill discovery should be enabled. */
+export declare function promptCommunitySkillDiscovery(options?: SetupPromptOptions): Promise<SkillDiscoveryMode>;
+/** Ask before replacing a client Kiokuko MCP identity that setup does not own. */
+export declare function promptReplaceConflictingMcp(client: SetupClient, options?: SetupPromptOptions): Promise<boolean>;
+export interface SetupFlowOptions {
+    readonly environment?: PathEnvironment;
+    readonly clients?: SetupClient[];
+    readonly command?: string;
+    readonly dryRun?: boolean;
+    readonly standardSkills?: boolean;
+    readonly skillDiscoveryMode?: SkillDiscoveryMode;
+    readonly ennoOduno?: EnnoSetupMode;
+    readonly json?: boolean;
+    readonly input?: NodeJS.ReadableStream;
+    readonly output?: NodeJS.WritableStream;
+}
+export interface SetupFlowDependencies<T extends {
+    clients: SetupClient[];
+    projectAgentFiles: ProjectAgentRefreshResult[];
+}> {
+    readonly setupGlobalClients?: (options: SetupOptions) => Promise<T>;
+}
+/** Run the shared client-selection, conflict-confirmation, and setup flow. */
+export declare function runSetupFlow<T extends {
+    clients: SetupClient[];
+    projectAgentFiles: ProjectAgentRefreshResult[];
+} = SetupResult>(options?: SetupFlowOptions, dependencyOverrides?: SetupFlowDependencies<T>): Promise<T>;
+/** Ask both setup questions through one readline session so buffered input remains intact. */
+export declare function promptSetupConfiguration(detected: SetupClient[], options?: SetupPromptOptions): Promise<{
+    clients: SetupClient[];
+    skillDiscoveryMode: SkillDiscoveryMode;
+}>;
+export declare function setupGlobalClients(options?: SetupOptions, dependencyOverrides?: SetupCommandDependencies): Promise<SetupResult>;
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

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