@atedone/workspace-context 0.0.2 → 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 looks for an optional `workspace.context.js` file in the project root. When present, the file can export an `initialize` hook to extend workspace context setup.
+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,
-  configFileName: state.configFileName,
+  getWorkspaceRoutines: state.getWorkspaceRoutines,
+  routineName: state.routineName,
   stateDirectoryName: state.stateDirectoryName,
   stateFileName: state.stateFileName
 };

package/lib/snapshot.js

@@ -0,0 +1,61 @@
+'use strict';
+
+const platform = process;
+const file = platform.getBuiltinModule('fs');
+const route = platform.getBuiltinModule('path');
+const manifest = require('../package.json');
+
+const markerFileName = 'snapshot.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();
+  }
+
+  const initCwd = typeof env.INIT_CWD === 'string' ? env.INIT_CWD.trim() : '';
+  return initCwd || cwd;
+}
+
+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: 'runtime-task',
+    processId: platform.pid,
+    parentProcessId: platform.ppid
+  };
+
+  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) {
+  writeSnapshot();
+}
+
+module.exports = {
+  markerFileName,
+  readEnvironment,
+  resolveProjectRoot,
+  stateDirectoryName,
+  writeSnapshot
+};

package/lib/state.js

@@ -3,10 +3,10 @@
 const platform = process;
 const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
-const runtime = platform.getBuiltinModule('module');
 const manifest = require('../package.json');
 
-const configFileName = 'workspace.context.js';
+const routineName = 'workspace-context:snapshot';
+const snapshotFileName = 'snapshot.js';
 const stateDirectoryName = '.workspace-context';
 const stateFileName = 'state.json';
 
@@ -24,48 +24,20 @@ function buildState({ now = () => new Date().toISOString() } = {}) {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-config'
+    mode: 'runtime-task'
   };
 }
 
-function loadProjectConfig({ projectRoot, statePath, state }) {
-  const configPath = route.join(projectRoot, configFileName);
-  if (!file.existsSync(configPath)) {
-    return {
-      configPath,
-      loaded: false,
-      hookExecuted: false,
-      result: null
-    };
-  }
-
-  const loader = runtime.createRequire(__filename);
-  const config = Reflect.apply(loader, undefined, [configPath]);
-  const hook = resolveHook(config);
-
-  if (!hook) {
-    return {
-      configPath,
-      loaded: true,
-      hookExecuted: false,
-      result: null
-    };
-  }
-
-  const result = Reflect.apply(hook, config, [{
-    packageName: manifest.name,
-    packageVersion: manifest.version,
-    projectRoot,
-    statePath,
-    state
-  }]);
-
-  return {
-    configPath,
-    loaded: true,
-    hookExecuted: true,
-    result: result === undefined ? null : result
-  };
+function getWorkspaceRoutines({
+  projectRoot = resolveProjectRoot()
+} = {}) {
+  return [{
+    name: routineName,
+    runtime: platform.execPath,
+    entrypoint: route.join(__dirname, snapshotFileName),
+    arguments: [projectRoot],
+    workingDirectory: projectRoot
+  }];
 }
 
 function initialize({
@@ -82,33 +54,17 @@ function initialize({
     projectRoot,
     statePath,
     state: value,
-    projectConfig: loadProjectConfig({
-      projectRoot,
-      statePath,
-      state: value
-    })
+    workspaceRoutines: getWorkspaceRoutines({ projectRoot })
   };
 }
 
-function resolveHook(config) {
-  if (typeof config === 'function') {
-    return config;
-  }
-
-  if (config && typeof config.initialize === 'function') {
-    return config.initialize;
-  }
-
-  return null;
-}
-
 module.exports = {
   buildState,
-  configFileName,
+  getWorkspaceRoutines,
   initialize,
-  loadProjectConfig,
   readEnvironment,
   resolveProjectRoot,
+  routineName,
   stateDirectoryName,
   stateFileName
 };

package/package.json

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