devclaw-gitea

peter/devclaw-gitea

Fork 0

Commit Graph

Author	SHA1	Message	Date
Lauren ten Hoor	be8e0f4db1	refactor: Centralize role types and configuration (#190 ) Creates a single source of truth for all worker roles via lib/roles/. ## New: lib/roles/ - registry.ts — All role definitions (dev, qa, architect) with levels, models, emoji, completion results, session key patterns - types.ts — RoleConfig interface - selectors.ts — Query helpers: getRole(), getLevelsForRole(), resolveModel(), isValidResult(), roleForLevel(), etc. - index.ts — Barrel exports ## Migrated Files - lib/tiers.ts — Now delegates to registry (backward compat kept) - lib/dispatch.ts — Uses registry for emoji resolution - lib/bootstrap-hook.ts — Uses registry for session key pattern - lib/services/tick.ts — Uses registry for level detection - lib/services/heartbeat.ts — Uses registry for role iteration - lib/tools/health.ts — Uses registry for role iteration - lib/tools/work-start.ts — Uses registry for role enum - lib/tools/work-finish.ts — Uses registry for result validation - lib/tools/project-register.ts — Uses registry for level lists ## Key Benefits - Adding a new role = add entry to registry.ts (single file) - No more scattered role unions ("dev" \| "qa" \| "architect") - Type-safe role/level/result validation from registry - Session key pattern auto-generated from registry - All 64 tests passing (22 new registry tests + 42 existing)	2026-02-14 17:15:54 +08:00
Lauren ten Hoor	57c78f3656	feat: Implement Architect role & design_task tool (#189 ) Adds the Architect role for design/architecture investigations with persistent sessions and structured design proposals. ## New Features - Architect role with opus (complex) and sonnet (standard) levels - design_task tool — Creates To Design issues and dispatches architect - Workflow states: To Design → Designing → Planning - Completion rules: architect:done → Planning, architect:blocked → Refining - Auto-level selection based on complexity keywords ## Files Changed (22 files, 546 additions) ### New Files - lib/tools/design-task.ts — design_task tool implementation - lib/tools/design-task.test.ts — 16 tests for architect functionality ### Core Changes - lib/tiers.ts — ARCHITECT_LEVELS, WorkerRole type, models, emoji - lib/workflow.ts — toDesign/designing states, completion rules - lib/projects.ts — architect WorkerState on Project type - lib/dispatch.ts — architect role support in dispatch pipeline - lib/services/pipeline.ts — architect completion rules - lib/model-selector.ts — architect level selection heuristic ### Integration - index.ts — Register design_task tool, architect config schema - lib/notify.ts — architect role in notifications - lib/bootstrap-hook.ts — architect session key parsing - lib/services/tick.ts — architect in queue processing - lib/services/heartbeat.ts — architect in health checks - lib/tools/health.ts — architect in health scans - lib/tools/status.ts — architect in status dashboard - lib/tools/work-start.ts — architect role option - lib/tools/work-finish.ts — architect validation - lib/tools/project-register.ts — architect labels + role scaffolding - lib/templates.ts — architect instructions + AGENTS.md updates - lib/setup/workspace.ts — architect role file scaffolding - lib/setup/smart-model-selector.ts — architect in model assignment - lib/setup/llm-model-selector.ts — architect in LLM prompt	2026-02-14 17:08:17 +08:00
Lauren ten Hoor	dfeadf742a	feat: make workflow states dynamic with XState-style statechart config (#147 ) (#160 ) ## Summary Introduces a configurable workflow state machine that replaces all hardcoded state labels. The default workflow matches current behavior exactly, ensuring backward compatibility. ## Architecture ### lib/workflow.ts — Core workflow engine XState-style statechart configuration: ```typescript type StateConfig = { type: 'queue' \| 'active' \| 'hold' \| 'terminal'; role?: 'dev' \| 'qa'; label: string; color: string; priority?: number; on?: Record<string, TransitionTarget>; }; ``` All behavior is derived from the config: - Queue states: `type: 'queue'`, grouped by role, ordered by priority - Active states: `type: 'active'` — worker occupied - Transitions: defined with optional actions (gitPull, detectPr, closeIssue, reopenIssue) - Labels and colors: derived from state.label and state.color ### Derivation functions - `getStateLabels()` — all labels for issue tracker sync - `getLabelColors()` — label → color mapping - `getQueueLabels(role)` — queue labels for a role, ordered by priority - `getActiveLabel(role)` — the active/in-progress label for a role - `getRevertLabel(role)` — queue label to revert to on failure - `detectRoleFromLabel()` — detect role from a queue label - `getCompletionRule(role, result)` — derive transition rule from config ## Files Changed - lib/workflow.ts — NEW: workflow engine and default config - lib/providers/provider.ts — deprecate STATE_LABELS, LABEL_COLORS; derive from workflow - lib/providers/github.ts — use workflow config for label operations - lib/providers/gitlab.ts — use workflow config for label operations - lib/services/pipeline.ts — use getCompletionRule() from workflow - lib/services/tick.ts — use workflow for queue/active labels - lib/services/health.ts — use workflow for active/revert labels - lib/tools/work-start.ts — use workflow for target label ## Backward Compatibility - DEFAULT_WORKFLOW matches current hardcoded behavior exactly - Deprecated exports kept for any external consumers - No breaking changes to tool interfaces or project state ## Future Work - Load per-project workflow overrides from projects.json - User-facing config in projects/workflow.json - Tool schema generation from workflow states	2026-02-13 18:50:09 +08:00

Author

SHA1

Message

Date

Lauren ten Hoor

be8e0f4db1

refactor: Centralize role types and configuration (#190 )

Creates a single source of truth for all worker roles via lib/roles/.

## New: lib/roles/

- **registry.ts** — All role definitions (dev, qa, architect) with
  levels, models, emoji, completion results, session key patterns
- **types.ts** — RoleConfig interface
- **selectors.ts** — Query helpers: getRole(), getLevelsForRole(),
  resolveModel(), isValidResult(), roleForLevel(), etc.
- **index.ts** — Barrel exports

## Migrated Files

- **lib/tiers.ts** — Now delegates to registry (backward compat kept)
- **lib/dispatch.ts** — Uses registry for emoji resolution
- **lib/bootstrap-hook.ts** — Uses registry for session key pattern
- **lib/services/tick.ts** — Uses registry for level detection
- **lib/services/heartbeat.ts** — Uses registry for role iteration
- **lib/tools/health.ts** — Uses registry for role iteration
- **lib/tools/work-start.ts** — Uses registry for role enum
- **lib/tools/work-finish.ts** — Uses registry for result validation
- **lib/tools/project-register.ts** — Uses registry for level lists

## Key Benefits

- Adding a new role = add entry to registry.ts (single file)
- No more scattered role unions ("dev" | "qa" | "architect")
- Type-safe role/level/result validation from registry
- Session key pattern auto-generated from registry
- All 64 tests passing (22 new registry tests + 42 existing)

2026-02-14 17:15:54 +08:00

Lauren ten Hoor

57c78f3656

feat: Implement Architect role & design_task tool (#189 )

Adds the Architect role for design/architecture investigations with
persistent sessions and structured design proposals.

## New Features

- **Architect role** with opus (complex) and sonnet (standard) levels
- **design_task tool** — Creates To Design issues and dispatches architect
- **Workflow states:** To Design → Designing → Planning
- **Completion rules:** architect:done → Planning, architect:blocked → Refining
- **Auto-level selection** based on complexity keywords

## Files Changed (22 files, 546 additions)

### New Files
- lib/tools/design-task.ts — design_task tool implementation
- lib/tools/design-task.test.ts — 16 tests for architect functionality

### Core Changes
- lib/tiers.ts — ARCHITECT_LEVELS, WorkerRole type, models, emoji
- lib/workflow.ts — toDesign/designing states, completion rules
- lib/projects.ts — architect WorkerState on Project type
- lib/dispatch.ts — architect role support in dispatch pipeline
- lib/services/pipeline.ts — architect completion rules
- lib/model-selector.ts — architect level selection heuristic

### Integration
- index.ts — Register design_task tool, architect config schema
- lib/notify.ts — architect role in notifications
- lib/bootstrap-hook.ts — architect session key parsing
- lib/services/tick.ts — architect in queue processing
- lib/services/heartbeat.ts — architect in health checks
- lib/tools/health.ts — architect in health scans
- lib/tools/status.ts — architect in status dashboard
- lib/tools/work-start.ts — architect role option
- lib/tools/work-finish.ts — architect validation
- lib/tools/project-register.ts — architect labels + role scaffolding
- lib/templates.ts — architect instructions + AGENTS.md updates
- lib/setup/workspace.ts — architect role file scaffolding
- lib/setup/smart-model-selector.ts — architect in model assignment
- lib/setup/llm-model-selector.ts — architect in LLM prompt

2026-02-14 17:08:17 +08:00

Lauren ten Hoor

dfeadf742a

feat: make workflow states dynamic with XState-style statechart config (#147 ) (#160 )

## Summary

Introduces a configurable workflow state machine that replaces all hardcoded
state labels. The default workflow matches current behavior exactly, ensuring
backward compatibility.

## Architecture

### lib/workflow.ts — Core workflow engine

XState-style statechart configuration:

```typescript
type StateConfig = {
  type: 'queue' | 'active' | 'hold' | 'terminal';
  role?: 'dev' | 'qa';
  label: string;
  color: string;
  priority?: number;
  on?: Record<string, TransitionTarget>;
};
```

All behavior is derived from the config:
- Queue states: `type: 'queue'`, grouped by role, ordered by priority
- Active states: `type: 'active'` — worker occupied
- Transitions: defined with optional actions (gitPull, detectPr, closeIssue, reopenIssue)
- Labels and colors: derived from state.label and state.color

### Derivation functions

- `getStateLabels()` — all labels for issue tracker sync
- `getLabelColors()` — label → color mapping
- `getQueueLabels(role)` — queue labels for a role, ordered by priority
- `getActiveLabel(role)` — the active/in-progress label for a role
- `getRevertLabel(role)` — queue label to revert to on failure
- `detectRoleFromLabel()` — detect role from a queue label
- `getCompletionRule(role, result)` — derive transition rule from config

## Files Changed

- **lib/workflow.ts** — NEW: workflow engine and default config
- **lib/providers/provider.ts** — deprecate STATE_LABELS, LABEL_COLORS; derive from workflow
- **lib/providers/github.ts** — use workflow config for label operations
- **lib/providers/gitlab.ts** — use workflow config for label operations
- **lib/services/pipeline.ts** — use getCompletionRule() from workflow
- **lib/services/tick.ts** — use workflow for queue/active labels
- **lib/services/health.ts** — use workflow for active/revert labels
- **lib/tools/work-start.ts** — use workflow for target label

## Backward Compatibility

- DEFAULT_WORKFLOW matches current hardcoded behavior exactly
- Deprecated exports kept for any external consumers
- No breaking changes to tool interfaces or project state

## Future Work

- Load per-project workflow overrides from projects.json
- User-facing config in projects/workflow.json
- Tool schema generation from workflow states

2026-02-13 18:50:09 +08:00

3 Commits