jfl 0.1.0 → 0.2.0

package/dist/lib/service-gtm.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Service-GTM Coordination Library
+ *
+ * Provides functions for coordinating between service projects and parent GTM workspaces.
+ *
+ * @purpose Service-GTM coordination helpers for sync and validation
+ * @spec Service /end Skill Deployment & GTM Sync Implementation Plan
+ */
+export interface ServiceConfig {
+    name: string;
+    type: "service" | "gtm";
+    service_type?: "web" | "api" | "worker" | "daemon" | "cli" | "infrastructure" | "container" | "library";
+    description: string;
+    gtm_parent?: string;
+    working_branch?: string;
+    sync_to_parent?: {
+        journal: boolean;
+        knowledge: boolean;
+        content: boolean;
+    };
+    environments?: {
+        [key: string]: {
+            code_path: string;
+            start_command: string;
+            port: number | null;
+            env: Record<string, string>;
+            health_check: {
+                enabled: boolean;
+                url: string;
+                interval: number;
+                timeout: number;
+            } | null;
+        };
+    };
+}
+export interface ServiceRegistration {
+    name: string;
+    path: string;
+    type: string;
+    registered_at: string;
+    last_sync?: string;
+    status: "active" | "inactive";
+}
+export interface GTMConfig extends ServiceConfig {
+    registered_services?: ServiceRegistration[];
+}
+/**
+ * Find parent GTM path from service config
+ */
+export declare function findGTMParent(servicePath: string): string | null;
+/**
+ * Validate GTM parent exists and is valid GTM workspace
+ */
+export declare function validateGTMParent(gtmPath: string): boolean;
+/**
+ * Get registered services from GTM config
+ */
+export declare function getRegisteredServices(gtmPath: string): ServiceRegistration[];
+/**
+ * Add service to GTM's registered_services array
+ */
+export declare function addServiceToGTM(gtmPath: string, serviceConfig: ServiceConfig): void;
+/**
+ * Update service sync timestamp in GTM config
+ */
+export declare function updateServiceSync(gtmPath: string, serviceName: string, timestamp: string): void;
+/**
+ * Sync journal entries from service to GTM
+ */
+export declare function syncJournalsToGTM(servicePath: string, gtmPath: string, serviceName: string): number;
+/**
+ * Git commit summary for phone home payload
+ */
+export interface GitCommitSummary {
+    hash: string;
+    message: string;
+    author: string;
+    timestamp: string;
+    files_changed: number;
+}
+/**
+ * Service sync payload - comprehensive session summary for GTM
+ */
+export interface ServiceSyncPayload {
+    service_name: string;
+    sync_timestamp: string;
+    session_branch: string;
+    session: {
+        duration_seconds: number;
+        start_time: string;
+        end_time: string;
+        work_description?: string;
+    };
+    git: {
+        commits: GitCommitSummary[];
+        files_changed: number;
+        lines_added: number;
+        lines_removed: number;
+        branch_merged_to: string;
+    };
+    journal: {
+        entry_count: number;
+        types: {
+            feature: number;
+            fix: number;
+            decision: number;
+            discovery: number;
+            milestone: number;
+            other: number;
+        };
+    };
+    health: {
+        validation_results?: {
+            errors: number;
+            warnings: number;
+            passed: number;
+        };
+        context_hub_connected: boolean;
+        uncommitted_changes: boolean;
+    };
+    environment: {
+        node_version: string;
+        jfl_version: string;
+        dependencies?: Record<string, string>;
+    };
+    content_synced: {
+        knowledge_files: string[];
+        content_files: string[];
+        config_files: string[];
+        claude_md_synced: boolean;
+        custom_files: string[];
+        total_bytes: number;
+    };
+    sync_config: {
+        knowledge_enabled: boolean;
+        content_enabled: boolean;
+        config_enabled: boolean;
+        detection_method: "git-diff" | "full-scan";
+    };
+    agent_notified: boolean;
+    errors: string[];
+}
+/**
+ * Phone home to GTM - comprehensive sync with full session metadata
+ *
+ * Collects everything the GTM needs to understand what happened in the service session:
+ * - Session summary (duration, when it started/ended)
+ * - Git activity (commits, files changed, lines added/removed)
+ * - Journal data (entry count, types of work)
+ * - Health status (validation, context hub, uncommitted changes)
+ * - Environment metadata (versions, dependencies)
+ * - Content sync (knowledge, content, config files)
+ *
+ * IMPORTANT: Never blocks session end. Collects all errors and returns partial success.
+ */
+export declare function phoneHomeToGTM(servicePath: string, gtmPath: string, sessionBranch: string): Promise<ServiceSyncPayload>;
+//# sourceMappingURL=service-gtm.d.ts.map

package/dist/lib/service-gtm.d.ts.map

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