@archznn/crewloop-skills 0.4.2 → 0.5.0

package/servers/dashboard/src/skills/infer.ts

@@ -9,6 +9,14 @@ export class SkillInferenceEngine {
   }
 
   infer(event: DashboardEvent, session: Session): SkillInferenceResult {
+    const explicitSignal =
+      (event.event_type === 'skill_change' && event.skill) ||
+      (event.tool === 'Skill' && event.detail && this.normalizeSkillName(event.detail));
+
+    if (session.active_confidence === 'explicit' && !explicitSignal) {
+      return { skill: session.active_skill, confidence: 'explicit' };
+    }
+
     if (event.event_type === 'skill_change' && event.skill) {
       return { skill: event.skill, confidence: 'explicit' };
     }

package/servers/dashboard/src/state.test.ts

@@ -15,6 +15,7 @@ function makeEvent(overrides: Partial<DashboardEvent> = {}): DashboardEvent {
   };
 }
 
+
 describe('StateStore', () => {
   it('creates session on first event', () => {
     const store = new StateStore({ maxEventsPerSession: 10, sessionMaxAgeMs: 60000 });
@@ -51,6 +52,14 @@ describe('StateStore', () => {
     assert.equal(session.active_confidence, 'explicit');
   });
 
+  it('sets explicit active skill from session_start event', () => {
+    const store = new StateStore({ maxEventsPerSession: 10, sessionMaxAgeMs: 60000 });
+    store.applyEvent(makeEvent({ skill: 'orchestrator', event_type: 'session_start' }));
+    const session = store.getSession('sess-1')!;
+    assert.equal(session.active_skill, 'orchestrator');
+    assert.equal(session.active_confidence, 'explicit');
+  });
+
   it('derives running status from tool_start', () => {
     const store = new StateStore({ maxEventsPerSession: 10, sessionMaxAgeMs: 60000 });
     store.applyEvent(makeEvent({ event_type: 'tool_start' }));
@@ -85,4 +94,38 @@ describe('StateStore', () => {
     assert.equal(sessions[0].id, 'b');
     assert.equal(sessions[1].id, 'a');
   });
+
+  it('starts with lifecycle starting on session_start', () => {
+    const store = new StateStore({ maxEventsPerSession: 10, sessionMaxAgeMs: 60000 });
+    store.applyEvent(makeEvent({ event_type: 'session_start' }));
+    const session = store.getSession('sess-1')!;
+    assert.equal(session.lifecycle, 'starting');
+  });
+
+  it('transitions to running on first tool event', () => {
+    const store = new StateStore({ maxEventsPerSession: 10, sessionMaxAgeMs: 60000 });
+    store.applyEvent(makeEvent({ event_type: 'session_start' }));
+    store.applyEvent(makeEvent({ event_type: 'tool_start', tool: 'Read' }));
+    const session = store.getSession('sess-1')!;
+    assert.equal(session.lifecycle, 'running');
+  });
+
+  it('sets lifecycle ended and ended_at on session_end', () => {
+    const store = new StateStore({ maxEventsPerSession: 10, sessionMaxAgeMs: 60000 });
+    store.applyEvent(makeEvent({ event_type: 'session_start' }));
+    const endTs = Date.now() + 1000;
+    store.applyEvent(makeEvent({ event_type: 'session_end', timestamp: endTs }));
+    const session = store.getSession('sess-1')!;
+    assert.equal(session.lifecycle, 'ended');
+    assert.equal(session.ended_at, endTs);
+  });
+
+  it('keeps session ended after subsequent tool events', () => {
+    const store = new StateStore({ maxEventsPerSession: 10, sessionMaxAgeMs: 60000 });
+    store.applyEvent(makeEvent({ event_type: 'session_start' }));
+    store.applyEvent(makeEvent({ event_type: 'session_end' }));
+    store.applyEvent(makeEvent({ event_type: 'tool_start', tool: 'Read' }));
+    const session = store.getSession('sess-1')!;
+    assert.equal(session.lifecycle, 'ended');
+  });
 });

package/servers/dashboard/src/state.ts

@@ -32,11 +32,19 @@ export class StateStore {
       session.tool_counts[event.tool] = (session.tool_counts[event.tool] || 0) + 1;
     }
 
-    if (event.skill) {
+    if (event.event_type === 'session_start' && event.skill) {
+      session.active_skill = event.skill;
+      session.active_confidence = 'explicit';
+    } else if (event.skill) {
       session.active_skill = event.skill;
       session.active_confidence = event.event_type === 'skill_change' ? 'explicit' : 'heuristic';
     }
 
+    if (event.event_type === 'session_end') {
+      session.ended_at = event.timestamp;
+    }
+    session.lifecycle = deriveLifecycle(event, session);
+
     session.status = deriveSessionStatus(event);
 
     this.sessions.set(event.session_id, session);
@@ -91,6 +99,7 @@ export class StateStore {
       source,
       events: [],
       tool_counts: {},
+      lifecycle: 'starting',
       started_at: now,
       last_event_at: now,
     };
@@ -99,6 +108,16 @@ export class StateStore {
   }
 }
 
+function deriveLifecycle(event: DashboardEvent, session: Session): 'starting' | 'running' | 'ended' {
+  if (event.event_type === 'session_end' || session.ended_at) {
+    return 'ended';
+  }
+  if (event.event_type === 'session_start' && session.events.length <= 1) {
+    return 'starting';
+  }
+  return 'running';
+}
+
 function deriveSessionStatus(event: DashboardEvent): EventStatus | undefined {
   switch (event.event_type) {
     case 'session_start':

package/servers/dashboard/src/types.ts

@@ -28,10 +28,12 @@ export interface Session {
   active_skill?: string;
   active_confidence?: 'explicit' | 'heuristic' | 'unknown';
   status?: EventStatus;
+  lifecycle: 'starting' | 'running' | 'ended';
   events: DashboardEvent[];
   tool_counts: Record<string, number>;
   started_at: number;
   last_event_at: number;
+  ended_at?: number;
 }
 
 export interface DashboardState {
@@ -60,9 +62,11 @@ export interface ClientSession {
   skill?: string;
   activeSkill?: ClientActiveSkill;
   status?: EventStatus;
+  lifecycle: 'starting' | 'running' | 'ended';
   events: ClientEvent[];
   startTime: number;
   lastActivity: number;
+  endedAt?: number;
   toolCounts: Record<string, number>;
 }
 

package/skills/orchestrator/SKILL.md

@@ -11,6 +11,12 @@ You are a technical product manager and discovery specialist. Your job is to ext
 
 ---
 
+## DASHBOARD LIFECYCLE
+
+When this skill is loaded at the start of a session, the CrewLoop dashboard should display an active session named `orchestrator`. If the agent supports lifecycle hooks, ensure the first event sent to the dashboard marks `orchestrator` as the active skill.
+
+---
+
 ### 🚨 MANDATORY: Read Reference & Template Files
 Before taking any action, you MUST read the global conventions in [conventions.md](../../references/conventions.md), the workflow in [workflow.md](../../references/workflow.md), and any local reference files or directories (such as `references/` or `assets/`) if present. Never skip this step or make assumptions about the guidelines.