@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/utils/snapshot-retention.js

@@ -0,0 +1,71 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Retain only recognized complete snapshots, preserving unsafe and foreign entries.
+ */
+import { readdirSync, rmdirSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { inspectSnapshotTree, recognizedSnapshot, } from './snapshot-manifest.js';
+import { assertSafeDirectory, assertSafeFile, pathEntry } from './snapshot-paths.js';
+export const BACKUP_DIR_PREFIX = 'github-';
+const OWNED_DIRECTORY = /^github-\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-[A-Za-z0-9]{6}$/;
+/** Call only with an inventoried tree belonging to this attempt or a recognized snapshot. */
+function removeSafeTree(tree) {
+    for (const file of tree.files) {
+        assertSafeFile(file);
+        unlinkSync(file);
+    }
+    for (const directory of tree.directories.reverse()) {
+        assertSafeDirectory(directory);
+        rmdirSync(directory);
+    }
+}
+export function cleanIncompleteSnapshot(directory, owner) {
+    const current = pathEntry(directory);
+    if (!owner ||
+        !current ||
+        current.isSymbolicLink() ||
+        current.dev !== owner.dev ||
+        current.ino !== owner.ino) {
+        throw new Error(`Refused cleanup of a directory no longer owned by this attempt: ${directory}`);
+    }
+    removeSafeTree(inspectSnapshotTree(directory));
+}
+/** A retention problem does not invalidate the completed pre-write evidence. */
+export function pruneSnapshots(backupsRoot, fresh, workspaceRoot, maxBackups) {
+    const warnings = [];
+    const recognized = [];
+    assertSafeDirectory(backupsRoot);
+    for (const name of readdirSync(backupsRoot)) {
+        if (!name.startsWith(BACKUP_DIR_PREFIX)) {
+            warnings.push(`Preserved unrelated backup entry: ${name}`);
+            continue;
+        }
+        const directory = join(backupsRoot, name);
+        if (directory === fresh)
+            continue;
+        try {
+            if (!OWNED_DIRECTORY.test(name))
+                throw new Error('Foreign backup directory name');
+            assertSafeDirectory(directory);
+            recognizedSnapshot(directory, workspaceRoot);
+            recognized.push({ directory, modified: pathEntry(directory)?.mtimeMs ?? 0 });
+        }
+        catch (error) {
+            warnings.push(`Preserved backup ${name}: ${String(error)}`);
+        }
+    }
+    recognized.sort((a, b) => b.modified - a.modified || b.directory.localeCompare(a.directory));
+    for (const candidate of recognized.slice(Math.max(0, maxBackups - 1))) {
+        try {
+            // Recheck ownership and evidence immediately before removing any entry.
+            removeSafeTree(recognizedSnapshot(candidate.directory, workspaceRoot));
+        }
+        catch (error) {
+            warnings.push(`Could not prune backup ${candidate.directory}: ${String(error)}`);
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=snapshot-retention.js.map

package/dist/utils/snapshot-retention.js.map

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

package/dist/utils/text-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Text-file reading that tolerates a UTF-8 byte-order mark. Windows editors
+ * (Notepad, PowerShell redirection) prepend U+FEFF, which defeats a
+ * `startsWith('---')` frontmatter test and makes `JSON.parse` throw.
+ */
+/** The text without a leading U+FEFF byte-order mark. */
+export declare function stripBom(text: string): string;
+/** Read a UTF-8 file and drop a leading byte-order mark. */
+export declare function readTextFile(path: string): string;
+//# sourceMappingURL=text-file.d.ts.map

package/dist/utils/text-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-file.d.ts","sourceRoot":"","sources":["../../src/utils/text-file.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/utils/text-file.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Text-file reading that tolerates a UTF-8 byte-order mark. Windows editors
+ * (Notepad, PowerShell redirection) prepend U+FEFF, which defeats a
+ * `startsWith('---')` frontmatter test and makes `JSON.parse` throw.
+ */
+import { readFileSync } from 'node:fs';
+const BOM = '';
+/** The text without a leading U+FEFF byte-order mark. */
+export function stripBom(text) {
+    return text.startsWith(BOM) ? text.slice(1) : text;
+}
+/** Read a UTF-8 file and drop a leading byte-order mark. */
+export function readTextFile(path) {
+    return stripBom(readFileSync(path, 'utf8'));
+}
+//# sourceMappingURL=text-file.js.map

package/dist/utils/text-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-file.js","sourceRoot":"","sources":["../../src/utils/text-file.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,GAAG,GAAG,GAAG,CAAC;AAEhB,yDAAyD;AACzD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/utils/update-agent-files.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Host-neutral agent-file sync.
+ *
+ * Payload files the package no longer ships are removed when they are provably
+ * ours and unedited (`agent-files-prune.ts`, BUG-143).
+ *
+ * Every existing path that will change is snapshotted before the first write;
+ * a failed snapshot aborts the run. A later write failure preserves the backup
+ * for recovery rather than promising automatic rollback.
+ *
+ * The function was named `updateCopilotFiles` while Copilot was the only host;
+ * the CLI command `devsteps update-copilot-files` and the MCP tool
+ * `update_copilot_files` keep their names so existing configurations and tool
+ * allowlists stay valid.
+ *
+ * @see EPIC-056 STORY-395 TASK-768 TASK-769 TASK-770 TASK-771
+ */
+import { type FileUpdateStatus } from './agent-files-payload.js';
+import { type CodexMode } from './codex-types.js';
+/** Host surfaces to sync. Wider than `AgentHost`, which names a single host. */
+export type AgentHostSelection = 'copilot' | 'claude' | 'both' | 'codex';
+export interface UpdateAgentFilesResult {
+    success: boolean;
+    updatedCount: number;
+    skippedCount: number;
+    addedCount: number;
+    /** Retired payload files deleted (or, in a dry run, to be deleted). */
+    removedCount: number;
+    backupDir: string;
+    files: FileUpdateStatus[];
+    message: string;
+    error?: string;
+}
+export interface UpdateAgentFilesOptions {
+    codexMode?: CodexMode;
+    sourceCodexDir?: string;
+    /** CLI-only cleanup of unchanged project-owned Codex payload. */
+    remove?: boolean;
+    /** DevSteps package version recorded in payload markers. */
+    packageVersion?: string;
+    /** Maximum backup rotations to keep (default: 5). */
+    maxBackups?: number;
+    /** Report what would change without writing. No backup is taken. */
+    dryRun?: boolean;
+    /** Overwrite even when a target carries local edits. */
+    force?: boolean;
+    /** Which host surfaces to sync (default: `copilot`). */
+    host?: AgentHostSelection;
+    /** Project root; defaults to the parent of `targetGithubDir`. */
+    projectPath?: string;
+    /** Name used in a freshly created `CLAUDE.md` heading. */
+    projectName?: string;
+}
+/** Update current Claude/Copilot surfaces with complete pre-write byte snapshots. */
+export declare function updateAgentFiles(sourceGithubDir: string, targetGithubDir: string, devstepsDir: string, options?: UpdateAgentFilesOptions): UpdateAgentFilesResult;
+/** @deprecated Use {@link updateAgentFiles}; kept so the tool name stays valid. */
+export declare const updateCopilotFiles: typeof updateAgentFiles;
+export type UpdateCopilotFilesResult = UpdateAgentFilesResult;
+export type UpdateCopilotFilesOptions = UpdateAgentFilesOptions;
+//# sourceMappingURL=update-agent-files.d.ts.map

package/dist/utils/update-agent-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-agent-files.d.ts","sourceRoot":"","sources":["../../src/utils/update-agent-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAGL,KAAK,gBAAgB,EAGtB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAUtE,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzE,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoRD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,uBAAuB,GAChC,sBAAsB,CAgCxB;AAED,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,yBAAmB,CAAC;AACnD,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC9D,MAAM,MAAM,yBAAyB,GAAG,uBAAuB,CAAC"}

package/dist/utils/update-agent-files.js

@@ -0,0 +1,248 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Host-neutral agent-file sync.
+ *
+ * Payload files the package no longer ships are removed when they are provably
+ * ours and unedited (`agent-files-prune.ts`, BUG-143).
+ *
+ * Every existing path that will change is snapshotted before the first write;
+ * a failed snapshot aborts the run. A later write failure preserves the backup
+ * for recovery rather than promising automatic rollback.
+ *
+ * The function was named `updateCopilotFiles` while Copilot was the only host;
+ * the CLI command `devsteps update-copilot-files` and the MCP tool
+ * `update_copilot_files` keep their names so existing configurations and tool
+ * allowlists stay valid.
+ *
+ * @see EPIC-056 STORY-395 TASK-768 TASK-769 TASK-770 TASK-771
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+import { candidateDirectories, diffPayload, hasPayloadDirectory, } from './agent-files-payload.js';
+import { applyPrune, planPrune } from './agent-files-prune.js';
+import { createWorkspaceSnapshot } from './agent-files-snapshot.js';
+import { renderClaudeContractPreamble } from './claude-host.js';
+import { setupCodexProject } from './codex-setup.js';
+import { assertCodexOptions } from './codex-types.js';
+import { planContractBlock, readPackagedContractBlock, writeContractBlock, } from './contract-block.js';
+import { injectDevstepsComment } from './init-helpers.js';
+import { assertSafeDirectory, validateWorkspaceTargets } from './snapshot-paths.js';
+/** Contract-file statuses mapped onto the payload reporting vocabulary. */
+const CONTRACT_STATUS = {
+    created: { status: 'added' },
+    updated: { status: 'updated', reason: 'block-replaced' },
+    unchanged: { status: 'skipped', reason: 'hash-match' },
+    'skipped-modified': { status: 'skipped', reason: 'user-modified' },
+    unavailable: { status: 'skipped', reason: 'no-block-in-package' },
+};
+function failure(message, error) {
+    return {
+        success: false,
+        updatedCount: 0,
+        skippedCount: 0,
+        addedCount: 0,
+        removedCount: 0,
+        backupDir: '',
+        files: [],
+        message,
+        error,
+    };
+}
+function count(files, status) {
+    return files.filter((f) => f.status === status).length;
+}
+function summarize(files, labels) {
+    const updated = count(files, 'updated');
+    const added = count(files, 'added');
+    const removed = count(files, 'removed');
+    const modified = files.filter((f) => f.reason?.startsWith('user-modified')).length;
+    const unchanged = files.filter((f) => f.status === 'skipped').length - modified;
+    return [
+        updated > 0 ? `${updated} ${labels[0]}` : '',
+        added > 0 ? `${added} ${labels[1]}` : '',
+        removed > 0 ? `${removed} ${labels[2]}` : '',
+        modified > 0 ? `${modified} ${labels[3]}` : '',
+        unchanged > 0 ? `${unchanged} ${labels[4]}` : '',
+    ]
+        .filter(Boolean)
+        .join(', ');
+}
+/** The contract files the selected hosts read, and how each is written. */
+function contractTargets(sourceGithubDir, targetGithubDir, projectPath, options) {
+    const host = options.host ?? 'copilot';
+    const block = readPackagedContractBlock(sourceGithubDir);
+    if (!block)
+        return { block: null, targets: [] };
+    const force = options.force ?? false;
+    const targets = [];
+    if (host === 'copilot' || host === 'both') {
+        targets.push({
+            file: '.github/copilot-instructions.md',
+            path: join(targetGithubDir, 'copilot-instructions.md'),
+            options: { force },
+        });
+    }
+    if (host === 'claude' || host === 'both') {
+        targets.push({
+            file: 'CLAUDE.md',
+            path: join(projectPath, 'CLAUDE.md'),
+            options: { force, preamble: renderClaudeContractPreamble(options.projectName) },
+        });
+    }
+    return { block, targets };
+}
+/** Map a contract-file outcome onto the payload reporting vocabulary. */
+function toFileStatus(file, result) {
+    const mapped = CONTRACT_STATUS[result.status] ?? { status: 'skipped' };
+    return { file, status: mapped.status, reason: mapped.reason };
+}
+/** Plan every payload, retirement and contract change without writing. */
+function planUpdates(sourceGithubDir, targetGithubDir, projectPath, settings) {
+    const syncPayload = (settings.host ?? 'copilot') !== 'claude';
+    const payload = syncPayload
+        ? diffPayload(sourceGithubDir, targetGithubDir, settings.force ?? false)
+        : { statuses: [], candidates: [] };
+    const prune = syncPayload
+        ? planPrune(sourceGithubDir, targetGithubDir, settings.packageVersion ?? 'unknown')
+        : { statuses: [], candidates: [] };
+    const { block, targets } = contractTargets(sourceGithubDir, targetGithubDir, projectPath, settings);
+    return {
+        candidates: payload.candidates,
+        prune,
+        statuses: [...payload.statuses, ...prune.statuses],
+        block,
+        contracts: targets.map((target) => ({
+            target,
+            plan: planContractBlock(target.path, block ?? '', target.options),
+        })),
+    };
+}
+/** Paths that would be overwritten, created or deleted, including contract files. */
+function changedPaths(plan) {
+    return [
+        ...plan.candidates.map((candidate) => candidate.targetFile),
+        ...plan.prune.candidates.map((candidate) => candidate.targetFile),
+        ...plan.contracts
+            .filter(({ plan }) => plan.content !== undefined)
+            .map(({ target }) => target.path),
+    ];
+}
+function plannedStatuses(plan) {
+    return [
+        ...plan.statuses,
+        ...plan.contracts.map(({ target, plan }) => toFileStatus(target.file, plan)),
+    ];
+}
+function successResult(files, backupDir, message) {
+    return {
+        success: true,
+        updatedCount: count(files, 'updated'),
+        skippedCount: count(files, 'skipped'),
+        addedCount: count(files, 'added'),
+        removedCount: count(files, 'removed'),
+        backupDir,
+        files,
+        message,
+    };
+}
+function previewResult(plan) {
+    const files = plannedStatuses(plan);
+    const summary = summarize(files, [
+        'to update',
+        'to add',
+        'retired to remove',
+        'locally modified/skipped',
+        'unchanged',
+    ]);
+    return successResult(files, '', summary ? `[dry-run] Would apply: ${summary}` : '[dry-run] Nothing to apply.');
+}
+/** Complete the byte snapshot before any target directory or file is changed. */
+function snapshotUpdates(plan, projectPath, targetGithubDir, devstepsDir, settings) {
+    assertSafeDirectory(targetGithubDir, true);
+    const targets = changedPaths(plan);
+    const keys = targets.map((target) => relative(projectPath, target).split(sep).join('/'));
+    validateWorkspaceTargets(projectPath, keys);
+    return createWorkspaceSnapshot(projectPath, devstepsDir, keys.filter((key) => existsSync(join(projectPath, key))), { maxBackups: settings.maxBackups ?? 5, packageVersion: settings.packageVersion ?? 'unknown' });
+}
+/** Apply the already planned changes; failures keep the completed snapshot for recovery. */
+function applyUpdates(plan, targetGithubDir, packageVersion) {
+    for (const directory of candidateDirectories(plan.candidates, targetGithubDir)) {
+        mkdirSync(directory, { recursive: true });
+    }
+    for (const candidate of plan.candidates) {
+        const annotated = injectDevstepsComment(candidate.rawContent, candidate.hash, packageVersion);
+        writeFileSync(candidate.targetFile, annotated, 'utf8');
+    }
+    const files = [...plan.statuses, ...applyPrune(plan.prune.candidates, targetGithubDir)];
+    for (const { target, plan: contract } of plan.contracts) {
+        const result = contract.content === undefined
+            ? contract
+            : writeContractBlock(target.path, plan.block ?? '', target.options);
+        files.push(toFileStatus(target.file, result));
+    }
+    return files;
+}
+function applyWithSnapshot(plan, projectPath, targetGithubDir, devstepsDir, settings) {
+    const backup = snapshotUpdates(plan, projectPath, targetGithubDir, devstepsDir, settings);
+    if (!backup.success) {
+        return {
+            ...failure('Backup failed — update aborted to prevent partial state.', [backup.error?.message ?? 'Unknown backup error', ...(backup.warnings ?? [])].join(' ')),
+            backupDir: backup.backupDir,
+            files: plan.statuses,
+        };
+    }
+    try {
+        const files = applyUpdates(plan, targetGithubDir, settings.packageVersion ?? 'unknown');
+        const summary = summarize(files, [
+            'updated',
+            'added',
+            'retired removed',
+            'locally modified/skipped',
+            'unchanged',
+        ]);
+        return successResult(files, backup.backupDir, [
+            `Agent files updated (${summary}).${backup.fileCount > 0 ? ` Backup: ${backup.backupDir}` : ''}`,
+            ...(backup.warnings ?? []),
+        ].join(' '));
+    }
+    catch (error) {
+        return {
+            ...failure(`Write error after backup. Backup preserved at: ${backup.backupDir}`, [error instanceof Error ? error.message : String(error), ...(backup.warnings ?? [])].join(' ')),
+            backupDir: backup.backupDir,
+            files: plan.statuses,
+        };
+    }
+}
+/** Update current Claude/Copilot surfaces with complete pre-write byte snapshots. */
+export function updateAgentFiles(sourceGithubDir, targetGithubDir, devstepsDir, options) {
+    const settings = options ?? {};
+    const projectPath = resolve(settings.projectPath ?? dirname(targetGithubDir));
+    try {
+        assertCodexOptions(settings.host ?? 'copilot', settings);
+    }
+    catch (error) {
+        return failure('Invalid host options; no files changed.', String(error));
+    }
+    if (settings.host === 'codex')
+        return setupCodexProject(projectPath, devstepsDir, settings);
+    if (!hasPayloadDirectory(sourceGithubDir)) {
+        return failure('Agent source directory is invalid - update aborted.', `Source directory is missing supported agent subdirectories: ${sourceGithubDir}`);
+    }
+    try {
+        const plan = planUpdates(sourceGithubDir, targetGithubDir, projectPath, settings);
+        if (settings.dryRun)
+            return previewResult(plan);
+        if (changedPaths(plan).length === 0) {
+            return successResult(plan.statuses, '', `All ${plan.statuses.length} files are up-to-date. No changes needed.`);
+        }
+        return applyWithSnapshot(plan, projectPath, targetGithubDir, devstepsDir, settings);
+    }
+    catch (error) {
+        return failure('Backup or update planning failed — update aborted before writing.', error instanceof Error ? error.message : String(error));
+    }
+}
+/** @deprecated Use {@link updateAgentFiles}; kept so the tool name stays valid. */
+export const updateCopilotFiles = updateAgentFiles;
+//# sourceMappingURL=update-agent-files.js.map

package/dist/utils/update-agent-files.js.map

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

package/dist/utils/update-copilot-files.d.ts

@@ -42,8 +42,10 @@ export interface UpdateCopilotFilesOptions {
  *   1. Compute sha256 of raw source content (before annotation).
  *   2. If a corresponding file exists in the target:
  *      a. Extract the stored hash from its devsteps HTML comment.
- *      b. If hashes match (and `force` is not set): skip — no change needed.
- *      c. If hashes differ: mark as "update" candidate.
+ *      b. If the marker is missing or canonical target content differs from
+ *         the stored hash: skip as locally modified unless `force` is set.
+ *      c. If the canonical target content is clean, compare source and marker
+ *         hashes to decide whether the file is unchanged or outdated.
  *   3. If no corresponding file exists: mark as "add" candidate.
  * After collecting candidates:
  *   4. If there are changes and not dryRun: create a backup first.

package/dist/utils/update-copilot-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-copilot-files.d.ts","sourceRoot":"","sources":["../../src/utils/update-copilot-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAaD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,yBAAyB,GAClC,wBAAwB,CAqJ1B"}
+{"version":3,"file":"update-copilot-files.d.ts","sourceRoot":"","sources":["../../src/utils/update-copilot-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,yBAAyB,GAClC,wBAAwB,CA6L1B"}

package/dist/utils/update-copilot-files.js

@@ -28,6 +28,9 @@ function extractManagedHash(content) {
 function sha256(content) {
     return createHash('sha256').update(content, 'utf8').digest('hex');
 }
+function canonicalContent(content) {
+    return content.replace(/<!--\s*devsteps-managed:.*?-->\n?/g, '');
+}
 const SUBDIRS = [
     { sub: 'agents', suffix: '.agent.md' },
     { sub: 'instructions', suffix: '.instructions.md' },
@@ -40,8 +43,10 @@ const SUBDIRS = [
  *   1. Compute sha256 of raw source content (before annotation).
  *   2. If a corresponding file exists in the target:
  *      a. Extract the stored hash from its devsteps HTML comment.
- *      b. If hashes match (and `force` is not set): skip — no change needed.
- *      c. If hashes differ: mark as "update" candidate.
+ *      b. If the marker is missing or canonical target content differs from
+ *         the stored hash: skip as locally modified unless `force` is set.
+ *      c. If the canonical target content is clean, compare source and marker
+ *         hashes to decide whether the file is unchanged or outdated.
  *   3. If no corresponding file exists: mark as "add" candidate.
  * After collecting candidates:
  *   4. If there are changes and not dryRun: create a backup first.
@@ -58,6 +63,19 @@ export function updateCopilotFiles(sourceGithubDir, targetGithubDir, devstepsDir
     const dryRun = options?.dryRun ?? false;
     const force = options?.force ?? false;
     const maxBackups = options?.maxBackups ?? 5;
+    const hasSupportedSourceDirectory = SUBDIRS.some(({ sub }) => existsSync(join(sourceGithubDir, sub)));
+    if (!existsSync(sourceGithubDir) || !hasSupportedSourceDirectory) {
+        return {
+            success: false,
+            updatedCount: 0,
+            skippedCount: 0,
+            addedCount: 0,
+            backupDir: '',
+            files: [],
+            message: 'Copilot source directory is invalid - update aborted.',
+            error: `Source directory is missing supported Copilot subdirectories: ${sourceGithubDir}`,
+        };
+    }
     const fileStatuses = [];
     const updateCandidates = [];
     // ── Phase 1: Diff source vs. target ─────────────────────────────────────────
@@ -66,7 +84,7 @@ export function updateCopilotFiles(sourceGithubDir, targetGithubDir, devstepsDir
         const targetSubDir = join(targetGithubDir, sub);
         if (!existsSync(sourceSubDir))
             continue;
-        const sourceFiles = readdirSync(sourceSubDir).filter((f) => f.startsWith('devsteps') && f.endsWith(suffix));
+        const sourceFiles = readdirSync(sourceSubDir).filter((f) => f.toLowerCase().startsWith('devsteps-') && f.endsWith(suffix));
         for (const file of sourceFiles) {
             const sourceFile = join(sourceSubDir, file);
             const targetFile = join(targetSubDir, file);
@@ -76,20 +94,39 @@ export function updateCopilotFiles(sourceGithubDir, targetGithubDir, devstepsDir
             if (existsSync(targetFile)) {
                 const installed = readFileSync(targetFile, 'utf8');
                 const installedHash = extractManagedHash(installed);
+                const targetHash = sha256(canonicalContent(installed));
+                if (!force && installedHash === null) {
+                    fileStatuses.push({ file: rel, status: 'skipped', reason: 'user-modified-no-marker' });
+                    continue;
+                }
+                if (!force && installedHash !== targetHash) {
+                    fileStatuses.push({ file: rel, status: 'skipped', reason: 'user-modified' });
+                    continue;
+                }
                 if (!force && installedHash === sourceHash) {
                     fileStatuses.push({ file: rel, status: 'skipped', reason: 'hash-match' });
                     continue;
                 }
-                const reasonSuffix = installedHash === null
-                    ? 'no-marker'
-                    : force
-                        ? 'force'
-                        : 'hash-mismatch';
-                updateCandidates.push({ sourceFile, targetFile, rawContent, hash: sourceHash, rel, status: 'updated' });
+                const reasonSuffix = force ? 'force' : 'hash-mismatch';
+                updateCandidates.push({
+                    sourceFile,
+                    targetFile,
+                    rawContent,
+                    hash: sourceHash,
+                    rel,
+                    status: 'updated',
+                });
                 fileStatuses.push({ file: rel, status: 'updated', reason: reasonSuffix });
             }
             else {
-                updateCandidates.push({ sourceFile, targetFile, rawContent, hash: sourceHash, rel, status: 'added' });
+                updateCandidates.push({
+                    sourceFile,
+                    targetFile,
+                    rawContent,
+                    hash: sourceHash,
+                    rel,
+                    status: 'added',
+                });
                 fileStatuses.push({ file: rel, status: 'added' });
             }
         }
@@ -97,6 +134,7 @@ export function updateCopilotFiles(sourceGithubDir, targetGithubDir, devstepsDir
     const updatedCount = fileStatuses.filter((f) => f.status === 'updated').length;
     const skippedCount = fileStatuses.filter((f) => f.status === 'skipped').length;
     const addedCount = fileStatuses.filter((f) => f.status === 'added').length;
+    const modifiedCount = fileStatuses.filter((f) => f.reason?.startsWith('user-modified')).length;
     // ── Phase 2: If nothing to do, return early ──────────────────────────────────
     if (updateCandidates.length === 0) {
         return {
@@ -113,7 +151,8 @@ export function updateCopilotFiles(sourceGithubDir, targetGithubDir, devstepsDir
         const summary = [
             updatedCount > 0 ? `${updatedCount} to update` : '',
             addedCount > 0 ? `${addedCount} to add` : '',
-            skippedCount > 0 ? `${skippedCount} unchanged` : '',
+            modifiedCount > 0 ? `${modifiedCount} locally modified/skipped` : '',
+            skippedCount - modifiedCount > 0 ? `${skippedCount - modifiedCount} unchanged` : '',
         ]
             .filter(Boolean)
             .join(', ');
@@ -166,7 +205,8 @@ export function updateCopilotFiles(sourceGithubDir, targetGithubDir, devstepsDir
     const summary = [
         updatedCount > 0 ? `${updatedCount} updated` : '',
         addedCount > 0 ? `${addedCount} added` : '',
-        skippedCount > 0 ? `${skippedCount} unchanged` : '',
+        modifiedCount > 0 ? `${modifiedCount} locally modified/skipped` : '',
+        skippedCount - modifiedCount > 0 ? `${skippedCount - modifiedCount} unchanged` : '',
     ]
         .filter(Boolean)
         .join(', ');

package/dist/utils/update-copilot-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-copilot-files.js","sourceRoot":"","sources":["../../src/utils/update-copilot-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,mFAAmF;AACnF,MAAM,kBAAkB,GAAG,gEAAgE,CAAC;AAE5F;;;GAGG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAS,MAAM,CAAC,OAAe;IAC7B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAsCD,MAAM,OAAO,GAAmB;IAC9B,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;IACtC,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACnD,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE;CACzC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,kBAAkB,CAChC,eAAuB,EACvB,eAAuB,EACvB,WAAmB,EACnB,OAAmC;IAEnC,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,SAAS,CAAC;IAC5D,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC;IACtC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;IAE5C,MAAM,YAAY,GAAuB,EAAE,CAAC;IAC5C,MAAM,gBAAgB,GAOjB,EAAE,CAAC;IAER,+EAA+E;IAC/E,KAAK,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QAEhD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,SAAS;QAExC,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CAClD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACtD,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YAE7B,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBACnD,MAAM,aAAa,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;gBAEpD,IAAI,CAAC,KAAK,IAAI,aAAa,KAAK,UAAU,EAAE,CAAC;oBAC3C,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;oBAC1E,SAAS;gBACX,CAAC;gBAED,MAAM,YAAY,GAAG,aAAa,KAAK,IAAI;oBACzC,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,KAAK;wBACL,CAAC,CAAC,OAAO;wBACT,CAAC,CAAC,eAAe,CAAC;gBACtB,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBACxG,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;YAC5E,CAAC;iBAAM,CAAC;gBACN,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;gBACtG,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAC/E,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAC/E,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IAE3E,gFAAgF;IAChF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,CAAC;YACf,YAAY;YACZ,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,OAAO,YAAY,2CAA2C;SACxE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,OAAO,GAAG;YACd,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,YAAY,CAAC,CAAC,CAAC,EAAE;YACnD,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,SAAS,CAAC,CAAC,CAAC,EAAE;YAC5C,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,YAAY,CAAC,CAAC,CAAC,EAAE;SACpD;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY;YACZ,YAAY;YACZ,UAAU;YACV,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,0BAA0B,OAAO,EAAE;SAC7C,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,MAAM,YAAY,GAAG,iBAAiB,CAAC,eAAe,EAAE,WAAW,EAAE;QACnE,UAAU;QACV,cAAc;KACf,CAAC,CAAC;IAEH,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,CAAC;YACf,YAAY;YACZ,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,0DAA0D;YACnE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,OAAO,IAAI,sBAAsB;SAC7D,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,IAAI,CAAC;QACH,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,qBAAqB,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAC9F,aAAa,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAAC,OAAO,UAAU,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,YAAY;YACZ,YAAY;YACZ,UAAU;YACV,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,kDAAkD,YAAY,CAAC,SAAS,EAAE;YACnF,KAAK,EAAE,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;SAC7E,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG;QACd,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,UAAU,CAAC,CAAC,CAAC,EAAE;QACjD,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC3C,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,YAAY,CAAC,CAAC,CAAC,EAAE;KACpD;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,OAAO,EAAE,IAAI;QACb,YAAY;QACZ,YAAY;QACZ,UAAU;QACV,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,0BAA0B,OAAO,KAAK,YAAY,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;KACxH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"update-copilot-files.js","sourceRoot":"","sources":["../../src/utils/update-copilot-files.ts"],"names":[],"mappings":"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"}