jiva-core 0.2.2 → 0.3.1

package/dist/personas/validator.js

@@ -0,0 +1,144 @@
+/**
+ * Skill and Persona validation logic
+ * Enforces frontmatter rules as specified in the implementation guide
+ */
+const SKILL_NAME_REGEX = /^[a-z0-9-]+$/;
+const MAX_NAME_LENGTH = 64;
+const MAX_DESCRIPTION_LENGTH = 1024;
+const MAX_COMPATIBILITY_LENGTH = 500;
+const ALLOWED_FRONTMATTER_KEYS = [
+    'name',
+    'description',
+    'license',
+    'allowedTools',
+    'allowed-tools', // Accept kebab-case variant
+    'metadata',
+    'compatibility',
+];
+/**
+ * Validate skill metadata from frontmatter
+ */
+export function validateSkillMetadata(metadata) {
+    const errors = [];
+    // Required: name
+    if (!metadata.name) {
+        errors.push({
+            field: 'name',
+            message: 'Skill name is required',
+        });
+    }
+    else {
+        // Name format: kebab-case, no leading/trailing/consecutive hyphens
+        if (!SKILL_NAME_REGEX.test(metadata.name)) {
+            errors.push({
+                field: 'name',
+                message: 'Skill name must be lowercase alphanumeric with hyphens only',
+                value: metadata.name,
+            });
+        }
+        // No leading/trailing hyphens
+        if (metadata.name.startsWith('-') || metadata.name.endsWith('-')) {
+            errors.push({
+                field: 'name',
+                message: 'Skill name cannot start or end with a hyphen',
+                value: metadata.name,
+            });
+        }
+        // No consecutive hyphens
+        if (metadata.name.includes('--')) {
+            errors.push({
+                field: 'name',
+                message: 'Skill name cannot contain consecutive hyphens',
+                value: metadata.name,
+            });
+        }
+        // Max length
+        if (metadata.name.length > MAX_NAME_LENGTH) {
+            errors.push({
+                field: 'name',
+                message: `Skill name must be ${MAX_NAME_LENGTH} characters or less`,
+                value: metadata.name,
+            });
+        }
+    }
+    // Required: description
+    if (!metadata.description) {
+        errors.push({
+            field: 'description',
+            message: 'Skill description is required',
+        });
+    }
+    else {
+        // No angle brackets
+        if (/<|>/.test(metadata.description)) {
+            errors.push({
+                field: 'description',
+                message: 'Skill description cannot contain angle brackets (< >)',
+                value: metadata.description,
+            });
+        }
+        // Max length
+        if (metadata.description.length > MAX_DESCRIPTION_LENGTH) {
+            errors.push({
+                field: 'description',
+                message: `Skill description must be ${MAX_DESCRIPTION_LENGTH} characters or less (got ${metadata.description.length})`,
+                value: metadata.description.substring(0, 100) + '...',
+            });
+        }
+    }
+    // Optional: compatibility (max 500 chars)
+    if (metadata.compatibility && metadata.compatibility.length > MAX_COMPATIBILITY_LENGTH) {
+        errors.push({
+            field: 'compatibility',
+            message: `Compatibility note must be ${MAX_COMPATIBILITY_LENGTH} characters or less`,
+            value: metadata.compatibility,
+        });
+    }
+    return errors;
+}
+/**
+ * Validate that only allowed frontmatter keys are present
+ */
+export function validateFrontmatterKeys(frontmatter) {
+    const errors = [];
+    const keys = Object.keys(frontmatter);
+    for (const key of keys) {
+        if (!ALLOWED_FRONTMATTER_KEYS.includes(key)) {
+            errors.push({
+                field: key,
+                message: `Unknown frontmatter key "${key}". Allowed keys: ${ALLOWED_FRONTMATTER_KEYS.join(', ')}`,
+                value: frontmatter[key],
+            });
+        }
+    }
+    return errors;
+}
+/**
+ * Validate SKILL.md body length (L2 should be < 500 lines)
+ */
+export function validateSkillBodyLength(content) {
+    const errors = [];
+    const lines = content.split('\n');
+    if (lines.length > 500) {
+        errors.push({
+            field: 'content',
+            message: `SKILL.md body should be under 500 lines (got ${lines.length}). Consider moving detailed content to references/`,
+            value: lines.length,
+        });
+    }
+    return errors;
+}
+/**
+ * Normalize frontmatter keys (handle kebab-case variants)
+ */
+export function normalizeFrontmatter(frontmatter) {
+    return {
+        name: frontmatter.name,
+        description: frontmatter.description,
+        license: frontmatter.license,
+        compatibility: frontmatter.compatibility,
+        allowedTools: frontmatter.allowedTools || frontmatter['allowed-tools'],
+        metadata: frontmatter.metadata,
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/personas/validator.js.map

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

package/dist/storage/factory.d.ts

@@ -0,0 +1,51 @@
+/**
+ * StorageProviderFactory - Creates the appropriate storage provider
+ * based on environment configuration
+ *
+ * DESIGN PRINCIPLES:
+ * 1. Infrastructure config (bucket names, paths) comes from environment variables
+ * 2. Identity context (tenantId, sessionId) comes from the caller (JWT, etc.)
+ * 3. CLI mode uses LocalStorageProvider with default context (backward compatible)
+ * 4. Cloud mode requires explicit setContext() call before operations
+ */
+import { StorageProvider } from './provider.js';
+import { LocalStorageProvider } from './local-provider.js';
+import { GCPBucketProvider } from './gcp-bucket-provider.js';
+import { StorageInfraConfig, StorageProviderType, StorageContext } from './types.js';
+/**
+ * Create a storage provider instance
+ *
+ * For CLI mode: Provider is returned with default context, ready to use
+ * For Cloud mode: Caller must call setContext() with authenticated identity
+ *
+ * @param explicitInfraConfig - Explicit infrastructure config (overrides environment)
+ * @param providerType - Explicit provider type (overrides auto-detection)
+ */
+export declare function createStorageProvider(explicitInfraConfig?: StorageInfraConfig, providerType?: StorageProviderType): Promise<StorageProvider>;
+/**
+ * Create a local storage provider for CLI/Desktop mode
+ * Returns provider with default context, ready to use immediately
+ *
+ * @param basePath - Optional custom base path (defaults to ~/.jiva)
+ */
+export declare function createLocalProvider(basePath?: string): Promise<LocalStorageProvider>;
+/**
+ * Create a GCP bucket provider for Cloud mode
+ *
+ * IMPORTANT: Caller MUST call setContext() with authenticated identity
+ * before performing any operations
+ *
+ * @param bucketName - GCP bucket name
+ * @param projectId - Optional GCP project ID
+ */
+export declare function createGCPProvider(bucketName: string, projectId?: string): Promise<GCPBucketProvider>;
+/**
+ * Create a storage provider and set context in one call
+ * Convenience method for cloud functions
+ *
+ * @param context - Authenticated user context (from JWT, etc.)
+ * @param infraConfig - Optional infrastructure config
+ * @param providerType - Optional explicit provider type
+ */
+export declare function createStorageProviderWithContext(context: StorageContext, infraConfig?: StorageInfraConfig, providerType?: StorageProviderType): Promise<StorageProvider>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/storage/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/storage/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAoErF;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,mBAAmB,CAAC,EAAE,kBAAkB,EACxC,YAAY,CAAC,EAAE,mBAAmB,GACjC,OAAO,CAAC,eAAe,CAAC,CAwC1B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAK/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAQ5B;AAED;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,cAAc,EACvB,WAAW,CAAC,EAAE,kBAAkB,EAChC,YAAY,CAAC,EAAE,mBAAmB,GACjC,OAAO,CAAC,eAAe,CAAC,CAI1B"}

package/dist/storage/factory.js

@@ -0,0 +1,154 @@
+/**
+ * StorageProviderFactory - Creates the appropriate storage provider
+ * based on environment configuration
+ *
+ * DESIGN PRINCIPLES:
+ * 1. Infrastructure config (bucket names, paths) comes from environment variables
+ * 2. Identity context (tenantId, sessionId) comes from the caller (JWT, etc.)
+ * 3. CLI mode uses LocalStorageProvider with default context (backward compatible)
+ * 4. Cloud mode requires explicit setContext() call before operations
+ */
+import { LocalStorageProvider } from './local-provider.js';
+import { GCPBucketProvider } from './gcp-bucket-provider.js';
+import { StorageProviderType } from './types.js';
+/**
+ * Environment variable names for INFRASTRUCTURE configuration only
+ * Identity (tenantId, sessionId) must come from authenticated requests
+ */
+const ENV_VARS = {
+    // Provider selection
+    PROVIDER: 'JIVA_STORAGE_PROVIDER',
+    // Local filesystem
+    BASE_PATH: 'JIVA_STORAGE_PATH',
+    // GCP
+    GCP_BUCKET: 'JIVA_GCP_BUCKET',
+    GCP_PROJECT: 'JIVA_GCP_PROJECT',
+    GCP_KEY_FILE: 'JIVA_GCP_KEY_FILE',
+    // AWS S3 (future)
+    S3_BUCKET: 'JIVA_S3_BUCKET',
+    S3_REGION: 'JIVA_S3_REGION',
+    // Redis (future)
+    REDIS_URL: 'JIVA_REDIS_URL',
+};
+/**
+ * Get infrastructure configuration from environment variables
+ */
+function getInfraConfigFromEnv() {
+    return {
+        basePath: process.env[ENV_VARS.BASE_PATH],
+        gcpBucketName: process.env[ENV_VARS.GCP_BUCKET],
+        gcpProjectId: process.env[ENV_VARS.GCP_PROJECT],
+        gcpKeyFilePath: process.env[ENV_VARS.GCP_KEY_FILE],
+        s3BucketName: process.env[ENV_VARS.S3_BUCKET],
+        s3Region: process.env[ENV_VARS.S3_REGION],
+        redisUrl: process.env[ENV_VARS.REDIS_URL],
+    };
+}
+/**
+ * Determine provider type from environment or explicit config
+ */
+function determineProviderType(infraConfig) {
+    // Explicit environment variable takes precedence
+    const envProvider = process.env[ENV_VARS.PROVIDER];
+    if (envProvider) {
+        return envProvider;
+    }
+    // Infer from available configuration
+    if (infraConfig?.gcpBucketName || process.env[ENV_VARS.GCP_BUCKET]) {
+        return StorageProviderType.GCP_BUCKET;
+    }
+    if (infraConfig?.s3BucketName || process.env[ENV_VARS.S3_BUCKET]) {
+        return StorageProviderType.AWS_S3;
+    }
+    if (infraConfig?.redisUrl || process.env[ENV_VARS.REDIS_URL]) {
+        return StorageProviderType.REDIS;
+    }
+    // Default to local filesystem
+    return StorageProviderType.LOCAL;
+}
+/**
+ * Create a storage provider instance
+ *
+ * For CLI mode: Provider is returned with default context, ready to use
+ * For Cloud mode: Caller must call setContext() with authenticated identity
+ *
+ * @param explicitInfraConfig - Explicit infrastructure config (overrides environment)
+ * @param providerType - Explicit provider type (overrides auto-detection)
+ */
+export async function createStorageProvider(explicitInfraConfig, providerType) {
+    // Merge environment config with explicit config
+    const envConfig = getInfraConfigFromEnv();
+    const infraConfig = {
+        basePath: explicitInfraConfig?.basePath || envConfig.basePath,
+        gcpBucketName: explicitInfraConfig?.gcpBucketName || envConfig.gcpBucketName,
+        gcpProjectId: explicitInfraConfig?.gcpProjectId || envConfig.gcpProjectId,
+        gcpKeyFilePath: explicitInfraConfig?.gcpKeyFilePath || envConfig.gcpKeyFilePath,
+        s3BucketName: explicitInfraConfig?.s3BucketName || envConfig.s3BucketName,
+        s3Region: explicitInfraConfig?.s3Region || envConfig.s3Region,
+        redisUrl: explicitInfraConfig?.redisUrl || envConfig.redisUrl,
+    };
+    // Determine provider type
+    const type = providerType || determineProviderType(infraConfig);
+    // Create provider instance
+    let provider;
+    switch (type) {
+        case StorageProviderType.GCP_BUCKET:
+            provider = new GCPBucketProvider(infraConfig);
+            break;
+        case StorageProviderType.AWS_S3:
+            throw new Error('AWS S3 provider not yet implemented. Coming soon!');
+        case StorageProviderType.REDIS:
+            throw new Error('Redis provider not yet implemented. Coming soon!');
+        case StorageProviderType.LOCAL:
+        default:
+            provider = new LocalStorageProvider(infraConfig);
+            break;
+    }
+    // Initialize provider
+    await provider.initialize();
+    return provider;
+}
+/**
+ * Create a local storage provider for CLI/Desktop mode
+ * Returns provider with default context, ready to use immediately
+ *
+ * @param basePath - Optional custom base path (defaults to ~/.jiva)
+ */
+export async function createLocalProvider(basePath) {
+    const provider = new LocalStorageProvider({ basePath });
+    await provider.initialize();
+    // LocalStorageProvider has default context set in constructor
+    return provider;
+}
+/**
+ * Create a GCP bucket provider for Cloud mode
+ *
+ * IMPORTANT: Caller MUST call setContext() with authenticated identity
+ * before performing any operations
+ *
+ * @param bucketName - GCP bucket name
+ * @param projectId - Optional GCP project ID
+ */
+export async function createGCPProvider(bucketName, projectId) {
+    const provider = new GCPBucketProvider({
+        gcpBucketName: bucketName,
+        gcpProjectId: projectId,
+    });
+    await provider.initialize();
+    // Context must be set by caller via setContext()
+    return provider;
+}
+/**
+ * Create a storage provider and set context in one call
+ * Convenience method for cloud functions
+ *
+ * @param context - Authenticated user context (from JWT, etc.)
+ * @param infraConfig - Optional infrastructure config
+ * @param providerType - Optional explicit provider type
+ */
+export async function createStorageProviderWithContext(context, infraConfig, providerType) {
+    const provider = await createStorageProvider(infraConfig, providerType);
+    provider.setContext(context);
+    return provider;
+}
+//# sourceMappingURL=factory.js.map

package/dist/storage/factory.js.map

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

package/dist/storage/gcp-bucket-provider.d.ts

@@ -0,0 +1,59 @@
+/**
+ * GCPBucketProvider - Google Cloud Storage based persistence
+ *
+ * Path structure:
+ * {bucket}/
+ *   {tenantId}/
+ *     config.json
+ *     conversations/
+ *       {conversationId}.json
+ *     sessions/
+ *       {sessionId}/
+ *         state.json
+ *     logs/
+ *       {sessionId}.log
+ *     directives/
+ *       {workspaceHash}.md
+ *
+ * IMPORTANT: In cloud mode, setContext() MUST be called with tenantId/sessionId
+ * from the authenticated request (JWT) before any operations.
+ */
+import { StorageProvider } from './provider.js';
+import { StorageInfraConfig, SavedConversation, ConversationMetadata, JivaState } from './types.js';
+export declare class GCPBucketProvider extends StorageProvider {
+    private bucket;
+    private bucketName;
+    private configCache;
+    constructor(infraConfig: StorageInfraConfig);
+    initialize(): Promise<void>;
+    private readJson;
+    private writeJson;
+    private writeText;
+    private readText;
+    private deleteFile;
+    private listFiles;
+    private hashWorkspacePath;
+    private loadConfigCache;
+    getConfig<T>(key: string): Promise<T | undefined>;
+    setConfig<T>(key: string, value: T): Promise<void>;
+    getAllConfig(): Promise<Record<string, any>>;
+    private getConversationObjectPath;
+    saveConversation(conversation: SavedConversation): Promise<string>;
+    loadConversation(id: string): Promise<SavedConversation | null>;
+    listConversations(): Promise<ConversationMetadata[]>;
+    deleteConversation(id: string): Promise<void>;
+    loadDirective(workspacePath: string): Promise<string | undefined>;
+    saveDirective(workspacePath: string, content: string): Promise<void>;
+    flushLogs(): Promise<void>;
+    exportState(): Promise<JivaState>;
+    importState(state: JivaState): Promise<void>;
+    /**
+     * Save complete state snapshot for cloud function handoff
+     */
+    saveStateSnapshot(state: JivaState): Promise<void>;
+    /**
+     * Load state snapshot for cloud function restoration
+     */
+    loadStateSnapshot(): Promise<JivaState | null>;
+}
+//# sourceMappingURL=gcp-bucket-provider.d.ts.map

package/dist/storage/gcp-bucket-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcp-bucket-provider.d.ts","sourceRoot":"","sources":["../../src/storage/gcp-bucket-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACV,MAAM,YAAY,CAAC;AA0BpB,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAA+C;gBAEtD,WAAW,EAAE,kBAAkB;IAWrC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YA0CnB,QAAQ;YAeR,SAAS;YAST,SAAS;YAST,QAAQ;YAeR,UAAU;YAUV,SAAS;IAOvB,OAAO,CAAC,iBAAiB;YAQX,eAAe;IAevB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAKjD,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAQlD,OAAO,CAAC,yBAAyB;IAI3B,gBAAgB,CAAC,YAAY,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAMlE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAK/D,iBAAiB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAmBpD,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAOjE,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB1B,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC;IAgBjC,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBlD;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAIrD"}