@kynetic-ai/spec 0.1.0

package/dist/parser/refs.js

@@ -0,0 +1,404 @@
+/**
+ * Reference resolution system for @references.
+ *
+ * Handles resolution of @slug and @ulid references to actual items,
+ * with proper error handling for not-found and ambiguous cases.
+ */
+// ============================================================
+// REFERENCE INDEX
+// ============================================================
+/**
+ * Index for efficient reference resolution.
+ * Build once when loading the spec, then resolve many times.
+ * AC: @agent-definitions ac-agent-3
+ */
+export class ReferenceIndex {
+    /** slug → ULID mapping */
+    slugIndex = new Map();
+    /** ULID → item mapping */
+    ulidIndex = new Map();
+    /** All ULIDs for prefix matching */
+    allUlids = [];
+    /**
+     * Build index from loaded items and meta items
+     * AC: @agent-definitions ac-agent-3
+     */
+    constructor(tasks, items, metaItems = []) {
+        // Index tasks
+        for (const task of tasks) {
+            this.indexItem(task);
+        }
+        // Index spec items
+        for (const item of items) {
+            this.indexItem(item);
+        }
+        // Index meta items (agents, workflows, conventions, observations)
+        // AC: @agent-definitions ac-agent-3
+        for (const metaItem of metaItems) {
+            this.indexMetaItem(metaItem);
+        }
+        // Sort ULIDs for consistent ordering
+        this.allUlids.sort();
+    }
+    indexItem(item) {
+        const ulid = item._ulid;
+        // Index by ULID
+        this.ulidIndex.set(ulid, item);
+        this.allUlids.push(ulid);
+        // Index by slugs
+        for (const slug of item.slugs) {
+            const existing = this.slugIndex.get(slug);
+            if (existing) {
+                existing.push(ulid);
+            }
+            else {
+                this.slugIndex.set(slug, [ulid]);
+            }
+        }
+    }
+    /**
+     * Index a meta item (agent, workflow, convention, observation)
+     * Meta items use 'id' field as their slug
+     * AC: @agent-definitions ac-agent-3
+     */
+    indexMetaItem(item) {
+        const ulid = item._ulid;
+        // Index by ULID
+        this.ulidIndex.set(ulid, item);
+        this.allUlids.push(ulid);
+        // Index by id (acts like a slug for meta items)
+        const metaItem = item;
+        if (metaItem.id) {
+            const existing = this.slugIndex.get(metaItem.id);
+            if (existing) {
+                existing.push(ulid);
+            }
+            else {
+                this.slugIndex.set(metaItem.id, [ulid]);
+            }
+        }
+    }
+    /**
+     * Resolve a reference to an item.
+     *
+     * Resolution order:
+     * 1. Exact slug match
+     * 2. Full ULID match
+     * 3. ULID prefix match (must be unique)
+     */
+    resolve(ref) {
+        // Strip @ prefix if present
+        const cleanRef = ref.startsWith('@') ? ref.slice(1) : ref;
+        const cleanRefLower = cleanRef.toLowerCase();
+        // 1. Try slug match first
+        const slugMatches = this.slugIndex.get(cleanRef);
+        if (slugMatches) {
+            if (slugMatches.length > 1) {
+                return {
+                    ok: false,
+                    error: 'duplicate_slug',
+                    ref,
+                    candidates: slugMatches,
+                };
+            }
+            const ulid = slugMatches[0];
+            const item = this.ulidIndex.get(ulid);
+            return { ok: true, ulid, item, matchType: 'slug' };
+        }
+        // 2. Try full ULID match
+        const exactMatch = this.ulidIndex.get(cleanRef.toUpperCase());
+        if (exactMatch) {
+            return {
+                ok: true,
+                ulid: exactMatch._ulid,
+                item: exactMatch,
+                matchType: 'ulid-full',
+            };
+        }
+        // 3. Try ULID prefix match
+        const prefixMatches = this.allUlids.filter(ulid => ulid.toLowerCase().startsWith(cleanRefLower));
+        if (prefixMatches.length === 0) {
+            return { ok: false, error: 'not_found', ref };
+        }
+        if (prefixMatches.length > 1) {
+            return {
+                ok: false,
+                error: 'ambiguous',
+                ref,
+                candidates: prefixMatches,
+            };
+        }
+        const ulid = prefixMatches[0];
+        const item = this.ulidIndex.get(ulid);
+        return { ok: true, ulid, item, matchType: 'ulid-prefix' };
+    }
+    /**
+     * Get an item by exact ULID (no resolution, direct lookup)
+     */
+    getByUlid(ulid) {
+        return this.ulidIndex.get(ulid);
+    }
+    /**
+     * Get the minimum unique prefix for a ULID.
+     * Returns the shortest prefix that uniquely identifies this ULID
+     * among all indexed items.
+     *
+     * @param ulid The full ULID to shorten
+     * @param minLength Minimum prefix length (default 8)
+     * @returns Shortest unique prefix
+     */
+    shortUlid(ulid, minLength = 8) {
+        // Start with minimum length
+        let length = minLength;
+        while (length < ulid.length) {
+            const prefix = ulid.slice(0, length);
+            const matches = this.allUlids.filter(u => u.toUpperCase().startsWith(prefix.toUpperCase()));
+            if (matches.length === 1) {
+                return prefix;
+            }
+            length++;
+        }
+        // Return full ULID if no shorter unique prefix found
+        return ulid;
+    }
+    /**
+     * Get all indexed ULIDs
+     */
+    getAllUlids() {
+        return [...this.allUlids];
+    }
+    /**
+     * Get all slugs and their mappings
+     */
+    getAllSlugs() {
+        return new Map(this.slugIndex);
+    }
+    /**
+     * Check if a slug exists
+     */
+    hasSlug(slug) {
+        return this.slugIndex.has(slug);
+    }
+    /**
+     * Get count of indexed items
+     */
+    get size() {
+        return this.ulidIndex.size;
+    }
+}
+// ============================================================
+// VALIDATION
+// ============================================================
+/**
+ * Fields that contain references
+ * AC: @agent-definitions ac-agent-3 - added_by for agent references
+ * AC: @workflow-definitions ac-workflow-3 - meta_ref for workflow references
+ * AC: @traits-field ac-1 - traits field contains refs to trait-type items
+ */
+const REF_FIELDS = [
+    'depends_on',
+    'blocked_by',
+    'implements',
+    'relates_to',
+    'tests',
+    'supersedes',
+    'spec_ref',
+    'context',
+    'added_by', // Agent reference
+    'author', // Agent reference
+    'resolved_by', // Agent reference
+    'workflow_ref', // Workflow reference
+    'meta_ref', // Meta reference (workflow, agent, convention)
+    'traits', // Trait references (AC: @traits-field ac-1)
+];
+/**
+ * Check if an item is deprecated
+ */
+function isDeprecated(item) {
+    const obj = item;
+    // Check for deprecated_in field (truthy value means deprecated)
+    if ('deprecated_in' in obj && obj.deprecated_in) {
+        return true;
+    }
+    // Check for maturity: deprecated status
+    if ('status' in obj && obj.status && typeof obj.status === 'object') {
+        const status = obj.status;
+        if ('maturity' in status && status.maturity === 'deprecated') {
+            return true;
+        }
+    }
+    // Also check top-level maturity field (some items may have it there)
+    if ('maturity' in obj && obj.maturity === 'deprecated') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Extract all references from an item
+ * AC: @agent-definitions ac-agent-3 - also checks nested notes for author refs
+ */
+function extractRefs(item) {
+    const refs = [];
+    const obj = item;
+    for (const field of REF_FIELDS) {
+        const value = obj[field];
+        if (typeof value === 'string' && value.startsWith('@')) {
+            refs.push({ field, ref: value });
+        }
+        else if (Array.isArray(value)) {
+            for (const v of value) {
+                if (typeof v === 'string' && v.startsWith('@')) {
+                    refs.push({ field, ref: v });
+                }
+            }
+        }
+    }
+    // Check nested notes for author references
+    // AC: @agent-definitions ac-agent-3
+    if ('notes' in obj && Array.isArray(obj.notes)) {
+        for (const note of obj.notes) {
+            if (note && typeof note === 'object' && 'author' in note) {
+                const author = note.author;
+                if (typeof author === 'string' && author.startsWith('@')) {
+                    refs.push({ field: 'notes[].author', ref: author });
+                }
+            }
+        }
+    }
+    // Check nested todos for added_by references
+    if ('todos' in obj && Array.isArray(obj.todos)) {
+        for (const todo of obj.todos) {
+            if (todo && typeof todo === 'object' && 'added_by' in todo) {
+                const addedBy = todo.added_by;
+                if (typeof addedBy === 'string' && addedBy.startsWith('@')) {
+                    refs.push({ field: 'todos[].added_by', ref: addedBy });
+                }
+            }
+        }
+    }
+    return refs;
+}
+/**
+ * Validate all references in the spec.
+ * Returns list of validation errors and warnings.
+ */
+export function validateRefs(index, tasks, items) {
+    const errors = [];
+    const warnings = [];
+    const allItems = [...tasks, ...items];
+    for (const item of allItems) {
+        const refs = extractRefs(item);
+        const sourceFile = item._sourceFile;
+        // Track traits for duplicate detection (AC: @traits-field ac-5)
+        const seenTraits = new Set();
+        for (const { field, ref } of refs) {
+            const result = index.resolve(ref);
+            if (!result.ok) {
+                let message;
+                switch (result.error) {
+                    case 'not_found':
+                        message = `Reference "${ref}" not found`;
+                        break;
+                    case 'ambiguous':
+                        message = `Reference "${ref}" is ambiguous, matches: ${result.candidates.join(', ')}`;
+                        break;
+                    case 'duplicate_slug':
+                        message = `Slug "${ref}" maps to multiple items: ${result.candidates.join(', ')}`;
+                        break;
+                }
+                errors.push({
+                    ref,
+                    sourceFile,
+                    sourceUlid: item._ulid,
+                    field,
+                    error: result.error,
+                    message,
+                });
+            }
+            else {
+                // Check if resolved target is deprecated
+                if (isDeprecated(result.item)) {
+                    const targetTitle = result.item.title || result.ulid;
+                    warnings.push({
+                        ref,
+                        sourceFile,
+                        sourceUlid: item._ulid,
+                        field,
+                        warning: 'deprecated_target',
+                        message: `Reference "${ref}" points to deprecated item: ${targetTitle}`,
+                    });
+                }
+                // AC: @traits-field ac-3 - traits ref must point to trait-type item
+                if (field === 'traits') {
+                    const targetItem = result.item;
+                    if (targetItem.type !== 'trait') {
+                        errors.push({
+                            ref,
+                            sourceFile,
+                            sourceUlid: item._ulid,
+                            field,
+                            error: 'not_found', // Reuse error type
+                            message: `Trait reference "${ref}" points to non-trait item (type: ${targetItem.type || 'unknown'})`,
+                        });
+                    }
+                    // AC: @traits-field ac-5 - warn on duplicate traits
+                    if (seenTraits.has(result.ulid)) {
+                        const targetTitle = result.item.title || result.ulid;
+                        warnings.push({
+                            ref,
+                            sourceFile,
+                            sourceUlid: item._ulid,
+                            field,
+                            warning: 'deprecated_target', // Reuse warning type for now
+                            message: `Duplicate trait reference "${ref}" (${targetTitle})`,
+                        });
+                    }
+                    seenTraits.add(result.ulid);
+                }
+            }
+        }
+    }
+    return { errors, warnings };
+}
+/**
+ * Find duplicate slugs in the index.
+ * Returns map of slug → ULIDs for slugs with multiple items.
+ */
+export function findDuplicateSlugs(index) {
+    const duplicates = new Map();
+    for (const [slug, ulids] of index.getAllSlugs()) {
+        if (ulids.length > 1) {
+            duplicates.set(slug, ulids);
+        }
+    }
+    return duplicates;
+}
+/**
+ * Check if proposed slugs are unique (don't conflict with existing items).
+ *
+ * @param index The reference index to check against
+ * @param slugs Array of proposed slugs to check
+ * @param excludeUlid Optional ULID to exclude from conflict check (for updates)
+ * @returns Success if all slugs are available, or conflict info if one exists
+ */
+export function checkSlugUniqueness(index, slugs, excludeUlid) {
+    const allSlugs = index.getAllSlugs();
+    for (const slug of slugs) {
+        const existingUlids = allSlugs.get(slug);
+        if (existingUlids) {
+            // Filter out the item being updated (if provided)
+            const conflictingUlids = excludeUlid
+                ? existingUlids.filter(ulid => ulid !== excludeUlid)
+                : existingUlids;
+            if (conflictingUlids.length > 0) {
+                return {
+                    ok: false,
+                    slug,
+                    existingUlid: conflictingUlids[0],
+                };
+            }
+        }
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=refs.js.map

package/dist/parser/refs.js.map

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

package/dist/parser/shadow.d.ts

@@ -0,0 +1,253 @@
+/**
+ * Shadow branch utilities for transparent spec/task state tracking.
+ *
+ * Shadow branch concept:
+ * - Orphan branch (kspec-meta) stores kspec state
+ * - .kspec/ directory is a git worktree pointing to shadow branch
+ * - Main branch gitignores .kspec/
+ * - All kspec read/write operations target .kspec/
+ * - Changes auto-commit to shadow branch
+ */
+export declare function setVerboseModeGetter(getter: () => boolean): void;
+/**
+ * Shadow branch configuration
+ */
+export interface ShadowConfig {
+    /** Whether shadow branch is enabled/detected */
+    enabled: boolean;
+    /** Path to .kspec/ worktree directory */
+    worktreeDir: string;
+    /** Shadow branch name (default: kspec-meta) */
+    branchName: string;
+    /** Project root (where .kspec/ lives) */
+    projectRoot: string;
+}
+/**
+ * Shadow branch status
+ */
+export interface ShadowStatus {
+    exists: boolean;
+    healthy: boolean;
+    branchExists: boolean;
+    worktreeExists: boolean;
+    worktreeLinked: boolean;
+    error?: string;
+}
+/**
+ * Error types for shadow branch issues
+ */
+export declare class ShadowError extends Error {
+    code: 'NOT_INITIALIZED' | 'WORKTREE_DISCONNECTED' | 'DIRECTORY_MISSING' | 'GIT_ERROR' | 'RUNNING_FROM_SHADOW';
+    suggestion: string;
+    constructor(message: string, code: 'NOT_INITIALIZED' | 'WORKTREE_DISCONNECTED' | 'DIRECTORY_MISSING' | 'GIT_ERROR' | 'RUNNING_FROM_SHADOW', suggestion: string);
+}
+/**
+ * Default shadow branch name
+ */
+export declare const SHADOW_BRANCH_NAME = "kspec-meta";
+/**
+ * Default shadow worktree directory
+ */
+export declare const SHADOW_WORKTREE_DIR = ".kspec";
+/**
+ * Check if debug mode is enabled.
+ * Debug mode can be enabled via:
+ * - KSPEC_DEBUG=1 environment variable
+ * - Verbose flag (passed from CLI --debug-shadow option)
+ *
+ * When enabled, shadow branch operations output detailed information.
+ */
+export declare function isDebugMode(verboseFlag?: boolean): boolean;
+/**
+ * Check if we're in a git repository
+ */
+export declare function isGitRepo(dir: string): Promise<boolean>;
+/**
+ * Get the git root directory
+ */
+export declare function getGitRoot(dir: string): string | null;
+/**
+ * Check if a branch exists
+ */
+export declare function branchExists(dir: string, branchName: string): Promise<boolean>;
+/**
+ * Check if a directory is a valid git worktree
+ */
+export declare function isValidWorktree(worktreeDir: string): Promise<boolean>;
+/**
+ * Detect if running from inside the shadow worktree directory.
+ * Returns the main project root if detected, null otherwise.
+ *
+ * Detection logic:
+ * 1. Check if .git is a file (worktrees have .git files, not directories)
+ * 2. Read the gitdir reference from the .git file
+ * 3. Check if it points to a worktree for .kspec (pattern: <project>/.git/worktrees/-kspec)
+ */
+export declare function detectRunningFromShadowWorktree(cwd: string): Promise<string | null>;
+/**
+ * Detect shadow branch configuration from a directory.
+ * Returns shadow config if .kspec/ exists and is valid.
+ */
+export declare function detectShadow(startDir: string): Promise<ShadowConfig | null>;
+/**
+ * Get detailed shadow branch status
+ */
+export declare function getShadowStatus(projectRoot: string): Promise<ShadowStatus>;
+/**
+ * Create an appropriate ShadowError based on status
+ */
+export declare function createShadowError(status: ShadowStatus): ShadowError;
+/**
+ * Auto-commit changes to shadow branch.
+ * Called after write operations when shadow is enabled.
+ *
+ * @param worktreeDir Path to .kspec/ directory
+ * @param message Commit message
+ * @param verbose Enable debug output (defaults to KSPEC_DEBUG env var)
+ * @returns true if commit succeeded, false if nothing to commit
+ */
+export declare function shadowAutoCommit(worktreeDir: string, message: string, verbose?: boolean): Promise<boolean>;
+/**
+ * Generate commit message for a kspec operation.
+ */
+export declare function generateCommitMessage(operation: string, ref?: string, detail?: string): string;
+/**
+ * Resolve a path relative to shadow worktree if enabled.
+ * Falls back to original path if shadow is not enabled.
+ */
+export declare function resolveShadowPath(originalPath: string, shadowConfig: ShadowConfig | null, projectRoot: string): string;
+/**
+ * Commit changes to shadow branch if enabled.
+ * This is the primary interface for CLI commands to trigger auto-commit.
+ *
+ * @param shadowConfig Shadow configuration (from KspecContext.shadow)
+ * @param operation Operation type (e.g., 'task-start', 'task-complete')
+ * @param ref Reference slug or ULID (optional)
+ * @param detail Additional detail for commit message (optional)
+ * @param verbose Enable debug output (defaults to KSPEC_DEBUG env var)
+ * @returns true if committed, false if shadow not enabled or nothing to commit
+ */
+export declare function commitIfShadow(shadowConfig: ShadowConfig | null, operation: string, ref?: string, detail?: string, verbose?: boolean): Promise<boolean>;
+/**
+ * Check if shadow is required but not available, and throw appropriate error.
+ * Use this at the start of commands that require shadow mode.
+ *
+ * @param shadowConfig Shadow configuration from context
+ * @param projectRoot Project root for status check
+ * @throws ShadowError if shadow is not properly configured
+ */
+export declare function requireShadow(shadowConfig: ShadowConfig | null, projectRoot: string): Promise<void>;
+/**
+ * Format a ShadowError for display in CLI.
+ * Returns a user-friendly message with suggestion.
+ */
+export declare function formatShadowError(error: ShadowError): string;
+/**
+ * Result from shadow initialization
+ */
+export interface ShadowInitResult {
+    success: boolean;
+    branchCreated: boolean;
+    worktreeCreated: boolean;
+    gitignoreUpdated: boolean;
+    initialCommit: boolean;
+    alreadyExists: boolean;
+    /** Whether shadow was created from existing remote branch */
+    createdFromRemote: boolean;
+    /** Whether new branch was pushed to remote to establish tracking */
+    pushedToRemote: boolean;
+    error?: string;
+}
+/**
+ * Options for shadow initialization
+ */
+export interface ShadowInitOptions {
+    /** Project name for manifest */
+    projectName?: string;
+    /** Force reinitialize even if exists */
+    force?: boolean;
+}
+/**
+ * Check if a remote exists (default: origin)
+ */
+export declare function hasRemote(projectRoot: string, remoteName?: string): Promise<boolean>;
+/**
+ * Check if a branch exists on a remote
+ */
+export declare function remoteBranchExists(projectRoot: string, branchName: string, remoteName?: string): Promise<boolean>;
+/**
+ * Fetch from remote to ensure refs are up to date.
+ * Returns true if fetch succeeded, false otherwise.
+ */
+export declare function fetchRemote(projectRoot: string, remoteName?: string): Promise<boolean>;
+/**
+ * Push shadow branch to remote with tracking.
+ * Returns true if push succeeded, false otherwise.
+ */
+export declare function pushShadowBranch(worktreeDir: string, remoteName?: string): Promise<boolean>;
+/**
+ * Check if shadow branch has remote tracking configured.
+ * AC-4: Used to determine whether sync should be attempted.
+ */
+export declare function hasRemoteTracking(worktreeDir: string): Promise<boolean>;
+/**
+ * Ensure shadow branch has remote tracking configured.
+ * AC-8: If shadow has no tracking but main branch has origin remote,
+ * automatically configure tracking to origin/kspec-meta.
+ *
+ * @param worktreeDir Path to .kspec/ worktree
+ * @param projectRoot Git repository root
+ * @returns true if tracking is now configured (was already or just set up)
+ */
+export declare function ensureRemoteTracking(worktreeDir: string, projectRoot: string): Promise<boolean>;
+/**
+ * Result from a sync operation
+ */
+export interface ShadowSyncResult {
+    success: boolean;
+    pulled: boolean;
+    pushed: boolean;
+    hadConflict: boolean;
+    error?: string;
+}
+/**
+ * Fire-and-forget push to remote.
+ * AC-1: Called after each auto-commit when tracking is configured.
+ * AC-8: Automatically sets up tracking if main branch has remote.
+ * Silently ignores errors - the local commit succeeded regardless.
+ *
+ * @param worktreeDir Path to .kspec/ worktree
+ * @param verbose Enable debug output
+ */
+export declare function shadowPushAsync(worktreeDir: string, verbose?: boolean): Promise<void>;
+/**
+ * Pull remote changes to shadow branch.
+ * AC-2: Called at session start to sync before operations.
+ * AC-6: Uses --ff-only first, falls back to --rebase.
+ * AC-3: On conflict, returns failure with suggestion.
+ * AC-8: Automatically sets up tracking if main branch has remote.
+ */
+export declare function shadowPull(worktreeDir: string): Promise<ShadowSyncResult>;
+/**
+ * Full sync operation: pull then push.
+ * Used by session start and explicit sync commands.
+ */
+export declare function shadowSync(worktreeDir: string): Promise<ShadowSyncResult>;
+/**
+ * Initialize shadow branch and worktree.
+ * Creates orphan branch, worktree, updates gitignore, and creates initial structure.
+ *
+ * @param projectRoot Git repository root
+ * @param options Initialization options
+ * @returns Result indicating what was created
+ */
+export declare function initializeShadow(projectRoot: string, options?: ShadowInitOptions): Promise<ShadowInitResult>;
+/**
+ * Repair a broken shadow branch setup.
+ * Handles cases where worktree is disconnected or directory is missing.
+ *
+ * @param projectRoot Git repository root
+ * @returns Result indicating what was repaired
+ */
+export declare function repairShadow(projectRoot: string): Promise<ShadowInitResult>;
+//# sourceMappingURL=shadow.d.ts.map

package/dist/parser/shadow.d.ts.map

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