@amoree-code/ocean 0.0.0-stage → 1.2.0

package/ocean-marketplace.json

@@ -0,0 +1,415 @@
+{
+  "schemaVersion": 1,
+  "name": "ocean-engine",
+  "capabilities": [
+    {
+      "kind": "skill",
+      "name": "dev.ocean.skills.business-logic",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "skills/core/business-logic"
+      },
+      "integrity": {
+        "sha256": "31b1ffc059cb76384100e294c9eeda0c977efa58b732fdcc6120cefea9151697"
+      },
+      "spec": {
+        "directory": "business-logic"
+      }
+    },
+    {
+      "kind": "skill",
+      "name": "dev.ocean.skills.catch-up",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "skills/core/catch-up"
+      },
+      "integrity": {
+        "sha256": "724b99fb618118cdd95b023d6c8c7e9537031d8042038d127bf5f5389a3feebc"
+      },
+      "spec": {
+        "directory": "catch-up"
+      }
+    },
+    {
+      "kind": "skill",
+      "name": "dev.ocean.skills.core-thinking",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "skills/core/core-thinking"
+      },
+      "integrity": {
+        "sha256": "7dc3991627849cba9148fc5d0c921faa347ed31499029d069940e78c980571d3"
+      },
+      "spec": {
+        "directory": "core-thinking"
+      }
+    },
+    {
+      "kind": "skill",
+      "name": "dev.ocean.skills.design-thinking",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "skills/core/design-thinking"
+      },
+      "integrity": {
+        "sha256": "bb4d35f5135aa219f57935b918bebb74cd0d99851945abd05facc98f307b6b64"
+      },
+      "spec": {
+        "directory": "design-thinking"
+      }
+    },
+    {
+      "kind": "skill",
+      "name": "dev.ocean.skills.graft",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "skills/core/graft"
+      },
+      "integrity": {
+        "sha256": "3144c8c50226702de281618ffb189290856c9aa438e0da6fdb8bba52f3a5a143"
+      },
+      "spec": {
+        "directory": "graft"
+      }
+    },
+    {
+      "kind": "skill",
+      "name": "dev.ocean.skills.loop",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "skills/core/loop"
+      },
+      "integrity": {
+        "sha256": "a792828f2efcc546ba4709b9a1a72d37fc3e63b7f674b057ca10e889a53f1dda"
+      },
+      "spec": {
+        "directory": "loop"
+      }
+    },
+    {
+      "kind": "skill",
+      "name": "dev.ocean.skills.session-handoff",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "skills/core/session-handoff"
+      },
+      "integrity": {
+        "sha256": "912d30e379f5a4ae7486cef723c46bb7752c71268ea4710c99ccf4668c84d49a"
+      },
+      "spec": {
+        "directory": "session-handoff"
+      }
+    },
+    {
+      "kind": "skill",
+      "name": "dev.ocean.skills.use-browser",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "skills/core/use-browser"
+      },
+      "integrity": {
+        "sha256": "1b4f2d81776efabfbebea325b0d1f85c7bc699f443e54501efe3aaf1cb0f31d4"
+      },
+      "spec": {
+        "directory": "use-browser"
+      }
+    },
+    {
+      "kind": "skill",
+      "name": "dev.ocean.skills.verification",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "skills/core/verification"
+      },
+      "integrity": {
+        "sha256": "ff7c3ddf015743a1939a914edb5bcaae37763192f214d8e4c79fb883f5500604"
+      },
+      "spec": {
+        "directory": "verification"
+      }
+    },
+    {
+      "kind": "mcp",
+      "name": "dev.ocean/chrome-devtools",
+      "description": "Control the owner's real, signed-in Chrome through Chrome DevTools MCP: tabs, navigation, clicks, forms, screenshots, console and network errors. Reads every open tab and acts inside any signed-in session of the attached profile, for every client that uses the Ocean gateway. The filesystem permission is declared for consent but not enforced at runtime, and the npm package is pinned by version, not by digest.",
+      "permissions": {
+        "filesystem": {
+          "read": [
+            "~/Library/Application Support/Google/Chrome"
+          ]
+        },
+        "network": [
+          "registry.npmjs.org",
+          "localhost",
+          "127.0.0.1"
+        ],
+        "exec": [
+          "npx"
+        ]
+      },
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "market/mcp/chrome-devtools"
+      },
+      "integrity": {
+        "sha256": "1c9b4bf3711ce9908690268722ff73721a5fc7a0e42c130bd237d9d817264a3a"
+      },
+      "spec": {
+        "name": "dev.ocean/chrome-devtools",
+        "description": "Chrome DevTools MCP attached to the owner's running Chrome. Usage statistics and CrUX lookups are off, so page URLs stay on this machine.",
+        "packages": [
+          {
+            "registryType": "npm",
+            "identifier": "chrome-devtools-mcp",
+            "version": "1.12.0",
+            "transport": {
+              "type": "stdio"
+            },
+            "packageArguments": [
+              {
+                "type": "positional",
+                "value": "--autoConnect"
+              },
+              {
+                "type": "positional",
+                "value": "--no-usage-statistics"
+              },
+              {
+                "type": "positional",
+                "value": "--no-performance-crux"
+              }
+            ]
+          }
+        ],
+        "_meta": {
+          "dev.ocean": {
+            "clientKey": "chrome-devtools"
+          }
+        }
+      }
+    },
+    {
+      "kind": "mcp",
+      "name": "dev.ocean/mcp-gateway",
+      "description": "One MCP endpoint for every registered server: Ocean's own and those installed from the marketplace.",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "market/mcp/gateway"
+      },
+      "integrity": {
+        "sha256": "ffff5a2c48452147caa2bf064c86a1155fea17af32212e5f40afb76e852571d0"
+      },
+      "spec": {
+        "name": "dev.ocean/mcp-gateway",
+        "description": "Lists and routes the tools of every registered MCP server behind one stdio endpoint.",
+        "packages": [
+          {
+            "registryType": "ocean-engine",
+            "identifier": "ocean",
+            "transport": {
+              "type": "stdio"
+            },
+            "packageArguments": [
+              {
+                "type": "positional",
+                "value": "mcp"
+              },
+              {
+                "type": "positional",
+                "value": "gateway"
+              }
+            ]
+          }
+        ],
+        "_meta": {
+          "dev.ocean": {
+            "clientKey": "ocean-gateway"
+          }
+        }
+      }
+    },
+    {
+      "kind": "mcp",
+      "name": "dev.ocean/obsidian",
+      "description": "Ocean's Obsidian vault bridge over MCP.",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "market/mcp/obsidian"
+      },
+      "integrity": {
+        "sha256": "d0c658f2aa5d54146900e98d3d8ce0df313e3799a754c872a568152ef9089705"
+      },
+      "spec": {
+        "name": "dev.ocean/obsidian",
+        "description": "Read and sync an Obsidian vault through Ocean.",
+        "packages": [
+          {
+            "registryType": "ocean-engine",
+            "identifier": "ocean",
+            "transport": {
+              "type": "stdio"
+            },
+            "packageArguments": [
+              {
+                "type": "positional",
+                "value": "obsidian"
+              },
+              {
+                "type": "positional",
+                "value": "mcp"
+              }
+            ]
+          }
+        ],
+        "_meta": {
+          "dev.ocean": {
+            "clientKey": "ocean-obsidian"
+          }
+        }
+      }
+    },
+    {
+      "kind": "mcp",
+      "name": "dev.ocean/ocean",
+      "description": "Ocean's own MCP server: workspace status, tasks, handoffs, sessions and the brain.",
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "market/mcp/ocean"
+      },
+      "integrity": {
+        "sha256": "4c1a7482efd8e1a96393a4ca913335b111e4744106e2b9230948360143aea3aa"
+      },
+      "spec": {
+        "name": "dev.ocean/ocean",
+        "description": "Ocean workspace, tasks, sessions and brain over MCP.",
+        "packages": [
+          {
+            "registryType": "ocean-engine",
+            "identifier": "ocean",
+            "transport": {
+              "type": "stdio"
+            },
+            "packageArguments": [
+              {
+                "type": "positional",
+                "value": "mcp"
+              },
+              {
+                "type": "positional",
+                "value": "serve"
+              }
+            ]
+          }
+        ],
+        "_meta": {
+          "dev.ocean": {
+            "clientKey": "ocean"
+          }
+        }
+      }
+    },
+    {
+      "kind": "mcp",
+      "name": "com.microsoft/playwright-mcp",
+      "description": "Playwright browser automation through the browser extension.",
+      "permissions": {
+        "network": [
+          "registry.npmjs.org",
+          "localhost",
+          "127.0.0.1"
+        ],
+        "exec": [
+          "npx"
+        ]
+      },
+      "version": "1.2.0",
+      "engines": {
+        "ocean": ">=1.2.0"
+      },
+      "source": {
+        "type": "path",
+        "path": "market/mcp/playwright"
+      },
+      "integrity": {
+        "sha256": "2b316d3ea88c629cd7ecea8e7671ab253232059b331e1189dfba39096219d437"
+      },
+      "spec": {
+        "name": "com.microsoft/playwright-mcp",
+        "description": "Browser automation with Playwright.",
+        "packages": [
+          {
+            "registryType": "npm",
+            "identifier": "@playwright/mcp",
+            "version": "0.0.84",
+            "transport": {
+              "type": "stdio"
+            },
+            "packageArguments": [
+              {
+                "type": "positional",
+                "value": "--extension"
+              }
+            ]
+          }
+        ],
+        "_meta": {
+          "dev.ocean": {
+            "clientKey": "playwright"
+          }
+        }
+      }
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,69 @@
 {
   "name": "@amoree-code/ocean",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "description": "Local-first memory, tasks and session capture shared by every AI coding client: one private workspace for Claude, Codex, Gemini and more.",
+  "version": "1.2.0",
+  "private": false,
+  "license": "MIT",
+  "author": "AMEER ABDULKAREEM JABBAR LAMI",
+  "homepage": "https://github.com/amoree-code/ocean#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amoree-code/ocean.git",
+    "directory": "packages/harness"
+  },
+  "bugs": {
+    "url": "https://github.com/amoree-code/ocean/issues"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "cli",
+    "memory",
+    "mcp",
+    "claude",
+    "codex",
+    "gemini",
+    "local-first"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=22.16.0"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "skills",
+    "market",
+    "ocean-marketplace.json"
+  ],
+  "bin": {
+    "ocean": "./dist/main.js"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.289",
+    "@anthropic-ai/sdk": "0.131.0",
+    "@langchain/core": "1.2.14",
+    "@langchain/langgraph": "1.4.19",
+    "@modelcontextprotocol/sdk": "1.32.0",
+    "@ocean/brain": "1.2.0",
+    "@ocean/context": "1.2.0",
+    "@ocean/core": "1.2.0",
+    "@ocean/loop": "1.2.0",
+    "@ocean/market": "1.2.0",
+    "@ocean/services": "1.2.0",
+    "playwright-core": "^1.48.0",
+    "sqlite-vec": "0.1.9",
+    "zod": "^4.6.5"
+  },
+  "optionalDependencies": {
+    "node-pty": "^1.1.0"
+  },
+  "bundleDependencies": [
+    "@ocean/brain",
+    "@ocean/context",
+    "@ocean/core",
+    "@ocean/loop",
+    "@ocean/market",
+    "@ocean/services"
+  ]
+}

package/skills/core/business-logic/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: business-logic
+description: Convert a product request into explicit rules, states, permissions, exceptions, and verifiable acceptance criteria.
+version: 1.0.0
+category: core
+---
+
+# Business Logic
+
+Use after the desired outcome is understood and before implementation.
+
+Describe:
+
+- inputs and outputs;
+- entities and state transitions;
+- rules and precedence when rules conflict;
+- permissions and approval boundaries;
+- validation and failure cases;
+- idempotency and retry safety;
+- acceptance criteria and verification signals.
+
+Keep rules domain-specific and executable. Never invent missing policy, identity, money, legal, or academic data; mark it as a blocker.

package/skills/core/catch-up/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: catch-up
+description: Reconstruct the current project state, completed work, blockers, and next action.
+version: 1.0.0
+category: core
+---
+
+# Catch up
+
+Reconstruct only the context needed to continue safely.
+
+1. Identify the active project and branch.
+2. Read the authoritative task or session record, then inspect the current worktree.
+3. Separate verified completed work from assumptions and stale history.
+4. Report: project, last objective, proven work, remaining work, blockers, and one next action.
+
+Read the smallest set of files that proves the answer. Do not modify files while catching up.

package/skills/core/core-thinking/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: core-thinking
+description: Analyze goals, constraints, risks, and evidence before execution.
+version: 1.0.0
+category: core
+---
+
+# Core Thinking
+
+Identify the goal, separate facts from assumptions, choose the smallest valid solution,
+and define evidence that can prove the result.

package/skills/core/design-thinking/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: design-thinking
+description: Frame a problem, clarify the desired outcome, compare simple solutions, and define success before implementation.
+version: 1.0.0
+category: core
+---
+
+# Design Thinking
+
+Use before non-trivial implementation or open-ended work.
+
+1. State the user outcome in one sentence.
+2. Separate observed facts, constraints, assumptions, and unknowns.
+3. Identify the smallest useful result and the people or systems it affects.
+4. Compare viable approaches by correctness, risk, complexity, and reversibility.
+5. Choose the smallest approach that meets the outcome.
+6. Define the evidence that proves completion before execution.
+
+Do not turn exploration into implementation without a clear outcome. Ask one focused question only when a missing choice materially changes the solution.