zelari-code 0.7.9 → 0.7.11

package/dist/agents/roles.js.map

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

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

@@ -1,248 +0,0 @@
-import * as skillsModule 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 wave-in response.
-- 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 reproduceBug = {
-    id: 'reproduce-bug',
-    version: '1.0.0',
-    name: 'Reproduce Bug',
-    description: 'Convert a bug report into a MINIMAL failing test. The test must fail without any code changes, then pass after the fix.',
-    category: 'debug',
-    requiredRoles: ['oracle', 'atlas'],
-    requiredTools: ['read_file', 'write_file'],
-    estimatedCost: 'medium',
-    enabledByDefault: true,
-    builtin: true,
-    triggers: [
-        'Bug report without a minimal reproduction',
-        'Bug that only happens in production (not in tests)',
-        'Bug that happens "sometimes" (intermittent)',
-        'Bug reported via screenshot or video, not repro steps',
-        'A complex multi-agent state race condition that is hard to verify without a test',
-    ],
-    antiPatterns: [
-        'Bug is in production AND has minimal repro steps already — skip to fix',
-        'Bug is in test code itself — fix the test, not the production code',
-        'Bug requires special hardware/network state — use a mock instead',
-    ],
-    requires: [],
-    relatedSkills: ['debug-with-rag', 'root-cause-five-whys'],
-    tags: ['debug', 'reproduction', 'test', 'minimal-example'],
-    examples: [
-        {
-            input: 'Bug report: "Council sometimes shows duplicate messages at the start of a session"',
-            output: {
-                minimalRepro: `// tests/regression/duplicate-messages.test.ts
-import { runCouncilPure } from '../agents/councilApi';
-
-describe('council duplicate message bug', () => {
-  it('does not emit duplicate user message when session resumes', async () => {
-    const mockProvider = async function* () {
-      yield { kind: 'text', delta: 'first' };
-      yield { kind: 'finish', reason: 'stop' };
-    };
-    const harness = new AgentHarness({
-      model: 'test', provider: 'test',
-      messages: [
-        { role: 'user', content: 'hi' },
-        { role: 'user', content: 'hi' }, // duplicate from session resume
-      ],
-      tools: [],
-      providerStream: mockProvider,
-    });
-    const events = [];
-    for await (const e of harness.run()) events.push(e);
-    const userMessages = events.filter(e => e.type === 'message_delta').length;
-    expect(userMessages).toBeGreaterThan(0); // sanity
-    // The actual bug: duplicate is rendered twice
-    // After fix, expect exactly 1 user message rendered
-  });
-});`,
-                reproSteps: [
-                    '1. Set up session with duplicate user message in transcript',
-                    '2. Run runCouncilPure',
-                    '3. Observe duplicate message in output',
-                ],
-                whyMinimal: 'Removed all agents except the first specialist (was: sisyphus+prometheus+hephaestus+oracle+chairman). Removed RAG context, workspace context. Kept only the duplication pattern.',
-            },
-        },
-    ],
-    outputSchema: '{ minimalRepro: string; reproSteps: string[]; whyMinimal: string }',
-    systemPromptFragment: `You are converting a bug report into a minimal failing test.
-
-## Methodology
-1. **Read the bug report** carefully: what's the exact symptom? When does it happen?
-2. **Strip to essentials**: remove every agent, tool, env var, user state that isn't strictly required.
-3. **Identify the trigger**: what ONE input causes the bug?
-4. **Write the failing test**: it must FAIL on the current (buggy) code.
-5. **Verify it fails**: the test must fail without any code changes.
-6. **After the fix lands**, the test must PASS.
-
-## Output format (JSON-typed)
-- minimalRepro: string (the test code, runnable as-is)
-- reproSteps: string[] (3-7 numbered steps to reproduce manually)
-- whyMinimal: string (what you stripped + why)
-
-## Minimal-repro principles
-- **One assertion per test** — easier to debug when the test fails
-- **Deterministic** — no flaky timing, no random data
-- **No external dependencies** — use mocks for network/DB
-- **Fast** — under 100ms if possible
-- **Independent** — doesn't depend on other tests' state
-
-Stay under 300 words.${CLARIFICATION_PROTOCOL}`,
-};
-const debugWithRag = {
-    id: 'debug-with-rag',
-    version: '1.0.0',
-    name: 'Debug With RAG',
-    description: 'Search the knowledge base for similar past bugs, read the stack trace, propose the most likely root cause and a concrete fix.',
-    category: 'debug',
-    requiredRoles: ['oracle', 'atlas'],
-    requiredTools: ['searchRAG', 'grep_content', 'read_file'],
-    estimatedCost: 'medium',
-    enabledByDefault: true,
-    builtin: true,
-    triggers: [
-        'A bug report with a stack trace or error message',
-        'A regression: feature worked before, now broken',
-        'A flaky test that fails intermittently',
-        'Performance regression: response time > 5s where it used to be < 500ms',
-        'A memory leak causing out-of-memory crashes',
-    ],
-    antiPatterns: [
-        'Bug is obvious from the error message (e.g. TypeError: cannot read property of undefined — fix directly)',
-        'No stack trace or repro steps — first ask the user for a minimal repro',
-        'A test is failing because the test itself is wrong — debug the test, not the code',
-    ],
-    requires: ['reproduce-bug'],
-    relatedSkills: ['root-cause-five-whys', 'reproduce-bug'],
-    tags: ['debug', 'rag', 'stack-trace', 'root-cause', 'regression'],
-    examples: [
-        {
-            input: 'TypeError: Cannot read properties of undefined (reading "map") at Council.tsx:847',
-            output: {
-                ragSearch: 'searchRAG(query="Council.tsx undefined map error") returned 2 prior incidents: similar bug fixed in commit a3f9d by adding optional chaining; another similar issue in Council.tsx:612.',
-                stackTraceAnalysis: 'Line 847 is inside `renderMessages()`. The most likely cause: `messages` is undefined when `runCouncilPure()` returns early on the first iteration before any agent has produced output.',
-                rootCause: 'race condition: messages array is set after the first agent completes, but renderMessages() is called during the loading state when messages is still undefined.',
-                proposedFix: `function renderMessages() {
-  const messages = session.messages ?? [];
-  return messages.map(m => <Message key={m.id} {...m} />);
-}`,
-                verification: 'Add a unit test that calls renderMessages() with messages=undefined and expects [] (not crash). Manual: trigger the bug scenario, confirm no crash.',
-            },
-        },
-    ],
-    outputSchema: '{ ragSearch: string; stackTraceAnalysis: string; rootCause: string; proposedFix: string; verification: string }',
-    systemPromptFragment: `You are debugging a bug using the knowledge base.
-
-## Methodology
-1. **Extract key terms** from the error message + stack trace (file names, function names, error type).
-2. **Search the knowledge base**: searchRAG(query="<key terms>")
-3. **Read the relevant files**: use read_file with line ranges from the stack trace.
-4. **Identify the root cause**: what's the actual logic error? Don't just fix the symptom.
-5. **Propose a minimal fix**: the SMALLEST change that addresses the root cause.
-6. **Specify verification**: how to confirm the fix works (test case + manual steps).
-
-## Output format (JSON-typed)
-- ragSearch: string (what you searched + what you found)
-- stackTraceAnalysis: string (which line + what's likely happening)
-- rootCause: string (the actual bug, not the symptom)
-- proposedFix: string (code snippet)
-- verification: string (test + manual steps)
-
-## Debugging principles
-- **Fix the cause, not the symptom** (e.g. don't add a try/catch to silence an error)
-- **Minimal change** — don't refactor surrounding code while debugging
-- **One hypothesis at a time** — don't list 5 possible causes
-- **Verify the fix actually fixes** — write a failing test BEFORE the fix
-
-Stay under 400 words.${CLARIFICATION_PROTOCOL}`,
-};
-const rootCauseFiveWhys = {
-    id: 'root-cause-five-whys',
-    version: '1.0.0',
-    name: 'Root Cause Five Whys',
-    description: 'Apply iterative 5-whys analysis with council consensus. Drill down through 5 levels of "why" to find the systemic root cause, not just the proximate trigger.',
-    category: 'debug',
-    requiredRoles: ['sisyphus', 'oracle', 'chairman'],
-    requiredTools: ['searchRAG', 'read_file'],
-    estimatedCost: 'high',
-    enabledByDefault: true,
-    builtin: true,
-    triggers: [
-        'A bug that keeps recurring after fixes ("whack-a-mole" symptom)',
-        'A systemic issue affecting multiple files/modules',
-        'A post-mortem on a production incident',
-        'Process issues (not just code) — why does the team keep making the same mistake?',
-        'Frequent merge failures or regression patterns in a single week',
-    ],
-    antiPatterns: [
-        'A trivial bug with obvious cause — just fix it directly',
-        'A user error (bad input) — the system should validate, not the user change behavior',
-        'A flaky test — fix the test, not the underlying system',
-    ],
-    requires: ['debug-with-rag'],
-    relatedSkills: ['debug-with-rag', 'reproduce-bug'],
-    tags: ['debug', 'root-cause', 'systemic', 'postmortem', 'five-whys'],
-    examples: [
-        {
-            input: 'Production incident: 3 outages in 2 weeks, all caused by the same API rate limit hit',
-            output: {
-                whys: [
-                    { level: 1, question: 'Why did the service go down?', answer: 'The MiniMax API returned 429 Too Many Requests at peak load.' },
-                    { level: 2, question: 'Why did we hit the rate limit?', answer: 'We made 200 requests/minute; the limit is 100/minute.' },
-                    { level: 3, question: 'Why did we exceed the rate limit?', answer: 'A single user request triggered 200 sub-requests for parallel tool calls.' },
-                    { level: 4, question: 'Why did one request trigger 200 sub-requests?', answer: 'The agent loop calls all tools in parallel without batching.' },
-                    { level: 5, question: 'Why don\'t we batch tool calls?', answer: 'No rate limiter in the agent loop. The team assumed the API limit was high enough.' },
-                ],
-                rootCause: 'No client-side rate limiting. The agent loop fires parallel tool calls without backoff or batching.',
-                systemicFix: 'Add a token-bucket rate limiter (100 req/min) before the API client. Implement batching for independent tool calls. Add a circuit breaker that pauses on 429 responses.',
-                processFix: 'Add a pre-deploy load test that runs 1000 concurrent requests and verifies rate-limit handling.',
-                councilConsensus: 'Chairman: "All three council members agree on the systemic root cause. The process fix is as important as the code fix — load tests should be CI-required."',
-            },
-        },
-    ],
-    outputSchema: '{ whys: Array<{ level: number; question: string; answer: string }>; rootCause: string; systemicFix: string; processFix: string; councilConsensus: string }',
-    systemPromptFragment: `You are applying the 5-whys technique with council consensus.
-
-## Methodology
-1. **State the symptom** as the starting point for "why?"
-2. **Ask "why?" 5 times**, drilling down through layers of cause
-3. **Each answer must be FACTUAL**, not speculative
-4. **At the 5th why**, you've reached the systemic root cause
-5. **Propose TWO fixes**: systemic (code/architecture) + process (team/workflow)
-6. **Get council consensus**: chairman summarizes agreement from sisyphus (orchestrator) and oracle (analyst)
-
-## Output format (JSON-typed)
-- whys: Array<{ level: number; question: string; answer: string }>
-- rootCause: string (the deepest why)
-- systemicFix: string (code/architecture change)
-- processFix: string (team/workflow change)
-- councilConsensus: string (chairman's summary of agreement)
-
-## Anti-patterns to avoid
-- **"Human error"** is NEVER the root cause — the system should make the error impossible
-- **"Lack of training"** is NEVER the root cause — automation + checklists > training
-- **"Not enough time"** is NEVER the root cause — find the constraint, not the excuse
-- Stop at the FIRST level if it's a trivial bug — don't overthink simple cases
-
-Stay under 500 words.${CLARIFICATION_PROTOCOL}`,
-};
-// prettier-ignore
-const registerCodingSkill = skillsModule['register' + 'Coding' + 'Skill'];
-registerCodingSkill(reproduceBug);
-registerCodingSkill(debugWithRag);
-registerCodingSkill(rootCauseFiveWhys);
-//# sourceMappingURL=debugging.js.map

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

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

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

@@ -1,301 +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 writeReadme = {
-    id: 'write-readme',
-    version: '1.0.0',
-    name: 'Write README',
-    description: 'Generate a project README from the codebase. Sections: Title, Badges, Description, Quick Start, Architecture, Development, Testing, Deployment, Contributing, License.',
-    category: 'docs',
-    requiredRoles: ['prometheus', 'atlas'],
-    requiredTools: ['read_file', 'grep_content'],
-    estimatedCost: 'medium',
-    enabledByDefault: true,
-    builtin: true,
-    triggers: [
-        'A new project is being created',
-        'Existing README is missing or stale',
-        'A project is being open-sourced',
-        'Onboarding new team members (they read the README first)',
-    ],
-    antiPatterns: [
-        'README exists and is recent — update instead of regenerate',
-        'Personal/internal project (README rarely matters)',
-        'Library with auto-generated docs from source code comments',
-    ],
-    requires: [],
-    relatedSkills: ['write-tsdoc', 'write-changelog'],
-    tags: ['docs', 'readme', 'onboarding', 'open-source'],
-    examples: [
-        {
-            input: 'Generate README for AnathemaBrain (Electron + React + TypeScript AI agent platform)',
-            output: {
-                readme: `# AnathemaBrain
-
-> An educational Python project for learning how coding agents are built.
-
-AnathemaBrain is an Electron desktop app... (truncated)
-
-## Quick Start
-
-\`\`\`bash
-npm install
-npm run dev
-\`\`\`
-
-## Architecture
-
-- **Main process** (electron/main/): Node.js, IPC handlers, LLM streaming
-- **Renderer** (src/): React 19 UI, Zustand stores
-- **Agent system** (src/agents/): Council multi-agent orchestration
-
-## Development
-
-\`\`\`bash
-npm run typecheck
-npm run test
-npm run lint
-\`\`\`
-
-## Testing
-
-96+ tests via Vitest + jsdom.
-
-## Deployment
-
-\`\`\`bash
-npm run build
-npm run electron:build
-\`\`\`
-
-## Contributing
-
-See docs/plans/ for active roadmaps. Pull requests welcome.
-
-## License
-
-Apache 2.0
-`,
-                sections: ['Title + tagline', 'Badges', 'Description', 'Quick Start', 'Architecture diagram', 'Development commands', 'Testing', 'Deployment', 'Contributing link', 'License'],
-            },
-        },
-    ],
-    outputSchema: '{ readme: string; sections: string[] }',
-    systemPromptFragment: `You are writing a project README.md.
-
-## Required sections (in order)
-1. **Title + tagline** (1 sentence): what is this project?
-2. **Badges** (optional): CI status, npm version, license
-3. **Description** (2-3 paragraphs): what does it do, who is it for
-4. **Quick Start** (5-10 lines): install + run + see something working
-5. **Architecture** (1-2 paragraphs + diagram): high-level structure
-6. **Development** (commands): how to run tests, typecheck, lint
-7. **Testing**: what kind of tests exist, how to run them
-8. **Deployment** (if applicable): how to build + ship
-9. **Contributing**: link to CONTRIBUTING.md or describe PR process
-10. **License**: license type
-
-## Output format (JSON-typed)
-- readme: string (the full README content in markdown)
-- sections: string[] (the sections you included)
-
-## README principles
-- **Show, don't tell**: code examples for non-trivial concepts
-- **Up-to-date**: don't include commands that don't work
-- **Scannable**: use headers, bullets, code blocks
-- **One page max**: link to deeper docs rather than nesting everything
-
-Stay under 600 words.${CLARIFICATION_PROTOCOL}`,
-};
-const writeTsdoc = {
-    id: 'write-tsdoc',
-    version: '1.0.0',
-    name: 'Write TSDoc',
-    description: 'Generate TSDoc/JSDoc comments for undocumented exports. Output: docstrings with @param, @returns, @throws, @example tags following the TSDoc standard.',
-    category: 'docs',
-    requiredRoles: ['atlas'],
-    requiredTools: ['read_file'],
-    estimatedCost: 'low',
-    enabledByDefault: true,
-    builtin: true,
-    triggers: [
-        'A function or class lacks documentation',
-        'A public API is exported without TSDoc',
-        'IDE intellisense shows "any" or missing info for a function',
-        'A new utility is added to a shared library',
-    ],
-    antiPatterns: [
-        'The function is private/internal — no need for TSDoc',
-        'Auto-generated docs already exist (typedoc, etc.)',
-        'The function is self-explanatory (getName → returns name)',
-    ],
-    requires: [],
-    relatedSkills: ['write-readme'],
-    tags: ['docs', 'tsdoc', 'jsdoc', 'intellisense', 'api-docs'],
-    examples: [
-        {
-            input: 'Add TSDoc to src/lib/formatDuration.ts',
-            output: {
-                documented: `/**
- * Formats a duration in milliseconds as a human-readable string.
- *
- * @param ms - Duration in milliseconds. Must be a non-negative finite number.
- * @param opts - Formatting options.
- * @param opts.style - 'compact' (1h 23m), 'full' (1:23:45), or 'minimal' (23m).
- *   Defaults to 'compact'.
- * @returns The formatted duration string.
- * @throws {RangeError} If ms is negative.
- * @throws {TypeError} If ms is NaN or Infinity.
- *
- * @example
- *   formatDuration(4980000);                       // '1h 23m'
- *   formatDuration(4980000, { style: 'full' });    // '1:23:45'
- *   formatDuration(60000, { style: 'minimal' });   // '1m'
- */
-export function formatDuration(ms: number, opts?: { style?: 'compact' | 'full' | 'minimal' }): string {
-  // ... existing implementation
-}`,
-                tagsAdded: ['@param', '@param (nested)', '@returns', '@throws x2', '@example'],
-            },
-        },
-    ],
-    outputSchema: '{ documented: string; tagsAdded: string[] }',
-    systemPromptFragment: `You are writing TSDoc comments for a TypeScript function or class.
-
-## TSDoc tags (use these)
-- \`@param {type} name - description\` — for each parameter
-- \`@returns description\` (or \`@return\` legacy alias)
-- \`@throws {ErrorType} condition\` — for each throw path
-- \`@example\` followed by code block (for non-trivial usage)
-- \`@deprecated reason\` — if the function is being phased out
-- \`@see FunctionName\` — for cross-references
-- \`@remarks\` — additional context
-- \`@internal\` — for internal helpers (suppresses from public docs)
-
-## Output format (JSON-typed)
-- documented: string (the full code block with TSDoc added)
-- tagsAdded: string[] (which tags you included)
-
-## TSDoc principles
-- **First sentence is the summary**: ends with a period, capital letter
-- **One @param per parameter**: don't omit even if obvious
-- **@throws for EVERY throw path**: callers need to know
-- **@example for non-trivial usage**: best way to communicate intent
-- **No marketing language**: just describe what the function does
-- **No implementation details**: TSDoc is for the API contract, not internals
-
-Stay under 400 words.${CLARIFICATION_PROTOCOL}`,
-};
-const writeChangelog = {
-    id: 'write-changelog',
-    version: '1.0.0',
-    name: 'Write Changelog',
-    description: 'Generate a CHANGELOG.md entry from git history. Follows Keep a Changelog format with sections: Added, Changed, Deprecated, Removed, Fixed, Security. Groups commits by category, deduplicates, writes user-facing descriptions.',
-    category: 'docs',
-    requiredRoles: ['atlas'],
-    requiredTools: [],
-    estimatedCost: 'low',
-    enabledByDefault: true,
-    builtin: true,
-    triggers: [
-        'A release is being prepared',
-        'A sprint/iteration ends',
-        'Significant changes have accumulated since the last entry',
-        'A user-visible breaking change happened',
-    ],
-    antiPatterns: [
-        'No commits since the last changelog entry — skip',
-        'Internal refactors with no user impact — exclude',
-        'Doc-only changes — mention briefly in "Changed" or skip',
-    ],
-    requires: [],
-    relatedSkills: ['write-readme', 'write-tsdoc'],
-    tags: ['docs', 'changelog', 'release-notes', 'keep-a-changelog'],
-    examples: [
-        {
-            input: 'Generate changelog for v0.2.0 from commits since v0.1.0 (last 30 commits)',
-            output: {
-                changelog: `# Changelog
-
-All notable changes to AnathemaBrain are documented in this file.
-
-## [0.2.0] - 2026-06-28
-
-### Added
-- **BrainEvent provider-neutral types** (Phase 11): 12 discriminated union events for agent lifecycle, message streaming, tool execution, errors
-- **EventBus**: typed in-memory pub/sub with error isolation
-- **AgentHarness**: pure agent loop yielding AsyncIterable<BrainEvent>
-- **runCouncilPure()**: council orchestration without window.electronAPI dependency
-- **5 built-in coding tools**: read_file, write_file, edit_file, bash, grep_content
-- **14 senior-grade coding skills** across 4 categories (Planning, Refactoring, Debugging, Review)
-
-### Changed
-- LLM streaming now emits BrainEvents alongside the IPC bridge (renderer unchanged)
-- Agent system refactored to use AgentHarness as the loop driver
-
-### Fixed
-- Council event timing: agent_start/agent_end now emit at correct boundaries
-- Tool execution start events fire when provider yields tool_call deltas
-
-### Security
-- Grok OAuth token refresh now respects rate limits (fixed race condition)
-
-[0.1.0] - 2026-06-01
-... (previous entries)
-`,
-                sectionsUsed: ['Added', 'Changed', 'Fixed', 'Security'],
-                commitsProcessed: 30,
-            },
-        },
-    ],
-    outputSchema: '{ changelog: string; sectionsUsed: string[]; commitsProcessed: number }',
-    systemPromptFragment: `You are writing a CHANGELOG.md entry from git history.
-
-## Keep a Changelog format
-Sections (use only those with content):
-- **Added** — new features
-- **Changed** — changes in existing functionality
-- **Deprecated** — soon-to-be removed features
-- **Removed** — now removed features
-- **Fixed** — bug fixes
-- **Security** — vulnerability fixes
-
-## Methodology
-1. **List commits since the last release** (use git log).
-2. **Categorize each commit** into the right section.
-3. **Translate to user-facing language**: "feat: add event bus" → "EventBus: typed in-memory pub/sub".
-4. **Group related commits**: if 5 commits all touch the event system, write ONE entry.
-5. **Skip internal-only changes**: refactors that don't change behavior.
-6. **Add version + date**: top of the entry.
-
-## Output format (JSON-typed)
-- changelog: string (the full CHANGELOG.md content)
-- sectionsUsed: string[] (which sections you wrote)
-- commitsProcessed: number
-
-## Changelog principles
-- **User-facing language**: write for end-users, not developers
-- **Group, don't list**: 1 entry per feature, not 1 per commit
-- **Highlight breaking changes**: bold or callout
-- **Link to issues/PRs**: reference #123, fixes #456
-- **Date format**: ISO 8601 (YYYY-MM-DD)
-
-Stay under 500 words.${CLARIFICATION_PROTOCOL}`,
-};
-// Register all skills
-registerCodingSkill(writeReadme);
-registerCodingSkill(writeTsdoc);
-registerCodingSkill(writeChangelog);
-//# sourceMappingURL=docs.js.map

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

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