@javierfrancoleal/audit 0.0.0-stage → 1.0.1

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,27 @@
-# Temporary Holding Version
+---
+description: "The consolidation organ: one pass over the logs — telemetry, friction, marketing intelligence, triage review, grade summary."
+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/audit
+
+Created by **J.Franco** — the consolidation organ of the workflow v2.
+
+## The honest evolution story
+
+The original organism had nine organs. The industrial lens showed that
+five were redundant: `usage-auditor` and `triage` read the same logs the
+grader reads. Their protocols were folded into ONE organ — `audit` — so
+the logs are read once and every output is produced in a single pass.
+
+The five vestigial organs (`interpreter`, `input-detector`, `cortex`,
+`triage`, `usage-auditor`) remain published on npm as deprecated: kept in
+the genome, no longer in the active body — like the appendix.
+
+## Use this plugin
+
+Ask "audit" or use `/audit` in a session, weekly.
+
+## License
+
+MIT — see the package license field.

package/assets/audit.md

@@ -0,0 +1,72 @@
+# Audit — the consolidation organ
+
+One pass over the logs, one report, everything the organism learned. This
+organ was folded from the vestigial `usage-auditor` (telemetry + marketing
+intelligence) and `triage` (issue classification). It reads once and
+produces all outputs.
+
+## When to run
+
+- The human asks "audit", "revisa el uso", `/audit`.
+- On a weekly cadence (schedule it for the owner).
+- After a pilot week, before expanding.
+
+## One read, all outputs
+
+Read in order: supervision.md, feedback.md, usage.md, triage.md, audit.md,
+decisions.md. Then produce ONE report with five sections:
+
+### 1. Usage telemetry
+
+Sessions, workers, features used, fallbacks counted (prompt copied,
+dictation unsupported, manual corrections), per worker and channel.
+
+### 2. Friction points
+
+Repeated feedback themes, repeated corrections, bilingual sessions without
+interpretation, rejected proposals. For each: the likely cause and ONE
+proposed fix.
+
+### 3. Marketing intelligence
+
+Anonymized winning moments (quote the evidence line), the most common use
+cases and their sectors, reusable sales patterns.
+
+### 4. Triage review (folded from the triage organ)
+
+List the open NON-ESSENTIAL entries in triage.md. For each, state whether
+it should stay accepted-beta or has become worth fixing. NEVER promote an
+issue to essential without the creator's confirmation — the creator makes
+the distinction.
+
+### 5. Grade summary
+
+Summarize the autonomy-grader's current grades and autonomy level; propose
+no rule moves here (the grader owns those).
+
+## Persistence
+
+Append the report to audit.md (append-only). The next audit compares
+against it for trends.
+
+## Teach, not only report (absorbed from the conductor organ)
+
+When the friction section shows the SAME feature was revised repeatedly,
+or the human's words were vague, the audit also teaches: name the missing
+concept (from docs/CONDUCTOR-GUIDE.md), explain it in one analogy, give
+the prompt template, and ask ONE clarifying question. Then record the
+lesson in the canonical EL FUEGO format (docs/EL-FUEGO-LOG.md):
+
+    ## <date> — <title>
+    - concepto: <capas|flujo|línea de tiempo|componentes|color|animación|sistema de diseño>
+    - fricción: <qué pidió y no lograba>
+    - lección: <la idea en una frase>
+    - orden-correcta: <la plantilla que SÍ funcionó>
+    - evidencia: <archivo/línea/commit>
+
+## Rules
+
+- One pass, all outputs: never re-read the same log twice in one audit.
+- Anonymize every person in the marketing section.
+- Quote evidence; never estimate silently.
+- Errors and friction are the most valuable findings: report them first.

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# @javierfrancoleal/audit — J.Franco's consolidation organ.
+- insert:
+    - id: audit
+      name: '@javierfrancoleal/audit'

package/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect width="64" height="64" rx="14" fill="#4D6BFE"/>
+  <circle cx="32" cy="32" r="20" fill="none" stroke="#ffffff" stroke-width="4"/>
+  <circle cx="32" cy="32" r="9" fill="#FACC15"/>
+  <path d="M32 12 L32 52 M12 32 L52 32" stroke="#ffffff" stroke-width="3"/>
+</svg>

package/lib/index.js

@@ -0,0 +1,70 @@
+// @javierfrancoleal/audit — the consolidation organ of the J.Franco
+// agentic workflow. Created by J.Franco. Folded from the vestigial
+// usage-auditor and triage organs. Registers the audit skill provider and,
+// when the host command registry is available, the /audit command.
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { BUNDLED_SKILL_RANK } from "@deepseek-ai/dsh-skill";
+
+const PROVIDER_NAME = "javierfrancoleal-audit";
+const SKILL_BODY_URL = new URL("../assets/audit.md", import.meta.url);
+const RESOURCE_BASE = {
+  kind: "directory",
+  path: fileURLToPath(new URL("../assets/", import.meta.url)),
+};
+
+const CANDIDATE = {
+  name: "audit",
+  description: "The consolidation organ of the J.Franco agentic workflow: one pass over the logs produces telemetry, friction points, marketing intelligence, the triage review, and the grade summary. The human approves every edit.",
+  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(_candidate) {
+    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 = "audit";
+const inject = ["skills"];
+
+const AUDIT_BRIEFING = [
+  "Audit ON — the consolidation organ.",
+  "One pass over the logs: telemetry, friction, marketing intelligence,",
+  "triage review, and grade summary.",
+  "I only propose — you approve every edit.",
+].join(" ");
+
+function apply(ctx) {
+  ctx.skills.registerProvider(() => provider);
+  const commands = ctx.get("commands");
+  if (commands !== undefined) {
+    commands.register({
+      definitionId: "@javierfrancoleal/audit",
+      name: "audit",
+      description: "One consolidation pass: telemetry, friction, marketing, triage review, grade summary",
+      input: { hint: "[optional: a period, e.g. 'this week']", attachments: true },
+      handler: () => ({ text: AUDIT_BRIEFING }),
+    });
+  }
+}
+
+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": "Audit",
+    "description": "Das Konsolidierungsorgan: ein Durchgang über die Protokolle — Telemetrie, Reibung, Marketing-Erkenntnisse, Triage-Überblick und Noten-Zusammenfassung."
+  }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Issue Triage",
+    "description": "The creator's issue-triage layer: essential bugs are fixed now; non-essential ones are recorded and accepted in Beta. The creator decides."
+  }
+}

package/locale/es.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Auditoría",
+    "description": "El órgano de consolidación: una pasada sobre los registros — telemetría, fricciones, inteligencia de marketing, revisión de triaje y resumen de grados."
+  }
+}

package/locale/fr.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Audit",
+    "description": "L'organe de consolidation : une passe sur les journaux — télémétrie, frictions, intelligence marketing, revue du triage et résumé des notes."
+  }
+}

package/locale/it.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Audit",
+    "description": "L'organo di consolidamento: una passata sui registri — telemetria, attriti, intelligence di marketing, revisione del triage e riepilogo dei voti."
+  }
+}

package/locale/ja.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "監査",
+    "description": "統合器官：ログを一度通読——テレメトリ、摩擦、マーケティング知見、トリアージ見直し、評定サマリー。"
+  }
+}

package/locale/ko.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "감사",
+    "description": "통합 기관: 로그를 한 번에 훑어 — 원격 측정, 마찰, 마케팅 인사이트, 분류 검토, 등급 요약."
+  }
+}

package/locale/pt.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Auditoria",
+    "description": "O órgão de consolidação: uma passagem pelos registos — telemetria, atritos, inteligência de marketing, revisão do triage e resumo das notas."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "审计",
+    "description": "整合器官：对日志的一次遍历——遥测、摩擦、营销情报、分类回顾和评分摘要。"
+  }
+}

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@javierfrancoleal/audit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "The consolidation organ of the J.Franco agentic workflow: one pass over the logs — telemetry, friction points, marketing intelligence, triage review, and grade summary. Folded from usage-auditor and triage (vestigial organs). 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"
+  },
+  "icon": "./icon.svg",
+  "files": [
+    "icon.svg",
+    "locale/*.json",
+    "lib/index.js",
+    "assets",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=24",
+    "dsh": ">=0.2.1-rc.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JavierFrancoLeal/jfranco-agentic-suite.git",
+    "directory": "jfranco-audit"
+  },
+  "homepage": "https://github.com/JavierFrancoLeal/jfranco-agentic-suite",
+  "keywords": [
+    "deepseek-harness",
+    "agentic-workflow",
+    "super-agent",
+    "telemetry",
+    "marketing-intelligence",
+    "triage"
+  ],
+  "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"
+  }
+}