mop-flow 0.1.8

package/.MOP/STATE.json

@@ -0,0 +1,668 @@
+{
+  "schemaVersion": "0.1.0",
+  "initialized": false,
+  "projectName": ".MemoryOfPlanet.core",
+  "projectNameDefault": ".MemoryOfPlanet.core",
+  "ownerCodename": null,
+  "activeMember": null,
+  "activeAgents": {},
+  "agentPolicy": {
+    "requiredAfterAuth": true,
+    "requireForEveryConversation": true,
+    "defaultRole": "core",
+    "defaultTitle": "Core Agent",
+    "gateOrder": "AUTH_GATE_THEN_AGENT_ROUTER_THEN_AGENT_GATE_THEN_ACTION"
+  },
+  "answerPolicy": {
+    "requireVisibleAgent": true,
+    "visibleAgentFormat": "agent: <agent-name> (<agent-role>) to <user>",
+    "requireMemoryRestore": true,
+    "requireMemorySave": true,
+    "rules": [
+      "Every authenticated user-facing answer must start with the active named agent line.",
+      "If no active named agent exists, ask the user to name the required agent before answering the task.",
+      "Party Mode keeps its dialogue format, but the final handoff to the user must still show the speaking agent."
+    ]
+  },
+  "memoryPolicy": {
+    "enabled": true,
+    "directory": ".MOP/memory",
+    "sessionBrief": ".MOP/memory/SESSION_BRIEF.md",
+    "monthlyPattern": "YYYY-MM.jsonl",
+    "recentLimit": 20,
+    "restoreBeforeAnswer": true,
+    "saveAfterMeaningfulWork": true,
+    "rules": [
+      "Save one-line memories to a monthly JSONL file so new chats can restore context.",
+      "Generate SESSION_BRIEF.md from recent monthly memory entries.",
+      "Read memory brief before answering any authenticated task."
+    ]
+  },
+  "agentRouter": {
+    "enabled": true,
+    "primaryAgentLimit": 1,
+    "supportAgentLimit": null,
+    "clarifyBeforeActionWhenAmbiguous": true,
+    "preferHighReasoningForNewSystems": true,
+    "defaultHighReasoningRole": "architect",
+    "defaultHighReasoningTitle": "System Architect",
+    "rules": [
+      "Route every authenticated conversation through one primary named agent.",
+      "For new systems, unclear product ideas, or multi-step builds, route first to a high-reasoning architect/planner agent.",
+      "If the task is ambiguous, ask concise clarifying questions before implementation.",
+      "Do not activate irrelevant agents, but there is no maximum support-agent limit when the task genuinely needs more expertise.",
+      "Keep the user's original intent visible in the route reason so the agent does not drift from context."
+    ]
+  },
+  "partyMode": {
+    "enabled": true,
+    "autoActivateWhenNeeded": true,
+    "banner": "PARTY MODE",
+    "bannerRequired": true,
+    "minimumParticipants": 3,
+    "preferredMinimumParticipants": 4,
+    "participantLimit": null,
+    "showAgentDialogueToUser": true,
+    "format": {
+      "banner": "PARTY MODE",
+      "agentToAgent": "agent: <from-name> (<from-role>) to agent: <to-name> (<to-role>)",
+      "agentToUser": "agent: <from-name> (<from-role>) to <user>",
+      "explanation": "agent: <from-name> (<from-role>)",
+      "messageIndent": "          ",
+      "blankLineBeforeMessage": true
+    },
+    "rules": [
+      "Party mode activates automatically when a task needs several specialist agents to reason together.",
+      "When Party mode is active, show PARTY MODE in large uppercase before the agent dialogue.",
+      "Normal Party mode should use at least 3 participants and prefer 4 when the task has enough relevant roles.",
+      "The primary agent coordinates the party and keeps the user intent visible.",
+      "Every visible agent message must use the configured dialogue format.",
+      "Agents should ask each other focused questions, answer directly, then hand a clear result to the user.",
+      "Explicit requests such as party mode, multi-agent, semua agent, or agent discussion must activate Party Mode.",
+      "If Party Mode needs unnamed agents, ask for all missing agent names before doing the task."
+    ]
+  },
+  "browserPolicy": {
+    "requirePreflightBeforeBrowserWork": true,
+    "requireDefaultBrowserCheck": true,
+    "supportedChoices": [
+      "Chrome",
+      "Edge",
+      "Brave",
+      "Opera"
+    ],
+    "builtinChromeBrowsers": [
+      "chrome",
+      "chromium"
+    ],
+    "directModeBrowsers": [
+      "brave",
+      "edge",
+      "opera"
+    ],
+    "rules": [
+      "Before browser, scraping, extraction, click automation, login flow, or form filling, run browser preflight.",
+      "Check the user's default browser automatically when possible.",
+      "If the default browser is Edge, Brave, or Opera, use chrome-direct mode and guide the user to start remote debugging.",
+      "If no supported browser is detected, ask the user which browser they use before continuing."
+    ]
+  },
+  "workflow": {
+    "enabled": true,
+    "name": "MOP Workflow",
+    "style": "BMAD-inspired, MOP-native",
+    "currentPhase": null,
+    "phaseOrder": [
+      "idea",
+      "brief",
+      "prd",
+      "ux-spec",
+      "architecture",
+      "story",
+      "readiness",
+      "implementation",
+      "review",
+      "release"
+    ],
+    "phases": [
+      {
+        "id": "idea",
+        "title": "Idea Capture",
+        "primaryRole": "planner",
+        "partyRoles": [
+          "architect",
+          "researcher"
+        ],
+        "artifact": "product-brief",
+        "goal": "Clarify the user's intent, outcome, audience, constraints, and unknowns."
+      },
+      {
+        "id": "brief",
+        "title": "Product Brief",
+        "primaryRole": "planner",
+        "partyRoles": [
+          "ux",
+          "architect",
+          "prompt"
+        ],
+        "artifact": "product-brief",
+        "goal": "Turn the idea into a concise product direction and first scope."
+      },
+      {
+        "id": "prd",
+        "title": "PRD",
+        "primaryRole": "planner",
+        "partyRoles": [
+          "ux",
+          "architect",
+          "reviewer"
+        ],
+        "artifact": "prd",
+        "goal": "Define users, requirements, user stories, acceptance criteria, and risks."
+      },
+      {
+        "id": "ux-spec",
+        "title": "UX Spec",
+        "primaryRole": "ux",
+        "partyRoles": [
+          "design",
+          "frontend",
+          "accessibility"
+        ],
+        "artifact": "ux-spec",
+        "goal": "Define flows, states, layout behavior, visual references, and accessibility expectations."
+      },
+      {
+        "id": "architecture",
+        "title": "Architecture",
+        "primaryRole": "architect",
+        "partyRoles": [
+          "frontend",
+          "backend",
+          "database",
+          "security",
+          "devops",
+          "performance"
+        ],
+        "artifact": "architecture",
+        "goal": "Choose the system shape, data contracts, boundaries, dependencies, and deployment path."
+      },
+      {
+        "id": "story",
+        "title": "Implementation Story",
+        "primaryRole": "planner",
+        "partyRoles": [
+          "coder",
+          "tester",
+          "reviewer"
+        ],
+        "artifact": "story",
+        "goal": "Break approved scope into implementable tasks with acceptance checks."
+      },
+      {
+        "id": "readiness",
+        "title": "Readiness Gate",
+        "primaryRole": "reviewer",
+        "partyRoles": [
+          "architect",
+          "tester",
+          "security"
+        ],
+        "artifact": "readiness-report",
+        "goal": "Confirm the work is clear enough to code without guessing."
+      },
+      {
+        "id": "implementation",
+        "title": "Implementation",
+        "primaryRole": "coder",
+        "partyRoles": [
+          "frontend",
+          "backend",
+          "database",
+          "tester"
+        ],
+        "artifact": "implementation-notes",
+        "goal": "Build the approved story with small safe changes and autosycn."
+      },
+      {
+        "id": "review",
+        "title": "Review",
+        "primaryRole": "reviewer",
+        "partyRoles": [
+          "tester",
+          "security",
+          "performance",
+          "ux"
+        ],
+        "artifact": "review",
+        "goal": "Find defects, regressions, missing tests, UX mismatch, and security/performance risks."
+      },
+      {
+        "id": "release",
+        "title": "Release",
+        "primaryRole": "devops",
+        "partyRoles": [
+          "github",
+          "deploy",
+          "reviewer",
+          "memory"
+        ],
+        "artifact": "release-notes",
+        "goal": "Prepare deploy, handoff, changelog, and merge/release confirmation."
+      }
+    ]
+  },
+  "artifacts": {
+    "enabled": true,
+    "directory": ".MOP/artifacts",
+    "templateDirectory": ".MOP/templates/artifacts",
+    "layout": "category/artifact-slug/type.md",
+    "defaultCategory": "general",
+    "folderByType": {
+      "product-brief": "plan",
+      "prd": "plan",
+      "ux-spec": "design",
+      "architecture": "architecture",
+      "story": "plan",
+      "readiness-report": "readiness",
+      "implementation-notes": "implementation",
+      "review": "review",
+      "adversarial-review": "review",
+      "release-notes": "release",
+      "handoff": "release",
+      "decision-log": "decisions"
+    },
+    "types": [
+      "product-brief",
+      "prd",
+      "ux-spec",
+      "architecture",
+      "story",
+      "readiness-report",
+      "implementation-notes",
+      "review",
+      "adversarial-review",
+      "release-notes",
+      "handoff",
+      "decision-log"
+    ]
+  },
+  "customization": {
+    "enabled": true,
+    "layerOrder": [
+      "defaults",
+      "team",
+      "member"
+    ],
+    "files": {
+      "defaults": ".MOP/config/defaults.json",
+      "team": ".MOP/config/team.json",
+      "memberPattern": ".MOP/config/members/<codename>.json"
+    },
+    "rules": [
+      "Defaults define safe project behavior.",
+      "Team config may override workflow preferences and agent policy.",
+      "Member config may override language, preferred agents, and UI verbosity.",
+      "Customization must not bypass auth, agent gate, autosycn identity, or BURHAN-MOP review."
+    ]
+  },
+  "mopFlow": {
+    "enabled": true,
+    "brand": "MOP Flow",
+    "canonicalMcpServer": "mop-flow",
+    "upstreamRuntime": "ruflo@latest",
+    "legacyRuntimeNames": [
+      "Ruflo",
+      "Claude Flow"
+    ],
+    "portableSkillDir": ".agents/skills",
+    "runtimeNativeSkillDir": ".claude/skills",
+    "manifest": ".MOP/flow/skill-manifest.json",
+    "statusCommand": "node .MOP/scripts/mop-flow.mjs status --json",
+    "manifestCommand": "node .MOP/scripts/mop-flow.mjs manifest refresh",
+    "providerParity": {
+      "enabled": true,
+      "providers": [
+        "claude",
+        "codex",
+        "gemini",
+        "antigravity"
+      ],
+      "rule": "All providers use MOP auth, memory, agent routing, workflow, and bridged skill inventory before provider-specific runtime behavior."
+    },
+    "rules": [
+      "MOP Flow is the user-facing brand.",
+      "Ruflo and Claude Flow are upstream runtime compatibility names only.",
+      "Bridge .claude/skills through the MOP Flow manifest for non-Claude providers.",
+      "Do not let provider-specific tools bypass MOP gates."
+    ]
+  },
+  "projectRootPolicy": {
+    "enabled": true,
+    "workInWorkspaceRoot": true,
+    "forbidNestedProjectFolder": true,
+    "rootPathMeaning": "The current workspace root is the app/project root.",
+    "forbiddenExamples": [
+      "portfolio/",
+      "my-app/",
+      "<project-name>/"
+    ],
+    "allowedTopLevelDirs": [
+      "src",
+      "app",
+      "pages",
+      "components",
+      "public",
+      "assets",
+      "tests",
+      "docs",
+      "config",
+      "scripts",
+      ".github",
+      ".MOP",
+      ".agents",
+      ".claude",
+      ".codex",
+      ".gemini"
+    ],
+    "rules": [
+      "When building or scaffolding a user project, create files directly in the workspace root.",
+      "Do not create a nested folder named after the app, product, or project and place the implementation there.",
+      "Use normal top-level app folders such as src, app, pages, components, public, assets, tests, docs, config, and scripts.",
+      "If a framework command wants to create a new project directory, use the current-directory mode or move generated files to root before continuing.",
+      "Ask for explicit permission only when the user truly wants a monorepo or multiple apps."
+    ]
+  },
+  "readinessGate": {
+    "enabled": true,
+    "requiredBeforeImplementation": true,
+    "minimumStatusToCode": "ready",
+    "checks": [
+      "intent-clear",
+      "user-and-success-defined",
+      "scope-bounded",
+      "artifacts-current",
+      "data-contract-clear",
+      "acceptance-criteria-present",
+      "risks-reviewed",
+      "tests-planned",
+      "rollback-or-undo-known"
+    ]
+  },
+  "adversarialReview": {
+    "enabled": true,
+    "name": "Adversarial Review",
+    "defaultMode": "constructive-red-team",
+    "triggers": [
+      "before-implementation",
+      "before-merge",
+      "security-sensitive",
+      "architecture-change",
+      "user-asks-review"
+    ],
+    "reviewRoles": [
+      "reviewer",
+      "security",
+      "performance",
+      "ux",
+      "tester"
+    ],
+    "rules": [
+      "Challenge assumptions without dismissing the user's goal.",
+      "Find failure modes, edge cases, hidden scope, and missing tests.",
+      "Propose fixes or safer alternatives for each serious finding.",
+      "Block implementation when requirements are too unclear."
+    ]
+  },
+  "installer": {
+    "enabled": true,
+    "packageName": "mop-flow",
+    "legacyPackageName": "burhan-mop",
+    "command": "npx mop-flow install",
+    "legacyCommand": "npx burhan-mop install",
+    "entrypoint": ".MOP/scripts/burhan-mop.mjs",
+    "installTargets": [
+      "provider entrypoints",
+      "MOP state",
+      "skills",
+      "workflow config",
+      "artifact templates"
+    ]
+  },
+  "mode": null,
+  "joinMode": "owner-approved",
+  "githubUrl": "",
+  "autosync": {
+    "enabled": true,
+    "targetMainBranch": "main",
+    "workBranchPrefix": "dev",
+    "preflightBeforeWork": true,
+    "secretScanBeforeCommit": true,
+    "autoMergeToMain": true,
+    "mergeGuardian": {
+      "enabled": true,
+      "name": "BURHAN-MOP",
+      "autoReviewAfterPush": true,
+      "decision": "required",
+      "commitAsGuardianWhenIdentityConfigured": false,
+      "gitIdentity": {
+        "name": "BURHAN-MOP",
+        "email": ""
+      },
+      "checks": {
+        "workingTreeCleanAfterCommit": true,
+        "branchUpToDateWithMain": true,
+        "stateValid": true,
+        "secretScan": true,
+        "mergeConflict": true,
+        "testCommand": "",
+        "buildCommand": ""
+      }
+    },
+    "requireUserGitEmail": true,
+    "verifyGhUserWhenConfigured": true,
+    "githubIdentity": {
+      "requireMatchedGhUser": true,
+      "useNoreplyForMemberCommits": true,
+      "noreplyFormat": "id-plus-login",
+      "rules": [
+        "Member commits must use the active member GitHub account, not an AI or guardian identity.",
+        "When gh is authenticated, derive member commit email as ID+USERNAME@users.noreply.github.com.",
+        "Refuse autosycn if the active gh account does not match the member githubUsername.",
+        "BURHAN-MOP identity is reserved for merge guardian commits only."
+      ]
+    }
+  },
+  "members": {},
+  "installedSkills": [
+    {
+      "name": "mop-flow",
+      "purpose": "Provider-neutral skill bridge and runtime wrapper. Makes MOP the canonical layer above Ruflo / Claude Flow across Claude, Codex, Gemini, and Antigravity."
+    },
+    {
+      "name": "autosycn",
+      "purpose": "Identity-safe memory + git autosync flow. Commits and merges as the active user, never as the AI tool."
+    },
+    {
+      "name": "auto-deploy",
+      "purpose": "Opt-in deployment setup for GitHub Pages or Actions, Docker, and Vercel. Must ask before activation."
+    },
+    {
+      "name": "mop-help",
+      "purpose": "Workflow-aware help skill. Answers what to do next, which agent should lead, and which artifact or gate applies."
+    }
+  ],
+  "deployment": {
+    "enabled": false,
+    "requireConfirmation": true,
+    "providers": {
+      "github": {
+        "enabled": false,
+        "mode": "pages-or-actions"
+      },
+      "docker": {
+        "enabled": false,
+        "mode": "dockerfile-compose"
+      },
+      "vercel": {
+        "enabled": false,
+        "mode": "project-link"
+      }
+    }
+  },
+  "agentRoster": [],
+  "agentCatalog": [
+    {
+      "role": "core",
+      "title": "Core Agent",
+      "kind": "orchestrator",
+      "purpose": "Default high-context conversation owner and final coordinator."
+    },
+    {
+      "role": "planner",
+      "title": "Product Planner",
+      "kind": "thinking",
+      "purpose": "Clarifies ideas, scopes products, asks questions, and turns vague requests into workable plans."
+    },
+    {
+      "role": "researcher",
+      "title": "Researcher",
+      "kind": "thinking",
+      "purpose": "Finds requirements, references, constraints, and missing context."
+    },
+    {
+      "role": "architect",
+      "title": "System Architect",
+      "kind": "thinking",
+      "purpose": "High-reasoning system design, architecture, tradeoffs, and context control."
+    },
+    {
+      "role": "coder",
+      "title": "Coder",
+      "kind": "implementation",
+      "purpose": "General code implementation after requirements are clear."
+    },
+    {
+      "role": "frontend",
+      "title": "Frontend Developer",
+      "kind": "implementation",
+      "purpose": "UI, React, Next.js, styling, state, responsive behavior, and browser UX."
+    },
+    {
+      "role": "backend",
+      "title": "Backend Developer",
+      "kind": "implementation",
+      "purpose": "APIs, server logic, authentication, integrations, and business rules."
+    },
+    {
+      "role": "database",
+      "title": "Database Engineer",
+      "kind": "implementation",
+      "purpose": "Schemas, migrations, queries, indexes, and data lifecycle."
+    },
+    {
+      "role": "mobile",
+      "title": "Mobile Developer",
+      "kind": "implementation",
+      "purpose": "iOS, Android, React Native, Flutter, PWA, offline workflows."
+    },
+    {
+      "role": "tester",
+      "title": "Tester",
+      "kind": "quality",
+      "purpose": "Test strategy, unit/integration/e2e coverage, regression checks, and bug reproduction."
+    },
+    {
+      "role": "reviewer",
+      "title": "Reviewer",
+      "kind": "quality",
+      "purpose": "Code review, risk review, maintainability, and final quality gate."
+    },
+    {
+      "role": "security",
+      "title": "Security Specialist",
+      "kind": "quality",
+      "purpose": "Threat modelling, auth, secrets, permissions, dependency risk, and hardening."
+    },
+    {
+      "role": "performance",
+      "title": "Performance Engineer",
+      "kind": "quality",
+      "purpose": "Speed, memory, bundle size, database/query performance, and profiling."
+    },
+    {
+      "role": "github",
+      "title": "GitHub Coordinator",
+      "kind": "operations",
+      "purpose": "GitHub repo, branch, PR, issue, release, and merge workflow."
+    },
+    {
+      "role": "browser",
+      "title": "Browser Automation Agent",
+      "kind": "operations",
+      "purpose": "Browser preflight, scraping, rendered extraction, clicking, form filling, login flows, and browser-act coordination."
+    },
+    {
+      "role": "devops",
+      "title": "DevOps Engineer",
+      "kind": "operations",
+      "purpose": "CI/CD, Docker, infrastructure, environment config, and deployment pipeline."
+    },
+    {
+      "role": "deploy",
+      "title": "Deployment Specialist",
+      "kind": "operations",
+      "purpose": "GitHub Pages/Actions, Docker deployment, Vercel setup, and release handoff."
+    },
+    {
+      "role": "memory",
+      "title": "Memory Keeper",
+      "kind": "memory",
+      "purpose": "Save, recall, summarize, search, and clean long-term MOP records."
+    },
+    {
+      "role": "ux",
+      "title": "UX Researcher",
+      "kind": "design",
+      "purpose": "User flows, pain points, personas, usability, and product behavior."
+    },
+    {
+      "role": "design",
+      "title": "UI/UX Designer",
+      "kind": "design",
+      "purpose": "Visual design, layouts, components, accessibility, and interaction polish."
+    },
+    {
+      "role": "accessibility",
+      "title": "Accessibility Specialist",
+      "kind": "quality",
+      "purpose": "Keyboard flow, screen reader behavior, contrast, reduced motion, and inclusive interaction checks."
+    },
+    {
+      "role": "docs",
+      "title": "Documentation Writer",
+      "kind": "communication",
+      "purpose": "README, guides, prompts, specs, changelogs, and concise user-facing docs."
+    },
+    {
+      "role": "prompt",
+      "title": "Prompt Engineer",
+      "kind": "ai",
+      "purpose": "Prompt systems, AI workflow design, context discipline, and model behavior."
+    },
+    {
+      "role": "seo",
+      "title": "SEO Strategist",
+      "kind": "marketing",
+      "purpose": "Technical SEO, metadata, schema, content structure, and search readiness."
+    }
+  ],
+  "ledger": [
+    {
+      "at": "2026-06-11T00:00:00.000Z",
+      "actor": "system",
+      "kind": "state-created",
+      "summary": "MOP state scaffold created; setup pending."
+    }
+  ]
+}