ai-execution-protocol 0.2.1 → 0.3.0

package/scripts/verify_install.py

@@ -1,93 +1,34 @@
 #!/usr/bin/env python3
-"""Verify that a target project has the mandatory AI protocol installed."""
+"""Verify an installed protocol using the shared install manifest."""
 
 from __future__ import annotations
 
 import argparse
+import json
 from pathlib import Path
 
 
-REQUIRED_FILES = [
-    "AGENTS.md",
-    ".aiignore",
-    "canonical-state.yaml",
-    "context-map.yaml",
-    "decisions/README.md",
-    "protocol/README.yaml",
-    "protocol/fast-path.yaml",
-    "protocol/router.yaml",
-    "protocol/route-packs.yaml",
-    "protocol/modes.yaml",
-    "protocol/execution-rules.yaml",
-    "protocol/risk-levels.yaml",
-    "protocol/mapping-checklists.yaml",
-    "protocol/validation-checklist.yaml",
-    "protocol/context-rules.yaml",
-    "protocol/context-compiler.yaml",
-    "protocol/persistent-context.yaml",
-    "protocol/formatting-rules.yaml",
-    "protocol/prompt-economy.yaml",
-    "protocol/spec-driven.yaml",
-]
+ROOT = Path(__file__).resolve().parents[1]
 
-REQUIRED_TEXT = {
-    "AGENTS.md": [
-        "AI_PROTOCOL_BEGIN",
-        "protocol/fast-path.yaml",
-        "protocol/router.yaml",
-        "Classifique o risco antes de agir",
-        "Prompt original",
-        "Prompt melhorado da IA",
-        "lista do que",
-        "Nenhum arquivo deve passar de 400 linhas.",
-    ],
-    ".aiignore": [
-        "results/",
-        "dist/",
-        "*.pyc",
-    ],
-    "canonical-state.yaml": [
-        "canonical_state",
-        "truth_order",
-    ],
-    "context-map.yaml": [
-        "project_context_map",
-        "aliases_are_pointers_not_truth",
-    ],
-    "protocol/router.yaml": [
-        "feature_or_spec",
-        "spec-driven.yaml",
-        "prompt_improvement",
-    ],
-    "protocol/route-packs.yaml": [
-        "read_pack_first_expand_only_when_needed",
-        "simple_answer",
-        "context_optimization",
-    ],
-    "protocol/spec-driven.yaml": [
-        "protocol_is_base_spec_is_tool",
-        "do_not_create_spec_for_low_value_tasks",
-    ],
-}
 
+def load_manifest() -> dict:
+    return json.loads((ROOT / "install-manifest.json").read_text(encoding="utf-8"))
 
-def main() -> int:
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--target", required=True, help="Project root to verify")
-    args = parser.parse_args()
-
-    root = Path(args.target).resolve()
-    errors: list[str] = []
 
-    for item in REQUIRED_FILES:
+def verify(root: Path) -> list[str]:
+    manifest = load_manifest()
+    required = manifest["required_files"] + [
+        f"protocol/{name}" for name in manifest["protocol_files"]
+    ]
+    errors = []
+    for item in required:
         path = root / item
         if not path.exists():
             errors.append(f"missing:{item}")
             continue
         if path.is_file() and len(path.read_text(encoding="utf-8").splitlines()) > 400:
             errors.append(f"line_limit:{item}")
-
-    for item, snippets in REQUIRED_TEXT.items():
+    for item, snippets in manifest["required_text"].items():
         path = root / item
         if not path.exists() or not path.is_file():
             continue
@@ -95,15 +36,18 @@ def main() -> int:
         for snippet in snippets:
             if snippet not in text:
                 errors.append(f"missing_text:{item}:{snippet}")
+    return errors
 
-    if errors:
-        print("FAIL")
-        for error in errors:
-            print(error)
-        return 1
 
-    print("PASS")
-    return 0
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--target", required=True, help="Project root to verify")
+    args = parser.parse_args()
+    errors = verify(Path(args.target).resolve())
+    print("PASS" if not errors else "FAIL")
+    for error in errors:
+        print(error)
+    return 1 if errors else 0
 
 
 if __name__ == "__main__":

package/templates/minimal/.aiignore

@@ -0,0 +1,8 @@
+results/
+benchmarks/generated/
+model-runs/generated/
+dist/
+memory/archive/
+candidate-memory/
+scripts/__pycache__/
+*.pyc

package/templates/minimal/AGENTS.md

@@ -0,0 +1,41 @@
+# AGENTS.md
+
+## Regra principal
+
+<!-- AI_PROTOCOL_BEGIN -->
+
+Use `protocol/fast-path.yaml` como entrada operacional minima.
+
+Este protocolo e obrigatorio para tarefas tecnicas. Classifique risco, escolha
+rota, consulte o pack compacto, carregue somente memoria relevante e valide a
+entrega.
+
+## Ordem de leitura
+
+1. `protocol/fast-path.yaml`
+2. `protocol/router.yaml`
+3. `protocol/route-packs.yaml`
+4. `memory/INDEX.yaml` somente quando memoria puder ajudar
+5. YAML completo da rota somente quando o pack nao bastar
+
+## Regras de execucao
+
+- Classifique o risco antes de agir.
+- Use o menor contexto suficiente e respeite `protocol/context-budget.yaml`.
+- Memoria orienta; pedido atual autoriza; codigo verificado define realidade.
+- Nunca amplie escopo com base em previsao ou preferencia antiga.
+- Use `protocol/selective-validation.yaml` para escolher a menor prova suficiente.
+- Ao terminar, verifique memoria: updated, unchanged, candidate, replaced ou
+  blocked_sensitive.
+- Nao persista segredo, token, dado de cliente ou informacao pessoal desnecessaria.
+- Para nivel critico, peca confirmacao antes de acao sensivel.
+- Entregue mudanca, validacao, limite e risco residual em poucas linhas.
+
+## Regras de organizacao
+
+- Nenhum arquivo fonte deve passar de 400 linhas.
+- Organize por assunto rastreavel.
+- Use YAML para operacao e Markdown para explicacao.
+- Evite duplicar regras e memoria.
+
+<!-- AI_PROTOCOL_END -->

package/templates/minimal/candidate-memory/README.md

@@ -0,0 +1,4 @@
+# Candidate Memory
+
+Store inferred, non-sensitive memory candidates here until evidence or user
+confirmation is enough for promotion.

package/templates/minimal/canonical-state.yaml

@@ -0,0 +1,16 @@
+id: canonical_state
+type: project_state
+version: 0.3
+purpose: small_current_truth_summary_for_ai_navigation
+status: bootstrap_template
+truth_order:
+  - current_user_request
+  - verified_current_files
+  - active_project_decisions
+  - explicit_user_preferences
+  - inferred_patterns_with_evidence
+  - project_docs
+  - conversation_history
+notes:
+  - memory_guides_current_request_authorizes
+  - update_when_verified_project_state_changes

package/templates/minimal/context-map.yaml

@@ -0,0 +1,22 @@
+id: project_context_map
+type: context_map
+version: 0.3
+purpose: small_index_for_progressive_context_retrieval
+maintenance:
+  current_mode: manual_bootstrap
+  rule: aliases_are_pointers_not_truth
+read_first:
+  - canonical-state.yaml
+  - protocol/fast-path.yaml
+  - protocol/router.yaml
+  - protocol/route-packs.yaml
+  - memory/INDEX.yaml
+domains: {}
+retrieval_policy:
+  order:
+    - match_domain_by_alias
+    - read_matching_memory_subjects
+    - read_domain_docs_only_when_needed
+    - search_candidate_files_or_symbols
+    - read_relevant_snippet_first
+    - read_full_file_when_snippet_is_not_enough

package/templates/minimal/decisions/README.md

@@ -0,0 +1,4 @@
+# Decisions
+
+Record confirmed project decisions with status, scope, evidence and replacement
+history.

package/templates/minimal/memory/INDEX.yaml

@@ -0,0 +1,20 @@
+id: memory_index
+type: memory_index
+version: 0.3
+purpose: route_to_minimum_relevant_persistent_memory
+policy:
+  - read_only_matching_subjects
+  - do_not_load_archive_by_default
+  - current_request_overrides_memory
+  - verified_files_override_stale_memory
+entries: []
+areas:
+  user:
+    path: memory/user/
+  projects:
+    path: memory/projects/
+  patterns:
+    path: memory/patterns/
+  archive:
+    path: memory/archive/
+    read_by_default: false