@archznn/crewloop-skills 0.3.0 → 0.4.0

package/servers/dashboard/src/state.ts

@@ -0,0 +1,115 @@
+import type { DashboardEvent, Session, DashboardState, AgentSource, EventStatus } from './types';
+
+export interface StateStoreOptions {
+  maxEventsPerSession: number;
+  sessionMaxAgeMs: number;
+}
+
+export class StateStore {
+  private sessions: Map<string, Session> = new Map();
+  private options: StateStoreOptions;
+
+  constructor(options: StateStoreOptions) {
+    this.options = options;
+  }
+
+  applyEvent(event: DashboardEvent): Session {
+    let session = this.sessions.get(event.session_id);
+
+    if (!session) {
+      session = this.createSession(event.session_id, event.source);
+    }
+
+    session.source = event.source;
+    session.last_event_at = event.timestamp;
+    session.events.unshift(event);
+
+    if (session.events.length > this.options.maxEventsPerSession) {
+      session.events.length = this.options.maxEventsPerSession;
+    }
+
+    if (event.tool) {
+      session.tool_counts[event.tool] = (session.tool_counts[event.tool] || 0) + 1;
+    }
+
+    if (event.skill) {
+      session.active_skill = event.skill;
+      session.active_confidence = event.event_type === 'skill_change' ? 'explicit' : 'heuristic';
+    }
+
+    session.status = deriveSessionStatus(event);
+
+    this.sessions.set(event.session_id, session);
+    return session;
+  }
+
+  setActiveSkill(
+    sessionId: string,
+    skill: string | undefined,
+    confidence: 'explicit' | 'heuristic' | 'unknown'
+  ): Session | undefined {
+    const session = this.sessions.get(sessionId);
+    if (!session) {
+      return undefined;
+    }
+    session.active_skill = skill;
+    session.active_confidence = confidence;
+    return session;
+  }
+
+  getSession(id: string): Session | undefined {
+    return this.sessions.get(id);
+  }
+
+  getAllSessions(): Session[] {
+    return Array.from(this.sessions.values()).sort(
+      (a, b) => b.last_event_at - a.last_event_at
+    );
+  }
+
+  getState(): DashboardState {
+    return {
+      sessions: Object.fromEntries(this.sessions),
+    };
+  }
+
+  pruneInactive(now: number = Date.now()): number {
+    let removed = 0;
+    for (const [id, session] of this.sessions) {
+      if (now - session.last_event_at > this.options.sessionMaxAgeMs) {
+        this.sessions.delete(id);
+        removed++;
+      }
+    }
+    return removed;
+  }
+
+  private createSession(id: string, source: AgentSource): Session {
+    const now = Date.now();
+    const session: Session = {
+      id,
+      source,
+      events: [],
+      tool_counts: {},
+      started_at: now,
+      last_event_at: now,
+    };
+    this.sessions.set(id, session);
+    return session;
+  }
+}
+
+function deriveSessionStatus(event: DashboardEvent): EventStatus | undefined {
+  switch (event.event_type) {
+    case 'session_start':
+    case 'tool_start':
+    case 'skill_change':
+      return 'running';
+    case 'tool_end':
+      return event.status || 'success';
+    case 'session_end':
+      return 'success';
+    default:
+      return undefined;
+  }
+}

package/servers/dashboard/src/types.ts

@@ -0,0 +1,110 @@
+export type AgentSource = 'kimi' | 'codex' | 'opencode' | 'log-watcher';
+
+export type EventType =
+  | 'session_start'
+  | 'session_end'
+  | 'tool_start'
+  | 'tool_end'
+  | 'skill_change';
+
+export type EventStatus = 'running' | 'success' | 'error';
+
+export interface DashboardEvent {
+  id: string;
+  timestamp: number;
+  source: AgentSource;
+  session_id: string;
+  event_type: EventType;
+  skill?: string;
+  tool?: string;
+  detail?: string;
+  status?: EventStatus;
+  duration_ms?: number;
+}
+
+export interface Session {
+  id: string;
+  source: AgentSource;
+  active_skill?: string;
+  active_confidence?: 'explicit' | 'heuristic' | 'unknown';
+  status?: EventStatus;
+  events: DashboardEvent[];
+  tool_counts: Record<string, number>;
+  started_at: number;
+  last_event_at: number;
+}
+
+export interface DashboardState {
+  sessions: Record<string, Session>;
+}
+
+export interface ClientActiveSkill {
+  name: string;
+  confidence: 'explicit' | 'heuristic' | 'unknown';
+}
+
+export interface ClientEvent {
+  id: string;
+  timestamp: number;
+  event_type: EventType;
+  tool?: string;
+  detail?: string;
+  status?: EventStatus;
+  duration_ms?: number;
+  skill?: string;
+}
+
+export interface ClientSession {
+  id: string;
+  source: AgentSource;
+  skill?: string;
+  activeSkill?: ClientActiveSkill;
+  status?: EventStatus;
+  events: ClientEvent[];
+  startTime: number;
+  lastActivity: number;
+  toolCounts: Record<string, number>;
+}
+
+export interface ClientSnapshotMessage {
+  type: 'snapshot';
+  sessions: ClientSession[];
+}
+
+export interface ClientUpdateMessage {
+  type: 'update';
+  session: ClientSession;
+  isActive: boolean;
+}
+
+export interface ClientPongMessage {
+  type: 'pong';
+}
+
+export type ClientWebSocketMessage =
+  | ClientSnapshotMessage
+  | ClientUpdateMessage
+  | ClientPongMessage;
+
+export interface SkillMeta {
+  name: string;
+  description: string;
+  icon: string;
+}
+
+export type ToolToSkillMap = Record<string, string | undefined>;
+
+export interface SkillInferenceResult {
+  skill: string | undefined;
+  confidence: 'explicit' | 'heuristic' | 'unknown';
+}
+
+export interface ServerConfig {
+  port: number;
+  host: string;
+  packageRoot: string;
+  maxEventsPerSession: number;
+  sessionMaxAgeMs: number;
+  pruneIntervalMs: number;
+}
+

package/servers/dashboard/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "public", "bin"]
+}

package/skills/orchestrator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: orchestrator
-description: Context discovery orchestrator for software tasks. Run FIRST for build, create, modify, fix, refactor, design, or implement requests. Gathers context and routes to architect for specs. Trigger: build, create, fix, refactor, design, implement, UI, frontend, dashboard, landing page, or code changes.
+description: "Context discovery orchestrator for software tasks. Run FIRST for build, create, modify, fix, refactor, design, or implement requests. Gathers context and routes to architect for specs. Trigger: build, create, fix, refactor, design, implement, UI, frontend, dashboard, landing page, or code changes."
 ---
 
 # Orchestrator — Context Discovery & Requirement Gathering