argsbarg 6.1.5 → 6.1.7

package/src/configure/configure.test.ts

@@ -6,15 +6,9 @@ import { afterEach, beforeEach, describe, expect, test } from "bun:test";
 import { existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { appConfigFileExists } from "~/config/file.ts";
-import {
-  appConfigHasEntries,
-  formatConfigureMutationSummary,
-  parseConfigureOpts,
-  validateConfigureOpts,
-} from "~/configure";
-import type { CliProgram } from "~/core/types.ts";
-import { Cli } from "~/index";
+import { appConfigFileExists } from "../config/file.ts";
+import type { CliProgram } from "../core/types.ts";
+import { Cli } from "../index.ts";
 import { detectInstalledArtifacts } from "./artifacts/detect-installed.ts";
 import { parseInstallOpts } from "./artifacts/opts.ts";
 import { resolveClaudeDesktopMcpPath, resolveInstallPaths } from "./artifacts/paths.ts";
@@ -22,6 +16,12 @@ import { buildInstallPlan, buildUpdatePlan } from "./artifacts/plan.ts";
 import { installTargetForKey } from "./artifacts/target-registry.ts";
 import { buildDetectedSnapshot, buildTargetPlanContext } from "./artifacts/target-scope.ts";
 import { buildUninstallPlan } from "./artifacts/uninstall.ts";
+import {
+  appConfigHasEntries,
+  formatConfigureMutationSummary,
+  parseConfigureOpts,
+  validateConfigureOpts,
+} from "./index.ts";
 
 const fixture: CliProgram = {
   key: "testapp",

package/src/configure/index.ts

@@ -2,11 +2,11 @@
 Interactive and automated `configure` command orchestration (agent artifacts and app config).
 */
 
-import { displayAppConfigPath, runConfigure } from "~/config/bootstrap.ts";
-import { ensureAppConfigFile } from "~/config/file.ts";
-import type { CliProgram } from "~/core/types.ts";
-import { resolveCapabilities } from "~/runtime/capabilities.ts";
-import { cliSkillInstall, skillTargetFromActionKind } from "~/skill/install.ts";
+import { displayAppConfigPath, runConfigure } from "../config/bootstrap.ts";
+import { ensureAppConfigFile } from "../config/file.ts";
+import type { CliProgram } from "../core/types.ts";
+import { resolveCapabilities } from "../runtime/capabilities.ts";
+import { cliSkillInstall, skillTargetFromActionKind } from "../skill/install.ts";
 import { resolveInstallPaths } from "./artifacts/paths.ts";
 import { buildInstallPlan, buildUpdatePlan } from "./artifacts/plan.ts";
 import {

package/src/configure/prompt.ts

@@ -2,7 +2,7 @@
 TTY prompts for per-target install, skip, or uninstall during interactive `configure`.
 */
 
-import { readPromptLine } from "~/prompt.ts";
+import { readPromptLine } from "../prompt.ts";
 import type { CliInstallArtifactKey } from "./artifacts/target-types.ts";
 
 /** Human-readable labels for each install artifact key in interactive prompts. */

package/src/core/context.ts

@@ -7,9 +7,9 @@ It keeps handlers small with a typed read API for flags, strings, numbers, and c
 parsed values.
 */
 
-import type { AnyAppConfigSnapshot } from "~/config/context.ts";
-import { EmptyAppConfigSnapshot } from "~/config/context.ts";
-import { strictParseDouble } from "~/utils.ts";
+import type { AnyAppConfigSnapshot } from "../config/context.ts";
+import { EmptyAppConfigSnapshot } from "../config/context.ts";
+import { strictParseDouble } from "../utils.ts";
 import { parseCommaList, parseDate, parseDateTime, parseDurationMs } from "./formats.ts";
 import { loadLeafInputs, readJsonOptionValue } from "./leaf-inputs.ts";
 import { normalizeRespondOptions, writeRespondBodyToStdout } from "./respond.ts";

package/src/core/json-leaf.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import { Cli } from "~/index";
+import { Cli } from "../index.ts";
 import { ParseKind, parse } from "./parse.ts";
 import { CliOptionKind, type CliProgram, CliSchemaValidationError } from "./types.ts";
 import { cliValidateProgram } from "./validate.ts";

package/src/core/leaf-inputs.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import { Cli, CliContext, CliOptionKind } from "~/index";
+import { Cli, CliContext, CliOptionKind } from "../index.ts";
 import { LeafInputError, loadLeafInputs } from "./leaf-inputs.ts";
 import type { CliProgram } from "./types.ts";
 

package/src/core/leaf-inputs.ts

@@ -2,8 +2,8 @@
 Leaf input reads: Json options (flag, preloaded stdin, or toolArgs), optional inputSchema validation.
 */
 
-import { validateConfigDocument } from "~/config/validate.ts";
-import { isInteractiveTty } from "~/utils.ts";
+import { validateConfigDocument } from "../config/validate.ts";
+import { isInteractiveTty } from "../utils.ts";
 import type { CliContext, CliLeafInputs } from "./context.ts";
 import { collectOptionDefs } from "./parse.ts";
 import type { CliInvocation, CliLeaf, CliNode, CliOption, CliProgram } from "./types.ts";

package/src/core/parse.test.ts

@@ -7,21 +7,21 @@ import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "no
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { $ } from "bun";
-import { completionBashScript, completionZshScript } from "~/builtins";
-import { cliPresentationRoot } from "~/builtins/presentation.ts";
-import { cliHelpRender } from "~/help.ts";
-import { Cli, CliFallbackMode, CliOptionKind, type CliProgram } from "~/index";
-import { applyShellEnv } from "~/mcp/env.ts";
-import { allMcpResources, collectMcpTools, mcpToolCallToArgv, resolveMcpSchemaUri } from "~/mcp/tools.ts";
-import { generatePluginSkillBundle, generateSkillBundle } from "~/skill/generate.ts";
-import { cliSkillInstall } from "~/skill/install.ts";
+import { completionBashScript, completionZshScript } from "../builtins/index.ts";
+import { cliPresentationRoot } from "../builtins/presentation.ts";
+import { cliHelpRender } from "../help.ts";
+import { Cli, CliFallbackMode, CliOptionKind, type CliProgram } from "../index.ts";
+import { applyShellEnv } from "../mcp/env.ts";
+import { allMcpResources, collectMcpTools, mcpToolCallToArgv, resolveMcpSchemaUri } from "../mcp/tools.ts";
+import { generatePluginSkillBundle, generateSkillBundle } from "../skill/generate.ts";
+import { cliSkillInstall } from "../skill/install.ts";
 import {
   enumMcpFixture,
   nestedDocsFallbackFixture,
   nestedMcpFixture,
   testProgram,
   varargsReadFixture,
-} from "~/test/fixtures.ts";
+} from "../test/fixtures.ts";
 import { ParseKind, parse, postParseValidate } from "./parse.ts";
 import { cliSchemaJson } from "./schema.ts";
 import { cliValidateProgram } from "./validate.ts";

package/src/core/parse.ts

@@ -7,8 +7,8 @@ It keeps handler dispatch and help on one parser so the CLI behavior stays consi
 across every entry path.
 */
 
-import { isCliCallable } from "~/runtime/exposure.ts";
-import { fullStringIsDouble } from "~/utils.ts";
+import { isCliCallable } from "../runtime/exposure.ts";
+import { fullStringIsDouble } from "../utils.ts";
 import { formatValidationError, validateFormatValue } from "./formats.ts";
 import {
   CliFallbackMode,

package/src/core/schema.ts

@@ -2,9 +2,9 @@
 This module serializes the CLI schema tree to JSON for machine-readable introspection.
 */
 
-import { type CliSchemaExport, exportPresentationBuiltins } from "~/builtins/export.ts";
-import { cliResolveNotes } from "~/help.ts";
-import { isCliSchemaHidden, visibleOptions } from "~/runtime/exposure.ts";
+import { type CliSchemaExport, exportPresentationBuiltins } from "../builtins/export.ts";
+import { cliResolveNotes } from "../help.ts";
+import { isCliSchemaHidden, visibleOptions } from "../runtime/exposure.ts";
 import { type CliNode, type CliProgram, isCliLeaf, isCliRouter, leafOutputSchema } from "./types.ts";
 
 const RESERVED = new Set(["http", "completion", "configure", "docs", "mcp", "version"]);

package/src/core/types.ts

@@ -4,7 +4,7 @@ It is the shared declarative model that parsing, validation, help, and completio
 read from, so the package has one source of truth.
 */
 
-import type { AnyAppConfigSnapshot } from "~/config/context.ts";
+import type { AnyAppConfigSnapshot } from "../config/context.ts";
 import type { CliContext } from "./context.ts";
 
 /**

package/src/core/validate.ts

@@ -2,12 +2,12 @@
 This module validates CLI schemas before execution.
 */
 
-import { AGENT_PAIRS, MCP_KEYS, mcpServerRequiredForArtifact } from "~/configure/artifacts/target-registry.ts";
-import { reservedDocsTopicResourceUris } from "~/docs/mcp-resources.ts";
-import { DOCS_BUILTIN_TOPIC_KEYS, docsEnabled } from "~/docs/resolve.ts";
-import { HTTP_RESERVED_TOP_LEVEL_SEGMENTS } from "~/http/paths.ts";
-import { resolveMcpSchemaUri } from "~/mcp/tools.ts";
-import { reservedCommandNames, resolveCapabilities } from "~/runtime/capabilities.ts";
+import { AGENT_PAIRS, MCP_KEYS, mcpServerRequiredForArtifact } from "../configure/artifacts/target-registry.ts";
+import { reservedDocsTopicResourceUris } from "../docs/mcp-resources.ts";
+import { DOCS_BUILTIN_TOPIC_KEYS, docsEnabled } from "../docs/resolve.ts";
+import { HTTP_RESERVED_TOP_LEVEL_SEGMENTS } from "../http/paths.ts";
+import { resolveMcpSchemaUri } from "../mcp/tools.ts";
+import { reservedCommandNames, resolveCapabilities } from "../runtime/capabilities.ts";
 import { validateFormatValue } from "./formats.ts";
 import {
   type CliLeaf,

package/src/docs/builtin.ts

@@ -1,6 +1,6 @@
-import { docsSkillTopicDescription } from "~/builtins/configure-copy.ts";
-import { type CliLeaf, type CliOption, CliOptionKind, type CliProgram, type CliRouter } from "~/core/types.ts";
-import { resolveCapabilities } from "~/runtime/capabilities.ts";
+import { docsSkillTopicDescription } from "../builtins/configure-copy.ts";
+import { type CliLeaf, type CliOption, CliOptionKind, type CliProgram, type CliRouter } from "../core/types.ts";
+import { resolveCapabilities } from "../runtime/capabilities.ts";
 import {
   DOCS_ROUTER_DESCRIPTION,
   docsEnabled,

package/src/docs/cli-guide.test.ts

@@ -3,9 +3,9 @@ Tests for docs/cli-guide module behavior.
 */
 
 import { expect, test } from "bun:test";
-import { cliSchemaExport } from "~/core/schema.ts";
-import type { CliProgram } from "~/core/types.ts";
-import { CliOptionKind } from "~/core/types.ts";
+import { cliSchemaExport } from "../core/schema.ts";
+import type { CliProgram } from "../core/types.ts";
+import { CliOptionKind } from "../core/types.ts";
 import { generateCliGuide, generateCliGuideBody } from "./cli-guide.ts";
 
 const nestedFixture: CliProgram = {

package/src/docs/cli-guide.ts

@@ -1,8 +1,8 @@
-import type { CliSchemaExport } from "~/builtins/export.ts";
-import { cliSchemaExport } from "~/core/schema.ts";
-import type { CliOption, CliPositional, CliProgram } from "~/core/types.ts";
-import { CliFallbackMode, CliOptionKind } from "~/core/types.ts";
-import { cliPositionalLabel, cliResolveNotes } from "~/help.ts";
+import type { CliSchemaExport } from "../builtins/export.ts";
+import { cliSchemaExport } from "../core/schema.ts";
+import type { CliOption, CliPositional, CliProgram } from "../core/types.ts";
+import { CliFallbackMode, CliOptionKind } from "../core/types.ts";
+import { cliPositionalLabel, cliResolveNotes } from "../help.ts";
 
 /** Options for {@link generateCliGuideBody} and {@link generateCliGuide}. */
 export interface CliGuideBodyOptions {

package/src/docs/docs.test.ts

@@ -6,14 +6,14 @@ import { afterEach, beforeEach, expect, test } from "bun:test";
 import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { completionBashScript } from "~/builtins";
-import { cliPresentationRoot } from "~/builtins/presentation.ts";
-import { ParseKind, parse } from "~/core/parse.ts";
-import type { CliProgram } from "~/core/types.ts";
-import { cliValidateProgram } from "~/core/validate.ts";
-import { cliHelpRender } from "~/help.ts";
-import { Cli } from "~/index";
-import { resolveCapabilities, skipsRequiredAppConfigExit } from "~/runtime/capabilities.ts";
+import { completionBashScript } from "../builtins/index.ts";
+import { cliPresentationRoot } from "../builtins/presentation.ts";
+import { ParseKind, parse } from "../core/parse.ts";
+import type { CliProgram } from "../core/types.ts";
+import { cliValidateProgram } from "../core/validate.ts";
+import { cliHelpRender } from "../help.ts";
+import { Cli } from "../index.ts";
+import { resolveCapabilities, skipsRequiredAppConfigExit } from "../runtime/capabilities.ts";
 import { generateMcpGuide } from "./mcp-guide.ts";
 import { saveDocsTopic } from "./save.ts";
 

package/src/docs/http-guide.ts

@@ -1,10 +1,10 @@
-import { defaultConfigEntryTitle } from "~/config/entry.ts";
-import { displayAppConfigPath } from "~/config/file.ts";
-import { collectOptionDefs } from "~/core/parse.ts";
-import { CliOptionKind, type CliProgram } from "~/core/types.ts";
-import { httpUserPathGlob, resolveHttpPathPrefix } from "~/http/paths.ts";
-import { collectHttpRoutes } from "~/http/routes.ts";
-import { resolveHttpListenAddress } from "~/http/server.ts";
+import { defaultConfigEntryTitle } from "../config/entry.ts";
+import { displayAppConfigPath } from "../config/file.ts";
+import { collectOptionDefs } from "../core/parse.ts";
+import { CliOptionKind, type CliProgram } from "../core/types.ts";
+import { httpUserPathGlob, resolveHttpPathPrefix } from "../http/paths.ts";
+import { collectHttpRoutes } from "../http/routes.ts";
+import { resolveHttpListenAddress } from "../http/server.ts";
 
 /** Formats one HTTP route for the auto-generated HTTP guide. */
 function formatRouteLine(root: CliProgram, route: ReturnType<typeof collectHttpRoutes>[number]): string {
@@ -51,8 +51,8 @@ export function generateHttpGuide(root: CliProgram): string {
     "",
     "| Method | Path | Purpose |",
     "| --- | --- | --- |",
-    "| `GET` | `/health` or `/health/liveness` | Liveness check |",
-    "| `GET` | `/health/readiness` | Readiness (config + `program.readiness`) |",
+    "| `GET` | `/health/liveness` | Liveness — server is online and accepting requests |",
+    "| `GET` | `/health/readiness` | Readiness — online plus config and `program.readiness` checks passed |",
     "| `GET` | `/openapi.json` | OpenAPI 3.1 REST paths |",
     "| `GET` | `/swagger` | Interactive Swagger UI API reference |",
     `| * | \`${userGlob}\` | Invoke user commands (method per route) |`,
@@ -63,7 +63,7 @@ export function generateHttpGuide(root: CliProgram): string {
     "## Examples",
     "",
     "```bash",
-    `curl -s ${baseUrl}/health`,
+    `curl -s ${baseUrl}/health/liveness`,
     `curl -s ${baseUrl}/health/readiness`,
     `curl -s ${baseUrl}/openapi.json`,
     `curl -s ${baseUrl}${sampleWorkspaces}`,

package/src/docs/mcp-guide.ts

@@ -1,10 +1,10 @@
-import { defaultConfigEntryTitle } from "~/config/entry.ts";
-import { displayAppConfigPath } from "~/config/file.ts";
-import { expectedOpenCodeMcpEntry, OPENCODE_CONFIG_SCHEMA } from "~/configure/artifacts/mcp-opencode.ts";
-import { collectOptionDefs } from "~/core/parse.ts";
-import { CliOptionKind, type CliProgram } from "~/core/types.ts";
-import { collectMcpTools, type McpToolDef, mcpServerId, resolveMcpSchemaUri } from "~/mcp/tools.ts";
-import { resolveCapabilities } from "~/runtime/capabilities.ts";
+import { defaultConfigEntryTitle } from "../config/entry.ts";
+import { displayAppConfigPath } from "../config/file.ts";
+import { expectedOpenCodeMcpEntry, OPENCODE_CONFIG_SCHEMA } from "../configure/artifacts/mcp-opencode.ts";
+import { collectOptionDefs } from "../core/parse.ts";
+import { CliOptionKind, type CliProgram } from "../core/types.ts";
+import { collectMcpTools, type McpToolDef, mcpServerId, resolveMcpSchemaUri } from "../mcp/tools.ts";
+import { resolveCapabilities } from "../runtime/capabilities.ts";
 import { resolveDocsTopicResourceUri } from "./mcp-resources.ts";
 import { docsEnabled, docsUserTopicKeys, resolveDocsConfig } from "./resolve.ts";
 

package/src/docs/mcp-resources.test.ts

@@ -3,7 +3,7 @@ Tests for docs/mcp-resources module behavior.
 */
 
 import { expect, test } from "bun:test";
-import type { CliProgram } from "~/core/types.ts";
+import type { CliProgram } from "../core/types.ts";
 import {
   defaultDocsTopicResourceUri,
   docsMcpResources,

package/src/docs/mcp-resources.ts

@@ -2,7 +2,7 @@
 Auto MCP resources for user docs.topics when docs and MCP are both enabled.
 */
 
-import type { CliProgram } from "~/core/types.ts";
+import type { CliProgram } from "../core/types.ts";
 import { docsEnabled, docsTopicDescription, docsTopicText, docsUserTopicKeys, resolveDocsConfig } from "./resolve.ts";
 
 /** Default URI pattern for a docs topic MCP resource (`<mcpId>://docs/<topicKey>`). */

package/src/docs/resolve.ts

@@ -1,7 +1,7 @@
-import { cliSchemaJson } from "~/core/schema.ts";
-import type { CliDocsConfig, CliProgram } from "~/core/types.ts";
-import { openApiJson } from "~/http/openapi.ts";
-import { generateSkillBundle } from "~/skill/generate.ts";
+import { cliSchemaJson } from "../core/schema.ts";
+import type { CliDocsConfig, CliProgram } from "../core/types.ts";
+import { openApiJson } from "../http/openapi.ts";
+import { generateSkillBundle } from "../skill/generate.ts";
 import { generateCliGuide } from "./cli-guide.ts";
 import { generateHttpGuide } from "./http-guide.ts";
 import { generateMcpGuide } from "./mcp-guide.ts";

package/src/docs/save.ts

@@ -1,7 +1,7 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import type { CliProgram } from "~/core/types.ts";
-import { generatedFileHtmlComment, insertGeneratedHint } from "~/skill/hint.ts";
+import type { CliProgram } from "../core/types.ts";
+import { generatedFileHtmlComment, insertGeneratedHint } from "../skill/hint.ts";
 import { docsTopicContent } from "./resolve.ts";
 
 /** Relative output directory for `docs --save`. */

package/src/exports/cli.ts

@@ -2,15 +2,15 @@
 Public CLI runtime export (`argsbarg/cli`).
 */
 
-export { displayAppConfigPath, resolveAppConfigPath } from "~/config/file.ts";
-export type { CliLeafInputs } from "~/core/context.ts";
-export { CliContext } from "~/core/context.ts";
+export { displayAppConfigPath, resolveAppConfigPath } from "../config/file.ts";
+export type { CliLeafInputs } from "../core/context.ts";
+export { CliContext } from "../core/context.ts";
 export {
   parseCommaList,
   parseDate,
   parseDateTime,
   parseDurationMs,
-} from "~/core/formats.ts";
+} from "../core/formats.ts";
 export type {
   CliAppConfig,
   CliAppConfigEntry,
@@ -35,13 +35,13 @@ export type {
   InstallAgentIntegration,
   InstallTargetSpec,
   ResolvedInstallTarget,
-} from "~/core/types.ts";
+} from "../core/types.ts";
 export {
   CliOptionKind,
   CliSchemaValidationError,
   CliValueFormat,
   isJsonLeaf,
-} from "~/core/types.ts";
-export { Cli, type CliInvokeKind, type CliInvokeResult } from "~/runtime/cli.ts";
-export { cliErrWithHelp } from "~/runtime/cli-errors.ts";
-export { isInteractiveTty } from "~/utils.ts";
+} from "../core/types.ts";
+export { Cli, type CliInvokeKind, type CliInvokeResult } from "../runtime/cli.ts";
+export { cliErrWithHelp } from "../runtime/cli-errors.ts";
+export { isInteractiveTty } from "../utils.ts";

package/src/exports/headless.ts

@@ -2,7 +2,7 @@
 Headless routing helpers (`argsbarg/headless`).
 */
 
-export type { HeadlessContext } from "~/headless/routing.ts";
+export type { HeadlessContext } from "../headless/routing.ts";
 export {
   formatDryRunMessage,
   requireYesInNonTty,
@@ -10,4 +10,4 @@ export {
   shouldRunHeadlessWithPositionals,
   shouldRunHeadlessWithYes,
   wantsExplicitJson,
-} from "~/headless/routing.ts";
+} from "../headless/routing.ts";

package/src/exports/http.ts

@@ -2,5 +2,5 @@
 HTTP/OpenAPI export (`argsbarg/http`).
 */
 
-export { generateOpenApi, openApiJson } from "~/http/openapi.ts";
-export { handleApiRequest, httpServeHttp, resolveHttpListenAddress } from "~/http/server.ts";
+export { generateOpenApi, openApiJson } from "../http/openapi.ts";
+export { handleApiRequest, httpServeHttp, resolveHttpListenAddress } from "../http/server.ts";

package/src/exports/mcp.ts

@@ -2,5 +2,5 @@
 MCP bundle export (`argsbarg/mcp`). @experimental
 */
 
-export type { McpBundlePaths, PackMcpBundleOpts } from "~/mcp/bundle.ts";
-export { defaultMcpBundlePaths, generateMcpManifest, packMcpBundle } from "~/mcp/bundle.ts";
+export type { McpBundlePaths, PackMcpBundleOpts } from "../mcp/bundle.ts";
+export { defaultMcpBundlePaths, generateMcpManifest, packMcpBundle } from "../mcp/bundle.ts";

package/src/headless/routing.ts

@@ -1,5 +1,5 @@
-import type { CliContext } from "~/core/context.ts";
-import { isInteractiveTty } from "~/utils.ts";
+import type { CliContext } from "../core/context.ts";
+import { isInteractiveTty } from "../utils.ts";
 
 /** Minimal context for headless routing helpers. */
 export type HeadlessContext = Pick<CliContext, "invocation">;

package/src/headless/tool-call.ts

@@ -2,16 +2,16 @@
 Shared headless tool dispatch for MCP and HTTP: config bootstrap, argv conversion, and invoke.
 */
 
-import { bootstrapAppConfig } from "~/config/bootstrap.ts";
-import { formatMcpMissingConfigMessage, missingRequiredConfig } from "~/config/resolve.ts";
-import type { CliInvocation, CliProgram, InvokeFailureKind } from "~/core/types.ts";
-import { failureKindHttpStatus } from "~/hooks/run.ts";
-import { apiErrorResponse, apiSuccessResponse, firstErrorLine } from "~/http/result.ts";
-import { type HttpRouteDef, httpRequestToArgv } from "~/http/routes.ts";
-import { obscureUnexpectedClientMessage } from "~/log/emitter.ts";
-import { buildToolCallSuccessFromResponse } from "~/mcp/result.ts";
-import { collectMcpTools, type McpToolDef, mcpToolCallToArgv } from "~/mcp/tools.ts";
-import type { Cli, CliInvokeResult } from "~/runtime/cli.ts";
+import { bootstrapAppConfig } from "../config/bootstrap.ts";
+import { formatMcpMissingConfigMessage, missingRequiredConfig } from "../config/resolve.ts";
+import type { CliInvocation, CliProgram, InvokeFailureKind } from "../core/types.ts";
+import { failureKindHttpStatus } from "../hooks/run.ts";
+import { apiErrorResponse, apiSuccessResponse, firstErrorLine } from "../http/result.ts";
+import { type HttpRouteDef, httpRequestToArgv } from "../http/routes.ts";
+import { obscureUnexpectedClientMessage } from "../log/emitter.ts";
+import { buildToolCallSuccessFromResponse } from "../mcp/result.ts";
+import { collectMcpTools, type McpToolDef, mcpToolCallToArgv } from "../mcp/tools.ts";
+import type { Cli, CliInvokeResult } from "../runtime/cli.ts";
 
 /** Outcome of resolving a tool name against the program schema. */
 export type ToolLookupResult =
@@ -179,7 +179,7 @@ export async function executeHttpRouteCall(
 /** Maps a headless success result to an HTTP Response. */
 export function headlessSuccessToHttpResponse(
   result: HeadlessToolCallSuccess,
-  leafApiResponse?: import("~/core/types.ts").CliHttpResponseConfig,
+  leafApiResponse?: import("../core/types.ts").CliHttpResponseConfig,
   defaultStatus?: number,
 ): Response {
   return apiSuccessResponse(result.response, leafApiResponse, defaultStatus);

package/src/hooks/run.ts

@@ -2,17 +2,17 @@
 Safe async hook runner, failure classification, and invoke error pipeline.
 */
 
-import type { CliContext } from "~/core/context.ts";
-import { LeafInputError } from "~/core/leaf-inputs.ts";
+import type { CliContext } from "../core/context.ts";
+import { LeafInputError } from "../core/leaf-inputs.ts";
 import type {
   ClientErrorOverride,
   ErrorHookContext,
   InvokeFailureKind,
   InvokeHookContext,
   ServerRuntime,
-} from "~/core/types.ts";
-import { firstErrorLine } from "~/http/result.ts";
-import { type LogEmitter, obscureUnexpectedClientMessage } from "~/log/emitter.ts";
+} from "../core/types.ts";
+import { firstErrorLine } from "../http/result.ts";
+import { type LogEmitter, obscureUnexpectedClientMessage } from "../log/emitter.ts";
 
 /** Runs a hook without letting hook throws escape uncaught. */
 export async function runHook<T>(hook: (() => T | Promise<T>) | undefined, label: string): Promise<T | undefined> {
@@ -106,7 +106,7 @@ export async function runErrorPipeline(
   hookCtx: InvokeHookContext,
   err: unknown,
   failureKind: InvokeFailureKind,
-  hooks: import("~/core/types.ts").CliProgramHooks | undefined,
+  hooks: import("../core/types.ts").CliProgramHooks | undefined,
   emitter: LogEmitter | undefined,
   obscureUnexpected: boolean,
 ): Promise<ErrorPipelineResult> {

package/src/http/openapi.ts

@@ -2,9 +2,9 @@
 Hand-built OpenAPI 3.1 document from exposed HTTP REST routes.
 */
 
-import { collectOptionDefs } from "~/core/parse.ts";
-import type { CliHttpMethod, CliNode, CliProgram } from "~/core/types.ts";
-import { CliOptionKind, isCliLeaf, isJsonLeaf } from "~/core/types.ts";
+import { collectOptionDefs } from "../core/parse.ts";
+import type { CliHttpMethod, CliNode, CliProgram } from "../core/types.ts";
+import { CliOptionKind, isCliLeaf, isJsonLeaf } from "../core/types.ts";
 import { collectHttpRoutes, defaultSuccessStatus } from "./routes.ts";
 import { dereferenceJsonSchema } from "./schema-deref.ts";
 
@@ -150,13 +150,15 @@ function jsonResponseEntry(description: string, schema: Record<string, unknown>)
   };
 }
 
-function livenessGetOp(operationId: string, summary: string): Record<string, unknown> {
+function livenessGetOp(): Record<string, unknown> {
   return {
     tags: [HEALTH_TAG],
-    operationId,
-    summary,
+    operationId: "health_liveness",
+    summary: "Liveness probe",
+    description:
+      "Returns 200 when the HTTP server is online and accepting requests. Does not run config or readiness checks — use for orchestrator liveness probes only.",
     responses: {
-      "200": jsonResponseEntry("Server is listening", livenessResponseSchema),
+      "200": jsonResponseEntry("Server is online", livenessResponseSchema),
     },
   };
 }
@@ -164,21 +166,19 @@ function livenessGetOp(operationId: string, summary: string): Record<string, unk
 /** Framework health probe paths served alongside user command routes. */
 function buildHealthPaths(): Record<string, unknown> {
   return {
-    "/health": {
-      get: livenessGetOp("health", "Liveness probe (alias of /health/liveness)"),
-    },
     "/health/liveness": {
-      get: livenessGetOp("health_liveness", "Liveness probe"),
+      get: livenessGetOp(),
     },
     "/health/readiness": {
       get: {
         tags: [HEALTH_TAG],
         operationId: "health_readiness",
         summary: "Readiness probe",
-        description: "Config file, required app config, and optional program.readiness checks.",
+        description:
+          "Returns 200 when the server is online and all readiness checks pass (config file, required app config, and optional program.readiness). Returns 503 when any check fails — use for orchestrator readiness probes before routing traffic.",
         responses: {
-          "200": jsonResponseEntry("Ready to serve traffic", readinessResponseSchema),
-          "503": jsonResponseEntry("Not ready", readinessResponseSchema),
+          "200": jsonResponseEntry("Online and ready to serve traffic", readinessResponseSchema),
+          "503": jsonResponseEntry("Online but not ready (one or more checks failed)", readinessResponseSchema),
         },
       },
     },
@@ -278,7 +278,15 @@ export function generateOpenApi(program: CliProgram): Record<string, unknown> {
       description: program.description,
     },
     ...(program.httpServer?.enabled
-      ? { tags: [{ name: HEALTH_TAG, description: "Server health probes" }, ...commandTags] }
+      ? {
+          tags: [
+            {
+              name: HEALTH_TAG,
+              description: "Orchestrator health probes — liveness (online) vs readiness (online + checks passed).",
+            },
+            ...commandTags,
+          ],
+        }
       : {}),
     paths,
   };

package/src/http/paths.ts

@@ -2,7 +2,7 @@
 HTTP path prefix helpers and framework route guards.
 */
 
-import type { CliProgram } from "~/core/types.ts";
+import type { CliProgram } from "../core/types.ts";
 
 /** Top-level segments reserved for framework routes when `pathPrefix` is empty. */
 export const HTTP_RESERVED_TOP_LEVEL_SEGMENTS = new Set(["health", "openapi.json", "swagger", "tools"]);

package/src/http/readiness.ts

@@ -2,9 +2,9 @@
 HTTP/MCP readiness checks for GET /health/readiness (orchestrator probes only).
 */
 
-import type { AnyAppConfigSnapshot } from "~/config/context.ts";
-import { missingRequiredConfig } from "~/config/resolve.ts";
-import type { CliProgram, ReadinessContext, ServerRuntime } from "~/core/types.ts";
+import type { AnyAppConfigSnapshot } from "../config/context.ts";
+import { missingRequiredConfig } from "../config/resolve.ts";
+import type { CliProgram, ReadinessContext, ServerRuntime } from "../core/types.ts";
 
 const READINESS_CACHE_MS = 3000;