@brik64/cli 0.1.0-beta.0 → 0.1.0-beta.2
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/LICENSE +70 -5
- package/NOTICE +18 -0
- package/README.md +108 -9
- package/docs/GITHUB_NPM_PUBLISHING.md +67 -0
- package/docs/RELEASE_COPY_MANUAL.md +358 -0
- package/package.json +38 -5
- package/tests/.gitkeep +0 -1
- package/tests/smoke.sh +0 -54
package/LICENSE
CHANGED
|
@@ -1,6 +1,71 @@
|
|
|
1
|
-
|
|
1
|
+
BRIK64 CLI PUBLIC BETA EVALUATION LICENSE
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
3
|
+
Copyright (c) 2026 BRIK64 INC. All rights reserved.
|
|
4
|
+
|
|
5
|
+
This package, including the BRIK64 CLI source, bundled PCD seed material,
|
|
6
|
+
examples, package metadata, documentation, evidence artifacts, and release
|
|
7
|
+
materials, is proprietary software and confidential know-how of BRIK64 INC
|
|
8
|
+
except where a file explicitly states otherwise.
|
|
9
|
+
|
|
10
|
+
1. Evaluation Permission
|
|
11
|
+
|
|
12
|
+
BRIK64 INC grants you a limited, revocable, non-exclusive, non-transferable
|
|
13
|
+
permission to download, install, and run this public beta release only for
|
|
14
|
+
internal evaluation, local workflow testing, compatibility review, and feedback
|
|
15
|
+
to BRIK64.
|
|
16
|
+
|
|
17
|
+
2. Reserved Rights
|
|
18
|
+
|
|
19
|
+
BRIK64 INC reserves all rights not expressly granted in this license. This
|
|
20
|
+
license does not grant any ownership interest, patent license, trademark license,
|
|
21
|
+
commercial distribution right, sublicensing right, hosted service right, resale
|
|
22
|
+
right, or right to create derivative works for public or commercial use.
|
|
23
|
+
|
|
24
|
+
3. Restrictions
|
|
25
|
+
|
|
26
|
+
Without prior written permission from BRIK64 INC, you may not:
|
|
27
|
+
|
|
28
|
+
- redistribute, mirror, sell, sublicense, rent, lease, or commercially exploit
|
|
29
|
+
this software;
|
|
30
|
+
- publish modified versions or derivative works;
|
|
31
|
+
- remove copyright, trademark, provenance, release, checksum, or evidence
|
|
32
|
+
notices;
|
|
33
|
+
- use BRIK64 names, logos, marks, or release artifacts to imply endorsement or
|
|
34
|
+
certification;
|
|
35
|
+
- use the beta in regulated, safety-critical, mission-critical, or production
|
|
36
|
+
systems as a certification authority.
|
|
37
|
+
|
|
38
|
+
4. Beta Scope
|
|
39
|
+
|
|
40
|
+
This public beta is provided for evaluation of local BRIK64 CLI workflows,
|
|
41
|
+
PCD-oriented project structure, package validation, and bounded evidence review.
|
|
42
|
+
Expanded platform support, production certification surfaces, and advanced
|
|
43
|
+
compiler-methodology scopes are governed by BRIK64 release gates and written
|
|
44
|
+
commercial terms.
|
|
45
|
+
|
|
46
|
+
5. Feedback
|
|
47
|
+
|
|
48
|
+
If you provide feedback, bug reports, ideas, or suggestions to BRIK64, you grant
|
|
49
|
+
BRIK64 INC a perpetual, irrevocable, worldwide, royalty-free right to use that
|
|
50
|
+
feedback to improve BRIK64 products and services without obligation to you.
|
|
51
|
+
|
|
52
|
+
6. No Warranty
|
|
53
|
+
|
|
54
|
+
This beta is provided as-is for evaluation. BRIK64 INC disclaims all warranties,
|
|
55
|
+
express or implied, including merchantability, fitness for a particular purpose,
|
|
56
|
+
non-infringement, and uninterrupted or error-free operation.
|
|
57
|
+
|
|
58
|
+
7. Limitation Of Liability
|
|
59
|
+
|
|
60
|
+
To the maximum extent permitted by law, BRIK64 INC is not liable for indirect,
|
|
61
|
+
incidental, special, consequential, exemplary, punitive, or business interruption
|
|
62
|
+
damages arising from this beta, even if advised of the possibility of such
|
|
63
|
+
damages.
|
|
64
|
+
|
|
65
|
+
8. Commercial Licensing
|
|
66
|
+
|
|
67
|
+
For production, commercial, hosted, redistribution, partner, enterprise,
|
|
68
|
+
regulated, or certification-oriented use, contact BRIK64 INC through the public
|
|
69
|
+
company channels listed at https://brik64.com.
|
|
70
|
+
|
|
71
|
+
This is not an open source license.
|
package/NOTICE
ADDED
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
BRIK64 CLI Public Beta Notice
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 BRIK64 INC. All rights reserved.
|
|
4
|
+
|
|
5
|
+
BRIK64 CLI 0.1 public beta is proprietary software published for evaluation of
|
|
6
|
+
local PCD workflows, bounded evidence review, and claim-safe project scaffolding.
|
|
7
|
+
The current public beta surface is focused on macOS local CLI usage, package
|
|
8
|
+
validation, and versioned release evidence. Expanded platform support and
|
|
9
|
+
stronger certification surfaces remain governed by the BRIK64 evidence process
|
|
10
|
+
and commercial licensing terms.
|
|
11
|
+
|
|
12
|
+
Public product information: https://brik64.com/home-cli
|
|
13
|
+
Documentation: https://docs.brik64.com/cli/install
|
|
14
|
+
Repository: https://github.com/brik64/brik64-cli
|
|
15
|
+
Package: https://www.npmjs.com/package/@brik64/cli
|
|
16
|
+
|
|
17
|
+
License: BRIK64 CLI Public Beta Evaluation License. This is not an open source
|
|
18
|
+
license. See LICENSE for evaluation terms and reserved rights.
|
package/README.md
CHANGED
|
@@ -1,12 +1,111 @@
|
|
|
1
|
-
#
|
|
1
|
+
# BRIK64 CLI
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
```text
|
|
4
|
+
╔══════════════════════════════════════════════════════╗
|
|
5
|
+
║ ║
|
|
6
|
+
║ ██████╗ ██████╗ ██╗██╗ ██╗ ██████╗ ██╗ ██╗ ║
|
|
7
|
+
║ ██╔══██╗██╔══██╗ ██║██║ ██╔╝██╔════╝ ██║ ██║ ║
|
|
8
|
+
║ ██████╔╝██████╔╝ ██║█████╔╝ ███████╗ ███████║ ║
|
|
9
|
+
║ ██╔══██╗██╔══██╗ ██║██╔═██╗ ██╔═══██╗╚════██║ ║
|
|
10
|
+
║ ██████╔╝██║ ██║ ██║██║ ██╗╚██████╔╝ ██║ ║
|
|
11
|
+
║ ╚═════╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ║
|
|
12
|
+
║ ║
|
|
13
|
+
║ BRIK64 SYSTEM BOOT ║
|
|
14
|
+
║ SOFTWARE LOGIC COMPILER ║
|
|
15
|
+
║ MAKE SOFTWARE REVIEWABLE AGAIN ║
|
|
16
|
+
║ ║
|
|
17
|
+
╚══════════════════════════════════════════════════════╝
|
|
18
|
+
```
|
|
4
19
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
20
|
+
BRIK64 CLI is the public beta command-line surface for local BRIK64 project
|
|
21
|
+
workflows. It gives developers a practical way to start working with
|
|
22
|
+
PCD-oriented structure, local evidence review, and claim-safe project scaffolding
|
|
23
|
+
from their own machine.
|
|
8
24
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
25
|
+
Generated code is easy to ship. Trust is the harder part. BRIK64 CLI is built
|
|
26
|
+
for teams that want software work to carry clearer structure, repeatable
|
|
27
|
+
evidence, and release language that stays aligned with verified artifacts.
|
|
28
|
+
|
|
29
|
+
## Status
|
|
30
|
+
|
|
31
|
+
Current beta: `0.1.0-beta.2`
|
|
32
|
+
|
|
33
|
+
This beta is intended for evaluation, local workflow trials, package smoke
|
|
34
|
+
testing, and bounded PCD/evidence review. The current public beta surface is
|
|
35
|
+
focused on macOS local CLI usage and developer-facing evidence workflows.
|
|
36
|
+
Broader platform support, stronger certification surfaces, and deeper compiler
|
|
37
|
+
claims remain gated by the evidence process in `brik64-prod`.
|
|
38
|
+
|
|
39
|
+
`brik64-prod` remains the authority for methodology, release gates, evidence
|
|
40
|
+
contracts, certification boundaries, and public claim authorization. This repo
|
|
41
|
+
contains the CLI source, package metadata, local tests, PCD seed files, and
|
|
42
|
+
versioned beta artifacts.
|
|
43
|
+
|
|
44
|
+
## Install
|
|
45
|
+
|
|
46
|
+
```sh
|
|
47
|
+
npm install -g @brik64/cli@beta
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
After installation:
|
|
51
|
+
|
|
52
|
+
```sh
|
|
53
|
+
brik --version
|
|
54
|
+
brik help
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Public web surface: https://brik64.com/home-cli
|
|
58
|
+
|
|
59
|
+
Docs: https://docs.brik64.com/cli/install
|
|
60
|
+
|
|
61
|
+
## What It Does
|
|
62
|
+
|
|
63
|
+
- Provides the `brik` command for the BRIK64 CLI beta.
|
|
64
|
+
- Supports local PCD-oriented project scaffolding and inspection workflows.
|
|
65
|
+
- Includes seed PCD examples and bounded evidence artifacts for CLI beta review.
|
|
66
|
+
- Keeps evidence boundaries visible as teams move from local workflow to stronger
|
|
67
|
+
BRIK64 review.
|
|
68
|
+
- Establishes the public package surface for controlled CLI evaluation and future
|
|
69
|
+
SDK alignment.
|
|
70
|
+
|
|
71
|
+
## Current Scope
|
|
72
|
+
|
|
73
|
+
The `0.1.0-beta.2` release is scoped to public beta evaluation. It is centered
|
|
74
|
+
on local developer workflow, macOS package validation, PCD seed material, and
|
|
75
|
+
release evidence review. Production certification, expanded platform support,
|
|
76
|
+
and advanced compiler-methodology claims are promoted only when the matching
|
|
77
|
+
BRIK64 gates and evidence packs authorize that scope.
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
## Release Assets
|
|
81
|
+
|
|
82
|
+
Current beta asset:
|
|
83
|
+
|
|
84
|
+
- macOS Apple Silicon package for local CLI evaluation.
|
|
85
|
+
|
|
86
|
+
Planned release lanes:
|
|
87
|
+
|
|
88
|
+
- macOS Intel package after platform-specific package and smoke gates pass.
|
|
89
|
+
- Debian/Ubuntu Linux packages after distro-specific build and install gates pass.
|
|
90
|
+
- Windows PC package after Windows runner validation and install smoke pass.
|
|
91
|
+
|
|
92
|
+
Each platform package should ship with its own artifact, checksum, install smoke,
|
|
93
|
+
and release evidence before it is promoted on npm, GitHub Releases, docs, or
|
|
94
|
+
brik64.com.
|
|
95
|
+
|
|
96
|
+
## Release Evidence
|
|
97
|
+
|
|
98
|
+
The public beta package is tied to versioned release artifacts, checksums, and
|
|
99
|
+
operator gates. Use the GitHub release assets and checksums to review the exact
|
|
100
|
+
package candidate before treating any install path as authoritative.
|
|
101
|
+
|
|
102
|
+
GitHub release: https://github.com/brik64/brik64-cli/releases/tag/v0.1.0-beta.2
|
|
103
|
+
|
|
104
|
+
## Copyright And License
|
|
105
|
+
|
|
106
|
+
Copyright (c) 2026 BRIK64 INC. All rights reserved.
|
|
107
|
+
|
|
108
|
+
See `LICENSE` and `NOTICE`. BRIK64 CLI public beta is proprietary
|
|
109
|
+
evaluation software from BRIK64 INC. Production, commercial, hosted,
|
|
110
|
+
redistribution, partner, enterprise, regulated, or certification-oriented use
|
|
111
|
+
requires written commercial terms from BRIK64 INC.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# GitHub To npm Publishing Runbook
|
|
2
|
+
|
|
3
|
+
BRIK64 CLI beta releases should be published from GitHub Actions after the
|
|
4
|
+
package metadata, README, NOTICE, release evidence, and claim-safe copy have
|
|
5
|
+
been reviewed.
|
|
6
|
+
|
|
7
|
+
## Recommended Path
|
|
8
|
+
|
|
9
|
+
Use the manual workflow:
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
.github/workflows/publish-npm-beta.yml
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Inputs:
|
|
16
|
+
|
|
17
|
+
- `version`: exact `package.json` version, for example `0.1.0-beta.1`.
|
|
18
|
+
- `dist_tag`: normally `beta`.
|
|
19
|
+
- `confirm_public_beta`: must equal `PUBLISH_BRIK64_CLI_BETA`.
|
|
20
|
+
|
|
21
|
+
Required GitHub configuration:
|
|
22
|
+
|
|
23
|
+
- Environment: `npm-beta`.
|
|
24
|
+
- Secret: `NPM_TOKEN` with publish rights for `@brik64/cli`.
|
|
25
|
+
- Recommended environment protection: require human approval before publish.
|
|
26
|
+
|
|
27
|
+
## Workflow Checks
|
|
28
|
+
|
|
29
|
+
The workflow:
|
|
30
|
+
|
|
31
|
+
- validates package name and exact version;
|
|
32
|
+
- restricts this lane to `0.1.0-beta.*` versions;
|
|
33
|
+
- runs `npm test`;
|
|
34
|
+
- runs `npm pack --dry-run`;
|
|
35
|
+
- requires `README.md` and `NOTICE`;
|
|
36
|
+
- fails if the version already exists on npm;
|
|
37
|
+
- publishes with public access and the selected dist-tag;
|
|
38
|
+
- verifies npm version metadata, README filename/content metadata, tarball metadata, and dist-tag after publish. The workflow retries metadata reads because npm propagation can lag immediately after a successful publish.
|
|
39
|
+
|
|
40
|
+
## Trusted Publishing Upgrade
|
|
41
|
+
|
|
42
|
+
npm supports Trusted Publishing from GitHub Actions using OIDC. That path reduces
|
|
43
|
+
long-lived token exposure and can generate npm provenance automatically for a
|
|
44
|
+
public package published from a public GitHub repository.
|
|
45
|
+
|
|
46
|
+
To migrate:
|
|
47
|
+
|
|
48
|
+
1. In npm package settings, add GitHub Actions as a trusted publisher for
|
|
49
|
+
organization `brik64`, repository `brik64-cli`, and this workflow.
|
|
50
|
+
2. Keep `permissions.id-token: write` in the workflow.
|
|
51
|
+
3. Test one beta publish from GitHub Actions.
|
|
52
|
+
4. After the trusted publisher works, restrict or revoke traditional npm tokens.
|
|
53
|
+
|
|
54
|
+
Until the trusted publisher is configured on npmjs.com, keep using `NPM_TOKEN`
|
|
55
|
+
in the protected `npm-beta` GitHub environment.
|
|
56
|
+
|
|
57
|
+
## Copy Boundary
|
|
58
|
+
|
|
59
|
+
Release copy should describe beta scope positively:
|
|
60
|
+
|
|
61
|
+
- local PCD workflows;
|
|
62
|
+
- bounded evidence review;
|
|
63
|
+
- claim-safe project scaffolding;
|
|
64
|
+
- macOS local CLI usage for the current beta;
|
|
65
|
+
- stronger scopes promoted only after matching BRIK64 gates authorize them.
|
|
66
|
+
|
|
67
|
+
Use `docs/RELEASE_COPY_MANUAL.md` before publishing a new npm beta.
|
|
@@ -0,0 +1,358 @@
|
|
|
1
|
+
# BRIK64 CLI Release Copy Manual
|
|
2
|
+
|
|
3
|
+
This manual standardizes public copy for BRIK64 CLI package pages, GitHub
|
|
4
|
+
releases, changelogs, repository descriptions, and launch snippets. It is built
|
|
5
|
+
for beta releases where public wording must be useful, commercial, searchable,
|
|
6
|
+
and aligned with BRIK64 evidence boundaries.
|
|
7
|
+
|
|
8
|
+
## Authority
|
|
9
|
+
|
|
10
|
+
- Product surface: BRIK64 CLI.
|
|
11
|
+
- Current public beta: `0.1.0-beta.2`.
|
|
12
|
+
- Public web surface: https://brik64.com/home-cli
|
|
13
|
+
- Docs: https://docs.brik64.com/cli/install
|
|
14
|
+
- Package: https://www.npmjs.com/package/@brik64/cli
|
|
15
|
+
- Release: https://github.com/brik64/brik64-cli/releases/tag/v0.1.0-beta.2
|
|
16
|
+
- Evidence authority: `brik64-prod` gates, manifests, checksums, and release
|
|
17
|
+
reports.
|
|
18
|
+
- Implementation surface: `brik64-cli` source, package metadata, tests, PCD seed
|
|
19
|
+
files, and beta artifacts.
|
|
20
|
+
|
|
21
|
+
## Voice Standard
|
|
22
|
+
|
|
23
|
+
BRIK64 release copy should be:
|
|
24
|
+
|
|
25
|
+
- technically serious;
|
|
26
|
+
- practical for developers;
|
|
27
|
+
- clear about beta maturity;
|
|
28
|
+
- evidence-aligned;
|
|
29
|
+
- commercially legible;
|
|
30
|
+
- confident without overreach.
|
|
31
|
+
|
|
32
|
+
Prefer scope language over negative disclaimers:
|
|
33
|
+
|
|
34
|
+
- `current beta scope`;
|
|
35
|
+
- `focused on macOS local CLI usage`;
|
|
36
|
+
- `gated by the BRIK64 evidence process`;
|
|
37
|
+
- `promoted when matching gates authorize the scope`;
|
|
38
|
+
- `release evidence available in attached manifests and checksums`.
|
|
39
|
+
|
|
40
|
+
## Canonical Package Description
|
|
41
|
+
|
|
42
|
+
Use this for `package.json.description` and short package surfaces:
|
|
43
|
+
|
|
44
|
+
```text
|
|
45
|
+
BRIK64 CLI public beta for local PCD workflows, bounded evidence review, and claim-safe project scaffolding.
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Alternative short descriptions:
|
|
49
|
+
|
|
50
|
+
```text
|
|
51
|
+
BRIK64 CLI beta for local project scaffolding, PCD-oriented workflows, and evidence-aware software review.
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
```text
|
|
55
|
+
Command-line beta for BRIK64 local workflows, PCD seed material, and versioned release evidence.
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Long Description
|
|
59
|
+
|
|
60
|
+
Use this for release pages, npm README intros, GitHub repository description
|
|
61
|
+
expansion, and docs package cards:
|
|
62
|
+
|
|
63
|
+
```text
|
|
64
|
+
BRIK64 CLI is the public beta command-line surface for local BRIK64 project workflows. It gives developers a practical way to start working with PCD-oriented structure, local evidence review, and claim-safe project scaffolding from their own machine.
|
|
65
|
+
|
|
66
|
+
The current beta is focused on macOS local CLI usage, package validation, seed PCD material, and developer-facing evidence workflows. Broader platform support, stronger certification surfaces, and deeper compiler-methodology claims are promoted only when the matching BRIK64 gates and evidence packs authorize that scope.
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## GitHub Repository Description
|
|
70
|
+
|
|
71
|
+
Use one of these as the GitHub repo description:
|
|
72
|
+
|
|
73
|
+
```text
|
|
74
|
+
BRIK64 CLI public beta for local PCD workflows, evidence review, and claim-safe project scaffolding.
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
```text
|
|
78
|
+
Public beta command-line surface for BRIK64 local workflows, PCD seed material, and release evidence review.
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
Recommended repo topics:
|
|
82
|
+
|
|
83
|
+
```text
|
|
84
|
+
brik64, brik, cli, pcd, evidence, software-trust, developer-tools, public-beta, macos, command-line
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## npm Keywords
|
|
88
|
+
|
|
89
|
+
Use these in `package.json.keywords`:
|
|
90
|
+
|
|
91
|
+
```json
|
|
92
|
+
[
|
|
93
|
+
"brik64",
|
|
94
|
+
"brik",
|
|
95
|
+
"cli",
|
|
96
|
+
"pcd",
|
|
97
|
+
"evidence",
|
|
98
|
+
"software-trust",
|
|
99
|
+
"developer-tools",
|
|
100
|
+
"public-beta"
|
|
101
|
+
]
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
Optional keywords for later releases, only when the relevant surface exists:
|
|
105
|
+
|
|
106
|
+
```text
|
|
107
|
+
topology, certification, sdk, macos, linux, windows, compiler, governance
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
Add platform keywords only when that platform has release evidence.
|
|
111
|
+
|
|
112
|
+
## SEO Titles And Meta Copy
|
|
113
|
+
|
|
114
|
+
Homepage/package card title:
|
|
115
|
+
|
|
116
|
+
```text
|
|
117
|
+
BRIK64 CLI Public Beta
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
SEO title:
|
|
121
|
+
|
|
122
|
+
```text
|
|
123
|
+
BRIK64 CLI - Public Beta for Local PCD and Evidence Workflows
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
Meta description:
|
|
127
|
+
|
|
128
|
+
```text
|
|
129
|
+
Install the BRIK64 CLI public beta for local PCD-oriented workflows, evidence review, and claim-safe project scaffolding. Current beta focused on macOS local CLI usage.
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
Social card title:
|
|
133
|
+
|
|
134
|
+
```text
|
|
135
|
+
BRIK64 CLI 0.1 Public Beta
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
Social card description:
|
|
139
|
+
|
|
140
|
+
```text
|
|
141
|
+
A local command-line surface for PCD-oriented project structure, bounded evidence review, and BRIK64 beta workflow evaluation.
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
## GitHub Release Template
|
|
145
|
+
|
|
146
|
+
```markdown
|
|
147
|
+
# BRIK64 CLI {{version}}
|
|
148
|
+
|
|
149
|
+
BRIK64 CLI is the public beta command-line surface for local BRIK64 project workflows. It gives developers a practical way to start working with PCD-oriented structure, local evidence review, and claim-safe project scaffolding from their own machine.
|
|
150
|
+
|
|
151
|
+
## Beta Scope
|
|
152
|
+
|
|
153
|
+
This release is intended for evaluation, local workflow trials, package smoke testing, and bounded PCD/evidence review. The current public beta surface is focused on macOS local CLI usage and developer-facing evidence workflows. Broader platform support, stronger certification surfaces, and deeper compiler-methodology claims remain gated by the evidence process in `brik64-prod`.
|
|
154
|
+
|
|
155
|
+
## Install
|
|
156
|
+
|
|
157
|
+
```sh
|
|
158
|
+
npm install -g @brik64/cli@beta
|
|
159
|
+
brik --version
|
|
160
|
+
brik help
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
Public web surface: https://brik64.com/home-cli
|
|
164
|
+
|
|
165
|
+
Docs: https://docs.brik64.com/cli/install
|
|
166
|
+
|
|
167
|
+
## What Is Included
|
|
168
|
+
|
|
169
|
+
- `brik` CLI beta package for local workflow evaluation.
|
|
170
|
+
- PCD seed material for CLI-oriented project structure.
|
|
171
|
+
- Bounded evidence artifacts and release checksums.
|
|
172
|
+
- macOS package validation surface for this beta.
|
|
173
|
+
- Public package/release metadata aligned to BRIK64 claim boundaries.
|
|
174
|
+
|
|
175
|
+
## Evidence
|
|
176
|
+
|
|
177
|
+
Use the attached manifests, checksums, and release assets to review the exact package candidate. `brik64-prod` remains the authority for methodology, release gates, evidence contracts, certification boundaries, and public claim authorization.
|
|
178
|
+
|
|
179
|
+
## Copyright
|
|
180
|
+
|
|
181
|
+
Copyright (c) 2026 BRIK64 INC. All rights reserved.
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
## Changelog Template
|
|
185
|
+
|
|
186
|
+
Use this as the standard changelog text for beta releases:
|
|
187
|
+
|
|
188
|
+
```markdown
|
|
189
|
+
# Changelog
|
|
190
|
+
|
|
191
|
+
## {{version}} - {{date}}
|
|
192
|
+
|
|
193
|
+
### Added
|
|
194
|
+
|
|
195
|
+
- Published the BRIK64 CLI public beta package surface for local workflow evaluation.
|
|
196
|
+
- Added PCD seed material for CLI-oriented project structure.
|
|
197
|
+
- Added bounded evidence artifacts and release checksums for package review.
|
|
198
|
+
- Added public metadata linking the package, repository, docs, and BRIK64 web surface.
|
|
199
|
+
|
|
200
|
+
### Changed
|
|
201
|
+
|
|
202
|
+
- Standardized package and release copy around beta maturity, local developer workflow, and evidence review.
|
|
203
|
+
- Aligned repository and release metadata with BRIK64 claim-safe public wording.
|
|
204
|
+
|
|
205
|
+
### Verification
|
|
206
|
+
|
|
207
|
+
- Package smoke tested with `npm pack --dry-run`.
|
|
208
|
+
- GitHub release assets include checksums and manifests for the beta artifact.
|
|
209
|
+
- npm `beta` dist-tag points to the current beta version after publication.
|
|
210
|
+
|
|
211
|
+
### Scope
|
|
212
|
+
|
|
213
|
+
This beta is centered on local developer workflow, macOS package validation, PCD seed material, and release evidence review. Expanded platform support and stronger certification surfaces are promoted when the matching BRIK64 gates and evidence packs authorize that scope.
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
## README Section Order
|
|
217
|
+
|
|
218
|
+
For npm and GitHub, keep README sections in this order:
|
|
219
|
+
|
|
220
|
+
1. Product intro.
|
|
221
|
+
2. Status.
|
|
222
|
+
3. Install.
|
|
223
|
+
4. What it does.
|
|
224
|
+
5. Current scope.
|
|
225
|
+
6. Release evidence.
|
|
226
|
+
7. Copyright and license.
|
|
227
|
+
|
|
228
|
+
The npm README is captured at publish time. Updating README copy in the repo does
|
|
229
|
+
not update an already published package page; publish a new semver version when
|
|
230
|
+
README or metadata must change on npm.
|
|
231
|
+
|
|
232
|
+
## Copy Rules By Surface
|
|
233
|
+
|
|
234
|
+
### npm
|
|
235
|
+
|
|
236
|
+
- Keep the `description` short and searchable.
|
|
237
|
+
- Include `homepage`, `repository`, `bugs`, `author`, `keywords`, `engines`,
|
|
238
|
+
`publishConfig`, `README.md`, `LICENSE`, and `NOTICE`.
|
|
239
|
+
- Use `--access public` for scoped public packages.
|
|
240
|
+
- Keep `beta` dist-tag for beta releases.
|
|
241
|
+
|
|
242
|
+
### GitHub Release
|
|
243
|
+
|
|
244
|
+
- Title format: `BRIK64 CLI {{version}} public beta`.
|
|
245
|
+
- Body should include beta scope, install command, included artifacts, evidence,
|
|
246
|
+
and copyright.
|
|
247
|
+
- Keep release assets and checksums attached.
|
|
248
|
+
- Use prerelease for beta versions.
|
|
249
|
+
|
|
250
|
+
### GitHub Repository
|
|
251
|
+
|
|
252
|
+
- Description should fit one sentence.
|
|
253
|
+
- Topics should be product/search terms, not unsupported platform claims.
|
|
254
|
+
- README must mirror npm package copy.
|
|
255
|
+
- Keep `NOTICE` and `LICENSE` visible at repo root.
|
|
256
|
+
|
|
257
|
+
### brik64.com / docs
|
|
258
|
+
|
|
259
|
+
- Link to npm, GitHub release, and docs install page.
|
|
260
|
+
- State the current beta scope positively.
|
|
261
|
+
- Prefer `current support` and `beta scope` over negative disclaimers.
|
|
262
|
+
- Use evidence language when stronger claims appear.
|
|
263
|
+
|
|
264
|
+
## Claim-Safe Wording Bank
|
|
265
|
+
|
|
266
|
+
Use:
|
|
267
|
+
|
|
268
|
+
```text
|
|
269
|
+
public beta
|
|
270
|
+
local workflow evaluation
|
|
271
|
+
PCD-oriented structure
|
|
272
|
+
bounded evidence review
|
|
273
|
+
release evidence
|
|
274
|
+
macOS local CLI usage
|
|
275
|
+
claim-safe project scaffolding
|
|
276
|
+
gated by BRIK64 evidence process
|
|
277
|
+
versioned release artifacts
|
|
278
|
+
checksums and manifests
|
|
279
|
+
```
|
|
280
|
+
|
|
281
|
+
Keep advanced or platform-specific wording evidence-bound. Platform language should stay scoped:
|
|
282
|
+
|
|
283
|
+
```text
|
|
284
|
+
current public beta surface is focused on macOS local CLI usage
|
|
285
|
+
```
|
|
286
|
+
|
|
287
|
+
```text
|
|
288
|
+
Linux and Windows support should be described only after platform-specific gates pass
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
## Standard Footer
|
|
292
|
+
|
|
293
|
+
```text
|
|
294
|
+
Copyright (c) 2026 BRIK64 INC. All rights reserved.
|
|
295
|
+
```
|
|
296
|
+
|
|
297
|
+
Use this footer in package README, release notes, NOTICE, docs cards, and public
|
|
298
|
+
repo descriptions where space allows.
|
|
299
|
+
|
|
300
|
+
|
|
301
|
+
## License Standard
|
|
302
|
+
|
|
303
|
+
BRIK64 CLI public beta releases use the `BRIK64 CLI Public Beta Evaluation License`.
|
|
304
|
+
This is proprietary evaluation software from BRIK64 INC. Public package metadata
|
|
305
|
+
should use:
|
|
306
|
+
|
|
307
|
+
```json
|
|
308
|
+
"license": "SEE LICENSE IN LICENSE"
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
Every beta package should include:
|
|
312
|
+
|
|
313
|
+
- `LICENSE` with the full BRIK64 CLI Public Beta Evaluation License;
|
|
314
|
+
- `NOTICE` with copyright, public links, and beta licensing summary;
|
|
315
|
+
- README copyright section pointing to both files;
|
|
316
|
+
- package metadata with `author.name` set to `BRIK64 INC`.
|
|
317
|
+
|
|
318
|
+
Use positive scope language for maturity and support boundaries. Commercial,
|
|
319
|
+
hosted, redistribution, partner, enterprise, regulated, or certification-oriented
|
|
320
|
+
use should route to written commercial terms from BRIK64 INC.
|
|
321
|
+
|
|
322
|
+
|
|
323
|
+
## ASCII Banner Standard
|
|
324
|
+
|
|
325
|
+
Use this provisional ASCII banner in CLI README and release surfaces until the
|
|
326
|
+
final cross-repo visual identity asset is ready:
|
|
327
|
+
|
|
328
|
+
```text
|
|
329
|
+
╔══════════════════════════════════════════════════════╗
|
|
330
|
+
║ ║
|
|
331
|
+
║ ██████╗ ██████╗ ██╗██╗ ██╗ ██████╗ ██╗ ██╗ ║
|
|
332
|
+
║ ██╔══██╗██╔══██╗ ██║██║ ██╔╝██╔════╝ ██║ ██║ ║
|
|
333
|
+
║ ██████╔╝██████╔╝ ██║█████╔╝ ███████╗ ███████║ ║
|
|
334
|
+
║ ██╔══██╗██╔══██╗ ██║██╔═██╗ ██╔═══██╗╚════██║ ║
|
|
335
|
+
║ ██████╔╝██║ ██║ ██║██║ ██╗╚██████╔╝ ██║ ║
|
|
336
|
+
║ ╚═════╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ║
|
|
337
|
+
║ ║
|
|
338
|
+
║ BRIK64 SYSTEM BOOT ║
|
|
339
|
+
║ SOFTWARE LOGIC COMPILER ║
|
|
340
|
+
║ MAKE SOFTWARE REVIEWABLE AGAIN ║
|
|
341
|
+
║ ║
|
|
342
|
+
╚══════════════════════════════════════════════════════╝
|
|
343
|
+
```
|
|
344
|
+
|
|
345
|
+
For beta copy, keep the claim-safe scope paragraph directly after the banner so
|
|
346
|
+
the visual language stays anchored to current release evidence.
|
|
347
|
+
|
|
348
|
+
## Release Asset Matrix Wording
|
|
349
|
+
|
|
350
|
+
Use this wording for current and future platform packages:
|
|
351
|
+
|
|
352
|
+
```text
|
|
353
|
+
Current beta asset: macOS Apple Silicon package.
|
|
354
|
+
Planned release lanes: macOS Intel, Debian/Ubuntu Linux packages, and Windows PC packages after platform-specific build and smoke gates pass.
|
|
355
|
+
```
|
|
356
|
+
|
|
357
|
+
Avoid presenting planned platform lanes as current support until the matching
|
|
358
|
+
artifact, checksum, install smoke, and release gate exist.
|
package/package.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@brik64/cli",
|
|
3
|
-
"version": "0.1.0-beta.
|
|
3
|
+
"version": "0.1.0-beta.2",
|
|
4
4
|
"private": false,
|
|
5
|
-
"description": "BRIK64 CLI
|
|
6
|
-
"homepage": "https://
|
|
5
|
+
"description": "BRIK64 CLI public beta for local PCD workflows, bounded evidence review, and claim-safe project scaffolding.",
|
|
6
|
+
"homepage": "https://brik64.com/home-cli",
|
|
7
7
|
"repository": {
|
|
8
8
|
"type": "git",
|
|
9
|
-
"url": "https://github.com/brik64/brik64-cli.git"
|
|
9
|
+
"url": "git+https://github.com/brik64/brik64-cli.git"
|
|
10
10
|
},
|
|
11
11
|
"bugs": {
|
|
12
12
|
"url": "https://github.com/brik64/brik64-cli/issues"
|
|
@@ -17,5 +17,38 @@
|
|
|
17
17
|
},
|
|
18
18
|
"scripts": {
|
|
19
19
|
"test": "bash tests/smoke.sh"
|
|
20
|
-
}
|
|
20
|
+
},
|
|
21
|
+
"author": {
|
|
22
|
+
"name": "BRIK64 INC",
|
|
23
|
+
"url": "https://brik64.com"
|
|
24
|
+
},
|
|
25
|
+
"keywords": [
|
|
26
|
+
"brik64",
|
|
27
|
+
"brik",
|
|
28
|
+
"cli",
|
|
29
|
+
"pcd",
|
|
30
|
+
"evidence",
|
|
31
|
+
"software-trust",
|
|
32
|
+
"developer-tools",
|
|
33
|
+
"public-beta"
|
|
34
|
+
],
|
|
35
|
+
"engines": {
|
|
36
|
+
"node": ">=20"
|
|
37
|
+
},
|
|
38
|
+
"publishConfig": {
|
|
39
|
+
"access": "public",
|
|
40
|
+
"tag": "beta",
|
|
41
|
+
"registry": "https://registry.npmjs.org/"
|
|
42
|
+
},
|
|
43
|
+
"files": [
|
|
44
|
+
"src",
|
|
45
|
+
"pcd",
|
|
46
|
+
"docs",
|
|
47
|
+
"evidence",
|
|
48
|
+
"packaging",
|
|
49
|
+
"README.md",
|
|
50
|
+
"LICENSE",
|
|
51
|
+
"NOTICE",
|
|
52
|
+
".brik/manifest.json"
|
|
53
|
+
]
|
|
21
54
|
}
|
package/tests/.gitkeep
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
|
package/tests/smoke.sh
DELETED
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env bash
|
|
2
|
-
set -euo pipefail
|
|
3
|
-
|
|
4
|
-
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
|
5
|
-
BRIK="$ROOT_DIR/src/brik.js"
|
|
6
|
-
tmpdir="$(mktemp -d)"
|
|
7
|
-
cleanup() { rm -rf "$tmpdir"; }
|
|
8
|
-
trap cleanup EXIT
|
|
9
|
-
|
|
10
|
-
node "$BRIK" --version | grep -q "BRIK64 CLI 0.1.0-beta.0"
|
|
11
|
-
node "$BRIK" --help | grep -q "status=bootstrap_non_release"
|
|
12
|
-
|
|
13
|
-
(
|
|
14
|
-
cd "$tmpdir"
|
|
15
|
-
node "$BRIK" init
|
|
16
|
-
test -f .brik/manifest.json
|
|
17
|
-
test ! -f AGENTS.md
|
|
18
|
-
)
|
|
19
|
-
|
|
20
|
-
cat >"$tmpdir/program.pcd" <<'PCD'
|
|
21
|
-
program sample
|
|
22
|
-
monomer ADD
|
|
23
|
-
PCD
|
|
24
|
-
|
|
25
|
-
if node "$BRIK" emit "$tmpdir/program.pcd" >/tmp/brik-emit.out 2>/tmp/brik-emit.err; then
|
|
26
|
-
echo "emit should require certificate" >&2
|
|
27
|
-
exit 1
|
|
28
|
-
fi
|
|
29
|
-
grep -q "certificate_required" /tmp/brik-emit.err
|
|
30
|
-
|
|
31
|
-
node "$BRIK" certify "$tmpdir/program.pcd"
|
|
32
|
-
node "$BRIK" emit "$tmpdir/program.pcd" | grep -q "pcd_sha256="
|
|
33
|
-
|
|
34
|
-
for target in ts rust python; do
|
|
35
|
-
out="$tmpdir/out-$target"
|
|
36
|
-
node "$BRIK" emit "$tmpdir/program.pcd" --target "$target" --out "$out" --tests >/tmp/brik-emit-$target.out
|
|
37
|
-
grep -q "generated=" "/tmp/brik-emit-$target.out"
|
|
38
|
-
grep -q "tests=" "/tmp/brik-emit-$target.out"
|
|
39
|
-
done
|
|
40
|
-
|
|
41
|
-
test -f "$tmpdir/out-ts/program.ts"
|
|
42
|
-
test -f "$tmpdir/out-ts/program.test.ts"
|
|
43
|
-
test -f "$tmpdir/out-rust/program.rs"
|
|
44
|
-
test -f "$tmpdir/out-rust/program_test.rs"
|
|
45
|
-
test -f "$tmpdir/out-python/program.py"
|
|
46
|
-
test -f "$tmpdir/out-python/test_program.py"
|
|
47
|
-
|
|
48
|
-
if node "$BRIK" emit "$tmpdir/program.pcd" --target go --out "$tmpdir/out-go" --tests >/tmp/brik-emit-go.out 2>/tmp/brik-emit-go.err; then
|
|
49
|
-
echo "unsupported target should fail closed" >&2
|
|
50
|
-
exit 1
|
|
51
|
-
fi
|
|
52
|
-
grep -q "unsupported_target" /tmp/brik-emit-go.err
|
|
53
|
-
|
|
54
|
-
echo "brik64-cli bootstrap smoke: PASS"
|