@10et/cli 1.0.0

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

@@ -0,0 +1,208 @@
+/**
+ * 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" | "portfolio";
+    service_type?: "web" | "api" | "worker" | "daemon" | "cli" | "infrastructure" | "container" | "library" | "agent";
+    description: string;
+    gtm_parent?: string;
+    portfolio_parent?: string;
+    working_branch?: string;
+    context_scope?: ContextScope;
+    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 ContextScope {
+    produces?: string[];
+    consumes?: string[];
+    denied?: string[];
+}
+export interface ServiceRegistration {
+    name: string;
+    path: string;
+    type: string;
+    registered_at: string;
+    last_sync?: string;
+    status: "active" | "inactive";
+    context_scope?: ContextScope;
+}
+export interface GTMConfig extends ServiceConfig {
+    registered_services?: ServiceRegistration[];
+}
+/**
+ * Shared type for journal entry type counts
+ */
+export interface JournalTypeCounts {
+    feature: number;
+    fix: number;
+    decision: number;
+    discovery: number;
+    milestone: number;
+    other: number;
+}
+/**
+ * Git commit summary for phone home payloads
+ */
+export interface GitCommitSummary {
+    hash: string;
+    message: string;
+    author: string;
+    timestamp: string;
+    files_changed: number;
+}
+/**
+ * Base sync payload — common fields shared by both service→GTM and GTM→portfolio syncs
+ */
+export interface BaseSyncPayload {
+    sync_timestamp: string;
+    session_branch: string;
+    git: {
+        commits: GitCommitSummary[];
+        files_changed: number;
+        lines_added: number;
+        lines_removed: number;
+    };
+    journal: {
+        entry_count: number;
+        types: JournalTypeCounts;
+    };
+    agent_notified: boolean;
+    errors: string[];
+}
+/**
+ * Service sync payload — comprehensive session summary for GTM (service→GTM direction)
+ */
+export interface ServiceSyncPayload extends BaseSyncPayload {
+    service_name: string;
+    session: {
+        duration_seconds: number;
+        start_time: string;
+        end_time: string;
+        work_description?: string;
+    };
+    git: BaseSyncPayload["git"] & {
+        branch_merged_to: string;
+    };
+    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";
+    };
+}
+/**
+ * GTM sync payload — journal summary for portfolio (GTM→portfolio direction)
+ */
+export interface GTMSyncPayload extends BaseSyncPayload {
+    gtm_name: string;
+    git: BaseSyncPayload["git"] & {
+        working_branch: string;
+    };
+    journal: BaseSyncPayload["journal"] & {
+        since: string;
+        files_aggregated: string[];
+        incomplete_aggregated: string[];
+        next_steps: string[];
+    };
+}
+/**
+ * Find parent GTM path from service config
+ */
+export declare function findGTMParent(servicePath: string): string | null;
+/**
+ * Find portfolio parent path from GTM config
+ */
+export declare function findPortfolioParent(gtmPath: string): string | null;
+/**
+ * Get full parent chain: service → GTM → portfolio
+ */
+export declare function getParentChain(projectPath: string): string[];
+/**
+ * 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;
+/**
+ * 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>;
+/**
+ * Phone home to Portfolio - sync full GTM journal content up to parent portfolio
+ *
+ * Reads GTM journal entries since last sync, copies journal files to portfolio,
+ * writes aggregated service-sync entry to portfolio journal, and emits a hub event.
+ *
+ * IMPORTANT: Never blocks session end. Collects all errors and returns partial success.
+ */
+export declare function phoneHomeToPortfolio(gtmPath: string, portfolioPath: string, sessionBranch: string): Promise<GTMSyncPayload>;
+//# 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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"}