sauron-cli 1.3.0 → 1.4.1

package/.genesis/prompts/prompt-sauron-update-intelligence.md

@@ -0,0 +1,20 @@
+# Prompt: Inteligência de Atualização e Proteção de Memória no Sauron CLI
+
+```markdown
+Estamos desenvolvendo o Sauron CLI, uma ferramenta de CLI em Node.js (TypeScript) que injeta regras de governança e memória arquitetural em repositórios para otimizar o uso de IAs (Cursor, Windsurf, Aider).
+
+Stack: Node.js, TypeScript, commander, @clack/prompts.
+
+Atualmente, temos o comando `sauron init`, que executa um onboarding interativo com o usuário (perguntando as IAs que serão usadas, severidade das regras, contexto do projeto e stack tecnológica). Após coletar essas respostas, ele gera os arquivos de manifesto (`AGENTS.md`, `.sauron/.manifest.json` e a pasta `.agents/`).
+
+O problema atual:
+Quando o usuário roda `npx sauron-cli@latest init` para **atualizar** o Sauron em um projeto existente, a CLI refaz todas as perguntas do onboarding inicial do zero, ignorando as configurações que o usuário já respondeu na primeira instalação.
+
+O que precisamos:
+1. **Detecção de Instalação Existente**: Antes de iniciar o onboarding do `@clack/prompts`, a CLI deve verificar se o `.sauron/.manifest.json` (ou `AGENTS.md`) já existe.
+2. **Reaproveitamento de Respostas**: Se existir, extrair os dados antigos (aiTargets, severity, projectContext, projectStack) e usá-los como `initialValue` nas perguntas do clack.
+3. **Opção de Bypass (Fast-track)**: Melhor ainda seria perguntar "Detectamos uma instalação anterior. Deseja manter as configurações atuais e pular o onboarding? (y/n)". Se 'y', pular as perguntas e apenas re-injetar os arquivos principais atualizados.
+4. **Proteção Rigorosa da Memória**: Garantir que a lógica de atualização **nunca** apague, sobrescreva ou modifique arquivos de documentação criados pelo usuário/IA dentro das subpastas de `.sauron/wiki/` (ex: `knowledge/`, `history/`, `modules/`). A atualização só pode atuar sobre a pasta `.agents/`, `AGENTS.md` e os arquivos base de configuração que vêm nos templates.
+
+Como podemos implementar essa inteligência no nosso comando de init (provavelmente refatorando o `init.command.ts` e o fluxo do `init.service.ts`) de forma elegante, garantindo a idempotência e segurança absoluta dos dados da Wiki?
+```

package/README.md

@@ -24,8 +24,10 @@ npx sauron-cli init
 
 ### `sauron init`
 
-Inicializa o Sauron Memory System no projeto atual.
-Ele executa um onboarding interativo que coleta as tecnologias do seu projeto para gerar um manifesto dinâmico (`AGENTS.md`) e injeta as regras específicas de acordo com os adaptadores de IAs configurados (Cursor AI `.mdc`, Windsurf Cascade `.windsurfrules`, Aider `.aider.instructions.md`, Antigravity).
+Inicializa o Sauron Memory System no projeto atual de forma inteligente.
+O comando executa uma **varredura heurística não-bloqueante** ($O(1)$) na raiz do repositório para detectar de forma autônoma a linguagem primária, frameworks, bancos de dados, gerenciadores de pacotes e ferramentas de IA ativas (Cursor, Windsurf, Aider, Antigravity).
+
+Durante o onboarding interativo, as perguntas são pré-populadas de forma inteligente com as informações detectadas. Ao concluir, o Sauron realiza a **injeção automática de receitas de Wiki** (Wiki Recipes) personalizadas para a sua stack tecnológica em `.sauron/wiki/standards/` (ex. TypeScript, Next.js, React, Tailwind CSS, PostgreSQL) de forma idempotente e não-destrutiva, gerando o manifesto dinâmico `AGENTS.md` e as regras de governança locais das IAs.
 
 ```bash
 # Inicialização interativa padrão

package/dist/index.js

@@ -10,10 +10,6 @@ import pc2 from "picocolors";
 import { fileURLToPath } from "url";
 import * as p2 from "@clack/prompts";
 
-// src/features/init/init.service.ts
-import fs8 from "fs-extra";
-import path8 from "path";
-
 // src/core/manifest.service.ts
 import crypto from "crypto";
 import fs from "fs-extra";
@@ -39,6 +35,10 @@ async function saveManifest(targetDir, manifest) {
   await fs.writeJson(manifestPath, manifest, { spaces: 2 });
 }
 
+// src/features/init/init.service.ts
+import fs8 from "fs-extra";
+import path8 from "path";
+
 // src/core/merge.service.ts
 function checkConflict(localContent, newContent, manifestHash) {
   const localHash = generateHash(localContent);
@@ -53,21 +53,21 @@ function checkConflict(localContent, newContent, manifestHash) {
 
 // src/features/init/templates.ts
 function generateAgentsMarkdown(aiTargets, severity, projectContext, projectStack) {
-  return `# Diretrizes Globais de Agentes (Sauron CLI)
+  return `# Global Agent Guidelines (Sauron CLI)
 
-**Alvos:** ${aiTargets.join(", ")}
-**Severidade:** ${severity}
+**Targets:** ${aiTargets.join(", ")}
+**Severity:** ${severity}
 
-## Contexto do Projeto
+## Project Context
 ${projectContext}
 
-## Stack Tecnol\xF3gica
+## Tech Stack
 ${projectStack}
 
-## Regra de Ouro (Write Obligation)
-Todos os agentes operando neste reposit\xF3rio est\xE3o estritamente obrigados a documentar qualquer altera\xE7\xE3o arquitetural, de regra de neg\xF3cio ou muta\xE7\xE3o de estado nas pastas \`.sauron\` e \`.agents\` correspondentes. A leitura passiva sem documenta\xE7\xE3o \xE9 considerada quebra de compliance.
+## Golden Rule (Write Obligation)
+All agents operating in this repository are strictly OBLIGATED to document any architectural changes, business rules, or state mutations in the corresponding \`.sauron\` and \`.agents\` folders. Passive reading without documentation is considered a compliance violation.
 
-*Gerado automaticamente pelo Sauron CLI.*
+*Automatically generated by Sauron CLI.*
 `;
 }
 
@@ -410,6 +410,10 @@ var InitService = class {
         const targetPath = path8.join(target, file);
         const stat = await fs8.stat(sourcePath);
         if (stat.isDirectory()) {
+          const relativeToTarget = path8.relative(cwd, targetPath).replace(/\\/g, "/");
+          if (relativeToTarget === ".sauron/wiki" && await fs8.pathExists(targetPath)) {
+            continue;
+          }
           await fs8.ensureDir(targetPath);
           await processDirectory(sourcePath, targetPath);
         } else {
@@ -464,6 +468,12 @@ var InitService = class {
       modifiedFiles.push("AGENTS.md");
     }
     manifest.files["AGENTS.md"] = generateHash(agentsMdContent);
+    manifest.config = {
+      aiTargets: options.aiTargets,
+      severity: options.severity,
+      projectContext: options.projectContext,
+      projectStack: options.projectStack
+    };
     await saveManifest(cwd, manifest);
     modifiedFiles.push(".sauron/.manifest.json");
     const memoryFilePath = path8.join(cwd, ".agents", "rules", "memory.md");
@@ -929,7 +939,41 @@ async function runInitCommand(options) {
     ...scannedContext.styling
   ].filter(Boolean).join(", ");
   let projectStack = inferredStackString || "Node.js, TypeScript";
-  if (session.interactive) {
+  let bypassOnboarding = false;
+  const manifestData = await getManifest(cwd);
+  if (manifestData) {
+    if (manifestData.config) {
+      aiTargets = manifestData.config.aiTargets;
+      severity = manifestData.config.severity;
+      projectContext = manifestData.config.projectContext;
+      projectStack = manifestData.config.projectStack;
+    } else {
+      const agentsMdPath = path10.join(cwd, "AGENTS.md");
+      if (await fs10.pathExists(agentsMdPath)) {
+        const content = await fs10.readFile(agentsMdPath, "utf8");
+        const targetsMatch = content.match(/\*\*Targets:\*\* (.*)/);
+        if (targetsMatch) aiTargets = targetsMatch[1].split(",").map((s) => s.trim());
+        const severityMatch = content.match(/\*\*Severity:\*\* (.*)/);
+        if (severityMatch) severity = severityMatch[1].trim();
+        const contextMatch = content.match(/## Project Context\n([\s\S]*?)\n## Tech Stack/);
+        if (contextMatch) projectContext = contextMatch[1].trim();
+        const stackMatch = content.match(/## Tech Stack\n([\s\S]*?)\n## Golden Rule/);
+        if (stackMatch) projectStack = stackMatch[1].trim();
+      }
+    }
+    if (session.interactive) {
+      const bypass = await p2.confirm({
+        message: "Detectamos uma instala\xE7\xE3o anterior. Deseja manter as configura\xE7\xF5es atuais e pular o onboarding?",
+        initialValue: true
+      });
+      if (p2.isCancel(bypass)) {
+        p2.cancel("Inicializa\xE7\xE3o abortada.");
+        process.exit(0);
+      }
+      bypassOnboarding = bypass;
+    }
+  }
+  if (session.interactive && !bypassOnboarding) {
     try {
       const config = await p2.group(
         {
@@ -1282,10 +1326,10 @@ async function runUninstallCommand(options) {
     p4.intro(pc4.bgRed(pc4.white(" Sauron Memory System - Desinstala\xE7\xE3o ")));
   }
   if (session.interactive) {
-    const confirm2 = await p4.confirm({
+    const confirm3 = await p4.confirm({
       message: options.purge ? pc4.red("Tem certeza que deseja desinstalar o Sauron e PURGAR toda a wiki de documenta\xE7\xE3o f\xEDsica?") : "Tem certeza que deseja desinstalar o Sauron deste projeto (a wiki/ de documenta\xE7\xE3o ser\xE1 preservada)?"
     });
-    if (p4.isCancel(confirm2) || !confirm2) {
+    if (p4.isCancel(confirm3) || !confirm3) {
       p4.cancel("Desinstala\xE7\xE3o abortada.");
       process.exit(0);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sauron-cli",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "",
   "main": "dist/index.js",
   "bin": {

package/templates/.agents/rules/memory.md

@@ -2,111 +2,111 @@
 trigger: always_on
 ---
 
-# Regra de Memória do Projeto (OBRIGATÓRIA)
+# Project Memory Rule (MANDATORY)
 
-> Esta regra garante que o Wiki (`.sauron/wiki/`) é a fonte da verdade absoluta do projeto.
-> Violá-la significa perder informação crítica entre sessões.
+> This rule ensures that the Wiki (`.sauron/wiki/`) is the absolute single source of truth for the project.
+> Violating it means losing critical context between sessions.
 
 ---
 
-## 1. LEITURA — Antes de Agir
+## 1. READ — Before Taking Action
 
-Sempre que algo for perguntado ou uma tarefa for iniciada:
+Whenever something is asked or a task is initiated:
 
-1. Leia `.sauron/wiki/summary.json` (o arquivo de roteamento base) primeiro. Este arquivo segue um **padrão rígido** e é a única fonte confiável de metadados.
-2. Navegue pelas sub-páginas relevantes usando as informações de nome original e tipo (file/folder) contidas no JSON.
-3. Só recorra à exploração do sistema de arquivos se a informação **não existir** no sumário (e atualize o sumário se necessário seguindo o schema da Seção 6).
+1. Read `.sauron/wiki/summary.json` (the base routing file) first. This file follows a **strict pattern** and is the only reliable source of metadata.
+2. Navigate through the relevant sub-pages using the original name and type (file/folder) information contained in the JSON.
+3. Only resort to exploring the file system if the information **does not exist** in the summary (and update the summary if necessary following the schema in Section 6).
 
 ---
 
-## 2. PROTOCOLO DE SINCRONIZAÇÃO (NUVEM)
+## 2. SYNCHRONIZATION PROTOCOL (CLOUD)
 
-O fluxo de documentação segue um ciclo de três etapas para garantir a persistência:
+The documentation flow follows a three-step cycle to ensure persistence:
 
-1. **PULL (Manual)**: Antes de iniciar a tarefa, o usuário executa `sauron pull` para atualizar os documentos locais com a versão mais recente da nuvem.
-2. **EXECUÇÃO (IA)**: Durante o desenvolvimento, o Agente atualiza/cria os documentos em `.sauron/wiki/` em tempo real.
-3. **PUSH (Manual)**: Ao finalizar a tarefa, o usuário executa `sauron push` para enviar as atualizações locais para a nuvem.
+1. **PULL (Manual)**: Before starting a task, the user executes `sauron pull` to update local documents with the latest cloud version.
+2. **EXECUTION (AI)**: During development, the Agent updates/creates documents in `.sauron/wiki/` in real-time.
+3. **PUSH (Manual)**: Upon completing the task, the user executes `sauron push` to send local updates to the cloud.
 
 > [!IMPORTANT]
-> O Agente deve assumir que o diretório `.sauron/wiki/` é o destino final e atualizá-lo diligentemente, permitindo que o usuário sincronize as mudanças posteriormente.
+> The Agent MUST assume that the `.sauron/wiki/` directory is the final destination and update it diligently, allowing the user to synchronize changes later.
 
 ---
 
-## 3. ESCRITA — Depois de Entregar (CRÍTICO)
+## 3. WRITE — After Delivering (CRITICAL)
 
-**Após QUALQUER entrega funcional, a wiki DEVE ser atualizada NO MESEMO TURNO de resposta.**
+**After ANY functional delivery, the wiki MUST be updated in the SAME response turn.**
 
-### Gatilhos Obrigatórios de Escrita
+### Mandatory Write Triggers
 
-| Evento | Ação no Wiki |
+| Event | Wiki Action |
 |--------|-------------|
-| **Integração de API externa** | Criar/atualizar página documentando URL, autenticação, payload, resposta e tratamento de erros. |
-| **Nova página/rota criada** | Registrar em `summary.json` (seguindo o **padrão rígido** da Seção 6) + criar arquivo `.md`. |
-| **Fluxo de autenticação alterado** | Atualizar a página de auth com o fluxo completo, incluindo cookies, tokens e middleware. |
-| **Novo componente de UI funcional** | Registrar na página do módulo correspondente com props, comportamento e dependências. |
-| **Decisão arquitetural tomada** | Documentar usando o formato "Decisão Arquitetural" (Problema → Opções → Escolha → Justificativa). |
-| **Variável de ambiente adicionada/alterada** | Registrar na página de infraestrutura com nome, propósito e exemplo. |
-| **Schema de banco alterado** | Atualizar `module-data-schema.md` com a mudança. |
-| **Bug crítico resolvido** | Registrar causa raiz e solução na página do módulo afetado. |
+| **External API integration** | Create/update page documenting URL, authentication, payload, response, and error handling. |
+| **New page/route created** | Register in `summary.json` (following the **strict pattern** in Section 6) + create `.md` file. |
+| **Authentication flow changed** | Update the auth page with the full flow, including cookies, tokens, and middleware. |
+| **New functional UI component** | Register in the corresponding module page with props, behavior, and dependencies. |
+| **Architectural decision made** | Document using the "Architectural Decision" format (Problem → Options → Choice → Justification). |
+| **Environment variable added/changed** | Register in the infrastructure page with name, purpose, and example. |
+| **Database schema changed** | Update `module-data-schema.md` with the change. |
+| **Critical bug resolved** | Register root cause and solution in the affected module page. |
 
-### Regra de Ouro
+### Golden Rule
 
 ```
-❌ ERRADO: Entregar código → Responder ao usuário → Esquecer o wiki
-✅ CORRETO: Entregar código → Atualizar wiki → Responder ao usuário
+❌ WRONG: Deliver code → Respond to user → Forget the wiki
+✅ CORRECT: Deliver code → Update wiki → Respond to user
 ```
 
-A atualização do wiki é **parte da entrega**, não um passo opcional posterior.
+Updating the wiki is **part of the delivery**, not an optional subsequent step.
 
 ---
 
-## 4. FORMATO — O que Escrever
+## 4. FORMAT — What to Write
 
-Cada registro deve conter no mínimo:
-- **O que foi feito** (descrição objetiva)
-- **Por que foi feito** (contexto e motivação)
-- **Como funciona** (detalhes técnicos: endpoints, payloads, fluxos)
-- **Arquivos afetados** (lista de caminhos)
-- **Data** (timestamp da alteração)
+Each record MUST contain at least:
+- **What was done** (objective description)
+- **Why it was done** (context and motivation)
+- **How it works** (technical details: endpoints, payloads, flows)
+- **Files affected** (list of paths)
+- **Date** (timestamp of the change)
 
 ---
 
-## 6. ESTRUTURA RÍGIDA DO SUMMARY.JSON
+## 6. STRICT STRUCTURE OF SUMMARY.JSON
 
-O arquivo `.sauron/wiki/summary.json` é o mapa de metadados que vincula os arquivos locais ao servidor. O CLI exige um padrão estrito para o comando `sauron push` funcionar corretamente.
+The `.sauron/wiki/summary.json` file is the metadata map that links local files to the server. The CLI requires a strict pattern for the `sauron push` command to work correctly.
 
-### Regras de Ouro do Summary
-- **NUNCA altere IDs**: Os campos `id`, `domainId` e `orgId` são cruciais. Removê-los ou alterá-los causará a criação de documentos duplicados no servidor em vez de atualizar os existentes.
-- **Mantenha o Mapeamento**: O campo `name` deve ser o título original (com espaços e acentos). O `slug` e o `path` devem ser gerados seguindo a lógica de normalização (lowercase, sem acentos, espaços viram hífens).
-- **Otimização**: Os campos `contentLength` e `contentHash` (SHA256) permitem que o CLI pule arquivos não alterados. Se você editar um arquivo manualmente, o `push` detectará a mudança mesmo se você não atualizar o hash (ele recalcula o hash local), mas o `summary.json` deve ser mantido atualizado para consistência.
-- **Acoplamento Físico**: O Sauron CLI mapeia domínios do banco de dados na nuvem com base na subpasta física no disco local (usando o diretório pai do arquivo). Arquivos na raiz do wiki sempre pertencerão ao domínio genérico `.`. É obrigatória a organização física em pastas para manter a separação lógica na nuvem.
-- **Ignorar summary.md**: O arquivo `summary.md` é uma página especial/reservada. Nunca adicione o `summary.md` como uma entrada do tipo `"file"` dentro do `summary.json`, caso contrário o CLI tentará excluí-lo e falhará com erro 422.
+### Summary Golden Rules
+- **NEVER alter IDs**: The fields `id`, `domainId`, and `orgId` are crucial. Removing or changing them will cause duplicate documents to be created on the server instead of updating existing ones.
+- **Maintain Mapping**: The `name` field must be the original title (with spaces and accents). The `slug` and `path` must be generated following normalization logic (lowercase, no accents, spaces become hyphens).
+- **Optimization**: The `contentLength` and `contentHash` (SHA256) fields allow the CLI to skip unchanged files. If you manually edit a file, `push` will detect the change even if you don't update the hash (it recalculates the local hash), but `summary.json` should be kept updated for consistency.
+- **Physical Coupling**: Sauron CLI maps database domains in the cloud based on the local physical subfolder (using the file's parent directory). Files in the wiki root will always belong to the generic domain `.`. Physical organization in folders is mandatory to maintain logical separation in the cloud.
+- **Ignore summary.md**: The `summary.md` file is a special/reserved page. Never add `summary.md` as a `"file"` entry inside `summary.json`, otherwise the CLI will attempt to delete it and fail with a 422 error.
 
-### Schema Obrigatório
+### Mandatory Schema
 
-O JSON deve ser um **array de objetos** seguindo rigorosamente estes formatos:
+The JSON MUST be an **array of objects** strictly following these formats:
 
-#### Entrada de Pasta (Domínio)
+#### Folder Entry (Domain)
 ```json
 {
   "type": "folder",
-  "name": "Título Original",
-  "slug": "titulo-original",
-  "path": "titulo-original",
-  "id": "id-do-dominio"
+  "name": "Original Title",
+  "slug": "original-title",
+  "path": "original-title",
+  "id": "domain-id"
 }
 ```
 
-#### Entrada de Arquivo (Documento)
+#### File Entry (Document)
 ```json
 {
   "type": "file",
-  "name": "Título Original do Documento",
-  "slug": "titulo-original-do-documento",
-  "path": "slug-do-dominio/titulo-original-do-documento.md",
-  "id": "id-do-kb",
-  "domainId": "id-do-dominio-pai",
-  "orgId": "id-da-organizacao",
+  "name": "Original Document Title",
+  "slug": "original-document-title",
+  "path": "domain-slug/original-document-title.md",
+  "id": "kb-id",
+  "domainId": "parent-domain-id",
+  "orgId": "organization-id",
   "contentLength": 1234,
   "contentHash": "sha256-checksum"
 }
@@ -114,15 +114,15 @@ O JSON deve ser um **array de objetos** seguindo rigorosamente estes formatos:
 
 ---
 
-## 7. VALIDAÇÃO — Checklist Mental
+## 7. VALIDATION — Mental Checklist
 
-Antes de finalizar qualquer resposta que envolva código, pergunte-se:
+Before finalizing any response involving code, ask yourself:
 
-- [ ] Criei ou modifiquei um arquivo? → Wiki precisa saber.
-- [ ] Conectei a uma API externa? → Wiki precisa documentar.
-- [ ] Alterei fluxo de login/sessão? → Wiki MUST refletir.
-- [ ] Criei uma nova página/rota? → `summary.json` precisa do registro de roteamento seguindo o **padrão rígido**.
-- [ ] Tomei uma decisão técnica (lib X vs Y, abordagem A vs B)? → Wiki precisa da justificativa.
-- [ ] Adicionei/alterei uma variável de ambiente? → Wiki precisa do registro.
+- [ ] Did I create or modify a file? → Wiki needs to know.
+- [ ] Did I connect to an external API? → Wiki needs to document it.
+- [ ] Did I alter the login/session flow? → Wiki MUST reflect it.
+- [ ] Did I create a new page/route? → `summary.json` needs the routing record following the **strict pattern**.
+- [ ] Did I make a technical decision (lib X vs Y, approach A vs B)? → Wiki needs the justification.
+- [ ] Did I add/alter an environment variable? → Wiki needs the record.
 
-Se qualquer checkbox for `true` e o wiki não foi atualizado, **a tarefa NÃO está completa**.
+If any checkbox is `true` and the wiki was not updated, **the task is NOT complete**.

package/templates/.agents/skills/wiki/SKILL.md

@@ -31,9 +31,9 @@ priority: MANDATORY
 | Property | Requirement |
 |----------|-------------|
 | **Base Directory** | `/.sauron/wiki/` |
-| **Root Routing File** | `summary.json` (dentro de `/.sauron/wiki/`) |
-| **Subdirectories** | `knowledge/`, `modules/`, `manuals/`, `standards/`, `history/` (pastas físicas obrigatórias para os domínios no Sauron) |
-| **Naming Pattern** | `{name}.md` (sem prefixos se já estiverem dentro das subpastas físicas de domínio) |
+| **Root Routing File** | `summary.json` (inside `/.sauron/wiki/`) |
+| **Subdirectories** | `knowledge/`, `modules/`, `manuals/`, `standards/`, `history/` (mandatory physical folders for domains in Sauron) |
+| **Naming Pattern** | `{name}.md` (no prefixes if they are already inside physical domain subfolders) |
 | **Examples** | `knowledge/architecture.md`, `modules/checkout.md`, `manuals/upholstery.md` |
 
 ---
@@ -41,25 +41,25 @@ priority: MANDATORY
 ## 3. Reference Templates
 
 ### 3.1 Root Routing File (`summary.json`)
-O arquivo `summary.json` é o mapa de metadados que vincula os arquivos locais ao servidor. Ele segue um **padrão rígido** (ver Seção 6 da `memory.md`).
+The `summary.json` file is the metadata map that links local files to the server. It follows a **strict pattern** (see Section 6 of `memory.md`).
 
 ```json
 [
   {
     "type": "folder",
-    "name": "Título Original",
-    "slug": "titulo-original",
-    "path": "titulo-original",
-    "id": "UUID-ou-ID"
+    "name": "Original Title",
+    "slug": "original-title",
+    "path": "original-title",
+    "id": "UUID-or-ID"
   },
   {
     "type": "file",
-    "name": "Título Original",
-    "slug": "titulo-original",
-    "path": "slug-do-dominio/titulo-original.md",
-    "id": "UUID-ou-ID",
-    "domainId": "ID-do-pai",
-    "orgId": "ID-da-organizacao",
+    "name": "Original Title",
+    "slug": "original-title",
+    "path": "domain-slug/original-title.md",
+    "id": "UUID-or-ID",
+    "domainId": "parent-ID",
+    "orgId": "organization-ID",
     "contentLength": 1234,
     "contentHash": "sha256-checksum"
   }

package/OpenSpec-main/.actrc

@@ -1 +0,0 @@
--P ubuntu-latest=catthehacker/ubuntu:act-latest

package/OpenSpec-main/.changeset/README.md

@@ -1,97 +0,0 @@
-# Changesets
-
-This directory is managed by [Changesets](https://github.com/changesets/changesets).
-
-## Quick Start
-
-```bash
-pnpm changeset
-```
-
-Follow the prompts to select version bump type and describe your changes.
-
-## Workflow
-
-1. **Choose the release path**: Maintainers decide whether a PR follows the normal release cadence or gets dedicated release tracking.
-2. **Add dedicated release tracking**: When a maintainer asks for a changeset, run `pnpm changeset` locally before or after your PR.
-3. **Version PR**: CI opens/updates a "Version Packages" PR when changesets merge to main.
-4. **Release**: Merging the Version PR triggers npm publish and GitHub Release.
-
-> **Note:** The default path is the normal release cadence. Add a changeset when a maintainer or release owner wants dedicated release notes and version tracking for the PR. Versioning (`changeset version`) and publishing happen automatically in CI.
-
-## Template
-
-Use this structure for your changeset content:
-
-```markdown
----
-"@fission-ai/openspec": patch
----
-
-### New Features
-
-- **Feature name** — What users can now do
-
-### Bug Fixes
-
-- Fixed issue where X happened when Y
-
-### Breaking Changes
-
-- `oldMethod()` has been removed, use `newMethod()` instead
-
-### Deprecations
-
-- `legacyOption` is deprecated and will be removed in v2.0
-
-### Other
-
-- Internal refactoring of X for better performance
-```
-
-Include only the sections relevant to your change.
-
-## Version Bump Guide
-
-| Type | When to use | Example |
-|------|-------------|---------|
-| `patch` | Release-tracked bug fixes, small improvements | Fixed crash when config missing |
-| `minor` | New features, non-breaking additions | Added `--verbose` flag |
-| `major` | Breaking changes, removed features | Renamed `init` to `setup` |
-
-## When to Create a Changeset
-
-**Use dedicated release tracking for:**
-- New features or commands selected for release
-- Notable bug fixes or hotfixes requested by a maintainer/release owner
-- Breaking changes or deprecations
-- Performance improvements users would notice and that are planned for release
-
-**Use the normal release cadence for:**
-- Routine bug fixes that fit the normal release cadence
-- Documentation-only changes
-- Test additions/fixes
-- Internal refactoring that preserves user behavior
-- CI/tooling changes
-
-## Writing Good Descriptions
-
-**Do:** Write for users, not developers
-```markdown
-- **Shell completions** — Tab completion now available for Bash, Fish, and PowerShell
-```
-
-**Don't:** Write implementation details
-```markdown
-- Added ShellCompletionGenerator class with Bash/Fish/PowerShell subclasses
-```
-
-**Do:** Explain the impact
-```markdown
-- Fixed config loading to respect `XDG_CONFIG_HOME` on Linux
-```
-
-**Don't:** Just reference the fix
-```markdown
-- Fixed #123
-```

package/OpenSpec-main/.changeset/config.json

@@ -1,15 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@changesets/config/schema.json",
-  "changelog": [
-    "@changesets/changelog-github",
-    { "repo": "Fission-AI/OpenSpec" }
-  ],
-  "commit": false,
-  "fixed": [],
-  "linked": [],
-  "access": "public",
-  "baseBranch": "main",
-  "updateInternalDependencies": "patch",
-  "ignore": []
-}
-

package/OpenSpec-main/.coderabbit.yaml

@@ -1,11 +0,0 @@
-# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
-# Minimal configuration for getting started
-language: "en-US"
-reviews:
-  profile: "chill"
-  high_level_summary: true
-  auto_review:
-    enabled: true
-    drafts: false
-    base_branches:
-      - ".*"