@etiquekit/etq 1.0.10 → 1.0.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/QuickStart.md +2 -1
- package/README.md +2 -6
- package/docs/AGENT_SPAWNING.md +78 -0
- package/docs/ARCHITECTURE.md +5 -5
- package/docs/CODEX_CLIENT_COMPATIBILITY.md +1 -1
- package/docs/CONCEPTS.md +22 -5
- package/docs/CORE_PROFILE.md +4 -2
- package/docs/INTEGRATION_UI.md +215 -0
- package/docs/OPERATOR_PLAYBOOK.md +77 -0
- package/docs/README.md +1 -0
- package/docs/SEAT_PROVISIONING.md +3 -3
- package/docs/TAG_ROUTE.md +95 -0
- package/docs/WORKTREE_QOL.md +6 -0
- package/docs/contracts/ledger-entry/ledger-entry.v0.2.md +1 -1
- package/lib/etiquette-core.js +143 -141
- package/lib/etiquette.js +333 -324
- package/package.json +1 -1
- package/templates/DISPATCH_PREMISES.md +39 -0
- package/templates/etiquette-vanilla-v0/source/control-seat/docs/work/access/ACCESS-ASSURANCE.md +1 -1
- package/templates/etiquette-vanilla-v0/source/control-seat/docs/work/access/workspace-secure-profile.v0.json +1 -1
- package/templates/seat-packs-v0/source/claude-code-seat/README.md +26 -0
- package/templates/seat-packs-v0/source/codex-seat/README.md +14 -0
- package/templates/seat-packs-v0/source/gemini-seat/README.md +20 -0
package/package.json
CHANGED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Dispatch Premises (Load-Bearing Premise Gate)
|
|
2
|
+
|
|
3
|
+
Reusable discipline block for dispatch cards. A load-bearing premise is any
|
|
4
|
+
claim whose falsity changes the dispatch's verdict, scope, or architecture.
|
|
5
|
+
Refuted premises waste a full runner round trip; the gate moves the check to
|
|
6
|
+
the dispatcher, where it is cheapest.
|
|
7
|
+
|
|
8
|
+
## Gate Rules
|
|
9
|
+
|
|
10
|
+
1. If a load-bearing premise is statically decidable at the routed base, the
|
|
11
|
+
dispatcher must VERIFY it before posting. Proof means a file:line whose
|
|
12
|
+
CONTENTS were read at the pinned base, on the CONSUMING surface's path.
|
|
13
|
+
Producer-side or sibling-binary evidence never verifies a consumer claim.
|
|
14
|
+
Name or path existence is never content.
|
|
15
|
+
2. Premises decidable only at runtime or by an external system ship as a
|
|
16
|
+
labeled HYPOTHESIS with a paired stop-condition the runner can trigger.
|
|
17
|
+
3. Budget: about 15 minutes and at most 5 premises. Beyond that, downgrade
|
|
18
|
+
the dispatch to a probe task whose deliverable IS the premise table.
|
|
19
|
+
4. Lint tell: a stop-condition that restates a static premise verbatim is a
|
|
20
|
+
fence instead of a check — verify it at dispatch time instead.
|
|
21
|
+
5. Runner stop-conditions remain the backstop, not the primary check. A
|
|
22
|
+
runner that finds a premise false must STOP and counter, never fabricate
|
|
23
|
+
a passing result.
|
|
24
|
+
|
|
25
|
+
## Template Block
|
|
26
|
+
|
|
27
|
+
Paste into the dispatch card and fill in:
|
|
28
|
+
|
|
29
|
+
```markdown
|
|
30
|
+
## Premises
|
|
31
|
+
|
|
32
|
+
| # | premise | class | proof / stop-condition |
|
|
33
|
+
| --- | --- | --- | --- |
|
|
34
|
+
| P1 | <claim the dispatch depends on> | VERIFIED | <file:line, contents read at <base-sha>, on the consuming surface> |
|
|
35
|
+
| P2 | <claim decidable only at runtime> | HYPOTHESIS | STOP if <observable falsifier>; counter instead of fabricating a pass |
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Every load-bearing premise appears in the table. A dispatch with an
|
|
39
|
+
unverified static premise is not ready to post.
|
package/templates/etiquette-vanilla-v0/source/control-seat/docs/work/access/ACCESS-ASSURANCE.md
CHANGED
|
@@ -24,7 +24,7 @@ Provider-backed secure deployments should keep raw identity material outside the
|
|
|
24
24
|
repo:
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
|
|
27
|
+
approved identity provider / assurance provider -> derived claims -> local access check
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
Repo-safe fields are provider refs, status, policy eligibility class, evidence
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
},
|
|
24
24
|
"claim_source": {
|
|
25
25
|
"kind": "none-required-for-open-mode",
|
|
26
|
-
"live_replacement": "
|
|
26
|
+
"live_replacement": "approved identity provider plus derived assurance claim export",
|
|
27
27
|
"raw_pii_allowed_in_repo": false
|
|
28
28
|
},
|
|
29
29
|
"reactor": {
|
|
@@ -17,3 +17,29 @@ Before pickup in the target project, read:
|
|
|
17
17
|
Re-orient with `etiquette whereami` before pickup after stale context, resume,
|
|
18
18
|
runner/model/profile swaps, or workflow migration. Hooks and readiness are
|
|
19
19
|
evidence only; the task envelope is the work authority.
|
|
20
|
+
|
|
21
|
+
## Claude Code QoL
|
|
22
|
+
|
|
23
|
+
**Monitoring posture (push vs pull):**
|
|
24
|
+
|
|
25
|
+
- Default OFF. A solo seat has no counterpart returns to catch — poll on
|
|
26
|
+
demand at natural checkpoints (`etiquette notify poll --seat <seat>` after
|
|
27
|
+
dispatching, before gates) instead of arming a watcher.
|
|
28
|
+
- Arm the Monitor tool (push) only when counterpart seats are actively
|
|
29
|
+
working or during a coordination window. Wrap a cursor-based poll loop —
|
|
30
|
+
never `tail -F` an event file from byte 0 (git operations rewrite it and
|
|
31
|
+
replay history).
|
|
32
|
+
- Push and the interactive agents view are mutually exclusive: any
|
|
33
|
+
persistent background task blocks the agents shortcut. Toggle deliberately
|
|
34
|
+
and say which posture you are in.
|
|
35
|
+
|
|
36
|
+
**Context-compaction hazards (Claude Code specific):**
|
|
37
|
+
|
|
38
|
+
- Compaction can silently swap your model. Render the active model in your
|
|
39
|
+
statusline; verify it after every compaction or resume.
|
|
40
|
+
- Re-orient with `etiquette whereami` after compaction — chat memory is not
|
|
41
|
+
a task binding. Durable facts belong in files, not context.
|
|
42
|
+
|
|
43
|
+
**Continuity:** prefer forked subagents for work that must survive your
|
|
44
|
+
session; a plain subagent dies with you. Keep persistent background tasks to
|
|
45
|
+
a minimum — each one is a posture commitment.
|
|
@@ -20,3 +20,17 @@ evidence only; the task envelope is the work authority.
|
|
|
20
20
|
|
|
21
21
|
For bounded, cursor-based wake checks use the portable core command
|
|
22
22
|
`etiquette notify poll --seat <id> --after-seq <n>` instead of raw `tail -F` monitors.
|
|
23
|
+
|
|
24
|
+
## Codex QoL
|
|
25
|
+
|
|
26
|
+
**Runner claims:** one seat, one active runner per task. Before occupying a
|
|
27
|
+
seat another runner may hold, claim explicitly and record your runner id; if
|
|
28
|
+
you find another runner's work in the worktree, preserve it and stand down or
|
|
29
|
+
counter — never overwrite.
|
|
30
|
+
|
|
31
|
+
**Honest substitution:** when your sandbox/safety layer refuses a declared
|
|
32
|
+
command (e.g. a disable-sandbox flag), run the stricter variant and disclose
|
|
33
|
+
the substitution in your return — never silently claim the declared gate ran.
|
|
34
|
+
|
|
35
|
+
**Notifications:** use bounded cursor-based polls (`etiquette notify poll`);
|
|
36
|
+
pair long waits with an explicit re-check cadence in your session notes.
|
|
@@ -17,3 +17,23 @@ Before pickup in the target project, read:
|
|
|
17
17
|
Re-orient with `etiquette whereami` before pickup after stale context, resume,
|
|
18
18
|
runner/model/profile swaps, or workflow migration. Hooks and readiness are
|
|
19
19
|
evidence only; the task envelope is the work authority.
|
|
20
|
+
|
|
21
|
+
## Gemini QoL
|
|
22
|
+
|
|
23
|
+
**Role fit:** this seat shines as a divergent-advisory and review seat —
|
|
24
|
+
fast structured review-returns (`confirm_with_amendments` with concrete
|
|
25
|
+
amendments), coverage sweeps, and alternative-angle pressure tests. Treat
|
|
26
|
+
its returns as first-class evidence.
|
|
27
|
+
|
|
28
|
+
**Calibration duties:**
|
|
29
|
+
|
|
30
|
+
- Every claim in a return carries file:line evidence read on the consuming
|
|
31
|
+
surface — speed invites overclaim; evidence is the antidote.
|
|
32
|
+
- Do not act as the sole verifier for promotion-grade claims; pair with a
|
|
33
|
+
second party or an executable check.
|
|
34
|
+
- Keep ledger-facing writes in a plain technical register — schemas, fields,
|
|
35
|
+
checks; metaphors stay in chat.
|
|
36
|
+
|
|
37
|
+
**Notifications:** Claude-style push monitors do not port to this runtime.
|
|
38
|
+
Use bounded cursor-based polls (`etiquette notify poll --seat <seat>`); no
|
|
39
|
+
persistent watchers, no tail-based loops.
|