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

package/dist/types/index-refs.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-refs.types.js","sourceRoot":"","sources":["../../src/types/index-refs.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA+FH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,2BAA2B;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,YAAY;KACS;IAE7B,6BAA6B;IAC7B,MAAM,EAAE;QACN,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,cAAc;QACvB,aAAa,EAAE,kBAAkB;QACjC,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,gBAAgB;KACE;IAE/B,+BAA+B;IAC/B,QAAQ,EAAE;QACR,kBAAkB,EAAE,uBAAuB;QAC3C,sBAAsB,EAAE,2BAA2B;QACnD,sBAAsB,EAAE,2BAA2B;QACnD,0BAA0B,EAAE,+BAA+B;KACtB;CAC/B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;;;;;OAKG;IACH,oBAAoB,EAAE,IAAI;IAE1B;;OAEG;IACH,WAAW,EAAE;QACX,eAAe,EAAE,EAAE,EAAE,KAAK;QAC1B,iBAAiB,EAAE,EAAE,EAAE,KAAK;QAC5B,aAAa,EAAE,GAAG,EAAE,KAAK;KAC1B;CACO,CAAC"}
+{"version":3,"file":"index-refs.types.js","sourceRoot":"","sources":["../../src/types/index-refs.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA+FH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,2BAA2B;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,WAAW;KACW;IAE7B,6BAA6B;IAC7B,MAAM,EAAE;QACN,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,cAAc;QACvB,aAAa,EAAE,kBAAkB;QACjC,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,gBAAgB;KACE;IAE/B,+BAA+B;IAC/B,QAAQ,EAAE;QACR,kBAAkB,EAAE,uBAAuB;QAC3C,sBAAsB,EAAE,2BAA2B;QACnD,sBAAsB,EAAE,2BAA2B;QACnD,0BAA0B,EAAE,+BAA+B;KACtB;CAC/B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;;;;;OAKG;IACH,oBAAoB,EAAE,IAAI;IAE1B;;OAEG;IACH,WAAW,EAAE;QACX,eAAe,EAAE,EAAE,EAAE,KAAK;QAC1B,iBAAiB,EAAE,EAAE,EAAE,KAAK;QAC5B,aAAa,EAAE,GAAG,EAAE,KAAK;KAC1B;CACO,CAAC"}

package/dist/types/index.d.ts

@@ -5,8 +5,7 @@
  * Types barrel export
  * Re-exports all TypeScript types from the shared type layer.
  */
-export type { AnalysisAspect, AnalysisBriefing, AspectVerdict, CompressedVerdict, EnrichedSprintBrief, EnrichedSprintItem, SprintItemRisk, SprintVerdict, } from '../schemas/analysis.js';
-export type { DevStepsConfig, DevStepsIndex, EisenhowerQuadrant, GitCommit, ItemMetadata, ItemStatus, ItemType, LinkedItems, RelationType, } from '../schemas/index.js';
+export type { CommitReferences, DevStepsConfig, DevStepsIndex, EisenhowerQuadrant, ItemMetadata, ItemStatus, ItemType, LinkedItems, RelationType, } from '../schemas/index.js';
 export * from './commands.js';
-export * from './index-refs.types.js';
+export * from './docs-map.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -6,5 +6,5 @@
  * Re-exports all TypeScript types from the shared type layer.
  */
 export * from './commands.js';
-export * from './index-refs.types.js';
+export * from './docs-map.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

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

@@ -0,0 +1,66 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Payload diff for the agent-file sync.
+ *
+ * A payload file is owned by DevSteps end to end, so it is replaced whole and
+ * carries a whole-file marker with the sha256 of its source. That is the
+ * opposite of a contract file, where only the delimited block belongs to
+ * DevSteps — see `contract-block.ts`.
+ *
+ * Agents, instructions, and prompts live flat under their directory and are
+ * selected by the `devsteps-` prefix. Skills live one directory deep
+ * (`skills/<name>/SKILL.md`, plus the tree's own `README.md`), so they need a
+ * recursive walk rather than a suffix match in a single directory.
+ *
+ * @see EPIC-056 STORY-395 TASK-768
+ */
+export interface FileUpdateStatus {
+    /** Path relative to the project root, e.g. `.github/agents/x.agent.md`. */
+    file: string;
+    status: 'updated' | 'skipped' | 'added' | 'removed';
+    reason?: string;
+}
+export interface PayloadCandidate {
+    targetFile: string;
+    rawContent: string;
+    hash: string;
+    file: string;
+}
+export interface PayloadDiff {
+    statuses: FileUpdateStatus[];
+    candidates: PayloadCandidate[];
+}
+export declare function sha256(content: string): string;
+/** Extract the sha256 recorded in a file's whole-file marker, if any. */
+export declare function extractManagedHash(content: string): string | null;
+/** Extract the package version recorded in a file's whole-file marker, if any. */
+export declare function extractManagedVersion(content: string): string | null;
+/**
+ * The file's content without its whole-file marker — what the recorded hash
+ * covers. Block delimiters are left in place; they belong to a contract file
+ * and are never part of a payload file.
+ */
+export declare function canonicalContent(content: string): string;
+/**
+ * Skill files of a packaged `.github`, as paths relative to the skills dir.
+ * `init` uses the same list, so a skill it installs carries the marker the sync
+ * later needs to tell an upstream change from a local edit.
+ */
+export declare function listSkillFiles(sourceGithubDir: string): string[];
+/** Source files of the whole payload, as paths relative to the `.github` dir. */
+export declare function listPayloadFiles(sourceGithubDir: string): string[];
+/** True when the source directory holds at least one supported payload tree. */
+export declare function hasPayloadDirectory(sourceGithubDir: string): boolean;
+/**
+ * Compare every payload file in the source against the target.
+ *
+ * A target file is skipped when it carries no marker or its content no longer
+ * matches the recorded hash, so a local edit is never overwritten unless
+ * `force` is set.
+ */
+export declare function diffPayload(sourceGithubDir: string, targetGithubDir: string, force: boolean): PayloadDiff;
+/** Directories that must exist before payload candidates are written. */
+export declare function candidateDirectories(candidates: PayloadCandidate[], targetGithubDir: string): string[];
+//# sourceMappingURL=agent-files-payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-files-payload.d.ts","sourceRoot":"","sources":["../../src/utils/agent-files-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAaH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjE;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAiCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhE;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBlE;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAIpE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,OAAO,GACb,WAAW,CAsCb;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,gBAAgB,EAAE,EAAE,eAAe,EAAE,MAAM,YAS3F"}

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

@@ -0,0 +1,153 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Payload diff for the agent-file sync.
+ *
+ * A payload file is owned by DevSteps end to end, so it is replaced whole and
+ * carries a whole-file marker with the sha256 of its source. That is the
+ * opposite of a contract file, where only the delimited block belongs to
+ * DevSteps — see `contract-block.ts`.
+ *
+ * Agents, instructions, and prompts live flat under their directory and are
+ * selected by the `devsteps-` prefix. Skills live one directory deep
+ * (`skills/<name>/SKILL.md`, plus the tree's own `README.md`), so they need a
+ * recursive walk rather than a suffix match in a single directory.
+ *
+ * @see EPIC-056 STORY-395 TASK-768
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+/** Matches the whole-file marker written by `injectDevstepsComment`. */
+const MANAGED_COMMENT_RE = /<!--\s*devsteps-managed:\s*true\b.*?hash:\s*sha256:([0-9a-f]{64}).*?-->/;
+/** Matches the version recorded in the same marker. */
+const MANAGED_VERSION_RE = /<!--\s*devsteps-managed:\s*true\b.*?version:\s*([^\s|]+).*?-->/;
+export function sha256(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex');
+}
+/** Extract the sha256 recorded in a file's whole-file marker, if any. */
+export function extractManagedHash(content) {
+    return content.match(MANAGED_COMMENT_RE)?.[1] ?? null;
+}
+/** Extract the package version recorded in a file's whole-file marker, if any. */
+export function extractManagedVersion(content) {
+    return content.match(MANAGED_VERSION_RE)?.[1] ?? null;
+}
+/**
+ * The file's content without its whole-file marker — what the recorded hash
+ * covers. Block delimiters are left in place; they belong to a contract file
+ * and are never part of a payload file.
+ */
+export function canonicalContent(content) {
+    return content.replace(/<!--\s*devsteps-managed:\s*true\b.*?-->\n?/g, '');
+}
+const FLAT_DIRECTORIES = [
+    { sub: 'agents', suffix: '.agent.md' },
+    { sub: 'instructions', suffix: '.instructions.md' },
+    { sub: 'prompts', suffix: '.prompt.md' },
+];
+/** The skills tree is nested and is not selected by a filename prefix. */
+const SKILLS_DIRECTORY = 'skills';
+/** Every `.md` file under `directory`, as paths relative to it. */
+function walkMarkdown(directory, prefix = '') {
+    if (!existsSync(directory))
+        return [];
+    const found = [];
+    for (const entry of readdirSync(directory)) {
+        if (entry.startsWith('.'))
+            continue;
+        const absolute = join(directory, entry);
+        const relativePath = prefix ? `${prefix}/${entry}` : entry;
+        if (statSync(absolute).isDirectory()) {
+            found.push(...walkMarkdown(absolute, relativePath));
+        }
+        else if (entry.endsWith('.md')) {
+            found.push(relativePath);
+        }
+    }
+    return found;
+}
+/**
+ * Skill files of a packaged `.github`, as paths relative to the skills dir.
+ * `init` uses the same list, so a skill it installs carries the marker the sync
+ * later needs to tell an upstream change from a local edit.
+ */
+export function listSkillFiles(sourceGithubDir) {
+    return walkMarkdown(join(sourceGithubDir, SKILLS_DIRECTORY));
+}
+/** Source files of the whole payload, as paths relative to the `.github` dir. */
+export function listPayloadFiles(sourceGithubDir) {
+    const files = [];
+    for (const { sub, suffix } of FLAT_DIRECTORIES) {
+        const sourceSubDir = join(sourceGithubDir, sub);
+        if (!existsSync(sourceSubDir))
+            continue;
+        for (const file of readdirSync(sourceSubDir)) {
+            if (file.toLowerCase().startsWith('devsteps-') && file.endsWith(suffix)) {
+                files.push(`${sub}/${file}`);
+            }
+        }
+    }
+    for (const file of listSkillFiles(sourceGithubDir)) {
+        files.push(`${SKILLS_DIRECTORY}/${file}`);
+    }
+    return files;
+}
+/** True when the source directory holds at least one supported payload tree. */
+export function hasPayloadDirectory(sourceGithubDir) {
+    return [...FLAT_DIRECTORIES.map((d) => d.sub), SKILLS_DIRECTORY].some((sub) => existsSync(join(sourceGithubDir, sub)));
+}
+/**
+ * Compare every payload file in the source against the target.
+ *
+ * A target file is skipped when it carries no marker or its content no longer
+ * matches the recorded hash, so a local edit is never overwritten unless
+ * `force` is set.
+ */
+export function diffPayload(sourceGithubDir, targetGithubDir, force) {
+    const statuses = [];
+    const candidates = [];
+    for (const relativePath of listPayloadFiles(sourceGithubDir)) {
+        const sourceFile = join(sourceGithubDir, ...relativePath.split('/'));
+        const targetFile = join(targetGithubDir, ...relativePath.split('/'));
+        const rawContent = readFileSync(sourceFile, 'utf8');
+        const sourceHash = sha256(rawContent);
+        const file = `.github/${relativePath}`;
+        if (!existsSync(targetFile)) {
+            candidates.push({ targetFile, rawContent, hash: sourceHash, file });
+            statuses.push({ file, status: 'added' });
+            continue;
+        }
+        const installed = readFileSync(targetFile, 'utf8');
+        const installedHash = extractManagedHash(installed);
+        if (!force && installedHash === null) {
+            statuses.push({ file, status: 'skipped', reason: 'user-modified-no-marker' });
+            continue;
+        }
+        if (!force && installedHash !== sha256(canonicalContent(installed))) {
+            statuses.push({ file, status: 'skipped', reason: 'user-modified' });
+            continue;
+        }
+        if (!force && installedHash === sourceHash) {
+            statuses.push({ file, status: 'skipped', reason: 'hash-match' });
+            continue;
+        }
+        candidates.push({ targetFile, rawContent, hash: sourceHash, file });
+        statuses.push({ file, status: 'updated', reason: force ? 'force' : 'hash-mismatch' });
+    }
+    return { statuses, candidates };
+}
+/** Directories that must exist before payload candidates are written. */
+export function candidateDirectories(candidates, targetGithubDir) {
+    const directories = new Set();
+    for (const candidate of candidates) {
+        const relativePath = relative(targetGithubDir, candidate.targetFile);
+        const segments = relativePath.split(sep);
+        segments.pop();
+        if (segments.length > 0)
+            directories.add(join(targetGithubDir, ...segments));
+    }
+    return [...directories];
+}
+//# sourceMappingURL=agent-files-payload.js.map

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Retired-file pruning for the agent-file sync.
+ *
+ * The sync copies the current payload into a workspace but never removed what
+ * the payload stopped shipping, so retired skills and prompts stayed loaded
+ * forever (BUG-143). Ownership needs no extra manifest: every installed payload
+ * file carries the whole-file marker with its version and the sha256 of its
+ * content. A file is pruned only when all of these hold:
+ *
+ * 1. it sits where the payload lives and carries the marker,
+ * 2. its content still matches the recorded hash (nobody edited it),
+ * 3. the current payload no longer ships its path,
+ * 4. its marker version is not newer than the running package version, so an
+ *    older CLI never deletes what a newer extension installed; an unparseable
+ *    version on either side keeps the file.
+ *
+ * Every candidate passes the path guard against the real `.github` dir and must
+ * resolve to itself, so a symbolic link — on the file or a directory — is kept
+ * and never followed into a deletion elsewhere.
+ *
+ * A retired file with local edits is reported and kept. A file without a marker
+ * is not ours and is neither touched nor reported. `force` does not widen this.
+ *
+ * @see BUG-143 STORY-371
+ */
+import { type FileUpdateStatus } from './agent-files-payload.js';
+export interface PruneCandidate {
+    /** Path relative to the `.github` dir, e.g. `skills/old/SKILL.md`. */
+    relativePath: string;
+    targetFile: string;
+    file: string;
+}
+export interface PrunePlan {
+    statuses: FileUpdateStatus[];
+    candidates: PruneCandidate[];
+}
+/** Semver precedence of `a` against `b`, or null when either does not parse. */
+export declare function compareVersions(a: string | null, b: string | null): number | null;
+/** Retired DevSteps-owned files in the target that the source payload no longer ships. */
+export declare function planPrune(sourceGithubDir: string, targetGithubDir: string, packageVersion: string): PrunePlan;
+/**
+ * Delete the planned files, then any skill directory they leave empty. A skill
+ * directory that still holds other files stays and is reported.
+ */
+export declare function applyPrune(candidates: PruneCandidate[], targetGithubDir: string): FileUpdateStatus[];
+//# sourceMappingURL=agent-files-prune.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-files-prune.d.ts","sourceRoot":"","sources":["../../src/utils/agent-files-prune.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,EAIL,KAAK,gBAAgB,EAGtB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAwBD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAQjF;AA0BD,0FAA0F;AAC1F,wBAAgB,SAAS,CACvB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,SAAS,CA4BX;AAiBD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,cAAc,EAAE,EAC5B,eAAe,EAAE,MAAM,GACtB,gBAAgB,EAAE,CAqBpB"}

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

@@ -0,0 +1,164 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Retired-file pruning for the agent-file sync.
+ *
+ * The sync copies the current payload into a workspace but never removed what
+ * the payload stopped shipping, so retired skills and prompts stayed loaded
+ * forever (BUG-143). Ownership needs no extra manifest: every installed payload
+ * file carries the whole-file marker with its version and the sha256 of its
+ * content. A file is pruned only when all of these hold:
+ *
+ * 1. it sits where the payload lives and carries the marker,
+ * 2. its content still matches the recorded hash (nobody edited it),
+ * 3. the current payload no longer ships its path,
+ * 4. its marker version is not newer than the running package version, so an
+ *    older CLI never deletes what a newer extension installed; an unparseable
+ *    version on either side keeps the file.
+ *
+ * Every candidate passes the path guard against the real `.github` dir and must
+ * resolve to itself, so a symbolic link — on the file or a directory — is kept
+ * and never followed into a deletion elsewhere.
+ *
+ * A retired file with local edits is reported and kept. A file without a marker
+ * is not ours and is neither touched nor reported. `force` does not widen this.
+ *
+ * @see BUG-143 STORY-371
+ */
+import { existsSync, readdirSync, readFileSync, realpathSync, rmdirSync, rmSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { validateWorkspacePath } from '../core/path-guard.js';
+import { canonicalContent, extractManagedHash, extractManagedVersion, listPayloadFiles, sha256, } from './agent-files-payload.js';
+function parseVersion(value) {
+    const match = value?.match(/^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/);
+    if (!match)
+        return null;
+    return {
+        core: [Number(match[1]), Number(match[2]), Number(match[3])],
+        pre: match[4] ? match[4].split('.') : [],
+    };
+}
+function comparePre(a, b) {
+    if (a.length === 0 || b.length === 0)
+        return b.length - a.length;
+    for (let i = 0; i < Math.min(a.length, b.length); i++) {
+        const [x, y] = [a[i] ?? '', b[i] ?? ''];
+        const numeric = /^\d+$/.test(x) && /^\d+$/.test(y);
+        const order = numeric ? Number(x) - Number(y) : x.localeCompare(y);
+        if (order !== 0)
+            return order;
+    }
+    return a.length - b.length;
+}
+/** Semver precedence of `a` against `b`, or null when either does not parse. */
+export function compareVersions(a, b) {
+    const [left, right] = [parseVersion(a), parseVersion(b)];
+    if (!left || !right)
+        return null;
+    for (let i = 0; i < 3; i++) {
+        const order = (left.core[i] ?? 0) - (right.core[i] ?? 0);
+        if (order !== 0)
+            return order;
+    }
+    return comparePre(left.pre, right.pre);
+}
+/**
+ * Decide one retired path. `lexical` is the path inside the real `.github` dir;
+ * it must resolve to itself, so a symbolic link anywhere below `.github` — on
+ * the file or on a directory — is kept rather than followed, and the file that
+ * is backed up is the file that is deleted.
+ */
+function judge(lexical, githubRoot, packageVersion) {
+    if (validateWorkspacePath(lexical, githubRoot) === null || realpathSync(lexical) !== lexical) {
+        return { remove: false, reason: 'retired-linked-or-outside-workspace' };
+    }
+    const installed = readFileSync(lexical, 'utf8');
+    const hash = extractManagedHash(installed);
+    if (hash === null)
+        return { remove: false, reason: null };
+    if (hash !== sha256(canonicalContent(installed))) {
+        return { remove: false, reason: 'user-modified-retired' };
+    }
+    const order = compareVersions(extractManagedVersion(installed), packageVersion);
+    if (order === null || order > 0)
+        return { remove: false, reason: 'retired-version-not-older' };
+    return { remove: true };
+}
+/** Retired DevSteps-owned files in the target that the source payload no longer ships. */
+export function planPrune(sourceGithubDir, targetGithubDir, packageVersion) {
+    if (!existsSync(targetGithubDir))
+        return { statuses: [], candidates: [] };
+    // Case-insensitive file systems (Windows, macOS) see a case-only rename as the
+    // same file the sync just rewrote, so shipped paths match regardless of case.
+    const shipped = new Set(listPayloadFiles(sourceGithubDir).map((path) => path.toLowerCase()));
+    const githubRoot = realpathSync(targetGithubDir);
+    const statuses = [];
+    const candidates = [];
+    for (const relativePath of listPayloadFiles(targetGithubDir)) {
+        if (shipped.has(relativePath.toLowerCase()))
+            continue;
+        const file = `.github/${relativePath}`;
+        const targetFile = join(githubRoot, ...relativePath.split('/'));
+        let verdict;
+        try {
+            verdict = judge(targetFile, githubRoot, packageVersion);
+        }
+        catch {
+            verdict = { remove: false, reason: 'retired-unreadable' };
+        }
+        if (verdict.remove) {
+            candidates.push({ relativePath, targetFile, file });
+            statuses.push({ file, status: 'removed', reason: 'retired' });
+        }
+        else if (verdict.reason) {
+            statuses.push({ file, status: 'skipped', reason: verdict.reason });
+        }
+    }
+    return { statuses, candidates };
+}
+/** Remove empty directories from `directory` up to, not including, `stop`. */
+function removeEmptyParents(directory, stop) {
+    let current = directory;
+    while (current.startsWith(stop) && current !== stop) {
+        if (!existsSync(current)) {
+            current = dirname(current);
+            continue;
+        }
+        if (readdirSync(current).length > 0)
+            return current;
+        rmdirSync(current);
+        current = dirname(current);
+    }
+    return null;
+}
+/**
+ * Delete the planned files, then any skill directory they leave empty. A skill
+ * directory that still holds other files stays and is reported.
+ */
+export function applyPrune(candidates, targetGithubDir) {
+    // Claude-only setup can write its contract before a .github directory exists.
+    if (candidates.length === 0)
+        return [];
+    for (const candidate of candidates)
+        rmSync(candidate.targetFile, { force: true });
+    const githubRoot = realpathSync(targetGithubDir);
+    const skillsRoot = join(githubRoot, 'skills');
+    const kept = new Set();
+    for (const candidate of candidates) {
+        if (!candidate.relativePath.startsWith('skills/'))
+            continue;
+        const remaining = removeEmptyParents(dirname(candidate.targetFile), skillsRoot);
+        if (remaining)
+            kept.add(remaining);
+    }
+    return [...kept].map((directory) => ({
+        file: `.github/${directory
+            .slice(githubRoot.length + 1)
+            .split(/[\\/]/)
+            .join('/')}/`,
+        status: 'skipped',
+        reason: 'retired-directory-not-empty',
+    }));
+}
+//# sourceMappingURL=agent-files-prune.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Complete exact-byte pre-write snapshots for the existing Copilot/Claude updater.
+ */
+export interface BackupResult {
+    success: boolean;
+    backupDir: string;
+    timestamp: string;
+    fileCount: number;
+    files: string[];
+    error?: Error;
+    /** Foreign or unsafe backups are retained with diagnostics rather than deleted. */
+    warnings?: string[];
+}
+export interface SnapshotOptions {
+    maxBackups?: number;
+    packageVersion?: string;
+    skip?: boolean;
+}
+export interface SnapshotMapping {
+    source: string;
+    destination: string;
+}
+export declare function snapshotTimestamp(): string;
+/** Internal mapping adapter keeps the legacy .github-relative backup layout. */
+export declare function createMappedSnapshot(workspaceRoot: string, devstepsDir: string, mappings: readonly SnapshotMapping[], options?: SnapshotOptions, githubDir?: string): BackupResult;
+/** Every input is an existing workspace-relative file with the same backup key. */
+export declare function createWorkspaceSnapshot(workspaceRoot: string, devstepsDir: string, relativeExistingPaths: readonly string[], options?: SnapshotOptions): BackupResult;
+//# sourceMappingURL=agent-files-snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-files-snapshot.d.ts","sourceRoot":"","sources":["../../src/utils/agent-files-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAgFD,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,OAAO,GAAE,eAAoB,EAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,YAAY,CA+Cd;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,qBAAqB,EAAE,SAAS,MAAM,EAAE,EACxC,OAAO,CAAC,EAAE,eAAe,GACxB,YAAY,CAOd"}