incur 0.3.14 → 0.3.16

package/src/Schema.ts

@@ -1,8 +1,18 @@
 import { z } from 'zod'
 
-/** Converts a Zod schema to a JSON Schema object. Strips the `$schema` meta-property. */
+/**
+ * Converts a Zod schema to a JSON Schema object. Strips the `$schema`
+ * meta-property. Represents bigints and dates as `{ type: "string" }`
+ * since JSON lacks native types for them.
+ */
 export function toJsonSchema(schema: z.ZodType): Record<string, unknown> {
-  const result = z.toJSONSchema(schema) as Record<string, unknown>
+  const result = z.toJSONSchema(schema, {
+    unrepresentable: 'any',
+    override: (ctx) => {
+      const type = ctx.zodSchema._zod?.def?.type
+      if (type === 'bigint' || type === 'date') ctx.jsonSchema.type = 'string'
+    },
+  }) as Record<string, unknown>
   delete result.$schema
   return result
 }

package/src/Skill.ts

@@ -133,7 +133,8 @@ function renderGroup(
   const childDescs = cmds.map((c) => c.description).filter(Boolean) as string[]
   const descParts: string[] = []
   if (groupDesc) descParts.push(groupDesc.replace(/\.$/, ''))
-  if (childDescs.length > 0) descParts.push(childDescs.join(', '))
+  if (childDescs.length > 0)
+    descParts.push(childDescs.map((d) => d.replace(/\.$/, '')).join(', '))
   const description =
     descParts.length > 0
       ? `${descParts.join('. ')}. Run \`${title} --help\` for usage details.`

package/src/SyncSkills.test.ts

@@ -125,3 +125,66 @@ test('installed SKILL.md contains frontmatter', async () => {
 
   rmSync(tmp, { recursive: true, force: true })
 })
+
+test('list returns skills from command map', async () => {
+  const cli = Cli.create('test', { description: 'A test CLI' })
+  cli.command('ping', { description: 'Health check', run: () => ({}) })
+  cli.command('greet', { description: 'Say hello', run: () => ({}) })
+
+  const commands = Cli.toCommands.get(cli)!
+  const result = await SyncSkills.list('test', commands)
+
+  expect(result.length).toBeGreaterThan(0)
+  const names = result.map((s) => s.name)
+  expect(names).toContain('test-ping')
+  expect(names).toContain('test-greet')
+  for (const s of result) {
+    expect(s.installed).toBe(false)
+    expect(s.description).toBeDefined()
+  }
+})
+
+test('list shows installed status after sync', async () => {
+  const tmp = join(tmpdir(), `clac-list-test-${Date.now()}`)
+  mkdirSync(tmp, { recursive: true })
+  process.env.XDG_DATA_HOME = tmp
+
+  const cli = Cli.create('test')
+  cli.command('ping', { description: 'Ping', run: () => ({}) })
+
+  const commands = Cli.toCommands.get(cli)!
+  const installDir = join(tmp, 'install')
+  mkdirSync(join(installDir, '.agents', 'skills'), { recursive: true })
+
+  // Sync first to install
+  await SyncSkills.sync('test', commands, {
+    global: false,
+    cwd: installDir,
+  })
+
+  // Now list should show installed
+  const result = await SyncSkills.list('test', commands)
+  expect(result.length).toBeGreaterThan(0)
+  for (const s of result) expect(s.installed).toBe(true)
+
+  rmSync(tmp, { recursive: true, force: true })
+})
+
+test('list returns empty for CLI with no commands', async () => {
+  const cli = Cli.create('empty')
+  const commands = Cli.toCommands.get(cli)!
+  const result = await SyncSkills.list('empty', commands)
+  expect(result).toHaveLength(0)
+})
+
+test('list results are sorted alphabetically', async () => {
+  const cli = Cli.create('test')
+  cli.command('zebra', { description: 'Z command', run: () => ({}) })
+  cli.command('alpha', { description: 'A command', run: () => ({}) })
+  cli.command('middle', { description: 'M command', run: () => ({}) })
+
+  const commands = Cli.toCommands.get(cli)!
+  const result = await SyncSkills.list('test', commands)
+  const names = result.map((s) => s.name)
+  expect(names).toEqual([...names].sort())
+})

package/src/SyncSkills.ts

@@ -125,6 +125,84 @@ export declare namespace sync {
   }
 }
 
+/** Lists skills derived from a CLI's command map with install status. */
+export async function list(
+  name: string,
+  commands: Map<string, any>,
+  options: list.Options = {},
+): Promise<list.Skill[]> {
+  const { depth = 1, description } = options
+  const cwd = options.cwd ?? process.cwd()
+
+  const groups = new Map<string, string>()
+  if (description) groups.set(name, description)
+  const entries = collectEntries(commands, [], groups)
+  const files = Skill.split(name, entries, depth, groups)
+
+  const skills: list.Skill[] = []
+  const meta = readMeta(name)
+  const installed = new Set(meta?.skills)
+
+  for (const file of files) {
+    const nameMatch = file.content.match(/^name:\s*(.+)$/m)
+    const descMatch = file.content.match(/^description:\s*(.+)$/m)
+    const skillName = nameMatch?.[1] ?? (file.dir || name)
+    skills.push({
+      name: skillName,
+      description: descMatch?.[1],
+      installed: installed.has(skillName),
+    })
+  }
+
+  // Include additional SKILL.md files matched by glob patterns
+  if (options.include) {
+    for (const pattern of options.include) {
+      const globPattern = pattern === '_root' ? 'SKILL.md' : path.join(pattern, 'SKILL.md')
+      for await (const match of fs.glob(globPattern, { cwd })) {
+        try {
+          const content = await fs.readFile(path.resolve(cwd, match), 'utf8')
+          const nameMatch = content.match(/^name:\s*(.+)$/m)
+          const skillName =
+            pattern === '_root' ? (nameMatch?.[1] ?? name) : path.basename(path.dirname(match))
+          if (!skills.some((s) => s.name === skillName)) {
+            const descMatch = content.match(/^description:\s*(.+)$/m)
+            skills.push({
+              name: skillName,
+              description: descMatch?.[1],
+              installed: installed.has(skillName),
+            })
+          }
+        } catch {}
+      }
+    }
+  }
+
+  return skills.sort((a, b) => a.name.localeCompare(b.name))
+}
+
+export declare namespace list {
+  /** Options for listing skills. */
+  type Options = {
+    /** Working directory for resolving `include` globs. Defaults to `process.cwd()`. */
+    cwd?: string | undefined
+    /** Grouping depth for skill files. Defaults to `1`. */
+    depth?: number | undefined
+    /** CLI description, used as the top-level group description. */
+    description?: string | undefined
+    /** Glob patterns for directories containing SKILL.md files to include. */
+    include?: string[] | undefined
+  }
+  /** A skill entry with install status. */
+  type Skill = {
+    /** Description extracted from the skill frontmatter. */
+    description?: string | undefined
+    /** Whether this skill is currently installed. */
+    installed: boolean
+    /** Skill name. */
+    name: string
+  }
+}
+
 /** Recursively collects leaf commands as `Skill.CommandInfo`. */
 function collectEntries(
   commands: Map<string, any>,

package/src/e2e.test.ts

@@ -967,7 +967,7 @@ describe('help', () => {
       Integrations:
         completions  Generate shell completion script
         mcp add      Register as MCP server
-        skills add   Sync skill files to agents
+        skills       Sync skill files to agents (add, list)
 
       Global Options:
         --filter-output <keys>              Filter output by key paths (e.g. foo,bar.baz,a[0,3])
@@ -1742,7 +1742,7 @@ describe('root command with subcommands', () => {
       Integrations:
         completions  Generate shell completion script
         mcp add      Register as MCP server
-        skills add   Sync skill files to agents
+        skills       Sync skill files to agents (add, list)
 
       Global Options:
         --filter-output <keys>              Filter output by key paths (e.g. foo,bar.baz,a[0,3])

package/src/internal/command.ts

@@ -422,6 +422,10 @@ export const builtinCommands = [
           noGlobal: z.boolean().optional().describe('Install to project instead of globally'),
         }),
       }),
+      subcommand({
+        name: 'list',
+        description: 'List skills',
+      }),
     ],
   },
 ] satisfies {