@aiwg/cli 2026.9.2 → 2026.9.4

package/README.md

@@ -961,6 +961,27 @@ If both `aiwg` and `@aiwg/cli` were installed into the same prefix, the most
 recent install owns the shared executable link. Remove both, then install the
 distribution you intend to use.
 
+### Bundled setup requires the full package
+
+`aiwg use all` and named framework setup such as `aiwg use sdlc` need the
+framework and addon sources included in `aiwg`. The lightweight `@aiwg/cli`
+package supports signed web lookup and external project-local bundle deployment;
+web lookup does not download a complete source tree for bundled setup.
+
+If setup reports that the full package is required, replace the lightweight
+global installation and rerun setup with your provider:
+
+```bash
+npm uninstall -g @aiwg/cli
+npm install -g aiwg
+aiwg use all --provider pi
+```
+
+Older CLI versions can instead report `ENOENT` while scanning
+`@aiwg/cli/agentic/code/addons`. The same recovery applies. Existing project
+files are retained; the prerequisite check now stops before deployment or
+project initialization, including in dry-run mode.
+
 ## Migrating Between Distributions
 
 From full AIWG to the lightweight package:

package/agentic/code/providers/antigravity/provider-contract.v1.json

@@ -0,0 +1,121 @@
+{
+  "schemaVersion": 1,
+  "contractVersion": "1.0.0",
+  "provider": "antigravity",
+  "aliases": ["agy"],
+  "displayName": "Google Antigravity CLI",
+  "status": "experimental",
+  "qualifiedCli": {
+    "executable": "agy",
+    "version": "1.1.26",
+    "platform": "linux-x64",
+    "observedOn": "2026-09-04",
+    "authenticatedExecution": false
+  },
+  "evidence": [
+    {
+      "id": "official-transition",
+      "url": "https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/",
+      "retrieved": "2026-09-04",
+      "confidence": "high"
+    },
+    {
+      "id": "official-install",
+      "url": "https://antigravity.google/docs/cli/install/",
+      "retrieved": "2026-09-04",
+      "confidence": "high"
+    },
+    {
+      "id": "official-headless",
+      "url": "https://antigravity.google/docs/cli/headless/",
+      "retrieved": "2026-09-04",
+      "confidence": "high"
+    },
+    {
+      "id": "official-mcp",
+      "url": "https://antigravity.google/docs/cli/mcp/",
+      "retrieved": "2026-09-04",
+      "confidence": "high"
+    },
+    {
+      "id": "official-skills",
+      "url": "https://antigravity.google/docs/cli/plugins/",
+      "retrieved": "2026-09-04",
+      "confidence": "medium",
+      "notes": "Official pages disagree about the global skills directory and flat versus nested project layouts."
+    },
+    {
+      "id": "official-subagents",
+      "url": "https://antigravity.google/docs/cli/subagents/",
+      "retrieved": "2026-09-04",
+      "confidence": "high"
+    },
+    {
+      "id": "local-cli-help",
+      "path": "test/fixtures/providers/antigravity-conformance/help-1.1.26.json",
+      "retrieved": "2026-09-04",
+      "confidence": "high",
+      "sanitized": true
+    }
+  ],
+  "surfaces": {
+    "selection": { "classification": "native", "canonical": "antigravity", "aliases": ["agy"] },
+    "context": {
+      "classification": "native",
+      "projectFiles": ["AGENTS.md", "GEMINI.md"],
+      "precedence": "provider-defined; no undocumented include syntax assumed"
+    },
+    "workspaceSkills": {
+      "classification": "native",
+      "path": ".agents/skills",
+      "layout": "nested-skill-md",
+      "notes": "AIWG deploys directories containing SKILL.md and preserves unrelated children."
+    },
+    "globalSkills": {
+      "classification": "unknown",
+      "enabled": false,
+      "candidates": ["~/.gemini/antigravity-cli/skills", "~/.gemini/config/skills"],
+      "reason": "Conflicting official documentation; deferred pending a safe version-pinned probe."
+    },
+    "customAgents": {
+      "classification": "native",
+      "projectPaths": [".agents/agents/<name>.md", ".agents/agents/<name>/agent.md"],
+      "selectedLayout": "flat-markdown",
+      "projection": "degraded",
+      "reason": "Only AIWG tool names with documented Antigravity equivalents are projected; provider-specific model policy remains runtime-scoped."
+    },
+    "mcp": {
+      "classification": "native",
+      "projectPath": ".agents/mcp_config.json",
+      "userPath": "~/.gemini/config/mcp_config.json",
+      "serversKey": "mcpServers",
+      "remoteUrlKey": "serverUrl",
+      "merge": "preserve unrelated top-level keys and operator-owned server names"
+    },
+    "headless": {
+      "classification": "native",
+      "baseArgs": ["-p"],
+      "jsonArgs": ["--output-format", "json"],
+      "streamArgs": ["--output-format", "stream-json"],
+      "interactiveStreamArgs": ["--input-format", "stream-json", "--output-format", "stream-json"],
+      "continueFlags": ["--continue", "--conversation"],
+      "dangerousFlag": "--dangerously-skip-permissions",
+      "defaultPermissionMode": "request-review",
+      "stdout": "protocol",
+      "stderr": "diagnostics"
+    },
+    "teams": { "classification": "emulated", "adapter": "aiwg-mc" },
+    "cron": { "classification": "external", "adapter": "operator-owned scheduler invoking the bounded headless adapter" },
+    "tasks": { "classification": "emulated", "adapter": "aiwg-mc" },
+    "behaviors": { "classification": "unsupported" },
+    "missionControl": { "classification": "emulated", "adapter": "aiwg-mc" },
+    "daemon": { "classification": "unsupported" },
+    "plugins": { "classification": "unknown", "enabled": false }
+  },
+  "safety": {
+    "normalCi": "offline-only",
+    "readsUserConfiguration": false,
+    "writesAuthOrPermissionSettings": false,
+    "liveSmoke": "opt-in-only"
+  }
+}

package/agentic/code/providers/capability-matrix.yaml

@@ -361,7 +361,7 @@ providers:
 
   hermes:
     display_name: Hermes
-    status: experimental
+    status: stable
     daemon_tier: unsupported
     daemon_pty_adapter: false
     artifact_paths:
@@ -470,6 +470,51 @@ providers:
     deploy_target: mixed
     aggregated_output: true
 
+  antigravity:
+    display_name: Google Antigravity CLI
+    aliases:
+      - agy
+    status: experimental
+    executable: agy
+    qualified_version: 1.1.26
+    qualification_evidence: agentic/code/providers/antigravity/provider-contract.v1.json
+    daemon_tier: unsupported
+    daemon_pty_adapter: false
+    artifact_paths:
+      agents: .agents/agents/
+      commands: "(not deployed; no qualified native command surface)"
+      skills: .agents/skills/
+      rules: AGENTS.md
+      behaviors: "(not supported)"
+      mcp_project: .agents/mcp_config.json
+      mcp_user: "~/.gemini/config/mcp_config.json"
+    native_features:
+      cron: false
+      agent_teams: false
+      tasks: false
+      mcp: true
+      behaviors: false
+      mission_control: false
+      daemon: false
+    emulation:
+      cron: external-trigger
+      agent_teams: aiwg-mc
+      tasks: aiwg-mc
+      mcp: native
+      behaviors: null
+      mission_control: aiwg-mc
+      daemon: null
+    hook_wiring:
+      at_link_support: false
+      fallback: full-inject
+      context_file: AGENTS.md
+    interaction:
+      structured_questions: none
+      fallback: markdown
+      notes: No stable structured-question tool contract was qualified for CLI 1.1.26.
+    deploy_target: project
+    aggregated_output: false
+
   pi:
     display_name: Pi Coding Agent
     aliases:
@@ -511,6 +556,47 @@ providers:
     deploy_target: project
     aggregated_output: false
 
+  omp:
+    display_name: Oh My Pi
+    aliases:
+      - oh-my-pi
+    status: experimental
+    daemon_tier: unsupported
+    daemon_pty_adapter: false
+    artifact_paths:
+      agents: .omp/agents/
+      commands: .omp/prompts/
+      skills: .agents/skills/
+      skills_cross_agent: .agents/skills/
+      rules: .omp/rules/
+      behaviors: .omp/extensions/
+    native_features:
+      cron: false
+      agent_teams: true
+      tasks: true
+      mcp: true
+      behaviors: true
+      mission_control: false
+      daemon: false
+    emulation:
+      cron: external-trigger
+      agent_teams: null
+      tasks: null
+      mcp: null
+      behaviors: null
+      mission_control: aiwg-mc
+      daemon: null
+    hook_wiring:
+      at_link_support: true
+      fallback: full-inject
+      context_file: .omp/AGENTS.md
+    interaction:
+      structured_questions: none
+      fallback: markdown
+      notes: OMP integration uses Markdown questions; native UI questions require an interactive runtime.
+    deploy_target: project
+    aggregated_output: false
+
 # Feature definitions — documents what each feature key means and
 # what emulation strategies are available when native support is absent.
 features:

package/agentic/code/providers/model-capabilities.v1.json

@@ -3,6 +3,17 @@
   "version": "1.0.0",
   "verifiedAt": "2026-07-20",
   "providers": {
+    "antigravity": {
+      "agent": "native", "skill": "native", "globalChild": "inherited",
+      "identifierSyntax": "model identifier accepted by Antigravity CLI 1.1.26 --model",
+      "effortValues": ["low", "medium", "high"],
+      "inheritance": "Omitted model and effort inherit the invoking Antigravity session",
+      "invalidPinFallback": "Provider validation/error; never assume fallback",
+      "configTarget": "agy launch arguments; custom-agent model tiers are not projected from generic AIWG model ids",
+      "artifactFormat": "YAML frontmatter plus Markdown; runtime --model and --effort flags",
+      "verification": "Pinned offline contract; authenticated model selection was not executed",
+      "sourceUrl": "https://antigravity.google/docs/cli/subagents/", "verifiedAt": "2026-09-04"
+    },
     "claude": {
       "agent": "native", "skill": "native", "globalChild": "inherited",
       "identifierSyntax": "Claude alias or accepted Anthropic model ID",
@@ -76,6 +87,26 @@
       "verification": "Inspect active profile and run metadata",
       "sourceUrl": "https://docs.warp.dev/agent-platform/capabilities/agent-profiles-permissions", "verifiedAt": "2026-07-20"
     },
+    "omp": {
+      "agent": "native",
+      "skill": "inherited",
+      "globalChild": "native",
+      "identifierSyntax": "provider/model identifier accepted by OMP --model",
+      "effortValues": [
+        "minimal",
+        "low",
+        "medium",
+        "high",
+        "xhigh"
+      ],
+      "inheritance": "Omitted model and thinking level inherit the invoking Pi session",
+      "invalidPinFallback": "Pi resolves against its configured catalog and exits on invalid explicit selection",
+      "configTarget": "OMP native agent frontmatter and runtime launch arguments",
+      "artifactFormat": "model and thinkingLevel frontmatter; --model and --thinking runtime flags",
+      "verification": "Pinned OMP 18.1.10 source and live OpenRouter smoke; individual role defaults remain operator configured",
+      "sourceUrl": "https://github.com/can1357/oh-my-pi/tree/5964a0f7649275bcde818f20073193fd032451f2/packages/coding-agent",
+      "verifiedAt": "2026-09-04"
+    },
     "pi": {
       "agent": "native", "skill": "inherited", "globalChild": "native",
       "identifierSyntax": "provider/model identifier accepted by Pi --model",

package/agentic/code/providers/model-catalog.v1.json

@@ -4,6 +4,14 @@
   "refreshedAt": "2026-07-20",
   "staleAfterDays": 90,
   "providers": {
+    "antigravity": {
+      "roles": {
+        "reasoning": { "id": "configured/reasoning", "status": "unverified", "observed": false },
+        "coding": { "id": "configured/coding", "status": "unverified", "observed": false },
+        "efficiency": { "id": "configured/efficiency", "status": "unverified", "observed": false }
+      },
+      "sourceUrl": "https://antigravity.google/docs/cli/overview/", "verifiedAt": "2026-09-04"
+    },
     "claude": {
       "roles": {
         "reasoning": { "id": "claude-opus-4-7", "status": "active", "observed": false },
@@ -52,6 +60,27 @@
       },
       "sourceUrl": "https://opencode.ai/docs/models", "verifiedAt": "2026-07-20"
     },
+    "omp": {
+      "roles": {
+        "reasoning": {
+          "id": "configured/reasoning",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "configured/coding",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "configured/efficiency",
+          "status": "unverified",
+          "observed": false
+        }
+      },
+      "sourceUrl": "https://github.com/can1357/oh-my-pi/tree/5964a0f7649275bcde818f20073193fd032451f2/packages/coding-agent",
+      "verifiedAt": "2026-09-04"
+    },
     "pi": {
       "roles": {
         "reasoning": { "id": "configured/reasoning", "status": "unverified", "observed": false },

package/agentic/code/providers/omp/README.md

@@ -0,0 +1,58 @@
+# OMP native resources
+
+The experimental `omp` provider targets Oh My Pi 18.1.10, reviewed at commit
+`5964a0f7649275bcde818f20073193fd032451f2`. It remains separate from `pi`.
+
+Project agents, Markdown prompts, rules and extensions use `.omp/agents`,
+`.omp/prompts`, `.omp/rules` and `.omp/extensions`. Kernel skills use
+`.agents/skills/<name>/SKILL.md`; `--copy-all` places standard skills in that
+same one-level native directory. Default standard skills remain in the AIWG
+source corpus for `aiwg discover` and `aiwg show`. Duplicate basenames fail
+with a collision diagnostic before overwriting a different resource.
+
+The `.omp/AGENTS.md` managed block uses native relative imports of root
+WORKSPACE.md and AIWG.md. Other Markdown links remain ordinary links.
+OMP's standalone root AGENTS discovery and foreign provider discovery are
+independent: disable/enable those through OMP itself. AIWG does not rewrite
+`disabledProviders`, foreign-user opt-in, extension settings or credentials.
+Nearest native context and root-to-cwd standalone context can coexist. A
+nested `.omp/AGENTS.md` shadows ancestor native context and rules: include
+`@../../WORKSPACE.md` and `@../../AIWG.md` explicitly when the nested native
+configuration is one directory below the repository root, or import the
+ancestor bootstrap. OMP expands imports and deduplicates overlapping prompt blocks. Operator
+content outside the bootstrap markers survives regeneration.
+
+Agent descriptions and system prompt bodies retain their source text.
+Explicit model IDs and priority lists pass through; configured model roles
+use `modelsConfig.omp[role]`. Unmapped roles inherit the session model with a
+degraded diagnostic. Unknown tool names are omitted with diagnostics. OMP
+interprets an empty spawn list as absent, then infers wildcard spawns from
+`task`; the adapter therefore removes `task` unless explicit spawn targets
+or an explicit wildcard are supplied. Tool definitions are capability
+selection, not a security sandbox.
+
+The bridge registers native session start/shutdown, before-agent-start,
+agent-end, tool-call and tool-result handlers. `/aiwg-bridge-status` reports
+registration counts. No default policy handler is installed. Consumers use
+`registerAiwgHandler` to attach an explicitly selected policy; tool-call
+blocks are returned to the native harness and handler failure blocks that
+call. Permission-request and pre-compaction enforcement are unsupported.
+Native hook installation is distinct from this extension. Markdown prompts
+are never executable custom commands.
+
+`registerAiwgTool` accepts OMP's native tool definition together with input
+and output validators. It propagates cancellation and execution errors,
+and rejects invalid input/output. Runtime modules must be reviewed just
+like any other executable OMP extension.
+
+Deployment records SHA-256 ownership and transformation receipts beside
+each resource. Refresh preserves operator creations and modifications,
+even with force. The provider uninstall routine removes only unchanged
+OMP-owned receipt entries and its own bootstrap markers. Disabling native
+extension discovery remains an OMP setting; explicit extension paths may
+still load despite `--no-extensions`.
+
+Remove a complete OMP deployment with `aiwg remove omp --provider omp`.
+Use `--dry-run` to preview or `--scope user` for the resolved OMP profile.
+This is distinct from removing a single AIWG framework. Modified files and
+unowned files remain, including other extensions and provider resources.

package/agentic/code/providers/omp/aiwg-bridge.ts

@@ -0,0 +1,52 @@
+/** Native OMP bridge. Policy handlers are explicitly registered; no prompt-only enforcement. */
+import type { ExtensionAPI, ToolDefinition } from '@oh-my-pi/pi-coding-agent';
+
+export const supportedEvents = ['session_start', 'before_agent_start', 'tool_call', 'tool_result', 'agent_end', 'session_shutdown'] as const;
+export const unsupportedEvents = ['permission_request', 'pre_compact_enforcement', 'native_hook_installation'] as const;
+type Decision = { block: true; reason: string } | undefined;
+type Handler = (event: unknown, context: unknown) => unknown | Promise<unknown>;
+const handlers = new Map<string, Handler[]>();
+export function registerAiwgHandler(event: string, handler: Handler): () => void {
+  if (!(supportedEvents as readonly string[]).includes(event)) throw new Error(`Unsupported OMP bridge event: ${event}`);
+  const list = handlers.get(event) || []; list.push(handler); handlers.set(event, list);
+  return () => { const at = list.indexOf(handler); if (at >= 0) list.splice(at, 1); };
+}
+export async function dispatchAiwgEvent(event: string, payload: unknown, context: unknown): Promise<Decision> {
+  for (const handler of handlers.get(event) || []) {
+    try {
+      const result = await handler(payload, context) as Decision;
+      if (event === 'tool_call' && result?.block) return { block: true, reason: String(result.reason || 'Denied by AIWG handler') };
+    } catch (error) {
+      if (event === 'tool_call') return { block: true, reason: `AIWG handler failed: ${error instanceof Error ? error.message : String(error)}` };
+      throw error;
+    }
+  }
+  return undefined;
+}
+/** ToolSmith callers provide schemas and validators; unsupported output never reaches OMP. */
+export function registerAiwgTool(api: ExtensionAPI, tool: ToolDefinition, validateInput: (input: unknown) => boolean, validateOutput: (output: unknown) => boolean): void {
+  if (!tool.name || !tool.parameters || typeof tool.execute !== 'function') throw new Error('Invalid OMP custom tool contract');
+  api.registerTool({ ...tool, async execute(id, params, signal, update, context) {
+    if (signal?.aborted) throw new Error('AIWG tool cancelled');
+    if (!validateInput(params)) throw new Error('Invalid AIWG tool input');
+    const result = await tool.execute(id, params, signal, update, context);
+    if (signal?.aborted) throw new Error('AIWG tool cancelled');
+    if (!validateOutput(result)) throw new Error('Invalid AIWG tool output');
+    return result;
+  } });
+}
+export default function aiwgBridge(api: ExtensionAPI): void {
+  api.on('session_start', async (event, context) => { await dispatchAiwgEvent('session_start', event, context); });
+  api.on('before_agent_start', async (event, context) => { await dispatchAiwgEvent('before_agent_start', event, context); });
+  api.on('tool_call', (event, context) => dispatchAiwgEvent('tool_call', event, context));
+  api.on('tool_result', async (event, context) => { await dispatchAiwgEvent('tool_result', event, context); });
+  api.on('agent_end', async (event, context) => { await dispatchAiwgEvent('agent_end', event, context); });
+  api.on('session_shutdown', async (event, context) => { await dispatchAiwgEvent('session_shutdown', event, context); handlers.clear(); });
+  api.registerCommand('aiwg-bridge-status', {
+    description: 'Show active AIWG OMP lifecycle bridge registrations',
+    async handler(args, context) {
+      if (args.trim()) throw new Error('aiwg-bridge-status accepts no arguments');
+      context.ui.notify(`AIWG OMP bridge: ${supportedEvents.join(', ')}. Registered handlers: ${[...handlers.values()].reduce((n, list) => n + list.length, 0)}.`, 'info');
+    },
+  });
+}

package/dist/src/agents/agent-deployer.js

@@ -14,6 +14,7 @@
 import * as fs from 'fs/promises';
 import * as path from 'path';
 import { existsSync } from 'fs';
+import YAML from 'yaml';
 import { AgentValidator } from './agent-validator.js';
 import { AgentPackager } from './agent-packager.js';
 import { getProviderDefinition } from '../providers/provider-definitions.js';
@@ -244,6 +245,23 @@ export class AgentDeployer {
                 }
             }
         }
+        // Preserve provider-native fields consumed by the OMP packager. The
+        // historical line parser cannot represent arrays, booleans or objects.
+        const native = YAML.parse(frontmatter) || {};
+        for (const key of ['thinkingLevel', 'spawns', 'blocking', 'output', 'autoloadSkills', 'readSummarize', 'prewalk', 'advisor']) {
+            if (native[key] !== undefined)
+                Object.assign(metadata, { [key]: native[key] });
+        }
+        if (Array.isArray(native.model)) {
+            metadata.modelPriority = native.model;
+            delete metadata.model;
+        }
+        if (Array.isArray(native.tools))
+            metadata.tools = native.tools;
+        if (typeof native.name === 'string')
+            metadata.name = native.name;
+        if (typeof native.description === 'string')
+            metadata.description = native.description;
         return metadata;
     }
     /**

package/dist/src/agents/agent-packager.js

@@ -4,10 +4,14 @@
  * Converts agents to platform-specific formats.
  */
 import { getProviderDefinition } from '../providers/provider-definitions.js';
+import YAML from 'yaml';
+import { transformAgent as transformOmpAgent } from '../providers/omp-agent.mjs';
 export class AgentPackager {
     getAgentFormatAdapters() {
         return {
             'claude-markdown': (agent) => this.convertToClaudeFormat(agent),
+            'antigravity-markdown': (agent) => this.convertToAntigravityFormat(agent),
+            'omp-markdown': (agent) => this.convertToOmpFormat(agent),
             'cursor-json': (agent) => this.convertToCursorFormat(agent),
             'codex-markdown': (agent) => this.convertToCodexFormat(agent),
             'copilot-markdown': (agent) => this.convertToGenericFormat(agent),
@@ -16,6 +20,22 @@ export class AgentPackager {
             'windsurf-markdown': (agent) => this.convertToWindsurfFormat(agent),
         };
     }
+    /** Antigravity custom agents use Markdown with provider-native tool identifiers. */
+    convertToAntigravityFormat(agent) {
+        const lines = ['---', `name: ${agent.metadata.name}`, `description: ${agent.metadata.description}`];
+        const toolMap = new Map([
+            ['Read', 'view_file'],
+            ['Write', 'write_to_file'],
+            ['Edit', 'replace_file_content'],
+            ['Grep', 'grep_search'],
+            ['Bash', 'run_command'],
+        ]);
+        const tools = (agent.metadata.tools ?? []).map(tool => toolMap.get(tool)).filter((tool) => Boolean(tool));
+        if (tools.length)
+            lines.push('tools:', ...tools.map(tool => `  - ${tool}`));
+        lines.push('---', '', agent.content);
+        return lines.join('\n');
+    }
     /**
      * Package agent for target platform
      */
@@ -35,6 +55,11 @@ export class AgentPackager {
             format: definition.id,
         };
     }
+    /** Preserve native OMP metadata without passing through another provider's serializer. */
+    convertToOmpFormat(agent) {
+        const metadata = { ...agent.metadata, model: agent.metadata.modelPriority ?? agent.metadata.model };
+        return transformOmpAgent(agent.filePath, `---\n${YAML.stringify(metadata)}---\n${agent.content}`);
+    }
     /**
      * Convert to Claude Code format (.md with YAML frontmatter)
      */

package/dist/src/artifacts/backends/sqlite-backend.js

@@ -50,28 +50,36 @@ export class SqliteGraphBackend {
         catch {
             throw new Error('sqlite backend is unavailable; run `aiwg features install sqlite`');
         }
-        this.assertSafeSqliteVersion();
-        const requestedJournal = dbPath === ':memory:' ? 'memory' : 'wal';
-        const actualJournal = String(this.db.pragma(`journal_mode = ${requestedJournal}`, { simple: true })).toLowerCase();
-        if (actualJournal !== requestedJournal) {
+        try {
+            // Changing journal mode may return SQLITE_BUSY without invoking SQLite's
+            // busy handler during a lock upgrade. Retry initialization as a whole:
+            // pragmas are idempotent and failed schema transactions roll back.
+            this.withBusyContext('initializing the graph database', () => {
+                this.assertSafeSqliteVersion();
+                const requestedJournal = dbPath === ':memory:' ? 'memory' : 'wal';
+                const actualJournal = String(this.db.pragma(`journal_mode = ${requestedJournal}`, { simple: true })).toLowerCase();
+                if (actualJournal !== requestedJournal) {
+                    throw new Error(`sqlite backend requested journal_mode=${requestedJournal} but received ${actualJournal}`);
+                }
+                this.db.pragma(`synchronous = ${options.synchronous ?? 'NORMAL'}`);
+                this.db.pragma('wal_autocheckpoint = 1000');
+                this.migrateSchema();
+            });
+        }
+        catch (error) {
             this.db.close();
-            throw new Error(`sqlite backend requested journal_mode=${requestedJournal} but received ${actualJournal}`);
+            throw error;
         }
-        this.db.pragma(`synchronous = ${options.synchronous ?? 'NORMAL'}`);
-        this.db.pragma('wal_autocheckpoint = 1000');
-        this.migrateSchema();
     }
     assertSafeSqliteVersion() {
         const version = String(this.db.prepare('SELECT sqlite_version() AS version').get().version);
         if (!isWalResetSafeVersion(version)) {
-            this.db.close();
             throw new Error(`sqlite backend requires a WAL-reset-safe SQLite build (3.44.6, 3.50.7, or >=3.51.3); found ${version}`);
         }
     }
     migrateSchema() {
         const current = Number(this.db.pragma('user_version', { simple: true }));
         if (current > SCHEMA_VERSION) {
-            this.db.close();
             throw new Error(`sqlite graph schema ${current} is newer than supported schema ${SCHEMA_VERSION}`);
         }
         if (current === SCHEMA_VERSION)

package/dist/src/artifacts/query-engine.js

@@ -101,6 +101,22 @@ function containsTokenSequence(haystack, needle) {
 function withIndexProvenance(entry, graph) {
     return { ...entry, indexGraph: graph, indexScope: graphScope(graph) };
 }
+/** Keep existing project capabilities visible while their derived cache is unavailable. */
+function projectCapabilityFallback(cwd) {
+    const index = loadGraphIndexFile(cwd, 'metadata.json', 'project');
+    if (index) {
+        const entries = Object.values(index.entries).map((entry) => withIndexProvenance(entry, 'project'));
+        if (entries.length > 0) {
+            // One diagnostic per command, on stderr so JSON and skill bodies stay parseable.
+            console.error('Warning: project capability cache is unavailable or stale; using the local project index. Run `aiwg index sync` to repair the cache.');
+            return entries;
+        }
+    }
+    if (['extensions', 'addons', 'frameworks', 'plugins', 'skills'].some((dir) => fs.existsSync(projectAiwgPath(cwd, dir)))) {
+        console.error('Warning: project capabilities could not be loaded: the cache is unavailable and the local project index is missing or empty. Run `aiwg index build --graph project` to repair discovery.');
+    }
+    return index ? [] : null;
+}
 function discoveryIdForEntry(entry) {
     return stableRecordId(recordTypeForEntry(entry, 'v2'), entry.path);
 }
@@ -919,6 +935,13 @@ export async function discoverCapability(cwd, params) {
         let unavailableReason;
         for (const graph of graphs) {
             const loaded = loadFortemiCoreMetadataEntries(cwd, graph, verifiedSourcePaths);
+            if (loaded.reason && graph === 'project' && !params.graph) {
+                const fallback = projectCapabilityFallback(cwd);
+                if (fallback) {
+                    entries.push(...fallback);
+                    continue;
+                }
+            }
             if (loaded.reason)
                 unavailableReason ??= loaded.reason;
             entries.push(...loaded.entries.map((entry) => withIndexProvenance(entry, graph)));
@@ -1373,6 +1396,13 @@ async function loadShowEntries(cwd, params) {
         let unavailableReason;
         for (const graph of graphs) {
             const loaded = loadFortemiCoreMetadataEntries(cwd, graph);
+            if (loaded.reason && graph === 'project' && !params.graph) {
+                const fallback = projectCapabilityFallback(cwd);
+                if (fallback) {
+                    entries.push(...fallback);
+                    continue;
+                }
+            }
             if (loaded.reason)
                 unavailableReason ??= loaded.reason;
             entries.push(...loaded.entries.map((entry) => withIndexProvenance(entry, graph)));