android2harmony 0.1.6 → 0.1.8

package/skills/a2h-app-req-gen/scripts/reqgen/src/agent-render/gap-audit-link.js

@@ -0,0 +1,62 @@
+const linkedStatuses = new Set(["unresolved", "limited"]);
+function addToBucket(buckets, ownerId, candidate) {
+  const bucket = buckets.get(ownerId) ?? new Map();
+  bucket.set(candidate.id, candidate);
+  buckets.set(ownerId, bucket);
+}
+function toReadonlyMap(buckets) {
+  return new Map(
+    [...buckets].map(([ownerId, bucket]) => [ownerId, [...bucket.values()]]),
+  );
+}
+/**
+ * Pure derivation, no IO: for each unresolved/limited gap-audit candidate,
+ * each of its normalizedFactRefs is checked against the Feature it belongs
+ * to first (`## unresolved` in agent-render/prompt.ts), and only falls back
+ * to the owning Area when that ref hits no Feature's supportRefs — an
+ * Area's supportRefs is a superset that already includes every one of its
+ * Features' facts (see src/analysis/req-model/build.ts), so a fact that
+ * reaches this fallback is necessarily Area-own (component/container-
+ * binding), never a Feature fact this loop simply hasn't visited yet.
+ */
+export function linkGapAuditToReqModel(reqModel, gapAudit) {
+  const factToFeatures = new Map();
+  const factToAreas = new Map();
+  for (const area of reqModel.areas) {
+    for (const factRef of area.supportRefs) {
+      const owners = factToAreas.get(factRef) ?? new Set();
+      owners.add(area.id);
+      factToAreas.set(factRef, owners);
+    }
+    for (const feature of area.features) {
+      for (const factRef of feature.supportRefs) {
+        const owners = factToFeatures.get(factRef) ?? new Set();
+        owners.add(feature.id);
+        factToFeatures.set(factRef, owners);
+      }
+    }
+  }
+  const byFeature = new Map();
+  const byArea = new Map();
+  const candidates = gapAudit.categories.flatMap(
+    (category) => category.candidates,
+  );
+  for (const candidate of candidates) {
+    if (!linkedStatuses.has(candidate.status)) continue;
+    for (const factRef of candidate.normalizedFactRefs) {
+      const featureIds = factToFeatures.get(factRef);
+      if (featureIds !== undefined && featureIds.size > 0) {
+        for (const featureId of featureIds)
+          addToBucket(byFeature, featureId, candidate);
+        continue;
+      }
+      const areaIds = factToAreas.get(factRef);
+      if (areaIds === undefined) continue;
+      for (const areaId of areaIds) addToBucket(byArea, areaId, candidate);
+    }
+  }
+  return {
+    byFeature: toReadonlyMap(byFeature),
+    byArea: toReadonlyMap(byArea),
+  };
+}

package/skills/a2h-app-req-gen/scripts/reqgen/src/agent-render/index.js

@@ -0,0 +1,66 @@
+export {
+  createCommandBackend,
+  createOpencodeBackend,
+  extractSessionId,
+  spawnAsync,
+} from "./backend.js";
+export { extractJsonBlock, repairUnescapedQuotes } from "./output-parse.js";
+export {
+  buildAreaExpected,
+  buildAreaInputMd,
+  buildAreaTaskMdForSubagent,
+  buildFeatureExpected,
+  buildInputMd,
+  buildTaskMdForSubagent,
+  featureTitleParts,
+} from "./prompt.js";
+export { linkGapAuditToReqModel } from "./gap-audit-link.js";
+export {
+  buildNameTraceLookup,
+  nameTraceKey,
+  renderCitationSeed,
+  renderNameTraceSection,
+  renderTitleHint,
+} from "./name-trace.js";
+export {
+  validateCitations,
+  validateRestatedFacts,
+  validateTitle,
+} from "./validate.js";
+export {
+  areaDirFor,
+  defaultCheckScriptPath,
+  expandAreaRenderItems,
+  expandRenderItems,
+  extractToolCalls,
+  prepareAreaInputs,
+  prepareFeatureInputs,
+  renderAllAreas,
+  renderAllAreasUnified,
+  renderAllFeatures,
+  renderAllFeaturesUnified,
+  renderAreaToDisk,
+  renderAreaUnified,
+  renderDirFor,
+  renderFeatureToDisk,
+  renderFeatureUnified,
+  runPool,
+} from "./orchestrate.js";
+export {
+  mergeAreaReqContents,
+  mergeAreaReqText,
+  mergeAreaReqTxt,
+  mergeReqContents,
+  mergeReqText,
+  mergeReqTxt,
+  stripLeadingTitle,
+} from "./merge.js";
+export {
+  readAreaAttempt,
+  readAttempt,
+  snapshotAreaReq,
+  snapshotAreaReqTxt,
+  snapshotReq,
+  snapshotReqTxt,
+} from "./snapshot.js";
+export { parseAgentArguments, runAgentStage2 } from "./cli.js";