Skip to content

Commit 42c02f3

Browse files
committed
Initial release: 1Helm 0.0.1
The complete first public release of 1Helm.
0 parents  commit 42c02f3

159 files changed

Lines changed: 34059 additions & 0 deletions

File tree

Some content is hidden

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

.codegraph/.gitignore

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# CodeGraph data files — local to each machine, not for committing.
2+
# Ignore everything in .codegraph/ except this file itself, so transient
3+
# files (the database, daemon.pid, sockets, logs) never show up in git.
4+
*
5+
!.gitignore

.github/CODEOWNERS

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# Default owner
2+
* @gitcommit90

.github/ISSUE_TEMPLATE/config.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
blank_issues_enabled: true

.github/pull_request_template.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
## Summary
2+
3+
<!-- User-visible problem and outcome. One concern per PR. -->
4+
5+
## Type of change
6+
7+
- [ ] Fix
8+
- [ ] Feature
9+
- [ ] Docs / governance
10+
- [ ] Refactor (no intended behavior change)
11+
- [ ] Chore / CI
12+
- [ ] Deploy / release tooling
13+
14+
## Release notes
15+
16+
Paste bullets for `CHANGELOG.md` Unreleased (or N/A):
17+
18+
```markdown
19+
### Fixed
20+
-
21+
```
22+
23+
- [ ] `CHANGELOG.md` updated (or N/A)
24+
- [ ] `docs/VISION.md` updated if this is a product decision
25+
26+
## Verification
27+
28+
- [ ] `npm run typecheck`
29+
- [ ] `npm run build`
30+
- [ ] `npm test` (and feature suites if present on this branch)
31+
- [ ] `git diff --check`
32+
- [ ] No secrets, private keys, or `data/` dumps
33+
- [ ] Local/sandbox/installer impact considered
34+
35+
## Post-merge (maintainers)
36+
37+
- [ ] Head branch deleted
38+
- [ ] CI green on `main`
39+
- [ ] If shipping: [docs/release-checklist.md](../docs/release-checklist.md)

.github/release.yml

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
changelog:
2+
exclude:
3+
labels:
4+
- skip-changelog
5+
categories:
6+
- title: Breaking changes
7+
labels: [breaking]
8+
- title: Features
9+
labels: [enhancement, feature]
10+
- title: Fixes
11+
labels: [bug, fix]
12+
- title: Documentation
13+
labels: [documentation]
14+
- title: Maintenance
15+
labels: [chore, ci]
16+
- title: Other
17+
labels: ["*"]

.github/workflows/ci.yml

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
name: CI
2+
3+
on:
4+
push:
5+
branches: [main]
6+
pull_request:
7+
8+
permissions:
9+
contents: read
10+
11+
concurrency:
12+
group: ci-${{ github.workflow }}-${{ github.ref }}
13+
cancel-in-progress: true
14+
15+
jobs:
16+
verify:
17+
name: verify
18+
runs-on: ubuntu-latest
19+
timeout-minutes: 20
20+
steps:
21+
- uses: actions/checkout@v4
22+
- uses: actions/setup-node@v4
23+
with:
24+
node-version: "22"
25+
cache: npm
26+
- name: Install
27+
run: PUPPETEER_SKIP_DOWNLOAD=1 npm ci
28+
- name: Diff check
29+
run: git diff --check
30+
- name: Typecheck
31+
run: npm run typecheck
32+
- name: Build
33+
run: npm run build
34+
- name: Test pipeline
35+
run: npm test
36+
- name: Governance artifacts
37+
run: |
38+
test -f LICENSE || test -f README.md
39+
test -f CHANGELOG.md
40+
test -f docs/GOVERNANCE.md
41+
test -f docs/release-lifecycle.md
42+
test -f docs/release-checklist.md
43+
node -e "const p=require('./package.json'); if(!p.version) process.exit(1)"

.gitignore

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
node_modules/
2+
data/
3+
data-*/
4+
public/bundle.js
5+
public/bundle.css
6+
public/app.css
7+
*.log
8+
.DS_Store
9+
.env
10+
.env.*
11+
!.env.example
12+
*.sqlite
13+
*.sqlite-wal
14+
*.sqlite-shm
15+
dist/
16+
17+
# local runtime state & session artifacts
18+
data-refactored/
19+
.deploy-backups/
20+
.claude/
21+
.design/

CHANGELOG.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# Changelog
2+
3+
All notable changes to 1Helm are documented in this file.
4+
5+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7+
8+
## [Unreleased]
9+
10+
## [0.0.1] - 2026-07-23
11+
12+
### Initial release
13+
14+
- One permanent resident agent and one persistent private Linux computer for
15+
every ordinary channel, with Skipper serving as the workspace-wide chief of
16+
staff and host/fleet operator.
17+
- Durable per-thread agent turns with concurrent independent threads, visible
18+
same-thread FIFO queues, generation-fenced single-writer responses, restart
19+
recovery, lane-scoped Stop, and immutable finalized answers.
20+
- Durable memory, provenance-bearing knowledge, reusable skills, scheduled
21+
follow-ups, recurring workflows, sleep/wake obligations, and resident ↔
22+
Skipper handoff with automatic return.
23+
- A shared multi-account model fabric spanning OAuth providers, API-key
24+
providers, enabled models, fallback routes, quotas, logs, and an internal
25+
OpenAI- and Anthropic-compatible gateway.
26+
- Host-owned Gmail and Photon connections with narrow grants, secret
27+
isolation, stable human blockers, deduplicated inbound messages, and durable
28+
external reply delivery states.
29+
- Native channel inventory and lifecycle controls for Skipper, authenticated
30+
file Open/Download actions, clickable structured questions, shell-correct
31+
cwd-aware terminals, trusted skill discovery, smooth streaming, Settings,
32+
Board, Activity, Files, Terminal, and complete first-run onboarding.
33+
- A documented reliability contract covering partner persona, prompt tiers,
34+
action bias, blocker and retry judgment, verification, memory, recovery,
35+
scheduling, connectors, and adversarial acceptance tests.
36+
- Signed, hardened-runtime Apple Silicon desktop packaging with Apple
37+
notarization, stapled tickets, Gatekeeper verification, persistent
38+
Application Support, and isolated Apple container machines.
39+
40+
[Unreleased]: https://github.com/gitcommit90/1Helm/compare/v0.0.1...HEAD
41+
[0.0.1]: https://github.com/gitcommit90/1Helm/releases/tag/v0.0.1

CONTRIBUTING.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Contributing — 1Helm
2+
3+
## Status
4+
5+
This repository is open source and maintainer-led. Focused bug fixes, tests,
6+
documentation repairs, and proposals aligned with the product contract are
7+
welcome through GitHub issues and pull requests.
8+
9+
## Maintainers
10+
11+
| Doc | Purpose |
12+
| --- | --- |
13+
| [docs/GOVERNANCE.md](./docs/GOVERNANCE.md) | Authority, branches, quality bar |
14+
| [docs/release-lifecycle.md](./docs/release-lifecycle.md) | Idea → PR → deploy |
15+
| [docs/release-checklist.md](./docs/release-checklist.md) | Ship verification commands |
16+
| [CHANGELOG.md](./CHANGELOG.md) | User/operator-facing history |
17+
| [docs/VISION.md](./docs/VISION.md) | Product decisions and build record |
18+
19+
### Every change that lands on `main`
20+
21+
1. Branch from current `origin/main`.
22+
2. `npm run typecheck`, `npm run build`, `npm test`.
23+
3. Update `CHANGELOG.md` Unreleased for user-visible work.
24+
4. Record durable decisions in `docs/VISION.md`.
25+
5. Use the merge method selected by the maintainer; delete the head branch.
26+
6. For a named ship: version bump + [release-checklist.md](./docs/release-checklist.md).
27+
28+
### Security
29+
30+
Do not commit API keys, OAuth tokens, or live `data/` directories. Report
31+
vulnerabilities through the private advisory path in [SECURITY.md](./SECURITY.md),
32+
not a public issue.

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 1Helm contributors
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

0 commit comments

Comments
 (0)