@atedone/workspace-context 0.0.0-stage → 0.0.1

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @atedone/workspace-context
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+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.

package/index.js

@@ -0,0 +1,12 @@
+'use strict';
+
+const state = require('./lib/state');
+
+const initialized = state.initialize();
+
+module.exports = {
+  initialized,
+  initialize: state.initialize,
+  stateDirectoryName: state.stateDirectoryName,
+  stateFileName: state.stateFileName
+};

package/lib/state.js

@@ -0,0 +1,53 @@
+'use strict';
+
+const platform = process;
+const file = platform.getBuiltinModule('fs');
+const route = platform.getBuiltinModule('path');
+const manifest = require('../package.json');
+
+const stateDirectoryName = '.workspace-context';
+const stateFileName = 'state.json';
+
+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 buildState({ now = () => new Date().toISOString() } = {}) {
+  return {
+    packageName: manifest.name,
+    packageVersion: manifest.version,
+    generatedAt: now(),
+    mode: 'runtime'
+  };
+}
+
+function initialize({
+  projectRoot = resolveProjectRoot(),
+  now
+} = {}) {
+  const statePath = route.join(projectRoot, stateDirectoryName, stateFileName);
+  const value = buildState({ now });
+
+  file.mkdirSync(route.dirname(statePath), { recursive: true });
+  file.writeFileSync(statePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+
+  return {
+    projectRoot,
+    statePath,
+    state: value
+  };
+}
+
+module.exports = {
+  buildState,
+  initialize,
+  readEnvironment,
+  resolveProjectRoot,
+  stateDirectoryName,
+  stateFileName
+};

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@atedone/workspace-context",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "Workspace context initialization helper for JavaScript tools.",
+  "main": "index.js",
+  "type": "commonjs",
+  "files": [
+    "lib",
+    "index.js",
+    "README.md"
+  ],
+  "license": "MIT",
+  "author": "atedone"
+}