@seanmars/tospec 0.19.0-beta.0 → 0.19.0-beta.13

package/dist/core/shared/tool-detection.d.ts

@@ -1,93 +1,71 @@
 /**
- * Tool Detection Utilities
- *
- * Shared utilities for detecting tool configurations and version status.
- */
-/**
- * Names of skill directories created by tospec init, derived from the one
- * workflow registry. Project-scope skills can't be nested, so they live flat
- * and prefixed at `<tool.skillsDir>/skills/tospec-<workflow>/SKILL.md`.
+ * Skill directories `tospec init` creates, derived from the one workflow registry.
+ * Project-scope skills can't be nested, so they live flat and prefixed at
+ * `<tool.skillsDir>/skills/tospec-<workflow>/SKILL.md`.
  */
 export declare const SKILL_NAMES: readonly string[];
 /**
- * Canonical skill directory names tospec used to create but no longer does.
- * Cleaned up on init/update so an upgrade leaves no orphan dirs behind in
- * `.agents/skills/`. verify was folded into apply; reconcile was renamed back
- * to sync, so its dir must go rather than sit beside the new one.
+ * Skill directories tospec used to create but no longer does; removed on
+ * init/update so an upgrade leaves no orphans.
  *
- * A name generated by WORKFLOW_DEFS must never appear here: removeLegacySkillDirs
- * runs on every init/update, so an overlap would delete the skill the same run
- * just wrote — silently, surfacing later as a missing skill rather than an error.
- * That is why `tospec-sync` came out of this list when the reconcile rename was
- * reverted, instead of `tospec-reconcile` simply being appended.
- */
-export declare const LEGACY_SKILL_DIRS: readonly ["tospec-verify", "tospec-reconcile"];
-/**
- * Status of skill configuration for a tool.
+ * A name WORKFLOW_DEFS generates must never appear here: removeLegacySkillDirs
+ * runs on every init/update, so an overlap deletes the skill the run just wrote.
  */
+export declare const LEGACY_SKILL_DIRS: readonly ['tospec-verify', 'tospec-reconcile'];
 export interface ToolSkillStatus {
-    /** Whether the tool has any skills configured */
+    /** The tool has at least one skill. */
     configured: boolean;
-    /** Whether all skills are configured */
+    /** The tool has every skill in SKILL_NAMES. */
     fullyConfigured: boolean;
-    /** Number of skills currently configured */
     skillCount: number;
 }
-/**
- * Version information for a tool's skills.
- */
 export interface ToolVersionStatus {
-    /** The tool ID */
     toolId: string;
-    /** The tool's display name */
     toolName: string;
-    /** Whether the tool has any skills configured */
     configured: boolean;
-    /** The generatedBy version found in the skill files, or null if not found */
+    /** The `generatedBy` frontmatter found in the skill files, or null. */
     generatedByVersion: string | null;
-    /** Whether the tool needs updating (version mismatch or missing) */
+    /** Version mismatched or missing. */
     needsUpdate: boolean;
 }
-/**
- * Removes any legacy skill directories (see LEGACY_SKILL_DIRS) from the given
- * skills directory. Idempotent — safe to call when they don't exist. Used by
- * init/update so upgrades leave no orphan verify/sync dirs behind.
- */
+/** Idempotent: safe when the legacy dirs do not exist. */
 export declare function removeLegacySkillDirs(skillsDir: string): Promise<number>;
 /**
- * Removes the intermediate grouped skill layouts from earlier builds so an
- * upgrade lands cleanly at the current flat `<toolBaseDir>/skills/tospec-<workflow>/`
- * location (project-scope skills can't be nested in a sub-folder). Removes:
- *   1. the grouped layout `<toolBaseDir>/skills/tospec/<workflow>/`
- *   2. the no-`skills/`-layer layout `<toolBaseDir>/tospec/<workflow>/`
- * The current flat `skills/tospec-<workflow>/` dirs are left alone (they're
- * refreshed by the link loop; a retired one like tospec-verify is handled by
- * removeLegacySkillDirs).
+ * Removes the skill directories for workflows the active profile does not select.
+ *
+ * Shared by `init` and `update`: agents load skills from the skill directory, so
+ * a run that prunes only `.claude/commands/tosx/` leaves excluded workflows
+ * loadable.
+ *
+ * ALL_WORKFLOWS and the directory naming are derived here rather than passed in,
+ * since a caller supplying either is a copy that can fall behind WORKFLOW_DEFS.
  */
-export declare function removeLegacyToolSkillLayout(toolBaseDir: string): Promise<number>;
+export declare function removeUnselectedSkillDirs(skillsDir: string, desiredWorkflows: readonly string[]): Promise<number>;
 /**
- * Gets the list of tools with skillsDir configured.
+ * Removes the grouped skill layouts earlier builds wrote, so an upgrade lands at
+ * the current flat `<toolBaseDir>/skills/tospec-<workflow>/`. The flat dirs are
+ * left alone: the copy loop refreshes them, and retired ones go via
+ * removeLegacySkillDirs.
  */
+export declare function removeLegacyToolSkillLayout(toolBaseDir: string): Promise<number>;
 export declare function getToolsWithSkillsDir(): string[];
-/**
- * Checks which skill files exist for a tool.
- */
 export declare function getToolSkillStatus(projectRoot: string, toolId: string): ToolSkillStatus;
-/**
- * Gets the skill status for all tools with skillsDir configured.
- */
 export declare function getToolStates(projectRoot: string): Map<string, ToolSkillStatus>;
-/**
- * Extracts the generatedBy version from a skill file's YAML frontmatter.
- * Returns null if the field is not found or the file doesn't exist.
- */
+/** Null when the field is absent or the file cannot be read. */
 export declare function extractGeneratedByVersion(skillFilePath: string): string | null;
-/**
- * Gets version status for a tool by reading the first available skill file.
- */
+/** Reads the version from the first skill file the tool has. */
 export declare function getToolVersionStatus(projectRoot: string, toolId: string, currentVersion: string): ToolVersionStatus;
+export declare function getConfiguredTools(projectRoot: string): string[];
 /**
- * Gets all configured tools in the project.
+ * Whether tospec has been installed into this tool dir, independent of how many
+ * skills sit there — the right question for `update`/`rules`, where
+ * `getToolSkillStatus().configured` is wrong: a profile selecting no workflows
+ * makes `update` remove every skill dir, erasing the evidence the tool was set
+ * up. tospec/decisions/20260916_152000-tool-install-marker-not-skill-count.md
+ *
+ * The workflow rule document is the durable marker: written on every
+ * init/update/rules, removed by none. The legacy `rules/tospec/decision.md` is
+ * init-only, so it proves tospec once touched the dir, not that it manages it.
  */
-export declare function getConfiguredTools(projectRoot: string): string[];
+export declare function isToolInstalled(projectRoot: string, toolId: string): boolean;
 //# sourceMappingURL=tool-detection.d.ts.map

package/dist/core/shared/tool-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-detection.d.ts","sourceRoot":"","sources":["../../../src/core/shared/tool-detection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAA4C,CAAC;AAEtF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,gDAAiD,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,eAAe,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oEAAoE;IACpE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc9E;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBtF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAqBvF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAS/E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2B9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,iBAAiB,CAkCnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAIhE"}
+{"version":3,"file":"tool-detection.d.ts","sourceRoot":"","sources":["../../../src/core/shared/tool-detection.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAA4C,CAAC;AAEtF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,YAAI,eAAe,EAAE,kBAAkB,CAAU,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,uEAAuE;IACvE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,qCAAqC;IACrC,WAAW,EAAE,OAAO,CAAC;CACtB;AAsBD,0DAA0D;AAC1D,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE9E;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,OAAO,CAAC,MAAM,CAAC,CASjB;AAsBD;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKtF;AAED,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAqBvF;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAQ/E;AAED,gEAAgE;AAChE,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiB9E;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,iBAAiB,CAiCnB;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAIhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAS5E"}

package/dist/core/shared/tool-detection.js

@@ -1,40 +1,29 @@
-/**
- * Tool Detection Utilities
- *
- * Shared utilities for detecting tool configurations and version status.
- */
 import path from 'path';
 import * as fs from 'fs';
-import { AI_TOOLS } from '../config.js';
+import { AI_TOOLS, LEGACY_WORKFLOW_RULE_FILENAME, TOOL_RULES_SUBDIR, WORKFLOW_RULE_FILENAME, } from '../config.js';
 import { ALL_WORKFLOWS, workflowSkillDirName } from './skill-generation.js';
 /**
- * Names of skill directories created by tospec init, derived from the one
- * workflow registry. Project-scope skills can't be nested, so they live flat
- * and prefixed at `<tool.skillsDir>/skills/tospec-<workflow>/SKILL.md`.
+ * Skill directories `tospec init` creates, derived from the one workflow registry.
+ * Project-scope skills can't be nested, so they live flat and prefixed at
+ * `<tool.skillsDir>/skills/tospec-<workflow>/SKILL.md`.
  */
 export const SKILL_NAMES = ALL_WORKFLOWS.map(workflowSkillDirName);
 /**
- * Canonical skill directory names tospec used to create but no longer does.
- * Cleaned up on init/update so an upgrade leaves no orphan dirs behind in
- * `.agents/skills/`. verify was folded into apply; reconcile was renamed back
- * to sync, so its dir must go rather than sit beside the new one.
+ * Skill directories tospec used to create but no longer does; removed on
+ * init/update so an upgrade leaves no orphans.
  *
- * A name generated by WORKFLOW_DEFS must never appear here: removeLegacySkillDirs
- * runs on every init/update, so an overlap would delete the skill the same run
- * just wrote — silently, surfacing later as a missing skill rather than an error.
- * That is why `tospec-sync` came out of this list when the reconcile rename was
- * reverted, instead of `tospec-reconcile` simply being appended.
+ * A name WORKFLOW_DEFS generates must never appear here: removeLegacySkillDirs
+ * runs on every init/update, so an overlap deletes the skill the run just wrote.
  */
 export const LEGACY_SKILL_DIRS = ['tospec-verify', 'tospec-reconcile'];
 /**
- * Removes any legacy skill directories (see LEGACY_SKILL_DIRS) from the given
- * skills directory. Idempotent — safe to call when they don't exist. Used by
- * init/update so upgrades leave no orphan verify/sync dirs behind.
+ * Removes each directory that exists and reports how many went. Errors are
+ * swallowed per directory: one that cannot be removed must not abort an init
+ * that has otherwise succeeded.
  */
-export async function removeLegacySkillDirs(skillsDir) {
+async function removeDirs(dirs) {
     let removed = 0;
-    for (const dirName of LEGACY_SKILL_DIRS) {
-        const dir = path.join(skillsDir, dirName);
+    for (const dir of dirs) {
         try {
             if (fs.existsSync(dir)) {
                 await fs.promises.rm(dir, { recursive: true, force: true });
@@ -42,49 +31,69 @@ export async function removeLegacySkillDirs(skillsDir) {
             }
         }
         catch {
-            // Ignore errors
+            // Best effort, per the note above.
         }
     }
     return removed;
 }
+/** Idempotent: safe when the legacy dirs do not exist. */
+export async function removeLegacySkillDirs(skillsDir) {
+    return removeDirs(LEGACY_SKILL_DIRS.map((dirName) => path.join(skillsDir, dirName)));
+}
 /**
- * Removes the intermediate grouped skill layouts from earlier builds so an
- * upgrade lands cleanly at the current flat `<toolBaseDir>/skills/tospec-<workflow>/`
- * location (project-scope skills can't be nested in a sub-folder). Removes:
- *   1. the grouped layout `<toolBaseDir>/skills/tospec/<workflow>/`
- *   2. the no-`skills/`-layer layout `<toolBaseDir>/tospec/<workflow>/`
- * The current flat `skills/tospec-<workflow>/` dirs are left alone (they're
- * refreshed by the link loop; a retired one like tospec-verify is handled by
- * removeLegacySkillDirs).
+ * Removes the skill directories for workflows the active profile does not select.
+ *
+ * Shared by `init` and `update`: agents load skills from the skill directory, so
+ * a run that prunes only `.claude/commands/tosx/` leaves excluded workflows
+ * loadable.
+ *
+ * ALL_WORKFLOWS and the directory naming are derived here rather than passed in,
+ * since a caller supplying either is a copy that can fall behind WORKFLOW_DEFS.
  */
-export async function removeLegacyToolSkillLayout(toolBaseDir) {
-    let removed = 0;
-    const legacyDirs = [
-        path.join(toolBaseDir, 'skills', 'tospec'), // grouped: <tool>/skills/tospec/<workflow>
-        path.join(toolBaseDir, 'tospec'), // bare:    <tool>/tospec/<workflow>
-    ];
-    for (const dir of legacyDirs) {
-        try {
-            if (fs.existsSync(dir)) {
-                await fs.promises.rm(dir, { recursive: true, force: true });
-                removed++;
-            }
-        }
-        catch {
-            // Ignore errors
-        }
+export async function removeUnselectedSkillDirs(skillsDir, desiredWorkflows) {
+    const desiredSet = new Set(desiredWorkflows);
+    const unselected = ALL_WORKFLOWS
+        .filter((workflow) => !desiredSet.has(workflow))
+        .map(workflowSkillDirName)
+        .filter((dirName) => dirName)
+        .map((dirName) => path.join(skillsDir, dirName));
+    return removeDirs([...unselected, ...staleGeneratedSkillDirs(skillsDir)]);
+}
+/**
+ * `tospec-*` skill directories this version does not generate but an earlier
+ * one did — a workflow renamed or dropped since. Recognised by the
+ * `generatedBy` frontmatter: a hand-written skill carries none and is left
+ * alone, because nothing else would ever restore it.
+ */
+function staleGeneratedSkillDirs(skillsDir) {
+    let entries;
+    try {
+        entries = fs.readdirSync(skillsDir, { withFileTypes: true });
     }
-    return removed;
+    catch {
+        return [];
+    }
+    const known = new Set([...SKILL_NAMES, ...LEGACY_SKILL_DIRS]);
+    return entries
+        .filter((entry) => entry.isDirectory() && entry.name.startsWith('tospec-') && !known.has(entry.name))
+        .map((entry) => path.join(skillsDir, entry.name))
+        .filter((dir) => extractGeneratedByVersion(path.join(dir, 'SKILL.md')) !== null);
 }
 /**
- * Gets the list of tools with skillsDir configured.
+ * Removes the grouped skill layouts earlier builds wrote, so an upgrade lands at
+ * the current flat `<toolBaseDir>/skills/tospec-<workflow>/`. The flat dirs are
+ * left alone: the copy loop refreshes them, and retired ones go via
+ * removeLegacySkillDirs.
  */
+export async function removeLegacyToolSkillLayout(toolBaseDir) {
+    return removeDirs([
+        path.join(toolBaseDir, 'skills', 'tospec'), // grouped: <tool>/skills/tospec/<workflow>
+        path.join(toolBaseDir, 'tospec'), // bare:    <tool>/tospec/<workflow>
+    ]);
+}
 export function getToolsWithSkillsDir() {
     return AI_TOOLS.filter((t) => t.skillsDir).map((t) => t.value);
 }
-/**
- * Checks which skill files exist for a tool.
- */
 export function getToolSkillStatus(projectRoot, toolId) {
     const tool = AI_TOOLS.find((t) => t.value === toolId);
     if (!tool?.skillsDir) {
@@ -104,36 +113,20 @@ export function getToolSkillStatus(projectRoot, toolId) {
         skillCount,
     };
 }
-/**
- * Gets the skill status for all tools with skillsDir configured.
- */
 export function getToolStates(projectRoot) {
     const states = new Map();
-    const toolIds = AI_TOOLS.filter((t) => t.skillsDir).map((t) => t.value);
-    for (const toolId of toolIds) {
+    for (const toolId of getToolsWithSkillsDir()) {
         states.set(toolId, getToolSkillStatus(projectRoot, toolId));
     }
     return states;
 }
-/**
- * Extracts the generatedBy version from a skill file's YAML frontmatter.
- * Returns null if the field is not found or the file doesn't exist.
- */
+/** Null when the field is absent or the file cannot be read. */
 export function extractGeneratedByVersion(skillFilePath) {
     try {
         if (!fs.existsSync(skillFilePath)) {
             return null;
         }
         const content = fs.readFileSync(skillFilePath, 'utf-8');
-        // Look for generatedBy in the YAML frontmatter
-        // The file format is:
-        // ---
-        // ...
-        // metadata:
-        //   author: tospec
-        //   version: "1.0"
-        //   generatedBy: "0.23.0"
-        // ---
         const generatedByMatch = content.match(/^\s*generatedBy:\s*["']?([^"'\n]+)["']?\s*$/m);
         if (generatedByMatch && generatedByMatch[1]) {
             return generatedByMatch[1].trim();
@@ -144,9 +137,7 @@ export function extractGeneratedByVersion(skillFilePath) {
         return null;
     }
 }
-/**
- * Gets version status for a tool by reading the first available skill file.
- */
+/** Reads the version from the first skill file the tool has. */
 export function getToolVersionStatus(projectRoot, toolId, currentVersion) {
     const tool = AI_TOOLS.find((t) => t.value === toolId);
     if (!tool?.skillsDir) {
@@ -160,7 +151,6 @@ export function getToolVersionStatus(projectRoot, toolId, currentVersion) {
     }
     const skillsDir = path.join(projectRoot, tool.skillsDir, 'skills');
     let generatedByVersion = null;
-    // Find the first skill file that exists and read its version
     for (const skillName of SKILL_NAMES) {
         const skillFile = path.join(skillsDir, skillName, 'SKILL.md');
         if (fs.existsSync(skillFile)) {
@@ -178,12 +168,30 @@ export function getToolVersionStatus(projectRoot, toolId, currentVersion) {
         needsUpdate,
     };
 }
-/**
- * Gets all configured tools in the project.
- */
 export function getConfiguredTools(projectRoot) {
     return AI_TOOLS
-        .filter((t) => t.skillsDir && getToolSkillStatus(projectRoot, t.value).configured)
+        .filter((t) => t.skillsDir && isToolInstalled(projectRoot, t.value))
         .map((t) => t.value);
 }
+/**
+ * Whether tospec has been installed into this tool dir, independent of how many
+ * skills sit there — the right question for `update`/`rules`, where
+ * `getToolSkillStatus().configured` is wrong: a profile selecting no workflows
+ * makes `update` remove every skill dir, erasing the evidence the tool was set
+ * up. tospec/decisions/20260916_152000-tool-install-marker-not-skill-count.md
+ *
+ * The workflow rule document is the durable marker: written on every
+ * init/update/rules, removed by none. The legacy `rules/tospec/decision.md` is
+ * init-only, so it proves tospec once touched the dir, not that it manages it.
+ */
+export function isToolInstalled(projectRoot, toolId) {
+    const tool = AI_TOOLS.find((t) => t.value === toolId);
+    if (!tool?.skillsDir)
+        return false;
+    if (getToolSkillStatus(projectRoot, toolId).configured)
+        return true;
+    // Either spelling: a project last touched before the filename typo was fixed
+    // holds the legacy name, which is just as much proof of an install.
+    return [WORKFLOW_RULE_FILENAME, LEGACY_WORKFLOW_RULE_FILENAME].some((name) => fs.existsSync(path.join(projectRoot, tool.skillsDir, ...TOOL_RULES_SUBDIR, name)));
+}
 //# sourceMappingURL=tool-detection.js.map

package/dist/core/shared/tool-detection.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-detection.js","sourceRoot":"","sources":["../../../src/core/shared/tool-detection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-detection.js","sourceRoot":"","sources":["../../../src/core/shared/tool-detection.ts"],"names":[],"mappings":"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"}

package/dist/core/skill-metrics.d.ts

@@ -1,31 +1,21 @@
 /**
  * Skill duration metrics, derived from Claude Code transcripts.
  *
- * There is no tospec-side event to measure. The CLI is stateless by design
- * (status comes from file existence), so it never learns when a workflow
- * starts or ends — and CLI-call telemetry would miss the workflows that
- * barely touch the CLI at all: `grill` only ever runs `tospec list`, and
- * `explore` only an optional `tospec decision new`.
+ * There is no tospec-side event to measure: the CLI is stateless, so it never
+ * learns when a workflow starts or ends, and CLI-call telemetry would miss the
+ * workflows that barely touch it. Every transcript entry in
+ * `<config>/projects/<encoded-cwd>/<session>.jsonl` already carries an
+ * `attributionSkill`, so this is a read-only analysis of existing data. The
+ * field is recent, so older sessions yield no runs — reported, not hidden.
  *
- * Claude Code already records what we need. Every transcript entry in
- * `<config>/projects/<encoded-cwd>/<session>.jsonl` carries an
- * `attributionSkill` field naming the skill that entry belongs to, so skill
- * timing is a read-only analysis of data that already exists — retroactively,
- * with nothing to install. The cost is that the field is recent: sessions
- * predating it yield no runs, which is reported rather than hidden.
- *
- * Two durations are reported per run because they answer different questions
- * and diverge sharply in conversational workflows:
+ * Two durations per run, because they diverge sharply in conversational
+ * workflows:
  *
  * - `span`    — wall clock, first to last entry. "How long did this take?"
  * - `engaged` — span minus gaps over `idleGapMs`. "How much of that was work?"
  *
- * An interview loop like `grill` idles while the user thinks, so its span runs
- * well above its engaged time; a continuous `apply` pass has the two nearly
- * equal. Reporting only one of them would silently answer the other question.
- *
- * Pure parsing/aggregation is split from the directory-reading wrapper so
- * vitest can exercise it without a transcript store on disk.
+ * Pure parsing/aggregation is split from the directory-reading wrapper so tests
+ * can exercise it without a transcript store on disk.
  */
 /** Gap above which the user is considered away, excluded from `engaged`. */
 export declare const DEFAULT_IDLE_GAP_MS: number;
@@ -42,10 +32,9 @@ export interface TranscriptEntry {
     skill: string | null;
 }
 /**
- * Which tool a run's timing was derived from. Claude Code's `attributionSkill`
- * is read directly from recorded data; Codex's is inferred by a heuristic
- * (see codex-metrics.ts) — the two are never combined into one figure because
- * they carry different confidence.
+ * Which tool a run's timing came from. Claude Code's `attributionSkill` is read
+ * directly; Codex's is inferred by a heuristic (codex-metrics.ts), so the two
+ * carry different confidence and are never combined into one figure.
  */
 export type MetricsSourceKind = 'claude-code' | 'codex';
 export interface SkillRun {
@@ -103,8 +92,8 @@ export interface RunGroupingOptions {
 /**
  * Claude Code's per-project transcript directory name: the absolute cwd with
  * every non-alphanumeric character replaced by `-`. `D:\workspace\a.b` becomes
- * `D--workspace-a-b` (the drive colon and the separator each contribute a dash,
- * which is why the doubled dash is correct and not a bug).
+ * `D--workspace-a-b` — the drive colon and the separator each contribute a dash,
+ * so the doubled dash is correct.
  */
 export declare function encodeProjectDirName(rootPath: string): string;
 export interface TranscriptDirOptions {
@@ -112,57 +101,46 @@ export interface TranscriptDirOptions {
     homedir?: string;
 }
 /**
- * Locates the transcript directory for a project root. `CLAUDE_CONFIG_DIR` is
- * honoured because Claude Code itself does; without it the default is
- * `~/.claude`. Injectable env/homedir follows global-config.ts so path
- * resolution stays testable.
+ * The transcript directory for a project root. `CLAUDE_CONFIG_DIR` is honoured
+ * because Claude Code itself does; without it the default is `~/.claude`.
  */
 export declare function resolveTranscriptDir(rootPath: string, options?: TranscriptDirOptions): string;
 /**
  * Collapses the two names one workflow is recorded under — the slash command
- * (`tosx:apply`) and the skill (`tospec-apply`) — onto the workflow id. Without
- * this every workflow's history is split across two unrelated-looking rows.
+ * (`tosx:apply`) and the skill (`tospec-apply`) — onto the workflow id, so its
+ * history is one row rather than two.
  */
 export declare function normalizeSkillName(raw: string): string;
 export declare function isWorkflowSkill(skill: string): boolean;
 /**
  * Parses one `.jsonl` transcript into timestamped entries, sorted by time.
  * Malformed lines are skipped rather than fatal: transcripts are an append-only
- * log written by another process and can be torn at the tail while a session
- * is live.
+ * log written by another process and can be torn at the tail.
  */
 export declare function parseTranscript(text: string): TranscriptEntry[];
 /**
- * Groups one session's entries into runs.
+ * Groups one session's entries into runs. Two rules carry the design:
  *
- * Two rules carry the whole design:
- *
- * - An **unattributed** entry does not end a run. Tool results and the user's
- *   own messages carry no `attributionSkill`, so treating them as boundaries
- *   shatters a single 30-minute `apply` into a hundred two-entry fragments.
- *   They are folded into the open run instead, because they are its work.
- * - A **different skill** does end a run. Grouping all of one skill's entries
- *   by min/max instead would make an A → B → A sequence count B's elapsed time
- *   inside A's engaged total. Splitting keeps run windows disjoint, at the cost
- *   of reporting a re-entered skill as several runs.
+ * - An **unattributed** entry does not end a run. Tool results and user messages
+ *   carry no `attributionSkill`, so treating them as boundaries shatters a
+ *   30-minute `apply` into fragments.
+ * - A **different skill** does end a run. Grouping by min/max instead would
+ *   count B's elapsed time inside A's engaged total for an A → B → A sequence.
+ *   The cost is reporting a re-entered skill as several runs.
  *
  * A run is additionally split at any internal gap over `splitGapMs`.
  */
 export declare function buildRuns(entries: TranscriptEntry[], session: string, options?: RunGroupingOptions): SkillRun[];
 /**
- * The composite key identifying one report row: a skill under one source.
- * Shared by aggregation, the daily/weekly/monthly series, and the frontend
- * (which reproduces this exact format in JS, since it cannot import a TS
- * module) — one definition of "row" everywhere a skill and its source must
- * be kept apart rather than merged.
+ * The composite key for one report row: a skill under one source. The frontend
+ * reproduces this format in JS (it cannot import a TS module), so keep the two
+ * in step.
  */
 export declare function skillRowKey(skill: string, source: MetricsSourceKind): string;
 /**
- * Aggregates runs per skill-and-source pair, ordered by total engaged time
- * (descending). Grouping by source too, not by skill alone, is what keeps a
- * skill run under both tools from being summed into one figure — Claude
- * Code's attribution and Codex's heuristic one carry different confidence and
- * must stay distinguishable everywhere a skill is reported.
+ * Aggregates runs per skill-and-source pair, by total engaged time descending.
+ * Grouping by source keeps a skill run under both tools from summing into one
+ * figure, since the two carry different confidence.
  */
 export declare function aggregateRuns(runs: SkillRun[]): SkillAggregate[];
 export interface CollectMetricsOptions extends RunGroupingOptions, TranscriptDirOptions {
@@ -172,14 +150,9 @@ export interface CollectMetricsOptions extends RunGroupingOptions, TranscriptDir
 /**
  * Reads every transcript for a project root and derives skill timings.
  *
- * Every skill found is reported, tospec's own workflows and unrelated ones
- * alike — there is deliberately no filtering by skill name. `workflow` on each
- * aggregate labels which is which, so a caller that cares can tell them apart
- * without this function deciding for it.
- *
- * A missing transcript directory is a reportable state (`available: false`),
- * not an error: the project may simply never have been opened in Claude Code,
- * and the caller renders that far better than a stack trace.
+ * No filtering by skill name: every skill found is reported, and `workflow` on
+ * each aggregate labels tospec's own. A missing transcript directory is a
+ * reportable state (`available: false`), not an error.
  */
 export declare function collectSkillMetrics(rootPath: string, options?: CollectMetricsOptions): Promise<SkillMetrics>;
 //# sourceMappingURL=skill-metrics.d.ts.map

package/dist/core/skill-metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-metrics.d.ts","sourceRoot":"","sources":["../../src/core/skill-metrics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-metrics.d.ts","sourceRoot":"","sources":["../../src/core/skill-metrics.ts"],"names":[],"mappings":"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"}