@opengsd/gsd-core 1.3.0-rc.1 → 1.3.0

package/{get-shit-done → gsd-core}/bin/lib/configuration.cjs

@@ -1,78 +1,85 @@
-'use strict';
-
+"use strict";
 /**
  * Configuration Module — single source of truth for config loading,
  * legacy-key normalization, defaults merge, and explicit on-disk migration.
+ *
+ * ADR-457 build-at-publish: the hand-written bin/lib/configuration.cjs collapsed
+ * to a TypeScript source of truth. Behaviour is preserved byte-for-behaviour
+ * from the prior hand-written .cjs; only types are added.
  */
-
-const { readFileSync, writeFileSync, existsSync, readdirSync } = require('node:fs');
-const { join } = require('node:path');
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DYNAMIC_KEY_PATTERNS = exports.RUNTIME_STATE_KEYS = exports.VALID_CONFIG_KEYS = exports.CONFIG_DEFAULTS = void 0;
+exports.loadConfig = loadConfig;
+exports.normalizeLegacyKeys = normalizeLegacyKeys;
+exports.mergeDefaults = mergeDefaults;
+exports.migrateOnDisk = migrateOnDisk;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// In .cts (CommonJS output) files, `require` is available as a global.
+const _require = require;
 // ─── Manifest requires ───────────────────────────────────────────────────────
 function loadConfigurationManifest(fileName) {
-  const candidates = [
-    // Installed runtime layout: get-shit-done/bin/shared/*.manifest.json
-    join(__dirname, '..', 'shared', fileName),
-    // Source-repo dev layout: sdk/shared/*.manifest.json
-    join(__dirname, '..', '..', '..', 'sdk', 'shared', fileName),
-  ];
-  let lastErr = null;
-  for (const candidate of candidates) {
-    try {
-      return require(candidate);
-    } catch (err) {
-      const isMissingCandidate =
-        err && err.code === 'MODULE_NOT_FOUND' && String(err.message || '').includes(candidate);
-      if (!isMissingCandidate) throw err;
-      lastErr = err;
-    }
-  }
-  throw new Error(
-    `${fileName} not found. Tried:\n${candidates.map((p) => `  ${p}`).join('\n')}\nLast error: ${lastErr?.message}`
-  );
+    const candidates = [
+        // Installed runtime layout: gsd-core/bin/shared/*.manifest.json
+        (0, node_path_1.join)(__dirname, '..', 'shared', fileName),
+    ];
+    let lastErr = null;
+    for (const candidate of candidates) {
+        try {
+            return _require(candidate);
+        }
+        catch (err) {
+            const e = err;
+            const isMissingCandidate = e && e.code === 'MODULE_NOT_FOUND' && String(e.message || '').includes(candidate);
+            if (!isMissingCandidate)
+                throw err;
+            lastErr = e;
+        }
+    }
+    throw new Error(`${fileName} not found. Tried:\n${candidates.map((p) => `  ${p}`).join('\n')}\nLast error: ${lastErr?.message}`);
 }
-
 const CONFIG_DEFAULTS = loadConfigurationManifest('config-defaults.manifest.json');
+exports.CONFIG_DEFAULTS = CONFIG_DEFAULTS;
 const SCHEMA_MANIFEST = loadConfigurationManifest('config-schema.manifest.json');
 const VALID_CONFIG_KEYS = new Set(SCHEMA_MANIFEST.validKeys);
+exports.VALID_CONFIG_KEYS = VALID_CONFIG_KEYS;
 const RUNTIME_STATE_KEYS = new Set(SCHEMA_MANIFEST.runtimeStateKeys);
+exports.RUNTIME_STATE_KEYS = RUNTIME_STATE_KEYS;
 const DYNAMIC_KEY_PATTERNS = SCHEMA_MANIFEST.dynamicKeyPatterns.map((p) => {
-  const pattern = new RegExp(p.source);
-  return {
-    ...p,
-    test: (key) => {
-      pattern.lastIndex = 0;
-      return pattern.test(key);
-    },
-  };
+    const pattern = new RegExp(p.source);
+    return {
+        ...p,
+        test: (key) => {
+            pattern.lastIndex = 0;
+            return pattern.test(key);
+        },
+    };
 });
-
+exports.DYNAMIC_KEY_PATTERNS = DYNAMIC_KEY_PATTERNS;
 // ─── Depth → Granularity mapping ─────────────────────────────────────────────
 const DEPTH_TO_GRANULARITY = {
     quick: 'coarse',
     standard: 'standard',
     comprehensive: 'fine',
 };
-
 // ─── Internal helpers ─────────────────────────────────────────────────────────
 function planningDir(cwd, workstream) {
     if (!workstream)
-        return join(cwd, '.planning');
-    return join(cwd, '.planning', 'workstreams', workstream);
+        return (0, node_path_1.join)(cwd, '.planning');
+    return (0, node_path_1.join)(cwd, '.planning', 'workstreams', workstream);
 }
-
 function detectSubRepos(cwd) {
     const results = [];
     try {
-        const entries = readdirSync(cwd, { withFileTypes: true });
+        const entries = (0, node_fs_1.readdirSync)(cwd, { withFileTypes: true });
         for (const entry of entries) {
             if (!entry.isDirectory())
                 continue;
             if (entry.name.startsWith('.') || entry.name === 'node_modules')
                 continue;
-            const gitPath = join(cwd, entry.name, '.git');
+            const gitPath = (0, node_path_1.join)(cwd, entry.name, '.git');
             try {
-                if (existsSync(gitPath)) {
+                if ((0, node_fs_1.existsSync)(gitPath)) {
                     results.push(entry.name);
                 }
             }
@@ -82,7 +89,6 @@ function detectSubRepos(cwd) {
     catch { /* ignore */ }
     return results.sort();
 }
-
 function deepMergeConfig(base, overlay) {
     const result = { ...base };
     for (const key of Object.keys(overlay)) {
@@ -102,66 +108,63 @@ function deepMergeConfig(base, overlay) {
     }
     return result;
 }
-
 // ─── Exported functions ───────────────────────────────────────────────────────
 function normalizeLegacyKeys(parsed) {
     const result = { ...parsed };
     const normalizations = [];
     // 1. branching_strategy → git.branching_strategy
     if (Object.prototype.hasOwnProperty.call(result, 'branching_strategy')) {
-        const value = result.branching_strategy;
-        const git = result.git ?? {};
-        if (git.branching_strategy === undefined) {
-            result.git = { ...git, branching_strategy: value };
+        const value = result['branching_strategy'];
+        const git = (result['git'] ?? {});
+        if (git['branching_strategy'] === undefined) {
+            result['git'] = { ...git, branching_strategy: value };
         }
         else {
             // canonical nested wins — just delete the stale top-level
-            result.git = { ...git };
+            result['git'] = { ...git };
         }
-        delete result.branching_strategy;
+        delete result['branching_strategy'];
         normalizations.push({ from: 'branching_strategy', to: 'git.branching_strategy', value });
     }
     // 2. top-level sub_repos → planning.sub_repos
     if (Object.prototype.hasOwnProperty.call(result, 'sub_repos')) {
-        const value = result.sub_repos;
-        const planning = result.planning ?? {};
-        if (planning.sub_repos === undefined) {
-            result.planning = { ...planning, sub_repos: value };
+        const value = result['sub_repos'];
+        const planning = (result['planning'] ?? {});
+        if (planning['sub_repos'] === undefined) {
+            result['planning'] = { ...planning, sub_repos: value };
         }
         else {
             // canonical nested wins — just drop the stale top-level
-            result.planning = { ...planning };
+            result['planning'] = { ...planning };
         }
-        delete result.sub_repos;
+        delete result['sub_repos'];
         normalizations.push({ from: 'sub_repos', to: 'planning.sub_repos', value });
     }
     // 3. multiRepo: true → marker (filesystem detection deferred to migrateOnDisk / caller)
-    if (result.multiRepo === true) {
-        delete result.multiRepo;
+    if (result['multiRepo'] === true) {
+        delete result['multiRepo'];
         normalizations.push({ from: 'multiRepo', to: 'planning.sub_repos', value: true, requiresFilesystem: true });
     }
     // 4. top-level depth → granularity
     if (Object.prototype.hasOwnProperty.call(result, 'depth') && !Object.prototype.hasOwnProperty.call(result, 'granularity')) {
-        const rawDepth = result.depth;
+        const rawDepth = result['depth'];
         const mapped = DEPTH_TO_GRANULARITY[rawDepth] ?? rawDepth;
-        result.granularity = mapped;
-        delete result.depth;
+        result['granularity'] = mapped;
+        delete result['depth'];
         normalizations.push({ from: 'depth', to: 'granularity', value: mapped });
     }
     return { parsed: result, normalizations };
 }
-
 function mergeDefaults(parsed) {
     // Start with a deep clone of defaults, then overlay parsed
     const defaults = structuredClone(CONFIG_DEFAULTS);
     return deepMergeConfig(defaults, parsed);
 }
-
-async function loadConfig(cwd, options) {
-    const configPath = join(planningDir(cwd, options?.workstream), 'config.json');
+function loadConfig(cwd, options) {
+    const configPath = (0, node_path_1.join)(planningDir(cwd, options?.workstream), 'config.json');
     let raw;
     try {
-        raw = readFileSync(configPath, 'utf-8');
+        raw = (0, node_fs_1.readFileSync)(configPath, 'utf-8');
     }
     catch {
         // File missing — return defaults
@@ -188,12 +191,11 @@ async function loadConfig(cwd, options) {
     }
     return mergeDefaults(normalized);
 }
-
-async function migrateOnDisk(cwd, workstream) {
-    const configPath = join(planningDir(cwd, workstream), 'config.json');
+function migrateOnDisk(cwd, workstream) {
+    const configPath = (0, node_path_1.join)(planningDir(cwd, workstream), 'config.json');
     let raw;
     try {
-        raw = readFileSync(configPath, 'utf-8');
+        raw = (0, node_fs_1.readFileSync)(configPath, 'utf-8');
     }
     catch {
         // File missing — nothing to migrate
@@ -221,13 +223,13 @@ async function migrateOnDisk(cwd, workstream) {
         if (norm.requiresFilesystem) {
             const detected = detectSubRepos(cwd);
             if (detected.length > 0) {
-                const planning = result.planning ?? {};
-                result.planning = { ...planning, sub_repos: detected, commit_docs: false };
+                const planning = (result['planning'] ?? {});
+                result['planning'] = { ...planning, sub_repos: detected, commit_docs: false };
             }
         }
     }
     try {
-        writeFileSync(configPath, JSON.stringify(result, null, 2));
+        (0, node_fs_1.writeFileSync)(configPath, JSON.stringify(result, null, 2));
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
@@ -235,14 +237,3 @@ async function migrateOnDisk(cwd, workstream) {
     }
     return { migrated: true, normalizations, wrote: configPath };
 }
-
-module.exports = {
-  loadConfig,
-  normalizeLegacyKeys,
-  mergeDefaults,
-  migrateOnDisk,
-  CONFIG_DEFAULTS,
-  VALID_CONFIG_KEYS,
-  RUNTIME_STATE_KEYS,
-  DYNAMIC_KEY_PATTERNS,
-};

package/gsd-core/bin/lib/context-utilization.cjs

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Context-utilization classifier for `gsd-health --context` (ADR-457
+ * build-at-publish: the hand-written bin/lib/context-utilization.cjs collapsed
+ * to a TypeScript source of truth). Behaviour is preserved byte-for-behaviour
+ * from the prior hand-written .cjs; only types are added.
+ *
+ * Pure function. Callers pass tokensUsed + contextWindow; the
+ * classifier returns the percent and one of three states. Recommendation
+ * strings are NOT in this module — formatting is the renderer's job
+ * (see `validate context` in gsd-tools.cjs). That separation lets the
+ * copy change without touching this module's tests.
+ *
+ * Thresholds:
+ *   < 60%   healthy   no action
+ *   60–70%  warning   approaching the fracture zone
+ *   ≥ 70%   critical  reasoning quality may degrade
+ *
+ * State boundaries use the exact ratio. The displayed `percent` is
+ * rounded for human reading and may differ from the boundary by ±1 in
+ * edge cases (e.g. 59.999% displays as 60 but classifies as healthy).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STATES = void 0;
+exports.classifyContextUtilization = classifyContextUtilization;
+exports.STATES = Object.freeze({
+    HEALTHY: 'healthy',
+    WARNING: 'warning',
+    CRITICAL: 'critical',
+});
+function classifyContextUtilization(tokensUsed, contextWindow) {
+    if (!Number.isInteger(tokensUsed) || tokensUsed < 0) {
+        throw new TypeError(`tokensUsed must be a non-negative integer, got: ${tokensUsed} (${typeof tokensUsed})`);
+    }
+    if (!Number.isInteger(contextWindow) || contextWindow <= 0) {
+        throw new TypeError(`contextWindow must be a positive integer, got: ${contextWindow} (${typeof contextWindow})`);
+    }
+    const ratio = Math.min(tokensUsed / contextWindow, 1);
+    const percent = Math.min(Math.round(ratio * 100), 100);
+    let state;
+    if (ratio < 0.60)
+        state = exports.STATES.HEALTHY;
+    else if (ratio < 0.70)
+        state = exports.STATES.WARNING;
+    else
+        state = exports.STATES.CRITICAL;
+    return { percent, state };
+}