aizuchi 0.4.0 → 0.5.0

package/dist/shared/task-setters.js

@@ -0,0 +1,132 @@
+/**
+ * task frontmatter の 1 フィールドだけを byte 保全で書き換える純関数。
+ * setRelatedDocsInRaw (related-docs.ts) と同じ行差し替え方式を採用する。
+ *
+ * - setDependsOnInRaw: frontmatter の depends_on 配列だけを置換/追加する
+ * - setPriorityInRaw:  frontmatter の priority スカラだけを置換/追加する
+ *
+ * 本文・他フィールド・改行コード・コメントは完全に保全する。
+ * frontmatter が見つからない raw はそのまま返す。
+ */
+// frontmatter 境界: 先頭の `---` 行 (行末空白を許容、parseTaskFile / setRelatedDocsInRaw と同じ規約)
+const FM_OPEN = /^---[ \t]*\r?\n/;
+// 閉じ `---` 行 (行末空白許容)
+const FM_CLOSE = /^---[ \t]*$/;
+// BOM は literal 禁止 (LEARN#13: invisible unicode は \uXXXX escape で書く)
+const BOM = '\uFEFF';
+// ---------------------------------------------------------------------------
+// 内部ユーティリティ
+// ---------------------------------------------------------------------------
+/**
+ * raw から BOM を剥がし、処理後に復元するラッパー。
+ * setRelatedDocsInRaw と同じ規約 (R13-1)。
+ */
+function withBomHandling(raw, fn) {
+    const hasBom = raw.startsWith(BOM);
+    const body = hasBom ? raw.slice(1) : raw;
+    const result = fn(body);
+    return hasBom ? BOM + result : result;
+}
+/**
+ * frontmatter 内の指定 key の行 (flow 1 行 or block 形式 key+続く`- `行) を除去し、
+ * フロントマターの行配列 (開き`---`を除く、閉じ`---`を除く範囲) を返す。
+ * また閉じ `---` のインデックスと全行配列も返す。
+ */
+function parseFrontmatterLines(raw) {
+    if (!FM_OPEN.test(raw))
+        return null;
+    const lines = raw.split('\n');
+    let closeIdx = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (FM_CLOSE.test(lines[i].replace(/\r$/, ''))) {
+            closeIdx = i;
+            break;
+        }
+    }
+    if (closeIdx === -1)
+        return null;
+    return { lines, closeIdx };
+}
+/**
+ * frontmatter 内の指定 key の行 (flow or block) を除去した行配列を返す。
+ * kept は開き `---` の次から closeIdx の手前までの内容 (閉じ `---` は含まない)。
+ */
+function removeKeyLines(lines, closeIdx, key) {
+    const keyPattern = new RegExp(`^${key}\\s*:`);
+    const kept = [];
+    let i = 1;
+    while (i < closeIdx) {
+        const line = lines[i].replace(/\r$/, '');
+        if (keyPattern.test(line)) {
+            i++;
+            // block 形式: 続く `- ` 行も取り除く (ゼロインデントも対象。setRelatedDocsInRaw R13-4 と同方式)
+            while (i < closeIdx && /^\s*-\s/.test(lines[i].replace(/\r$/, '')))
+                i++;
+            continue;
+        }
+        kept.push(lines[i]);
+        i++;
+    }
+    return kept;
+}
+/**
+ * `kept` 行配列にフィールドを挿入し、raw 全体を再組み立てして返す。
+ * 挿入位置: created: 行の直前、なければ末尾 (setRelatedDocsInRaw と同じ規約)。
+ * newLine が null の場合は挿入しない (フィールド除去のみ)。
+ */
+function rebuildRaw(lines, closeIdx, kept, newLine) {
+    if (newLine !== null) {
+        const createdIdx = kept.findIndex((l) => /^created\s*:/.test(l.replace(/\r$/, '')));
+        if (createdIdx !== -1) {
+            kept.splice(createdIdx, 0, newLine);
+        }
+        else {
+            kept.push(newLine);
+        }
+    }
+    const head = [lines[0], ...kept].join('\n');
+    const tail = lines.slice(closeIdx).join('\n');
+    return `${head}\n${tail}`;
+}
+// ---------------------------------------------------------------------------
+// 公開 API
+// ---------------------------------------------------------------------------
+/**
+ * raw (frontmatter + 本文) の depends_on 行を ids で差し替えた raw を返す。
+ * - ids が空: depends_on 行 (flow 1 行 or block 形式) を除去する
+ * - ids が非空: JSON.stringify 済み flow 形式 1 行
+ *   (`depends_on: ["TASK-001", "TASK-002"]`) に置換/挿入する。
+ *   setRelatedDocsInRaw と同じ表現スタイルに統一する (仕様「配列表現は existing に合わせる」)。
+ * - frontmatter が無い raw はそのまま返す
+ */
+export function setDependsOnInRaw(raw, ids) {
+    return withBomHandling(raw, (body) => setDependsOnInner(body, ids));
+}
+function setDependsOnInner(raw, ids) {
+    const parsed = parseFrontmatterLines(raw);
+    if (!parsed)
+        return raw;
+    const { lines, closeIdx } = parsed;
+    const kept = removeKeyLines(lines, closeIdx, 'depends_on');
+    // setRelatedDocsInRaw と同じ JSON.stringify flow 形式 (YAML double-quoted として常に valid)
+    const newLine = ids.length > 0 ? `depends_on: [${ids.map((id) => JSON.stringify(id)).join(', ')}]` : null;
+    return rebuildRaw(lines, closeIdx, kept, newLine);
+}
+/**
+ * raw (frontmatter + 本文) の priority 行を priority で差し替えた raw を返す。
+ * - フィールドが無ければ created: 行の直前 (無ければ閉じ `---` の直前) に追加する
+ * - フィールドが既にあれば値だけ置換する
+ * - frontmatter が無い raw はそのまま返す
+ */
+export function setPriorityInRaw(raw, priority) {
+    return withBomHandling(raw, (body) => setPriorityInner(body, priority));
+}
+function setPriorityInner(raw, priority) {
+    const parsed = parseFrontmatterLines(raw);
+    if (!parsed)
+        return raw;
+    const { lines, closeIdx } = parsed;
+    const kept = removeKeyLines(lines, closeIdx, 'priority');
+    const newLine = `priority: ${priority}`;
+    return rebuildRaw(lines, closeIdx, kept, newLine);
+}