@appilots/cli 0.11.3 → 0.14.0

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { SourceControlCandidate } from './types/index.js';
 import * as t from '@babel/types';
 
 /**
@@ -18,6 +19,7 @@ interface ScreenDescriptor {
     filePath: string;
     title?: string;
     description?: string;
+    controlCandidates?: SourceControlCandidate[];
     components: ComponentDescriptor[];
     forms: FormDescriptor[];
     actions: ActionDescriptor[];
@@ -58,6 +60,8 @@ interface ScreenPermissionDescriptor {
     requiresConfirmation?: boolean;
     blockedActions?: string[];
     isPii?: boolean;
+    /** Graded assessment: the relay blocks every write on this screen. */
+    assessment?: boolean;
 }
 /**
  * O que a varredura alcançou — para o relatório do CLI, não para o agente.
@@ -367,6 +371,7 @@ declare class ScreenAnalyzer {
     private routeTargetFiles;
     /** §D: Count of screens filtered out in strict mode (available after analyze()) */
     screensFilteredOut: number;
+    controlEvidenceFiles: Record<string, SourceControlCandidate[]>;
     constructor(config: AnalyzerConfig, options?: {
         strictScreens?: boolean;
         screenPatterns?: string[];
@@ -813,6 +818,7 @@ interface PlatformAnalyzerOptions {
     navigationExclude?: string[];
 }
 interface PlatformAnalyzerResult {
+    controlEvidenceFiles?: Record<string, SourceControlCandidate[]>;
     screens: ScreenDescriptor[];
     navigation: NavigationGraph;
     /** Number of source files matched by glob (before screen filtering). */
@@ -1330,6 +1336,14 @@ interface AppilotsConfig {
     manifestPath?: string;
     /** `appilots eval` settings — see docs: Testing your agent between releases. */
     eval?: EvalConfig;
+    /** Knowledge base / RAG configuration — see docs: Knowledge base. */
+    knowledge?: KnowledgeConfig;
+}
+interface KnowledgeConfig {
+    /** Glob patterns for documentation files to index (e.g. "docs/*.md"). */
+    sources?: string[];
+    /** Glob patterns to exclude from indexing. */
+    exclude?: string[];
 }
 interface EvalConfig {
     /** Directory of `*.json` scenario files. Default: `<outputDir>/scenarios`. */
@@ -1519,6 +1533,21 @@ interface StatusResult {
     };
     error?: string;
 }
+/**
+ * Result from a knowledge sync operation
+ */
+interface KnowledgeSyncResult {
+    success: boolean;
+    uploaded: number;
+    skipped: number;
+    errors: number;
+    error?: string;
+    details?: Array<{
+        filename: string;
+        status: 'uploaded' | 'skipped' | 'error';
+        error?: string;
+    }>;
+}
 /**
  * Appilots API client configuration
  */
@@ -1581,6 +1610,18 @@ declare class AppilotsAPIClient {
      *   EVAL_MAX_SCENARIOS_PER_RUN (currently 20) as a cost guard.
      */
     evalRun(scenarios: EvalScenarioRequest[]): Promise<EvalRunResult>;
+    /**
+     * Syncs knowledge documents with the Appilots backend.
+     *
+     * @param documents Array of documents to sync (filename, base64 content, mimeType, checksum)
+     * @returns KnowledgeSyncResult with counts of uploaded, skipped, and errored docs
+     */
+    knowledgeSync(documents: Array<{
+        filename: string;
+        content: string;
+        mimeType: string;
+        checksum: string;
+    }>): Promise<KnowledgeSyncResult>;
     /**
      * Checks if the Appilots API server is healthy
      *
@@ -1596,6 +1637,6 @@ declare class AppilotsAPIClient {
  * banner. Kept identical to package.json by the release flow;
  * `version.test.ts` fails if the two ever disagree.
  */
-declare const CLI_VERSION = "0.11.3";
+declare const CLI_VERSION = "0.14.0";
 
 export { type ActionDescriptor, type AnalyzerConfig, AppilotsAPIClient, type AppilotsConfig, type AppilotsManifest, CLI_VERSION, ComponentAnalyzer, type ComponentDescriptor, DEFAULT_MANIFEST_FILENAME, DEFAULT_WEB_SCREEN_PATTERNS, type EnvOverrides, type FlowDescriptor, type FlowStepDescriptor, FormAnalyzer, type FormDescriptor, type FormFieldDescriptor, GenericPlatformAnalyzer, type LoadManifestResult, type LocatorDescriptor, type MCPDocument, MCPGenerator, type MCPGeneratorConfig, type MCPGeneratorOptions, type MCPOutput, type MetadataLintWarning, NavigationAnalyzer, type NavigationGraph, type NavigationNode, type NavigatorDescriptor, type ParamDescriptor, type PlatformAnalyzer, type PlatformAnalyzerOptions, type PlatformAnalyzerResult, ReactNativePlatformAnalyzer, ReactWebPlatformAnalyzer, type ScreenAgentHints, ScreenAnalyzer, type ScreenDescriptor, type SignalDescriptor, type StatusResult, type SyncResult, type TargetDescriptor, type WaitPolicyDescriptor, WebNavigationAnalyzer, type WebNavigationResult, type WebRoute, WebScreenAnalyzer, formatMetadataWarnings, getConfigPath, getEnvOverrides, lintActionMetadata, loadConfig, loadManifest, mergeManifestNavigation, mergeManifestScreens, resolvePathToScreen, saveConfig, screenNameFromPath, validateConfig };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { SourceControlCandidate } from './types/index.js';
 import * as t from '@babel/types';
 
 /**
@@ -18,6 +19,7 @@ interface ScreenDescriptor {
     filePath: string;
     title?: string;
     description?: string;
+    controlCandidates?: SourceControlCandidate[];
     components: ComponentDescriptor[];
     forms: FormDescriptor[];
     actions: ActionDescriptor[];
@@ -58,6 +60,8 @@ interface ScreenPermissionDescriptor {
     requiresConfirmation?: boolean;
     blockedActions?: string[];
     isPii?: boolean;
+    /** Graded assessment: the relay blocks every write on this screen. */
+    assessment?: boolean;
 }
 /**
  * O que a varredura alcançou — para o relatório do CLI, não para o agente.
@@ -367,6 +371,7 @@ declare class ScreenAnalyzer {
     private routeTargetFiles;
     /** §D: Count of screens filtered out in strict mode (available after analyze()) */
     screensFilteredOut: number;
+    controlEvidenceFiles: Record<string, SourceControlCandidate[]>;
     constructor(config: AnalyzerConfig, options?: {
         strictScreens?: boolean;
         screenPatterns?: string[];
@@ -813,6 +818,7 @@ interface PlatformAnalyzerOptions {
     navigationExclude?: string[];
 }
 interface PlatformAnalyzerResult {
+    controlEvidenceFiles?: Record<string, SourceControlCandidate[]>;
     screens: ScreenDescriptor[];
     navigation: NavigationGraph;
     /** Number of source files matched by glob (before screen filtering). */
@@ -1330,6 +1336,14 @@ interface AppilotsConfig {
     manifestPath?: string;
     /** `appilots eval` settings — see docs: Testing your agent between releases. */
     eval?: EvalConfig;
+    /** Knowledge base / RAG configuration — see docs: Knowledge base. */
+    knowledge?: KnowledgeConfig;
+}
+interface KnowledgeConfig {
+    /** Glob patterns for documentation files to index (e.g. "docs/*.md"). */
+    sources?: string[];
+    /** Glob patterns to exclude from indexing. */
+    exclude?: string[];
 }
 interface EvalConfig {
     /** Directory of `*.json` scenario files. Default: `<outputDir>/scenarios`. */
@@ -1519,6 +1533,21 @@ interface StatusResult {
     };
     error?: string;
 }
+/**
+ * Result from a knowledge sync operation
+ */
+interface KnowledgeSyncResult {
+    success: boolean;
+    uploaded: number;
+    skipped: number;
+    errors: number;
+    error?: string;
+    details?: Array<{
+        filename: string;
+        status: 'uploaded' | 'skipped' | 'error';
+        error?: string;
+    }>;
+}
 /**
  * Appilots API client configuration
  */
@@ -1581,6 +1610,18 @@ declare class AppilotsAPIClient {
      *   EVAL_MAX_SCENARIOS_PER_RUN (currently 20) as a cost guard.
      */
     evalRun(scenarios: EvalScenarioRequest[]): Promise<EvalRunResult>;
+    /**
+     * Syncs knowledge documents with the Appilots backend.
+     *
+     * @param documents Array of documents to sync (filename, base64 content, mimeType, checksum)
+     * @returns KnowledgeSyncResult with counts of uploaded, skipped, and errored docs
+     */
+    knowledgeSync(documents: Array<{
+        filename: string;
+        content: string;
+        mimeType: string;
+        checksum: string;
+    }>): Promise<KnowledgeSyncResult>;
     /**
      * Checks if the Appilots API server is healthy
      *
@@ -1596,6 +1637,6 @@ declare class AppilotsAPIClient {
  * banner. Kept identical to package.json by the release flow;
  * `version.test.ts` fails if the two ever disagree.
  */
-declare const CLI_VERSION = "0.11.3";
+declare const CLI_VERSION = "0.14.0";
 
 export { type ActionDescriptor, type AnalyzerConfig, AppilotsAPIClient, type AppilotsConfig, type AppilotsManifest, CLI_VERSION, ComponentAnalyzer, type ComponentDescriptor, DEFAULT_MANIFEST_FILENAME, DEFAULT_WEB_SCREEN_PATTERNS, type EnvOverrides, type FlowDescriptor, type FlowStepDescriptor, FormAnalyzer, type FormDescriptor, type FormFieldDescriptor, GenericPlatformAnalyzer, type LoadManifestResult, type LocatorDescriptor, type MCPDocument, MCPGenerator, type MCPGeneratorConfig, type MCPGeneratorOptions, type MCPOutput, type MetadataLintWarning, NavigationAnalyzer, type NavigationGraph, type NavigationNode, type NavigatorDescriptor, type ParamDescriptor, type PlatformAnalyzer, type PlatformAnalyzerOptions, type PlatformAnalyzerResult, ReactNativePlatformAnalyzer, ReactWebPlatformAnalyzer, type ScreenAgentHints, ScreenAnalyzer, type ScreenDescriptor, type SignalDescriptor, type StatusResult, type SyncResult, type TargetDescriptor, type WaitPolicyDescriptor, WebNavigationAnalyzer, type WebNavigationResult, type WebRoute, WebScreenAnalyzer, formatMetadataWarnings, getConfigPath, getEnvOverrides, lintActionMetadata, loadConfig, loadManifest, mergeManifestNavigation, mergeManifestScreens, resolvePathToScreen, saveConfig, screenNameFromPath, validateConfig };