Skip to content

Commit 0036eb1

Browse files
feat(lcos): rename public package and add export packaging
1 parent e999670 commit 0036eb1

64 files changed

Lines changed: 1382 additions & 154 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

CLAIMS.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Claim Safety
22

3-
This toy package uses strict public-claim boundaries.
3+
This public proof package uses strict public-claim boundaries.
44

55
LCOS-Core is a public reduced scaffold and proof-of-mechanism surface. It is
66
not the private SKOS system, and it is not a claim of general safety or
@@ -19,17 +19,17 @@ production reliability.
1919

2020
## Safe claims
2121

22-
- The toy ledger detects simple receipt-chain tampering in an append-oriented JSONL log.
23-
- The toy intake workbench produces accept/hold/reject decisions.
24-
- The toy router is deterministic and returns visible reasons.
25-
- The toy replay tool renders a timeline from receipt JSONL.
22+
- The receipt ledger detects simple receipt-chain tampering in an append-oriented JSONL log.
23+
- The intake workbench produces accept/hold/reject decisions.
24+
- The router is deterministic and returns visible reasons.
25+
- The replay tool renders a timeline from receipt JSONL.
2626
- The public positioning packet describes a fundable public scaffold, not the
2727
private substrate.
2828

2929
## Unsafe claims
3030

3131
- Do not claim this package implements the private SKOS system.
32-
- Do not claim production routing quality from the toy router.
32+
- Do not claim production routing quality from the router.
3333
- Do not claim patent coverage from this repository alone.
3434
- Do not claim real operational validation from synthetic fixtures.
3535
- Do not claim the ledger is OS-enforced immutable or cryptographically signed.

CONTRIBUTING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Thank you for your interest.
44

5-
This repository is currently maintained as a controlled toy public package.
5+
This repository is currently maintained as a controlled public proof package.
66

77
## Current contribution posture
88

@@ -15,4 +15,4 @@ This repository is currently maintained as a controlled toy public package.
1515
- Keep claims narrow and evidence-backed.
1616
- Prefer synthetic examples over operational data.
1717
- Do not add non-public system details.
18-
- Do not widen the repo from toy package to production claims.
18+
- Do not widen the repo from public proof package to production claims.

EMPLOYMENT_CONTRACT_MEMO.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ AI-assisted teams often run into hidden workflow failures:
3333

3434
## Public proof surface
3535

36-
LCOS-Core is my public reduced scaffold for governed agentic runtime primitives. It demonstrates mechanism classes such as append-oriented receipt ledgers, typed decisions, deterministic toy routing, replay, schema-light validation, adversarial fixtures, and explicit public/private claim boundaries.
36+
LCOS-Core is my public proof scaffold for governed agentic runtime primitives. It demonstrates mechanism classes such as append-oriented receipt ledgers, typed decisions, deterministic routing, replay, schema-light validation, adversarial fixtures, and explicit public/private claim boundaries.
3737

3838
## Private research substrate
3939

EVIDENCE_MAP.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
What is implemented, where to find it, and what the tests prove.
44

55
All claims are limited to the contents of this repository.
6-
This is a toy demonstration package — see CLAIMS.md for the full boundary.
6+
This is a public proof package — see CLAIMS.md for the full boundary.
77

88
---
99

@@ -13,9 +13,9 @@ This is a toy demonstration package — see CLAIMS.md for the full boundary.
1313

1414
| | |
1515
|---|---|
16-
| Implementation | `src/lcos_toy/receipt.py`, `src/lcos_toy/ledger.py` |
16+
| Implementation | `src/lcos_public/receipt.py`, `src/lcos_public/ledger.py` |
1717
| Tests | `tests/test_ledger.py` |
18-
| CLI demo | `python -m lcos_toy.cli demo-ledger` |
18+
| CLI demo | `python -m lcos_public.cli demo-ledger` |
1919

2020
What the tests prove:
2121
- Valid chain verifies (`test_append_only_chain_verifies`)
@@ -31,9 +31,9 @@ What the tests prove:
3131

3232
| | |
3333
|---|---|
34-
| Implementation | `src/lcos_toy/decision.py`, `src/lcos_toy/intake.py` |
34+
| Implementation | `src/lcos_public/decision.py`, `src/lcos_public/intake.py` |
3535
| Tests | `tests/test_intake.py` |
36-
| CLI demo | `python -m lcos_toy.cli demo-intake examples/requests/simple_accept.json` |
36+
| CLI demo | `python -m lcos_public.cli demo-intake examples/requests/simple_accept.json` |
3737

3838
What the tests prove:
3939
- Valid requests accept
@@ -49,9 +49,9 @@ What the tests prove:
4949

5050
| | |
5151
|---|---|
52-
| Implementation | `src/lcos_toy/router.py` |
52+
| Implementation | `src/lcos_public/router.py` |
5353
| Tests | `tests/test_router.py` |
54-
| CLI demo | `python -m lcos_toy.cli demo-route "summarize this receipt"` |
54+
| CLI demo | `python -m lcos_public.cli demo-route "summarize this receipt"` |
5555

5656
What the tests prove:
5757
- Router is deterministic across calls
@@ -66,7 +66,7 @@ What the tests prove:
6666

6767
| | |
6868
|---|---|
69-
| Implementation | `src/lcos_toy/claim.py` |
69+
| Implementation | `src/lcos_public/claim.py` |
7070
| Tests | `tests/test_claim.py` |
7171

7272
States: `OPEN → ACTIVE → HELD | COMPLETE`
@@ -93,7 +93,7 @@ What the tests prove:
9393

9494
| | |
9595
|---|---|
96-
| Implementation | `src/lcos_toy/chain.py` |
96+
| Implementation | `src/lcos_public/chain.py` |
9797
| Tests | `tests/test_chain.py` |
9898

9999
What the tests prove:
@@ -112,7 +112,7 @@ This is a structural guarantee, not a logged observation after the fact.
112112

113113
| | |
114114
|---|---|
115-
| Implementation | `src/lcos_toy/execution.py` |
115+
| Implementation | `src/lcos_public/execution.py` |
116116
| Tests | `tests/test_execution.py` |
117117

118118
What the tests prove:
@@ -129,9 +129,9 @@ What the tests prove:
129129

130130
| | |
131131
|---|---|
132-
| Implementation | `src/lcos_toy/replay.py` |
132+
| Implementation | `src/lcos_public/replay.py` |
133133
| Tests | `tests/test_replay.py` |
134-
| CLI demo | `python -m lcos_toy.cli replay <path-to-ledger.jsonl>` |
134+
| CLI demo | `python -m lcos_public.cli replay <path-to-ledger.jsonl>` |
135135

136136
---
137137

PROOF.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This repository provides a reduced example of:
99
- append-oriented receipt ledgers
1010
- hash-chain verification
1111
- typed decision states
12-
- deterministic toy routing
12+
- deterministic routing
1313
- replay and timeline rendering
1414
- schema-light intake validation
1515
- adversarial synthetic fixtures
@@ -33,8 +33,8 @@ Run:
3333

3434
```bash
3535
python -m unittest discover -s tests
36-
python -m lcos_toy.cli demo-ledger
37-
python -m lcos_toy.cli demo-route "audit this receipt"
36+
python -m lcos_public.cli demo-ledger
37+
python -m lcos_public.cli demo-route "audit this receipt"
3838
```
3939

4040
## Claim boundary

PUBLIC_DISCLOSURE_NOTICE.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Public Disclosure Notice
22

3-
This repository is a public toy package.
3+
This repository is a public proof package.
44

55
It is intended to demonstrate engineering discipline, testing rigor, and
66
claim-safe release practices. It is not intended to disclose non-public system
@@ -19,4 +19,3 @@ details, production configuration, or private implementation advantage.
1919

2020
See `LICENSE`. Public visibility does not grant copying, modification, or
2121
distribution rights beyond the current license posture.
22-

QUICKSTART.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,17 +11,17 @@ pip install -e .
1111
## Run the demos
1212

1313
```bash
14-
python -m lcos_toy.cli demo-ledger
14+
python -m lcos_public.cli demo-ledger
1515
```
1616
Expected: a hash-linked receipt timeline printed to stdout, ending with `valid=true count=2 issues=0`
1717

1818
```bash
19-
python -m lcos_toy.cli demo-intake examples/requests/simple_accept.json
19+
python -m lcos_public.cli demo-intake examples/requests/simple_accept.json
2020
```
21-
Expected: `{"kind": "ACCEPT", "reason": "request is admissible in toy scope", ...}`
21+
Expected: `{"kind": "ACCEPT", "reason": "request is admissible in public scope", ...}`
2222

2323
```bash
24-
python -m lcos_toy.cli demo-route "summarize this audit receipt"
24+
python -m lcos_public.cli demo-route "summarize this audit receipt"
2525
```
2626
Expected: `{"kind": "ACCEPT", "kernel_id": "receipt-kernel", "reason": "matched capability: receipt", ...}`
2727

@@ -35,7 +35,7 @@ Expected: 48 tests pass across ledger, intake, router, replay, claim, chain, and
3535
## Try the full path
3636

3737
```python
38-
from lcos_toy.execution import RequestRecord, GoverningExecutor
38+
from lcos_public.execution import RequestRecord, GoverningExecutor
3939

4040
request = RequestRecord.create(
4141
request_id="qs-001",

README.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# LCOS-Core Toy Public Package
1+
# LCOS-Core Public Proof Package
22

33
AI agents make claims about what they did. This is infrastructure for verifying
44
those claims without trusting the agent's account.
@@ -15,7 +15,7 @@ those two.
1515
This is the self-contained public layer of a larger private research program.
1616
The part that can be cloned, run, and inspected independently.
1717

18-
This package demonstrates a bounded toy implementation of receipt-gated governance
18+
This package demonstrates a bounded public proof implementation of receipt-gated governance
1919
primitives: append-oriented receipt logs, tamper-aware replay, typed decision states,
2020
claim lifecycle with transition receipts, gate-first execution, and public/private
2121
disclosure boundaries.
@@ -24,16 +24,16 @@ disclosure boundaries.
2424

2525
```bash
2626
python -m pip install -e .
27-
python -m lcos_toy.cli demo-ledger
28-
python -m lcos_toy.cli demo-intake examples/requests/simple_accept.json
29-
python -m lcos_toy.cli demo-route "summarize this audit receipt"
27+
python -m lcos_public.cli demo-ledger
28+
python -m lcos_public.cli demo-intake examples/requests/simple_accept.json
29+
python -m lcos_public.cli demo-route "summarize this audit receipt"
3030
python -m unittest discover -s tests
3131
```
3232

3333
Expected results:
3434

3535
- `demo-ledger` — prints a hash-linked receipt timeline and confirms `valid=true`
36-
- `demo-intake` — returns `{"kind": "ACCEPT", ...}` for a well-formed toy request
36+
- `demo-intake` — returns `{"kind": "ACCEPT", ...}` for a well-formed public request
3737
- `demo-route` — returns a deterministic kernel routing decision with a visible reason
3838
- `tests` — all pass
3939

@@ -48,7 +48,7 @@ This package demonstrates:
4848
- tamper-aware replay and timeline rendering
4949
- typed hold/escalate/reject/accept decisions
5050
- schema-light intake validation
51-
- deterministic toy routing with visible reasons
51+
- deterministic routing with visible reasons
5252
- claim lifecycle state machine (OPEN → ACTIVE → HELD | COMPLETE)
5353
- transition receipts with content-addressed IDs
5454
- claim receipt chains with deterministic recovery IDs
@@ -67,7 +67,7 @@ It intentionally does not include:
6767

6868
Public equals mechanism class. Private equals mechanism advantage.
6969

70-
This toy repository is a reduced example for review, hiring, grant, and
70+
This public proof repository is a reduced example for review, hiring, grant, and
7171
research-facing evaluation. It is not the full private system and should not be
7272
read as a publication of the decisive internal strategy.
7373

@@ -77,12 +77,12 @@ future licensing posture are evaluated.
7777
## Layout
7878

7979
```text
80-
src/lcos_toy/
80+
src/lcos_public/
8181
receipt.py receipt record and content-addressed digest logic
8282
ledger.py append-oriented JSONL ledger and verifier
8383
decision.py typed decision objects (ACCEPT/HOLD/REJECT/ESCALATE)
8484
intake.py schema-light governed intake workbench
85-
router.py deterministic toy router with visible reasons
85+
router.py deterministic router with visible reasons
8686
replay.py audit/replay timeline renderer
8787
claim.py claim state machine + TransitionReceipt emission
8888
chain.py ClaimReceiptChain with deterministic recovery_id
@@ -127,9 +127,9 @@ docs/research/
127127

128128
```bash
129129
python -m pip install -e .
130-
python -m lcos_toy.cli demo-ledger
131-
python -m lcos_toy.cli demo-intake examples/requests/simple_accept.json
132-
python -m lcos_toy.cli demo-route "summarize this audit receipt"
130+
python -m lcos_public.cli demo-ledger
131+
python -m lcos_public.cli demo-intake examples/requests/simple_accept.json
132+
python -m lcos_public.cli demo-route "summarize this audit receipt"
133133
python -m unittest discover -s tests
134134
```
135135

RELEASE_PACKAGE_MANIFEST.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# LCOS-Core Toy Public Package Manifest
1+
# LCOS-Core Public Proof Package Manifest
22

33
## Package rule
44

@@ -10,7 +10,7 @@ Show the engineering spine. Hide the decisive strategy.
1010
- Receipt-chain verification
1111
- Audit/replay timeline renderer
1212
- Governed intake workbench
13-
- Deterministic toy router with visible reasons
13+
- Deterministic router with visible reasons
1414
- Contract-first JSON schemas
1515
- Synthetic adversarial fixtures
1616
- Unit tests for ledger, intake, routing, and replay
@@ -30,9 +30,9 @@ Show the engineering spine. Hide the decisive strategy.
3030

3131
```bash
3232
PYTHONPATH=src python3 -m unittest discover -s tests -v
33-
PYTHONPATH=src python3 -m lcos_toy.cli demo-ledger
34-
PYTHONPATH=src python3 -m lcos_toy.cli demo-intake examples/requests/simple_accept.json
35-
PYTHONPATH=src python3 -m lcos_toy.cli demo-route "audit this receipt"
33+
PYTHONPATH=src python3 -m lcos_public.cli demo-ledger
34+
PYTHONPATH=src python3 -m lcos_public.cli demo-intake examples/requests/simple_accept.json
35+
PYTHONPATH=src python3 -m lcos_public.cli demo-route "audit this receipt"
3636
```
3737

3838
## Current validation result
@@ -44,6 +44,6 @@ PYTHONPATH=src python3 -m lcos_toy.cli demo-route "audit this receipt"
4444

4545
## Intended use
4646

47-
This zip is a public-safe toy repository seed. It can be inspected, copied into
47+
This zip is a public-safe repository seed. It can be inspected, copied into
4848
a public repository, or used as a review artifact after the release decision is
4949
confirmed.

SECURITY.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Security
22

3-
This repository is a toy public package and does not make production security
3+
This repository is a public proof package and does not make production security
44
claims.
55

66
## Scope
@@ -12,11 +12,10 @@ claims.
1212

1313
## Reporting
1414

15-
If you find an issue in this toy package, report it privately to the repository
15+
If you find an issue in this proof package, report it privately to the repository
1616
owner instead of opening a public exploit writeup first.
1717

1818
## Non-goals
1919

2020
This package is not a production-grade security product. Treat it as a review
2121
artifact and educational scaffold.
22-

0 commit comments

Comments
 (0)