ci and initial

.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [main, v2]
+  pull_request:
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: "1.24"
+
+      - run: go build ./...
+
+      - run: go test ./...
+
+      - uses: golangci/golangci-lint-action@v8

.gitignore

@@ -1,4 +1,13 @@
-*.db
-/data
-/uploads
+/bin/
+/dist/
+/potok
+/potokd
+coverage.out
+*.test
 .env
+.env.local
+/data/
+*.db
+.vscode/
+.idea/
+.DS_Store

cmd/potok/main.go

@@ -0,0 +1,8 @@
+// Command potok is the Potok command line client.
+package main
+
+import "fmt"
+
+func main() {
+	fmt.Println("potok: not implemented yet")
+}

cmd/potokd/main.go

@@ -0,0 +1,8 @@
+// Command potokd is the Potok server daemon.
+package main
+
+import "fmt"
+
+func main() {
+	fmt.Println("potokd: not implemented yet")
+}

internal/client/cli/doc.go

@@ -0,0 +1,2 @@
+// Package cli implements the potok command tree.
+package cli

internal/client/config/doc.go

@@ -0,0 +1,2 @@
+// Package config reads and writes the client configuration file.
+package config

internal/client/crypto/doc.go

@@ -0,0 +1,2 @@
+// Package crypto implements key derivation and vault encryption.
+package crypto

internal/client/secrets/doc.go

@@ -0,0 +1,2 @@
+// Package secrets stores passphrases and API keys in the OS keyring.
+package secrets

internal/client/syncer/doc.go

@@ -0,0 +1,2 @@
+// Package syncer diffs local and remote state and applies the result.
+package syncer

internal/client/transport/doc.go

@@ -0,0 +1,2 @@
+// Package transport is the HTTP client for the Potok API.
+package transport

internal/client/vault/doc.go

@@ -0,0 +1,2 @@
+// Package vault scans vault directories and maintains the local index.
+package vault

internal/protocol/doc.go

@@ -0,0 +1,2 @@
+// Package protocol defines the wire types shared by the client and server.
+package protocol

internal/server/auth/doc.go

@@ -0,0 +1,2 @@
+// Package auth issues and verifies API keys.
+package auth

internal/server/blobstore/doc.go

@@ -0,0 +1,2 @@
+// Package blobstore stores opaque encrypted blobs.
+package blobstore

internal/server/dashboard/doc.go

@@ -0,0 +1,2 @@
+// Package dashboard serves the admin web interface.
+package dashboard

internal/server/doc.go

@@ -0,0 +1,2 @@
+// Package server wires the API server and its dependencies together.
+package server

internal/server/http/doc.go

@@ -0,0 +1,2 @@
+// Package httpapi serves the Potok HTTP API.
+package httpapi

internal/server/store/doc.go

@@ -0,0 +1,2 @@
+// Package store persists vault metadata.
+package store

internal/version/doc.go

@@ -0,0 +1,2 @@
+// Package version exposes build metadata stamped in at link time.
+package version