@codewalla_india/openspec 1.3.1 → 1.3.2

package/dist/core/migration.js

@@ -4,26 +4,359 @@
  * One-time migration logic for existing projects when profile system is introduced.
  * Called by both init and update commands before profile resolution.
  */
+import { AI_TOOLS } from './config.js';
 import { getGlobalConfig, getGlobalConfigPath, saveGlobalConfig } from './global-config.js';
 import { CommandAdapterRegistry } from './command-generation/index.js';
+import { resolveCommandInvocation, resolveCommandSurfaceCapability, shouldGenerateCommandsForTool, } from './command-surface.js';
 import { WORKFLOW_TO_SKILL_DIR } from './profile-sync-drift.js';
+import { COMMAND_IDS } from './shared/tool-detection.js';
 import { ALL_WORKFLOWS } from './profiles.js';
+import { getSkillReferenceTransformer, getTransformerForTool } from '../utils/command-references.js';
+import { FileSystemUtils } from '../utils/file-system.js';
+import { isSharedSkillTargetActive } from './shared-skill-target.js';
+import { isLegacyCodexSkillEquivalentToCurrent } from './shared/skill-content-equivalence.js';
 import path from 'path';
 import * as fs from 'fs';
-function scanInstalledWorkflowArtifacts(projectPath, tools) {
+import { resolveToolSkillsDir, toolSupportsSkills } from './shared/skill-paths.js';
+/**
+ * Former tool roots whose OpenSpec-managed content belongs under the tool's
+ * current skillsDir. User files are never touched.
+ */
+export const LEGACY_TOOL_ROOTS = {
+    // Kimi CLI became Kimi Code and moved from .kimi to .kimi-code.
+    kimi: [{ root: '.kimi', needsConsent: false }],
+    // Windsurf was rebranded to Devin Desktop on 2026-06-02 and its config
+    // directory moved to .devin/. Devin Desktop reads .windsurf/ only as a
+    // fallback and Devin Local does not read it at all, so moving is the right
+    // default — but a pre-rebrand Windsurf build reads ONLY .windsurf/, and
+    // nothing on disk tells that user apart, so the move is offered, not taken.
+    devin: [{ root: '.windsurf', needsConsent: true }],
+    // Codex now reads the canonical shared .agents root. Generate the current
+    // replacement first so a divergent legacy file is preserved, not overwritten.
+    codex: [{ root: '.codex', needsConsent: false, timing: 'after-generation' }],
+};
+function classifyManagedFile(source, destination) {
+    if (isSamePath(source, destination))
+        return 'skip';
+    if (!fs.existsSync(destination))
+        return 'move';
+    try {
+        const sourceContent = fs.readFileSync(source, 'utf-8');
+        const destinationContent = fs.readFileSync(destination, 'utf-8');
+        const equivalentGeneratedSkills = path.basename(source) === 'SKILL.md' &&
+            path.basename(destination) === 'SKILL.md' &&
+            isLegacyCodexSkillEquivalentToCurrent(sourceContent, destinationContent);
+        return sourceContent === destinationContent || equivalentGeneratedSkills
+            ? 'drop'
+            : 'keep';
+    }
+    catch {
+        return 'keep';
+    }
+}
+/**
+ * Rewrites a generated command path from the tool's current root to a legacy
+ * one, so `.devin/workflows/opsx-apply.md` locates its `.windsurf/` twin
+ * without the migration hard-coding either layout.
+ *
+ * Returns undefined for adapters whose paths are absolute (global-scoped
+ * command files) or do not start at the tool root — neither can be relocated
+ * by swapping a leading segment.
+ */
+function legacyCommandPath(commandPath, currentRoot, legacyRoot) {
+    if (path.isAbsolute(commandPath))
+        return undefined;
+    const segments = commandPath.split(/[\\/]/);
+    if (segments[0] !== currentRoot)
+        return undefined;
+    segments[0] = legacyRoot;
+    return path.join(...segments);
+}
+/**
+ * Reports the OpenSpec content sitting under each tool's legacy root, without
+ * moving anything. Callers use this to ask before a move that needs consent.
+ */
+export function findLegacyToolMigrations(projectPath, timing = 'before-generation') {
+    return collectLegacyToolMigrations(projectPath, false, undefined, timing);
+}
+/**
+ * Moves OpenSpec-managed skill directories (openspec-*) and command files
+ * (opsx-*) from a tool's legacy root to its current one. When the destination
+ * already exists the legacy copy is removed instead. Legacy directories are
+ * deleted only when left empty, so user files under the old location — a
+ * hand-written Cascade workflow next to the generated ones — are preserved.
+ *
+ * @param projectPath - Project root
+ * @param toolIds - Restrict the move to these tools; omit to move every tool
+ *        whose legacy root needs no consent
+ */
+export function migrateLegacyToolDirs(projectPath, toolIds, timing = 'before-generation') {
+    return collectLegacyToolMigrations(projectPath, true, toolIds, timing);
+}
+function collectLegacyToolMigrations(projectPath, apply, toolIds, timing = 'before-generation') {
+    const migrations = [];
+    for (const tool of AI_TOOLS) {
+        if (!tool.skillsDir)
+            continue;
+        if (toolIds && !toolIds.includes(tool.value))
+            continue;
+        for (const legacy of LEGACY_TOOL_ROOTS[tool.value] ?? []) {
+            const legacyTiming = legacy.timing ?? 'before-generation';
+            if (legacyTiming !== timing)
+                continue;
+            if (legacy.root === tool.skillsDir)
+                continue;
+            // Without an explicit tool list, only moves that need no consent run.
+            if (apply && !toolIds && legacy.needsConsent)
+                continue;
+            const legacyRootPath = path.join(projectPath, legacy.root);
+            if (!fs.existsSync(legacyRootPath))
+                continue;
+            try {
+                FileSystemUtils.assertProjectArtifactPath(projectPath, legacyRootPath);
+                FileSystemUtils.assertProjectArtifactPath(projectPath, path.join(projectPath, tool.skillsDir));
+            }
+            catch {
+                console.warn(`Skipping legacy ${legacy.root}/ migration because the directory resolves outside this project.`);
+                continue;
+            }
+            const skills = migrateSkillDirs(projectPath, tool.skillsDir, legacy.root, apply, legacyTiming === 'after-generation');
+            const commands = migrateCommandFiles(projectPath, tool, legacy.root, apply);
+            if (apply) {
+                removeDirIfEmpty(path.join(legacyRootPath, 'skills'));
+                removeDirIfEmpty(path.join(legacyRootPath, 'workflows'));
+                removeDirIfEmpty(legacyRootPath);
+            }
+            // Kept-only results are retained deliberately. When every legacy file
+            // differs from its counterpart nothing is movable, and dropping the
+            // record here would leave the user with two divergent copies and no
+            // word of it.
+            if (skills.moved > 0 || commands.moved > 0 || skills.kept > 0 || commands.kept > 0) {
+                migrations.push({
+                    toolId: tool.value,
+                    from: legacy.root,
+                    to: tool.skillsDir,
+                    skillDirs: skills.moved,
+                    commandFiles: commands.moved,
+                    keptInPlace: skills.kept + commands.kept,
+                    needsConsent: legacy.needsConsent,
+                });
+            }
+        }
+    }
+    return migrations;
+}
+function migrateSkillDirs(projectPath, currentRoot, legacyRoot, apply, requireDestination = false) {
+    const legacySkillsDir = path.join(projectPath, legacyRoot, 'skills');
+    if (!fs.existsSync(legacySkillsDir))
+        return { moved: 0, kept: 0 };
+    const currentSkillsDir = path.join(projectPath, currentRoot, 'skills');
+    let moved = 0;
+    let kept = 0;
+    for (const workflowId of ALL_WORKFLOWS) {
+        const dirName = WORKFLOW_TO_SKILL_DIR[workflowId];
+        const source = path.join(legacySkillsDir, dirName);
+        const sourceSkill = path.join(source, 'SKILL.md');
+        if (!fs.existsSync(sourceSkill))
+            continue;
+        const destination = path.join(currentSkillsDir, dirName);
+        const destinationSkill = path.join(destination, 'SKILL.md');
+        if (requireDestination && !fs.existsSync(destinationSkill))
+            continue;
+        if (!areProjectArtifacts(projectPath, sourceSkill, destinationSkill)) {
+            console.warn(`Skipping legacy ${legacyRoot}/skills/${dirName} migration because it resolves outside this project.`);
+            continue;
+        }
+        const disposition = classifyManagedFile(sourceSkill, destinationSkill);
+        if (disposition === 'skip')
+            continue;
+        if (disposition === 'keep') {
+            kept++;
+            continue;
+        }
+        if (!apply) {
+            moved++;
+            continue;
+        }
+        try {
+            // Move the generated file, never the directory around it. A skill
+            // directory can also hold files the user wrote, and this destination is
+            // one OpenSpec deletes on its own — commands-only delivery and a
+            // deselected workflow both remove the whole skill directory. Carrying a
+            // user's file across would be handing it to that later removal.
+            if (disposition === 'drop') {
+                fs.rmSync(sourceSkill, { force: true });
+            }
+            else {
+                fs.mkdirSync(destination, { recursive: true });
+                fs.renameSync(sourceSkill, destinationSkill);
+            }
+            // Anything the user left beside it stays under the legacy root.
+            removeDirIfEmpty(source);
+            moved++;
+        }
+        catch {
+            // Leave the legacy directory in place if it cannot be moved
+        }
+    }
+    return { moved, kept };
+}
+function migrateCommandFiles(projectPath, tool, legacyRoot, apply) {
+    const adapter = CommandAdapterRegistry.get(tool.value);
+    if (!adapter || !tool.skillsDir)
+        return { moved: 0, kept: 0 };
+    let moved = 0;
+    let kept = 0;
+    for (const commandId of COMMAND_IDS) {
+        const currentPath = adapter.getFilePath(commandId);
+        const legacyPath = legacyCommandPath(currentPath, tool.skillsDir, legacyRoot);
+        if (!legacyPath)
+            continue;
+        const source = path.join(projectPath, legacyPath);
+        if (!fs.existsSync(source))
+            continue;
+        const destination = path.join(projectPath, currentPath);
+        if (!areProjectArtifacts(projectPath, source, destination)) {
+            console.warn(`Skipping legacy ${legacyPath} migration because it resolves outside this project.`);
+            continue;
+        }
+        const disposition = classifyManagedFile(source, destination);
+        if (disposition === 'skip')
+            continue;
+        if (disposition === 'keep') {
+            kept++;
+            continue;
+        }
+        if (!apply) {
+            moved++;
+            continue;
+        }
+        try {
+            if (disposition === 'drop') {
+                fs.rmSync(source, { force: true });
+            }
+            else {
+                fs.mkdirSync(path.dirname(destination), { recursive: true });
+                fs.renameSync(source, destination);
+            }
+            moved++;
+        }
+        catch {
+            // Leave the legacy file in place if it cannot be moved
+        }
+    }
+    return { moved, kept };
+}
+/**
+ * Summarizes what a migration moved, e.g. "6 skills and 6 commands".
+ */
+export function describeLegacyMigration(migration) {
+    const parts = [];
+    if (migration.skillDirs > 0) {
+        parts.push(`${migration.skillDirs} skill${migration.skillDirs === 1 ? '' : 's'}`);
+    }
+    if (migration.commandFiles > 0) {
+        parts.push(`${migration.commandFiles} command${migration.commandFiles === 1 ? '' : 's'}`);
+    }
+    return parts.join(' and ');
+}
+/**
+ * Names OpenSpec-managed files the move deliberately left behind, so a user
+ * who customized one knows there are now two copies to reconcile.
+ */
+export function keptInPlaceNotice(migration) {
+    if (migration.keptInPlace === 0)
+        return undefined;
+    const n = migration.keptInPlace;
+    // Deliberately does not claim the difference came from an edit: an older
+    // OpenSpec version's output differs too. Either way nothing was overwritten,
+    // and the user is the one who decides which copy to keep.
+    return (`Left ${n} file${n === 1 ? '' : 's'} in ${migration.from}/ that ` +
+        `differ${n === 1 ? 's' : ''} from the copy in ${migration.to}/. Nothing was ` +
+        `overwritten — compare the two and delete the ${migration.from}/ copy once ` +
+        `you have kept anything you customized.`);
+}
+/**
+ * Whether a migration has anything to move, as opposed to only files left in
+ * place. Callers use this to avoid offering a move of nothing.
+ */
+export function hasMovableContent(migration) {
+    return migration.skillDirs > 0 || migration.commandFiles > 0;
+}
+/**
+ * Explains why a consent-gated move is being offered, in the user's terms.
+ * Keyed by tool so the reason is specific rather than a generic "files moved".
+ */
+export function legacyMigrationNotice(migration) {
+    if (migration.toolId === 'devin') {
+        return (`Windsurf is now Devin Desktop, and its config directory moved from ` +
+            `${migration.from}/ to ${migration.to}/. Devin Desktop reads ${migration.from}/ ` +
+            `only as a fallback, and Devin Local does not read it at all.`);
+    }
+    return `${migration.from}/ is the former location for this tool; ${migration.to}/ is current.`;
+}
+/**
+ * Whether two paths are the same file on disk once symlinks are resolved.
+ *
+ * Symlinking one tool root at the other is a realistic way to straddle a
+ * rebrand (`ln -s .devin .windsurf` to keep an older build working). Without
+ * this check the "destination already exists, drop the legacy copy" branch
+ * deletes the destination itself, taking the only copy with it.
+ */
+function isSamePath(a, b) {
+    try {
+        return fs.realpathSync(a) === fs.realpathSync(b);
+    }
+    catch {
+        return false;
+    }
+}
+function areProjectArtifacts(projectPath, ...artifactPaths) {
+    try {
+        for (const artifactPath of artifactPaths) {
+            FileSystemUtils.assertProjectArtifactPath(projectPath, artifactPath);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function removeDirIfEmpty(dirPath) {
+    try {
+        if (fs.readdirSync(dirPath).length === 0) {
+            fs.rmdirSync(dirPath);
+        }
+    }
+    catch {
+        // Missing or non-empty directory — nothing to do
+    }
+}
+function scanInstalledWorkflowArtifacts(projectPath, tools, includeLegacySkills = false) {
     const installed = new Set();
     let hasSkills = false;
     let hasCommands = false;
     for (const tool of tools) {
-        if (!tool.skillsDir)
+        if (!toolSupportsSkills(tool))
             continue;
-        const skillsDir = path.join(projectPath, tool.skillsDir, 'skills');
-        for (const workflowId of ALL_WORKFLOWS) {
-            const skillDirName = WORKFLOW_TO_SKILL_DIR[workflowId];
-            const skillFile = path.join(skillsDir, skillDirName, 'SKILL.md');
-            if (fs.existsSync(skillFile)) {
-                installed.add(workflowId);
-                hasSkills = true;
+        const skillsDirs = [];
+        if (tool.globalSkillsDir) {
+            skillsDirs.push(resolveToolSkillsDir(projectPath, tool));
+        }
+        else if (isSharedSkillTargetActive(projectPath, tool.value)) {
+            skillsDirs.push(resolveToolSkillsDir(projectPath, tool));
+            if (includeLegacySkills) {
+                skillsDirs.push(...(tool.legacySkillsDirs ?? []).map((root) => path.join(projectPath, root, 'skills')));
+            }
+        }
+        for (const skillsDir of skillsDirs) {
+            for (const workflowId of ALL_WORKFLOWS) {
+                const skillDirName = WORKFLOW_TO_SKILL_DIR[workflowId];
+                const skillFile = path.join(skillsDir, skillDirName, 'SKILL.md');
+                if (fs.existsSync(skillFile)) {
+                    installed.add(workflowId);
+                    hasSkills = true;
+                }
             }
         }
         const adapter = CommandAdapterRegistry.get(tool.value);
@@ -89,7 +422,7 @@ export function migrateIfNeeded(projectPath, tools) {
         return;
     }
     // Scan for installed workflows
-    const artifacts = scanInstalledWorkflowArtifacts(projectPath, tools);
+    const artifacts = scanInstalledWorkflowArtifacts(projectPath, tools, true);
     const installedWorkflows = artifacts.workflows;
     if (installedWorkflows.length === 0) {
         // No workflows installed, new user — defaults will apply
@@ -103,6 +436,22 @@ export function migrateIfNeeded(projectPath, tools) {
     }
     saveGlobalConfig(config);
     console.log(`Migrated: custom profile with ${installedWorkflows.length} workflows`);
-    console.log("New in this version: /opsx:propose. Try 'openspec config profile core' for the streamlined experience.");
+    // Each detected tool resolves to a propose reference for its surface: the
+    // command name its generated files answer to when commands will exist for it
+    // under the effective delivery (/opsx:propose when namespaced under opsx/,
+    // /opsx-propose when the filename is the command), its documented skill
+    // invocation otherwise. When the tools disagree — including command tools
+    // mixed with skill-only tools — stay syntax-neutral rather than advertise a
+    // form that is wrong for one of them.
+    const effectiveDelivery = config.delivery ?? 'both';
+    const proposeReferences = new Set(tools.map((tool) => {
+        if (shouldGenerateCommandsForTool(tool.value, effectiveDelivery)) {
+            const transformer = getTransformerForTool(tool.value, effectiveDelivery, resolveCommandSurfaceCapability(tool.value), resolveCommandInvocation(tool.value));
+            return transformer ? transformer('/opsx:propose') : '/opsx:propose';
+        }
+        return getSkillReferenceTransformer(tool.value)('/opsx:propose');
+    }));
+    const proposeReference = proposeReferences.size === 1 ? [...proposeReferences][0] : 'the openspec-propose skill';
+    console.log(`New in this version: ${proposeReference}. Try 'openspec config profile core' for the streamlined experience.`);
 }
 //# sourceMappingURL=migration.js.map

package/dist/core/modify/conflict-detector.d.ts

@@ -0,0 +1,26 @@
+export interface ConflictInfo {
+    artifactId: string;
+    affectedSections: string[];
+}
+/**
+ * Detects conflicts where manual edits would be overwritten by propagation.
+ */
+export declare class ConflictDetector {
+    private changeRoot;
+    constructor(changeRoot: string);
+    /**
+     * Detects conflicts for a specific artifact.
+     * Returns conflict info if conflicts exist, null otherwise.
+     */
+    detectConflicts(artifactId: string, artifactPath: string, upstreamContent: string): Promise<ConflictInfo | null>;
+    /**
+     * Heuristic to detect if content has manual edits.
+     * In a full implementation, this would use git diff or similar.
+     */
+    private hasManualEdits;
+    /**
+     * Detects conflicts for multiple artifacts.
+     */
+    detectAllConflicts(artifactPaths: Map<string, string>, upstreamContents: Map<string, string>): Promise<ConflictInfo[]>;
+}
+//# sourceMappingURL=conflict-detector.d.ts.map

package/dist/core/modify/conflict-detector.js

@@ -0,0 +1,62 @@
+import { readFile } from 'node:fs/promises';
+/**
+ * Detects conflicts where manual edits would be overwritten by propagation.
+ */
+export class ConflictDetector {
+    changeRoot;
+    constructor(changeRoot) {
+        this.changeRoot = changeRoot;
+    }
+    /**
+     * Detects conflicts for a specific artifact.
+     * Returns conflict info if conflicts exist, null otherwise.
+     */
+    async detectConflicts(artifactId, artifactPath, upstreamContent) {
+        try {
+            const currentContent = await readFile(artifactPath, 'utf-8');
+            // In a full implementation, this would:
+            // 1. Parse both current and upstream content
+            // 2. Identify sections that would be overwritten
+            // 3. Check if manual edits exist in those sections
+            // For now, simplified approach: if content differs and has manual edits, flag as conflict
+            if (currentContent !== upstreamContent && this.hasManualEdits(currentContent)) {
+                return {
+                    artifactId,
+                    affectedSections: ['entire file'], // Simplified: flag entire file as conflict
+                };
+            }
+            return null;
+        }
+        catch (error) {
+            // If file doesn't exist, no conflict
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Heuristic to detect if content has manual edits.
+     * In a full implementation, this would use git diff or similar.
+     */
+    hasManualEdits(content) {
+        // Simplified heuristic: check for markers of manual editing
+        // In a real implementation, this would compare with template-generated content
+        return content.length > 0; // Placeholder: assume non-empty content has manual edits
+    }
+    /**
+     * Detects conflicts for multiple artifacts.
+     */
+    async detectAllConflicts(artifactPaths, upstreamContents) {
+        const conflicts = [];
+        for (const [artifactId, artifactPath] of artifactPaths.entries()) {
+            const upstreamContent = upstreamContents.get(artifactId) || '';
+            const conflict = await this.detectConflicts(artifactId, artifactPath, upstreamContent);
+            if (conflict) {
+                conflicts.push(conflict);
+            }
+        }
+        return conflicts;
+    }
+}
+//# sourceMappingURL=conflict-detector.js.map

package/dist/core/modify/dependency-propagator.d.ts

@@ -0,0 +1,38 @@
+import type { ArtifactGraph } from '../artifact-graph/graph.js';
+export interface DependencyPropagationResult {
+    artifactId: string;
+    filePath: string;
+    modificationScope: 'direct' | 'propagated';
+}
+export interface ConflictInfo {
+    artifactId: string;
+    affectedSections: string[];
+}
+/**
+ * Propagates changes from modified artifacts to their dependents.
+ * Uses diff-based merge to preserve non-conflicting manual edits.
+ */
+export declare class DependencyPropagator {
+    private graph;
+    private changeRoot;
+    constructor(graph: ArtifactGraph, changeRoot: string);
+    /**
+     * Calculates all artifacts that need to be updated given the modified artifacts.
+     * Returns artifact IDs in update order (deepest dependents first).
+     */
+    calculateUpdateScope(modifiedArtifacts: string[]): string[];
+    /**
+     * Performs diff-based merge to preserve non-conflicting manual edits.
+     * Returns the merged content.
+     */
+    mergeContent(currentContent: string, upstreamContent: string): Promise<string>;
+    /**
+     * Propagates changes to a single artifact.
+     */
+    propagateToArtifact(artifactId: string, artifactPath: string, upstreamChanges: Map<string, string>): Promise<DependencyPropagationResult>;
+    /**
+     * Propagates changes to all affected artifacts.
+     */
+    propagateChanges(modifiedArtifacts: string[], artifactPaths: Map<string, string>): Promise<DependencyPropagationResult[]>;
+}
+//# sourceMappingURL=dependency-propagator.d.ts.map

package/dist/core/modify/dependency-propagator.js

@@ -0,0 +1,103 @@
+import { readFile } from 'node:fs/promises';
+/**
+ * Propagates changes from modified artifacts to their dependents.
+ * Uses diff-based merge to preserve non-conflicting manual edits.
+ */
+export class DependencyPropagator {
+    graph;
+    changeRoot;
+    constructor(graph, changeRoot) {
+        this.graph = graph;
+        this.changeRoot = changeRoot;
+    }
+    /**
+     * Calculates all artifacts that need to be updated given the modified artifacts.
+     * Returns artifact IDs in update order (deepest dependents first).
+     */
+    calculateUpdateScope(modifiedArtifacts) {
+        const toUpdate = new Set();
+        for (const artifactId of modifiedArtifacts) {
+            try {
+                const dependents = this.graph.getDependents(artifactId);
+                for (const dep of dependents) {
+                    toUpdate.add(dep);
+                }
+            }
+            catch (error) {
+                // If getDependents throws (e.g., circular dependency), re-throw
+                throw error;
+            }
+        }
+        // Add the modified artifacts themselves
+        for (const artifactId of modifiedArtifacts) {
+            toUpdate.add(artifactId);
+        }
+        // Sort by reverse build order (deepest first)
+        const buildOrder = this.graph.getBuildOrder();
+        const updateOrder = Array.from(toUpdate).sort((a, b) => {
+            const posA = buildOrder.indexOf(a);
+            const posB = buildOrder.indexOf(b);
+            return posB - posA;
+        });
+        return updateOrder;
+    }
+    /**
+     * Performs diff-based merge to preserve non-conflicting manual edits.
+     * Returns the merged content.
+     */
+    async mergeContent(currentContent, upstreamContent) {
+        // Simple line-by-line diff-based merge
+        const currentLines = currentContent.split('\n');
+        const upstreamLines = upstreamContent.split('\n');
+        // For now, return upstream content (simplified approach)
+        // In a full implementation, this would do a proper 3-way merge
+        // preserving manual edits that don't conflict with upstream changes
+        return upstreamContent;
+    }
+    /**
+     * Propagates changes to a single artifact.
+     */
+    async propagateToArtifact(artifactId, artifactPath, upstreamChanges) {
+        // Read current content
+        const currentContent = await readFile(artifactPath, 'utf-8');
+        // In a full implementation, this would:
+        // 1. Load the template for the artifact
+        // 2. Regenerate with upstream changes as context
+        // 3. Merge with current content using diff-based merge
+        // For now, we'll return a placeholder result
+        return {
+            artifactId,
+            filePath: artifactPath,
+            modificationScope: 'propagated',
+        };
+    }
+    /**
+     * Propagates changes to all affected artifacts.
+     */
+    async propagateChanges(modifiedArtifacts, artifactPaths) {
+        const updateOrder = this.calculateUpdateScope(modifiedArtifacts);
+        const results = [];
+        for (const artifactId of updateOrder) {
+            const artifactPath = artifactPaths.get(artifactId);
+            if (!artifactPath) {
+                throw new Error(`No path found for artifact: ${artifactId}`);
+            }
+            if (modifiedArtifacts.includes(artifactId)) {
+                // Direct modification
+                results.push({
+                    artifactId,
+                    filePath: artifactPath,
+                    modificationScope: 'direct',
+                });
+            }
+            else {
+                // Propagated change
+                const result = await this.propagateToArtifact(artifactId, artifactPath, new Map() // upstream changes would be passed here
+                );
+                results.push(result);
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=dependency-propagator.js.map

package/dist/core/modify/history-tracker.d.ts

@@ -0,0 +1,34 @@
+export interface ModificationRecord {
+    timestamp: string;
+    modifiedArtifacts: string[];
+    intent: string;
+}
+export interface ChangeMarker {
+    modifyHistory: ModificationRecord[];
+}
+/**
+ * Tracks modification history in the change marker (.openspec.yaml).
+ */
+export declare class HistoryTracker {
+    private changeRoot;
+    constructor(changeRoot: string);
+    /**
+     * Records a modification event in the change marker.
+     */
+    recordModification(changeName: string, modifiedArtifacts: string[], intent: string): Promise<void>;
+    /**
+     * Gets the modification history for a change.
+     */
+    getHistory(changeName: string): Promise<ModificationRecord[]>;
+    /**
+     * Parses the change marker YAML content.
+     * In a full implementation, this would use a proper YAML parser.
+     */
+    private parseMarker;
+    /**
+     * Stringifies the change marker to YAML format.
+     * In a full implementation, this would use a proper YAML stringifier.
+     */
+    private stringifyMarker;
+}
+//# sourceMappingURL=history-tracker.d.ts.map