@qilin-agent/cli 0.0.0-stage → 3.1.3

package/lib/types/process-shutdown.d.ts

@@ -0,0 +1,20 @@
+/** Bounded, escalating process shutdown for the long-lived CLI surfaces. */
+/** Maximum grace allowed for the application tree to dispose before process exit. */
+export declare const PROCESS_SHUTDOWN_TIMEOUT_MS = 5000;
+/** Process-exit controller shared by normal completion and Unix signal handlers. */
+export interface ProcessShutdown {
+    /** Start or join graceful disposal before allowing natural completion with `code`. */
+    shutdown(code: number): Promise<void>;
+    /** Start graceful disposal followed by exit, or force exit when shutdown is already running. */
+    interrupt(code: number): void;
+}
+/**
+ * Create one process-exit controller around an application disposer.
+ * @param dispose - Whole-application teardown that resolves at quiescence.
+ * @param forceExit - Function that exits the process immediately, replaceable by tests.
+ * @param complete - Function that records the natural completion code, replaceable by tests.
+ * @param timeoutMs - Grace before forced exit, replaceable by tests.
+ * @returns A controller whose normal calls coalesce and whose repeated signal call escalates.
+ */
+export declare function createProcessShutdown(dispose: () => Promise<void>, forceExit?: (code: number) => void, complete?: (code: number) => void, timeoutMs?: number): ProcessShutdown;
+//# sourceMappingURL=process-shutdown.d.ts.map

package/lib/types/profile-boot.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Shared profile boot for every `qilin` surface: resolve the profile, stack its
+ * patch layers (bundle layers in `qilin.profile.bundles` order, the profile's
+ * own `cordis.patch.yml`, `--patch` overlays, the telemetry switch), mount the
+ * tree over the profile's empty root config, and wire fail-loud plus bounded shutdown.
+ *
+ * App flags are not the launcher's business: the invocation's inner arguments
+ * are provided to the tree through `ctx.cmdlineArgs`, where any injected app
+ * plugin may read the same immutable snapshot.
+ * @module @qilin-agent/cli/profile-boot
+ */
+import { type Context } from '@qilin-agent/kylin';
+import { type ProfileContext, type Profile, type ProfileResolutionMode } from '@qilin-agent/app-boot';
+import { type LaunchEnvironmentSnapshot } from '@qilin-agent/launch-environment';
+import { type ProcessShutdown } from './process-shutdown.ts';
+/**
+ * The home-level user patch layer (`$QILIN_HOME/cordis.patch.yml`), applied
+ * over every profile's own layer. Resolved per call, not at module load:
+ * `$QILIN_HOME` may be set by the test or launcher after import.
+ * @returns the absolute patch-file path.
+ */
+export declare function homePatchPath(): string;
+/** Absolute path of this qilin installation's package.json (both anchors: src/ and lib/ sit one level under apps/cli). */
+export declare const INSTALL_ANCHOR: string;
+/** Root config filename inside a profile directory. */
+export declare const PROFILE_ROOT_FILENAME = "cordis.yml";
+/**
+ * Initialize a missing profile from one shipped template. This copies only
+ * the template's bundle list; local state from the
+ * same-named shipped profile is not read, and no inheritance metadata is
+ * persisted. Shipped profile names are reserved, and the target directory is
+ * claimed exclusively so existing or concurrent state is never reused.
+ * @param name - the new profile name.
+ * @param fromDefaultProfile - shipped profile template to copy.
+ * @param home - Harness home containing the profile directory.
+ * @throws when the template is unknown, the target name is shipped, or the target directory exists.
+ */
+export declare function initializeProfileFromDefault(name: string, fromDefaultProfile: string, home?: string): void;
+/**
+ * Load a resolved profile for `name` and (re)write the empty root config. The
+ * root is always rewritten: the whole composition is patch layers, and the
+ * vendored Loader's tree write-back (a plugin self-disposing persists the
+ * current tree) can bake composed rows into this file — which would duplicate
+ * every bundle insert on the next boot. The file exists on disk only because
+ * the Loader needs a real include root to anchor `baseUrl` at the profile
+ * directory (the config dump anchors on the same file, so both compose over
+ * the identical base).
+ * @param name - the profile name.
+ * @param userLayer - `false` skips parsing `cordis.patch.yml` (the default dump).
+ * @param fromDefaultProfile - shipped template used once to initialize a missing profile.
+ * @returns the loaded profile.
+ * @throws when explicit initialization names an unknown template or an existing profile.
+ */
+export declare function prepareProfile(name: string, userLayer?: boolean, fromDefaultProfile?: string): Profile;
+/** An application-owned profile and its independent installation fallback. */
+export interface ResolvedProfileRuntime {
+    /** Profile already loaded from the application's own directory. */
+    profile: Profile;
+    /** Absolute package.json path of the application's qilin installation. */
+    installAnchor: string;
+}
+/** Options for {@link runProfile}. */
+export interface RunProfileOptions {
+    /** This run's frozen environment snapshot, provided before any entry mounts. */
+    environment: LaunchEnvironmentSnapshot;
+    /** The profile name to boot. */
+    profile: string;
+    /** Loaded application profile; bypasses named profile initialization when supplied. */
+    resolvedProfile?: ResolvedProfileRuntime | undefined;
+    /** Shipped template used once to initialize a missing profile. */
+    fromDefaultProfile?: string | undefined;
+    /** `--patch` overlay paths, in argv order. */
+    patchFiles: readonly string[];
+    /** The invocation's inner arguments, handed to the tree through `ctx.cmdlineArgs`. */
+    args: readonly string[];
+    /** Application-owned package runtime, scoped to plugin package operations. */
+    packageManager?: ProfileContext['packageManager'];
+    /** Module fallback backend; defaults to runtime. Plain Node callers may override it; pkg executables always use runtime. */
+    resolutionMode?: ProfileResolutionMode;
+}
+/**
+ * Boot one profile invocation end to end and leave process lifetime to the
+ * mounted plugins (or to a one-shot runner the composition mounts).
+ * @param options - environment snapshot, profile name, overlays, and the booted app's own arguments.
+ * @returns the settled root context and the shutdown controller.
+ * @throws after disposing startup resources; cleanup failures retain the original error.
+ */
+export declare function runProfile(options: RunProfileOptions): Promise<{
+    ctx: Context;
+    shutdown: ProcessShutdown;
+}>;
+//# sourceMappingURL=profile-boot.d.ts.map

package/lib/types/startup-diagnostics.d.ts

@@ -0,0 +1,19 @@
+/** Save original startup diagnostics while keeping the terminal report concise. */
+import type { StartupError } from '@qilin-agent/app-boot';
+/** Launcher-owned context; no environment values or plugin configurations are collected. */
+interface StartupDiagnosticContext {
+    home: string;
+    version: string;
+    profile: string;
+}
+/**
+ * Print the startup summary and save a private, uniquely named report under QILIN_HOME/logs.
+ * Failed writes print the complete report to stderr instead of claiming a saved path.
+ * @param error - startup audit failure retaining plugin metadata and original errors.
+ * @param context - resolved Harness home, application version, and selected profile.
+ * @param write - terminal output sink; awaited before returning, defaults to stderr.
+ * @returns after saving or printing the report and completing terminal writes.
+ */
+export declare function reportStartupFailure(error: StartupError, context: StartupDiagnosticContext, write?: (text: string) => void | Promise<void>): Promise<void>;
+export {};
+//# sourceMappingURL=startup-diagnostics.d.ts.map

package/package.json

@@ -1,6 +1,174 @@
 {
   "name": "@qilin-agent/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "qilin CLI: profile launch, plugin management, and configuration inspection",
+  "version": "3.1.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkutysllb/QiLin.git",
+    "directory": "apps/cli"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "type": "module",
+  "bin": {
+    "qilin": "lib/bin.js"
+  },
+  "files": [
+    "lib/*.js",
+    "lib/types/*.d.ts"
+  ],
+  "qilin": {
+    "configTrees": [
+      {
+        "mount": "config/agent-presets",
+        "path": "../../packages/preset/agent-presets/presets",
+        "scanRoster": true
+      }
+    ]
+  },
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^15.0.0",
+    "js-yaml": "^4.2.0",
+    "node-addon-require-builtin": "^0.1.6",
+    "@qilin-agent/agent-instructions": "3.1.3",
+    "@qilin-agent/acp-app": "3.1.3",
+    "@qilin-agent/agent-tool-presentation": "3.1.3",
+    "@qilin-agent/app-boot": "3.1.3",
+    "@qilin-agent/atomic-write": "3.1.3",
+    "@qilin-agent/base": "3.1.3",
+    "@qilin-agent/client-ui-agent-preset": "3.1.3",
+    "@qilin-agent/client-ui-kylin": "3.1.3",
+    "@qilin-agent/cmdline": "3.1.3",
+    "@qilin-agent/command-compact": "3.1.3",
+    "@qilin-agent/command-goal": "3.1.3",
+    "@qilin-agent/compaction-basic": "3.1.3",
+    "@qilin-agent/compaction-tool-result-pruner": "3.1.3",
+    "@qilin-agent/experimental-auto-review": "3.1.3",
+    "@qilin-agent/experimental-inspector-profile": "3.1.3",
+    "@qilin-agent/experimental-agent-team-profile": "3.1.3",
+    "@qilin-agent/experimental-schedule-bundle": "3.1.3",
+    "@qilin-agent/experimental-voice-input-bundle": "3.1.3",
+    "@qilin-agent/fs-local": "3.1.3",
+    "@qilin-agent/headless": "3.1.3",
+    "@qilin-agent/goal": "3.1.3",
+    "@qilin-agent/goal-round-driver": "3.1.3",
+    "@qilin-agent/hmr": "3.1.3",
+    "@qilin-agent/home-paths": "3.1.3",
+    "@qilin-agent/hooks-claude-code": "3.1.3",
+    "@qilin-agent/hooks-codex": "3.1.3",
+    "@qilin-agent/http-proxy": "3.1.3",
+    "@qilin-agent/jobs-local": "3.1.3",
+    "@qilin-agent/kylin": "~4.0.3",
+    "@qilin-agent/kylin-client-runner": "3.1.3",
+    "@qilin-agent/kylin-plugin-include": "~1.0.8",
+    "@qilin-agent/kylin-plugin-timer": "~1.1.5",
+    "@qilin-agent/mcp-client": "3.1.3",
+    "@qilin-agent/launch-environment": "3.1.3",
+    "@qilin-agent/mcp-resources": "3.1.3",
+    "@qilin-agent/kylin-plugin-loader": "~1.0.4",
+    "@qilin-agent/plan-mode": "3.1.3",
+    "@qilin-agent/persona": "3.1.3",
+    "@qilin-agent/plugin-manager": "3.1.3",
+    "@qilin-agent/pwsh-local": "3.1.3",
+    "@qilin-agent/pwsh-sandbox": "3.1.3",
+    "@qilin-agent/schedule": "3.1.3",
+    "@qilin-agent/sdk-app": "3.1.3",
+    "@qilin-agent/sdk-minimal": "3.1.3",
+    "@qilin-agent/schemastery": "~3.18.3",
+    "@qilin-agent/session-projection": "3.1.3",
+    "@qilin-agent/skill": "3.1.3",
+    "@qilin-agent/session-reference": "3.1.3",
+    "@qilin-agent/skill-filesystem": "3.1.3",
+    "@qilin-agent/terminal": "3.1.3",
+    "@qilin-agent/terminal-bash": "3.1.3",
+    "@qilin-agent/tmux-context": "3.1.3",
+    "@qilin-agent/time-context": "3.1.3",
+    "@qilin-agent/tool-ask-user": "3.1.3",
+    "@qilin-agent/token-meter": "3.1.3",
+    "@qilin-agent/tool-bash": "3.1.3",
+    "@qilin-agent/tool-fs-search": "3.1.3",
+    "@qilin-agent/tool-bash-persistent": "3.1.3",
+    "@qilin-agent/tool-goal": "3.1.3",
+    "@qilin-agent/tool-jobs": "3.1.3",
+    "@qilin-agent/tool-fs": "3.1.3",
+    "@qilin-agent/sidebar-opens": "3.1.3",
+    "@qilin-agent/tool-kylin": "3.1.3",
+    "@qilin-agent/tool-pwsh": "3.1.3",
+    "@qilin-agent/tool-present": "3.1.3",
+    "@qilin-agent/tool-pwsh-persistent": "3.1.3",
+    "@qilin-agent/tool-ralph": "3.1.3",
+    "@qilin-agent/tool-schedule": "3.1.3",
+    "@qilin-agent/tool-skill": "3.1.3",
+    "@qilin-agent/tool-str-replace-editor": "3.1.3",
+    "@qilin-agent/tool-todo": "3.1.3",
+    "@qilin-agent/tool-subagent": "3.1.3",
+    "@qilin-agent/tool-subagent-control": "3.1.3",
+    "@qilin-agent/tool-workflow": "3.1.3",
+    "@qilin-agent/tool-web": "3.1.3",
+    "@qilin-agent/web-app": "3.1.3",
+    "@qilin-agent/web-brand": "3.1.3",
+    "@qilin-agent/webhook-github": "3.1.3",
+    "@qilin-agent/workflow-ptc": "3.1.3",
+    "@qilin-agent/webhook": "3.1.3"
+  },
+  "devDependencies": {
+    "@agentclientprotocol/sdk": "1.4.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/ws": "8.18.1",
+    "execa": "^10.0.0",
+    "ws": "8.21.0",
+    "@qilin-agent/acp": "3.1.3",
+    "@qilin-agent/agent": "3.1.3",
+    "@qilin-agent/agent-loop": "3.1.3",
+    "@qilin-agent/agent-loop-testkit": "3.1.3",
+    "@qilin-agent/deepseek-llm-api-extensions": "3.1.3",
+    "@qilin-agent/bash-local": "3.1.3",
+    "@qilin-agent/credentials-local": "3.1.3",
+    "@qilin-agent/experimental-agent-team": "3.1.3",
+    "@qilin-agent/experimental-ptc-runtime-python": "3.1.3",
+    "@qilin-agent/experimental-tool-agent-team": "3.1.3",
+    "@qilin-agent/fs-observation-policy": "3.1.3",
+    "@qilin-agent/fs-sandbox": "3.1.3",
+    "@qilin-agent/host-frontend-static": "3.1.3",
+    "@qilin-agent/host-webserver": "3.1.3",
+    "@qilin-agent/llm": "3.1.3",
+    "@qilin-agent/llm-deepseek": "3.1.3",
+    "@qilin-agent/llm-deepseek-api-key": "3.1.3",
+    "@qilin-agent/llm-mock-server": "3.1.3",
+    "@qilin-agent/attachment-local": "3.1.3",
+    "@qilin-agent/llm-replay": "3.1.3",
+    "@qilin-agent/llm-pi-ai": "3.1.3",
+    "@qilin-agent/loader-smoke": "3.1.3",
+    "@qilin-agent/plugin-package-inventory-deepseek": "3.1.3",
+    "@qilin-agent/sandbox-local": "3.1.3",
+    "@qilin-agent/sandbox-policy": "3.1.3",
+    "@qilin-agent/session-checkpoint-policy": "3.1.3",
+    "@qilin-agent/session": "3.1.3",
+    "@qilin-agent/session-log-deepseek": "3.1.3",
+    "@qilin-agent/session-persistence-jsonl": "3.1.3",
+    "@qilin-agent/settings": "3.1.3",
+    "@qilin-agent/shell-env": "3.1.3",
+    "@qilin-agent/session-query": "3.1.3",
+    "@qilin-agent/subagent-spawn-in-process": "3.1.3",
+    "@qilin-agent/subagent": "3.1.3",
+    "@qilin-agent/subagent-fork-in-process": "3.1.3",
+    "@qilin-agent/settings-file": "3.1.3",
+    "@qilin-agent/subprocess-local": "3.1.3",
+    "@qilin-agent/system-prompt": "3.1.3",
+    "@qilin-agent/tools": "3.1.3",
+    "@qilin-agent/user-approval": "3.1.3"
+  },
+  "exports": {
+    "./profile-boot": {
+      "types": "./lib/types/profile-boot.d.ts",
+      "default": "./lib/profile-boot.js"
+    },
+    "./lib/*": "./lib/*",
+    "./package.json": "./package.json"
+  }
 }