happyskills 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.6.0] - 2026-06-04
+
+### Added
+
+- Extend `stats` (all additive): `--group-by skill` on `--scope my_activity` (rank which skills *you* installed); a new `installs` metric on `--scope my_skills_reach` that counts total installs of your authored skills (you + others; bot excluded), with `--exclude-self` to drop your own. Availability warnings are now softer — suppressed for `--period` presets, terser for explicit `--from`. Requires API v5.4.0+.
+
 ## [1.5.0] - 2026-06-04
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "happyskills",
-	"version": "1.5.0",
+	"version": "1.6.0",
 	"description": "Package manager for AI agent skills",
 	"license": "SEE LICENSE IN LICENSE",
 	"author": "Nicolas Dao <nic@cloudlesslabs.com> (https://cloudlesslabs.com)",

package/src/commands/stats.js

@@ -15,10 +15,10 @@ const token_store = require('../auth/token_store')
 
 const METRICS_BY_SCOPE = {
 	my_activity:     ['installs', 'updates', 'searches', 'uninstalls'],
-	my_skills_reach: ['installs_by_others', 'distinct_installers'],
+	my_skills_reach: ['installs', 'installs_by_others', 'distinct_installers'],
 }
 const GROUP_BY_BY_SCOPE = {
-	my_activity:     ['none', 'day', 'week', 'month', 'surface'],
+	my_activity:     ['none', 'day', 'week', 'month', 'surface', 'skill'],
 	my_skills_reach: ['none', 'day', 'week', 'month', 'skill'],
 }
 const VALID_PRESETS = ['7d', '30d', '90d', '6mo', '12mo']
@@ -35,21 +35,25 @@ Two scopes:
 Options:
   --scope <scope>         my_activity | my_skills_reach (required)
   --metric <metric>       my_activity:     installs, updates, searches, uninstalls
-                          my_skills_reach: installs_by_others, distinct_installers
+                          my_skills_reach: installs (everyone), installs_by_others,
+                                           distinct_installers
   --period <preset>       ${VALID_PRESETS.join(' | ')}
   --from <ISO date>       Explicit window start (use instead of --period)
   --to <ISO date>         Explicit window end (default: now)
-  --group-by <bucket>     my_activity:     none, day, week, month, surface
+  --group-by <bucket>     my_activity:     none, day, week, month, surface, skill
                           my_skills_reach: none, day, week, month, skill
                           (default: none)
   --skill <owner/skill>   Limit my_skills_reach to one skill you authored
+  --exclude-self          my_skills_reach 'installs' only: exclude your own installs
+                          (installs counts you by default)
   --json                  Output as JSON envelope
 
 Examples:
   happyskills stats --scope my_activity --metric installs --period 30d
+  happyskills stats --scope my_activity --metric installs --period 30d --group-by skill
   happyskills stats --scope my_activity --metric searches --period 90d --group-by week --json
-  happyskills stats --scope my_skills_reach --metric distinct_installers --period 12mo
-  happyskills stats --scope my_skills_reach --metric installs_by_others --period 12mo --group-by skill
+  happyskills stats --scope my_skills_reach --metric installs --period 12mo --group-by skill
+  happyskills stats --scope my_skills_reach --metric installs --period 12mo --exclude-self
   happyskills stats --scope my_skills_reach --metric distinct_installers --period 12mo --skill acme/deploy-aws
   happyskills stats --scope my_activity --metric installs --from 2026-05-01 --to 2026-06-01`
 
@@ -98,6 +102,14 @@ const build_request = (flags) => {
 		body.repo_slug = flags.skill
 	}
 
+	// --exclude-self refines my_skills_reach `installs` (which counts you by
+	// default). Meaningless elsewhere — the server enforces this too.
+	if (flags['exclude-self']) {
+		if (scope !== 'my_skills_reach')
+			throw new UsageError('--exclude-self is only valid for --scope my_skills_reach.')
+		body.exclude_self = true
+	}
+
 	return body
 }
 
@@ -161,14 +173,15 @@ const schema = {
 	input: {
 		positional: [],
 		flags: [
-			{ name: 'scope',    type: 'string', required: true,  description: 'my_activity | my_skills_reach' },
-			{ name: 'metric',   type: 'string', required: true,  description: 'my_activity: installs|updates|searches|uninstalls; my_skills_reach: installs_by_others|distinct_installers' },
-			{ name: 'period',   type: 'string', default: undefined, description: 'Window preset: 7d|30d|90d|6mo|12mo (use instead of --from/--to)' },
-			{ name: 'from',     type: 'string', default: undefined, description: 'Explicit window start (ISO date)' },
-			{ name: 'to',       type: 'string', default: undefined, description: 'Explicit window end (ISO date, default now)' },
-			{ name: 'group-by', type: 'string', default: 'none', description: 'my_activity: none|day|week|month|surface; my_skills_reach: none|day|week|month|skill' },
-			{ name: 'skill',    type: 'string', default: undefined, description: 'my_skills_reach only: limit to one authored skill (owner/skill)' },
-			{ name: 'json',     type: 'boolean', default: false, description: 'Output as JSON' },
+			{ name: 'scope',        type: 'string', required: true,  description: 'my_activity | my_skills_reach' },
+			{ name: 'metric',       type: 'string', required: true,  description: 'my_activity: installs|updates|searches|uninstalls; my_skills_reach: installs|installs_by_others|distinct_installers' },
+			{ name: 'period',       type: 'string', default: undefined, description: 'Window preset: 7d|30d|90d|6mo|12mo (use instead of --from/--to)' },
+			{ name: 'from',         type: 'string', default: undefined, description: 'Explicit window start (ISO date)' },
+			{ name: 'to',           type: 'string', default: undefined, description: 'Explicit window end (ISO date, default now)' },
+			{ name: 'group-by',     type: 'string', default: 'none', description: 'my_activity: none|day|week|month|surface|skill; my_skills_reach: none|day|week|month|skill' },
+			{ name: 'skill',        type: 'string', default: undefined, description: 'my_skills_reach only: limit to one authored skill (owner/skill)' },
+			{ name: 'exclude-self', type: 'boolean', default: false, description: "my_skills_reach 'installs' only: exclude your own installs (counted by default)" },
+			{ name: 'json',         type: 'boolean', default: false, description: 'Output as JSON' },
 		],
 	},
 	output: {
@@ -190,9 +203,10 @@ const schema = {
 		{ code: 'NETWORK_ERROR', next_step: { kind: 'recovery', action: 'retry' } },
 	],
 	examples: [
-		'happyskills stats --scope my_activity --metric installs --period 30d',
-		'happyskills stats --scope my_skills_reach --metric distinct_installers --period 12mo --group-by skill',
-		'happyskills stats --scope my_skills_reach --metric installs_by_others --period 12mo --skill acme/deploy-aws',
+		'happyskills stats --scope my_activity --metric installs --period 30d --group-by skill',
+		'happyskills stats --scope my_skills_reach --metric installs --period 12mo --group-by skill',
+		'happyskills stats --scope my_skills_reach --metric installs --period 12mo --exclude-self',
+		'happyskills stats --scope my_skills_reach --metric distinct_installers --period 12mo --skill acme/deploy-aws',
 	],
 }
 

package/src/commands/stats.test.js

@@ -59,6 +59,26 @@ describe('build_request — closed grammar', () => {
 	it('rejects a --skill without owner/skill form', () => {
 		assert.throws(() => build_request({ scope: 'my_skills_reach', metric: 'installs_by_others', period: '12mo', skill: 'deploy' }), /owner\/skill/)
 	})
+
+	it('accepts group-by skill on my_activity (rank your own installs by skill)', () => {
+		const body = build_request({ scope: 'my_activity', metric: 'installs', period: '30d', 'group-by': 'skill' })
+		assert.equal(body.group_by, 'skill')
+	})
+
+	it('accepts the my_skills_reach `installs` metric', () => {
+		const body = build_request({ scope: 'my_skills_reach', metric: 'installs', period: '12mo' })
+		assert.equal(body.metric, 'installs')
+		assert.equal(body.exclude_self, undefined) // self included by default
+	})
+
+	it('maps --exclude-self to exclude_self for my_skills_reach', () => {
+		const body = build_request({ scope: 'my_skills_reach', metric: 'installs', period: '12mo', 'exclude-self': true })
+		assert.equal(body.exclude_self, true)
+	})
+
+	it('rejects --exclude-self on my_activity', () => {
+		assert.throws(() => build_request({ scope: 'my_activity', metric: 'installs', period: '30d', 'exclude-self': true }), /--exclude-self is only valid/)
+	})
 })
 
 describe('schema export', () => {