@slope-dev/slope 1.63.0 → 1.64.0

package/dist/core/roadmap-source-patch.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Surgical text-level patching for modular roadmap YAML sources.
+ *
+ * Roadmap reconciliation must not reserialize an authored bundle: a one-field
+ * status change that rewrites quoting, indentation, and line wrapping obscures
+ * review and inflates diffs (#615, #617). These helpers patch only the lines
+ * that belong to the targeted sprint entry and leave every other byte of the
+ * source untouched. Callers verify the result semantically before writing.
+ */
+export interface RoadmapSourceSprintTextPatch {
+    /** New status value for the sprint entry, e.g. "complete". */
+    status: string;
+    /** Scorecards map key to upsert (the stored sprint id as a string). */
+    scorecardKey?: string;
+    /** Repo-relative scorecard path recorded under the key. */
+    scorecardPath?: string;
+}
+/**
+ * Patch a sprint's status (and optionally its scorecards entry) in raw YAML
+ * source text without reformatting anything else. Returns null when the
+ * document's shape prevents a confidently surgical edit (flow-style entries,
+ * mixed line endings, a missing or duplicated block-style `- id:` line) so the
+ * caller can fall back to a full rewrite explicitly.
+ */
+export declare function patchRoadmapSourceSprintText(source: string, sprintId: number, patch: RoadmapSourceSprintTextPatch): string | null;
+//# sourceMappingURL=roadmap-source-patch.d.ts.map

package/dist/core/roadmap-source-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap-source-patch.d.ts","sourceRoot":"","sources":["../../src/core/roadmap-source-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,4BAA4B;IAC3C,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAaD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,4BAA4B,GAClC,MAAM,GAAG,IAAI,CAiBf"}

package/dist/core/roadmap-source-patch.js

@@ -0,0 +1,172 @@
+/**
+ * Surgical text-level patching for modular roadmap YAML sources.
+ *
+ * Roadmap reconciliation must not reserialize an authored bundle: a one-field
+ * status change that rewrites quoting, indentation, and line wrapping obscures
+ * review and inflates diffs (#615, #617). These helpers patch only the lines
+ * that belong to the targeted sprint entry and leave every other byte of the
+ * source untouched. Callers verify the result semantically before writing.
+ */
+const ENTRY_ID_PATTERN = /^(\s*)- id:\s*([0-9][0-9.]*)\s*(#.*)?$/;
+/**
+ * Patch a sprint's status (and optionally its scorecards entry) in raw YAML
+ * source text without reformatting anything else. Returns null when the
+ * document's shape prevents a confidently surgical edit (flow-style entries,
+ * mixed line endings, a missing or duplicated block-style `- id:` line) so the
+ * caller can fall back to a full rewrite explicitly.
+ */
+export function patchRoadmapSourceSprintText(source, sprintId, patch) {
+    const eol = source.includes('\r\n') ? '\r\n' : '\n';
+    const lines = source.split(/\r?\n/);
+    // A lossless round-trip is required before we can claim the edit is
+    // surgical; mixed line endings would be silently normalized otherwise.
+    if (lines.join(eol) !== source)
+        return null;
+    const section = findTopLevelSection(lines, 'sprints');
+    if (!section)
+        return null;
+    const location = locateSprintEntry(lines, section, sprintId);
+    if (!location)
+        return null;
+    patchStatusLine(lines, location, patch.status);
+    if (patch.scorecardKey && patch.scorecardPath) {
+        if (!upsertScorecardEntry(lines, patch.scorecardKey, patch.scorecardPath))
+            return null;
+    }
+    return lines.join(eol);
+}
+function findTopLevelSection(lines, key) {
+    const start = lines.findIndex(line => new RegExp(`^${key}:\\s*(#.*)?$`).test(line));
+    if (start < 0)
+        return null;
+    let end = lines.length;
+    for (let index = start + 1; index < lines.length; index++) {
+        if (/^\S/.test(lines[index])) {
+            end = index;
+            break;
+        }
+    }
+    return { start, end };
+}
+function locateSprintEntry(lines, section, sprintId) {
+    let entryIndent = null;
+    const matches = [];
+    for (let index = section.start + 1; index < section.end; index++) {
+        const listItem = /^(\s+)- /.exec(lines[index]);
+        if (!listItem)
+            continue;
+        entryIndent ??= listItem[1];
+        if (listItem[1] !== entryIndent)
+            continue;
+        const idMatch = ENTRY_ID_PATTERN.exec(lines[index]);
+        if (idMatch && idMatch[1] === entryIndent && Number(idMatch[2]) === sprintId) {
+            matches.push(index);
+        }
+    }
+    if (entryIndent == null || matches.length !== 1)
+        return null;
+    const entryLine = matches[0];
+    let blockEnd = section.end;
+    for (let index = entryLine + 1; index < section.end; index++) {
+        const line = lines[index];
+        if (line.startsWith(`${entryIndent}- `)) {
+            blockEnd = index;
+            break;
+        }
+        if (line.trim() !== '' && !line.startsWith(entryIndent)) {
+            blockEnd = index;
+            break;
+        }
+    }
+    let propertyIndent = `${entryIndent}  `;
+    for (let index = entryLine + 1; index < blockEnd; index++) {
+        const property = /^(\s+)[A-Za-z_][\w-]*:/.exec(lines[index]);
+        if (property && property[1].length > entryIndent.length) {
+            propertyIndent = property[1];
+            break;
+        }
+    }
+    return { entryLine, blockEnd, propertyIndent };
+}
+/** Split the text after a mapping key into leading whitespace, scalar value,
+ *  and trailing comment (a `#` at the start or preceded by whitespace),
+ *  without regex backtracking. */
+function splitValueAndComment(rest) {
+    let commentStart = -1;
+    for (let index = 0; index < rest.length; index++) {
+        if (rest[index] === '#' && (index === 0 || rest[index - 1] === ' ' || rest[index - 1] === '\t')) {
+            commentStart = index;
+            break;
+        }
+    }
+    const head = commentStart < 0 ? rest : rest.slice(0, commentStart);
+    let comment = commentStart < 0 ? '' : rest.slice(commentStart);
+    let separatorEnd = 0;
+    while (separatorEnd < head.length && (head[separatorEnd] === ' ' || head[separatorEnd] === '\t'))
+        separatorEnd += 1;
+    const separator = head.slice(0, separatorEnd);
+    let valueEnd = head.length;
+    while (valueEnd > separatorEnd && (head[valueEnd - 1] === ' ' || head[valueEnd - 1] === '\t'))
+        valueEnd -= 1;
+    if (comment)
+        comment = `${head.slice(valueEnd)}${comment}`;
+    return { separator, value: head.slice(separatorEnd, valueEnd), comment };
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function patchStatusLine(lines, location, status) {
+    const prefix = `${location.propertyIndent}status:`;
+    for (let index = location.entryLine + 1; index < location.blockEnd; index++) {
+        if (!lines[index].startsWith(prefix))
+            continue;
+        const { separator, comment } = splitValueAndComment(lines[index].slice(prefix.length));
+        // Guarantee separators so empty values (`status:`) and comment-only
+        // values (`status: # note`) cannot glue into an invalid scalar.
+        const commentSeparator = comment && !/^[ \t]/.test(comment) ? ' ' : '';
+        lines[index] = `${prefix}${separator || ' '}${status}${commentSeparator}${comment}`;
+        return;
+    }
+    lines.splice(location.entryLine + 1, 0, `${location.propertyIndent}status: ${status}`);
+}
+/** Returns false when a scorecards section exists in a shape (flow style)
+ *  that cannot be edited surgically, so the caller can fall back explicitly. */
+function upsertScorecardEntry(lines, key, path) {
+    const section = findTopLevelSection(lines, 'scorecards');
+    if (!section) {
+        // A `scorecards:` line that carries inline content (flow-style map) is a
+        // real section this patcher cannot edit; appending a second key would
+        // corrupt the document.
+        if (lines.some(line => /^scorecards:/.test(line)))
+            return false;
+        let insertAt = lines.length;
+        while (insertAt > 0 && lines[insertAt - 1].trim() === '')
+            insertAt -= 1;
+        lines.splice(insertAt, 0, 'scorecards:', `  "${key}": ${path}`);
+        return true;
+    }
+    const escapedKey = escapeRegExp(key);
+    const keyPattern = new RegExp(`^([ \\t]+)(['"]?)${escapedKey}\\2:`);
+    let entryIndent = '  ';
+    let lastEntry = section.start;
+    for (let index = section.start + 1; index < section.end; index++) {
+        const entry = /^([ \t]+)(['"]?)([0-9][0-9.]*)\2:/.exec(lines[index]);
+        if (!entry)
+            continue;
+        entryIndent = entry[1];
+        lastEntry = index;
+        const keyMatch = keyPattern.exec(lines[index]);
+        if (keyMatch) {
+            // Leave the line untouched when the value already matches, and keep any
+            // trailing comment when it does not.
+            const { value, comment } = splitValueAndComment(lines[index].slice(keyMatch[0].length));
+            if (value !== path) {
+                lines[index] = `${keyMatch[1]}${keyMatch[2]}${key}${keyMatch[2]}: ${path}${comment ? ` ${comment.trimStart()}` : ''}`;
+            }
+            return true;
+        }
+    }
+    lines.splice(lastEntry + 1, 0, `${entryIndent}"${key}": ${path}`);
+    return true;
+}
+//# sourceMappingURL=roadmap-source-patch.js.map

package/dist/core/roadmap-source-patch.js.map

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

package/dist/core/roadmap-sources.d.ts

@@ -37,6 +37,13 @@ export interface RoadmapSourceValidationResult {
 }
 export declare class RoadmapSourceError extends Error {
     readonly sourcePath?: string | undefined;
+    /**
+     * True when the failure is a refusal to discard authored content that exists
+     * only in the generated projection. Callers must treat this as fatal rather
+     * than downgrading it to a warning — reporting success while planning work is
+     * destroyed is the whole defect (GH #637).
+     */
+    projectionContentLoss?: boolean;
     constructor(message: string, sourcePath?: string | undefined);
 }
 export declare function normalizeDiagnosticPath(path: string): string;
@@ -47,6 +54,43 @@ export declare function sourceProjectToRoadmap(project: RoadmapSourceProject): P
 /** Compile ordered authoring bundles into the existing roadmap compatibility shape. */
 export declare function compileRoadmapSources(project: RoadmapSourceProject, sources: LoadedRoadmapSource[]): RoadmapDefinition;
 export declare function serializeRoadmapProjection(roadmap: RoadmapDefinition): string;
+/**
+ * Key of the generated-file marker written into the compiled projection.
+ *
+ * The marker exists only in the bytes on disk. `serializeRoadmapProjection`
+ * stays canonical and marker-free, because projection bytes are compared in four
+ * places — compile write, closeout reconciliation, archive planning, and the
+ * migration planner/applier `expected_projection_sha256` pair. Stamping the
+ * marker into those canonical bytes broke migration receipt binding (seven
+ * tests), so it is applied at the write boundary and stripped again on read
+ * (GH #644, deferred from #637).
+ */
+export declare const ROADMAP_PROJECTION_MARKER_KEY = "_generated";
+/** Add the generated-file marker to projection bytes about to be written. */
+export declare function withRoadmapProjectionMarker(projection: string, sourcePath: string): string;
+/**
+ * Remove the generated-file marker so on-disk bytes can be compared against
+ * canonical projection bytes. Returns the input unchanged when no marker exists,
+ * so projections written before this change still compare correctly.
+ */
+export declare function stripRoadmapProjectionMarker(projection: string): string;
+export interface RoadmapProjectionDivergence {
+    /** Sprint ids present in the on-disk projection but produced by no source. */
+    sprints: string[];
+    /** Phase names present in the on-disk projection but produced by no source. */
+    phases: string[];
+}
+/**
+ * Find content that exists only in the checked-out projection.
+ *
+ * A projection that merely lags its sources contains nothing the sources do not
+ * produce, so it is safe to overwrite. Content present *only* on disk is
+ * authored planning work that a blind rewrite would destroy — which is exactly
+ * how a phase, six sprints and 26 tickets were lost on a success exit (GH #637).
+ *
+ * Returns null when nothing would be lost.
+ */
+export declare function findRoadmapProjectionDivergence(existing: string, compiled: RoadmapDefinition): RoadmapProjectionDivergence | null;
 /** Validate source federation invariants before any compatibility write. */
 export declare function validateRoadmapSourceFederation(project: RoadmapSourceProject, sources: LoadedRoadmapSource[]): RoadmapSourceValidationResult;
 //# sourceMappingURL=roadmap-sources.d.ts.map

package/dist/core/roadmap-sources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roadmap-sources.d.ts","sourceRoot":"","sources":["../../src/core/roadmap-sources.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnF,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,GAAG,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,QAAQ,EAAE,4BAA4B,EAAE,CAAC;IACzC,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACN,UAAU,CAAC,EAAE,MAAM,YAAA;CAK/B;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAgB,GAAG,MAAM,CAWtF;AAmDD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,UAAU,SAA8B,GACvC,oBAAoB,CAgDtB;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,qBAAqB,CA2JvB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,aAAa,CAAC,CAKrH;AAqBD,uFAAuF;AACvF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,mBAAmB,EAAE,GAC7B,iBAAiB,CA4BnB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAE7E;AAMD,4EAA4E;AAC5E,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,mBAAmB,EAAE,GAC7B,6BAA6B,CA0J/B"}
+{"version":3,"file":"roadmap-sources.d.ts","sourceRoot":"","sources":["../../src/core/roadmap-sources.ts"],"names":[],"mappings":"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"}