@nikelyh/offscript 0.0.0-stage → 1.0.0

package/dist/studio/brand/logo-perspectives.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" aria-labelledby="perspectives-title" color="#237763" role="img" viewBox="0 0 64 64"><title id="perspectives-title">OFFSCRIPT — Perspectives</title><path fill="currentColor" d="M5 17 34 7v16l-8-3v-2l-13 5v15l7 2v9L5 44Zm34 5 20 5v23l-11 4v-9l3-1V33l-12-3Z"/><path fill="currentColor" fill-rule="evenodd" d="m24 27 21 6v22l-21 7Zm8 11v13l5-2V40Z" clip-rule="evenodd"/></svg>

package/dist/studio/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" aria-labelledby="perspectives-title" color="#237763" role="img" viewBox="0 0 64 64"><style>@media (prefers-color-scheme:dark){svg{color:#78c8ad}}</style><title id="perspectives-title">OFFSCRIPT — Perspectives</title><path fill="currentColor" d="M5 17 34 7v16l-8-3v-2l-13 5v15l7 2v9L5 44Zm34 5 20 5v23l-11 4v-9l3-1V33l-12-3Z"/><path fill="currentColor" fill-rule="evenodd" d="m24 27 21 6v22l-21 7Zm8 11v13l5-2V40Z" clip-rule="evenodd"/></svg>

package/dist/studio/index.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" sizes="any" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>offscript</title>
+    <script type="module" crossorigin src="/assets/index-uXpu7a13.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-Dh5KHl3J.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist/studio/licenses/jetbrains-mono.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono) JetBrainsMono-Italic[wght].ttf: Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/studio/licenses/space-grotesk.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Space Grotesk Project Authors (https://github.com/floriankarsten/space-grotesk)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/offscript.mjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import { readFileSync, statSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+
+function resolveCliScript() {
+  const dist = new URL("./dist/scripts/server/cli-results.js", import.meta.url);
+  try {
+    if (statSync(dist).isFile()) return dist.href;
+  } catch {}
+  const dev = new URL("./scripts/server/cli-results.ts", import.meta.url);
+  try {
+    if (statSync(dev).isFile()) return dev.href;
+  } catch {}
+  throw new Error("Distribution is missing. Run npm run build:local in the OFFSCRIPT checkout, or reinstall the archive.");
+}
+
+try {
+  const { values, positionals } = parseArgs({ allowPositionals: true, options: {
+    project: { type: "string" }, port: { type: "string" }, "data-directory": { type: "string" },
+    "no-studio": { type: "boolean" }, "no-open": { type: "boolean" }, cancel: { type: "boolean" },
+    help: { type: "boolean", short: "h" }, version: { type: "boolean", short: "v" },
+  } });
+  const command = positionals[0];
+  const isResults = command === "results";
+  const isRecover = command === "recover";
+  const isTargeted = isResults || isRecover;
+  const validCommands = ["studio", "serve", "list", "results", "recover"];
+  if (
+    (command !== undefined && !validCommands.includes(command)) ||
+    (isTargeted && positionals.length !== 2) ||
+    (!isTargeted && positionals.length > 1)
+  ) {
+    throw new Error("Expected studio, serve, list, results <simulation-id>, or recover <simulation-id>. Use --help for usage.");
+  }
+  if ((command === "studio" && values["no-studio"]) ||
+      ((command === "serve" || values["no-studio"]) && values["no-open"]) ||
+      ((command === "list" || isTargeted) && (values["no-studio"] || values["no-open"] || values.port))) {
+    throw new Error("Conflicting options for command. Use --help for usage.");
+  }
+  if (values.help) {
+    console.log(`Usage: offscript [command] [options]
+
+Commands:
+  studio                 Serve Studio/API and open the secure local entry (default).
+  serve                  Serve the API only.
+  list                   List saved simulations for the project.
+  results <id>           Inspect exploration results (findings, observations, investigations).
+  recover <id>           Explicitly settle an interrupted simulation to failed (or cancelled with --cancel).
+
+Options:
+  --project <directory>  Target project (default: current directory).
+  --port <number>        Loopback port, 0 selects an available port (default: 0).
+  --data-directory <dir> Storage directory, relative to the target project.
+  --cancel               When recovering, mark as cancelled instead of failed.
+  --no-open             Print the Studio entry without opening a browser.
+  --no-studio           Legacy alias for serve.
+  -h, --help            Show help without starting the host.
+  -v, --version         Show the package version without starting the host.
+
+Flags override OFFSCRIPT_PROJECT_ROOT, OFFSCRIPT_PORT, OFFSCRIPT_DATA_DIRECTORY.
+No agents or target services start automatically.`);
+  } else if (values.version) {
+    console.log(JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8")).version);
+  } else {
+    const project = values.project ?? process.env.OFFSCRIPT_PROJECT_ROOT ?? process.cwd();
+    try {
+      if (!project.trim() || !statSync(project).isDirectory()) throw new Error();
+    } catch { throw new Error("Project must reference an existing, accessible directory."); }
+    const dataDirectory = values["data-directory"] ?? process.env.OFFSCRIPT_DATA_DIRECTORY;
+    if (dataDirectory !== undefined && !dataDirectory.trim()) throw new Error("Storage directory must not be blank.");
+
+    if (command === "list") {
+      const { executeListCommand } = await import(resolveCliScript());
+      await executeListCommand({ projectRoot: project, ...(dataDirectory !== undefined ? { dataDirectory } : {}) });
+    } else if (isResults) {
+      const { executeResultsCommand } = await import(resolveCliScript());
+      await executeResultsCommand({ projectRoot: project, simulationId: positionals[1] ?? "", ...(dataDirectory !== undefined ? { dataDirectory } : {}) });
+    } else if (isRecover) {
+      const { executeRecoverCommand } = await import(resolveCliScript());
+      await executeRecoverCommand({ projectRoot: project, simulationId: positionals[1] ?? "", cancel: Boolean(values.cancel), ...(dataDirectory !== undefined ? { dataDirectory } : {}) });
+    } else {
+      const port = values.port ?? process.env.OFFSCRIPT_PORT ?? "0";
+      if (!/^\d+$/.test(port) || !Number.isSafeInteger(Number(port)) || Number(port) > 65535) {
+        throw new Error("Port must be an integer between 0 and 65535.");
+      }
+      const studio = command !== "serve" && !values["no-studio"];
+      try {
+        if (!statSync(new URL("./dist/scripts/server/run.js", import.meta.url)).isFile()) throw new Error();
+        if (studio && !statSync(new URL("./dist/studio/index.html", import.meta.url)).isFile()) throw new Error();
+      } catch { throw new Error("Distribution is missing. Run npm run build:local in the OFFSCRIPT checkout, or reinstall the archive."); }
+      process.env.OFFSCRIPT_PROJECT_ROOT = project;
+      process.env.OFFSCRIPT_PORT = port;
+      if (dataDirectory !== undefined) process.env.OFFSCRIPT_DATA_DIRECTORY = dataDirectory;
+      if (studio) process.env.OFFSCRIPT_STUDIO_DIRECTORY = fileURLToPath(new URL("./dist/studio/", import.meta.url));
+      else delete process.env.OFFSCRIPT_STUDIO_DIRECTORY;
+      process.env.OFFSCRIPT_OPEN_BROWSER = studio && !values["no-open"] ? "1" : "0";
+      await import("./dist/scripts/server/run.js");
+    }
+  }
+} catch (error) {
+  console.error(`OFFSCRIPT: ${error instanceof Error ? error.message : "Could not launch. Use --help for usage."}`);
+  process.exitCode = 1;
+}

package/package.json

@@ -1,6 +1,102 @@
 {
   "name": "@nikelyh/offscript",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "type": "module",
+  "scripts": {
+    "prepare": "node -e \"if (process.env.HUSKY !== '0') import('husky').then(m => m.default()).catch(() => {})\"",
+    "lint": "npm run lint:packages && npm --prefix apps/studio run lint",
+    "build": "npm --prefix apps/studio run build",
+    "check": "npm run typecheck:domain && npm run typecheck:contracts && npm run typecheck:application && npm run typecheck:browser && npm run typecheck:orchestration && npm run typecheck:persistence && npm run typecheck:runtime && npm run typecheck:server && npm run typecheck:projects && npm run db:check && npm --prefix apps/studio run typecheck:tests && npm test && npm run lint && npm run build",
+    "commitlint": "commitlint",
+    "typecheck:domain": "tsc -p packages/domain/tsconfig.json && tsc -p packages/domain/tests/tsconfig.json",
+    "test:domain": "node --test packages/domain/tests/*.test.ts",
+    "test": "npm run test:domain && npm run test:contracts && npm run test:application && npm run test:browser && npm run test:orchestration && npm run test:persistence && npm run test:runtime && npm run test:server && npm run test:projects && npm --prefix apps/studio test",
+    "typecheck:browser": "tsc -p packages/browser/tsconfig.json && tsc -p packages/browser/tests/tsconfig.json",
+    "test:browser": "node --test packages/browser/tests/*.test.ts",
+    "typecheck:application": "tsc -p packages/application/tsconfig.json && tsc -p packages/application/tests/tsconfig.json",
+    "test:application": "node --test packages/application/tests/*.test.ts",
+    "typecheck:contracts": "tsc -p packages/contracts/tsconfig.json && tsc -p packages/contracts/tests/tsconfig.json",
+    "test:contracts": "node --test packages/contracts/tests/*.test.ts",
+    "typecheck:orchestration": "tsc -p packages/orchestration/tsconfig.json && tsc -p packages/orchestration/tests/tsconfig.json",
+    "test:orchestration": "node --import ./packages/orchestration/tests/setup.ts --test packages/orchestration/tests/*.test.ts",
+    "demo:mozaik": "node scripts/mozaik/run.ts",
+    "typecheck:persistence": "tsc -p packages/persistence/tsconfig.json && tsc -p packages/persistence/tests/tsconfig.json",
+    "test:persistence": "node --test packages/persistence/tests/*.test.ts",
+    "db:generate": "drizzle-kit generate",
+    "db:check": "drizzle-kit check",
+    "lint:packages": "npm exec --prefix apps/studio --offline -- oxlint packages scripts drizzle.config.ts offscript.mjs",
+    "typecheck:runtime": "tsc -p packages/runtime/tsconfig.json && tsc -p packages/runtime/tests/tsconfig.json",
+    "test:runtime": "node --test packages/runtime/tests/*.test.ts",
+    "typecheck:server": "tsc -p packages/server/tsconfig.json && tsc -p packages/server/tests/tsconfig.json",
+    "test:server": "node --test packages/server/tests/*.test.ts",
+    "dev:server": "node scripts/server/run.ts",
+    "typecheck:projects": "tsc -p packages/projects/tsconfig.json && tsc -p packages/projects/tests/tsconfig.json",
+    "test:projects": "node --test packages/projects/tests/*.test.ts",
+    "build:local": "node scripts/server/distribution-clean.ts && npm run build && tsc -p tsconfig.distribution.json && node scripts/server/distribution-assets.ts",
+    "start": "node offscript.mjs",
+    "prepack": "npm run build:local"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^21.2.4",
+    "@commitlint/config-conventional": "^21.2.4",
+    "@types/better-sqlite3": "9.6.0",
+    "@types/node": "^26.6.5",
+    "drizzle-kit": "0.31.11",
+    "husky": "^9.1.7",
+    "typescript": "~7.0.2"
+  },
+  "dependencies": {
+    "@fastify/send": "4.2.0",
+    "@mozaik-ai/core": "4.2.0",
+    "better-sqlite3": "13.0.3",
+    "drizzle-orm": "0.45.4",
+    "fastify": "5.12.7",
+    "playwright": "1.64.1"
+  },
+  "overrides": {
+    "@esbuild-kit/core-utils": {
+      "esbuild": "0.25.12"
+    }
+  },
+  "allowScripts": {
+    "better-sqlite3": false,
+    "@google/genai@2.32.0": false,
+    "protobufjs@7.6.6": false,
+    "esbuild@0.25.12": true,
+    "esbuild@0.28.2": true
+  },
+  "version": "1.0.0",
+  "bin": {
+    "offscript": "offscript.mjs"
+  },
+  "engines": {
+    "node": ">=24.0.0",
+    "npm": ">=11.19.0"
+  },
+  "files": [
+    "offscript.mjs",
+    "dist",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "description": "Local-first software exploration with Mozaik multi-agent coordination and a local Studio.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yohanvillarp/offscript.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yohanvillarp/offscript/issues"
+  },
+  "homepage": "https://github.com/yohanvillarp/offscript#readme",
+  "keywords": [
+    "mozaik",
+    "multi-agent",
+    "software-exploration",
+    "playwright",
+    "developer-tools",
+    "local-first"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}