aimship 0.0.0-stage → 0.1.0-preview.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.
Files changed (48) hide show
  1. package/CONTRIBUTING.md +33 -0
  2. package/LICENSE +21 -0
  3. package/README.md +89 -2
  4. package/README.zh-CN.md +90 -0
  5. package/bin/aimship.mjs +17 -0
  6. package/docs/cli.md +82 -0
  7. package/docs/examples.md +5 -0
  8. package/docs/guide.md +277 -0
  9. package/docs/guide.zh-CN.md +277 -0
  10. package/docs/installation.md +24 -0
  11. package/lib/cli.mjs +171 -0
  12. package/lib/documents.mjs +155 -0
  13. package/lib/install.mjs +363 -0
  14. package/lib/io.mjs +55 -0
  15. package/lib/migrate.mjs +77 -0
  16. package/lib/state.mjs +276 -0
  17. package/lib/view.mjs +69 -0
  18. package/package.json +43 -4
  19. package/skills/aimship/SKILL.md +19 -0
  20. package/skills/aimship/agents/openai.yaml +6 -0
  21. package/skills/aimship/references/artifact-map.json +163 -0
  22. package/skills/aimship/references/core.md +88 -0
  23. package/skills/aimship/references/document-patterns.md +39 -0
  24. package/skills/aimship/references/hosts.md +17 -0
  25. package/skills/aimship/references/recovery.md +21 -0
  26. package/skills/aimship/references/sources-and-changes.md +34 -0
  27. package/skills/aimship/references/stages/contract.md +23 -0
  28. package/skills/aimship/references/stages/diagnose.md +25 -0
  29. package/skills/aimship/references/stages/frame.md +23 -0
  30. package/skills/aimship/references/stages/handoff.md +23 -0
  31. package/skills/aimship/references/stages/implement.md +25 -0
  32. package/skills/aimship/references/stages/plan.md +23 -0
  33. package/skills/aimship/references/stages/prototype.md +23 -0
  34. package/skills/aimship/references/stages/requirements.md +23 -0
  35. package/skills/aimship/references/stages/review.md +23 -0
  36. package/skills/aimship/references/stages/scope.md +23 -0
  37. package/skills/aimship/references/stages/tech-design.md +25 -0
  38. package/skills/aimship/references/stages/test-design.md +23 -0
  39. package/skills/aimship/references/stages/verify.md +25 -0
  40. package/skills/aimship/references/templates/change-log.md +14 -0
  41. package/skills/aimship/references/templates/diagnosis.md +39 -0
  42. package/skills/aimship/references/templates/handoff.md +34 -0
  43. package/skills/aimship/references/templates/plan.md +34 -0
  44. package/skills/aimship/references/templates/prd.md +39 -0
  45. package/skills/aimship/references/templates/review.md +19 -0
  46. package/skills/aimship/references/templates/scope.md +39 -0
  47. package/skills/aimship/references/templates/tech-design.md +39 -0
  48. package/skills/aimship/references/templates/testing.md +34 -0
@@ -0,0 +1,34 @@
1
+ # handoff
2
+
3
+ Delivery: <deliveryId from init>; document revision: <revision>.
4
+
5
+ <a id="goals"></a>
6
+ ## Current goal comparison
7
+
8
+ REQ/AC and actual results, including explicit goal changes. Replace guidance with actual content; explain inapplicability, never prefill a result.
9
+
10
+ <a id="artifacts"></a>
11
+ ## Artifacts, repositories and versions
12
+
13
+ Links, actual checkout/worktree, branch/commit and uncommitted paths; no Git uses file digests. Replace guidance with actual content; explain inapplicability, never prefill a result.
14
+
15
+ <a id="usage"></a>
16
+ ## Usage
17
+
18
+ Actual commands and entry points. Replace guidance with actual content; explain inapplicability, never prefill a result.
19
+
20
+ <a id="results"></a>
21
+ ## Review and verification
22
+
23
+ Scopes, versions, results and evidence. Replace guidance with actual content; explain inapplicability, never prefill a result.
24
+
25
+ <a id="limits"></a>
26
+ ## Limitations and remaining work
27
+
28
+ Unverified work and recovery conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
29
+
30
+ <a id="outcomes"></a>
31
+ ## Acceptance, integration, release and continuation
32
+
33
+ Independent facts; prepared version is not a release. Replace guidance with actual content; explain inapplicability, never prefill a result.
34
+
@@ -0,0 +1,34 @@
1
+ # plan
2
+
3
+ Delivery: <deliveryId from init>; document revision: <revision>.
4
+
5
+ <a id="basis"></a>
6
+ ## Implementation basis and scope
7
+
8
+ Current requirements, design, contracts and actual repositories. Replace guidance with actual content; explain inapplicability, never prefill a result.
9
+
10
+ <a id="batches"></a>
11
+ ## Batches and dependencies
12
+
13
+ B ID, goal, dependencies and integration arrangement. Replace guidance with actual content; explain inapplicability, never prefill a result.
14
+
15
+ <a id="tasks"></a>
16
+ ## Tasks and completion criteria
17
+
18
+ TASK, batch, REQ/AC or risk, repository ID, file/module, planned change, completion criteria, status, artifact ref. Replace guidance with actual content; explain inapplicability, never prefill a result.
19
+
20
+ <a id="validation"></a>
21
+ ## Review and independent verification arrangement
22
+
23
+ Each batch review, overall review then independent verification; no per-batch full test gates. Replace guidance with actual content; explain inapplicability, never prefill a result.
24
+
25
+ <a id="execution"></a>
26
+ ## Task status and execution records
27
+
28
+ Actual changes and object versions by TASK/B; preserve original plan and distinguish pre-existing changes. Replace guidance with actual content; explain inapplicability, never prefill a result.
29
+
30
+ <a id="remaining"></a>
31
+ ## Deviations, blockers and remaining work
32
+
33
+ Unfinished effects and recovery, not a second stage ledger. Replace guidance with actual content; explain inapplicability, never prefill a result.
34
+
@@ -0,0 +1,39 @@
1
+ # prd
2
+
3
+ Delivery: <deliveryId from init>; document revision: <revision>.
4
+
5
+ <a id="info"></a>
6
+ ## Document information and sources
7
+
8
+ Identify this delivery, revision and adopted inputs. Replace guidance with actual content; explain inapplicability, never prefill a result.
9
+
10
+ <a id="goals"></a>
11
+ ## Background, goals and non-goals
12
+
13
+ Separate known facts, requirements and assumptions. Replace guidance with actual content; explain inapplicability, never prefill a result.
14
+
15
+ <a id="scope"></a>
16
+ ## Scope, engineering objects and endpoint
17
+
18
+ Included/excluded work, repository IDs, authorization and endpoint. Replace guidance with actual content; explain inapplicability, never prefill a result.
19
+
20
+ <a id="requirements"></a>
21
+ ## Requirements and behavior
22
+
23
+ REQ, type, actor/object, trigger/precondition, behavior, observable result, boundaries/errors, source and AC. Shared business rules, access control (even one role), performance and reliability need independent identity when independently testable. Replace guidance with actual content; explain inapplicability, never prefill a result.
24
+
25
+ <a id="states"></a>
26
+ ## States, interaction and recovery
27
+
28
+ Allowed transitions, terminal states, errors and recovery; say why inapplicable. Replace guidance with actual content; explain inapplicability, never prefill a result.
29
+
30
+ <a id="acceptance"></a>
31
+ ## Acceptance criteria
32
+
33
+ AC, requirement reference, condition, operation, decidable expected result. Replace guidance with actual content; explain inapplicability, never prefill a result.
34
+
35
+ <a id="arrangement"></a>
36
+ ## Dependencies, questions and stage arrangement
37
+
38
+ Selected order, artifact locations/reuse, dependencies, Q with impact/status/decision source. Replace guidance with actual content; explain inapplicability, never prefill a result.
39
+
@@ -0,0 +1,19 @@
1
+ # review
2
+
3
+ Delivery: <deliveryId from init>; document revision: <revision>.
4
+
5
+ <a id="basis"></a>
6
+ ## Review basis and scope
7
+
8
+ Exact repositories/objects, baseline and differences. Replace guidance with actual content; explain inapplicability, never prefill a result.
9
+
10
+ <a id="reviews"></a>
11
+ ## Review records
12
+
13
+ REV, batch/overall/repair scope, TASK/REQ/AC, reviewer/date, findings, dispositions and recheck conclusions. Replace guidance with actual content; explain inapplicability, never prefill a result.
14
+
15
+ <a id="conclusion"></a>
16
+ ## Open findings and current conclusion
17
+
18
+ Preserve historical findings and old object basis; review is not execution. Replace guidance with actual content; explain inapplicability, never prefill a result.
19
+
@@ -0,0 +1,39 @@
1
+ # scope
2
+
3
+ Delivery: <deliveryId from init>; document revision: <revision>.
4
+
5
+ <a id="info"></a>
6
+ ## Document information and source versions
7
+
8
+ Delivery identity and adopted versions. Replace guidance with actual content; explain inapplicability, never prefill a result.
9
+
10
+ <a id="goals"></a>
11
+ ## Goal, engineering objects and endpoint
12
+
13
+ Actual repository IDs, authorized objects and endpoint. Replace guidance with actual content; explain inapplicability, never prefill a result.
14
+
15
+ <a id="adoption"></a>
16
+ ## Source mapping and adopted scope
17
+
18
+ Source/version/original ID or section, adoption decision, requirement reference, AC and gaps; do not copy the full PRD. Replace guidance with actual content; explain inapplicability, never prefill a result.
19
+
20
+ <a id="exclusions"></a>
21
+ ## Exclusions and constraints
22
+
23
+ Explicitly delimit this commission. Replace guidance with actual content; explain inapplicability, never prefill a result.
24
+
25
+ <a id="decisions"></a>
26
+ ## Conflicts, gaps and supplementary decisions
27
+
28
+ Preserve sources; identify decision authority and pending source updates. Replace guidance with actual content; explain inapplicability, never prefill a result.
29
+
30
+ <a id="acceptance"></a>
31
+ ## Acceptance basis
32
+
33
+ AC, requirement/source identity, conditions, actions and expected results. Replace guidance with actual content; explain inapplicability, never prefill a result.
34
+
35
+ <a id="arrangement"></a>
36
+ ## Authorization, questions and stage arrangement
37
+
38
+ Selected order, artifact locations/reuse, permissions and open Q. Replace guidance with actual content; explain inapplicability, never prefill a result.
39
+
@@ -0,0 +1,39 @@
1
+ # tech-design
2
+
3
+ Delivery: <deliveryId from init>; document revision: <revision>.
4
+
5
+ <a id="basis"></a>
6
+ ## Basis and engineering context
7
+
8
+ Current requirements and actual engineering constraints. Replace guidance with actual content; explain inapplicability, never prefill a result.
9
+
10
+ <a id="architecture"></a>
11
+ ## Architecture and key flows
12
+
13
+ Ordered explanation or diagram of the important flow. Replace guidance with actual content; explain inapplicability, never prefill a result.
14
+
15
+ <a id="modules"></a>
16
+ ## Modules and interaction implementation
17
+
18
+ Repository ID, responsibility, actual path, new/change, requirement refs; entry/state/data flow for interaction. Replace guidance with actual content; explain inapplicability, never prefill a result.
19
+
20
+ <a id="data"></a>
21
+ ## Data, interfaces and SQL
22
+
23
+ Structures, indexes, consistency, contract authority, database type/version/schema basis, SQL order and execution boundary. Replace guidance with actual content; explain inapplicability, never prefill a result.
24
+
25
+ <a id="errors"></a>
26
+ ## Errors and nonfunctional design
27
+
28
+ Recovery, access, performance, observability, cache/messages when relevant. Replace guidance with actual content; explain inapplicability, never prefill a result.
29
+
30
+ <a id="risks"></a>
31
+ ## Tradeoffs and risks
32
+
33
+ Reasons, alternatives, compatibility and technical risks. Replace guidance with actual content; explain inapplicability, never prefill a result.
34
+
35
+ <a id="coverage"></a>
36
+ ## Requirement coverage and questions
37
+
38
+ REQ/AC to module/operation/SQL section and unresolved Q. Replace guidance with actual content; explain inapplicability, never prefill a result.
39
+
@@ -0,0 +1,34 @@
1
+ # testing
2
+
3
+ Delivery: <deliveryId from init>; document revision: <revision>.
4
+
5
+ <a id="basis"></a>
6
+ ## Basis and scope
7
+
8
+ Current AC and risks; adopted cases location/version if verify-only. Replace guidance with actual content; explain inapplicability, never prefill a result.
9
+
10
+ <a id="environment"></a>
11
+ ## Environment, data and execution conditions
12
+
13
+ Tools, permissions, commands and unavailable conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
14
+
15
+ <a id="cases"></a>
16
+ ## Test cases
17
+
18
+ TC, case version, REQ/AC or risk, type/level, preconditions, operations, concrete expected result, method/entry. Replace guidance with actual content; explain inapplicability, never prefill a result.
19
+
20
+ <a id="coverage"></a>
21
+ ## Coverage and verification arrangement
22
+
23
+ AC, requirements, TC, gaps and execution group/order. Replace guidance with actual content; explain inapplicability, never prefill a result.
24
+
25
+ <a id="runs"></a>
26
+ ## Execution and retest records
27
+
28
+ RUN, TC@version, exact code/build or document object, command/operation, assertions, actual results and evidence. Not executed until actually run; append failures/retests. Replace guidance with actual content; explain inapplicability, never prefill a result.
29
+
30
+ <a id="conclusion"></a>
31
+ ## Defects, current conclusion and remaining work
32
+
33
+ Separate passed, failed, blocked and unexecuted; explain applicability after change. Replace guidance with actual content; explain inapplicability, never prefill a result.
34
+