@etiquekit/etq 1.0.5 → 1.0.7
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/AGENTS.md +26 -17
- package/QuickStart.md +11 -3
- package/README.md +13 -13
- package/bin/etiquette +293 -292
- package/docs/README.md +0 -1
- package/docs/RELEASE_SURFACE_AUDIT.md +0 -1
- package/package.json +9 -2
- package/templates/seat-packs-v0/README.md +1 -1
- package/templates/seat-packs-v0/source/claude-code-seat/README.md +1 -1
- package/templates/seat-packs-v0/source/codex-seat/README.md +1 -1
- package/templates/seat-packs-v0/source/gemini-seat/README.md +1 -1
- package/templates/seat-packs-v0/source/ollama-seat/README.md +1 -1
- package/templates/seat-packs-v0/source/openrouter-seat/README.md +1 -1
- package/docs/CONCEPT_STATUS.md +0 -67
package/docs/README.md
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@etiquekit/etq",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.7",
|
|
4
4
|
"description": "Governance and evidence CLI for AI-assisted engineering seats.",
|
|
5
5
|
"private": false,
|
|
6
6
|
"type": "module",
|
|
@@ -44,5 +44,12 @@
|
|
|
44
44
|
"yaml": "2.8.3",
|
|
45
45
|
"zod": "4.3.6"
|
|
46
46
|
},
|
|
47
|
-
"homepage": "https://etiquekit.com"
|
|
47
|
+
"homepage": "https://etiquekit.com",
|
|
48
|
+
"repository": {
|
|
49
|
+
"type": "git",
|
|
50
|
+
"url": "git+https://github.com/leepickdev/etq.git"
|
|
51
|
+
},
|
|
52
|
+
"bugs": {
|
|
53
|
+
"url": "https://github.com/leepickdev/etq/issues"
|
|
54
|
+
}
|
|
48
55
|
}
|
|
@@ -62,7 +62,7 @@ project head-start surfaces before pickup:
|
|
|
62
62
|
- `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
|
|
63
63
|
- `docs/work/cookbooks/ADD_A_LANE.md` when routing work
|
|
64
64
|
|
|
65
|
-
|
|
65
|
+
Re-orient with `etiquette whereami` before pickup after stale context, resume,
|
|
66
66
|
runner/model/profile swaps, or workflow migration.
|
|
67
67
|
|
|
68
68
|
## Validate Catalog
|
|
@@ -14,6 +14,6 @@ Before pickup in the target project, read:
|
|
|
14
14
|
4. `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
|
|
15
15
|
5. `docs/work/cookbooks/ADD_A_LANE.md` when routing new work
|
|
16
16
|
|
|
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.
|
|
@@ -14,7 +14,7 @@ Before pickup in the target project, read:
|
|
|
14
14
|
4. `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
|
|
15
15
|
5. `docs/work/cookbooks/ADD_A_LANE.md` when routing new work
|
|
16
16
|
|
|
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
20
|
|
|
@@ -14,6 +14,6 @@ Before pickup in the target project, read:
|
|
|
14
14
|
4. `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
|
|
15
15
|
5. `docs/work/cookbooks/ADD_A_LANE.md` when routing new work
|
|
16
16
|
|
|
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.
|
|
@@ -14,6 +14,6 @@ Before pickup in the target project, read:
|
|
|
14
14
|
4. `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
|
|
15
15
|
5. `docs/work/cookbooks/ADD_A_LANE.md` when routing new work
|
|
16
16
|
|
|
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.
|
|
@@ -14,6 +14,6 @@ Before pickup in the target project, read:
|
|
|
14
14
|
4. `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
|
|
15
15
|
5. `docs/work/cookbooks/ADD_A_LANE.md` when routing new work
|
|
16
16
|
|
|
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.
|
package/docs/CONCEPT_STATUS.md
DELETED
|
@@ -1,67 +0,0 @@
|
|
|
1
|
-
# Concept Status Matrix
|
|
2
|
-
|
|
3
|
-
Etiquette uses a few strong workflow concepts. Some are core behavior today,
|
|
4
|
-
some belong to the optional secure plane, and some are still operating patterns
|
|
5
|
-
that need a concrete consumer before they become default workflow.
|
|
6
|
-
|
|
7
|
-
Use this page when writing portal copy, onboarding material, release notes, or
|
|
8
|
-
manager runbooks. Do not promote a concept beyond the status shown here.
|
|
9
|
-
|
|
10
|
-
## Edition Boundary
|
|
11
|
-
|
|
12
|
-
| Surface | Purpose | Authority Posture |
|
|
13
|
-
| --- | --- | --- |
|
|
14
|
-
| Etiquette Core | Repo-local coordination, task envelopes, receipts, allowed writes, read models, manuals, and canaries. | Transparent by default; authority comes from tracked task/grant records and receipts. |
|
|
15
|
-
| Etiquette Secure | Restricted-seat admission, external assurance claims, revocation, policy state, and optional tightening reactor. | Tightens standing and eligibility; it must not grant workflow authority by itself. |
|
|
16
|
-
| Hosted/portal plane | Setup passes, workspace visibility, onboarding, board/read-model display, and operational observability. | Portal RBAC authorizes portal operations only. Workflow authority stays local and grant-backed. |
|
|
17
|
-
|
|
18
|
-
## Concept Matrix
|
|
19
|
-
|
|
20
|
-
| Concept | Core Status | Secure Status | Portal Surface | Caveat |
|
|
21
|
-
| --- | --- | --- | --- | --- |
|
|
22
|
-
| Ledger | Shipped. Repo-local task records, events, and receipts carry durable workflow truth. | May receive signed or protected replication later. | Board and console render ledger-derived read models. | Git-backed truth is durable and auditable; call it cryptographic only when signing/protected append-only is actually configured. |
|
|
23
|
-
| Receipts | Shipped. Work returns must cite changed files, validation, blockers, and next owner. | May include action authorization stamps and external verifier receipts. | Evidence drawers and manager views point to receipts. | A receipt proves evidence; it does not grant, merge, close, or promote by itself. |
|
|
24
|
-
| Seats and agents | Shipped. A seat is a stable responsibility; an occupant/runtime can change. Owner cards derive accountability, diet, boundaries, review cadence, and failure modes from source contracts plus live readiness. | Restricted seats may require assurance claims before admission. | Roster and owner cards show lifecycle, readiness, ownership, and posture. | Model cards, owner cards, and roster posture help routing but do not authorize work or transfer ownership. |
|
|
25
|
-
| Task envelopes | Shipped. Tasks declare owner, mode, allowed writes, forbidden writes, validation, stop conditions, and receipt expectations. | Secure admission can refuse restricted seats before task execution. | Manager manuals and pickup surfaces show the envelope. | Allowed writes are a cooperative boundary unless paired with OS/container enforcement or audit gates. |
|
|
26
|
-
| Rubrics and validation | Shipped as acceptance criteria and conformance gates. | Can be bound to restricted workflows and verifier receipts. | Manager/operator docs list required validation and stop conditions. | Do not claim every runtime is hard-blocked from returning unless the specific flow enforces that gate. |
|
|
27
|
-
| Authorization | Shipped as grant-backed workflow discipline: authentication seats an actor; authorization gates consequential action. | Access assurance, grant leases, kill-switch state, and action stamps compose at admission time. | Hosted pass docs and workspace authority contracts describe the boundary. | A verified occupant has standing, not blanket authority. Grants are effective only while standing is current. |
|
|
28
|
-
| Access screening | Not required for open Core. | Optional Secure surface using derived claims from providers such as Persona, Scandit, and Supabase. | Restricted-seat policy docs and secure onboarding should expose pass/fail status, not raw identity data. | Raw documents, scans, full document numbers, ethnicity, and provider secrets do not belong in Git. |
|
|
29
|
-
| Portal / management console | Core read model, docs site, screenshots, and read-only `console serve` are shipped. | Secure portal may manage policy state and revocation signals. | Console and board are read-only by default. | Portal RBAC is not workflow authority. Browser actions remain out of scope in Core. |
|
|
30
|
-
| Distribution and plugins | Core CLI, docs, templates, MCP resources/prompts, and outbox-backed proposal staging are portable. | Secure can ship as an optional add-on. | Codex and Claude Code plugins may launch workflows and portal views. | Plugins are convenience packaging, not authority. MCP proposal tools must not mutate the ledger directly. |
|
|
31
|
-
| Remote execution | Supported as evidence-first design. | Secure runtimes may require admission, revocation, and verifier identity before execution. Org-remote workspaces use session outboxes, sharded drains, candidate imports, and authority promotion gates. | Manager docs should treat remote receipts as evidence. | Start remote as witness, not worker. Remote receipts and drain imports do not authorize promotion. |
|
|
32
|
-
| Managed-agent parity | Parity map exists for agents, environments, sessions, events, tools, MCP, memory, outcomes, and scheduling. | Secure can add restricted runtime admission and revocation. | Docs site and portal docs may expose the map. | Compatibility is not dependency. The runner executes; Etiquette governs and records. |
|
|
33
|
-
| Architecture boundary | Core, runtime, harness, adapter, and reactor roles are documented and import-boundary tested. | Secure adds admission policy without forking doctrine. | Hosted consumes projected views without becoming authority. | New reverse imports are architectural changes, not convenience edits. |
|
|
34
|
-
| Memory | Shipped as cited context, filesystem-shaped candidate stores, SQLite FTS recall, and `memory status` capability reporting. Evidence consolidation/rollup is the memory compaction lifecycle; it is not doctrine marination. | Secure deployments may restrict what crosses org/workspace boundaries. | Docs may surface references, summaries, archive pointers, and shipped/reserved memory status. | Memory proposes; ledger authorizes. Do not claim full semantic/vector memory parity until the adapter ships. Do not rewrite shared truth through background consolidation. |
|
|
35
|
-
| Marination | Operating pattern. Use for doctrine sabbaticals: scheduled fresh-attention review of rules, errata, and proposed revisions. | Can be run under Secure as an advisory process with cited evidence. | Not yet a default portal workflow. | Deltas only. It produces proposals, not silent lane mutations. |
|
|
36
|
-
| Sabbaticals / parking | Partially reflected as `park`, `held`, and deferred dispositions. | Secure deployments may freeze standing or grants while work is parked. | Manager cadence can show parked/held work. | Do not promise automatic stash/cleanup unless the workspace implements that runbook. |
|
|
37
|
-
| Tightening reactor | Not part of default Core. | Optional off-by-default listener that writes only fail-closed signals such as revocation or kill-switch state. | Secure operations may show reactor health. | It may tighten, never loosen. If it stops, local admission still fails or proceeds from last known policy according to the configured gate. |
|
|
38
|
-
|
|
39
|
-
## Primitive Loop
|
|
40
|
-
|
|
41
|
-
Core records, validates, gates, and dispatches. Full remembers, consolidates,
|
|
42
|
-
marinates, and projects. Execution is not the gate: Core execution is the local
|
|
43
|
-
shell/worktree, Full execution is a runtime cell or managed runner, and both
|
|
44
|
-
remain authority-false until the promotion gate accepts evidence.
|
|
45
|
-
|
|
46
|
-
| Layer | Core | Full |
|
|
47
|
-
| --- | --- | --- |
|
|
48
|
-
| Record | identity, seats, task envelopes, session runbooks, ledger, receipts | memory stores, recall capsules, org/workspace projections |
|
|
49
|
-
| Reflect | rubrics, local validation, reconciliation by review | consolidation rollups, marination, drift and failure trend review |
|
|
50
|
-
| Gate | human/Git promotion gate over receipts and grants | same gate, enriched by secure admission and policy checks |
|
|
51
|
-
| Execute | local shell, local worktree, local runner | runtime cells, EKS/kind sandboxes, managed runners |
|
|
52
|
-
| Act | dispatch, receipt return, next-owner routing | hosted portal views, observability, adapter projections |
|
|
53
|
-
|
|
54
|
-
## Writing Rule
|
|
55
|
-
|
|
56
|
-
Use shipped language for shipped behavior, design language for parked behavior,
|
|
57
|
-
and edition language for Secure behavior:
|
|
58
|
-
|
|
59
|
-
```text
|
|
60
|
-
Core records, validates, gates, and dispatches.
|
|
61
|
-
Full remembers, consolidates, marinates, and projects.
|
|
62
|
-
Secure admits and revokes restricted standing.
|
|
63
|
-
Portals display and coordinate.
|
|
64
|
-
Grants authorize consequential actions.
|
|
65
|
-
Receipts prove what happened.
|
|
66
|
-
Execution returns evidence; it never mints authority.
|
|
67
|
-
```
|