docs: comprehensive documentation update — align all docs with current codebase state

- Fix license inconsistency: LICENSE.md now MIT (matches package.json)
- Fix Node version drift: standardize on >=18 (v22 recommended) across all docs
- Remove all 'stub agent' references from QUICKSTART, TESTING, ARCHITECTURE
- Rewrite CONFIGURATION.md: replace obsolete axios/worker stub with actual AI service, preferences, and slash command configuration
- Rewrite ELECTRON_README.md: replace outdated prototype doc with accurate overlay/chat/capture/coordinate architecture
- Update ARCHITECTURE.md: fix fine grid spacing (25px not 50px), replace stub extensibility with actual provider/CLI/agent extension points
- Update CONTRIBUTING.md: add characterization test workflow, expanded project structure with ai-service/, native/, hooks/
- Update PUBLISHING.md + RELEASE_PROCESS.md: version examples match 0.0.x cadence, add characterization test requirement
- Update TESTING.md: replace Spectron/unit test stubs with current characterization test guidance
- Update PROJECT_STATUS.md: reflect 0.0.14 and unreleased capability separation work
- Add archival headers to FINAL_SUMMARY.txt, TEST_REPORT.md, GPT-reports.md, baseline-app.md
- Add context headers to docs/inspect-overlay-plan.md, docs/INTEGRATED_TERMINAL_ARCHITECTURE.md
- Add upstream separator in changelog.md between Liku Edition and upstream Copilot CLI entries
- Fix README.md package size badge (196KB not 245KB), remove dead external doc link
- Mark gameingwithai.md and refactored-ai-service.md with proper document-type headers

Author: TayDa64

ARCHITECTURE.md

@@ -10,7 +10,7 @@ This application implements an Electron-based headless agent system with an ultr
 2. **Non-Intrusive**: Transparent overlay, edge-docked chat, never blocks user workspace
 3. **Performance-First**: Click-through by default, minimal background processing
 4. **Secure**: Context isolation, no Node integration in renderers, CSP headers
-5. **Extensible**: Clean IPC message schema ready for agent integration
+5. **Extensible**: Clean IPC message schema with multi-provider AI service and agent orchestration
 
 ## Multi-Agent Orchestration
 
@@ -164,8 +164,8 @@ This allows internal seams to move without changing the external contract seen b
 ```
 
 **Key Functions:**
-- `generateCoarseGrid()`: Creates 100px spacing grid
-- `generateFineGrid()`: Creates 50px spacing grid
+- `generateCoarseGrid()`: Creates ~100px spacing grid
+- `generateFineGrid()`: Creates ~25px spacing grid
 - `renderDots()`: Renders interactive dots
 - `selectDot()`: Handles dot click events
 - `updateModeDisplay()`: Updates UI based on mode
@@ -367,49 +367,14 @@ All resources loaded locally, no CDN or external dependencies.
 
 ## Extensibility Points
 
-### Agent Integration
-Replace stub in `src/main/index.js`:
-```javascript
-ipcMain.on('chat-message', async (event, message) => {
-  // Call external agent API or worker process
-  const response = await agent.process(message);
-  chatWindow.webContents.send('agent-response', response);
-});
-```
-
-### Custom Grid Patterns
-Add to overlay renderer:
-```javascript
-function generateCustomGrid(pattern) {
-  // Implement custom dot placement logic
-}
-```
+### AI Service Providers
+New providers can be added by implementing the provider interface in `src/main/ai-service/providers/` and registering in the provider registry. The orchestration layer handles fallback chains and dispatch.
 
-### Additional Windows
-Follow pattern:
-```javascript
-function createSettingsWindow() {
-  settingsWindow = new BrowserWindow({
-    webPreferences: {
-      contextIsolation: true,
-      nodeIntegration: false,
-      preload: path.join(__dirname, 'preload.js')
-    }
-  });
-}
-```
+### CLI Commands
+New CLI commands are added as modules in `src/cli/commands/` and registered in the `COMMANDS` table in `src/cli/liku.js`.
 
-### Plugin System (Future)
-```javascript
-// Example plugin interface
-const plugin = {
-  name: 'screen-capture',
-  init: (mainProcess) => {
-    // Register IPC handlers
-    ipcMain.on('capture-screen', plugin.captureScreen);
-  }
-};
-```
+### Agent Roles
+New orchestration roles can be added as agent definition files in `.github/agents/` with corresponding hook policies in `.github/hooks/`.
 
 ## Platform Differences
 
@@ -451,6 +416,12 @@ const plugin = {
 3. Enable IPC logging in DevTools
 4. Verify correct channel names
 
+### AI Service Issues
+1. Check provider authentication (`/login` or environment variables)
+2. Verify model availability with `/status`
+3. Check capability routing with `/model`
+4. Review conversation state with `/status`
+
 ## Best Practices
 
 ### DO