@shrkcrft/cli 0.1.0-alpha.21 → 0.1.0-alpha.23

package/dist/status/freshness.js

@@ -0,0 +1,81 @@
+import { readdirSync, statSync } from 'node:fs';
+import * as nodePath from 'node:path';
+/**
+ * Source-mtime freshness — a small shared CLI helper.
+ *
+ * Several `… status` commands (`framework status`, `context status`) need to
+ * answer the same question: "is this stored artefact stale relative to the
+ * source tree it was built from?" They all walk the workspace for the newest
+ * source-file mtime and compare it to a stored build timestamp. This module
+ * is the single home for that walk so the commands stay byte-identical.
+ *
+ * NOTE: this is deliberately CLI-local and distinct from
+ * `@shrkcrft/graph`'s `detectGraphFreshness` — that one models the graph
+ * store's own freshness and graph sits BELOW cli in the layer order, so it
+ * cannot be reused here.
+ */
+export const FRESHNESS_SKIP_DIRS = new Set([
+    'node_modules', 'dist', 'build', 'coverage', '.git', '.sharkcraft',
+    '.next', '.cache', '.tmp-pack', 'out', 'target',
+]);
+export const FRESHNESS_SOURCE_EXTS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.java', '.cs', '.py', '.go', '.rs', '.kt', '.swift',
+]);
+/** Newest source-file mtime (ms) under `root`, ignoring build/output dirs. 0
+ *  when nothing matched. */
+export function newestSourceMtimeMs(root) {
+    let newest = 0;
+    const stack = [root];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries) {
+            if (FRESHNESS_SKIP_DIRS.has(name) || name.startsWith('.'))
+                continue;
+            const full = nodePath.join(dir, name);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                stack.push(full);
+                continue;
+            }
+            if (!st.isFile())
+                continue;
+            if (!FRESHNESS_SOURCE_EXTS.has(nodePath.extname(full).toLowerCase()))
+                continue;
+            if (st.mtimeMs > newest)
+                newest = st.mtimeMs;
+        }
+    }
+    return newest;
+}
+/** Compare a stored build timestamp to the newest source mtime in `scope`.
+ *  `stale` when a source file is newer than the build; `unknown` when the
+ *  build timestamp can't be parsed. */
+export function computeMtimeFreshness(scope, builtAtIso) {
+    const newestMs = newestSourceMtimeMs(scope);
+    const lastChangedAt = newestMs > 0 ? new Date(newestMs).toISOString() : null;
+    const builtMs = builtAtIso ? Date.parse(builtAtIso) : NaN;
+    if (!Number.isFinite(builtMs)) {
+        return { state: 'unknown', lastBuiltAt: builtAtIso ?? null, lastChangedAt, behindMs: 0 };
+    }
+    const behindMs = newestMs > builtMs ? Math.round(newestMs - builtMs) : 0;
+    return {
+        state: behindMs > 0 ? 'stale' : 'fresh',
+        lastBuiltAt: builtAtIso ?? null,
+        lastChangedAt,
+        behindMs,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/cli",
-  "version": "0.1.0-alpha.21",
+  "version": "0.1.0-alpha.23",
   "description": "SharkCraft CLI (`shrk`): structured project intelligence for AI coding agents.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -47,38 +47,38 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.21",
-    "@shrkcrft/compress": "^0.1.0-alpha.21",
-    "@shrkcrft/config": "^0.1.0-alpha.21",
-    "@shrkcrft/workspace": "^0.1.0-alpha.21",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.21",
-    "@shrkcrft/context": "^0.1.0-alpha.21",
-    "@shrkcrft/rules": "^0.1.0-alpha.21",
-    "@shrkcrft/paths": "^0.1.0-alpha.21",
-    "@shrkcrft/templates": "^0.1.0-alpha.21",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.21",
-    "@shrkcrft/dashboard": "^0.1.0-alpha.21",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.21",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.21",
-    "@shrkcrft/presets": "^0.1.0-alpha.21",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.21",
-    "@shrkcrft/graph": "^0.1.0-alpha.21",
-    "@shrkcrft/rule-graph": "^0.1.0-alpha.21",
-    "@shrkcrft/structural-search": "^0.1.0-alpha.21",
-    "@shrkcrft/impact-engine": "^0.1.0-alpha.21",
-    "@shrkcrft/context-planner": "^0.1.0-alpha.21",
-    "@shrkcrft/architecture-guard": "^0.1.0-alpha.21",
-    "@shrkcrft/framework-scanners": "^0.1.0-alpha.21",
-    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.21",
-    "@shrkcrft/quality-gates": "^0.1.0-alpha.21",
-    "@shrkcrft/migrate": "^0.1.0-alpha.21",
-    "@shrkcrft/generator": "^0.1.0-alpha.21",
-    "@shrkcrft/importer": "^0.1.0-alpha.21",
-    "@shrkcrft/inspector": "^0.1.0-alpha.21",
-    "@shrkcrft/ai": "^0.1.0-alpha.21",
-    "@shrkcrft/embeddings": "^0.1.0-alpha.21",
-    "@shrkcrft/shared": "^0.1.0-alpha.21",
-    "@shrkcrft/mcp-server": "^0.1.0-alpha.21",
+    "@shrkcrft/core": "^0.1.0-alpha.23",
+    "@shrkcrft/compress": "^0.1.0-alpha.23",
+    "@shrkcrft/config": "^0.1.0-alpha.23",
+    "@shrkcrft/workspace": "^0.1.0-alpha.23",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.23",
+    "@shrkcrft/context": "^0.1.0-alpha.23",
+    "@shrkcrft/rules": "^0.1.0-alpha.23",
+    "@shrkcrft/paths": "^0.1.0-alpha.23",
+    "@shrkcrft/templates": "^0.1.0-alpha.23",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.23",
+    "@shrkcrft/dashboard": "^0.1.0-alpha.23",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.23",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.23",
+    "@shrkcrft/presets": "^0.1.0-alpha.23",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.23",
+    "@shrkcrft/graph": "^0.1.0-alpha.23",
+    "@shrkcrft/rule-graph": "^0.1.0-alpha.23",
+    "@shrkcrft/structural-search": "^0.1.0-alpha.23",
+    "@shrkcrft/impact-engine": "^0.1.0-alpha.23",
+    "@shrkcrft/context-planner": "^0.1.0-alpha.23",
+    "@shrkcrft/architecture-guard": "^0.1.0-alpha.23",
+    "@shrkcrft/framework-scanners": "^0.1.0-alpha.23",
+    "@shrkcrft/api-surface-diff": "^0.1.0-alpha.23",
+    "@shrkcrft/quality-gates": "^0.1.0-alpha.23",
+    "@shrkcrft/migrate": "^0.1.0-alpha.23",
+    "@shrkcrft/generator": "^0.1.0-alpha.23",
+    "@shrkcrft/importer": "^0.1.0-alpha.23",
+    "@shrkcrft/inspector": "^0.1.0-alpha.23",
+    "@shrkcrft/ai": "^0.1.0-alpha.23",
+    "@shrkcrft/embeddings": "^0.1.0-alpha.23",
+    "@shrkcrft/shared": "^0.1.0-alpha.23",
+    "@shrkcrft/mcp-server": "^0.1.0-alpha.23",
     "@huggingface/transformers": "^3.7.5"
   },
   "publishConfig": {