| name | init |
| description | Initialize or inspect a Hypo-Workflow workspace using the manifest-based format. Use for /hw:init when starting a repository, adopting an existing codebase, or checking whether legacy state can be adopted safely. |
Init Workspace Adoption
输出语言规则
用户可见内容遵循项目 output.language；缺失时跟随当前对话语言。Schema key、配置 key、命令和路径保持英文。
Init creates a recoverable bootstrap context, not a Goal or Cycle. Init has no user-global configuration or setup prerequisite.
Import initializeWorkspace from this installed bundle's core/src/index.js and pass the target project separately as root. Every mutation uses a unique safe final { id } transaction option.
Input
Use:
initializeWorkspace(root, { intent?, project_id?, workspace_id? }, { id?, faultInjector? })
The ordinary form is /hw:init <intended outcome>. Treat trailing text as the intended project outcome.
When no non-empty outcome is supplied, return the single init_outcome question and ask what the project should achieve. This branch is read-only. After the answer, summarize the understood outcome; that answer authorizes Init only, not a Goal, Cycle, or implementation.
Workspace Classes
| Classification | Behavior |
|---|
empty | Initialize the manifest format transactionally from the supplied outcome. |
unmanaged_brownfield | Read bounded safe repository evidence, create an Adoption Brief, then initialize transactionally. |
current | Report already_initialized and make no write. |
mixed_current_with_legacy_residue | Report residue without rewriting either model. |
legacy | Run inspectLegacyWorkspace read-only; migration is a separate future action. |
damaged_current | Fail closed with concrete repair evidence. Never call a legacy writer. |
Successful Initialization
A manifest-last transaction creates:
.pipeline/manifest.yaml with runtime, memory, and snapshot zones- a reference-only
runtime/active.yaml pointer to a bootstrap_job
- bootstrap Runtime and Continuation objects
project_intent and adoption_brief Markdown Records- derived machine and human Record indexes
- a derived Context Capsule
initial_snapshot is null. Init does not fabricate a Goal, Cycle, Receipt, Journal event, Recovery Pack, accepted Snapshot, platform adapter, generic Rules store, or global configuration.
For brownfield adoption, every fact records basis, confidence, and an existing repository-relative locator. Inference is never labeled confirmed. Preserve source bytes and mtimes.
Safety And Report
Reject traversal, symlink evidence, secret-like values, raw credentials, and hidden reasoning before persistence. Errors must not echo rejected secrets. Preserve all repository files outside the staged .pipeline write set.
Explain the workspace classification, project/workspace identity, bootstrap reference, Adoption Brief facts and confidence, and the next useful public route in chat. For legacy or damaged workspaces, explain why no write occurred and what evidence or repair is needed.
