burhan-mop 0.1.0 → 0.1.2

package/{.memoryofplanet → .MOP}/PROTOCOL.md

@@ -1,15 +1,15 @@
-# MemoryOfPlanet Core Protocol
+# MOP Core Protocol
 
 This is the source of truth for setup, authentication, member state, and agent
-naming in MemoryOfPlanet.
+naming in MOP.
 
 ## First Action Gate
 
 Before any assistant answers questions or edits files in this core, read
-`.memoryofplanet/STATE.json`.
+`.MOP/STATE.json`.
 
 - If `initialized` is `false`, output:
-  `MemoryOfPlanet belum di-setup. Jalankan /mop-setup.`
+  `MOP belum di-setup. Jalankan /mop-setup.`
   Then run the setup wizard only.
 - If `initialized` is `true` and `activeMember` is empty, output:
   `Codename dan password.`
@@ -40,7 +40,7 @@ Use this order:
 After confirmation, run:
 
 ```bash
-node .memoryofplanet/scripts/mop-core.mjs setup --project-name "<name>" --name "<display>" --codename <codename> --password "<password>" --mode <solo|team> --conversation-language "<lang>" --coding-language "<lang>" --git-email "<github-verified-email>" [--git-name "<display>"] [--github-username "<github-login>"] [--github-url "<url>"] [--join-mode <mode>]
+node .MOP/scripts/mop-core.mjs setup --project-name "<name>" --name "<display>" --codename <codename> --password "<password>" --mode <solo|team> --conversation-language "<lang>" --coding-language "<lang>" --git-email "<github-verified-email>" [--git-name "<display>"] [--github-username "<github-login>"] [--github-url "<url>"] [--join-mode <mode>]
 ```
 
 ## Agent Naming Ceremony
@@ -69,7 +69,7 @@ only when their expertise is genuinely needed, with no fixed maximum.
 Use:
 
 ```bash
-node .memoryofplanet/scripts/mop-core.mjs agent route --actor <codename> --task "<user task>"
+node .MOP/scripts/mop-core.mjs agent route --actor <codename> --task "<user task>"
 ```
 
 Routing rules:
@@ -152,7 +152,7 @@ agent: <from-name> (<from-role>)
 
 ## MOP Workflow
 
-MOP Workflow is BMAD-inspired but MemoryOfPlanet-native. It is the default
+MOP Workflow is BMAD-inspired and MOP-native. It is the default
 structure for complex work:
 
 `idea -> brief -> prd -> ux-spec -> architecture -> story -> readiness -> implementation -> review -> release`
@@ -161,9 +161,9 @@ Use the workflow helper when the user asks what to do next, asks for a plan, or
 requests implementation:
 
 ```bash
-node .memoryofplanet/scripts/mop-workflow.mjs help --actor <codename> --task "<user task>"
-node .memoryofplanet/scripts/mop-workflow.mjs next --actor <codename> --task "<user task>"
-node .memoryofplanet/scripts/mop-workflow.mjs status --actor <codename>
+node .MOP/scripts/mop-workflow.mjs help --actor <codename> --task "<user task>"
+node .MOP/scripts/mop-workflow.mjs next --actor <codename> --task "<user task>"
+node .MOP/scripts/mop-workflow.mjs status --actor <codename>
 ```
 
 The workflow helper returns the suggested phase, lead agent role, party roles,
@@ -171,12 +171,12 @@ next artifact, and gate status. The primary agent still owns the answer.
 
 ## Artifacts
 
-Complex work should create durable artifacts under `.memoryofplanet/artifacts/`.
+Complex work should create durable artifacts under `.MOP/artifacts/`.
 Artifacts are grouped by category so planning, reviews, releases, and decisions
 do not mix together:
 
 ```text
-.memoryofplanet/artifacts/<category>/<artifact-slug>/<type>.md
+.MOP/artifacts/<category>/<artifact-slug>/<type>.md
 ```
 
 Default categories:
@@ -208,7 +208,7 @@ Available artifact types:
 Create artifacts with:
 
 ```bash
-node .memoryofplanet/scripts/mop-workflow.mjs artifact create --actor <codename> --type <type> --title "<title>"
+node .MOP/scripts/mop-workflow.mjs artifact create --actor <codename> --type <type> --title "<title>"
 ```
 
 Use `--category <name>` only when the default type category is not suitable.
@@ -232,14 +232,14 @@ for a monorepo or multiple apps.
 
 Customization is layered and non-bypassing:
 
-1. defaults: `.memoryofplanet/config/defaults.json`
-2. team: `.memoryofplanet/config/team.json`
-3. member: `.memoryofplanet/config/members/<codename>.json`
+1. defaults: `.MOP/config/defaults.json`
+2. team: `.MOP/config/team.json`
+3. member: `.MOP/config/members/<codename>.json`
 
 Show merged config with:
 
 ```bash
-node .memoryofplanet/scripts/mop-workflow.mjs config show --actor <codename>
+node .MOP/scripts/mop-workflow.mjs config show --actor <codename>
 ```
 
 Customization may tune workflow preferences, party mode verbosity, and preferred
@@ -251,7 +251,7 @@ BURHAN-MOP review.
 Before coding or making implementation changes, run:
 
 ```bash
-node .memoryofplanet/scripts/mop-workflow.mjs gate readiness --actor <codename> --task "<user task>" [--artifact <path>]
+node .MOP/scripts/mop-workflow.mjs gate readiness --actor <codename> --task "<user task>" [--artifact <path>]
 ```
 
 If status is not `ready`, ask clarification or update the required artifact
@@ -263,7 +263,7 @@ Use adversarial review before implementation for risky work, before merge, or
 when the user asks for review:
 
 ```bash
-node .memoryofplanet/scripts/mop-workflow.mjs review adversarial --actor <codename> --target "<plan, artifact, file, or task>"
+node .MOP/scripts/mop-workflow.mjs review adversarial --actor <codename> --target "<plan, artifact, file, or task>"
 ```
 
 Adversarial review must challenge assumptions, find failure modes, surface
@@ -287,9 +287,12 @@ apply.
 The package installer command is:
 
 ```bash
-npx burhan-mop install
+npx burhan-mop install [--target <project-folder>] [--force] [--json]
 ```
 
+The default output is a clean terminal UI. Use `--json` for CI, scripts, and
+other automation that needs machine-readable output.
+
 The short package command works after the package is published to npm. Before
 an npm publish, install directly from GitHub:
 
@@ -300,10 +303,10 @@ npx --yes github:BURHANDEV-ENTERPRISE/BURHAN-MOP install
 Local equivalent:
 
 ```bash
-node .memoryofplanet/scripts/burhan-mop.mjs install --target <project-folder>
+node .MOP/scripts/burhan-mop.mjs install --target <project-folder>
 ```
 
-Installer copies provider entrypoints, MemoryOfPlanet state, skills, workflow
+Installer copies provider entrypoints, MOP state, skills, workflow
 config, and artifact templates. Existing files are skipped unless `--force` is
 used.
 
@@ -319,19 +322,19 @@ Then ask:
 Save the answer with:
 
 ```bash
-node .memoryofplanet/scripts/mop-core.mjs agent activate --actor <codename> --role <role> --title "<title>" --name "<agent-name>"
+node .MOP/scripts/mop-core.mjs agent activate --actor <codename> --role <role> --title "<title>" --name "<agent-name>"
 ```
 
 Check the current active agent with:
 
 ```bash
-node .memoryofplanet/scripts/mop-core.mjs agent current --actor <codename>
+node .MOP/scripts/mop-core.mjs agent current --actor <codename>
 ```
 
 Switch to an existing owned agent with:
 
 ```bash
-node .memoryofplanet/scripts/mop-core.mjs agent use --actor <codename> --name "<agent-name>"
+node .MOP/scripts/mop-core.mjs agent use --actor <codename> --name "<agent-name>"
 ```
 
 All durable memory and ledger entries must include the active agent when one is
@@ -346,7 +349,7 @@ available to the active member:
 3. Save the name with:
 
 ```bash
-node .memoryofplanet/scripts/mop-core.mjs agent activate --actor <codename> --role <role> --title "<title>" --name "<agent-name>"
+node .MOP/scripts/mop-core.mjs agent activate --actor <codename> --role <role> --title "<title>" --name "<agent-name>"
 ```
 
 ## Shared Agent Rule
@@ -366,15 +369,15 @@ changes. It is intentionally identity-safe.
 Before first push for a member, configure the real Git identity:
 
 ```bash
-node .memoryofplanet/scripts/mop-core.mjs member git-identity --actor <codename> --name "<display name>" --email "<github-verified-email>" --github-username "<github-login>"
+node .MOP/scripts/mop-core.mjs member git-identity --actor <codename> --name "<display name>" --email "<github-verified-email>" --github-username "<github-login>"
 ```
 
 Then run:
 
 ```bash
-node .memoryofplanet/scripts/mop-autosycn.mjs init --actor <owner-codename> --url "<github-url>"
-node .memoryofplanet/scripts/mop-autosycn.mjs preflight --actor <codename>
-node .memoryofplanet/scripts/mop-autosycn.mjs run --actor <codename> --reason "<what changed>"
+node .MOP/scripts/mop-autosycn.mjs init --actor <owner-codename> --url "<github-url>"
+node .MOP/scripts/mop-autosycn.mjs preflight --actor <codename>
+node .MOP/scripts/mop-autosycn.mjs run --actor <codename> --reason "<what changed>"
 ```
 
 Autosycn must:
@@ -423,13 +426,13 @@ Only activate deployment after explicit confirmation.
 
 ## File Layout
 
-- `.memoryofplanet/STATE.json` - durable project/member/agent state.
-- `.memoryofplanet/PROTOCOL.md` - this protocol.
-- `.memoryofplanet/scripts/mop-core.mjs` - setup/login/agent helper.
-- `.memoryofplanet/scripts/mop-workflow.mjs` - workflow/help/artifact/readiness/review helper.
-- `.memoryofplanet/scripts/burhan-mop.mjs` - installer CLI for `npx burhan-mop install`.
-- `.memoryofplanet/scripts/mop-autosycn.mjs` - identity-safe autosycn helper.
-- `.memoryofplanet/scripts/mop-auto-deploy.mjs` - opt-in deployment helper.
+- `.MOP/STATE.json` - durable project/member/agent state.
+- `.MOP/PROTOCOL.md` - this protocol.
+- `.MOP/scripts/mop-core.mjs` - setup/login/agent helper.
+- `.MOP/scripts/mop-workflow.mjs` - workflow/help/artifact/readiness/review helper.
+- `.MOP/scripts/burhan-mop.mjs` - installer CLI for `npx burhan-mop install`.
+- `.MOP/scripts/mop-autosycn.mjs` - identity-safe autosycn helper.
+- `.MOP/scripts/mop-auto-deploy.mjs` - opt-in deployment helper.
 - `AGENTS.md` - Codex and provider-neutral entrypoint.
 - `CLAUDE.md` - Claude Code entrypoint.
 - `GEMINI.md` - Gemini CLI entrypoint.

package/{.memoryofplanet → .MOP}/STATE.json

@@ -58,7 +58,7 @@
   "workflow": {
     "enabled": true,
     "name": "MOP Workflow",
-    "style": "BMAD-inspired, MemoryOfPlanet-native",
+    "style": "BMAD-inspired, MOP-native",
     "currentPhase": null,
     "phaseOrder": [
       "idea",
@@ -202,8 +202,8 @@
   },
   "artifacts": {
     "enabled": true,
-    "directory": ".memoryofplanet/artifacts",
-    "templateDirectory": ".memoryofplanet/templates/artifacts",
+    "directory": ".MOP/artifacts",
+    "templateDirectory": ".MOP/templates/artifacts",
     "layout": "category/artifact-slug/type.md",
     "defaultCategory": "general",
     "folderByType": {
@@ -243,9 +243,9 @@
       "member"
     ],
     "files": {
-      "defaults": ".memoryofplanet/config/defaults.json",
-      "team": ".memoryofplanet/config/team.json",
-      "memberPattern": ".memoryofplanet/config/members/<codename>.json"
+      "defaults": ".MOP/config/defaults.json",
+      "team": ".MOP/config/team.json",
+      "memberPattern": ".MOP/config/members/<codename>.json"
     },
     "rules": [
       "Defaults define safe project behavior.",
@@ -276,7 +276,7 @@
       "config",
       "scripts",
       ".github",
-      ".memoryofplanet",
+      ".MOP",
       ".agents",
       ".claude",
       ".codex",
@@ -335,10 +335,10 @@
     "enabled": true,
     "packageName": "burhan-mop",
     "command": "npx burhan-mop install",
-    "entrypoint": ".memoryofplanet/scripts/burhan-mop.mjs",
+    "entrypoint": ".MOP/scripts/burhan-mop.mjs",
     "installTargets": [
       "provider entrypoints",
-      "MemoryOfPlanet state",
+      "MOP state",
       "skills",
       "workflow config",
       "artifact templates"
@@ -511,7 +511,7 @@
       "role": "memory",
       "title": "Memory Keeper",
       "kind": "memory",
-      "purpose": "Save, recall, summarize, search, and clean long-term MemoryOfPlanet records."
+      "purpose": "Save, recall, summarize, search, and clean long-term MOP records."
     },
     {
       "role": "ux",
@@ -555,7 +555,7 @@
       "at": "2026-06-11T00:00:00.000Z",
       "actor": "system",
       "kind": "state-created",
-      "summary": "MemoryOfPlanet state scaffold created; setup pending."
+      "summary": "MOP state scaffold created; setup pending."
     }
   ]
 }

package/{.memoryofplanet → .MOP}/config/defaults.json

@@ -14,8 +14,8 @@
     "includeGateStatus": true
   },
   "artifacts": {
-    "directory": ".memoryofplanet/artifacts",
-    "templateDirectory": ".memoryofplanet/templates/artifacts",
+    "directory": ".MOP/artifacts",
+    "templateDirectory": ".MOP/templates/artifacts",
     "layout": "category/artifact-slug/type.md",
     "defaultCategory": "general",
     "folderByType": {

package/.MOP/scripts/burhan-mop.mjs

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+import { cpSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(here, '..', '..');
+const colorEnabled = process.stdout.isTTY && !process.env.NO_COLOR;
+const colors = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m'
+};
+const installEntries = [
+  'AGENTS.md',
+  'CLAUDE.md',
+  'GEMINI.md',
+  '.MOP',
+  '.agents',
+  '.claude',
+  '.claude-flow',
+  '.codex',
+  '.gemini',
+  '.mcp.json'
+];
+const doctorEntries = [
+  'AGENTS.md',
+  'CLAUDE.md',
+  'GEMINI.md',
+  '.MOP/STATE.json',
+  '.MOP/PROTOCOL.md',
+  '.MOP/scripts/mop-core.mjs',
+  '.MOP/scripts/mop-workflow.mjs',
+  '.agents/skills/mop-help/SKILL.md'
+];
+
+function parseArgs(argv) {
+  const out = { _: [] };
+  for (let i = 0; i < argv.length; i += 1) {
+    const item = argv[i];
+    if (!item.startsWith('--')) {
+      out._.push(item);
+      continue;
+    }
+    const [key, inlineValue] = item.slice(2).split('=', 2);
+    if (inlineValue !== undefined) {
+      out[key] = inlineValue;
+      continue;
+    }
+    const next = argv[i + 1];
+    if (!next || next.startsWith('--')) {
+      out[key] = true;
+    } else {
+      out[key] = next;
+      i += 1;
+    }
+  }
+  return out;
+}
+
+function paint(name, value) {
+  if (!colorEnabled) return value;
+  return `${colors[name]}${value}${colors.reset}`;
+}
+
+function rule() {
+  console.log(paint('gray', '-'.repeat(66)));
+}
+
+function header(title, subtitle) {
+  console.log('');
+  rule();
+  console.log(paint('bold', title));
+  console.log(paint('cyan', subtitle));
+  rule();
+}
+
+function asJson(args) {
+  return args.json === true || args.format === 'json';
+}
+
+function statusBadge(status) {
+  if (status === 'installed') return paint('green', '[OK]');
+  if (status === 'skipped-existing') return paint('yellow', '[SKIP]');
+  if (status === 'missing-source') return paint('red', '[MISS]');
+  return paint('gray', '[INFO]');
+}
+
+function statusLabel(status) {
+  if (status === 'installed') return 'installed';
+  if (status === 'skipped-existing') return 'already exists';
+  if (status === 'missing-source') return 'template missing';
+  return status;
+}
+
+function summarize(results) {
+  return results.reduce((summary, item) => {
+    if (item.status === 'installed') summary.installed += 1;
+    else if (item.status === 'skipped-existing') summary.skipped += 1;
+    else if (item.status === 'missing-source') summary.missing += 1;
+    else summary.other += 1;
+    return summary;
+  }, { installed: 0, skipped: 0, missing: 0, other: 0 });
+}
+
+function copyPath(entry, source, target, force = false) {
+  if (!existsSync(source)) return { entry, source, target, status: 'missing-source' };
+  if (existsSync(target) && !force) return { entry, source, target, status: 'skipped-existing' };
+  mkdirSync(dirname(target), { recursive: true });
+  cpSync(source, target, { recursive: true, force: true });
+  return { entry, source, target, status: 'installed' };
+}
+
+function buildInstallReport(args) {
+  const targetRoot = resolve(String(args.target || process.cwd()));
+  const force = args.force === true;
+  const results = installEntries.map((entry) => copyPath(
+    entry,
+    join(packageRoot, entry),
+    join(targetRoot, entry),
+    force
+  ));
+  const summary = summarize(results);
+  return {
+    ok: summary.missing === 0,
+    command: 'npx burhan-mop install',
+    target: targetRoot,
+    force,
+    results,
+    summary,
+    next: [
+      'Run /mop-setup in the target project.',
+      'For team mode, initialize autosycn after setup.',
+      'Use: node .MOP/scripts/mop-workflow.mjs help --actor <codename> --task "lepas ni buat apa?"'
+    ]
+  };
+}
+
+function renderInstall(report) {
+  header('BURHAN-MOP installer', 'Portable AI MemoryCore for Claude, Codex / ChatGPT, Gemini, and Antigravity');
+  console.log(`${paint('bold', 'Target')} : ${report.target}`);
+  console.log(`${paint('bold', 'Mode')}   : ${report.force ? 'force overwrite' : 'safe install'}`);
+  rule();
+  for (const item of report.results) {
+    console.log(`${statusBadge(item.status)} ${item.entry.padEnd(28)} ${statusLabel(item.status)}`);
+  }
+  rule();
+  console.log(`${paint('bold', 'Summary')}: ${report.summary.installed} installed, ${report.summary.skipped} skipped, ${report.summary.missing} missing`);
+  if (report.summary.skipped > 0) {
+    console.log(paint('yellow', 'Tip: existing files were kept. Use --force only when you want to overwrite them.'));
+  }
+  if (report.summary.missing > 0) {
+    console.log(paint('red', 'Some package templates are missing. Reinstall or report this package build.'));
+  }
+  console.log('');
+  console.log(paint('bold', 'Next'));
+  report.next.forEach((item, index) => {
+    console.log(`  ${index + 1}. ${item}`);
+  });
+  console.log('');
+  console.log(paint('dim', 'Automation JSON: npx burhan-mop install --json'));
+}
+
+function install(args) {
+  const report = buildInstallReport(args);
+  if (asJson(args)) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+  renderInstall(report);
+}
+
+function buildDoctorReport() {
+  const results = doctorEntries.map((entry) => {
+    const path = join(process.cwd(), entry);
+    const exists = existsSync(path);
+    return {
+      entry,
+      exists,
+      type: exists ? (statSync(path).isDirectory() ? 'dir' : 'file') : 'missing'
+    };
+  });
+  return {
+    ok: results.every((item) => item.exists),
+    cwd: process.cwd(),
+    results
+  };
+}
+
+function renderDoctor(report) {
+  header('BURHAN-MOP doctor', 'Workspace health check');
+  console.log(`${paint('bold', 'Project')}: ${report.cwd}`);
+  rule();
+  for (const item of report.results) {
+    const badge = item.exists ? paint('green', '[OK]') : paint('red', '[MISS]');
+    console.log(`${badge} ${item.entry.padEnd(38)} ${item.type}`);
+  }
+  rule();
+  console.log(`${paint('bold', 'Status')}: ${report.ok ? paint('green', 'ready') : paint('red', 'missing files')}`);
+  console.log('');
+  console.log(paint('dim', 'Automation JSON: npx burhan-mop doctor --json'));
+}
+
+function doctor(args) {
+  const report = buildDoctorReport();
+  if (asJson(args)) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+  renderDoctor(report);
+}
+
+function listPackage(args) {
+  const report = {
+    packageRoot,
+    entries: readdirSync(packageRoot, { withFileTypes: true }).map((item) => ({
+      name: item.name,
+      type: item.isDirectory() ? 'dir' : 'file'
+    }))
+  };
+  if (asJson(args)) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+  header('BURHAN-MOP package', 'Published package contents');
+  console.log(`${paint('bold', 'Root')}: ${report.packageRoot}`);
+  rule();
+  for (const item of report.entries) {
+    console.log(`${item.type.padEnd(4)} ${item.name}`);
+  }
+  console.log('');
+  console.log(paint('dim', 'Automation JSON: npx burhan-mop package --json'));
+}
+
+function main() {
+  const [command, ...rest] = process.argv.slice(2);
+  const args = parseArgs(rest);
+  if (command === 'install') return install(args);
+  if (command === 'doctor') return doctor(args);
+  if (command === 'package') return listPackage(args);
+  console.log(`Usage:
+  npx burhan-mop install [--target PATH] [--force] [--json]
+  npx burhan-mop doctor [--json]
+  npx burhan-mop package [--json]`);
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(error.message);
+  process.exitCode = 1;
+}

package/{.memoryofplanet → .MOP}/scripts/mop-auto-deploy.mjs

@@ -102,7 +102,7 @@ function defer(args) {
 
 function enable(args) {
   const state = readState();
-  if (!state.initialized) throw new Error('MemoryOfPlanet is not initialized.');
+  if (!state.initialized) throw new Error('MOP is not initialized.');
   const actor = requireArg(args, 'actor');
   if (!state.members?.[actor]) throw new Error(`Unknown actor: ${actor}`);
   const confirm = String(args.confirm || '').toLowerCase();
@@ -138,10 +138,10 @@ function main() {
   if (command === 'enable') return enable(args);
 
   console.log(`Usage:
-  node .memoryofplanet/scripts/mop-auto-deploy.mjs status
-  node .memoryofplanet/scripts/mop-auto-deploy.mjs ask
-  node .memoryofplanet/scripts/mop-auto-deploy.mjs defer --actor <codename> --answer nanti
-  node .memoryofplanet/scripts/mop-auto-deploy.mjs enable --actor <codename> --provider github|docker|vercel|all --confirm yes`);
+  node .MOP/scripts/mop-auto-deploy.mjs status
+  node .MOP/scripts/mop-auto-deploy.mjs ask
+  node .MOP/scripts/mop-auto-deploy.mjs defer --actor <codename> --answer nanti
+  node .MOP/scripts/mop-auto-deploy.mjs enable --actor <codename> --provider github|docker|vercel|all --confirm yes`);
 }
 
 try {
@@ -150,4 +150,3 @@ try {
   console.error(error.message);
   process.exitCode = 1;
 }
-