@frenchtoastman/oh-my-groundcontrol 0.0.7 → 0.0.11

package/README.md

@@ -44,7 +44,7 @@ Install and configure by following the instructions here:
 https://raw.githubusercontent.com/frenchtoasters/oh-my-groundcontrol/refs/heads/master/README.md
 ```
 
-**Detailed installation guide:** [docs/installation.md](docs/installation.md)
+**Note:** We recommend adding `.groundcontrol/` to your project's `.gitignore` to prevent generated flight plans from being committed.
 
 **Additional guides:**
 - **[Antigravity Setup](docs/antigravity.md)** - Complete guide for Antigravity provider configuration  
@@ -56,9 +56,26 @@ https://raw.githubusercontent.com/frenchtoasters/oh-my-groundcontrol/refs/heads/
 
 ### Mission Control Standards Adherence
 
-Our planning, execution, and verification pipelines enforce protocols based on official NASA standards:
-- **[NASA-STD-8739.8B](https://standards.nasa.gov/system/files/tmp/NASA-STD-8739.8B.pdf)** (Software Assurance and Software Safety Standard): Ensures rigorous traceability, off-nominal scenario handling, and safety-critical QA paths during the Groundcontrol planning phase.
-- **[NASA-STD-7009B](https://standards.nasa.gov/sites/default/files/standards/NASA/B/1/NASA-STD-7009B-Final-3-5-2024.pdf)** (Standard for Models and Simulations): Required during complex system modeling to enforce credibility assessment before committing to architectural designs.
+Our planning, execution, and verification pipelines enforce protocols based on official NASA standards. We have synthesized these into four core **NASA Guardrails** for AI agent execution:
+
+1. **Destructive Pause (NASA-STD-8739.8B):** Stop and request explicit user confirmation before irreversible actions (e.g., force pushing, bulk deletions).
+2. **Pre-Flight Verification (NASA-HDBK-8739.19-3):** Always run linters and typechecks (`bun run check:ci`, `bun run typecheck`) to validate changes before concluding.
+3. **Atomic Checkpoints (NASA-HDBK-8739.18):** Commit stable states before initiating widespread refactors.
+4. **Escalation Protocol (NASA-STD-7009B):** If an automated check fails 3+ times, stop guessing and ask the user for guidance.
+
+#### Source Documentation
+The principles driving our agent behavior are extracted directly from the [NASA Technical Standards System](https://standards.nasa.gov):
+
+- [NASA-STD-7009B](https://standards.nasa.gov/standard/nasa/nasa-std-7009): Standard for Models and Simulations
+- [NASA-STD-8739.8B](https://standards.nasa.gov/standard/nasa/nasa-std-87398): Software Assurance and Software Safety Standard
+- [NASA-STD-5017B](https://standards.nasa.gov/standard/nasa/nasa-std-5017): Design and Development Requirements for Mechanisms
+- [NASA-HDBK-8739.18](https://standards.nasa.gov/standard/nasa/nasa-hdbk-873918): Software Engineering Handbook
+- [NASA-HDBK-8739.19-2](https://standards.nasa.gov/standard/nasa/nasa-hdbk-873919-2): Software Assurance Handbook
+- [NASA-HDBK-8739.19-3](https://standards.nasa.gov/standard/nasa/nasa-hdbk-873919-3): Software Measurement Handbook
+- [NASA-HDBK-8709.22](https://standards.nasa.gov/standard/nasa/nasa-hdbk-870922): Safety and Mission Assurance Acronyms, Abbreviations, and Definitions
+- [NASA-HDBK-8709.24](https://standards.nasa.gov/standard/nasa/nasa-hdbk-870924): Planetary Protection Handbook
+- [NASA-HDBK-1004](https://standards.nasa.gov/standard/nasa/nasa-hdbk-1004): Data Requirements Descriptions (DRDs) for Software
+- [NASA-HDBK-1009A](https://standards.nasa.gov/standard/nasa/nasa-hdbk-1009): Software Error Causes
 
 > *At mission control, ten specialized operators govern the success of every launch. Each holds authority over a critical telemetry system. Together they ensure mission success. Here, ten agents govern the craft of code.*
 
@@ -66,26 +83,6 @@ Our planning, execution, and verification pipelines enforce protocols based on o
 
 *Those who plan, perceive, and verify before the launch sequence begins.*
 
-```mermaid
-graph TD
-    U["🧑 User"] -->|"request"| P["🏛️ Groundcontrol"]
-    P -->|"gap analysis"| S["👁️ PreFlight"]
-    P -->|"codebase recon"| E["🧭 Explorer"]
-    P -->|"knowledge retrieval"| L["📜 Librarian"]
-    P -->|"plan verification"| M["⚖️ Verification"]
-    S -.->|"risks & gaps"| P
-    E -.->|"file map"| P
-    L -.->|"docs & references"| P
-    M -.->|"PASS / FAIL"| P
-    P -->|"approved plan"| O["👑 Orchestrator"]
-
-    style P fill:#2d4a22,stroke:#4a7c34,color:#fff
-    style S fill:#4a3728,stroke:#7a5a3e,color:#fff
-    style E fill:#1a3a4a,stroke:#2a6a8a,color:#fff
-    style L fill:#3a2a4a,stroke:#6a4a8a,color:#fff
-    style M fill:#4a4a1a,stroke:#8a8a2a,color:#fff
-    style O fill:#4a2a1a,stroke:#8a4a2a,color:#fff
-```
 
 ---
 
@@ -183,25 +180,6 @@ graph TD
 
 *Those who explore, advise, and execute once the plan is authorized.*
 
-```mermaid
-graph TD
-    P["🏛️ Groundcontrol"] -->|"approved plan"| O["👑 Orchestrator"]
-    O -->|"implementation"| F["⚒️ Fixer"]
-    O -->|"UI/UX"| D["🎨 Designer"]
-    O -->|"codebase recon"| E["🧭 Explorer"]
-    O -->|"architecture advice"| R["🔮 Oracle"]
-    F -.->|"code changes"| O
-    D -.->|"visual polish"| O
-    E -.->|"file map"| O
-    R -.->|"guidance"| O
-
-    style O fill:#4a2a1a,stroke:#8a4a2a,color:#fff
-    style F fill:#3a3a3a,stroke:#6a6a6a,color:#fff
-    style D fill:#4a1a3a,stroke:#8a2a6a,color:#fff
-    style E fill:#1a3a4a,stroke:#2a6a8a,color:#fff
-    style R fill:#2a2a4a,stroke:#4a4a8a,color:#fff
-    style P fill:#2d4a22,stroke:#4a7c34,color:#fff
-```
 
 ---
 

package/dist/agents/groundcontrol/system-prompt.d.ts

@@ -9,8 +9,11 @@ export declare const GROUNDCONTROL_SYSTEM_PROMPT = "<system-reminder>\n# Groundc
  * Question permission allows agent to ask user questions.
  */
 export declare const GROUNDCONTROL_PERMISSION: {
-    edit: "allow";
-    bash: "allow";
+    edit: {
+        '.groundcontrol/**/*': "allow";
+        '*': "ask";
+    };
+    bash: "ask";
     webfetch: "allow";
     question: "allow";
 };

package/dist/index.js

@@ -18952,6 +18952,12 @@ var DESIGNER_PROMPT = `You are a Designer - a frontend UI/UX specialist who crea
 - Leverage component libraries where available
 - Prioritize visual excellence\u2014code perfection comes second
 
+**NASA Guardrails (High-Reliability Mode)**:
+- **Destructive Pause**: Stop and request explicit user confirmation before irreversible actions (e.g., force pushing, bulk deletions).
+- **Pre-Flight Verification**: Always run linters/typechecks (\`bun run check:ci\`, \`bun run typecheck\`) to validate changes before concluding.
+- **Atomic Checkpoints**: Commit stable states before initiating widespread refactors.
+- **Escalation Protocol**: If an automated check fails 3+ times, stop guessing and ask the user for guidance.
+
 ## Output Quality
 You're capable of extraordinary creative work. Commit fully to distinctive visions and show what's possible when breaking conventions thoughtfully.`;
 function createDesignerAgent(model, customPrompt, customAppendPrompt) {
@@ -19012,7 +19018,13 @@ Concise answer to the question
 **Constraints**:
 - READ-ONLY: Search and report, don't modify
 - Be exhaustive but concise
-- Include line numbers when relevant`;
+- Include line numbers when relevant
+
+**NASA Guardrails (High-Reliability Mode)**:
+- **Destructive Pause**: Stop and request explicit user confirmation before irreversible actions (e.g., force pushing, bulk deletions).
+- **Pre-Flight Verification**: Always run linters/typechecks (\`bun run check:ci\`, \`bun run typecheck\`) to validate changes before concluding.
+- **Atomic Checkpoints**: Commit stable states before initiating widespread refactors.
+- **Escalation Protocol**: If an automated check fails 3+ times, stop guessing and ask the user for guidance.`;
 function createExplorerAgent(model, customPrompt, customAppendPrompt) {
   let prompt = EXPLORER_PROMPT;
   if (customPrompt) {
@@ -19073,7 +19085,13 @@ No changes required
 <verification>
 - Tests passed: [not run - reason]
 - LSP diagnostics: [not run - reason]
-</verification>`;
+</verification>
+
+**NASA Guardrails (High-Reliability Mode)**:
+- **Destructive Pause**: Stop and request explicit user confirmation before irreversible actions (e.g., force pushing, bulk deletions).
+- **Pre-Flight Verification**: Always run linters/typechecks (\`bun run check:ci\`, \`bun run typecheck\`) to validate changes before concluding.
+- **Atomic Checkpoints**: Commit stable states before initiating widespread refactors.
+- **Escalation Protocol**: If an automated check fails 3+ times, stop guessing and ask the user for guidance.`;
 function createFixerAgent(model, customPrompt, customAppendPrompt) {
   let prompt = FIXER_PROMPT;
   if (customPrompt) {
@@ -20802,8 +20820,11 @@ ${GROUNDCONTROL_HIGH_ACCURACY_MODE}
 ${GROUNDCONTROL_PLAN_TEMPLATE}
 ${GROUNDCONTROL_BEHAVIORAL_SUMMARY}`;
 var GROUNDCONTROL_PERMISSION = {
-  edit: "allow",
-  bash: "allow",
+  edit: {
+    ".groundcontrol/**/*": "allow",
+    "*": "ask"
+  },
+  bash: "ask",
   webfetch: "allow",
   question: "allow"
 };
@@ -20866,7 +20887,13 @@ var LIBRARIAN_PROMPT = `You are Librarian - a research specialist for codebases
 - Provide evidence-based answers with sources
 - Quote relevant code snippets
 - Link to official docs when available
-- Distinguish between official and community patterns`;
+- Distinguish between official and community patterns
+
+**NASA Guardrails (High-Reliability Mode)**:
+- **Destructive Pause**: Stop and request explicit user confirmation before irreversible actions (e.g., force pushing, bulk deletions).
+- **Pre-Flight Verification**: Always run linters/typechecks (\`bun run check:ci\`, \`bun run typecheck\`) to validate changes before concluding.
+- **Atomic Checkpoints**: Commit stable states before initiating widespread refactors.
+- **Escalation Protocol**: If an automated check fails 3+ times, stop guessing and ask the user for guidance.`;
 function createLibrarianAgent(model, customPrompt, customAppendPrompt) {
   let prompt = LIBRARIAN_PROMPT;
   if (customPrompt) {
@@ -20907,7 +20934,13 @@ var ORACLE_PROMPT = `You are Oracle - a strategic technical advisor.
 **Constraints**:
 - READ-ONLY: You advise, you don't implement
 - Focus on strategy, not execution
-- Point to specific files/lines when relevant`;
+- Point to specific files/lines when relevant
+
+**NASA Guardrails (High-Reliability Mode)**:
+- **Destructive Pause**: Stop and request explicit user confirmation before irreversible actions (e.g., force pushing, bulk deletions).
+- **Pre-Flight Verification**: Always run linters/typechecks (\`bun run check:ci\`, \`bun run typecheck\`) to validate changes before concluding.
+- **Atomic Checkpoints**: Commit stable states before initiating widespread refactors.
+- **Escalation Protocol**: If an automated check fails 3+ times, stop guessing and ask the user for guidance.`;
 function createOracleAgent(model, customPrompt, customAppendPrompt) {
   let prompt = ORACLE_PROMPT;
   if (customPrompt) {
@@ -21052,6 +21085,12 @@ Balance: respect dependencies, avoid parallelizing what must be sequential.
 - Confirm specialists completed successfully
 - Verify solution meets requirements
 
+## NASA Guardrails (High-Reliability Mode)
+1. **Destructive Pause:** Stop and request explicit user confirmation before irreversible actions (e.g., force pushing, bulk deletions).
+2. **Pre-Flight Verification:** Always run linters/typechecks (\`bun run check:ci\`, \`bun run typecheck\`) to validate changes before concluding.
+3. **Atomic Checkpoints:** Commit stable states before initiating widespread refactors.
+4. **Escalation Protocol:** If an automated check fails 3+ times, stop guessing and ask the user for guidance.
+
 ## Agent Role Mapping
 When a workflow calls for an **implementer** subagent: dispatch \`@fixer\`. Fixer has enforced constraints (no research, no delegation, structured output) that match the implementer role exactly.
 When a workflow calls for a **reviewer** subagent: dispatch \`@oracle\`. Oracle has the depth for architectural review and access to code review skills.
@@ -23104,13 +23143,13 @@ function createAutoUpdateCheckerHook(ctx, options = {}) {
         const displayVersion = localDevVersion ?? cachedVersion;
         if (localDevVersion) {
           if (showStartupToast) {
-            showToast(ctx, `OMO-Slim ${displayVersion} (dev)`, "Running in local development mode.", "info");
+            showToast(ctx, `OMO-Groundcontrol ${displayVersion} (dev)`, "Running in local development mode.", "info");
           }
           log("[auto-update-checker] Local development mode");
           return;
         }
         if (showStartupToast) {
-          showToast(ctx, `OMO-Slim ${displayVersion ?? "unknown"}`, "oh-my-groundcontrol is active.", "info");
+          showToast(ctx, `OMO-Groundcontrol ${displayVersion ?? "unknown"}`, "oh-my-groundcontrol is active.", "info");
         }
         runBackgroundUpdateCheck(ctx, autoUpdate).catch((err) => {
           log("[auto-update-checker] Background update check failed:", err);
@@ -23143,14 +23182,14 @@ async function runBackgroundUpdateCheck(ctx, autoUpdate) {
   }
   log(`[auto-update-checker] Update available (${channel}): ${currentVersion} \u2192 ${latestVersion}`);
   if (!autoUpdate) {
-    showToast(ctx, `OMO-Slim ${latestVersion}`, `v${latestVersion} available. Restart to apply.`, "info", 8000);
+    showToast(ctx, `OMO-Groundcontrol ${latestVersion}`, `v${latestVersion} available. Restart to apply.`, "info", 8000);
     log("[auto-update-checker] Auto-update disabled, notification only");
     return;
   }
   if (pluginInfo.isPinned) {
     const updated = updatePinnedVersion(pluginInfo.configPath, pluginInfo.entry, latestVersion);
     if (!updated) {
-      showToast(ctx, `OMO-Slim ${latestVersion}`, `v${latestVersion} available. Restart to apply.`, "info", 8000);
+      showToast(ctx, `OMO-Groundcontrol ${latestVersion}`, `v${latestVersion} available. Restart to apply.`, "info", 8000);
       log("[auto-update-checker] Failed to update pinned version in config");
       return;
     }
@@ -23159,11 +23198,11 @@ async function runBackgroundUpdateCheck(ctx, autoUpdate) {
   invalidatePackage(PACKAGE_NAME);
   const installSuccess = await runBunInstallSafe(ctx);
   if (installSuccess) {
-    showToast(ctx, "OMO-Slim Updated!", `v${currentVersion} \u2192 v${latestVersion}
+    showToast(ctx, "OMO-Groundcontrol Updated!", `v${currentVersion} \u2192 v${latestVersion}
 Restart OpenCode to apply.`, "success", 8000);
     log(`[auto-update-checker] Update installed: ${currentVersion} \u2192 ${latestVersion}`);
   } else {
-    showToast(ctx, `OMO-Slim ${latestVersion}`, `v${latestVersion} available. Restart to apply.`, "info", 8000);
+    showToast(ctx, `OMO-Groundcontrol ${latestVersion}`, `v${latestVersion} available. Restart to apply.`, "info", 8000);
     log("[auto-update-checker] bun install failed; update not installed");
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@frenchtoastman/oh-my-groundcontrol",
-  "version": "0.0.7",
-  "description": "Lightweight agent orchestration plugin for OpenCode - a slimmed-down fork of oh-my-opencode",
+  "version": "0.0.11",
+  "description": "An OpenCode plugin for multi-agent orchestration for structured planning with NASA-style guardrails.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {