@straiffi/archon 1.0.0 → 1.0.6

package/README.md

@@ -1,6 +1,6 @@
 # Archon
 
-A ticket-driven interface for AI-assisted code automation. Create tickets, plan features, then let an AI agent (Claude or OpenCode) implement them in isolated git worktrees.
+Archon is a ticket-driven interface for AI-assisted code automation. Create tickets, plan features, then let an AI agent such as Claude or OpenCode implement them in isolated git worktrees.
 
 ## Install
 
@@ -42,7 +42,7 @@ archon update
 
 V1 targets macOS and Linux first.
 
-## External tool prerequisites
+## External Tool Prerequisites
 
 Archon does not bundle external developer tools.
 
@@ -57,44 +57,16 @@ Required or commonly expected tools:
 
 If one of the optional AI tools is missing, Archon should still start, but features that depend on that binary will return actionable errors.
 
-## How it works
+## How It Works
 
 Tickets move through three states:
 
-1. **Plan** — write a title and description for the feature or task
-2. **Build** — the server spawns your configured AI tool in a new git worktree on a dedicated branch; real-time logs stream back to the UI
-3. **Review** — an agent conducts a code review and fixes any issues found
+1. **Plan**: write a title and description for the feature or task
+2. **Build**: the server spawns your configured AI tool in a new git worktree on a dedicated branch; real-time logs stream back to the UI
+3. **Review**: an agent conducts a code review and fixes any issues found
 
 The frontend is a React kanban board. The backend is an Express server with a SQLite database and Socket.io for live status updates.
 
-## Development
-
-For normal source development, use the repo checkout workflow instead of the packaged CLI.
-
-Install dependencies from the repository root:
-
-```bash
-npm install
-```
-
-Start dev mode:
-
-```bash
-npm run start:dev
-```
-
-`npm run start:dev` is the primary local development command. It keeps the Express server and Vite frontend as separate processes and configures the dev database plus API base URL overrides for you.
-
-Other useful commands:
-
-```bash
-npm run build
-npm test
-npm run smoke:package
-```
-
-`npm run smoke:package` builds the package, installs the packed tarball into a temporary npm prefix, runs `archon --version`, starts `archon --no-open`, fetches the app shell and an API route, then shuts it down.
-
 ## Project Setup
 
 After Archon starts, create a project from the UI:
@@ -105,7 +77,7 @@ After Archon starts, create a project from the UI:
 4. Optionally open `Advanced settings` to review or edit setup, service, worktree sync, and IDE settings
 5. Save the project, select it in the project switcher, and create tickets inside that project
 
-## Project configuration
+## Project Configuration
 
 Archon stores repository and run settings per project in its database. Use the project form in the UI to configure each project.
 
@@ -158,7 +130,7 @@ IDE command: code --reuse-window
 
 Each ticket gets its own worktree and branch derived from the ticket title, using the active project's repository settings. Archon reuses an existing local branch when one already exists; otherwise it creates a new branch for the worktree.
 
-## Data And Migration
+## Data Storage
 
 Archon keeps runtime state out of the installed package tree.
 
@@ -171,54 +143,7 @@ Default database locations:
 
 You can override the database location with `DB_PATH`.
 
-### Migrating from an existing dev database
-
-Older local development runs may already have data in one of these files:
+## Development And Maintenance
 
-- `server/archon-dev.db`
-- `server/archon.db`
-
-Recommended manual migration flow:
-
-1. Stop all Archon dev and production processes.
-2. Back up the source database and any current production database.
-3. Create the production app-data directory if it does not exist.
-4. Copy the chosen development database to the production database path.
-5. If SQLite sidecar files such as `-wal` or `-shm` exist, only copy them while Archon is fully stopped.
-6. Start Archon normally and let its startup schema checks apply any missing migrations.
-
-If you want to run production Archon against an existing database temporarily, launch it with:
-
-```bash
-DB_PATH=/path/to/archon-dev.db archon
-```
-
-## Release Process
-
-Archon uses a manual GitHub Actions release workflow.
-
-### GitHub setup
-
-1. Publish the npm package scope or package name from the npm account or organization that owns `@straiffi/archon`.
-2. Add an `NPM_TOKEN` repository secret in GitHub with publish access to that package.
-3. Run the `Release` workflow from the `main` branch.
-4. Choose one of `patch`, `minor`, or `major` for `release_type`.
-
-The workflow will:
-
-1. install dependencies
-2. run type checks, lint, tests, build, tarball validation, and packaged-install smoke checks
-3. run `npm version <release_type>`
-4. publish with `npm publish --access public`
-5. push the version commit and git tag back to GitHub
-
-### Local release dry run
-
-Before running the workflow, you can validate the release path locally with:
-
-```bash
-npm install
-npm run build
-npm run smoke:package
-npm pack --dry-run
-```
+- Contributor workflow: [`DEVELOPMENT.md`](https://github.com/Straiffi/Archon/blob/main/DEVELOPMENT.md)
+- Release workflow: [`RELEASING.md`](https://github.com/Straiffi/Archon/blob/main/RELEASING.md)

package/dist/server/index.js

@@ -31,7 +31,8 @@ import { exportProjectMemoryArchive, importProjectMemoryArchive } from './lib/pr
 import { buildReviewFindingsResponse, computeDiffSignature, getLatestReviewRunForContext } from './lib/reviewFindings.js';
 import { getDiscoveredSkills, normalizeSkillNames } from './lib/skills.js';
 import { clearAllPreviewProxies } from './lib/previewProxy.js';
-import { resolveClientBuildPaths, shouldServeClientApp } from './lib/staticClient.js';
+import { shutdownRealtimeServer } from './lib/shutdown.js';
+import { resolveClientBuildPaths, shouldServeClientApp, STATIC_CLIENT_DIRECTORY_OPTIONS, STATIC_CLIENT_INDEX_OPTIONS, } from './lib/staticClient.js';
 import { deleteIntegrationConnection, getGitHubConnectionConfig, getJiraConnectionConfig, listIntegrationConnections, upsertIntegrationConnection, } from './lib/integrations/index.js';
 import { createGitHubPullRequest, findOpenGitHubPullRequest, findOpenGitHubPullRequestByHeadBranch, getGitHubPullRequestComments, getGitHubPullRequestReviews, getGitHubPullRequest, GitHubApiError, hasGitHubRemoteBranch, resolveGitHubRepository, validateGitHubConnection, } from './lib/integrations/github.js';
 import { importJiraIssue, JiraApiError, validateJiraConnection } from './lib/integrations/jira.js';
@@ -5017,7 +5018,7 @@ app.delete('/tickets/:id', async (req, res) => {
 });
 const clientBuild = resolveClientBuildPaths(import.meta.url);
 if (clientBuild) {
-    app.use(express.static(clientBuild.directoryPath, { index: false }));
+    app.use(express.static(clientBuild.directoryPath, STATIC_CLIENT_DIRECTORY_OPTIONS));
     app.get(/.*/, (req, res, next) => {
         if (!shouldServeClientApp({
             method: req.method,
@@ -5027,7 +5028,7 @@ if (clientBuild) {
             next();
             return;
         }
-        res.sendFile(clientBuild.indexPath, error => {
+        res.sendFile(clientBuild.indexPath, STATIC_CLIENT_INDEX_OPTIONS, error => {
             if (error) {
                 next(error);
             }
@@ -5084,22 +5085,15 @@ export const startServer = ({ port = DEFAULT_PORT, host } = {}) => {
     });
 };
 export const shutdownServer = async (signal) => {
-    if (signal) {
-        console.log(`\nReceived ${signal}, shutting down...`);
-    }
-    closeAllTerminalSessions();
-    await Promise.all([clearAllPreviewProxies(), stopAllBuildAgents(), stopAllTickets()]);
-    if (httpServer.listening) {
-        await new Promise((resolve, reject) => {
-            httpServer.close(error => {
-                if (error) {
-                    reject(error);
-                    return;
-                }
-                resolve();
-            });
-        });
-    }
+    await shutdownRealtimeServer({
+        signal,
+        io,
+        httpServer,
+        closeAllTerminalSessions,
+        clearAllPreviewProxies,
+        stopAllBuildAgents,
+        stopAllTickets,
+    });
 };
 export const registerShutdownHandlers = () => {
     const createHandler = (signal) => {