@patricksardinha/agentkit-cli 0.1.0

package/tests/generators/playbookGenerator.test.ts

@@ -0,0 +1,152 @@
+import { describe, it, expect } from 'vitest'
+import { generatePlaybook } from '../../src/generators/playbookGenerator.js'
+import { extractAgentsFromWorkflow } from '../../src/utils/agentParser.js'
+import { toSlug } from '../../src/utils/agentParser.js'
+import type { Agent } from '../../src/types/agent.js'
+
+const sampleAgents: Agent[] = [
+  {
+    number: 1,
+    name: 'Infra & Setup',
+    fullName: 'Agent 1 · Infra & Setup',
+    slug: 'infra-setup',
+    scope: 'scaffolding du projet',
+    outputs: ['package.json', 'tsconfig.json'],
+    criterion: 'npm run build',
+  },
+  {
+    number: 2,
+    name: 'Components',
+    fullName: 'Agent 2 · Components',
+    slug: 'components',
+    scope: 'composants UI réutilisables',
+    outputs: ['src/components/'],
+    criterion: 'npm test',
+  },
+]
+
+describe('generatePlaybook', () => {
+  it('returns a non-empty string', () => {
+    const result = generatePlaybook({ agents: sampleAgents, projectName: 'my-app' })
+    expect(typeof result).toBe('string')
+    expect(result.length).toBeGreaterThan(0)
+  })
+
+  it('contains the project name', () => {
+    const result = generatePlaybook({ agents: sampleAgents, projectName: 'my-app' })
+    expect(result).toContain('my-app')
+  })
+
+  it('starts with the unique instruction', () => {
+    const result = generatePlaybook({ agents: sampleAgents, projectName: 'my-app' })
+    expect(result).toContain("Donne cette instruction à Claude Code")
+    expect(result).toContain("Lis PLAYBOOK.md et exécute la procédure")
+  })
+
+  it('contains global execution rules', () => {
+    const result = generatePlaybook({ agents: sampleAgents, projectName: 'my-app' })
+    expect(result).toContain('Règles d\'exécution globales')
+    expect(result).toContain('3 tentatives')
+    expect(result).toContain('validation humaine')
+    expect(result).toContain('Ne jamais passer')
+  })
+
+  it('contains a block for each agent', () => {
+    const result = generatePlaybook({ agents: sampleAgents, projectName: 'my-app' })
+    for (const agent of sampleAgents) {
+      expect(result).toContain(agent.fullName)
+      expect(result).toContain(agent.scope)
+      expect(result).toContain(`agents/agent-${agent.number}-${agent.slug}/skills.md`)
+    }
+  })
+
+  it('each agent block contains outputs and criterion', () => {
+    const result = generatePlaybook({ agents: sampleAgents, projectName: 'my-app' })
+    expect(result).toContain('package.json')
+    expect(result).toContain('npm run build')
+    expect(result).toContain('src/components/')
+    expect(result).toContain('npm test')
+  })
+
+  it('contains the "Itérations futures" section', () => {
+    const result = generatePlaybook({ agents: sampleAgents, projectName: 'my-app' })
+    expect(result).toContain('Itérations futures')
+    expect(result).toContain('agentkit add --feature')
+  })
+
+  it('contains the human validation section', () => {
+    const result = generatePlaybook({ agents: sampleAgents, projectName: 'my-app' })
+    expect(result).toContain('Validation humaine requise')
+    expect(result).toContain('3 échecs consécutifs')
+    expect(result).toContain('Dépendance externe manquante')
+    expect(result).toContain('Conflit')
+  })
+
+  it('handles an empty agents list gracefully', () => {
+    const result = generatePlaybook({ agents: [], projectName: 'empty-project' })
+    expect(typeof result).toBe('string')
+    expect(result).toContain('empty-project')
+  })
+})
+
+describe('toSlug', () => {
+  it('converts name to lowercase hyphenated slug', () => {
+    expect(toSlug('Infra & Setup')).toBe('infra-setup')
+    expect(toSlug('Components')).toBe('components')
+    expect(toSlug('State & Hooks')).toBe('state-hooks')
+    expect(toSlug('Pages & Routing')).toBe('pages-routing')
+    expect(toSlug('Tests & CI')).toBe('tests-ci')
+  })
+
+  it('handles extra spaces and special chars', () => {
+    expect(toSlug('Data Layer')).toBe('data-layer')
+    expect(toSlug('API · Routes')).toBe('api-routes')
+  })
+})
+
+describe('extractAgentsFromWorkflow', () => {
+  it('extracts agents from a workflow string matching template format', () => {
+    const workflow = `# Agent Workflow — React Project
+
+## Stack détectée
+Framework: React
+
+## Agents
+
+### Agent 1 · Components
+Périmètre : composants UI réutilisables
+Produit   : src/components/
+Critère   : composants documentés et testés
+
+### Agent 2 · State & Hooks
+Périmètre : state management, hooks personnalisés
+Produit   : src/hooks/
+Critère   : hooks testés unitairement
+`
+    const agents = extractAgentsFromWorkflow(workflow)
+    expect(agents).toHaveLength(2)
+    expect(agents[0].number).toBe(1)
+    expect(agents[0].name).toBe('Components')
+    expect(agents[0].fullName).toBe('Agent 1 · Components')
+    expect(agents[0].slug).toBe('components')
+    expect(agents[0].scope).toBe('composants UI réutilisables')
+    expect(agents[0].criterion).toBe('composants documentés et testés')
+    expect(agents[0].outputs).toEqual(['src/components/'])
+  })
+
+  it('handles multi-line outputs', () => {
+    const workflow = `### Agent 1 · Setup
+Périmètre : configuration initiale
+Produit   :
+  - package.json
+  - tsconfig.json
+Critère   : npm run build
+`
+    const agents = extractAgentsFromWorkflow(workflow)
+    expect(agents[0].outputs).toEqual(['package.json', 'tsconfig.json'])
+  })
+
+  it('returns empty array for content with no agent blocks', () => {
+    expect(extractAgentsFromWorkflow('# Just a title\nNo agents here.')).toEqual([])
+  })
+})

package/tests/generators/skillsGenerator.test.ts

@@ -0,0 +1,94 @@
+import { describe, it, expect, afterEach } from 'vitest'
+import { generateSkills } from '../../src/generators/skillsGenerator.js'
+import type { Agent } from '../../src/types/agent.js'
+import { readFile, rm, mkdtemp } from 'node:fs/promises'
+import { join } from 'node:path'
+import { tmpdir } from 'node:os'
+
+const sampleAgents: Agent[] = [
+  {
+    number: 1,
+    name: 'Infra & Setup',
+    fullName: 'Agent 1 · Infra & Setup',
+    slug: 'infra-setup',
+    scope: 'scaffolding du projet',
+    outputs: ['package.json', 'tsconfig.json'],
+    criterion: 'npm run build',
+  },
+  {
+    number: 2,
+    name: 'Components',
+    fullName: 'Agent 2 · Components',
+    slug: 'components',
+    scope: 'composants UI réutilisables',
+    outputs: ['src/components/'],
+    criterion: 'npm test',
+  },
+]
+
+let tempDir = ''
+
+afterEach(async () => {
+  if (tempDir) {
+    await rm(tempDir, { recursive: true, force: true })
+    tempDir = ''
+  }
+})
+
+describe('generateSkills', () => {
+  it('creates an agents/ directory with one folder per agent', async () => {
+    tempDir = await mkdtemp(join(tmpdir(), 'agentkit-test-'))
+    await generateSkills(sampleAgents, tempDir)
+
+    for (const agent of sampleAgents) {
+      const dirPath = join(tempDir, 'agents', `agent-${agent.number}-${agent.slug}`)
+      // readFile would throw if dir doesn't exist — use access via readFile on a known file
+      const skills = await readFile(join(dirPath, 'skills.md'), 'utf-8')
+      expect(skills).toBeTruthy()
+    }
+  })
+
+  it('skills.md contains the agent fullName', async () => {
+    tempDir = await mkdtemp(join(tmpdir(), 'agentkit-test-'))
+    await generateSkills(sampleAgents, tempDir)
+
+    const skills1 = await readFile(
+      join(tempDir, 'agents', 'agent-1-infra-setup', 'skills.md'),
+      'utf-8',
+    )
+    expect(skills1).toContain('Agent 1 · Infra & Setup')
+    expect(skills1).toContain('## Contexte technique')
+    expect(skills1).toContain('## Documentation de référence')
+    expect(skills1).toContain('## Conventions spécifiques')
+  })
+
+  it('context.md contains scope and criterion', async () => {
+    tempDir = await mkdtemp(join(tmpdir(), 'agentkit-test-'))
+    await generateSkills(sampleAgents, tempDir)
+
+    const ctx = await readFile(
+      join(tempDir, 'agents', 'agent-1-infra-setup', 'context.md'),
+      'utf-8',
+    )
+    expect(ctx).toContain('Agent 1 · Infra & Setup')
+    expect(ctx).toContain('scaffolding du projet')
+    expect(ctx).toContain('npm run build')
+    expect(ctx).toContain('package.json')
+  })
+
+  it('generates correct folder name from agent slug', async () => {
+    tempDir = await mkdtemp(join(tmpdir(), 'agentkit-test-'))
+    await generateSkills(sampleAgents, tempDir)
+
+    const skills2 = await readFile(
+      join(tempDir, 'agents', 'agent-2-components', 'skills.md'),
+      'utf-8',
+    )
+    expect(skills2).toContain('Agent 2 · Components')
+  })
+
+  it('handles empty agents list without error', async () => {
+    tempDir = await mkdtemp(join(tmpdir(), 'agentkit-test-'))
+    await expect(generateSkills([], tempDir)).resolves.toBeUndefined()
+  })
+})

package/tests/generators/workflowGenerator.test.ts

@@ -0,0 +1,84 @@
+import { describe, it, expect } from 'vitest'
+import { generateWorkflow } from '../../src/generators/workflowGenerator.js'
+import type { StackInfo } from '../../src/detectors/stackDetector.js'
+
+function makeStack(
+  framework: StackInfo['framework'],
+  opts: Partial<Omit<StackInfo, 'framework'>> = {},
+): StackInfo {
+  return {
+    framework,
+    language: framework === 'fastapi' ? 'python' : opts.hasTypeScript ? 'typescript' : 'javascript',
+    hasTypeScript: opts.hasTypeScript ?? false,
+    extras: opts.extras ?? [],
+    ...opts,
+  }
+}
+
+describe('generateWorkflow', () => {
+  it('returns a non-empty string for every supported framework', () => {
+    const frameworks: StackInfo['framework'][] = [
+      'react', 'nextjs', 'tauri', 'fastapi', 'express', 'node', 'unknown',
+    ]
+    for (const framework of frameworks) {
+      const result = generateWorkflow(makeStack(framework))
+      expect(typeof result).toBe('string')
+      expect(result.length).toBeGreaterThan(0)
+    }
+  })
+
+  it('all outputs start with a markdown heading', () => {
+    const frameworks: StackInfo['framework'][] = [
+      'react', 'nextjs', 'tauri', 'fastapi', 'express', 'node', 'unknown',
+    ]
+    for (const framework of frameworks) {
+      const result = generateWorkflow(makeStack(framework))
+      expect(result.trimStart()).toMatch(/^#/)
+    }
+  })
+
+  it('React — contains Agent sections', () => {
+    const result = generateWorkflow(makeStack('react'))
+    expect(result).toContain('Agent')
+    expect(result).toContain('React')
+  })
+
+  it('React — reflects TypeScript language', () => {
+    const result = generateWorkflow(makeStack('react', { hasTypeScript: true }))
+    expect(result).toContain('TypeScript')
+  })
+
+  it('Next.js — mentions Next.js and Prisma when extra present', () => {
+    const result = generateWorkflow(makeStack('nextjs', { extras: ['prisma'] }))
+    expect(result).toContain('Next.js')
+    expect(result).toContain('Prisma')
+  })
+
+  it('Tauri — mentions Rust and Cargo', () => {
+    const result = generateWorkflow(makeStack('tauri'))
+    expect(result).toContain('Tauri')
+    expect(result).toContain('Rust')
+  })
+
+  it('FastAPI — mentions FastAPI and Python', () => {
+    const result = generateWorkflow(makeStack('fastapi'))
+    expect(result).toContain('FastAPI')
+    expect(result).toContain('Python')
+  })
+
+  it('Express — mentions Express', () => {
+    const result = generateWorkflow(makeStack('express'))
+    expect(result).toContain('Express')
+  })
+
+  it('Node — mentions Node.js', () => {
+    const result = generateWorkflow(makeStack('node'))
+    expect(result).toContain('Node.js')
+  })
+
+  it('unknown — returns a generic fallback', () => {
+    const result = generateWorkflow(makeStack('unknown'))
+    expect(typeof result).toBe('string')
+    expect(result.length).toBeGreaterThan(0)
+  })
+})

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}

package/tsup.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+  entry: ['src/cli.ts'],
+  format: ['esm', 'cjs'],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+  splitting: false,
+  shims: true,
+})

package/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['tests/**/*.test.ts'],
+  },
+})