@codeyam/codeyam-cli 0.1.0-staging.d0ad4ae → 0.1.0-staging.d4f25c3

package/codeyam-cli/src/utils/rules/rulePlacement.js

@@ -0,0 +1,65 @@
+/**
+ * Compute the correct .claude/rules/ subdirectory for a rule based on its frontmatter paths.
+ *
+ * Algorithm:
+ * 1. For each path, extract the directory portion (strip filenames and glob segments)
+ * 2. Find the longest common directory prefix across all paths
+ * 3. Return that prefix (to be used as .claude/rules/<prefix>/)
+ *
+ * @param paths - Array of path patterns from rule frontmatter
+ * @returns The deepest common directory (e.g., "packages/ai/src/lib"), or "" for root
+ * @throws If paths array is empty
+ */
+export function computeRulePlacement(paths) {
+    if (paths.length === 0) {
+        throw new Error('paths array must not be empty');
+    }
+    const directories = paths.map(extractDirectory);
+    // Find the longest common prefix of directory segments
+    const segmentArrays = directories.map((d) => (d === '' ? [] : d.split('/')));
+    const commonSegments = segmentArrays.reduce((common, segments) => {
+        const result = [];
+        for (let i = 0; i < Math.min(common.length, segments.length); i++) {
+            if (common[i] === segments[i]) {
+                result.push(common[i]);
+            }
+            else {
+                break;
+            }
+        }
+        return result;
+    });
+    return commonSegments.join('/');
+}
+/**
+ * Extract the directory portion from a path pattern, stripping:
+ * - Filenames (anything with an extension after the last /)
+ * - Glob segments (**, *, *.ext)
+ * - Trailing slashes
+ */
+function extractDirectory(pathPattern) {
+    // Remove trailing slashes
+    const p = pathPattern.replace(/\/+$/, '');
+    const segments = p.split('/');
+    // Walk backwards, dropping segments that are globs or filenames
+    while (segments.length > 0) {
+        const last = segments[segments.length - 1];
+        if (isGlobOrFile(last)) {
+            segments.pop();
+        }
+        else {
+            break;
+        }
+    }
+    return segments.join('/');
+}
+function isGlobOrFile(segment) {
+    // Glob patterns: **, *, *.ext, **/*.ext
+    if (segment.includes('*'))
+        return true;
+    // Files: have an extension like .ts, .tsx, .js, etc.
+    if (/\.\w+$/.test(segment))
+        return true;
+    return false;
+}
+//# sourceMappingURL=rulePlacement.js.map

package/codeyam-cli/src/utils/rules/rulePlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulePlacement.js","sourceRoot":"","sources":["../../../../../src/utils/rules/rulePlacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAe;IAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAEhD,uDAAuD;IACvD,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QAC/D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAClE,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,0BAA0B;IAC1B,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE1C,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE9B,gEAAgE;IAChE,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3C,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,GAAG,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACnC,wCAAwC;IACxC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,qDAAqD;IACrD,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/codeyam-cli/src/utils/rules/ruleState.js

@@ -0,0 +1,150 @@
+// Consolidated rule metadata management
+// Single source of truth for lastAuditedAt, content hashes, and review status
+import path from 'path';
+import fs from 'fs/promises';
+import crypto from 'crypto';
+const RULE_STATE_FILE = 'codeyam-rule-state.json';
+const CURRENT_VERSION = 1;
+/**
+ * Hash the meaningful content of a rule, excluding metadata that doesn't
+ * affect the rule's substance (category field).
+ */
+export function hashRuleContent(content) {
+    const normalized = content.replace(/^category:\s*.+$\n?/m, '');
+    return crypto.createHash('sha256').update(normalized).digest('hex');
+}
+/**
+ * Get the path to .claude/codeyam-rule-state.json
+ */
+function getRuleStatePath(projectRoot) {
+    return path.join(projectRoot, '.claude', RULE_STATE_FILE);
+}
+/**
+ * Load rule state from .claude/codeyam-rule-state.json
+ * Returns empty state if the file doesn't exist.
+ */
+export async function loadRuleState(projectRoot) {
+    const filePath = getRuleStatePath(projectRoot);
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const data = JSON.parse(content);
+        if (data.version !== CURRENT_VERSION) {
+            console.warn(`[ruleState] Unknown version ${data.version}, using empty state`);
+            return { version: CURRENT_VERSION, rules: {} };
+        }
+        return data;
+    }
+    catch {
+        return { version: CURRENT_VERSION, rules: {} };
+    }
+}
+/**
+ * Save rule state to .claude/codeyam-rule-state.json
+ */
+export async function saveRuleState(projectRoot, data) {
+    const filePath = getRuleStatePath(projectRoot);
+    // Ensure .claude directory exists
+    const claudeDir = path.dirname(filePath);
+    await fs.mkdir(claudeDir, { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Sync rule state with current rules on disk.
+ * - Recomputes content hashes for all current rules
+ * - Marks `reviewed: false` for rules whose hash changed
+ * - Removes entries for deleted rules
+ * - Preserves lastAuditedAt and reviewed status for unchanged rules
+ */
+export async function syncRuleState(projectRoot, rules) {
+    const state = await loadRuleState(projectRoot);
+    const currentRulePaths = new Set(rules.map((r) => r.filePath));
+    // Remove entries for deleted rules
+    for (const key of Object.keys(state.rules)) {
+        if (!currentRulePaths.has(key)) {
+            delete state.rules[key];
+        }
+    }
+    // Update entries for current rules
+    for (const rule of rules) {
+        const fullContent = await fs.readFile(rule.absolutePath, 'utf-8');
+        const newHash = hashRuleContent(fullContent);
+        const existing = state.rules[rule.filePath];
+        if (existing) {
+            if (existing.contentHash !== newHash) {
+                // Content changed — reset reviewed status, keep lastAuditedAt
+                state.rules[rule.filePath] = {
+                    ...existing,
+                    contentHash: newHash,
+                    reviewed: false,
+                };
+            }
+            // If hash matches, keep everything as-is
+        }
+        else {
+            // New rule — not yet reviewed, no lastAuditedAt
+            state.rules[rule.filePath] = {
+                contentHash: newHash,
+                reviewed: false,
+            };
+        }
+    }
+    await saveRuleState(projectRoot, state);
+    return state;
+}
+/**
+ * Set lastAuditedAt to now for the listed rule file paths.
+ * Only modifies .claude/codeyam-rule-state.json.
+ */
+export async function touchLastAuditedAt(projectRoot, ruleFilePaths) {
+    const state = await loadRuleState(projectRoot);
+    const now = new Date().toISOString();
+    for (const filePath of ruleFilePaths) {
+        if (state.rules[filePath]) {
+            state.rules[filePath].lastAuditedAt = now;
+        }
+    }
+    await saveRuleState(projectRoot, state);
+}
+/**
+ * Mark a rule as reviewed or unreviewed.
+ * When marking as reviewed, also recomputes the content hash.
+ */
+export async function setReviewed(projectRoot, filePath, reviewed, rulesDir) {
+    const state = await loadRuleState(projectRoot);
+    if (reviewed) {
+        // Recompute hash to ensure it's current
+        const effectiveRulesDir = rulesDir || path.join(projectRoot, '.claude', 'rules');
+        const fullPath = path.join(effectiveRulesDir, filePath);
+        const content = await fs.readFile(fullPath, 'utf-8');
+        const contentHash = hashRuleContent(content);
+        if (state.rules[filePath]) {
+            state.rules[filePath].reviewed = true;
+            state.rules[filePath].contentHash = contentHash;
+        }
+        else {
+            state.rules[filePath] = {
+                contentHash,
+                reviewed: true,
+            };
+        }
+    }
+    else {
+        if (state.rules[filePath]) {
+            state.rules[filePath].reviewed = false;
+        }
+    }
+    await saveRuleState(projectRoot, state);
+}
+/**
+ * Get the lastAuditedAt value for a rule from loaded state.
+ */
+export function getRuleLastAuditedAt(state, filePath) {
+    return state.rules[filePath]?.lastAuditedAt ?? null;
+}
+/**
+ * Check if a rule is reviewed from loaded state.
+ */
+export function isRuleReviewed(state, filePath) {
+    return state.rules[filePath]?.reviewed ?? false;
+}
+//# sourceMappingURL=ruleState.js.map

package/codeyam-cli/src/utils/rules/ruleState.js.map

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

package/codeyam-cli/src/utils/rules/sourceFiles.js

@@ -0,0 +1,43 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+const EXCLUDED_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    '.codeyam',
+    '.claude',
+    'build',
+    'coverage',
+]);
+/**
+ * Find all files in a project, returning paths relative to projectRoot.
+ */
+export async function findSourceFilesInProject(projectRoot) {
+    const sourceFiles = [];
+    async function walkDir(dir, relativePath) {
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relPath = relativePath
+                    ? `${relativePath}/${entry.name}`
+                    : entry.name;
+                if (entry.isDirectory() && EXCLUDED_DIRS.has(entry.name)) {
+                    continue;
+                }
+                if (entry.isDirectory()) {
+                    await walkDir(fullPath, relPath);
+                }
+                else if (entry.isFile()) {
+                    sourceFiles.push(relPath);
+                }
+            }
+        }
+        catch {
+            // Directory not readable, skip
+        }
+    }
+    await walkDir(projectRoot, '');
+    return sourceFiles;
+}
+//# sourceMappingURL=sourceFiles.js.map

package/codeyam-cli/src/utils/rules/sourceFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceFiles.js","sourceRoot":"","sources":["../../../../../src/utils/rules/sourceFiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,cAAc;IACd,MAAM;IACN,MAAM;IACN,UAAU;IACV,SAAS;IACT,OAAO;IACP,UAAU;CACX,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,WAAmB;IAEnB,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,YAAoB;QACtD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,OAAO,GAAG,YAAY;oBAC1B,CAAC,CAAC,GAAG,YAAY,IAAI,KAAK,CAAC,IAAI,EAAE;oBACjC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBAEf,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzD,SAAS;gBACX,CAAC;gBAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,MAAM,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnC,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC1B,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/B,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/codeyam-cli/src/utils/rules/staleness.js

@@ -0,0 +1,137 @@
+// Staleness detection for Claude Rules
+import fs from 'fs/promises';
+import path from 'path';
+import { minimatch } from 'minimatch';
+import { getRuleLastAuditedAt } from "./ruleState.js";
+/**
+ * Find all files matching glob patterns under a directory
+ */
+async function findMatchingFiles(patterns, projectRoot) {
+    const matches = [];
+    async function walkDir(dir, relativePath) {
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relPath = relativePath
+                    ? `${relativePath}/${entry.name}`
+                    : entry.name;
+                // Skip common non-source directories
+                if (entry.isDirectory() &&
+                    (entry.name === 'node_modules' ||
+                        entry.name === '.git' ||
+                        entry.name === 'dist' ||
+                        entry.name === '.codeyam' ||
+                        entry.name === '.claude')) {
+                    continue;
+                }
+                if (entry.isDirectory()) {
+                    await walkDir(fullPath, relPath);
+                }
+                else if (entry.isFile()) {
+                    // Check if file matches any pattern
+                    for (const pattern of patterns) {
+                        if (minimatch(relPath, pattern, { matchBase: true })) {
+                            matches.push(relPath);
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory not readable, skip
+        }
+    }
+    await walkDir(projectRoot, '');
+    return matches;
+}
+/**
+ * Get the most recent modification time from a list of files
+ */
+async function getNewestFileTime(files, projectRoot) {
+    let newestTime = null;
+    let newestPath = null;
+    for (const file of files) {
+        try {
+            const stat = await fs.stat(path.join(projectRoot, file));
+            if (!newestTime || stat.mtime > newestTime) {
+                newestTime = stat.mtime;
+                newestPath = file;
+            }
+        }
+        catch {
+            // File not accessible, skip
+        }
+    }
+    return { newestPath, newestTime };
+}
+/**
+ * Check if a single rule is stale.
+ * Reads lastAuditedAt from ruleState instead of frontmatter.
+ */
+export async function checkRuleStaleness(rule, projectRoot, ruleState) {
+    // Get rule lastAuditedAt from state (or null if not provided / not found)
+    let ruleTimestamp = null;
+    if (ruleState) {
+        const ts = getRuleLastAuditedAt(ruleState, rule.filePath);
+        if (ts) {
+            const parsed = new Date(ts);
+            if (!isNaN(parsed.getTime())) {
+                ruleTimestamp = parsed;
+            }
+        }
+    }
+    // If no paths defined, rule is not stale (nothing to compare against)
+    if (!rule.frontmatter.paths || rule.frontmatter.paths.length === 0) {
+        return {
+            rule,
+            isStale: false,
+            ruleTimestamp,
+            newestFileModified: null,
+            newestFilePath: null,
+        };
+    }
+    // Find all files matching the rule's patterns
+    const matchingFiles = await findMatchingFiles(rule.frontmatter.paths, projectRoot);
+    // If no files match, rule is not stale
+    if (matchingFiles.length === 0) {
+        return {
+            rule,
+            isStale: false,
+            ruleTimestamp,
+            newestFileModified: null,
+            newestFilePath: null,
+        };
+    }
+    // Get the newest file modification time
+    const { newestPath, newestTime } = await getNewestFileTime(matchingFiles, projectRoot);
+    // Determine if stale: rule is stale if newest file is newer than lastAuditedAt
+    // If rule has no lastAuditedAt, it's considered stale
+    let isStale = false;
+    if (!ruleTimestamp) {
+        isStale = true;
+    }
+    else if (newestTime && newestTime > ruleTimestamp) {
+        isStale = true;
+    }
+    return {
+        rule,
+        isStale,
+        ruleTimestamp,
+        newestFileModified: newestTime,
+        newestFilePath: newestPath,
+    };
+}
+/**
+ * Check all rules for staleness
+ */
+export async function getAllStaleRules(rules, projectRoot, ruleState) {
+    const results = [];
+    for (const rule of rules) {
+        const result = await checkRuleStaleness(rule, projectRoot, ruleState);
+        results.push(result);
+    }
+    return results;
+}
+//# sourceMappingURL=staleness.js.map

package/codeyam-cli/src/utils/rules/staleness.js.map

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

package/codeyam-cli/src/utils/scenarioCoverage.js

@@ -0,0 +1,77 @@
+import { scenarioEntityName } from "./entityChangeStatus.js";
+/**
+ * Classify scenarios as stale or fresh based on when they were captured
+ * relative to when the current feature started.
+ *
+ * A scenario is "stale" if:
+ * - It belongs to a page entity that is new/edited/impacted
+ * - It was captured BEFORE the current feature started
+ *
+ * A page is "uncovered" if:
+ * - It has a new/edited/impacted entity
+ * - It has NO scenarios at all (not even stale ones)
+ */
+export function classifyScenarioCoverage(scenarios, entityChangeStatus, pageEntityNames, featureStartedAt) {
+    // Convert ISO timestamp to SQLite format for comparison
+    const featureTs = featureStartedAt
+        ? featureStartedAt.replace('T', ' ').replace(/\.\d{3}Z$/, '')
+        : null;
+    const staleScenarios = [];
+    const freshScenarios = [];
+    const coveredPageEntities = new Set();
+    for (const row of scenarios) {
+        // Determine entity name for this scenario, preferring pageFilePath
+        // for precise route-based identity over lossy URL-derived names.
+        const entityName = scenarioEntityName({
+            componentName: row.component_name,
+            pageFilePath: row.page_file_path,
+            url: row.url,
+        });
+        if (!entityName)
+            continue;
+        const status = entityChangeStatus[entityName];
+        if (!status)
+            continue; // Entity not changed — not relevant
+        // Only audit page/app scenarios, not component isolation scenarios
+        if (row.component_name)
+            continue;
+        const createdAt = row.created_at || '';
+        const updatedAt = row.updated_at || '';
+        const isFresh = featureTs
+            ? createdAt >= featureTs || updatedAt >= featureTs
+            : true;
+        if (isFresh) {
+            freshScenarios.push({
+                name: row.name,
+                url: row.url,
+                entityName,
+            });
+            coveredPageEntities.add(entityName);
+        }
+        else {
+            staleScenarios.push({
+                name: row.name,
+                url: row.url,
+                entityName,
+                changeStatus: status.status,
+                lastCaptured: createdAt,
+            });
+        }
+    }
+    // Find pages with changes but zero scenarios
+    const uncoveredPages = [];
+    for (const [entityName, status] of Object.entries(entityChangeStatus)) {
+        if (!pageEntityNames.has(entityName))
+            continue; // Only pages
+        if (coveredPageEntities.has(entityName))
+            continue; // Has fresh scenarios
+        // Check if it has ANY scenario (even stale)
+        const hasStale = staleScenarios.some((s) => s.entityName === entityName);
+        if (!hasStale) {
+            uncoveredPages.push({ entityName, changeStatus: status.status });
+        }
+    }
+    const pass = staleScenarios.length === 0 && uncoveredPages.length === 0;
+    return { staleScenarios, freshScenarios, uncoveredPages, pass };
+}
+//# sourceMappingURL=scenarioCoverage.js.map

package/codeyam-cli/src/utils/scenarioCoverage.js.map

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

package/codeyam-cli/src/utils/scenarioMarkers.js

@@ -0,0 +1,134 @@
+/**
+ * Pure logic for transforming {{scenario:Name:ID}} markers into OSC 8
+ * clickable hyperlinks in terminal output.
+ *
+ * Extracted from terminalServer.ts for testability. Zero side-effects.
+ *
+ * Claude Code's renderer inserts ANSI escape codes (colors/styles) within the
+ * marker text, so we can't regex-match on raw PTY data directly. Instead,
+ * strip ANSI codes to find markers, then map positions back to the original
+ * string for replacement.
+ */
+// Matches CSI sequences: \x1b[ followed by params and a letter.
+// Also handles private-mode params (?) and colon-delimited SGR (e.g., 38:2:R:G:B).
+const ANSI_ESCAPE_RE = /\x1b\[[?]?[0-9;:]*[a-zA-Z]/g;
+// Additional non-CSI escapes: charset selection (\x1b(B), save/restore cursor, etc.
+const OTHER_ESCAPE_RE = /\x1b[()][A-Z0-9]/g;
+/**
+ * Strip all ANSI escape sequences from a string.
+ */
+function stripAnsi(data) {
+    return data.replace(ANSI_ESCAPE_RE, '').replace(OTHER_ESCAPE_RE, '');
+}
+/**
+ * Build a position map from ANSI-stripped indices to original indices.
+ * posMap[strippedIndex] = originalIndex, skipping over ANSI sequences.
+ */
+function buildAnsiPositionMap(data, stripped) {
+    const posMap = [];
+    for (let di = 0, si = 0; di < data.length; di++) {
+        if (data[di] === '\x1b') {
+            // Try CSI sequence (with optional ? for private mode, : for colon-delimited SGR)
+            const seqMatch = data.slice(di).match(/^\x1b\[?\??[0-9;:]*[a-zA-Z]/);
+            if (seqMatch) {
+                di += seqMatch[0].length - 1;
+                continue;
+            }
+            // Try charset selection: \x1b(B, \x1b)0, etc.
+            const charsetMatch = data.slice(di).match(/^\x1b[()][A-Z0-9]/);
+            if (charsetMatch) {
+                di += charsetMatch[0].length - 1;
+                continue;
+            }
+        }
+        posMap[si] = di;
+        si++;
+    }
+    posMap[stripped.length] = data.length; // sentinel for end-of-string markers
+    return posMap;
+}
+const MARKER_RE = /\{\{scenario:([^:}]+):([^}]+)\}\}/g;
+/**
+ * Transform {{scenario:Name:ID}} markers into OSC 8 hyperlinks.
+ * OSC 8 format: \x1b]8;;URL\x07VISIBLE_TEXT\x1b]8;;\x07
+ *
+ * Stateless — operates on a single string. For streaming PTY data,
+ * use createMarkerTransformer() which buffers partial markers.
+ */
+export function transformScenarioMarkers(data, port) {
+    const stripped = stripAnsi(data);
+    if (!stripped.includes('{{scenario:'))
+        return data;
+    const posMap = buildAnsiPositionMap(data, stripped);
+    const replacements = [];
+    let m;
+    while ((m = MARKER_RE.exec(stripped)) !== null) {
+        const url = `http://localhost:${port}/editor?scenario=${m[2]}&ref=link`;
+        const visibleName = m[1];
+        // Pad replacement to match the original marker's visible width so table
+        // columns stay aligned after the shorter hyperlink text replaces the marker.
+        const pad = ' '.repeat(Math.max(0, m[0].length - visibleName.length));
+        replacements.push({
+            origStart: posMap[m.index],
+            origEnd: posMap[m.index + m[0].length],
+            replacement: `\x1b]8;;${url}\x07${visibleName}\x1b]8;;\x07${pad}`,
+        });
+    }
+    if (replacements.length === 0)
+        return data;
+    // Replace from end to start so earlier positions stay valid
+    let result = data;
+    for (let i = replacements.length - 1; i >= 0; i--) {
+        const r = replacements[i];
+        result =
+            result.slice(0, r.origStart) + r.replacement + result.slice(r.origEnd);
+    }
+    return result;
+}
+/**
+ * Create a stateful scenario marker transformer that buffers partial markers
+ * across PTY chunks. Claude Code streams output token by token, so the PTY
+ * can split a {{scenario:Name:ID}} marker across two (or more) data events.
+ *
+ * Also handles Ink-style line rewrites where \r (carriage return) invalidates
+ * buffered content from the same line.
+ */
+export function createMarkerTransformer(port) {
+    let buffer = '';
+    return function transform(data) {
+        // If the incoming data contains \r (carriage return), Ink is rewriting
+        // the current line. Any buffered partial marker from that line is stale —
+        // discard it so the new content isn't confused with old fragments.
+        // The buffer only ever holds content after an unclosed {{ (i.e., a partial
+        // marker on the current line), so discarding it is always safe when the
+        // line is being rewritten.
+        if (buffer && data.includes('\r')) {
+            buffer = '';
+            return transform(data);
+        }
+        // Prepend any buffered partial-marker text from the previous chunk
+        const combined = buffer + data;
+        buffer = '';
+        // Strip ANSI to detect partial markers at the end
+        const stripped = stripAnsi(combined);
+        // Check for an unclosed {{ at the end — potential partial marker
+        const lastOpen = stripped.lastIndexOf('{{');
+        if (lastOpen !== -1 && !stripped.slice(lastOpen).includes('}}')) {
+            // Map the stripped position back to the original string
+            const posMap = buildAnsiPositionMap(combined, stripped);
+            const splitPos = posMap[lastOpen];
+            // Safety: if partial marker exceeds 500 chars, it's not a real marker — flush it
+            if (combined.length - splitPos > 500) {
+                return transformScenarioMarkers(combined, port);
+            }
+            buffer = combined.slice(splitPos);
+            const toSend = combined.slice(0, splitPos);
+            // If nothing to send yet (entire chunk is a partial marker), return empty
+            if (toSend.length === 0)
+                return '';
+            return transformScenarioMarkers(toSend, port);
+        }
+        return transformScenarioMarkers(combined, port);
+    };
+}
+//# sourceMappingURL=scenarioMarkers.js.map

package/codeyam-cli/src/utils/scenarioMarkers.js.map

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