Files
skillkit/packages/cli/src/commands/activity.ts
T
Rohit Ghumare aafa086314 feat: add skillkit doctor command and enhance skillkit status (#64)
* feat: add `skillkit doctor` command and enhance `skillkit status`

- New `skillkit doctor` command with 10 health checks across 3 categories
  (environment, configuration, skills) with --json and --fix flags
- Enhanced `skillkit status` shows project overview dashboard when no
  active session exists instead of bare "No active session found" message
- Overview includes agent, config, version, skills count, recent history

* feat: add skill activity log, session snapshots, and session explain

Three new session intelligence features:

- Activity Log: tracks which skills were active per git commit
  (`skillkit activity` with --skill, --limit, --json flags)
- Session Snapshots: save/restore named snapshots of session state
  (`skillkit session snapshot save|restore|list|delete`)
- Session Explain: structured summary of current session
  (`skillkit session explain` with --json, --no-git flags)

Includes path traversal protection on snapshot names, YAML validation
on parsed activity data, and robust error handling on snapshot restore.

983 tests passing (942 core + 41 CLI including 14 E2E tests).

* feat: add issue planner - generate plans from GitHub Issues

New `skillkit issue plan` and `skillkit issue list` commands that
fetch GitHub Issues via `gh` CLI and generate StructuredPlans.
Parses checkboxes, file mentions, and labels from issue body.
29 new tests, all passing.

* fix: address CodeRabbit review suggestions for PR #64

- doctor.ts: use execFileSync, typed AgentType, remove as-any casts
- activity.ts: validate parseInt with radix and NaN guard
- issue.ts: wrap JSON.parse in try/catch for gh CLI output
- issue-planner.ts: guard JSON.parse, fix includeTests no-op ternary,
  remove duplicate IssuePlanMetadata (import from types.ts)
- status.ts: typed StatusOverview interface, remove as-any casts
- snapshot-manager.ts: align observations param with SessionSnapshot type
- session.ts: proper type mapping for observations (no double cast)
- activity-log.ts: min-length guard for SHA prefix match
- e2e tests: use top-level imports instead of inline require()
- commands.test.ts: add assertions for DoctorCommand, IssuePlanCommand,
  IssueListCommand

* fix: address review feedback from CodeRabbit and Devin

- Include test step in no-checklist fallback when includeTests is true
- Restore observations from snapshot in SessionSnapshotRestoreCommand

* fix: address remaining CodeRabbit and Devin review feedback

- doctor.ts: Use getAdapter() per AgentType instead of getAllAdapters()
  spread (which destroys prototype methods like isDetected)
- doctor.ts: Use getGlobalSkillsDir() from AGENT_CONFIG instead of
  hardcoded path formula
- session-explainer.ts: Defensively default state.history and
  state.decisions to empty arrays
- session-explainer.ts: Use loadConfig().agent with skillSource fallback
  instead of always using skillSource as agent name
- observation-store.ts: Add static readAll() that reads observations
  without sessionId mismatch clearing
- session.ts: Use ObservationStore.readAll() for snapshot save to avoid
  empty observations due to sessionId mismatch
2026-02-11 20:26:51 +00:00

95 lines
2.7 KiB
TypeScript

import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { ActivityLog } from '@skillkit/core';
export class ActivityCommand extends Command {
static override paths = [['activity']];
static override usage = Command.Usage({
description: 'Show skill activity log for git commits',
examples: [
['Show recent activity', '$0 activity'],
['Filter by skill', '$0 activity --skill code-simplifier'],
['JSON output', '$0 activity --json'],
],
});
skill = Option.String('--skill,-s', {
description: 'Filter by skill name',
});
limit = Option.String('--limit,-l', {
description: 'Number of entries to show (default: 10)',
});
json = Option.Boolean('--json,-j', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const projectPath = process.cwd();
const log = new ActivityLog(projectPath);
const parsed = this.limit ? parseInt(this.limit, 10) : 10;
const limit = Number.isFinite(parsed) && parsed > 0 ? parsed : 10;
const activities = this.skill
? log.getBySkill(this.skill)
: log.getRecent(limit);
if (this.json) {
console.log(JSON.stringify(activities.slice(0, limit), null, 2));
return 0;
}
if (activities.length === 0) {
console.log(chalk.yellow('No activity recorded'));
console.log(
chalk.dim(
'Activity is recorded when skills are active during git commits.'
)
);
return 0;
}
console.log(chalk.cyan(' Recent Skill Activity\n'));
const displayed = activities.slice(0, limit);
for (const activity of displayed) {
const shortSha = activity.commitSha.slice(0, 7);
const skills = activity.activeSkills.join(', ');
const files = activity.filesChanged.join(', ');
const ago = formatTimeAgo(activity.committedAt);
console.log(` ${chalk.bold(shortSha)} ${activity.message}`);
console.log(` Skills: ${chalk.green(skills)}`);
console.log(
` Files: ${files} ${chalk.dim(`(${ago})`)}`
);
console.log();
}
const topSkills = log.getMostUsedSkills().slice(0, 5);
if (topSkills.length > 0) {
const formatted = topSkills
.map((s) => `${s.skill} (${s.count})`)
.join(', ');
console.log(` Top Skills: ${formatted}`);
}
return 0;
}
}
function formatTimeAgo(isoDate: string): string {
const diff = Date.now() - new Date(isoDate).getTime();
const minutes = Math.floor(diff / 60000);
const hours = Math.floor(minutes / 60);
const days = Math.floor(hours / 24);
if (days > 0) return `${days}d ago`;
if (hours > 0) return `${hours}h ago`;
if (minutes > 0) return `${minutes}m ago`;
return 'just now';
}