loopforge 2.7.0 → 3.0.0

package/loopforge-policy.json

@@ -0,0 +1,340 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://loopforge.dev/loopforge-policy.json",
+  "title": "LoopForge Policy",
+  "description": "Stable configuration contract for loop_policy.json.",
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string"
+    },
+    "constraints": {
+      "type": "object",
+      "properties": {},
+      "required": [],
+      "additionalProperties": false
+    },
+    "summary": {
+      "type": "object",
+      "properties": {
+        "window": {
+          "type": "number"
+        },
+        "health_check_interval": {
+          "type": "number"
+        },
+        "milestone_interval": {
+          "type": "number"
+        },
+        "max_milestones": {
+          "type": "number"
+        },
+        "enable_loop_synthesis": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "window",
+        "health_check_interval",
+        "milestone_interval",
+        "max_milestones",
+        "enable_loop_synthesis"
+      ],
+      "additionalProperties": false
+    },
+    "engine": {
+      "type": "object",
+      "properties": {
+        "max_circuit_breaker": {
+          "type": "number"
+        },
+        "max_rounds": {
+          "type": "number"
+        },
+        "enforcement_escalation_enabled": {
+          "type": "boolean"
+        },
+        "backtrack_enabled": {
+          "type": "boolean"
+        },
+        "backtrack_max_depth": {
+          "type": "number"
+        },
+        "backtrack_preserve_discoveries": {
+          "type": "boolean"
+        },
+        "drift_clarification_max_streak": {
+          "type": "number"
+        },
+        "max_rejections": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "max_circuit_breaker",
+        "max_rounds",
+        "enforcement_escalation_enabled",
+        "backtrack_enabled",
+        "backtrack_max_depth",
+        "backtrack_preserve_discoveries",
+        "drift_clarification_max_streak",
+        "max_rejections"
+      ],
+      "additionalProperties": false
+    },
+    "prompt": {
+      "type": "object",
+      "properties": {
+        "injection_mode": {
+          "type": "string"
+        },
+        "full_refresh_interval": {
+          "type": "number"
+        },
+        "adaptive_refresh": {
+          "type": "boolean"
+        },
+        "max_l1_streak": {
+          "type": "number"
+        },
+        "stale_round_threshold": {
+          "type": "number"
+        },
+        "min_meaningful_sections": {
+          "type": "number"
+        },
+        "l0_max_chars": {
+          "type": "number"
+        },
+        "l1_max_chars": {
+          "type": "number"
+        },
+        "l2_max_chars": {
+          "type": "number"
+        },
+        "l2_adaptive_enabled": {
+          "type": "boolean"
+        },
+        "l2_adaptive_round_factor": {
+          "type": "number"
+        },
+        "l2_adaptive_milestone_factor": {
+          "type": "number"
+        },
+        "l2_adaptive_max_chars": {
+          "type": "number"
+        },
+        "l2_adaptive_subgoal_factor": {
+          "type": "number"
+        },
+        "l2_pointer_enabled": {
+          "type": "boolean"
+        },
+        "max_emphasize_l2": {
+          "type": "number"
+        },
+        "max_emphasize_l1": {
+          "type": "number"
+        },
+        "max_expand_l1": {
+          "type": "number"
+        },
+        "max_confusion_points": {
+          "type": "number"
+        },
+        "base_prompt_version": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "injection_mode",
+        "full_refresh_interval",
+        "adaptive_refresh",
+        "max_l1_streak",
+        "stale_round_threshold",
+        "min_meaningful_sections",
+        "l0_max_chars",
+        "l1_max_chars",
+        "l2_max_chars",
+        "l2_adaptive_enabled",
+        "l2_adaptive_round_factor",
+        "l2_adaptive_milestone_factor",
+        "l2_adaptive_max_chars",
+        "l2_adaptive_subgoal_factor",
+        "l2_pointer_enabled",
+        "max_emphasize_l2",
+        "max_emphasize_l1",
+        "max_expand_l1",
+        "max_confusion_points",
+        "base_prompt_version"
+      ],
+      "additionalProperties": false
+    },
+    "backend": {
+      "type": "object",
+      "properties": {
+        "root_dir": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "root_dir"
+      ],
+      "additionalProperties": false
+    },
+    "evolution": {
+      "type": "object",
+      "properties": {
+        "max_discovered_constraints_per_round": {
+          "type": "number"
+        },
+        "max_active_constraints": {
+          "type": "number"
+        },
+        "max_objective_versions": {
+          "type": "number"
+        },
+        "failed_pattern_match_threshold": {
+          "type": "number"
+        },
+        "intent_drift_threshold": {
+          "type": "number"
+        },
+        "criteria_dedup_threshold": {
+          "type": "number"
+        },
+        "subgoal_dedup_threshold": {
+          "type": "number"
+        },
+        "subgoal_match_threshold": {
+          "type": "number"
+        },
+        "subgoal_auto_complete_threshold": {
+          "type": "number"
+        },
+        "constraint_match_threshold": {
+          "type": "number"
+        },
+        "subgoal_drift_alignment_threshold": {
+          "type": "number"
+        },
+        "max_subgoals_in_prompt": {
+          "type": "number"
+        },
+        "max_done_subgoals_in_prompt": {
+          "type": "number"
+        },
+        "constraint_inactive_rounds": {
+          "type": "number"
+        },
+        "constraint_id_enabled": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "max_discovered_constraints_per_round",
+        "max_active_constraints",
+        "max_objective_versions",
+        "failed_pattern_match_threshold",
+        "intent_drift_threshold",
+        "criteria_dedup_threshold",
+        "subgoal_dedup_threshold",
+        "subgoal_match_threshold",
+        "subgoal_auto_complete_threshold",
+        "constraint_match_threshold",
+        "subgoal_drift_alignment_threshold",
+        "max_subgoals_in_prompt",
+        "max_done_subgoals_in_prompt",
+        "constraint_inactive_rounds",
+        "constraint_id_enabled"
+      ],
+      "additionalProperties": false
+    },
+    "checkpoint": {
+      "type": "object",
+      "properties": {
+        "max_carried_constraints": {
+          "type": "number"
+        },
+        "outcome_max_chars": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "max_carried_constraints",
+        "outcome_max_chars"
+      ],
+      "additionalProperties": false
+    },
+    "state_file": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "directory": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "enabled",
+        "directory"
+      ],
+      "additionalProperties": false
+    },
+    "evidence": {
+      "type": "object",
+      "properties": {
+        "providers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "timeout_ms": {
+          "type": "number"
+        },
+        "commands": {
+          "type": "array",
+          "items": {}
+        }
+      },
+      "required": [
+        "providers",
+        "timeout_ms",
+        "commands"
+      ],
+      "additionalProperties": false
+    },
+    "mcp": {
+      "type": "object",
+      "properties": {
+        "session_lease_ms": {
+          "type": "number"
+        },
+        "session_lease_renew_interval_ms": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "session_lease_ms",
+        "session_lease_renew_interval_ms"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "version",
+    "constraints",
+    "summary",
+    "engine",
+    "prompt",
+    "backend",
+    "evolution",
+    "checkpoint",
+    "state_file",
+    "evidence",
+    "mcp"
+  ],
+  "additionalProperties": false
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "loopforge",
-  "version": "2.7.0",
-  "description": "Durable cognitive infrastructure for multi-session AI coding tasks — hierarchical summaries, structured sub-goal tracking, time-aware constraint decay, and adaptive prompt budgets for 100+ round agent loops.",
+  "version": "3.0.0",
+  "description": "External cognitive infrastructure for AI coding agents — breaks the summary cascade, provides independent verification, and enables model-directed prompt prioritization for 100+ round agent loops.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,15 +31,21 @@
     "!dist/tests/",
     "skills",
     "loop_policy.json",
+    "loopforge-policy.json",
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc && node dist/generate-schema.js",
-    "generate-schema": "tsc && node dist/generate-schema.js",
-    "test": "tsc && node dist/generate-schema.js && node --test --test-concurrency=1 dist/tests/*.test.js",
-    "test:watch": "tsc && node --test --watch dist/tests/*.test.js",
+    "build": "npm run clean:dist && tsc && node dist/generate-schema.js",
+    "generate-schema": "npm run clean:dist && tsc && node dist/generate-schema.js",
+    "test": "npm run clean:dist && tsc && node dist/generate-schema.js && node --test --test-concurrency=1 dist/tests/*.test.js",
+    "test:watch": "npm run clean:dist && tsc && node --test --watch dist/tests/*.test.js",
+    "test:long-horizon": "npm run clean:dist && tsc && node --test --test-concurrency=1 dist/tests/long-horizon-reconstruction.test.js",
+    "clean:dist": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
     "check": "tsc --noEmit",
-    "prepack": "npm run build"
+    "check:hygiene": "node scripts/check-repository-hygiene.mjs",
+    "verify:artifacts": "node scripts/verify-artifacts.mjs",
+    "release:check": "npm run check && npm run check:hygiene && npm test && npm run verify:artifacts && npm --cache ../.npm-cache pack --dry-run --json --ignore-scripts",
+    "prepack": "npm run verify:artifacts && npm run build"
   },
   "repository": {
     "type": "git",