producs 3.0.0 → 3.0.1

package/README.pd

@@ -197,6 +197,7 @@
     #$Table
       #$Row['Command','Description']
       #$Row['Set[name,value]','Set a variable']
+      #$Row['Get[name]', 'Get the value of a variable']
       #$Row['Unset[name]','Delete a variable']
       #$Row['Export[name,value]','Set variable and push to process.env']
       #$Row['Env_get[KEY]','Read process.env.KEY into VALUE']

package/cli.js

@@ -30,6 +30,7 @@ ${bold("Flags:")}
   ${bold("--no-color")}    Disable ANSI colors
   ${bold("--ast")}         Dump AST as JSON and exit (no execution)
   ${bold("--demo")}        Run the built-in feature demo
+  ${bold("--readme")}      Run the built-in interactive readme (built in producs itself, not in markdown)
   ${bold("--help")}        Show this message
   ${bold("--version")}     Print version
 
@@ -65,6 +66,11 @@ ${dim("─".repeat(60))}
 const DEMO = require("fs").readFileSync(
   require("path").join(__dirname, "examples", "demo.pd"), "utf8"
 );
+
+const README = require("fs").readFileSync(
+  require("path").join(__dirname, "README.pd"), "utf8"
+);
+
 // ─── Parse argv ───────────────────────────────────────────────────────────────
 const argv  = process.argv.slice(2);
 const flags = new Set(argv.filter(a => a.startsWith("--")));
@@ -92,6 +98,17 @@ if (flags.has("--demo")) {
   process.exit(0);
 }
 
+// ─── Readme ─────────────────────────────────────────────────────────────────────
+if (flags.has("--readme")) {
+  try { prod.run(README); }
+  catch (e) {
+    process.stderr.write(red(`\n${e.name||"Error"}: ${e.message}\n`));
+    if (opts.debug && e.stack) process.stderr.write(dim(e.stack)+"\n");
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
 // ─── File execution ───────────────────────────────────────────────────────────
 const filePath = path.resolve(files[0]);
 let src;

package/index.js

@@ -394,6 +394,14 @@ class CommandRegistry {
       return okResult(value);
     }, { doc:"Set['name','value'] or pipe VALUE into variable" });
 
+    R.register("Get", (node, input) => {
+      const [name=""] = rA(node.args);
+      const val = env.vars[name];
+      if (val === undefined) return failResult("",{reason:`variable ${name} not set`});
+      return okResult(val);
+    }, { doc:"Get['name'] → VALUE" });
+
+
     R.register("Unset", (node,input) => {
       const [name=""] = rA(node.args);
       delete env.vars[name]; return okResult(input.VALUE);

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "producs",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Professional Documentation Shell DSL — a modular, pipeable terminal scripting language",
   "main": "index.js",
   "bin": {
-    "producs": "./cli.js"
+    "producs": "cli.js"
   },
   "scripts": {
     "start": "node cli.js",
@@ -21,7 +21,7 @@
     "scripting",
     "pipeline"
   ],
-  "author": "Purcwix",
+  "author": "purcwix",
   "license": "MIT",
   "dependencies": {
     "prompt-sync": "^4.2.0"