@namewta/speculo 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/README.md +1 -1
- package/dist/src/kernel.d.ts +23 -2
- package/dist/src/kernel.js +9 -0
- package/dist/src/kernel.js.map +1 -1
- package/dist/src/ops-resources.d.ts +3 -0
- package/dist/src/ops-resources.js +188 -0
- package/dist/src/ops-resources.js.map +1 -0
- package/dist/src/refresh.js +20 -2
- package/dist/src/refresh.js.map +1 -1
- package/dist/src/structured.js +7 -0
- package/dist/src/structured.js.map +1 -1
- package/dist/src/workflows.js +1 -1
- package/dist/src/workflows.js.map +1 -1
- package/package.json +1 -1
- package/template/.speculo/README.md +3 -3
- package/template/.speculo/kernel/README.md +3 -0
- package/template/.speculo/kernel/checkpoint.schema.json +138 -4
- package/template/commands/archive-and-consolidate.md +5 -1
- package/template/commands/status.md +2 -2
- package/template/workflows/ops/D-project-deploy/D-project-deploy.md +34 -0
- package/template/workflows/ops/H-host-manage/H-host-manage.md +30 -0
- package/template/workflows/ops/I-initialize/I-initialize.md +28 -0
- package/template/workflows/ops/INDEX.md +15 -17
- package/template/workflows/ops/README.md +59 -93
- package/template/workflows/ops/_state/status.json +15 -3
- package/template/workflows/ops/common/CAPABILITIES.md +23 -0
- package/template/workflows/ops/common/USAGE.md +112 -0
- package/template/workflows/ops/common/examples/README.md +7 -0
- package/template/workflows/ops/common/examples/binding.example.json +12 -0
- package/template/workflows/ops/common/examples/compose-app.example.json +56 -0
- package/template/workflows/ops/common/examples/credential.example.json +9 -0
- package/template/workflows/ops/common/examples/environment-request.example.json +7 -0
- package/template/workflows/ops/common/examples/register.example.json +44 -0
- package/template/workflows/ops/common/examples/shared-allocation.example.json +37 -0
- package/template/workflows/ops/common/rules/activation-and-memory.md +5 -20
- package/template/workflows/ops/common/rules/persistence-and-secrets.md +27 -0
- package/template/workflows/ops/common/rules/recovery.md +15 -0
- package/template/workflows/ops/common/rules/shared-services.md +13 -0
- package/template/workflows/ops/common/schemas/allocation.schema.json +92 -0
- package/template/workflows/ops/common/schemas/approval.schema.json +41 -21
- package/template/workflows/ops/common/schemas/binding.schema.json +73 -0
- package/template/workflows/ops/common/schemas/deployment.schema.json +244 -0
- package/template/workflows/ops/common/schemas/host.schema.json +88 -0
- package/template/workflows/ops/common/schemas/plan.schema.json +1573 -0
- package/template/workflows/ops/common/schemas/project.schema.json +55 -11
- package/template/workflows/ops/common/schemas/spec.schema.json +1032 -0
- package/template/workflows/ops/common/schemas/status.schema.json +758 -17
- package/template/workflows/ops/common/service-profiles/custom.md +5 -0
- package/template/workflows/ops/common/service-profiles/docker-engine.md +11 -0
- package/template/workflows/ops/common/service-profiles/minio.md +7 -0
- package/template/workflows/ops/common/service-profiles/mysql.md +7 -0
- package/template/workflows/ops/common/service-profiles/redis.md +7 -0
- package/template/workflows/ops/common/templates/CONTROLLER-RECORD.md +13 -0
- package/template/workflows/ops/common/templates/EXECUTION-PLAN.md +15 -0
- package/template/workflows/ops/common/templates/HOST-README.md +11 -0
- package/template/workflows/ops/common/templates/PROJECT-README.md +15 -0
- package/template/workflows/ops/common/tests/test_ops.mjs +752 -0
- package/template/workflows/ops/common/tools/bootstrap.ps1 +18 -0
- package/template/workflows/ops/common/tools/bootstrap.sh +27 -0
- package/template/workflows/ops/common/tools/demo-local.mjs +101 -0
- package/template/workflows/ops/common/tools/ops.mjs +4 -0
- package/template/workflows/ops/common/tools/opslib/agent.mjs +873 -0
- package/template/workflows/ops/common/tools/opslib/cli.mjs +311 -0
- package/template/workflows/ops/common/tools/opslib/core.mjs +393 -0
- package/template/workflows/ops/common/tools/opslib/docs.mjs +252 -0
- package/template/workflows/ops/common/tools/opslib/execution.mjs +378 -0
- package/template/workflows/ops/common/tools/opslib/host_recipes.mjs +109 -0
- package/template/workflows/ops/common/tools/opslib/model.mjs +272 -0
- package/template/workflows/ops/common/tools/opslib/native_windows.mjs +36 -0
- package/template/workflows/ops/common/tools/opslib/planner.mjs +687 -0
- package/template/workflows/ops/common/tools/opslib/services.mjs +76 -0
- package/template/workflows/ops/common/tools/opslib/sources.mjs +56 -0
- package/template/workflows/ops/common/tools/opslib/transport.mjs +127 -0
- package/template/workflows/ops/common/tools/validate-ops.mjs +43 -1012
- package/template/workflows/ops/manifest.json +60 -1
- package/template/workflows/ops/runtime-contract.json +1 -6
- package/template/workflows/ops/A-archive-and-learn/A-archive-and-learn.md +0 -73
- package/template/workflows/ops/A-archive-and-learn/promotion-plan-template.md +0 -41
- package/template/workflows/ops/A-archive-and-learn/retrospective-template.md +0 -53
- package/template/workflows/ops/E-execute-and-stabilize/E-execute-and-stabilize.md +0 -82
- package/template/workflows/ops/E-execute-and-stabilize/attempt-summary-template.md +0 -44
- package/template/workflows/ops/E-execute-and-stabilize/diagnosis-template.md +0 -24
- package/template/workflows/ops/E-execute-and-stabilize/handoff-template.md +0 -32
- package/template/workflows/ops/E-execute-and-stabilize/rollback-template.md +0 -26
- package/template/workflows/ops/E-execute-and-stabilize/verification-state-template.json +0 -30
- package/template/workflows/ops/E-execute-and-stabilize/verification-template.md +0 -55
- package/template/workflows/ops/H-computer-hygiene/H-computer-hygiene.md +0 -105
- package/template/workflows/ops/H-computer-hygiene/examples/README.md +0 -9
- package/template/workflows/ops/H-computer-hygiene/examples/linux/2026-09-14.environment.md +0 -45
- package/template/workflows/ops/H-computer-hygiene/examples/linux/2026-09-14.json +0 -970
- package/template/workflows/ops/H-computer-hygiene/examples/linux/2026-09-14.md +0 -216
- package/template/workflows/ops/H-computer-hygiene/examples/macos/2026-09-14.environment.md +0 -45
- package/template/workflows/ops/H-computer-hygiene/examples/macos/2026-09-14.json +0 -970
- package/template/workflows/ops/H-computer-hygiene/examples/macos/2026-09-14.md +0 -216
- package/template/workflows/ops/H-computer-hygiene/examples/windows/2026-09-14.environment.md +0 -45
- package/template/workflows/ops/H-computer-hygiene/examples/windows/2026-09-14.json +0 -969
- package/template/workflows/ops/H-computer-hygiene/examples/windows/2026-09-14.md +0 -216
- package/template/workflows/ops/H-computer-hygiene/references/00-sources.md +0 -58
- package/template/workflows/ops/H-computer-hygiene/references/01-safety.md +0 -52
- package/template/workflows/ops/H-computer-hygiene/references/10-windows.md +0 -47
- package/template/workflows/ops/H-computer-hygiene/references/11-macos.md +0 -46
- package/template/workflows/ops/H-computer-hygiene/references/12-linux.md +0 -13
- package/template/workflows/ops/H-computer-hygiene/references/20-toolchains.md +0 -83
- package/template/workflows/ops/H-computer-hygiene/references/21-path-migration.md +0 -64
- package/template/workflows/ops/H-computer-hygiene/references/22-repositories.md +0 -35
- package/template/workflows/ops/H-computer-hygiene/references/30-software-removal.md +0 -41
- package/template/workflows/ops/H-computer-hygiene/references/40-report-spec.md +0 -54
- package/template/workflows/ops/H-computer-hygiene/references/50-speculo-integration.md +0 -26
- package/template/workflows/ops/H-computer-hygiene/references/source-register.json +0 -406
- package/template/workflows/ops/H-computer-hygiene/rules/catalog.json +0 -191
- package/template/workflows/ops/H-computer-hygiene/scripts/hygiene.py +0 -1348
- package/template/workflows/ops/H-computer-hygiene/scripts/run.ps1 +0 -7
- package/template/workflows/ops/H-computer-hygiene/scripts/run.sh +0 -5
- package/template/workflows/ops/H-computer-hygiene/templates/config.example.json +0 -13
- package/template/workflows/ops/H-computer-hygiene/templates/maven-settings.fragment.xml +0 -6
- package/template/workflows/ops/H-computer-hygiene/templates/native-evidence.example.json +0 -19
- package/template/workflows/ops/H-computer-hygiene/tests/cli_smoke.py +0 -65
- package/template/workflows/ops/H-computer-hygiene/tests/make_examples.py +0 -114
- package/template/workflows/ops/H-computer-hygiene/tests/test_hygiene.py +0 -486
- package/template/workflows/ops/I-intake-and-assess/I-intake-and-assess.md +0 -73
- package/template/workflows/ops/I-intake-and-assess/change-status-template.json +0 -26
- package/template/workflows/ops/I-intake-and-assess/collector-catalog.md +0 -28
- package/template/workflows/ops/I-intake-and-assess/deployment-dossier-template.md +0 -62
- package/template/workflows/ops/I-intake-and-assess/global-change-status-template.json +0 -26
- package/template/workflows/ops/I-intake-and-assess/project-detection.md +0 -38
- package/template/workflows/ops/I-intake-and-assess/request-template.md +0 -44
- package/template/workflows/ops/I-intake-and-assess/system-report-template.md +0 -34
- package/template/workflows/ops/I-intake-and-assess/target-profile-template.json +0 -24
- package/template/workflows/ops/P-plan-and-approve/P-plan-and-approve.md +0 -72
- package/template/workflows/ops/P-plan-and-approve/plan-review-template.md +0 -78
- package/template/workflows/ops/_state/archive/.gitkeep +0 -1
- package/template/workflows/ops/_state/changes/.gitkeep +0 -1
- package/template/workflows/ops/common/rules/artifact-contract.md +0 -38
- package/template/workflows/ops/common/rules/closure-and-learning.md +0 -27
- package/template/workflows/ops/common/rules/evidence-and-redaction.md +0 -22
- package/template/workflows/ops/common/rules/execution-loop.md +0 -27
- package/template/workflows/ops/common/rules/path-and-scope-contract.md +0 -21
- package/template/workflows/ops/common/rules/plan-and-approval.md +0 -25
- package/template/workflows/ops/common/rules/project-and-change-scope.md +0 -20
- package/template/workflows/ops/common/rules/target-profile-and-release-gates.md +0 -44
- package/template/workflows/ops/common/schemas/attempt.schema.json +0 -42
- package/template/workflows/ops/common/schemas/change-status.schema.json +0 -43
- package/template/workflows/ops/common/schemas/deployment-model.schema.json +0 -26
- package/template/workflows/ops/common/schemas/implementation-plan.schema.json +0 -221
- package/template/workflows/ops/common/schemas/inventory-snapshot.schema.json +0 -31
- package/template/workflows/ops/common/schemas/journal-event.schema.json +0 -22
- package/template/workflows/ops/common/schemas/promotion-approval.schema.json +0 -20
- package/template/workflows/ops/common/schemas/promotion-manifest.schema.json +0 -22
- package/template/workflows/ops/common/schemas/target-profile.schema.json +0 -32
- package/template/workflows/ops/common/schemas/verification-state.schema.json +0 -30
- package/template/workflows/ops/common/tools/close-change.mjs +0 -177
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# Linux Docker Engine 准备合同
|
|
2
|
+
|
|
3
|
+
本版不从互联网猜最新安装命令。先读取真实发行版、架构、已有 Engine/Compose、用户和配置。缺失时由用户/Agent提供固定版本的可信安装器与包清单,安装器本地文件哈希进入计划,禁止直接执行未校验 curl 输出。
|
|
4
|
+
|
|
5
|
+
使用 H host_actions:将安装器写入 `_host/installers/<version>/`;install-toolchain 明示系统包文件/服务动作、当前默认版本与验证;write-control 合并 `/etc/docker/daemon.json`,data-root 必须是已登记 `host_root/_runtime/docker`;之后明确 restart/start、info、compose version 和权限检查。已有配置不能直接覆盖成仅含 data-root 的文件;先保存、合并并复核差异。
|
|
6
|
+
|
|
7
|
+
已有数据:生成独立维护计划,列所有容器/消费者,验证一致备份,停机,保留旧目录,显式复制/校验/切换/启动/验证。不能“为了规范”直接删除 /var/lib/docker。Rootless 有不同 daemon/config 权限,需显式适配,不冒充 rootful。
|
|
8
|
+
|
|
9
|
+
Docker Desktop 和隐藏 VM 不能通过在 Windows 创建 C:\Ops\_runtime\docker 就满足真实根;严格模式不接受这类假配置。使用实际 Linux/WSL Engine 主机,或先实施并验证对应平台 adapter。
|
|
10
|
+
|
|
11
|
+
D 会读取 daemon ID/context/endpoint/data-root/Compose 版本,固定实际 daemon,只接受 unix/npipe 本机端点,拒绝 remote context 偷连另一台机器。容器镜像必须 image@sha256,Compose>=2.30,根文件系统只读,全部业务数据显式 bind。
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# minio 服务档案
|
|
2
|
+
|
|
3
|
+
提供者独立 minio-main 项目,service_type=minio,service.endpoint 是实际管理员端点;对象数据在 data/minio/objects,实例卷数和恢复方式根据真实拓扑确定,不机械套单盘模板。
|
|
4
|
+
|
|
5
|
+
内置分配使用用户指定并核验版本的 mc client_path,以 MC_HOST_ops 进程环境传管理员凭据;每 APP 一个桶、最小桶策略和应用身份。mc admin user add 的新应用密码位于子进程参数,需 allow_secret_argv=true 显式确认特权进程查看风险;不接受该边界时使用既有资源的实际验证模式。
|
|
6
|
+
|
|
7
|
+
删除 APP 不删除桶或公共实例。桶级恢复需实际版本/复制/版本控制策略,不能把复制 APP 根当作对象数据备份。
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# mysql 服务档案
|
|
2
|
+
|
|
3
|
+
提供者是独立 mysql-main 项目,service_type=mysql,method=compose,service.compose_service 必须是实际服务名。image 固定摘要。数据在 data/mysql/instance,容器 /var/lib/mysql 显式 bind;镜像声明的其他 VOLUME 必须根据实际 inspect 映射。创建目录的 uid/gid 与所用镜像一致,不猜所有版本相同。
|
|
4
|
+
|
|
5
|
+
管理员凭据登记 provider.credential_refs;应用库用 Allocation(resource_kind=database),应用账号 username/password 必须在账本中真实匹配。内置分配只允许明确本库权限,默认 SELECT/INSERT/UPDATE/DELETE;迁移用户需要 DDL 时显式授予本库所需权限,不授全局管理员。
|
|
6
|
+
|
|
7
|
+
已存在未知库/用户拒绝覆盖;密码不自动重置。数据备份使用该版本可验证的一致性逻辑/物理工具;单 APP 回滚不得恢复整个实例。
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# redis 服务档案
|
|
2
|
+
|
|
3
|
+
提供者独立 redis-main 项目,service_type=redis,service.compose_service 指向实际服务。数据在 data/redis/instance;ACL 文件配置为 data/redis/acl/users.acl(service.acl_persistence 必须完全匹配),容器 ACL 写入路径必须映射到这个项目数据目录,不能将 ACL SAVE 写到只读 config。
|
|
4
|
+
|
|
5
|
+
每个 APP 使用不同 ACL username、prefix 和凭据;禁用/限制危险管理命令,内置分配使用受限命令类别。必须核验真实客户端兼容性、ACL SAVE 和新账号认证。prefix/数字 DB 不等于独立内存/CPU/备份恢复边界;要求强隔离时部署专用实例。
|
|
6
|
+
|
|
7
|
+
持久化 AOF/RDB 属于业务数据不是可随意清理的日志。公共实例恢复影响所有消费者,需要整体维护批准。
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# APP / 服务部署记录
|
|
2
|
+
|
|
3
|
+
此文件是内容合同,不含真实密码;实际生成器依据成功回执填入真实值,不把占位符当交付。
|
|
4
|
+
|
|
5
|
+
## 部署实例、主机、账户、来源与固定构件
|
|
6
|
+
|
|
7
|
+
## observed_version 与首次/最近 UTC 部署时间
|
|
8
|
+
|
|
9
|
+
## 项目根、compose/service、env、config、data/component/purpose、logs、backups
|
|
10
|
+
|
|
11
|
+
## 依赖 provider、逻辑资源、物理路径、网络与备份归属
|
|
12
|
+
|
|
13
|
+
## 启动、停止、查看、更新、迁移、回滚步骤
|
|
14
|
+
|
|
15
|
+
## 最后运行与双边文档回执;默认不写密码
|