paper-mono 0.62.0

package/bin/chunks/chunk-BGKLQ5Y6.js

@@ -0,0 +1,55 @@
+// src/config.ts
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+var moduleDir = dirname(fileURLToPath(import.meta.url));
+function getPackageDir() {
+  const configured = process.env.PAPER_PACKAGE_DIR;
+  if (configured === "~") return homedir();
+  if (configured?.startsWith("~/")) return join(homedir(), configured.slice(2));
+  if (configured) return resolve(configured);
+  let current = moduleDir;
+  while (current !== dirname(current)) {
+    if (existsSync(join(current, "package.json"))) return current;
+    current = dirname(current);
+  }
+  return moduleDir;
+}
+var manifest = JSON.parse(readFileSync(join(getPackageDir(), "package.json"), "utf8"));
+var APP_NAME = manifest.piConfig?.name ?? "paper";
+var OWNER_COMMAND = "paper mono";
+var PUBLIC_PROMISE = "Turn a Paper reference into a sharp implementation brief, get explicit approval, then carry it faithfully into production code.";
+var IDENTITY_DOMAIN = "Paper Desktop design-to-code workflows";
+var CONFIG_DIR_NAME = manifest.piConfig?.configDir ?? ".paper";
+var VERSION = manifest.version ?? "0.0.0";
+var ENV_AGENT_DIR = "PAPER_CODING_AGENT_DIR";
+var PACKAGE_DISTRIBUTION = manifest.paperMono?.distribution ?? "workspace";
+var BUNDLED_PACKAGE_VERSIONS = Object.freeze(
+  manifest.paperMono?.bundledPackages ?? {}
+);
+function applyPaperPrivacyDefaults(environment = process.env) {
+  environment.PI_TELEMETRY = "0";
+  environment.PI_SKIP_VERSION_CHECK = "1";
+}
+function getAgentDir() {
+  const configured = process.env[ENV_AGENT_DIR];
+  if (configured === "~") return homedir();
+  if (configured?.startsWith("~/")) return join(homedir(), configured.slice(2));
+  if (configured) return resolve(configured);
+  return join(homedir(), CONFIG_DIR_NAME, "agent");
+}
+
+export {
+  getPackageDir,
+  APP_NAME,
+  OWNER_COMMAND,
+  PUBLIC_PROMISE,
+  IDENTITY_DOMAIN,
+  CONFIG_DIR_NAME,
+  VERSION,
+  PACKAGE_DISTRIBUTION,
+  BUNDLED_PACKAGE_VERSIONS,
+  applyPaperPrivacyDefaults,
+  getAgentDir
+};

package/bin/chunks/chunk-I4P43IZS.js

@@ -0,0 +1,171 @@
+import {
+  APP_NAME,
+  OWNER_COMMAND,
+  PUBLIC_PROMISE
+} from "./chunk-BGKLQ5Y6.js";
+
+// src/workflow-contract.ts
+var PAPER_IMPLEMENTATION_BRIEF_SCHEMA_VERSION = "paper-implementation-brief.v1";
+var PAPER_BRIEF_APPROVAL_PREFIX = "APPROVE PAPER BRIEF";
+function isEnabledWorkflowFlag(value) {
+  return value === true || typeof value === "string" && ["1", "true", "yes"].includes(value.trim().toLowerCase());
+}
+function resolvePaperWorkflowMode(auditOnly, copilot) {
+  if (isEnabledWorkflowFlag(auditOnly) && isEnabledWorkflowFlag(copilot)) {
+    throw new TypeError("--audit-only and --copilot are mutually exclusive Paper workflow modes.");
+  }
+  if (isEnabledWorkflowFlag(auditOnly)) return "audit-only";
+  if (isEnabledWorkflowFlag(copilot)) return "copilot";
+  return "reference-to-code";
+}
+var PAPER_TOOL_SAFETY_CLASSIFICATIONS = Object.freeze({
+  paper_get_basic_info: "read-only",
+  paper_get_selection: "read-only",
+  paper_get_node_info: "read-only",
+  paper_get_children: "read-only",
+  paper_get_tree_summary: "read-only",
+  paper_get_screenshot: "read-only",
+  paper_get_jsx: "read-only",
+  paper_get_computed_styles: "read-only",
+  paper_get_fill_image: "read-only",
+  paper_find_nodes: "read-only",
+  paper_get_font_family_info: "read-only",
+  paper_get_guide: "read-only",
+  paper_find_placement: "read-only",
+  paper_get_tokens: "read-only",
+  paper_mcp_reachability_check: "read-only",
+  paper_capture_provenance: "read-only",
+  paper_style_tokens_extract: "dry-run-or-live-mutation",
+  paper_materialize_system_direction: "dry-run-or-live-mutation",
+  paper_create_page: "live-mutation",
+  paper_open_page: "live-mutation",
+  paper_create_tokens: "dry-run-or-live-mutation",
+  paper_set_tokens: "dry-run-or-live-mutation",
+  paper_write_html: "dry-run-or-live-mutation",
+  paper_move_nodes: "dry-run-or-live-mutation",
+  paper_rename_nodes: "dry-run-or-live-mutation",
+  paper_revise_artboard: "dry-run-or-live-mutation",
+  paper_delete_nodes: "dry-run-or-live-mutation"
+});
+var PAPER_MUTATION_TOOL_NAMES = [
+  "paper_style_tokens_extract",
+  "paper_materialize_system_direction",
+  "paper_create_page",
+  "paper_open_page",
+  "paper_create_tokens",
+  "paper_set_tokens",
+  "paper_write_html",
+  "paper_move_nodes",
+  "paper_rename_nodes",
+  "paper_revise_artboard",
+  "paper_delete_nodes"
+];
+var PAPER_TOOL_IDS = Object.freeze([
+  "paper_get_basic_info",
+  "paper_get_selection",
+  "paper_get_node_info",
+  "paper_get_children",
+  "paper_get_tree_summary",
+  "paper_get_screenshot",
+  "paper_get_jsx",
+  "paper_get_computed_styles",
+  "paper_get_fill_image",
+  "paper_get_font_family_info",
+  "paper_get_guide",
+  "paper_find_placement",
+  "paper_mcp_reachability_check",
+  "paper_style_tokens_extract",
+  "paper_materialize_system_direction",
+  "paper_create_page",
+  "paper_open_page",
+  "paper_rename_nodes",
+  "paper_revise_artboard",
+  "paper_delete_nodes",
+  "paper_find_nodes",
+  "paper_get_tokens",
+  "paper_capture_provenance",
+  "paper_create_tokens",
+  "paper_set_tokens",
+  "paper_write_html",
+  "paper_move_nodes"
+]);
+
+// src/owner-help.ts
+var STANDARD_TOOL_IDS = ["read", "bash", "edit", "write", "grep", "find", "ls"];
+function printHelp() {
+  process.stdout.write(`${OWNER_COMMAND} - Paper Desktop design-to-code specialist
+
+${PUBLIC_PROMISE}
+
+Usage:
+  ${OWNER_COMMAND} [options] [@files...] [messages...]
+  ${APP_NAME} [options] [@files...] [messages...]
+
+Arguments:
+  @file                              Attach a regular file contained by the current repository
+  messages...                        Send initial prompt text to the specialist
+  -- messages...                     Treat following option-shaped text as specialist prompt input
+
+Commands:
+  ${APP_NAME} show|info [--json]      Show the open Paper document
+  ${APP_NAME} selection [--json]      Show the current Paper selection
+  ${APP_NAME} tree [--json]           Show the open document tree
+  ${APP_NAME} node <id> [options]      Inspect node info, children, or JSX
+  ${APP_NAME} screenshot --out <file> Save a node or single-selection screenshot
+  ${APP_NAME} doctor [--json]          Check all 27 Paper tools and reachability
+  ${OWNER_COMMAND} [options]           Start the guarded design-to-code specialist
+
+Options:
+  --about-json                       Print identity, privacy, lock, workflow, and provenance receipts
+  --audit-only                       Permanently read-only audit workflow
+  --copilot                          Guarded Paper copilot workflow; still requires brief approval
+  --continue, -c                     Continue the most recent session
+  --resume, -r                       Select a session to resume
+  --session <id>                     Open a verified session ID; path-like values are rejected
+  --fork <path-or-id>                Fork a session into the current project
+  --session-dir <dir>                Override session storage and lookup
+  --no-session                       Use an in-memory session
+  --provider <name>                  Select a provider
+  --model <provider/id-or-pattern>   Select a model
+  --api-key <key>                    Runtime-only API key; requires --model
+  --thinking <level>                 off|minimal|low|medium|high|xhigh
+  --list-models [search]             List available models
+  --mode <mode>                      text|json (RPC is disabled by the approval boundary)
+  --print, -p                        Process prompts and exit
+  --tools <ids>                      Select shared or Paper tools
+  --no-tools                         Disable all tools
+  --skill <path>                     Load a skill path
+  --no-skills, -ns                  Disable skills
+  --prompt-template <path>           Load a prompt-template path
+  --no-prompt-templates, -np         Disable prompt templates
+  --theme <path>                     Load a theme path
+  --no-themes                        Disable themes
+  --system-prompt <text>             Override the Paper prompt
+  --append-system-prompt <text>      Append prompt policy (repeatable)
+  --offline                          Disable startup network operations
+  --verbose                          Show verbose startup detail
+  --version, -v                      Print the Paper package version
+  --help, -h                         Show this help
+
+Environment:
+  PAPER_CODING_AGENT_DIR             Agent home (default: ~/.paper/agent)
+  PAPER_OFFLINE                      Disable startup network operations
+
+Registered capabilities (mutation remains locked until exact brief approval):
+  ${[...STANDARD_TOOL_IDS, ...PAPER_TOOL_IDS].join(", ")}
+
+Safety:
+  External extension discovery and direct page commands are disabled. Mutation stays locked until the exact APPROVE PAPER BRIEF <brief-id> phrase for the current brief.
+`);
+}
+
+export {
+  PAPER_IMPLEMENTATION_BRIEF_SCHEMA_VERSION,
+  PAPER_BRIEF_APPROVAL_PREFIX,
+  resolvePaperWorkflowMode,
+  PAPER_TOOL_SAFETY_CLASSIFICATIONS,
+  PAPER_MUTATION_TOOL_NAMES,
+  PAPER_TOOL_IDS,
+  STANDARD_TOOL_IDS,
+  printHelp
+};

package/bin/chunks/chunk-JCO37BXY.js

@@ -0,0 +1,31 @@
+// src/cli/diagnostics.ts
+var PAPER_HELP_HINT = "Run `paper --help` for supported commands and options.";
+var CREDENTIAL_OPTION_TERMS = /* @__PURE__ */ new Set([
+  "auth",
+  "authorization",
+  "credential",
+  "credentials",
+  "key",
+  "password",
+  "passphrase",
+  "secret",
+  "token"
+]);
+function isCredentialShapedOption(option) {
+  return option.slice(2).toLowerCase().split(/[-_]/u).some((term) => CREDENTIAL_OPTION_TERMS.has(term));
+}
+function safeArgumentForDiagnostic(token) {
+  const separator = token.indexOf("=");
+  if (!token.startsWith("--")) return token;
+  if (separator < 0) return isCredentialShapedOption(token) ? `${token} [REDACTED]` : token;
+  const option = token.slice(0, separator);
+  return `${option}=[REDACTED]`;
+}
+function invalidPaperArgument(message) {
+  throw new TypeError(`${message} ${PAPER_HELP_HINT}`);
+}
+
+export {
+  safeArgumentForDiagnostic,
+  invalidPaperArgument
+};