zelari-code 0.7.9 → 0.7.11

package/dist/agents/skills/builtin/testing.js

@@ -1,245 +0,0 @@
-import { registerCodingSkill } from '../../skills.js';
-const CLARIFICATION_PROTOCOL = `
-
-WHEN TO ASK THE USER (clarification):
-If a single missing fact would materially change your output (target platform, scope, a binary design choice with significant trade-offs, a constraint you cannot safely assume), pause and ask the user by appending EXACTLY this block at the end of your message:
-
----QUESTION---
-{ "question": "One focused question", "choices": ["Option A", "Option B", "Option C"], "context": "Why this matters" }
----END---
-
-Rules for clarifications:
-- Ask AT MOST ONE question per turn, and only when genuinely blocked.
-- Prefer a small set of concrete "choices" (2-4). The user can still type a custom answer.
-- Do NOT ask for information that could be reasonably assumed or already in shared context.
-- If you can proceed with a sound documented assumption, DO SO instead of asking.`;
-const writeUnitTests = {
-    id: 'write-unit-tests',
-    version: '1.0.0',
-    name: 'Write Unit Tests',
-    description: 'TDD-style test generation for a function or module. Output: 5-10 focused unit tests covering happy paths, edge cases (empty/null/boundary), error paths. Each test has one assertion. Uses Vitest patterns (the project standard).',
-    category: 'test',
-    requiredRoles: ['oracle', 'atlas'],
-    requiredTools: ['read_file'],
-    estimatedCost: 'medium',
-    enabledByDefault: true,
-    builtin: true,
-    triggers: [
-        'A function or module has no tests',
-        'Coverage report shows a specific function is untested',
-        'A new utility is added (helper, formatter, validator)',
-        'A bug is fixed and a regression test is needed',
-    ],
-    antiPatterns: [
-        'Integration scenarios (multi-component) — use write-integration-tests',
-        'A bug report exists — use regression-test instead (more focused)',
-        'Performance benchmarks — those need write-bench-test, not unit tests',
-    ],
-    requires: [],
-    relatedSkills: ['regression-test', 'test-coverage-analysis'],
-    tags: ['test', 'unit-test', 'tdd', 'vitest', 'coverage'],
-    examples: [
-        {
-            input: 'Write unit tests for src/lib/formatDuration.ts',
-            output: {
-                testFile: 'tests/unit/formatDuration.test.ts',
-                tests: [
-                    { name: 'formats 0 ms as "0s"', input: 0, expected: '0s' },
-                    { name: 'formats 45 seconds as "45s"', input: 45000, expected: '45s' },
-                    { name: 'formats 1 minute as "1m"', input: 60000, expected: '1m' },
-                    { name: 'formats 1h 23m for long duration', input: 4980000, expected: '1h 23m' },
-                    { name: 'formats 2d for >24h', input: 172800000, expected: '2d' },
-                    { name: 'throws on negative duration', input: -1000, expectedThrows: 'Negative duration' },
-                    { name: 'throws on NaN', input: NaN, expectedThrows: 'NaN duration' },
-                    { name: 'respects compact style option', input: 60000, options: { style: 'compact' }, expected: '1m' },
-                ],
-            },
-        },
-    ],
-    outputSchema: '{ testFile: string; tests: Array<{ name: string; input: unknown; expected?: unknown; options?: Record<string, unknown>; expectedThrows?: string }> }',
-    systemPromptFragment: `You are writing Vitest unit tests for a function or module.
-
-## Methodology
-1. **Read the source**: understand the function signature, branches, error paths.
-2. **Identify happy paths**: at least 2 tests for typical inputs.
-3. **Identify edge cases** (boundaries): 0, 1, max, empty array, empty string.
-4. **Identify error paths**: invalid input, network errors, partial data.
-5. **Write one test per assertion** — easier to debug when a test fails.
-6. **Use Vitest patterns**: describe/it/expect, vi.fn() for mocks, vi.spyOn for stubs.
-
-## Test naming
-- Use \`describe('moduleName', () => { it('does X when Y', ...) })\`.
-- Test name describes behavior, not implementation.
-- Group related tests in the same describe block.
-
-## Output format (JSON-typed)
-- testFile: string (the file path)
-- tests: Array<{ name, input, expected, options?, expectedThrows? }>
-
-## Anti-patterns to avoid
-- Tests that always pass (tautologies)
-- Tests with multiple assertions (split into separate tests)
-- Tests that depend on test execution order
-- Snapshot tests for non-deterministic output
-
-Stay under 500 words.${CLARIFICATION_PROTOCOL}`,
-};
-const writeIntegrationTests = {
-    id: 'write-integration-tests',
-    version: '1.0.0',
-    name: 'Write Integration Tests',
-    description: 'Generate end-to-end scenario tests that span multiple components. Tests verify the integration boundary, not individual units. Uses real subsystems (or close mocks) to catch contract mismatches.',
-    category: 'test',
-    requiredRoles: ['oracle', 'hephaestus'],
-    requiredTools: ['read_file', 'grep_content'],
-    estimatedCost: 'medium',
-    enabledByDefault: true,
-    builtin: true,
-    triggers: [
-        'A new feature spans 2+ modules',
-        'A new API endpoint needs end-to-end coverage',
-        'A refactor changes module boundaries — verify behavior preserved',
-        'A bug was caused by a contract mismatch between two modules',
-    ],
-    antiPatterns: [
-        'Single-component logic — use write-unit-tests',
-        'Performance benchmarks — use a dedicated perf test',
-        'Visual regression (UI snapshot) — needs screenshot diff tooling',
-    ],
-    requires: ['write-unit-tests'],
-    relatedSkills: ['write-unit-tests', 'regression-test'],
-    tags: ['test', 'integration', 'e2e', 'contract', 'multi-component'],
-    examples: [
-        {
-            input: 'Integration test for "user uploads file → RAG indexes → user queries"',
-            output: {
-                testFile: 'tests/integration/upload-query.test.ts',
-                scenarios: [
-                    { name: 'uploaded file appears in search results within 5s', steps: ['create test vault', 'upload doc.md', 'wait 1s for indexer', 'query "doc.md"', 'expect result'] },
-                    { name: 'deleted file removed from search results', steps: ['upload + query (sanity)', 'delete file', 'wait 1s', 'query', 'expect no result'] },
-                    { name: 'concurrent uploads maintain ordering', steps: ['upload 10 files in parallel', 'query each', 'expect all 10 found'] },
-                    { name: 'corrupt file (binary garbage) does not crash indexer', steps: ['upload binary garbage', 'wait 5s', 'expect vault accessible (no crash)'] },
-                ],
-                contracts: [
-                    { between: 'vault + indexer', contract: 'indexer subscribes to vault:created events and processes new files within 5s' },
-                    { between: 'indexer + search', contract: 'search returns docs only after indexer has flushed their embeddings to SQLite' },
-                ],
-            },
-        },
-    ],
-    outputSchema: '{ testFile: string; scenarios: Array<{ name: string; steps: string[] }>; contracts: Array<{ between: string; contract: string }> }',
-    systemPromptFragment: `You are writing integration tests that span multiple components.
-
-## Methodology
-1. **Identify the integration boundary**: which 2+ components interact?
-2. **Document the contract**: what does component A promise to component B?
-3. **Test the contract, not the internals**: verify the OBSERVABLE behavior, not the implementation.
-4. **Use real subsystems where possible**: in-memory SQLite instead of mocks; fake HTTP server instead of stubbed client.
-5. **Each scenario is a complete user story**: setup → action → verify.
-
-## Output format (JSON-typed)
-- testFile: string
-- scenarios: Array<{ name, steps[] }>
-- contracts: Array<{ between, contract }>
-
-## Integration test principles
-- **Minimal mocks**: mock only the OUTSIDE world (network, disk, time), not your own code
-- **Real data**: use realistic test data, not "foo" / "bar"
-- **Deterministic**: avoid timing-based assertions (use polling with timeout)
-- **Cleanup**: each scenario should leave the system in a clean state
-
-Stay under 500 words.${CLARIFICATION_PROTOCOL}`,
-};
-const regressionTest = {
-    id: 'regression-test',
-    version: '1.0.0',
-    name: 'Regression Test',
-    description: 'Convert a bug report into a permanent regression test. The test must fail on the BUGGY code (pre-fix), pass on the FIXED code (post-fix), and stay in the suite forever to prevent the bug from coming back.',
-    category: 'test',
-    requiredRoles: ['oracle'],
-    requiredTools: ['write_file'],
-    estimatedCost: 'low',
-    enabledByDefault: true,
-    builtin: true,
-    triggers: [
-        'A bug is fixed and a regression test is needed',
-        'A user reports a recurring bug ("this used to work")',
-        'A flaky test that intermittently fails',
-        'A bug found in code review',
-    ],
-    antiPatterns: [
-        'The bug has not been fixed yet — first fix, then add regression test',
-        'The bug is in test code itself — fix the test',
-        'A bug that requires impossible-to-mock state (real network, real browser)',
-    ],
-    requires: [],
-    relatedSkills: ['write-unit-tests', 'reproduce-bug'],
-    tags: ['test', 'regression', 'bug-fix', 'permanent-test'],
-    examples: [
-        {
-            input: 'Bug: "Council shows duplicate user message at session resume" was just fixed in commit a3f9d',
-            output: {
-                testFile: 'tests/regression/duplicate-user-message.test.ts',
-                test: `import { describe, it, expect } from 'vitest';
-import { runCouncilPure } from '../agents/councilApi';
-
-describe('regression: duplicate user message at session resume', () => {
-  it('does not render duplicate user message when session resumes with duplicate input', async () => {
-    const messages = [
-      { role: 'user' as const, content: 'hi' },
-      { role: 'user' as const, content: 'hi' }, // duplicate from session resume
-    ];
-    const mockProvider = async function* () {
-      yield { kind: 'text' as const, delta: 'response' };
-      yield { kind: 'finish' as const, reason: 'stop' };
-    };
-    const events = [];
-    for await (const e of runCouncilPure('hi', {
-      model: 'test', provider: 'test',
-      messages,
-      tools: [],
-      councilSize: 1,
-      debateMode: false,
-      ragContext: '',
-      workspaceContext: '',
-      providerStream: mockProvider,
-    }, {})) {
-      events.push(e);
-    }
-    const userMessageDeltas = events.filter(e => e.type === 'message_delta').length;
-    expect(userMessageDeltas).toBe(1); // exactly 1, not 2
-  });
-});`,
-                whyRegression: 'Bug was reported 3 times in the last month. The fix (dedup user messages on session resume) was in commit a3f9d. This test guards against future refactors breaking the dedup logic.',
-                bugCommit: 'a3f9d',
-            },
-        },
-    ],
-    outputSchema: '{ testFile: string; test: string; whyRegression: string; bugCommit: string }',
-    systemPromptFragment: `You are converting a fixed bug into a permanent regression test.
-
-## Methodology
-1. **Confirm the bug is FIXED**: check git log / recent commits for the fix.
-2. **Write the test**: it should FAIL if you revert the fix (verify this mentally).
-3. **Add a comment** in the test file linking to the bug commit.
-4. **Place in tests/regression/**: separate from unit tests for visibility.
-
-## Output format (JSON-typed)
-- testFile: string
-- test: string (the full test code, runnable as-is)
-- whyRegression: string (why this test should stay forever)
-- bugCommit: string (the commit hash that fixed the bug)
-
-## Regression test principles
-- **One test per bug** — easier to identify which regression fired
-- **Reference the bug commit** in a comment so future devs understand the history
-- **Minimal repro** — strip to the essential trigger, don't include unrelated setup
-- **Never delete a regression test** without a written justification (the bug came back once, it'll come back again)
-
-Stay under 300 words.${CLARIFICATION_PROTOCOL}`,
-};
-// Register in topological order
-registerCodingSkill(writeUnitTests);
-registerCodingSkill(writeIntegrationTests);
-registerCodingSkill(regressionTest);
-//# sourceMappingURL=testing.js.map

package/dist/agents/skills/builtin/testing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../../src/agents/skills/builtin/testing.ts"],"names":[],"mappings":"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"}

package/dist/agents/skills.js

@@ -1,272 +0,0 @@
-export const CODING_CATEGORY = {
-    PLANNING: 'planning',
-    REFACTOR: 'refactor',
-    DEBUG: 'debug',
-    REVIEW: 'review',
-    TEST: 'test',
-    DOCS: 'docs',
-    OPS: 'ops',
-    GIT: 'git',
-    DB: 'db',
-    MAINT: 'maint',
-};
-/**
- * Skill catalog — packages of capability assignable to agents.
- *
- * Each skill injects a systemPromptFragment into the agent's prompt and
- * declares the tools it requires.
- */
-export const SKILL_CATALOG = [
-    {
-        id: 'vault-manager',
-        version: '1.0.0',
-        tags: ['knowledge', 'vault', 'notes'],
-        relatedSkills: ['document-writer'],
-        name: 'Vault Manager',
-        description: 'Create, edit, search and link markdown documents in the Knowledge Vault using [[wikilinks]], #tags and YAML frontmatter.',
-        category: 'vault',
-        color: '#3b82f6',
-        enabledByDefault: true,
-        builtin: true,
-        requiredTools: ['createDocument', 'updateDocument', 'searchDocuments', 'linkDocuments'],
-        systemPromptFragment: `You can manage the Knowledge Vault directly.
-- Documents are markdown files with a path (e.g. "notes/architecture"), title, content, tags, and optional category.
-- Connect documents with [[wikilinks]]: write [[target]] or [[target|alias]] inside the content.
-- Add #hashtags anywhere in the content to tag a document.
-- Optional YAML frontmatter may precede the body (key: value lines wrapped in ---).
-- Prefer creating durable notes over answering in chat when the information is reusable.`,
-    },
-    {
-        id: 'project-planner',
-        version: '1.0.0',
-        tags: ['planning', 'project', 'tasks'],
-        relatedSkills: [],
-        name: 'Project Planner',
-        description: 'Structured project planning with phases, tasks, subtasks, dependencies and milestones.',
-        category: 'project',
-        color: '#10b981',
-        enabledByDefault: true,
-        builtin: true,
-        requiredTools: ['createTask', 'createPhase', 'createMilestone', 'updateTask'],
-        systemPromptFragment: `You plan projects hierarchically.
-- Decompose work into phases, then tasks within phases.
-- For each task include: title, description, priority (low|medium|high|critical), and optional tags/subtasks.
-- Define milestones to mark key deliverables.
-- When relevant, reference file paths and acceptance criteria.`,
-    },
-    {
-        id: 'idea-synthesizer',
-        version: '1.0.0',
-        tags: ['ideation', 'creativity'],
-        relatedSkills: [],
-        name: 'Idea Synthesizer',
-        description: 'Generate, cluster and evaluate creative ideas using divergent thinking.',
-        category: 'ideas',
-        color: '#f59e0b',
-        enabledByDefault: true,
-        builtin: true,
-        requiredTools: ['addIdea', 'clusterIdeas'],
-        systemPromptFragment: `You generate and organize ideas.
-- Produce a diverse set of ideas, then cluster related ones.
-- Tag ideas consistently and assign a category.
-- Evaluate feasibility and novelty briefly.`,
-    },
-    {
-        id: 'mind-mapper',
-        version: '1.0.0',
-        tags: ['knowledge', 'graph', 'visualization'],
-        relatedSkills: [],
-        name: 'Mind Mapper',
-        description: 'Build structured mind maps (root → branches → leaves) and connect them to vault documents.',
-        category: 'mindmap',
-        color: '#06b6d4',
-        enabledByDefault: false,
-        builtin: true,
-        requiredTools: ['buildMindMap', 'addNode', 'linkNodes', 'createMindMapNode'],
-        systemPromptFragment: `You build mind maps as JSON structures.
-- Root → branches → leaves.
-- Each node has a label and short content.
-- Use semantic colors and connect nodes that relate to vault documents.`,
-    },
-    {
-        id: 'research-analyst',
-        version: '1.0.0',
-        tags: ['research', 'rag', 'analysis'],
-        relatedSkills: [],
-        name: 'Research Analyst',
-        description: 'Query the RAG knowledge base, synthesize findings and cite sources.',
-        category: 'analysis',
-        color: '#a855f7',
-        enabledByDefault: true,
-        builtin: true,
-        requiredTools: ['searchRAG', 'searchDocuments'],
-        systemPromptFragment: `You research using the retrieval system.
-- Use searchRAG / searchDocuments to find relevant prior knowledge before answering.
-- Cite sources by title when you rely on retrieved content.
-- Structure analyses with clear sections and a conclusion.`,
-    },
-    {
-        id: 'document-writer',
-        version: '1.0.0',
-        tags: ['writing', 'documentation'],
-        relatedSkills: [],
-        name: 'Document Writer',
-        description: 'Write high-quality technical or narrative documents into the vault.',
-        category: 'writing',
-        color: '#ec4899',
-        enabledByDefault: false,
-        builtin: true,
-        requiredTools: ['createDocument', 'updateDocument'],
-        systemPromptFragment: `You write polished documents.
-- Choose an appropriate structure (guide, spec, reference, narrative).
-- Maintain a consistent tone and voice.
-- Use headings, lists, and code blocks where helpful; link related notes with [[wikilinks]].`,
-    },
-];
-/** Default skill assignments per agent id. */
-const DEFAULT_AGENT_SKILLS = {
-    sisyphus: ['project-planner', 'research-analyst'],
-    prometheus: ['project-planner', 'vault-manager'],
-    hephaestus: ['idea-synthesizer', 'mind-mapper', 'document-writer'],
-    atlas: ['mind-mapper', 'research-analyst'],
-    oracle: ['research-analyst'],
-    chairman: ['vault-manager', 'project-planner', 'idea-synthesizer'],
-};
-/** Get all skills in a given category. */
-export function getSkillsByCategory(cat) {
-    return SKILL_CATALOG.filter((s) => s.category === cat);
-}
-/** Get a skill by id. */
-export function getSkillById(id) {
-    return SKILL_CATALOG.find((s) => s.id === id);
-}
-/**
- * Resolve the default skills for an agent.
- * Custom/user-defined agents default to an empty set (configured via UI).
- */
-export function resolveAgentSkills(agentId) {
-    const ids = DEFAULT_AGENT_SKILLS[agentId] ?? [];
-    return ids
-        .map((id) => getSkillById(id))
-        .filter((s) => s !== undefined);
-}
-/** All builtin skill ids (useful for the settings UI). */
-export function getBuiltinSkillIds() {
-    return SKILL_CATALOG.filter((s) => s.builtin).map((s) => s.id);
-}
-/**
- * List all skills (built-in + custom). Returns a fresh array — safe to mutate.
- * Uses SkillMetadata type.
- */
-export function listSkills() {
-    return [...SKILL_CATALOG];
-}
-/**
- * Get a skill by ID, returned as SkillMetadata.
- * Returns undefined if not found.
- */
-export function getSkillMetadata(id) {
-    return SKILL_CATALOG.find((s) => s.id === id);
-}
-/**
- * Register a custom skill (user-defined or MCP-discovered). If a skill
- * with the same id already exists, it is replaced.
- */
-export function registerSkill(skill) {
-    const idx = SKILL_CATALOG.findIndex((s) => s.id === skill.id);
-    if (idx >= 0) {
-        SKILL_CATALOG[idx] = skill;
-    }
-    else {
-        SKILL_CATALOG.push(skill);
-    }
-}
-/**
- * Remove a skill by ID. Returns true if removed, false if not found.
- * Built-in skills (skill.builtin === true) cannot be removed.
- */
-export function unregisterSkill(id) {
-    const skill = SKILL_CATALOG.find((s) => s.id === id);
-    if (!skill)
-        return false;
-    if (skill.builtin)
-        return false;
-    const idx = SKILL_CATALOG.indexOf(skill);
-    SKILL_CATALOG.splice(idx, 1);
-    return true;
-}
-/**
- * Find all skills matching a tag (exact match).
- */
-export function findSkillsByTag(tag) {
-    return SKILL_CATALOG.filter((s) => s.tags?.includes(tag));
-}
-/**
- * Find all skills matching any of the given IDs.
- * Unknown IDs are silently skipped.
- */
-export function findSkillsByIds(ids) {
-    const idSet = new Set(ids);
-    return SKILL_CATALOG.filter((s) => idSet.has(s.id));
-}
-/**
- * Resolve skill dependencies in topological order. Returns empty array
- * if a dependency is missing (caller should handle gracefully).
- */
-export function resolveSkillDependencies(id) {
-    const start = SKILL_CATALOG.find((s) => s.id === id);
-    if (!start)
-        return [];
-    // Skills currently have no 'requires' field, so topological sort is trivial.
-    return [start];
-}
-/** Empty catalog of coding skills — populated by Task 13.4. */
-export const CODING_SKILL_CATALOG = [];
-/** List all coding skills (fresh array). */
-export function listCodingSkills() {
-    return [...CODING_SKILL_CATALOG];
-}
-/** Get a coding skill by id. */
-export function getCodingSkillById(id) {
-    return CODING_SKILL_CATALOG.find((s) => s.id === id);
-}
-/** Find all coding skills in a category. */
-export function findCodingSkillsByCategory(category) {
-    return CODING_SKILL_CATALOG.filter((s) => s.category === category);
-}
-/** Find all coding skills matching a tag. */
-export function findCodingSkillsByTag(tag) {
-    return CODING_SKILL_CATALOG.filter((s) => s.tags.includes(tag));
-}
-/**
- * Validate that all `requires` references point to existing skill IDs.
- * Returns an array of error messages (empty = valid).
- *
- * Note: This is a runtime check. Compile-time validation requires the
- * TypeScript type to express the cross-reference; we use a manual
- * registration API that throws on invalid requires.
- */
-export function validateCodingSkillRequires(skill) {
-    const errors = [];
-    for (const reqId of skill.requires) {
-        if (!CODING_SKILL_CATALOG.some((s) => s.id === reqId)) {
-            errors.push(`Skill "${skill.id}" requires unknown skill "${reqId}"`);
-        }
-    }
-    return errors;
-}
-/** Register a coding skill (called by Task 13.4 when populating the catalog). */
-export function registerCodingSkill(skill) {
-    const errors = validateCodingSkillRequires(skill);
-    if (errors.length > 0) {
-        throw new Error(`Cannot register coding skill: ${errors.join('; ')}`);
-    }
-    const idx = CODING_SKILL_CATALOG.findIndex((s) => s.id === skill.id);
-    if (idx >= 0) {
-        CODING_SKILL_CATALOG[idx] = skill;
-    }
-    else {
-        CODING_SKILL_CATALOG.push(skill);
-    }
-}
-//# sourceMappingURL=skills.js.map

package/dist/agents/skills.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/agents/skills.ts"],"names":[],"mappings":"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"}