@khoavu882/doflow 2.0.0-beta.3 → 2.0.0-beta.5

package/src/runtime/context/pointer.js

@@ -0,0 +1,142 @@
+'use strict';
+
+// TypeScript migration: run directly by Node native type-stripping.
+const fs = require('node:fs');
+const path = require('node:path');
+const crypto = require('node:crypto');
+
+function sha256(text        )         {
+  return `sha256:${crypto.createHash('sha256').update(text, 'utf8').digest('hex')}`;
+}
+
+function inside(root        , file        , fsImpl = fs)                {
+  const absolute = path.resolve(file);
+  let realRoot        ;
+  let realFile        ;
+  try {
+    realRoot = fsImpl.realpathSync(path.resolve(root));
+    realFile = fsImpl.realpathSync(absolute);
+  } catch { return null; }
+  const relative = path.relative(realRoot, realFile);
+  if (!relative || relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) return null;
+  const normalized = relative.split(path.sep).join('/');
+  if (normalized.split('/').includes('state')) return null;
+  return normalized;
+}
+
+function lineSlice(lines          , startLine        , endLine        )         {
+  return lines.slice(startLine - 1, endLine).join('\n') + '\n';
+}
+
+function rangesFor(file        , text        , requirement         )                                                                        {
+  const lines = text.split(/\r?\n/);
+  const result                                                                        = [];
+  if (requirement) {
+    let section = '';
+    for (let i = 0; i < lines.length; i++) {
+      const heading = lines[i].match(/^##\s+(.*)$/);
+      if (heading) section = heading[1];
+      if (!/^##\s+[34](?:[.)]|\s|$)/.test(lines[i])) continue;
+      let end = i + 1;
+      while (end < lines.length && !/^##\s+/.test(lines[end])) end++;
+      for (let j = i + 1; j < end; j++) {
+        if (!/^\s*\*\*Detail:?\*\*/i.test(lines[j])) continue;
+        let blockEnd = j + 1;
+        while (blockEnd < end && !/^\s*\*\*[A-Za-z][^*]*:?\*\*/.test(lines[blockEnd])) blockEnd++;
+        result.push({ startLine: j + 1, endLine: blockEnd, heading: section || null });
+        j = blockEnd - 1;
+      }
+      i = end - 1;
+    }
+    return result;
+  }
+  let start = -1;
+  let title                = null;
+  const flush = (end        ) => {
+    if (start >= 0 && end >= start) result.push({ startLine: start + 1, endLine: end, heading: title });
+  };
+  for (let i = 0; i < lines.length; i++) {
+    const heading = lines[i].match(/^##\s+(.+)$/);
+    if (heading) {
+      flush(i);
+      start = i;
+      title = heading[1].trim();
+    }
+  }
+  flush(lines.length);
+  return result;
+}
+
+function createPointer({ path: rel, heading, range, slice }     )      {
+  const bytes = Buffer.byteLength(slice, 'utf8');
+  return {
+    id: `ptr:${rel}:${range.startLine}-${range.endLine}`,
+    path: rel,
+    heading,
+    range,
+    digest: sha256(slice),
+    bytes,
+    tokensEst: { value: Math.ceil(bytes / 4), basis: 'estimated:bytes/4' },
+    inlineBytes: Buffer.byteLength(`- ptr:${rel}:${range.startLine}-${range.endLine} ${rel}:${range.startLine}-${range.endLine} ${bytes} B\n`, 'utf8'),
+    load: `read ${rel} lines ${range.startLine}-${range.endLine}`,
+  };
+}
+
+function sourceFiles({ projectRoot, feature, fsImpl = fs }     )                                                    {
+  const root = path.resolve(projectRoot);
+  const featureDir = feature?.featureDir ? path.resolve(feature.featureDir) : null;
+  const candidates                                                    = [];
+  const add = (file                           , requirement = false) => {
+    if (!file) return;
+    const absolute = path.isAbsolute(file) ? file : path.resolve(feature?.repoRoot || root, file);
+    let stat     ;
+    try { stat = fsImpl.statSync(absolute); } catch { return; }
+    if (!inside(root, absolute, fsImpl) || !stat.isFile()) return;
+    if (!candidates.some((item) => item.absolute === absolute)) candidates.push({ absolute, requirement });
+  };
+  if (featureDir) {
+    add(feature.paths?.requirement || path.join(featureDir, 'intention', 'requirement.md'), true);
+    for (const file of [
+      feature.paths?.design,
+      feature.paths?.plan,
+      path.join(featureDir, 'design', 'design.md'),
+      path.join(featureDir, 'design', 'specs.md'),
+      path.join(featureDir, 'design', 'data-model.md'),
+      path.join(featureDir, 'plan', 'plan.md'),
+      path.join(featureDir, 'design.md'),
+      path.join(featureDir, 'plan.md'),
+    ]) add(file);
+  }
+  return candidates;
+}
+
+function collectPointers({ projectRoot, feature, fsImpl = fs }     )        {
+  const root = path.resolve(projectRoot);
+  const pointers        = [];
+  for (const source of sourceFiles({ projectRoot: root, feature, fsImpl })) {
+  const rel = inside(root, source.absolute, fsImpl);
+    if (!rel) continue;
+    let text        ;
+    try { text = fsImpl.readFileSync(source.absolute, 'utf8'); } catch { continue; }
+    const lines = text.split(/\r?\n/);
+    for (const range of rangesFor(rel, text, source.requirement)) {
+      const slice = lineSlice(lines, range.startLine, range.endLine);
+      if (!slice.trim()) continue;
+      pointers.push(createPointer({ path: rel, heading: range.heading, range: { startLine: range.startLine, endLine: range.endLine }, slice }));
+    }
+  }
+  return pointers;
+}
+
+function readPointerSlice({ projectRoot, pointer, fsImpl = fs }     )                                           {
+  const rel = inside(projectRoot, path.resolve(projectRoot, pointer.path), fsImpl);
+  if (!rel || rel !== pointer.path) return null;
+  const file = path.resolve(projectRoot, rel);
+  try {
+    const lines = fsImpl.readFileSync(file, 'utf8').split(/\r?\n/);
+    const slice = lineSlice(lines, pointer.range.startLine, pointer.range.endLine);
+    return { slice, digest: sha256(slice) };
+  } catch { return null; }
+}
+
+module.exports = { collectPointers, createPointer, readPointerSlice, sha256 };