Skip to content

Commit d3b9cba

Browse files
Deployed ddd4445 to dev with Zensical 0.0.47 and mike 2.2.0+zensical-0.1.0
1 parent 6464a55 commit d3b9cba

3 files changed

Lines changed: 111 additions & 4 deletions

File tree

‎dev/search.json‎

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

‎dev/tools/cli/index.html‎

Lines changed: 90 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -623,6 +623,34 @@
623623
</span>
624624
</a>
625625

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+
626654
</li>
627655

628656
</ul>
@@ -847,6 +875,34 @@
847875
</span>
848876
</a>
849877

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+
850906
</li>
851907

852908
</ul>
@@ -977,23 +1033,27 @@ <h2 id="command-line">Command line<a class="headerlink" href="#command-line" tit
9771033
<tbody>
9781034
<tr>
9791035
<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>
9811037
</tr>
9821038
<tr>
9831039
<td><code>file</code></td>
9841040
<td><code>info</code>, <code>cat</code>, <code>write</code>, <code>download</code>, <code>upload</code></td>
9851041
</tr>
9861042
<tr>
9871043
<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>
9891045
</tr>
9901046
<tr>
9911047
<td><code>slot</code></td>
9921048
<td><code>list</code>, <code>get</code>, <code>set</code></td>
9931049
</tr>
9941050
<tr>
9951051
<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>
9971057
</tr>
9981058
<tr>
9991059
<td><code>instances</code></td>
@@ -1043,6 +1103,33 @@ <h2 id="command-line">Command line<a class="headerlink" href="#command-line" tit
10431103
<code>osw entity --help</code> or <code>osw entity get -h</code>, and prints that command's own
10441104
help.</p>
10451105
<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">&para;</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+
&lt;task category&gt; --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">&para;</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>
10461133

10471134

10481135

‎dev/tools/configuration/index.html‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1170,6 +1170,26 @@ <h2 id="variable-reference">Variable reference<a class="headerlink" href="#varia
11701170
<td><code>OSW_MCP_VERBOSE</code></td>
11711171
<td><code>true</code> prints the configuration source report</td>
11721172
</tr>
1173+
<tr>
1174+
<td><code>OSW_PERSON_IRI</code></td>
1175+
<td></td>
1176+
<td>Page name of the operator's own Person entity, read by the osl-tasks skill to filter tasks by actionee</td>
1177+
</tr>
1178+
<tr>
1179+
<td><code>OSW_TASK_CATEGORY</code></td>
1180+
<td></td>
1181+
<td>Category a newly created task is written to, read by the osl-tasks skill</td>
1182+
</tr>
1183+
<tr>
1184+
<td><code>OSW_PERSON_CATEGORY</code></td>
1185+
<td></td>
1186+
<td>Category a newly created person is written to, read by the osl-tasks skill</td>
1187+
</tr>
1188+
<tr>
1189+
<td><code>OSW_PROJECT_CATEGORY</code></td>
1190+
<td></td>
1191+
<td>Category a newly created project is written to, read by the osl-tasks skill</td>
1192+
</tr>
11731193
</tbody>
11741194
</table>
11751195
<h2 id="windows-paths-in-a-env-file">Windows paths in a <code>.env</code> file<a class="headerlink" href="#windows-paths-in-a-env-file" title="Permanent link">&para;</a></h2>

0 commit comments

Comments
 (0)