asdf

Squash the current repository state back into one baseline commit while
preserving the README reframing and repository contents.

Constraint: User explicitly requested a single squashed commit with subject "asdf"
Confidence: high
Scope-risk: broad
Reversibility: clean
Directive: This commit intentionally rewrites published history; coordinate before future force-pushes
Tested: git status clean; local history rewritten to one commit; force-pushed main to origin and instructkr
Not-tested: Fresh clone verification after push

src/utils/bash/specs/alias.ts

@@ -0,0 +1,14 @@
+import type { CommandSpec } from '../registry.js'
+
+const alias: CommandSpec = {
+  name: 'alias',
+  description: 'Create or list command aliases',
+  args: {
+    name: 'definition',
+    description: 'Alias definition in the form name=value',
+    isOptional: true,
+    isVariadic: true,
+  },
+}
+
+export default alias

src/utils/bash/specs/index.ts

@@ -0,0 +1,18 @@
+import type { CommandSpec } from '../registry.js'
+import alias from './alias.js'
+import nohup from './nohup.js'
+import pyright from './pyright.js'
+import sleep from './sleep.js'
+import srun from './srun.js'
+import time from './time.js'
+import timeout from './timeout.js'
+
+export default [
+  pyright,
+  timeout,
+  sleep,
+  alias,
+  nohup,
+  time,
+  srun,
+] satisfies CommandSpec[]

src/utils/bash/specs/nohup.ts

@@ -0,0 +1,13 @@
+import type { CommandSpec } from '../registry.js'
+
+const nohup: CommandSpec = {
+  name: 'nohup',
+  description: 'Run a command immune to hangups',
+  args: {
+    name: 'command',
+    description: 'Command to run with nohup',
+    isCommand: true,
+  },
+}
+
+export default nohup

src/utils/bash/specs/pyright.ts

@@ -0,0 +1,91 @@
+import type { CommandSpec } from '../registry.js'
+
+export default {
+  name: 'pyright',
+  description: 'Type checker for Python',
+  options: [
+    { name: ['--help', '-h'], description: 'Show help message' },
+    { name: '--version', description: 'Print pyright version and exit' },
+    {
+      name: ['--watch', '-w'],
+      description: 'Continue to run and watch for changes',
+    },
+    {
+      name: ['--project', '-p'],
+      description: 'Use the configuration file at this location',
+      args: { name: 'FILE OR DIRECTORY' },
+    },
+    { name: '-', description: 'Read file or directory list from stdin' },
+    {
+      name: '--createstub',
+      description: 'Create type stub file(s) for import',
+      args: { name: 'IMPORT' },
+    },
+    {
+      name: ['--typeshedpath', '-t'],
+      description: 'Use typeshed type stubs at this location',
+      args: { name: 'DIRECTORY' },
+    },
+    {
+      name: '--verifytypes',
+      description: 'Verify completeness of types in py.typed package',
+      args: { name: 'IMPORT' },
+    },
+    {
+      name: '--ignoreexternal',
+      description: 'Ignore external imports for --verifytypes',
+    },
+    {
+      name: '--pythonpath',
+      description: 'Path to the Python interpreter',
+      args: { name: 'FILE' },
+    },
+    {
+      name: '--pythonplatform',
+      description: 'Analyze for platform',
+      args: { name: 'PLATFORM' },
+    },
+    {
+      name: '--pythonversion',
+      description: 'Analyze for Python version',
+      args: { name: 'VERSION' },
+    },
+    {
+      name: ['--venvpath', '-v'],
+      description: 'Directory that contains virtual environments',
+      args: { name: 'DIRECTORY' },
+    },
+    { name: '--outputjson', description: 'Output results in JSON format' },
+    { name: '--verbose', description: 'Emit verbose diagnostics' },
+    { name: '--stats', description: 'Print detailed performance stats' },
+    {
+      name: '--dependencies',
+      description: 'Emit import dependency information',
+    },
+    {
+      name: '--level',
+      description: 'Minimum diagnostic level',
+      args: { name: 'LEVEL' },
+    },
+    {
+      name: '--skipunannotated',
+      description: 'Skip type analysis of unannotated functions',
+    },
+    {
+      name: '--warnings',
+      description: 'Use exit code of 1 if warnings are reported',
+    },
+    {
+      name: '--threads',
+      description: 'Use up to N threads to parallelize type checking',
+      args: { name: 'N', isOptional: true },
+    },
+  ],
+  args: {
+    name: 'files',
+    description:
+      'Specify files or directories to analyze (overrides config file)',
+    isVariadic: true,
+    isOptional: true,
+  },
+} satisfies CommandSpec

src/utils/bash/specs/sleep.ts

@@ -0,0 +1,13 @@
+import type { CommandSpec } from '../registry.js'
+
+const sleep: CommandSpec = {
+  name: 'sleep',
+  description: 'Delay for a specified amount of time',
+  args: {
+    name: 'duration',
+    description: 'Duration to sleep (seconds or with suffix like 5s, 2m, 1h)',
+    isOptional: false,
+  },
+}
+
+export default sleep

src/utils/bash/specs/srun.ts

@@ -0,0 +1,31 @@
+import type { CommandSpec } from '../registry.js'
+
+const srun: CommandSpec = {
+  name: 'srun',
+  description: 'Run a command on SLURM cluster nodes',
+  options: [
+    {
+      name: ['-n', '--ntasks'],
+      description: 'Number of tasks',
+      args: {
+        name: 'count',
+        description: 'Number of tasks to run',
+      },
+    },
+    {
+      name: ['-N', '--nodes'],
+      description: 'Number of nodes',
+      args: {
+        name: 'count',
+        description: 'Number of nodes to allocate',
+      },
+    },
+  ],
+  args: {
+    name: 'command',
+    description: 'Command to run on the cluster',
+    isCommand: true,
+  },
+}
+
+export default srun

src/utils/bash/specs/time.ts

@@ -0,0 +1,13 @@
+import type { CommandSpec } from '../registry.js'
+
+const time: CommandSpec = {
+  name: 'time',
+  description: 'Time a command',
+  args: {
+    name: 'command',
+    description: 'Command to time',
+    isCommand: true,
+  },
+}
+
+export default time

src/utils/bash/specs/timeout.ts

@@ -0,0 +1,20 @@
+import type { CommandSpec } from '../registry.js'
+
+const timeout: CommandSpec = {
+  name: 'timeout',
+  description: 'Run a command with a time limit',
+  args: [
+    {
+      name: 'duration',
+      description: 'Duration to wait before timing out (e.g., 10, 5s, 2m)',
+      isOptional: false,
+    },
+    {
+      name: 'command',
+      description: 'Command to run',
+      isCommand: true,
+    },
+  ],
+}
+
+export default timeout