donna 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

donna/{world → workspaces}/worlds/python.py

@@ -7,14 +7,14 @@ from donna.core.errors import ErrorsList
 from donna.core.result import Err, Ok, Result, unwrap_to_error
 from donna.domain.ids import ArtifactId, FullArtifactId, FullArtifactIdPattern, WorldId
 from donna.machine.artifacts import Artifact
-from donna.world import errors as world_errors
-from donna.world.artifacts import ArtifactRenderContext
-from donna.world.artifacts_discovery import ArtifactListingNode, list_artifacts_by_pattern
-from donna.world.worlds.base import World as BaseWorld
-from donna.world.worlds.base import WorldConstructor
+from donna.workspaces import errors as world_errors
+from donna.workspaces.artifacts import ArtifactRenderContext
+from donna.workspaces.artifacts_discovery import ArtifactListingNode, list_artifacts_by_pattern
+from donna.workspaces.worlds.base import World as BaseWorld
+from donna.workspaces.worlds.base import WorldConstructor
 
 if TYPE_CHECKING:
-    from donna.world.config import SourceConfigValue, WorldConfig
+    from donna.workspaces.config import SourceConfigValue, WorldConfig
 
 
 class Python(BaseWorld):
@@ -59,7 +59,7 @@ class Python(BaseWorld):
         if not resource_dir.is_dir():
             return Ok(None)
 
-        from donna.world.config import config
+        from donna.workspaces.config import config
 
         supported_extensions = config().supported_extensions()
         matches = [
@@ -81,7 +81,7 @@ class Python(BaseWorld):
     def _get_source_by_filename(
         self, artifact_id: ArtifactId, filename: str
     ) -> Result["SourceConfigValue", ErrorsList]:
-        from donna.world.config import config
+        from donna.workspaces.config import config
 
         extension = pathlib.Path(filename).suffix
         source_config = config().find_source_for_extension(extension)
@@ -115,7 +115,7 @@ class Python(BaseWorld):
         full_id = FullArtifactId((self.id, artifact_id))
 
         extension = pathlib.Path(resource_path.name).suffix
-        from donna.world.config import config
+        from donna.workspaces.config import config
 
         source_config = config().find_source_for_extension(extension)
         if source_config is None:
@@ -142,6 +142,9 @@ class Python(BaseWorld):
     def update(self, artifact_id: ArtifactId, content: bytes, extension: str) -> Result[None, ErrorsList]:
         return Err([world_errors.WorldReadonly(world_id=self.id)])
 
+    def remove(self, artifact_id: ArtifactId) -> Result[None, ErrorsList]:
+        return Err([world_errors.WorldReadonly(world_id=self.id)])
+
     @unwrap_to_error
     def file_extension_for(self, artifact_id: ArtifactId) -> Result[str, ErrorsList]:
         resource_path = self._resolve_artifact_file(artifact_id).unwrap()

{donna-0.2.0.dist-info → donna-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: donna
-Version: 0.2.0
+Version: 0.2.1
 Summary: A deterministic workflow and state orchestration engine for LLM agents.
 License-Expression: BSD-3-Clause
 License-File: LICENSE
@@ -11,6 +11,7 @@ Requires-Python: >=3.12,<4.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3 :: Only
@@ -20,7 +21,9 @@ Requires-Dist: jinja2 (>=3.1,<3.2)
 Requires-Dist: markdown-it-py (>=4.0,<4.1)
 Requires-Dist: mdformat (>=1.0.0,<1.1.0)
 Requires-Dist: pydantic (>=2.12,<2.13)
+Requires-Dist: tomli-w (>=1.2,<1.3)
 Requires-Dist: typer (>=0.20,<0.21)
+Project-URL: Changelog, https://github.com/Tiendil/donna/blob/main/CHANGELOG.md
 Project-URL: Homepage, https://github.com/Tiendil/donna
 Project-URL: Issues, https://github.com/Tiendil/donna/issues
 Project-URL: Repository, https://github.com/Tiendil/donna

donna-0.2.1.dist-info/RECORD

@@ -0,0 +1,92 @@
+donna/__init__.py,sha256=lEC7l3wDCBiC5gw56XkAeBW1XJA52pck7SFR1_CUals,41
+donna/artifacts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/artifacts/intro.md,sha256=sWkuHnYLiScoux6XNeFeC8PIfZbhpLT0mk6LmKLe8MA,2141
+donna/artifacts/research/specs/report.md,sha256=yg1rrLGjzgAr5ZbezTGXbKfHshsd23mTJAZb4ZkUFDY,8576
+donna/artifacts/research/work/research.md,sha256=TacNXHhKDo2HFLigqTZJyKwgarAyIBHThUdH4Nuc4Os,7082
+donna/artifacts/rfc/specs/request_for_change.md,sha256=IXkQWfVG1l-oUvlOpWTIINoxykPzaYp8C4ZQolq_28s,12980
+donna/artifacts/rfc/work/create.md,sha256=f8bOggAQa22aIkS0i8z7rHdyqxy-SBls-ZLpMxT5PAQ,3761
+donna/artifacts/rfc/work/do.md,sha256=tifHYbwTHybjZgJ3pJBs0A748ACcITA8SKkRW5hWvp4,2949
+donna/artifacts/rfc/work/plan.md,sha256=DD4qU9aJOlJkkDAa8I1j4a6AqLCEY36xU3DqFt48-g8,2532
+donna/artifacts/usage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/artifacts/usage/artifacts.md,sha256=ZDkUnzgr583suhDFe8f2lup7VC8ocJCuDRfGKL-mWt0,13531
+donna/artifacts/usage/cli.md,sha256=hyfCtMiwN-nJUoJEpuh8goecOlk85ZAjDww0CstHn9w,10578
+donna/artifacts/usage/worlds.md,sha256=iA61-ZzS29NLxrdVQhdSF-2hpS6wGO1stlWkMkHnNDU,2078
+donna/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/cli/__main__.py,sha256=_zo9JRR0m_ggVlrSaCpwo84bo0-cR9DgnJFup1AcH5U,224
+donna/cli/application.py,sha256=rIEseTvPZgX4tZ23fTX49LF0XLfyzTO8gtpA8G80MTI,466
+donna/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/cli/commands/artifacts.py,sha256=qakcdQ_9h4ZE1Yw0xxNfA5vhxWEPRsZjA0DjJdsNvp0,6416
+donna/cli/commands/sessions.py,sha256=CqE8EocRmay3_CQGAgBwPtNffQ9KjpD7IXOOYxVW33Y,2142
+donna/cli/commands/workspaces.py,sha256=ZFTFCojhi14njRFsCIpXjUWYY_aYyLH06xLFNTRDrk4,1078
+donna/cli/errors.py,sha256=9UzGo4tINr3EEwhOu361M7ulGS-bEe7wGgVivu07Z1o,524
+donna/cli/types.py,sha256=ZWALGkmfZQ62C8Sb6nGRkSLi0g79cEM0cAUQoITn1v0,3692
+donna/cli/utils.py,sha256=rtgtCttr-txPVp1BNJYF9Nfb8zMAnBFsZ7ORsYaLsRw,1418
+donna/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/core/entities.py,sha256=Y3udcI1ykWDI_yPqCX6JTuDmF81BxO0PnnJzzD5uMoM,753
+donna/core/errors.py,sha256=jkblzdC1bk0-E5eSGiiPSSIEHPbUbz88CXPvrHdLVuU,3313
+donna/core/result.py,sha256=3QLzoRWs9ph_oGcWYbephbZjx97M_0Ayx_yFhweOcFo,2374
+donna/core/utils.py,sha256=lviOkI-aFGWMy-3_VWVdf7iKGdOsIZtEzEa-5f618mk,1141
+donna/domain/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/domain/errors.py,sha256=jewM3wYUCGLwNb8tvHkJ35-Y59ezJKgWy7pr_Utk7iA,1253
+donna/domain/ids.py,sha256=CMEBRj6i2vjVi74TtUcjLTALn3MqKsEbs-Iv463mjVg,14678
+donna/lib/__init__.py,sha256=01wddMlBwKz3gtcWiSD1rAKfhMMtsp_n90DHCplWRzI,987
+donna/lib/sources.py,sha256=VvnAsIm7V_CnQeEN7KqB5Z-5yzQOmz3TTAYpB6MxZZk,182
+donna/lib/worlds.py,sha256=w6QmpSx3gF0q71GyTdWQAKgMwT5VaMHAa_0FdNiyOnI,286
+donna/machine/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/machine/action_requests.py,sha256=BRJHHex3O0-3MT2hf66QdkaSrjCA84wKBXscr1zwVtk,1249
+donna/machine/artifacts.py,sha256=IpwVDUV3lUEuA80hHDSoRd3qcjYoDbZpPF7EO4VFi-o,6627
+donna/machine/changes.py,sha256=TlgMA70u0ffRvwKVBwXEgEk1bp4m9w9MsVxtishX9Sw,2463
+donna/machine/errors.py,sha256=45EPNC12rRT2pdgd2b9HMXCP0aon4sxo9DdUfxXeMnQ,4956
+donna/machine/operations.py,sha256=CHXPy8hDYNqE5woVMj_lu2p4wgl7fqRxO0Dz0v1t4zI,761
+donna/machine/primitives.py,sha256=ptPIO1yu4xXBNuVcnhKlOSPHfFj3Fo2kr_I8cbEbF04,3287
+donna/machine/sessions.py,sha256=TSwNP_ELAjvnPBfHdNOVi4FguZYlf3UIhcRB0qXgK5Y,7135
+donna/machine/state.py,sha256=W8mlxlH0cL91zNgOJ4dSngg-pUS7RO9J4R1ALkN782U,8121
+donna/machine/tasks.py,sha256=2dfz5AoXC0pBH7t7x2SXSfZTM7_3tMYXRjJClGJY_Xc,2175
+donna/machine/templates.py,sha256=oIlvYgpeuofq52sKtGvhlB850FQeuBIuwCkphoaOvss,2535
+donna/primitives/__init__.py,sha256=CfJhz3TLdFxYbqCXioWVAIKGQ2tAMwXwL_Fg3A68Dqo,53
+donna/primitives/artifacts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/primitives/artifacts/specification.py,sha256=SYqRHJwfIvSVd0PTrrLG_Q0IdNy2mbdeK73Y1bt80_o,844
+donna/primitives/artifacts/workflow.py,sha256=4u4Y9Le8ICKqWJR6qmC-flXKMers9Udm4vzKCHHLMME,7939
+donna/primitives/directives/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/primitives/directives/goto.py,sha256=uJdMJe3leJPSl_0PU4jd2AbHFJsJkf-x6rKhn4hKZd8,1679
+donna/primitives/directives/list.py,sha256=VgpUdZyGFQJbuhbMxNqRBWGn0_75u9lEzgjjKTqFKZY,3198
+donna/primitives/directives/task_variable.py,sha256=KvxY8ZOKFh6alkBhgDvkWzIJBfRNP4oYKRJ0SgHzO_g,2959
+donna/primitives/directives/view.py,sha256=-FvVKksxTx8WyyZgsh2jkauqQOWf7b5LL201dbv_hac,3198
+donna/primitives/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/primitives/operations/finish_workflow.py,sha256=-3vaYAjj6oN93JWeQIoV9TOqzDjv-2ch_Wp4pXcOHvs,1846
+donna/primitives/operations/output.py,sha256=30gAqmCdgh0UqkQIrOevpiAlONW3rT4wgOrdEtXv4nU,3271
+donna/primitives/operations/request_action.py,sha256=aovOrEIfyzaiqiLEvR-dUNgCEaIEX2x1uHPEDUMQtq4,2893
+donna/primitives/operations/run_script.py,sha256=R72TCPv-vsI9sZzkyikw6dulmW4iSIKWT4vEGYU4vjc,9348
+donna/protocol/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/protocol/cell_shortcuts.py,sha256=dZVCzoaPu09IYEA5g5gYPhR-q8MpgmehcYti1z9BBuI,385
+donna/protocol/cells.py,sha256=jQCM-l31Kt7gEBXgvb7Ph5Fstbz9lf0lEUbH0bgNlWg,1348
+donna/protocol/errors.py,sha256=u54fxMtJMWL8cbOLWU0acrmxV7Q8uHnyT1NFw959SMI,486
+donna/protocol/formatters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/protocol/formatters/automation.py,sha256=I_I-b8bixuXBlKqn2ryHDKSdRJy77FzDATJi-jhEPWI,928
+donna/protocol/formatters/base.py,sha256=PGrAgxiEtZKyg1wPePQMt5syOr6IpC4ydh5rMElaojE,405
+donna/protocol/formatters/human.py,sha256=WvoZVYlD4H3MftDkpEEP_RtyZnzJhUWKNecKgm3FoXg,1168
+donna/protocol/formatters/llm.py,sha256=z_2djZFaVVHjLYFMneUrYp5sA-EvtPuHUDzGKV1ogu4,1266
+donna/protocol/modes.py,sha256=vFDjciPdPy26XlLBGrgAn1kAVW7EJAHrccGcJrK7vUo,960
+donna/protocol/nodes.py,sha256=aP5IVOouZe6akSdfzPpfcGuZLbxkEieTE6j6SuVuTUU,1974
+donna/protocol/utils.py,sha256=GMiqGH2vawKu8_MmofWhCljI7AqoYDI0w19I-21t02g,663
+donna/workspaces/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/workspaces/artifacts.py,sha256=co6MBjIX2kV91WgNqCnDiK01hqUeB5cGPhE_ftJMl8U,8254
+donna/workspaces/artifacts_discovery.py,sha256=JEf5ZVLaK2wwhx5mVE4ulOdmC2lApCdyfpfv2vBB_DE,2803
+donna/workspaces/config.py,sha256=p7ujpAeOewikSWrfLLc64JeDsyrXBRCI7QLNMGng18w,6507
+donna/workspaces/errors.py,sha256=ZK77AKjnRLc0-Qnu-NKztliSbCYBDmzr71fo1soWDrg,8276
+donna/workspaces/initialization.py,sha256=d2oRwU4YEhhDeB1UtcOhqT0LD08QJoWEtvmSoQ6QwMg,2456
+donna/workspaces/markdown.py,sha256=Aom9AnnpGHXI8LndmizwwG5r6aIFlosHjCvw-juL85Q,7214
+donna/workspaces/sources/__init__.py,sha256=IRwKWnqQKh1ase742jhdadBcS4E9Hxr6j_l9Li6wwfw,70
+donna/workspaces/sources/base.py,sha256=y6CawcOSBUX3oMO8YXlxE6p_NMJ713ukTZhgNKKBl94,2020
+donna/workspaces/sources/markdown.py,sha256=vfNXIjDYOE40h8Thj0U593LYK874FiaFurLm6q0EFEY,9741
+donna/workspaces/templates.py,sha256=tovUVXCHKfHDymr7jxPO_nN-7r_-K_pcmzkdBa9FEes,6092
+donna/workspaces/tmp.py,sha256=q-ZPPTrssRjNNBJlP3wua7JjvLnXqOmYrcn2rUnhleo,1330
+donna/workspaces/worlds/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/workspaces/worlds/base.py,sha256=8Wt70dTlMzuO1Mmjll4reUgB_-hem9-rx_cAwaSyFVM,2589
+donna/workspaces/worlds/filesystem.py,sha256=cInj9GE65OCA4Ax27uYDuPMKJ4nlTcZ1JVZe51JSkQw,7055
+donna/workspaces/worlds/python.py,sha256=dRPS4jHIMRqdecCAmF7FuC6IwH3__nfWaf2cMSc7Txk,7223
+donna-0.2.1.dist-info/METADATA,sha256=_NTdFT_tdpPEQqVozdqt1vyHKUHe8E6DKgxYQokDJaA,2179
+donna-0.2.1.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+donna-0.2.1.dist-info/entry_points.txt,sha256=r2W_yOzauooYCu312OQwCycIN1UjVnO5paPpS2EDZqo,48
+donna-0.2.1.dist-info/licenses/LICENSE,sha256=KiF6_RVxH0MLeHZZtc8ag497X-c6oPmk-0OOf9qQDDk,1504
+donna-0.2.1.dist-info/RECORD,,

{donna-0.2.0.dist-info → donna-0.2.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.3.0
+Generator: poetry-core 2.3.1
 Root-Is-Purelib: true
 Tag: py3-none-any

donna/artifacts/work/do_it.md

@@ -1,142 +0,0 @@
-# Meta Work Loop
-
-```toml donna
-kind = "donna.lib.workflow"
-start_operation_id = "start"
-```
-
-General purpose work planning and execution workflow. Use it when you need to do complex work and there is no more specific workflow available.
-
-## Start Work
-
-```toml donna
-id = "start"
-kind = "donna.lib.request_action"
-fsm_mode = "start"
-```
-
-1. Read the specification `{{ donna.lib.view("donna:work:planning") }}` if you haven't done it yet.
-2. Read the specification `{{ donna.lib.view("donna:usage:artifacts") }}` if you haven't done it yet.
-3. If the developer hasn't provided you a description of the work for this session, ask them to provide it.
-4. Create new session-level specification `session:work_scope` with developer-provided description of the work to be done.
-5. `{{ donna.lib.goto("create_work_description") }}`
-
-## Create Work Description
-
-```toml donna
-id = "create_work_description"
-kind = "donna.lib.request_action"
-```
-
-1. Read the specification `{{ donna.lib.view("donna:work:planning") }}` if you haven't done it yet.
-2. Read the specification `{{ donna.lib.view("donna:usage:artifacts") }}` if you haven't done it yet.
-3. Formulate a concise high-level description of the work to be done, based on the developer-provided description.
-4. Add this description to the `session:work_scope`.
-5. `{{ donna.lib.goto("list_primary_goals") }}`
-
-## List Primary Goals
-
-```toml donna
-id = "list_primary_goals"
-kind = "donna.lib.request_action"
-```
-
-1. Read the specification `{{ donna.lib.view("donna:work:planning") }}` if you haven't done it yet.
-2. Read the specification `{{ donna.lib.view("donna:usage:artifacts") }}` if you haven't done it yet.
-3. If you can add more goals based on existing `{{ donna.lib.view("session:work_scope") }}` add them to the specification.
-4. If you can polish the existing goals according to the quality criteria in the `{{ donna.lib.view("donna:work:planning") }}` do it.
-5. `{{ donna.lib.goto("list_objectives") }}`
-
-## List Objectives
-
-```toml donna
-id = "list_objectives"
-kind = "donna.lib.request_action"
-```
-
-You MUST list objectives that need to be achieved to complete each goal.
-
-1. Read the specification `{{ donna.lib.view("donna:work:planning") }}` if you haven't done it yet.
-2. Read the specification `{{ donna.lib.view("donna:usage:artifacts") }}` if you haven't done it yet.
-3. If you can add more objectives based on existing `{{ donna.lib.view("session:work_scope") }}` add them to the specification.
-4. If you can polish the existing objectives according to the quality criteria in the `{{ donna.lib.view("donna:work:planning") }}` do it.
-5. `{{ donna.lib.goto("list_constraints") }}`
-
-## List Constraints
-
-```toml donna
-id = "list_constraints"
-kind = "donna.lib.request_action"
-```
-
-1. Read the specification `{{ donna.lib.view("donna:work:planning") }}` if you haven't done it yet.
-2. Read the specification `{{ donna.lib.view("donna:usage:artifacts") }}` if you haven't done it yet.
-3. If you can add more constraints based on existing `{{ donna.lib.view("session:work_scope") }}` add them to the specification.
-4. If you can polish the existing constraints according to the quality criteria in the `{{ donna.lib.view("donna:work:planning") }}` do it.
-5. `{{ donna.lib.goto("list_acceptance_criteria") }}`
-
-## List Acceptance Criteria
-
-```toml donna
-id = "list_acceptance_criteria"
-kind = "donna.lib.request_action"
-```
-
-1. Read the specification `{{ donna.lib.view("donna:work:planning") }}` if you haven't done it yet.
-2. Read the specification `{{ donna.lib.view("donna:usage:artifacts") }}` if you haven't done it yet.
-3. If you can add more acceptance criteria based on existing `{{ donna.lib.view("session:work_scope") }}` add them to the specification.
-4. If you can polish the existing acceptance criteria according to the quality criteria in the `{{ donna.lib.view("donna:work:planning") }}` do it.
-5. `{{ donna.lib.goto("list_deliverables") }}`
-
-## List Deliverables
-
-```toml donna
-id = "list_deliverables"
-kind = "donna.lib.request_action"
-```
-
-1. Read the specification `{{ donna.lib.view("donna:work:planning") }}` if you haven't done it yet.
-2. Read the specification `{{ donna.lib.view("donna:usage:artifacts") }}` if you haven't done it yet.
-3. If you can list more deliverables based on existing `{{ donna.lib.view("session:work_scope") }}` add them to the specification.
-4. If you can polish the existing deliverables according to the quality criteria in the `{{ donna.lib.view("donna:work:planning") }}` do it.
-5. `{{ donna.lib.goto("prepare_plan") }}`
-
-## Prepare Work Plan
-
-```toml donna
-id = "prepare_plan"
-kind = "donna.lib.request_action"
-```
-
-1. Read the specification `{{ donna.lib.view("donna:work:planning") }}` if you haven't done it yet.
-2. Read the specification `{{ donna.lib.view("donna:usage:artifacts") }}` if you haven't done it yet.
-3. Read the specification `{{ donna.lib.view("session:work_scope") }}` if you haven't done it yet.
-4. Create new session-level workflow `session:work_execution` according to the scope of work you have defined.
-5. `{{ donna.lib.goto("execute_plan") }}`
-
-## Execute Plan
-
-```toml donna
-id = "execute_plan"
-kind = "donna.lib.request_action"
-```
-
-1. Run workflow `session:work_execution` to execute the work according to the plan.
-2. `{{ donna.lib.goto("groom_work") }}`
-
-## Groom Work
-
-```toml donna
-id = "groom_work"
-kind = "donna.lib.request_action"
-```
-
-1. Run the grooming workflow to ensure that the result is polished, clean, and ready for review.
-2. `{{ donna.lib.goto("finish") }}`
-
-## Finish
-
-```toml donna
-id = "finish"
-kind = "donna.lib.finish"
-```

donna/artifacts/work/do_it_fast.md

@@ -1,98 +0,0 @@
-# Show Workflow Spec + Schema
-
-```toml donna
-kind = "donna.lib.workflow"
-start_operation_id = "read_workflow_source"
-```
-
-<!-- This is a temporary worflow, later Donna should have a specialized command to display the spec -->
-
-This workflow guides an agent through loading a workflow artifact source, choosing the correct FSM graph DSL, and producing a concise schema summary with a graph and per-operation descriptions.
-
-## Read workflow source
-
-```toml donna
-id = "read_workflow_source"
-kind = "donna.lib.request_action"
-fsm_mode = "start"
-```
-
-1. Identify the full workflow artifact id to summarize from the developer request (for example: `project:work:grooming`).
-2. If the workflow id is missing or ambiguous, ask the developer to provide the exact id, then repeat this operation.
-3. Fetch the workflow artifact source with:
-   - `./bin/donna.sh artifacts fetch '<workflow-id>'`
-4. Read the fetched source from the path printed by the command to capture:
-   - Workflow name (H1 title) and short description.
-   - The start operation (from `start_operation_id` in the workflow head config, which must be marked with `fsm_mode = "start"`).
-   - Each operation `id`, `kind`, and any {% raw %}`{{ donna.lib.goto(...) }}`{% endraw %} transitions in its body.
-5. Continue to {{ donna.lib.goto("select_fsm_dsl") }}.
-
-## Select FSM graph DSL
-
-```toml donna
-id = "select_fsm_dsl"
-kind = "donna.lib.request_action"
-```
-
-1. Determine whether the developer requested a specific FSM graph DSL (from the original request or provided inputs).
-2. If a DSL is specified, record it verbatim for rendering.
-3. If no DSL is specified, select Mermaid DSL.
-4. Continue to {{ donna.lib.goto("render_schema") }}.
-
-## Render short schema
-
-```toml donna
-id = "render_schema"
-kind = "donna.lib.request_action"
-```
-
-1. Produce the schema output in the exact meta format below, using the selected DSL for the FSM graph:
-
-```
-# <workflow name>
-
-<very short one sentence description of what it does>
-
-<FSM graph description in some DSL>
-
-<list of operations: `<id>` — <short one sentence description of what it does>
-```
-
-2. Ensure the FSM graph includes all operations and transitions, and clearly marks the start and finish operations.
-3. For Mermaid, use a `stateDiagram-v2` or `flowchart` representation and keep node ids aligned with operation ids.
-4. For each operation list entry, write a single concise sentence that is clean, complete, and faithful to the operation body.
-5. Continue to {{ donna.lib.goto("refine_schema") }}.
-
-## Refine schema output
-
-```toml donna
-id = "refine_schema"
-kind = "donna.lib.request_action"
-```
-
-1. Re-read the produced schema and improve clarity and correctness without changing the required format.
-2. Tighten wording to keep each description to a single clean sentence while still being thorough and accurate.
-3. Ensure the DSL selection rule is reflected in the graph and described output.
-4. Continue to {{ donna.lib.goto("validate_schema") }}.
-
-## Validate schema output
-
-```toml donna
-id = "validate_schema"
-kind = "donna.lib.request_action"
-```
-
-1. Verify the output contains the title, one-sentence description, FSM graph, and operation list in the required order.
-2. Confirm the chosen DSL is correct (developer-specified or Mermaid by default).
-3. Confirm each operation description is a single sentence and matches the operation purpose.
-4. If any check fails, return to {{ donna.lib.goto("refine_schema") }}.
-5. If all checks pass, proceed to {{ donna.lib.goto("finish") }}.
-
-## Finish
-
-```toml donna
-id = "finish"
-kind = "donna.lib.finish"
-```
-
-Workflow complete.