@gitgov/core 1.0.0

package/README.md

@@ -0,0 +1,303 @@
+# @gitgov/core: The Governance Engine
+
+[![NPM Version](https://img.shields.io/npm/v/@gitgov/core)](https://www.npmjs.com/package/@gitgov/core)
+[![License: MPL-2.0](https://img.shields.io/badge/License-MPL%202.0-brightgreen.svg)](https://opensource.org/licenses/MPL-2.0)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](./tsconfig.json)
+
+`@gitgov/core` is the **universal SDK** for the GitGovernance ecosystem. It provides a type-safe, local-first, and schema-driven API to manage identities, agents, and workflows in software projects.
+
+## 🚀 Quick Start
+
+This example initializes a complete GitGovernance project in a new directory, creating the necessary configuration, the first user actor, and a root cycle for tasks.
+
+```typescript
+import {
+  ProjectAdapter,
+  ConfigManager,
+  RecordStore,
+  IdentityAdapter,
+  BacklogAdapter,
+  WorkflowMethodologyAdapter,
+} from "@gitgov/core";
+import path from "path";
+import fs from "fs/promises";
+
+// 1. Instantiate all core adapters and their dependencies
+const identityAdapter = new IdentityAdapter();
+const backlogAdapter = new BacklogAdapter({
+  taskStore: new RecordStore("tasks"),
+  cycleStore: new RecordStore("cycles"),
+  workflowMethodology: new WorkflowMethodologyAdapter(),
+  identity: identityAdapter,
+});
+const projectAdapter = new ProjectAdapter({
+  identityAdapter,
+  backlogAdapter,
+  workflowMethodologyAdapter: new WorkflowMethodologyAdapter(),
+  configManager: new ConfigManager(),
+  taskStore: new RecordStore("tasks"),
+  cycleStore: new RecordStore("cycles"),
+});
+
+// 2. Validate environment and initialize the project
+const validation = await projectAdapter.validateEnvironment();
+if (!validation.isValid) {
+  console.error("Environment issues:", validation.warnings);
+  process.exit(1);
+}
+
+const result = await projectAdapter.initializeProject({
+  name: "My GitGovernance Project",
+  actorName: "Project Owner",
+});
+
+// 3. Project is now ready!
+console.log(`✅ Project initialized: ${result.projectId}`);
+console.log(`🔗 Root cycle: ${result.rootCycle}`);
+console.log(
+  `👤 Actor created: ${result.actor.displayName} (${result.actor.id})`
+);
+
+// Expected output:
+// ✅ Project initialized: my-gitgovernance-project
+// 🔗 Root cycle: cycle:my-gitgovernance-project.root
+// 👤 Actor created: Project Owner (human:project-owner)
+```
+
+## ✅ What's Implemented (v1.0)
+
+### Identity Management (Complete)
+
+- **ActorRecord**: Cryptographic identities with Ed25519 keys
+- **AgentRecord**: AI agent operational manifests
+- **Full CRUD**: Create, read, list, revoke operations
+- **Schema Validation**: JSON Schema-driven with detailed errors
+- **Performance**: Schema validation caching
+
+### Complete Adapter Ecosystem (7/7 Adapters)
+
+- **ProjectAdapter**: Project initialization engine with 3-adapter orchestration (✅ Implemented)
+- **BacklogAdapter**: Task and cycle lifecycle management with workflow validation (✅ Implemented)
+- **MetricsAdapter**: Pure calculation engine for system analytics (✅ Implemented)
+- **ChangelogAdapter**: System historian for change documentation (✅ Implemented)
+- **ExecutionAdapter**: Immutable audit log for work execution (✅ Implemented)
+- **FeedbackAdapter**: Structured communication and blocking management (✅ Implemented)
+- **IdentityAdapter**: Cryptographic identity and agent management (✅ Implemented)
+
+### Complete Record System (7/7 Records)
+
+- **TaskRecord**: Factory and validation for task management
+- **CycleRecord**: Factory and validation for cycle organization
+- **ExecutionRecord**: Factory and validation for execution logging
+- **ChangelogRecord**: Factory and validation for changelog generation
+- **FeedbackRecord**: Factory and validation for feedback management
+- **ActorRecord**: Factory and validation for identity management
+- **AgentRecord**: Factory and validation for agent manifests
+
+### Infrastructure Modules
+
+- **Generic Store**: CRUD operations for all record types
+- **Integration Testing**: Cross-module validation framework
+- **WorkflowMethodologyAdapter**: Configurable workflow validation engine (✅ Implemented)
+- **EventBusModule**: Event-driven architecture foundation with 9 event types (✅ Implemented)
+
+```typescript
+// Complete project initialization workflow
+const projectAdapter = new ProjectAdapter({
+  identityAdapter: new IdentityAdapter(),
+  backlogAdapter: new BacklogAdapter(/* dependencies */),
+  workflowMethodologyAdapter: new WorkflowMethodologyAdapter(),
+  configManager: new ConfigManager(),
+  taskStore: new RecordStore("tasks"),
+  cycleStore: new RecordStore("cycles"),
+});
+
+// 1. Validate environment
+const validation = await projectAdapter.validateEnvironment();
+if (!validation.isValid) {
+  console.error("Environment issues:", validation.warnings);
+  process.exit(1);
+}
+
+// 2. Initialize complete project
+const result = await projectAdapter.initializeProject({
+  name: "My GitGovernance Project",
+  actorName: "Project Owner",
+  template: "./templates/basic.json",
+  methodology: "scrum",
+});
+
+// 3. Project is now ready
+console.log(`✅ Project initialized: ${result.projectId}`);
+console.log(`🔗 Root cycle: ${result.rootCycle}`);
+console.log(`👤 Actor: ${result.actor.displayName}`);
+
+// 4. Get project information
+const projectInfo = await projectAdapter.getProjectInfo();
+console.log(`📊 Project: ${projectInfo?.name}`);
+```
+
+## 🏗️ Architecture
+
+The package is built with a domain-driven architecture to separate responsibilities. The public API is exposed through `Adapters`.
+
+```mermaid
+graph TD
+    subgraph "@gitgov/core"
+        PA[ProjectAdapter] --> IA[IdentityAdapter];
+        PA --> BA[BacklogAdapter];
+        PA --> WMA[WorkflowMethodologyAdapter];
+        PA --> CM[ConfigManager];
+        PA --> F((Factories));
+        IA --> F;
+        IA --> V((Validation));
+        IA --> S((Store));
+        IA --> CR((Crypto));
+    end
+
+    subgraph "Consumidores"
+        CLI["@gitgov/cli"]
+        SAAS["@gitgov/saas"]
+    end
+
+    CLI --> PA;
+    SAAS --> PA;
+
+    style PA fill:#e8f5e8,stroke:#4caf50,stroke-width:2px
+    style IA fill:#e8f5e8,stroke:#4caf50,stroke-width:2px
+    style BA fill:#e8f5e8,stroke:#4caf50,stroke-width:2px
+```
+
+### Core Principles
+
+1.  **Protocol-Driven**: The canonical JSON Schemas that define the governance protocol are bundled with the package and are the single source of truth for all data validation.
+2.  **Type Safety**: Strict TypeScript with no `any` to prevent compile-time errors.
+3.  **Event Coherence Guarantee**: Event payloads are derived from canonical records using TypeScript Utility Types, ensuring 100% consistency between system state and system events.
+4.  **Rich Errors**: Detailed, field-level validation errors to make debugging easier.
+5.  **Performance**: A compiled schema cache (`SchemaValidationCache`) minimizes I/O and accelerates repetitive validations.
+6.  **Local-First**: Designed to operate directly on a Git repository as its database.
+
+## 🔧 Advanced Usage
+
+### Schema Validation
+
+```typescript
+import {
+  validateActorRecordDetailed,
+  DetailedValidationError,
+} from "@gitgov/core";
+
+const result = validateActorRecordDetailed(userData);
+if (!result.isValid) {
+  result.errors.forEach((error) => {
+    console.log(`❌ ${error.field}: ${error.message}`);
+    console.log(`   Got: ${JSON.stringify(error.value)}`);
+  });
+}
+```
+
+### Custom Error Handling
+
+```typescript
+import {
+  DetailedValidationError,
+  RecordNotFoundError,
+  ProjectRootError,
+} from "@gitgov/core";
+
+function handleCoreErrors(error: unknown) {
+  if (error instanceof DetailedValidationError) {
+    return { type: "validation", fields: error.ajvErrors };
+  } else if (error instanceof RecordNotFoundError) {
+    return { type: "not_found", code: error.code };
+  } else if (error instanceof ProjectRootError) {
+    return { type: "setup", message: "Initialize Git repository first" };
+  }
+  return { type: "unknown", error };
+}
+```
+
+### Performance Monitoring
+
+```typescript
+import { SchemaValidationCache } from "@gitgov/core";
+
+// Monitor cache efficiency
+const stats = SchemaValidationCache.getCacheStats();
+console.log(`Cache hit ratio: ${stats.cachedSchemas} schemas loaded`);
+
+// Clear cache when schemas are updated
+SchemaValidationCache.clearCache();
+```
+
+## 🧪 Testing & Development
+
+```bash
+# Run all tests (500+ passing)
+npm test
+
+# Type checking
+npx tsc --noEmit
+
+# Watch mode for development
+npm test -- --watch
+```
+
+### Test Coverage
+
+- **711 tests total** with EARS methodology
+- **ProjectAdapter**: 18 tests (complete project initialization + template processing + error recovery)
+- **BacklogAdapter**: 43 tests (complete workflow lifecycle + event handlers + E2E simulation)
+- **MetricsAdapter**: 32 tests (Tier 1+2 calculations + performance validation)
+- **ChangelogAdapter**: 31 tests (multi-entity changelog + conditional validation)
+- **EventBusModule**: 32 tests (20 unit + 12 integration tests with cross-adapter scenarios)
+- **FeedbackAdapter**: 15 tests (complete EARS coverage with dual event emission)
+- **ExecutionAdapter**: 13 tests (complete EARS coverage with performance validation)
+- **WorkflowMethodologyAdapter**: 51 tests (29 unit + 22 integration tests)
+- **Identity Domain**: 66 tests (Adapter + ActorRecord/AgentRecord factories & validators)
+- **Validation**: 62 tests (for Task, Cycle, Exec, CL, Feedback records + schema caching)
+- **Factories**: 40 tests (for Task, Cycle, Exec, CL, Feedback records)
+- **Store**: 26 tests (generic CRUD for all record types)
+- **Crypto**: 23 tests (signatures + checksums for all 7 record types)
+- **ConfigManager**: 20 tests (configuration + session state + project utilities)
+- **Utils**: 10 tests (ID generation utilities)
+- **Integration**: 18 tests (cross-module validation)
+
+## 🔮 Roadmap
+
+### Next: CLI Integration & Polish
+
+- CLI init command integration with ProjectAdapter
+- Real adapter integration tests (replace mocks with actual adapters)
+- IndexerModule for local cache optimization
+- Performance benchmarking with enterprise datasets
+- ConfigManager write methods (architectural improvement)
+
+### Recently Completed
+
+- ✅ **ProjectAdapter**: Complete implementation with 3-adapter orchestration
+- ✅ **BacklogAdapter**: Complete implementation with event-driven coordination
+- ✅ **MetricsAdapter**: Complete calculation engine with Tier 1+2 functions
+- ✅ **ChangelogAdapter**: Complete implementation with conditional validation
+- ✅ **ExecutionAdapter**: Complete implementation with traceability
+- ✅ **FeedbackAdapter**: Complete implementation with dual event emission
+
+## 📚 Documentation
+
+- **[Protocol Specs](./src/schemas/)**: Canonical schemas and rules
+
+## 🤝 Contributing
+
+This package follows **a protocol-first approach**. Every feature must:
+
+1. Have a corresponding specification (blueprint) in `specs/`
+2. Include comprehensive tests with EARS references
+3. Follow the established architectural patterns
+4. Pass TypeScript strict compilation
+5. Update relevant documentation
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md) for detailed guidelines.
+
+---
+
+**Built with ❤️ by the GitGovernance Team**

package/dist/scripts/compile-json-to-types.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env tsx
+/**
+ * Compile JSON schemas to TypeScript types
+ *
+ * This script reads the JSON schemas from src/schemas/ (with $ref references)
+ * and generates TypeScript types using json-schema-to-typescript.
+ * It handles $ref resolution automatically.
+ */
+declare function compileSchemas(): Promise<void>;
+export { compileSchemas };
+//# sourceMappingURL=compile-json-to-types.d.ts.map

package/dist/scripts/compile-json-to-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-json-to-types.d.ts","sourceRoot":"","sources":["../../scripts/compile-json-to-types.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AA+DH,iBAAe,cAAc,kBA0E5B;AAOD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/scripts/compile-json-to-types.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env tsx
+/**
+ * Compile JSON schemas to TypeScript types
+ *
+ * This script reads the JSON schemas from src/schemas/ (with $ref references)
+ * and generates TypeScript types using json-schema-to-typescript.
+ * It handles $ref resolution automatically.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { compile } from 'json-schema-to-typescript';
+import { fileURLToPath } from 'url';
+// ESM equivalent of __dirname
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Paths
+const SCHEMAS_DIR = path.join(__dirname, '../src/schemas/generated');
+const OUTPUT_DIR = path.join(__dirname, '../src/types/generated');
+/**
+ * Generate schema mappings by reading all JSON files in the schemas directory
+ */
+function generateSchemaMappings(schemasDir) {
+    const mappings = {};
+    if (!fs.existsSync(schemasDir)) {
+        console.warn(`⚠️  Schemas directory not found: ${schemasDir}`);
+        return mappings;
+    }
+    const files = fs.readdirSync(schemasDir)
+        .filter(file => file.endsWith('.json'))
+        .sort();
+    for (const jsonFile of files) {
+        // Convert all schemas consistently: "actor_record_schema.json" → "actor_record.ts"
+        const tsFileName = jsonFile.replace('_schema.json', '.ts');
+        mappings[jsonFile] = tsFileName;
+    }
+    return mappings;
+}
+/**
+ * Custom resolver for $ref references within our schemas directory
+ */
+function createRefResolver(schemasDir) {
+    return {
+        order: 1,
+        canRead: (file) => {
+            return typeof file.url === 'string' && file.url.startsWith('ref:');
+        },
+        read: (file) => {
+            const schemaName = file.url.replace('ref:', '');
+            const jsonPath = path.join(schemasDir, `${schemaName}.json`);
+            if (fs.existsSync(jsonPath)) {
+                const content = fs.readFileSync(jsonPath, 'utf8');
+                return JSON.parse(content);
+            }
+            else {
+                console.warn(`⚠️  Referenced schema not found: ${jsonPath}`);
+                return {}; // Return empty schema as fallback
+            }
+        }
+    };
+}
+async function compileSchemas() {
+    console.log('🔄 Compiling JSON schemas to TypeScript types...');
+    // Create output directory if it doesn't exist
+    fs.mkdirSync(OUTPUT_DIR, { recursive: true });
+    const compiledTypes = [];
+    // Generate schema mappings dynamically
+    const schemaMappings = generateSchemaMappings(SCHEMAS_DIR);
+    // Process each schema mapping
+    for (const [jsonFile, tsFile] of Object.entries(schemaMappings)) {
+        const jsonPath = path.join(SCHEMAS_DIR, jsonFile);
+        const tsPath = path.join(OUTPUT_DIR, tsFile);
+        if (!fs.existsSync(jsonPath)) {
+            console.warn(`⚠️  Schema not found: ${jsonPath}`);
+            continue;
+        }
+        try {
+            // Read JSON schema
+            const schemaContent = fs.readFileSync(jsonPath, 'utf8');
+            const schema = JSON.parse(schemaContent);
+            // Generate TypeScript type name
+            const typeName = path.basename(tsFile, '.ts')
+                .split('_')
+                .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+                .join('');
+            // Compile to TypeScript with custom options
+            const tsContent = await compile(schema, typeName, {
+                bannerComment: `/**
+ * This file was automatically generated from ${jsonFile}.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
+ * and run 'pnpm compile:types' to regenerate this file.
+ */`,
+                style: {
+                    singleQuote: true,
+                },
+                // Custom resolver for handling $ref to other schemas
+                $refOptions: {
+                    resolve: {
+                        // Custom resolver for our schema references
+                        file: createRefResolver(SCHEMAS_DIR)
+                    }
+                },
+                // Additional options for better type generation
+                additionalProperties: false,
+                enableConstEnums: true,
+                strictIndexSignatures: true,
+            });
+            // Write TypeScript file
+            fs.writeFileSync(tsPath, tsContent);
+            console.log(`✅ ${jsonFile} → types/${tsFile}`);
+            compiledTypes.push(path.basename(tsFile, '.ts'));
+        }
+        catch (error) {
+            console.error(`❌ Failed to compile ${jsonFile}:`, error);
+            // Don't exit on error, continue with other schemas
+            console.log(`   Continuing with other schemas...`);
+        }
+    }
+    console.log(`🎉 Successfully compiled ${compiledTypes.length} schema types!`);
+    if (compiledTypes.length > 0) {
+        console.log(`📁 Types generated in: ${OUTPUT_DIR}`);
+        console.log(`🔗 Available types: ${compiledTypes.join(', ')}`);
+    }
+}
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    compileSchemas().catch(console.error);
+}
+export { compileSchemas };
+//# sourceMappingURL=compile-json-to-types.js.map

package/dist/scripts/compile-json-to-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-json-to-types.js","sourceRoot":"","sources":["../../scripts/compile-json-to-types.ts"],"names":[],"mappings":"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"}

package/dist/scripts/diagnose-duplicates.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env tsx
+/**
+ * Diagnostic script to detect duplicate nodes and edges in GitGovernance data
+ * Usage: npx tsx packages/core/scripts/diagnose-duplicates.ts
+ */
+export {};
+//# sourceMappingURL=diagnose-duplicates.d.ts.map

package/dist/scripts/diagnose-duplicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose-duplicates.d.ts","sourceRoot":"","sources":["../../scripts/diagnose-duplicates.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/scripts/diagnose-duplicates.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env tsx
+/**
+ * Diagnostic script to detect duplicate nodes and edges in GitGovernance data
+ * Usage: npx tsx packages/core/scripts/diagnose-duplicates.ts
+ */
+import { DiagramGenerator } from '../src/diagram_generator/index.js';
+import { ConfigManager } from '../src/config_manager/index.js';
+import * as path from 'path';
+async function diagnoseDuplicates() {
+    console.log('🔍 Diagnosing duplicates in GitGovernance data...');
+    try {
+        // Find project root
+        const projectRoot = ConfigManager.findProjectRoot();
+        if (!projectRoot) {
+            throw new Error("Could not find project root.");
+        }
+        // Initialize generator
+        const generator = new DiagramGenerator({
+            layout: 'LR',
+            includeEpicTasks: true,
+            maxDepth: 4,
+            colorScheme: 'default',
+            showAssignments: false,
+        });
+        // Load records
+        const gitgovPath = path.join(projectRoot, '.gitgov');
+        const cycles = await generator.loadCycleRecords(gitgovPath);
+        const tasks = await generator.loadTaskRecords(gitgovPath);
+        console.log(`📊 Loaded ${cycles.length} cycles and ${tasks.length} tasks`);
+        // Detect duplicates using our new method
+        const duplicates = generator.analyzer.detectDuplicates(cycles, tasks);
+        if (duplicates.duplicateNodes.length === 0 && duplicates.duplicateEdges.length === 0) {
+            console.log('✅ No duplicates found!');
+        }
+        else {
+            console.log('\n🔴 Duplicates detected:');
+            if (duplicates.duplicateNodes.length > 0) {
+                console.log('\n📦 Duplicate Nodes:');
+                duplicates.duplicateNodes.forEach(dup => {
+                    console.log(`  • ${dup.id} (appears ${dup.count} times)`);
+                    console.log(`    Sources: ${dup.sources.join(', ')}`);
+                });
+            }
+            if (duplicates.duplicateEdges.length > 0) {
+                console.log('\n🔗 Duplicate Edges:');
+                duplicates.duplicateEdges.forEach(dup => {
+                    console.log(`  • ${dup.edge} (appears ${dup.count} times)`);
+                });
+            }
+        }
+        // Generate graph with deduplication
+        console.log('\n🔄 Generating deduplicated graph...');
+        const graph = generator.analyzer.analyzeRelationships(cycles, tasks);
+        if (graph.metadata.duplicatesRemoved) {
+            const { nodes: nodesDup, edges: edgesDup } = graph.metadata.duplicatesRemoved;
+            if (nodesDup > 0 || edgesDup > 0) {
+                console.log(`✂️  Removed ${nodesDup} duplicate nodes and ${edgesDup} duplicate edges`);
+            }
+            else {
+                console.log('✅ No duplicates were removed (clean data)');
+            }
+        }
+        console.log(`📈 Final graph: ${graph.metadata.nodeCount} nodes, ${graph.metadata.edgeCount} edges`);
+    }
+    catch (error) {
+        console.error('❌ Error during diagnosis:', error);
+        process.exit(1);
+    }
+}
+// Run the diagnostic
+diagnoseDuplicates();
+//# sourceMappingURL=diagnose-duplicates.js.map

package/dist/scripts/diagnose-duplicates.js.map

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

package/dist/scripts/generate-indexes.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env tsx
+/**
+ * Generate index.ts files for schemas and types directories
+ *
+ * This script creates appropriate index files for both:
+ * - schemas/: Complex object exports with JSON imports
+ * - types/: Simple re-exports of TypeScript types
+ */
+/**
+ * Generate schemas/index.ts with JSON imports and object exports
+ */
+declare function generateSchemasIndex(): void;
+/**
+ * Generate types/index.ts with simple re-exports
+ */
+declare function generateTypesIndex(): void;
+/**
+ * Generate both index files
+ */
+declare function generateIndexes(): Promise<void>;
+export { generateIndexes, generateSchemasIndex, generateTypesIndex };
+//# sourceMappingURL=generate-indexes.d.ts.map

package/dist/scripts/generate-indexes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-indexes.d.ts","sourceRoot":"","sources":["../../scripts/generate-indexes.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AA4BH;;GAEG;AACH,iBAAS,oBAAoB,SAwF5B;AAED;;GAEG;AACH,iBAAS,kBAAkB,SAsC1B;AAED;;GAEG;AACH,iBAAe,eAAe,kBAW7B;AAOD,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,CAAC"}