atris 3.15.13 → 3.15.22

package/commands/terminal.js

@@ -12,11 +12,11 @@
  * - Prints stdout, stderr, and exit_code so the caller knows what happened
  *
  * USAGE:
- *   atris terminal pallet "ls /workspace/atris/"
- *   atris terminal pallet "find /workspace -name '*.md' | wc -l" --timeout 60
+ *   atris terminal example-co "ls /workspace/atris/"
+ *   atris terminal example-co "find /workspace -name '*.md' | wc -l" --timeout 60
  *   atris terminal "rm -rf /workspace/cruft"   # auto-detects business from .atris/business.json
  *
- * Discovered the /terminal endpoint during overnight pallet cleanup — bulk
+ * Discovered the /terminal endpoint during overnight workspace cleanup - bulk
  * deleting 401 files via individual /file DELETE calls hit the rate limit
  * after request 60 and would have taken hours. One `rm -rf` via /terminal
  * finished in 1 second.
@@ -91,9 +91,9 @@ async function terminalAtris() {
   if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
     console.log('Usage: atris terminal [business] <command> [--timeout N]');
     console.log('');
-    console.log('  atris terminal pallet "ls /workspace/atris/"');
+    console.log('  atris terminal example-co "ls /workspace/atris/"');
     console.log('  atris terminal "find /workspace -name \\"*.md\\""    # auto-detect business');
-    console.log('  atris terminal pallet "rm -rf /workspace/cruft" --timeout 30');
+    console.log('  atris terminal example-co "rm -rf /workspace/cruft" --timeout 30');
     console.log('');
     console.log('  --timeout N    seconds to wait for the command (default 30, max 120)');
     process.exit(0);

package/commands/verify.js

@@ -112,7 +112,7 @@ function verifyWorkspace(cwd, atrisDir) {
     console.log('Result: VERIFIED ✓');
     console.log('Workspace is healthy. Ready for production.');
   } else {
-    console.log(`Result: ${results.issues.length} issue(s) found`);
+    console.log(`Result: ${results.issues.length} ${results.issues.length === 1 ? 'issue' : 'issues'} found`);
     console.log('Fix issues before marking work complete.');
   }
   console.log('');
@@ -223,10 +223,12 @@ function verifyMap(cwd, atrisDir) {
 
   const content = fs.readFileSync(mapFile, 'utf8');
 
-  // Check for placeholder content
-  const isPlaceholder = content.toLowerCase().includes('generated by your ai agent')
-    || content.toLowerCase().includes('run your ai agent')
-    || content.toLowerCase().includes('placeholder');
+  // Check for placeholder content. Match the specific phrases written by
+  // commands/init.js:357 — a substring search for "placeholder" is too broad
+  // and false-flags any MAP.md that mentions the word in prose.
+  const lower = content.toLowerCase();
+  const isPlaceholder = lower.includes('generated by your ai agent')
+    || lower.includes('run your ai agent');
 
   if (isPlaceholder) {
     result.issues.push('MAP.md contains placeholder content');

package/commands/visualize.js

@@ -368,6 +368,13 @@ async function generateVisual(prompt, options = {}) {
 }
 
 async function visualizeAtris(args = process.argv.slice(3)) {
+  // Bare-word `help` should not be treated as a prompt — it would trigger a
+  // paid image-generation call ("draw me a picture of help"). Promote it to
+  // the help intent.
+  if (args[0] === 'help') {
+    showVisualizeHelp();
+    return;
+  }
   const { prompt, options } = parseVisualizeArgs(args);
   if (options.help) {
     showVisualizeHelp();

package/commands/wiki.js

@@ -166,6 +166,53 @@ function printLocalPrompt(title, prompt, wikiRoot, details = []) {
   console.log('');
 }
 
+function hasHelpFlag(args) {
+  return args.includes('--help') || args.includes('-h') || args[0] === 'help';
+}
+
+function printWikiHelp(scope = null) {
+  const normalized = scope === 'ingest' || scope === 'query' || scope === 'lint' || scope === 'search' || scope === 'log' || scope === 'loop' || scope === 'verify'
+    ? scope
+    : null;
+
+  console.log('');
+  if (normalized === 'ingest') {
+    console.log('Usage: atris ingest <path>');
+    console.log('Usage: atris wiki ingest [--private|--cloud] [business] <path>');
+    console.log('');
+    console.log('Stage source files into the local wiki context pack.');
+  } else if (normalized === 'query') {
+    console.log('Usage: atris query "question"');
+    console.log('Usage: atris wiki query [--private|--cloud] [business] "question"');
+    console.log('');
+    console.log('Build a local or cloud wiki query prompt.');
+  } else if (normalized === 'lint') {
+    console.log('Usage: atris lint');
+    console.log('Usage: atris wiki lint [--private|--cloud] [business]');
+    console.log('');
+    console.log('Build a local or cloud wiki lint prompt.');
+  } else {
+    console.log('Usage: atris wiki <ingest|query|lint|search|log|loop|verify> [business] [args]');
+    console.log('');
+    console.log('  ingest <path>                 Local-first ingest into atris/wiki/');
+    console.log('  query  "question"             Local-first query against atris/wiki/');
+    console.log('  lint                          Local-first lint for atris/wiki/');
+    console.log('  search [business] <term>      Search local atris/wiki/index.md');
+    console.log('  log    [business] [N]         Show recent atris/wiki/log.md entries');
+    console.log('  loop                          Run local wiki upkeep analysis and refresh STATUS/log');
+    console.log('  verify                        Check agent-readable source/verification metadata');
+  }
+  console.log('');
+  console.log('Flags:');
+  console.log('  --cloud                       Route ingest/query/lint to the cloud workspace');
+  console.log('  --local                       Be explicit about local mode');
+  console.log(`  --private                     Use local private wiki at ${PRIVATE_WIKI_ROOT}/`);
+  console.log('  --help, -h                    Show this help');
+  console.log('');
+  console.log('Business is auto-detected from .atris/business.json for cloud mode if omitted.');
+  console.log('');
+}
+
 async function wikiIngest(mode, slug, sourceValue) {
   if (!sourceValue) {
     console.error('Usage: atris wiki ingest [business] <path>');
@@ -359,6 +406,11 @@ function wikiVerify(mode, slug) {
 }
 
 async function wikiCommand(subcommand, ...args) {
+  if (!subcommand || subcommand === 'help' || subcommand === '--help' || subcommand === '-h' || hasHelpFlag(args)) {
+    printWikiHelp(subcommand);
+    return;
+  }
+
   const { mode, args: cleanArgs } = parseModeArgs(args);
 
   switch (subcommand) {
@@ -430,22 +482,7 @@ async function wikiCommand(subcommand, ...args) {
       break;
     }
     default:
-      console.log('Usage: atris wiki <ingest|query|lint|search|log|loop|verify> [business] [args]');
-      console.log('');
-      console.log('  ingest <path>                 Local-first ingest into atris/wiki/');
-      console.log('  query  "question"             Local-first query against atris/wiki/');
-      console.log('  lint                          Local-first lint for atris/wiki/');
-      console.log('  search [business] <term>      Search local atris/wiki/index.md');
-      console.log('  log    [business] [N]         Show recent atris/wiki/log.md entries');
-      console.log('  loop                          Run local wiki upkeep analysis and refresh STATUS/log');
-      console.log('  verify                        Check agent-readable source/verification metadata');
-      console.log('');
-      console.log('Flags:');
-      console.log('  --cloud                       Route ingest/query/lint to the cloud workspace');
-      console.log('  --local                       Be explicit about local mode');
-      console.log(`  --private                     Use local private wiki at ${PRIVATE_WIKI_ROOT}/`);
-      console.log('');
-      console.log('Business is auto-detected from .atris/business.json for cloud mode if omitted.');
+      printWikiHelp();
   }
 }