@agent-scope/cli 1.19.0 → 1.20.1

package/dist/index.d.cts

@@ -125,6 +125,22 @@ declare function createCiCommand(): Command;
 
 declare function createDoctorCommand(): Command;
 
+/**
+ * get-skill-command.ts
+ *
+ * `scope get-skill` — print the Scope SKILL.md to stdout so an agent can
+ * load it directly into its context without knowing the file path.
+ *
+ * The skill content is embedded at build time by scripts/generate-skill-content.mjs
+ * so this works correctly in any install context (global npm, local node_modules, etc.)
+ *
+ * Usage:
+ *   scope get-skill              # print raw markdown to stdout
+ *   scope get-skill --json       # wrap in JSON { "skill": "<content>" }
+ */
+
+declare function createGetSkillCommand(): Command;
+
 /**
  * @agent-scope/cli — `scope init` command implementation
  *
@@ -184,6 +200,9 @@ interface ReactScopeConfig {
         failOnConsoleErrors: boolean;
         baselinePath: string;
     };
+    icons?: {
+        patterns: string[];
+    };
 }
 interface InitOptions {
     /** Accept all defaults without prompting. */
@@ -303,7 +322,7 @@ interface HooksProfilingResult {
  *
  *   - totalRenders       — total commit count during the interaction window
  *   - uniqueComponents   — distinct component names that re-rendered
- *   - wastedRenders      — re-renders where output was identical (heuristic)
+ *   - wastedRenders      — deprecated heuristic, always null in JSON output
  *   - timing.js          — JS execution time (ms) measured via Performance API
  *   - timing.layout      — Layout/reflow time (ms) measured via PerformanceObserver
  *   - timing.paint       — Paint time (ms) measured via PerformanceObserver
@@ -352,8 +371,14 @@ interface InteractionProfile {
     totalRenders: number;
     /** Number of distinct component names that re-rendered during the window. */
     uniqueComponents: number;
-    /** Estimated number of "wasted" renders (components that re-rendered without output change). */
-    wastedRenders: number;
+    /** Deprecated heuristic field retained for compatibility; always null because it is not directly measured. */
+    wastedRenders: number | null;
+    /** Explicit machine-readable note that wasted render counts are not directly measured. */
+    wastedRendersHeuristic: {
+        measured: false;
+        value: null;
+        note: string;
+    };
     /** Timing breakdown in ms. */
     timing: InteractionTiming;
     /** Layout shift metrics. */
@@ -465,6 +490,8 @@ interface ListRow {
     complexityClass: ComplexityClass;
     hookCount: number;
     contextCount: number;
+    collection?: string;
+    internal: boolean;
 }
 interface QueryRow {
     name: string;
@@ -472,6 +499,8 @@ interface QueryRow {
     complexityClass: ComplexityClass;
     hooks: string;
     contexts: string;
+    collection?: string;
+    internal: boolean;
 }
 /**
  * Minimal glob matcher supporting `*` (any chars except `/`) and `**` (any chars).
@@ -542,4 +571,4 @@ declare function resolveTokenFilePath(fileFlag?: string): string;
  */
 declare function createTokensExportCommand(): Command;
 
-export { CI_EXIT, type CausalityLink, type CiCheckName, type CiCheckResult, type CiExitCode, type CiOptions, type CiResult, type ComponentHookProfile, type HookHeuristicFlag, type HookProfile, type HooksProfilingResult, type InitOptions, type InitResult, type InteractionProfile, type InteractionStep$1 as InteractionStep, type InteractionTiming, type LayoutShiftData, type ListRow, type ProfileHeuristicFlag, type QueryRow, type ReactScopeConfig, type RenderEvent, type RenderTrigger, type RendersAnalysisResult, type ScopeCLIOptions, createCiCommand, createDoctorCommand, createInitCommand, createInstrumentCommand, createManifestCommand, createProgram, createTokensCommand, createTokensExportCommand, formatCiReport, isTTY, matchGlob, resolveTokenFilePath, runCi, runInit };
+export { CI_EXIT, type CausalityLink, type CiCheckName, type CiCheckResult, type CiExitCode, type CiOptions, type CiResult, type ComponentHookProfile, type HookHeuristicFlag, type HookProfile, type HooksProfilingResult, type InitOptions, type InitResult, type InteractionProfile, type InteractionStep$1 as InteractionStep, type InteractionTiming, type LayoutShiftData, type ListRow, type ProfileHeuristicFlag, type QueryRow, type ReactScopeConfig, type RenderEvent, type RenderTrigger, type RendersAnalysisResult, type ScopeCLIOptions, createCiCommand, createDoctorCommand, createGetSkillCommand, createInitCommand, createInstrumentCommand, createManifestCommand, createProgram, createTokensCommand, createTokensExportCommand, formatCiReport, isTTY, matchGlob, resolveTokenFilePath, runCi, runInit };

package/dist/index.d.ts

@@ -125,6 +125,22 @@ declare function createCiCommand(): Command;
 
 declare function createDoctorCommand(): Command;
 
+/**
+ * get-skill-command.ts
+ *
+ * `scope get-skill` — print the Scope SKILL.md to stdout so an agent can
+ * load it directly into its context without knowing the file path.
+ *
+ * The skill content is embedded at build time by scripts/generate-skill-content.mjs
+ * so this works correctly in any install context (global npm, local node_modules, etc.)
+ *
+ * Usage:
+ *   scope get-skill              # print raw markdown to stdout
+ *   scope get-skill --json       # wrap in JSON { "skill": "<content>" }
+ */
+
+declare function createGetSkillCommand(): Command;
+
 /**
  * @agent-scope/cli — `scope init` command implementation
  *
@@ -184,6 +200,9 @@ interface ReactScopeConfig {
         failOnConsoleErrors: boolean;
         baselinePath: string;
     };
+    icons?: {
+        patterns: string[];
+    };
 }
 interface InitOptions {
     /** Accept all defaults without prompting. */
@@ -303,7 +322,7 @@ interface HooksProfilingResult {
  *
  *   - totalRenders       — total commit count during the interaction window
  *   - uniqueComponents   — distinct component names that re-rendered
- *   - wastedRenders      — re-renders where output was identical (heuristic)
+ *   - wastedRenders      — deprecated heuristic, always null in JSON output
  *   - timing.js          — JS execution time (ms) measured via Performance API
  *   - timing.layout      — Layout/reflow time (ms) measured via PerformanceObserver
  *   - timing.paint       — Paint time (ms) measured via PerformanceObserver
@@ -352,8 +371,14 @@ interface InteractionProfile {
     totalRenders: number;
     /** Number of distinct component names that re-rendered during the window. */
     uniqueComponents: number;
-    /** Estimated number of "wasted" renders (components that re-rendered without output change). */
-    wastedRenders: number;
+    /** Deprecated heuristic field retained for compatibility; always null because it is not directly measured. */
+    wastedRenders: number | null;
+    /** Explicit machine-readable note that wasted render counts are not directly measured. */
+    wastedRendersHeuristic: {
+        measured: false;
+        value: null;
+        note: string;
+    };
     /** Timing breakdown in ms. */
     timing: InteractionTiming;
     /** Layout shift metrics. */
@@ -465,6 +490,8 @@ interface ListRow {
     complexityClass: ComplexityClass;
     hookCount: number;
     contextCount: number;
+    collection?: string;
+    internal: boolean;
 }
 interface QueryRow {
     name: string;
@@ -472,6 +499,8 @@ interface QueryRow {
     complexityClass: ComplexityClass;
     hooks: string;
     contexts: string;
+    collection?: string;
+    internal: boolean;
 }
 /**
  * Minimal glob matcher supporting `*` (any chars except `/`) and `**` (any chars).
@@ -542,4 +571,4 @@ declare function resolveTokenFilePath(fileFlag?: string): string;
  */
 declare function createTokensExportCommand(): Command;
 
-export { CI_EXIT, type CausalityLink, type CiCheckName, type CiCheckResult, type CiExitCode, type CiOptions, type CiResult, type ComponentHookProfile, type HookHeuristicFlag, type HookProfile, type HooksProfilingResult, type InitOptions, type InitResult, type InteractionProfile, type InteractionStep$1 as InteractionStep, type InteractionTiming, type LayoutShiftData, type ListRow, type ProfileHeuristicFlag, type QueryRow, type ReactScopeConfig, type RenderEvent, type RenderTrigger, type RendersAnalysisResult, type ScopeCLIOptions, createCiCommand, createDoctorCommand, createInitCommand, createInstrumentCommand, createManifestCommand, createProgram, createTokensCommand, createTokensExportCommand, formatCiReport, isTTY, matchGlob, resolveTokenFilePath, runCi, runInit };
+export { CI_EXIT, type CausalityLink, type CiCheckName, type CiCheckResult, type CiExitCode, type CiOptions, type CiResult, type ComponentHookProfile, type HookHeuristicFlag, type HookProfile, type HooksProfilingResult, type InitOptions, type InitResult, type InteractionProfile, type InteractionStep$1 as InteractionStep, type InteractionTiming, type LayoutShiftData, type ListRow, type ProfileHeuristicFlag, type QueryRow, type ReactScopeConfig, type RenderEvent, type RenderTrigger, type RendersAnalysisResult, type ScopeCLIOptions, createCiCommand, createDoctorCommand, createGetSkillCommand, createInitCommand, createInstrumentCommand, createManifestCommand, createProgram, createTokensCommand, createTokensExportCommand, formatCiReport, isTTY, matchGlob, resolveTokenFilePath, runCi, runInit };