@deftai/directive-core 0.56.1 → 0.56.2

package/dist/content-contracts/standards/_helpers.js

@@ -63,6 +63,10 @@ const SKIP_DIRS = new Set([
     "dist",
     "tests",
     ".deft-cache",
+    // node_modules holds third-party markdown (dependency READMEs) that is not
+    // framework content; scanning it produced volatile, version-pinned cases that
+    // broke CI when dependency versions drifted (#1993 follow-up).
+    "node_modules",
 ]);
 const MIGRATION_ARTIFACT_TREES = ["vbrief/migration"];
 export function isMigrationArtifact(rel) {

package/dist/preflight-cache/evaluate.js

@@ -148,6 +148,32 @@ function metaFetchedAt(metaPath) {
         return null;
     }
 }
+/**
+ * #1991: report whether a cache entry's upstream issue is terminal-closed.
+ *
+ * Reads the sibling raw.json (the cached issue payload) and returns true only
+ * when its `state` is positively "closed". Unknown / missing state returns
+ * false so we never exclude an entry we are not sure about. Closed issues are
+ * terminal: their `fetched_at` age is irrelevant to dispatch-queue freshness,
+ * and `cache:fetch-all --force` (open-only enumeration) can never refresh them,
+ * so the age gate must not wedge on them.
+ */
+function metaEntryIsTerminalClosed(metaPath) {
+    const rawPath = join(metaPath, "..", "raw.json");
+    if (!existsSync(rawPath))
+        return false;
+    try {
+        const raw = JSON.parse(readFileSync(rawPath, "utf8"));
+        if (raw !== null && typeof raw === "object" && !Array.isArray(raw)) {
+            const state = raw.state;
+            return typeof state === "string" && state.toLowerCase() === "closed";
+        }
+    }
+    catch {
+        /* unknown state -> keep in scope */
+    }
+    return false;
+}
 function loadScopeRules(projectRoot) {
     const defPath = join(projectRoot, "vbrief", "PROJECT-DEFINITION.vbrief.json");
     if (!existsSync(defPath))
@@ -398,10 +424,16 @@ export function evaluate(projectRoot, options = {}) {
         allMetaPaths.length > 0 &&
         scopedMetaPaths.length === 0 &&
         candState === "populated";
-    // Step 5: Oldest in-scope entry age + drift probe (#1886)
+    // Step 5: Oldest in-scope entry age + drift probe (#1886).
+    // #1991: judge age over OPEN entries only. Terminal-closed entries are
+    // excluded because `cache:fetch-all --force` (open-only enumeration) can never
+    // refresh their `fetched_at`, so including them would let a stale closed entry
+    // wedge the gate with no working recovery command.
+    const rawCandidatePaths = scopedMetaPaths.length > 0 ? scopedMetaPaths : allMetaPaths;
+    const ageCandidatePaths = rawCandidatePaths.filter((p) => !metaEntryIsTerminalClosed(p));
     let minFetchedAt = null;
     let minMetaPath = null;
-    for (const p of scopedMetaPaths.length > 0 ? scopedMetaPaths : allMetaPaths) {
+    for (const p of ageCandidatePaths) {
         const ts = metaFetchedAt(p);
         if (ts !== null && (minFetchedAt === null || ts < minFetchedAt)) {
             minFetchedAt = ts;
@@ -411,7 +443,11 @@ export function evaluate(projectRoot, options = {}) {
     const now = nowFn();
     const ageMs = minFetchedAt !== null ? now.getTime() - minFetchedAt.getTime() : Infinity;
     const ageH = ageMs / (1000 * 3600);
-    const stale = ageH > maxAgeHours;
+    // When every candidate is terminal-closed (non-empty input, no open entry to
+    // judge) there is nothing open whose age can be stale -> fresh. The truly
+    // empty-cache case (no entries at all) preserves its prior staleness result.
+    const allCandidatesClosed = minFetchedAt === null && rawCandidatePaths.length > 0;
+    const stale = allCandidatesClosed ? false : ageH > maxAgeHours;
     // Step 5b: --allow-stale bypass
     if (stale && allowStale) {
         const warning = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.56.1",
+  "version": "0.56.2",
   "description": "TypeScript engine core for the Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -189,6 +189,10 @@
     "./init-deposit": {
       "types": "./dist/init-deposit/index.d.ts",
       "default": "./dist/init-deposit/index.js"
+    },
+    "./dist/*.js": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
     }
   },
   "files": [
@@ -205,8 +209,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.56.1",
-    "@deftai/directive-types": "^0.56.1"
+    "@deftai/directive-content": "^0.56.2",
+    "@deftai/directive-types": "^0.56.2"
   },
   "scripts": {
     "build": "tsc -b",