@zibby/skills 0.1.90 → 0.1.91

package/dist/codeStats.d.ts

@@ -0,0 +1,163 @@
+export function sizeBucket(added: any, deleted: any): string;
+export function fileExtension(path: any): string;
+export function extKind(ext: any): any;
+/**
+ * commit_facts — deterministic per-commit facts from its changed-file list.
+ * `files` is [{ path|newPath|filename, additions?, deletions? }] (the shapes
+ * gitlab_get_commit / github_get_commit already return). Pure.
+ */
+export function commitFacts(files: any, opts?: {}): {
+    filesChanged: number;
+    filePaths: string[];
+    extCounts: {};
+    kindCounts: {
+        code: number;
+        test: number;
+        docs: number;
+        config: number;
+        style: number;
+        data: number;
+        other: number;
+    };
+    additions: number;
+    deletions: number;
+    sizeBucket: string;
+    largestFile: string;
+    dirs: string[];
+};
+/**
+ * glob_hit — how many of `paths` match ANY of `globs`. Deterministic. Supports
+ * `**` (any depth), `*` (one segment, no slash), `?` (one char). The customer's
+ * own core-path globs (e.g. "src/payment/**") are passed at REPORT time — this
+ * makes "who works in the core" a reproducible number, not an LLM guess.
+ */
+export function globToRegExp(glob: any): RegExp;
+export function globHit(paths: any, globs: any): {
+    total: number;
+    hits: number;
+    ratio: number;
+    matched: string[];
+};
+/**
+ * percentile — the reproducible, cross-team-comparable rank of `value` within
+ * `values` (0-100, "% of the cohort at or below value"). Ties count at-or-below
+ * (the standard cumulative rank). Empty cohort → null (undefined, not a lie).
+ */
+export function percentileRank(values: any, value: any): number;
+export namespace codeStatsSkill {
+    let id: string;
+    let serverName: string;
+    let allowedTools: string[];
+    let description: string;
+    let promptFragment: string;
+    function resolve(): {
+        command: any;
+        args: any[];
+        env: {};
+        description: string;
+        type?: undefined;
+        alwaysLoad?: undefined;
+    } | {
+        type: string;
+        command: string;
+        args: any[];
+        env: {};
+        description: string;
+        alwaysLoad: boolean;
+    };
+    function handleToolCall(name: any, args: any): Promise<string>;
+    let tools: ({
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                files: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            path: {
+                                type: string;
+                            };
+                            additions: {
+                                type: string;
+                            };
+                            deletions: {
+                                type: string;
+                            };
+                        };
+                    };
+                };
+                additions: {
+                    type: string;
+                    description: string;
+                };
+                deletions: {
+                    type: string;
+                    description: string;
+                };
+                paths?: undefined;
+                globs?: undefined;
+                values?: undefined;
+                value?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                paths: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                globs: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                files?: undefined;
+                additions?: undefined;
+                deletions?: undefined;
+                values?: undefined;
+                value?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                values: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                value: {
+                    type: string;
+                    description: string;
+                };
+                files?: undefined;
+                additions?: undefined;
+                deletions?: undefined;
+                paths?: undefined;
+                globs?: undefined;
+            };
+            required: string[];
+        };
+    })[];
+}
+export default codeStatsSkill;

package/dist/codeStats.js

@@ -0,0 +1,19 @@
+import{existsSync as _}from"fs";import{fileURLToPath as v}from"url";import{dirname as x,resolve as k}from"path";function w(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let s=x(v(import.meta.url)),e=k(s,"..","bin","mcp-skill.mjs");return _(e)?e:null}var S=[{name:"trivial",max:5},{name:"small",max:30},{name:"medium",max:150},{name:"large",max:600},{name:"huge",max:1/0}];function N(s,e){let t=(Number(s)||0)+(Number(e)||0);for(let o of S)if(t<=o.max)return o.name;return"huge"}function T(s){let t=String(s||"").toLowerCase().split("/").pop()||"",o=t.match(/\.(test|spec)\.[a-z0-9]+$/);if(o)return`.${o[1]}`;let i=t.lastIndexOf(".");return i<=0?/^(dockerfile|makefile|jenkinsfile|procfile|gemfile|rakefile)$/i.test(t)?t.toLowerCase():"":t.slice(i)}var C={code:[".js",".jsx",".ts",".tsx",".mjs",".cjs",".py",".go",".rs",".java",".kt",".rb",".php",".c",".cc",".cpp",".h",".hpp",".cs",".swift",".scala",".m",".dart",".ex",".exs",".clj",".sh",".bash"],test:[".test",".spec"],docs:[".md",".mdx",".rst",".txt",".adoc"],config:[".json",".yml",".yaml",".toml",".ini",".env",".cfg",".conf",".lock",".xml",".properties","dockerfile","makefile","jenkinsfile","procfile",".tf",".gradle"],style:[".css",".scss",".sass",".less",".styl"],data:[".csv",".tsv",".sql",".parquet",".proto",".graphql",".gql"]},P=(()=>{let s={};for(let[e,t]of Object.entries(C))for(let o of t)s[o]=e;return s})();function j(s){return P[String(s||"").toLowerCase()]||"other"}function E(s,e={}){let t=Array.isArray(s)?s:[],o=[],i={},n={code:0,test:0,docs:0,config:0,style:0,data:0,other:0},a=0,m=0,c={path:"",changed:-1};for(let r of t){if(!r||typeof r!="object")continue;let l=String(r.path||r.newPath||r.filename||r.new_path||"").trim();if(!l)continue;o.push(l);let g=Number(r.additions??r.add??0)||0,b=Number(r.deletions??r.del??0)||0;a+=g,m+=b;let d=T(l);i[d||"(none)"]=(i[d||"(none)"]||0)+1,n[j(d)]+=1;let y=g+b;y>c.changed&&(c={path:l,changed:y})}let p=Number(e.additions),u=Number(e.deletions),h=Number.isFinite(p)?p:a,f=Number.isFinite(u)?u:m;return{filesChanged:o.length,filePaths:o,extCounts:i,kindCounts:n,additions:h,deletions:f,sizeBucket:N(h,f),largestFile:c.path||null,dirs:[...new Set(o.map(r=>r.includes("/")?r.split("/")[0]:"(root)"))].sort()}}function O(s){let e="",t=String(s||"");for(let o=0;o<t.length;o++){let i=t[o];i==="*"?t[o+1]==="*"?(e+=".*",o++,t[o+1]==="/"&&o++):e+="[^/]*":i==="?"?e+="[^/]":"\\^$.|+()[]{}".includes(i)?e+=`\\${i}`:e+=i}return new RegExp(`^${e}$`)}function A(s,e){let t=Array.isArray(s)?s.map(String):[],o=(Array.isArray(e)?e:[]).filter(Boolean).map(O);if(!o.length)return{total:t.length,hits:0,ratio:0,matched:[]};let i=t.filter(n=>o.some(a=>a.test(n)));return{total:t.length,hits:i.length,ratio:t.length?Number((i.length/t.length).toFixed(4)):0,matched:i}}function L(s,e){let t=(Array.isArray(s)?s:[]).map(Number).filter(n=>Number.isFinite(n)),o=Number(e);if(!t.length||!Number.isFinite(o))return null;let i=t.filter(n=>n<=o).length;return Number((i/t.length*100).toFixed(1))}var R={id:"code-stats",serverName:"code_stats",allowedTools:["mcp__code_stats__*"],description:"Deterministic code statistics \u2014 pure, reproducible facts from changed-file lists + numbers (extension/work-kind mix, size bucket, core-path glob coverage, percentile rank). Zero LLM, zero network.",promptFragment:`## Code Stats (DETERMINISTIC facts \u2014 pure, reproducible, zero-LLM)
+These tools COMPUTE reproducible facts from data you already have. Use them so
+your numbers are auditable and survive challenge (same input \u2192 same output).
+
+Tools:
+- code_stats_commit_facts: Given a commit's changed \`files\` list
+  ([{path, additions, deletions}] \u2014 exactly what gitlab_get_commit /
+  github_get_commit return), returns { filePaths, extCounts, kindCounts
+  (code/test/docs/config/style/data/other), additions, deletions, sizeBucket,
+  largestFile, dirs }. Call this for EVERY commit you meter and PERSIST the raw
+  facts (filePaths as JSON, kindCounts, sizeBucket) \u2014 they're free now and let
+  any later analysis run without re-fetching.
+- code_stats_glob_hit: Given \`paths\` + \`globs\` (e.g. ["src/payment/**",
+  "auth/**"]), returns { hits, ratio, matched }. Use at REPORT time to compute
+  each person's CORE-PATH coverage against the caller's own core globs \u2014 a
+  reproducible "works in the core vs the edges" number.
+- code_stats_percentile: Given \`values\` (a cohort's numbers) + a \`value\`,
+  returns the 0-100 percentile rank. Use to express every metric as a rank
+  within the team (reproducible + comparable across teams), not a raw number.`,resolve(){let s=w();return s?{type:"stdio",command:"node",args:[s,"../dist/codeStats.js","codeStatsSkill"],env:{},description:this.description,alwaysLoad:!0}:{command:null,args:[],env:{},description:this.description}},async handleToolCall(s,e){try{switch(s){case"code_stats_commit_facts":return JSON.stringify(E(e?.files,{additions:e?.additions,deletions:e?.deletions}));case"code_stats_glob_hit":return JSON.stringify(A(e?.paths,e?.globs));case"code_stats_percentile":return JSON.stringify({percentile:L(e?.values,e?.value)});default:return JSON.stringify({error:`Unknown tool: ${s}`})}}catch(t){return JSON.stringify({error:t.message})}},tools:[{name:"code_stats_commit_facts",description:"Deterministic per-commit facts from its changed-file list. Pass files: [{path, additions, deletions}] (gitlab_get_commit / github_get_commit shape). Returns filePaths, extCounts, kindCounts (code/test/docs/config/style/data/other), additions, deletions, sizeBucket (trivial/small/medium/large/huge), largestFile, dirs. Pure \u2014 same input always same output.",input_schema:{type:"object",properties:{files:{type:"array",description:"Changed files. Each { path (or newPath/filename), additions?, deletions? }.",items:{type:"object",properties:{path:{type:"string"},additions:{type:"number"},deletions:{type:"number"}}}},additions:{type:"number",description:"Optional commit-level total additions override (else summed from files)."},deletions:{type:"number",description:"Optional commit-level total deletions override."}},required:["files"]}},{name:"code_stats_glob_hit",description:"How many of paths match ANY of globs (supports **, *, ?). Returns { total, hits, ratio, matched }. Use for reproducible core-path coverage against the caller's own core globs.",input_schema:{type:"object",properties:{paths:{type:"array",items:{type:"string"},description:"File paths to test."},globs:{type:"array",items:{type:"string"},description:'Glob patterns, e.g. ["src/payment/**", "auth/**"].'}},required:["paths","globs"]}},{name:"code_stats_percentile",description:'The 0-100 percentile rank of value within values (cumulative "% at or below"). Reproducible + cross-team comparable. Empty cohort \u2192 null.',input_schema:{type:"object",properties:{values:{type:"array",items:{type:"number"},description:"The cohort's numbers."},value:{type:"number",description:"The value to rank."}},required:["values","value"]}}]},B=R;export{R as codeStatsSkill,E as commitFacts,B as default,j as extKind,T as fileExtension,A as globHit,O as globToRegExp,L as percentileRank,N as sizeBucket};

package/dist/index.d.ts

@@ -25,6 +25,7 @@ import { kvMemorySkill } from './kvMemory.js';
 import { datasetStoreSkill } from './datasetStore.js';
 import { artifactSkill } from './artifact.js';
 import { chartRenderSkill } from './chartRender.js';
+import { codeStatsSkill } from './codeStats.js';
 import { socialCardSkill } from './socialCard.js';
 import { codeScanSkill } from './code-scan.js';
 import { codebaseMemorySkill } from './codebaseMemory.js';
@@ -33,7 +34,7 @@ import { testRunnerSkill } from './test-runner.js';
 import { skillInstallerSkill } from './skill-installer.js';
 import { coreToolsSkill } from './core-tools.js';
 import { workflowBuilderSkill } from './workflow-builder.js';
-export { browserSkill, jiraSkill, githubSkill, gitlabSkill, figmaSkill, hubspotSkill, linearSkill, planeSkill, opendesignSkill, gitSkill, gitWriteSkill, slackSkill, larkSkill, discordSkill, notionSkill, linkedinSkill, googleDocsSkill, larkDocsSkill, chatNotifySkill, sentrySkill, memorySkill, chatMemorySkill, kvMemorySkill, datasetStoreSkill, artifactSkill, chartRenderSkill, socialCardSkill, codeScanSkill, codebaseMemorySkill, gbrainSkill, testRunnerSkill, testRunnerSkill as runnerSkill, skillInstallerSkill, coreToolsSkill, workflowBuilderSkill };
+export { browserSkill, jiraSkill, githubSkill, gitlabSkill, figmaSkill, hubspotSkill, linearSkill, planeSkill, opendesignSkill, gitSkill, gitWriteSkill, slackSkill, larkSkill, discordSkill, notionSkill, linkedinSkill, googleDocsSkill, larkDocsSkill, chatNotifySkill, sentrySkill, memorySkill, chatMemorySkill, kvMemorySkill, datasetStoreSkill, artifactSkill, chartRenderSkill, codeStatsSkill, socialCardSkill, codeScanSkill, codebaseMemorySkill, gbrainSkill, testRunnerSkill, testRunnerSkill as runnerSkill, skillInstallerSkill, coreToolsSkill, workflowBuilderSkill };
 export { openaiBillingSkill, anthropicBillingSkill, cursorAdminSkill, fetchOpenAICosts, fetchOpenAIProjects, fetchAnthropicCosts, fetchAnthropicWorkspaces, fetchCursorSpend, fetchAllProviders, groupByKey, meanStddev } from "./llm-billing.js";
 export { reportObjectSchema, reportToBlockKit, reportToLarkCard, reportToNotionBlocks, reportToMarkdown, SEVERITIES as REPORT_SEVERITIES } from "./report.js";
 export { skill, functionSkill } from "./function-skill.js";