cclaw-cli 7.7.1 → 8.1.0

package/dist/content/core-agents.d.ts

@@ -1,235 +1,11 @@
-/**
- * Agent persona content for cclaw.
- *
- * cclaw materializes markdown agent definitions (`.md` with YAML frontmatter)
- * under `.cclaw/agents/` for harness delegation. Research work that does not
- * need isolated subagent context lives in `.cclaw/skills/research/*.md`
- * playbooks and is executed in-thread by the primary agent.
- */
-export interface AgentReturnSchema {
-    /** Field carrying the terminal verdict/status token. */
-    statusField: string;
-    /** Exact allowed terminal values for this agent's first structured return. */
-    allowedStatuses: string[];
-    /** Fields the controller should expect in every completed response. */
-    requiredFields: string[];
-    /** Fields that must cite artifact anchors, commands, or code locations when applicable. */
-    evidenceFields: string[];
-    /** Additional optional fields allowed for specific agent contracts. */
-    optionalFields?: string[];
-}
-export interface AgentDefinition {
-    /** Kebab-case identifier, e.g. `"reviewer"`. */
-    name: string;
-    /** When to invoke — include PROACTIVE / MUST BE USED guidance. */
+import type { SpecialistId } from "../types.js";
+export interface CoreAgent {
+    id: SpecialistId;
+    title: string;
+    activation: "on-demand";
+    modes: string[];
     description: string;
-    /** Allowed tools for this agent (harness-specific names). */
-    tools: string[];
-    /** Model tier for routing cost/latency vs depth. */
-    model: "fast" | "balanced" | "deep";
-    /** How the harness should treat activation relative to flow context. */
-    activation: "proactive" | "on-demand" | "mandatory";
-    /** cclaw flow stages this agent is designed to support. */
-    relatedStages: string[];
-    /** Strict terminal return contract rendered into materialized agent files. */
-    returnSchema: AgentReturnSchema;
-    /** Markdown body rendered below the YAML frontmatter. */
-    body: string;
+    prompt: string;
 }
-/**
- * Canonical slice-builder worker protocol text (embedded in the agent body and
- * echoed in the TDD skill block).
- */
-export declare function sliceBuilderProtocol(): string;
-/**
- * Canonical specialist roster materialized under `.cclaw/agents/`.
- *
- * Declared with `satisfies` so the array retains literal `name` types for
- * downstream type-level consumers (e.g. `AgentName`), while still being
- * checked against the `AgentDefinition` shape at compile time. Do not add
- * an explicit `AgentDefinition[]` annotation here — it would widen `name`
- * to `string` and break the compile-time drift guard.
- */
-export declare const CCLAW_AGENTS: readonly [{
-    readonly name: "researcher";
-    readonly description: "PROACTIVE when context readiness, repo search, reference patterns, or external docs could change a stage decision. MUST summarize search-before-read evidence before large reads.";
-    readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
-    readonly model: "fast";
-    readonly activation: "proactive";
-    readonly relatedStages: ["brainstorm", "scope", "design", "plan"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "planner";
-    readonly description: "MANDATORY for scope/design/plan and PROACTIVE for high-ambiguity work. MUST BE USED when sequencing, dependency mapping, or risk trade-offs are required before coding.";
-    readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
-    readonly model: "deep";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["brainstorm", "scope", "design", "spec", "plan"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "product-discovery";
-    readonly description: "MANDATORY during brainstorm and PROACTIVE during scope when value framing or expansion strategy needs product-level discovery pressure.";
-    readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
-    readonly model: "deep";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["brainstorm", "scope"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "divergent-thinker";
-    readonly description: "PROACTIVE before planner/critic convergence when brainstorm or scope needs option-space expansion and alternative framings.";
-    readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
-    readonly model: "balanced";
-    readonly activation: "proactive";
-    readonly relatedStages: ["brainstorm", "scope"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "critic";
-    readonly description: "PROACTIVE during brainstorm/scope/design when premises, alternatives, cost, rollback, or hidden assumptions need adversarial pressure.";
-    readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
-    readonly model: "balanced";
-    readonly activation: "proactive";
-    readonly relatedStages: ["brainstorm", "scope", "design"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "architect";
-    readonly description: "MANDATORY during design and final ship verification. MUST BE USED to validate architecture boundaries, alternatives, failure modes, rollout, and cross-stage cohesion before release.";
-    readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
-    readonly model: "deep";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["design", "ship"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "spec-validator";
-    readonly description: "MANDATORY during standard/deep spec. MUST BE USED to validate measurable acceptance criteria, assumptions, edge cases, and testability mapping.";
-    readonly tools: ["Read", "Grep", "Glob"];
-    readonly model: "balanced";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["spec"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "spec-document-reviewer";
-    readonly description: "PROACTIVE during spec when self-review surfaces issues, subsystem boundaries feel broad, or the artifact needs a final plan-readiness pass.";
-    readonly tools: ["Read", "Grep", "Glob"];
-    readonly model: "balanced";
-    readonly activation: "proactive";
-    readonly relatedStages: ["spec"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "coherence-reviewer";
-    readonly description: "PROACTIVE during spec/plan/design when internal consistency must be validated across sections, terminology, references, and dependency narratives.";
-    readonly tools: ["Read", "Grep", "Glob"];
-    readonly model: "balanced";
-    readonly activation: "proactive";
-    readonly relatedStages: ["spec", "plan", "design"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "scope-guardian-reviewer";
-    readonly description: "PROACTIVE during scope/plan/design when complexity growth, scope drift, or unnecessary abstraction risk needs a dedicated challenge pass.";
-    readonly tools: ["Read", "Grep", "Glob"];
-    readonly model: "balanced";
-    readonly activation: "proactive";
-    readonly relatedStages: ["scope", "plan", "design"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "feasibility-reviewer";
-    readonly description: "PROACTIVE during plan/design when resource, runtime, environment, dependency, or rollout assumptions can make the solution non-viable.";
-    readonly tools: ["Read", "Grep", "Glob"];
-    readonly model: "balanced";
-    readonly activation: "proactive";
-    readonly relatedStages: ["plan", "design"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "reviewer";
-    readonly description: "MANDATORY during review. MUST BE USED to run a two-pass audit with explicit inline lens coverage for performance, compatibility, and observability.";
-    readonly tools: ["Read", "Grep", "Glob"];
-    readonly model: "balanced";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["spec", "review", "ship"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "security-reviewer";
-    readonly description: "MANDATORY during review; PROACTIVE during design/ship for trust-boundary changes. Always produce an explicit no-change attestation when no security-relevant surface moved.";
-    readonly tools: ["Read", "Grep", "Glob"];
-    readonly model: "balanced";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["design", "review", "ship"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "integration-overseer";
-    readonly description: "ON-DEMAND after TDD fan-out to verify cross-slice cohesion contract integrity, integration surfaces, and shared invariants before review handoff.";
-    readonly tools: ["Read", "Grep", "Glob"];
-    readonly model: "balanced";
-    readonly activation: "on-demand";
-    readonly relatedStages: ["tdd", "review"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "release-reviewer";
-    readonly description: "MANDATORY during ship. MUST BE USED for release readiness, rollback, finalization mode, evidence freshness, and victory detector checks.";
-    readonly tools: ["Read", "Grep", "Glob", "Bash"];
-    readonly model: "balanced";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["ship"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "doc-updater";
-    readonly description: "MANDATORY only at ship; PROACTIVE during tdd/review whenever behavior, config, or public API changes. Keep docs and runbooks in lockstep with shipped behavior.";
-    readonly tools: ["Read", "Write", "Edit", "Grep", "Glob"];
-    readonly model: "fast";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["tdd", "ship"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "slice-builder";
-    readonly description: "MANDATORY for delegated TDD slices. Owns RED → GREEN → REFACTOR → per-slice DOC for one feature-atomic implementation unit/slice in a single delegated span. Multiple slice-builder spans run in parallel only under `parallel-builders` topology with disjoint `claimedPaths`; `strict-micro` keeps tiny tasks separate.";
-    readonly tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"];
-    readonly model: "balanced";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["tdd"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}, {
-    readonly name: "fixer";
-    readonly description: "ON-DEMAND fresh worker after review FAIL/PARTIAL evidence. Must fix only the cited criterion within explicit allowed files.";
-    readonly tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"];
-    readonly model: "balanced";
-    readonly activation: "on-demand";
-    readonly relatedStages: ["review", "tdd"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
-}];
-/**
- * Union of known agent names (compile-time). Use this in content that
- * references agents by name so the TypeScript compiler catches renames
- * and typos instead of letting them slip into generated artifacts.
- */
-export type AgentName = (typeof CCLAW_AGENTS)[number]["name"];
-export declare function agentMarkdown(agent: AgentDefinition): string;
-/**
- * Markdown table mapping cclaw stage entry points to specialist agents.
- */
-export declare function agentRoutingTable(): string;
-/**
- * Cost tier routing for the specialist agent roster.
- */
-export declare function agentCostTierTable(): string;
-export declare function agentRegistryMatrix(): string;
-/**
- * AGENTS.md-ready section describing cclaw’s specialist delegation model.
- */
-export declare function agentsAgentsMdBlock(): string;
+export declare const CORE_AGENTS: CoreAgent[];
+export declare function renderAgentMarkdown(agent: CoreAgent): string;