CLAUDE.me generated

AGENTS.md

@@ -0,0 +1,19 @@
+# AGENTS.md
+
+This is a StartOS service-package repository — it builds a `.s9pk` for StartOS.
+
+Develop it inside a StartOS packaging workspace created by `start-cli s9pk init-workspace`,
+which provides the packaging guide and agent context one level up. If you're reading this in a
+bare clone with no workspace, the full guide is at <https://docs.start9.com/packaging>.
+
+**Start every task at the recipe index** — `../start-technologies/projects/start-sdk/docs/src/recipes.md`
+(or <https://docs.start9.com/packaging/recipes.html>). It maps an intent ("prompt the user to create
+admin credentials", "expose a web UI") to the constructs, the reference pages, and a named production
+package to copy. Find the recipe before you read this package's neighbours: a package you reach by
+grepping may be non-conformant, and the recipe outranks it.
+
+Work this package's `TODO.md` from top to bottom. Keep `README.md` (architecture, for developers and LLMs) and `instructions.md` (end-user docs) in sync with your changes.
+
+## Inspecting a running install
+
+To run a command inside a service's container (read its generated config, grep app logs), use `start-cli package attach <id> -n <subcontainer-name> -- <cmd>`. Select the subcontainer by **name** with `-n` (the name passed to `SubContainer.of` in `main.ts`, e.g. `-n web`) or by image with `-i`. Note: `-s/--subcontainer` matches the internal **Guid**, not the name, so passing a name to `-s` fails with "no matching subcontainers". A service with more than one subcontainer requires a selector; with none given, `attach` falls back to an interactive picker that panics in a non-TTY shell — that's the missing selector, not a TTY requirement.

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

TODO.md

@@ -0,0 +1,23 @@
+# TODO — bring Spaces from beta.9 to 
+
+Consult the packaging guide as you go
+(`start-technologies/projects/start-sdk/docs/src/recipes.md` is the intent index). Remove items as you finish
+them, and add items when you defer work.
+
+## The service
+
+- [ ] Update @start9labs/start-sdk to the latest version.
+
+## Docs
+
+- [ ] Write `README.md` (per `start-technologies/projects/start-sdk/docs/src/writing-readmes.md`).
+- [ ] Write `instructions.md` (per `start-technologies/projects/start-sdk/docs/src/writing-instructions.md`).
+- [ ] Fill in `UPDATING.md` (upstream-version tracking).
+
+## Build, test, ship
+
+- [ ] First test build: `make` (or `start-cli s9pk pack`); fix any `tsc` / pack errors.
+- [ ] Install on a StartOS box and verify the service runs (and is reachable, once it
+      exposes an interface).
+- [ ] Backup / restore sanity check.
+- [ ] Review the README and instructions one more time against actual behavior.