@atedone/workspace-context 0.0.3 → 0.0.4

package/README.md

@@ -2,4 +2,4 @@
 
 Workspace context initialization helper for JavaScript tools.
 
-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.
+The package initializes `.workspace-context/state.json` when loaded and exposes a workspace routine descriptor for callers that coordinate context snapshot refreshes.

package/index.js

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

package/lib/{prepare.js → snapshot.js}

@@ -5,25 +5,38 @@ const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 const manifest = require('../package.json');
 
-const markerFileName = 'prepare.json';
+const markerFileName = 'snapshot.json';
 const stateDirectoryName = '.workspace-context';
 
 function readEnvironment() {
   return Reflect.get(platform, 'env') || {};
 }
 
-function resolveProjectRoot(env = readEnvironment(), cwd = platform.cwd()) {
+function resolveProjectRoot(
+  candidate = platform.argv[2],
+  env = readEnvironment(),
+  cwd = platform.cwd()
+) {
+  if (typeof candidate === 'string' && candidate.trim()) {
+    return candidate.trim();
+  }
+
   const initCwd = typeof env.INIT_CWD === 'string' ? env.INIT_CWD.trim() : '';
   return initCwd || cwd;
 }
 
-function writeMarker({ projectRoot = resolveProjectRoot(), now = () => new Date().toISOString() } = {}) {
+function writeSnapshot({
+  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'
+    mode: 'runtime-task',
+    processId: platform.pid,
+    parentProcessId: platform.ppid
   };
 
   file.mkdirSync(route.dirname(markerPath), { recursive: true });
@@ -36,7 +49,7 @@ function writeMarker({ projectRoot = resolveProjectRoot(), now = () => new Date(
 }
 
 if (require.main === module) {
-  writeMarker();
+  writeSnapshot();
 }
 
 module.exports = {
@@ -44,5 +57,5 @@ module.exports = {
   readEnvironment,
   resolveProjectRoot,
   stateDirectoryName,
-  writeMarker
+  writeSnapshot
 };

package/lib/state.js

@@ -5,7 +5,8 @@ const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 const manifest = require('../package.json');
 
-const lifecycleScriptName = 'prepare';
+const routineName = 'workspace-context:snapshot';
+const snapshotFileName = 'snapshot.js';
 const stateDirectoryName = '.workspace-context';
 const stateFileName = 'state.json';
 
@@ -23,63 +24,20 @@ function buildState({ now = () => new Date().toISOString() } = {}) {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-manifest'
+    mode: 'runtime-task'
   };
 }
 
-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
-  };
+function getWorkspaceRoutines({
+  projectRoot = resolveProjectRoot()
+} = {}) {
+  return [{
+    name: routineName,
+    runtime: platform.execPath,
+    entrypoint: route.join(__dirname, snapshotFileName),
+    arguments: [projectRoot],
+    workingDirectory: projectRoot
+  }];
 }
 
 function initialize({
@@ -96,18 +54,17 @@ function initialize({
     projectRoot,
     statePath,
     state: value,
-    projectManifest: syncProjectManifest({ projectRoot })
+    workspaceRoutines: getWorkspaceRoutines({ projectRoot })
   };
 }
 
 module.exports = {
-  buildLifecycleCommand,
   buildState,
+  getWorkspaceRoutines,
   initialize,
-  lifecycleScriptName,
   readEnvironment,
   resolveProjectRoot,
+  routineName,
   stateDirectoryName,
-  stateFileName,
-  syncProjectManifest
+  stateFileName
 };

package/package.json

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