@josfox/jos 0.2.1

package/LICENSE

@@ -0,0 +1 @@
+MIT

package/README.md

@@ -0,0 +1,2 @@
+# @josfox/jos v0.2.1
+Short-name CLI. Supports --version/--help and .jos export.

package/bin/jos.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const { DEFAULT_SPEC, asConsole } = require('../lib/spec');
+const VERSION = "0.2.1";
+function printBanner(){ console.log(`JOSFOX CLI v${VERSION}`); }
+function printHelp(){ printBanner(); console.log(`
+Usage:
+  jos [command] [options]
+
+Commands:
+  help                   Show help
+  version                Print version
+  init <name>            Scaffold a starter folder with spec.jos.json
+  export --format FMT    Export current spec (FMT: jos|console)
+  run [--mode value]     Example
+
+Flags:
+  -h, --help             Show help
+  -v, --version          Print version
+`); }
+function main(){
+  const argv = process.argv.slice(2);
+  if (argv.includes('--version') || argv.includes('-v')) { console.log(VERSION); return; }
+  if (argv.includes('--help') || argv.includes('-h')) { printHelp(); return; }
+  const cmd = (argv[0] || 'help').toLowerCase(); const rest = argv.slice(1);
+  if (cmd === 'help' || cmd === '?') return printHelp();
+  if (cmd === 'version') return console.log(VERSION);
+  if (cmd === 'init') {
+    const name = rest[0]; if (!name) return (console.error('Provide a name: jos init <name>'), process.exit(1));
+    const dir = path.resolve(process.cwd(), name); if (!fs.existsSync(dir)) fs.mkdirSync(dir,{recursive:true});
+    fs.writeFileSync(path.join(dir,'spec.jos.json'), JSON.stringify(DEFAULT_SPEC,null,2));
+    console.log(`Initialized ${dir} with spec.jos.json`); return;
+  }
+  if (cmd === 'export') {
+    const idx = rest.indexOf('--format'); let fmt = 'jos';
+    if (idx >= 0 && rest[idx+1]) fmt = String(rest[idx+1]).toLowerCase();
+    if (fmt === 'console') console.log(asConsole(DEFAULT_SPEC)); else console.log(JSON.stringify(DEFAULT_SPEC,null,2));
+    return;
+  }
+  if (cmd === 'run') {
+    const m = rest.indexOf('--mode'); const mode = (m>=0 && rest[m+1]) ? rest[m+1] : 'default';
+    console.log(`Running in mode: ${mode}`); return;
+  }
+  printHelp();
+}
+main();

package/lib/spec.js

@@ -0,0 +1,25 @@
+const DEFAULT_SPEC = {"version":"v2","kind":"Pack","name":"example-pack","description":"Example JOS Pack with prompts and an agent.","imports":[{"kind":"Prompt","ref":"./prompts/greet","as":"greet"},{"kind":"Prompt","ref":"./prompts/farewell","as":"bye"}],"prompts":{"greet":{"kind":"Prompt","id":"greet","template":"Hello, {{name}}!"},"farewell":{"kind":"Prompt","id":"farewell","template":"Bye, {{name}}."}},"agents":{"support":{"kind":"Agent","uses":["greet","farewell"],"vars":{"tone":"friendly"},"routes":[{"when":"start","do":"greet"},{"when":"end","do":"farewell"}]}},"meta":{"createdBy":"jos","kinds":["Prompt","Pack","Agent","App"],"hierarchy":{"Prompt":{"role":"leaf","canImport":[],"canContain":[]},"Pack":{"role":"library","canImport":["Prompt","Pack"],"canContain":["Prompt","Agent"]},"Agent":{"role":"runtime","canImport":["Prompt","Pack"],"canContain":[]},"App":{"role":"product","canImport":["Agent","Pack"],"canContain":["Agent"]}}}};
+function asConsole(spec = DEFAULT_SPEC) {
+  const lines = [];
+  const meta = spec.meta || {}
+  const kinds = meta.kinds || [];
+  const hierarchy = meta.hierarchy || {}
+  lines.push('JOS Spec');
+  lines.push(`version: ${spec.version}`);
+  lines.push(`kind: ${spec.kind}`);
+  lines.push('kinds:');
+  kinds.forEach(kind => lines.push(`  - ${kind}`));
+  lines.push('hierarchy:');
+  Object.keys(hierarchy).forEach(key => {
+    const h = hierarchy[key];
+    const imp = (h.canImport || []).join(',');
+    const cont = (h.canContain || []).join(',');
+    lines.push(`  ${key}: role=${h.role || ''}, canImport=${imp}, canContain=${cont}`);
+  });
+  const prompts = Object.keys(spec.prompts || {});
+  const agents = Object.keys(spec.agents || {});
+  lines.push('prompts:' + (prompts.length ? ' ' + prompts.join(', ') : ' (none)'));
+  lines.push('agents:' + (agents.length ? ' ' + agents.join(', ') : ' (none)'));
+  return lines.join('\n');
+}
+module.exports = { DEFAULT_SPEC, asConsole };

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@josfox/jos",
+  "version": "0.2.1",
+  "description": "JOSFOX CLI \u2014 exposes `jos` command with .jos export & kinds/hierarchy",
+  "bin": {
+    "jos": "bin/jos.js"
+  },
+  "type": "commonjs",
+  "keywords": [
+    "jos",
+    "josfox",
+    "cli",
+    ".jos",
+    "spec",
+    "export"
+  ],
+  "author": "JOSFOX",
+  "license": "MIT",
+  "homepage": "https://github.com/josfox/jos",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/josfox/jos.git"
+  },
+  "bugs": {
+    "url": "https://github.com/josfox/jos/issues"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "README.md",
+    "LICENSE"
+  ]
+}