@javierfrancoleal/cifra 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 J.Franco
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+---
+description: "Cifra — the host-signature organ: detects the host, adapts text/instructions/layout per OS and form factor."
+kind: "package-bundle"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @javierfrancoleal/cifra
+
+Created by **J.Franco**.
+
+## Summary
+
+When a Fanal skin must adapt to its host (macOS, Windows, Linux, iOS,
+Android; laptop, tablet, smartphone), this skill applies the canonical
+host signature (assets/host-detect.js), the OS-adaptive text matrix, and
+the audit rule: the signature is always visible to the operator.
+
+## License
+
+MIT.

package/assets/cifra.md

@@ -0,0 +1,33 @@
+# Cifra — the host signature and its adaptations
+
+Use this skill when a Fanal skin must adapt to the HOST it runs on:
+operating system (macOS, Windows, Linux, iOS, Android), form factor
+(laptop, tablet, smartphone), touch, Electron/kiosk, PWA standalone.
+
+## The signature
+
+Embed the canonical snippet (assets/host-detect.js) in the skin. It
+exposes `window.CIFRA = { os, form, touch, electron, kiosk, standalone }`
+and adds body classes: os-*, form-*, touch, standalone, electron, kiosk.
+
+## What must adapt per host
+
+1. TEXT: permission instructions. "Nothing leaves this Mac" becomes
+   "Nothing leaves this PC" on Windows. Finder becomes File Explorer.
+   The OS-adaptive matrix keys: home, permMic, permFinder.
+2. INSTRUCTIONS: the permission step of the installation wizard shows
+   the real path of each OS (System Settings vs Settings vs Android
+   runtime permissions), including the "try it" triggers.
+3. PROGRAMMING: CSS by body classes (os-win .foot, form-phone layout,
+   touch targets ≥ 44px); the panel's dictation hint per OS; the kiosk
+   class locks the kitchen tablet fullscreen.
+4. AUDIT: every skin shows its signature (🖥️ os · form · electron/touch)
+   in the Supervision card — the host can never lie about itself to the
+   operator.
+
+## Rules
+
+- Detect, never guess: the signature comes from real APIs only.
+- Adapt text and layout; never change the flow (the traffic light and
+  the silo are the same on every host).
+- New OSes: extend the matrix, do not branch the business logic.

package/assets/host-detect.js

@@ -0,0 +1,27 @@
+// Cifra — the host signature (canonical snippet for Fanal and its skins).
+// Detects the operating system and the form factor, exposes body classes
+// and the OS-adaptive text matrix. Embed this in any Fanal skin.
+(function () {
+  const ua = navigator.userAgent || "";
+  const touch = ("ontouchstart" in window) || navigator.maxTouchPoints > 2;
+  let os = "other";
+  if (/iPhone|iPad|iPod/.test(ua)) os = "ios";
+  else if (/Android/.test(ua)) os = "android";
+  else if (/Mac|Macintosh/.test(ua)) os = "mac";
+  else if (/Windows/.test(ua)) os = "win";
+  else if (/Linux/.test(ua)) os = "linux";
+  let form = "desktop";
+  if (os === "ios" || os === "android") form = "phone";
+  else if (touch && Math.min(screen.width, screen.height) > 700) form = "tablet";
+  const electron = !!(window.process && window.process.versions && window.process.versions.electron);
+  const kiosk = electron && /kiosk/.test(ua);
+  const standalone = navigator.standalone === true || (window.matchMedia && window.matchMedia("(display-mode: standalone)").matches);
+  const HOST = { os, form, touch, electron, kiosk, standalone };
+  document.body.classList.add("os-" + os, "form-" + form);
+  if (touch) document.body.classList.add("touch");
+  if (standalone) document.body.classList.add("standalone");
+  if (electron) document.body.classList.add("electron");
+  if (kiosk) document.body.classList.add("kiosk");
+  window.CIFRA = HOST;
+  return HOST;
+})();

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# @javierfrancoleal/cifra — the host-signature organ.
+- insert:
+    - id: cifra
+      name: '@javierfrancoleal/cifra'

package/lib/index.js

@@ -0,0 +1,45 @@
+// @javierfrancoleal/cifra — an organ of the J.Franco agentic workflow.
+// Created by J.Franco. Registers the cifra skill provider.
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { BUNDLED_SKILL_RANK } from "@deepseek-ai/dsh-skill";
+
+const PROVIDER_NAME = "javierfrancoleal-cifra";
+const SKILL_BODY_URL = new URL("../assets/cifra.md", import.meta.url);
+const RESOURCE_BASE = { kind: "directory", path: fileURLToPath(new URL("../assets/", import.meta.url)) };
+
+const CANDIDATE = {
+  name: "cifra",
+  description: "The host-signature organ of the J.Franco agentic workflow: detects the host (operating system and form factor) where Fanal runs, adapts texts, instructions and layout per host (macOS/Windows/Linux/iOS/Android, laptop/tablet/phone), and audits the signature visibly — never changes the flow.",
+  invocation: { modelInvocable: true, userInvocable: true },
+  provider: PROVIDER_NAME,
+  source: "bundled",
+  resourceBase: RESOURCE_BASE,
+  rank: BUNDLED_SKILL_RANK,
+  locator: SKILL_BODY_URL,
+};
+
+const provider = {
+  name: PROVIDER_NAME,
+  list: () => Promise.resolve([CANDIDATE]),
+  async get() {
+    return {
+      name: CANDIDATE.name,
+      description: CANDIDATE.description,
+      invocation: CANDIDATE.invocation,
+      provider: CANDIDATE.provider,
+      source: CANDIDATE.source,
+      resourceBase: RESOURCE_BASE,
+      content: await readFile(SKILL_BODY_URL, "utf8"),
+    };
+  },
+};
+
+const name = "cifra";
+const inject = ["skills"];
+
+function apply(ctx) {
+  ctx.skills.registerProvider(() => provider);
+}
+
+export { apply, inject, name };

package/locale/ar.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "التشفير",
+    "description": "يكشف المضيف ويكيّف النصوص والتعليمات والتخطيط حسب نظام التشغيل وعامل الشكل."
+  }
+}

package/locale/de.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Ziffer",
+    "description": "Erkennt den Host und passt Texte, Anweisungen und Layout je nach System und Geräteform an."
+  }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Cipher",
+    "description": "Detects the host and adapts texts, instructions and layout per operating system and form factor."
+  }
+}

package/locale/es.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Cifra",
+    "description": "Detecta el host y adapta textos, instrucciones y diseño según el sistema operativo y el factor de forma."
+  }
+}

package/locale/fr.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Cifre",
+    "description": "Détecte l'hôte et adapte textes, instructions et mise en page selon le système et le format de l'appareil."
+  }
+}

package/locale/it.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Cifra",
+    "description": "Rileva l'host e adatta testi, istruzioni e layout per sistema operativo e formato dispositivo."
+  }
+}

package/locale/ja.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "暗号",
+    "description": "ホストを検出し、OS と形状に応じてテキスト・手順・レイアウトを適応します。"
+  }
+}

package/locale/ko.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "암호",
+    "description": "호스트를 감지하고 OS와 폼팩터에 따라 텍스트·안내·레이아웃을 적용합니다."
+  }
+}

package/locale/pt.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Cifra",
+    "description": "Detecta o host e adapta textos, instruções e layout por sistema operacional e formato."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "密码",
+    "description": "检测主机并按操作系统和形态适配文本、说明与布局。"
+  }
+}

package/package.json

@@ -1,6 +1,17 @@
 {
   "name": "@javierfrancoleal/cifra",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Cifra — the host-signature organ of the J.Franco agentic workflow: detects the host (OS + form factor), adapts texts/instructions/layout per platform, and audits the signature visibly. Created by J.Franco.",
+  "author": "J.Franco",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": { ".": "./lib/index.js", "./cordis.patch.yml": "./cordis.patch.yml", "./package.json": "./package.json", "./locale/*.json": "./locale/*.json" },
+  "files": ["lib/index.js", "assets", "cordis.patch.yml", "README.md", "locale/*.json"],
+  "engines": { "node": ">=24", "dsh": ">=0.2.1-rc.0" },
+  "repository": { "type": "git", "url": "git+https://github.com/JavierFrancoLeal/jfranco-agentic-suite.git", "directory": "jfranco-cifra" },
+  "keywords": ["deepseek-harness", "host-detection", "cross-platform", "sovereign"],
+  "dsh": { "manifestVersion": 1, "bundle": { "patch": "./cordis.patch.yml" } },
+  "publishConfig": { "access": "public" },
+  "peerDependencies": { "@deepseek-ai/cordis": "~4.0.5", "@deepseek-ai/dsh-skill": ">=0.2.1-rc.5" }
+}