argsbarg 6.1.2 → 6.1.4

package/src/skill/generate.ts

@@ -2,17 +2,17 @@
 This module generates Agent Skills content (SKILL.md + reference.md) from a CLI schema.
 */
 
-import { defaultConfigEntryTitle } from "../config/entry.ts";
-import { generateApiGuide } from "../docs/api-guide.ts";
+import { defaultConfigEntryTitle } from "~/config/entry.ts";
+import { collectOptionDefs } from "~/core/parse.ts";
+import { CliOptionKind, type CliProgram } from "~/core/types.ts";
+import { generateCliGuide } from "~/docs/cli-guide.ts";
 import {
   collectMcpTools,
   type McpToolDef,
   mcpServerId,
   resolveMcpSchemaUri,
   sanitizeToolSegment,
-} from "../mcp/tools.ts";
-import { collectOptionDefs } from "../parse.ts";
-import { CliOptionKind, type CliProgram } from "../types.ts";
+} from "~/mcp/tools.ts";
 import type { SkillTarget } from "./naming.ts";
 import { skillDirNameForTarget, skillFrontmatterName } from "./naming.ts";
 
@@ -149,7 +149,7 @@ function buildSkillMd(root: CliProgram, target: SkillTarget, dirName: string): s
     "",
     "## Reference",
     "",
-    `For full detail, open \`reference.md\` in this skill directory (same as \`${root.key} docs api\`).`,
+    `For full detail, open \`reference.md\` in this skill directory (same as \`${root.key} docs cli\`).`,
     "",
   );
 
@@ -190,9 +190,9 @@ function buildSkillMd(root: CliProgram, target: SkillTarget, dirName: string): s
   return lines.join("\n");
 }
 
-/** Builds reference.md with the full `docs api` markdown guide. */
+/** Builds reference.md with the compact `docs cli` markdown guide. */
 function buildReferenceMd(root: CliProgram): string {
-  return generateApiGuide(root);
+  return generateCliGuide(root, { compact: true });
 }
 
 /** Builds MCP routing SKILL.md for Claude Code plugin zips. */

package/src/skill/hint.ts

@@ -1,4 +1,4 @@
-import type { CliProgram } from "../types.ts";
+import type { CliProgram } from "~/core/types.ts";
 
 /** YAML frontmatter block at the start of SKILL.md. */
 export const MARKDOWN_FRONTMATTER_RE = /^---\r?\n[\s\S]*?\r?\n---\r?\n/;

package/src/skill/install.ts

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { userHome } from "../paths/host.ts";
-import type { CliProgram } from "../types.ts";
+import type { CliProgram } from "~/core/types.ts";
+import { userHome } from "~/paths/host.ts";
 import { generateSkillBundle, type SkillTarget } from "./generate.ts";
 import { applySkillInstallHints } from "./hint.ts";
 

package/src/skill/naming.ts

@@ -1,7 +1,7 @@
 /** Agent skill install targets. */
 export type SkillTarget = "cursor" | "claude" | "codex" | "opencode" | "openclaw";
 
-import { sanitizeToolSegment } from "../mcp/tools.ts";
+import { sanitizeToolSegment } from "~/mcp/tools.ts";
 
 /** Kebab-case skill folder + frontmatter name for agents that require hyphen slugs. */
 export function skillSlug(programKey: string): string {

package/src/{test-fixtures.ts → test/fixtures.ts}

@@ -1,5 +1,5 @@
-import type { CliProgram } from "./types.ts";
-import { CliFallbackMode, CliOptionKind } from "./types.ts";
+import type { CliProgram } from "~/core/types.ts";
+import { CliFallbackMode, CliOptionKind } from "~/core/types.ts";
 
 export function testProgram(prog: Record<string, unknown> & { key: string; description: string }): CliProgram {
   return { version: "0.0.0", ...prog } as CliProgram;
@@ -166,6 +166,7 @@ export function nestedDocsFallbackFixture(): CliProgram {
   return testProgram({
     key: "app",
     description: "",
+    docs: { enabled: false },
     commands: [
       {
         key: "docs",

package/src/{config.integration.test.ts → test/integration/config.test.ts}

@@ -6,9 +6,9 @@ import { expect, test } from "bun:test";
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
-import { bootstrapAppConfig } from "./config/bootstrap.ts";
-import { resolveAppConfigPath } from "./config/file.ts";
-import { mcpRequest, testProgram } from "./test-fixtures.ts";
+import { bootstrapAppConfig } from "~/config/bootstrap.ts";
+import { resolveAppConfigPath } from "~/config/file.ts";
+import { mcpRequest, testProgram } from "~/test/fixtures.ts";
 
 /** Tests that bootstrapAppConfig prefers host env over config file. */
 test("bootstrapAppConfig prefers host env over config file", () => {
@@ -124,13 +124,13 @@ test("MCP config file loads and exports vars for tool handlers", async () => {
   rmSync(dir, { recursive: true, force: true });
 });
 
-/** Cli.run docs api skips required appConfig exit. */
-test("Cli.run docs api skips required appConfig exit", async () => {
+/** Cli.run docs cli skips required appConfig exit. */
+test("Cli.run docs cli skips required appConfig exit", async () => {
   const dir = mkdtempSync(join(tmpdir(), "argsbarg-docs-skip-"));
   const configFile = join(dir, ".local", "lib", "docs_skip_test", "config");
   mkdirSync(dirname(configFile), { recursive: true });
   writeFileSync(configFile, "{}\n");
-  const entry = join(import.meta.dir, "index.ts");
+  const entry = join(import.meta.dir, "..", "..", "index.ts");
   const mainPath = join(dir, "run-docs.ts");
   writeFileSync(
     mainPath,
@@ -139,7 +139,7 @@ const program = {
   key: "docs-skip-test",
   version: "1.0.0",
   description: "test",
-  docs: { enabled: true, topics: { readme: { text: "# readme\\n" } } },
+  docs: { topics: { readme: { text: "# readme\\n" } } },
   appConfig: {
     entries: { token: { description: "Token.", env: "DOCS_SKIP_RUN_TOKEN" } },
   },
@@ -151,7 +151,7 @@ await new Cli(program).run(process.argv.slice(2));
   const env = { ...process.env, HOME: dir } as Record<string, string | undefined>;
   delete env.DOCS_SKIP_RUN_TOKEN;
   try {
-    const proc = Bun.spawn(["bun", "run", mainPath, "docs", "api"], {
+    const proc = Bun.spawn(["bun", "run", mainPath, "docs", "cli"], {
       stdout: "pipe",
       stderr: "pipe",
       env,