@ginkoai/cli 1.0.0 → 1.4.1

package/dist/lib/write-dispatcher/write-dispatcher.js

@@ -0,0 +1,197 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-02
+ * @tags: [write-dispatch, adapter-pattern, multi-backend, adr-041]
+ * @related: [adapters/graph-adapter.ts, adapters/local-adapter.ts, api/v1/graph/_cloud-graph-client.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: []
+ */
+/**
+ * WriteDispatcher
+ *
+ * Routes write operations to multiple backends using the adapter pattern.
+ * Supports dual-write migration strategy and graceful fallback.
+ *
+ * Architecture (ADR-041):
+ * - Primary adapter (graph) must succeed for write to be considered successful
+ * - Secondary adapters (local) run concurrently for dual-write period
+ * - Environment variables control which adapters are enabled
+ * - Single source of truth: graph for reads, dispatched writes
+ *
+ * Usage:
+ * ```typescript
+ * const dispatcher = new WriteDispatcher({ primaryAdapter: 'graph' });
+ * dispatcher.registerAdapter(new GraphAdapter());
+ * dispatcher.registerAdapter(new LocalAdapter());
+ *
+ * const result = await dispatcher.dispatch({
+ *   type: 'ADR',
+ *   id: 'adr_042',
+ *   title: 'Use JWT',
+ *   content: '# ADR-042...',
+ *   data: { status: 'proposed' }
+ * });
+ * ```
+ */
+export class WriteDispatcher {
+    adapters = new Map();
+    config;
+    constructor(config) {
+        this.config = {
+            primaryAdapter: config.primaryAdapter,
+            enabledAdapters: config.enabledAdapters || [],
+            dualWrite: config.dualWrite !== undefined ? config.dualWrite : true,
+            failFast: config.failFast !== undefined ? config.failFast : true,
+        };
+    }
+    /**
+     * Register a write adapter
+     */
+    registerAdapter(adapter) {
+        this.adapters.set(adapter.name, adapter);
+    }
+    /**
+     * Unregister an adapter
+     */
+    unregisterAdapter(name) {
+        this.adapters.delete(name);
+    }
+    /**
+     * Get list of registered adapters
+     */
+    getAdapters() {
+        return Array.from(this.adapters.keys());
+    }
+    /**
+     * Get enabled adapters based on configuration
+     */
+    getEnabledAdapters() {
+        return Array.from(this.adapters.values()).filter(adapter => {
+            // Check if adapter itself is enabled
+            if (!adapter.enabled()) {
+                return false;
+            }
+            // If enabledAdapters list is specified, check if adapter is in the list
+            if (this.config.enabledAdapters && this.config.enabledAdapters.length > 0) {
+                return this.config.enabledAdapters.includes(adapter.name);
+            }
+            return true;
+        });
+    }
+    /**
+     * Dispatch write operation to all enabled adapters
+     *
+     * Strategy:
+     * 1. Execute all enabled adapters concurrently
+     * 2. Wait for primary adapter to complete
+     * 3. If primary fails, throw error (fail fast)
+     * 4. If primary succeeds, return its result
+     * 5. Secondary adapter failures are logged but don't block
+     *
+     * @throws Error if primary adapter fails
+     */
+    async dispatch(document) {
+        const enabledAdapters = this.getEnabledAdapters();
+        if (enabledAdapters.length === 0) {
+            throw new Error('No enabled adapters available for write dispatch');
+        }
+        // Find primary adapter
+        const primaryAdapter = enabledAdapters.find(a => a.name === this.config.primaryAdapter);
+        if (!primaryAdapter) {
+            throw new Error(`Primary adapter '${this.config.primaryAdapter}' not found or not enabled`);
+        }
+        // Execute all adapters concurrently
+        const writePromises = enabledAdapters.map(adapter => adapter
+            .write(document)
+            .then(result => ({ adapter: adapter.name, result, success: true }))
+            .catch(error => ({
+            adapter: adapter.name,
+            error: error instanceof Error ? error.message : String(error),
+            success: false,
+        })));
+        const results = await Promise.all(writePromises);
+        // Check primary adapter result
+        const primaryResult = results.find(r => r.adapter === this.config.primaryAdapter);
+        if (!primaryResult) {
+            throw new Error(`Primary adapter '${this.config.primaryAdapter}' not found in results`);
+        }
+        if (!primaryResult.success) {
+            const errorMsg = 'error' in primaryResult ? primaryResult.error : 'Unknown error';
+            throw new Error(`Primary adapter '${this.config.primaryAdapter}' failed: ${errorMsg}`);
+        }
+        // Log secondary adapter failures (non-blocking)
+        const secondaryFailures = results.filter((r) => !r.success && r.adapter !== this.config.primaryAdapter);
+        if (secondaryFailures.length > 0) {
+            for (const failure of secondaryFailures) {
+                console.warn(`[WriteDispatcher] Secondary adapter '${failure.adapter}' failed: ${failure.error}`);
+            }
+        }
+        // Return primary adapter result
+        return primaryResult.result;
+    }
+    /**
+     * Validate configuration and adapters
+     */
+    validate() {
+        const errors = [];
+        // Check if primary adapter is registered
+        if (!this.adapters.has(this.config.primaryAdapter)) {
+            errors.push(`Primary adapter '${this.config.primaryAdapter}' is not registered`);
+        }
+        // Check if at least one adapter is enabled
+        const enabledAdapters = this.getEnabledAdapters();
+        if (enabledAdapters.length === 0) {
+            errors.push('No adapters are enabled. Check environment configuration.');
+        }
+        // Check if primary adapter is enabled
+        const primaryEnabled = enabledAdapters.some(a => a.name === this.config.primaryAdapter);
+        if (!primaryEnabled && this.adapters.has(this.config.primaryAdapter)) {
+            errors.push(`Primary adapter '${this.config.primaryAdapter}' is registered but not enabled`);
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Get dispatcher status
+     */
+    getStatus() {
+        const enabledAdapters = this.getEnabledAdapters();
+        return {
+            primaryAdapter: this.config.primaryAdapter,
+            registeredAdapters: Array.from(this.adapters.keys()),
+            enabledAdapters: enabledAdapters.map(a => a.name),
+            dualWrite: this.config.dualWrite,
+        };
+    }
+}
+/**
+ * Global dispatcher instance (singleton)
+ */
+let globalDispatcher = null;
+/**
+ * Initialize global dispatcher
+ */
+export function initializeDispatcher(config) {
+    globalDispatcher = new WriteDispatcher(config);
+    return globalDispatcher;
+}
+/**
+ * Get global dispatcher instance
+ */
+export function getDispatcher() {
+    if (!globalDispatcher) {
+        throw new Error('WriteDispatcher not initialized. Call initializeDispatcher() first.');
+    }
+    return globalDispatcher;
+}
+/**
+ * Check if dispatcher is initialized
+ */
+export function isDispatcherInitialized() {
+    return globalDispatcher !== null;
+}
+//# sourceMappingURL=write-dispatcher.js.map

package/dist/lib/write-dispatcher/write-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-dispatcher.js","sourceRoot":"","sources":["../../../src/lib/write-dispatcher/write-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,GAA8B,IAAI,GAAG,EAAE,CAAC;IAChD,MAAM,CAAkC;IAEhD,YAAY,MAA6B;QACvC,IAAI,CAAC,MAAM,GAAG;YACZ,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE;YAC7C,SAAS,EAAE,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;YACnE,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;SACjE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAqB;QACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,IAAY;QAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACK,kBAAkB;QACxB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;YACzD,qCAAqC;YACrC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBACvB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,wEAAwE;YACxE,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5D,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,QAAQ,CAAC,QAA2B;QACxC,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAElD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QAED,uBAAuB;QACvB,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACxF,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,MAAM,CAAC,cAAc,4BAA4B,CAAC,CAAC;QAC9F,CAAC;QAED,oCAAoC;QACpC,MAAM,aAAa,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAClD,OAAO;aACJ,KAAK,CAAC,QAAQ,CAAC;aACf,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAa,EAAE,CAAC,CAAC;aAC3E,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACf,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC7D,OAAO,EAAE,KAAc;SACxB,CAAC,CAAC,CACN,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAEjD,+BAA+B;QAC/B,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAElF,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,MAAM,CAAC,cAAc,wBAAwB,CAAC,CAAC;QAC1F,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,OAAO,IAAI,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,MAAM,CAAC,cAAc,aAAa,QAAQ,EAAE,CAAC,CAAC;QACzF,CAAC;QAED,gDAAgD;QAChD,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAA2D,EAAE,CACtG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,CAAC,cAAc,CACvD,CAAC;QAEF,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;gBACxC,OAAO,CAAC,IAAI,CAAC,wCAAwC,OAAO,CAAC,OAAO,aAAa,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YACpG,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,OAAO,aAAa,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,yCAAyC;QACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,MAAM,CAAC,cAAc,qBAAqB,CAAC,CAAC;QACnF,CAAC;QAED,2CAA2C;QAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAClD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC3E,CAAC;QAED,sCAAsC;QACtC,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACxF,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,MAAM,CAAC,cAAc,iCAAiC,CAAC,CAAC;QAC/F,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS;QAMP,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAElD,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC1C,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpD,eAAe,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACjD,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;SACjC,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,IAAI,gBAAgB,GAA2B,IAAI,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA6B;IAChE,gBAAgB,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,gBAAgB,KAAK,IAAI,CAAC;AACnC,CAAC"}

package/dist/types/charter.d.ts

@@ -0,0 +1,330 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-11-10
+ * @tags: [types, charter, project-charter, conversation, confidence-scoring]
+ * @related: [charter-storage.ts, conversation-facilitator.ts, charter-synthesizer.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+/**
+ * Work modes determine charter depth and conversation style
+ */
+export type WorkMode = 'hack-ship' | 'think-build' | 'full-planning';
+/**
+ * Charter status lifecycle
+ */
+export type CharterStatus = 'draft' | 'active' | 'archived';
+/**
+ * Charter aspects tracked for confidence scoring
+ */
+export type CharterAspect = 'purpose' | 'users' | 'success' | 'scope';
+/**
+ * Version bump types for semantic versioning
+ */
+export type VersionBump = 'major' | 'minor' | 'patch';
+/**
+ * Scope boundaries: what's in, out, and to be determined
+ */
+export interface CharterScope {
+    inScope: string[];
+    outOfScope: string[];
+    tbd: string[];
+}
+/**
+ * Main charter content
+ */
+export interface CharterContent {
+    purpose: string;
+    users: string[];
+    successCriteria: string[];
+    scope: CharterScope;
+    constraints?: string;
+    timeline?: string;
+    team?: string[];
+    risks?: string[];
+    alternatives?: string[];
+    governance?: string;
+}
+/**
+ * Score for a single charter aspect (0-100)
+ */
+export interface AspectScore {
+    score: number;
+    signals: string[];
+    missing: string[];
+}
+/**
+ * Confidence metrics for charter completeness
+ */
+export interface CharterConfidence {
+    purpose: AspectScore;
+    users: AspectScore;
+    success: AspectScore;
+    scope: AspectScore;
+    overall: number;
+}
+/**
+ * Confidence thresholds for decision-making
+ */
+export declare const CONFIDENCE_THRESHOLDS: {
+    readonly CRITICAL: 40;
+    readonly WORKABLE: 70;
+    readonly EXCELLENT: 90;
+};
+/**
+ * Semantic version structure
+ */
+export interface CharterVersion {
+    major: number;
+    minor: number;
+    patch: number;
+}
+/**
+ * Single changelog entry
+ */
+export interface ChangelogEntry {
+    version: string;
+    date: string;
+    changes: string[];
+    participants: string[];
+    confidence?: number;
+}
+/**
+ * Complete project charter
+ */
+export interface Charter {
+    id: string;
+    projectId: string;
+    status: CharterStatus;
+    workMode: WorkMode;
+    version: CharterVersion;
+    createdAt: Date;
+    updatedAt: Date;
+    content: CharterContent;
+    confidence: CharterConfidence;
+    changelog: ChangelogEntry[];
+    graphNodeId?: string;
+    embedding?: number[];
+}
+/**
+ * A single conversation exchange
+ */
+export interface ConversationExchange {
+    question: string;
+    response: string;
+    timestamp: Date;
+    aspectsAddressed: CharterAspect[];
+}
+/**
+ * Work mode detection signals
+ */
+export interface WorkModeSignals {
+    hackShip: number;
+    thinkBuild: number;
+    fullPlanning: number;
+}
+/**
+ * Full conversation context during charter creation
+ */
+export interface ConversationContext {
+    exchanges: ConversationExchange[];
+    workModeSignals: WorkModeSignals;
+    tbdAspects: Set<CharterAspect>;
+    nudgeCount: number;
+    lastNudgeTime?: Date;
+    stopSignals: boolean;
+}
+/**
+ * Extracted content from conversation
+ */
+export interface ExtractedContent {
+    problemStatements: string[];
+    valueStatements: string[];
+    userTypes: string[];
+    successCriteria: string[];
+    inScope: string[];
+    outOfScope: string[];
+    constraints: string[];
+    timeline: string[];
+    team: string[];
+    risks?: string[];
+    alternatives?: string[];
+}
+/**
+ * Question template for a specific aspect
+ */
+export interface QuestionTemplate {
+    aspect: CharterAspect;
+    question: string;
+    followUps: string[];
+    keywords: string[];
+    weight: number;
+}
+/**
+ * Question selection context
+ */
+export interface QuestionContext {
+    previousQuestions: string[];
+    aspectsCovered: Set<CharterAspect>;
+    responseDepth: 'shallow' | 'moderate' | 'deep';
+    userTone: 'urgent' | 'exploratory' | 'methodical';
+}
+/**
+ * File storage metadata
+ */
+export interface FileStorageMetadata {
+    path: string;
+    exists: boolean;
+    lastModified?: Date;
+    size?: number;
+}
+/**
+ * Graph storage metadata
+ */
+export interface GraphStorageMetadata {
+    nodeId?: string;
+    synced: boolean;
+    lastSyncedAt?: Date;
+    syncError?: string;
+}
+/**
+ * Complete storage status
+ */
+export interface CharterStorageStatus {
+    file: FileStorageMetadata;
+    graph: GraphStorageMetadata;
+    inSync: boolean;
+}
+/**
+ * Storage operation result
+ */
+export interface CharterStorageResult {
+    success: boolean;
+    charter?: Charter;
+    error?: string;
+    storageStatus: CharterStorageStatus;
+}
+/**
+ * Options for ginko charter command
+ */
+export interface CharterOptions {
+    view?: boolean;
+    edit?: boolean;
+    mode?: WorkMode;
+    skipConversation?: boolean;
+    outputPath?: string;
+}
+/**
+ * Options for charter creation
+ */
+export interface CharterCreateOptions {
+    workMode?: WorkMode;
+    skipGraphSync?: boolean;
+    customPath?: string;
+}
+/**
+ * Options for charter editing
+ */
+export interface CharterEditOptions {
+    conversational?: boolean;
+    directEdit?: boolean;
+    aspectToEdit?: CharterAspect;
+}
+/**
+ * Charter preview summary
+ */
+export interface CharterPreview {
+    title: string;
+    purpose: string;
+    keyPoints: string[];
+    confidence: number;
+    workMode: WorkMode;
+}
+/**
+ * Diff between two charter versions
+ */
+export interface CharterDiff {
+    versionFrom: string;
+    versionTo: string;
+    additions: string[];
+    deletions: string[];
+    modifications: string[];
+    significantChange: boolean;
+}
+/**
+ * Charter validation result
+ */
+export interface CharterValidation {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    suggestions: string[];
+}
+/**
+ * Validation rules
+ */
+export interface ValidationRule {
+    name: string;
+    description: string;
+    check: (charter: Charter) => boolean;
+    severity: 'error' | 'warning' | 'info';
+}
+/**
+ * Default charter file path
+ */
+export declare const DEFAULT_CHARTER_PATH = "docs/PROJECT-CHARTER.md";
+/**
+ * Work mode characteristics
+ */
+export declare const WORK_MODE_CHARACTERISTICS: {
+    readonly 'hack-ship': {
+        readonly name: "Hack & Ship";
+        readonly description: "Quick prototype, MVP, weekend project";
+        readonly conversationDepth: "light";
+        readonly targetTime: 5;
+        readonly requiredSections: readonly ["purpose", "scope"];
+        readonly keywords: readonly ["quick", "prototype", "MVP", "weekend", "validate"];
+    };
+    readonly 'think-build': {
+        readonly name: "Think & Build";
+        readonly description: "Team project with process and testing";
+        readonly conversationDepth: "standard";
+        readonly targetTime: 15;
+        readonly requiredSections: readonly ["purpose", "users", "success", "scope", "constraints"];
+        readonly keywords: readonly ["team", "process", "testing", "architecture"];
+    };
+    readonly 'full-planning': {
+        readonly name: "Full Planning";
+        readonly description: "Enterprise project with stakeholders and governance";
+        readonly conversationDepth: "comprehensive";
+        readonly targetTime: 30;
+        readonly requiredSections: readonly ["purpose", "users", "success", "scope", "constraints", "risks", "alternatives", "governance"];
+        readonly keywords: readonly ["stakeholders", "governance", "risks", "alternatives", "compliance"];
+    };
+};
+/**
+ * Check if value is a valid WorkMode
+ */
+export declare function isWorkMode(value: any): value is WorkMode;
+/**
+ * Check if value is a valid CharterStatus
+ */
+export declare function isCharterStatus(value: any): value is CharterStatus;
+/**
+ * Check if value is a valid CharterAspect
+ */
+export declare function isCharterAspect(value: any): value is CharterAspect;
+/**
+ * Partial charter for updates
+ */
+export type CharterUpdate = Partial<Pick<Charter, 'content' | 'status' | 'workMode' | 'confidence'>>;
+/**
+ * Charter summary for listings
+ */
+export type CharterSummary = Pick<Charter, 'id' | 'status' | 'workMode' | 'version' | 'updatedAt'> & {
+    title: string;
+    confidenceOverall: number;
+};
+//# sourceMappingURL=charter.d.ts.map

package/dist/types/charter.d.ts.map

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

package/dist/types/charter.js

@@ -0,0 +1,76 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-11-10
+ * @tags: [types, charter, project-charter, conversation, confidence-scoring]
+ * @related: [charter-storage.ts, conversation-facilitator.ts, charter-synthesizer.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+/**
+ * Confidence thresholds for decision-making
+ */
+export const CONFIDENCE_THRESHOLDS = {
+    CRITICAL: 40, // Below this needs gentle probing
+    WORKABLE: 70, // Above this is good enough to start
+    EXCELLENT: 90, // Very comprehensive
+};
+// ============================================================================
+// Helper Functions & Constants
+// ============================================================================
+/**
+ * Default charter file path
+ */
+export const DEFAULT_CHARTER_PATH = 'docs/PROJECT-CHARTER.md';
+/**
+ * Work mode characteristics
+ */
+export const WORK_MODE_CHARACTERISTICS = {
+    'hack-ship': {
+        name: 'Hack & Ship',
+        description: 'Quick prototype, MVP, weekend project',
+        conversationDepth: 'light',
+        targetTime: 5, // minutes
+        requiredSections: ['purpose', 'scope'],
+        keywords: ['quick', 'prototype', 'MVP', 'weekend', 'validate'],
+    },
+    'think-build': {
+        name: 'Think & Build',
+        description: 'Team project with process and testing',
+        conversationDepth: 'standard',
+        targetTime: 15, // minutes
+        requiredSections: ['purpose', 'users', 'success', 'scope', 'constraints'],
+        keywords: ['team', 'process', 'testing', 'architecture'],
+    },
+    'full-planning': {
+        name: 'Full Planning',
+        description: 'Enterprise project with stakeholders and governance',
+        conversationDepth: 'comprehensive',
+        targetTime: 30, // minutes
+        requiredSections: ['purpose', 'users', 'success', 'scope', 'constraints', 'risks', 'alternatives', 'governance'],
+        keywords: ['stakeholders', 'governance', 'risks', 'alternatives', 'compliance'],
+    },
+};
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Check if value is a valid WorkMode
+ */
+export function isWorkMode(value) {
+    return ['hack-ship', 'think-build', 'full-planning'].includes(value);
+}
+/**
+ * Check if value is a valid CharterStatus
+ */
+export function isCharterStatus(value) {
+    return ['draft', 'active', 'archived'].includes(value);
+}
+/**
+ * Check if value is a valid CharterAspect
+ */
+export function isCharterAspect(value) {
+    return ['purpose', 'users', 'success', 'scope'].includes(value);
+}
+//# sourceMappingURL=charter.js.map

package/dist/types/charter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charter.js","sourceRoot":"","sources":["../../src/types/charter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+EH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,EAAE,EAAI,kCAAkC;IAClD,QAAQ,EAAE,EAAE,EAAI,qCAAqC;IACrD,SAAS,EAAE,EAAE,EAAG,qBAAqB;CAC7B,CAAC;AAqQX,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,uCAAuC;QACpD,iBAAiB,EAAE,OAAO;QAC1B,UAAU,EAAE,CAAC,EAAE,UAAU;QACzB,gBAAgB,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;QACtC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC;KAC/D;IACD,aAAa,EAAE;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,uCAAuC;QACpD,iBAAiB,EAAE,UAAU;QAC7B,UAAU,EAAE,EAAE,EAAE,UAAU;QAC1B,gBAAgB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC;QACzE,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC;KACzD;IACD,eAAe,EAAE;QACf,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,qDAAqD;QAClE,iBAAiB,EAAE,eAAe;QAClC,UAAU,EAAE,EAAE,EAAE,UAAU;QAC1B,gBAAgB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,CAAC;QAChH,QAAQ,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,CAAC;KAChF;CACO,CAAC;AAEX,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAU;IACnC,OAAO,CAAC,WAAW,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAU;IACxC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAU;IACxC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}