fauxnix-cli 0.7.1 → 0.9.0

package/README.md

@@ -153,6 +153,11 @@ development:
 - **text filters**: `grep egrep sed awk sort uniq cut tr` — sed/awk scripts are parsed at
   translate time (unsupported constructs throw named errors, never silently misbehave)
 - **text I/O**: `echo printf cat head tail wc tee nl tac md5sum sha1sum sha256sum base64 seq yes xargs`
+
+`cp` / `mv` / `rm` / `touch` / `tee` / `grep` / `head` / `du` carry a `CommandSpec`: unknown
+options fail with a GNU-style usage error instead of being ignored. Implemented GNU holes:
+`cp -n` / `mv -n` / `touch -c` / `tee --append` / `grep -m` / `head --lines` / `du --max-depth`.
+`fauxnix list --json` and `docs/command-specs.md` dump the same metadata.
 - **shell/system**: `cd pwd export unset env printenv ps kill pkill pgrep sleep which type whoami
   id groups date uname hostname uptime free nproc clear true false test [ [[ : pushd popd dirs sudo
   timeout man history less more source . eval exit alias set`
@@ -196,6 +201,7 @@ fauxnix optimizes for the commands agents actually run. Documented deviations:
 - `yes` is capped at 65,536 lines — PS 5.1 pipelines cannot signal upstream producers to stop, so
   an unbounded `yes | head` would hang.
 - `tail -f`, `eval`, `alias`, heredocs, `while`/`until`/`case`,
+  `env -i`/`--ignore-environment`,
   and background `&` are rejected with actionable error messages instead of misbehaving.
   (`if/then/elif/else/fi`, `for x in ...`, backtick substitution, `command -v`, pipeline `read`,
   dotenv-style `source`, and word-level `$((...))` arithmetic expansion are supported.)

package/dist/cli.js

@@ -2,7 +2,7 @@ import { spawn } from 'node:child_process';
 import { FauxnixSession } from './executor.js';
 import { parseCommand } from './parser.js';
 import { translateCommandList } from './translator.js';
-import { registeredNames } from './registry.js';
+import { listCommandsJson, registeredNames, specsMarkdown } from './registry.js';
 import { encodeCommand } from './encoding.js';
 import { startMcpServer } from './mcp.js';
 import { packageVersion } from './version.js';
@@ -15,6 +15,8 @@ Usage:
   fauxnix translate "cmd"            show the PowerShell translation only
   fauxnix mcp                        start the MCP stdio server (for agent harnesses)
   fauxnix list                       list translated commands
+  fauxnix list --json                same list as machine-readable capability metadata
+  fauxnix list --markdown            CommandSpec tables (same text as docs/command-specs.md)
   fauxnix check                      verify the local PowerShell environment
   fauxnix --version
 
@@ -31,6 +33,14 @@ export async function runCli(argv) {
         return;
     }
     if (verb === 'list') {
+        if (rest[0] === '--json') {
+            console.log(JSON.stringify(listCommandsJson(), null, 2));
+            return;
+        }
+        if (rest[0] === '--markdown') {
+            console.log(specsMarkdown());
+            return;
+        }
         const names = registeredNames();
         console.log(names.length + ' translated commands:');
         for (const n of names)

package/dist/commands/files.d.ts

@@ -1,2 +1,5 @@
-import { Handler } from '../registry.js';
+import { CommandSpec, Handler } from '../registry.js';
+/** Destructive file commands migrated first (#130). Unspec'd handlers stay unchecked.
+ *  cp/mv `-f`/`--force` is always-on overwrite (Copy-Item/Move-Item -Force); listed so `cp -rf` stays valid. */
+export declare const specs: CommandSpec[];
 export declare const handlers: Record<string, Handler>;