Update README.md

Reviewed-on: http://localhost:3000/filepilot/filepilot-pipeline/pulls/8
Reviewed-by: glovely <glovely@stevens.edu>

README.md

@@ -1,3 +1,22 @@
-# filepilot-pipeline
+## Product Scope
 
-One-click DevSecOps deployment for controlled LLM-assisted file updates
+FilePilot demonstrates a controlled file-update workflow. It accepts a target
+file description, expected text, and replacement text. The application locates
+the file only within an approved demonstration directory, verifies the expected
+text, creates a backup, presents a diff, performs the replacement, verifies the
+result, and records the outcome.
+
+FilePilot does not provide unrestricted filesystem access, general desktop
+control, arbitrary shell execution, or open-ended autonomous planning.
+
+## Demonstration Acceptance Criteria
+
+The demonstration succeeds when FilePilot:
+
+1. finds the approved project-status file;
+2. confirms that it contains `Status: Draft`;
+3. creates a backup;
+4. shows the proposed change;
+5. replaces the line with `Status: Reviewed`;
+6. verifies the saved result; and
+7. records the outcome without exposing secrets.

ops/gitea/README.md

@@ -0,0 +1,27 @@
+# Gitea Operations
+
+This directory contains the versioned, non-secret Gitea deployment.
+
+## Current staging design
+
+- Gitea image: `docker.gitea.com/gitea:1.27.3-rootless`
+- Database: SQLite
+- Application data volume: `filepilot-gitea_gitea-data`
+- Configuration volume: `filepilot-gitea_gitea-config`
+- Temporary access: `127.0.0.1:3000`
+- Public backend port: none
+- Git-over-SSH: disabled
+
+The loopback mapping is temporary until the assignment domain, HTTPS proxy,
+and final hostname are configured.
+
+## Operations
+
+Start or update the service:
+
+```bash
+docker compose up -d
+docker compose ps
+docker compose logs --tail=100 gitea
+docker compose down
+```

ops/gitea/compose.yaml

@@ -0,0 +1,25 @@
+name: filepilot-gitea
+
+services:
+  gitea:
+    image: docker.gitea.com/gitea:1.27.3-rootless
+    container_name: filepilot-gitea
+    restart: unless-stopped
+    environment:
+      GITEA__database__DB_TYPE: sqlite3
+      GITEA__database__PATH: /var/lib/gitea/data/gitea.db
+      GITEA__server__DOMAIN: localhost
+      GITEA__server__ROOT_URL: http://localhost:3000/
+      GITEA__server__HTTP_PORT: 3000
+      GITEA__server__DISABLE_SSH: "true"
+      GITEA__service__DISABLE_REGISTRATION: "true"
+    ports:
+      - "127.0.0.1:3000:3000"
+    volumes:
+      - gitea-data:/var/lib/gitea
+      - gitea-config:/etc/gitea
+
+volumes:
+  gitea-data:
+  gitea-config:
+