|
623 | 623 | </span> |
624 | 624 | </a> |
625 | 625 |
|
| 626 | +</li> |
| 627 | + |
| 628 | + <li class="md-nav__item"> |
| 629 | + <a href="#tasks-and-projects" class="md-nav__link"> |
| 630 | + <span class="md-ellipsis"> |
| 631 | + <span class="md-typeset"> |
| 632 | + Tasks and projects |
| 633 | + </span> |
| 634 | + </span> |
| 635 | + </a> |
| 636 | + |
| 637 | + <nav class="md-nav" aria-label="Tasks and projects"> |
| 638 | + <ul class="md-nav__list"> |
| 639 | + |
| 640 | + <li class="md-nav__item"> |
| 641 | + <a href="#the-claude-code-skill" class="md-nav__link"> |
| 642 | + <span class="md-ellipsis"> |
| 643 | + <span class="md-typeset"> |
| 644 | + The Claude Code skill |
| 645 | + </span> |
| 646 | + </span> |
| 647 | + </a> |
| 648 | + |
| 649 | +</li> |
| 650 | + |
| 651 | + </ul> |
| 652 | + </nav> |
| 653 | + |
626 | 654 | </li> |
627 | 655 |
|
628 | 656 | </ul> |
|
847 | 875 | </span> |
848 | 876 | </a> |
849 | 877 |
|
| 878 | +</li> |
| 879 | + |
| 880 | + <li class="md-nav__item"> |
| 881 | + <a href="#tasks-and-projects" class="md-nav__link"> |
| 882 | + <span class="md-ellipsis"> |
| 883 | + <span class="md-typeset"> |
| 884 | + Tasks and projects |
| 885 | + </span> |
| 886 | + </span> |
| 887 | + </a> |
| 888 | + |
| 889 | + <nav class="md-nav" aria-label="Tasks and projects"> |
| 890 | + <ul class="md-nav__list"> |
| 891 | + |
| 892 | + <li class="md-nav__item"> |
| 893 | + <a href="#the-claude-code-skill" class="md-nav__link"> |
| 894 | + <span class="md-ellipsis"> |
| 895 | + <span class="md-typeset"> |
| 896 | + The Claude Code skill |
| 897 | + </span> |
| 898 | + </span> |
| 899 | + </a> |
| 900 | + |
| 901 | +</li> |
| 902 | + |
| 903 | + </ul> |
| 904 | + </nav> |
| 905 | + |
850 | 906 | </li> |
851 | 907 |
|
852 | 908 | </ul> |
@@ -977,23 +1033,27 @@ <h2 id="command-line">Command line<a class="headerlink" href="#command-line" tit |
977 | 1033 | <tbody> |
978 | 1034 | <tr> |
979 | 1035 | <td><code>entity</code></td> |
980 | | -<td><code>get</code>, <code>put</code>, <code>export</code>, <code>delete</code></td> |
| 1036 | +<td><code>get</code>, <code>put</code>, <code>export</code>, <code>delete</code>, <code>validate</code></td> |
981 | 1037 | </tr> |
982 | 1038 | <tr> |
983 | 1039 | <td><code>file</code></td> |
984 | 1040 | <td><code>info</code>, <code>cat</code>, <code>write</code>, <code>download</code>, <code>upload</code></td> |
985 | 1041 | </tr> |
986 | 1042 | <tr> |
987 | 1043 | <td><code>search</code></td> |
988 | | -<td><code>ask</code>, <code>titles</code>, <code>content</code>, <code>entities</code>, <code>sparql</code></td> |
| 1044 | +<td><code>ask</code>, <code>titles</code>, <code>content</code>, <code>entities</code>, <code>sparql</code>, <code>label</code></td> |
989 | 1045 | </tr> |
990 | 1046 | <tr> |
991 | 1047 | <td><code>slot</code></td> |
992 | 1048 | <td><code>list</code>, <code>get</code>, <code>set</code></td> |
993 | 1049 | </tr> |
994 | 1050 | <tr> |
995 | 1051 | <td><code>schema</code></td> |
996 | | -<td><code>get</code></td> |
| 1052 | +<td><code>get</code>, <code>props</code>, <code>usage</code></td> |
| 1053 | +</tr> |
| 1054 | +<tr> |
| 1055 | +<td><code>skill</code></td> |
| 1056 | +<td><code>install</code></td> |
997 | 1057 | </tr> |
998 | 1058 | <tr> |
999 | 1059 | <td><code>instances</code></td> |
@@ -1043,6 +1103,33 @@ <h2 id="command-line">Command line<a class="headerlink" href="#command-line" tit |
1043 | 1103 | <code>osw entity --help</code> or <code>osw entity get -h</code>, and prints that command's own |
1044 | 1104 | help.</p> |
1045 | 1105 | <p>Failures exit non-zero with a short message on stderr and no traceback.</p> |
| 1106 | +<h2 id="tasks-and-projects">Tasks and projects<a class="headerlink" href="#tasks-and-projects" title="Permanent link">¶</a></h2> |
| 1107 | +<p>There is no dedicated command group for tasks. Reading local todos into an |
| 1108 | +OSL wiki as Task entities, and reading tasks, projects and persons back out, |
| 1109 | +is done with the generic <code>entity</code>, <code>schema</code> and <code>search</code> commands against the |
| 1110 | +three OSL core categories (Task, Person, Project).</p> |
| 1111 | +<p><strong>Configuration.</strong> Four environment variables affect this, and all are |
| 1112 | +optional: <code>OSW_PERSON_IRI</code>, <code>OSW_TASK_CATEGORY</code>, <code>OSW_PERSON_CATEGORY</code> and |
| 1113 | +<code>OSW_PROJECT_CATEGORY</code>. Reading always queries the shared OSL core category, |
| 1114 | +since MediaWiki category membership includes the whole subclass tree, so a |
| 1115 | +task kept in a local subclass is found without any configuration. The three |
| 1116 | +category overrides only change where a newly created task, person or project |
| 1117 | +is written.</p> |
| 1118 | +<p><strong>Vocabularies.</strong> <code>status</code> and <code>prio</code> store the page name of a wiki item, not |
| 1119 | +a word. Read the allowed values from the category schema with <code>osw schema get |
| 1120 | +<task category> --resolve</code>: <code>status</code> carries them in <code>enum</code>, and <code>prio</code> names |
| 1121 | +the category that holds them in <code>range</code>. A stock instance offers To do, In |
| 1122 | +work and Done for <code>status</code>, and High, Medium and Low for <code>prio</code>. A due date is |
| 1123 | +written to <code>end_date_time</code>, since the Task category has no due-date property.</p> |
| 1124 | +<h3 id="the-claude-code-skill">The Claude Code skill<a class="headerlink" href="#the-claude-code-skill" title="Permanent link">¶</a></h3> |
| 1125 | +<p>The skill that drives this ships at <code>src/osw/skills/osl-tasks/SKILL.md</code>. |
| 1126 | +Install it one of two ways:</p> |
| 1127 | +<ol> |
| 1128 | +<li><code>osw skill install</code>, which copies it to <code>~/.claude/skills/osl-tasks/</code>.</li> |
| 1129 | +<li><code>/plugin marketplace add OpenSemanticLab/osw-python</code> then |
| 1130 | + <code>/plugin install osl-tasks</code>.</li> |
| 1131 | +</ol> |
| 1132 | +<p>A new Claude Code session picks it up with no further action.</p> |
1046 | 1133 |
|
1047 | 1134 |
|
1048 | 1135 |
|
|
0 commit comments