trackops 2.0.0 → 2.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trackops",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Operational project control with task management, document generation, multi-project dashboard, and optional OPERA methodology",
   "main": "lib/control.js",
   "bin": {

package/skills/trackops/SKILL.md

@@ -1,89 +1,86 @@
 ---
 name: "trackops"
-description: "Global TrackOps skill that prepares your agent for local project orchestration and operational automation, ensures the runtime on first use, and guides per-project activation with optional OPERA."
-metadata:
-  version: "2.0.0"
-  type: "global"
-  triggers:
-    - "install trackops"
-    - "skills.sh"
-    - "trackops init"
-    - "trackops opera install"
-    - "opera handoff"
+description: "Skill global de TrackOps para instalar y activar la orquestacion local de proyectos con OPERA, entorno y handoff a agentes. Usala cuando el usuario quiera instalar TrackOps desde skills.sh, bootstrapear el runtime con `node scripts/bootstrap-trackops.js`, ejecutar `trackops init`, ejecutar `trackops opera install`, revisar `trackops opera handoff`, o trabajar sobre el flujo operativo de un repositorio."
 ---
 
 # TrackOps
 
-Use this skill in two layers.
+Si la conversacion y el proyecto deben trabajar en ingles, lee `locales/en/SKILL.md` antes de seguir.
 
-## 1. Global skill layer
+## Capa global
 
-Install it with:
+Instala la skill del marketplace con:
 
 ```bash
 npx skills add Baxahaun/trackops
 ```
 
-Before relying on the CLI, run:
+Antes de depender del CLI, ejecuta el script empaquetado de la skill:
 
 ```bash
 node scripts/bootstrap-trackops.js
 ```
 
-That bootstrap ensures the `trackops` runtime and records state in `~/.trackops/runtime.json`.
+Ese bootstrap:
 
-## 2. Local project layer
+- asegura el runtime npm de `trackops`
+- valida que el binario global sea ejecutable
+- registra estado en `~/.trackops/runtime.json`
 
-Inside a repository:
+No debe crear archivos dentro de un repositorio por si solo.
+
+## Capa local del proyecto
+
+Dentro del repositorio:
 
 ```bash
 trackops init
 trackops opera install
 ```
 
-Core rules:
+Reglas base:
 
-- treat the global skill install as non-invasive
-- use `ops/contract/operating-contract.json` as the machine contract when it exists
-- use `ops/project_control.json` as the operational source of truth for backlog and state
-- use `ops/policy/autonomy.json` before approval-sensitive actions
-- use `/.env` and `/.env.example` as the environment contract
-- keep generated operational docs under `ops/`
-- support `trackops locale get|set` and `trackops doctor locale` when language matters
+- trata la instalacion global como no invasiva
+- usa `ops/contract/operating-contract.json` como contrato de maquina cuando exista
+- usa `ops/project_control.json` como fuente de verdad operativa
+- usa `ops/policy/autonomy.json` antes de acciones sensibles
+- usa `/.env` y `/.env.example` como contrato de entorno
+- deja la documentacion operativa generada dentro de `ops/`
+- usa `trackops locale get|set` y `trackops doctor locale` cuando el idioma importe
 
-## OPERA onboarding
+## Onboarding de OPERA
 
-OPERA no longer assumes every user is technical.
+OPERA ya no asume que todo usuario es tecnico.
 
-When OPERA starts, TrackOps classifies:
+TrackOps clasifica:
 
-- user technical level
-- current project state
-- available documentation
+- nivel tecnico del usuario
+- estado actual del proyecto
+- documentacion disponible
 
-Then it chooses one of two routes:
+Luego elige una de dos rutas:
 
 - `direct bootstrap`
-  for technical users and already-defined repositories
+  para usuarios tecnicos y repos ya definidos
 - `agent handoff`
-  for early ideas, non-technical users, or weak documentation
+  para ideas tempranas, usuarios no tecnicos o documentacion debil
 
-If TrackOps routes bootstrap to the agent:
+Si TrackOps deriva al agente:
 
-- read `ops/bootstrap/agent-handoff.md`
-- or print it with `trackops opera handoff --print`
-- the agent must produce:
+- lee `ops/bootstrap/agent-handoff.md`
+- o imprimelo con `trackops opera handoff --print`
+- exige como salida:
   - `ops/bootstrap/intake.json`
   - `ops/bootstrap/spec-dossier.md`
-  - `ops/bootstrap/open-questions.md` when important gaps remain
-- then resume with:
+  - `ops/bootstrap/open-questions.md` cuando queden huecos importantes
+- reanuda con:
 
 ```bash
 trackops opera bootstrap --resume
 ```
 
-Read references only when needed:
+## Que referencia leer y cuando
 
-- `references/activation.md`
-- `references/workflow.md`
-- `references/troubleshooting.md`
+- lee `references/activation.md` solo para instalacion, primer uso, locale bootstrap y activacion de un repo
+- lee `references/workflow.md` solo cuando TrackOps ya esta activo y haga falta operar el dia a dia del repositorio
+- lee `references/troubleshooting.md` solo cuando fallen la instalacion, el bootstrap, el resume o el contrato de entorno

package/skills/trackops/agents/openai.yaml

@@ -1,3 +1,7 @@
 interface:
   display_name: "TrackOps"
-  short_description: "Global TrackOps skill for local project orchestration, bilingual onboarding, agent coordination, and operational automation"
+  short_description: "Bootstrap TrackOps and activate OPERA"
+  default_prompt: "Use $trackops to bootstrap the TrackOps runtime and activate OPERA in this repository."
+
+policy:
+  allow_implicit_invocation: true

package/skills/trackops/locales/en/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: "trackops"
+description: "Global TrackOps skill for installing and activating local project orchestration with OPERA, environment management, and agent handoff. Use it when the user wants to install TrackOps from skills.sh, bootstrap the runtime with `node scripts/bootstrap-trackops.js`, run `trackops init`, run `trackops opera install`, inspect `trackops opera handoff`, or work through the operational flow of a repository."
+---
+
+# TrackOps
+
+Use this localized file when the conversation and project should run in English.
+
+## Global layer
+
+Install the marketplace skill with:
+
+```bash
+npx skills add Baxahaun/trackops
+```
+
+Before relying on the CLI, run the bundled skill script:
+
+```bash
+node scripts/bootstrap-trackops.js
+```
+
+That bootstrap:
+
+- ensures the npm `trackops` runtime
+- verifies that the global binary can be executed
+- records state in `~/.trackops/runtime.json`
+
+It must not create repository files on its own.
+
+## Local project layer
+
+Inside the repository:
+
+```bash
+trackops init
+trackops opera install
+```
+
+Core rules:
+
+- treat the global install as non-invasive
+- use `ops/contract/operating-contract.json` as the machine contract when it exists
+- use `ops/project_control.json` as the operational source of truth
+- use `ops/policy/autonomy.json` before approval-sensitive actions
+- use `/.env` and `/.env.example` as the environment contract
+- keep generated operational docs under `ops/`
+- use `trackops locale get|set` and `trackops doctor locale` when language matters
+
+## OPERA onboarding
+
+OPERA no longer assumes every user is technical.
+
+TrackOps classifies:
+
+- user technical level
+- current project state
+- available documentation
+
+Then it chooses one of two routes:
+
+- `direct bootstrap`
+  for technical users and already-defined repositories
+- `agent handoff`
+  for early ideas, non-technical users, or weak documentation
+
+If TrackOps routes bootstrap to the agent:
+
+- read `ops/bootstrap/agent-handoff.md`
+- or print it with `trackops opera handoff --print`
+- require these outputs:
+  - `ops/bootstrap/intake.json`
+  - `ops/bootstrap/spec-dossier.md`
+  - `ops/bootstrap/open-questions.md` when important gaps remain
+- resume with:
+
+```bash
+trackops opera bootstrap --resume
+```
+
+## Which reference to read and when
+
+- read `locales/en/references/activation.md` only for installation, first use, locale bootstrap, and repository activation
+- read `locales/en/references/workflow.md` only when TrackOps is already active and you need day-to-day repository operations
+- read `locales/en/references/troubleshooting.md` only when installation, bootstrap, resume, or environment contract handling fails

package/skills/trackops/locales/en/references/activation.md

@@ -0,0 +1,73 @@
+# Activation
+
+## Global install
+
+Install the marketplace skill:
+
+```bash
+npx skills add Baxahaun/trackops
+```
+
+On first use, ensure the runtime with the bundled skill script:
+
+```bash
+node scripts/bootstrap-trackops.js
+```
+
+The global skill must not create repository files on its own.
+
+## Local activation
+
+Inside a repository:
+
+```bash
+trackops init
+trackops opera install
+```
+
+By default, `trackops init` creates a split workspace with:
+
+- `app/`
+- `ops/`
+- `/.env`
+- `/.env.example`
+- `.trackops-workspace.json`
+
+## OPERA routing
+
+OPERA always starts by classifying:
+
+- technical level
+- project state
+- documentation state
+
+If the project is still early or the user is non-technical, TrackOps writes:
+
+- `ops/bootstrap/agent-handoff.md`
+- `ops/bootstrap/agent-handoff.json`
+
+The agent must produce:
+
+- `ops/bootstrap/intake.json`
+- `ops/bootstrap/spec-dossier.md`
+- `ops/bootstrap/open-questions.md` when needed
+
+When the quality gate passes, OPERA compiles:
+
+- `ops/contract/operating-contract.json`
+- `ops/genesis.md`
+- `ops/policy/autonomy.json`
+
+Resume with:
+
+```bash
+trackops opera bootstrap --resume
+```
+
+Locale controls:
+
+```bash
+trackops locale get
+trackops locale set en
+trackops doctor locale
+```

package/skills/trackops/locales/en/references/troubleshooting.md

@@ -0,0 +1,49 @@
+# Troubleshooting
+
+## Missing prerequisites
+
+- Install Node 18+ if Node is missing or too old.
+- Install a Node distribution that includes npm if npm is missing.
+
+## Global install command failed
+
+- Install from committed GitHub state:
+  `npx skills add Baxahaun/trackops`
+- Then ensure the local runtime with:
+  `node scripts/bootstrap-trackops.js`
+- If the install succeeded but the CLI still looks unavailable, confirm that `~/.trackops/runtime.json` exists.
+
+## Runtime bootstrap failed
+
+- Re-run `node scripts/bootstrap-trackops.js`.
+- If npm global permissions fail, configure a user-writable npm prefix instead of using `sudo`.
+
+## OPERA routed bootstrap to the agent
+
+This is expected when:
+
+- the user is non-technical
+- the project is still in idea stage
+- documentation is weak
+
+Use:
+
+```bash
+trackops opera handoff --print
+trackops opera bootstrap --resume
+```
+
+## Resume does not complete
+
+TrackOps will not invent missing context.
+
+Check that both files exist and contain usable data:
+
+- `ops/bootstrap/intake.json`
+- `ops/bootstrap/spec-dossier.md`
+
+## Environment looks inconsistent
+
+- Run `trackops env status`.
+- Run `trackops env sync`.
+- If bridge mode is `copy`, do not edit `app/.env` directly.

package/skills/trackops/locales/en/references/workflow.md

@@ -0,0 +1,26 @@
+# Workflow
+
+Once TrackOps is active in a repository:
+
+1. Run `trackops status`.
+2. Run `trackops next`.
+3. Move task state with `trackops task ...`.
+4. Run `trackops sync` after meaningful changes.
+5. Run `trackops env status` when credentials matter.
+
+Operational rules:
+
+- In split workspaces, use `ops/project_control.json` as the source of truth.
+- Generated operational docs live in `ops/`.
+- Product code lives in `app/`.
+- Real secrets live in `/.env`.
+- Public environment contract lives in `/.env.example`.
+- `app/.env` is only a compatibility bridge.
+
+If OPERA is installed:
+
+- `ops/contract/operating-contract.json` holds the machine contract.
+- `ops/genesis.md` holds the compiled human view.
+- `ops/policy/autonomy.json` holds the executable autonomy policy.
+- `ops/bootstrap/` holds onboarding artifacts.
+- `ops/.agent/hub/` and `ops/.agents/skills/` hold managed agent artifacts.

package/skills/trackops/references/activation.md

@@ -1,31 +1,31 @@
-# Activation
+# Activacion
 
-## Global install
+## Instalacion global
 
-Install the marketplace skill:
+Instala la skill del marketplace:
 
 ```bash
 npx skills add Baxahaun/trackops
 ```
 
-On first use, ensure the runtime with:
+En primer uso, asegura el runtime con el script empaquetado de la skill:
 
 ```bash
 node scripts/bootstrap-trackops.js
 ```
 
-The global skill must not create repository files by itself.
+La skill global no debe crear archivos dentro de repositorios por si sola.
 
-## Local activation
+## Activacion local
 
-Inside a repository:
+Dentro de un repositorio:
 
 ```bash
 trackops init
 trackops opera install
 ```
 
-By default, `trackops init` creates a split workspace with:
+Por defecto, `trackops init` crea un workspace split con:
 
 - `app/`
 - `ops/`
@@ -33,38 +33,38 @@ By default, `trackops init` creates a split workspace with:
 - `/.env.example`
 - `.trackops-workspace.json`
 
-## OPERA routing
+## Routing de OPERA
 
-OPERA always starts by classifying:
+OPERA siempre empieza clasificando:
 
-- technical level
-- project state
-- documentation state
+- nivel tecnico
+- estado del proyecto
+- estado de la documentacion
 
-If the project is still early or the user is non-technical, TrackOps writes:
+Si el proyecto aun esta verde o el usuario no es tecnico, TrackOps escribe:
 
 - `ops/bootstrap/agent-handoff.md`
 - `ops/bootstrap/agent-handoff.json`
 
-The agent then produces:
+El agente debe producir:
 
 - `ops/bootstrap/intake.json`
 - `ops/bootstrap/spec-dossier.md`
-- `ops/bootstrap/open-questions.md` when needed
+- `ops/bootstrap/open-questions.md` cuando haga falta
 
-When the quality gate passes, OPERA compiles:
+Cuando el quality gate pasa, OPERA compila:
 
 - `ops/contract/operating-contract.json`
 - `ops/genesis.md`
 - `ops/policy/autonomy.json`
 
-Resume with:
+Reanuda con:
 
 ```bash
 trackops opera bootstrap --resume
 ```
 
-Locale controls:
+Controles de idioma:
 
 ```bash
 trackops locale get

package/skills/trackops/references/troubleshooting.md

@@ -1,49 +1,49 @@
 # Troubleshooting
 
-## Missing prerequisites
+## Faltan prerequisitos
 
-- Install Node 18+ if Node is missing or too old.
-- Install a Node distribution that includes npm if npm is missing.
+- Instala Node 18+ si Node falta o es demasiado antiguo.
+- Instala una distribucion de Node que incluya npm si falta npm.
 
-## Global install command failed
+## Fallo al instalar la skill global
 
-- Install from committed GitHub state:
+- Instala desde el estado committeado de GitHub:
   `npx skills add Baxahaun/trackops`
-- Then ensure the local runtime with:
+- Luego asegura el runtime local con:
   `node scripts/bootstrap-trackops.js`
-- If the install succeeded but the CLI still looks unavailable, confirm that `~/.trackops/runtime.json` exists.
+- Si la instalacion salio bien pero el CLI sigue sin aparecer, confirma que `~/.trackops/runtime.json` exista.
 
-## Runtime bootstrap failed
+## Fallo en el bootstrap del runtime
 
-- Re-run `node scripts/bootstrap-trackops.js`.
-- If npm global permissions fail, configure a user-writable npm prefix instead of using `sudo`.
+- Reejecuta `node scripts/bootstrap-trackops.js`.
+- Si fallan los permisos globales de npm, configura un prefix de usuario en lugar de usar `sudo`.
 
-## OPERA routed bootstrap to the agent
+## OPERA ha derivado el bootstrap al agente
 
-This is expected when:
+Es el comportamiento esperado cuando:
 
-- the user is non-technical
-- the project is still in idea stage
-- documentation is weak
+- el usuario no es tecnico
+- el proyecto sigue en fase idea
+- la documentacion es debil
 
-Use:
+Usa:
 
 ```bash
 trackops opera handoff --print
 trackops opera bootstrap --resume
 ```
 
-## Resume does not complete
+## El resume no completa
 
-TrackOps will not invent missing context.
+TrackOps no inventa contexto faltante.
 
-Check that both files exist and contain usable data:
+Comprueba que ambos archivos existan y contengan datos utilizables:
 
 - `ops/bootstrap/intake.json`
 - `ops/bootstrap/spec-dossier.md`
 
-## Environment looks inconsistent
+## El entorno parece inconsistente
 
-- Run `trackops env status`.
-- Run `trackops env sync`.
-- If bridge mode is `copy`, do not edit `app/.env` directly.
+- Ejecuta `trackops env status`.
+- Ejecuta `trackops env sync`.
+- Si el bridge mode es `copy`, no edites `app/.env` directamente.

package/skills/trackops/references/workflow.md

@@ -1,26 +1,26 @@
 # Workflow
 
-Once TrackOps is active in a repository:
+Una vez que TrackOps esta activo en un repositorio:
 
-1. Run `trackops status`.
-2. Run `trackops next`.
-3. Move task state with `trackops task ...`.
-4. Run `trackops sync` after meaningful changes.
-5. Run `trackops env status` when credentials matter.
+1. Ejecuta `trackops status`.
+2. Ejecuta `trackops next`.
+3. Mueve el estado de tareas con `trackops task ...`.
+4. Ejecuta `trackops sync` tras cambios relevantes.
+5. Ejecuta `trackops env status` cuando importen las credenciales.
 
-Operational rules:
+Reglas operativas:
 
-- In split workspaces, use `ops/project_control.json` as the source of truth.
-- Generated operational docs live in `ops/`.
-- Product code lives in `app/`.
-- Real secrets live in `/.env`.
-- Public environment contract lives in `/.env.example`.
-- `app/.env` is only a compatibility bridge.
+- En workspaces split, usa `ops/project_control.json` como fuente de verdad.
+- La documentacion operativa generada vive en `ops/`.
+- El codigo de producto vive en `app/`.
+- Los secretos reales viven en `/.env`.
+- El contrato publico de entorno vive en `/.env.example`.
+- `app/.env` es solo un puente de compatibilidad.
 
-If OPERA is installed:
+Si OPERA esta instalado:
 
-- `ops/contract/operating-contract.json` holds the machine contract.
-- `ops/genesis.md` holds the compiled human view.
-- `ops/policy/autonomy.json` holds the executable autonomy policy.
-- `ops/bootstrap/` holds onboarding artifacts.
-- `ops/.agent/hub/` and `ops/.agents/skills/` hold managed agent artifacts.
+- `ops/contract/operating-contract.json` contiene el contrato de maquina.
+- `ops/genesis.md` contiene la vista humana compilada.
+- `ops/policy/autonomy.json` contiene la politica ejecutable.
+- `ops/bootstrap/` contiene los artefactos de onboarding.
+- `ops/.agent/hub/` y `ops/.agents/skills/` contienen artefactos gestionados de agentes.

package/skills/trackops/skill.json

@@ -2,8 +2,8 @@
   "name": "trackops",
   "shortDescription": "Global TrackOps skill for local project orchestration, agent coordination, bilingual onboarding, and operational automation.",
   "description": "Installs TrackOps as a global skill, ensures the runtime on first use, lets users choose Spanish or English, activates local project orchestration, and routes OPERA onboarding into either direct bootstrap or agent-led discovery.",
-  "skillVersion": "2.0.0",
-  "trackopsVersion": "2.0.0",
+  "skillVersion": "2.0.1",
+  "trackopsVersion": "2.0.1",
   "npmPackage": "trackops",
   "bootstrapPolicy": "first_use",
   "supportedAgentsV1": [