Orginize
This commit is contained in:
@@ -73,4 +73,4 @@ run_command "appstore setup"
|
||||
|
||||
- `docs/guides/guest-pear-and-appstore-workflow.md`
|
||||
- `docs/design/p2p-app-store.md`
|
||||
- `packages/bare-os-coreutils/lib/appstore-pear.js`
|
||||
- `packages/bare-os-coreutils/lib/pear/appstore-pear.js`
|
||||
|
||||
+1
-1
@@ -10,7 +10,7 @@ requires: [read_file, read_proc_file, run_js_script]
|
||||
|
||||
## When to use
|
||||
|
||||
Use this skill when you (or the user) need to **author or debug** Bare OS **JavaScript** that runs **inside the guest** (kernel init, `/bin/*` utilities, `kernel.ext.d`, user `.mjs` run via **`run_js_script`**, or Pear/booter-hosted scripts). It complements repo docs: treat **`developer-guide/02-the-context-object.md`** and **`packages/bare-os-booter/lib/bare-os-ctx.d.ts`** as the canonical deep dives; this file is the **fast mental model**.
|
||||
Use this skill when you (or the user) need to **author or debug** Bare OS **JavaScript** that runs **inside the guest** (kernel init, `/bin/*` utilities, `kernel.ext.d`, user `.mjs` run via **`run_js_script`**, or Pear/booter-hosted scripts). It complements repo docs: treat **`developer-guide/02-the-context-object.md`** and **`packages/bare-os-booter/lib/ctx/bare-os-ctx.d.ts`** as the canonical deep dives; this file is the **fast mental model**.
|
||||
|
||||
## Core model
|
||||
|
||||
|
||||
@@ -9,8 +9,8 @@ requires: [read_proc_file, verification_hints]
|
||||
|
||||
## Touch list
|
||||
|
||||
- packages/bare-os-booter/lib/bare-os-ctx-api.js
|
||||
- packages/bare-os-booter/lib/bare-os-ctx.d.ts
|
||||
- packages/bare-os-booter/lib/ctx/bare-os-ctx-api.js
|
||||
- packages/bare-os-booter/lib/ctx/bare-os-ctx.d.ts
|
||||
- docs/reference/compatibility-matrix.md
|
||||
- packages/bare-os-booter/CHANGELOG.md
|
||||
|
||||
|
||||
@@ -15,7 +15,7 @@ Use when the user asks about **HDMS** (Hyperdrive Management): **`hdms`** CLI, *
|
||||
## Prerequisites
|
||||
|
||||
- **HDMS activates after identity unlock.** Guest sessions can **list** mounts that are already open; **mutating** commands (**`create`**, **`add`**, registry edits, **`invite`**, **`pair`**, etc.) go through **`assertLoggedIn`**: require `**ctx.identity.state === 'unlocked'`** and an active HDMS controller.
|
||||
- Implementation: **`packages/bare-os-booter/lib/hdms-manager.js`** (**`runHdmsCli`**, **`HdmsController`**), exposed as **`ctx.runHdms(argv)`** in **`packages/bare-os-booter/index.js`**.
|
||||
- Implementation: **`packages/bare-os-booter/lib/p2p/hdms-manager.js`** (**`runHdmsCli`**, **`HdmsController`**), exposed as **`ctx.runHdms(argv)`** in **`packages/bare-os-booter/index.js`**.
|
||||
|
||||
## Registry and VFS
|
||||
|
||||
@@ -43,7 +43,7 @@ High-level behavior (details and caveats in **`handbook/05-identity-vault-and-hd
|
||||
## Execution steps (for the agent)
|
||||
|
||||
1. If the user is **guest**, explain that **mutations** require **`login`** / **`login --new`** first; **`hdms list`** may still work for existing mounts.
|
||||
2. For **subcommands and flags**, prefer **`read_man_page hdms`** when available; otherwise cite **`handbook/05-identity-vault-and-hdms.md`** and **`packages/bare-os-booter/lib/hdms-manager.js`**.
|
||||
2. For **subcommands and flags**, prefer **`read_man_page hdms`** when available; otherwise cite **`handbook/05-identity-vault-and-hdms.md`** and **`packages/bare-os-booter/lib/p2p/hdms-manager.js`**.
|
||||
3. For **pairing failures**, check timeout env vars, bootstrap connectivity, and whether **`--read-only`** was used inappropriately on invites.
|
||||
|
||||
## Constraints
|
||||
|
||||
@@ -14,7 +14,7 @@ Use when the user asks about **Holesail** in this repo: exposing TCP/UDP through
|
||||
|
||||
## Mental model
|
||||
|
||||
1. **Integration** lives in **`packages/bare-os-booter/lib/bare-holesail.js`** (initd + optional early “kernel-path” instance), **`bare-holesail-managed.js`** ( **`state.json`** rows, **`ensure`**, **`SyncPersistedServerKey`** ), **`holesail-cli.js`** (**`ctx.bareOsRunHolesailCli`** for **`/bin/holesail`**), **`bare-os-www-holesail.js`**, **`bare-os-ssh-holesail.js`**.
|
||||
1. **Integration** lives in **`packages/bare-os-booter/lib/p2p/bare-holesail.js`** (initd + optional early “kernel-path” instance), **`bare-holesail-managed.js`** ( **`state.json`** rows, **`ensure`**, **`SyncPersistedServerKey`** ), **`holesail-cli.js`** (**`ctx.bareOsRunHolesailCli`** for **`/bin/holesail`**), **`bare-os-www-holesail.js`**, **`bare-os-ssh-holesail.js`**.
|
||||
2. **Resolution order** under **`pear run`**: the booter prefers **`ctx.bare.holesail`** ( **`/lib/bare/bundles/holesail.js`** after drive merge), else host **`import.meta.resolve('holesail')`**, else eval of the drive IIFE bundle via **`ctx.vfs`** — **`/bin`** and **`/boot/init.js`** are **not** Node modules, so scripts must not **`require('holesail')`**.
|
||||
3. **Stock default**: initd unit **`bare-holesail`** is **on** when **`BARE_OS_HOLESAIL_INITD`** and **`BARE_OS_HOLESAIL_MANAGED`** are left at defaults (**`1`** in stock **`shellEnv`** unless the host clears them). Disable with **`BARE_OS_HOLESAIL_INITD=0`** or **`systemctl disable bare-holesail`** (`**~/.config/bare-os/initd/disabled.txt`**).
|
||||
4. **Stock auto-rows** — **`bare-www-<port>`** after **`bare-os-www`** listens (**`BARE_OS_WWW_HOLESAIL=0`** disables merge). **`bare-ssh-<port>`** after **`bare-openssh`** listens (**`BARE_OS_SSH_HOLESAIL=0`** disables). **`bare-user-session-stack`** re-ensures SSH tunnel after **`bare-holesail`** starts if sshd was already listening.
|
||||
|
||||
+1
-1
@@ -34,7 +34,7 @@ Use for any work that touches the **governed kernel expansion** (Batch C items,
|
||||
- The specific word-N verifier if adding bits
|
||||
- Full `npm test` (or at minimum the kernel-program + doc subset) before any PR
|
||||
- For a new **proc builder** or **ctx.bareOs*** method: copy the exact pattern from a word-11 file (e.g. `bare-os-proc-hypercore-pack-hrpc-lifecycle.js` + emitter in index.js + entry in bare-os-ctx-api.js + .d.ts). Update the programVersion / schema note in kernel-program.md.
|
||||
- For **agent skills** supporting kernel program work: keep this skill + bareos-code-change in the requires list and update `BARE_AGENT_SKILL_SEED_REL` in `packages/bare-os-coreutils/lib/agent-workspace.js` (the source of truth for seeding).
|
||||
- For **agent skills** supporting kernel program work: keep this skill + bareos-code-change in the requires list and update `BARE_AGENT_SKILL_SEED_REL` in `packages/bare-os-coreutils/lib/agent/agent-workspace.js` (the source of truth for seeding).
|
||||
|
||||
## Output contract (what you must produce)
|
||||
- Updated `feature-roadmap.md` table row(s) with status "in progress" or "done — links to PR + verifier".
|
||||
|
||||
@@ -69,6 +69,6 @@ Release creates (or reuses) a writable HDMS mount `pear-<app-name>` at `/mnt/pea
|
||||
## Files & References
|
||||
|
||||
- Plan: `docs/design/ctx-pear-surface-and-bare-audit-plan.md`
|
||||
- Staging: `packages/bare-os-coreutils/lib/pear-stage.js`
|
||||
- Release: `packages/bare-os-coreutils/lib/pear-release.js`
|
||||
- Staging: `packages/bare-os-coreutils/lib/pear/pear-stage.js`
|
||||
- Release: `packages/bare-os-coreutils/lib/pear/pear-release.js`
|
||||
- Command: `packages/bare-os-coreutils/src/pear.js`
|
||||
|
||||
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user